@bolloon/bolloon-agent 0.1.0 → 0.1.1

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 (431) hide show
  1. package/package.json +1 -1
  2. package/dist/constraint-runtime/tests/agent.test.js +0 -16
  3. package/dist/constraint-runtime/tests/constraint.test.js +0 -41
  4. package/dist/constraint-runtime/tests/skill.test.js +0 -19
  5. package/dist/constraint-runtime/tests/thinking.test.js +0 -22
  6. package/dist/electron-preload.js +0 -15
  7. package/dist/electron-preload.js.map +0 -1
  8. package/dist/electron.js +0 -206
  9. package/dist/electron.js.map +0 -1
  10. package/dist/test/constraint-layer.test.js +0 -164
  11. package/dist/test/global-shared-context.test.js +0 -315
  12. package/dist/test/pi-sdk.test.js +0 -47
  13. package/dist/test/set-persona.test.js +0 -38
  14. package/dist/test/subagent-manager.test.js +0 -276
  15. package/dist/test/workflow-engine.test.js +0 -87
  16. package/dist/workflows/collaboration.js +0 -374
  17. package/dist/workflows/index.js +0 -54
  18. package/docs/agent-communication.md +0 -333
  19. package/docs/plans/2026-05-15-document-agent-design.md +0 -479
  20. package/docs/plans/2026-05-15-document-agent-implementation-plan.md +0 -792
  21. package/docs/plans/2026-05-16-chat-ui-design.md +0 -86
  22. package/docs/plans/2026-05-16-constraint-runtime-design.md +0 -106
  23. package/docs/plans/2026-05-16-constraint-runtime-implementation.md +0 -441
  24. 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
  25. package/src/bollharness/.boll/CLAUDE.md.template +0 -34
  26. package/src/bollharness/.boll/MANIFEST.yaml +0 -213
  27. package/src/bollharness/.boll/active-review-agents/.gitkeep +0 -0
  28. package/src/bollharness/.boll/agents/review-base.yaml +0 -108
  29. package/src/bollharness/.boll/deploy-allowlist.yaml +0 -38
  30. package/src/bollharness/.boll/inbox/schema/message-v1.json +0 -99
  31. package/src/bollharness/.boll/install-staging/.gitkeep +0 -0
  32. package/src/bollharness/.boll/issue-adapter.yaml +0 -31
  33. package/src/bollharness/.boll/plugins/boll-mode-toolkit/contracts/mode-contract.md +0 -85
  34. package/src/bollharness/.boll/plugins/boll-review-toolkit/contracts/evidence-packet-schema.json +0 -102
  35. package/src/bollharness/.boll/plugins/boll-review-toolkit/contracts/review-contract.yaml +0 -247
  36. package/src/bollharness/.boll/rules/backend-routes.md +0 -31
  37. package/src/bollharness/.boll/rules/closure-semantics.md +0 -30
  38. package/src/bollharness/.boll/rules/env-vars.md +0 -32
  39. package/src/bollharness/.boll/rules/hanis-protocol.md +0 -145
  40. package/src/bollharness/.boll/rules/repo-structure.md +0 -42
  41. package/src/bollharness/.boll/rules/review-agent-isolation.md +0 -73
  42. package/src/bollharness/.boll/rules/source-of-truth.md +0 -33
  43. package/src/bollharness/.boll/settings.json +0 -180
  44. package/src/bollharness/.boll/settings.json.template +0 -31
  45. package/src/bollharness/.boll/skills/arch/SKILL.md +0 -372
  46. package/src/bollharness/.boll/skills/bug-pipeline/SKILL.md +0 -168
  47. package/src/bollharness/.boll/skills/bug-triage/SKILL.md +0 -161
  48. package/src/bollharness/.boll/skills/context-chains/SKILL.md +0 -250
  49. package/src/bollharness/.boll/skills/context-chains/context-chain-index.md +0 -48
  50. package/src/bollharness/.boll/skills/context-chains/work-type-extractors/code_change_extractor.ts +0 -142
  51. package/src/bollharness/.boll/skills/context-chains/work-type-extractors/debugging_extractor.ts +0 -126
  52. package/src/bollharness/.boll/skills/context-chains/work-type-extractors/design_extractor.ts +0 -148
  53. package/src/bollharness/.boll/skills/context-chains/work-type-extractors/planning_extractor.ts +0 -162
  54. package/src/bollharness/.boll/skills/context-chains/work-type-extractors/question_extractor.ts +0 -116
  55. package/src/bollharness/.boll/skills/context-chains/work-type-extractors/review_extractor.ts +0 -136
  56. package/src/bollharness/.boll/skills/crystal-learn/SKILL.md +0 -93
  57. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-0.md +0 -34
  58. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-1.md +0 -34
  59. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-2.md +0 -35
  60. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-3.md +0 -34
  61. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-4.md +0 -43
  62. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-5.md +0 -34
  63. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-6.md +0 -37
  64. package/src/bollharness/.boll/skills/crystal-learn/invariants/INV-7.md +0 -46
  65. package/src/bollharness/.boll/skills/guardian-fixer/PROMPT.md +0 -415
  66. package/src/bollharness/.boll/skills/guardian-fixer/SKILL.md +0 -320
  67. package/src/bollharness/.boll/skills/harness-dev/SKILL.md +0 -93
  68. package/src/bollharness/.boll/skills/harness-dev/examples/README.md +0 -227
  69. package/src/bollharness/.boll/skills/harness-dev-handoff/SKILL.md +0 -165
  70. package/src/bollharness/.boll/skills/harness-eng/SKILL.md +0 -110
  71. package/src/bollharness/.boll/skills/harness-eng-test/SKILL.md +0 -79
  72. package/src/bollharness/.boll/skills/harness-lab/SKILL.md +0 -170
  73. package/src/bollharness/.boll/skills/harness-ops/SKILL.md +0 -57
  74. package/src/bollharness/.boll/skills/harness-voice/SKILL.md +0 -183
  75. package/src/bollharness/.boll/skills/judgment/SKILL.md +0 -115
  76. package/src/bollharness/.boll/skills/lead/SKILL.md +0 -245
  77. package/src/bollharness/.boll/skills/lead/install-wow-harness.md +0 -77
  78. package/src/bollharness/.boll/skills/lead/ref-review-sop.md +0 -91
  79. package/src/bollharness/.boll/skills/lead/ref-stages.md +0 -129
  80. package/src/bollharness/.boll/skills/skill-discovery/SKILL.md +0 -169
  81. package/src/bollharness/.boll/skills/task-arch/SKILL.md +0 -106
  82. package/src/bollharness/.boll/skills/toolkit/SKILL.md +0 -57
  83. package/src/bollharness/.boll/tasks/.gitkeep +0 -0
  84. package/src/bollharness/.boll/toolkit-index.yaml +0 -112
  85. package/src/bollharness/.claude/agents/review-base.yaml +0 -108
  86. package/src/bollharness/.claude/plugins/boll-mode-toolkit/.claude-plugin/plugin.json +0 -44
  87. package/src/bollharness/.claude/plugins/boll-review-toolkit/.claude-plugin/plugin.json +0 -24
  88. package/src/bollharness/.claude/plugins/boll-review-toolkit/contracts/evidence-packet-schema.json +0 -102
  89. package/src/bollharness/.claude/plugins/boll-review-toolkit/contracts/review-contract.yaml +0 -247
  90. package/src/bollharness/.claude/settings.json +0 -157
  91. package/src/bollharness/.claude/skills/arch/SKILL.md +0 -64
  92. package/src/bollharness/.claude/skills/crystal-learn/SKILL.md +0 -93
  93. package/src/bollharness/.claude/skills/guardian-fixer/PROMPT.md +0 -44
  94. package/src/bollharness/.claude/skills/guardian-fixer/SKILL.md +0 -324
  95. package/src/bollharness/.claude/skills/harness-dev/SKILL.md +0 -93
  96. package/src/bollharness/.claude/skills/harness-dev/examples/README.md +0 -17
  97. package/src/bollharness/.claude/skills/harness-dev-handoff/SKILL.md +0 -165
  98. package/src/bollharness/.claude/skills/harness-eng/SKILL.md +0 -183
  99. package/src/bollharness/.claude/skills/harness-eng-test/SKILL.md +0 -57
  100. package/src/bollharness/.claude/skills/harness-ops/SKILL.md +0 -57
  101. package/src/bollharness/.claude/skills/harness-voice/SKILL.md +0 -84
  102. package/src/bollharness/.claude/skills/lead/INDEX.md +0 -28
  103. package/src/bollharness/.claude/skills/lead/SKILL.md +0 -24
  104. package/src/bollharness/.claude/skills/lead/install-wow-harness.md +0 -77
  105. package/src/bollharness/.claude/skills/lead/ref-review-sop.md +0 -48
  106. package/src/bollharness/.claude/skills/lead/ref-stages.md +0 -58
  107. package/src/bollharness/.claude/skills/plan-lock/SKILL.md +0 -74
  108. package/src/bollharness/.claude/skills/skill-discovery/SKILL.md +0 -120
  109. package/src/bollharness/.claude/skills/task-arch/SKILL.md +0 -106
  110. package/src/bollharness/.claude/skills/toolkit/SKILL.md +0 -57
  111. package/src/bollharness/.claude/skills/toolkit/list.sh +0 -92
  112. package/src/bollharness/.githooks/pre-commit +0 -21
  113. package/src/bollharness/.github/workflows/ci.yml +0 -88
  114. package/src/bollharness/CLAUDE.md +0 -73
  115. package/src/bollharness/README.md +0 -143
  116. package/src/bollharness/README.zh-CN.md +0 -131
  117. package/src/bollharness/docs/decisions/ADR-030-guard-signal-protocol-and-governance-reload.md +0 -1076
  118. package/src/bollharness/docs/decisions/ADR-038-harness-optimization-strategy.md +0 -2039
  119. package/src/bollharness/docs/decisions/ADR-041-codex-claude-code-division-of-labor.md +0 -128
  120. package/src/bollharness/docs/decisions/ADR-H1-crystal-learn-revival.md +0 -188
  121. package/src/bollharness/docs/decisions/ADR-H2-identity-isolation.md +0 -183
  122. package/src/bollharness/docs/decisions/ADR-H3-memory-scope.md +0 -133
  123. package/src/bollharness/docs/decisions/ADR-H4-prompt-governance.md +0 -146
  124. package/src/bollharness/docs/decisions/ADR-H5-gate-quantization.md +0 -212
  125. package/src/bollharness/docs/decisions/ADR-H6-state-file-health.md +0 -211
  126. package/src/bollharness/docs/decisions/ADR-H8-issue-and-doc-compliance.md +0 -202
  127. package/src/bollharness/docs/decisions/ADR-H9-mailbox.md +0 -231
  128. package/src/bollharness/docs/decisions/PLAN-H1-crystal-learn-revival.md +0 -270
  129. package/src/bollharness/docs/decisions/PLAN-H2-identity-isolation.md +0 -291
  130. package/src/bollharness/docs/decisions/PLAN-H3-memory-scope.md +0 -228
  131. package/src/bollharness/docs/decisions/PLAN-H4-prompt-governance.md +0 -227
  132. package/src/bollharness/docs/decisions/PLAN-H5-gate-quantization.md +0 -239
  133. package/src/bollharness/docs/decisions/PLAN-H6-state-file-health.md +0 -325
  134. package/src/bollharness/docs/decisions/PLAN-H8-issue-and-doc-compliance.md +0 -242
  135. package/src/bollharness/docs/decisions/PLAN-H9-mailbox.md +0 -378
  136. package/src/bollharness/docs/launch-article-en.md +0 -276
  137. package/src/bollharness/docs/launch-article-zh.md +0 -305
  138. package/src/bollharness/docs/practice.html +0 -356
  139. package/src/bollharness/docs/practice.md +0 -82
  140. package/src/bollharness/docs/research/round-1/README.md +0 -11
  141. package/src/bollharness/docs/research/round-2/README.md +0 -11
  142. package/src/bollharness/docs/research/round-3/README.md +0 -11
  143. package/src/bollharness/docs/research/round-4/README.md +0 -11
  144. package/src/bollharness/docs/research/round-5/README.md +0 -11
  145. package/src/bollharness/docs/research/round-6/README.md +0 -11
  146. package/src/bollharness/package-lock.json +0 -48
  147. package/src/bollharness/reference/boll-reference/.claude/rules/backend-routes.md +0 -268
  148. package/src/bollharness/reference/boll-reference/.claude/rules/bridge.md +0 -20
  149. package/src/bollharness/reference/boll-reference/.claude/rules/closure-semantics.md +0 -30
  150. package/src/bollharness/reference/boll-reference/.claude/rules/coaching.md +0 -13
  151. package/src/bollharness/reference/boll-reference/.claude/rules/env-vars.md +0 -50
  152. package/src/bollharness/reference/boll-reference/.claude/rules/hackathon.md +0 -12
  153. package/src/bollharness/reference/boll-reference/.claude/rules/repo-structure.md +0 -184
  154. package/src/bollharness/reference/boll-reference/.claude/rules/review-agent-isolation.md +0 -112
  155. package/src/bollharness/reference/boll-reference/.claude/rules/scenes.md +0 -12
  156. package/src/bollharness/reference/boll-reference/.claude/skills/arch/SKILL.md +0 -551
  157. package/src/bollharness/reference/boll-reference/.claude/skills/boll-animation/SKILL.md +0 -26
  158. package/src/bollharness/reference/boll-reference/.claude/skills/boll-bridge/SKILL.md +0 -227
  159. package/src/bollharness/reference/boll-reference/.claude/skills/boll-bridge/agents/openai.yaml +0 -4
  160. package/src/bollharness/reference/boll-reference/.claude/skills/boll-bridge/references/bridge-failure-taxonomy.md +0 -142
  161. package/src/bollharness/reference/boll-reference/.claude/skills/boll-bridge/references/bridge-validation-ladder.md +0 -107
  162. package/src/bollharness/reference/boll-reference/.claude/skills/boll-crystal/SKILL.md +0 -893
  163. package/src/bollharness/reference/boll-reference/.claude/skills/boll-crystal-learn/SKILL.md +0 -89
  164. package/src/bollharness/reference/boll-reference/.claude/skills/boll-dev/SKILL.md +0 -93
  165. package/src/bollharness/reference/boll-reference/.claude/skills/boll-dev/examples/README.md +0 -209
  166. package/src/bollharness/reference/boll-reference/.claude/skills/boll-dev-handoff/SKILL.md +0 -165
  167. package/src/bollharness/reference/boll-reference/.claude/skills/boll-eng/SKILL.md +0 -110
  168. package/src/bollharness/reference/boll-reference/.claude/skills/boll-eng-frontend/SKILL.md +0 -203
  169. package/src/bollharness/reference/boll-reference/.claude/skills/boll-eng-hdc/SKILL.md +0 -27
  170. package/src/bollharness/reference/boll-reference/.claude/skills/boll-eng-orchestrator/SKILL.md +0 -28
  171. package/src/bollharness/reference/boll-reference/.claude/skills/boll-eng-prompt/SKILL.md +0 -27
  172. package/src/bollharness/reference/boll-reference/.claude/skills/boll-eng-test/SKILL.md +0 -79
  173. package/src/bollharness/reference/boll-reference/.claude/skills/boll-lab/SKILL.md +0 -372
  174. package/src/bollharness/reference/boll-reference/.claude/skills/boll-run/SKILL.md +0 -437
  175. package/src/bollharness/reference/boll-reference/.claude/skills/boll-ux-appstore/SKILL.md +0 -27
  176. package/src/bollharness/reference/boll-reference/.claude/skills/boll-voice/SKILL.md +0 -442
  177. package/src/bollharness/reference/boll-reference/.claude/skills/guardian-fixer/PROMPT.md +0 -421
  178. package/src/bollharness/reference/boll-reference/.claude/skills/guardian-fixer/SKILL.md +0 -326
  179. package/src/bollharness/reference/boll-reference/.claude/skills/lead/SKILL.md +0 -155
  180. package/src/bollharness/reference/boll-reference/.claude/skills/lead/ref-review-sop.md +0 -91
  181. package/src/bollharness/reference/boll-reference/.claude/skills/lead/ref-stages.md +0 -129
  182. package/src/bollharness/reference/boll-reference/.claude/skills/nature-designer/output/skill-map-preview.png +0 -0
  183. package/src/bollharness/reference/boll-reference/.claude/skills/nature-designer/output/skill-map-v2.png +0 -0
  184. package/src/bollharness/reference/boll-reference/.claude/skills/nature-designer/output/skill-map-v3.png +0 -0
  185. package/src/bollharness/reference/boll-reference/.claude/skills/nature-designer/output/skill-map-v4.png +0 -0
  186. package/src/bollharness/reference/boll-reference/.claude/skills/plan-lock/SKILL.md +0 -425
  187. package/src/bollharness/reference/boll-reference/.claude/skills/plan-lock/ref-three-checks.md +0 -62
  188. package/src/bollharness/reference/boll-reference/.claude/skills/plan-lock/ref-wp-templates.md +0 -78
  189. package/src/bollharness/reference/boll-reference/.claude/skills/task-arch/SKILL.md +0 -76
  190. package/src/bollharness/reference/boll-reference/.claude/skills/vibedevteam-graph/SKILL.md +0 -57
  191. package/src/bollharness/reference/boll-reference/.claude/skills/vibedevteam-graph/beads-graph.sh +0 -153
  192. package/src/bollharness/reference/boll-reference/.claude/skills/vibedevteam-init/SKILL.md +0 -52
  193. package/src/bollharness/reference/boll-reference/.claude/skills/vibedevteam-init/beads-auto-link.sh +0 -76
  194. package/src/bollharness/reference/boll-reference/.claude/skills/vibedevteam-sync/SKILL.md +0 -50
  195. package/src/bollharness/reference/boll-reference/.claude/skills/vibedevteam-sync/beads-sync-proj.sh +0 -108
  196. package/src/bollharness/reference/boll-reference/docs/architecture/AGENT-PROFILE.md +0 -151
  197. package/src/bollharness/reference/boll-reference/docs/architecture/COST-STRUCTURE.md +0 -56
  198. package/src/bollharness/reference/boll-reference/docs/architecture/INDEX.md +0 -76
  199. package/src/bollharness/reference/boll-reference/docs/architecture/MODULE1-INTENT-FIELD.md +0 -116
  200. package/src/bollharness/reference/boll-reference/docs/architecture/MODULE2-CRYSTALLIZATION.md +0 -200
  201. package/src/bollharness/reference/boll-reference/docs/architecture/PRINCIPLES.md +0 -84
  202. package/src/bollharness/reference/boll-reference/docs/architecture/PROTOCOL-CORE.md +0 -209
  203. package/src/bollharness/reference/boll-reference/docs/architecture/VISION.md +0 -181
  204. package/src/bollharness/reference/boll-reference/docs/architecture/discussions/D-01-MARKET-SCENE-PROTOCOL.md +0 -754
  205. package/src/bollharness/reference/boll-reference/scripts/hooks/stop-evaluator.md +0 -57
  206. package/src/bollharness/scripts/context-fragments/artifact-linkage.md +0 -14
  207. package/src/bollharness/scripts/context-fragments/auth-consumers.md +0 -17
  208. package/src/bollharness/scripts/context-fragments/bridge-constitution.md +0 -13
  209. package/src/bollharness/scripts/context-fragments/catalyst-distributed.md +0 -18
  210. package/src/bollharness/scripts/context-fragments/closure-checklist.md +0 -13
  211. package/src/bollharness/scripts/context-fragments/contract-consumers.md +0 -15
  212. package/src/bollharness/scripts/context-fragments/db-shared-structures.md +0 -15
  213. package/src/bollharness/scripts/context-fragments/fixed-three-layers.md +0 -19
  214. package/src/bollharness/scripts/context-fragments/general-dev-principles.md +0 -11
  215. package/src/bollharness/scripts/context-fragments/issue-first.md +0 -8
  216. package/src/bollharness/scripts/context-fragments/mcp-parity.md +0 -16
  217. package/src/bollharness/scripts/context-fragments/pi-agent-operations.md +0 -74
  218. package/src/bollharness/scripts/context-fragments/protocol-consumers.md +0 -15
  219. package/src/bollharness/scripts/context-fragments/run-events-consumers.md +0 -15
  220. package/src/bollharness/scripts/context-fragments/scene-fidelity.md +0 -13
  221. package/src/bollharness/scripts/context-fragments/truth-source-hierarchy.md +0 -15
  222. package/src/bollharness/scripts/context-fragments/two-language.md +0 -15
  223. package/src/bollharness/scripts/context-fragments/version-sources.md +0 -14
  224. package/src/bollharness/scripts/hooks/stop-evaluator.md +0 -83
  225. package/src/bollharness/templates/scaffold/.boll/guard/.gitkeep +0 -0
  226. package/src/bollharness/templates/scaffold/.boll/metrics/.gitkeep +0 -0
  227. package/src/bollharness/templates/scaffold/.boll/state/.gitkeep +0 -0
  228. package/src/bollharness/templates/scaffold/CLAUDE.md +0 -89
  229. package/src/bollharness/templates/scaffold/docs/INDEX.md +0 -3
  230. package/src/bollharness/templates/scaffold/docs/decisions/ADR_TEMPLATE.md +0 -38
  231. package/src/bollharness/templates/scaffold/docs/decisions/PLAN_TEMPLATE.md +0 -45
  232. package/src/bollharness/templates/scaffold/docs/decisions/tasks/.gitkeep +0 -2
  233. package/src/bollharness/templates/scaffold/docs/issues/.gitkeep +0 -0
  234. package/src/bollharness/templates/scaffold/docs/issues/GUARD_ISSUE_TEMPLATE.md +0 -35
  235. package/src/bollharness/templates/scaffold/docs/issues/ISSUE_TEMPLATE.md +0 -51
  236. package/src/bollharness/tsconfig.json +0 -26
  237. package/src/constraint-runtime/package-lock.json +0 -48
  238. package/src/constraint-runtime/package.json +0 -34
  239. package/src/constraint-runtime/src/_archive_helper.ts +0 -16
  240. package/src/constraint-runtime/src/agent/coordinator.ts +0 -71
  241. package/src/constraint-runtime/src/agent/index.ts +0 -1
  242. package/src/constraint-runtime/src/assistant/index.ts +0 -15
  243. package/src/constraint-runtime/src/bootstrap/index.ts +0 -15
  244. package/src/constraint-runtime/src/bootstrap_graph.ts +0 -17
  245. package/src/constraint-runtime/src/bridge/index.ts +0 -15
  246. package/src/constraint-runtime/src/buddy/index.ts +0 -15
  247. package/src/constraint-runtime/src/cli/index.ts +0 -15
  248. package/src/constraint-runtime/src/command_graph.ts +0 -20
  249. package/src/constraint-runtime/src/commands.ts +0 -83
  250. package/src/constraint-runtime/src/components/index.ts +0 -15
  251. package/src/constraint-runtime/src/constants/index.ts +0 -15
  252. package/src/constraint-runtime/src/constraint/budget.ts +0 -25
  253. package/src/constraint-runtime/src/constraint/index.ts +0 -3
  254. package/src/constraint-runtime/src/constraint/permission.ts +0 -28
  255. package/src/constraint-runtime/src/context.ts +0 -45
  256. package/src/constraint-runtime/src/coordinator/index.ts +0 -15
  257. package/src/constraint-runtime/src/cost_hook.ts +0 -6
  258. package/src/constraint-runtime/src/cost_tracker.ts +0 -9
  259. package/src/constraint-runtime/src/deferred_init.ts +0 -18
  260. package/src/constraint-runtime/src/direct_modes.ts +0 -13
  261. package/src/constraint-runtime/src/dynamic-tool-loader.ts +0 -115
  262. package/src/constraint-runtime/src/entrypoints/index.ts +0 -15
  263. package/src/constraint-runtime/src/execution_registry.ts +0 -41
  264. package/src/constraint-runtime/src/history.ts +0 -16
  265. package/src/constraint-runtime/src/hooks/index.ts +0 -15
  266. package/src/constraint-runtime/src/index.ts +0 -28
  267. package/src/constraint-runtime/src/ink.ts +0 -4
  268. package/src/constraint-runtime/src/keybindings/index.ts +0 -15
  269. package/src/constraint-runtime/src/memdir/index.ts +0 -15
  270. package/src/constraint-runtime/src/migrations/index.ts +0 -15
  271. package/src/constraint-runtime/src/models.ts +0 -49
  272. package/src/constraint-runtime/src/moreright/index.ts +0 -15
  273. package/src/constraint-runtime/src/native_ts/index.ts +0 -15
  274. package/src/constraint-runtime/src/output_styles/index.ts +0 -15
  275. package/src/constraint-runtime/src/parity_audit.ts +0 -23
  276. package/src/constraint-runtime/src/plugins/index.ts +0 -15
  277. package/src/constraint-runtime/src/port_manifest.ts +0 -20
  278. package/src/constraint-runtime/src/prefetch.ts +0 -17
  279. package/src/constraint-runtime/src/query.ts +0 -7
  280. package/src/constraint-runtime/src/reference_data/archive_surface_snapshot.json +0 -63
  281. package/src/constraint-runtime/src/reference_data/commands_snapshot.json +0 -1037
  282. package/src/constraint-runtime/src/reference_data/subsystems/OpenCLI.json +0 -10
  283. package/src/constraint-runtime/src/reference_data/subsystems/PolymarketSDK.json +0 -12
  284. package/src/constraint-runtime/src/reference_data/subsystems/SafeSDK.json +0 -14
  285. package/src/constraint-runtime/src/reference_data/subsystems/assistant.json +0 -8
  286. package/src/constraint-runtime/src/reference_data/subsystems/bootstrap.json +0 -8
  287. package/src/constraint-runtime/src/reference_data/subsystems/bridge.json +0 -32
  288. package/src/constraint-runtime/src/reference_data/subsystems/buddy.json +0 -13
  289. package/src/constraint-runtime/src/reference_data/subsystems/cli.json +0 -26
  290. package/src/constraint-runtime/src/reference_data/subsystems/components.json +0 -32
  291. package/src/constraint-runtime/src/reference_data/subsystems/constants.json +0 -28
  292. package/src/constraint-runtime/src/reference_data/subsystems/coordinator.json +0 -8
  293. package/src/constraint-runtime/src/reference_data/subsystems/entrypoints.json +0 -15
  294. package/src/constraint-runtime/src/reference_data/subsystems/hooks.json +0 -32
  295. package/src/constraint-runtime/src/reference_data/subsystems/keybindings.json +0 -21
  296. package/src/constraint-runtime/src/reference_data/subsystems/memdir.json +0 -15
  297. package/src/constraint-runtime/src/reference_data/subsystems/migrations.json +0 -18
  298. package/src/constraint-runtime/src/reference_data/subsystems/moreright.json +0 -8
  299. package/src/constraint-runtime/src/reference_data/subsystems/native_ts.json +0 -11
  300. package/src/constraint-runtime/src/reference_data/subsystems/outputStyles.json +0 -8
  301. package/src/constraint-runtime/src/reference_data/subsystems/plugins.json +0 -9
  302. package/src/constraint-runtime/src/reference_data/subsystems/remote.json +0 -11
  303. package/src/constraint-runtime/src/reference_data/subsystems/schemas.json +0 -8
  304. package/src/constraint-runtime/src/reference_data/subsystems/screens.json +0 -10
  305. package/src/constraint-runtime/src/reference_data/subsystems/server.json +0 -10
  306. package/src/constraint-runtime/src/reference_data/subsystems/services.json +0 -32
  307. package/src/constraint-runtime/src/reference_data/subsystems/skills.json +0 -27
  308. package/src/constraint-runtime/src/reference_data/subsystems/state.json +0 -13
  309. package/src/constraint-runtime/src/reference_data/subsystems/types.json +0 -18
  310. package/src/constraint-runtime/src/reference_data/subsystems/upstreamproxy.json +0 -9
  311. package/src/constraint-runtime/src/reference_data/subsystems/utils.json +0 -32
  312. package/src/constraint-runtime/src/reference_data/subsystems/vim.json +0 -12
  313. package/src/constraint-runtime/src/reference_data/subsystems/voice.json +0 -8
  314. package/src/constraint-runtime/src/reference_data/tools_snapshot.json +0 -1042
  315. package/src/constraint-runtime/src/remote/index.ts +0 -15
  316. package/src/constraint-runtime/src/remote_runtime.ts +0 -17
  317. package/src/constraint-runtime/src/runtime/index.ts +0 -1
  318. package/src/constraint-runtime/src/runtime/session.ts +0 -42
  319. package/src/constraint-runtime/src/schemas/index.ts +0 -15
  320. package/src/constraint-runtime/src/screens/index.ts +0 -15
  321. package/src/constraint-runtime/src/server/index.ts +0 -15
  322. package/src/constraint-runtime/src/services/index.ts +0 -15
  323. package/src/constraint-runtime/src/session_store.ts +0 -32
  324. package/src/constraint-runtime/src/setup.ts +0 -50
  325. package/src/constraint-runtime/src/skills/index.ts +0 -1
  326. package/src/constraint-runtime/src/skills/skill-registry.ts +0 -40
  327. package/src/constraint-runtime/src/state/index.ts +0 -15
  328. package/src/constraint-runtime/src/system_init.ts +0 -21
  329. package/src/constraint-runtime/src/thinking/engine.ts +0 -61
  330. package/src/constraint-runtime/src/thinking/index.ts +0 -1
  331. package/src/constraint-runtime/src/tool_pool.ts +0 -20
  332. package/src/constraint-runtime/src/tools/OpenCLI/execAdapter.ts +0 -12
  333. package/src/constraint-runtime/src/tools/OpenCLI/listAdapters.ts +0 -12
  334. package/src/constraint-runtime/src/tools/OpenCLI/runCommand.ts +0 -13
  335. package/src/constraint-runtime/src/tools/PolymarketSDK/cancelOrder.ts +0 -10
  336. package/src/constraint-runtime/src/tools/PolymarketSDK/createOrder.ts +0 -13
  337. package/src/constraint-runtime/src/tools/PolymarketSDK/getMarket.ts +0 -14
  338. package/src/constraint-runtime/src/tools/PolymarketSDK/getOrders.ts +0 -10
  339. package/src/constraint-runtime/src/tools/PolymarketSDK/listMarkets.ts +0 -24
  340. package/src/constraint-runtime/src/tools/SafeSDK/confirmTransaction.ts +0 -13
  341. package/src/constraint-runtime/src/tools/SafeSDK/createTransaction.ts +0 -23
  342. package/src/constraint-runtime/src/tools/SafeSDK/deploySafe.ts +0 -12
  343. package/src/constraint-runtime/src/tools/SafeSDK/executeTransaction.ts +0 -12
  344. package/src/constraint-runtime/src/tools/SafeSDK/getBalance.ts +0 -10
  345. package/src/constraint-runtime/src/tools/SafeSDK/getPendingTransactions.ts +0 -10
  346. package/src/constraint-runtime/src/tools/SafeSDK/proposeTransaction.ts +0 -14
  347. package/src/constraint-runtime/src/tools/WalletTools/autoPay.ts +0 -58
  348. package/src/constraint-runtime/src/tools/WalletTools/createWallet.ts +0 -19
  349. package/src/constraint-runtime/src/tools/WalletTools/getBalance.ts +0 -28
  350. package/src/constraint-runtime/src/tools/WalletTools/importWallet.ts +0 -34
  351. package/src/constraint-runtime/src/tools/WalletTools/sendTransaction.ts +0 -50
  352. package/src/constraint-runtime/src/tools/WalletTools/signMessage.ts +0 -23
  353. package/src/constraint-runtime/src/tools/WalletTools/transferToken.ts +0 -49
  354. package/src/constraint-runtime/src/tools.ts +0 -100
  355. package/src/constraint-runtime/src/transcript.ts +0 -23
  356. package/src/constraint-runtime/src/types/index.ts +0 -15
  357. package/src/constraint-runtime/src/upstream_proxy/index.ts +0 -15
  358. package/src/constraint-runtime/src/utils/index.ts +0 -15
  359. package/src/constraint-runtime/src/vim/index.ts +0 -15
  360. package/src/constraint-runtime/src/voice/index.ts +0 -15
  361. package/src/constraint-runtime/tests/agent.test.ts +0 -20
  362. package/src/constraint-runtime/tests/constraint.test.ts +0 -47
  363. package/src/constraint-runtime/tests/skill.test.ts +0 -23
  364. package/src/constraint-runtime/tests/thinking.test.ts +0 -28
  365. package/src/constraint-runtime/tsconfig.json +0 -13
  366. package/src/pi-ecosystem/index.ts +0 -453
  367. package/src/pi-ecosystem-colony/index.ts +0 -482
  368. package/src/pi-ecosystem-goals/index.ts +0 -585
  369. package/src/pi-ecosystem-judgment/decision.ts +0 -431
  370. package/src/pi-ecosystem-judgment/distillation.ts +0 -398
  371. package/src/pi-ecosystem-judgment/human-value-store.ts +0 -580
  372. package/src/pi-ecosystem-judgment/index.ts +0 -678
  373. package/src/pi-ecosystem-judgment/value-injection.ts +0 -744
  374. package/src/pi-ecosystem-mcp/index.ts +0 -427
  375. package/src/pi-ecosystem-subagents/index.ts +0 -408
  376. package/src/test/ai-judgment-test.ts +0 -92
  377. package/src/test/bollharness-integration.test.ts +0 -398
  378. package/src/test/channel-agent-multi-dialogue.ts +0 -265
  379. package/src/test/channel-heartbeat-agent-test.ts +0 -244
  380. package/src/test/constraint-layer.test.ts +0 -191
  381. package/src/test/diap-identity-test.ts +0 -222
  382. package/src/test/diap-quick-test.ts +0 -73
  383. package/src/test/global-shared-context.test.ts +0 -393
  384. package/src/test/harness-judgment-injection.test.ts +0 -353
  385. package/src/test/harness-workflow-integrator-test.ts +0 -285
  386. package/src/test/human-value-store.test.ts +0 -316
  387. package/src/test/hybrid-integration-test.ts +0 -126
  388. package/src/test/hybrid-messenger-verify.ts +0 -68
  389. package/src/test/iroh-bistream-debug.ts +0 -50
  390. package/src/test/iroh-communication.test.ts +0 -81
  391. package/src/test/iroh-debug-test.ts +0 -69
  392. package/src/test/iroh-diap-test.ts +0 -90
  393. package/src/test/iroh-direct-connect.ts +0 -65
  394. package/src/test/iroh-e2e-fixed.ts +0 -106
  395. package/src/test/iroh-e2e-same-process.ts +0 -83
  396. package/src/test/iroh-e2e.ts +0 -83
  397. package/src/test/iroh-final-e2e.ts +0 -84
  398. package/src/test/iroh-relay-test.ts +0 -46
  399. package/src/test/iroh-simple-test.ts +0 -49
  400. package/src/test/iroh-transport-verify.ts +0 -60
  401. package/src/test/iroh-transport.test.ts +0 -47
  402. package/src/test/iroh-two-nodes.ts +0 -87
  403. package/src/test/iroh-verify.ts +0 -55
  404. package/src/test/judgment-decision.test.ts +0 -373
  405. package/src/test/llm-judgment-integration.test.ts +0 -257
  406. package/src/test/p2p-agent-complex-dialogue.ts +0 -490
  407. package/src/test/p2p-agent-dialogue.ts +0 -423
  408. package/src/test/p2p-agent-full-bidirectional.ts +0 -686
  409. package/src/test/p2p-agent-harness-flow.ts +0 -562
  410. package/src/test/p2p-agent-harness-single.ts +0 -175
  411. package/src/test/p2p-ai-dialogue-test.ts +0 -374
  412. package/src/test/p2p-cid-connect-test.ts +0 -245
  413. package/src/test/p2p-connect-receiver.ts +0 -85
  414. package/src/test/p2p-iroh-test.ts +0 -214
  415. package/src/test/p2p-minimal-test.ts +0 -264
  416. package/src/test/p2p-node-1.ts +0 -172
  417. package/src/test/p2p-node-2.ts +0 -172
  418. package/src/test/p2p-server.ts +0 -335
  419. package/src/test/p2p-two-nodes-test.ts +0 -542
  420. package/src/test/pi-sdk.test.ts +0 -47
  421. package/src/test/set-persona.ts +0 -56
  422. package/src/test/simple.test.ts +0 -11
  423. package/src/test/storage-integration.test.ts +0 -191
  424. package/src/test/subagent-manager.test.ts +0 -392
  425. package/src/test/test-gate-flow.test.ts +0 -92
  426. package/src/test/workflow-engine.test.ts +0 -101
  427. package/src/web/design.md +0 -99
  428. package/src/workflows/collaboration.ts +0 -455
  429. package/src/workflows/index.ts +0 -64
  430. package/vitest.config.ts +0 -12
  431. 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