@bolloon/bolloon-agent 0.1.0

package/src/bollharness/.boll/rules/env-vars.md

@@ -0,0 +1,32 @@
+---
+paths:
+  - "config.ts"
+  - "settings.ts"
+  - ".env*"
+  - "scripts/deploy*"
+---
+
+# {{PROJECT_NAME}} 环境变量清单 (Template)
+
+> 这是一个环境变量索引 rule 模板。bollharness fork 时保留骨架，{{PROJECT_NAME}} 自己填充具体变量。
+
+## 如何使用
+
+1. 把 `{{PROJECT_NAME}}` 替换成你的项目名
+2. 下表每一项必须如实填写**用途 + 必需性 + 默认值**
+3. **禁止**在这份文件里写任何真实 secret 值——这份文件会被提交到 repo
+
+## 变量表
+
+| 变量 | 必需 | 默认 | 用途 |
+|------|------|------|------|
+| `{{PROJECT_NAME_UPPER}}_ENV` | 是 | `development` | 运行环境 (`development` / `staging` / `production`) |
+| `{{PROJECT_NAME_UPPER}}_PORT` | 否 | `8080` | HTTP 监听端口 |
+| `{{PROJECT_NAME_UPPER}}_DB_URL` | 是 | — | 数据库连接串 |
+| `{{PROJECT_NAME_UPPER}}_LOG_LEVEL` | 否 | `INFO` | 日志级别 |
+
+## Secret 管理
+
+- 真实 secret 值只能存在于 `.env.local` / CI secret store / 部署 secret manager
+- `.env.local` 必须在 `.gitignore` 中
+- bollharness `src/scripts/sanitize.ts` 会拦截常见 secret 模式 (`sk-ant-`、`sk-or-`、`.env*` KV 等)

package/src/bollharness/.boll/rules/hanis-protocol.md

@@ -0,0 +1,145 @@
+# Hanis（H 系列）协议详细规则
+
+**触发**: 改 `.boll/inbox/**` / `.boll/state/**` / `docs/decisions/ADR-H*.md` / `docs/decisions/PLAN-H*.md` / `.worktrees/hanis-*/**` / `.boll/log/hanis-self-symptoms.md` 时自动加载
+**适用范围**: 所有针对 hanis（H 系列）治理底座的修改
+**强制等级**: 不可降级（hard rule）；与 ADR-041 v1.0「调字不加机制」边界详 §H4 vs H5
+
+## H0 元规约 6+1（必读）
+
+> H0 仅依赖手工 `git diff` / `wc -l` / `grep` / Nature 签字 / PR 评论。**不得引用任何 H1-H9 未来产物**。
+
+| § | 规则 | 触发 | 验证 |
+|---|---|---|---|
+| **H0.1 施工隔离** | H 子 PLAN 的施工目录必须在 scope 显式列出，跨 scope 改动需 Nature 签字 | PR diff 触及非自身 scope | `git diff --name-only` 与 scope 列表手工比对 |
+| **H0.2 节流限速** | 每个 H 文档 ≤500 行；新增 ADR ≤300 行 | 起草 / 修订 / 追加章节 | `wc -l` 直量；PR 模板含行数自报 |
+| **H0.3 执检分离** | 起草人不能担任最终签字人；实施者不能验收自己 | PR merge 前；DoD 验收 | PR 至少 1 条非作者签字 |
+| **H0.4 自指禁止** | 修问题 X 的 H 不得在自己交付物中重现 X 的症状 | 任意 H 起草 / 实施 | PR 必填"自指自检"段，reviewer grep 反查 |
+| **H0.5 跨 H 协调** | 共改文件需登记冲突表；未登记按 git 时间戳先到先得，后到方负责 rebase | 同 commit window 多 H 触及同文件 | `git log --all --oneline -- <path>` 反查 |
+| **H0.6 证据机械化** | DoD 证据必须机器可生成（grep / 行数 / 文件存在 / hook log），不接受"reviewer 认为已完成" | 每个 DoD 勾选 | DoD checklist 每条括注证据生成命令 |
+| **H0.meta** | H0 自身修订也适用 H0.1-H0.6；H0 不引用任何 H1-H9 未来产物 | H0 文档每次变更 | 起草者写"H0 自检：未引用 H1-H9 未来产物" |
+
+## 9 站速查表
+
+| 站 | ADR | PLAN | 核心 INV | 抗 compact 接口 |
+|---|-----|------|---------|----------------|
+| H0 | `ADR-H0-meta-charter.md` | （单文档，Nature 单签 charter） | 6+1 元规约 | — |
+| H9 | `ADR-H9-mailbox.md` | `PLAN-H9-mailbox.md` | inbox schema-v1 / 5 hook | `.boll/inbox/main/unread/` SessionStart 注入 |
+| H2 | `ADR-H2-identity-isolation.md` | `PLAN-H2-identity-isolation.md` | ownership.yaml owner 字段必填 | ADR-042 D9 |
+| H3 | `ADR-H3-memory-scope.md` | `PLAN-H3-memory-scope.md` | INV-H3-1/2/3（≤200 / ≤50 / 跨session 走 inbox） | MEMORY.md 主索引 ≤200 |
+| H4 | `ADR-H4-prompt-governance.md` | `PLAN-H4-prompt-governance.md` | 黑话/推卸/过度 review checklist | — |
+| H1 | `ADR-H1-crystal-learn-revival.md` | `PLAN-H1-crystal-learn-revival.md` | crystal-learn 周期触发 | — |
+| H5 | `ADR-H5-gate-quantization.md` | `PLAN-H5-gate-quantization.md` | review-contract.yaml + 跳 Gate 决策表 | — |
+| H6 | `ADR-H6-state-file-health.md` | `PLAN-H6-state-file-health.md` | state 清单 + 健康指标 ≥3 | ADR-042 D9 |
+| H8 | `ADR-H8-issue-and-doc-compliance.md` | `PLAN-H8-issue-and-doc-compliance.md` | INV-H8-1/2/3 | ADR-INDEX 自指过滤 |
+
+## H4 vs H5 哲学边界（与 ADR-041 v1.0 张力）
+
+ADR-041 v1.0 故意"调字不加机制"。H 系列在补机制（H7 hook IO / H9 邮箱 / H6 状态文件）。两哲学边界：
+
+| 问题类型 | 走 prompt（ADR-041 v1.0） | 走 schema/hook（H 系列） | 判定理由 |
+|---|---|---|---|
+| 行为偏好（黑话 / 推卸 / 过度自我表扬） | ✅ lead skill prompt 段 | ❌ 不写 hook | 70% 遵从率够用；hook 解决不了"语气" |
+| 物理隔离（写权限 / 身份 / 跨 session） | ❌ prompt 不算数 | ✅ frontmatter / hook / 文件结构 | ADR-038 D11：schema-level 100% |
+| 节奏限速（review 轮次 / 文档行数） | ✅ 红线 + 每周人脑回顾 | ⚠ 仅当反复违反才升级 hook | 先调字 3 周 → 仍违反再上 hook |
+| 通信协议（窗口间消息 / proposal 格式） | ❌ prompt 不能保证 schema | ✅ 文件 + hook 验 schema | 没 schema 验，邮箱第二天就乱 |
+
+**反例（H 系列绝不做）**：
+- ❌ 写 hook 检测 AI 用没用黑话 → 黑话治理走 lead skill prompt
+- ❌ 建 metrics 系统记录 review 轮次 → 节奏靠红线 + 每周人脑回顾
+- ❌ 做 dashboard 看 H 系列进度 → 主窗口邮箱 inbox 已经够用
+- ❌ 加 SKILL.md 教 AI 怎么自己识别推卸行为 → 元能力堆叠是推卸的另一个症状
+
+## H9 邮箱机制使用规则
+
+**inbox 路径约定**（schema 锁死，不许后续动）：
+```
+.boll/inbox/
+├── main/{unread,processed,in-flight}/    # 主窗口收件箱
+├── window-h0/, window-h7/, window-h9/, ...   # 子窗口出件箱
+└── schema/message-v1.json                # 消息 schema
+```
+
+**消息文件 frontmatter 必填**：`sender / sender_pid / ts / kind(progress|block|done|question) / priority(P0|P1|P2) / related_h / ack_required`
+
+**5 hooks**（已上线）：`inbox-write-ledger.ts` / `inbox-validate.ts` / `inbox-inject-on-start.ts` / `inbox-poll.sh` / `inbox-ack.ts`
+
+**与 `.boll/proposals/` 边界**（H9 ADR §X 锁死）：
+- proposal = "我的足迹"（self-trace）
+- inbox = "我喊队友"（peer-message）
+- 同一动作只走一个；都要走时 inbox 引用 proposal ID（不复制内容）
+
+**主窗口姿态**：脚本协调员，不是人手。所有窗口间通信走 inbox，不许 SendMessage / TeamCreate / 复制粘贴。
+
+## ADR-INDEX.md 自指过滤
+
+**INV-H8-1 检测命令**：
+```bash
+diff <(ls docs/decisions/ADR-*.md | xargs -n1 basename | sed 's/\.md$//' | grep -v '^ADR-INDEX' | sort) \
+     <(awk '/^- \[ADR-/{gsub(/^- \[/, ""); gsub(/\].*/, ""); print}' docs/decisions/ADR-INDEX.md | sort)
+```
+
+**关键**：`grep -v '^ADR-INDEX'` 必须保留——ADR-INDEX 自身在 `ADR-*.md` glob 内，但不在自身 hook 列表（自指悖论闭环）。
+
+## 跨 H 冲突仲裁
+
+| 冲突点 | H | 仲裁原则 |
+|---|---|---|
+| `*/SKILL.md` frontmatter | H2 × H4 | 串行：H2 先 schema，H4 后 prompt |
+| `ownership.yaml` | H2 × H6 | 串行：H2 先升级 schema，H6 后基于新 schema |
+| `MEMORY.md` | H3 × H4 | 串行：H3 先重组分段，H4 后写入 |
+| `ADR-042.md` D9 段 | H2 × H6 | 串行：H2 加身份段，H6 加抗 compact 段 |
+| `.boll/log/hook/` 路径 | H7 × 下游全部 | 串行：H7 先定，下游引用 |
+| `.boll/inbox/**` | H9 × 下游全部 | 串行：H9 先定 schema，下游窗口才能发 |
+
+未登记冲突：git 时间戳先到先得，后到方 rebase。
+
+## DoD 证据生成命令速查
+
+| Check | 命令 | 期望 |
+|---|---|---|
+| ADR ≤300 行 | `wc -l docs/decisions/ADR-H*.md` | 全部 ≤300 |
+| PLAN ≤500 行 | `wc -l docs/decisions/PLAN-H*.md` | 全部 ≤500 |
+| ADR-INDEX 完整 | INV-H8-1 命令 | exit 0 |
+| CHANGELOG ≤14d | `awk '/^## \[/{...}' CHANGELOG.md` | 相邻日期差 ≤14d |
+| open issue ≤80 | `find docs/issues -name "*.md" | xargs grep -l "^status: open" | wc -l` | ≤80 |
+| 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 |
+
+## 自指症状审计流
+
+`.boll/log/hanis-self-symptoms.md` 是 H 系列实施期 + 后续维护期"修问题反而引入问题"的落地审计流。每次触发：
+- 日期 / 涉及 H / 症状描述 / 处置 / 是否需要回滚
+
+**长期成功信号**：症状趋势递减（H 系列收尾时分析）；递增 = H 系列失败信号。
+
+## 失败回滚 4 档
+
+| 档位 | 现象 | 处置 |
+|---|---|---|
+| 轻 | 个别 hook fail，不影响产线 | 在 hanis-main 上 fix commit；记 self-symptoms |
+| 中 | vNext smoke fail 但能修 | hotfix worktree from hanis-main，1 天内 fix；超时升级 |
+| 重 | 产线撞挂 | `git revert <Hx-merge-commit>`；下游 H 必须 rebase；Nature 单签 |
+| 最坏 | 连续 2 H 重 broken 回滚 | H 系列暂停 1 周，Nature 评估拓扑或拆 H |
+
+## 与现行产线共存灰度（已收尾期间维护参考）
+
+H 系列已 9/9 全闭，但维护期改动仍受灰度规则约束：
+- 改 hook → 跑现行 vNext smoke（K 系列 sandbox + boattosea Gate）
+- inbox 新路径不冲突 vNext，但 PostToolUse Write hook 只在 inbox 路径加
+- ownership.yaml / MEMORY.md 重组前必须 backup
+- state 文件健康指标 = 只读盘点，不删活的 state
+
+## 与其他规则的关系
+
+- **ADR-038 D11**: schema-level 隔离 100% > prompt-level 70%（H2/H9 frontmatter 设计依据）
+- **ADR-041 v1.0**: 调字不加机制（H4 prompt 治理 vs H 系列其他机制层的边界依据）
+- **ADR-042 D3/D4/D9**: anti-compact 接口（H2/H6 抗 compact 接口签字依据）
+- **`feedback_record_preexisting_failures`**: pre-existing 失败 / guard 漂移登记不阻塞，但必须记录
+
+## 例外申请
+
+H 系列 9 站已收尾。新议题原则上**不加 H10+**，走业务 PLAN-XXX 自然消化。
+
+例外申请条件（罕见）：
+1. 该议题不能由任何业务 PLAN 承载（必须是 hanis 元层）
+2. Nature 单签
+3. 沿 9 站现有 ADR/PLAN 修订路径走，不开新 H 编号

package/src/bollharness/.boll/rules/repo-structure.md

@@ -0,0 +1,42 @@
+---
+paths:
+  - "{{PROJECT_NAME}}/**"
+  - "src/**"
+  - "lib/**"
+---
+
+# {{PROJECT_NAME}} Repository Structure (Template)
+
+> 这份 rule 是仓库结构的"认知地图"，让 agent 在第一次接触仓库时快速理解目录布局，避免盲目 Glob 扫描。
+
+## 如何使用
+
+1. 替换 `{{PROJECT_NAME}}`、`{{DOMAIN}}` 为你项目的真实名称
+2. 下表是骨架示例，填入你项目的实际目录
+3. 每条注释回答 "这个目录放什么 / 什么不应该放在这里"
+
+## 目录布局
+
+```
+{{PROJECT_NAME}}/
+├── .boll/              # Claude Code 配置 (settings.json + rules/ + skills/ + agents/)
+├── .boll/         # bollharness runtime 数据 (metrics/proposals/guard/tasks)
+├── src/scripts/
+│   ├── hooks/            # PreToolUse/PostToolUse 等 hook 实做 (stdlib only)
+│   ├── checks/           # 结构化 check 脚本 (INV-* guard, fragment integrity, etc.)
+│   ├── ci/               # CI 专用扫描器
+│   └── lib/              # 共享 lib (sanitize_patterns, claim_patterns, ...)
+├── src/ or {{PROJECT_NAME}}/      # 业务代码入口
+├── tests/                         # 测试
+├── docs/
+│   ├── decisions/        # ADR / PLAN / TECH 决策文档
+│   ├── issues/           # Guardian issue (ADR-030 closure semantics)
+│   └── architecture/     # 架构图与核心概念
+└── CLAUDE.md             # 项目根入口, 声明不可妥协约束 + path-scoped rules 触发表
+```
+
+## 禁止事项
+
+- `src/scripts/hooks/` 内禁止 `import requests` / 非 stdlib 依赖（hook 必须 runtime 零依赖）
+- `.boll/` 子目录的 runtime content 不能进 git（`.gitignore` 负向模式保留 `.gitkeep` sentinel）
+- 不允许在多个地方硬编码 "physical_files=N"——唯一源是 `src/scripts/ci/count-components.sh`

package/src/bollharness/.boll/rules/review-agent-isolation.md

@@ -0,0 +1,73 @@
+# 审查 Agent 工具隔离规则
+
+**来源**: ADR-038 D11 + OpenDev arXiv 2603.05344
+**适用范围**: 所有 review / audit / evaluator / gate-keeper 类 subagent
+**强制等级**: 不可降级（hard rule）
+
+## 核心规则
+
+**一句话**：审查类 agent 的工具白名单必须 schema-level 隔离写权限，prompt 约束不算数。
+
+## 为什么
+
+- **Prompt 约束**（"不要修改文件"）：经验上约 70% 遵从率
+- **Schema 隔离**（frontmatter 不列 Edit/Write）：100% 遵从率（物理上无法调用）
+- 写权限误用造成的 silent corruption 比可见错误更难恢复
+
+## 实施清单
+
+### 1. 本地 review agent — frontmatter 强制
+
+```yaml
+---
+name: my-reviewer
+tools:
+  - Read
+  - Glob
+  - Grep
+  - WebFetch
+  # 不列 Edit/Write/Bash → 物理隔离
+---
+```
+
+参考实现：`.boll/agents/review-readonly.md`
+共享白名单：`.boll/agents/review-base.yaml`
+
+### 2. 插件 review agent — spawn-boundary gate（PreToolUse Task hook）
+
+我们无法改第三方插件的 frontmatter，但可以在 CC spawn subagent 之前的 `PreToolUse Task` hook 拦截：
+
+1. 检查 subagent_type 是否在 review/audit 列表（配置见 `.boll/review-agents.yaml`）
+2. 检查调用 prompt 是否包含 read-only directive
+3. 缺失 → exit 2 硬阻断 spawn
+4. 通过 → 写 marker 文件到 `.boll/active-review-agents/`，allow
+
+参考实现：`src/scripts/hooks/review-agent-gatekeeper.ts`
+
+### 3. Stop hook Evaluator — 设计上零工具
+
+`src/scripts/hooks/stop-evaluator.md` 是 hook 注入的检查清单 prompt，不是 subagent。它本身没有工具调用能力，符合 D11 精神。
+
+## 违规检测
+
+每次 PR 检查时（手动 / Gate 审查 / 自动化）：
+
+1. 扫描 `.boll/agents/*.md` 中所有 frontmatter 含"review|audit|evaluator|gate"的 agent
+2. 检查它们的 `tools:` 字段是否包含 Edit / Write / Bash / NotebookEdit
+3. 如有，要求文档化 deviation 理由（写在 agent.md 顶部）
+
+## D11.2 Spawn-Boundary Gate 工作原理
+
+**为什么不直接禁止 review agent 调用 Edit/Write？** — 因为 CC PreToolUse 的 stdin payload 不直接告诉 hook "这个工具调用来自哪个 subagent"。我们无法在 Edit/Write 时刻准确判断调用方是 review agent 还是 main agent。
+
+**chokepoint 在 `Task` tool**：当 main agent 调用 `Task(subagent_type=<reviewer>)` 时，PreToolUse Task hook 在 spawn 发生之前拦截并强制 prompt 包含 read-only directive。
+
+**残余漏洞**：subagent 自身仍可能 ignore prompt 约束（~70% adherence）。但相比"完全靠调用方自觉"，这把约束从"希望"变成了"前置硬条件"。
+
+## 例外申请
+
+在极少数情况下，某个 review agent 可能需要 Bash（例如运行只读 git 命令）。这需要：
+
+1. 在 agent definition 顶部用注释说明 deviation 理由
+2. 在 PreToolUse hook 中加白名单匹配（参考 `bash_allowed_patterns` in review-base.yaml）
+3. 在 `docs/decisions/` 中记录例外 ADR

package/src/bollharness/.boll/rules/source-of-truth.md

@@ -0,0 +1,33 @@
+# Source of Truth
+
+> 这份 rule 告诉 agent 哪些文件是"事实源"，不允许凭记忆或 LLM 自己推断；必须先 Read 或 Grep 再做判断。
+
+## Layout 真相源
+
+| 主题 | 真相文件 |
+|------|---------|
+| Harness 组件清单 (hooks/checks/rules/skills) | `.boll/MANIFEST.yaml` |
+| PreToolUse / PostToolUse matcher 注册 | `.boll/settings.json` |
+| Annex A.1 五类脱敏分类 | `src/scripts/lib/sanitize_patterns.ts` |
+| 三元 count (command_instances/unique_scripts/physical_files) | `src/scripts/ci/count-components.sh` 实时输出 |
+| rebaseline triggers | `.boll/MANIFEST.yaml` `rebaseline_triggers[]` |
+
+## 决策链真相源
+
+| 主题 | 真相文件 |
+|------|---------|
+| 开源治理与剥离边界 | `docs/decisions/ADR-043-wow-harness-open-sourcing.md`（fork 时已脱敏） |
+| Harness 优化决策链 | `docs/decisions/ADR-038-harness-optimization-v5.md` |
+| Codex 分流边界 | `docs/decisions/ADR-041-codex-integration.md` |
+| Guard signal 与 governance reload | `docs/decisions/ADR-030-guard-signal-and-governance-reload.md` |
+
+## 禁止行为
+
+- 禁止凭记忆声称"某个 hook 存在"——先 `grep src/scripts/hooks/` 或读 `MANIFEST.yaml`
+- 禁止在多个文件维护同一份数字（例如 hook 总数）——引用 `MANIFEST.yaml` 单一源
+- 禁止在 skill 或 rule 里硬编码 `.boll/` 路径——harness runtime dir 统一为 `.boll/`
+
+## 参见
+
+- `.boll/rules/closure-semantics.md` — Fixed 三层定义
+- `.boll/rules/review-agent-isolation.md` — review agent schema-level 工具隔离

package/src/bollharness/.boll/settings.json

@@ -0,0 +1,180 @@
+{
+  "attribution": {
+    "co_authored_by": false
+  },
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/guard-feedback.ts",
+            "timeout": 30
+          },
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/loop-detection.ts",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/risk-tracker.ts 2>/dev/null || true",
+            "timeout": 3
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/deploy-guard.ts",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "if": "Bash(npx ts-node *)",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/auto-ts-node.ts",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/tool-call-counter.ts 2>/dev/null || true",
+            "timeout": 3
+          }
+        ]
+      },
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/review-agent-gatekeeper.ts",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "matcher": "Read|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/sanitize-on-read.ts",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && bash scripts/hooks/precompact.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/session-start-reset-risk.ts",
+            "timeout": 3
+          },
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/session-start-magic-docs.ts",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/session-start-toolkit-reminder.ts",
+            "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/gate-judgment-inject.ts",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/stop-evaluator.ts",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/session-reflection.ts",
+            "timeout": 10
+          },
+          {
+            "type": "command",
+            "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",
+            "timeout": 30
+          },
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/deploy-progress-on-session-end.ts",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/failure-analyzer.ts",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PreGateTransition": [
+      {
+        "matcher": "*",
+        "hooks": []
+      }
+    ],
+    "PostGateTransition": [
+      {
+        "matcher": "0|3",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$(scripts/hooks/find-project-root.sh)\" && npx ts-node scripts/hooks/gate-transition-judgment.ts ${BOLL_GATE_TO} .",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}

package/src/bollharness/.boll/settings.json.template

@@ -0,0 +1,31 @@
+{
+  "_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.",
+
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write|NotebookEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$({{HOOK_ROOT}}/{{FIND_ROOT_SCRIPT}})\" && npx ts-node {{HOOK_ROOT}}/guard-feedback.ts"
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "cd \"$({{HOOK_ROOT}}/{{FIND_ROOT_SCRIPT}})\" && npx ts-node {{HOOK_ROOT}}/deploy-guard.ts"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [],
+    "Stop": [],
+    "PreCompact": [],
+    "SessionStart": [],
+    "SessionEnd": []
+  }
+}