harness-engineering-agent 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 YiLaoWei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,191 @@
+# Harness Engineering Agent
+
+面向复杂项目工程的 OpenCode 自动开发插件。
+
+该插件采用全局安装、按项目配置的运行方式，通过专用 primary `harness` Agent 与内部 Harness agent set 协调完成需求拆解、实现、确定性校验、有限重试和最终报告，不依赖 Sisyphus、OMO 或 OpenSpec 运行时。
+
+## 当前能力
+
+- 选择 `harness` Agent 后，使用自然语言发起 `start`、`status`、`resume`、`pause`、`cancel`、`answer`、`waive`、`report` 生命周期操作。
+- 插件只在当前消息的 `agent === "harness"` 时触发 Harness 协调；普通 Agent 和普通聊天不会自动拦截。
+- 自然语言请求先进入内部 Intake Session，转换为严格 JSON intent，再由确定性的 RunController 执行对应操作。
+- `chat.message` 采用两阶段非阻塞流程：前台先返回 synthetic 受理确认，协调工作在后台运行；后台完成后再向同一父会话补发 Harness 内部完成消息，供 `harness` Agent 做最终总结。
+- 所有内部 Session 都显式绑定到 Harness 自有 agent，并同时保留稳定旧 ID 与英文显示名映射。
+- 当前激活链为 `Nuwa -> Fuxi -> Luban -> deterministic verification -> Zhulong -> Yinglong`；失败时经 `Xingtian` 归因，允许自动修复时由 `Jingwei` 生成 Repair Task，再交回 `Luban` 在受限范围内执行。
+- `resume` 会从 `.harness/runs/<run-id>/` 的快照与事件恢复上下文，不会重复已完成 Task 或丢失既有 evidence。
+- Git 基线、脏工作区、外部修改、scope drift、merge conflict 与 verification evidence gap 全部由 Controller 的确定性状态机保护，不能被 Agent 自报绕过。
+- 并行仅在依赖、路径范围和验证资源都无冲突时启用，且必须在独立 git worktree 中执行；冲突或集成失败时保留诊断 worktree refs，并让主仓库 `merge --abort` 回到无 unmerged 状态。
+- 验证命令通过结构化 argv、`shell: false`、工作区包含校验、嵌套解释器/包管理器绕过检查和审批元数据约束执行，不接受 Agent 自报“已通过”替代命令证据。
+
+## 内部工程工具
+
+Harness 自研并注册以下只读工程工具，不依赖 OMO 或用户的 MCP 配置：
+
+- `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。
+
+这些工具在执行边界校验 Agent 身份，普通 OpenCode Agent 无法调用。Planner、Worker、Verifier 和 Failure Analyzer 可以使用全部研究工具；Acceptance 只使用 grep.app 与 LSP；Intake 和主 Harness Agent不使用这些工具。LSP 只提供只读查询，不实现重命名或代码写入。JDT LS 数据目录位于系统临时目录，并在插件释放时清理。
+
+Context7 默认匿名访问；可通过环境变量 `CONTEXT7_API_KEY` 提升限额。JDT LS 命令可通过 `HARNESS_JDTLS_COMMAND` 覆盖。
+
+## 构建与全局加载
+
+```bash
+pnpm install
+pnpm build
+```
+
+OpenCode 会自动加载 `~/.config/opencode/plugins/` 下的插件。开发环境可创建：
+
+```typescript
+// ~/.config/opencode/plugins/harness-engineering-agent.ts
+export { server } from "/workspace/CnbProjectSpace/harness-engineering-agent/dist/index.js"
+```
+
+修改插件或配置后需要重新执行 `pnpm build`，并重启 OpenCode。
+
+## 发布到 npm
+
+交互式发布脚本会调用 npm 官方登录流程。用户名正常显示，密码由 npm
+隐藏读取，不会作为命令参数、环境变量或脚本变量保存。账号启用 2FA 时，
+npm 会继续提示输入 OTP。
+
+先执行不发布的完整检查：
+
+```bash
+pnpm publish:npm -- --dry-run
+```
+
+确认包名和版本无误后执行真实发布：
+
+```bash
+pnpm publish:npm
+```
+
+脚本依次执行登录、版本占用检查、类型检查、Lint、测试、构建、打包预览
+和发布确认。npm 不允许覆盖已有版本，后续发布前先升级版本：
+
+```bash
+npm version patch --no-git-tag-version
+```
+
+npm registry 要求发布者启用双重验证。账号密码登录后先执行：
+
+```bash
+npm profile enable-2fa auth-and-writes
+```
+
+重新运行 `pnpm publish:npm`，发布阶段按 npm 提示输入 OTP。另一种方式是
+在 npm 网站创建 granular access token，为目标包授予 `Read and write`
+权限并启用 `Bypass 2FA`。运行脚本时隐藏输入 token：
+
+```bash
+pnpm publish:npm -- --token-auth
+```
+
+脚本将 token 临时写入权限为 `600` 的 npmrc，并仅通过
+`NPM_CONFIG_USERCONFIG` 传给 npm 子进程；`pnpm test/build` 不会继承该
+认证文件。脚本结束后自动删除。token 不会写入命令参数、shell 历史、
+项目文件或日志。该参数不能绕过 npm registry 的服务端权限校验。
+
+如果 token 曾经出现在日志、聊天或公开文件中，应立即在 npm 网站撤销并
+重新创建，不要继续使用泄露的 token。
+
+发布后在 `opencode.json` 中通过 npm 包名加载：
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["harness-engineering-agent"]
+}
+```
+
+## 项目配置
+
+在目标项目创建 `.harness/config.yaml`：
+
+```yaml
+schemaVersion: "1.0.0"
+enabled: true
+harness:
+  provider: openai
+  model: gpt-5.5
+planner:
+  provider: openai
+  model: gpt-5.5
+worker:
+  provider: deepseek
+  model: deepseek-v4-pro
+verifier:
+  provider: openai
+  model: gpt-5.5
+acceptance:
+  provider: openai
+  model: gpt-5.5
+failureAnalyzer:
+  provider: openai
+  model: gpt-5.5
+maxRunAttempts: 3
+stateDirectory: .harness/runs
+```
+
+`harness` profile 只用于专用 `harness` Agent 和内部 Intake Session；不要在这里重新引入 `maxSteps` 等 OpenCode Agent 运行时字段。
+
+`acceptance` 缺省继承 `verifier`，`failureAnalyzer` 缺省继承 `planner`。`repair-worker` 当前复用 `worker` profile，而不是单独配置项。三者都会参与实际控制链，不再只是预留配置。
+
+`stateDirectory`、任务 `allowedPaths` 和验证工作目录只能是项目内相对路径。
+
+## 使用方式
+
+1. 在 OpenCode 中选择 primary `harness` Agent。
+2. 直接发送自然语言请求，例如“启动一个 run，目标是……”“查询 run-abc 状态”“恢复 run-abc”“取消 run-abc”“生成 run-abc 报告”。
+3. `start` 请求必须能被 Intake 提炼成 title、summary、acceptanceCriteria；如果缺少必要信息，Harness 会返回 clarification 响应而不是猜测。
+4. `status`、`resume`、`cancel`、`report` 必须显式提供 `runId`；Harness 不会默认选择“最近一次运行”。
+
+## Agent 集与权限矩阵
+
+当前独立 Harness agent set 固定为：
+
+- primary：`harness`
+- internal：`Nuwa`、`Fuxi`、`Luban`、`Zhulong`、`Yinglong`、`Xingtian`、`Jingwei`
+
+角色到 agent 的单一映射：
+
+- `intake -> Nuwa`（兼容 ID：`harness-intake`）
+- `planner -> Fuxi`（兼容 ID：`harness-planner`）
+- `worker -> Luban`（兼容 ID：`harness-worker`）
+- `verifier -> Zhulong`（兼容 ID：`harness-verifier`）
+- `acceptance -> Yinglong`（兼容 ID：`harness-acceptance`）
+- `failure-analyzer -> Xingtian`（兼容 ID：`harness-failure-analyzer`）
+- `repair-worker -> Jingwei`（兼容 ID：`harness-repair-worker`）
+
+权限矩阵：
+
+- `Luban` / `harness-worker`：`task=false`，`edit/write/patch/bash=true`，`permission.edit=allow`，`permission.bash=allow`
+- 其他全部 Harness agent：`task/edit/write/patch/bash=false`，`permission.edit=deny`，`permission.bash=deny`
+
+当前确定性生命周期保持为 `intake -> planner -> worker -> deterministic verification -> verifier -> acceptance -> report`。失败路径会进入 `failure-analyzer`，必要时再进入 `repair-worker -> worker -> deterministic verification -> verifier -> acceptance` 修复闭环。
+
+## 恢复与证据
+
+- `.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。
+- Bug 修复与 `repairEnabled` Task 要求 RED/GREEN/REFACTOR 三阶段 evidence；Design Bundle 场景要求 requirement / acceptance / tasks / evidence / report 结构可追踪。
+- 最终报告会汇总 `traceability`、`unfinishedTasks`、`verificationSummaries`、`failures`、`evidenceGaps` 和 `residualRisks`，不会因为 run 结束就抹平历史失败记录。
+
+## 设计来源
+
+- Harness Engineering：将上下文、工具、状态、反馈、验证和恢复构造成模型外部的确定性控制平面。
+- Superpowers：吸收 brainstorming、writing plans、TDD、systematic debugging、subagent development 和 verification before completion 的工程纪律。
+- 自有 Harness 文档：使用 overview、architecture、specs、implementation-plan 分离动机、技术决策、行为契约和实施计划。
+
+## 设计文档
+
+- [设计概览](harness/overview.md)
+- [总体架构](harness/architecture.md)
+- [实施计划](harness/implementation-plan.md)
+- [能力规格](harness/specs/)
+
+插件运行时只依赖 OpenCode Plugin/SDK、配置解析库和目标项目自身的构建测试工具。

package/dist/config/config-defaults.d.ts

@@ -0,0 +1,32 @@
+export declare const HARNESS_CONFIG_DEFAULTS: {
+    readonly schemaVersion: "1.0.0";
+    readonly enabled: true;
+    readonly harness: {
+        readonly provider: "openai";
+        readonly model: "gpt-5.5";
+    };
+    readonly planner: {
+        readonly provider: "openai";
+        readonly model: "gpt-5.5";
+    };
+    readonly worker: {
+        readonly provider: "deepseek";
+        readonly model: "deepseek-v4-pro";
+    };
+    readonly verifier: {
+        readonly provider: "openai";
+        readonly model: "gpt-5.5";
+    };
+    readonly acceptance: {
+        readonly provider: "openai";
+        readonly model: "gpt-5.5";
+    };
+    readonly failureAnalyzer: {
+        readonly provider: "openai";
+        readonly model: "gpt-5.5";
+    };
+    readonly verificationCommands: readonly [];
+    readonly maxRunAttempts: 3;
+    readonly stateDirectory: ".harness/runs";
+};
+//# sourceMappingURL=config-defaults.d.ts.map

package/dist/config/config-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-defaults.d.ts","sourceRoot":"","sources":["../../src/config/config-defaults.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BF,CAAA"}

package/dist/config/config-defaults.js

@@ -0,0 +1,32 @@
+export const HARNESS_CONFIG_DEFAULTS = {
+    schemaVersion: "1.0.0",
+    enabled: true,
+    harness: {
+        provider: "openai",
+        model: "gpt-5.5",
+    },
+    planner: {
+        provider: "openai",
+        model: "gpt-5.5",
+    },
+    worker: {
+        provider: "deepseek",
+        model: "deepseek-v4-pro",
+    },
+    verifier: {
+        provider: "openai",
+        model: "gpt-5.5",
+    },
+    acceptance: {
+        provider: "openai",
+        model: "gpt-5.5",
+    },
+    failureAnalyzer: {
+        provider: "openai",
+        model: "gpt-5.5",
+    },
+    verificationCommands: [],
+    maxRunAttempts: 3,
+    stateDirectory: ".harness/runs",
+};
+//# sourceMappingURL=config-defaults.js.map

package/dist/config/config-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-defaults.js","sourceRoot":"","sources":["../../src/config/config-defaults.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,aAAa,EAAE,OAAO;IACtB,OAAO,EAAE,IAAI;IACb,OAAO,EAAE;QACP,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,SAAS;KACjB;IACD,OAAO,EAAE;QACP,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,SAAS;KACjB;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,iBAAiB;KACzB;IACD,QAAQ,EAAE;QACR,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,SAAS;KACjB;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,SAAS;KACjB;IACD,eAAe,EAAE;QACf,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,SAAS;KACjB;IACD,oBAAoB,EAAE,EAAE;IACxB,cAAc,EAAE,CAAC;IACjB,cAAc,EAAE,eAAe;CACC,CAAA"}

package/dist/config/config-errors.d.ts

@@ -0,0 +1,7 @@
+export declare class ConfigLoadError extends Error {
+    readonly name = "ConfigLoadError";
+    readonly sourcePath: string;
+    readonly cause: unknown;
+    constructor(sourcePath: string, cause: unknown);
+}
+//# sourceMappingURL=config-errors.d.ts.map

package/dist/config/config-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-errors.d.ts","sourceRoot":"","sources":["../../src/config/config-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAkB,IAAI,qBAAoB;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,SAAkB,KAAK,EAAE,OAAO,CAAA;gBAEpB,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAK/C"}

package/dist/config/config-errors.js

@@ -0,0 +1,11 @@
+export class ConfigLoadError extends Error {
+    name = "ConfigLoadError";
+    sourcePath;
+    cause;
+    constructor(sourcePath, cause) {
+        super(`Failed to load harness config from ${sourcePath}`, { cause });
+        this.sourcePath = sourcePath;
+        this.cause = cause;
+    }
+}
+//# sourceMappingURL=config-errors.js.map

package/dist/config/config-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-errors.js","sourceRoot":"","sources":["../../src/config/config-errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACtB,IAAI,GAAG,iBAAiB,CAAA;IACjC,UAAU,CAAQ;IACT,KAAK,CAAS;IAEhC,YAAY,UAAkB,EAAE,KAAc;QAC5C,KAAK,CAAC,sCAAsC,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;QACpE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF"}

package/dist/config/config-file.d.ts

@@ -0,0 +1,3 @@
+import { type HarnessConfigInput } from "./config-schema.js";
+export declare const readHarnessConfigFile: (sourcePath: string) => Promise<HarnessConfigInput | undefined>;
+//# sourceMappingURL=config-file.d.ts.map

package/dist/config/config-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file.d.ts","sourceRoot":"","sources":["../../src/config/config-file.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,kBAAkB,EAA4B,MAAM,oBAAoB,CAAA;AAEtF,eAAO,MAAM,qBAAqB,GAChC,YAAY,MAAM,KACjB,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAWxC,CAAA"}

package/dist/config/config-file.js

@@ -0,0 +1,31 @@
+import { readFile } from "node:fs/promises";
+import { parse as parseYaml } from "yaml";
+import { ConfigLoadError } from "./config-errors.js";
+import { HarnessConfigInputSchema } from "./config-schema.js";
+export const readHarnessConfigFile = async (sourcePath) => {
+    try {
+        const rawDocument = await readFile(sourcePath, "utf8");
+        return parseHarnessConfigDocument(sourcePath, rawDocument);
+    }
+    catch (error) {
+        if (isFileNotFoundError(error)) {
+            return undefined;
+        }
+        throw new ConfigLoadError(sourcePath, error);
+    }
+};
+const parseHarnessConfigDocument = (sourcePath, rawDocument) => {
+    try {
+        return HarnessConfigInputSchema.parse(parseYaml(rawDocument));
+    }
+    catch (error) {
+        throw new ConfigLoadError(sourcePath, error);
+    }
+};
+const isFileNotFoundError = (error) => {
+    if (typeof error !== "object" || error === null) {
+        return false;
+    }
+    return Reflect.get(error, "code") === "ENOENT";
+};
+//# sourceMappingURL=config-file.js.map

package/dist/config/config-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../../src/config/config-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE3C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAA;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAA2B,wBAAwB,EAAE,MAAM,oBAAoB,CAAA;AAEtF,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACxC,UAAkB,EACuB,EAAE;IAC3C,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;QACtD,OAAO,0BAA0B,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC,CAAA;AAED,MAAM,0BAA0B,GAAG,CACjC,UAAkB,EAClB,WAAmB,EACC,EAAE;IACtB,IAAI,CAAC;QACH,OAAO,wBAAwB,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAA;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,CAAC,KAAc,EAAW,EAAE;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,QAAQ,CAAA;AAChD,CAAC,CAAA"}

package/dist/config/config-merge.d.ts

@@ -0,0 +1,8 @@
+import type { HarnessConfig, HarnessConfigInput } from "./config-schema.js";
+import type { MergedHarnessConfig } from "./config-types.js";
+export declare const mergeHarnessConfig: ({ defaults, projectConfig, runOverride, }: {
+    readonly defaults: HarnessConfig;
+    readonly projectConfig: HarnessConfigInput | undefined;
+    readonly runOverride: HarnessConfigInput | undefined;
+}) => MergedHarnessConfig;
+//# sourceMappingURL=config-merge.d.ts.map

package/dist/config/config-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-merge.d.ts","sourceRoot":"","sources":["../../src/config/config-merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,kBAAkB,EAEnB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,mBAAmB,EAAwB,MAAM,mBAAmB,CAAA;AAElF,eAAO,MAAM,kBAAkB,GAAI,2CAIhC;IACD,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,GAAG,SAAS,CAAA;IACtD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,GAAG,SAAS,CAAA;CACrD,KAAG,mBA8CH,CAAA"}

package/dist/config/config-merge.js

@@ -0,0 +1,50 @@
+export const mergeHarnessConfig = ({ defaults, projectConfig, runOverride, }) => {
+    const projectValue = projectConfig ?? {};
+    const overrideValue = runOverride ?? {};
+    return {
+        schemaVersion: projectValue.schemaVersion ?? defaults.schemaVersion,
+        enabled: overrideValue.enabled ?? projectValue.enabled ?? defaults.enabled,
+        harness: mergeHarnessProfile({
+            defaults: defaults.harness,
+            projectProfile: projectValue.harness,
+            runOverride: overrideValue.harness,
+        }),
+        planner: mergeHarnessProfile({
+            defaults: defaults.planner,
+            projectProfile: projectValue.planner,
+            runOverride: overrideValue.planner,
+        }),
+        worker: mergeHarnessProfile({
+            defaults: defaults.worker,
+            projectProfile: projectValue.worker,
+            runOverride: overrideValue.worker,
+        }),
+        verifier: mergeHarnessProfile({
+            defaults: defaults.verifier,
+            projectProfile: projectValue.verifier,
+            runOverride: overrideValue.verifier,
+        }),
+        acceptance: mergeHarnessProfile({
+            defaults: defaults.acceptance,
+            projectProfile: projectValue.acceptance ?? projectValue.verifier,
+            runOverride: overrideValue.acceptance,
+        }),
+        failureAnalyzer: mergeHarnessProfile({
+            defaults: defaults.failureAnalyzer,
+            projectProfile: projectValue.failureAnalyzer ?? projectValue.planner,
+            runOverride: overrideValue.failureAnalyzer,
+        }),
+        verificationCommands: overrideValue.verificationCommands ??
+            projectValue.verificationCommands ??
+            defaults.verificationCommands,
+        maxRunAttempts: overrideValue.maxRunAttempts ?? projectValue.maxRunAttempts ?? defaults.maxRunAttempts,
+        stateDirectory: overrideValue.stateDirectory ?? projectValue.stateDirectory ?? defaults.stateDirectory,
+    };
+};
+const mergeHarnessProfile = ({ defaults, projectProfile, runOverride, }) => {
+    return {
+        provider: runOverride?.provider ?? projectProfile?.provider ?? defaults.provider,
+        model: runOverride?.model ?? projectProfile?.model ?? defaults.model,
+    };
+};
+//# sourceMappingURL=config-merge.js.map

package/dist/config/config-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-merge.js","sourceRoot":"","sources":["../../src/config/config-merge.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EACjC,QAAQ,EACR,aAAa,EACb,WAAW,GAKZ,EAAuB,EAAE;IACxB,MAAM,YAAY,GAAG,aAAa,IAAI,EAAE,CAAA;IACxC,MAAM,aAAa,GAAG,WAAW,IAAI,EAAE,CAAA;IAEvC,OAAO;QACL,aAAa,EAAE,YAAY,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa;QACnE,OAAO,EAAE,aAAa,CAAC,OAAO,IAAI,YAAY,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO;QAC1E,OAAO,EAAE,mBAAmB,CAAC;YAC3B,QAAQ,EAAE,QAAQ,CAAC,OAAO;YAC1B,cAAc,EAAE,YAAY,CAAC,OAAO;YACpC,WAAW,EAAE,aAAa,CAAC,OAAO;SACnC,CAAC;QACF,OAAO,EAAE,mBAAmB,CAAC;YAC3B,QAAQ,EAAE,QAAQ,CAAC,OAAO;YAC1B,cAAc,EAAE,YAAY,CAAC,OAAO;YACpC,WAAW,EAAE,aAAa,CAAC,OAAO;SACnC,CAAC;QACF,MAAM,EAAE,mBAAmB,CAAC;YAC1B,QAAQ,EAAE,QAAQ,CAAC,MAAM;YACzB,cAAc,EAAE,YAAY,CAAC,MAAM;YACnC,WAAW,EAAE,aAAa,CAAC,MAAM;SAClC,CAAC;QACF,QAAQ,EAAE,mBAAmB,CAAC;YAC5B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,cAAc,EAAE,YAAY,CAAC,QAAQ;YACrC,WAAW,EAAE,aAAa,CAAC,QAAQ;SACpC,CAAC;QACF,UAAU,EAAE,mBAAmB,CAAC;YAC9B,QAAQ,EAAE,QAAQ,CAAC,UAAU;YAC7B,cAAc,EAAE,YAAY,CAAC,UAAU,IAAI,YAAY,CAAC,QAAQ;YAChE,WAAW,EAAE,aAAa,CAAC,UAAU;SACtC,CAAC;QACF,eAAe,EAAE,mBAAmB,CAAC;YACnC,QAAQ,EAAE,QAAQ,CAAC,eAAe;YAClC,cAAc,EAAE,YAAY,CAAC,eAAe,IAAI,YAAY,CAAC,OAAO;YACpE,WAAW,EAAE,aAAa,CAAC,eAAe;SAC3C,CAAC;QACF,oBAAoB,EAClB,aAAa,CAAC,oBAAoB;YAClC,YAAY,CAAC,oBAAoB;YACjC,QAAQ,CAAC,oBAAoB;QAC/B,cAAc,EACZ,aAAa,CAAC,cAAc,IAAI,YAAY,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc;QACxF,cAAc,EACZ,aAAa,CAAC,cAAc,IAAI,YAAY,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc;KACzF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,CAAC,EAC3B,QAAQ,EACR,cAAc,EACd,WAAW,GAKZ,EAAwB,EAAE;IACzB,OAAO;QACL,QAAQ,EAAE,WAAW,EAAE,QAAQ,IAAI,cAAc,EAAE,QAAQ,IAAI,QAAQ,CAAC,QAAQ;QAChF,KAAK,EAAE,WAAW,EAAE,KAAK,IAAI,cAAc,EAAE,KAAK,IAAI,QAAQ,CAAC,KAAK;KACrE,CAAA;AACH,CAAC,CAAA"}

package/dist/config/config-schema.d.ts

@@ -0,0 +1,135 @@
+import { z } from "zod";
+import type { AvailableModelRegistry, MergedHarnessConfig } from "./config-types.js";
+declare const HarnessProfileInputSchema: z.ZodReadonly<z.ZodObject<{
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+export declare const HarnessConfigInputSchema: z.ZodReadonly<z.ZodObject<{
+    schemaVersion: z.ZodOptional<z.ZodLiteral<"1.0.0">>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    harness: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    planner: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    worker: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    verifier: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    acceptance: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    failureAnalyzer: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    verificationCommands: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+        workingDirectory: z.ZodString;
+        scope: z.ZodEnum<{
+            task: "task";
+            project: "project";
+            integration: "integration";
+        }>;
+        sideEffectLevel: z.ZodEnum<{
+            read_only: "read_only";
+            workspace_write: "workspace_write";
+            external_side_effect: "external_side_effect";
+        }>;
+        timeoutMs: z.ZodNumber;
+        origin: z.ZodOptional<z.ZodEnum<{
+            config: "config";
+            planner: "planner";
+            worker: "worker";
+            repair: "repair";
+        }>>;
+        requiresConfirmation: z.ZodOptional<z.ZodBoolean>;
+        confirmation: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+            approvedBy: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strip>>>;
+        allowedEnv: z.ZodOptional<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, z.core.$strip>>>>>;
+    maxRunAttempts: z.ZodOptional<z.ZodNumber>;
+    stateDirectory: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>>;
+export declare const HarnessProfileSchema: z.ZodReadonly<z.ZodObject<{
+    provider: z.ZodString;
+    model: z.ZodString;
+}, z.core.$strip>>;
+export declare const HarnessConfigSchema: z.ZodReadonly<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0.0">;
+    enabled: z.ZodBoolean;
+    harness: z.ZodReadonly<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strip>>;
+    planner: z.ZodReadonly<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strip>>;
+    worker: z.ZodReadonly<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strip>>;
+    verifier: z.ZodReadonly<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strip>>;
+    acceptance: z.ZodReadonly<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strip>>;
+    failureAnalyzer: z.ZodReadonly<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strip>>;
+    verificationCommands: z.ZodReadonly<z.ZodArray<z.ZodReadonly<z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+        workingDirectory: z.ZodString;
+        scope: z.ZodEnum<{
+            task: "task";
+            project: "project";
+            integration: "integration";
+        }>;
+        sideEffectLevel: z.ZodEnum<{
+            read_only: "read_only";
+            workspace_write: "workspace_write";
+            external_side_effect: "external_side_effect";
+        }>;
+        timeoutMs: z.ZodNumber;
+        origin: z.ZodOptional<z.ZodEnum<{
+            config: "config";
+            planner: "planner";
+            worker: "worker";
+            repair: "repair";
+        }>>;
+        requiresConfirmation: z.ZodOptional<z.ZodBoolean>;
+        confirmation: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+            approvedBy: z.ZodString;
+            reason: z.ZodString;
+        }, z.core.$strip>>>;
+        allowedEnv: z.ZodOptional<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, z.core.$strip>>>>;
+    maxRunAttempts: z.ZodNumber;
+    stateDirectory: z.ZodString;
+}, z.core.$strict>>;
+export type HarnessAgentProfile = z.infer<typeof HarnessProfileSchema>;
+export type HarnessConfig = z.infer<typeof HarnessConfigSchema>;
+export type HarnessConfigInput = z.infer<typeof HarnessConfigInputSchema>;
+export type HarnessProfileInput = z.infer<typeof HarnessProfileInputSchema>;
+export declare const parseHarnessConfig: (config: MergedHarnessConfig, availableModels?: AvailableModelRegistry) => HarnessConfig;
+export {};
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/config/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/config/config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAEpF,QAAA,MAAM,yBAAyB;;;mBAMlB,CAAA;AAEb,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAexB,CAAA;AAEb,eAAO,MAAM,oBAAoB;;;kBAKpB,CAAA;AAEb,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAenB,CAAA;AAEb,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACtE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AACzE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,mBAAmB,EAC3B,kBAAkB,sBAAsB,KACvC,aAIF,CAAA"}