@dommaker/harness 0.9.0 → 0.10.0

package/dist/tools/definitions/std/backlog/resolve.yml

@@ -0,0 +1,37 @@
+# backlog/resolve - 解决待办项
+#
+# 输入：
+#   - project_path: 项目路径
+#   - item_id: 待办项 ID
+#   - resolution: 解决说明（可选）
+#
+# 输出：
+#   - item: 解决后的待办项
+
+id: backlog/resolve
+stage: plan
+name: 解决待办项
+description: 标记待办项为已解决
+category: backlog
+execute:
+  type: builtin
+  handler: backlog/resolve
+
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  item_id:
+    type: string
+    description: 待办项 ID（如 BUG-001）
+    required: true
+  resolution:
+    type: string
+    description: 解决说明
+    required: false
+
+outputs:
+  - name: item
+    type: object
+    description: 解决后的待办项

package/dist/tools/definitions/std/backlog/update.yml

@@ -0,0 +1,42 @@
+# backlog/update - 更新待办项
+#
+# 输入：
+#   - project_path: 项目路径
+#   - item_id: 待办项 ID
+#   - status: 新状态（可选）
+#   - priority: 新优先级（可选）
+#
+# 输出：
+#   - item: 更新后的待办项
+
+id: backlog/update
+stage: plan
+name: 更新待办项
+description: 更新待办项状态或优先级
+category: backlog
+execute:
+  type: builtin
+  handler: backlog/update
+
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  item_id:
+    type: string
+    description: 待办项 ID（如 BUG-001）
+    required: true
+  status:
+    type: string
+    enum: [open, in_progress, resolved, closed]
+    required: false
+  priority:
+    type: string
+    enum: [critical, high, medium, low]
+    required: false
+
+outputs:
+  - name: item
+    type: object
+    description: 更新后的待办项

package/dist/tools/definitions/std/bugfix/diagnose.yml

@@ -0,0 +1,68 @@
+# bugfix/diagnose - 诊断 Bug
+#
+# 输入：
+#   - project_path: 项目路径
+#   - bug_description: Bug 描述
+#   - error_log: 可选的错误日志
+#
+# 输出：
+#   - diagnosis: 诊断结果
+
+id: bugfix/diagnose
+stage: fix
+name: 诊断 Bug
+description: 分析代码和错误信息，定位 Bug 根因
+category: bugfix
+agent: codex
+
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  bug_description:
+    type: string
+    description: Bug 描述
+    required: true
+  error_log:
+    type: string
+    description: 错误日志（可选）
+    required: false
+
+outputs:
+  - name: diagnosis
+    type: object
+    description: 诊断结果
+
+prompt: |
+  你是一个专业的 Bug 诊断专家。请分析以下 Bug 并找出根因。
+  
+  **Bug 描述**: {{bug_description}}
+  
+  {{#if error_log}}
+  **错误日志**:
+  ```
+  {{error_log}}
+  ```
+  {{/if}}
+  
+  **项目路径**: {{project_path}}
+  
+  **任务**：
+  1. 分析相关代码文件
+  2. 找出 Bug 根因
+  3. 提出修复方案
+  
+  **输出格式**（JSON）：
+  ```json
+  {
+    "root_cause": "根本原因描述",
+    "affected_files": ["file1.ts", "file2.ts"],
+    "fix_suggestion": "修复建议",
+    "estimated_complexity": "low/medium/high",
+    "related_tests": ["test1.test.ts"]
+  }
+  ```
+
+temperature: 0.2
+timeout: 180  # 3 分钟

package/dist/tools/definitions/std/bugfix/fix.yml

@@ -0,0 +1,66 @@
+# bugfix/fix - 修复 Bug
+#
+# 输入：
+#   - project_path: 项目路径
+#   - diagnosis: 诊断结果
+#   - bug_description: Bug 描述
+#
+# 输出：
+#   - fix_result: 修复结果
+
+id: bugfix/fix
+stage: fix
+name: 修复 Bug
+description: 根据诊断结果修复 Bug
+category: bugfix
+agent: codex
+
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  diagnosis:
+    type: object
+    description: 诊断结果
+    required: true
+  bug_description:
+    type: string
+    description: Bug 描述
+    required: true
+
+outputs:
+  - name: fix_result
+    type: object
+    description: 修复结果
+
+prompt: |
+  你是一个专业的 Bug 修复工程师。请根据诊断结果修复 Bug。
+  
+  **Bug 描述**: {{bug_description}}
+  
+  **诊断结果**:
+  ```json
+  {{diagnosis}}
+  ```
+  
+  **项目路径**: {{project_path}}
+  
+  **要求**：
+  1. 只修改必要的代码
+  2. 保持代码风格一致
+  3. 添加必要的注释说明修复原因
+  4. 不引入新问题
+  
+  **输出格式**（JSON）：
+  ```json
+  {
+    "files_modified": ["file1.ts"],
+    "changes_summary": "修改摘要",
+    "potential_side_effects": ["可能的副作用"],
+    "needs_test_update": true/false
+  }
+  ```
+
+temperature: 0.1
+timeout: 180  # 3 分钟

package/dist/tools/definitions/std/bugfix/verify.yml

@@ -0,0 +1,69 @@
+# bugfix/verify - 验证 Bug 修复
+#
+# 输入：
+#   - project_path: 项目路径
+#   - diagnosis: 诊断结果
+#   - fix_result: 修复结果
+#
+# 输出：
+#   - verify_result: 验证结果
+
+id: bugfix/verify
+stage: fix
+name: 验证修复
+description: 验证 Bug 是否已正确修复
+category: bugfix
+agent: codex
+
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  diagnosis:
+    type: object
+    description: 诊断结果
+    required: true
+  fix_result:
+    type: object
+    description: 修复结果
+    required: true
+
+outputs:
+  - name: verify_result
+    type: object
+    description: 验证结果
+
+prompt: |
+  你是一个质量保证工程师。请验证 Bug 修复是否正确。
+  
+  **诊断结果**:
+  ```json
+  {{diagnosis}}
+  ```
+  
+  **修复结果**:
+  ```json
+  {{fix_result}}
+  ```
+  
+  **项目路径**: {{project_path}}
+  
+  **验证任务**：
+  1. 运行相关测试（如果有）
+  2. 检查修复是否解决了根本原因
+  3. 确认没有引入新问题
+  
+  **输出格式**（JSON）：
+  ```json
+  {
+    "tests_passed": true/false,
+    "test_output": "测试输出摘要",
+    "bug_fixed": true/false,
+    "side_effects_detected": [],
+    "recommendation": "可以提交/需要进一步修复"
+  }
+  ```
+
+temperature: 0.1
+timeout: 120  # 2 分钟

package/dist/tools/definitions/std/constraint/check-decomposition.yml

@@ -0,0 +1,103 @@
+# check-decomposition.yml - 检查功能拆解
+# ============================================================================
+# 类型: 验证步骤
+# 用途: 检查每个功能是否都有可验证的 passes 子任务
+# Long-Running Agents 铁律: 功能实现前必须拆解为可验证的子任务
+# ============================================================================
+
+name: check-decomposition
+stage: govern
+description: 检查功能是否已拆解为可验证的 passes 子任务
+category: validation
+version: 1.0.0
+
+inputs:
+  - name: project_path
+    type: path
+    required: true
+    description: 项目路径
+  
+  - name: constraint_level
+    type: string
+    default: guideline
+    enum: [iron_law, guideline, tip]
+    description: |
+      约束级别：
+      - iron_law: 违反时必须停止
+      - guideline: 违反时警告
+      - tip: 仅提示
+  
+  - name: exceptions
+    type: array
+    default: [trivial_change, bug_fix_only, internal_refactor]
+    description: 允许例外的情况
+
+outputs:
+  - name: passed
+    type: boolean
+    description: 是否通过检查
+  
+  - name: violations
+    type: array
+    description: 违规的功能 ID 列表
+  
+  - name: warning_count
+    type: number
+    description: 警告数量
+  
+  - name: error_count
+    type: number
+    description: 错误数量（iron_law 级别）
+
+# Prompt
+prompt: |
+  你是 Long-Running Agents 约束检查器。请检查功能拆解约束。
+  
+  ## 项目路径
+  
+  {{project_path}}
+  
+  ## 约束级别
+  
+  {{constraint_level}}
+  
+  ## 铁律定义
+  
+  **no_feature_without_decomposition**:
+  实现功能前必须先拆解为可验证的子任务（passes）
+  
+  ## 检查流程
+  
+  1. 加载 feature_list.json:
+     ```bash
+     cat {{project_path}}/feature_list.json
+     ```
+  
+  2. 对每个 feature 检查：
+     - 是否有 `passes` 字段
+     - `passes` 数组是否非空
+     - 每个 pass 是否有 `description` 和 `verification`
+  
+  3. 识别例外情况（跳过检查）：
+     {{exceptions}}
+  
+  4. 输出结果：
+     ```json
+     {
+       "passed": true/false,
+       "violations": ["feature-id-1", "feature-id-2"],
+       "warning_count": N,
+       "error_count": N  // 只在 iron_law 级别
+     }
+     ```
+  
+  ## 约束级别处理
+  
+  - **iron_law**: 违规必须返回 passed=false, error_count>0
+  - **guideline**: 违规返回 passed=true, warning_count>0
+  - **tip**: 违规返回 passed=true，仅提示
+  
+  ## 注意
+  
+  - 如果 feature_list.json 不存在，返回 passed=true（跳过检查）
+  - 只检查 `status` 不是 `completed` 的功能

package/dist/tools/definitions/std/constraint/check-feature-list.yml

@@ -0,0 +1,77 @@
+# check-feature-list.yml - 检查 feature_list.json
+# ============================================================================
+# 类型: 验证步骤
+# 用途: 检查项目是否存在 feature_list.json 并验证格式
+# ============================================================================
+
+name: check-feature-list
+stage: govern
+description: 检查 feature_list.json 存在性和格式
+category: validation
+version: 1.0.0
+
+inputs:
+  - name: project_path
+    type: path
+    required: true
+    description: 项目路径
+  
+  - name: strict
+    type: boolean
+    default: false
+    description: 是否严格模式（缺失时报错）
+
+outputs:
+  - name: exists
+    type: boolean
+    description: feature_list.json 是否存在
+  
+  - name: valid
+    type: boolean
+    description: 格式是否正确
+  
+  - name: feature_count
+    type: number
+    description: 功能数量
+  
+  - name: features_with_passes
+    type: number
+    description: 有 passes 字段的功能数量
+  
+  - name: errors
+    type: array
+    description: 错误列表
+
+# Prompt（用于 Agent 执行）
+prompt: |
+  你是项目约束检查器。请检查项目的 feature_list.json 文件。
+  
+  ## 项目路径
+  
+  {{project_path}}
+  
+  ## 检查流程
+  
+  1. 检查文件是否存在: `{{project_path}}/feature_list.json`
+  
+  2. 如果存在，检查格式：
+     - 是否是有效的 JSON
+     - 是否有 `features` 数组字段
+     - 每个 feature 是否有 `id`, `name`, `description` 字段
+     - 检查有多少 feature 有 `passes` 字段
+  
+  3. 输出检查结果：
+     ```json
+     {
+       "exists": true/false,
+       "valid": true/false,
+       "feature_count": N,
+       "features_with_passes": N,
+       "errors": ["错误1", "错误2", ...]
+     }
+     ```
+  
+  ## 注意
+  
+  - 如果 strict=true 且文件不存在，返回错误
+  - 如果 strict=false 且文件不存在，返回 exists=false, valid=false（不报错）

package/dist/tools/definitions/std/constraint/check-progress.yml

@@ -0,0 +1,97 @@
+# check-progress.yml - 检查 progress.json
+# ============================================================================
+# 类型: 验证步骤
+# 用途: 检查跨 session 进度追踪文件
+# Long-Running Agents: progress.json 用于追踪跨 session 的功能完成进度
+# ============================================================================
+
+name: check-progress
+stage: govern
+description: 检查 progress.json 跨 session 进度追踪
+category: validation
+version: 1.0.0
+
+inputs:
+  - name: project_path
+    type: path
+    required: true
+    description: 项目路径
+  
+  - name: require_passes_evidence
+    type: boolean
+    default: true
+    description: 是否要求 passes 有证据（截图/测试结果）
+
+outputs:
+  - name: exists
+    type: boolean
+    description: progress.json 是否存在
+  
+  - name: valid
+    type: boolean
+    description: 格式是否正确
+  
+  - name: completed_features
+    type: number
+    description: 已完成的功能数量
+  
+  - name: in_progress_features
+    type: number
+    description: 进行中的功能数量
+  
+  - name: passes_with_evidence
+    type: number
+    description: 有证据的 passes 数量
+  
+  - name: passes_without_evidence
+    type: number
+    description: 缺失证据的 passes 数量
+  
+  - name: errors
+    type: array
+    description: 错误列表
+
+# Prompt
+prompt: |
+  你是 Long-Running Agents 进度检查器。请检查 progress.json。
+  
+  ## 项目路径
+  
+  {{project_path}}
+  
+  ## 检查流程
+  
+  1. 检查文件是否存在: `{{project_path}}/progress.json`
+  
+  2. 如果存在，检查格式：
+     - 是否是有效的 JSON
+     - 是否有 `features` 字段
+     - 每个 feature 是否有 `id`, `status`, `passes` 字段
+     - `status` 是否是有效值: pending, in_progress, completed
+  
+  3. 统计：
+     - 已完成功能数量（status=completed）
+     - 进行中功能数量（status=in_progress）
+     - 有证据的 passes 数量（有 screenshot 或 test_result）
+     - 缺失证据的 passes 数量
+  
+  4. 如果 require_passes_evidence=true：
+     - 检查每个 completed 的 feature 的 passes 是否有证据
+  
+  5. 输出结果：
+     ```json
+     {
+       "exists": true/false,
+       "valid": true/false,
+       "completed_features": N,
+       "in_progress_features": N,
+       "passes_with_evidence": N,
+       "passes_without_evidence": N,
+       "errors": ["错误1", ...]
+     }
+     ```
+  
+  ## 注意
+  
+  - progress.json 是可选的（不存在时不报错）
+  - 如果不存在，返回 exists=false, valid=false

package/dist/tools/definitions/std/constraint/generate-report.yml

@@ -0,0 +1,147 @@
+# generate-report.yml - 生成约束检查报告
+# ============================================================================
+# 类型: 汇总步骤
+# 用途: 汇总所有约束检查结果，生成报告
+# ============================================================================
+
+name: generate-report
+stage: govern
+description: 生成约束检查汇总报告
+category: reporting
+version: 1.0.0
+
+inputs:
+  - name: project_path
+    type: path
+    required: true
+    description: 项目路径
+  
+  - name: constraint_level
+    type: string
+    required: true
+    description: 约束级别
+  
+  - name: feature_list_result
+    type: object
+    required: true
+    description: feature_list 检查结果
+  
+  - name: decomposition_result
+    type: object
+    required: true
+    description: 功能拆解检查结果
+  
+  - name: progress_result
+    type: object
+    required: true
+    description: progress 检查结果
+  
+  - name: output_format
+    type: string
+    default: summary
+    enum: [summary, detailed, json]
+    description: 输出格式
+
+outputs:
+  - name: passed
+    type: boolean
+    description: 是否通过所有约束
+  
+  - name: total_checks
+    type: number
+    description: 总检查项数
+  
+  - name: passed_checks
+    type: number
+    description: 通过的检查项数
+  
+  - name: violations
+    type: array
+    description: 所有违规项
+  
+  - name: report
+    type: object
+    description: 详细报告
+  
+  - name: report_file
+    type: path
+    description: 报告文件路径
+
+# Prompt
+prompt: |
+  你是约束检查报告生成器。请汇总所有检查结果生成报告。
+  
+  ## 项目信息
+  
+  项目路径: {{project_path}}
+  约束级别: {{constraint_level}}
+  
+  ## 检查结果
+  
+  ### feature_list.json 检查
+  ```json
+  {{feature_list_result}}
+  ```
+  
+  ### 功能拆解检查
+  ```json
+  {{decomposition_result}}
+  ```
+  
+  ### progress.json 检查
+  ```json
+  {{progress_result}}
+  ```
+  
+  ## 报告生成
+  
+  根据 output_format 生成报告：
+  
+  ### summary 格式（默认）
+  
+  ```
+  🔍 Long-Running Agents 约束检查
+  
+  项目路径: {{project_path}}
+  约束级别: {{constraint_level}}
+  
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  
+  检查项                    状态    说明
+  ────────────────────────────────────────────
+  feature_list.json         ✅/⚠️/❌   ...
+  功能拆解                  ✅/⚠️/❌   ...
+  progress.json             ✅/⚠️/❌   ...
+  
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  
+  结果: ✅ 通过 / ❌ 失败 (N/M)
+  
+  违规项: [列表]
+  ```
+  
+  ### detailed 格式
+  
+  包含每个检查项的详细信息、错误列表、建议修复
+  
+  ### json 格式
+  
+  ```json
+  {
+    "passed": true/false,
+    "total_checks": N,
+    "passed_checks": N,
+    "violations": [...],
+    "checks": {
+      "feature_list": {...},
+      "decomposition": {...},
+      "progress": {...}
+    }
+  }
+  ```
+  
+  ## 输出
+  
+  将报告保存到: {{project_path}}/.constraint-report.json
+  
+  同时输出 JSON 格式的 passed/total_checks/passed_checks/violations/report