claude-code-workflow 6.3.50 → 6.3.52

package/.codex/skills/codex-issue-plan-execute/specs/quality-standards.md

@@ -0,0 +1,231 @@
+# Quality Standards
+
+质量评估标准和验收条件。
+
+## Quality Dimensions
+
+### 1. Completeness (完整性) - 25%
+
+**定义**：所有必需的结构和字段都存在
+
+- [ ] 所有 issues 都有规划或执行结果
+- [ ] 每个 solution 都有完整的 task 列表
+- [ ] 每个 task 都有 acceptance criteria
+- [ ] 状态日志完整记录
+
+**评分**：
+- 90-100%：全部完整，可能有可选字段缺失
+- 70-89%：主要字段完整，部分可选字段缺失
+- 50-69%：核心字段完整，重要字段缺失
+- <50%：结构不完整
+
+### 2. Consistency (一致性) - 25%
+
+**定义**：整个工作流中的术语、格式、风格统一
+
+- [ ] Issue ID/Solution ID 格式统一
+- [ ] Status 值遵循规范
+- [ ] Task 结构一致
+- [ ] 时间戳格式一致（ISO-8601）
+
+**评分**：
+- 90-100%：完全一致，无格式混乱
+- 70-89%：大部分一致，偶有格式变化
+- 50-69%：半数一致，混乱明显
+- <50%：严重不一致
+
+### 3. Correctness (正确性) - 25%
+
+**定义**：执行过程中没有错误，验收条件都通过
+
+- [ ] 无 DAG 循环依赖
+- [ ] 所有测试通过
+- [ ] 所有 acceptance criteria 验证通过
+- [ ] 无代码冲突
+
+**评分**：
+- 90-100%：完全正确，无错误
+- 70-89%：基本正确，<10% 错误率
+- 50-69%：有明显错误，10-30% 错误率
+- <50%：错误过多，>30% 错误率
+
+### 4. Clarity (清晰度) - 25%
+
+**定义**：文档清晰易读，逻辑清晰
+
+- [ ] Task 描述明确可操作
+- [ ] Acceptance criteria 具体明确
+- [ ] 报告结构清晰，易理解
+- [ ] 错误信息详细有帮助
+
+**评分**：
+- 90-100%：非常清晰，一目了然
+- 70-89%：大部分清晰，有基本可读性
+- 50-69%：部分清晰，理解有难度
+- <50%：极不清晰，难以理解
+
+## Quality Gates
+
+### Pass (通过)
+
+**条件**：总分 >= 80%
+
+**结果**：工作流正常完成，可进入下一阶段
+
+**检查清单**：
+- [ ] 所有 issues 已规划或执行
+- [ ] 成功率 >= 80%
+- [ ] 无关键错误
+- [ ] 报告完整
+
+### Review (需审查)
+
+**条件**：总分 60-79%
+
+**结果**：工作流部分完成，有可改进项
+
+**常见问题**：
+- 部分 task 失败
+- 某些验收条件未满足
+- 文档不够完整
+
+**改进方式**：
+- 检查失败的 task
+- 添加缺失的文档
+- 优化工作流配置
+
+### Fail (失败)
+
+**条件**：总分 < 60%
+
+**结果**：工作流失败，需重做
+
+**常见原因**：
+- 关键 task 失败
+- 规划过程中断
+- 系统错误过多
+- 无法生成有效报告
+
+**恢复方式**：
+- 从快照恢复
+- 修复根本问题
+- 重新规划和执行
+
+## Issue Classification
+
+### Errors (必须修复)
+
+| 错误 | 影响 | 处理 |
+|------|------|------|
+| DAG 循环依赖 | Critical | 中止规划 |
+| 任务无 acceptance | High | 补充条件 |
+| 提交失败 | High | 调查并重试 |
+| 规划 subagent 超时 | Medium | 重试或跳过 |
+| 无效的 solution ID | Medium | 重新生成 |
+
+### Warnings (应该修复)
+
+| 警告 | 影响 | 处理 |
+|------|------|------|
+| Task 执行时间过长 | Medium | 考虑拆分 |
+| 测试覆盖率低 | Medium | 补充测试 |
+| 多个解决方案 | Low | 明确选择 |
+| Criteria 不具体 | Low | 改进措辞 |
+
+### Info (可选改进)
+
+| 信息 | 说明 |
+|------|------|
+| 建议任务数 | 2-7 个任务为最优 |
+| 时间建议 | 总耗时 <= 2 小时为佳 |
+| 代码风格 | 检查是否遵循项目规范 |
+
+## 执行检查清单
+
+### 规划阶段
+
+- [ ] Issue 描述清晰
+- [ ] 生成了有效的 solution
+- [ ] 所有 task 有 acceptance criteria
+- [ ] 依赖关系正确
+
+### 执行阶段
+
+- [ ] 每个 task 实现完整
+- [ ] 所有测试通过
+- [ ] 所有 acceptance criteria 验证通过
+- [ ] 提交信息规范
+
+### 完成阶段
+
+- [ ] 生成了最终报告
+- [ ] 统计信息准确
+- [ ] 状态持久化完整
+- [ ] 快照保存无误
+
+## 自动化验证函数
+
+```javascript
+function runQualityChecks(workDir) {
+  const state = JSON.parse(Read(`${workDir}/state.json`));
+  const issues = state.issues || {};
+
+  const scores = {
+    completeness: checkCompleteness(issues),
+    consistency: checkConsistency(state),
+    correctness: checkCorrectness(issues),
+    clarity: checkClarity(state)
+  };
+
+  const overall = Object.values(scores).reduce((a, b) => a + b) / 4;
+
+  return {
+    scores: scores,
+    overall: overall.toFixed(1),
+    gate: overall >= 80 ? 'pass' : overall >= 60 ? 'review' : 'fail',
+    details: {
+      issues_total: Object.keys(issues).length,
+      completed: Object.values(issues).filter(i => i.status === 'completed').length,
+      failed: Object.values(issues).filter(i => i.status === 'failed').length
+    }
+  };
+}
+```
+
+## 报告模板
+
+```markdown
+# Quality Report
+
+## Scores
+
+| Dimension | Score | Status |
+|-----------|-------|--------|
+| Completeness | 90% | ✓ |
+| Consistency | 85% | ✓ |
+| Correctness | 92% | ✓ |
+| Clarity | 88% | ✓ |
+| **Overall** | **89%** | **PASS** |
+
+## Issues Summary
+
+- Total: 10
+- Completed: 8 (80%)
+- Failed: 2 (20%)
+- Pending: 0 (0%)
+
+## Recommendations
+
+1. ...
+2. ...
+
+## Errors & Warnings
+
+### Errors (0)
+
+None
+
+### Warnings (1)
+
+- Task T4 in ISS-003 took 45 minutes (expected 30)
+```

package/.codex/skills/codex-issue-plan-execute/specs/solution-schema.md

@@ -0,0 +1,270 @@
+# Solution Schema Specification
+
+解决方案数据结构和验证规则。
+
+## When to Use
+
+| Phase | Usage | Section |
+|-------|-------|---------|
+| Phase: action-plan | Solution 生成 | Solution Structure |
+| Phase: action-execute | Task 解析 | Task Definition |
+
+---
+
+## Solution Structure
+
+### 完整 Schema
+
+```json
+{
+  "id": "SOL-ISS-001-1",
+  "issue_id": "ISS-001",
+  "description": "Fix authentication token expiration by extending TTL",
+  "strategy_type": "bugfix",
+  "created_at": "2025-01-29T11:00:00Z",
+  "tasks": [
+    {
+      "id": "T1",
+      "title": "Update token TTL configuration",
+      "action": "Modify",
+      "scope": "src/config/auth.ts",
+      "description": "Increase JWT token expiration from 1h to 24h",
+      "modification_points": [
+        {
+          "file": "src/config/auth.ts",
+          "target": "JWT_EXPIRY",
+          "change": "Change value from 3600 to 86400"
+        }
+      ],
+      "implementation": [
+        "Open src/config/auth.ts",
+        "Locate JWT_EXPIRY constant",
+        "Update value: 3600 → 86400",
+        "Add comment explaining change"
+      ],
+      "test": {
+        "commands": ["npm test -- auth.config.test.ts"],
+        "unit": ["Token expiration should be 24h"],
+        "integration": []
+      },
+      "acceptance": {
+        "criteria": [
+          "Unit tests pass",
+          "Token TTL is correctly set",
+          "No breaking changes to API"
+        ],
+        "verification": [
+          "Run: npm test",
+          "Manual: Verify token in console"
+        ]
+      },
+      "depends_on": [],
+      "estimated_minutes": 15,
+      "priority": 1
+    }
+  ],
+  "exploration_context": {
+    "relevant_files": [
+      "src/config/auth.ts",
+      "src/services/auth.service.ts",
+      "tests/auth.test.ts"
+    ],
+    "patterns": "Follow existing config pattern in .env",
+    "integration_points": "Used by AuthService in middleware"
+  },
+  "analysis": {
+    "risk": "low",
+    "impact": "medium",
+    "complexity": "low"
+  },
+  "score": 0.95,
+  "is_bound": true
+}
+```
+
+## 字段说明
+
+### 基础字段
+
+| 字段 | 类型 | 必需 | 说明 |
+|------|------|------|------|
+| `id` | string | ✓ | 唯一 ID：SOL-{issue-id}-{seq} |
+| `issue_id` | string | ✓ | 关联的 Issue ID |
+| `description` | string | ✓ | 解决方案描述 |
+| `strategy_type` | string | | 策略类型：bugfix/feature/refactor |
+| `tasks` | array | ✓ | 任务列表，至少 1 个 |
+
+### Task 字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `id` | string | 任务 ID：T1, T2, ... |
+| `title` | string | 任务标题 |
+| `action` | string | 动作类型：Create/Modify/Fix/Refactor |
+| `scope` | string | 作用范围：文件或目录 |
+| `modification_points` | array | 具体修改点列表 |
+| `implementation` | array | 实现步骤 |
+| `test` | object | 测试命令和用例 |
+| `acceptance` | object | 验收条件和验证步骤 |
+| `depends_on` | array | 任务依赖：[T1, T2] |
+| `estimated_minutes` | number | 预计耗时（分钟） |
+
+### 验收条件
+
+```json
+{
+  "acceptance": {
+    "criteria": [
+      "Unit tests pass",
+      "Function returns correct result",
+      "No performance regression"
+    ],
+    "verification": [
+      "Run: npm test -- module.test.ts",
+      "Manual: Call function and verify output"
+    ]
+  }
+}
+```
+
+## 验证规则
+
+### 必需字段检查
+
+```javascript
+function validateSolution(solution) {
+  if (!solution.id) throw new Error("Missing: id");
+  if (!solution.issue_id) throw new Error("Missing: issue_id");
+  if (!solution.description) throw new Error("Missing: description");
+  if (!Array.isArray(solution.tasks)) throw new Error("tasks must be array");
+  if (solution.tasks.length === 0) throw new Error("tasks cannot be empty");
+  return true;
+}
+
+function validateTask(task) {
+  if (!task.id) throw new Error("Missing: task.id");
+  if (!task.title) throw new Error("Missing: task.title");
+  if (!task.action) throw new Error("Missing: task.action");
+  if (!Array.isArray(task.implementation)) throw new Error("implementation must be array");
+  if (!task.acceptance) throw new Error("Missing: task.acceptance");
+  if (!Array.isArray(task.acceptance.criteria)) throw new Error("acceptance.criteria must be array");
+  if (task.acceptance.criteria.length === 0) throw new Error("acceptance.criteria cannot be empty");
+  return true;
+}
+```
+
+### 格式验证
+
+- ID 格式：`SOL-ISS-\d+-\d+`
+- Action 值：Create | Modify | Fix | Refactor | Add | Remove
+- Risk/Impact/Complexity 值：low | medium | high
+- Score 范围：0.0 - 1.0
+
+## 任务依赖
+
+### 表示方法
+
+```json
+{
+  "tasks": [
+    {
+      "id": "T1",
+      "title": "Create auth module",
+      "depends_on": []
+    },
+    {
+      "id": "T2",
+      "title": "Add authentication logic",
+      "depends_on": ["T1"]
+    },
+    {
+      "id": "T3",
+      "title": "Add tests",
+      "depends_on": ["T1", "T2"]
+    }
+  ]
+}
+```
+
+### DAG 验证
+
+```javascript
+function validateDAG(tasks) {
+  const visited = new Set();
+  const recursionStack = new Set();
+
+  function hasCycle(taskId) {
+    visited.add(taskId);
+    recursionStack.add(taskId);
+
+    const task = tasks.find(t => t.id === taskId);
+    if (!task || !task.depends_on) return false;
+
+    for (const dep of task.depends_on) {
+      if (!visited.has(dep)) {
+        if (hasCycle(dep)) return true;
+      } else if (recursionStack.has(dep)) {
+        return true;  // 发现循环
+      }
+    }
+
+    recursionStack.delete(taskId);
+    return false;
+  }
+
+  for (const task of tasks) {
+    if (!visited.has(task.id) && hasCycle(task.id)) {
+      throw new Error(`Circular dependency detected: ${task.id}`);
+    }
+  }
+  return true;
+}
+```
+
+## 文件保存
+
+### 位置
+
+```
+.workflow/.scratchpad/codex-issue-{timestamp}/solutions/
+├── ISS-001-plan.json           # 规划结果
+├── ISS-001-execution.json      # 执行结果
+├── ISS-002-plan.json
+└── ISS-002-execution.json
+```
+
+### 文件内容
+
+**规划结果**：包含 solution 完整定义
+**执行结果**：包含执行状态和提交信息
+
+```json
+{
+  "solution_id": "SOL-ISS-001-1",
+  "status": "completed|failed",
+  "executed_at": "ISO-8601",
+  "execution_result": {
+    "files_modified": ["src/auth.ts"],
+    "commit_hash": "abc123...",
+    "tests_passed": true
+  }
+}
+```
+
+## 质量门控
+
+### Solution 评分标准
+
+| 指标 | 权重 | 评分方法 |
+|------|------|----------|
+| 任务完整性 | 30% | 无空任务，每个任务有 acceptance |
+| 依赖合法性 | 20% | 无循环依赖，依赖链清晰 |
+| 验收可测 | 30% | Criteria 明确可测，有验证步骤 |
+| 复杂度评估 | 20% | Risk/Impact/Complexity 合理评估 |
+
+### 通过条件
+
+- 所有必需字段存在
+- 无格式错误
+- 无循环依赖
+- Score >= 0.8

package/.codex/skills/codex-issue-plan-execute/specs/subagent-roles.md

@@ -0,0 +1,32 @@
+⚠️ **DEPRECATED** - This file is deprecated as of v2.0 (2025-01-29)
+
+**Use instead**: [`agent-roles.md`](agent-roles.md)
+
+This file has been superseded by a consolidated `agent-roles.md` that improves organization and eliminates duplication.
+
+**Why the change?**
+- Consolidates all agent role definitions in one place
+- Eliminates duplicated role descriptions
+- Single source of truth for agent capabilities
+- Better organization with unified reference format
+
+**Migration**:
+```javascript
+// OLD (v1.0)
+// Reference: specs/subagent-roles.md
+
+// NEW (v2.0)
+// Reference: specs/agent-roles.md
+```
+
+**Timeline**:
+- v2.0 (2025-01-29): Old file kept for backward compatibility
+- v2.1 (2025-03-31): Old file will be removed
+
+---
+
+# Subagent Roles Definition (Legacy - See agent-roles.md instead)
+
+See [`agent-roles.md`](agent-roles.md) for the current consolidated agent roles specification.
+
+All content has been merged into the new agent-roles.md file with improved organization and formatting.

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

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/commands/cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4GH,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA+pCD;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,OAAO,EAAE,cAAc,GAAG,cAAc,GACvC,OAAO,CAAC,IAAI,CAAC,CA8Hf"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/commands/cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoHH,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA+qCD;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,OAAO,EAAE,cAAc,GAAG,cAAc,GACvC,OAAO,CAAC,IAAI,CAAC,CA8Hf"}

package/ccw/dist/commands/cli.js

@@ -54,6 +54,9 @@ function notifyDashboard(data) {
  * Uses specific event types that match frontend handlers
  */
 function broadcastStreamEvent(eventType, payload) {
+    if (process.env.DEBUG_CLI_EVENTS) {
+        console.error(`[CLI-BROADCAST] START ${eventType} at ${Date.now()}`);
+    }
     const data = JSON.stringify({
         type: eventType,
         ...payload,
@@ -82,6 +85,9 @@ function broadcastStreamEvent(eventType, payload) {
     });
     req.write(data);
     req.end();
+    if (process.env.DEBUG_CLI_EVENTS) {
+        console.error(`[CLI-BROADCAST] END ${eventType} at ${Date.now()}`);
+    }
 }
 /**
  * Show storage information and management options
@@ -756,6 +762,9 @@ async function execAction(positionalPrompt, options) {
         tool,
         mode
     });
+    if (process.env.DEBUG) {
+        console.error(`[CLI] Generated executionId: ${executionId}`);
+    }
     // Buffer to accumulate output when both --stream and --to-file are specified
     let streamBuffer = '';
     // Streaming output handler - broadcasts to dashboard AND writes to stdout
@@ -820,7 +829,7 @@ async function execAction(positionalPrompt, options) {
             includeDirs,
             // timeout removed - controlled by external caller (bash timeout)
             resume,
-            id, // custom execution ID
+            id: executionId, // unified execution ID (matches broadcast events)
             noNative,
             stream: !!stream, // stream=true → streaming enabled (no cache), stream=false → cache output (default)
             outputFormat, // Enable JSONL parsing for tools that support it
@@ -925,14 +934,26 @@ async function execAction(positionalPrompt, options) {
                 turn_count: result.conversation.turn_count
             });
             // Broadcast CLI_EXECUTION_COMPLETED for real-time streaming viewer
+            if (process.env.DEBUG_CLI_EVENTS) {
+                console.error(`[CLI-TIMING] Broadcasting CLI_EXECUTION_COMPLETED at ${Date.now()}`);
+            }
             broadcastStreamEvent('CLI_EXECUTION_COMPLETED', {
                 executionId, // Use the same executionId as started event
                 success: true,
                 duration: result.execution.duration_ms
             });
+            if (process.env.DEBUG_CLI_EVENTS) {
+                console.error(`[CLI-TIMING] Broadcast returned, setting timeout at ${Date.now()}`);
+            }
             // Ensure clean exit after successful execution
             // Delay to allow HTTP request to complete
-            setTimeout(() => process.exit(0), 150);
+            // FIX: Increased from 150ms to 500ms for long-running executions
+            setTimeout(() => {
+                if (process.env.DEBUG_CLI_EVENTS) {
+                    console.error(`[CLI-TIMING] process.exit(0) at ${Date.now()}`);
+                }
+                process.exit(0);
+            }, 500);
         }
         else {
             if (!spinner) {