@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,145 +0,0 @@
1
- # Hanis(H 系列)协议详细规则
2
-
3
- **触发**: 改 `.boll/inbox/**` / `.boll/state/**` / `docs/decisions/ADR-H*.md` / `docs/decisions/PLAN-H*.md` / `.worktrees/hanis-*/**` / `.boll/log/hanis-self-symptoms.md` 时自动加载
4
- **适用范围**: 所有针对 hanis(H 系列)治理底座的修改
5
- **强制等级**: 不可降级(hard rule);与 ADR-041 v1.0「调字不加机制」边界详 §H4 vs H5
6
-
7
- ## H0 元规约 6+1(必读)
8
-
9
- > H0 仅依赖手工 `git diff` / `wc -l` / `grep` / Nature 签字 / PR 评论。**不得引用任何 H1-H9 未来产物**。
10
-
11
- | § | 规则 | 触发 | 验证 |
12
- |---|---|---|---|
13
- | **H0.1 施工隔离** | H 子 PLAN 的施工目录必须在 scope 显式列出,跨 scope 改动需 Nature 签字 | PR diff 触及非自身 scope | `git diff --name-only` 与 scope 列表手工比对 |
14
- | **H0.2 节流限速** | 每个 H 文档 ≤500 行;新增 ADR ≤300 行 | 起草 / 修订 / 追加章节 | `wc -l` 直量;PR 模板含行数自报 |
15
- | **H0.3 执检分离** | 起草人不能担任最终签字人;实施者不能验收自己 | PR merge 前;DoD 验收 | PR 至少 1 条非作者签字 |
16
- | **H0.4 自指禁止** | 修问题 X 的 H 不得在自己交付物中重现 X 的症状 | 任意 H 起草 / 实施 | PR 必填"自指自检"段,reviewer grep 反查 |
17
- | **H0.5 跨 H 协调** | 共改文件需登记冲突表;未登记按 git 时间戳先到先得,后到方负责 rebase | 同 commit window 多 H 触及同文件 | `git log --all --oneline -- <path>` 反查 |
18
- | **H0.6 证据机械化** | DoD 证据必须机器可生成(grep / 行数 / 文件存在 / hook log),不接受"reviewer 认为已完成" | 每个 DoD 勾选 | DoD checklist 每条括注证据生成命令 |
19
- | **H0.meta** | H0 自身修订也适用 H0.1-H0.6;H0 不引用任何 H1-H9 未来产物 | H0 文档每次变更 | 起草者写"H0 自检:未引用 H1-H9 未来产物" |
20
-
21
- ## 9 站速查表
22
-
23
- | 站 | ADR | PLAN | 核心 INV | 抗 compact 接口 |
24
- |---|-----|------|---------|----------------|
25
- | H0 | `ADR-H0-meta-charter.md` | (单文档,Nature 单签 charter) | 6+1 元规约 | — |
26
- | H9 | `ADR-H9-mailbox.md` | `PLAN-H9-mailbox.md` | inbox schema-v1 / 5 hook | `.boll/inbox/main/unread/` SessionStart 注入 |
27
- | H2 | `ADR-H2-identity-isolation.md` | `PLAN-H2-identity-isolation.md` | ownership.yaml owner 字段必填 | ADR-042 D9 |
28
- | H3 | `ADR-H3-memory-scope.md` | `PLAN-H3-memory-scope.md` | INV-H3-1/2/3(≤200 / ≤50 / 跨session 走 inbox) | MEMORY.md 主索引 ≤200 |
29
- | H4 | `ADR-H4-prompt-governance.md` | `PLAN-H4-prompt-governance.md` | 黑话/推卸/过度 review checklist | — |
30
- | H1 | `ADR-H1-crystal-learn-revival.md` | `PLAN-H1-crystal-learn-revival.md` | crystal-learn 周期触发 | — |
31
- | H5 | `ADR-H5-gate-quantization.md` | `PLAN-H5-gate-quantization.md` | review-contract.yaml + 跳 Gate 决策表 | — |
32
- | H6 | `ADR-H6-state-file-health.md` | `PLAN-H6-state-file-health.md` | state 清单 + 健康指标 ≥3 | ADR-042 D9 |
33
- | H8 | `ADR-H8-issue-and-doc-compliance.md` | `PLAN-H8-issue-and-doc-compliance.md` | INV-H8-1/2/3 | ADR-INDEX 自指过滤 |
34
-
35
- ## H4 vs H5 哲学边界(与 ADR-041 v1.0 张力)
36
-
37
- ADR-041 v1.0 故意"调字不加机制"。H 系列在补机制(H7 hook IO / H9 邮箱 / H6 状态文件)。两哲学边界:
38
-
39
- | 问题类型 | 走 prompt(ADR-041 v1.0) | 走 schema/hook(H 系列) | 判定理由 |
40
- |---|---|---|---|
41
- | 行为偏好(黑话 / 推卸 / 过度自我表扬) | ✅ lead skill prompt 段 | ❌ 不写 hook | 70% 遵从率够用;hook 解决不了"语气" |
42
- | 物理隔离(写权限 / 身份 / 跨 session) | ❌ prompt 不算数 | ✅ frontmatter / hook / 文件结构 | ADR-038 D11:schema-level 100% |
43
- | 节奏限速(review 轮次 / 文档行数) | ✅ 红线 + 每周人脑回顾 | ⚠ 仅当反复违反才升级 hook | 先调字 3 周 → 仍违反再上 hook |
44
- | 通信协议(窗口间消息 / proposal 格式) | ❌ prompt 不能保证 schema | ✅ 文件 + hook 验 schema | 没 schema 验,邮箱第二天就乱 |
45
-
46
- **反例(H 系列绝不做)**:
47
- - ❌ 写 hook 检测 AI 用没用黑话 → 黑话治理走 lead skill prompt
48
- - ❌ 建 metrics 系统记录 review 轮次 → 节奏靠红线 + 每周人脑回顾
49
- - ❌ 做 dashboard 看 H 系列进度 → 主窗口邮箱 inbox 已经够用
50
- - ❌ 加 SKILL.md 教 AI 怎么自己识别推卸行为 → 元能力堆叠是推卸的另一个症状
51
-
52
- ## H9 邮箱机制使用规则
53
-
54
- **inbox 路径约定**(schema 锁死,不许后续动):
55
- ```
56
- .boll/inbox/
57
- ├── main/{unread,processed,in-flight}/ # 主窗口收件箱
58
- ├── window-h0/, window-h7/, window-h9/, ... # 子窗口出件箱
59
- └── schema/message-v1.json # 消息 schema
60
- ```
61
-
62
- **消息文件 frontmatter 必填**:`sender / sender_pid / ts / kind(progress|block|done|question) / priority(P0|P1|P2) / related_h / ack_required`
63
-
64
- **5 hooks**(已上线):`inbox-write-ledger.ts` / `inbox-validate.ts` / `inbox-inject-on-start.ts` / `inbox-poll.sh` / `inbox-ack.ts`
65
-
66
- **与 `.boll/proposals/` 边界**(H9 ADR §X 锁死):
67
- - proposal = "我的足迹"(self-trace)
68
- - inbox = "我喊队友"(peer-message)
69
- - 同一动作只走一个;都要走时 inbox 引用 proposal ID(不复制内容)
70
-
71
- **主窗口姿态**:脚本协调员,不是人手。所有窗口间通信走 inbox,不许 SendMessage / TeamCreate / 复制粘贴。
72
-
73
- ## ADR-INDEX.md 自指过滤
74
-
75
- **INV-H8-1 检测命令**:
76
- ```bash
77
- diff <(ls docs/decisions/ADR-*.md | xargs -n1 basename | sed 's/\.md$//' | grep -v '^ADR-INDEX' | sort) \
78
- <(awk '/^- \[ADR-/{gsub(/^- \[/, ""); gsub(/\].*/, ""); print}' docs/decisions/ADR-INDEX.md | sort)
79
- ```
80
-
81
- **关键**:`grep -v '^ADR-INDEX'` 必须保留——ADR-INDEX 自身在 `ADR-*.md` glob 内,但不在自身 hook 列表(自指悖论闭环)。
82
-
83
- ## 跨 H 冲突仲裁
84
-
85
- | 冲突点 | H | 仲裁原则 |
86
- |---|---|---|
87
- | `*/SKILL.md` frontmatter | H2 × H4 | 串行:H2 先 schema,H4 后 prompt |
88
- | `ownership.yaml` | H2 × H6 | 串行:H2 先升级 schema,H6 后基于新 schema |
89
- | `MEMORY.md` | H3 × H4 | 串行:H3 先重组分段,H4 后写入 |
90
- | `ADR-042.md` D9 段 | H2 × H6 | 串行:H2 加身份段,H6 加抗 compact 段 |
91
- | `.boll/log/hook/` 路径 | H7 × 下游全部 | 串行:H7 先定,下游引用 |
92
- | `.boll/inbox/**` | H9 × 下游全部 | 串行:H9 先定 schema,下游窗口才能发 |
93
-
94
- 未登记冲突:git 时间戳先到先得,后到方 rebase。
95
-
96
- ## DoD 证据生成命令速查
97
-
98
- | Check | 命令 | 期望 |
99
- |---|---|---|
100
- | ADR ≤300 行 | `wc -l docs/decisions/ADR-H*.md` | 全部 ≤300 |
101
- | PLAN ≤500 行 | `wc -l docs/decisions/PLAN-H*.md` | 全部 ≤500 |
102
- | ADR-INDEX 完整 | INV-H8-1 命令 | exit 0 |
103
- | CHANGELOG ≤14d | `awk '/^## \[/{...}' CHANGELOG.md` | 相邻日期差 ≤14d |
104
- | open issue ≤80 | `find docs/issues -name "*.md" | xargs grep -l "^status: open" | wc -l` | ≤80 |
105
- | 9 H ADR 索引 | `for h in H0 H9 H2 H3 H4 H1 H5 H6 H8; do grep -qE "^\- \[ADR-${h}\b" docs/decisions/ADR-INDEX.md || echo "MISSING | ADR-${h}"; done` | 0 MISSING |
106
-
107
- ## 自指症状审计流
108
-
109
- `.boll/log/hanis-self-symptoms.md` 是 H 系列实施期 + 后续维护期"修问题反而引入问题"的落地审计流。每次触发:
110
- - 日期 / 涉及 H / 症状描述 / 处置 / 是否需要回滚
111
-
112
- **长期成功信号**:症状趋势递减(H 系列收尾时分析);递增 = H 系列失败信号。
113
-
114
- ## 失败回滚 4 档
115
-
116
- | 档位 | 现象 | 处置 |
117
- |---|---|---|
118
- | 轻 | 个别 hook fail,不影响产线 | 在 hanis-main 上 fix commit;记 self-symptoms |
119
- | 中 | vNext smoke fail 但能修 | hotfix worktree from hanis-main,1 天内 fix;超时升级 |
120
- | 重 | 产线撞挂 | `git revert <Hx-merge-commit>`;下游 H 必须 rebase;Nature 单签 |
121
- | 最坏 | 连续 2 H 重 broken 回滚 | H 系列暂停 1 周,Nature 评估拓扑或拆 H |
122
-
123
- ## 与现行产线共存灰度(已收尾期间维护参考)
124
-
125
- H 系列已 9/9 全闭,但维护期改动仍受灰度规则约束:
126
- - 改 hook → 跑现行 vNext smoke(K 系列 sandbox + boattosea Gate)
127
- - inbox 新路径不冲突 vNext,但 PostToolUse Write hook 只在 inbox 路径加
128
- - ownership.yaml / MEMORY.md 重组前必须 backup
129
- - state 文件健康指标 = 只读盘点,不删活的 state
130
-
131
- ## 与其他规则的关系
132
-
133
- - **ADR-038 D11**: schema-level 隔离 100% > prompt-level 70%(H2/H9 frontmatter 设计依据)
134
- - **ADR-041 v1.0**: 调字不加机制(H4 prompt 治理 vs H 系列其他机制层的边界依据)
135
- - **ADR-042 D3/D4/D9**: anti-compact 接口(H2/H6 抗 compact 接口签字依据)
136
- - **`feedback_record_preexisting_failures`**: pre-existing 失败 / guard 漂移登记不阻塞,但必须记录
137
-
138
- ## 例外申请
139
-
140
- H 系列 9 站已收尾。新议题原则上**不加 H10+**,走业务 PLAN-XXX 自然消化。
141
-
142
- 例外申请条件(罕见):
143
- 1. 该议题不能由任何业务 PLAN 承载(必须是 hanis 元层)
144
- 2. Nature 单签
145
- 3. 沿 9 站现有 ADR/PLAN 修订路径走,不开新 H 编号
@@ -1,42 +0,0 @@
1
- ---
2
- paths:
3
- - "{{PROJECT_NAME}}/**"
4
- - "src/**"
5
- - "lib/**"
6
- ---
7
-
8
- # {{PROJECT_NAME}} Repository Structure (Template)
9
-
10
- > 这份 rule 是仓库结构的"认知地图",让 agent 在第一次接触仓库时快速理解目录布局,避免盲目 Glob 扫描。
11
-
12
- ## 如何使用
13
-
14
- 1. 替换 `{{PROJECT_NAME}}`、`{{DOMAIN}}` 为你项目的真实名称
15
- 2. 下表是骨架示例,填入你项目的实际目录
16
- 3. 每条注释回答 "这个目录放什么 / 什么不应该放在这里"
17
-
18
- ## 目录布局
19
-
20
- ```
21
- {{PROJECT_NAME}}/
22
- ├── .boll/ # Claude Code 配置 (settings.json + rules/ + skills/ + agents/)
23
- ├── .boll/ # bollharness runtime 数据 (metrics/proposals/guard/tasks)
24
- ├── src/scripts/
25
- │ ├── hooks/ # PreToolUse/PostToolUse 等 hook 实做 (stdlib only)
26
- │ ├── checks/ # 结构化 check 脚本 (INV-* guard, fragment integrity, etc.)
27
- │ ├── ci/ # CI 专用扫描器
28
- │ └── lib/ # 共享 lib (sanitize_patterns, claim_patterns, ...)
29
- ├── src/ or {{PROJECT_NAME}}/ # 业务代码入口
30
- ├── tests/ # 测试
31
- ├── docs/
32
- │ ├── decisions/ # ADR / PLAN / TECH 决策文档
33
- │ ├── issues/ # Guardian issue (ADR-030 closure semantics)
34
- │ └── architecture/ # 架构图与核心概念
35
- └── CLAUDE.md # 项目根入口, 声明不可妥协约束 + path-scoped rules 触发表
36
- ```
37
-
38
- ## 禁止事项
39
-
40
- - `src/scripts/hooks/` 内禁止 `import requests` / 非 stdlib 依赖(hook 必须 runtime 零依赖)
41
- - `.boll/` 子目录的 runtime content 不能进 git(`.gitignore` 负向模式保留 `.gitkeep` sentinel)
42
- - 不允许在多个地方硬编码 "physical_files=N"——唯一源是 `src/scripts/ci/count-components.sh`
@@ -1,73 +0,0 @@
1
- # 审查 Agent 工具隔离规则
2
-
3
- **来源**: ADR-038 D11 + OpenDev arXiv 2603.05344
4
- **适用范围**: 所有 review / audit / evaluator / gate-keeper 类 subagent
5
- **强制等级**: 不可降级(hard rule)
6
-
7
- ## 核心规则
8
-
9
- **一句话**:审查类 agent 的工具白名单必须 schema-level 隔离写权限,prompt 约束不算数。
10
-
11
- ## 为什么
12
-
13
- - **Prompt 约束**("不要修改文件"):经验上约 70% 遵从率
14
- - **Schema 隔离**(frontmatter 不列 Edit/Write):100% 遵从率(物理上无法调用)
15
- - 写权限误用造成的 silent corruption 比可见错误更难恢复
16
-
17
- ## 实施清单
18
-
19
- ### 1. 本地 review agent — frontmatter 强制
20
-
21
- ```yaml
22
- ---
23
- name: my-reviewer
24
- tools:
25
- - Read
26
- - Glob
27
- - Grep
28
- - WebFetch
29
- # 不列 Edit/Write/Bash → 物理隔离
30
- ---
31
- ```
32
-
33
- 参考实现:`.boll/agents/review-readonly.md`
34
- 共享白名单:`.boll/agents/review-base.yaml`
35
-
36
- ### 2. 插件 review agent — spawn-boundary gate(PreToolUse Task hook)
37
-
38
- 我们无法改第三方插件的 frontmatter,但可以在 CC spawn subagent 之前的 `PreToolUse Task` hook 拦截:
39
-
40
- 1. 检查 subagent_type 是否在 review/audit 列表(配置见 `.boll/review-agents.yaml`)
41
- 2. 检查调用 prompt 是否包含 read-only directive
42
- 3. 缺失 → exit 2 硬阻断 spawn
43
- 4. 通过 → 写 marker 文件到 `.boll/active-review-agents/`,allow
44
-
45
- 参考实现:`src/scripts/hooks/review-agent-gatekeeper.ts`
46
-
47
- ### 3. Stop hook Evaluator — 设计上零工具
48
-
49
- `src/scripts/hooks/stop-evaluator.md` 是 hook 注入的检查清单 prompt,不是 subagent。它本身没有工具调用能力,符合 D11 精神。
50
-
51
- ## 违规检测
52
-
53
- 每次 PR 检查时(手动 / Gate 审查 / 自动化):
54
-
55
- 1. 扫描 `.boll/agents/*.md` 中所有 frontmatter 含"review|audit|evaluator|gate"的 agent
56
- 2. 检查它们的 `tools:` 字段是否包含 Edit / Write / Bash / NotebookEdit
57
- 3. 如有,要求文档化 deviation 理由(写在 agent.md 顶部)
58
-
59
- ## D11.2 Spawn-Boundary Gate 工作原理
60
-
61
- **为什么不直接禁止 review agent 调用 Edit/Write?** — 因为 CC PreToolUse 的 stdin payload 不直接告诉 hook "这个工具调用来自哪个 subagent"。我们无法在 Edit/Write 时刻准确判断调用方是 review agent 还是 main agent。
62
-
63
- **chokepoint 在 `Task` tool**:当 main agent 调用 `Task(subagent_type=<reviewer>)` 时,PreToolUse Task hook 在 spawn 发生之前拦截并强制 prompt 包含 read-only directive。
64
-
65
- **残余漏洞**:subagent 自身仍可能 ignore prompt 约束(~70% adherence)。但相比"完全靠调用方自觉",这把约束从"希望"变成了"前置硬条件"。
66
-
67
- ## 例外申请
68
-
69
- 在极少数情况下,某个 review agent 可能需要 Bash(例如运行只读 git 命令)。这需要:
70
-
71
- 1. 在 agent definition 顶部用注释说明 deviation 理由
72
- 2. 在 PreToolUse hook 中加白名单匹配(参考 `bash_allowed_patterns` in review-base.yaml)
73
- 3. 在 `docs/decisions/` 中记录例外 ADR
@@ -1,33 +0,0 @@
1
- # Source of Truth
2
-
3
- > 这份 rule 告诉 agent 哪些文件是"事实源",不允许凭记忆或 LLM 自己推断;必须先 Read 或 Grep 再做判断。
4
-
5
- ## Layout 真相源
6
-
7
- | 主题 | 真相文件 |
8
- |------|---------|
9
- | Harness 组件清单 (hooks/checks/rules/skills) | `.boll/MANIFEST.yaml` |
10
- | PreToolUse / PostToolUse matcher 注册 | `.boll/settings.json` |
11
- | Annex A.1 五类脱敏分类 | `src/scripts/lib/sanitize_patterns.ts` |
12
- | 三元 count (command_instances/unique_scripts/physical_files) | `src/scripts/ci/count-components.sh` 实时输出 |
13
- | rebaseline triggers | `.boll/MANIFEST.yaml` `rebaseline_triggers[]` |
14
-
15
- ## 决策链真相源
16
-
17
- | 主题 | 真相文件 |
18
- |------|---------|
19
- | 开源治理与剥离边界 | `docs/decisions/ADR-043-wow-harness-open-sourcing.md`(fork 时已脱敏) |
20
- | Harness 优化决策链 | `docs/decisions/ADR-038-harness-optimization-v5.md` |
21
- | Codex 分流边界 | `docs/decisions/ADR-041-codex-integration.md` |
22
- | Guard signal 与 governance reload | `docs/decisions/ADR-030-guard-signal-and-governance-reload.md` |
23
-
24
- ## 禁止行为
25
-
26
- - 禁止凭记忆声称"某个 hook 存在"——先 `grep src/scripts/hooks/` 或读 `MANIFEST.yaml`
27
- - 禁止在多个文件维护同一份数字(例如 hook 总数)——引用 `MANIFEST.yaml` 单一源
28
- - 禁止在 skill 或 rule 里硬编码 `.boll/` 路径——harness runtime dir 统一为 `.boll/`
29
-
30
- ## 参见
31
-
32
- - `.boll/rules/closure-semantics.md` — Fixed 三层定义
33
- - `.boll/rules/review-agent-isolation.md` — review agent schema-level 工具隔离
@@ -1,180 +0,0 @@
1
- {
2
- "attribution": {
3
- "co_authored_by": false
4
- },
5
- "hooks": {
6
- "PostToolUse": [
7
- {
8
- "matcher": "Edit|Write",
9
- "hooks": [
10
- {
11
- "type": "command",
12
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/guard-feedback.ts",
13
- "timeout": 30
14
- },
15
- {
16
- "type": "command",
17
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/loop-detection.ts",
18
- "timeout": 5
19
- },
20
- {
21
- "type": "command",
22
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/risk-tracker.ts 2>/dev/null || true",
23
- "timeout": 3
24
- }
25
- ]
26
- }
27
- ],
28
- "PreToolUse": [
29
- {
30
- "matcher": "Bash",
31
- "hooks": [
32
- {
33
- "type": "command",
34
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/deploy-guard.ts",
35
- "timeout": 10
36
- },
37
- {
38
- "type": "command",
39
- "if": "Bash(npx ts-node *)",
40
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/auto-ts-node.ts",
41
- "timeout": 5
42
- }
43
- ]
44
- },
45
- {
46
- "matcher": "*",
47
- "hooks": [
48
- {
49
- "type": "command",
50
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/tool-call-counter.ts 2>/dev/null || true",
51
- "timeout": 3
52
- }
53
- ]
54
- },
55
- {
56
- "matcher": "Task",
57
- "hooks": [
58
- {
59
- "type": "command",
60
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/review-agent-gatekeeper.ts",
61
- "timeout": 5
62
- }
63
- ]
64
- },
65
- {
66
- "matcher": "Read|Bash",
67
- "hooks": [
68
- {
69
- "type": "command",
70
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/sanitize-on-read.ts",
71
- "timeout": 10
72
- }
73
- ]
74
- }
75
- ],
76
- "PreCompact": [
77
- {
78
- "matcher": "*",
79
- "hooks": [
80
- {
81
- "type": "command",
82
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && bash scripts/hooks/precompact.sh",
83
- "timeout": 5
84
- }
85
- ]
86
- }
87
- ],
88
- "SessionStart": [
89
- {
90
- "matcher": "*",
91
- "hooks": [
92
- {
93
- "type": "command",
94
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/session-start-reset-risk.ts",
95
- "timeout": 3
96
- },
97
- {
98
- "type": "command",
99
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/session-start-magic-docs.ts",
100
- "timeout": 10
101
- },
102
- {
103
- "type": "command",
104
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/session-start-toolkit-reminder.ts",
105
- "timeout": 5
106
- },
107
- {
108
- "type": "command",
109
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/gate-judgment-inject.ts",
110
- "timeout": 5
111
- }
112
- ]
113
- }
114
- ],
115
- "Stop": [
116
- {
117
- "matcher": "*",
118
- "hooks": [
119
- {
120
- "type": "command",
121
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/stop-evaluator.ts",
122
- "timeout": 10
123
- }
124
- ]
125
- }
126
- ],
127
- "SessionEnd": [
128
- {
129
- "matcher": "*",
130
- "hooks": [
131
- {
132
- "type": "command",
133
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/session-reflection.ts",
134
- "timeout": 10
135
- },
136
- {
137
- "type": "command",
138
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/trace-analyzer.ts analyze --days 1 --min-samples 3 2>/dev/null || true",
139
- "timeout": 30
140
- },
141
- {
142
- "type": "command",
143
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/deploy-progress-on-session-end.ts",
144
- "timeout": 5
145
- }
146
- ]
147
- }
148
- ],
149
- "PostToolUseFailure": [
150
- {
151
- "matcher": "*",
152
- "hooks": [
153
- {
154
- "type": "command",
155
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/failure-analyzer.ts",
156
- "timeout": 5
157
- }
158
- ]
159
- }
160
- ],
161
- "PreGateTransition": [
162
- {
163
- "matcher": "*",
164
- "hooks": []
165
- }
166
- ],
167
- "PostGateTransition": [
168
- {
169
- "matcher": "0|3",
170
- "hooks": [
171
- {
172
- "type": "command",
173
- "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/gate-transition-judgment.ts ${BOLL_GATE_TO} .",
174
- "timeout": 10
175
- }
176
- ]
177
- }
178
- ]
179
- }
180
- }
@@ -1,31 +0,0 @@
1
- {
2
- "_comment": "WP-01b placeholder template. WP-03 substitutes {{HOOK_ROOT}} and {{FIND_ROOT_SCRIPT}} with real bollharness paths and emits the 15-row grep-locked registry to .boll/MANIFEST.yaml#settings_command_registry. WP-11 installer atomically appends one PreToolUse Read|Bash matcher via npx ts-node -e or jq (never sed). Contract: producer = WP-01b (template), substituter = WP-03 (15 rows), consumer = WP-11 (16th row). See PLAN-086 v2.1-final section 4 phase B + patch_b.",
3
-
4
- "hooks": {
5
- "PreToolUse": [
6
- {
7
- "matcher": "Edit|Write|NotebookEdit",
8
- "hooks": [
9
- {
10
- "type": "command",
11
- "command": "cd \"$({{HOOK_ROOT}}/{{FIND_ROOT_SCRIPT}})\" && npx ts-node {{HOOK_ROOT}}/guard-feedback.ts"
12
- }
13
- ]
14
- },
15
- {
16
- "matcher": "Bash",
17
- "hooks": [
18
- {
19
- "type": "command",
20
- "command": "cd \"$({{HOOK_ROOT}}/{{FIND_ROOT_SCRIPT}})\" && npx ts-node {{HOOK_ROOT}}/deploy-guard.ts"
21
- }
22
- ]
23
- }
24
- ],
25
- "PostToolUse": [],
26
- "Stop": [],
27
- "PreCompact": [],
28
- "SessionStart": [],
29
- "SessionEnd": []
30
- }
31
- }