@dommaker/harness 0.9.0 → 0.10.0

package/dist/tools/definitions/std/governance/rollback.yml

@@ -0,0 +1,186 @@
+# rollback.yml - 回滚步骤
+# ============================================================================
+# 类型: 治理类步骤
+# 执行方式: 内置处理器
+# 用途: 回滚进化实现，恢复到之前状态
+# 核心理念: 效果不好自动回滚，保护系统稳定
+# ============================================================================
+
+name: rollback
+stage: govern
+description: 回滚进化实现，恢复到之前状态
+category: governance
+version: 1.0.0
+
+# 执行配置
+execute:
+  type: builtin
+  handler: governance/rollback
+
+# 输入定义
+inputs:
+  effect_tracking_id:
+    type: string
+    description: 效果追踪记录 ID
+    required: true
+  
+  project_path:
+    type: path
+    description: 项目路径
+    required: true
+  
+  commit_before:
+    type: string
+    description: 进化实现前的 commit hash
+    required: true
+  
+  commit_after:
+    type: string
+    description: 进化实现后的 commit hash
+    required: true
+  
+  reason:
+    type: string
+    description: 回滚原因
+    required: true
+  
+  triggered_by:
+    type: string
+    description: 触发方式
+    enum: [auto, manual]
+    default: auto
+
+# 回滚流程
+rollback_steps:
+  step_1:
+    name: 验证当前状态
+    actions:
+      - 检查是否有未提交的变更
+      - 确认可以安全回滚
+      - 创建备份分支
+  
+  step_2:
+    name: 执行回滚
+    actions:
+      - git reset --hard {commit_before}
+      - 或 git revert {commit_after}
+      - 根据情况选择
+  
+  step_3:
+    name: 验证回滚结果
+    actions:
+      - 运行测试
+      - 检查构建
+      - 确认功能正常
+  
+  step_4:
+    name: 更新记录
+    actions:
+      - 更新 effect-tracking 状态
+      - 记录回滚原因
+      - 通知相关人员
+
+# 回滚策略
+strategies:
+  reset:
+    description: 硬重置到之前 commit
+    use_when: "变更未推送 / 仅本地"
+    command: "git reset --hard {commit_before}"
+  
+  revert:
+    description: 创建回滚 commit
+    use_when: "变更已推送 / 需要保留历史"
+    command: "git revert {commit_after}"
+  
+  branch:
+    description: 创建回滚分支
+    use_when: "需要保留当前状态"
+    commands:
+      - "git branch rollback-backup-{timestamp}"
+      - "git reset --hard {commit_before}"
+
+# 安全检查
+safety_checks:
+  - name: 检查未提交变更
+    command: "git status --porcelain"
+    expected: empty
+    on_fail: warn
+  
+  - name: 检查远程同步
+    command: "git status -sb"
+    expected: 'ahead 0, behind 0 or local-only'
+    on_fail: confirm
+  
+  - name: 检查依赖变更
+    command: "git diff {commit_before}..{commit_after} -- package.json"
+    expected: any
+    on_fail: "需要重新安装依赖"
+
+# 输出定义
+outputs:
+  - name: rollback_status
+    type: string
+    enum: [pending, in_progress, completed, failed]
+    description: 回滚状态
+  
+  - name: strategy_used
+    type: string
+    enum: [reset, revert, branch]
+    description: 使用的回滚策略
+  
+  - name: commit_before
+    type: string
+    description: 回滚前的 commit
+  
+  - name: commit_after
+    type: string
+    description: 回滚后的 commit（新创建的回滚 commit）
+  
+  - name: verification_result
+    type: object
+    description: 回滚验证结果
+    properties:
+      tests_passed:
+        type: boolean
+      build_passed:
+        type: boolean
+      errors:
+        type: array
+  
+  - name: duration_ms
+    type: number
+    description: 回滚执行时长（毫秒）
+  
+  - name: backup_branch
+    type: string
+    description: 备份分支名（如果创建了）
+
+# 错误处理
+errors:
+  UNCOMMITTED_CHANGES:
+    message: "存在未提交的变更，请先处理"
+    severity: warn
+    action: "提示用户处理或自动 stash"
+  
+  PUSHED_CHANGES:
+    message: "变更已推送到远程，建议使用 revert 策略"
+    severity: warn
+    action: "切换到 revert 策略"
+  
+  DEPENDENCY_CHANGED:
+    message: "依赖有变更，回滚后需要重新安装"
+    severity: info
+    action: "自动运行 npm install / pip install"
+  
+  VERIFICATION_FAILED:
+    message: "回滚后验证失败"
+    severity: error
+    action: "回滚失败，需要人工介入"
+
+# 元数据
+metadata:
+  author: Agent Studio
+  tags:
+    - governance
+    - rollback
+    - safety

package/dist/tools/definitions/std/governance/stance-review.yml

@@ -0,0 +1,149 @@
+# stance-review.yml - 立场审核步骤
+# ============================================================================
+# 类型: 治理类步骤
+# 执行方式: 调用 Agent
+# 用途: 以特定立场审核方案/代码/决策
+# 核心理念: 每个角色只站在自己的立场深入思考
+# ============================================================================
+
+name: stance-review
+stage: govern
+description: 以特定立场审核方案/代码/决策（三省六部制核心）
+category: governance
+version: 1.0.0
+
+# Agent 配置
+agent: codex
+temperature: 0.3  # 稍高温度允许更深入的思考
+
+# 可用工具
+tools:
+  - file-read
+  - define-stance
+  - validate-artifact
+
+# 输入定义
+inputs:
+  - name: stance_id
+    type: string
+    required: true
+    description: |
+      立场 ID，可选值：
+      - critic: 挑刺者（评审专家）
+      - supporter: 支持者（方案策划）
+      - decider: 决策者（项目负责人）
+      - planner: 规划者
+      - executor: 执行者（开发工程师）
+      - tester: 测试者
+      - architect: 架构师
+      - security: 安全专家
+      - performance: 性能专家
+      - auditor: 审计官
+  
+  - name: artifact_type
+    type: string
+    required: true
+    description: |
+      审核对象类型：
+      - proposal: 方案提案
+      - architecture: 架构设计
+      - code: 代码实现
+      - decision: 决策记录
+      - capability: 能力定义
+  
+  - name: artifact_content
+    type: string
+    required: true
+    description: 审核对象内容
+  
+  - name: review_criteria
+    type: array
+    description: 审核标准列表
+    default: []
+  
+  - name: previous_opinions
+    type: array
+    description: 其他立场已有的审核意见（用于参考）
+    default: []
+
+# 输出定义
+outputs:
+  - name: verdict
+    type: string
+    description: |
+      审核结论：
+      - approve: 通过
+      - reject: 封还（直接退回）
+      - request_changes: 驳正（要求修改）
+  
+  - name: opinion
+    type: string
+    description: 详细审核意见
+  
+  - name: issues
+    type: array
+    description: 发现的问题列表
+    items:
+      type: object
+      properties:
+        severity:
+          type: string
+          description: 严重程度 (critical | major | minor | suggestion)
+        category:
+          type: string
+          description: 问题分类
+        description:
+          type: string
+          description: 问题描述
+        suggestion:
+          type: string
+          description: 改进建议
+  
+  - name: suggestions
+    type: array
+    description: 改进建议列表
+
+# Prompt 模板
+prompt: |
+  你正在进行立场审核。
+  
+  ## 审核立场
+  立场 ID: {{stance_id}}
+  
+  ## 审核对象
+  类型: {{artifact_type}}
+  内容: {{artifact_content}}
+  
+  ## 审核标准
+  {{#if review_criteria}}
+  {{#each review_criteria}}
+  - {{this}}
+  {{/each}}
+  {{else}}
+  - 完整性
+  - 可行性
+  - 风险评估
+  {{/if}}
+  
+  {{#if previous_opinions}}
+  ## 其他立场意见
+  {{#each previous_opinions}}
+  **{{this.verdict}}** ({{this.stanceId}}): {{this.opinion}}
+  {{/each}}
+  {{/if}}
+  
+  请以你的立场进行审核，输出审核结果。
+
+# 执行配置
+execute:
+  type: builtin
+  handler: stance-review
+  
+# 元数据
+metadata:
+  author: Agent Studio
+  tags:
+    - governance
+    - review
+    - stance
+    - stance-isolation

package/dist/tools/definitions/std/governance/track-effect.yml

@@ -0,0 +1,199 @@
+# track-effect.yml - 效果追踪步骤
+# ============================================================================
+# 类型: 治理类步骤
+# 执行方式: 内置处理器
+# 用途: 追踪进化实现后的效果，验证是否达到预期
+# 核心理念: 指标分层、周期检查、自动回滚
+# ============================================================================
+
+name: track-effect
+stage: govern
+description: 追踪进化实现后的效果，验证是否达到预期
+category: governance
+version: 1.0.0
+
+# 执行配置
+execute:
+  type: builtin
+  handler: governance/track-effect
+
+# 输入定义
+inputs:
+  evolution_item_id:
+    type: string
+    description: 关联的进化建议 ID
+    required: true
+  
+  project_path:
+    type: path
+    description: 项目路径
+    required: true
+  
+  implementation_commit:
+    type: string
+    description: 实现该进化的 commit hash
+    required: true
+  
+  risk_level:
+    type: string
+    description: 风险等级
+    enum: [low, medium, high]
+    default: medium
+  
+  tracking_duration_hours:
+    type: number
+    description: 追踪时长（小时）
+    default: 24
+
+# 指标分层
+metrics:
+  basic:  # 基础层 - 必追踪
+    - name: error_rate
+      description: 错误率
+      source: logs/errors
+      unit: percentage
+    
+    - name: test_pass_rate
+      description: 测试通过率
+      source: test/results
+      unit: percentage
+    
+    - name: build_status
+      description: 构建状态
+      source: ci/build
+      unit: boolean
+  
+  enhanced:  # 增强层 - 可选
+    - name: response_time
+      description: 响应时间
+      source: metrics/response
+      unit: ms
+    
+    - name: memory_usage
+      description: 内存占用
+      source: metrics/memory
+      unit: MB
+    
+    - name: api_success_rate
+      description: API 成功率
+      source: metrics/api
+      unit: percentage
+
+# 检查点调度
+checkpoint_schedule:
+  immediate:
+    time: 0h
+    checks:
+      - build_status
+      - test_pass_rate
+  
+  after_1h:
+    time: 1h
+    checks:
+      - error_rate
+      - api_success_rate
+    condition: "risk_level in [medium, high]"
+  
+  after_1d:
+    time: 24h
+    checks:
+      - error_rate
+      - test_pass_rate
+      - response_time
+      - memory_usage
+    condition: "risk_level == high"
+
+# 阈值配置
+thresholds:
+  low_risk:
+    error_rate_increase: 5      # 错误率增加不超过 5%
+    test_pass_rate_drop: 5      # 测试通过率下降不超过 5%
+    critical_errors: 0          # 不允许关键错误
+  
+  medium_risk:
+    error_rate_increase: 3
+    test_pass_rate_drop: 3
+    critical_errors: 0
+  
+  high_risk:
+    error_rate_increase: 1
+    test_pass_rate_drop: 1
+    critical_errors: 0
+
+# 回滚策略
+rollback_strategy:
+  low:
+    action: notify
+    description: 通知人工处理
+  
+  medium:
+    action: notify_with_suggestion
+    description: 通知 + 建议回滚
+  
+  high:
+    action: auto_rollback
+    description: 自动回滚 + 通知
+
+# 输出定义
+outputs:
+  - name: tracking_id
+    type: string
+    description: 效果追踪记录 ID
+  
+  - name: status
+    type: string
+    enum: [pending, tracking, success, failed, rolled_back]
+    description: 追踪状态
+  
+  - name: checkpoints
+    type: array
+    description: 检查点结果
+    items:
+      type: object
+      properties:
+        scheduled_time:
+          type: string
+        actual_time:
+          type: number
+        metrics:
+          type: array
+        assessment:
+          type: string
+        issues:
+          type: array
+  
+  - name: current_metrics
+    type: object
+    description: 当前指标快照
+    properties:
+      error_rate:
+        type: object
+      test_pass_rate:
+        type: object
+      build_status:
+        type: object
+  
+  - name: rollback_decision
+    type: object
+    description: 回滚决策（如果需要）
+    properties:
+      decision:
+        type: string
+        enum: [rollback, keep, monitor]
+      reason:
+        type: string
+      triggered_by:
+        type: object
+  
+  - name: overall_assessment
+    type: string
+    enum: [success, warning, failure]
+    description: 整体评估
+
+# 元数据
+metadata:
+  author: Agent Studio
+  tags:
+    - governance
+    - effect-tracking
+    - metrics

package/dist/tools/definitions/std/governance/vote-tally.yml

@@ -0,0 +1,144 @@
+# vote-tally.yml - 投票统计步骤
+# ============================================================================
+# 类型: 治理类步骤
+# 执行方式: 内置处理器
+# 用途: 统计投票结果，计算是否通过
+# 核心理念: 绝对多数 >50%，Owner 否决权
+# ============================================================================
+
+name: vote-tally
+stage: govern
+description: 统计投票结果，计算是否通过
+category: governance
+version: 1.0.0
+
+# 执行配置
+execute:
+  type: builtin
+  handler: governance/vote-tally
+
+# 输入定义
+inputs:
+  voting_session_id:
+    type: string
+    description: 投票会话 ID
+    required: true
+  
+  force_close:
+    type: boolean
+    description: 是否强制结束投票（即使有人未投票）
+    default: false
+  
+  method:
+    type: string
+    description: 通过方式
+    enum: [simple_majority, absolute_majority, unanimous, super_majority]
+    default: absolute_majority
+  
+  threshold:
+    type: number
+    description: 通过阈值（百分比 0-100）
+    default: 50
+
+# 通过条件计算
+pass_conditions:
+  # 绝对多数（默认）
+  absolute_majority:
+    description: "赞成票权重 > 总权重 50%"
+    formula: "approve_weight / total_weight > 0.5"
+  
+  # 简单多数
+  simple_majority:
+    description: "赞成票 > 反对票"
+    formula: "approve_count > reject_count"
+  
+  # 全票通过
+  unanimous:
+    description: "所有人赞成（弃权不计）"
+    formula: "approve_count == actual_voters - abstain_count"
+  
+  # 超级多数
+  super_majority:
+    description: "赞成票 > 总权重 66.7%"
+    formula: "approve_weight / total_weight > 0.667"
+
+# 否决权检查
+veto_check:
+  description: "如果有否决权投反对，直接否决"
+  formula: "any(vote == 'reject' and weight == 'veto')"
+
+# 法定人数检查
+quorum_check:
+  description: "投票人数需要达到最低要求"
+  default_quorum: 0.5  # 默认 50% 参与率
+
+# 输出定义
+outputs:
+  - name: decision
+    type: string
+    description: 最终决策
+    enum: [approved, rejected, no_quorum, vetoed, pending]
+  
+  - name: statistics
+    type: object
+    description: 投票统计
+    properties:
+      total_participants:
+        type: number
+      actual_voters:
+        type: number
+      approve_count:
+        type: number
+      reject_count:
+        type: number
+      abstain_count:
+        type: number
+      approve_weight:
+        type: number
+      reject_weight:
+        type: number
+  
+  - name: checks
+    type: object
+    description: 条件检查结果
+    properties:
+      quorum_met:
+        type: boolean
+      threshold_met:
+        type: boolean
+      veto_exercised:
+        type: boolean
+  
+  - name: vote_breakdown
+    type: array
+    description: 详细投票记录
+    items:
+      type: object
+      properties:
+        voter_id:
+          type: string
+        vote:
+          type: string
+        weight:
+          type: number
+        reason:
+          type: string
+  
+  - name: voting_session
+    type: object
+    description: 完整投票会话信息
+
+# 决策优先级
+decision_priority:
+  1_vetoed: "如果有否决权投反对 → vetoed"
+  2_no_quorum: "如果未达法定人数 → no_quorum"
+  3_threshold: "检查通过阈值 → approved/rejected"
+  4_pending: "投票未结束 → pending"
+
+# 元数据
+metadata:
+  author: Agent Studio
+  tags:
+    - governance
+    - voting
+    - tally

package/dist/tools/definitions/std/patch/execute.yml

@@ -0,0 +1,51 @@
+# patch/execute - 执行 Patch 修改
+#
+# 输入：
+#   - project_path: 项目路径
+#   - description: 修改描述
+#
+# 输出：
+#   - result: 修改结果摘要
+
+id: patch/execute
+stage: fix
+name: 执行 Patch
+description: 执行简单的配置/文案修改
+category: patch
+agent: codex
+
+# 输入定义
+inputs:
+  project_path:
+    type: string
+    description: 项目路径
+    required: true
+  description:
+    type: string
+    description: 修改描述
+    required: true
+
+# 输出定义
+outputs:
+  - name: result
+    type: string
+    description: 修改结果摘要
+
+# Agent Prompt
+prompt: |
+  你是一个极简修改助手。请执行以下修改：
+  
+  **修改描述**: {{description}}
+  
+  **要求**：
+  1. 只修改必要的文件
+  2. 不修改逻辑代码
+  3. 修改完成后简要说明改动
+  
+  **项目路径**: {{project_path}}
+  
+  请直接执行修改，不需要询问确认。
+
+# 配置
+temperature: 0.1
+timeout: 120  # 2 分钟