@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,228 +0,0 @@
1
- # PLAN-H3: Memory Scope 分段实施计划
2
-
3
- **状态**:Draft(待 reviewer 复核)
4
- **日期**:2026-04-28
5
- **关联**:ADR-H3 / ADR-H0 §3 元规约 / ADR-H9 §6.5 边界
6
-
7
- ## 1. 工程范围
8
-
9
- ADR-H3 §1-§3 决策的工程展开:5 个 WP,串行(WP-01 → WP-05)。本 PLAN 不引入并行 WP(H3 总估时 3 天,单 session 串行更稳)。
10
-
11
- **入口资产清单**(来自 ADR-H3 §3.6 受管资产 + Gate 0 实地盘点):
12
-
13
- | 资产类 | 文件路径 | 状态 |
14
- |--------|----------|------|
15
- | ADR | `docs/decisions/ADR-H3-memory-scope.md` | 已新增(前置 commit) |
16
- | PLAN | 本文件 | 起草中 |
17
- | user-level memory 主索引 | `~/.claude/projects/-Users-nature------boll/memory/MEMORY.md` | 待重组(276 → ≤200) |
18
- | user-level memory backup | `~/.claude/projects/-Users-nature------boll/memory/_backup/MEMORY-pre-H3-{ts}.md` | 待新增 |
19
- | user-level memory index | `~/.claude/projects/-Users-nature------boll/memory/feedback_index.md` | 待新增(feedback_*.md 目录索引) |
20
- | symptoms log | `.boll/log/harness-self-symptoms.md` | 待 append(如有) |
21
- | reviewer 落点 | `docs/decisions/tasks/PLAN-H3/reviewer-verdict-{ts}.md` | 待新增 |
22
-
23
- **不动**:ownership.yaml / SKILL.md / hook / inbox/proposals/state schema / 任何业务代码 / 224 个 topic-specific .md 文件(仅 MEMORY.md 主索引重组,其余文件 grep 引用)。
24
-
25
- ---
26
-
27
- ## 2. WP 拆解
28
-
29
- ### WP-01:MEMORY.md backup(H 系列灰度 §3.3.3 强制前置)
30
-
31
- **目标**:MEMORY.md 重组前先备份到 `_backup/MEMORY-pre-H3-{ts}.md`,7 天观察期内任何反弹可一键回滚。
32
-
33
- **操作**:
34
- ```bash
35
- TS=$(date +%Y%m%dT%H%M)
36
- mkdir -p ~/.claude/projects/-Users-nature------boll/memory/_backup
37
- cp ~/.claude/projects/-Users-nature------boll/memory/MEMORY.md \
38
- ~/.claude/projects/-Users-nature------boll/memory/_backup/MEMORY-pre-H3-${TS}.md
39
- ```
40
-
41
- **DoD**:
42
- - [ ] `_backup/MEMORY-pre-H3-*.md` 文件存在
43
- - [ ] backup 行数 = 当前 MEMORY.md 行数(diff 验证一字未改)
44
- - [ ] backup 文件 mtime ≥ 重组开始时刻
45
-
46
- **估时**:5 min
47
-
48
- **verify**:
49
- ```bash
50
- ls -la ~/.claude/projects/-Users-nature------boll/memory/_backup/MEMORY-pre-H3-*.md
51
- diff ~/.claude/projects/-Users-nature------boll/memory/MEMORY.md \
52
- ~/.claude/projects/-Users-nature------boll/memory/_backup/MEMORY-pre-H3-*.md # 此时应为空 diff
53
- ```
54
-
55
- ---
56
-
57
- ### WP-02:MEMORY.md 段长盘点 + 重组分组
58
-
59
- **目标**:grep 现状段头 + 段长 + 计算"超 50 行"段数,输出重组分组清单。
60
-
61
- **操作**:
62
- 1. 列所有 `## ` 段头 + 起始行号
63
- 2. 计算每段行数:相邻段头行号差
64
- 3. 标 `OVER_50` / `OK`
65
- 4. 按 ADR-H3 §3.2 重组规则把每个 `OVER_50` 段标"下沉到 X.md" / "拆分为 highlights + index"
66
-
67
- **DoD**:
68
- - [ ] 现状盘点文件落 `docs/decisions/tasks/PLAN-H3/wp02-current-segments.md`(grep 输出 + 段长统计)
69
- - [ ] 重组分组清单覆盖所有 `OVER_50` 段,每段标"动作"(下沉 / 拆分 / highlights+index / 不动)
70
- - [ ] 估算重组后行数 ≤ 200(meeting INV-H3-1)
71
-
72
- **估时**:30 min
73
-
74
- **verify**:
75
- ```bash
76
- test -f docs/decisions/tasks/PLAN-H3/wp02-current-segments.md
77
- grep -c "OVER_50" docs/decisions/tasks/PLAN-H3/wp02-current-segments.md # 期望 ≥ 1
78
- grep -c "动作:" docs/decisions/tasks/PLAN-H3/wp02-current-segments.md
79
- ```
80
-
81
- ---
82
-
83
- ### WP-03:5 条旧 memory highlights 挑选 + feedback_index.md 起草
84
-
85
- **目标**:从现有"硬性要求"段(~60 项)中挑出**最高频引用**的 5 条作为主索引 highlights,其余下沉到新 `feedback_index.md`(每条 1 行 pointer + 1 行描述)。
86
-
87
- **挑选规则**(ADR-H0.6 证据机械化):
88
- - 近 30 天 `git log --since=2026-03-29 -p` grep 命中频次最高的 5 条
89
- - 命中频次相同时,优先 Nature 显式升级过的(含 "第 N 次升级" / "Nature 拍" 字样)
90
- - 5 条 highlights 必须涵盖至少 3 个不同主题(不能 5 条全是 git 类)
91
-
92
- **feedback_index.md 起草**:
93
- ```
94
- # feedback_index.md — 完整教训目录索引
95
-
96
- > 主索引 MEMORY.md 仅留 5 条 highlights;本文件是完整 ~60 项的目录指针。
97
- > 每条 1 行 pointer + 1 行 hook,详细见各 topic-specific .md。
98
-
99
- ## 多 session / git race
100
- - [并行 git race—commit 后必核 git show --stat](feedback_parallel_session_git_race_post_commit_verify.md) — race 升级版
101
-
102
- ## 部署与上线
103
- - [生产 SSH 要白名单](feedback_prod_ssh_needs_allowlist.md) — verbal 不能穿透 sandbox
104
- ...
105
- ```
106
-
107
- **DoD**:
108
- - [ ] 5 条 highlights 挑选过程(grep 命令 + 命中数)落 `docs/decisions/tasks/PLAN-H3/wp03-highlights-selection.md`
109
- - [ ] 5 条覆盖至少 3 个不同主题
110
- - [ ] `feedback_index.md` 新增(user-level,路径 `~/.claude/projects/-Users-nature------boll/memory/feedback_index.md`)
111
- - [ ] feedback_index.md 行数 ≤ 100(防膨胀);包含至少 30 条 pointer(覆盖现状大部分 feedback)
112
-
113
- **估时**:1 h
114
-
115
- **verify**:
116
- ```bash
117
- test -f ~/.claude/projects/-Users-nature------boll/memory/feedback_index.md
118
- wc -l ~/.claude/projects/-Users-nature------boll/memory/feedback_index.md # ≤ 100
119
- grep -cE "^- \[" ~/.claude/projects/-Users-nature------boll/memory/feedback_index.md # ≥ 30 pointers
120
- test -f docs/decisions/tasks/PLAN-H3/wp03-highlights-selection.md
121
- ```
122
-
123
- ---
124
-
125
- ### WP-04:MEMORY.md 主索引重组实施
126
-
127
- **目标**:按 WP-02 分组 + WP-03 highlights,实际重写 MEMORY.md,落到 ≤200 行 + 单段 ≤50 行。
128
-
129
- **操作流程**:
130
- 1. 读 backup(防原文丢失)
131
- 2. 按 ADR-H3 §3.2 顶部固定(≤30 行):身份说明 + 近期重要真相源 pointer(最多 8 条)
132
- 3. 硬性要求段:5 条 highlights + 1 行 pointer 到 feedback_index.md
133
- 4. 项目状态段:每段 ≤30 行;超 30 行下沉到对应 `project_<name>_state.md`
134
- 5. 生产环境 / Discovery / Crystallization 等技术清单段:每段 ≤30 行
135
- 6. 删除现状所有"Pending Reminder"中**已触发条件满足**的条目
136
- 7. 末尾 grep `^## ` 计数 + 行数验证
137
-
138
- **DoD**:
139
- - [ ] MEMORY.md 行数 ≤ 200(INV-H3-1)
140
- - [ ] 单个 `## ` 段行数 ≤ 50(INV-H3-2,逐段 awk 验证)
141
- - [ ] MEMORY.md 不含"待协调员决定" / "TBD" / "进行中 WP" 字样(INV-H3-3 + H0.4 自指禁止;元层定义命中除外)
142
- - [ ] 顶部"近期重要真相源" pointer ≤ 8 条
143
- - [ ] "硬性要求"段 = 5 条 highlights + 1 行 feedback_index.md pointer
144
- - [ ] backup 仍存在(一键回滚保证)
145
-
146
- **估时**:1 h
147
-
148
- **verify**:
149
- ```bash
150
- M=~/.claude/projects/-Users-nature------boll/memory/MEMORY.md
151
- wc -l "$M" # ≤ 200
152
- awk '/^## /{if(prev){print NR-prev_line, prev}; prev=$0; prev_line=NR} END{print NR-prev_line+1, prev}' "$M" | sort -rn | head -5
153
- # 期望最长段 ≤ 50
154
- grep -cE "TBD|后续讨论|待协调员决定|进行中 WP" "$M"
155
- # 期望 0(INV-H3-3)
156
- ```
157
-
158
- ---
159
-
160
- ### WP-05:非起草 reviewer 复核(H0.3 执检分离)
161
-
162
- **目标**:spawn 一个非起草 reviewer subagent(read-only frontmatter 物理隔离),复核 ADR-H3 + PLAN-H3 + WP-01..04 实施物。
163
-
164
- **reviewer brief**(必含):
165
- - ADR-H3 / PLAN-H3 / ADR-H0 6+1 元规约 + INV-H3-1/2/3 验收清单
166
- - 严格只读:不得 Edit/Write/commit;仅 grep/wc/awk/test
167
- - 输出 PASS/FAIL + P0/P1/P2 finding 列表
168
-
169
- **reviewer agent picks**:`pr-review-toolkit:code-reviewer`(外部插件 reviewer,prompt-level read-only directive 兜底;H2 已用,工作良好)
170
-
171
- **DoD**:
172
- - [ ] reviewer 复核完成 + 输出落 `docs/decisions/tasks/PLAN-H3/reviewer-verdict-{ts}.md`
173
- - [ ] reviewer 裁决 PASS(如 FAIL 则按 P0/P1 修后再走一轮)
174
- - [ ] H0.3 执检分离证据:reviewer agent 不是 ADR-H3/PLAN-H3 起草者
175
-
176
- **估时**:30 min(含 reviewer 异步等待)
177
-
178
- **verify**:
179
- ```bash
180
- ls docs/decisions/tasks/PLAN-H3/reviewer-verdict-*.md 2>/dev/null | head -1
181
- grep -E "verdict: (PASS|FAIL)" docs/decisions/tasks/PLAN-H3/reviewer-verdict-*.md
182
- ```
183
-
184
- ---
185
-
186
- ## 3. WP 顺序 + 总估时
187
-
188
- ```
189
- WP-01 backup → WP-02 盘点 → WP-03 highlights+index → WP-04 重组 → WP-05 reviewer
190
- 5 min 30 min 1 h 1 h 30 min
191
- ```
192
-
193
- **串行 + 单 session**。预计总耗时 ~3 h(含 reviewer 异步等待)。如某 WP 超期 50% 触发"H 系列自指症状"记录(H 系列 plan §3.5 节奏控制)。
194
-
195
- ---
196
-
197
- ## 4. 跨 H 协调(H0.5)
198
-
199
- | 触点 | 冲突类型 | H3 处置 |
200
- |------|---------|---------|
201
- | MEMORY.md schema 结构 | 后续子计划同改风险 | H3 收口后 schema 定锚,后续子计划在新结构下写入条目(不重新分段) |
202
- | `~/.claude/projects/.../memory/` 整目录 | user-level shared resource | 任何 H 子计划改 user-level memory 结构需先核 H3 是否收口 |
203
- | ADR-042 D6 心跳契约 | memory vs inbox 边界声明 | H3 §3.5 已显式声明:memory ≠ 心跳通道;不动 ADR-042 D6 文本 |
204
- | ADR-H9 §6.5 inbox/proposals 边界 | 三态完整图 | H3 §3.4 在 ADR-H9 基础上扩展为三态完整图;不动 ADR-H9 文本 |
205
-
206
- ---
207
-
208
- ## 5. ADR-H0 元规约自检
209
-
210
- - **H0.1 施工隔离**:本 PLAN 操作路径全在 ADR-H3 §3.6 列出范围
211
- - **H0.2 节流限速**:本 PLAN 目标 ≤ 500 行
212
- - **H0.3 执检分离**:WP-05 reviewer 必为非起草 read-only subagent
213
- - **H0.4 自指禁止**:H3 修"memory 噪声",本 PLAN grep `TBD|后续讨论|待协调员决定` 仅元层定义命中(参 ADR-H0 §6 例 4)
214
- - **H0.5 跨 H 协调**:见 §4
215
- - **H0.6 证据机械化**:每个 WP 都给出 grep / wc / awk / test 命令
216
-
217
- ---
218
-
219
- ## 6. 反对意见
220
-
221
- 无新反对(ADR-H3 §4 已答辩 3 类反对,本 PLAN 不引入新决策点)。
222
-
223
- ---
224
-
225
- ## 7. 受影响外部相关
226
-
227
- - `~/.claude/projects/-Users-nature------boll/memory/MEMORY.md` 是 CC user-level memory 主入口,重组期间任何 session 启动会读到部分迁移状态——WP-01 backup 是回滚保证;WP-02 → WP-04 在同一 session 内连续完成(≤2 h 窗口),最小化跨 session 半态读取概率。
228
- - 224 个 topic-specific `.md` 文件不动(仅 grep 引用),feedback_index.md 是新增 pointer 索引。
@@ -1,227 +0,0 @@
1
- # PLAN-H4: Prompt 治理工程实施(lead/SKILL.md 三类清单落地)
2
-
3
- **状态**:Draft(待 ADR-H4 reviewer 签字后转 Active;H 系列拓扑 D 第 5 个 PLAN)
4
- **日期**:2026-04-28
5
- **估时**:3 天(继承 H 系列 plan §3.3 行)
6
- **关联**:ADR-H4-prompt-governance.md(决策真相源)/ ADR-H0 元规约 / ADR-041 v1.0 / `.claude/skills/lead/SKILL.md`
7
-
8
- ## 1. Context
9
-
10
- 本 PLAN 是 ADR-H4 决策的工程实施真相源(详细 WP / DoD / 验证命令)。ADR-H4 §3 已锁三类清单 + lead/SKILL.md 插入位置 + 哲学边界 + 失败模式;本 PLAN 把它们拆为可执行 WP。
11
-
12
- > **三层文档边界**(H 系列 plan §3.0):本 PLAN 写 WP 拆解 + DoD 机械化命令;不写决策辩证(在 ADR-H4 §1-§4);不写实施 LOG(在 `docs/decisions/tasks/PLAN-H4/WP-NN/LOG.md`)。
13
-
14
- ## 2. WP 拆解(5 WP 模式)
15
-
16
- ### WP-01: 现状盘点(precondition,避 §4.8 第 3 次复发)
17
-
18
- **目标**:施工前完成 4 项核(路径存在 + 行数 + frontmatter 字段 + 前置 ADR 已覆盖),杜绝起草未实证症状。
19
-
20
- **动作**:
21
- 1. `wc -l .claude/skills/lead/SKILL.md`(确认当前 169 行 + 加 ≤30 行预算 ≤200 行)
22
- 2. `grep -nE "^## |^### " .claude/skills/lead/SKILL.md`(确认 "Gate 7 开发日志硬性要求" 段在 line 152、"联动规则(skill 调度表)" 段在 line 158 — ADR-H4 §3.2 锚点)
23
- 3. `ls .claude/skills/lead/SKILL.md ~/.claude/projects/-Users-nature------boll/memory/feedback_no_jargon_with_nature.md ~/.claude/projects/-Users-nature------boll/memory/feedback_stop_asking_confirmation.md ~/.claude/projects/-Users-nature------boll/memory/feedback_review_driven_complexity_inflation.md`(确认 6 个 pointer 真相源全存在)
24
- 4. `grep -n "行为治理\|H4 三类\|黑话\|推卸\|过度 review" .claude/skills/lead/SKILL.md`(确认目标段位现尚无重叠规则;如有重叠 → WP-02 设计为 enhancement 而非 new section)
25
-
26
- **DoD**(机械化):
27
- - 4 项核命令全跑通 + 输出落 `docs/decisions/tasks/PLAN-H4/WP-01/baseline-evidence.md`
28
- - 任一项偏离 ADR-H4 §3.2/§3.5 假设 → 必须先回 ADR-H4 修订(避免 ADR/PLAN 漂移)
29
-
30
- **预估**:0.3d(半上午)
31
-
32
- ### WP-02: lead/SKILL.md 段起草(≤30 行 + 10 条 + 全 pointer)
33
-
34
- **目标**:把 ADR-H4 §3.1 三类清单 10 条物化为 lead/SKILL.md 内 ≤30 行 markdown 段。
35
-
36
- **动作**:
37
- 1. backup `cp .claude/skills/lead/SKILL.md .claude/skills/lead/SKILL.md.pre-h4-bak`(不入 git,仅本地保命)
38
- 2. 起草 `## 行为治理(H4 三类清单)` 段草稿到 `docs/decisions/tasks/PLAN-H4/WP-02/draft-section.md`(独立文件先验段长 + 内容审)
39
- 3. 段结构(严格 ≤30 行):
40
- ```
41
- ## 行为治理(H4 三类清单) # 1 行
42
- # 1 行空
43
- > 由 ADR-H4 物理化 6 条 memory ... # 2 行 blockquote
44
- # 1 行空
45
- ### 黑话 # 1 行
46
- - jargon 检测 → ...(pointer) # 1 行
47
- - task-arch 复写 → ...(pointer) # 1 行
48
- # 1 行空
49
- ### 推卸 # 1 行
50
- - 反问 → ...(pointer) # 1 行
51
- - 待协调员决定 → ...(pointer) # 1 行
52
- # 1 行空
53
- ### 过度 review # 1 行
54
- - inflation → ...(pointer) # 1 行
55
- - 同维度反复 → ...(pointer) # 1 行
56
- - 无证 PASS → ...(pointer) # 1 行
57
- # 1 行空
58
- ### 其他 # 1 行
59
- - 完工虚报 → ...(pointer) # 1 行
60
- - 起草未实证 → ...(pointer) # 1 行
61
- - 结论范围越界 → ...(pointer) # 1 行
62
- ```
63
- 合计 ≤25 行(裕量 5 行给 pointer 长度)
64
-
65
- **DoD**(机械化):
66
- - `wc -l docs/decisions/tasks/PLAN-H4/WP-02/draft-section.md` ≤ 30
67
- - `grep -c "feedback_.*\.md\|harness-self-symptoms.md" draft-section.md` ≥ 10(每条挂 pointer,INV-H4-2)
68
- - `grep -c "^- " draft-section.md` ≥ 10(INV-H4-1 厚度)
69
- - 段内零 hook / metrics / review-contract / spawn 关键词(INV-H4-3 哲学边界):`grep -iE "hook|metrics|review-contract|spawn" draft-section.md` 必须为零
70
-
71
- **预估**:0.5d(半天起草 + reviewer self-check)
72
-
73
- ### WP-03: Demo 改写示范("前 vs 后" 对照)
74
-
75
- **目标**:取 1 条历史违规实例(推卸 / 黑话 / 过度 review 任选),写"H4 前 → H4 后"对照,让未来 reviewer / Nature 验收时能秒判 H4 是否生效。
76
-
77
- **动作**:
78
- 1. 从 `.boll/log/harness-self-symptoms.md` §4.1-§4.9 中挑 1 条最具代表性的违规实例(建议 §4.1 plan §3.5 隔离策略违反 H0.4 自指禁止 — "推卸(待协调员决定)"代表)
79
- 2. 写到 `docs/decisions/tasks/PLAN-H4/WP-03/demo-rewrite-{ts}.md`:
80
- - **H4 前(违规)**:原文摘录(≤10 行 quote)
81
- - **触发的 checklist 条**:哪条 H4 规则本应触发
82
- - **H4 后(合规重写)**:改写示范(≤10 行)
83
- - **判定逻辑**:grep 哪个关键词命中 / 应改为哪个表达
84
- 3. demo 改写本身**不修改原文件**(避 §4.x 第 N 次复发:改 .boll/log 等于篡改 dogfood 数据流)—— 仅作示范
85
-
86
- **DoD**(机械化):
87
- - `wc -l docs/decisions/tasks/PLAN-H4/WP-03/demo-rewrite-*.md` ≤ 60(前+后+判定 ≤60 行总)
88
- - demo 文件 grep `^### H4 前\|^### H4 后` 各 ≥1 段
89
- - demo 引用的 self-symptoms 行号能 verify(`grep -n "$快照" .boll/log/harness-self-symptoms.md` 命中)
90
-
91
- **预估**:0.5d
92
-
93
- ### WP-04: lead/SKILL.md race-safe 嵌入
94
-
95
- **目标**:把 WP-02 草稿落到 `.claude/skills/lead/SKILL.md`,行数 + 段位 + 内容三验证 PASS。
96
-
97
- **动作**:
98
- 1. 嵌入前再核 `git status` 不在 merge state(如在 → defer 到 merge conclude,记 self-symptoms §4.x — §4.9 同模式可能复发)
99
- 2. `Edit` 工具在 lead/SKILL.md line 157("## 联动规则(skill 调度表)" 之前)插入 WP-02 段
100
- 3. 嵌入后立即 `wc -l .claude/skills/lead/SKILL.md` 验 ≤200 行(FM1 防御)
101
- 4. `grep -nE "^## |^### " .claude/skills/lead/SKILL.md` 验段顺序:Gate 7 段(line ≤157)→ 行为治理段(line 158-185 区段)→ 联动规则段(line ≥186)
102
- 5. race-safe commit:`git commit --only .claude/skills/lead/SKILL.md docs/decisions/ADR-H4-prompt-governance.md docs/decisions/PLAN-H4-prompt-governance.md docs/decisions/tasks/PLAN-H4/`(用 --only 隔离别 session 的 staged)
103
- 6. commit 后 `git show --stat HEAD` 后核:只含本 H4 scope 文件,不带别 plan 串味儿
104
-
105
- **DoD**(机械化):
106
- - `wc -l .claude/skills/lead/SKILL.md` ≤ 200(绝对硬规,FM1 防御)
107
- - `grep -c "## 行为治理(H4 三类清单)" .claude/skills/lead/SKILL.md` = 1
108
- - `grep -c "^- .*feedback_.*\.md\|^- .*harness-self-symptoms.md" .claude/skills/lead/SKILL.md` ≥ 10(嵌入后 INV-H4-1/2 仍成立)
109
- - `git show --stat HEAD` 文件清单严格匹配 §3.5 受管资产 scope(不多不少)
110
-
111
- **预估**:0.4d
112
-
113
- ### WP-05: Reviewer 签字(H0.3 执检分离)
114
-
115
- **目标**:spawn `pr-review-toolkit:code-reviewer` 或 `feature-dev:code-reviewer` subagent(read-only directive 兜底,schema-level frontmatter 隔离),签字判定 INV-H4-1/2/3 + ADR-H0 6+1 全 PASS。
116
-
117
- **动作**:
118
- 1. `Agent(subagent_type="pr-review-toolkit:code-reviewer", run_in_background=true)` spawn reviewer,prompt 含:
119
- - read-only directive("do not Edit/Write/Bash; verify only by Read/Grep/Glob")
120
- - 验证目标 commit 区间(H4 ADR + PLAN + lead SKILL.md + tasks/PLAN-H4/ 全部)
121
- - 14 维度核查清单(INV-H4-1/2/3 + ADR-H0 6+1 + ADR-H4 §3.6 FM 1/2/3 防御 + dogfood §4.x 是否新增)
122
- 2. reviewer 输出落 `docs/decisions/tasks/PLAN-H4/reviewer-verdict-{ts}.md`
123
- 3. verdict 三态:
124
- - **PASS**:所有 INV + 6+1 全过 → H4 closure
125
- - **PASS-WITH-NOTES**:≤ P1 不阻塞 → 同 session 内修补 → 二次 verdict(继承 H3 §4.8 处置经验)
126
- - **BLOCK**:任 P0 → 必须修补再过
127
-
128
- **DoD**(机械化):
129
- - verdict 文件存在 + 含 `verdict: PASS|PASS-WITH-NOTES|BLOCK` frontmatter
130
- - `grep -c "^## Findings\|^### P0\|^### P1" reviewer-verdict-*.md` ≥ 2 段(即使 PASS 也要列空 P0)
131
- - reviewer ≠ 起草 session(reviewer self-attest 段)
132
- - reviewer 自身 grep `\bH[1568]\b` 仅边界引用 + 自检命中(H0.meta 不引用未来产物)
133
-
134
- **预估**:0.3d
135
-
136
- ## 3. 验证矩阵(汇总 DoD)
137
-
138
- | 维度 | 验证命令 | 通过门槛 |
139
- |------|---------|---------|
140
- | INV-H4-1 厚度 | `grep -c "^- " .claude/skills/lead/SKILL.md` 在 H4 段范围 | ≥10 |
141
- | INV-H4-2 pointer | `grep -c "feedback_.*\.md\|harness-self-symptoms.md" lead/SKILL.md` 在 H4 段 | ≥10 |
142
- | INV-H4-3 哲学边界 | `grep -iE "hook\|metrics\|review-contract\|spawn" lead/SKILL.md` 在 H4 段 | =0 |
143
- | FM1 lead 行数 | `wc -l .claude/skills/lead/SKILL.md` | ≤200 |
144
- | FM2 inflation 防御 | reviewer verdict P0/P1 列表 | ≤1 P1(且 pointer 关)|
145
- | FM3 跨 SKILL 漂移 | `grep -l "## 行为治理(H4" .claude/skills/*/SKILL.md` | 仅 lead/SKILL.md 命中 |
146
- | H0.1 scope | `git show --stat HEAD` 文件清单 | 严格 ⊆ ADR-H4 §3.5 |
147
- | H0.2 节流 | `wc -l ADR-H4` / `wc -l PLAN-H4` | ≤300 / ≤500 |
148
- | H0.3 执检分离 | reviewer self-attest 段 | "我非起草人" |
149
- | H0.4 自指禁止 | `grep -E "TBD\|后续讨论\|待协调员决定" ADR-H4 PLAN-H4` | 仅元层定义命中 |
150
- | H0.5 跨子计划 | H 系列 plan §3.4 冲突表 | H4 行已登记 |
151
- | H0.6 证据机械化 | 本 §3 表 | 每行有命令 |
152
- | H0.meta 不引未来 | `grep "\bH[1568]\b" ADR-H4 PLAN-H4` | 仅边界 + 自检命中 |
153
- | Dogfood §4.x | `git diff .boll/log/harness-self-symptoms.md` | 同 session 内自指必登记 |
154
-
155
- ## 4. 失败回滚策略(继承 ADR-H4 §3.6 + plan §3.3.4)
156
-
157
- | 等级 | 触发 | 处置 |
158
- |------|------|------|
159
- | 轻 | WP-04 嵌入后 lead 行数 195-200(接近边界,未越线) | 段内删冗余条目至 ≤25 行;INV-H4-1 仍 ≥10 |
160
- | 中 | WP-04 嵌入后 lead 行数 >200(FM1 触发) | revert lead/SKILL.md 嵌入;H4 段必须先按 INV-H3-2 双层口径分拆为子文件,再二次嵌入 |
161
- | 重 | reviewer 给 P0 BLOCK,且根因是 ADR-H4 决策缺陷而非工程错误 | revert 全部 H4 commit;ADR-H4 修订 v1.1(同 H3 P1-1 处置模式);不阻塞 H 系列推进 — H4 进入 followup 待 v1.1 后重启 |
162
- | 最坏 | reviewer 给 P0 + 跨 H 副作用(破坏 H2/H3 已落地段) | 按 H 系列 plan §3.3.4 第 4 档 — 暂停 H 系列 1 周,Nature 评估 |
163
-
164
- ## 5. ADR-H0 元规约自检(PLAN 维度)
165
-
166
- - **H0.1 施工隔离**:本 PLAN scope 见 ADR-H4 §3.5,6 类路径全在 `docs/`、`.claude/skills/lead/`、`.boll/log/`
167
- - **H0.2 节流限速**:本 PLAN 目标 ≤500 行(终稿见 wc -l)
168
- - **H0.3 执检分离**:起草 = 本 session(H4 owning);reviewer = WP-05 spawn 的 read-only subagent
169
- - **H0.4 自指禁止**:本 PLAN grep `TBD|后续讨论|待协调员决定` 仅元层定义命中(参 §2 WP-02 段结构示意,本身就是规则定义)
170
- - **H0.5 跨子计划协调**:lead/SKILL.md 共改冲突已记入 H 系列 plan §3.4(H2 × H4 串行;H2 已 merged 不冲突 / H4 不动 ownership.yaml)
171
- - **H0.6 证据机械化**:每个 WP DoD 段全机械化(详 §3 矩阵)
172
- - **H0.meta**:本 PLAN grep `\bH[1568]\b` 仅 §1 关联 + §3 ADR-H0 / ADR-H3 / ADR-H4 / H 系列 plan 引用 + §5 自检本身命中(无未来产物引用)
173
-
174
- ## 6. 跨 H 协调登记(H 系列 plan §3.4 增量)
175
-
176
- | 文件 | H 触及 | 类型 | 仲裁 | 验证 |
177
- |------|--------|------|------|------|
178
- | `.claude/skills/lead/SKILL.md` | H4 独占 | 新增段(line 157 后插入)| H2/H3 已 merged 且不动 lead/SKILL.md,H4 独占无冲突 | `git log --oneline -- .claude/skills/lead/SKILL.md` 验 H 系列内仅 H4 commit |
179
- | `docs/decisions/ADR-H4-prompt-governance.md` | H4 独占 | 新增 ADR | 编号唯一 | `ls docs/decisions/ADR-H4-*.md` |
180
- | `docs/decisions/PLAN-H4-prompt-governance.md` | H4 独占 | 新增 PLAN | 编号唯一 | `ls docs/decisions/PLAN-H4-*.md` |
181
- | `docs/decisions/tasks/PLAN-H4/` | H4 独占 | 新增目录 | 编号唯一 | `ls docs/decisions/tasks/PLAN-H4/` |
182
- | `.boll/log/harness-self-symptoms.md` | H4 append | append 段(如自指)| 全 H 共享 append-only | `git log -- .boll/log/harness-self-symptoms.md` |
183
-
184
- ## 7. 进度追踪
185
-
186
- - [x] WP-01: 现状盘点(已在 H4 起草前完成 — 即避 §4.8 第 3 次复发的"前置 grep" 动作;wc/grep 4 项核命令已跑,结果纳入 ADR-H4 §3.5)
187
- - [ ] WP-02: 起草草稿段 → `tasks/PLAN-H4/WP-02/draft-section.md`
188
- - [ ] WP-03: demo 改写 → `tasks/PLAN-H4/WP-03/demo-rewrite-{ts}.md`
189
- - [ ] WP-04: lead/SKILL.md 嵌入 + race-safe commit
190
- - [ ] WP-05: reviewer 签字 + verdict 落 `tasks/PLAN-H4/reviewer-verdict-*.md`
191
-
192
- ## 8. Verify 命令汇总(reviewer 直接 copy-paste)
193
-
194
- ```bash
195
- # H0.2 行数核
196
- wc -l docs/decisions/ADR-H4-prompt-governance.md docs/decisions/PLAN-H4-prompt-governance.md .claude/skills/lead/SKILL.md
197
-
198
- # INV-H4-1 厚度(H4 段范围内 ≥10 条 - 段范围用 awk 切 "^## 行为治理" 到 "^## 联动规则" 之间)
199
- awk '/^## 行为治理(H4 三类清单)/,/^## 联动规则/' .claude/skills/lead/SKILL.md | grep -c "^- "
200
-
201
- # INV-H4-2 pointer(每条挂 feedback_*.md 或 harness-self-symptoms.md)
202
- awk '/^## 行为治理(H4 三类清单)/,/^## 联动规则/' .claude/skills/lead/SKILL.md | grep -c "feedback_.*\.md\|harness-self-symptoms.md"
203
-
204
- # INV-H4-3 哲学边界(段内零 hook/metrics/review-contract)
205
- awk '/^## 行为治理(H4 三类清单)/,/^## 联动规则/' .claude/skills/lead/SKILL.md | grep -iE "hook|metrics|review-contract|spawn" || echo "PASS: 段内零机制化关键词"
206
-
207
- # H0.4 自指扫描(仅元层定义命中)
208
- grep -nE "TBD|后续讨论|待协调员决定" docs/decisions/ADR-H4-prompt-governance.md docs/decisions/PLAN-H4-prompt-governance.md
209
-
210
- # H0.meta 未来 H 引用(仅边界 + 自检命中)
211
- grep -nE "\bH[1568]\b" docs/decisions/ADR-H4-prompt-governance.md docs/decisions/PLAN-H4-prompt-governance.md
212
-
213
- # FM1 lead 行数(≤200 硬规)
214
- wc -l .claude/skills/lead/SKILL.md
215
-
216
- # FM3 跨 SKILL 漂移(仅 lead/SKILL.md 应有 H4 段)
217
- grep -l "## 行为治理(H4 三类清单)" .claude/skills/*/SKILL.md
218
- ```
219
-
220
- ## 9. 与现行 vNext 共存(plan §3.3.3)
221
-
222
- | 检查 | 期望 | 缘由 |
223
- |------|------|------|
224
- | K 系列 sandbox smoke 不破 | PASS | H4 仅改 lead/SKILL.md prompt 段,不动 hook / yaml / 业务代码 |
225
- | 业务集成示例 Gate 不破 | PASS | 同上 |
226
- | coaching session 行为 | 70% 遵从率基线(继承 ADR-038 D11.2)| H4 不立硬约束,行为偏好 30% session 仍可能违规 — 不算回归 |
227
- | MCP `boll-mcp` 不破 | PASS | H4 不动 mcp-server / backend |