harness-engineering-agent 0.1.8 → 0.2.0

package/README.md

@@ -15,13 +15,15 @@ Harness 是确定性的控制平面，内部 Agent 是受约束的概率执行
 - 自然语言请求先进入内部 Intake Session，转换为严格 JSON intent，再由确定性的 RunController 执行对应操作。
 - `chat.message` 采用两阶段非阻塞流程：前台先返回包含真实 `runId` 和初始状态的 synthetic 受理结果，协调工作在后台运行；后台完成后再向同一父会话补发 Harness 内部完成消息，供 `harness` Agent 做最终总结。
 - 所有内部 Session 显式绑定到 Harness 自有 agent，并同时保留稳定兼容 ID 与英文显示名映射。
+- **8 个 Agent 遵循版本化能力合同**（`HARNESS_TOOL_CAPABILITY_VERSION = "1.0.0"`），工具权限按角色白名单分配，输出必须符合版本化 JSON Schema。
 - Git 基线、脏工作区、外部修改、scope drift、merge conflict 与 verification evidence gap 全部由 Controller 的确定性状态机保护，不能被 Agent 自报绕过。
 - 验证命令通过结构化 argv、`shell: false`、工作区包含校验、嵌套解释器/包管理器绕过检查和审批元数据约束执行，不接受 Agent 自报"已通过"替代命令证据。
 - `resume` 会从 `.harness/runs/<run-id>/` 的快照与事件恢复上下文，不会重复已完成 Task 或丢失既有 evidence。
+- **稳定 criterionId 和逐项证据追踪**：每个验收项（`criterionId`）从需求到 Task 覆盖、TaskReview、RunAcceptance 全程追踪，确保证据链完整。
 
 ## 正常主链
 
-需求从自然语言开始，经过结构化、规划、执行、验证、验收，最终生成报告：
+需求从自然语言开始，经过结构化、两阶段规划、两阶段审查、执行、验证、Run 级验收，最终生成报告：
 
 ```
 用户自然语言
@@ -33,19 +35,22 @@ Harness 是确定性的控制平面，内部 Agent 是受约束的概率执行
   Nuwa (Intake) ── 结构化 HarnessIntent；start 携带 Requirement
     |
     v
-  Fuxi (Planner) ── TaskGraph JSON
+  Fuxi (Planner) ── 两阶段规划：ContextPackage → PlanReview（含 TaskGraph）
     |
     v
-  Luban (Worker) ── 在 allowedPaths 内实现任务
+  Zhulong (Verifier) ── 两阶段审查：PlanReview → 逐 Task TaskReview
+    |
+    v
+  Luban (Worker) ── 按 executionCategory 路由，在 allowedPaths 内实现任务
     |
     v
   确定性验证 (Controller 执行命令)
     |
     v
-  Zhulong (Verifier) ── 依据 evidence 判定
+  Run 级 integration verification
     |
     v
-  Yinglong (Acceptance) ── 检查 requirement/task/evidence 闭环
+  Yinglong (Acceptance) ── 所有 Task 和 Run 级验证通过后，执行一次性 RunAcceptance
     |
     v
   最终报告 (final-report.md)
@@ -59,32 +64,34 @@ Harness 是确定性的控制平面，内部 Agent 是受约束的概率执行
 失败证据
     |
     v
-  Xingtian (Failure Analyzer) ── 分类根因，给出恢复建议
+  Xingtian (Failure Analyzer) ── 可先请求受控只读诊断探针，确认根因后分类
     |
-    v (需要修复时)
-  Jingwei (Repair Worker) ── 生成受限 Repair Task，不直接改代码
+    v (根因确认且需要修复时)
+  Jingwei (Repair Worker) ── 基于 rootCauseFingerprint 生成收窄 RepairTask
     |
     v
-  Luban (Worker) ── 在受限范围内执行修复
+  Luban (Worker) ── 在受限 allowedPaths 内执行修复
     |
     v
-  重新验证 ──> Zhulong ──> Yinglong ──> 报告或再次归因
+  重新验证 ──> Zhulong（逐 Task TaskReview）──> Yinglong（RunAcceptance）──> 报告或再次归因
 ```
 
-每个 Task 拥有有限 retry budget。预算耗尽后进入 `PAUSED` 或 `FAILED`，不会无限循环。
+每个 Task 拥有有限 retry budget。预算耗尽后进入 `PAUSED` 或 `FAILED`，不会无限循环。RepairTask 包含 `version` 字段跟踪修复迭代，`rootCauseFingerprint` 用于去重。
 
 ## Agent 总览表
 
+8 个 Agent 均遵循版本化能力合同（`HARNESS_TOOL_CAPABILITY_VERSION = "1.0.0"`），工具权限按角色白名单分配，输出必须符合版本化 JSON Schema。
+
 | 英文名 | 中文名 | 稳定 ID | Session role | 写权限 | 主要产物 |
 |---|---|---|---|---|---|
 | Harness | 工程总控 | `harness` | primary | 无（只读呈现） | 用户交互摘要、运行状态展示 |
 | Nuwa | 女娲，需求塑形智能体 | `harness-intake` | `intake` | 只读 | HarnessIntent JSON；start Requirement |
-| Fuxi | 伏羲，规划编排智能体 | `harness-planner` | `planner` | 只读 | TaskGraph JSON |
+| Fuxi | 伏羲，规划编排智能体 | `harness-planner` | `planner` | 只读 | ContextPackage → PlanReview（含 TaskGraph） |
 | Luban | 鲁班，实现执行智能体 | `harness-worker` | `worker` | edit/write/patch/bash | WorkerOutput JSON、代码变更 |
-| Zhulong | 烛龙，独立验证智能体 | `harness-verifier` | `verifier` | 只读 | VerifierOutput JSON |
-| Yinglong | 应龙，最终验收智能体 | `harness-acceptance` | `acceptance` | 只读 | AcceptanceOutput JSON |
-| Xingtian | 刑天，失败归因智能体 | `harness-failure-analyzer` | `failure-analyzer` | 只读 | FailureAnalyzerOutput JSON |
-| Jingwei | 精卫，修复规划智能体 | `harness-repair-worker` | `repair-worker` | 只读 | RepairTask（结构化修复建议） |
+| Zhulong | 烛龙，独立验证智能体 | `harness-verifier` | `verifier` | 只读 | PlanReview + 逐 Task TaskReview |
+| Yinglong | 应龙，最终验收智能体 | `harness-acceptance` | `acceptance` | 只读 | RunAcceptance JSON（Run 级一次性验收） |
+| Xingtian | 刑天，失败归因智能体 | `harness-failure-analyzer` | `failure-analyzer` | 只读 | FailureAnalyzerOutput JSON（可请求受控诊断探针） |
+| Jingwei | 精卫，修复规划智能体 | `harness-repair-worker` | `repair-worker` | 只读 | RepairTask（根因确认后生成收窄修复建议） |
 
 只有 `Luban` 可以 edit/write/patch/bash。其他内部 Agent 全部只读。`Jingwei` 只生成 Repair Task，不直接修改代码。
 
@@ -116,20 +123,25 @@ Harness 是确定性的控制平面，内部 Agent 是受约束的概率执行
 
 - **稳定 ID**：`harness-planner`
 - **Session role**：`planner`
-- **定位**：根据 Requirement 生成可执行、可验证的 TaskGraph。
-- **主要职责**：将 Requirement 拆解为有向无环 Task Graph，每个 Task 包含依赖、allowedPaths、verificationPlan、retryBudget 和 evidenceRefs。
+- **定位**：根据 Requirement 生成可执行、可验证的 TaskGraph，采用两阶段规划。
+- **主要职责**：
+  - **第一阶段**：生成 ContextPackage，收集仓库引用、外部引用、未解决问题和约束条件。
+  - **第二阶段**：基于 ContextPackage 生成 PlanReview，包含 TaskGraph、coverage（每个 criterionId 的任务覆盖映射）和 findings。
 - **输入**：Requirement JSON + runId。
-- **输出**：TaskGraph JSON。
+- **输出**：ContextPackage → PlanReview（含 TaskGraph JSON）。每个 Task 包含 `executionCategory`（quick/deep/visual-engineering/ultrabrain）、`allowedPaths`、`verificationPlan`、`retryBudget` 和 `acceptanceCriterionIds`。
 - **权限边界**：只读。可使用全部研究工具（Context7、grep.app、LSP），但不编辑文件、不执行 shell、不委派子 Agent。
-- **上下游关系**：上游是 Nuwa，下游是 Luban。Controller 在接受 TaskGraph 前执行结构校验（ID 唯一、依赖存在、图无环、文件范围不冲突）。
+- **上下游关系**：上游是 Nuwa，下游是 Zhulong（PlanReview）和 Luban（Task 执行）。Controller 在接受 PlanReview 前执行结构校验（ID 唯一、依赖存在、图无环、文件范围不冲突、criterionId 覆盖完整）。
 
 ### Luban（鲁班，实现执行智能体）
 
 - **稳定 ID**：`harness-worker`
 - **Session role**：`worker`
-- **定位**：唯一被允许修改代码的 Harness Agent。
-- **主要职责**：在 Task 指定的 `allowedPaths` 范围内实现代码变更，输出结构化 WorkerOutput。
-- **输入**：Task JSON + Requirement JSON + allowedPaths。
+- **定位**：唯一被允许修改代码的 Harness Agent，按 `executionCategory` 路由执行策略。
+- **主要职责**：
+  - **executionCategory 路由**：根据 Task 的 `executionCategory`（quick/deep/visual-engineering/ultrabrain）选择执行深度和验证强度。
+  - **allowedPaths 前置授权**：只能在 Task 指定的 `allowedPaths` 范围内实现代码变更。
+  - **事后对账**：Controller 验证实际 `changedPaths` 是否在 `allowedPaths` 内，超出范围触发暂停。
+- **输入**：Task JSON + Requirement JSON + allowedPaths + executionCategory。
 - **输出**：WorkerOutput JSON（包含 summary、changedPaths、verificationCommands、evidence）。
 - **权限边界**：`edit/write/patch/bash` 全部允许，`permission.edit=allow`，`permission.bash=allow`。可使用全部研究工具。必须严格遵守 allowedPaths，不得请求父会话完整历史。
 - **上下游关系**：上游是 Fuxi（通过 Controller 分发 Task），下游是确定性验证和 Zhulong。修复链中，Jingwei 生成的 Repair Task 也交回 Luban 执行。
@@ -138,45 +150,56 @@ Harness 是确定性的控制平面，内部 Agent 是受约束的概率执行
 
 - **稳定 ID**：`harness-verifier`
 - **Session role**：`verifier`
-- **定位**：独立于 Luban 的验证判定者，只依据任务与实际 evidence 判断。
-- **主要职责**：审查 Controller 执行的确定性验证结果和 evidence，输出 passed、failed 或 evidence_gap 判定。
-- **输入**：Task JSON + Requirement JSON + Evidence 列表。
-- **输出**：VerifierOutput JSON（包含 status、summary、evidenceRefs、followUp）。
+- **定位**：独立于 Luban 的验证判定者，执行两阶段审查：PlanReview 和逐 Task TaskReview。
+- **主要职责**：
+  - **PlanReview 阶段**：审查 Fuxi 的 PlanReview 输出，验证 coverage（每个 criterionId 是否被 Task 覆盖）、findings 和 reviewedTasks 的一致性。
+  - **逐 Task TaskReview 阶段**：对每个 Task 的 WorkerOutput 执行独立审查，输出 `spec-compliance`（规格符合性）和 `code-quality`（代码质量）两个维度的 verdict（pass/fail）和 findings。
+- **输入**：PlanReview + Task JSON + WorkerOutput + Evidence 列表。
+- **输出**：PlanReview 判定 + 逐 Task TaskReview JSON（包含 status、specCompliance、codeQuality、changedPaths、acceptanceCriterionIds）。
 - **权限边界**：只读。`task/edit/write/patch/bash` 全部禁用。可使用全部研究工具辅助审查，但不执行修改、不执行 shell。
-- **上下游关系**：上游是 Controller（传递 evidence），下游是 Yinglong（通过时）或 Xingtian（失败时）。Zhulong 不能修改代码。
+- **上下游关系**：上游是 Controller（传递 evidence 和 WorkerOutput），下游是 Yinglong（所有 Task 通过后）或 Xingtian（失败时）。Zhulong 不能修改代码。
 
 ### Yinglong（应龙，最终验收智能体）
 
 - **稳定 ID**：`harness-acceptance`
 - **Session role**：`acceptance`
-- **定位**：检查需求、任务和 evidence 的闭环完整性。
-- **主要职责**：验证每个需求和验收项是否都有对应 evidence 覆盖，输出 accepted、failed 或 evidence_gap 判定。
-- **输入**：Task JSON + Requirement JSON + Evidence 列表。
-- **输出**：AcceptanceOutput JSON（包含 status、summary、evidenceIds）。
+- **定位**：Run 级一次性最终验收，仅在所有 Task 的 TaskReview 和 Run 级 integration verification 全部通过后执行一次。
+- **主要职责**：
+  - **Run 级验收**：检查整个 Run 的需求、验收项和 evidence 的闭环完整性，不是逐 Task 验收。
+  - **criterionId 逐项追踪**：为每个 `criterionId` 生成 `CriterionDecision`，记录 status（accepted/blocked/waived/unknown）、关联的 taskIds、taskReviewIds、evidenceIds、failureIds 和 changedPaths。
+  - **一次性执行**：Yinglong 在整个 Run 生命周期内只执行一次 RunAcceptance，不会重复调用。
+- **输入**：Run 状态 + 所有 TaskReview + integration verification evidence + Requirement。
+- **输出**：RunAcceptance JSON（包含 status、summary、criterionDecisions）。
 - **权限边界**：只读。`task/edit/write/patch/bash` 全部禁用。可使用 grep.app 和 LSP 工具辅助审查，不使用 Context7。
-- **上下游关系**：上游是 Zhulong（验证通过后进入验收），下游是 Controller（Controller 再执行确定性 Guard Condition 决定是否进入 COMPLETED）。Yinglong 不能修改代码。
+- **上下游关系**：上游是 Zhulong（所有 TaskReview 通过后）和 Controller（integration verification 通过后），下游是 Controller（Controller 再执行确定性 Guard Condition 决定是否进入 COMPLETED）。Yinglong 不能修改代码。
 
 ### Xingtian（刑天，失败归因智能体）
 
 - **稳定 ID**：`harness-failure-analyzer`
 - **Session role**：`failure-analyzer`
-- **定位**：根据实际失败证据分类根因并给出结构化恢复建议。
-- **主要职责**：将失败分类为 `context-gap`、`requirement-ambiguity`、`dependency-blocked`、`implementation-defect`、`verification-environment`、`scope-drift`、`merge-conflict`、`model-failure`，并给出对应恢复动作。
-- **输入**：Task JSON + Requirement JSON + Failure + Evidence 列表。
-- **输出**：FailureAnalyzerOutput JSON（包含 action、category、summary、evidenceIds）。
-- **权限边界**：只读。`task/edit/write/patch/bash` 全部禁用。可使用全部研究工具辅助归因，但不执行修改。
-- **上下游关系**：上游是 Controller（传递失败证据），下游是 Jingwei（需要修复时）或 Controller（需要澄清、等待或终止时）。Xingtian 不能修改代码。
+- **定位**：根据实际失败证据分类根因并给出结构化恢复建议，可先请求受控只读诊断探针确认根因。
+- **主要职责**：
+  - **受控诊断探针**：在归因前可请求 Controller 执行受控的只读诊断命令（如日志查询、状态检查），收集额外证据确认根因，而不是仅依赖既有失败证据。
+  - **根因分类**：将失败分类为 `context-gap`、`requirement-ambiguity`、`dependency-blocked`、`implementation-defect`、`verification-environment`、`scope-drift`、`merge-conflict`、`model-failure`，并生成 `rootCauseFingerprint` 用于去重。
+  - **恢复建议**：给出对应恢复动作，只有确认根因后才允许 Jingwei 生成 RepairTask。
+- **输入**：Task JSON + Requirement JSON + Failure + Evidence 列表 + 可选诊断探针结果。
+- **输出**：FailureAnalyzerOutput JSON（包含 action、category、summary、rootCauseFingerprint、evidenceIds）。
+- **权限边界**：只读。`task/edit/write/patch/bash` 全部禁用。可使用全部研究工具辅助归因，可请求受控诊断探针，但不执行修改。
+- **上下游关系**：上游是 Controller（传递失败证据），下游是 Jingwei（需要修复时，且根因已确认）或 Controller（需要澄清、等待或终止时）。Xingtian 不能修改代码。
 
 ### Jingwei（精卫，修复规划智能体）
 
 - **稳定 ID**：`harness-repair-worker`
 - **Session role**：`repair-worker`
-- **定位**：根据失败证据输出结构化修复建议，只建议，不直接修改代码。
-- **主要职责**：分析失败原因和当前 Task 约束，生成受限的 RepairTask，包含修复步骤、影响范围和验证要求。
-- **输入**：Task JSON + Requirement JSON + Failure + Evidence 列表 + allowedPaths + retryBudget。
-- **输出**：RepairWorkerOutput JSON（包含 status、summary、repairTask、evidenceIds）。
+- **定位**：根据 Xingtian 确认的根因输出结构化修复建议，只建议，不直接修改代码。
+- **主要职责**：
+  - **根因确认前置**：只有 Xingtian 完成根因分类并生成 `rootCauseFingerprint` 后，Jingwei 才能生成 RepairTask。
+  - **收窄修复范围**：基于根因和失败证据生成受限的 RepairTask，包含 `allowedPaths`（比原 Task 更窄）、`minimalFailureSet`（最小失败验证集）和 `fullVerification`（完整验证集）。
+  - **版本化 RepairTask**：每个 RepairTask 有 `version` 字段，跟踪修复迭代。
+- **输入**：Task JSON + Requirement JSON + Failure + Evidence 列表 + Xingtian 的 rootCauseFingerprint + allowedPaths + retryBudget。
+- **输出**：RepairWorkerOutput JSON（包含 status、summary、repairTask、evidenceIds）。RepairTask 包含 `sourceTaskId`、`sourceFailureId`、`rootCauseFingerprint`、`repairEnabled`、`phaseEvidenceKinds`（red/green/refactor 三阶段）。
 - **权限边界**：只读。`task/edit/write/patch/bash` 全部禁用。可使用全部研究工具辅助分析，但明确禁止直接修改代码或调用写工具。
-- **上下游关系**：上游是 Xingtian（通过 Controller 传递失败上下文），下游是 Luban（Controller 将 RepairTask 交给 Luban 在受限范围内执行）。Jingwei 不直接修改代码。
+- **上下游关系**：上游是 Xingtian（通过 Controller 传递失败上下文和根因确认），下游是 Luban（Controller 将 RepairTask 交给 Luban 在受限范围内执行）。Jingwei 不直接修改代码。
 
 ## 权限矩阵
 
@@ -192,20 +215,34 @@ Luban / harness-worker:
 
 `harness` primary 同样只读，不使用任何研究工具。
 
-## Harness MCP 工具
+## Harness 研究工具
+
+Harness 插件直接提供 7 个原生研究工具，OpenCode 内使用**不要求另配 MCP**。工具能力版本为 `HARNESS_TOOL_CAPABILITY_VERSION = "1.0.0"`，按角色白名单分配权限。
+
+### 插件原生工具（推荐）
 
-Harness 通过本地 stdio MCP Server 提供以下只读工程工具：
+插件加载后自动注册以下工具，工具名以 `harness_` 为前缀：
 
 - `harness_context7_resolve`、`harness_context7_query`：直连 Context7 官方 HTTP API。
 - `harness_grep_app_search`：通过自研 Streamable HTTP MCP 客户端调用 grep.app 官方 `searchGitHub`。
 - `harness_lsp_status`、`harness_lsp_diagnostics`、`harness_lsp_definition`、`harness_lsp_references`：通过自研 JSON-RPC stdio 客户端访问 JDT LS 和 TypeScript Language Server。
 
-OpenCode 以 `harness` 作为 MCP Server 名称，因此最终工具名保持 `harness_*`。工具使用权限按角色分配：
+工具使用权限按角色分配：
 
 - **全部研究工具**：Fuxi（Planner）、Luban（Worker）、Zhulong（Verifier）、Xingtian（Failure Analyzer）、Jingwei（Repair Worker）。
 - **grep.app + LSP**：Yinglong（Acceptance）。
 - **不使用研究工具**：Harness（primary）、Nuwa（Intake）。
 
+### stdio MCP（外部兼容入口）
+
+对于非 OpenCode 宿主或需要独立 MCP 进程的场景，Harness 提供 stdio MCP Server：
+
+```bash
+npx -y harness-engineering-agent-mcp
+```
+
+MCP Server 注册相同的 7 个工具（`context7_resolve`、`context7_query`、`grep_app_search`、`lsp_status`、`lsp_diagnostics`、`lsp_definition`、`lsp_references`），但**不实施角色白名单**，调用方自行负责权限控制。
+
 LSP 只提供只读查询，不实现重命名或代码写入。JDT LS 数据目录位于系统临时目录，并在 MCP Server 退出时清理。
 
 Context7 默认匿名访问，可通过环境变量 `CONTEXT7_API_KEY` 提升限额。JDT LS 命令可通过 `HARNESS_JDTLS_COMMAND` 覆盖。
@@ -284,14 +321,17 @@ Git 与工作区管理：
 - Run 执行期间可在同一或其他 Harness 会话中查询、暂停、取消、恢复或生成报告
 
 ### 内部 Agent 链
-当前激活链：`Nuwa → Fuxi → Luban → deterministic verification → Zhulong → Yinglong`
+当前激活链：`Nuwa → Fuxi（ContextPackage → PlanReview）→ Zhulong（PlanReview → 逐 Task TaskReview）→ Luban → deterministic verification → Run 级 integration verification → Yinglong（RunAcceptance）`
 
-失败处理：`Xingtian` 归因 → `Jingwei` 生成修复任务 → `Luban` 有限修复
+失败处理：`Xingtian（诊断探针 + 根因确认）→ Jingwei（收窄 RepairTask）→ Luban 有限修复`
 
 ### 只读工程工具
-- **Context7**: 直连官方 HTTP API
-- **grep.app**: 通过 Streamable HTTP MCP 客户端搜索
-- **LSP**: 自研 JSON-RPC 客户端访问 JDT LS 和 TypeScript LS
+插件直接提供 7 个原生研究工具（不需要另配 MCP）：
+- **Context7**: 直连官方 HTTP API（`harness_context7_resolve`、`harness_context7_query`）
+- **grep.app**: 通过 Streamable HTTP MCP 客户端搜索（`harness_grep_app_search`）
+- **LSP**: 自研 JSON-RPC 客户端访问 JDT LS 和 TypeScript LS（`harness_lsp_status`、`harness_lsp_diagnostics`、`harness_lsp_definition`、`harness_lsp_references`）
+
+工具能力版本为 `HARNESS_TOOL_CAPABILITY_VERSION = "1.0.0"`，按角色白名单分配权限。stdio MCP 仅为外部兼容入口。
 
 ### 确定性恢复
 - 快照与事件持久化到 `.harness/runs/<run-id>/`
@@ -303,12 +343,37 @@ Git 与工作区管理：
 - 独立 git worktree 执行
 - 冲突时保留诊断 worktree refs
 
+## 配置诊断
+
+Harness 提供 `doctor` 命令用于诊断配置问题，支持人类可读和 JSON 两种输出格式：
+
+```bash
+# 人类可读输出
+harness-engineering-agent-doctor
+
+# JSON 输出
+harness-engineering-agent-doctor --json
+```
+
+doctor 命令检查以下内容：
+
+- **config**：OpenCode 配置文件是否存在
+- **package**：Harness 包入口、doctor 子路径与 MCP bin 是否正确声明
+- **compatibility**：OpenCode SDK 和 Plugin SDK 版本兼容性
+- **plugin**：Harness 插件是否正确注册，Agent 名称是否冲突
+- **agent**：将注册的 8 个 Harness Agent 是否正常
+- **tool**：Harness 能力目录包含的工具数量（当前 7 个）
+- **harness_mcp**：Harness MCP 自连接测试
+- **mcp**：其他配置的 MCP Server 连接状态（单个第三方 MCP 失败由 doctor 隔离归因，不影响整体诊断）
+
+退出码：0 表示通过，1 表示存在问题。
+
 ## 快速开始
 
 ### 环境要求
 
-- Node.js >= 18
-- pnpm >= 8
+- Node.js >= 24
+- pnpm >= 11
 - Git
 
 ### 安装依赖
@@ -332,7 +397,7 @@ OpenCode 会自动加载 `~/.config/opencode/plugins/` 下的插件。开发环
 export { server } from "/path/to/harness-engineering-agent/dist/index.js"
 ```
 
-修改插件或配置后需要重新执行 `pnpm build`，并重启 OpenCode。
+修改插件或配置后需要重新执行 `pnpm build`，并**重启 OpenCode** 使变更生效。运行中的 OpenCode 会话不会热加载插件变更。
 
 ## 发布到 npm
 
@@ -374,7 +439,24 @@ pnpm publish:npm -- --token-auth
 
 ## OpenCode npm 引用
 
-发布后在 `opencode.json` 中加载插件并注册 Harness MCP Server：
+发布后在 `opencode.json` 中加载插件。根据使用场景选择以下两种配置方式之一：
+
+### 方式一：插件-only（推荐）
+
+插件直接提供 `harness_*` 原生研究工具，不需要配置 MCP：
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["harness-engineering-agent"]
+}
+```
+
+这是最简单的配置方式。插件加载后自动注册 8 个 Harness Agent 和 7 个研究工具，按角色白名单控制权限。
+
+### 方式二：插件 + 可选 MCP（外部兼容）
+
+如果需要在 OpenCode 之外使用 Harness 研究工具（如独立脚本或其他 MCP 客户端），可以额外配置 stdio MCP：
 
 ```json
 {
@@ -391,13 +473,16 @@ pnpm publish:npm -- --token-auth
 }
 ```
 
-OpenCode 会通过包的 `./server` 导出加载专用插件入口；根入口仍保留完整 SDK 导出，供其它
-npm 调用方使用。
+注意：MCP 配置是可选的。插件已经提供了所有研究工具，MCP 仅为外部兼容入口。两者同时配置时，OpenCode 会同时加载插件工具和 MCP 工具，但插件工具已包含角色权限控制，MCP 工具不包含。
+
+OpenCode 会通过包的 `./server` 导出加载专用插件入口；根入口仍保留完整 SDK 导出，供其它 npm 调用方使用。
 
 启动后 Harness 插件注册的用户可见 Agent 只有 `harness`，并在插件注入顺序中优先显示。
 内部 Agent 仍以 `harness-intake`、`harness-planner`、`harness-worker` 等稳定 ID 注册，
 供 Harness 控制平面按角色调度，但会标记为 `hidden`，不进入用户侧 Agent/Model 选择列表。
 
+**重要**：修改插件或配置后需要重新执行 `pnpm build`，并**重启 OpenCode** 使变更生效。运行中的 OpenCode 会话不会热加载插件变更。
+
 ## 项目配置
 
 在目标项目创建 `.harness/config.yaml`：
@@ -552,7 +637,8 @@ harness-engineering-agent/
 
 - `.harness/runs/<run-id>/state.json` 使用原子替换写入，`events.jsonl` 追加持久化并带稳定幂等键。
 - `FilesystemRunStore` 在读取时重放快照后的事件，并拒绝未知 major schema version。
-- Evidence Ledger 记录 requirement、acceptance criterion、task、changed paths、verification command、输出摘要 digest 和 redaction metadata。
+- Evidence Ledger 记录 requirement、acceptance criterion（`criterionId`）、task、changed paths、verification command、输出摘要 digest 和 redaction metadata。
+- **稳定 criterionId 和逐项证据追踪**：每个 `criterionId` 从需求定义、PlanReview coverage、TaskReview、RunAcceptance criterionDecisions 全程追踪，确保证据链完整可审计。
 - Bug 修复与 `repairEnabled` Task 要求 RED/GREEN/REFACTOR 三阶段 evidence。Design Bundle 场景要求 requirement / acceptance / tasks / evidence / report 结构可追踪。
 - 最终报告汇总 `traceability`、`unfinishedTasks`、`verificationSummaries`、`failures`、`evidenceGaps` 和 `residualRisks`，不会因为 run 结束就抹平历史失败记录。
 
@@ -576,7 +662,7 @@ harness-engineering-agent/
 ```bash
 pnpm typecheck                    # 类型检查
 pnpm lint                         # Biome lint
-pnpm test                         # Vitest 测试（当前 176 个测试全部通过，单 worker 模式）
+pnpm test                         # Vitest 测试（当前 303 个测试全部通过，47 个测试文件）
 pnpm build                        # 构建
 ```
 

package/dist/agent/harness-agent-capabilities.d.ts

@@ -0,0 +1,4 @@
+export { buildCapabilityPermission, buildCapabilityPrompt, buildCapabilityToolConfig, buildRoleSystemPrompts, buildSessionToolAllowlist, findUnauthorizedSuggestedSignal, getHarnessAgentCapability, getHarnessSessionCapability, } from "./harness-agent-capability-builders.js";
+export { HARNESS_AGENT_CAPABILITIES } from "./harness-agent-capability-data.js";
+export { type BuiltinToolName, HARNESS_AGENT_CAPABILITY_VERSION, type HarnessAgentCapability, type HarnessCapabilityPermissionConfig, type HarnessCapabilitySignalIssue, type HarnessCapabilityToolConfig, type OutputContract, type PermissionValue, type SuggestionContract, } from "./harness-agent-capability-types.js";
+//# sourceMappingURL=harness-agent-capabilities.d.ts.map

package/dist/agent/harness-agent-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-agent-capabilities.d.ts","sourceRoot":"","sources":["../../src/agent/harness-agent-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,+BAA+B,EAC/B,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAA;AAC/E,OAAO,EACL,KAAK,eAAe,EACpB,gCAAgC,EAChC,KAAK,sBAAsB,EAC3B,KAAK,iCAAiC,EACtC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,qCAAqC,CAAA"}

package/dist/agent/harness-agent-capabilities.js

@@ -0,0 +1,4 @@
+export { buildCapabilityPermission, buildCapabilityPrompt, buildCapabilityToolConfig, buildRoleSystemPrompts, buildSessionToolAllowlist, findUnauthorizedSuggestedSignal, getHarnessAgentCapability, getHarnessSessionCapability, } from "./harness-agent-capability-builders.js";
+export { HARNESS_AGENT_CAPABILITIES } from "./harness-agent-capability-data.js";
+export { HARNESS_AGENT_CAPABILITY_VERSION, } from "./harness-agent-capability-types.js";
+//# sourceMappingURL=harness-agent-capabilities.js.map

package/dist/agent/harness-agent-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-agent-capabilities.js","sourceRoot":"","sources":["../../src/agent/harness-agent-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,EACzB,+BAA+B,EAC/B,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAA;AAC/E,OAAO,EAEL,gCAAgC,GAQjC,MAAM,qCAAqC,CAAA"}

package/dist/agent/harness-agent-capability-builders.d.ts

@@ -0,0 +1,11 @@
+import { type HarnessSessionRole } from "../session/contracts.js";
+import type { HarnessAgentCapability, HarnessCapabilityPermissionConfig, HarnessCapabilitySignalIssue, HarnessCapabilityToolConfig } from "./harness-agent-capability-types.js";
+export declare const buildCapabilityPrompt: (capability: HarnessAgentCapability) => string;
+export declare const buildCapabilityPermission: (capability: HarnessAgentCapability) => HarnessCapabilityPermissionConfig;
+export declare const buildCapabilityToolConfig: (capability: HarnessAgentCapability) => HarnessCapabilityToolConfig;
+export declare const buildRoleSystemPrompts: () => Record<HarnessSessionRole, string>;
+export declare const buildSessionToolAllowlist: (role: HarnessSessionRole) => HarnessCapabilityToolConfig;
+export declare const findUnauthorizedSuggestedSignal: (role: string, value: unknown) => HarnessCapabilitySignalIssue | undefined;
+export declare const getHarnessAgentCapability: (agentId: string) => HarnessAgentCapability;
+export declare const getHarnessSessionCapability: (role: HarnessSessionRole) => HarnessAgentCapability;
+//# sourceMappingURL=harness-agent-capability-builders.d.ts.map

package/dist/agent/harness-agent-capability-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-agent-capability-builders.d.ts","sourceRoot":"","sources":["../../src/agent/harness-agent-capability-builders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEvF,OAAO,KAAK,EACV,sBAAsB,EACtB,iCAAiC,EACjC,4BAA4B,EAC5B,2BAA2B,EAC5B,MAAM,qCAAqC,CAAA;AAE5C,eAAO,MAAM,qBAAqB,GAAI,YAAY,sBAAsB,KAAG,MACxC,CAAA;AAEnC,eAAO,MAAM,yBAAyB,GACpC,YAAY,sBAAsB,KACjC,iCAGD,CAAA;AAEF,eAAO,MAAM,yBAAyB,GACpC,YAAY,sBAAsB,KACjC,2BAKF,CAAA;AAED,eAAO,MAAM,sBAAsB,QAAO,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAsBzE,CAAA;AAEF,eAAO,MAAM,yBAAyB,GACpC,MAAM,kBAAkB,KACvB,2BAIF,CAAA;AAED,eAAO,MAAM,+BAA+B,GAC1C,MAAM,MAAM,EACZ,OAAO,OAAO,KACb,4BAA4B,GAAG,SAYjC,CAAA;AAED,eAAO,MAAM,yBAAyB,GAAI,SAAS,MAAM,KAAG,sBAI3D,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAI,MAAM,kBAAkB,KAAG,sBAItE,CAAA"}

package/dist/agent/harness-agent-capability-builders.js

@@ -0,0 +1,57 @@
+import { HARNESS_SESSION_ROLE } from "../session/contracts.js";
+import { HARNESS_AGENT_CAPABILITIES } from "./harness-agent-capability-data.js";
+export const buildCapabilityPrompt = (capability) => capability.promptLines.join("\n");
+export const buildCapabilityPermission = (capability) => ({
+    edit: capability.permission.edit,
+    bash: capability.permission.bash,
+});
+export const buildCapabilityToolConfig = (capability) => {
+    const tools = {};
+    for (const [name, enabled] of Object.entries(capability.builtins))
+        tools[name] = enabled;
+    for (const name of capability.pluginTools)
+        tools[name] = true;
+    return tools;
+};
+export const buildRoleSystemPrompts = () => ({
+    [HARNESS_SESSION_ROLE.intake]: buildCapabilityPrompt(getHarnessSessionCapability(HARNESS_SESSION_ROLE.intake)),
+    [HARNESS_SESSION_ROLE.planner]: buildCapabilityPrompt(getHarnessSessionCapability(HARNESS_SESSION_ROLE.planner)),
+    [HARNESS_SESSION_ROLE.worker]: buildCapabilityPrompt(getHarnessSessionCapability(HARNESS_SESSION_ROLE.worker)),
+    [HARNESS_SESSION_ROLE.verifier]: buildCapabilityPrompt(getHarnessSessionCapability(HARNESS_SESSION_ROLE.verifier)),
+    [HARNESS_SESSION_ROLE.acceptance]: buildCapabilityPrompt(getHarnessSessionCapability(HARNESS_SESSION_ROLE.acceptance)),
+    [HARNESS_SESSION_ROLE.failureAnalyzer]: buildCapabilityPrompt(getHarnessSessionCapability(HARNESS_SESSION_ROLE.failureAnalyzer)),
+    [HARNESS_SESSION_ROLE.repairWorker]: buildCapabilityPrompt(getHarnessSessionCapability(HARNESS_SESSION_ROLE.repairWorker)),
+});
+export const buildSessionToolAllowlist = (role) => {
+    const capability = HARNESS_AGENT_CAPABILITIES.find((item) => item.sessionRole === role);
+    if (capability === undefined)
+        throw new TypeError(`unknown Harness session capability: ${role}`);
+    return buildCapabilityToolConfig(capability);
+};
+export const findUnauthorizedSuggestedSignal = (role, value) => {
+    const capability = HARNESS_AGENT_CAPABILITIES.find((item) => item.sessionRole === role);
+    if (capability === undefined || typeof value !== "object" || value === null)
+        return undefined;
+    const status = Reflect.get(value, "status");
+    if (typeof status === "string" && !capability.suggestions.status.includes(status)) {
+        return { field: "status", value: status, allowedValues: capability.suggestions.status };
+    }
+    const action = Reflect.get(value, "action");
+    if (typeof action === "string" && !capability.suggestions.action.includes(action)) {
+        return { field: "action", value: action, allowedValues: capability.suggestions.action };
+    }
+    return undefined;
+};
+export const getHarnessAgentCapability = (agentId) => {
+    const capability = HARNESS_AGENT_CAPABILITIES.find((item) => item.agentId === agentId);
+    if (capability === undefined)
+        throw new TypeError(`unknown Harness agent capability: ${agentId}`);
+    return capability;
+};
+export const getHarnessSessionCapability = (role) => {
+    const capability = HARNESS_AGENT_CAPABILITIES.find((item) => item.sessionRole === role);
+    if (capability === undefined)
+        throw new TypeError(`unknown Harness session capability: ${role}`);
+    return capability;
+};
+//# sourceMappingURL=harness-agent-capability-builders.js.map

package/dist/agent/harness-agent-capability-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-agent-capability-builders.js","sourceRoot":"","sources":["../../src/agent/harness-agent-capability-builders.ts"],"names":[],"mappings":"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"}

package/dist/agent/harness-agent-capability-data.d.ts

@@ -0,0 +1,3 @@
+import { type HarnessAgentCapability } from "./harness-agent-capability-types.js";
+export declare const HARNESS_AGENT_CAPABILITIES: readonly HarnessAgentCapability[];
+//# sourceMappingURL=harness-agent-capability-data.d.ts.map

package/dist/agent/harness-agent-capability-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-agent-capability-data.d.ts","sourceRoot":"","sources":["../../src/agent/harness-agent-capability-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,qCAAqC,CAAA;AAwB5C,eAAO,MAAM,0BAA0B,EAAE,SAAS,sBAAsB,EACb,CAAA"}

package/dist/agent/harness-agent-capability-data.js

@@ -0,0 +1,23 @@
+import { HARNESS_AGENT_CAPABILITY_VERSION, } from "./harness-agent-capability-types.js";
+import { HARNESS_ROLE_CAPABILITY_DIRECTORY } from "./harness-role-capability-directory-data.js";
+const capability = (input) => ({
+    version: HARNESS_AGENT_CAPABILITY_VERSION,
+    agentId: input.agentId,
+    displayName: input.displayName,
+    description: input.description,
+    mode: input.mode,
+    hidden: input.hidden,
+    profileKey: input.profileKey,
+    ...(input.sessionRole === undefined ? {} : { sessionRole: input.sessionRole }),
+    responsibilities: input.responsibilities,
+    inputContext: input.inputContext,
+    builtins: input.builtins,
+    permission: input.permission,
+    outputContract: input.outputContract,
+    budget: input.budget,
+    suggestions: input.suggestions,
+    promptLines: input.promptLines,
+    pluginTools: input.pluginTools,
+});
+export const HARNESS_AGENT_CAPABILITIES = HARNESS_ROLE_CAPABILITY_DIRECTORY.entries.map(capability);
+//# sourceMappingURL=harness-agent-capability-data.js.map

package/dist/agent/harness-agent-capability-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-agent-capability-data.js","sourceRoot":"","sources":["../../src/agent/harness-agent-capability-data.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,GAEjC,MAAM,qCAAqC,CAAA;AAE5C,OAAO,EAAE,iCAAiC,EAAE,MAAM,6CAA6C,CAAA;AAE/F,MAAM,UAAU,GAAG,CAAC,KAA0C,EAA0B,EAAE,CAAC,CAAC;IAC1F,OAAO,EAAE,gCAAgC;IACzC,OAAO,EAAE,KAAK,CAAC,OAAO;IACtB,WAAW,EAAE,KAAK,CAAC,WAAW;IAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;IAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,MAAM,EAAE,KAAK,CAAC,MAAM;IACpB,UAAU,EAAE,KAAK,CAAC,UAAU;IAC5B,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;IAC9E,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;IACxC,YAAY,EAAE,KAAK,CAAC,YAAY;IAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;IACxB,UAAU,EAAE,KAAK,CAAC,UAAU;IAC5B,cAAc,EAAE,KAAK,CAAC,cAAc;IACpC,MAAM,EAAE,KAAK,CAAC,MAAM;IACpB,WAAW,EAAE,KAAK,CAAC,WAAW;IAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;IAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;CAC/B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,0BAA0B,GACrC,iCAAiC,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA"}

package/dist/agent/harness-agent-capability-types.d.ts

@@ -0,0 +1,50 @@
+import type { HarnessAgentId, HarnessSessionRole } from "../session/contracts.js";
+export declare const HARNESS_AGENT_CAPABILITY_VERSION: "1.0.0";
+declare const BUILTIN_TOOL_NAMES: readonly ["task", "edit", "bash", "write", "patch"];
+export type BuiltinToolName = (typeof BUILTIN_TOOL_NAMES)[number];
+export type PermissionValue = "allow" | "deny";
+export type OutputContract = {
+    readonly schemaVersion: "1.0.0";
+    readonly type: string;
+};
+export type SuggestionContract = {
+    readonly status: readonly string[];
+    readonly action: readonly string[];
+};
+export type HarnessAgentCapability = {
+    readonly version: typeof HARNESS_AGENT_CAPABILITY_VERSION;
+    readonly agentId: HarnessAgentId;
+    readonly displayName: string;
+    readonly description: string;
+    readonly mode: "primary" | "all";
+    readonly hidden: boolean;
+    readonly profileKey: "harness" | "planner" | "worker" | "verifier" | "acceptance" | "failureAnalyzer";
+    readonly sessionRole?: HarnessSessionRole;
+    readonly responsibilities: readonly string[];
+    readonly inputContext: readonly string[];
+    readonly builtins: Readonly<Record<BuiltinToolName, boolean>>;
+    readonly permission: {
+        readonly edit: PermissionValue;
+        readonly bash: PermissionValue;
+    };
+    readonly outputContract: OutputContract | null;
+    readonly budget: {
+        readonly summary: string;
+        readonly dimensions: readonly string[];
+    };
+    readonly suggestions: SuggestionContract;
+    readonly promptLines: readonly string[];
+    readonly pluginTools: readonly string[];
+};
+export type HarnessCapabilitySignalIssue = {
+    readonly field: "status" | "action";
+    readonly value: string;
+    readonly allowedValues: readonly string[];
+};
+export type HarnessCapabilityToolConfig = Readonly<Record<string, boolean>>;
+export type HarnessCapabilityPermissionConfig = {
+    readonly edit: PermissionValue;
+    readonly bash: PermissionValue;
+};
+export {};
+//# sourceMappingURL=harness-agent-capability-types.d.ts.map

package/dist/agent/harness-agent-capability-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-agent-capability-types.d.ts","sourceRoot":"","sources":["../../src/agent/harness-agent-capability-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjF,eAAO,MAAM,gCAAgC,EAAG,OAAgB,CAAA;AAEhE,QAAA,MAAM,kBAAkB,qDAAsD,CAAA;AAE9E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AACjE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,CAAA;AAC9C,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AACvF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,gCAAgC,CAAA;IACzD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,UAAU,EACf,SAAS,GACT,SAAS,GACT,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,iBAAiB,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAA;IACzC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAA;IAC7D,QAAQ,CAAC,UAAU,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;KAAE,CAAA;IACvF,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAA;IAC9C,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAA;IACrF,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAA;IACxC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CACxC,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1C,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAC3E,MAAM,MAAM,iCAAiC,GAAG;IAC9C,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAC/B,CAAA"}

package/dist/agent/harness-agent-capability-types.js

@@ -0,0 +1,3 @@
+export const HARNESS_AGENT_CAPABILITY_VERSION = "1.0.0";
+const BUILTIN_TOOL_NAMES = ["task", "edit", "bash", "write", "patch"];
+//# sourceMappingURL=harness-agent-capability-types.js.map

package/dist/agent/harness-agent-capability-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-agent-capability-types.js","sourceRoot":"","sources":["../../src/agent/harness-agent-capability-types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gCAAgC,GAAG,OAAgB,CAAA;AAEhE,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAU,CAAA"}

package/dist/agent/harness-role-capability-directory-data.d.ts

@@ -0,0 +1,3 @@
+import { type HarnessRoleCapabilityDirectory } from "./harness-role-capability-directory.js";
+export declare const HARNESS_ROLE_CAPABILITY_DIRECTORY: HarnessRoleCapabilityDirectory;
+//# sourceMappingURL=harness-role-capability-directory-data.d.ts.map

package/dist/agent/harness-role-capability-directory-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-role-capability-directory-data.d.ts","sourceRoot":"","sources":["../../src/agent/harness-role-capability-directory-data.ts"],"names":[],"mappings":"AAmBA,OAAO,EAML,KAAK,8BAA8B,EAGpC,MAAM,wCAAwC,CAAA;AAO/C,eAAO,MAAM,iCAAiC,gCAgNH,CAAA"}