@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,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 |