更新日志

面向用户的亮点，从新到旧。每个版本的完整条目——包括内部改动和仅面向贡献者的改动——请查看 GitHub releases 和 docs/CHANGELOG.md。本站的版本徽章对应最新一次 npm 发布。

0.9 起的版本按 minor 聚合。

0.14

• 破坏性变更——Codex 委派模式的整个配置面已移除。 安装器/配置选项、SessionStart 常驻授权、自然语言委派推断，以及所有 fleet 回退全部删除。/delegate 和 /parallel 作为 prompt 起始的类型化命令保留；原生 Codex spawn_agent 配合实际安装的 agent_type，现在是 fleet 身份和生命周期的唯一权威。
• 破坏性变更——MCP 配置只有一个存储权威。 repo 级作用域已退役，配置现在只存在于用户级。
• 新增 reverse-skill-router，作为推荐的、仅显式启用的外部 skill（--with-reverse-skill），不含在任何 profile 里；外部 provider 由 catalog 驱动、按 commit 锁定，并在投影到宿主之前做完整性校验。
• 强制的 archctx / archctx-contracts 闭包升到 0.4.2。repo-harness update 会核对并回读这个闭包，同时传递 ArchContext 精确的 Node >=24 <26 运行时契约。
• 修复：MCP 会话达到上限时，回收最久未使用的空闲 Streamable HTTP 会话，正在处理中的会话不受影响；/health 现在会报告会话生命周期计数。
• 架构图产物只认 Markdown Mermaid 围栏块。 独立 HTML 的发现逻辑和 handoff 字段已从 runtime、脚手架和生成的 contract 中移除。外部 Mermaid skill 仅作为编写/审阅辅助保留，不是 runtime 或 npm 依赖。
• 本仓库的 capability 权威切换到 archcontext 节点。
• 修复：init 和 setup-global 构造命令时基于 process.env 而非空对象，构造出的命令能继承你真实的环境变量。

0.13

• 长任务续跑协议。 state next（六条确定性只读路由）和 state attempt（活性账本）配合无进展熔断器，加上崩溃可恢复的 closeout journal——带每个 worktree 的原子所有权声明，以及用于 contract worktree 和 ship worktree 收尾的显式 recover inspect|abort|reconcile。
• 安全修复——.repo-harness/ 现在按整个目录忽略。 之前的 gitignore 投影只列了两条失效的单文件条目，导致 MCP server 写在 <repo>/.repo-harness/ 下的四个文件——包括存放 OAuth access/refresh token 的 mcp.oauth-tokens.json——对于没有先用 repo 作用域跑过 mcp setup chatgpt 就直接启动 repo-harness mcp serve --transport http 的用户来说，一直处于未被忽略的状态。
• repo-harness-hook 以预构建单文件 bundle 发布。 从 registry 重装现在是原子地替换一个文件，重装窗口期内触发的 hook 不会再解析到替换了一半的 import 图，也就不会挂到宿主的 30 秒超时。
• 修复：正在活跃刷新的 MCP OAuth client 只要还持有有效 token，就不会在 30 天 TTL 时被删除——ChatGPT connector 不用再周期性重新授权。闲置超过 30 天的 client 仍然正常过期。
• 验证预算从 600 秒提到 1200 秒；失败 criterion 的 runner 日志现在保留在 .ai/harness/runs/，不再随本轮临时目录一起销毁。

0.12

• 破坏性变更——repo-harness adopt 已移除。 仓库内接入现在用 repo-harness init，全局 bootstrap 只用 repo-harness install。
• Codex App Threads 成为锁定模型的主委派路由，native 回退 fail-closed。
• SessionStart 铸造的单一 run identity 现在贯穿 hook 遥测和证据关联。
• agent-fleet 漂移检测变为 receipt-aware，并保留仓库自有的角色映射。
• 五语言 README 重构为 get-started 优先的布局。

0.11

• ChatGPT delegate 模式——仓库自有的双 agent GPT Pro 协作协议，按宿主区分传输方式（Claude 走 Oracle consult/continue 链，Codex 走内置浏览器），并在任何 session 或 provider 副作用发生之前，对实际渲染出的 prompt bundle 强制执行 fail-closed 的 Gitleaks 出口扫描。
• minimal/full 宿主 profile（默认 full）、显式的 protocol-1 迁移、随 profile 变化的 Codex hook 投影，以及用户自管 agent-fleet 的保留。
• checks/latest.json 只从证据账本 materialize，此前所有直接写入路径都在同一个包里删除。
• skill 表面发现切换到 manifest v2。
• 修复：macOS Bash 3.2 下的主 worktree 发布、证据创世的不可变性，以及 QA 分数归一化。

0.10

• 工作流中现在强制本地 merge gate。
• 新增 ChatGPT coding MCP profile 和 agent-fleet 专家角色，native 自定义 agent 的角色路由通过 SubagentStart 证据验证。
• 可按仓库配置 deploy-sql 根目录和命名策略。
• 接入流程改用事务式 TypeScript planner；Bun 基线升到 1.3.14。

0.9

• bugfix 任务 profile，带一等公民的 Root Cause Evidence 校验——runner 和 verifier 各自独立地评估同一份 ## Root Cause Evidence 段落，按记录下来的复现步骤匹配修复前的失败产物。
• frontend 任务 profile，带 design-brief 校验和 capability/archcontext 边界桥接。
• agent fleet 成为一等依赖： install-agent-fleet 直接安装上游 agent 定义并生成对应的 Codex .toml 映射，默认不覆盖已有文件。
• repo-harness install --target codex|both --location global --delegation-mode auto|explicit，让全局 Codex 委派模式持久化，且不会破坏已有的配置键。
• 全局 bootstrap 在交互式终端里会先 Y/n 询问，再安装可选的外部 skills 和 CodeGraph；非 TTY 和 --json 保持不询问。
• doctor 要求 PATH 上可见的 Codex CLI 至少为 0.144.0，并且让纯 Claude 的安装不再出现无关的 Codex 警告。

0.8.1

• Oracle 是唯一受支持的 GPT Pro 浏览器路径。 实验性的 ChatGPT Chrome 扩展 / bridge provider——browser-bind 和 --provider bridge——已被移除。原生 Chrome DevTools 引擎仅作为已弃用的诊断工具保留。
• General Repo MCP 参考文档，以及一份 CodeGraph 上线手册：仓库管理、隐私/审计边界、从工作流产物读取的迁移、上线开关，以及已知限制。
• 修复：Codex Stop 决策输出不再在回合收尾时让桌面应用崩溃。

0.8.0

• Review Rubric v1 和 diff 指纹现已附加到 review、release 和 peer-acceptance 提示中。
• Review 新鲜度校验： 实现指纹过期或缺失时，会拦截 “Done” 声明，直到 /check 和 peer acceptance 重新刷新。
• Hook 资产统一归到 assets/hooks/ 下，并生成一份 self-host 投影，同时附带 tarball 和 central-install 的一致性校验。

0.7.5

• 默认 planner profile 上的 ChatGPT MCP workspaceReader——通过 reader_status、list_allowed_roots、open_workspace、tree、search_text 和 read_text 实现只读仓库访问，而不仅限于工作流文件。
• 多仓库： 通过 ~/.repo-harness/registered-repos.json 发现已注册的仓库，并用 repo_path 定向，让一个 Connector 服务于每个已接入的仓库。
• HTTP url-token 认证模式；OAuth offline_access，带 refresh-token 轮换。
• 建议性的 minimal-change hooks，覆盖 SessionStart、UserPromptSubmit、PostToolUse.edit 和 Stop，证据写入 .ai/harness/checks/minimal-change.latest.json。
• 即使在宽泛读取时，密钥 deny glob 仍然生效；遗留的 fullDiskRead: true 会 fail closed；受管 hooks 绑定到当前 git 仓库。

0.7.4

• 面向 Developer Mode 的用户级 ChatGPT MCP 配置——配置和认证位于 ~/.repo-harness/ 下。宽泛的全盘读取已弃用，转而使用已注册接入的仓库加上显式的 --allow-root 条目。
• discover_harness_repos 加上 repo_path 定向，用于 MCP 读取工具。
• Oracle 浏览器咨询的 --chatgpt-app 预选；mcp doctor 中加入 ChatGPT Connector 的调用证据。

0.7.3

• 修复：why/how 调查目标的委托提示作用域、每会话的 subagent 重试状态隔离、adopt --compact 辅助回收，以及重新运行时保留 ChatGPT MCP 绑定的 host/port。

0.7.2

• 为选定的 Chrome profile 提供 ChatGPT 原生浏览器产品会话绑定（已在 0.8.1 由 Oracle 取代）。
• Oracle 浏览器 provider 心跳：--heartbeat，默认 59 秒，让长时间的 GPT Pro 运行保持可观测。