npm - @bolloon/bolloon-agent - Versions diffs - 0.1.0 - Mend

@bolloon/bolloon-agent 0.1.0

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 (808) hide show

package/src/bollharness/docs/practice.html ADDED Viewed

@@ -0,0 +1,356 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<title>bollharness 在 boll 的实践</title>
+<style>
+  :root {
+    --bg: #fafaf7;
+    --card: #ffffff;
+    --ink: #1a1a1a;
+    --muted: #6b6b6b;
+    --line: #d8d8d4;
+    --rule: #e6e6e2;
+    --user: #fff4d6;       --user-bd: #d97706;
+    --work: #dceefb;       --work-bd: #1d4ed8;
+    --review: #fde2ea;     --review-bd: #be123c;
+    --v1: #dceefb;         --v1-bd: #1d4ed8;
+    --v2: #fff4d6;         --v2-bd: #d97706;
+    --v3: #d6f0d8;         --v3-bd: #15803d;
+  }
+  * { box-sizing: border-box; }
+  html, body {
+    margin: 0; padding: 0;
+    background: var(--bg); color: var(--ink);
+    font-family: -apple-system, BlinkMacSystemFont, "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
+    -webkit-font-smoothing: antialiased;
+    line-height: 1.55;
+  }
+  .page { max-width: 1180px; margin: 0 auto; padding: 56px 40px 96px; }
+  h1 { font-size: 30px; margin: 0 0 10px; letter-spacing: -0.5px; }
+  .lead { color: var(--muted); font-size: 14px; margin: 0 0 12px; }
+  .meta { color: #888; font-size: 12px; margin: 0 0 28px; }
+  h2 {
+    font-size: 20px; font-weight: 700;
+    margin: 56px 0 20px; padding-bottom: 10px;
+    border-bottom: 1px solid var(--rule);
+  }
+  h2 .num { color: #999; font-weight: 500; margin-right: 8px; }
+  /* ======= 图 1：横向 8 关流程 ======= */
+  .flow {
+    display: flex; align-items: stretch; gap: 6px;
+    flex-wrap: wrap;
+    padding: 8px 0 0;
+  }
+  .node {
+    flex: 1 1 0;
+    min-width: 116px;
+    background: var(--card);
+    border: 2px solid var(--line);
+    border-radius: 10px;
+    padding: 12px 12px 14px;
+    box-shadow: 0 1px 0 rgba(0,0,0,0.02);
+  }
+  .node .tag {
+    display: block; font-size: 10px; letter-spacing: 0.6px;
+    color: var(--muted); text-transform: uppercase; margin-bottom: 6px;
+    font-weight: 600;
+  }
+  .node .title { font-weight: 700; font-size: 14px; }
+  .node .body { color: #4a4a4a; font-size: 12px; margin-top: 6px; line-height: 1.5; }
+  .node.user   { background: var(--user);   border-color: var(--user-bd); }
+  .node.work   { background: var(--work);   border-color: var(--work-bd); }
+  .node.review { background: var(--review); border-color: var(--review-bd); }
+  .arrow {
+    display: flex; align-items: center; justify-content: center;
+    color: #b0b0b0; font-size: 16px; font-weight: 600; min-width: 14px;
+  }
+  .legend {
+    display: flex; gap: 24px; flex-wrap: wrap;
+    margin: 16px 0 0;
+    font-size: 12px; color: #555;
+  }
+  .dot {
+    display: inline-block; width: 10px; height: 10px;
+    border-radius: 50%; margin-right: 6px;
+    vertical-align: middle;
+    border: 2px solid;
+  }
+  .dot.user   { background: var(--user);   border-color: var(--user-bd); }
+  .dot.work   { background: var(--work);   border-color: var(--work-bd); }
+  .dot.review { background: var(--review); border-color: var(--review-bd); }
+  .footnote {
+    margin-top: 14px;
+    background: #f3f3ef;
+    border-left: 3px solid #999;
+    padding: 10px 14px;
+    color: #444; font-size: 13px;
+  }
+  .footnote strong { color: var(--ink); }
+  /* ======= 图 2：三层叠加 ======= */
+  .stack { display: flex; flex-direction: column; gap: 0; }
+  .layer {
+    border-radius: 12px;
+    padding: 22px 24px 24px;
+    border: 2px solid;
+  }
+  .layer .lname {
+    font-size: 11px; font-weight: 700; letter-spacing: 0.8px;
+    opacity: 0.7; text-transform: uppercase;
+  }
+  .layer .ltitle {
+    font-size: 18px; font-weight: 700;
+    margin: 6px 0 18px;
+  }
+  .lcomps { display: flex; gap: 12px; flex-wrap: wrap; }
+  .comp {
+    background: rgba(255,255,255,0.78);
+    border-radius: 8px;
+    padding: 12px 14px;
+    flex: 1 1 220px;
+    min-width: 220px;
+  }
+  .comp .ct { font-weight: 700; font-size: 14px; }
+  .comp .cd { color: #555; font-size: 12px; line-height: 1.55; margin-top: 4px; }
+  .layer.v1 { background: var(--v1); border-color: var(--v1-bd); }
+  .layer.v2 { background: var(--v2); border-color: var(--v2-bd); }
+  .layer.v3 { background: var(--v3); border-color: var(--v3-bd); }
+  .stackjoin {
+    text-align: center;
+    color: #777; font-size: 12px;
+    padding: 10px 0;
+    font-weight: 600;
+    letter-spacing: 0.5px;
+  }
+  /* ======= 速查表 ======= */
+  table {
+    width: 100%; border-collapse: collapse;
+    margin-top: 14px; font-size: 13px;
+    background: var(--card);
+    border: 1px solid var(--rule);
+    border-radius: 8px; overflow: hidden;
+  }
+  th, td { text-align: left; padding: 12px 14px; border-bottom: 1px solid var(--rule); vertical-align: top; }
+  th { background: #f3f3ef; font-size: 12px; color: var(--muted); font-weight: 700; letter-spacing: 0.3px; }
+  tr:last-child td { border-bottom: 0; }
+  td code, p code, .footnote code {
+    font-family: "SF Mono", Menlo, Consolas, monospace;
+    font-size: 12px;
+    background: #efeee8; padding: 2px 6px; border-radius: 4px;
+    color: #2d2d2d;
+  }
+  footer {
+    margin-top: 64px; padding-top: 22px;
+    border-top: 1px solid var(--rule);
+    color: var(--muted); font-size: 12px;
+    line-height: 1.7;
+  }
+  @media (max-width: 1024px) {
+    .node { flex: 1 1 140px; }
+  }
+</style>
+</head>
+<body>
+<div class="page">
+  <h1>bollharness 在 boll 的实践</h1>
+  <p class="lead">两张图 / 一份速查表 — harness 当前真实在跑的样子。</p>
+  <p class="meta">98 天 · 2058 commits · 76 万行 · 2100+ 测试 · 一个人 + AI 全自主交付</p>
+  <!-- ============ 图 1 ============ -->
+  <h2><span class="num">图 1</span>你说一句话，AI 自己干完 8 关</h2>
+  <div class="flow">
+    <div class="node user">
+      <span class="tag">起点</span>
+      <div class="title">你说</div>
+      <div class="body">「我要做 X」</div>
+    </div>
+    <div class="arrow">›</div>
+    <div class="node work">
+      <span class="tag">Gate 0</span>
+      <div class="title">lead 锁问题</div>
+      <div class="body">判定变更分类</div>
+    </div>
+    <div class="arrow">›</div>
+    <div class="node work">
+      <span class="tag">Gate 1</span>
+      <div class="title">arch 出架构</div>
+      <div class="body">列清消费方</div>
+    </div>
+    <div class="arrow">›</div>
+    <div class="node review">
+      <span class="tag">Gate 2</span>
+      <div class="title">独立审查 AI</div>
+      <div class="body">tools 不含<br/>Edit / Write</div>
+    </div>
+    <div class="arrow">›</div>
+    <div class="node review">
+      <span class="tag">Gate 3-4</span>
+      <div class="title">plan-lock</div>
+      <div class="body">冻结方案<br/>独立再审</div>
+    </div>
+    <div class="arrow">›</div>
+    <div class="node review">
+      <span class="tag">Gate 5-6</span>
+      <div class="title">task-arch 拆 WP</div>
+      <div class="body">独立审查<br/>接缝有 owner</div>
+    </div>
+    <div class="arrow">›</div>
+    <div class="node work">
+      <span class="tag">Gate 7</span>
+      <div class="title">harness-dev 写码</div>
+      <div class="body">边写边记日志</div>
+    </div>
+    <div class="arrow">›</div>
+    <div class="node review">
+      <span class="tag">Gate 8</span>
+      <div class="title">终审 + E2E</div>
+      <div class="body">通过才出 PR</div>
+    </div>
+    <div class="arrow">›</div>
+    <div class="node user">
+      <span class="tag">终点</span>
+      <div class="title">accept PR</div>
+    </div>
+  </div>
+  <div class="legend">
+    <span><span class="dot user"></span>你的输入 / 你的决策</span>
+    <span><span class="dot work"></span>AI 执行（lead / arch / dev 等）</span>
+    <span><span class="dot review"></span>独立审查 AI（无 Edit / Write 工具，物理上不能改代码）</span>
+  </div>
+  <div class="footnote">
+    <strong>红色那 4 关</strong>由全新独立的 AI 接手 — 不共享之前对话从头看，工具清单里物理移除 Edit / Write，<em>不是嘱咐它「请只看不改」，是它根本调不出这两个工具</em>。
+  </div>
+  <!-- ============ 图 2 ============ -->
+  <h2><span class="num">图 2</span>三层 harness — 每层在解决什么问题</h2>
+  <div class="stack">
+    <div class="layer v3">
+      <div class="lname">v3 · 自治层</div>
+      <div class="ltitle">解决：harness 自己跑出 bug 时谁来修 harness（修问题反而引入问题）</div>
+      <div class="lcomps">
+        <div class="comp">
+          <div class="ct">改 harness 时不许重现自己要修的症状</div>
+          <div class="cd">H0 元规约 6+1 条款 · 修过度 review 的 PR 不许过度 review · grep 反查 · Nature 单签</div>
+        </div>
+        <div class="comp">
+          <div class="ct">多窗口并行不靠人手当中转</div>
+          <div class="cd">H9 文件邮箱 · 子窗口写 markdown 消息 → 主窗口启动 hook 自动注入到 prompt · 5 个 hook 保证不丢/不重</div>
+        </div>
+        <div class="comp">
+          <div class="ct">同样的坑不踩第二次</div>
+          <div class="cd">H1 crystal-learn · 真实事故 → 提取成不变量 → 注入回执行层 skill · 8 条已落地</div>
+        </div>
+        <div class="comp">
+          <div class="ct">编号撞 / 记忆涨爆 / 状态文件漂移 / 文档脱节</div>
+          <div class="cd">H2-H8 · 身份段独立 · MEMORY 主索引 ≤200 行 · ADR-INDEX 自指过滤 · open issue ≤80 等硬指标</div>
+        </div>
+      </div>
+    </div>
+    <div class="stackjoin">↑ 当 v1+v2 自己跑出问题</div>
+    <div class="layer v2">
+      <div class="lname">v2 · 阶段化层</div>
+      <div class="ltitle">解决：AI 不知道当前在哪个阶段，工具权限一直全开</div>
+      <div class="lcomps">
+        <div class="comp">
+          <div class="ct">阶段切换自动收/放权</div>
+          <div class="cd">/mode plan → build → verify → release · plan 阶段 AI 只读不写 / build 阶段才解锁 Edit / verify 阶段强制看 evidence</div>
+        </div>
+        <div class="comp">
+          <div class="ct">审查标准写在契约里不在提示词里漂</div>
+          <div class="cd">review-contract.yaml 锁死「谁审什么 / 要什么证据 / 什么标准算通过」· verify-gate hook 在 Stop 时校验 evidence packet</div>
+        </div>
+      </div>
+    </div>
+    <div class="stackjoin">↑ 当 v1 还不够</div>
+    <div class="layer v1">
+      <div class="lname">v1 · 物理拦截层</div>
+      <div class="ltitle">解决：AI 写规则但不听规则（CLAUDE.md 遵从率仅 ~20%）</div>
+      <div class="lcomps">
+        <div class="comp">
+          <div class="ct">想做错事就在动作那一刻挡下</div>
+          <div class="cd">18 hooks · 想 rm -rf？想 push 到生产？想跳测试？想暗中改审查 AI？hook 直接 exit 2 物理阻断</div>
+        </div>
+        <div class="comp">
+          <div class="ct">把 AI 拆成各司其职的角色</div>
+          <div class="cd">16 skills · lead 锁问题不写代码 / arch 出方案不实现 / dev 实现不审查 / reviewer 物理无写权 — 单 AI 干所有事必出错</div>
+        </div>
+        <div class="comp">
+          <div class="ct">不靠 AI 记规则，靠脚本自动验</div>
+          <div class="cd">15 checks · 撞 ADR 编号 / 引用错文件路径 / hook IO 不合规 — git pre-commit 拒提交，不靠人记</div>
+        </div>
+      </div>
+    </div>
+  </div>
+  <!-- ============ 速查表 ============ -->
+  <h2><span class="num">附</span>想直接看实现，打开这几个文件</h2>
+  <table>
+    <thead>
+      <tr><th style="width: 30%">你想看</th><th>打开这个</th></tr>
+    </thead>
+    <tbody>
+      <tr>
+        <td>审查 AI 物理上改不了代码</td>
+        <td><code>.boll/plugins/boll-review-toolkit/agents/reviewer.md</code><br/>
+          看顶上 <code>tools:</code> 列表 — 没有 Edit / Write / Bash</td>
+      </tr>
+      <tr>
+        <td>ADR 编号撞了 git 直接拒绝提交</td>
+        <td><code>.githooks/pre-commit</code>（22 行 shell）<br/>
+          + <code>scripts/checks/check_adr_plan_numbering.ts</code></td>
+      </tr>
+      <tr>
+        <td>AI 之间怎么传消息（H9 邮箱）</td>
+        <td><code>.boll/inbox/schema/message-v1.json</code><br/>
+          + 5 个 inbox hook（write-ledger / validate / inject-on-start / poll / ack）</td>
+      </tr>
+      <tr>
+        <td>16 个 skill 怎么分工</td>
+        <td><code>.boll/skills/</code> — 每个子目录一个 SKILL.md</td>
+      </tr>
+      <tr>
+        <td>所有 hook IO schema</td>
+        <td><code>scripts/hooks/_hook_output.ts</code> — 16 个 helper API（ADR-058 §D1）</td>
+      </tr>
+    </tbody>
+  </table>
+  <footer>
+    本地双击 <code>practice.html</code> 用浏览器打开 / 也可以投到大屏。<br/>
+    所有图块用纯 HTML+CSS 画 — 不依赖 mermaid / 不依赖 markdown viewer / 不依赖网络。
+  </footer>
+</div>
+</body>
+</html>

package/src/bollharness/docs/practice.md ADDED Viewed

@@ -0,0 +1,82 @@
+# bollharness 在 boll 的实践
+> **本地展示**：双击打开 [`docs/practice.html`](./practice.html)（浅色主题，纯 HTML+CSS，不依赖任何渲染引擎）。
+> 下面是同一份内容的 GitHub 在线版本（Mermaid 渲染）。
+98 天 / 2058 commits / 76 万行 / 2100+ 测试 — 一个人 + AI 全自主交付。
+两张图是 harness 当前真实在跑的样子。
+---
+## 图 1 · 你说一句话，AI 自己干完 8 关
+```mermaid
+flowchart LR
+    U[你说<br/>我要做 X]:::user --> G0
+    G0[Gate 0<br/>lead 锁问题]:::work --> G1
+    G1[Gate 1<br/>arch 出架构]:::work --> G2
+    G2[Gate 2<br/>独立审查 AI<br/>无 Edit/Write]:::review --> G34
+    G34[Gate 3-4<br/>plan-lock 冻结<br/>独立审查]:::review --> G56
+    G56[Gate 5-6<br/>task-arch 拆 WP<br/>独立审查]:::review --> G7
+    G7[Gate 7<br/>harness-dev 写代码<br/>边写边记日志]:::work --> G8
+    G8[Gate 8<br/>终审 + E2E]:::review --> PR
+    PR[accept PR]:::user
+    classDef user fill:#fff4d6,stroke:#d97706,color:#000
+    classDef work fill:#dceefb,stroke:#1d4ed8,color:#000
+    classDef review fill:#fde2ea,stroke:#be123c,color:#000
+```
+- 黄色 = 你的输入 / 你的决策
+- 蓝色 = AI 执行（lead / arch / dev）
+- 红色 = 独立审查 AI — 不共享之前对话从头看；tools 列表里物理移除 Edit / Write，**不是嘱咐它「只看不改」，是它根本调不出这两个工具**
+---
+## 图 2 · 三层 harness — 每层在解决什么问题
+```mermaid
+flowchart TB
+    subgraph V3[v3 · 自治层 · 解决 harness 自己跑出 bug 时谁来修 harness]
+        H0[改 harness 时<br/>不许重现自己要修的症状<br/>H0 元规约]
+        H9[多窗口并行<br/>不靠人手当中转<br/>H9 文件邮箱]
+        H1[同样的坑<br/>不踩第二次<br/>H1 crystal-learn]
+        Hx[编号撞/记忆涨爆<br/>状态漂移/文档脱节<br/>H2-H8 硬指标]
+    end
+    subgraph V2[v2 · 阶段化层 · 解决 AI 不知道当前在哪个阶段，工具权限一直全开]
+        Mode[阶段切换<br/>自动收/放权<br/>mode-toolkit]
+        Review[审查标准写在契约里<br/>不在提示词里漂<br/>review-toolkit]
+    end
+    subgraph V1[v1 · 物理拦截层 · 解决 AI 写规则但不听规则 CLAUDE.md 遵从率仅 20%]
+        Hooks[想做错事<br/>就在动作那一刻挡下<br/>18 hooks]
+        Skills[把 AI 拆成<br/>各司其职的角色<br/>16 skills]
+        Checks[不靠 AI 记规则<br/>靠脚本自动验<br/>15 checks]
+    end
+    V1 ==当 v1 还不够==> V2 ==当 v1+v2 自己跑出问题==> V3
+    classDef v1 fill:#dceefb,stroke:#1d4ed8,color:#000
+    classDef v2 fill:#fff4d6,stroke:#d97706,color:#000
+    classDef v3 fill:#d6f0d8,stroke:#15803d,color:#000
+    class Hooks,Skills,Checks v1
+    class Mode,Review v2
+    class H0,H9,H1,Hx v3
+```
+每层都在答一个问题：「上一层不够用的时候补什么」。
+- **v1 解决** AI 写规则但不听规则（CLAUDE.md 遵从率仅 ~20%）→ 用 hook 物理拦截
+- **v2 解决** AI 工具权限一直全开 → 用阶段机自动收/放权
+- **v3 解决** harness 自己跑出 bug → 9 站自治协议（修问题不在自己交付物里重现该问题等）
+**v3 一直闭合不再开新站，本身就是稳态信号。**
+---
+## 想直接看实现的话
+| 你想看 | 打开这个 |
+|---|---|
+| 审查 AI 物理上改不了代码 | [`.boll/plugins/boll-review-toolkit/agents/reviewer.md`](../.boll/plugins/boll-review-toolkit/agents/reviewer.md) — 看顶上 `tools:` 列表 |
+| ADR 编号撞了 git 直接拒绝提交 | [`.githooks/pre-commit`](../.githooks/pre-commit)（22 行 shell）+ [`scripts/checks/check_adr_plan_numbering.ts`](../scripts/checks/check_adr_plan_numbering.ts) |
+| AI 之间怎么传消息（H9 邮箱） | [`.boll/inbox/schema/message-v1.json`](../.boll/inbox/schema/message-v1.json) + 5 个 inbox hook |
+| 16 个 skill 怎么分工 | [`.boll/skills/`](../.boll/skills/) |
+| 所有 hook IO schema | [`scripts/hooks/_hook_output.ts`](../scripts/hooks/_hook_output.ts) — 16 个 helper API（ADR-058） |

package/src/bollharness/docs/research/round-1/README.md ADDED Viewed

@@ -0,0 +1,11 @@
+# Round 1 — placeholder
+This directory is reserved for WP-9b deliverables:
+- 52 天 AI Harness 交付长文 (round 1-6 research narrative)
+- 7-class failure taxonomy report (round-1/failure-taxonomy.md)
+See `docs/decisions/ADR-001-genesis.md` §13.1/§13.2 (WP-9b scope)
+and `PLAN-086` §4.phase_B for production context.
+Status: skeleton only. Content is produced by WP-9b, not WP-08.

package/src/bollharness/docs/research/round-2/README.md ADDED Viewed

@@ -0,0 +1,11 @@
+# Round 2 — placeholder
+This directory is reserved for WP-9b deliverables:
+- 52 天 AI Harness 交付长文 (round 1-6 research narrative)
+- 7-class failure taxonomy report (round-2/failure-taxonomy.md)
+See `docs/decisions/ADR-001-genesis.md` §13.1/§13.2 (WP-9b scope)
+and `PLAN-086` §4.phase_B for production context.
+Status: skeleton only. Content is produced by WP-9b, not WP-08.

package/src/bollharness/docs/research/round-3/README.md ADDED Viewed

@@ -0,0 +1,11 @@
+# Round 3 — placeholder
+This directory is reserved for WP-9b deliverables:
+- 52 天 AI Harness 交付长文 (round 1-6 research narrative)
+- 7-class failure taxonomy report (round-3/failure-taxonomy.md)
+See `docs/decisions/ADR-001-genesis.md` §13.1/§13.2 (WP-9b scope)
+and `PLAN-086` §4.phase_B for production context.
+Status: skeleton only. Content is produced by WP-9b, not WP-08.

package/src/bollharness/docs/research/round-4/README.md ADDED Viewed

@@ -0,0 +1,11 @@
+# Round 4 — placeholder
+This directory is reserved for WP-9b deliverables:
+- 52 天 AI Harness 交付长文 (round 1-6 research narrative)
+- 7-class failure taxonomy report (round-4/failure-taxonomy.md)
+See `docs/decisions/ADR-001-genesis.md` §13.1/§13.2 (WP-9b scope)
+and `PLAN-086` §4.phase_B for production context.
+Status: skeleton only. Content is produced by WP-9b, not WP-08.

package/src/bollharness/docs/research/round-5/README.md ADDED Viewed

@@ -0,0 +1,11 @@
+# Round 5 — placeholder
+This directory is reserved for WP-9b deliverables:
+- 52 天 AI Harness 交付长文 (round 1-6 research narrative)
+- 7-class failure taxonomy report (round-5/failure-taxonomy.md)
+See `docs/decisions/ADR-001-genesis.md` §13.1/§13.2 (WP-9b scope)
+and `PLAN-086` §4.phase_B for production context.
+Status: skeleton only. Content is produced by WP-9b, not WP-08.

package/src/bollharness/docs/research/round-6/README.md ADDED Viewed

@@ -0,0 +1,11 @@
+# Round 6 — placeholder
+This directory is reserved for WP-9b deliverables:
+- 52 天 AI Harness 交付长文 (round 1-6 research narrative)
+- 7-class failure taxonomy report (round-6/failure-taxonomy.md)
+See `docs/decisions/ADR-001-genesis.md` §13.1/§13.2 (WP-9b scope)
+and `PLAN-086` §4.phase_B for production context.
+Status: skeleton only. Content is produced by WP-9b, not WP-08.

package/src/bollharness/package-lock.json ADDED Viewed

@@ -0,0 +1,48 @@
+{
+  "name": "bollharness",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "bollharness",
+      "version": "1.0.0",
+      "license": "MIT",
+      "devDependencies": {
+        "@types/node": "^20.0.0",
+        "typescript": "^5.3.0"
+      }
+    },
+    "node_modules/@types/node": {
+      "version": "20.19.41",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.41.tgz",
+      "integrity": "sha512-ECymXOukMnOoVkC2bb1Vc/w/836DXncOg5m8Xj1RH7xSHZJWNYY6Zh7EH477vcnD5egKNNfy2RpNOmuChhFPgQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.21.0"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.9.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "dev": true,
+      "license": "MIT"
+    }
+  }
+}

package/src/bollharness/package.json ADDED Viewed

@@ -0,0 +1,20 @@
+{
+  "name": "bollharness",
+  "version": "1.0.0",
+  "description": "AI Agent Session Governance Framework - TypeScript implementation",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": ["claude-code", "agent-governance", "hooks"],
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  }
+}

package/src/bollharness/reference/SOURCE-COMMIT.txt ADDED Viewed

@@ -0,0 +1,3 @@
+# README
+This directory is for reference purposes - it contains a snapshot from the Towow project for historical reference.