harness-reflex 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (121) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +103 -23
  3. package/USER_GUIDE.md +121 -43
  4. package/dist/adapters/agy.js +1 -1
  5. package/dist/adapters/agy.js.map +1 -1
  6. package/dist/adapters/codex.d.ts +133 -4
  7. package/dist/adapters/codex.js +325 -2
  8. package/dist/adapters/codex.js.map +1 -1
  9. package/dist/backend/defaults.d.ts +31 -0
  10. package/dist/backend/defaults.js +32 -0
  11. package/dist/backend/defaults.js.map +1 -0
  12. package/dist/backend/jev.js +6 -5
  13. package/dist/backend/jev.js.map +1 -1
  14. package/dist/backend/mock.d.ts +12 -1
  15. package/dist/backend/mock.js +34 -0
  16. package/dist/backend/mock.js.map +1 -1
  17. package/dist/backend/simple-jev.js +5 -4
  18. package/dist/backend/simple-jev.js.map +1 -1
  19. package/dist/backend/types.d.ts +34 -0
  20. package/dist/backend/types.js.map +1 -1
  21. package/dist/cli/index.js +5 -3
  22. package/dist/cli/index.js.map +1 -1
  23. package/dist/core/closing.d.ts +90 -0
  24. package/dist/core/closing.js +111 -0
  25. package/dist/core/closing.js.map +1 -0
  26. package/dist/core/evidence.d.ts +119 -0
  27. package/dist/core/evidence.js +209 -0
  28. package/dist/core/evidence.js.map +1 -0
  29. package/dist/core/judge.d.ts +221 -0
  30. package/dist/core/judge.js +251 -0
  31. package/dist/core/judge.js.map +1 -0
  32. package/dist/core/orchestrate-closing.d.ts +237 -0
  33. package/dist/core/orchestrate-closing.js +250 -0
  34. package/dist/core/orchestrate-closing.js.map +1 -0
  35. package/dist/core/orchestrate-correction.d.ts +209 -0
  36. package/dist/core/orchestrate-correction.js +141 -0
  37. package/dist/core/orchestrate-correction.js.map +1 -0
  38. package/dist/core/orchestrate-host.d.ts +225 -0
  39. package/dist/core/orchestrate-host.js +80 -0
  40. package/dist/core/orchestrate-host.js.map +1 -0
  41. package/dist/core/orchestrate-stagnation.d.ts +259 -0
  42. package/dist/core/orchestrate-stagnation.js +270 -0
  43. package/dist/core/orchestrate-stagnation.js.map +1 -0
  44. package/dist/core/orchestrate.d.ts +357 -0
  45. package/dist/core/orchestrate.js +418 -0
  46. package/dist/core/orchestrate.js.map +1 -0
  47. package/dist/core/policy.d.ts +122 -0
  48. package/dist/core/policy.js +102 -0
  49. package/dist/core/policy.js.map +1 -0
  50. package/dist/core/prune-plan.d.ts +141 -0
  51. package/dist/core/prune-plan.js +390 -0
  52. package/dist/core/prune-plan.js.map +1 -0
  53. package/dist/core/score.d.ts +2 -2
  54. package/dist/core/score.js.map +1 -1
  55. package/dist/core/text.d.ts +36 -0
  56. package/dist/core/text.js +66 -0
  57. package/dist/core/text.js.map +1 -0
  58. package/dist/hook/cli.d.ts +9 -0
  59. package/dist/hook/cli.js +52 -0
  60. package/dist/hook/cli.js.map +1 -0
  61. package/dist/hook/contract.d.ts +125 -0
  62. package/dist/hook/contract.js +159 -0
  63. package/dist/hook/contract.js.map +1 -0
  64. package/dist/hook/decision.d.ts +97 -0
  65. package/dist/hook/decision.js +955 -0
  66. package/dist/hook/decision.js.map +1 -0
  67. package/dist/hook/memory-store.d.ts +81 -0
  68. package/dist/hook/memory-store.js +157 -0
  69. package/dist/hook/memory-store.js.map +1 -0
  70. package/dist/hook/payload.d.ts +55 -0
  71. package/dist/hook/payload.js +129 -0
  72. package/dist/hook/payload.js.map +1 -0
  73. package/dist/hook/run.d.ts +48 -0
  74. package/dist/hook/run.js +218 -0
  75. package/dist/hook/run.js.map +1 -0
  76. package/dist/hook/store-port.d.ts +72 -0
  77. package/dist/hook/store-port.js +2 -0
  78. package/dist/hook/store-port.js.map +1 -0
  79. package/dist/index.d.ts +1 -0
  80. package/dist/index.js +1 -0
  81. package/dist/index.js.map +1 -1
  82. package/dist/ports/audit.d.ts +18 -0
  83. package/dist/ports/audit.js +11 -0
  84. package/dist/ports/audit.js.map +1 -0
  85. package/dist/ports/clock.d.ts +14 -0
  86. package/dist/ports/clock.js +11 -0
  87. package/dist/ports/clock.js.map +1 -0
  88. package/dist/ports/decision.d.ts +75 -0
  89. package/dist/ports/decision.js +2 -0
  90. package/dist/ports/decision.js.map +1 -0
  91. package/dist/ports/index.d.ts +14 -0
  92. package/dist/ports/index.js +2 -0
  93. package/dist/ports/index.js.map +1 -0
  94. package/dist/ports/log.d.ts +22 -0
  95. package/dist/ports/log.js +12 -0
  96. package/dist/ports/log.js.map +1 -0
  97. package/dist/ports/state.d.ts +46 -0
  98. package/dist/ports/state.js +13 -0
  99. package/dist/ports/state.js.map +1 -0
  100. package/dist/state/clock.d.ts +40 -0
  101. package/dist/state/clock.js +43 -0
  102. package/dist/state/clock.js.map +1 -0
  103. package/dist/state/file-store.d.ts +340 -0
  104. package/dist/state/file-store.js +849 -0
  105. package/dist/state/file-store.js.map +1 -0
  106. package/dist/state/paths.d.ts +41 -0
  107. package/dist/state/paths.js +73 -0
  108. package/dist/state/paths.js.map +1 -0
  109. package/docs/USER_GUIDE.en.md +79 -36
  110. package/docs/claude-code.md +281 -0
  111. package/docs/design/v0.2.0-harness-plugins.md +381 -0
  112. package/docs/design/v0.3.0-orchestration-unification.md +580 -0
  113. package/docs/dsh-plugin.md +54 -54
  114. package/docs/release-checklist-v0.1.0.md +32 -21
  115. package/docs/release-handbook-porting-notes.md +11 -11
  116. package/docs/release-handbook.md +55 -30
  117. package/docs/release-notes-v0.1.0.md +27 -14
  118. package/docs/release-notes-v0.3.0.md +152 -0
  119. package/docs/research/claude-code-harness.md +607 -0
  120. package/docs/research/pi-harness.md +621 -0
  121. package/package.json +16 -7
package/CHANGELOG.md ADDED
@@ -0,0 +1,20 @@
1
+ # 更新日志 / Changelog
2
+
3
+ ## 0.3.0
4
+
5
+ ### 宿主接入
6
+
7
+ - 新增 Codex CLI、pi、Kimi Code 和 OpenCode 接入;Claude Code 与 DSH 插件一并升至 `0.3.0`。各宿主适配自己的事件和返回格式,剪枝、停滞、失效纠偏与收尾判定共用核心规则。
8
+ - Codex 只能改写 MCP 工具输出,不能改写 shell 输出;回合内 MCP 工具与剪枝未在真实模型回合中验证。pi 的收尾最多请求一次续跑,不能阻断。Kimi 的剪枝只记账,收尾阻断需要 exit-2 shim。OpenCode 的 `session.idle` 不能阻断收尾。Kimi 与 OpenCode 的宿主接入仅做了离线契约测试。详见 [能力对照](README.md#宿主能力对照)。
9
+
10
+ ### DSH 插件
11
+
12
+ - System One 改用连接配置:可维护多条连接,每条连接可从模型列表中选定一个模型。全新配置预置并启用 `JEV official`,凭证只读取 `JEV_API_KEY`;不会覆盖已有连接或显式停用的设置。命名凭证变量后不会回退到其他变量,面板不回显密钥。
13
+ - 设置面板编辑后自动保存,只写本次改动。保存失败时保留草稿并显示原因;只读状态不会写入。重复选择当前模型不会丢掉正在输入的文本。
14
+ - 工具结果与账本记录逐次判定的连接、请求模型及结果来源;缺少证据时不推断来源。
15
+ - 推理强度按回合判定,参考当前提示、对话历史与上一次强度。`reflex_delegate` 是单独的可选工具,需要显式开启 Delegation,且宿主工具须开放模型选择。
16
+
17
+ ### 升级与分发
18
+
19
+ - 从 `0.1.0` 直接升至 `0.3.0`,没有发布过 `0.2.0`。旧账本可继续读取;旧 alpha 包 `dsh-reflex` 与 `dsh-harness-reflex` 是不同的安装,配置不会自动迁移。DSH 插件要求 `>=0.2.2-rc.1 <0.2.3`;同版本重装须加 `--force`。
20
+ - 发布构建生成七份 tarball。`harness-reflex`、`dsh-harness-reflex`、`pi-reflex` 可作为 npm 包发布;Claude Code、Codex、Kimi Code 和 OpenCode 的配置或插件包标记为 `private`,按各自 README 接入。仓库内的 `release/RELEASE-0.3.0.md` 提供安装与验证背景。
package/README.md CHANGED
@@ -6,6 +6,59 @@
6
6
 
7
7
  ---
8
8
 
9
+ ## 先分清两个「面」(写文档、剪视频、写脚本前必看)
10
+
11
+ 同一个插件在不同宿主里露出不同形状,**工具数量与自动化程度都不同**,混着讲会自相矛盾:
12
+
13
+ | | A. MCP 面(Claude Code / Codex / AGY) | B. DSH 宿主插件面(`dsh-harness-reflex`) |
14
+ |---|---|---|
15
+ | 工具 | **8 个**:`choice` `score` `route` `screen` `gate` `prune` `detect_stagnation` `status_ledger` | **5 个可开关**:`choice` `score` `route` `screen` `gate`;默认开 4 个,`route` 默认关 |
16
+ | 剪枝 / 停滞 / 收尾核验 | 需要模型**主动调用工具** | **自动干预**:`tools/post-execute`、`agent/pre-step`、`agent/turn-stopping` 钩子执行,模型不调也会发生 |
17
+ | 账本 | `reflex_status_ledger` 工具 | `/reflex-ledger` 命令 或 设置面板「账本」页(不占工具位) |
18
+ | 模型与思考等级 | 不涉及(由宿主决定) | 自动:虚拟 Provider 候选池 + 自适应 `reasoningEffort` |
19
+ | 设置面板 | 无 | **8 个页签**:概览 / 虚拟 Provider / 推理强度 / System 1 后端 / 自动干预 / 工具开关 / 账本 / 使用说明 |
20
+
21
+ 一句话:**A 面是工具集,B 面是「工具 + 自动干预 + 路由」**。讲到具体数字前,先说清在讲哪个面。
22
+
23
+ ---
24
+
25
+ ## 宿主能力对照
26
+
27
+ v0.3.0 产物覆盖下表六个宿主。**它们的能力并不对等**——宿主没有给出对应钩子时,
28
+ 这个能力就是做不到,而不是「配置一下就好」。下表按「能力在模型侧是否真的生效」写:
29
+
30
+ | 能力 | Claude Code | DSH(`dsh-harness-reflex`) | Codex CLI | pi | Kimi Code | OpenCode |
31
+ |---|---|---|---|---|---|---|
32
+ | 8 个 / 5 个 `reflex_*` 工具(MCP) | ✅ 8 个 MCP 工具 | ✅ 5 个可开关(默认 4) | ⚠️ 8 个 MCP 工具已声明,**本机未进回合内工具清单** | ✅ 工具集在本进程内 | ⚠️ 8 个 MCP 工具已声明,**未在真机验证** | ⚠️ 8 个 MCP 工具已声明,**未在真机验证** |
33
+ | 停滞拦截(拒绝重复调用) | ✅ 拒绝 | ✅ 自动 | ✅ 拒绝 | ✅ 拒绝 | ✅ 拒绝 | ✅ 抛错拒绝 |
34
+ | 结果剪枝(改写工具输出) | ✅ 生效 | ✅ 自动生效 | ⚠️ **只能改 MCP 工具输出,不能改 shell 工具输出** | ✅ 生效 | ❌ **`PostToolUse` 是 observation-only:只记账不生效** | ✅ 生效(`tool.execute.after` 替换输出) |
35
+ | 失效纠偏 | ✅ 生效 | ✅ 自动生效 | — | ✅ 生效 | ❌ 只记账(`PostToolUseFailure` observation-only) | ❌ 宿主无工具失败钩子 |
36
+ | 收尾核验(阻断「我完成了」) | ✅ **真阻断** | ✅ **真阻断** | ✅ 可 block | ⚠️ **只能续跑一次,从不阻断**:记为 `closing-degraded-pass`,永不记 `closing-block` | ⚠️ 需 `hooks/reflex-stop-exit2.sh` shim 转 exit 2 才能阻断 | ❌ **Stop 无法拦截**(`session.idle` 无插件级否决权,只记 warn 日志) |
37
+ | 接入形态 | 配置 hooks + MCP | 进程内 Cordis 插件 | 配置 `hooks.json` + `config.toml` | 进程内 TS 扩展 | 配置 `hooks.toml` + shim + `mcp.json` | **JS 插件**(宿主无 shell 钩子机制) |
38
+
39
+ 读法:
40
+
41
+ - **Claude Code / DSH 是完整能力**:六项能力全部在模型侧真实生效。
42
+ - **Codex 的剪枝只作用于 MCP 工具输出。** 宿主的 `PostToolUse` 只接受 `updatedMCPToolOutput` 一个决定字段,
43
+ 且只对 MCP 工具生效;**shell(`exec_command`)的结果改不了**。这不是接线缺陷,而是宿主的契约。
44
+ `reflex_prune` 仍可作为工具由模型自己调用。另:本机没有可用模型端点,**MCP 工具从未进入 Codex 回合内的
45
+ 工具清单**,故「回合内剪枝」与「回合内 MCP 工具」均未真机验证。
46
+ - **Kimi 的剪枝只记账不生效。** `PostToolUse` / `PostToolUseFailure` / `SubagentStop` 在 Kimi Code 里是
47
+ observation-only:宿主忽略返回值,判定仍写进账本,但改变不了模型看到的内容。只有 `PreToolUse`(拒绝)
48
+ 和 `Stop`(**经 `hooks/reflex-stop-exit2.sh` 把我们的 `decision:"block"` JSON 转成 exit 2**)能真正干预。
49
+ - **OpenCode 没有 shell 钩子机制**,唯一扩展点是 JS 插件(`Plugin = (input) => Promise<Hooks>`),所以它
50
+ 拿到的是插件而不是配置片段。剪枝与停滞**在 OpenCode 上是生效的**(这是少见的非 Claude 宿主优势);
51
+ 但 **Stop 无法拦截**——`session.idle` 事件不带助手文本,宿主也没有插件级否决权,异议只能写进日志。
52
+ - **pi 的收尾只会降级放行。** pi 没有任何 API 能拒绝结束一个回合;`agent_before_settle` 只能请求
53
+ **一次**续跑,它不能否决 settle。因此矛盾未被纠正时会放行并记 `closing-degraded-pass`——
54
+ **pi 永远不会写 `closing-block`**,扩展不会假装自己做到了。
55
+
56
+ > ⚠️ **未验证项不要当已验证**:Kimi / OpenCode 的整机安装与钩子触发、Codex 的回合内 MCP 工具,
57
+ > 本机都没有对应的可用宿主,均未真机验证;验证方法逐条写在各包 README 的
58
+ > 「Verification status」小节。Claude Code 与 pi 有真机 e2e。
59
+
60
+ ---
61
+
9
62
  ## 核心特性与架构
10
63
 
11
64
  ```
@@ -32,7 +85,7 @@
32
85
  1. **跨 Harness 零门槛适配**:
33
86
  - **Claude Code**:标准 MCP 协议(`.mcp.json`),提供 `reflex_gate`、`reflex_prune`、`reflex_detect_stagnation` 等工具。
34
87
  - **Codex CLI**:`.codex/config.json` 原生 MCP 挂载。
35
- - **Antigravity (AGY)**:支持全功能 Bundle 插件(`.agents/plugins/harness-reflex/`),内嵌 `plugin.json`、`mcp_config.json`、`hooks.json` 与 `rules/AGENTS.md`。
88
+ - **Antigravity (AGY)**:Bundle 插件(`.agents/plugins/harness-reflex/`),内嵌 `plugin.json`、`mcp_config.json`、`hooks.json` 与 `rules/AGENTS.md`;hooks 调用与 Claude Code 相同的 `harness-reflex hook <event>` 分发器,自动干预能力取决于 AGY 是否消费 hook 输出(以宿主实测为准)。
36
89
 
37
90
  2. **全套 System One 工具链(MCP 面 8 个工具,由根包 stdio server 暴露给外部客户端)**:
38
91
  - **底层通用 API**:
@@ -52,9 +105,9 @@
52
105
  - 内置 `calibrate` 引擎,可基于历史标注集拟合单调映射曲线,计算 ECE 误差并输出校准配置;
53
106
  - 线上运行时自动修正过度自信的模型原始概率,杜绝盲目放行。
54
107
 
55
- 4. **DSH Host 插件(进程内集成,`@miuzel/dsh-reflex`)**:
108
+ 4. **DSH Host 插件(进程内集成,`dsh-harness-reflex`)**:
56
109
  - 除 stdio MCP 之外,同一套 System One 能力还以 **DSH Cordis Host 插件**形式在 `dsh` 进程内注册:
57
- `packages/dsh-reflex/` 通过 `ctx.tools` 注册 **5 个可开关工具** `reflex_choice` / `reflex_score` /
110
+ `packages/dsh-harness-reflex/` 通过 `ctx.tools` 注册 **5 个可开关工具** `reflex_choice` / `reflex_score` /
58
111
  `reflex_route` / `reflex_screen` / `reflex_gate`,**默认开启前 4 个、`route` 默认关闭**。
59
112
  - **剪枝、停滞拦截、收尾核验与失效纠偏是自动干预**,不是工具:它们由宿主的
60
113
  `tools/post-execute`、`agent/pre-step`、`agent/turn-stopping` 钩子按 `interventions.mode`
@@ -70,12 +123,24 @@
70
123
  - 路由**上下文感知且带会话粘性**:决策请求带上本会话累积的上下文规模与当前物理模型,提示词写明
71
124
  「保留当前模型可省缓存、非必要不切」,名次相近(未超出 `stickyMargin`,默认 15%)时守住已在用的
72
125
  模型,只有明显更合适才切换;`model-route` 台账记 `currentModel` / `switched` / `contextTokens`。
73
- - 详见 [`docs/dsh-plugin.md`](docs/dsh-plugin.md) 与 [`packages/dsh-reflex/README.md`](packages/dsh-reflex/README.md)。
126
+ - 详见 [`docs/dsh-plugin.md`](docs/dsh-plugin.md) 与 [`packages/dsh-harness-reflex/README.md`](packages/dsh-harness-reflex/README.md)。
127
+
128
+ 5. **Claude Code 插件三件套(v0.3.0)**:
129
+ - `packages/claude-reflex/` 同时携带 **mod**(`turn.step` effort 接线)、**settings hooks**
130
+ (PreToolUse / PostToolUse / PostToolUseFailure / Stop / SubagentStop(默认关)/ SessionStart / SessionEnd,
131
+ 逐事件调用 `harness-reflex hook <event>`)与 **MCP server**(根包 8 个 `reflex_*` 工具)。
132
+ - 剪枝、停滞、失效纠偏 **active**;收尾核验默认 **observe**,可在插件配置里 opt-in 成 `active`。
133
+ - 安装、配置、限制与「本环境已验证 / 需你本机验证」两栏见
134
+ [`docs/claude-code.md`](docs/claude-code.md);真实 `claude -p` e2e 见 `scripts/claude-e2e.sh`。
74
135
 
75
136
  ---
76
137
 
77
138
  ## 快速安装与配置
78
139
 
140
+ 在 `0.3.0` 上架 npm 后,可运行 `npm install -g harness-reflex@0.3.0` 安装核心 CLI 与 stdio MCP。
141
+ 上架前可从发布产物安装:`npm install -g ./release/harness-reflex-0.3.0.tgz`。
142
+ 以下构建和配置示例从源码仓库根目录运行。
143
+
79
144
  ### 1. 构建
80
145
  ```bash
81
146
  npm install
@@ -103,33 +168,40 @@ node dist/cli/index.js setup agy
103
168
 
104
169
  ```bash
105
170
  # 从本仓库产物安装;同版本重装必须加 --force(pnpm 不会静默覆盖同版本)
106
- dsh plugin --profile web add --force ./release/miuzel-dsh-reflex-0.1.0.tgz
171
+ dsh plugin --profile web add --force ./release/dsh-harness-reflex-0.3.0.tgz
107
172
 
108
- # 首次发布到 npm 后(包名 @miuzel/dsh-reflex):
109
- dsh plugin --profile web add @miuzel/dsh-reflex@0.1.0
173
+ # 首次发布到 npm 后(包名 dsh-harness-reflex):
174
+ dsh plugin --profile web add dsh-harness-reflex@0.3.0
110
175
  ```
111
176
 
112
177
  安装后重启 / 重载 `dsh`,设置页会出现「Reflex 决策运行时」面板;`/dsh-reflex/api/health`
113
- 应返回 `{"ok":true,"name":"dsh-reflex","version":"0.1.0"}`。
178
+ 应返回 `{"ok":true,"name":"dsh-reflex","version":"0.3.0"}`。
114
179
 
115
- ### 5. 配置 System One 决策后端(可选)
180
+ ### 5. 配置核心 CLI / MCP 的 System One 决策后端(可选)
181
+ DSH 插件使用设置面板中的连接配置;全新配置预置并启用 `JEV official`,凭证读取 `JEV_API_KEY`。
116
182
  默认内置本地快速启发式决策器(`<5ms` 延迟,零外部依赖)。可随时无缝切换到其他 System One API:
117
183
 
118
184
  ```bash
119
- # 切换 Provider A:官方 Jev API
120
- export SYSTEM_ONE_BACKEND=jev
185
+ # 切换 Provider A:官方 Jev API(只有 key 是必填,地址与模型都有默认值)
121
186
  export SYSTEM_ONE_API_KEY="your-api-key"
122
- export SYSTEM_ONE_BASE_URL="https://api.typesafe.ai/v1/systemone"
123
187
 
124
188
  # 切换 Provider B:通用 open-weights 模型 logits 读出 (vLLM / simple-jev / OpenAI 兼容接口)
125
- export SYSTEM_ONE_BACKEND=simple-jev
126
- export SYSTEM_ONE_BASE_URL="http://localhost:8000"
127
- export SYSTEM_ONE_MODEL="Qwen/Qwen2.5-7B-Instruct"
189
+ export SYSTEM_ONE_BASE_URL="http://localhost:8000" # 只有地址是必填
190
+ export SYSTEM_ONE_BACKEND=simple-jev # 或不写:检测到 VLLM_BASE_URL/OPENAI_BASE_URL 会自动选中
128
191
 
129
- # 切换 Provider C:离线/本地基准模拟后端 (默认)
192
+ # 切换 Provider C:离线/本地基准模拟后端(什么都不设时的默认)
130
193
  export SYSTEM_ONE_BACKEND=mock
131
194
  ```
132
195
 
196
+ 不设 `SYSTEM_ONE_BACKEND` 时按顺序自动判定:有 `SYSTEM_ONE_API_KEY`/`JEV_API_KEY` → `jev`;
197
+ 有 `VLLM_BASE_URL`/`OPENAI_BASE_URL` → `simple-jev`;都没有 → `mock`。
198
+
199
+ | 变量 | 默认值 |
200
+ | --- | --- |
201
+ | `SYSTEM_ONE_BASE_URL` | `jev`:`https://api.typesafe.ai/v1/systemone`;`simple-jev`:`http://localhost:8000` |
202
+ | `SYSTEM_ONE_MODEL` | `jev`:`jev-latest`;`simple-jev`:`Qwen/Qwen2.5-7B-Instruct` |
203
+ | `SYSTEM_ONE_API_KEY` | `jev`:无(空串,请求会被服务端拒绝);`simple-jev`:`dummy`(本地服务通常不校验) |
204
+
133
205
  ---
134
206
 
135
207
  ## 实验基准对比运行
@@ -152,7 +224,8 @@ node dist/cli/index.js ledger
152
224
  ```bash
153
225
  npm test # 根包:ledger / score / route / route-prompt / MCP 表面 / 打包清单
154
226
  npm run test:plugin # DSH 插件:注册、严格校验、工具面与 /reflex-ledger、生命周期、虚拟 provider 路由(含上下文感知与会话粘性)、设置面板与使用说明
155
- npm run test:all # 构建根包 + 插件,然后跑两套测试
227
+ npm run test:claude-plugin # Claude Code 插件:manifest/hooks/.mcp.json、7 事件、observe diff=0、崩溃放行
228
+ npm run test:all # 构建后运行七套测试:核心、DSH、Claude Code、Codex、pi、Kimi Code、OpenCode
156
229
  npm run test:mutation # 负向对照:注入故障,要求被测试(或编译器)抓住
157
230
  ```
158
231
 
@@ -160,14 +233,16 @@ npm run test:mutation # 负向对照:注入故障,要求被测试(或
160
233
 
161
234
  ## 使用说明与发布产物
162
235
 
236
+ - 版本变更见 [`CHANGELOG.md`](CHANGELOG.md)。
237
+
163
238
  - **[`USER_GUIDE.md`](USER_GUIDE.md)**(中文)与 **[`docs/USER_GUIDE.en.md`](docs/USER_GUIDE.en.md)**(English):
164
239
  插件架构、虚拟 Provider 模型池配置、自适应思考等级(`reflex` / `auto`)、System 1 后端接入、
165
240
  MCP 与原生 DSH 工具对照、决策账本、测试与发布流程。这两份文档会被嵌入插件前端,
166
241
  可在 DSH 设置页 **Reflex → 使用说明 / Guide** 标签页内直接切换中英文阅读。
167
242
 
168
243
  ```bash
169
- npm run release:pack # 打包两个包到 release/:结构审计 + 离线安装冒烟 + SHA256SUMS
170
- npm run release # 全量构建与测试通过后再打包(发布闸门)
244
+ npm run release:pack -- --keep # 构建后打包七份 tarball;保留已跟踪的发布草稿和打包暂存目录
245
+ npm run release -- --keep # 全量构建、七套测试及变异测试通过后再以相同方式打包
171
246
  ```
172
247
 
173
248
  产物路径:
@@ -175,12 +250,17 @@ npm run release # 全量构建与测试通过后再打包(发布闸
175
250
  | 产物 | 说明 |
176
251
  | --- | --- |
177
252
  | `release/harness-reflex-<version>.tgz` | 根包:核心运行时、CLI、stdio MCP、适配器、`dist/`(含类型与自包含 source map)、`USER_GUIDE.md`、`docs/` |
178
- | `release/miuzel-dsh-reflex-<version>.tgz` | DSH Host 插件 `@miuzel/dsh-reflex`(scoped 包的 npm pack 命名):`dist/`、单文件浏览器端 `client.js`(含内嵌使用说明)、`cordis.patch.yml`、`locale/` |
179
- | `release/SHA256SUMS` | 两份 tarball 的 SHA-256 校验和 |
253
+ | `release/dsh-harness-reflex-<version>.tgz` | DSH Host 插件 `dsh-harness-reflex`(npm pack 命名):`dist/`、单文件浏览器端 `client.js`(含内嵌使用说明)、`cordis.patch.yml`、`locale/` |
254
+ | `release/harness-reflex-claude-code-<version>.tgz` | Claude Code 插件(`private`) |
255
+ | `release/harness-reflex-codex-<version>.tgz` | Codex 配置包(`private`) |
256
+ | `release/pi-reflex-<version>.tgz` | pi 扩展 |
257
+ | `release/harness-reflex-kimi-code-<version>.tgz` | Kimi Code 配置包与 shim(`private`) |
258
+ | `release/harness-reflex-opencode-<version>.tgz` | OpenCode JS 插件与配置(`private`) |
259
+ | `release/SHA256SUMS` | 七份 tarball 的 SHA-256 校验和;在 `release/` 内运行 `sha256sum -c SHA256SUMS` |
180
260
  | `release/release-report.json` | 逐项打包核验记录(文件清单、死链、依赖声明、安装冒烟) |
181
- | `release/RELEASE-<version>.md` | 发布说明:安装方式、核验清单、内容构成 |
261
+ | `release/RELEASE-<version>.artifacts.md` | 自动生成的产物与核验说明 |
182
262
 
183
- `npm run release:pack` 不止于「打包成功」:它解压两份 tarball,核对必需文件、
263
+ `npm run release:pack` 不止于「打包成功」:它解压七份 tarball,核对必需文件、
184
264
  拒绝测试构建产物、临时目录与本地绝对路径,解析全部相对引用与 source map 目标(零死链,
185
265
  且不允许未声明的运行时依赖),再对根包做一次真实 `npm install`(`bin`、具名 import 与
186
266
  stdio MCP `tools/list` 冒烟)。
package/USER_GUIDE.md CHANGED
@@ -1,7 +1,7 @@
1
- # Harness Reflex 使用说明(v0.1.0)
1
+ # Harness Reflex 使用说明(v0.3.0)
2
2
 
3
- > 本文档是 **`@miuzel/dsh-reflex` 插件** 与 **`harness-reflex` 核心包** 的完整使用手册。
4
- > 同一份内容会内嵌进 `packages/dsh-reflex/client.js`,可在 DSH 设置面板的
3
+ > 本文档是 **`dsh-harness-reflex` 插件** 与 **`harness-reflex` 核心包** 的完整使用手册。
4
+ > 同一份内容会内嵌进 `packages/dsh-harness-reflex/client.js`,可在 DSH 设置面板的
5
5
  > **「使用说明 / Guide」** 标签页内直接阅读(跟随 DSH 界面语言中英切换)。
6
6
  > 因此修改本文档后必须重新执行 `npm run build:all`,否则面板里仍是上一次构建的副本
7
7
  > (`npm run test:plugin` 会用文档摘要做漂移校验)。
@@ -19,7 +19,7 @@ System Two 生成式推理的前提下,用毫秒级的概率判定完成门禁
19
19
  | 形态 | 包 | 适用 Harness | 通信方式 |
20
20
  | --- | --- | --- | --- |
21
21
  | stdio MCP 服务器 | `harness-reflex` | Claude Code、Codex CLI、AGY | MCP JSON-RPC 子进程 |
22
- | DSH Host 插件 | `@miuzel/dsh-reflex` | DeepSeek Harness (`dsh`) | 进程内 `ctx.tools` / Cordis 钩子 |
22
+ | DSH Host 插件 | `dsh-harness-reflex` | DeepSeek Harness (`dsh`) | 进程内 `ctx.tools` / Cordis 钩子 |
23
23
 
24
24
  MCP 面暴露 8 个工具;DSH 面只注册 5 个可开关工具(默认 4 个),剪枝/停滞/账本由自动干预与
25
25
  `/reflex-ledger` 命令承载。参数及校验边界以第 9 节和各表面实际工具定义为准。
@@ -35,7 +35,7 @@ MCP 面暴露 8 个工具;DSH 面只注册 5 个可开关工具(默认 4 个
35
35
  └───────────────┬──────────────────────────────────┬───────────────────┘
36
36
  │ stdio MCP │ DSH Cordis 进程内
37
37
  ┌───────────────▼──────────────────┐ ┌────────────▼───────────────────┐
38
- │ harness-reflex 核心(dist/) │ │ @miuzel/dsh-reflex 插件 │
38
+ │ harness-reflex 核心(dist/) │ │ dsh-harness-reflex 插件 │
39
39
  │ gate · prune · stagnation │◄─┤ src/bridge.ts ReflexRuntime │
40
40
  │ route · screen · score │ │ src/tools.ts 5 个可开关工具 │
41
41
  │ ledger · calibrate │ │ src/router.ts 虚拟 Provider │
@@ -46,7 +46,8 @@ MCP 面暴露 8 个工具;DSH 面只注册 5 个可开关工具(默认 4 个
46
46
  └──────────────────────────────────┘ ┌────────────▼───────────────────┐
47
47
  │ client.js 浏览器面板(React) │
48
48
  │ 概览/虚拟 Provider/推理强度/ │
49
- │ System 1 后端/决策账本/使用说明 │
49
+ │ System 1 后端/自动干预/工具开关/ │
50
+ │ 决策账本/使用说明 │
50
51
  └────────────────────────────────┘
51
52
  ```
52
53
 
@@ -83,17 +84,17 @@ node dist/cli/index.js setup all # 或 claude | codex | agy
83
84
 
84
85
  # 3) 以 DSH 插件方式安装(进程内集成,推荐)
85
86
  # 发布 tarball:同版本重装必须 --force;开发期也可直接装目录
86
- dsh plugin --profile web add --force ./release/miuzel-dsh-reflex-0.1.0.tgz
87
+ dsh plugin --profile web add --force ./release/dsh-harness-reflex-0.3.0.tgz
87
88
  ```
88
89
 
89
90
  `npm run build:all` 的每一步都是必需的:
90
91
 
91
92
  1. `tsc`:根包 `src/` → `dist/`;
92
93
  2. `node scripts/link-dsh-deps.mjs`:把本机 DSH 的 `@deepseek-ai/*` 软链进
93
- `packages/dsh-reflex/node_modules/`(完全离线,不访问 registry);
94
- 3. `tsc -p packages/dsh-reflex/tsconfig.json`:插件 Host 半边 → `packages/dsh-reflex/dist/`;
94
+ `packages/dsh-harness-reflex/node_modules/`(完全离线,不访问 registry);
95
+ 3. `tsc -p packages/dsh-harness-reflex/tsconfig.json`:插件 Host 半边 → `packages/dsh-harness-reflex/dist/`;
95
96
  4. `node scripts/embed-user-guide.mjs` + `tsc -p tsconfig.client.json` +
96
- `node packages/dsh-reflex/dist/client-bundle.js packages/dsh-reflex`:
97
+ `node packages/dsh-harness-reflex/dist/client-bundle.js packages/dsh-harness-reflex`:
97
98
  把本文档内嵌进浏览器半边并产出单文件 `client.js`。
98
99
 
99
100
  > 构建顺序不可交换:`client.js` 必须晚于本文档的修改,否则面板显示的说明与仓库文档不一致。
@@ -112,26 +113,52 @@ dsh plugin --profile web add --force ./release/miuzel-dsh-reflex-0.1.0.tgz
112
113
  | 官方 Jev / System One API | `jev` | `POST {BASE_URL}/v1/...`,需 API Key |
113
114
 
114
115
  ```bash
115
- # 官方 Jev
116
- export SYSTEM_ONE_BACKEND=jev
116
+ # 官方 Jev:只有 key 是必填
117
117
  export SYSTEM_ONE_API_KEY="your-api-key"
118
- export SYSTEM_ONE_BASE_URL="https://api.typesafe.ai/v1/systemone"
119
118
 
120
- # 自托管 vLLM(OpenAI 兼容)
121
- export SYSTEM_ONE_BACKEND=simple-jev
119
+ # 自托管 vLLM(OpenAI 兼容):只有地址是必填
122
120
  export SYSTEM_ONE_BASE_URL="http://localhost:8000"
123
- export SYSTEM_ONE_MODEL="Qwen/Qwen2.5-7B-Instruct"
121
+ export SYSTEM_ONE_BACKEND=simple-jev # 省略也能判定:检测到 VLLM_BASE_URL/OPENAI_BASE_URL 即为 simple-jev
124
122
  ```
125
123
 
126
- 插件配置项(可在设置面板「System 1 后端」页编辑,或写进 DSH 插件配置):
124
+ 不显式设 `SYSTEM_ONE_BACKEND` 时的判定顺序:有 `SYSTEM_ONE_API_KEY`/`JEV_API_KEY` → `jev`;
125
+ 有 `VLLM_BASE_URL`/`OPENAI_BASE_URL` → `simple-jev`;都没有 → `mock`。
126
+
127
+ 三份默认值都取决于后端,不要凭「默认 mock」推断另外两个:
128
+
129
+ | 变量 | `jev` | `simple-jev` |
130
+ | --- | --- | --- |
131
+ | `SYSTEM_ONE_BASE_URL` | `https://api.typesafe.ai/v1/systemone` | `http://localhost:8000` |
132
+ | `SYSTEM_ONE_MODEL` | `jev-latest` | `Qwen/Qwen2.5-7B-Instruct` |
133
+ | `SYSTEM_ONE_API_KEY` | **无**(空串,请求会被服务端拒绝) | `dummy`(本地服务通常不校验) |
134
+
135
+ **连接只来自「当前激活的连接配置」**(面板「System 1 后端」页的「连接配置(可多套)」)。
136
+ 没有激活项时插件就是**未配置**状态:面板明确显示未配置,插件不发任何外部请求,
137
+ 判定改走本地确定性启发式。激活名写错时也不会被悄悄换成别的连接。
138
+
139
+ 每一套连接配置的字段(写进 DSH 插件配置时位于 `systemOne.profiles.<名字>`):
127
140
 
128
141
  | 配置 | 默认 | 说明 |
129
142
  | --- | --- | --- |
130
- | `backend` | `auto` | `auto` 按环境变量判定,也可强制 `mock` / `vllm` / `jev`(`vllm` 即 logits 读出,环境变量侧名 `simple-jev`) |
131
- | `baseUrl` | 省略 | System 1 服务地址;省略时用后端默认值 |
132
- | `model` | 省略 | 服务端模型 ID(`simple-jev` 必填) |
133
- | `apiKeyEnv` | `SYSTEM_ONE_API_KEY` | **只记录环境变量名**,密钥本身不进入设置文档 |
134
- | `timeoutMs` | `2000` | 单次判定超时;超时按 `System 1 不可用` 走降级路径 |
143
+ | `baseUrl` | 省略 | System 1 服务地址;省略时由后端按环境变量/默认值决定 |
144
+ | `modelIds` | 省略 | 这套连接可用的**模型 ID 列表**(可多个)。`model` 是单模型写法,等同于只含一项的列表 |
145
+ | `selectedModel` | 列表第一项 | **唯一选定的模型**:运行时发送它,「测试」按钮探活也用它。必须是 `modelIds` 里的一项:保存时就会拒绝不在列表里的选择;手改文件绕过校验时,运行时不建立任何连接(面板显示未配置),不会改发默认模型 |
146
+ | `apiKey` | 省略 | 密钥本身;**只写不读**——保存后不回显,页面只显示「已保存」。**改名不会带着它走**:改名后需要重新填写(见下) |
147
+ | `apiKeyEnv` | 省略 | **只记录环境变量名**;省略时不点名,由后端按 `SYSTEM_ONE_API_KEY` → `JEV_API_KEY` → `VLLM_API_KEY` → `OPENAI_API_KEY` 兜底;点名即锁定,不回落 |
148
+ | `timeoutMs` | 省略 | 单次判定超时;省略时用**后端默认值 `jev` 10000 ms / `simple-jev` 8000 ms**,不是统一值 |
149
+ | `backend` | 省略 | 这套连接使用的后端实现;省略时用顶层 `backend` |
150
+
151
+ 顶层的 `backend` 只是「连接未指定实现时用哪个」(`auto` 按环境变量判定,也可强制
152
+ `mock` / `vllm` / `jev`),它本身不构成连接。显式 `backend: mock` 仍然有效:那是
153
+ 主动选择本地实现,不需要连接配置。
154
+
155
+ **改名与只写密钥.** 连接的「名字」就是它在设置文档里的路径,所以改名等于换一个
156
+ 保存路径,Host 无法把已保存的密钥搬到新名字下。面板因此会**阻止保存**并点名该行,
157
+ 要求重新填写 API Key(来源是环境变量的连接不受影响,改名照常保存)。同时改两个
158
+ 名字互换、或改到一个已被别的已保存配置占用的名字,也会被拦下并说明原因。
159
+
160
+ `systemOne` 顶层同名的 `baseUrl` / `model` / `apiKeyEnv` / `timeoutMs` 不参与连接:
161
+ 它们不构成一套连接配置。文件里若还留着这些字段,面板既不读取也不改写它们。
135
162
 
136
163
  校准曲线(可选):用 `calibrate` 引擎基于历史标注集拟合 ECE/PAVA 曲线,再用
137
164
  `calibrationPath` 指向该 JSON,运行时会自动修正过度自信的原始概率。
@@ -177,6 +204,14 @@ routing:
177
204
  - `virtualProvider` 不能包含 `:`;候选的 `provider` 与 `model` 都不能为空。
178
205
  - 主代理与 subagent 都走同一条拦截链路,抗循环标识(loop identity)在改写后保持不变。
179
206
  - 每次路由的候选、选择、置信度与耗时都会进账本,可在「决策账本」页回看。
207
+ - **每次调用的来源(g-068)**:每条决策账目与工具输出都带 `systemOneConnection`
208
+ (调用时生效的 System 1 连接名)、`systemOneModel`(本次**请求**的模型 ID)与
209
+ `systemOneSource` 之一 —— `remote`(由该连接作答)、`local`(该连接不发请求)、
210
+ `local-fallback`(远端尝试失败后本地作答)、`rejected`(远端失败且没有产出决策)
211
+ 或 `unknown`(没有任何证据能证明来源)。`systemOneModel` 只是**请求**的模型:上游是否
212
+ 接受或改写它,插件结构上看不到,因此任何地方都不把它当作「实际应答模型」。
213
+ 切换连接不会改写历史条目;账本 JSONL 只追加、不重写。`/reflex-ledger` 与面板
214
+ 「决策账本」页都显示这三项。
180
215
 
181
216
  **上下文感知与会话粘性(省缓存、非必要不切换).** 换模型会让服务端的提示词前缀
182
217
  缓存整体失效,因此路由不是「每轮重新选一次」,而是**默认守住这台会话已经在用的物理
@@ -323,7 +358,7 @@ interventions:
323
358
  取回就是拿同一条定位符读会话事件:
324
359
 
325
360
  ```ts
326
- import { readPrunedOriginal } from '@miuzel/dsh-reflex';
361
+ import { readPrunedOriginal } from 'dsh-harness-reflex';
327
362
 
328
363
  const record = readPrunedOriginal(session.ownEvents(), locator);
329
364
  record?.text; // 逐字节原文
@@ -374,13 +409,13 @@ record?.digest; // 与决策记录里的 digest 一致
374
409
  | 推理强度 | 策略(不干预 / Reflex 自适应)、兜底档、最小置信度、**自适应推理强度开关** |
375
410
  | 自动干预 | 三态模式(`off`/`observe`/`active`)、四大能力覆盖、每回合干预次数上限、每回合判定上限、每会话判定上限、重复阈值、失败阈值、最小置信度、判定窗口大小、剪枝下限比例;并列出当前生效的模式与能力(只读) |
376
411
  | 工具开关 | 5 个能力逐项启停(默认 4 开、`route` 关);每项写明**做什么 / agent 何时该调用 / 是否建议暴露**,并有「应用推荐组合」按钮;页尾列出当前已注册的工具名(只读,跟随 `toolPrefix`),并提示账本改用 `/reflex-ledger` |
377
- | System 1 后端 | 后端实现、Base URL、模型 ID、API Key 环境变量名、超时;以及工具名前缀、裁剪阈值、账本 JSONL 路径、校准曲线路径 |
412
+ | System 1 后端 | 连接配置(可多套:Base URL、模型列表与单选、API Key 只写、环境变量名、超时)、后端实现;以及工具名前缀、裁剪阈值、账本 JSONL 路径、校准曲线路径 |
378
413
  | 决策账本 | 实时指标、最近决策表、落盘路径、清空(需二次确认) |
379
414
  | **使用说明** | **本手册的只读视图,跟随 DSH 界面语言中英切换** |
380
415
 
381
- - 页面是**整组写回**:改一个字段会让该配置组整体过一次 Host 校验后保存(System 1
382
- 后端页覆盖 `backend`、`systemOne`、`toolPrefix`、`ledgerPath`、`pruneThreshold`、
383
- `calibrationPath` 六条配置路径,保存时逐条整值写入);
416
+ - 页面保存前会过一次 Host 校验:改一个字段只写该字段所在的路径(整组写回的组除外,
417
+ 见下);System 1 后端页覆盖连接配置行、`systemOne.active`、`backend` 与四个运行时
418
+ 字段,保存时按路径只写改动项;
384
419
  - Host 文档只读时页面自动进入只读模式,写操作按钮禁用;
385
420
  - 面板路由 `/dsh-reflex/api/*`(`panel` / `health` / `ledger/clear`)只接受 loopback 客户端,清除账本必须显式确认。
386
421
 
@@ -399,12 +434,14 @@ record?.digest; // 与决策记录里的 digest 一致
399
434
  逐字节一致,默认配置下配置内容零变化(默认已经是 4 开 1 关)。
400
435
  - **推理强度开关:总是显式写入**。`effort.enabled` 随该组写下当前值,避免出现
401
436
  「面板显示已启用、配置里其实是省略」的歧义。
402
- - **System 1 后端:逐条 schema 路径整值写入**。Host 的设置文档按**配置路径**寻址,
403
- 而该页覆盖的是 `backend`(标量)、`systemOne`(连接块)以及 `toolPrefix`、
404
- `ledgerPath`、`pruneThreshold`、`calibrationPath` 四个顶层字段:保存时这几条路径
405
- 各自整值写入(只写发生变化的那一组),**页面名不会被当成配置键**——`runtime`
406
- 并不是 `Config` 的字段,按页面名写入会被 Host 直接拒绝,整次保存随之失败。留空的
407
- `ledgerPath`/`calibrationPath` 以「取消设置」写入,效果等于沿用下层配置而不是写空串。
437
+ - **System 1 后端:逐条路径只写改动项**。Host 的设置文档按**配置路径**寻址,而该页
438
+ 覆盖的是 `backend`(标量)、连接配置行(`systemOne.profiles.<名字>.<字段>`)、
439
+ `systemOne.active` 以及 `toolPrefix`、`ledgerPath`、`pruneThreshold`、
440
+ `calibrationPath` 四个顶层字段:保存时只写**取值真的变了**的路径,没动过的行与
441
+ 字段一个字都不写(改名/删除的行另按 g-065 的规则整棵子树 `unset`)。**页面名不会
442
+ 被当成配置键**——`runtime` 并不是 `Config` 的字段,按页面名写入会被 Host 直接拒绝,
443
+ 整次保存随之失败。留空的 `ledgerPath`/`calibrationPath` 以「取消设置」写入,效果
444
+ 等于沿用下层配置而不是写空串。
408
445
 
409
446
  非法值(未知工具后缀、非布尔值、越界预算、非法三态取值)由 Host 侧同一个
410
447
  `resolveConfig` 校验器拒绝并给出字段级错误文案,面板不会部分生效——要么整组通过,
@@ -438,20 +475,30 @@ record?.digest; // 与决策记录里的 digest 一致
438
475
  ## 9. MCP 工具 ↔ DSH 原生能力对照
439
476
 
440
477
  两种形态**各自使用不同的工具集**:stdio MCP 侧仍然暴露自 v0.1.0 起冻结的 **8 个工具**,
441
- DSH 插件侧只注册 **5 个可开关的能力(默认 4 个)**——另外三项能力改由自动干预与一条
442
- 命令承载,不占用模型的工具清单。
443
-
444
- | 能力 | MCP 工具名(`harness-reflex mcp`) | DSH 插件侧(`@miuzel/dsh-reflex`) | 主要参数 | 建议 |
478
+ DSH 插件侧只注册 **6 个可开关的能力(默认 5 个)**——另外三项能力改由自动干预与一条
479
+ 命令承载,不占用模型的工具清单。`reflex_delegate` 是插件侧专属的包装工具:它把任务转交给
480
+ 宿主的 `subagent` 工具,由 System One 决定子树该用多深的思考档位;它**刻意没有**思考档位
481
+ 参数(想精确指定档位就直接调用 `subagent`),并且只在宿主委派工具声明了
482
+ `reasoning_effort`(即部署开启了 `modelSelection: true`)时才注册——否则不注册并在日志里
483
+ 说明原因,不会出现「注册了却传不进档位」的静默降级。
484
+
485
+ | 能力 | MCP 工具名(`harness-reflex mcp`) | DSH 插件侧(`dsh-harness-reflex`) | 主要参数 | 建议 |
445
486
  | --- | --- | --- | --- | --- |
446
487
  | 多选一分类 | `reflex_choice` | 工具 `reflex_choice` | `question`, `options[]`, 可选 `context` | 建议暴露 |
447
488
  | 连续评分 | `reflex_score` | 工具 `reflex_score` | `statement`, 可选 `criteria`, `context` | 建议暴露 |
448
489
  | 提示注入筛查 | `reflex_screen` | 工具 `reflex_screen` | `content`, 可选 `source`, `strict` | 建议暴露 |
449
490
  | 声明-证据门禁 | `reflex_gate` | 工具 `reflex_gate` | `assertions[{statement}]`, `evidence`, 可选 `strictness` | 建议暴露 |
450
491
  | 候选排序 | `reflex_route` | 工具 `reflex_route`(**默认不注册**) | `goal`, `candidates[]`, 可选 `topK` | 按需开启 |
492
+ | 委派子代理 | `reflex_delegate` | 工具 `reflex_delegate`(**需先在设置面板勾选「子代理委派」,且宿主委派工具随后开放思考档位时才注册**) | `prompt`, `description`, 可选 `provider`, `model`, `cwd` | 建议暴露 |
451
493
  | 长输出剪枝 | `reflex_prune` | 无工具:结果剪枝由 `tools/pre-execute` 等钩子按干预模式自动执行 | `rawOutput`, 可选 `intent`, `shadowMode` | — |
452
494
  | 停滞检测 | `reflex_detect_stagnation` | 无工具:停滞检测是自动干预的一部分 | 可选 `recentAction`, `goal`, `history[]` | — |
453
495
  | 账本审计 | `reflex_status_ledger` | 无工具:改用 `/reflex-ledger` 命令(无参数) | 可选 `includeEntries`(返回 `summary`,可附 `recentEntries`) | 人读 |
454
496
 
497
+ 勾选 **子代理委派** 是一次带副作用的明确同意:插件会把 `tool-subagent: { modelSelection: true }` **合并**进你的
498
+ profile patch(`~/.dsh/profiles/<profile>/cordis.patch.yml`),其余内容逐字节保留,写入前先备份。宿主在启动时
499
+ 读取该开关,因此面板明说 **「已保存,重启 DSH 后生效」**,不假装即时生效。运行期该能力消失时,插件只告警、
500
+ 摘掉 `reflex_delegate` 并在面板显示原因——**绝不自动把你的配置改回去**。
501
+
455
502
  差异点:
456
503
 
457
504
  - 工具名前缀可配置(`toolPrefix`,默认 `reflex_`),例如改成 `rv_` 后是 `rv_gate`;
@@ -481,6 +528,32 @@ DSH 插件侧只注册 **5 个可开关的能力(默认 4 个)**——另外
481
528
  或非布尔值会在安装时被校验器拒绝,而不是被静默忽略。把 5 项全部写 `false` 后本
482
529
  插件不注册任何工具(路由、推理强度与干预钩子不受影响)。
483
530
 
531
+ ### 9.1 五个 Harness 的能力差异
532
+
533
+ 同一套决策引擎接进了五个宿主,但**能力并不对等**:宿主没给出对应钩子时,该能力就是做不到。
534
+ 选宿主之前先看这张表(「是否在模型侧真实生效」才是关键,不是「有没有接线」):
535
+
536
+ | 能力 | Claude Code | DSH | Codex CLI | pi | Kimi Code | OpenCode |
537
+ |---|---|---|---|---|---|---|
538
+ | 剪枝(改写工具输出) | ✅ | ✅ 自动 | ⚠️ 仅 MCP 工具输出,**shell 输出改不了** | ✅ | ❌ 只记账不生效 | ✅ |
539
+ | 停滞拦截 | ✅ | ✅ 自动 | ✅ | ✅ | ✅ | ✅ |
540
+ | 收尾阻断 | ✅ 真阻断 | ✅ 真阻断 | ✅ | ⚠️ 只续跑一次,记 `closing-degraded-pass` | ⚠️ 需 exit-2 shim | ❌ 无法拦截 |
541
+ | 接入形态 | hooks + MCP | 进程内插件 | hooks.json + config.toml | 进程内 TS 扩展 | hooks.toml + shim | JS 插件 |
542
+
543
+ 四条例外必须记住:
544
+
545
+ 1. **Codex**:`PostToolUse` 只接受 `updatedMCPToolOutput`,且只对 MCP 工具生效,**shell 工具输出无法改写**。
546
+ 本机无可用模型端点,MCP 工具从未进入回合内工具清单,这一路径未真机验证。
547
+ 2. **Kimi**:`PostToolUse` / `PostToolUseFailure` / `SubagentStop` 是 observation-only,判定只进账本、
548
+ 改变不了模型看到的内容;**剪枝只记账不生效**。`Stop` 要靠 `hooks/reflex-stop-exit2.sh` 转成 exit 2 才拦得住。
549
+ 3. **OpenCode**:宿主没有 shell 钩子机制,扩展点是 JS 插件;剪枝与停滞**生效**,但 **Stop 无法拦截**
550
+ (`session.idle` 不带助手文本,也无插件级否决权,只写 warn 日志)。
551
+ 4. **pi**:没有任何 API 能拒绝结束回合,`agent_before_settle` 只能请求一次续跑;矛盾未被纠正时放行并记
552
+ `closing-degraded-pass`,**pi 永不写 `closing-block`**。
553
+
554
+ **Claude Code 与 DSH 是完整能力**。Kimi / OpenCode 的整机安装与钩子触发、Codex 的回合内 MCP 工具均未真机验证,
555
+ 复现方法见各包 README 的「Verification status」。
556
+
484
557
  ---
485
558
 
486
559
  ## 10. 决策账本与审计
@@ -519,10 +592,15 @@ npm run release:pack # 只打包并校验(不跑测试;注意需先 buil
519
592
  | 产物 | 内容 |
520
593
  | --- | --- |
521
594
  | `harness-reflex-<version>.tgz` | 根包:`dist/`、`README.md`、`docs/`、`USER_GUIDE.md`、`experiments/` |
522
- | `miuzel-dsh-reflex-<version>.tgz` | 插件 `@miuzel/dsh-reflex`(scoped 包命名):`dist/`、`client.js`(内含本手册)、`cordis.patch.yml`、`locale/` |
523
- | `SHA256SUMS` | 上述两份 tarball 的 SHA-256 校验和 |
595
+ | `dsh-harness-reflex-<version>.tgz` | 插件 `dsh-harness-reflex`(npm pack 命名):`dist/`、`client.js`(内含本手册)、`cordis.patch.yml`、`locale/` |
596
+ | `harness-reflex-claude-code-<version>.tgz` | Claude Code 插件:`.claude-plugin/`、`hooks/`、`.mcp.json` |
597
+ | `harness-reflex-codex-<version>.tgz` | Codex 配置包:`hooks.json`、`config.toml` |
598
+ | `pi-reflex-<version>.tgz` | pi 扩展:`src/`(发布会直接跑源码)、`scripts/`、`dist/` 声明 |
599
+ | `harness-reflex-kimi-code-<version>.tgz` | Kimi Code 配置包:`hooks.toml`、`hooks/reflex-stop-exit2.sh`、`mcp.json` |
600
+ | `harness-reflex-opencode-<version>.tgz` | OpenCode 插件:`plugin/reflex.js`、`opencode.json` |
601
+ | `SHA256SUMS` | 全部 tarball 的 SHA-256 校验和 |
524
602
  | `release-report.json` | 逐项打包核验记录(文件清单、死链、依赖声明、安装冒烟) |
525
- | `RELEASE-<version>.md` | 发布说明:安装命令、核验清单、内容构成 |
603
+ | `RELEASE-<version>.md` | 由脚本生成的发布说明(机器产物;当前版本的会在每次打包时重写,**更早版本的会被保留**) |
526
604
 
527
605
  校验脚本 `scripts/release-pack.mjs` 会解压 tarball 逐个断言:必需文件齐全、
528
606
  无测试构建与临时目录、`exports`/`bin`/`dsh.bundle.patch` 目标真实存在、每个相
@@ -540,7 +618,7 @@ npm run release:pack # 只打包并校验(不跑测试;注意需先 buil
540
618
  | 虚拟模型报错而不是派发 | 候选池为空且没有 `routing.fallback`;补候选或配置兜底目标 |
541
619
  | 文本没有按预期被路由 | 检查 `routing.enabled`、虚拟模型 ID 拼写,以及 Agent 是否真的请求了该虚拟模型 |
542
620
  | 推理强度没变化 | 策略设置为省略 = 不干预;或者调用方在请求里显式选择了具体档位 |
543
- | System 1 判定总是走兜底 | `timeoutMs` 过小、`baseUrl` 不可达,或 `minConfidence` 过高;先看「概览」页的最近决策与后端状态 |
621
+ | System 1 判定总是走兜底 | `timeoutMs` 过小、`baseUrl` 不可达,或 `minConfidence` 过高;先看「概览」页的最近决策与后端状态。注意超时**没有统一默认值**:省略时 `jev` 用 10000 ms、`simple-jev` 用 8000 ms |
544
622
  | 面板里的使用说明是过时副本 | 修改 `USER_GUIDE.md` 后未重新构建;执行 `npm run build:all` |
545
623
  | 关掉某个工具后模型仍在调用它 | 注册表在下一次加载时生效;重载插件后再看,并确认键名写的是**后缀**(`gate`,不是 `reflex_gate`)。`prune`/`detect_stagnation`/`status_ledger` 已不是工具,写进 `tools.enabled` 会被校验器拒绝 |
546
624
  | 默认工具清单里没有 `reflex_route` | 属预期:`route` 默认关闭,需要在工具开关页打开(或写 `tools: { enabled: { route: true } }`) |
@@ -553,8 +631,8 @@ npm run release:pack # 只打包并校验(不跑测试;注意需先 buil
553
631
 
554
632
  ## 13. 版本与兼容性
555
633
 
556
- - 版本:`harness-reflex` 与 `@miuzel/dsh-reflex` 同步发布,v0.1.0;
557
- - Node:`>= 18`(根包 `engines`);DSH Host 依赖 `@deepseek-ai/*@0.2.1-alpha.4`;
634
+ - 版本:`harness-reflex` 与 `dsh-harness-reflex` 同步发布,v0.3.0;五个宿主插件包同版本;
635
+ - Node:`>= 18`(根包 `engines`;`pi-reflex` 为 `>= 22.19.0`);DSH Host 依赖 `@deepseek-ai/*@0.2.1-alpha.4`;
558
636
  - 插件以 `peerDependencies` 声明 Host 契约,运行时不重复打包 Host 模块;
559
637
  - stdio MCP 的 8 工具表面自 v0.1.0 起冻结,Host 侧变更不得静默改动其载荷;
560
638
  - DSH 插件侧的工具表面自 v0.1.0 起是 **5 个可开关能力、默认注册 4 个**
@@ -40,7 +40,7 @@ export class AgyAdapter {
40
40
  hooks: [
41
41
  {
42
42
  type: 'command',
43
- command: `node "${binaryPath}" hook post-tool`
43
+ command: `node "${binaryPath}" hook posttooluse`
44
44
  }
45
45
  ]
46
46
  }
@@ -1 +1 @@
1
- {"version":3,"file":"agy.js","sourceRoot":"","sources":["../../src/adapters/agy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,OAAO,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,YAAoB,EAAE,UAAkB;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;QAClF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE/C,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5C,iBAAiB;QACjB,MAAM,cAAc,GAAG;YACrB,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,qEAAqE;YAClF,OAAO,EAAE,OAAO;SACjB,CAAC;QACF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAEvG,qBAAqB;QACrB,MAAM,SAAS,GAAG;YAChB,UAAU,EAAE;gBACV,gBAAgB,EAAE;oBAChB,OAAO,EAAE,MAAM;oBACf,IAAI,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC;oBACzB,GAAG,EAAE;wBACH,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM;wBAC1F,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;wBACnF,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE;qBACvF;iBACF;aACF;SACF,CAAC;QACF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAEtG,gBAAgB;QAChB,MAAM,WAAW,GAAG;YAClB,cAAc,EAAE;gBACd,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE;oBACX;wBACE,OAAO,EAAE,aAAa;wBACtB,KAAK,EAAE;4BACL;gCACE,IAAI,EAAE,SAAS;gCACf,OAAO,EAAE,SAAS,UAAU,kBAAkB;6BAC/C;yBACF;qBACF;iBACF;gBACD,IAAI,EAAE;oBACJ;wBACE,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,SAAS,UAAU,aAAa;qBAC1C;iBACF;aACF;SACF,CAAC;QACF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAEnG,qBAAqB;QACrB,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;CAiBvB,CAAC;QACE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QAExE,OAAO,EAAE,SAAS,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nexport class AgyAdapter {\n /**\n * Generates Antigravity (AGY) plugin bundle inside .agents/plugins/harness-reflex/\n */\n static configureAgy(workspaceDir: string, binaryPath: string): { pluginDir: string } {\n const pluginDir = path.join(workspaceDir, '.agents', 'plugins', 'harness-reflex');\n const rulesDir = path.join(pluginDir, 'rules');\n\n fs.mkdirSync(rulesDir, { recursive: true });\n\n // 1. plugin.json\n const pluginManifest = {\n name: 'harness-reflex',\n description: 'System 1 decision runtime & Jev compatibility layer for Antigravity',\n version: '0.1.0'\n };\n fs.writeFileSync(path.join(pluginDir, 'plugin.json'), JSON.stringify(pluginManifest, null, 2), 'utf8');\n\n // 2. mcp_config.json\n const mcpConfig = {\n mcpServers: {\n 'harness-reflex': {\n command: 'node',\n args: [binaryPath, 'mcp'],\n env: {\n SYSTEM_ONE_BACKEND: process.env.SYSTEM_ONE_BACKEND || process.env.REFLEX_BACKEND || 'mock',\n SYSTEM_ONE_API_KEY: process.env.SYSTEM_ONE_API_KEY || process.env.JEV_API_KEY || '',\n SYSTEM_ONE_BASE_URL: process.env.SYSTEM_ONE_BASE_URL || process.env.JEV_BASE_URL || ''\n }\n }\n }\n };\n fs.writeFileSync(path.join(pluginDir, 'mcp_config.json'), JSON.stringify(mcpConfig, null, 2), 'utf8');\n\n // 3. hooks.json\n const hooksConfig = {\n 'reflex-guard': {\n enabled: true,\n PostToolUse: [\n {\n matcher: 'run_command',\n hooks: [\n {\n type: 'command',\n command: `node \"${binaryPath}\" hook post-tool`\n }\n ]\n }\n ],\n Stop: [\n {\n type: 'command',\n command: `node \"${binaryPath}\" hook stop`\n }\n ]\n }\n };\n fs.writeFileSync(path.join(pluginDir, 'hooks.json'), JSON.stringify(hooksConfig, null, 2), 'utf8');\n\n // 4. rules/AGENTS.md\n const ruleContent = `# Harness Reflex Guidelines\n\nYou are equipped with the **Harness Reflex** System 1 Decision Runtime.\n\n### Core Guidelines:\n1. **Evidence Verification Gate (\\`reflex_gate\\`)**:\n - Before presenting final completion to the user or closing an objective, verify each acceptance criterion against actual output/diffs using \\`reflex_gate\\`.\n - Never assume success based on absence of errors. If \\`reflex_gate\\` returns \\`escalate\\` or \\`contradicted\\`, continue fixing.\n\n2. **Tool Output Pruning (\\`reflex_prune\\`)**:\n - For bulky stdout from test suites, greps, or builds, use \\`reflex_prune\\` to extract relevant diagnostic lines and save context window.\n\n3. **Stagnation Recovery (\\`reflex_detect_stagnation\\`)**:\n - If an edit or command fails multiple times, invoke \\`reflex_detect_stagnation\\` to break loops and obtain corrective suggestions.\n\n4. **Audit Ledger (\\`reflex_status_ledger\\`)**:\n - Access the decision ledger to observe token savings, decision latencies, and pass rates.\n`;\n fs.writeFileSync(path.join(rulesDir, 'AGENTS.md'), ruleContent, 'utf8');\n\n return { pluginDir };\n }\n}\n"]}
1
+ {"version":3,"file":"agy.js","sourceRoot":"","sources":["../../src/adapters/agy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,OAAO,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,YAAoB,EAAE,UAAkB;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;QAClF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE/C,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5C,iBAAiB;QACjB,MAAM,cAAc,GAAG;YACrB,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,qEAAqE;YAClF,OAAO,EAAE,OAAO;SACjB,CAAC;QACF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAEvG,qBAAqB;QACrB,MAAM,SAAS,GAAG;YAChB,UAAU,EAAE;gBACV,gBAAgB,EAAE;oBAChB,OAAO,EAAE,MAAM;oBACf,IAAI,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC;oBACzB,GAAG,EAAE;wBACH,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM;wBAC1F,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;wBACnF,mBAAmB,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE;qBACvF;iBACF;aACF;SACF,CAAC;QACF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAEtG,gBAAgB;QAChB,MAAM,WAAW,GAAG;YAClB,cAAc,EAAE;gBACd,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE;oBACX;wBACE,OAAO,EAAE,aAAa;wBACtB,KAAK,EAAE;4BACL;gCACE,IAAI,EAAE,SAAS;gCACf,OAAO,EAAE,SAAS,UAAU,oBAAoB;6BACjD;yBACF;qBACF;iBACF;gBACD,IAAI,EAAE;oBACJ;wBACE,IAAI,EAAE,SAAS;wBACf,OAAO,EAAE,SAAS,UAAU,aAAa;qBAC1C;iBACF;aACF;SACF,CAAC;QACF,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAEnG,qBAAqB;QACrB,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;CAiBvB,CAAC;QACE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QAExE,OAAO,EAAE,SAAS,EAAE,CAAC;IACvB,CAAC;CACF","sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nexport class AgyAdapter {\n /**\n * Generates Antigravity (AGY) plugin bundle inside .agents/plugins/harness-reflex/\n */\n static configureAgy(workspaceDir: string, binaryPath: string): { pluginDir: string } {\n const pluginDir = path.join(workspaceDir, '.agents', 'plugins', 'harness-reflex');\n const rulesDir = path.join(pluginDir, 'rules');\n\n fs.mkdirSync(rulesDir, { recursive: true });\n\n // 1. plugin.json\n const pluginManifest = {\n name: 'harness-reflex',\n description: 'System 1 decision runtime & Jev compatibility layer for Antigravity',\n version: '0.1.0'\n };\n fs.writeFileSync(path.join(pluginDir, 'plugin.json'), JSON.stringify(pluginManifest, null, 2), 'utf8');\n\n // 2. mcp_config.json\n const mcpConfig = {\n mcpServers: {\n 'harness-reflex': {\n command: 'node',\n args: [binaryPath, 'mcp'],\n env: {\n SYSTEM_ONE_BACKEND: process.env.SYSTEM_ONE_BACKEND || process.env.REFLEX_BACKEND || 'mock',\n SYSTEM_ONE_API_KEY: process.env.SYSTEM_ONE_API_KEY || process.env.JEV_API_KEY || '',\n SYSTEM_ONE_BASE_URL: process.env.SYSTEM_ONE_BASE_URL || process.env.JEV_BASE_URL || ''\n }\n }\n }\n };\n fs.writeFileSync(path.join(pluginDir, 'mcp_config.json'), JSON.stringify(mcpConfig, null, 2), 'utf8');\n\n // 3. hooks.json\n const hooksConfig = {\n 'reflex-guard': {\n enabled: true,\n PostToolUse: [\n {\n matcher: 'run_command',\n hooks: [\n {\n type: 'command',\n command: `node \"${binaryPath}\" hook posttooluse`\n }\n ]\n }\n ],\n Stop: [\n {\n type: 'command',\n command: `node \"${binaryPath}\" hook stop`\n }\n ]\n }\n };\n fs.writeFileSync(path.join(pluginDir, 'hooks.json'), JSON.stringify(hooksConfig, null, 2), 'utf8');\n\n // 4. rules/AGENTS.md\n const ruleContent = `# Harness Reflex Guidelines\n\nYou are equipped with the **Harness Reflex** System 1 Decision Runtime.\n\n### Core Guidelines:\n1. **Evidence Verification Gate (\\`reflex_gate\\`)**:\n - Before presenting final completion to the user or closing an objective, verify each acceptance criterion against actual output/diffs using \\`reflex_gate\\`.\n - Never assume success based on absence of errors. If \\`reflex_gate\\` returns \\`escalate\\` or \\`contradicted\\`, continue fixing.\n\n2. **Tool Output Pruning (\\`reflex_prune\\`)**:\n - For bulky stdout from test suites, greps, or builds, use \\`reflex_prune\\` to extract relevant diagnostic lines and save context window.\n\n3. **Stagnation Recovery (\\`reflex_detect_stagnation\\`)**:\n - If an edit or command fails multiple times, invoke \\`reflex_detect_stagnation\\` to break loops and obtain corrective suggestions.\n\n4. **Audit Ledger (\\`reflex_status_ledger\\`)**:\n - Access the decision ledger to observe token savings, decision latencies, and pass rates.\n`;\n fs.writeFileSync(path.join(rulesDir, 'AGENTS.md'), ruleContent, 'utf8');\n\n return { pluginDir };\n }\n}\n"]}