issue-manage

Ask me:

• "Show all issues" → List with filters
• "View issue GH-123" → Detailed inspection
• "Edit issue priority" → Modify fields
• "Delete old issues" → Remove with confirmation
• "Bulk update status" → Batch operations
• "Show completed issues" → View issue history
• "Archive old issues" → Move to history

```bash

# Core operations

ccw issue list # List active issues

ccw issue list --json # Get issue details

ccw issue history # List completed issues (from history)

ccw issue history --json # Completed issues as JSON

ccw issue status # Detailed status

ccw issue init --title "..." # Create issue

ccw issue task --title "..." # Add task

ccw issue bind # Bind solution

ccw issue update --status completed # Complete & auto-archive

# Queue management

ccw issue queue # List current queue

ccw issue queue add # Add to queue

ccw issue queue list # Queue history

ccw issue queue switch # Switch queue

ccw issue queue archive # Archive queue

ccw issue queue delete # Delete queue

ccw issue next # Get next task

ccw issue done # Mark completed

ccw issue update --from-queue # Sync statuses from queue

```

1. LIST 📋

Filter and browse issues:

```

┌─ Filter by Status ─────────────────┐

│ □ All □ Registered │

│ □ Planned □ Queued │

│ □ Executing □ Completed │

└────────────────────────────────────┘

```

Flow:

1. Ask filter preferences → ccw issue list --json
2. Display table: ID | Status | Priority | Title
3. Select issue for detail view

2. VIEW 🔍

Detailed issue inspection:

```

┌─ Issue: GH-123 ─────────────────────┐

│ Title: Fix authentication bug │

│ Status: planned | Priority: P2 │

│ Solutions: 2 (1 bound) │

│ Tasks: 5 pending │

└─────────────────────────────────────┘

```

Flow:

1. Fetch ccw issue status --json
2. Display issue + solutions + tasks
3. Offer actions: Edit | Plan | Queue | Delete

3. EDIT ✏️

Modify issue fields:

| Field | Options |

|-------|---------|

| Title | Free text |

| Priority | P1-P5 |

| Status | registered → completed |

| Context | Problem description |

| Labels | Comma-separated |

Flow:

1. Select field to edit
2. Show current value
3. Collect new value via AskUserQuestion
4. Update .workflow/issues/issues.jsonl

4. DELETE 🗑️

Remove with confirmation:

```

⚠️ Delete issue GH-123?

This will also remove:

• Associated solutions
• Queued tasks

[Delete] [Cancel]

```

Flow:

1. Confirm deletion via AskUserQuestion
2. Remove from issues.jsonl
3. Clean up solutions/.jsonl
4. Remove from queue.json

5. HISTORY 📚

View and manage completed issues:

```

┌─ Issue History ─────────────────────┐

│ ID Completed Title │

│ ISS-001 2025-12-28 12:00 Fix bug │

│ ISS-002 2025-12-27 15:30 Feature │

└──────────────────────────────────────┘

```

Flow:

1. Fetch ccw issue history --json
2. Display table: ID | Completed At | Title
3. Optional: Filter by date range

Auto-Archive: When issue status → completed:

• Issue moves from issues.jsonl → issue-history.jsonl
• Solutions remain in solutions/.jsonl
• Queue items marked completed

6. BULK 📦

Batch operations:

| Operation | Description |

|-----------|-------------|

| Update Status | Change multiple issues |

| Update Priority | Batch priority change |

| Add Labels | Tag multiple issues |

| Delete Multiple | Bulk removal |

| Queue All Planned | Add all planned to queue |

| Retry All Failed | Reset failed tasks |

| Sync from Queue | Update statuses from active queue |

```

┌────────────────────────────────────────────────┐

│ Main Menu │

│ ┌────┐ ┌────┐ ┌────┐ ┌─────┐ ┌────┐ │

│ │List│ │View│ │Edit│ │Hist.│ │Bulk│ │

│ └──┬─┘ └──┬─┘ └──┬─┘ └──┬──┘ └──┬─┘ │

└─────┼──────┼──────┼──────┼───────┼─────────────┘

│ │ │ │ │

▼ ▼ ▼ ▼ ▼

Filter Detail Fields History Multi

Select Actions Update Browse Select

│ │ │ │ │

└──────┴──────┴──────┴───────┘

│

▼

Back to Menu

```

Issue Lifecycle:

```

registered → planned → queued → executing → completed

│

▼

issue-history.jsonl

```

Entry Point

```javascript

// Parse input for issue ID

const issueId = input.match(/^([A-Z]+-\d+|ISS-\d+)/i)?.[1];

// Show main menu

await showMainMenu(issueId);

```

Main Menu Pattern

```javascript

// 1. Fetch dashboard data

const issues = JSON.parse(Bash('ccw issue list --json') || '[]');

const history = JSON.parse(Bash('ccw issue history --json 2>/dev/null') || '[]');

const queue = JSON.parse(Bash('ccw issue queue --json 2>/dev/null') || '{}');

// 2. Display summary

console.log(Active: ${issues.length} | Completed: ${history.length} | Queue: ${queue.pending_count || 0} pending);

// 3. Ask action via AskUserQuestion

const action = AskUserQuestion({

questions: [{

question: 'What would you like to do?',

header: 'Action',

options: [

{ label: 'List Issues', description: 'Browse active issues' },

{ label: 'View Issue', description: 'Detail view' },

{ label: 'Edit Issue', description: 'Modify fields' },

{ label: 'View History', description: 'Completed issues' },

{ label: 'Bulk Operations', description: 'Batch actions' }

]

}]

});

// 4. Route to handler

```

Filter Pattern

```javascript

const filter = AskUserQuestion({

questions: [{

question: 'Filter by status?',

header: 'Filter',

multiSelect: true,

options: [

{ label: 'All', description: 'Show all' },

{ label: 'Registered', description: 'Unplanned' },

{ label: 'Planned', description: 'Has solution' },

{ label: 'Executing', description: 'In progress' }

]

}]

});

```

Edit Pattern

```javascript

// Select field

const field = AskUserQuestion({...});

// Get new value based on field type

// For Priority: show P1-P5 options

// For Status: show status options

// For Title: accept free text via "Other"

// Update file

const issuesPath = '.workflow/issues/issues.jsonl';

// Read → Parse → Update → Write

```

| File | Purpose |

|------|---------|

| .workflow/issues/issues.jsonl | Active issue records |

| .workflow/issues/issue-history.jsonl | Completed issues (archived) |

| .workflow/issues/solutions/.jsonl | Solutions per issue |

| .workflow/issues/queues/index.json | Queue index (multi-queue) |

| .workflow/issues/queues/.json | Individual queue files |

| Error | Resolution |

|-------|------------|

| No issues found | Suggest /issue:new to create |

| Issue not found | Show available issues, re-prompt |

| Write failure | Check file permissions |

| Queue error | Display ccw error message |

• /issue:new - Create structured issue
• /issue:plan - Generate solution
• /issue:queue - Form execution queue
• /issue:execute - Execute tasks