@bolloon/bolloon-agent 0.1.0 → 0.1.2

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 (581) hide show
  1. package/bin/bolloon-cli.cjs +157 -0
  2. package/bin/bolloon-daemon.sh +207 -0
  3. package/bin/bolloon.cmd +11 -0
  4. package/dist/agents/constraint-layer.js +10 -15
  5. package/dist/agents/pi-sdk.js +433 -106
  6. package/dist/agents/protocol.js +82 -1
  7. package/dist/agents/subagent-manager.js +2 -2
  8. package/dist/agents/workflow-engine.js +15 -20
  9. package/dist/agents/workflow-pivot-loop.js +541 -0
  10. package/dist/bollharness/src/index.js +5 -0
  11. package/dist/bollharness/src/scripts/checks/check_adr_plan_numbering.js +6 -0
  12. package/dist/bollharness/src/scripts/checks/check_api_types.js +45 -0
  13. package/dist/bollharness/src/scripts/checks/check_artifact_link.js +146 -0
  14. package/dist/bollharness/src/scripts/checks/check_bridge_deps.js +6 -0
  15. package/dist/bollharness/src/scripts/checks/check_bugfix_binding.js +6 -0
  16. package/dist/bollharness/src/scripts/checks/check_bugfix_binding_ci.js +6 -0
  17. package/dist/bollharness/src/scripts/checks/check_doc_file_references.js +6 -0
  18. package/dist/bollharness/src/scripts/checks/check_doc_freshness.js +135 -0
  19. package/dist/bollharness/src/scripts/checks/check_doc_links.js +31 -0
  20. package/dist/bollharness/src/scripts/checks/check_file_existence_claims.js +6 -0
  21. package/dist/bollharness/src/scripts/checks/check_fragment_integrity.js +34 -0
  22. package/dist/bollharness/src/scripts/checks/check_hook_installed.js +63 -0
  23. package/dist/bollharness/src/scripts/checks/check_issue_closure.js +41 -0
  24. package/dist/bollharness/src/scripts/checks/check_mcp_parity.js +6 -0
  25. package/dist/bollharness/src/scripts/checks/check_security.js +48 -0
  26. package/dist/bollharness/src/scripts/checks/check_skill_parity.js +6 -0
  27. package/dist/bollharness/src/scripts/checks/check_versions.js +6 -0
  28. package/dist/bollharness/src/scripts/checks/finding.js +13 -0
  29. package/dist/bollharness/src/scripts/checks/next_decision_number.js +20 -0
  30. package/dist/bollharness/src/scripts/checks/regenerate_magic_docs.js +6 -0
  31. package/dist/bollharness/src/scripts/ci/detect_rebaseline_triggers.js +8 -0
  32. package/dist/bollharness/src/scripts/ci/scan_subprocess_cfg.js +8 -0
  33. package/dist/bollharness/src/scripts/ci/scan_verify_artifacts.js +8 -0
  34. package/dist/bollharness/src/scripts/ci/scan_yaml_schema.js +8 -0
  35. package/dist/bollharness/src/scripts/context_router.js +67 -0
  36. package/dist/bollharness/src/scripts/deploy-guard.js +157 -0
  37. package/dist/bollharness/src/scripts/guard-feedback.js +192 -0
  38. package/dist/bollharness/src/scripts/guard_router.js +158 -0
  39. package/dist/bollharness/src/scripts/hooks/_hook_output.js +6 -0
  40. package/dist/bollharness/src/scripts/hooks/auto-python3.js +6 -0
  41. package/dist/bollharness/src/scripts/hooks/deploy-progress-on-session-end.js +6 -0
  42. package/dist/bollharness/src/scripts/hooks/failure-analyzer.js +6 -0
  43. package/dist/bollharness/src/scripts/hooks/gate-judgment-inject.js +92 -0
  44. package/dist/bollharness/src/scripts/hooks/gate-transition-judgment.js +63 -0
  45. package/dist/bollharness/src/scripts/hooks/inbox-ack.js +6 -0
  46. package/dist/bollharness/src/scripts/hooks/inbox-inject-on-start.js +6 -0
  47. package/dist/bollharness/src/scripts/hooks/inbox-validate.js +6 -0
  48. package/dist/bollharness/src/scripts/hooks/inbox-write-ledger.js +6 -0
  49. package/dist/bollharness/src/scripts/hooks/initializer-agent.js +6 -0
  50. package/dist/bollharness/src/scripts/hooks/loop-detection.js +73 -0
  51. package/dist/bollharness/src/scripts/hooks/owner-guard.js +6 -0
  52. package/dist/bollharness/src/scripts/hooks/precompact.js +6 -0
  53. package/dist/bollharness/src/scripts/hooks/review-agent-gatekeeper.js +6 -0
  54. package/dist/bollharness/src/scripts/hooks/risk-tracker.js +108 -0
  55. package/dist/bollharness/src/scripts/hooks/sanitize-on-read.js +6 -0
  56. package/dist/bollharness/src/scripts/hooks/session-reflection.js +7 -0
  57. package/dist/bollharness/src/scripts/hooks/session-start-magic-docs.js +7 -0
  58. package/dist/bollharness/src/scripts/hooks/session-start-reset-risk.js +7 -0
  59. package/dist/bollharness/src/scripts/hooks/session-start-toolkit-reminder.js +7 -0
  60. package/dist/bollharness/src/scripts/hooks/stop-evaluator.js +157 -0
  61. package/dist/bollharness/src/scripts/hooks/tool-call-counter.js +6 -0
  62. package/dist/bollharness/src/scripts/hooks/trace-analyzer.js +10 -0
  63. package/dist/bollharness/src/scripts/install/install-trust-token.js +7 -0
  64. package/dist/bollharness/src/scripts/install/multi_project_registry.js +9 -0
  65. package/dist/bollharness/src/scripts/install/phase2_auto.js +21 -0
  66. package/dist/bollharness/src/scripts/install/pre_commit_installer.js +6 -0
  67. package/dist/bollharness/src/scripts/install/tier_selector.js +7 -0
  68. package/dist/bollharness/src/scripts/install/transcript_miner.js +7 -0
  69. package/dist/bollharness/src/scripts/lib/claim_patterns.js +10 -0
  70. package/dist/bollharness/src/scripts/lib/sanitize_patterns.js +12 -0
  71. package/dist/bollharness/src/scripts/sanitize.js +6 -0
  72. package/dist/bollharness-integration/channel-judgment-engine.js +530 -0
  73. package/dist/bollharness-integration/context-chain-router.js +383 -0
  74. package/dist/bollharness-integration/context-router-judgment.js +13 -21
  75. package/dist/bollharness-integration/context-router.js +22 -64
  76. package/dist/bollharness-integration/gate-state-machine.js +14 -19
  77. package/dist/bollharness-integration/gate-transition-hooks.js +16 -61
  78. package/dist/bollharness-integration/guard-checker.js +21 -68
  79. package/dist/bollharness-integration/index.js +14 -124
  80. package/dist/bollharness-integration/integration.js +13 -20
  81. package/dist/bollharness-integration/llm-judgment-engine.js +569 -0
  82. package/dist/bollharness-integration/skill-adapter.js +18 -64
  83. package/dist/cli-entry.js +261 -0
  84. package/dist/constraint-runtime/src/commands.js +17 -7
  85. package/dist/constraint-runtime/src/constraint/budget.js +1 -6
  86. package/dist/constraint-runtime/src/constraint/permission.js +1 -6
  87. package/dist/constraint-runtime/src/models.js +1 -3
  88. package/dist/constraint-runtime/src/tools.js +17 -7
  89. package/dist/constraints/index.js +1 -7
  90. package/dist/documents/reader.js +8 -49
  91. package/dist/heartbeat/DaemonManager.js +242 -0
  92. package/dist/heartbeat/HealthMonitor.js +285 -0
  93. package/dist/heartbeat/StartupVerifier.js +205 -0
  94. package/dist/heartbeat/Watchdog.js +168 -0
  95. package/dist/heartbeat/index.js +84 -0
  96. package/dist/heartbeat/types.js +5 -0
  97. package/dist/index.js +381 -28
  98. package/dist/llm/config-store.js +31 -57
  99. package/dist/llm/llm-judgment-client.js +389 -0
  100. package/dist/llm/pi-ai.js +9 -52
  101. package/dist/network/agent-network.js +46 -90
  102. package/dist/network/hybrid-messenger.js +125 -0
  103. package/dist/network/iroh-bootstrap.js +38 -0
  104. package/dist/network/iroh-discovery.js +145 -0
  105. package/dist/network/iroh-integration.js +9 -16
  106. package/dist/network/iroh-transport.js +10 -48
  107. package/dist/network/p2p.js +23 -62
  108. package/dist/network/storage/adapters/json-adapter.js +4 -42
  109. package/dist/network/storage/index.js +147 -0
  110. package/dist/network/storage/types.js +14 -0
  111. package/dist/pi-ecosystem/index.js +233 -0
  112. package/dist/pi-ecosystem-colony/index.js +29 -90
  113. package/dist/pi-ecosystem-goals/index.js +20 -74
  114. package/dist/pi-ecosystem-judgment/decision.js +29 -47
  115. package/dist/pi-ecosystem-judgment/distillation.js +16 -29
  116. package/dist/pi-ecosystem-judgment/human-value-store.js +13 -60
  117. package/dist/pi-ecosystem-judgment/index.js +21 -74
  118. package/dist/pi-ecosystem-judgment/value-injection.js +26 -72
  119. package/dist/pi-ecosystem-mcp/index.js +24 -78
  120. package/dist/pi-ecosystem-subagents/index.js +20 -69
  121. package/dist/social/ant-colony/AdaptiveHeartbeat.js +3 -8
  122. package/dist/social/ant-colony/PheromoneEngine.js +11 -49
  123. package/dist/social/ant-colony/index.js +6 -0
  124. package/dist/social/ant-colony/types.js +4 -8
  125. package/dist/social/channels/ChannelManager.js +8 -46
  126. package/dist/social/channels/DiapChannelBridge.js +9 -47
  127. package/dist/social/channels/InterestMatcher.js +2 -7
  128. package/dist/social/channels/channel-agent-session.js +309 -0
  129. package/dist/social/channels/channel-heartbeat-agent.js +494 -0
  130. package/dist/social/channels/diap-doc-parser.js +204 -0
  131. package/dist/social/channels/harness-workflow-integrator.js +446 -0
  132. package/dist/social/channels/index.js +9 -0
  133. package/dist/social/channels/types.js +3 -7
  134. package/dist/social/global-shared-context.js +6 -47
  135. package/dist/social/heartbeat.js +29 -72
  136. package/dist/social/persona/enhanced-persona.js +299 -0
  137. package/dist/web/client.js +302 -136
  138. package/dist/web/components/p2p/index.js +159 -9
  139. package/dist/web/components/p2p/p2p-connection.js +136 -0
  140. package/dist/web/components/p2p/p2p-manager.js +24 -0
  141. package/dist/web/components/p2p/p2p-store-memory.js +1 -1
  142. package/dist/web/components/p2p/types.js +7 -0
  143. package/dist/web/index.html +5 -0
  144. package/dist/web/style.css +118 -0
  145. package/package.json +12 -6
  146. package/scripts/build-cli.js +206 -0
  147. package/scripts/postinstall.js +153 -0
  148. package/src/agents/pi-sdk.ts +347 -28
  149. package/src/agents/protocol.ts +95 -1
  150. package/src/agents/workflow-pivot-loop.ts +674 -0
  151. package/src/bollharness/scripts/context-fragments/pi-agent-operations.md +34 -0
  152. package/src/cli-entry.ts +304 -0
  153. package/src/heartbeat/DaemonManager.ts +283 -0
  154. package/src/heartbeat/HealthMonitor.ts +316 -0
  155. package/src/heartbeat/StartupVerifier.ts +223 -0
  156. package/src/heartbeat/Watchdog.ts +198 -0
  157. package/src/heartbeat/index.ts +108 -0
  158. package/src/heartbeat/types.ts +82 -0
  159. package/src/llm/config-store.ts +23 -5
  160. package/src/network/iroh-transport.ts +3 -3
  161. package/src/web/client.js +302 -136
  162. package/src/web/components/p2p/P2PModal.tsx +91 -3
  163. package/src/web/components/p2p/index.ts +171 -9
  164. package/src/web/components/p2p/p2p-connection.ts +153 -1
  165. package/src/web/components/p2p/p2p-manager.ts +39 -1
  166. package/src/web/components/p2p/p2p-store-memory.ts +1 -1
  167. package/src/web/components/p2p/p2p-tools.ts +315 -0
  168. package/src/web/components/p2p/types.ts +58 -0
  169. package/src/web/index.html +5 -0
  170. package/src/web/server.ts +353 -36
  171. package/src/web/style.css +118 -0
  172. package/tsconfig.cli.json +16 -0
  173. package/tsconfig.electron.json +1 -1
  174. package/tsconfig.json +1 -2
  175. package/dist/constraint-runtime/tests/agent.test.js +0 -16
  176. package/dist/constraint-runtime/tests/constraint.test.js +0 -41
  177. package/dist/constraint-runtime/tests/skill.test.js +0 -19
  178. package/dist/constraint-runtime/tests/thinking.test.js +0 -22
  179. package/dist/electron-preload.js +0 -15
  180. package/dist/electron-preload.js.map +0 -1
  181. package/dist/electron.js +0 -206
  182. package/dist/electron.js.map +0 -1
  183. package/dist/test/constraint-layer.test.js +0 -164
  184. package/dist/test/global-shared-context.test.js +0 -315
  185. package/dist/test/pi-sdk.test.js +0 -47
  186. package/dist/test/set-persona.test.js +0 -38
  187. package/dist/test/subagent-manager.test.js +0 -276
  188. package/dist/test/workflow-engine.test.js +0 -87
  189. package/dist/web/server.js +0 -1647
  190. package/dist/web/server.js.map +0 -1
  191. package/dist/workflows/collaboration.js +0 -374
  192. package/dist/workflows/index.js +0 -54
  193. package/docs/agent-communication.md +0 -333
  194. package/docs/plans/2026-05-15-document-agent-design.md +0 -479
  195. package/docs/plans/2026-05-15-document-agent-implementation-plan.md +0 -792
  196. package/docs/plans/2026-05-16-chat-ui-design.md +0 -86
  197. package/docs/plans/2026-05-16-constraint-runtime-design.md +0 -106
  198. package/docs/plans/2026-05-16-constraint-runtime-implementation.md +0 -441
  199. package/docs//346/225/260/345/255/246/350/276/205/345/212/251/346/231/272/350/203/275/344/275/223-/346/240/270/345/277/203/346/225/210/346/236/234/345/256/232/344/271/211.md +0 -287
  200. package/src/bollharness/.boll/CLAUDE.md.template +0 -34
  201. package/src/bollharness/.boll/MANIFEST.yaml +0 -213
  202. package/src/bollharness/.boll/active-review-agents/.gitkeep +0 -0
  203. package/src/bollharness/.boll/agents/review-base.yaml +0 -108
  204. package/src/bollharness/.boll/deploy-allowlist.yaml +0 -38
  205. package/src/bollharness/.boll/inbox/schema/message-v1.json +0 -99
  206. package/src/bollharness/.boll/install-staging/.gitkeep +0 -0
  207. package/src/bollharness/.boll/issue-adapter.yaml +0 -31
  208. package/src/bollharness/.boll/plugins/boll-mode-toolkit/contracts/mode-contract.md +0 -85
  209. package/src/bollharness/.boll/plugins/boll-review-toolkit/contracts/evidence-packet-schema.json +0 -102
  210. package/src/bollharness/.boll/plugins/boll-review-toolkit/contracts/review-contract.yaml +0 -247
  211. package/src/bollharness/.boll/rules/backend-routes.md +0 -31
  212. package/src/bollharness/.boll/rules/closure-semantics.md +0 -30
  213. package/src/bollharness/.boll/rules/env-vars.md +0 -32
  214. package/src/bollharness/.boll/rules/hanis-protocol.md +0 -145
  215. package/src/bollharness/.boll/rules/repo-structure.md +0 -42
  216. package/src/bollharness/.boll/rules/review-agent-isolation.md +0 -73
  217. package/src/bollharness/.boll/rules/source-of-truth.md +0 -33
  218. package/src/bollharness/.boll/settings.json +0 -180
  219. package/src/bollharness/.boll/settings.json.template +0 -31
  220. package/src/bollharness/.boll/skills/arch/SKILL.md +0 -372
  221. package/src/bollharness/.boll/skills/bug-pipeline/SKILL.md +0 -168
  222. package/src/bollharness/.boll/skills/bug-triage/SKILL.md +0 -161
  223. package/src/bollharness/.boll/skills/context-chains/SKILL.md +0 -250
  224. package/src/bollharness/.boll/skills/context-chains/context-chain-index.md +0 -48
  225. package/src/bollharness/.boll/skills/context-chains/work-type-extractors/code_change_extractor.ts +0 -142
  226. package/src/bollharness/.boll/skills/context-chains/work-type-extractors/debugging_extractor.ts +0 -126
  227. package/src/bollharness/.boll/skills/context-chains/work-type-extractors/design_extractor.ts +0 -148
  228. package/src/bollharness/.boll/skills/context-chains/work-type-extractors/planning_extractor.ts +0 -162
  229. package/src/bollharness/.boll/skills/context-chains/work-type-extractors/question_extractor.ts +0 -116
  230. package/src/bollharness/.boll/skills/context-chains/work-type-extractors/review_extractor.ts +0 -136
  231. package/src/bollharness/.boll/skills/crystal-learn/SKILL.md +0 -93
  232. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-0.md +0 -34
  233. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-1.md +0 -34
  234. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-2.md +0 -35
  235. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-3.md +0 -34
  236. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-4.md +0 -43
  237. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-5.md +0 -34
  238. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-6.md +0 -37
  239. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-7.md +0 -46
  240. package/src/bollharness/.boll/skills/guardian-fixer/PROMPT.md +0 -415
  241. package/src/bollharness/.boll/skills/guardian-fixer/SKILL.md +0 -320
  242. package/src/bollharness/.boll/skills/harness-dev/SKILL.md +0 -93
  243. package/src/bollharness/.boll/skills/harness-dev/examples/README.md +0 -227
  244. package/src/bollharness/.boll/skills/harness-dev-handoff/SKILL.md +0 -165
  245. package/src/bollharness/.boll/skills/harness-eng/SKILL.md +0 -110
  246. package/src/bollharness/.boll/skills/harness-eng-test/SKILL.md +0 -79
  247. package/src/bollharness/.boll/skills/harness-lab/SKILL.md +0 -170
  248. package/src/bollharness/.boll/skills/harness-ops/SKILL.md +0 -57
  249. package/src/bollharness/.boll/skills/harness-voice/SKILL.md +0 -183
  250. package/src/bollharness/.boll/skills/judgment/SKILL.md +0 -115
  251. package/src/bollharness/.boll/skills/lead/SKILL.md +0 -245
  252. package/src/bollharness/.boll/skills/lead/install-wow-harness.md +0 -77
  253. package/src/bollharness/.boll/skills/lead/ref-review-sop.md +0 -91
  254. package/src/bollharness/.boll/skills/lead/ref-stages.md +0 -129
  255. package/src/bollharness/.boll/skills/skill-discovery/SKILL.md +0 -169
  256. package/src/bollharness/.boll/skills/task-arch/SKILL.md +0 -106
  257. package/src/bollharness/.boll/skills/toolkit/SKILL.md +0 -57
  258. package/src/bollharness/.boll/tasks/.gitkeep +0 -0
  259. package/src/bollharness/.boll/toolkit-index.yaml +0 -112
  260. package/src/bollharness/.claude/agents/review-base.yaml +0 -108
  261. package/src/bollharness/.claude/plugins/boll-mode-toolkit/.claude-plugin/plugin.json +0 -44
  262. package/src/bollharness/.claude/plugins/boll-review-toolkit/.claude-plugin/plugin.json +0 -24
  263. package/src/bollharness/.claude/plugins/boll-review-toolkit/contracts/evidence-packet-schema.json +0 -102
  264. package/src/bollharness/.claude/plugins/boll-review-toolkit/contracts/review-contract.yaml +0 -247
  265. package/src/bollharness/.claude/settings.json +0 -157
  266. package/src/bollharness/.claude/skills/arch/SKILL.md +0 -64
  267. package/src/bollharness/.claude/skills/crystal-learn/SKILL.md +0 -93
  268. package/src/bollharness/.claude/skills/guardian-fixer/PROMPT.md +0 -44
  269. package/src/bollharness/.claude/skills/guardian-fixer/SKILL.md +0 -324
  270. package/src/bollharness/.claude/skills/harness-dev/SKILL.md +0 -93
  271. package/src/bollharness/.claude/skills/harness-dev/examples/README.md +0 -17
  272. package/src/bollharness/.claude/skills/harness-dev-handoff/SKILL.md +0 -165
  273. package/src/bollharness/.claude/skills/harness-eng/SKILL.md +0 -183
  274. package/src/bollharness/.claude/skills/harness-eng-test/SKILL.md +0 -57
  275. package/src/bollharness/.claude/skills/harness-ops/SKILL.md +0 -57
  276. package/src/bollharness/.claude/skills/harness-voice/SKILL.md +0 -84
  277. package/src/bollharness/.claude/skills/lead/INDEX.md +0 -28
  278. package/src/bollharness/.claude/skills/lead/SKILL.md +0 -24
  279. package/src/bollharness/.claude/skills/lead/install-wow-harness.md +0 -77
  280. package/src/bollharness/.claude/skills/lead/ref-review-sop.md +0 -48
  281. package/src/bollharness/.claude/skills/lead/ref-stages.md +0 -58
  282. package/src/bollharness/.claude/skills/plan-lock/SKILL.md +0 -74
  283. package/src/bollharness/.claude/skills/skill-discovery/SKILL.md +0 -120
  284. package/src/bollharness/.claude/skills/task-arch/SKILL.md +0 -106
  285. package/src/bollharness/.claude/skills/toolkit/SKILL.md +0 -57
  286. package/src/bollharness/.claude/skills/toolkit/list.sh +0 -92
  287. package/src/bollharness/.githooks/pre-commit +0 -21
  288. package/src/bollharness/.github/workflows/ci.yml +0 -88
  289. package/src/bollharness/docs/decisions/ADR-030-guard-signal-protocol-and-governance-reload.md +0 -1076
  290. package/src/bollharness/docs/decisions/ADR-038-harness-optimization-strategy.md +0 -2039
  291. package/src/bollharness/docs/decisions/ADR-041-codex-claude-code-division-of-labor.md +0 -128
  292. package/src/bollharness/docs/decisions/ADR-H1-crystal-learn-revival.md +0 -188
  293. package/src/bollharness/docs/decisions/ADR-H2-identity-isolation.md +0 -183
  294. package/src/bollharness/docs/decisions/ADR-H3-memory-scope.md +0 -133
  295. package/src/bollharness/docs/decisions/ADR-H4-prompt-governance.md +0 -146
  296. package/src/bollharness/docs/decisions/ADR-H5-gate-quantization.md +0 -212
  297. package/src/bollharness/docs/decisions/ADR-H6-state-file-health.md +0 -211
  298. package/src/bollharness/docs/decisions/ADR-H8-issue-and-doc-compliance.md +0 -202
  299. package/src/bollharness/docs/decisions/ADR-H9-mailbox.md +0 -231
  300. package/src/bollharness/docs/decisions/PLAN-H1-crystal-learn-revival.md +0 -270
  301. package/src/bollharness/docs/decisions/PLAN-H2-identity-isolation.md +0 -291
  302. package/src/bollharness/docs/decisions/PLAN-H3-memory-scope.md +0 -228
  303. package/src/bollharness/docs/decisions/PLAN-H4-prompt-governance.md +0 -227
  304. package/src/bollharness/docs/decisions/PLAN-H5-gate-quantization.md +0 -239
  305. package/src/bollharness/docs/decisions/PLAN-H6-state-file-health.md +0 -325
  306. package/src/bollharness/docs/decisions/PLAN-H8-issue-and-doc-compliance.md +0 -242
  307. package/src/bollharness/docs/decisions/PLAN-H9-mailbox.md +0 -378
  308. package/src/bollharness/docs/launch-article-en.md +0 -276
  309. package/src/bollharness/docs/launch-article-zh.md +0 -305
  310. package/src/bollharness/docs/practice.html +0 -356
  311. package/src/bollharness/docs/practice.md +0 -82
  312. package/src/bollharness/docs/research/round-1/README.md +0 -11
  313. package/src/bollharness/docs/research/round-2/README.md +0 -11
  314. package/src/bollharness/docs/research/round-3/README.md +0 -11
  315. package/src/bollharness/docs/research/round-4/README.md +0 -11
  316. package/src/bollharness/docs/research/round-5/README.md +0 -11
  317. package/src/bollharness/docs/research/round-6/README.md +0 -11
  318. package/src/bollharness/package-lock.json +0 -48
  319. package/src/bollharness/reference/boll-reference/.claude/rules/backend-routes.md +0 -268
  320. package/src/bollharness/reference/boll-reference/.claude/rules/bridge.md +0 -20
  321. package/src/bollharness/reference/boll-reference/.claude/rules/closure-semantics.md +0 -30
  322. package/src/bollharness/reference/boll-reference/.claude/rules/coaching.md +0 -13
  323. package/src/bollharness/reference/boll-reference/.claude/rules/env-vars.md +0 -50
  324. package/src/bollharness/reference/boll-reference/.claude/rules/hackathon.md +0 -12
  325. package/src/bollharness/reference/boll-reference/.claude/rules/repo-structure.md +0 -184
  326. package/src/bollharness/reference/boll-reference/.claude/rules/review-agent-isolation.md +0 -112
  327. package/src/bollharness/reference/boll-reference/.claude/rules/scenes.md +0 -12
  328. package/src/bollharness/reference/boll-reference/.claude/skills/arch/SKILL.md +0 -551
  329. package/src/bollharness/reference/boll-reference/.claude/skills/boll-animation/SKILL.md +0 -26
  330. package/src/bollharness/reference/boll-reference/.claude/skills/boll-bridge/SKILL.md +0 -227
  331. package/src/bollharness/reference/boll-reference/.claude/skills/boll-bridge/agents/openai.yaml +0 -4
  332. package/src/bollharness/reference/boll-reference/.claude/skills/boll-bridge/references/bridge-failure-taxonomy.md +0 -142
  333. package/src/bollharness/reference/boll-reference/.claude/skills/boll-bridge/references/bridge-validation-ladder.md +0 -107
  334. package/src/bollharness/reference/boll-reference/.claude/skills/boll-crystal/SKILL.md +0 -893
  335. package/src/bollharness/reference/boll-reference/.claude/skills/boll-crystal-learn/SKILL.md +0 -89
  336. package/src/bollharness/reference/boll-reference/.claude/skills/boll-dev/SKILL.md +0 -93
  337. package/src/bollharness/reference/boll-reference/.claude/skills/boll-dev/examples/README.md +0 -209
  338. package/src/bollharness/reference/boll-reference/.claude/skills/boll-dev-handoff/SKILL.md +0 -165
  339. package/src/bollharness/reference/boll-reference/.claude/skills/boll-eng/SKILL.md +0 -110
  340. package/src/bollharness/reference/boll-reference/.claude/skills/boll-eng-frontend/SKILL.md +0 -203
  341. package/src/bollharness/reference/boll-reference/.claude/skills/boll-eng-hdc/SKILL.md +0 -27
  342. package/src/bollharness/reference/boll-reference/.claude/skills/boll-eng-orchestrator/SKILL.md +0 -28
  343. package/src/bollharness/reference/boll-reference/.claude/skills/boll-eng-prompt/SKILL.md +0 -27
  344. package/src/bollharness/reference/boll-reference/.claude/skills/boll-eng-test/SKILL.md +0 -79
  345. package/src/bollharness/reference/boll-reference/.claude/skills/boll-lab/SKILL.md +0 -372
  346. package/src/bollharness/reference/boll-reference/.claude/skills/boll-run/SKILL.md +0 -437
  347. package/src/bollharness/reference/boll-reference/.claude/skills/boll-ux-appstore/SKILL.md +0 -27
  348. package/src/bollharness/reference/boll-reference/.claude/skills/boll-voice/SKILL.md +0 -442
  349. package/src/bollharness/reference/boll-reference/.claude/skills/guardian-fixer/PROMPT.md +0 -421
  350. package/src/bollharness/reference/boll-reference/.claude/skills/guardian-fixer/SKILL.md +0 -326
  351. package/src/bollharness/reference/boll-reference/.claude/skills/lead/SKILL.md +0 -155
  352. package/src/bollharness/reference/boll-reference/.claude/skills/lead/ref-review-sop.md +0 -91
  353. package/src/bollharness/reference/boll-reference/.claude/skills/lead/ref-stages.md +0 -129
  354. package/src/bollharness/reference/boll-reference/.claude/skills/nature-designer/output/skill-map-preview.png +0 -0
  355. package/src/bollharness/reference/boll-reference/.claude/skills/nature-designer/output/skill-map-v2.png +0 -0
  356. package/src/bollharness/reference/boll-reference/.claude/skills/nature-designer/output/skill-map-v3.png +0 -0
  357. package/src/bollharness/reference/boll-reference/.claude/skills/nature-designer/output/skill-map-v4.png +0 -0
  358. package/src/bollharness/reference/boll-reference/.claude/skills/plan-lock/SKILL.md +0 -425
  359. package/src/bollharness/reference/boll-reference/.claude/skills/plan-lock/ref-three-checks.md +0 -62
  360. package/src/bollharness/reference/boll-reference/.claude/skills/plan-lock/ref-wp-templates.md +0 -78
  361. package/src/bollharness/reference/boll-reference/.claude/skills/task-arch/SKILL.md +0 -76
  362. package/src/bollharness/reference/boll-reference/.claude/skills/vibedevteam-graph/SKILL.md +0 -57
  363. package/src/bollharness/reference/boll-reference/.claude/skills/vibedevteam-graph/beads-graph.sh +0 -153
  364. package/src/bollharness/reference/boll-reference/.claude/skills/vibedevteam-init/SKILL.md +0 -52
  365. package/src/bollharness/reference/boll-reference/.claude/skills/vibedevteam-init/beads-auto-link.sh +0 -76
  366. package/src/bollharness/reference/boll-reference/.claude/skills/vibedevteam-sync/SKILL.md +0 -50
  367. package/src/bollharness/reference/boll-reference/.claude/skills/vibedevteam-sync/beads-sync-proj.sh +0 -108
  368. package/src/bollharness/reference/boll-reference/docs/architecture/AGENT-PROFILE.md +0 -151
  369. package/src/bollharness/reference/boll-reference/docs/architecture/COST-STRUCTURE.md +0 -56
  370. package/src/bollharness/reference/boll-reference/docs/architecture/INDEX.md +0 -76
  371. package/src/bollharness/reference/boll-reference/docs/architecture/MODULE1-INTENT-FIELD.md +0 -116
  372. package/src/bollharness/reference/boll-reference/docs/architecture/MODULE2-CRYSTALLIZATION.md +0 -200
  373. package/src/bollharness/reference/boll-reference/docs/architecture/PRINCIPLES.md +0 -84
  374. package/src/bollharness/reference/boll-reference/docs/architecture/PROTOCOL-CORE.md +0 -209
  375. package/src/bollharness/reference/boll-reference/docs/architecture/VISION.md +0 -181
  376. package/src/bollharness/reference/boll-reference/docs/architecture/discussions/D-01-MARKET-SCENE-PROTOCOL.md +0 -754
  377. package/src/bollharness/templates/scaffold/.boll/guard/.gitkeep +0 -0
  378. package/src/bollharness/templates/scaffold/.boll/metrics/.gitkeep +0 -0
  379. package/src/bollharness/templates/scaffold/.boll/state/.gitkeep +0 -0
  380. package/src/bollharness/templates/scaffold/docs/INDEX.md +0 -3
  381. package/src/bollharness/templates/scaffold/docs/decisions/ADR_TEMPLATE.md +0 -38
  382. package/src/bollharness/templates/scaffold/docs/decisions/PLAN_TEMPLATE.md +0 -45
  383. package/src/bollharness/templates/scaffold/docs/decisions/tasks/.gitkeep +0 -2
  384. package/src/bollharness/templates/scaffold/docs/issues/.gitkeep +0 -0
  385. package/src/bollharness/templates/scaffold/docs/issues/GUARD_ISSUE_TEMPLATE.md +0 -35
  386. package/src/bollharness/templates/scaffold/docs/issues/ISSUE_TEMPLATE.md +0 -51
  387. package/src/bollharness/tsconfig.json +0 -26
  388. package/src/constraint-runtime/package-lock.json +0 -48
  389. package/src/constraint-runtime/package.json +0 -34
  390. package/src/constraint-runtime/src/_archive_helper.ts +0 -16
  391. package/src/constraint-runtime/src/agent/coordinator.ts +0 -71
  392. package/src/constraint-runtime/src/agent/index.ts +0 -1
  393. package/src/constraint-runtime/src/assistant/index.ts +0 -15
  394. package/src/constraint-runtime/src/bootstrap/index.ts +0 -15
  395. package/src/constraint-runtime/src/bootstrap_graph.ts +0 -17
  396. package/src/constraint-runtime/src/bridge/index.ts +0 -15
  397. package/src/constraint-runtime/src/buddy/index.ts +0 -15
  398. package/src/constraint-runtime/src/cli/index.ts +0 -15
  399. package/src/constraint-runtime/src/command_graph.ts +0 -20
  400. package/src/constraint-runtime/src/commands.ts +0 -83
  401. package/src/constraint-runtime/src/components/index.ts +0 -15
  402. package/src/constraint-runtime/src/constants/index.ts +0 -15
  403. package/src/constraint-runtime/src/constraint/budget.ts +0 -25
  404. package/src/constraint-runtime/src/constraint/index.ts +0 -3
  405. package/src/constraint-runtime/src/constraint/permission.ts +0 -28
  406. package/src/constraint-runtime/src/context.ts +0 -45
  407. package/src/constraint-runtime/src/coordinator/index.ts +0 -15
  408. package/src/constraint-runtime/src/cost_hook.ts +0 -6
  409. package/src/constraint-runtime/src/cost_tracker.ts +0 -9
  410. package/src/constraint-runtime/src/deferred_init.ts +0 -18
  411. package/src/constraint-runtime/src/direct_modes.ts +0 -13
  412. package/src/constraint-runtime/src/dynamic-tool-loader.ts +0 -115
  413. package/src/constraint-runtime/src/entrypoints/index.ts +0 -15
  414. package/src/constraint-runtime/src/execution_registry.ts +0 -41
  415. package/src/constraint-runtime/src/history.ts +0 -16
  416. package/src/constraint-runtime/src/hooks/index.ts +0 -15
  417. package/src/constraint-runtime/src/index.ts +0 -28
  418. package/src/constraint-runtime/src/ink.ts +0 -4
  419. package/src/constraint-runtime/src/keybindings/index.ts +0 -15
  420. package/src/constraint-runtime/src/memdir/index.ts +0 -15
  421. package/src/constraint-runtime/src/migrations/index.ts +0 -15
  422. package/src/constraint-runtime/src/models.ts +0 -49
  423. package/src/constraint-runtime/src/moreright/index.ts +0 -15
  424. package/src/constraint-runtime/src/native_ts/index.ts +0 -15
  425. package/src/constraint-runtime/src/output_styles/index.ts +0 -15
  426. package/src/constraint-runtime/src/parity_audit.ts +0 -23
  427. package/src/constraint-runtime/src/plugins/index.ts +0 -15
  428. package/src/constraint-runtime/src/port_manifest.ts +0 -20
  429. package/src/constraint-runtime/src/prefetch.ts +0 -17
  430. package/src/constraint-runtime/src/query.ts +0 -7
  431. package/src/constraint-runtime/src/reference_data/archive_surface_snapshot.json +0 -63
  432. package/src/constraint-runtime/src/reference_data/commands_snapshot.json +0 -1037
  433. package/src/constraint-runtime/src/reference_data/subsystems/OpenCLI.json +0 -10
  434. package/src/constraint-runtime/src/reference_data/subsystems/PolymarketSDK.json +0 -12
  435. package/src/constraint-runtime/src/reference_data/subsystems/SafeSDK.json +0 -14
  436. package/src/constraint-runtime/src/reference_data/subsystems/assistant.json +0 -8
  437. package/src/constraint-runtime/src/reference_data/subsystems/bootstrap.json +0 -8
  438. package/src/constraint-runtime/src/reference_data/subsystems/bridge.json +0 -32
  439. package/src/constraint-runtime/src/reference_data/subsystems/buddy.json +0 -13
  440. package/src/constraint-runtime/src/reference_data/subsystems/cli.json +0 -26
  441. package/src/constraint-runtime/src/reference_data/subsystems/components.json +0 -32
  442. package/src/constraint-runtime/src/reference_data/subsystems/constants.json +0 -28
  443. package/src/constraint-runtime/src/reference_data/subsystems/coordinator.json +0 -8
  444. package/src/constraint-runtime/src/reference_data/subsystems/entrypoints.json +0 -15
  445. package/src/constraint-runtime/src/reference_data/subsystems/hooks.json +0 -32
  446. package/src/constraint-runtime/src/reference_data/subsystems/keybindings.json +0 -21
  447. package/src/constraint-runtime/src/reference_data/subsystems/memdir.json +0 -15
  448. package/src/constraint-runtime/src/reference_data/subsystems/migrations.json +0 -18
  449. package/src/constraint-runtime/src/reference_data/subsystems/moreright.json +0 -8
  450. package/src/constraint-runtime/src/reference_data/subsystems/native_ts.json +0 -11
  451. package/src/constraint-runtime/src/reference_data/subsystems/outputStyles.json +0 -8
  452. package/src/constraint-runtime/src/reference_data/subsystems/plugins.json +0 -9
  453. package/src/constraint-runtime/src/reference_data/subsystems/remote.json +0 -11
  454. package/src/constraint-runtime/src/reference_data/subsystems/schemas.json +0 -8
  455. package/src/constraint-runtime/src/reference_data/subsystems/screens.json +0 -10
  456. package/src/constraint-runtime/src/reference_data/subsystems/server.json +0 -10
  457. package/src/constraint-runtime/src/reference_data/subsystems/services.json +0 -32
  458. package/src/constraint-runtime/src/reference_data/subsystems/skills.json +0 -27
  459. package/src/constraint-runtime/src/reference_data/subsystems/state.json +0 -13
  460. package/src/constraint-runtime/src/reference_data/subsystems/types.json +0 -18
  461. package/src/constraint-runtime/src/reference_data/subsystems/upstreamproxy.json +0 -9
  462. package/src/constraint-runtime/src/reference_data/subsystems/utils.json +0 -32
  463. package/src/constraint-runtime/src/reference_data/subsystems/vim.json +0 -12
  464. package/src/constraint-runtime/src/reference_data/subsystems/voice.json +0 -8
  465. package/src/constraint-runtime/src/reference_data/tools_snapshot.json +0 -1042
  466. package/src/constraint-runtime/src/remote/index.ts +0 -15
  467. package/src/constraint-runtime/src/remote_runtime.ts +0 -17
  468. package/src/constraint-runtime/src/runtime/index.ts +0 -1
  469. package/src/constraint-runtime/src/runtime/session.ts +0 -42
  470. package/src/constraint-runtime/src/schemas/index.ts +0 -15
  471. package/src/constraint-runtime/src/screens/index.ts +0 -15
  472. package/src/constraint-runtime/src/server/index.ts +0 -15
  473. package/src/constraint-runtime/src/services/index.ts +0 -15
  474. package/src/constraint-runtime/src/session_store.ts +0 -32
  475. package/src/constraint-runtime/src/setup.ts +0 -50
  476. package/src/constraint-runtime/src/skills/index.ts +0 -1
  477. package/src/constraint-runtime/src/skills/skill-registry.ts +0 -40
  478. package/src/constraint-runtime/src/state/index.ts +0 -15
  479. package/src/constraint-runtime/src/system_init.ts +0 -21
  480. package/src/constraint-runtime/src/thinking/engine.ts +0 -61
  481. package/src/constraint-runtime/src/thinking/index.ts +0 -1
  482. package/src/constraint-runtime/src/tool_pool.ts +0 -20
  483. package/src/constraint-runtime/src/tools/OpenCLI/execAdapter.ts +0 -12
  484. package/src/constraint-runtime/src/tools/OpenCLI/listAdapters.ts +0 -12
  485. package/src/constraint-runtime/src/tools/OpenCLI/runCommand.ts +0 -13
  486. package/src/constraint-runtime/src/tools/PolymarketSDK/cancelOrder.ts +0 -10
  487. package/src/constraint-runtime/src/tools/PolymarketSDK/createOrder.ts +0 -13
  488. package/src/constraint-runtime/src/tools/PolymarketSDK/getMarket.ts +0 -14
  489. package/src/constraint-runtime/src/tools/PolymarketSDK/getOrders.ts +0 -10
  490. package/src/constraint-runtime/src/tools/PolymarketSDK/listMarkets.ts +0 -24
  491. package/src/constraint-runtime/src/tools/SafeSDK/confirmTransaction.ts +0 -13
  492. package/src/constraint-runtime/src/tools/SafeSDK/createTransaction.ts +0 -23
  493. package/src/constraint-runtime/src/tools/SafeSDK/deploySafe.ts +0 -12
  494. package/src/constraint-runtime/src/tools/SafeSDK/executeTransaction.ts +0 -12
  495. package/src/constraint-runtime/src/tools/SafeSDK/getBalance.ts +0 -10
  496. package/src/constraint-runtime/src/tools/SafeSDK/getPendingTransactions.ts +0 -10
  497. package/src/constraint-runtime/src/tools/SafeSDK/proposeTransaction.ts +0 -14
  498. package/src/constraint-runtime/src/tools/WalletTools/autoPay.ts +0 -58
  499. package/src/constraint-runtime/src/tools/WalletTools/createWallet.ts +0 -19
  500. package/src/constraint-runtime/src/tools/WalletTools/getBalance.ts +0 -28
  501. package/src/constraint-runtime/src/tools/WalletTools/importWallet.ts +0 -34
  502. package/src/constraint-runtime/src/tools/WalletTools/sendTransaction.ts +0 -50
  503. package/src/constraint-runtime/src/tools/WalletTools/signMessage.ts +0 -23
  504. package/src/constraint-runtime/src/tools/WalletTools/transferToken.ts +0 -49
  505. package/src/constraint-runtime/src/tools.ts +0 -100
  506. package/src/constraint-runtime/src/transcript.ts +0 -23
  507. package/src/constraint-runtime/src/types/index.ts +0 -15
  508. package/src/constraint-runtime/src/upstream_proxy/index.ts +0 -15
  509. package/src/constraint-runtime/src/utils/index.ts +0 -15
  510. package/src/constraint-runtime/src/vim/index.ts +0 -15
  511. package/src/constraint-runtime/src/voice/index.ts +0 -15
  512. package/src/constraint-runtime/tests/agent.test.ts +0 -20
  513. package/src/constraint-runtime/tests/constraint.test.ts +0 -47
  514. package/src/constraint-runtime/tests/skill.test.ts +0 -23
  515. package/src/constraint-runtime/tests/thinking.test.ts +0 -28
  516. package/src/constraint-runtime/tsconfig.json +0 -13
  517. package/src/pi-ecosystem/index.ts +0 -453
  518. package/src/pi-ecosystem-colony/index.ts +0 -482
  519. package/src/pi-ecosystem-goals/index.ts +0 -585
  520. package/src/pi-ecosystem-judgment/decision.ts +0 -431
  521. package/src/pi-ecosystem-judgment/distillation.ts +0 -398
  522. package/src/pi-ecosystem-judgment/human-value-store.ts +0 -580
  523. package/src/pi-ecosystem-judgment/index.ts +0 -678
  524. package/src/pi-ecosystem-judgment/value-injection.ts +0 -744
  525. package/src/pi-ecosystem-mcp/index.ts +0 -427
  526. package/src/pi-ecosystem-subagents/index.ts +0 -408
  527. package/src/test/ai-judgment-test.ts +0 -92
  528. package/src/test/bollharness-integration.test.ts +0 -398
  529. package/src/test/channel-agent-multi-dialogue.ts +0 -265
  530. package/src/test/channel-heartbeat-agent-test.ts +0 -244
  531. package/src/test/constraint-layer.test.ts +0 -191
  532. package/src/test/diap-identity-test.ts +0 -222
  533. package/src/test/diap-quick-test.ts +0 -73
  534. package/src/test/global-shared-context.test.ts +0 -393
  535. package/src/test/harness-judgment-injection.test.ts +0 -353
  536. package/src/test/harness-workflow-integrator-test.ts +0 -285
  537. package/src/test/human-value-store.test.ts +0 -316
  538. package/src/test/hybrid-integration-test.ts +0 -126
  539. package/src/test/hybrid-messenger-verify.ts +0 -68
  540. package/src/test/iroh-bistream-debug.ts +0 -50
  541. package/src/test/iroh-communication.test.ts +0 -81
  542. package/src/test/iroh-debug-test.ts +0 -69
  543. package/src/test/iroh-diap-test.ts +0 -90
  544. package/src/test/iroh-direct-connect.ts +0 -65
  545. package/src/test/iroh-e2e-fixed.ts +0 -106
  546. package/src/test/iroh-e2e-same-process.ts +0 -83
  547. package/src/test/iroh-e2e.ts +0 -83
  548. package/src/test/iroh-final-e2e.ts +0 -84
  549. package/src/test/iroh-relay-test.ts +0 -46
  550. package/src/test/iroh-simple-test.ts +0 -49
  551. package/src/test/iroh-transport-verify.ts +0 -60
  552. package/src/test/iroh-transport.test.ts +0 -47
  553. package/src/test/iroh-two-nodes.ts +0 -87
  554. package/src/test/iroh-verify.ts +0 -55
  555. package/src/test/judgment-decision.test.ts +0 -373
  556. package/src/test/llm-judgment-integration.test.ts +0 -257
  557. package/src/test/p2p-agent-complex-dialogue.ts +0 -490
  558. package/src/test/p2p-agent-dialogue.ts +0 -423
  559. package/src/test/p2p-agent-full-bidirectional.ts +0 -686
  560. package/src/test/p2p-agent-harness-flow.ts +0 -562
  561. package/src/test/p2p-agent-harness-single.ts +0 -175
  562. package/src/test/p2p-ai-dialogue-test.ts +0 -374
  563. package/src/test/p2p-cid-connect-test.ts +0 -245
  564. package/src/test/p2p-connect-receiver.ts +0 -85
  565. package/src/test/p2p-iroh-test.ts +0 -214
  566. package/src/test/p2p-minimal-test.ts +0 -264
  567. package/src/test/p2p-node-1.ts +0 -172
  568. package/src/test/p2p-node-2.ts +0 -172
  569. package/src/test/p2p-server.ts +0 -335
  570. package/src/test/p2p-two-nodes-test.ts +0 -542
  571. package/src/test/pi-sdk.test.ts +0 -47
  572. package/src/test/set-persona.ts +0 -56
  573. package/src/test/simple.test.ts +0 -11
  574. package/src/test/storage-integration.test.ts +0 -191
  575. package/src/test/subagent-manager.test.ts +0 -392
  576. package/src/test/test-gate-flow.test.ts +0 -92
  577. package/src/test/workflow-engine.test.ts +0 -101
  578. package/src/workflows/collaboration.ts +0 -455
  579. package/src/workflows/index.ts +0 -64
  580. package/vitest.config.ts +0 -12
  581. package//346/203/263/346/263/225.md +0 -79
@@ -1,239 +0,0 @@
1
- ---
2
- plan: PLAN-H5
3
- adr_ref: ADR-H5-gate-quantization.md
4
- status: in-progress
5
- date: 2026-04-28
6
- parent_plan: H 系列 plan §3.3(H5 行)
7
- philosophy_inheritance:
8
- - ADR-041 v1.0
9
- - ADR-H0 §H0.1-H0.6 + H0.meta
10
- - ADR-H4 INV-H4-3 反例表
11
- - ADR-038 D11.2
12
- applies_scope:
13
- - .claude/plugins/boll-review-toolkit/contracts/review-contract.yaml
14
- - docs/decisions/ADR-H5-gate-quantization.md
15
- - docs/decisions/PLAN-H5-gate-quantization.md
16
- - docs/decisions/tasks/PLAN-H5/**
17
- not_in_scope:
18
- - 任何 hook 文件(INV-H5-3 红线)
19
- - .claude/skills/lead/SKILL.md(H4 占位)
20
- - verify-gate.py / transition.py(仅作为"读 yaml 字段"的消费方,不改其代码)
21
- ---
22
-
23
- # PLAN-H5:Gate 量纲化工程计划
24
-
25
- ## §1 上下文与基线锁定
26
-
27
- ### 1.1 工程目标
28
-
29
- 把 ADR-H5 的 3 条 INV(行数限额 schema 化 / 执检分离 binding 化 / 零机制实际引入)落地到 review-contract.yaml;不动任何 hook、不写任何 metrics、不引入任何新机制。
30
-
31
- ### 1.2 基线锁定(带行数 + 时间戳,避免 §4.7/§4.8 同根复现)
32
-
33
- | # | 资产 | 起草前实测 | 限额 | 时间戳(git log)|
34
- |---|------|------------|------|------------------|
35
- | 1 | `.claude/plugins/boll-review-toolkit/contracts/review-contract.yaml` | 132 行 / 4 active binding | ≤220 行 | 当前 HEAD ⇒ 末改 commit `c81xxxxx`(PLAN-098 时期) |
36
- | 2 | `docs/decisions/ADR-H5-gate-quantization.md` | 212 行(已起草) | ≤300 | 本 PLAN commit 同步 |
37
- | 3 | `docs/decisions/PLAN-H5-gate-quantization.md` | 本文件 | ≤500 | 同上 |
38
- | 4 | `.claude/plugins/boll-review-toolkit/agents/reviewer.md` | 仅引用,不改 | — | — |
39
- | 5 | `verify-gate.py` | 仅消费方,不改 | — | — |
40
- | 6 | reviewer signoff 历史路径形态 | H1 在 WP-05/,H2/3/4 在 PLAN-Hx/ 根 | INV-H5-2 锁定为 WP-05/ | 4 文件已存在,不迁移 |
41
- | 7 | 行数限额散落处 | ADR-H0 §H0.2 / ADR-H1 / ADR-H3 / ADR-H4 共 4 处 | INV-H5-1 收口为 yaml `line_caps` 顶层字段 | 4 ADR 不改文本,本 H 仅做 ref |
42
-
43
- ### 1.3 已知 race risk
44
-
45
- `docs/handoffs/ownership.yaml` 在 git status 中显示 modified(其他 session);`backend/product/admin/**` 多个未 commit 文件(PLAN-096 owning dev session);任何 H5 commit 必须用 `git commit --only <H5 路径>` 隔离(§4.4 + §4.9 教训复用)。
46
-
47
- ## §2 WP 拆解(5 WP)
48
-
49
- ### WP-01 现状盘点(已完成 in 2026-04-28T18:50 session)
50
- - DoD:基线表 §1.2 7 行齐全 + race risk §1.3 列出
51
- - 实测:✅ 已完成(本 PLAN §1.2/§1.3 即证据)
52
-
53
- ### WP-02 起草 ADR-H5 + PLAN-H5(已完成)
54
- - DoD:ADR-H5 ≤300 + PLAN-H5 ≤500 + INV ≥3 + 跳 Gate 决策表 ≥5 行 + inflation 规则 ≥3 条
55
- - 实测:✅ ADR-H5 212 行 + 跳 Gate 表 6 行 + inflation 规则 3 条
56
-
57
- ### WP-03 修改 review-contract.yaml(待执行)
58
-
59
- **目标**:在 review-contract.yaml 增加 3 处 schema 字段:
60
-
61
- 1. **顶层 `line_caps` 字段**(INV-H5-1):
62
- ```yaml
63
- line_caps:
64
- - id: adr-h-series
65
- glob: "docs/decisions/ADR-H*.md"
66
- max_lines: 300
67
- source_adr: "ADR-H0 §H0.2"
68
- - id: plan-h-series
69
- glob: "docs/decisions/PLAN-H*.md"
70
- max_lines: 500
71
- source_adr: "ADR-H0 §H0.2"
72
- - id: lead-skill-h-segment
73
- glob: ".claude/skills/lead/SKILL.md"
74
- max_lines: 220
75
- source_adr: "ADR-H1 受管资产 + ADR-H4 INV-H4-1"
76
- - id: memory-master-index
77
- glob: "~/.claude/projects/-Users-nature------boll/memory/MEMORY.md"
78
- max_lines: 200
79
- source_adr: "ADR-H3 INV-H3-2 v1.1"
80
- ```
81
-
82
- 2. **`merge-ready-review` binding 增加 `drafter_reviewer_separation` 子字段**(INV-H5-2):
83
- ```yaml
84
- drafter_reviewer_separation:
85
- required: true
86
- rationale: "ADR-H0 §H0.3 执检分离"
87
- evidence_path_pattern: "docs/decisions/tasks/PLAN-{plan}/WP-05/reviewer-verdict-*.md"
88
- reviewer_subagent_whitelist:
89
- - "pr-review-toolkit:code-reviewer"
90
- - "boll-review-toolkit:reviewer"
91
- ```
92
-
93
- 3. **顶层 `inflation` 字段**(ADR-H5 §5 三条规则):
94
- ```yaml
95
- inflation:
96
- no_grow_now_clean_later: true
97
- drafter_reviewer_must_differ_session: true
98
- h0_self_check_segment_required: true
99
- ```
100
-
101
- **DoD**:
102
- - yaml diff 仅新增 3 处字段;不删任何已有字段;4 active binding 字段不动
103
- - yaml 总行数 ≤220
104
- - `python3 -c "import yaml; yaml.safe_load(open('.claude/plugins/boll-review-toolkit/contracts/review-contract.yaml'))"` 无 SyntaxError
105
- - verify-gate.py 不修改;如新字段被读取需要后续 ADR
106
-
107
- **race-safe commit**:`git commit --only .claude/plugins/boll-review-toolkit/contracts/review-contract.yaml`
108
-
109
- ### WP-04 dogfood — H5 自身走 Gate(自指自检)
110
-
111
- **目标**:以本 PLAN-H5 起草过程为输入,验证 H5 的 3 条 INV 是否对自己生效。
112
-
113
- **输入材料**:
114
- - 本次 H5 起草过程的 git log(c356106b..H5 closure 时刻)
115
- - ADR-H5 / PLAN-H5 / review-contract.yaml diff
116
- - INV-H5-3 验证命令实际执行结果
117
-
118
- **期望输出**(`docs/decisions/tasks/PLAN-H5/WP-04/dogfood-output-<ts>.md` ≤80 行):
119
-
120
- ```markdown
121
- ---
122
- plan: PLAN-H5
123
- wp: WP-04
124
- trigger: ADR-H5 §10 dogfood 规划
125
- date: <ts>
126
- status: self-check-result
127
- ---
128
-
129
- # H5 自指自检结果
130
-
131
- ## INV-H5-1(行数 schema 化)
132
- - review-contract.yaml line_caps 字段是否包含本 ADR-H5 + PLAN-H5 的 cap?
133
- - 实测:[verify by grep + diff]
134
-
135
- ## INV-H5-2(执检分离 binding 化)
136
- - WP-05 verdict 文件路径是否匹配 evidence_path_pattern?
137
- - 实测:[verify by ls]
138
-
139
- ## INV-H5-3(零机制实际引入)
140
- - find newer .py files = 0?
141
- - git diff hook stat = empty?
142
- - yaml diff cron/schedule fields = 0?
143
- - 反例段排除后正文动词搭配 = 0?
144
- - 实测:[四项 grep + find 命令实际执行结果]
145
-
146
- ## 自指悖论修正
147
- - 本 dogfood 文档自身受 INV-H5 约束吗?
148
- - 评估:[是/否 + 理由]
149
- ```
150
-
151
- **DoD**:
152
- - 文件存在 ≤80 行
153
- - 4 项 INV-H5-3 检测命令实际执行(不是 placeholder)
154
- - 自指悖论评估段非空
155
-
156
- ### WP-05 reviewer signoff(独立 subagent)
157
-
158
- **目标**:spawn `pr-review-toolkit:code-reviewer` 独立 subagent(read-only directive),独立于本 session 起草人验收。
159
-
160
- **verdict 文件路径**:`docs/decisions/tasks/PLAN-H5/WP-05/reviewer-verdict-<ts>.md`
161
-
162
- **reviewer 验证 14 维度**(与 H1 WP-05 一致结构 + H5 特化项):
163
-
164
- | # | 维度 | 验证命令 |
165
- |---|------|----------|
166
- | 1 | ADR-H5 ≤300 | `wc -l docs/decisions/ADR-H5-gate-quantization.md` |
167
- | 2 | PLAN-H5 ≤500 | `wc -l docs/decisions/PLAN-H5-gate-quantization.md` |
168
- | 3 | review-contract.yaml ≤220 | `wc -l .claude/plugins/boll-review-toolkit/contracts/review-contract.yaml` |
169
- | 4 | INV-H5-1 line_caps ≥4 项 | `python3 -c "import yaml; print(len(yaml.safe_load(open(...))['line_caps']))"` |
170
- | 5 | INV-H5-2 binding 字段存在 | `python3 -c "...['bindings'][1]['drafter_reviewer_separation']"` |
171
- | 6 | INV-H5-3 检测 1: find newer .py | `find docs/decisions/tasks/PLAN-H5 .claude/plugins/boll-review-toolkit -newer ADR-H0 -name "*.py" \| wc -l` = 0 |
172
- | 7 | INV-H5-3 检测 2: hook diff | `git diff HEAD~5..HEAD --stat -- 'scripts/hooks/h5*' '.claude/plugins/*/hooks/h5*' \| wc -l` = 0 |
173
- | 8 | INV-H5-3 检测 3: yaml field | `grep -cE "^\s*(cron\|schedule\|polling_interval\|auto_spawn_reviewer):" review-contract.yaml` = 0 |
174
- | 9 | INV-H5-3 检测 4: awk 排除反例段后动词搭配 | `awk -v RS='## §' 'NR!=4 && NR!=8' ADR-H5 \| grep -cE "(创建\|启动\|调度).*(metrics\|dashboard\|hook)"` = 0 |
175
- | 10 | yaml 语法合法 | `python3 -c "import yaml; yaml.safe_load(open(...))"` 无异常 |
176
- | 11 | yaml 4 active binding 未破坏 | grep `active: true` count ≥4 |
177
- | 12 | 跳 Gate 决策表 ≥5 行 | grep ADR-H5 §4 表 row count |
178
- | 13 | inflation 规则 ≥3 | grep ADR-H5 §5 规则 count |
179
- | 14 | H0.meta H[6-8] grep(排除 code block) | `awk '/^\`\`\`/{f=!f;next} !f' ADR-H5 \| grep -cE "\bH[6-8]\b"` = 0 |
180
-
181
- **DoD**:14 维度全 PASS;零 P0 / 零 P1;P2/P3 转 issue 不阻塞 H5 闭合。
182
-
183
- ## §3 跨 H 冲突协调
184
-
185
- 按 H 系列 plan §3.4 冲突表:
186
-
187
- | 文件 | H5 × 哪个 H | 处置 |
188
- |------|------------|------|
189
- | review-contract.yaml | H5 唯一 | 无冲突 |
190
- | ADR-H0 §H0.2 行数限额 | H5 仅 ref,不改 | 无冲突 |
191
- | 历史 reviewer-verdict 文件 | H1/2/3/4 已存在 | INV-H5-2 仅约束未来;不迁移历史 |
192
- | `verify-gate.py` | H5 不改 | 无冲突;如未来要消费 line_caps 字段,单独 ADR |
193
-
194
- **§4.9 cross-plan-class race 防御**:起草本 PLAN 期间检查 `git status` 无 merge state;commit 前再核一次。
195
-
196
- ## §4 race-safe commit 计划
197
-
198
- | commit | 内容 | 命令 |
199
- |--------|------|------|
200
- | 1 | ADR-H5 + PLAN-H5 起草 + WP-04 dogfood 输出 | `git add docs/decisions/ADR-H5-gate-quantization.md docs/decisions/PLAN-H5-gate-quantization.md docs/decisions/tasks/PLAN-H5/WP-04/*.md && git commit --only <those paths>` |
201
- | 2 | review-contract.yaml schema 修改 | `git commit --only .claude/plugins/boll-review-toolkit/contracts/review-contract.yaml` |
202
- | 3 | WP-05 reviewer signoff verdict | `git add <verdict>.md && git commit --only <verdict>.md` |
203
-
204
- **与 §4.9 教训对齐**:每个 commit 前 `git status` 核 merge state;如撞他 session merge,按 §4.9 处置(restore --staged + 推迟)。
205
-
206
- ## §5 H0 自检(条款逐项)
207
-
208
- | 条款 | 状态 |
209
- |------|------|
210
- | H0.1 施工隔离 | ✅ scope 明确(review-contract.yaml + 本 H 文档;禁动 hook/SKILL.md/MEMORY.md) |
211
- | H0.2 行数限额 | 待 wc -l 终稿验证(estimated 250-300) |
212
- | H0.3 执检分离 | ✅ WP-05 独立 subagent + verdict 文件 |
213
- | H0.4 自指禁止 | ✅ INV-H5-3 修正 INV-H1-3 朴素 grep;不重现"自指 false positive" 症状 |
214
- | H0.5 跨 H 协调 | ✅ §3 冲突表(H5 唯一改 review-contract.yaml) |
215
- | H0.6 证据机械化 | ✅ §2 WP-05 14 维度全部给出 grep/wc/python3 命令 |
216
- | H0.meta | ✅ awk 排除 code block 后 grep H[6-8] = 0 |
217
-
218
- ## §6 与现行 vNext 共存(H 系列 plan §3.3.3)
219
-
220
- - review-contract.yaml 修改前 4 active binding 状态实测:`grep -c "active: true" review-contract.yaml` = 4
221
- - 修改后跑 mock evidence packet 通过 verify-gate.py(如条件允许;否则 §4 commit 2 后第一次实际 mode transition 即验证)
222
- - 如发现 verify-gate.py 因新字段崩溃 → §4 commit 2 revert + 字段位置重新设计
223
-
224
- ## §7 参考链接
225
-
226
- - ADR-H0 §H0.1-H0.6: docs/decisions/ADR-H0-meta-charter.md
227
- - ADR-H4 INV-H4-3 反例表: docs/decisions/ADR-H4-prompt-governance.md §3
228
- - review-contract schema 文档: .claude/plugins/boll-review-toolkit/contracts/review-contract.yaml header comment
229
- - evidence-packet schema: .claude/plugins/boll-review-toolkit/contracts/evidence-packet-schema.json
230
- - ADR-038 D11.2 schema-level vs prompt-level: docs/decisions/ADR-038-harness-rebase.md
231
- - H1 WP-05 verdict 模板(结构参考): docs/decisions/tasks/PLAN-H1/WP-05/reviewer-verdict-20260428-183611.md
232
-
233
- ## §8 进度
234
-
235
- - [x] WP-01 现状盘点(2026-04-28T18:55)
236
- - [x] WP-02 起草 ADR-H5 + PLAN-H5(2026-04-28T19:00)
237
- - [ ] WP-03 修改 review-contract.yaml ← 当前
238
- - [ ] WP-04 dogfood
239
- - [ ] WP-05 reviewer signoff
@@ -1,325 +0,0 @@
1
- ---
2
- plan: PLAN-H6
3
- adr_ref: ADR-H6-state-file-health.md
4
- status: in-progress
5
- date: 2026-04-28
6
- parent_plan: H 系列 plan §3.3(H6 行)
7
- philosophy_inheritance:
8
- - ADR-041 v1.0
9
- - ADR-H0 §H0.1-H0.6 + H0.meta
10
- - ADR-H4 INV-H4-3 反例表
11
- - ADR-H5 INV-H5-3 实际引入检测 + awk 排除 code block 模板
12
- - ADR-038 D11.2 schema-level 100%
13
- applies_scope:
14
- - .claude/plugins/boll-review-toolkit/contracts/review-contract.yaml
15
- - .boll/state/_archived/(新建)
16
- - .gitignore(加 1 行)
17
- - .boll/state/.DS_Store(删除)
18
- - .boll/state/completion-proposal-profile-build-cli-archived-*.json(移动)
19
- - .boll/state/harness-review-2026-04-14/(移动)
20
- - docs/decisions/ADR-H6-state-file-health.md
21
- - docs/decisions/PLAN-H6-state-file-health.md
22
- - docs/decisions/tasks/PLAN-H6/**
23
- not_in_scope:
24
- - 任何 hook / py 文件(INV-H6-3)
25
- - .boll/state/round{1-5}-verdicts/(审计原地保留)
26
- - .boll/proposals/ / .boll/guard/ / .boll/inbox/ / .boll/evidence/
27
- - verify-gate.py / transition.py / owner-guard.py(仅引用)
28
- ---
29
-
30
- # PLAN-H6:状态文件健康度工程计划
31
-
32
- ## §1 上下文与基线锁定
33
-
34
- ### 1.1 工程目标
35
-
36
- ADR-H6 3 条 INV 的物理落地:
37
- - INV-H6-1:review-contract.yaml 增 `state_inventory` 顶层字段(≥10 项)
38
- - INV-H6-2:review-contract.yaml 增 `state_health_indicators` 顶层字段(≥3 条)
39
- - INV-H6-3:零机制实际引入(继承 INV-H5-3 修正版 4 项检测)
40
-
41
- 同时执行 3 stale 清理(.DS_Store 删 + 2 archived 移 _archived/),并签字接受 ADR-042 D3/D4/D9 抗 compact 协议作为真相源。
42
-
43
- ### 1.2 基线锁定(带行数 + 时间戳)
44
-
45
- | # | 资产 | 起草前实测 | 限额 | 时间戳 |
46
- |---|------|------------|------|--------|
47
- | 1 | `.claude/plugins/boll-review-toolkit/contracts/review-contract.yaml` | 171 行(H5 后) | ≤270(H6 后目标) | HEAD = `872f03ce` (PLAN-H5 WP-03) |
48
- | 2 | `docs/decisions/ADR-H6-state-file-health.md` | 205 行(已起草) | ≤300 | 本 PLAN commit 同步 |
49
- | 3 | `docs/decisions/PLAN-H6-state-file-health.md` | 本文件 | ≤500 | 同上 |
50
- | 4 | `.boll/state/.DS_Store` | 6148 字节 / Apr 16 | 删除 | git status 验证 |
51
- | 5 | `.boll/state/completion-proposal-profile-build-cli-archived-20260419-1110.json` | 4737 字节 / Apr 19 | 移到 `_archived/` | `git mv` |
52
- | 6 | `.boll/state/harness-review-2026-04-14/` | 目录 / Apr 14 | 移到 `_archived/` | `git mv` |
53
- | 7 | `.gitignore` | 加 1 行 `.boll/state/.DS_Store` | 行数变化 +1 | — |
54
- | 8 | state_inventory 项数 | 0(未引入) | ≥10 | yaml.safe_load |
55
- | 9 | state_health_indicators 项数 | 0(未引入) | ≥3 | yaml.safe_load |
56
- | 10 | reviewer-verdict 历史路径 | H1 在 WP-05/,H5 在 WP-05/ | INV-H5-2 已锁 WP-05/ | 4 文件已存在 |
57
-
58
- ### 1.3 已知 race risk
59
-
60
- - `.boll/state/risk-snapshot.json` 实测 mtime 当下(被 risk-tracker 实时维护)—— **不动** ;H6 不修改任何动态 state 文件
61
- - 其他 session 可能持续写 `.boll/proposals/` —— H6 不动该目录
62
- - `git mv` 文件期间如撞他 session merge state,按 §4.9 教训:`git restore --staged` + 推迟
63
-
64
- ## §2 WP 拆解(5 WP)
65
-
66
- ### WP-01 现状盘点(已完成 in 2026-04-28T19:12)
67
-
68
- DoD:基线表 §1.2 10 行齐全;§1.3 race risk 列出;ADR-042 D3/D4/D9 引用确认;3 stale 候选实测时间戳。
69
- 实测:✅ 已完成(本 PLAN §1.2/§1.3 + ADR-H6 §1.1 即证据)
70
-
71
- ### WP-02 起草 ADR-H6 + PLAN-H6(已完成)
72
-
73
- DoD:ADR-H6 ≤300 + PLAN-H6 ≤500 + INV ≥3 + state 清单 ≥10(在 ADR §1.1 表)+ 健康度指标 ≥3(在 ADR §3 INV-H6-2)+ stale 决策表 ≥3(在 ADR §4)+ 抗 compact 接口签字 ≥1(在 ADR §6)。
74
- 实测:✅ ADR-H6 205/300 + state 资产 15+ 项 + 健康度 3 条 + stale 3 条 + 抗 compact 签字 5 条
75
-
76
- ### WP-03 review-contract.yaml schema + 3 stale 物理清理(待执行)
77
-
78
- #### 3a:review-contract.yaml 增 2 处顶层字段
79
-
80
- 紧跟 H5 `inflation` 字段之后,在 `bindings:` 之前插入:
81
-
82
- ```yaml
83
- # ── ADR-H6 §3 INV-H6-1: state 清单 schema 化 ──
84
- # 把 .boll/state + .boll/proposals + .boll/guard + .boll/log + .boll/inbox + .boll/evidence
85
- # 等 state 资产收口为顶层清单。kind: dynamic / archived / append-only / managed-by-other-h
86
- state_inventory:
87
- - id: state-mode
88
- path: ".boll/state/mode"
89
- kind: dynamic
90
- owner: boll-mode-toolkit
91
- - id: state-run
92
- path: ".boll/state/run.json"
93
- kind: dynamic
94
- owner: boll-mode-toolkit
95
- - id: state-locks
96
- path: ".boll/state/locks.json"
97
- kind: dynamic
98
- owner: boll-mode-toolkit
99
- - id: state-completion-proposal
100
- path: ".boll/state/completion-proposal.json"
101
- kind: dynamic
102
- owner: boll-review-toolkit
103
- - id: state-risk-snapshot
104
- path: ".boll/state/risk-snapshot.json"
105
- kind: dynamic
106
- owner: risk-tracker
107
- - id: state-round-verdicts
108
- path: ".boll/state/round{1-5}-verdicts/"
109
- kind: archived
110
- owner: harness-review-history
111
- - id: state-archived-dir
112
- path: ".boll/state/_archived/"
113
- kind: archived
114
- owner: ADR-H6
115
- - id: proposals-self-evolution
116
- path: ".boll/proposals/"
117
- kind: append-only
118
- owner: vNext-self-evolution
119
- note: "265 文件; 只增不删"
120
- - id: guard-loop-counter
121
- path: ".boll/guard/"
122
- kind: append-only
123
- owner: harness-guard
124
- note: "11321 文件; #4 认知修正; 活工具态非污染"
125
- - id: log-self-symptoms
126
- path: ".boll/log/harness-self-symptoms.md"
127
- kind: append-only
128
- owner: H 系列
129
- - id: log-hook-ledger
130
- path: ".boll/log/hook/"
131
- kind: append-only
132
- owner: 各 hook
133
- - id: inbox-mailbox
134
- path: ".boll/inbox/"
135
- kind: managed-by-other-h
136
- owner: ADR-H9
137
- note: "main/quarantine/schema/window-h{0-6,8,9}"
138
- - id: evidence-packets
139
- path: ".boll/evidence/"
140
- kind: managed-by-other-h
141
- owner: 各 PLAN
142
-
143
- # ── ADR-H6 §3 INV-H6-2: state 健康度指标 schema 化 ──
144
- state_health_indicators:
145
- - id: schema-validity
146
- desc: "5 个 dynamic JSON 文件 JSON parse 通过 + 必填字段非空"
147
- check: "python3 -c 'import json; [json.load(open(p)) for p in [\".boll/state/run.json\", \".boll/state/locks.json\", \".boll/state/completion-proposal.json\", \".boll/state/risk-snapshot.json\"]]'"
148
- - id: top-level-no-noise
149
- desc: ".boll/state/ 顶层无 .DS_Store / 未归档 archived 文件 / 临时文件"
150
- check: "ls .boll/state/.DS_Store .boll/state/*archived*.json 2>/dev/null | wc -l"
151
- expect: 0
152
- - id: inbox-unread-volume
153
- desc: ".boll/inbox/main/unread/ ≤50 文件(H9 ADR 红线复用)"
154
- check: "ls .boll/inbox/main/unread/ 2>/dev/null | wc -l"
155
- expect_max: 50
156
- ```
157
-
158
- DoD:
159
- - yaml diff 仅新增上述 2 处顶层字段(不删任何已有字段;4 active binding + H5 三字段不动)
160
- - yaml 总行数 ≤270
161
- - `python3 -c "import yaml; doc = yaml.safe_load(open(...)); assert len(doc['state_inventory']) >= 10; assert len(doc['state_health_indicators']) >= 3"` 通过
162
- - `grep -c "active: true"` = 4
163
-
164
- #### 3b:3 stale 物理清理
165
-
166
- ```bash
167
- # 1. 创建 _archived/
168
- mkdir -p .boll/state/_archived
169
-
170
- # 2. 移动 archived JSON
171
- git mv .boll/state/completion-proposal-profile-build-cli-archived-20260419-1110.json \
172
- .boll/state/_archived/completion-proposal-profile-build-cli-archived-20260419-1110.json
173
-
174
- # 3. 移动 14 天前 review 目录
175
- git mv .boll/state/harness-review-2026-04-14 \
176
- .boll/state/_archived/harness-review-2026-04-14
177
-
178
- # 4. 删除 .DS_Store
179
- git rm --cached .boll/state/.DS_Store 2>/dev/null || rm -f .boll/state/.DS_Store
180
-
181
- # 5. .gitignore 增 1 行
182
- echo ".boll/state/.DS_Store" >> .gitignore # 实际用 Edit 工具不用 echo
183
- ```
184
-
185
- DoD:
186
- - `ls .boll/state/.DS_Store` = 不存在
187
- - `ls .boll/state/_archived/` 含 2 项
188
- - `grep ".boll/state/.DS_Store" .gitignore` ≥1
189
- - `ls .boll/state/*archived*.json` 顶层 = 0
190
- - 健康度指标 `top-level-no-noise` check = 0
191
-
192
- **race-safe commit**:3a 和 3b 分两个 commit,避免 yaml schema + 文件移动混在同一 commit;commit 用 `git commit --only <paths>` 隔离他 session。
193
-
194
- ### WP-04 dogfood — H6 自指自检
195
-
196
- 期望输出(`docs/decisions/tasks/PLAN-H6/WP-04/dogfood-output-<ts>.md` ≤80 行):
197
-
198
- ```markdown
199
- ---
200
- plan: PLAN-H6
201
- wp: WP-04
202
- trigger: ADR-H6 §10 dogfood 规划
203
- date: <ts>
204
- status: self-check-result
205
- ---
206
-
207
- # H6 自指自检结果
208
-
209
- ## §1 INV-H6-1(state 清单 schema 化)
210
- - review-contract.yaml state_inventory 项数实测
211
- - 起草 H6 过程是否触犯 line_caps(ADR-H6 ≤300 + PLAN-H6 ≤500 + yaml ≤270)
212
-
213
- ## §2 INV-H6-2(健康度指标)
214
- - 3 条指标 schema 字段实测 yaml.safe_load
215
- - 每条 indicator 的 check 命令实际执行结果
216
-
217
- ## §3 INV-H6-3(零机制实际引入 4 项检测,复用 H5)
218
- - find newer .py = 0
219
- - hook diff = empty
220
- - yaml mechanism field = 0
221
- - 反例段排除后动词搭配 = 0
222
-
223
- ## §4 stale 清理执行结果
224
- - .DS_Store 删除 ✓/✗
225
- - archived JSON 移动 ✓/✗
226
- - harness-review-2026-04-14 移动 ✓/✗
227
-
228
- ## §5 抗 compact 接口签字(plan §3.3 H6 DoD)
229
- - ADR-042 D3 / D4 / D9 引用确认
230
- - 不重做、不另建(红线)
231
-
232
- ## §6 自指悖论(继承 H5 §4)
233
- - 本 dogfood 文档自身受 INV-H6-1 约束(≤80 行)
234
- - 不引入新机制(纯 markdown)
235
- ```
236
-
237
- DoD:
238
- - 文件存在 ≤80 行
239
- - INV-H6-3 4 项检测命令实际执行(不是 placeholder)
240
- - 抗 compact 签字段非空
241
-
242
- ### WP-05 reviewer signoff(独立 subagent)
243
-
244
- verdict 路径(INV-H5-2 evidence_path_pattern 满足):
245
- `docs/decisions/tasks/PLAN-H6/WP-05/reviewer-verdict-<ts>.md`
246
-
247
- reviewer 验证 14 维度(结构同 H5 WP-05,特化项见下表):
248
-
249
- | # | 维度 | 验证命令 |
250
- |---|------|----------|
251
- | 1 | ADR-H6 ≤300 | `wc -l docs/decisions/ADR-H6-state-file-health.md` |
252
- | 2 | PLAN-H6 ≤500 | `wc -l docs/decisions/PLAN-H6-state-file-health.md` |
253
- | 3 | review-contract.yaml ≤270 | `wc -l ...review-contract.yaml` |
254
- | 4 | INV-H6-1 state_inventory ≥10 | `python3 -c "import yaml; print(len(yaml.safe_load(open(...))['state_inventory']))"` |
255
- | 5 | INV-H6-2 state_health_indicators ≥3 | 同 yaml.safe_load 路径 |
256
- | 6 | INV-H6-3 检测 1: find newer .py | `find ... -name "*.py" \| wc -l` = 0 |
257
- | 7 | INV-H6-3 检测 2: hook diff | `git diff --stat -- 'scripts/hooks/h6*' '.claude/plugins/*/hooks/h6*' \| wc -l` = 0 |
258
- | 8 | INV-H6-3 检测 3: yaml field | `grep -cE "^\s*(cron\|schedule\|polling_interval\|auto_*):" review-contract.yaml` = 0 |
259
- | 9 | INV-H6-3 检测 4: 反例段排除后动词搭配 | awk 排除 §3/§7/§9 后 grep | = 0 |
260
- | 10 | yaml 语法合法 | `python3 -c "import yaml; yaml.safe_load(open(...))"` |
261
- | 11 | 4 active binding + H5 三字段未破坏 | `grep -c "active: true"` = 4 + line_caps/inflation/drafter_reviewer_separation 仍存在 |
262
- | 12 | stale 清理实测 | `ls .boll/state/.DS_Store .boll/state/*archived*.json 2>/dev/null \| wc -l` = 0 + `ls .boll/state/_archived/ \| wc -l` ≥ 2 |
263
- | 13 | .gitignore 含 .DS_Store 规则 | `grep "\.boll/state/\.DS_Store" .gitignore` ≥1 |
264
- | 14 | H0.meta H{7,10,11,12} 排除 code block | `awk '/^\`\`\`/{f=!f;next} !f' \| grep -cE "\bH(7\|10\|11\|12)\b"` = 0 |
265
-
266
- DoD:14 维度全 PASS;零 P0/P1/P2;P3 不阻塞。
267
-
268
- ## §3 跨 H 冲突协调
269
-
270
- | 文件 | H6 × 哪个 H | 处置 |
271
- |------|------------|------|
272
- | review-contract.yaml | H6 ↔ H5(已落地)↔ 未来 H8 | H5 三字段不动;H6 加 2 字段;H8 如要加字段需要在 H8 PLAN 显式锁字段名 |
273
- | `.boll/inbox/` | H6 仅 reference 不动 | H9 受管 |
274
- | `.boll/proposals/` | H6 仅 reference | self-evolution 只增不删 |
275
- | `.boll/guard/` | H6 仅 reference | 活工具态 |
276
- | ADR-042 D3/D4/D9 | H6 仅签字接受 | ADR-042 受管 |
277
-
278
- `§4.9 cross-plan-class race` 防御:起草本 PLAN 期间检查 `git status` 无 merge state;commit 前再核。
279
-
280
- ## §4 race-safe commit 计划
281
-
282
- | commit | 内容 | 命令 |
283
- |--------|------|------|
284
- | 1 | ADR-H6 + PLAN-H6 起草 + WP-04 dogfood | `git add ADR-H6 PLAN-H6 WP-04/dogfood && git commit --only <paths>` |
285
- | 2 | review-contract.yaml schema 修改 | `git commit --only .claude/plugins/boll-review-toolkit/contracts/review-contract.yaml` |
286
- | 3 | 3 stale 物理清理(git mv + git rm + .gitignore) | `git mv ... && git rm ... && git commit --only <文件 + .gitignore>` |
287
- | 4 | WP-05 reviewer signoff verdict | `git add <verdict>.md && git commit --only <verdict>.md` |
288
-
289
- H6 是 4 commit 链(H1/H4/H5 是 3 commit;H6 因 stale 清理多 1 commit)。每 commit 前 `git status` 核 merge state。
290
-
291
- ## §5 H0 自检(条款逐项)
292
-
293
- | 条款 | 状态 |
294
- |------|------|
295
- | H0.1 施工隔离 | ✅ scope 明确(review-contract.yaml + .boll/state/_archived/ + 3 stale + .gitignore;禁动 hook/proposals/guard/inbox/evidence/round-verdicts) |
296
- | H0.2 行数限额 | 待 wc -l 终稿验证(estimated 230-260 ADR / 290-330 PLAN) |
297
- | H0.3 执检分离 | ✅ WP-05 独立 subagent + verdict 文件 |
298
- | H0.4 自指禁止 | ✅ INV-H6-3 直接复用 H5 修正版(不重新发明,避免 INV-H1-3 朴素 grep 自指 false positive 复现) |
299
- | H0.5 跨 H 协调 | ✅ §3 冲突表(review-contract.yaml H5+H6;不撞 H8) |
300
- | H0.6 证据机械化 | ✅ §2 WP-03/04/05 全部给 grep/wc/python3/find 命令 |
301
- | H0.meta | ✅ awk 排除 code block 后扫描已退役/未来 H 引用 = 0(详见 §5 验证命令;裸字面 token 全部装入 code fence 避免自指) |
302
-
303
- ## §6 与现行 vNext 共存(H 系列 plan §3.3.3)
304
-
305
- - review-contract.yaml 修改前后跑 yaml.safe_load 验证
306
- - `.boll/state/_archived/` 新建对 verify-gate.py / transition.py / capability-router.py 透明(仅清理顶层噪声,不动 dynamic state 文件位置)
307
- - 3 stale 移动用 `git mv` 保留历史;只 .DS_Store 用 `git rm`(macOS 噪声无价值)
308
- - 如某 stale 移动后 verify-gate.py 找不到文件 → 立即 `git mv` 还原 + ADR-H6 补丁
309
-
310
- ## §7 参考链接
311
-
312
- - ADR-H0 §H0.1-H0.6: docs/decisions/ADR-H0-meta-charter.md
313
- - ADR-H4 INV-H4-3 反例表: docs/decisions/ADR-H4-prompt-governance.md
314
- - ADR-H5 INV-H5-3 修正版: docs/decisions/ADR-H5-gate-quantization.md §3
315
- - review-contract.yaml H5 三字段: commit 872f03ce
316
- - ADR-042 D3 / D4 / D9: docs/decisions/ADR-042-parallel-dev-state-management.md
317
- - H5 WP-05 verdict 模板: docs/decisions/tasks/PLAN-H5/WP-05/reviewer-verdict-20260428-185114.md
318
-
319
- ## §8 进度
320
-
321
- - [x] WP-01 现状盘点(2026-04-28T19:12)
322
- - [x] WP-02 起草 ADR-H6 + PLAN-H6
323
- - [ ] WP-03 review-contract.yaml schema + stale 清理(拆 2 commit) ← 当前
324
- - [ ] WP-04 dogfood
325
- - [ ] WP-05 reviewer signoff