geneseed 4.25.1 → 4.27.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 (97) hide show
  1. package/CHANGELOG.md +43 -0
  2. package/DESIGN.md +6 -5
  3. package/README.md +10 -6
  4. package/SHIPPED.md +4 -3
  5. package/adapters/bob/README.md +26 -4
  6. package/adapters/claude-code/README.md +6 -2
  7. package/adapters/claude-code/skills/geneseed/SKILL.md +2 -2
  8. package/adapters/opencode/HOW-OPENCODE-LOADS.md +4 -2
  9. package/adapters/opencode/README.md +5 -2
  10. package/adapters/opencode/plugins/geneseed-activity.js +331 -31
  11. package/adapters/opencode/plugins/geneseed-guard.js +79 -4
  12. package/bin/geneseed-hook.mjs +13 -7
  13. package/docs/concepts/enforcement-table.md +12 -0
  14. package/docs/concepts/exclusions.md +15 -1
  15. package/docs/concepts/hook-gates.md +3 -2
  16. package/docs/concepts/hooks.md +12 -1
  17. package/docs/concepts/host-matrix.md +2 -2
  18. package/docs/concepts/ownership.md +79 -0
  19. package/docs/concepts/rules.md +1 -1
  20. package/docs/guides/set-up-ownership.md +77 -0
  21. package/docs/reference/glossary.md +1 -1
  22. package/docs/reference/opencode-plugins.md +1 -1
  23. package/docs/reference/plugin-activity.md +4 -2
  24. package/docs/reference/plugin-guard.md +1 -0
  25. package/docs/reference/troubleshoot-doctor.md +2 -2
  26. package/docs/understand/enforced-vs-asked.md +3 -2
  27. package/docs/understand/machine-bob.md +1 -1
  28. package/docs/understand/machine-claude.md +1 -1
  29. package/docs/understand/machine-opencode.md +2 -2
  30. package/docs/web-ui.md +21 -2
  31. package/harness.config.json +1 -1
  32. package/js/README.md +1 -0
  33. package/js/build/render.mjs +1 -1
  34. package/js/build/source.mjs +5 -1
  35. package/js/cli-table.json +46 -1
  36. package/js/hosts/activity.mjs +175 -30
  37. package/js/hosts/hooks-prims.mjs +2 -2
  38. package/js/hosts/hooks.mjs +45 -5
  39. package/js/hosts/ownership-gate.mjs +105 -0
  40. package/js/hosts/settings.mjs +14 -4
  41. package/js/inspect/cost.mjs +1 -1
  42. package/js/inspect/inventory.mjs +1 -1
  43. package/js/inspect/status.mjs +1 -1
  44. package/js/loop/registry.mjs +17 -0
  45. package/js/web/activity.mjs +116 -5
  46. package/package.json +1 -1
  47. package/registry.json +7 -0
  48. package/src/AGENT.md.tmpl +5 -0
  49. package/src/agents/developer.md +7 -1
  50. package/src/modes/foreman.md +4 -1
  51. package/src/ontology/universal.md +19 -0
  52. package/src/skills/_checkpoints.md +15 -0
  53. package/src/skills/develop.md +4 -0
  54. package/src/skills/document-project.md +2 -1
  55. package/src/skills/learn-mode.md +13 -17
  56. package/src/skills/ownership.md +139 -0
  57. package/src/skills/pipeline.md +1 -1
  58. package/themes/README.md +2 -2
  59. package/themes/_TEMPLATE.json +1 -0
  60. package/themes/biker.json +1 -0
  61. package/themes/commentator.json +1 -0
  62. package/themes/cyberpunk.json +1 -0
  63. package/themes/gamer.json +1 -0
  64. package/themes/imperial.json +1 -0
  65. package/themes/joker.json +1 -0
  66. package/themes/marvin.json +1 -0
  67. package/themes/mean.json +1 -0
  68. package/themes/military.json +1 -0
  69. package/themes/neutral.json +1 -0
  70. package/themes/pirate.json +1 -0
  71. package/themes/sports.json +1 -0
  72. package/themes/verstappen.json +1 -0
  73. package/themes/wizard.json +1 -0
  74. package/web/dist/assets/Activity-DfETiyWm.js +1 -0
  75. package/web/dist/assets/ActivityDetail-CnP3GPAN.js +1 -0
  76. package/web/dist/assets/Bonsai-CN4rRAHc.js +1 -0
  77. package/web/dist/assets/{CopyButton-B6myFV7a.js → CopyButton-CRAUXSG7.js} +1 -1
  78. package/web/dist/assets/{Dashboard-DEQCBcUW.js → Dashboard-CaqOqtkG.js} +2 -2
  79. package/web/dist/assets/Docs-BFxyAVdN.js +5 -0
  80. package/web/dist/assets/{GreenhouseView-CV1squu6.js → GreenhouseView-19roNb5W.js} +1 -1
  81. package/web/dist/assets/{Installs-C4TQVZ_-.js → Installs-BSoQN7w7.js} +3 -3
  82. package/web/dist/assets/{JournalView-CpXsT_JD.js → JournalView-BgU2ybaq.js} +1 -1
  83. package/web/dist/assets/{KitApply-fYh_YjQA.js → KitApply-Ckc0P5kt.js} +1 -1
  84. package/web/dist/assets/{Kits-BMuGOiTg.js → Kits-BZqWGWMu.js} +1 -1
  85. package/web/dist/assets/Laws-CnUWiNIx.js +3 -0
  86. package/web/dist/assets/{Library-DiZqRFL5.js → Library-rYO8owx_.js} +2 -2
  87. package/web/dist/assets/{Loops-DkwWkdPc.js → Loops-CljFhhQV.js} +2 -2
  88. package/web/dist/assets/{OperatorHudView-CLmq0lNh.js → OperatorHudView-xs7SCwCe.js} +1 -1
  89. package/web/dist/assets/{Personal-C70XacpA.js → Personal-CMPwtl36.js} +2 -2
  90. package/web/dist/assets/{Tabs-ChFhPGP6.js → Tabs-CEfSUVQp.js} +1 -1
  91. package/web/dist/assets/{index-DxCqnFPy.js → index-FLVXXvV3.js} +2 -2
  92. package/web/dist/assets/{index-Cqqs-PbJ.css → index-XTGBLKQr.css} +1 -1
  93. package/web/dist/index.html +2 -2
  94. package/web/dist/assets/Activity-BdMwEnFN.js +0 -1
  95. package/web/dist/assets/ActivityDetail-BgUjDuxO.js +0 -1
  96. package/web/dist/assets/Docs-ChBYcQbT.js +0 -5
  97. package/web/dist/assets/Laws-ndHW7Onu.js +0 -3
package/CHANGELOG.md CHANGED
@@ -8,6 +8,49 @@ label. For the capability ↔ spec map, see [SHIPPED.md](SHIPPED.md).
8
8
 
9
9
  ## [Unreleased]
10
10
 
11
+ ## [4.27.0] — 2026-10-27
12
+
13
+ Minor: ownership — the developer decides each part of production code, at a granularity the team sets in the root `AGENTS.md`; a Credo section, the ownership skill, and a first-write gate that is on by default (see the ⚠️ entry). Re-emit every install with `geneseed rebuild-all` to get the new Credo section, the skill, the `develop`/`developer`/Foreman changes and the OpenCode guard.
14
+
15
+ - ⚠️ **Behaviour change on update: the ownership first-write gate.** In an application repo (a
16
+ git root holding `package.json`, `pom.xml`, `build.gradle*`, `pyproject.toml`, `go.mod`,
17
+ `Cargo.toml`, `*.csproj`, `composer.json` or `Gemfile`) whose root `AGENTS.md` has no
18
+ `## Ownership` section, the first Write, Edit or NotebookEdit of each session is now refused
19
+ once, with a reason that tells the agent to propose the ownership setup to the developer.
20
+ The next write passes. Claude Code, OpenClaude and Bob get the hook with the update itself (`git pull` or the npm package), with no re-emit
21
+ (Claude and OpenClaude: `permissionDecision: "deny"`, which shows the reason to the model;
22
+ Bob: exit 2). OpenCode V1
23
+ and V2 get it with the guard plugin on the next emit. Run `geneseed rebuild-all` straight
24
+ after updating: the refusal points at the ownership skill, which only a re-emit installs.
25
+ Shell writes are not gated, nor sub-agent writes on Claude Code, OpenClaude and OpenCode. To opt out: per repo, add `## Ownership` with `mode: off` to the root `AGENTS.md`;
26
+ per install, rebuild with `--no-ownership-gate`; per session, answer "proceed without".
27
+ See [Ownership](docs/concepts/ownership.md).
28
+
29
+ ### Changed
30
+ - **Activity opens on the Garden.** The live sessions show as bonsai by default; the `List | Garden` switch shows the cards, and the list is kept in the link as `v=list`. An older link carrying `v=garden` still opens the Garden.
31
+ - **The Credo gains an Ownership section, and learn-mode may propose.** A fifth always-on section, between Decisions and Conduct: the code belongs to whoever will answer for it, and work is handed over only when the developer can say what changed, where and why. learn-mode may now propose a solution, but never applies one it has not explained.
32
+ - **learn-mode's checkpoint rules move into a shared include.** The state-file, `Pending`, cadence and "no code without an answer" rules now live in `skills/_checkpoints.md`, which learn-mode includes and the ownership Rite shares. learn-mode keeps every rule it had; they now read as one "Checkpoint rules" section.
33
+ - **develop, the developer Adept and Foreman honour ownership.** In an ownership repo, develop runs each slice through the ownership checkpoints (unless learn-mode is active); Foreman delegates only once the plan is approved inline, and its brief carries the approved decisions; the developer writes only what those decisions cover, returns `blocked: decision needed` on any other choice, and hands back the diff for final review.
34
+
35
+ ### Added
36
+ - **The ownership Rite.** In an application whose root `AGENTS.md` has a `## Ownership` section with `mode: on`, the developer decides each part at the granularity the team sets (`feature`, `file` or `function`); interfaces and sensitive zones are always a checkpoint. Routine steps are announced, not asked, and the native diff is the approval. Its setup extracts the conventions, asks about five questions and writes the section. One line in `AGENT.md` points to it; learn-mode still comes first.
37
+ - **Ownership docs.** A concept page ([Ownership](docs/concepts/ownership.md)): the section format, granularity, the first-write gate, the opt-outs and how it differs from learn-mode; a guide ([Set up ownership](docs/guides/set-up-ownership.md)); and the gate in every page that lists the hook gates.
38
+
39
+ ## [4.26.0] — 2026-10-26
40
+
41
+ Minor: Activity's Garden — every live session as a pixel bonsai, fed by richer activity snapshots on every host (where files are, who changed them, sub-agents, turns, context, compactions), plus OpenCode files and the host filter fixed.
42
+
43
+ ### Added
44
+ - **A session's detail page shows its bonsai.** The same pixel tree as the Garden, with hoverable pads listing each author's files and a legend of turns, context, compactions and sub-agents — for a live session and for an ended one, which is drawn as it was, without motion or bubbles.
45
+ - **Activity has a Garden view.** A `List | Garden` switch shows every live session as a pixel bonsai (Canopy style, with a Sakura palette toggle): one shelf per repo, one tree per session. The pot is coloured by host. The tree grows with the prompt count and its crown with the context fill (yellow tips past 80 %), and is pruned flat at each compaction before it grows back. A running sub-agent is a branch with its own pad, tinted by agent type; a finished one leaves a pruned stub and a fallen leaf. Each changed file is a blossom on its author's pad; hover lists the paths. `!` means the session waits for you, `x` an error. A red thread joins two sessions on the same file in one worktree, an amber one across two worktrees. Past ten trees, quiet shelves fold into chips.
46
+ - **Activity records more of each session (Claude Code, OpenClaude, IBM Bob).** Each changed file now keeps its path relative to the session's git root (never absolute; a file outside the repo keeps only its name) and who changed it: the session or one of its sub-agents. Snapshots also carry the sub-agents (a new `SubagentStart` hook on Claude Code and OpenClaude shows one the moment it starts), the git root and main repo, the prompt count, the context size, and the compactions. Bob's sub-agents show, but Bob's hooks do not say which one changed a file.
47
+ - **Activity records OpenCode sub-agents and more of each session.** A child session (a `task` sub-agent) is no longer skipped: it shows as a sub-agent of its parent, and the files it changes are credited to it. Each file keeps its path relative to the repo (never absolute), and the snapshot carries the git root and main repo, the prompt count, the context size and the compactions. On OpenCode 2, changed files now show too, without line counts.
48
+ - **Activity's API serves the garden's data.** Each live session now also carries its git root and main repo (with a case-folded `repo_key` to group them), sub-agents, prompt count, context size, compactions, its uncapped changed files (`files_all`) and the loops running in its worktree. A new top-level `collisions` lists every file two writers changed among the live sessions: same worktree, or two worktrees of one repo. The loop join reads the registry without writing it, so a page view still never writes a file.
49
+
50
+ ### Fixed
51
+ - **OpenCode sessions show their changed files on Activity.** OpenCode 1.x never fills the session summary's diffs; the per-turn diffs sit on the user message (`message.updated`), and a zeroed summary on every step wiped the list. Files now fold from each turn (a repeat of the same turn replaces it, a new turn adds), `session.diff` stays the fallback for 1.3, and an `/undo` (`message.removed`) drops the undone turn.
52
+ - **Activity's host filter lists the hosts again.** The reader dropped each session's `host`, so the filter had no options; an OpenCode plugin snapshot, which carries no host, now reads as `opencode`.
53
+
11
54
  ## [4.25.1] — 2026-10-25
12
55
 
13
56
  Patch: Activity, session detail and Doctor use the full width.
package/DESIGN.md CHANGED
@@ -31,8 +31,8 @@ vault or a specific tool's hooks.
31
31
  3. **Theme is voice + vocabulary; the scaffolding is theme-independent.** A single
32
32
  neutral source renders to any theme via token substitution, split into two classes:
33
33
  - **Structure** (always plain English, every theme, every emit) — the section
34
- *layout*, the harness name (`HARNESS`), the law *numbers*, the four ontology section
35
- names (`ONT_TELOS`, `ONT_EVIDENCE`, `ONT_DECISIONS`, `ONT_CONDUCT`), a few rare
34
+ *layout*, the harness name (`HARNESS`), the law *numbers*, the five ontology section
35
+ names (`ONT_TELOS`, `ONT_EVIDENCE`, `ONT_DECISIONS`, `ONT_OWNERSHIP`, `ONT_CONDUCT`), a few rare
36
36
  technical nouns (`Context`, `Scripts`, `Charter`), and the folder names (`laws/`,
37
37
  `ontology/`, `doctrines/`, `agents/`, `skills/`, `memory/`, `notebook/` via `DIR_*`).
38
38
  These live in the `STRUCTURE` map in `js/build/render.mjs` and are laid on top of every
@@ -92,10 +92,11 @@ vault or a specific tool's hooks.
92
92
  the rules that matter. The governance surface is split into three tiers, each answering
93
93
  a different question:
94
94
 
95
- - **Ontology** (`src/ontology/universal.md`) — *who is deciding*. Four sections of
95
+ - **Ontology** (`src/ontology/universal.md`) — *who is deciding*. Five sections of
96
96
  flowing prose: **Telos** (what the agent is for, and the Pact it works under),
97
97
  **Evidence** (how a claim is graded by how it was obtained), **Decisions** (classify
98
- and tier by reversibility; show the real forks), **Conduct** (answer what was asked,
98
+ and tier by reversibility; show the real forks), **Ownership** (the code belongs to
99
+ whoever answers for it; hand work over only once it is understood), **Conduct** (answer what was asked,
99
100
  once). It absorbed the Pact, which is now stated *inside* Telos rather than standing
100
101
  as a peer of the rules.
101
102
  - **Invariants** (`src/laws/universal.md`) — *what is never traded*. Nine Rules, `I`..`IX`,
@@ -187,7 +188,7 @@ theme file defines a `DIR_*` key, so `laws/` is `laws/` in all fourteen voices.
187
188
  | Component | Source | `Harness/` output | Purpose |
188
189
  | --- | --- | --- | --- |
189
190
  | Entrypoint | `src/AGENT.md.tmpl` | `AGENT.md` | what the tool reads; inlines the constitution, links the rest |
190
- | Ontology | `src/ontology/` | `ontology/` | the mind the rules govern — Telos, Evidence, Decisions, Conduct; always on, never toggleable |
191
+ | Ontology | `src/ontology/` | `ontology/` | the mind the rules govern — Telos, Evidence, Decisions, Ownership, Conduct; always on, never toggleable |
191
192
  | Governance | `src/laws/` | `laws/` | the nine universal invariants; always on, never toggleable |
192
193
  | Doctrines | `src/doctrines/` | `doctrines/` | the four practice packs — the one build-time axis that changes *which rules ship*; the whole catalogue is written to disk either way |
193
194
  | Delegation | `src/agents/` | `agents/` | capability specialists with output contracts |
package/README.md CHANGED
@@ -11,7 +11,7 @@
11
11
  [![Node >= 22.7](https://img.shields.io/badge/node-%3E%3D22.7-5fa04e)](package.json)
12
12
  [![zero dependencies](https://img.shields.io/badge/deps-zero-success)](package.json)
13
13
  [![Themes](https://img.shields.io/badge/themes-14-9cf)](themes/)
14
- [![Skills](https://img.shields.io/badge/skills-47-blueviolet)](src/skills/)
14
+ [![Skills](https://img.shields.io/badge/skills-48-blueviolet)](src/skills/)
15
15
  [![Agents](https://img.shields.io/badge/agents-20-orange)](src/agents/)
16
16
  [![Laws and doctrines](https://img.shields.io/badge/laws-9%20%2B%2031%20doctrines-critical)](src/doctrines/)
17
17
  [![Plugins](https://img.shields.io/badge/plugins-7-teal)](adapters/opencode/plugins/)
@@ -62,7 +62,7 @@ The lineage is also why an **imperial** theme ships alongside the neutral one: i
62
62
 
63
63
  ### How it works
64
64
 
65
- One canonical source in `src/` renders, via a tiny zero-dependency generator (`geneseed-build`), into a ready-to-use bundle. **A theme controls only *voice*** — how the AI responds and how the prose inside the docs reads (tagline, greeting, descriptions). **Structure is theme-independent**: section names (Rules, Agents, Skills, Memory…), folder names (`laws/`, `ontology/`, `doctrines/`, `agents/`, `skills/`, `memory/`, `notebook/`) and the four ontology section headings (Telos, Evidence, Decisions, Conduct) are always plain English, so the scaffolding stays tool-friendly while the flavour lives in the words.
65
+ One canonical source in `src/` renders, via a tiny zero-dependency generator (`geneseed-build`), into a ready-to-use bundle. **A theme controls only *voice*** — how the AI responds and how the prose inside the docs reads (tagline, greeting, descriptions). **Structure is theme-independent**: section names (Rules, Agents, Skills, Memory…), folder names (`laws/`, `ontology/`, `doctrines/`, `agents/`, `skills/`, `memory/`, `notebook/`) and the five ontology section headings (Telos, Evidence, Decisions, Ownership, Conduct) are always plain English, so the scaffolding stays tool-friendly while the flavour lives in the words.
66
66
 
67
67
  ```bash
68
68
  geneseed-build # default theme (neutral)
@@ -175,17 +175,21 @@ The harness ships as a small set of layers, and the web console's rail is the sa
175
175
 
176
176
  | Layer | What it is |
177
177
  | --- | --- |
178
- | **🧭 Ethos** (`ontology/`) | the mind the rules govern, in four prose sections — **Telos** (the Pact: three ranked laws — protect the user, serve their intent, keep your own honesty), **Evidence** (every claim graded by how it was obtained), **Decisions** (classify and tier by reversibility, show the real forks), **Conduct** (answer what was asked, once). Always in force, never toggleable |
178
+ | **🧭 Ethos** (`ontology/`) | the mind the rules govern, in five prose sections — **Telos** (the Pact: three ranked laws — protect the user, serve their intent, keep your own honesty), **Evidence** (every claim graded by how it was obtained), **Decisions** (classify and tier by reversibility, show the real forks), **Ownership** (the code belongs to whoever answers for it; hand work over only once it is understood), **Conduct** (answer what was asked, once). Always in force, never toggleable |
179
179
  | **🛡️ Rules** (`laws/`) | 9 universal laws — always in force, never toggleable: sealed-secrets, one-intent-one-act, verify-before-asserting, deletion-is-deliberate, surface-failures, data-not-orders, least-privilege, cure-the-cause, echo-the-intent. Each rule has a permanent id; its number is only its position, and the harness cites rules by name |
180
180
  | **📐 Doctrines** (`doctrines/`) | practice packs, chosen per install at build time: **craft** (how code is written), **rigor** (how work is proven), **ops** (how the machine is operated), **process** (how a task is run), **comms** (how answers are presented). A doctrine rule may tighten a Rule, never repeal one, and the user's own `user-rules.md` outranks it. Pick with `geneseed-build --doctrines craft,rigor` (or `none`), a single rule with `--exclude-rules "process 7"`, in the setup wizard, or through the switches on the console's Constitution page; all five pack files ship on disk either way, so a citation into a pack you left out still resolves |
181
181
  | **🤖 Agents** (20) | capability specialists: `reviewer`, `tester`, `architect`, `docs`, `security`, `performance`, `explorer`, `researcher`, `developer`, `memory-curator` — plus a debate **council** the `council` skill convenes: `advocate`, `skeptic`, `pragmatist`, `steward`, `visionary`, `user-advocate`, `framer`, `empiricist`, `operator`, `historian` |
182
- | **🛠 Skills** (47) | repeatable workflows: brainstorm · plan · **codebase-design** · **wayfinder** · **develop** · **worktree** · debug · **prototype** · refactor · **ponytail** · **forge-mcp** · **bruno** · geneseed-code-review · **fresh-eyes** · **security-audit** · **dependencies** · **review-response** · commit · **ship** · **release** · **git-history** · document-project · **frontend-design** · **deck** · **prose** · **ingest** · **research** · **teach** · **quiz** · **learn-mode** · handoff · roast-me · **council** · parallel-agents · **workflow** · **wiki** · **geneseed** · **rule** · **profile** · **skill-forge** · **pipeline** · **loop** · **brick-forge** · **daydream** · **react-view-transitions** · **token-report** · **explain-changes** |
182
+ | **🛠 Skills** (48) | repeatable workflows: brainstorm · plan · **codebase-design** · **wayfinder** · **develop** · **worktree** · debug · **prototype** · refactor · **ponytail** · **forge-mcp** · **bruno** · geneseed-code-review · **fresh-eyes** · **security-audit** · **dependencies** · **review-response** · commit · **ship** · **release** · **git-history** · document-project · **frontend-design** · **deck** · **prose** · **ingest** · **research** · **teach** · **quiz** · **learn-mode** · **ownership** · handoff · roast-me · **council** · parallel-agents · **workflow** · **wiki** · **geneseed** · **rule** · **profile** · **skill-forge** · **pipeline** · **loop** · **brick-forge** · **daydream** · **react-view-transitions** · **token-report** · **explain-changes** |
183
183
  | **🔌 Plugins** (OpenCode) | `geneseed-context` injects project docs *and your machine wiki* every session (and across compaction); `geneseed-learn` distils memory at session end; `geneseed-guard` enforces the safety Laws and protected wiki folders at the tool boundary; `geneseed-workflow` registers the `workflow` tool that runs saved orchestration scripts; `geneseed-notify` sends a native OS notification when a long run finishes; `geneseed-ponytail` holds a minimal-code mode (`/ponytail lite\|full\|ultra\|off`), opt-in, injecting the laziest-that-works ruleset every turn so it doesn't drift; `geneseed-activity` streams what each session is doing to the web console's Activity view |
184
184
  | **🧠 Memory** (`memory/`) | one-fact-per-file durable knowledge, indexed by `MEMORY.md` (git-ignored, personal) |
185
185
  | **📓 Notebook** (`notebook/`) | the agent's sovereign space — any medium (code, tools, data, notes), self-ruled via a seed-once charter, always git-ignored; only its `.gitignore` is build-asserted |
186
186
  | **🌐 Wiki** (`geneseed-wiki.jsonc`) | your own machine-wide knowledge base — typically an Obsidian vault — declared once per machine: entry notes load eager/lazy, the agent reads and **writes** it under the vault's own conventions, with an inbox fallback and guard-enforced protected folders |
187
187
  | **🧭 Context** | the project's own docs — auto-discovered on OpenCode, or via a `context.json` manifest |
188
188
 
189
+ ### 🧑‍💻 Ownership of production code
190
+
191
+ In an application built for production, the developer stays the owner of the code. A committed `## Ownership` section in the repo's root `AGENTS.md` sets how closely the team steers — per feature, per file or per function — and names the sensitive zones; the agent then proposes, explains the complex parts and writes only what the developer approved, while interfaces and sensitive zones are always a checkpoint. Before the first write in an application repo with no such section, a hook stops the agent once so it proposes the setup. Opt a repo out with `mode: off`, an install with `--no-ownership-gate`, or a session by answering "proceed without"; learn-mode, when a developer turns it on, always drives the workflow (the hook still stops the first write once). See [Ownership](docs/concepts/ownership.md) and [Set up ownership](docs/guides/set-up-ownership.md).
192
+
189
193
  ### 🤝 What the harness asks of you
190
194
 
191
195
  The Pact in the Ethos is mutual. The agent's side is written into every install. Yours is not enforced — it is what keeps the pact honest, and only you can give it:
@@ -278,7 +282,7 @@ Geneseed/
278
282
  ├── harness.config.json default theme + metadata (the one owner of the version)
279
283
  ├── src/ canonical source — edit here
280
284
  │ ├── AGENT.md.tmpl the entrypoint, rendered to AGENT.md
281
- │ ├── ontology/ how the agent thinks — Telos, Evidence, Decisions, Conduct
285
+ │ ├── ontology/ how the agent thinks — Telos, Evidence, Decisions, Ownership, Conduct
282
286
  │ ├── laws/ the universal invariants
283
287
  │ ├── doctrines/ the five practice packs (craft, rigor, ops, process, comms)
284
288
  │ ├── postures/ the relationship register, inlined into AGENT.md
@@ -377,7 +381,7 @@ Some skills and agents are adapted from other open-source skill collections, und
377
381
  - `mattpocock-skills-frozen` — [mattpocock/skills](https://github.com/mattpocock/skills) by Matt Pocock (MIT), pinned at 391a2701, the last commit carrying `resolving-merge-conflicts` (deleted upstream since): the merge-conflict step of git-history, from a skill upstream has since deleted, so the weekly drift check skips it.
378
382
  - `mattpocock-skills-2509` — [mattpocock/skills](https://github.com/mattpocock/skills) by Matt Pocock (MIT), a second key for the same repo, at the same pin as `mattpocock-skills` today (5beb35b0): the PR body of ship and the guardrail clause of rule.
379
383
  - `superpowers` — [obra/superpowers](https://github.com/obra/superpowers) by Jesse Vincent (MIT): the core of debug, the size step and builder check of brainstorm, the plan rules of plan, the reviewer brief behind geneseed-code-review and the reviewer agent, the review-handling steps of review-response, and the ruling format of pipeline and parallel-agents.
380
- - `vibe-wise` — [nykooi1/vibe-wise](https://github.com/nykooi1/vibe-wise) by Noah Kim (MIT): the state file, levels and checkpoints of learn-mode.
384
+ - `vibe-wise` — [nykooi1/vibe-wise](https://github.com/nykooi1/vibe-wise) by Noah Kim (MIT): the state file, levels and checkpoints of learn-mode, and the checkpoint rules ownership shares.
381
385
  - `piomin-spring-boot` — [piomin/claude-ai-spring-boot](https://github.com/piomin/claude-ai-spring-boot) by Piotr Mińkowski (Apache-2.0): the Spring Boot kit's skills and agents, rewritten and condensed for Boot 4.
382
386
  - `everything-claude-code` — [affaan-m/everything-claude-code](https://github.com/affaan-m/everything-claude-code) by Affaan Mustafa (MIT): the React kit's skills and agents, rewritten and condensed for Vite and Jest.
383
387
 
package/SHIPPED.md CHANGED
@@ -20,7 +20,7 @@ historical references, not files distributed with the repo.
20
20
  > **On version numbers.** [`harness.config.json`](harness.config.json)'s `version` is a
21
21
  > human-readable label only. The canonical identity of an installed harness is the
22
22
  > **source fingerprint** stamped in `.geneseed-version` (see `geneseed version`), not the
23
- > string. Current label: **4.25.1**.
23
+ > string. Current label: **4.27.0**.
24
24
 
25
25
  ## Capabilities
26
26
 
@@ -29,8 +29,8 @@ Every row below is present in the tree today; "Spec" names the design record.
29
29
  | Capability | What it is | Spec |
30
30
  | --- | --- | --- |
31
31
  | **Themed generator** | One neutral `src/` → 14 themed bundles via `geneseed-build` (zero dependencies); structure stays theme-independent | [DESIGN.md](DESIGN.md) |
32
- | **Laws / Agents / Skills / Memory / Notebook** | 9 laws, 20 agents, 47 skills, the memory convention, and the agent's sovereign notebook | `2026-06-11-notebook-sovereign-space` · `2026-06-10-notebook-agent-own-space` |
33
- | **Three-tier constitution** | The governance surface splits into an always-on **Ontology** (Telos, Evidence, Decisions, Conduct — the Pact absorbed into Telos), the nine always-on **Invariants**, and five toggleable **Doctrine** packs (craft, rigor, ops, process, comms) addressed `<pack> <n>`. Every rule carries a permanent id; its number is its position, computed at render time, and a citation renders as the rule's principle name. Packs are chosen at build time with `--doctrines` or the setup wizard; the whole catalogue ships on disk either way, so a citation into an inactive pack still resolves. Precedence, in order: Ontology + Invariants, then the user's `user-rules.md`, then the active Doctrines, then `PROFILE.md`. `doctor`'s `constitutionProblems` gates rule ids (declared, unique, never a retired one), the per-rule Principle column, every `{{LAW:<id>}}` / `{{DOCTRINE:<id>}}` citation in `src/`, and the rule that an always-on tier may never cite a toggleable one | `2026-08-19-three-tier-constitution-design` |
32
+ | **Laws / Agents / Skills / Memory / Notebook** | 9 laws, 20 agents, 48 skills, the memory convention, and the agent's sovereign notebook | `2026-06-11-notebook-sovereign-space` · `2026-06-10-notebook-agent-own-space` |
33
+ | **Three-tier constitution** | The governance surface splits into an always-on **Ontology** (Telos, Evidence, Decisions, Ownership, Conduct — the Pact absorbed into Telos), the nine always-on **Invariants**, and five toggleable **Doctrine** packs (craft, rigor, ops, process, comms) addressed `<pack> <n>`. Every rule carries a permanent id; its number is its position, computed at render time, and a citation renders as the rule's principle name. Packs are chosen at build time with `--doctrines` or the setup wizard; the whole catalogue ships on disk either way, so a citation into an inactive pack still resolves. Precedence, in order: Ontology + Invariants, then the user's `user-rules.md`, then the active Doctrines, then `PROFILE.md`. `doctor`'s `constitutionProblems` gates rule ids (declared, unique, never a retired one), the per-rule Principle column, every `{{LAW:<id>}}` / `{{DOCTRINE:<id>}}` citation in `src/`, and the rule that an always-on tier may never cite a toggleable one | `2026-08-19-three-tier-constitution-design` |
34
34
  | **`doctor`** | One check: unresolved tokens, dead/non-hermetic links, theme-key parity, authoring gates, rendered-bundle drift | `2026-06-07-theme-aware-doctor-diff` |
35
35
  | **`diff` + improvements export** | Deployed-vs-source drift report; export an `improvements.md` back-port | `2026-06-12-improvements-export` |
36
36
  | **`status` / `version`** | Headless dashboard + fingerprint verdict (no TUI needed) | `2026-06-07-status-command` · `2026-06-07-version-and-uninstall` |
@@ -42,6 +42,7 @@ Every row below is present in the tree today; "Spec" names the design record.
42
42
  | **Per-agent memory** | Each capability agent keeps durable lessons in `memory/agents/<name>.md`: read at dispatch, written back mechanically by `learn` on session/subagent end (OpenCode plugin + Claude `SubagentStop`; Bob has no subagent event); `learn --consolidate` rebuilds the index | `2026-07-04-orchestration-memory-upgrade` |
43
43
  | **Wiki integration** | Machine-wide knowledge base (`geneseed-wiki.jsonc`): eager/lazy loading, conventions, protected folders enforced at the tool boundary | `2026-06-11-wiki-knowledge-base` |
44
44
  | **Collaboration layer** | Negotiated postures (peer/mentor/expert/assistant/artisan, chosen at setup, inlined in AGENT.md), the bidirectional Pact, epistemically-typed memory (`force:` + Bridge rule), and a seed-once `PROFILE.md` identity with a web editor tab and a `profile` skill that interviews the user to draft it | `2026-07-12-collaboration-layer` |
45
+ | **Ownership** | The developer keeps ownership of production code: a Credo section (the code belongs to whoever answers for it), the `ownership` skill (setup from the code and a short interview, `feature`/`file`/`function` granularity, interfaces and sensitive zones always a checkpoint, announce-don't-ask), a `## Ownership` section in the committed root `AGENTS.md` (`mode: on\|off`), and a first-write gate on every host that stops the session's first write once in an application repo without one. learn-mode always comes first; `develop`, the `developer` agent and Foreman hold the checkpoints. Off per repo (`mode: off`), per install (`--no-ownership-gate`), per session ("proceed without") | `2026-10-26-ownership` |
45
46
  | **Rule front door** | Both durable stores enter through the `rule` skill's fork (*standing rule, or fact to remember?* — always asked, never inferred): the memory branch elicits the binding `force` and shows the file before writing, the rule branch pressure-tests by reformulation and a mandatory counter-example. Doctrine process 1 carries the norm on every host; a `rule-gate` PreToolUse hook (Claude, Bob) and a `geneseed-guard` speed bump (OpenCode) hold it at the tool boundary | `2026-07-30-rule-front-door` |
46
47
  | **Entity registry** | `registry.json` records a lifecycle status, version, owner and add-date for every agent and skill in the tree (maintainer-side — never rendered into a bundle, so it costs no session context). `doctor` gates it against `src/` in both directions, sweeps everything that ships for credentials, and holds each vendored skill folder to an immutable upstream commit. The status surfaces as a badge in the web catalog, shown only where it deviates from `approved` | `2026-07-31-entity-registry` |
47
48
  | **Node runtime + npm package** | The whole harness runs from Node: every command `js/cli-table.json` declares, all five hook verbs, every web-console endpoint (the OS-native folder picker excepted, and declined on purpose) and both generators. Every commit runs the unit suite, `doctor --all` across every theme × host × footprint, and the generator's two self-comparisons, on Linux and Windows both; the frozen emit/cli/web recordings that also gated it retired on 2026-08-17 (see the 2.0.0 entry in [CHANGELOG.md](CHANGELOG.md)). It ships as the zero-dependency `geneseed` package (`geneseed`, `geneseed-hook`, `geneseed-build`), so `npx geneseed setup` needs no clone and nothing else installed; `geneseed migrate` moves an existing checkout install across. Node is the only runtime it asks for: the `token-report` skill's own script is `token_report.mjs`, gated over seeded transcripts for all four hosts, and `daydream` calls `node -e` | `2026-08-06-npx-distribution` |
@@ -95,14 +95,16 @@ names but **not Claude's protocol**, and the global file at the **nested**
95
95
  and the one way to refuse a call is **exit code 2**. Claude's `permissionDecision:
96
96
  "ask"` on stdout is therefore invisible to Bob — the groups earlier versions wrote were
97
97
  permissive on every call.
98
- - **`SubagentStop` and `PreCompact` are not Bob events**, so they are not written.
98
+ - **`SubagentStop` is not a Bob event**, so it is not written. Bob 2.2.3 does have
99
+ `PreCompact` and `PostCompact` (its bundle's event list and schema); Geneseed does not wire
100
+ them yet, so `learn` still runs on `Stop` only.
99
101
 
100
102
  What the global emit writes into `~/.bob/settings/settings.json`:
101
103
 
102
104
  | event | verb | how the verdict travels |
103
105
  | --- | --- | --- |
104
106
  | `SessionStart` | `context --host bob` | plain stdout, as on Claude |
105
- | `PreToolUse` | `tool-gate --host bob` — one group, no matcher | Laws I/IV, rigor-5 and ops-2: **exit 2**, reason on stderr — it says no chat confirmation lifts the block, since Bob has no ask tier; process 1/5: a stderr line, exit 0 |
107
+ | `PreToolUse` | `tool-gate --host bob` — one group, no matcher | Laws I/IV, rigor-5 and ops-2: **exit 2**, reason on stderr — it says no chat confirmation lifts the block, since Bob has no ask tier; process 1/5: a stderr line, exit 0; the ownership gate (the session's first write in an application repo with no `## Ownership` section in its root `AGENTS.md`): **exit 2 once**, the same write then passes — off with `--no-ownership-gate` or `mode: off` |
106
108
  | `Stop` | `learn` | never a verdict |
107
109
  | `UserPromptSubmit` | `activity --host bob` | never a verdict; records the turn for the web console's Activity view |
108
110
 
@@ -110,6 +112,25 @@ Every hook also feeds the Activity view after it decides (off with `GENESEED_ACT
110
112
  Bob sends no transcript, so a Bob session shows only the calls `tool-gate` sees; see
111
113
  `docs/reference/plugin-activity.md`.
112
114
 
115
+ **The payload Bob actually sends.** Bob 2.2.3's hook runner (read in its shipped bundle,
116
+ `resources/app/extensions/bob-code/dist/extension.js`) writes the payload to stdin and closes
117
+ it, for every event. The keys are Claude's: `hook_event_name`, `session_id` (the root task's
118
+ id), `cwd` (the root workspace, with a lower-case drive letter on Windows), and on tool events
119
+ `tool_name`, `tool_input` (the model's raw arguments) and `tool_use_id`. Older notes describe
120
+ `{event, session_id, tool, input, output}`; the activity writer reads both shapes.
121
+ - The edit tools are `write_file`, `apply_diff`, `insert_content` and `search_and_replace`,
122
+ each with a `path` that Bob resolves against the workspace and expands a leading `~` in. The
123
+ writer does the same, then stores the path relative to the git root.
124
+ - `spawn_subagent` and `start_subtask` run their own task, but its tool calls fire the
125
+ parent's hooks with the parent's `session_id` and no sub-agent id. Activity therefore shows
126
+ such a sub-agent as a branch with no id, which the next `Stop` closes, and marks the session
127
+ `attribution: false`: its files cannot be told from the parent's.
128
+ - After a compaction, Bob fires `SessionStart` with `source: "compact"`. The writer counts a
129
+ compaction there; any other Bob `SessionStart` is not recorded, because the first prompt's
130
+ `UserPromptSubmit` records the session right after it.
131
+ - Bob has no `SessionEnd`, `SubagentStart` or `SubagentStop`. Its settings schema is strict:
132
+ one unknown event key drops the whole hooks block, so none of those is ever written.
133
+
113
134
  No matcher on `PreToolUse`, deliberately: Bob's tools page already drifts from its own
114
135
  changelog (`web_fetch`, the 2.1.0 Office/IBM-docs tools are undocumented there), so an
115
136
  allow-list built from it would fail open on the next tool Bob adds, and a deny-list needs a
@@ -128,8 +149,9 @@ carries.
128
149
  `~/.bob/settings.json` (your own keys there are kept) and writes the new set to the
129
150
  nested file.
130
151
 
131
- **Unverified live.** There is no Bob install on the authoring machine; this is Bob's
132
- documented contract, with the payload field names assumed to be Claude's. If a field
152
+ **Partly verified.** The payload field names are Claude's: Bob 2.2.3's bundle shows them,
153
+ and a live Activity check on 2026-10-25 recorded a Bob session from them. The gates' own
154
+ verdicts are still Bob's documented contract. If a field
133
155
  name differs the gate defers rather than misfires, and the harness still holds through
134
156
  the `rules/geneseed.md` preamble — the same behaviour-contract parity every
135
157
  non-OpenCode host gets. `/hooks` in Bob Shell 2.0.2+ lists the hooks it loaded and
@@ -40,7 +40,11 @@ absolute-path hooks instead — `geneseed setup` does that for you.) It:
40
40
  - on **PreToolUse** (matcher `Write|Edit|NotebookEdit`), runs
41
41
  `geneseed-hook rule-gate` — refuses a write that would put a credential into a tracked
42
42
  file, and asks first on the first write to `user-rules.md` or a memory file (whether
43
- something you want kept is a rule or a fact is your call). Ordinary edits pass.
43
+ something you want kept is a rule or a fact is your call). In an application repo (a git
44
+ root holding a build manifest) whose root `AGENTS.md` has no `## Ownership` section, it also
45
+ denies the session's first write once, with a reason addressed to the agent: propose the
46
+ ownership setup, or proceed without; the next write passes, and sub-agents defer. Off per repo
47
+ with `mode: off` in that section, per install with `--no-ownership-gate`. Ordinary edits pass.
44
48
  (`MultiEdit` is not a Claude Code tool and is not in the matcher; the gate reads
45
49
  `edits[].new_string` as a cheap guard regardless.)
46
50
  - on **SessionStart**, every source (`startup`, `resume`, `clear`, `compact`, `fork`), runs
@@ -70,7 +74,7 @@ absolute-path hooks instead — `geneseed setup` does that for you.) It:
70
74
  and auto-compaction is the moment that window is about to be summarised away.
71
75
  This captures memory *before* the summary; the SessionStart `context` hook (which
72
76
  also fires on the `compact` source) re-seeds context *after* it.
73
- - on **UserPromptSubmit** and **SessionEnd**, runs `geneseed-hook activity`, which decides
77
+ - on **UserPromptSubmit**, **SessionEnd** and **SubagentStart**, runs `geneseed-hook activity`, which decides
74
78
  nothing and prints nothing: it records the session for the web console's Activity view.
75
79
  Every other hook above feeds that view too, after it has decided. `GENESEED_ACTIVITY=off`
76
80
  (or the console's toggle) turns it off; see `docs/reference/plugin-activity.md`.
@@ -21,7 +21,7 @@ If none resolve, the user does not have Geneseed deployed here — say so and st
21
21
 
22
22
  A live harness root contains: `AGENT.md`, `ontology/universal.md`, `laws/universal.md`, `doctrines/<pack>.md`, `agents/<name>.md`, `skills/<name>/SKILL.md`, `memory/MEMORY.md`, `notebook/NOTEBOOK.md`, `themes/`, and (on OpenCode) `plugins/`, `workflows/`, `opencode.jsonc`, `geneseed-wiki.jsonc`.
23
23
 
24
- The constitution is **three tiers**: an always-on **Ontology** (four prose sections — Telos, Evidence, Decisions, Conduct), nine always-on **Rules** numbered I–IX, and the **Doctrines** — practice packs (`craft`, `rigor`, `ops`, `process`, `comms`) chosen per install at build time. `AGENT.md` carries all three inline (whole at the `full` footprint, heading-plus-first-line at `lean`), *and* the complete text ships as files beside it. All five pack files ship even when a pack was not built in, so a citation into an inactive pack still resolves on disk — which is why a question about a rule is answered from the tier file, never only from `AGENT.md`.
24
+ The constitution is **three tiers**: an always-on **Ontology** (five prose sections — Telos, Evidence, Decisions, Ownership, Conduct), nine always-on **Rules** numbered I–IX, and the **Doctrines** — practice packs (`craft`, `rigor`, `ops`, `process`, `comms`) chosen per install at build time. `AGENT.md` carries all three inline (whole at the `full` footprint, heading-plus-first-line at `lean`), *and* the complete text ships as files beside it. All five pack files ship even when a pack was not built in, so a citation into an inactive pack still resolves on disk — which is why a question about a rule is answered from the tier file, never only from `AGENT.md`.
25
25
 
26
26
  ## Read-only verbs (safe, no confirmation needed)
27
27
 
@@ -34,7 +34,7 @@ The constitution is **three tiers**: an always-on **Ontology** (four prose secti
34
34
  - **Read a specific piece** — read the file directly:
35
35
  - Agent by name: `<harness>/agents/<name>.md`
36
36
  - Skill by name: `<harness>/skills/<name>/SKILL.md`
37
- - Ontology section by name: `<harness>/ontology/universal.md` — `#### Telos` / `Evidence` / `Decisions` / `Conduct` (theme-independent names)
37
+ - Ontology section by name: `<harness>/ontology/universal.md` — `#### Telos` / `Evidence` / `Decisions` / `Ownership` / `Conduct` (theme-independent names)
38
38
  - Rule by numeral I–IX: `<harness>/laws/universal.md` — heading `### <Rule-noun> <ROMAN> — <title>`
39
39
  - Doctrine rule by pack and number: `<harness>/doctrines/<pack>.md` — heading `### <Doctrine-noun> <pack> <n> — <title>`
40
40
  - Memory fact: `<harness>/memory/<file>.md`; index at `MEMORY.md`
@@ -92,7 +92,9 @@ changed for each plugin:
92
92
  | throwaway session + `prompt` to distil | `ctx.generate.text({ prompt, model })`: one stateless call |
93
93
  | a hook throws to block a tool | a throw is a **defect that fails the whole step**. The guard renames the call instead (see `geneseed-guard.js`) |
94
94
  | `@opencode-ai/plugin` `tool()` helper | `@opencode/plugin`; a plain JSON-schema `input` needs no helper |
95
- | `todo.updated`, session `summary` diffs | no V2 event. The activity cards show no todos or files on V2 |
95
+ | `todo.updated` | no V2 event. The activity cards show no todos on V2 |
96
+ | user-message `summary.diffs` (files touched) | `session.step.ended` / `step.failed` `files`: paths only, so the activity cards show files with no line counts, and a revert never removes one |
97
+ | `session.compacted` | `session.compaction.ended` |
96
98
  | tool part carries its name | `session.tool.called` has no name; it rides on `session.tool.input.started` |
97
99
  | tools `bash`, `apply_patch`, `task` | renamed `shell`, `patch`, `subagent` (the old ids are aliases). The guard's substring classes cover both spellings; its usage counter takes `subagent` (type under `agent`) beside `task`, since the hook sees the name before alias resolution |
98
100
 
@@ -125,7 +127,7 @@ to native **skills**, not slash commands (same `SKILL.md` shape as Claude Code).
125
127
  | plugin on `experimental.session.compacting` | **context plugin** — re-pushes the `eager` docs so they survive compaction |
126
128
  | plugin on `session.idle` | **learn plugin** — distils memory into `memory/` (debounced to fire once, at session end) |
127
129
  | plugin on `experimental.chat.messages.transform` (V1) | **context plugin** — also adds the done gate's reminder when a check in `.geneseed/done-checks.txt` has not passed since the last edit (Verify Before Asserting); OpenCode 2 turns are not judged |
128
- | plugin on `tool.execute.before` | **guard plugin** — blocks secret-file writes and credential-shaped write content (Sealed Secrets), writes to a protected check or the done list (External Gate), catastrophic shell and every other real data loss, judged against the repository's state (Deletion Is Deliberate), a recursive whole-filesystem scan (Commands Must Return), the first rule-store write (Persist Insight) and protected wiki folders; logs each block to the gate ledger and counts skill/subagent use (`GENESEED_GUARD=off\|warn`) |
130
+ | plugin on `tool.execute.before` | **guard plugin** — blocks secret-file writes and credential-shaped write content (Sealed Secrets), writes to a protected check or the done list (External Gate), catastrophic shell and every other real data loss, judged against the repository's state (Deletion Is Deliberate), a recursive whole-filesystem scan (Commands Must Return), the first rule-store write (Persist Insight), protected wiki folders, and the session's first write in an application repo with no `## Ownership` section in its root `AGENTS.md` (the ownership gate, once; a child session defers; off with `--no-ownership-gate`); logs each block to the gate ledger and counts skill/subagent use (`GENESEED_GUARD=off\|warn`) |
129
131
  | plugin registering a custom tool | **workflow plugin** — the `workflow` tool runs saved orchestration scripts from `workflows/` |
130
132
  | `context.json` / `.harness/` (manifest) | *optional* override when discovery doesn't fit |
131
133
 
@@ -386,10 +386,13 @@ behaviour** — nothing changes the machine's current agent/model unless you opt
386
386
  the safety Laws at the tool boundary: **blocks** writes to private-key/credential
387
387
  files (Sealed Secrets), catastrophic shell like `rm -rf /` and every command that would really lose data, judged
388
388
  against the repository's state (Deletion Is Deliberate), and any mutation under
389
- a declared wiki's `protected` folders (AGENT.md §8, from `geneseed-wiki.jsonc`); **warns** on
389
+ a declared wiki's `protected` folders (AGENT.md §8, from `geneseed-wiki.jsonc`); **refuses
390
+ once** the session's first write in an application repo whose root `AGENTS.md` has no
391
+ `## Ownership` section (the ownership gate; a child session defers; off with `mode: off` in
392
+ that section or an install built `--no-ownership-gate`); **warns** on
390
393
  `.env` writes. `GENESEED_GUARD=off` disables it, `=warn` downgrades
391
394
  blocks to warnings. Every **block** appends one line to the install's
392
- `notebook/gates.jsonl` (rule `law-1` / `law-4` / `process-1` / `wiki`, a timestamp,
395
+ `notebook/gates.jsonl` (rule `law-1` / `law-4` / `process-1` / `wiki` / `ownership`, a timestamp,
393
396
  never the path or command) — the same ledger the Claude-family hooks write, so
394
397
  `geneseed status` counts what the boundary caught on every host. Warnings are not
395
398
  recorded.