claude-code-workflow 6.3.12 → 6.3.15

package/.claude/skills/issue-manage/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: issue-manage
-description: Interactive issue management with menu-driven CRUD operations. Use when managing issues, viewing issue status, editing issue fields, or performing bulk operations on issues. Triggers on "manage issue", "list issues", "edit issue", "delete issue", "bulk update", "issue dashboard".
+description: Interactive issue management with menu-driven CRUD operations. Use when managing issues, viewing issue status, editing issue fields, performing bulk operations, or viewing issue history. Triggers on "manage issue", "list issues", "edit issue", "delete issue", "bulk update", "issue dashboard", "issue history", "completed issues".
 allowed-tools: Bash, Read, Write, AskUserQuestion, Task, Glob
 ---
 
@@ -16,17 +16,22 @@ Ask me:
 - "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
 
 ## CLI Endpoints
 
 ```bash
 # Core operations
-ccw issue list                      # List all issues
+ccw issue list                      # List active issues
 ccw issue list <id> --json          # Get issue details
+ccw issue history                   # List completed issues (from history)
+ccw issue history --json            # Completed issues as JSON
 ccw issue status <id>               # Detailed status
 ccw issue init <id> --title "..."   # Create issue
 ccw issue task <id> --title "..."   # Add task
 ccw issue bind <id> <solution-id>   # Bind solution
+ccw issue update <id> --status completed  # Complete & auto-archive
 
 # Queue management
 ccw issue queue                     # List current queue
@@ -37,6 +42,7 @@ ccw issue queue archive             # Archive queue
 ccw issue queue delete <queue-id>   # Delete queue
 ccw issue next                      # Get next task
 ccw issue done <queue-id>           # Mark completed
+ccw issue update --from-queue       # Sync statuses from queue
 ```
 
 ## Operations
@@ -113,7 +119,29 @@ This will also remove:
 3. Clean up `solutions/<id>.jsonl`
 4. Remove from `queue.json`
 
-### 5. BULK 📦
+### 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/<id>.jsonl`
+- Queue items marked completed
+
+### 6. BULK 📦
 
 Batch operations:
 
@@ -125,25 +153,34 @@ Batch operations:
 | 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 |
 
 ## Workflow
 
 ```
-┌──────────────────────────────────────┐
-│         Main Menu                    │
-│  ┌────┐ ┌────┐ ┌────┐ ┌────┐        │
-│  │List│ │View│ │Edit│ │Bulk│        │
-│  └──┬─┘ └──┬─┘ └──┬─┘ └──┬─┘        │
-└─────┼──────┼──────┼──────┼──────────┘
-      │      │      │      │
-      ▼      ▼      ▼      ▼
-   Filter  Detail  Fields  Multi
-   Select  Actions Update  Select
-      │      │      │      │
-      └──────┴──────┴──────┘
-                │
-                ▼
-         Back to Menu
+┌────────────────────────────────────────────────┐
+│              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
 ```
 
 ## Implementation Guide
@@ -163,10 +200,11 @@ await showMainMenu(issueId);
 ```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(`Issues: ${issues.length} | Queue: ${queue.pending_count || 0} pending`);
+console.log(`Active: ${issues.length} | Completed: ${history.length} | Queue: ${queue.pending_count || 0} pending`);
 
 // 3. Ask action via AskUserQuestion
 const action = AskUserQuestion({
@@ -174,9 +212,10 @@ const action = AskUserQuestion({
     question: 'What would you like to do?',
     header: 'Action',
     options: [
-      { label: 'List Issues', description: 'Browse with filters' },
+      { 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' }
     ]
   }]
@@ -223,9 +262,11 @@ const issuesPath = '.workflow/issues/issues.jsonl';
 
 | File | Purpose |
 |------|---------|
-| `.workflow/issues/issues.jsonl` | Issue records |
+| `.workflow/issues/issues.jsonl` | Active issue records |
+| `.workflow/issues/issue-history.jsonl` | Completed issues (archived) |
 | `.workflow/issues/solutions/<id>.jsonl` | Solutions per issue |
-| `.workflow/issues/queue.json` | Execution queue |
+| `.workflow/issues/queues/index.json` | Queue index (multi-queue) |
+| `.workflow/issues/queues/<queue-id>.json` | Individual queue files |
 
 ## Error Handling
 

package/.claude/workflows/cli-templates/schemas/discovery-finding-schema.json

@@ -118,10 +118,10 @@
                 "maximum": 5,
                 "description": "Priority 1-5 (1=critical, 5=low)"
               },
-              "labels": {
+              "tags": {
                 "type": "array",
                 "items": { "type": "string" },
-                "description": "Suggested labels for the issue"
+                "description": "Suggested tags for the issue"
               }
             },
             "description": "Pre-filled issue suggestion for export"
@@ -205,7 +205,7 @@
             "title": "Add null check in user validation",
             "type": "bug",
             "priority": 2,
-            "labels": ["bug", "auth"]
+            "tags": ["bug", "auth"]
           },
           "external_reference": null,
           "confidence": 0.85,

package/.claude/workflows/cli-templates/schemas/issues-jsonl-schema.json

@@ -1,168 +1,141 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "title": "Issues JSONL Schema",
-  "description": "Schema for each line in issues.jsonl (flat storage)",
-  "type": "object",
-  "required": ["id", "title", "status", "created_at"],
-  "properties": {
-    "id": {
-      "type": "string",
-      "description": "Issue ID (GH-123, ISS-xxx, DSC-001)"
-    },
-    "title": {
-      "type": "string"
-    },
-    "status": {
-      "type": "string",
-      "enum": ["registered", "planning", "planned", "queued", "executing", "completed", "failed", "paused"],
-      "default": "registered"
-    },
-    "priority": {
-      "type": "integer",
-      "minimum": 1,
-      "maximum": 5,
-      "default": 3,
-      "description": "1=critical, 2=high, 3=medium, 4=low, 5=trivial"
-    },
-    "context": {
-      "type": "string",
-      "description": "Issue context/description (markdown)"
-    },
-    "source": {
-      "type": "string",
-      "enum": ["github", "text", "discovery"],
-      "description": "Source of the issue"
-    },
-    "source_url": {
-      "type": "string",
-      "description": "Original source URL (for GitHub issues)"
-    },
-    "labels": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Issue labels/tags"
-    },
-    "discovery_context": {
-      "type": "object",
-      "description": "Enriched context from issue:discover (only when source=discovery)",
-      "properties": {
-        "discovery_id": {
-          "type": "string",
-          "description": "Source discovery session ID"
-        },
-        "perspective": {
-          "type": "string",
-          "enum": ["bug", "ux", "test", "quality", "security", "performance", "maintainability", "best-practices"]
-        },
-        "category": {
-          "type": "string",
-          "description": "Finding category (e.g., edge-case, race-condition)"
-        },
-        "file": {
-          "type": "string",
-          "description": "Primary affected file"
-        },
-        "line": {
-          "type": "integer",
-          "description": "Line number in primary file"
-        },
-        "snippet": {
-          "type": "string",
-          "description": "Code snippet showing the issue"
-        },
-        "confidence": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1,
-          "description": "Agent confidence score"
-        },
-        "suggested_fix": {
-          "type": "string",
-          "description": "Suggested remediation from discovery"
-        }
-      }
-    },
-    "affected_components": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Files/modules affected"
-    },
-    "lifecycle_requirements": {
-      "type": "object",
-      "properties": {
-        "test_strategy": {
-          "type": "string",
-          "enum": ["unit", "integration", "e2e", "manual", "auto"]
-        },
-        "regression_scope": {
-          "type": "string",
-          "enum": ["affected", "related", "full"]
-        },
-        "acceptance_type": {
-          "type": "string",
-          "enum": ["automated", "manual", "both"]
-        },
-        "commit_strategy": {
-          "type": "string",
-          "enum": ["per-task", "squash", "atomic"]
-        }
-      }
-    },
-    "bound_solution_id": {
-      "type": "string",
-      "description": "ID of the bound solution (null if none bound)"
-    },
-    "solution_count": {
-      "type": "integer",
-      "default": 0,
-      "description": "Number of candidate solutions"
-    },
-    "created_at": {
-      "type": "string",
-      "format": "date-time"
-    },
-    "updated_at": {
-      "type": "string",
-      "format": "date-time"
-    },
-    "planned_at": {
-      "type": "string",
-      "format": "date-time"
-    },
-    "completed_at": {
-      "type": "string",
-      "format": "date-time"
-    }
-  },
-  "examples": [
-    {
-      "id": "DSC-001",
-      "title": "Fix: SQLite connection pool memory leak",
-      "status": "registered",
-      "priority": 1,
-      "context": "Connection pool cleanup only happens when MAX_POOL_SIZE is reached...",
-      "source": "discovery",
-      "labels": ["bug", "resource-leak", "critical"],
-      "discovery_context": {
-        "discovery_id": "DSC-20251228-182237",
-        "perspective": "bug",
-        "category": "resource-leak",
-        "file": "storage/sqlite_store.py",
-        "line": 59,
-        "snippet": "if len(self._pool) >= self.MAX_POOL_SIZE:\n    self._cleanup_stale_connections()",
-        "confidence": 0.85,
-        "suggested_fix": "Implement periodic cleanup or weak references"
-      },
-      "affected_components": ["storage/sqlite_store.py"],
-      "lifecycle_requirements": {
-        "test_strategy": "unit",
-        "regression_scope": "affected",
-        "acceptance_type": "automated",
-        "commit_strategy": "per-task"
-      },
-      "bound_solution_id": null,
-      "solution_count": 0,
-      "created_at": "2025-12-28T18:22:37Z"
-    }
-  ]
-}
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Issues JSONL Schema",
+  "description": "Schema for each line in issues.jsonl (flat storage)",
+  "type": "object",
+  "required": ["id", "title", "status", "created_at"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "description": "Issue ID (GH-123, ISS-xxx, DSC-001)"
+    },
+    "title": {
+      "type": "string"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["registered", "planning", "planned", "queued", "executing", "completed", "failed", "paused"],
+      "default": "registered"
+    },
+    "priority": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 5,
+      "default": 3,
+      "description": "1=critical, 2=high, 3=medium, 4=low, 5=trivial"
+    },
+    "context": {
+      "type": "string",
+      "description": "Issue context/description (markdown)"
+    },
+    "source": {
+      "type": "string",
+      "enum": ["github", "text", "discovery"],
+      "description": "Source of the issue"
+    },
+    "source_url": {
+      "type": "string",
+      "description": "Original source URL (for GitHub issues)"
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Issue tags"
+    },
+    "extended_context": {
+      "type": "object",
+      "description": "Minimal extended context for planning hints",
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "file:line format (e.g., 'src/auth.ts:42')"
+        },
+        "suggested_fix": {
+          "type": "string",
+          "description": "Suggested remediation"
+        },
+        "notes": {
+          "type": "string",
+          "description": "Additional notes (user clarifications or discovery hints)"
+        }
+      }
+    },
+    "affected_components": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Files/modules affected"
+    },
+    "lifecycle_requirements": {
+      "type": "object",
+      "properties": {
+        "test_strategy": {
+          "type": "string",
+          "enum": ["unit", "integration", "e2e", "manual", "auto"]
+        },
+        "regression_scope": {
+          "type": "string",
+          "enum": ["affected", "related", "full"]
+        },
+        "acceptance_type": {
+          "type": "string",
+          "enum": ["automated", "manual", "both"]
+        },
+        "commit_strategy": {
+          "type": "string",
+          "enum": ["per-task", "squash", "atomic"]
+        }
+      }
+    },
+    "bound_solution_id": {
+      "type": "string",
+      "description": "ID of the bound solution (null if none bound)"
+    },
+    "solution_count": {
+      "type": "integer",
+      "default": 0,
+      "description": "Number of candidate solutions"
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "planned_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "completed_at": {
+      "type": "string",
+      "format": "date-time"
+    }
+  },
+  "examples": [
+    {
+      "id": "DSC-001",
+      "title": "Fix: SQLite connection pool memory leak",
+      "status": "registered",
+      "priority": 1,
+      "context": "Connection pool cleanup only happens when MAX_POOL_SIZE is reached...",
+      "source": "discovery",
+      "tags": ["bug", "resource-leak", "critical"],
+      "extended_context": {
+        "location": "storage/sqlite_store.py:59",
+        "suggested_fix": "Implement periodic cleanup or weak references",
+        "notes": null
+      },
+      "affected_components": ["storage/sqlite_store.py"],
+      "lifecycle_requirements": {
+        "test_strategy": "unit",
+        "regression_scope": "affected",
+        "acceptance_type": "automated",
+        "commit_strategy": "per-task"
+      },
+      "bound_solution_id": null,
+      "solution_count": 0,
+      "created_at": "2025-12-28T18:22:37Z"
+    }
+  ]
+}

package/.claude/workflows/cli-templates/schemas/queue-schema.json

@@ -120,10 +120,6 @@
           "maximum": 1,
           "description": "Semantic importance score (0.0-1.0)"
         },
-        "assigned_executor": {
-          "type": "string",
-          "enum": ["codex", "gemini", "agent"]
-        },
         "queued_at": { "type": "string", "format": "date-time" },
         "started_at": { "type": "string", "format": "date-time" },
         "completed_at": { "type": "string", "format": "date-time" },
@@ -160,7 +156,6 @@
         "execution_group": { "type": "string" },
         "depends_on": { "type": "array", "items": { "type": "string" } },
         "semantic_priority": { "type": "number", "minimum": 0, "maximum": 1 },
-        "assigned_executor": { "type": "string", "enum": ["codex", "gemini", "agent"] },
         "queued_at": { "type": "string", "format": "date-time" },
         "started_at": { "type": "string", "format": "date-time" },
         "completed_at": { "type": "string", "format": "date-time" },

package/.claude/workflows/cli-templates/schemas/solution-schema.json

@@ -7,8 +7,9 @@
   "properties": {
     "id": {
       "type": "string",
-      "description": "Unique solution identifier",
-      "pattern": "^SOL-[0-9]+$"
+      "description": "Unique solution identifier: SOL-{issue-id}-{seq}",
+      "pattern": "^SOL-.+-[0-9]+$",
+      "examples": ["SOL-GH-123-1", "SOL-ISS-20251229-1"]
     },
     "description": {
       "type": "string",

package/.codex/prompts/issue-execute.md

@@ -40,7 +40,7 @@ ccw issue next
 This returns JSON with the full solution definition:
 - `item_id`: Solution identifier in queue (e.g., "S-1")
 - `issue_id`: Parent issue ID (e.g., "ISS-20251227-001")
-- `solution_id`: Solution ID (e.g., "SOL-20251227-001")
+- `solution_id`: Solution ID (e.g., "SOL-ISS-20251227-001-1")
 - `solution`: Full solution with all tasks
 - `execution_hints`: Timing and executor hints
 
@@ -54,10 +54,10 @@ Expected solution structure:
 {
   "item_id": "S-1",
   "issue_id": "ISS-20251227-001",
-  "solution_id": "SOL-20251227-001",
+  "solution_id": "SOL-ISS-20251227-001-1",
   "status": "pending",
   "solution": {
-    "id": "SOL-20251227-001",
+    "id": "SOL-ISS-20251227-001-1",
     "description": "Description of solution approach",
     "tasks": [
       {

package/.codex/prompts/issue-plan.md

@@ -71,25 +71,22 @@ Task rules (from schema):
 
 ### Step 5: Register & bind solutions via CLI
 
-Create an import JSON file per solution (NOT JSONL), then bind it:
-
-1. Write a file (example path):
-   - `.workflow/issues/solutions/_imports/<issue-id>-<timestamp>.json`
-2. File contents shape (minimum):
-   ```json
-   {
-     "description": "High-level summary",
-     "approach": "Technical approach",
-     "tasks": []
-   }
-   ```
-3. Register+bind in one step:
-   - `ccw issue bind <issue-id> --solution <import-file>`
-
-If you intentionally generated multiple solutions for the same issue:
-- Register each via `ccw issue bind <issue-id> <solution-id> --solution <import-file>` (do NOT bind yet).
-- Present the alternatives in `pending_selection` and stop for user choice.
-- Bind chosen solution with: `ccw issue bind <issue-id> <solution-id>`.
+**Create solution** (via CLI endpoint):
+```bash
+ccw issue solution <issue-id> --data '{"description":"...", "approach":"...", "tasks":[...]}'
+# Output: {"id":"SOL-{issue-id}-1", ...}
+```
+
+**CLI Features:**
+| Feature | Description |
+|---------|-------------|
+| Auto-increment ID | `SOL-{issue-id}-{seq}` (e.g., `SOL-GH-123-1`) |
+| Multi-solution | Appends to existing JSONL, supports multiple per issue |
+| Trailing newline | Proper JSONL format, no corruption |
+
+**Binding:**
+- **Single solution**: Auto-bind: `ccw issue bind <issue-id> <solution-id>`
+- **Multiple solutions**: Present alternatives in `pending_selection`, wait for user choice
 
 ### Step 6: Detect cross-issue file conflicts (best-effort)
 

package/.codex/prompts/issue-queue.md

@@ -78,8 +78,8 @@ Build a file → solutions mapping:
 
 ```javascript
 fileModifications = {
-  "src/auth.ts": ["SOL-001", "SOL-003"],
-  "src/api.ts": ["SOL-002"]
+  "src/auth.ts": ["SOL-ISS-001-1", "SOL-ISS-003-1"],
+  "src/api.ts": ["SOL-ISS-002-1"]
 }
 ```
 
@@ -129,13 +129,12 @@ Group assignment:
     {
       "item_id": "S-1",
       "issue_id": "ISS-001",
-      "solution_id": "SOL-001",
+      "solution_id": "SOL-ISS-001-1",
       "status": "pending",
       "execution_order": 1,
       "execution_group": "P1",
       "depends_on": [],
       "semantic_priority": 0.8,
-      "assigned_executor": "codex",
       "files_touched": ["src/auth.ts"],
       "task_count": 3
     }

package/README.md

@@ -9,6 +9,7 @@
 [![npm](https://img.shields.io/npm/v/claude-code-workflow.svg)](https://www.npmjs.com/package/claude-code-workflow)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]()
+[![Visual Tests](https://github.com/catlog22/Claude-Code-Workflow/actions/workflows/visual-tests.yml/badge.svg)](https://github.com/catlog22/Claude-Code-Workflow/actions/workflows/visual-tests.yml)
 
 **Languages:** [English](README.md) | [中文](README_CN.md)
 

package/ccw/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAuEA,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA2NxC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAuEA,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CA6NxC"}