geneseed 5.3.1 → 5.5.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.
- package/CHANGELOG.md +102 -0
- package/README.md +51 -18
- package/SHIPPED.md +7 -7
- package/adapters/bob/README.md +12 -1
- package/adapters/opencode/README.md +5 -3
- package/adapters/opencode/plugins/geneseed-context.js +77 -10
- package/adapters/opencode/plugins/geneseed-guard.js +106 -22
- package/adapters/opencode/plugins/geneseed-learn.js +641 -6
- package/bin/geneseed-cli.mjs +10 -0
- package/bin/geneseed-hook.mjs +5 -4
- package/docs/PRD.md +1 -1
- package/docs/README.md +1 -0
- package/docs/concepts/agents.md +14 -2
- package/docs/concepts/collaboration.md +2 -2
- package/docs/concepts/enforcement-table.md +5 -2
- package/docs/concepts/exclusions.md +16 -2
- package/docs/concepts/footprint.md +1 -1
- package/docs/concepts/foreman-mode.md +23 -4
- package/docs/concepts/hook-gates.md +4 -4
- package/docs/concepts/hooks.md +25 -7
- package/docs/concepts/host-matrix.md +4 -4
- package/docs/concepts/hosts.md +1 -1
- package/docs/concepts/kits.md +12 -2
- package/docs/concepts/loop-bricks.md +3 -3
- package/docs/concepts/loops.md +6 -4
- package/docs/concepts/ownership.md +1 -1
- package/docs/concepts/rules.md +2 -2
- package/docs/concepts/shared-tier.md +1 -1
- package/docs/concepts/skills.md +21 -1
- package/docs/concepts/themes.md +1 -1
- package/docs/extending.md +73 -29
- package/docs/guides/auto-merge.md +100 -0
- package/docs/guides/choose-your-setup.md +1 -1
- package/docs/guides/headless.md +1 -1
- package/docs/guides/install-clone.md +19 -1
- package/docs/guides/install-scripted.md +8 -2
- package/docs/guides/install.md +20 -2
- package/docs/guides/loop-finish.md +3 -3
- package/docs/guides/loop-running.md +4 -4
- package/docs/guides/project-context.md +1 -1
- package/docs/guides/run-a-factory.md +2 -2
- package/docs/guides/setup-doctrines.md +2 -2
- package/docs/guides/setup-footprint.md +1 -1
- package/docs/guides/uninstall.md +3 -3
- package/docs/guides/upgrade.md +2 -2
- package/docs/guides/worktree.md +1 -1
- package/docs/reference/env-context.md +1 -1
- package/docs/reference/environment.md +4 -2
- package/docs/reference/plugin-activity.md +1 -1
- package/docs/reference/plugin-guard.md +1 -1
- package/docs/reference/plugin-learn.md +5 -1
- package/docs/reference/plugin-workflow.md +1 -1
- package/docs/reference/profiles.md +142 -0
- package/docs/reference/troubleshoot-doctor.md +1 -1
- package/docs/reference/troubleshoot-hooks.md +2 -2
- package/docs/reference/troubleshoot-install.md +3 -3
- package/docs/reference/troubleshoot-tools.md +1 -1
- package/docs/token-footprint.md +11 -6
- package/docs/understand/design-choices-engineering.md +1 -1
- package/docs/understand/enforced-vs-asked.md +1 -1
- package/docs/understand/machine-claude.md +2 -2
- package/docs/understand/on-your-machine.md +1 -1
- package/docs/web-ui.md +8 -6
- package/harness.config.json +1 -1
- package/js/README.md +11 -3
- package/js/build/args.mjs +16 -4
- package/js/build/catalog.mjs +11 -1
- package/js/build/driver.mjs +74 -16
- package/js/build/emit-claude.mjs +32 -5
- package/js/build/emit-opencode.mjs +16 -9
- package/js/build/export.mjs +1 -1
- package/js/build/generate.mjs +12 -157
- package/js/build/notes-migrate.mjs +99 -0
- package/js/build/profile.mjs +326 -0
- package/js/build/render.mjs +110 -8
- package/js/build/retired-skills.mjs +60 -13
- package/js/build/source.mjs +100 -3
- package/js/build/stubs.mjs +4 -1
- package/js/cli-table.json +212 -7
- package/js/hosts/agent-runs.mjs +205 -0
- package/js/hosts/done-checks.mjs +3 -1
- package/js/hosts/hooks-done.mjs +428 -63
- package/js/hosts/hooks-learn.mjs +89 -3
- package/js/hosts/hooks-prims.mjs +44 -4
- package/js/hosts/hooks.mjs +159 -9
- package/js/hosts/hosts.mjs +10 -0
- package/js/hosts/installs.mjs +44 -2
- package/js/hosts/link.mjs +45 -10
- package/js/hosts/native.mjs +61 -7
- package/js/hosts/opencode.mjs +1 -1
- package/js/hosts/settings.mjs +101 -3
- package/js/hosts/spec-feedback.mjs +538 -0
- package/js/hosts/usage.mjs +67 -8
- package/js/inspect/agent-scores.mjs +118 -0
- package/js/inspect/checks-authoring.mjs +2 -1
- package/js/inspect/checks-build.mjs +20 -4
- package/js/inspect/checks-constitution.mjs +32 -0
- package/js/inspect/checks-repo.mjs +27 -2
- package/js/inspect/cost.mjs +6 -5
- package/js/inspect/diff.mjs +46 -8
- package/js/inspect/doctor.mjs +4 -0
- package/js/inspect/inventory.mjs +1 -1
- package/js/inspect/status.mjs +3 -1
- package/js/inspect/validate.mjs +1 -0
- package/js/lib/machine-dir.mjs +8 -0
- package/js/lib/paths.mjs +4 -1
- package/js/maintain/profile-scope.mjs +145 -0
- package/js/maintain/profiles.mjs +486 -0
- package/js/maintain/setup.mjs +413 -15
- package/js/maintain/uninstall.mjs +4 -1
- package/js/maintain/update.mjs +4 -2
- package/js/web/actions.mjs +44 -41
- package/js/web/api.mjs +13 -3
- package/js/web/handler.mjs +8 -0
- package/js/web/jobs.mjs +5 -4
- package/js/web/profiles-api.mjs +201 -0
- package/js/web/routes.mjs +5 -0
- package/package.json +2 -1
- package/profiles/guillaume-claude-global.json +16 -0
- package/profiles/starter.json +14 -0
- package/registry.json +14 -0
- package/src/AGENT.md.tmpl +16 -18
- package/src/agents/_self-improvement.md +15 -7
- package/src/agents/_template.md +4 -2
- package/src/agents/advocate.md +1 -1
- package/src/agents/architect.md +1 -1
- package/src/agents/developer.md +10 -3
- package/src/agents/devops-engineer.md +1 -1
- package/src/agents/docker-expert.md +1 -1
- package/src/agents/docs.md +1 -1
- package/src/agents/empiricist.md +1 -1
- package/src/agents/explorer.md +4 -2
- package/src/agents/framer.md +1 -1
- package/src/agents/historian.md +1 -1
- package/src/agents/kubernetes-specialist.md +1 -1
- package/src/agents/memory-curator.md +1 -1
- package/src/agents/operator.md +1 -1
- package/src/agents/performance.md +1 -1
- package/src/agents/pragmatist.md +1 -1
- package/src/agents/react-engineer.md +1 -1
- package/src/agents/react-reviewer.md +1 -1
- package/src/agents/researcher.md +1 -1
- package/src/agents/reviewer.md +10 -3
- package/src/agents/security.md +1 -1
- package/src/agents/skeptic.md +1 -1
- package/src/agents/spring-boot-engineer.md +1 -1
- package/src/agents/spring-reviewer.md +1 -1
- package/src/agents/spring-security.md +1 -1
- package/src/agents/steward.md +1 -1
- package/src/agents/tester.md +4 -2
- package/src/agents/user-advocate.md +1 -1
- package/src/agents/visionary.md +1 -1
- package/src/bricks/pr-open.md +3 -2
- package/src/doctrines/ops.md +2 -2
- package/src/doctrines/process.md +40 -36
- package/src/factories/analysis-to-build.json +1 -1
- package/src/factories/bug-report-to-fix.json +1 -1
- package/src/factories/issue-to-pr.json +1 -1
- package/src/kits/terminal-tools/rules.md +10 -0
- package/src/kits/terminal-tools.json +13 -0
- package/src/licenses/herdr.txt +201 -0
- package/src/memory/README.md +12 -2
- package/src/modes/foreman.md +25 -9
- package/src/skill-descriptions.json +63 -0
- package/src/skills/_self-improvement.md +42 -24
- package/src/skills/_template.md +3 -1
- package/src/skills/brainstorm.md +35 -22
- package/src/skills/commit.md +17 -17
- package/src/skills/daydream/VENDOR.md +6 -0
- package/src/skills/debug/ci.md +1 -1
- package/src/skills/dependencies.md +3 -3
- package/src/skills/diagram-design/VENDOR.md +4 -0
- package/src/skills/document-project.md +3 -2
- package/src/skills/explain-changes/VENDOR.md +5 -1
- package/src/skills/factory.md +13 -4
- package/src/skills/geneseed.md +4 -2
- package/src/skills/git-history.md +5 -7
- package/src/skills/herdr.md +135 -0
- package/src/skills/loop.md +3 -2
- package/src/skills/opencode-cli.md +84 -0
- package/src/skills/parallel-agents.md +11 -0
- package/src/skills/pipeline.md +3 -3
- package/src/skills/plan.md +5 -4
- package/src/skills/react-view-transitions/VENDOR.md +7 -1
- package/src/skills/release.md +11 -9
- package/src/skills/review-response.md +4 -2
- package/src/skills/rule/approve.md +2 -1
- package/src/skills/rule.md +27 -1
- package/src/skills/ship.md +54 -7
- package/src/skills/skill-forge.md +5 -3
- package/src/skills/token-report/VENDOR.md +5 -1
- package/src/skills/worktree.md +2 -2
- package/src/upstreams.json +9 -2
- package/themes/README.md +3 -1
- package/themes/_TEMPLATE.json +2 -0
- package/themes/biker.json +2 -0
- package/themes/commentator.json +2 -0
- package/themes/cyberpunk.json +2 -0
- package/themes/gamer.json +2 -0
- package/themes/imperial.json +2 -0
- package/themes/joker.json +2 -0
- package/themes/marvin.json +2 -0
- package/themes/mean.json +2 -0
- package/themes/military.json +2 -0
- package/themes/neutral.json +2 -0
- package/themes/pirate.json +2 -0
- package/themes/sports.json +2 -0
- package/themes/verstappen.json +2 -0
- package/themes/wizard.json +2 -0
- package/web/dist/assets/{ActiveLoops-BJJN3P-V.js → ActiveLoops-DOJCPPPc.js} +1 -1
- package/web/dist/assets/Activity-LKsDzsnK.js +1 -0
- package/web/dist/assets/ActivityDetail-DhwTfPm6.js +1 -0
- package/web/dist/assets/{Bonsai-BBl4XXqs.js → Bonsai-CePMLrpr.js} +1 -1
- package/web/dist/assets/{CopyButton-Beven8yn.js → CopyButton-CuoaJ6k7.js} +1 -1
- package/web/dist/assets/Dashboard-D1VKuvLe.js +2 -0
- package/web/dist/assets/Docs-CUrHJKaU.js +5 -0
- package/web/dist/assets/Factories-Ci1XfmSy.js +1 -0
- package/web/dist/assets/{GreenhouseView-Bce212qd.js → GreenhouseView-CNfH2lPK.js} +1 -1
- package/web/dist/assets/Installs-ZHQZM1iS.js +3 -0
- package/web/dist/assets/{JournalView-CV4omyww.js → JournalView-CMsWahkS.js} +1 -1
- package/web/dist/assets/Kits-CkliyK0n.js +1 -0
- package/web/dist/assets/Laws-hh4O3HZ4.js +4 -0
- package/web/dist/assets/{LibRows-Dag1s0ZX.js → LibRows-Brv0Hmkr.js} +1 -1
- package/web/dist/assets/Library-BYmiLjJr.js +3 -0
- package/web/dist/assets/Loops-ytm-xJ68.js +2 -0
- package/web/dist/assets/{OperatorHudView-JmYY1pBR.js → OperatorHudView-KaqCx_HP.js} +1 -1
- package/web/dist/assets/Personal-CmcnRKYE.js +2 -0
- package/web/dist/assets/Settings-tUrpdOfq.js +1 -0
- package/web/dist/assets/{Tabs-8zsyEPSK.js → Tabs-CD7etcGD.js} +1 -1
- package/web/dist/assets/api-CZ-x0iWG.js +1 -0
- package/web/dist/assets/{controls-D4wmg_pl.js → controls-CK7qHA8H.js} +1 -1
- package/web/dist/assets/{index-CRWqKxfY.css → index-Ba_Kg3Af.css} +1 -1
- package/web/dist/assets/index-COKbhFNo.js +6 -0
- package/web/dist/index.html +3 -3
- package/web/dist/assets/Activity-WQ3ykgxU.js +0 -1
- package/web/dist/assets/ActivityDetail-7rt04SkS.js +0 -1
- package/web/dist/assets/Dashboard-BgLArtgu.js +0 -2
- package/web/dist/assets/Docs-B5aHp86J.js +0 -5
- package/web/dist/assets/Factories-BjqzXAw8.js +0 -1
- package/web/dist/assets/Installs-B1OsrHXF.js +0 -3
- package/web/dist/assets/Kits-CW1e7xNa.js +0 -1
- package/web/dist/assets/Laws-1Ckf1lbs.js +0 -4
- package/web/dist/assets/Library-B3FuFLel.js +0 -3
- package/web/dist/assets/Loops-CwqgnLNw.js +0 -2
- package/web/dist/assets/Personal-DKLgLa7Z.js +0 -2
- package/web/dist/assets/Settings-BwErnh-R.js +0 -1
- package/web/dist/assets/api-DLDVY3K-.js +0 -1
- package/web/dist/assets/index-Ce6qF2nG.js +0 -6
package/CHANGELOG.md
CHANGED
|
@@ -8,6 +8,108 @@ label. For the capability ↔ spec map, see [SHIPPED.md](SHIPPED.md).
|
|
|
8
8
|
|
|
9
9
|
## [Unreleased]
|
|
10
10
|
|
|
11
|
+
## [5.5.0] — 2026-11-15
|
|
12
|
+
|
|
13
|
+
**Upgrade note.** The new behaviour reaches an install only when it is emitted again: `geneseed upgrade` (or `rebuild-all`) does it for every active install. An existing install reads as `--context-window 200k`, so on a machine whose model has a 1M-token window, rebuild it once with `--context-window 1m` or apply a profile that says `1m`. Project notes written by earlier versions move to `<project>/notebook/` on that rebuild, with no loss.
|
|
14
|
+
|
|
15
|
+
### Added
|
|
16
|
+
- **Feedback notes have a machine and a project scope.** A `spec-feedback:` line now picks where it goes by its tag, not by the install kind: `[agent]`, `[general]`, `[skill:<id>]` and `[skill:<id>:general]` go to the machine notes in the shared tier (`~/.config/geneseed/notes/`), for every host and install kind, because a defect of a spec is true in every repo; `[agent:project]`, `[general:project]`, `[skill:<id>:project]` and `[skill:<id>:general:project]` go to `<project>/notebook/{agent,skill}-notes/`, one folder for every host, for a fact true only in that repo. Step 0 of every agent and skill reads the machine notes, then the project notes, which win where they disagree. The project folders are kept out of git through a marked block in the clone's `.git/info/exclude`; no `.gitignore` is written into the project. On the next project emit, notes written by earlier versions in a host's own notebook (`.claude`, `.bob`, `.openclaude`, `.opencode`) merge into the project notebook as project notes, read back before the originals move to an archive beside them. An OpenClaude project install now reads its notes where it writes them.
|
|
17
|
+
- **Install profiles: a one-line install with no questions.** `.\install.cmd --profile starter` (Windows) or `./install --profile starter` (macOS, Linux) from a fresh clone installs the `starter` profile globally into every AI coding tool found on the machine, puts `geneseed` on `PATH`, sets the web console to start at login, starts it (or restarts it when it runs), runs the doctor and prints an ASCII summary with the console address. It needs no terminal. A failure on one tool does not stop the others; the run then exits 1. A second run is an update and a repair: it puts each setting back to the profile's value and names every setting it put back. On macOS and Linux it writes the PATH block into the shell's startup file without asking and names the file. Without `--profile`, `setup` and both install scripts are unchanged. See `docs/reference/profiles.md`.
|
|
18
|
+
- **`profiles/<name>.json`**, shipped in the package and the clone, checked against the generator's own value lists (an unknown key is an error) and by `geneseed doctor`. Two ship: `starter` (neutral, peer, direct, all packs, every gate armed except the ownership gate, all four tools) and `guillaume-claude-global` (the author's Claude Code setup: imperial, expert, foreman, six rules excluded, the deletion, ownership and external gates off).
|
|
19
|
+
- **The agent outcome ledger: did a spec change help?** When a named subagent finishes, the SubagentStop hook appends one line to `notebook/agent-runs.jsonl` in the install: the day, the agent, a 12-hex hash of its rendered spec (none for an agent Geneseed does not ship), whether the done gate let the turn end and how often it blocked it first, the tool calls and refused calls of that turn, the `spec-feedback:` lines and whether a report came back. Only facts the hook reads, no self-score and no model call; a stop the gate blocks writes no line. `geneseed catalog agents --scores` prints one row per agent and spec hash (runs, judged runs never blocked as `n/judged`, mean refused and mean tools with their run counts, shown from 3 runs, feedback lines, reports, first and last day), so the runs before and after a spec edit compare. A refused call is read off the first line of a tool result only, so a red test that quotes a gate's words is not one. The OpenCode learn plugin writes the same line for a named child session, without the done-gate fields, and with empty tool counts when it sees no tool part it knows (the OpenCode 2 shape is unverified). Off with `GENESEED_NO_USAGE` or `.usage-off`, as `usage.jsonl` is. Bob has no subagent-finished event, so it writes nothing.
|
|
20
|
+
- **`geneseed profile save <name> --from <host>-global`** writes a profile from an existing global install, every setting as it is, gates off included, and prints how it differs from `starter`, gates first. It refuses an existing file without `--force` and reads no personal file (user rules, profile, memory, wiki, notebook).
|
|
21
|
+
- **Personal install profiles.** Profiles come from two sources: Shipped (`profiles/` in the checkout, added by pull request) and Personal (`~/.config/geneseed/profiles/`, beside memory and rules; an update never touches it). `geneseed profile save` writes a Personal profile by default; `--shipped` writes the checkout's `profiles/`, and only a git clone takes it. A Personal profile may not reuse a Shipped name: `save` refuses it, `--force` included, and `geneseed doctor` names a clash made by hand (the Shipped profile is the one that loads). `profile save` also reads a project install: `--from <host> --project <dir>`.
|
|
22
|
+
- **`geneseed profile apply <name> [--project <dir>] [--hosts a,b]`** applies a profile globally, or to one project folder (`--emit <host> --out <dir> --root <dir>` per tool). A profile has no scope of its own. It builds only the tools the profile lists that this machine has (`--hosts` narrows them), touches no other install, and does none of the onboarding of `setup --profile` (no `PATH`, login item, console or doctor). Like `setup --profile`, a failure on one tool does not stop the others, and the summary lists every setting a build put back. In project scope, a tool whose global install is active gets one more line: both root files load, and it names the global gates that still run in the project.
|
|
23
|
+
- **A profile may carry `sharedTier`.** A project apply passes it (`--shared-tier on`); a global apply ignores it.
|
|
24
|
+
- **Skills keep their own feedback, with no model call.** When a skill hindered the work, the reply ends with `spec-feedback: [skill:<id>] <fix> [— situation: …] — seen: …` (`[skill:<id>:general]` goes to `skill-notes/_general.md`); each skill's real id is rendered into its text. The Stop hook copies the line into `skill-notes/<id>.md`, which the skill reads at step 0, before the done gate's verdict, so a blocked turn keeps it; the sub-agent capture gets the same fix. Not captured: a skill the install does not ship, a malformed skill tag, a line inside inline code or a fence, an excluded folder. The OpenCode learn plugin does the same at turn end (V1 reads one message per turn). Bob's Stop carries no reply, so there the skill text has the model append the line itself. The hook marks its own bullets `(<writer>, date)` and the caps drop only those: a hand-written line is never dropped. In 30 days, 20 of 73 skill runs hit friction and no skill note was ever written. Run `geneseed rebuild-all`: an install captures nothing until it is re-emitted.
|
|
25
|
+
- **`--context-window 200k|1m` sets Claude Code's skill-listing budget** (default `200k`). Claude Code lists skills under about 6 000 characters on a 200k-context model and 30 000 on 1M, and drops the descriptions of low-usage skills first, so a fresh install on a 200k model showed none of Geneseed's. The Claude Code emits write `skillListingMaxDescChars` 80 and `skillListingBudgetFraction` 0.013 (`200k`) or `skillListingMaxDescChars` 120 (`1m`) into the settings file Geneseed already merges, values set by a simulation of the listing. A value set by hand is never touched; uninstall removes only what Geneseed wrote; a project never undercuts a key the user-level settings set, and a new project takes the machine's window. In profiles (`contextWindow`: `starter` 200k, `guillaume-claude-global` 1m) and the web console. OpenCode and Bob do not cap the list: the setting writes nothing there. **Upgrade:** an existing install reads as `200k`, so its next rebuild writes 80 and 0.013 and prints one line; on a 1M-token model, rebuild once with `--context-window 1m` or apply a profile that says `1m`.
|
|
26
|
+
- **Installs › Profiles in the web console.** One card per profile of both sources (tools, settings, the gates it turns off, the installs that follow it), an Apply panel (Global or One project, a tool checklist, what each build would put back, the global install that keeps running beside a project), and a Save panel (an active install as a Personal or Shipped profile, with its difference from `starter`). The Selected install panel names the profiles its install follows and has a **Save as profile…** button. Both writes are background jobs that run the CLI command.
|
|
27
|
+
|
|
28
|
+
### Changed
|
|
29
|
+
- **One theme-neutral catalogue line of at most 80 characters per skill.** `src/skill-descriptions.json` holds one line per skill, purpose and trigger, trigger first; it is the model-visible description on every host and in the export, and the themed purpose stays in the body (this reverses the 2026-11-11 decision for the frontmatter line only). A vendored skill keeps its upstream description as the first body line. The default install's skill listing drops from 8 836 to 3 971 characters, so it fits a 200k model's budget; the routing probe went from 35 to 38 of 43 cases, with no negative case lost. A doctor check and an emit check fail on a line over 80. The `grill-me` alias of brainstorm is retired (a user's own grill-me skill is left alone; an old `Excluded skills: grill-me` still resolves).
|
|
30
|
+
- **Release, brainstorm, plan and rule take what their runs showed.** **release:** fires only when the user asks to cut or publish a release; lands its PR with `gh pr merge --squash --auto`, never `--admin` or a direct push; waits with `gh run watch --exit-status`, never sleep-then-poll. **brainstorm:** a "go" on the decision ledger approves the ledger, not the build; in a worktree the spec is committed on the worktree's branch. **plan:** the plan goes beside its spec in the project's spec or plan home when one exists, else the notebook. **rule:** approval names the items or says approve; a remark is not approval. Text only; reaches an install on its next emit.
|
|
31
|
+
- **The brief checklist names the worker's model tier, the done gate and where the report goes.** The parent picks each worker's tier per task and names it in the brief: the strongest is its own current model (no override), and it steps down, never up — intermediate for scoped writing, light for read-only search and digests, its own for judgement and a retry; on a host whose model names are unknown (OpenCode), inherit. A project's done-gate checks run unpiped and a background suite is waited on; paths outside a worktree may be refused; a stand-down across a global and a project install holds only for records every copy sees alike, never a verdict; the worker writes its full report to a file and replies with the path. Text only; reaches an install on its next emit.
|
|
32
|
+
- **Foreman mode falls back to direct work when the session holds no dispatch tool.** With no tool that can start a writing (developer) worker (`Agent` on Claude Code and OpenClaude, `subagent`/`task` on OpenCode, `spawn_subagent` on Bob), the session does each task itself, one at a time, in one tree, and says so once; the pipeline skill makes such a session its own crew lead. The check is on the tool, not the host: Bob IDE and Bob Shell read the same `~/.bob` install, Bob IDE gives `spawn_subagent` only to modes whose groups hold `subagent`, and its `ask` mode may start only `explore`. Bob's `start_subtask` does not count, as it appears to make the parent wait (inferred from the bundle, not observed live). The Bob facts are corrected, the host matrix included: a Bob subagent cannot spawn another (Bob IDE 2.2.3), so a Bob worker has no sub-workers and a Bob crew lead plays the roles in turn; Bob Shell has no subagents at all (reported by Bob Shell itself, not read in code). Text only; reaches an install on its next emit.
|
|
33
|
+
- **Foreman mode names how each host resumes a worker, and lets a settled worker take a related task.** A follow-up goes back to its worker by `SendMessage` on Claude Code (on OpenClaude only in its agent-teams mode) and by the `subagent` tool with the worker's `sessionID` on OpenCode (V1: `task` with `task_id`); Bob has no resume. A new task still gets a new worker by default, but it may go to an idle worker whose own task is merged or dropped when it works in the same files or context and that worker's context is still light; the worker starts it on a new branch from the current BASE, under a new ledger line, and never holds two live tasks. The pipeline skill names the same per-host resume for a crew lead. Text only; reaches an install on its next emit.
|
|
34
|
+
- **The four most-used agent specs take what their own feedback reported.** A digest of the 47 real `spec-feedback:` lines of 2026-10 and 11, attributed per agent from the transcripts, gave these edits. **developer:** it may install dependencies only when the brief allows it. In a worktree it runs one plain command per call (`git -C`, no `cd … &&`, no heredocs) and keeps a `\u` escape an escape. As a Foreman worker it hands back a full run with its count line, and calls a failure pre-existing only after reproducing it on a clean BASE. **reviewer:** a diff with nothing to run is traced against its readers by hand. A new entry in a family (theme, host, world) is checked against every per-entry test list. The ref is authoritative over a diff file. **explorer:** it skips its reads on a context-only brief and names the commit it read. **tester:** it re-runs a failure seen only in a concurrent run alone before diagnosing it. **Every agent:** a refused step-0 read is skipped and named in the report, never a stop. Text only; reaches an install on its next emit.
|
|
35
|
+
- **One brief checklist for dispatched workers.** Step 3 of the parallel-agents skill now carries a **Brief checklist** with six items: the git ref and diff state, the whole write set (other call sites, twin copies), a scratch path and a load cap per worker, long suites in the background, whether a dependency install is allowed, and the host's shell limits. The Foreman mode and the pipeline skill point to it instead of restating it. The 5.4.0 rule against opening a worker command with `cd` into the worktree moved into that checklist. Text only; reaches an install on its next emit.
|
|
36
|
+
- **The brainstorm skill takes the lessons of Superpowers 7.0.2.** It reads what the user pointed at before the first question and never asks what that answers; a request clear from the start is restated with any constraint or cheaper path found, and confirmed; for a project, the 2–3 approaches go in a message of their own, picked before any design is written, and the spec records them; where the spec goes is the agent's call; and a brainstorm that started on its own offers to just start, stating any platform, language or tool chosen when the user takes it. The `superpowers` pin moves to v7.0.2. Its subagent-driven-development changes mostly moved text into reference files; the rest (running its scripts from the working tree) is already in the Brief checklist, so parallel-agents and pipeline are unchanged. Text only; reaches an install on its next emit.
|
|
37
|
+
|
|
38
|
+
### Fixed
|
|
39
|
+
- **The usage ledger counts a typed `/skill`, and each call once.** A skill typed as `/name` made no Skill tool call and was never counted; the UserPromptSubmit hook (Claude Code, OpenClaude, Bob) now records it with `via: "slash"` when the skill is installed, and OpenCode 1 on `command.execute.before` (OpenCode 2 has no command hook). A global install beside a live project install counted every call twice; the global copy now stands down when the project copy can count, and on OpenCode exactly one copy counts, the nearest live project's. An excluded folder stays out, counting included. Name and day only.
|
|
40
|
+
- **On an OpenCode project install, the gate log, agent runs and notes reach the console and the agents.** The plugins wrote `usage.jsonl`, `gates.jsonl`, `agent-runs.jsonl` and the spec-feedback notes under `<repo>/.opencode/notebook`, a folder no emit creates; they now use `<repo>/notebook`, as the emit and the console do. Each guard copy records its own refusals, since a global and a project copy judge a call from their own config. Re-emit OpenCode project installs.
|
|
41
|
+
- **The routing probe tells an outage from a miss.** `tests/skill_triggers.mjs` scored a run that ended on an API error (a usage limit, for one) as "the skill did not fire", failing every positive and passing every negative; such a run is now left out, and a case with too few valid runs is inconclusive (exit 1). A max-turns stop is still a miss. Cases added for release, pipeline, parallel-agents, refactor, deck and workflow.
|
|
42
|
+
- **The done gate accepts a check run from a worktree or at another concurrency.** Workers in worktrees ran `npm --prefix <worktree> run lint` and the suite without `--test-concurrency=8`, as their brief asks, all green, and the gate still blocked their SubagentStop 5 to 7 times each, because those commands do not start with the listed line. Before the prefix match, the gate now removes from both the line and the command `--prefix <dir>` on `npm` and `-C <dir>` right after `git`, only when `<dir>` is the judged project's own root (the worktree whose files were edited, by real path), and `--test-concurrency N` on `node --test`. Nothing else changes: another project's dir, a sibling worktree or the main checkout, a changed glob or reporter, a pipe or a masked exit code still read as not run. The gate does not follow `cd`: it reads the command line only. The OpenCode reminder does the same.
|
|
43
|
+
- **The agents' self-improvement loop keeps what they report.** The `spec-feedback:` lines a subagent ends its report with were meant to be written down by the caller, which never happened, and the agents read another file anyway. Now the SubagentStop hook copies each line, with no model call and whether or not `GENESEED_LLM` is set, into `agent-notes/<name>.md` (the tier's `notes/` on a global install, else the install's `notebook/`), a `general` line into `agent-notes/_general.md` instead: one dated bullet each, appended under a file lock, no duplicates, quoted and fenced lines skipped, capped at 100 bullets an agent file, 30 in `_general.md` and 8 000 characters a file (only the hook's own bullets ever drop). Every agent's step 0 now reads those notes beside `memory/agents/<name>.md`. The OpenCode learn plugin does the same for a named child session (V1 and V2). Bob has no subagent-finished event; there the caller still copies the line. Run `geneseed rebuild-all` to get the new agent text.
|
|
44
|
+
|
|
45
|
+
## [5.4.0] — 2026-11-13
|
|
46
|
+
|
|
47
|
+
**Upgrade note.** *Consent Before Push* changes meaning: run `geneseed rebuild-all` after the
|
|
48
|
+
update. An install that excluded *Consent Before Push* because it asked on every commit can switch
|
|
49
|
+
it back on (`--exclude-rules` without it, or its row on the console's Constitution page). A repo
|
|
50
|
+
whose remote was added by hand has no default branch recorded, and every commit there asks:
|
|
51
|
+
`git remote set-head origin --auto` records it.
|
|
52
|
+
|
|
53
|
+
### Changed
|
|
54
|
+
- **An edited deployed file reads as kept or diverged, and only a diverged one alerts.** "Kept" means the source still renders what the last emit wrote; it shows as neutral in the console and in `geneseed diff`. The base hash survives rebuilds (manifest `kept_hashes`). An edited `.md` file still alerts when kept. The self-improvement text no longer claims the doctor reports such an edit.
|
|
55
|
+
- **Worker briefs never open a command with `cd` into the worktree.** The Foreman worker brief and the pipeline crew brief tell workers to run from the worktree or with absolute paths (`git -C`, `npm --prefix`), because Claude Code asks the user to approve a compound command that opens with `cd` into another folder. Text only; reaches an install on its next emit.
|
|
56
|
+
- **The README opens with a hero image and each main section with a banner.** Seven new SVGs under `docs/assets/` share one dark panel, the brand teal and a gene-seed helix; the terminal demo is redrawn to match, says five targets, types no counts and shows each gate's first two ask lines as the hook prints them. Repository page only: none of it ships in the package.
|
|
57
|
+
- **`herdr` is a skill name again.** It left `RETIRED_SKILL_IDS`, where it sat since its removal in 2026-10: the kit skill drives the same tool, so an install whose `Excluded skills:` line names `herdr` now excludes the kit skill, which is what that line meant. It is listed in the new `REVIVED_SKILL_IDS`, so an old herdr skill folder that no manifest owns is still moved to `archived-skills/` on a global emit: with the kit off nothing replaces it, and with the kit on the current kit copy is written in its place. A herdr skill you edited, and that an emit already kept as yours, is never moved, with the kit on or off.
|
|
58
|
+
- **Consent Before Push guards the main branch, not every commit.** The main branch (`main`,
|
|
59
|
+
`master`, a remote's default, and from a linked worktree the main checkout's branch) changes
|
|
60
|
+
only through a pull request with green checks; a green one is merged on the user's yes or
|
|
61
|
+
under the standing auto-merge rule below, a red, pending or unchecked one never. On any other branch, commits, local merges and plain
|
|
62
|
+
pushes of the checked-out branch run without a prompt, a quoted Conventional Commits message
|
|
63
|
+
(`fix(x): y`) or a bash `-F -` heredoc with a quoted delimiter included.
|
|
64
|
+
- **The git gate follows on Claude Code, OpenClaude and Bob.** It asks for a commit or push onto
|
|
65
|
+
the main branch, a forced push, a bare `git push`, a push of another branch, or a command it
|
|
66
|
+
cannot read; and for everything in a repo with no remote, or a remote with no default branch
|
|
67
|
+
recorded. On Claude Code and OpenClaude a sub-agent's push asks too. Bob sends no sub-agent
|
|
68
|
+
field, so there a worker's push of its own branch passes like a session's; dispatched workers
|
|
69
|
+
are still told never to push. OpenCode keeps its static `git commit*`/`git push*` asks,
|
|
70
|
+
since a glob cannot read the branch, and its carrier says so. The rule id and name stay. The
|
|
71
|
+
`loop/*` exemption now matters only under strict consent.
|
|
72
|
+
- **The done gate may block up to 3 times per continuation, each time only after a new edit or a changed background verdict.** It used to block once per turn. A task notification starts a new continuation with a fresh count. Over the whole turn, up to the next human prompt, it blocks at most 10 times, so a red suite relaunched in the background cannot loop. A Stop with no new edit and no new verdict since the last block ends the turn with the `done-gate-cap` ledger line. A block names the checks whose background run is still running or reported a failure. The count is kept per session (and per sub-agent) in the install's `notebook/done-gate/`.
|
|
73
|
+
- **The startup text states its order without shouting.** The readiness-sigil paragraph loses "required", "MUST", "verbatim" and "do not paraphrase"; §9 loses "not deferrable" and "this is not a suggestion". Every ordering clause stays: read the rules and load the project context before the first reply, begin it with the sigil line, and a matching skill is still the first tool call. Strong current models over-apply emphatic wording; a weak model keeps the same sequence. The sigil line itself is unchanged, so theme detection and Bob's own first-reply override are untouched. Reaches an install on its next emit.
|
|
74
|
+
- **A build no longer resets an install's settings in silence; a bare build over one now exits 1.**
|
|
75
|
+
A `geneseed build` (or `geneseed-build`) over an existing install of the same host compares
|
|
76
|
+
each setting it was not given — theme, footprint, posture, mode, trust, packs, excluded rules
|
|
77
|
+
and skills, kits, shared tier, gate switches — with the install's own. If one would change, it
|
|
78
|
+
refuses before writing anything, exit 1: it lists each change as `name: current -> new` and
|
|
79
|
+
prints the install's own rebuild command with the flags you passed applied on top. A flag you
|
|
80
|
+
pass is never compared. A build that ran before and reset a setting now stops there; the new
|
|
81
|
+
`--reset` flag accepts the defaults for one build. `rebuild-all`, `upgrade`, `migrate` and
|
|
82
|
+
the console's rebuild replay an install's whole profile and run as before; the console's
|
|
83
|
+
install and deploy forms, its Build onto another emit, and the setup wizard, which compose a
|
|
84
|
+
whole selection, pass `--reset`. A rebuild command now spells `--posture` and `--mode`
|
|
85
|
+
unless they equal `harness.config.json`'s default, not the literal `peer`/`direct`. The first
|
|
86
|
+
`geneseed upgrade` into this version still replays with the old code, so an OpenCode project
|
|
87
|
+
bundle with the shared tier on can be refused once: run `geneseed upgrade` again.
|
|
88
|
+
`installProfile`, `setupBuildArgs` and `rebuildCommand` moved to `js/build/profile.mjs` so the
|
|
89
|
+
generator can read an install without reaching a module that spawns.
|
|
90
|
+
|
|
91
|
+
### Added
|
|
92
|
+
- **A new opt-in kit, `terminal-tools`, for terminal programs the agent drives through their own CLI.** It adds two skills and no agent. `herdr` controls Herdr workspaces, tabs, panes and agents from inside a Herdr pane, gated on `HERDR_ENV=1` and on the user naming Herdr; it is adapted from the official skill of [herdrdev/herdr](https://github.com/herdrdev/herdr) (Apache-2.0), pinned at the v0.9.4 metadata sync, and carries the Windows notes of herdr's own docs page (native support generally available; signed binaries and SmartScreen avoidance unsupported; one x86_64 Windows asset in v0.9.5). `opencode-cli` drives OpenCode V2 from another session: headless `opencode run` with JSON output, the background service against `--standalone` and `--server`, sessions, MCP, plugins, models, stats and debug; it is first-party, verified against the V2 source at v2.3.0, and leaves every credential command to the user. The kit's rules gate on the environment, read live state before acting, close only what the agent opened, and never stop the user's server or service. It is off by default; turn it on with `--kits terminal-tools`.
|
|
93
|
+
- **`--strict-consent`** (the *Strict consent* switch on the console's Constitution page)
|
|
94
|
+
brings back the old behaviour: every commit and push asks, own branch included. The install
|
|
95
|
+
records it (`Own-branch pass: off`), every rebuild and upgrade keeps it, and the carrier
|
|
96
|
+
says so under the rule.
|
|
97
|
+
- **Auto-merge green PRs, off by default.** Say "turn on auto-merge" and the `rule` skill writes a standing rule into `user-rules.md` (global or per project; the project layer wins). With it, the `ship` skill and a factory's close step arm the forge's auto-merge on a PR the agent opens, on the reviewed head, only when the base branch has required checks: docs and tests only can arm at once, other code waits for one approving review (or the blind reviewer, for a solo repo), and a sensitive diff never arms, whatever the rule says. An armed PR is disarmed before any later push. Without the rule nothing changes, and the agent says once per session in a repo how to turn it on. No host gates a merge command, so the rule is text on every host; see `docs/guides/auto-merge.md`.
|
|
98
|
+
- **Sub-agents are judged at SubagentStop.** The done gate reads the sub-agent's own transcript and judges each git root it wrote under against that root's own list. A block keeps the sub-agent working; an inferred check there is a stderr line and a ledger entry only.
|
|
99
|
+
- **The `geneseed` skill covers a reinstall.** Its trigger now names reinstalling, updating,
|
|
100
|
+
upgrading, repairing and re-running the install, and it opens with the rule: start from the
|
|
101
|
+
install's `rebuild` command, change only the named flag, run the command a refusal prints, and
|
|
102
|
+
add `--reset` only when the user asked for the defaults.
|
|
103
|
+
|
|
104
|
+
### Fixed
|
|
105
|
+
- **Bob prints the readiness banner once.** Bob's first-reply override told it to begin with the sigil line, and Bob also echoed the theme's fenced banner block right under it: two banners in every first reply. The override now says to print the sigil line once and never reproduce the banner block. Reaches a Bob install on its next emit.
|
|
106
|
+
- **`install.cmd` puts `geneseed` on PATH, as `./install` does.** After the setup wizard, when `geneseed` is not on PATH, the Windows installer now runs `geneseed link`, which writes `%LOCALAPPDATA%\Geneseed\bin\geneseed.cmd` and adds that folder to the user Path. Before, a fresh Windows clone had no `geneseed` command until the user found `geneseed.cmd link`. The check is `where $PATH:geneseed`: a bare `where` also searches the current folder and would find the clone's own launcher. A failed link only warns; `geneseed.cmd` still works from the clone. npm installs are unchanged, since npm already puts `geneseed` on PATH.
|
|
107
|
+
- **A background launch is not a pass.** A check started with `run_in_background`, or moved to the background after its foreground timeout, counts only when its task notification says it completed with exit code 0. Before, the launch itself counted, which was 76 of 112 accepted passes in 30 days of real transcripts. A task notification no longer opens a turn.
|
|
108
|
+
- **An excluded rule is no longer cited by the instructions file.** Owner decision D3 (2026-11-11) made an excluded rule off, but the carrier still cited it: an install that excluded process 5 read `(*Consent Before Push*)` in §3, Foreman mode and three process rules. The render now removes a parenthetical citation of an excluded rule, and only that name from a list of citations. The rule files on disk keep every citation. `geneseed doctor` refuses a carrier parenthetical that mixes a doctrine citation with other words; the three such sites (§3 twice, §6) and one in ops 4 were rewritten. Reaches an install on its next emit; a build with no exclusion is unchanged.
|
|
109
|
+
- **Skill and agent descriptions no longer end in `;`.** A description keeps the first clause of the trigger, and a clause that ended at a `;` kept it: six skills (dependencies, geneseed, loop, review-response, skill-forge, wayfinder) ended their `description:` in a `;`, which reads as text cut short. That `;` is now a `.`. Reaches an install on its next emit.
|
|
110
|
+
- **`geneseed help <hook-verb>` prints the hook's help instead of refusing.** `geneseed help context` (and `geneseed context --help`) answered with the hook-verb refusal and exit 2. It now prints one line saying the host runs it as `geneseed-hook context`, then that binary's own help for the verb, and exits 0. A bare `geneseed context` still refuses.
|
|
111
|
+
- **The notebook path names `.claude/` or `.bob/` on a project install.** On a Claude Code or Bob project install the notebook is `.claude/notebook/` or `.bob/notebook/`, but the Foreman mode's ledger and status files and the notes file of every skill and agent self-improvement loop said `notebook/…`, a folder that does not exist at the repo root. They now carry the prefix, as §6 already did; Bob's global `rules/geneseed.md` says `../notebook/`. OpenCode and OpenClaude project installs, plain bundles and the shared tier's notes path are unchanged. Reaches an install on its next emit.
|
|
112
|
+
|
|
11
113
|
## [5.3.1] — 2026-11-12
|
|
12
114
|
|
|
13
115
|
**Upgrade note.** The fixed hook commands, matchers and plugins reach an install only when it is emitted again: run `geneseed rebuild-all` after the update.
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
<h1 align="center"><img src="docs/assets/hero.svg" alt="Geneseed" width="880"></h1>
|
|
4
4
|
|
|
5
5
|
**A portable, theme-able harness you implant once and use everywhere to grow a disciplined AI coding agent.**
|
|
6
6
|
|
|
@@ -27,6 +27,18 @@
|
|
|
27
27
|
|
|
28
28
|
**Geneseed compiles your agent's rules instead of asking you to write them.** One source in `src/` renders into a ready-made harness for OpenCode, Claude Code, Bob, OpenClaude, or any `AGENT.md` tool: a constitution of laws and doctrines, a roster of capability agents, native skills, a memory convention — and, wherever the host has a hook surface, gates that *enforce* the laws at the tool boundary instead of hoping the model remembers them.
|
|
29
29
|
|
|
30
|
+
**New here? One line, no questions** — it clones Geneseed and installs the [`starter` profile](#-new-to-ai-agents-one-line-no-questions). You need git and Node ≥ 22.7.
|
|
31
|
+
|
|
32
|
+
```bat
|
|
33
|
+
git clone https://github.com/Arylmera/Geneseed.git && cd Geneseed && .\install.cmd --profile starter
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
```bash
|
|
37
|
+
git clone https://github.com/Arylmera/Geneseed.git && cd Geneseed && ./install --profile starter
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
The first line is for Windows (cmd or PowerShell 7), the second for macOS and Linux. Windows PowerShell 5.1 has no `&&`: there, put `;` in its place. Want to choose the theme, the host and the rest yourself? Run the wizard instead:
|
|
41
|
+
|
|
30
42
|
```bash
|
|
31
43
|
npx geneseed setup
|
|
32
44
|
```
|
|
@@ -39,9 +51,9 @@ A hand-written instructions file is prose the model may or may not honour, copie
|
|
|
39
51
|
|
|
40
52
|
- **Laws are enforced, not suggested.** A force-push to `main`, a `reset --hard` that abandons unpushed commits, or a credential written into a tracked file is caught by a hook *before* the tool runs, in the host's own dialect — a prompt on Claude Code and OpenClaude, a hard block on OpenCode, exit 2 on Bob. The gates fail closed, and every catch is one line in a ledger that `geneseed status` counts.
|
|
41
53
|
- **The developer stays the owner of the code.** In a production application the agent proposes and the developer decides — per feature, per file or per function, as the team sets in a committed `AGENTS.md`. Interfaces and sensitive zones are always a checkpoint, complex parts are explained before they land, and a hook stops the first write in an application that has not chosen yet. [Ownership →](#-ownership-of-production-code)
|
|
42
|
-
- **One source, five targets.** Skills are byte-identical on every host; only the wiring differs. Every commit renders all
|
|
54
|
+
- **One source, five targets.** Skills are byte-identical on every host; only the wiring differs. Every commit renders all 268 emit configurations, and a second emit into the same tree must change nothing.
|
|
43
55
|
- **Costs are measured, not guessed.** Zero runtime dependencies. The hook path loads in about 14 ms per tool call. The default *lean* footprint keeps the always-on context small and puts the full rationale one read away — the numbers are in [docs/token-footprint.md](docs/token-footprint.md).
|
|
44
|
-
- **It follows you.** Install once, globally; every repo inherits it. One `git pull` or `npm install -g geneseed@latest` rebuilds every active install.
|
|
56
|
+
- **It follows you.** Install once, globally; every repo inherits it. One `geneseed upgrade` (a `git pull`), or `npm install -g geneseed@latest` then `geneseed rebuild-all`, rebuilds every active install.
|
|
45
57
|
|
|
46
58
|
This page is the overview. **New to agent harnesses?** Start with [Understand](docs/understand/harness.md) — a short course on what a harness is, what lands on your machine, what changes in your day, and what is enforced versus only asked. Everything else — every install path, configuration knob, and troubleshooting step — is in the **[documentation](docs/README.md)**, which the web console also renders.
|
|
47
59
|
|
|
@@ -51,7 +63,7 @@ This page is the overview. **New to agent harnesses?** Start with [Understand](d
|
|
|
51
63
|
|
|
52
64
|
<p align="center"><sub>31 deterministic checks, no LLM — <a href="#ai-harness-scorecard">how this is scored, and how to score your own repo</a></sub></p>
|
|
53
65
|
|
|
54
|
-
|
|
66
|
+
<p align="center"><img src="docs/assets/banner-why.svg" alt="" width="880"></p>
|
|
55
67
|
|
|
56
68
|
## 🧬 1 · Why Geneseed
|
|
57
69
|
|
|
@@ -70,10 +82,28 @@ geneseed-build # default theme (neutral)
|
|
|
70
82
|
geneseed-build --theme imperial # Warhammer 40k voice, identical structure
|
|
71
83
|
```
|
|
72
84
|
|
|
73
|
-
|
|
85
|
+
<p align="center"><img src="docs/assets/banner-setup.svg" alt="" width="880"></p>
|
|
74
86
|
|
|
75
87
|
## 🚀 2 · Setup
|
|
76
88
|
|
|
89
|
+
### 🧭 New to AI agents? One line, no questions
|
|
90
|
+
|
|
91
|
+
Clone Geneseed where you like, then run one command at the root of the clone. It installs the **`starter`** profile into every AI coding tool it finds (OpenCode, IBM Bob, Claude Code, OpenClaude), puts `geneseed` on your `PATH`, sets the web console to start at login, starts it, runs the health check and prints the console's address. It asks nothing.
|
|
92
|
+
|
|
93
|
+
Windows (cmd or PowerShell 7; on Windows PowerShell 5.1, put `;` in place of each `&&`):
|
|
94
|
+
|
|
95
|
+
```bat
|
|
96
|
+
git clone https://github.com/Arylmera/Geneseed.git && cd Geneseed && .\install.cmd --profile starter
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
macOS, Linux:
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
git clone https://github.com/Arylmera/Geneseed.git && cd Geneseed && ./install --profile starter
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
`starter` is a neutral voice, a candid peer posture, the agent working each task itself, and every guardrail armed except the ownership gate. Run the same line again to update and repair. `geneseed profile save <name> --from claude-global` writes your own install as a Personal profile (in `~/.config/geneseed/profiles/`); with `--shipped`, from a clone, it writes [`profiles/`](profiles/) for a pull request, which is how a team adds one. `geneseed profile apply <name>` applies a profile globally, or with `--project <dir>` to one project folder. See [Install profiles](docs/reference/profiles.md).
|
|
106
|
+
|
|
77
107
|
### ⚡ The short way — `npx`
|
|
78
108
|
|
|
79
109
|
The harness is published on npm as **[`geneseed`](https://www.npmjs.com/package/geneseed)** — three commands (`geneseed`, `geneseed-hook`, `geneseed-build`), zero dependencies. One command, nothing cloned, nothing else to install. The only prerequisite is **Node ≥ 22.7**.
|
|
@@ -82,7 +112,7 @@ The harness is published on npm as **[`geneseed`](https://www.npmjs.com/package/
|
|
|
82
112
|
npx geneseed setup # the guided wizard
|
|
83
113
|
```
|
|
84
114
|
|
|
85
|
-
The wizard asks for a **theme** (each one
|
|
115
|
+
The wizard asks for a **theme** (each one listed with a one-line description) and an **install mode** — a host (OpenCode, Claude Code, IBM Bob or OpenClaude) installed globally or per repo, *OpenCode global* being the recommended one (every repo inherits it), or the *plain bundle* for any `AGENT.md` tool — then builds and offers a health check. It works the same on macOS, Linux and Windows (cmd, PowerShell, or a POSIX shell).
|
|
86
116
|
|
|
87
117
|
Keeping it around is the same command with `npm`:
|
|
88
118
|
|
|
@@ -137,7 +167,7 @@ Node ≥ 22.7 is the entire dependency list — every command, all six hook verb
|
|
|
137
167
|
- **Run it from anywhere** — a global `npm install -g geneseed` already does this; from a checkout see [Run geneseed from anywhere](docs/guides/run-anywhere.md).
|
|
138
168
|
- **Something wrong?** [Troubleshooting](docs/reference/troubleshooting.md) is organised by what you see.
|
|
139
169
|
|
|
140
|
-
|
|
170
|
+
<p align="center"><img src="docs/assets/banner-console.svg" alt="" width="880"></p>
|
|
141
171
|
|
|
142
172
|
## 🖥 3 · Web & terminal
|
|
143
173
|
|
|
@@ -158,7 +188,7 @@ geneseed web stop # stop the daemon
|
|
|
158
188
|
geneseed web status # is it running, and where
|
|
159
189
|
```
|
|
160
190
|
|
|
161
|
-
The sidebar has
|
|
191
|
+
The sidebar has eleven pages: **Overview** (what's deployed, health, recent jobs), **Constitution** (the rules and doctrine switches), **Library** (skills, agents, the wiki), **Kits** (opt-in stack bundles), **Loops** (the loop catalogue), **Personal** (your rules, profile, memory, notebook), **Installs** (hosts, local edits, doctor, server), **Factories** (the factory catalogue and its runs), **Activity** (what the sessions did), **Settings** and **Docs** — this documentation, opening on the Understand track, with a map of what Geneseed put on your machine.
|
|
162
192
|
|
|
163
193
|
It binds to `127.0.0.1` only and runs entirely offline — no npm needed at runtime; the UI build ships in `web/dist/`. Mutating actions run in the background and report back as toasts (fire-and-notify), guarded by a per-session token so other sites can't trigger them. A global **Spotlight** search in the topbar jumps to any agent, skill, rule, doc, or MCP server. Rebuild the UI after changing anything under `web/src/` with `cd web && npm install && npm run build`. If `web/dist/` is missing (fresh clone, never built), `geneseed web` offers to run that build for you — answer `Y` and it installs, builds, and starts the server; in non-interactive shells it prints the manual recipe instead.
|
|
164
194
|
|
|
@@ -168,11 +198,11 @@ Full reference — every view, the launch/daemon/PWA surface, the security model
|
|
|
168
198
|
|
|
169
199
|
No browser? Every action the console offers is also a verb: `build`, `doctor`, `diff`, `rebuild-all`, `status`, `memory`, `catalog`, `exclude`, `mcp`, `link`/`unlink`, `uninstall` (global **or** per-repo). `geneseed setup` runs the install wizard — plain text prompts, every console, every OS; see [Setup](#-2--setup) above for the walkthrough. `geneseed --help` lists every command, and bare `geneseed` (or `./geneseed`) opens the web console when it can, else prints the command list. There is no full-screen panel: `menu` prints the command list (`tui` is retired, and says so).
|
|
170
200
|
|
|
171
|
-
|
|
201
|
+
<p align="center"><img src="docs/assets/banner-contents.svg" alt="" width="880"></p>
|
|
172
202
|
|
|
173
203
|
## 📦 4 · What you get
|
|
174
204
|
|
|
175
|
-
The harness ships as a small set of layers, and the web console's rail is the same shape — Constitution
|
|
205
|
+
The harness ships as a small set of layers, and the web console's rail is the same shape — Constitution has its own entry; skills, agents and the wiki sit under Library; memory and notebook under Personal:
|
|
176
206
|
|
|
177
207
|
| Layer | What it is |
|
|
178
208
|
| --- | --- |
|
|
@@ -222,7 +252,7 @@ Pick with `--theme NAME` or via the setup wizard; upgrades remember it. More in
|
|
|
222
252
|
|
|
223
253
|
A second per-install dial sets how much of the constitution the root file carries *inline* every turn — a token-cost knob, not a change to which Rules apply. **lean** (the default) carries each rule's hand-written short form and points to the full text on disk; **full** inlines every rule with its rationale. Every rule is in force either way. More in [Footprint](docs/concepts/footprint.md) and [Footprint, loop trust and changing later](docs/guides/setup-footprint.md).
|
|
224
254
|
|
|
225
|
-
|
|
255
|
+
<p align="center"><img src="docs/assets/banner-harnesses.svg" alt="" width="880"></p>
|
|
226
256
|
|
|
227
257
|
## 🔌 Supported harnesses
|
|
228
258
|
|
|
@@ -306,11 +336,11 @@ Geneseed/
|
|
|
306
336
|
## 🧪 Validate & test
|
|
307
337
|
|
|
308
338
|
```bash
|
|
309
|
-
node bin/geneseed-cli.mjs doctor
|
|
339
|
+
node bin/geneseed-cli.mjs doctor --all # every theme + parity + authoring + drift
|
|
310
340
|
node --test --test-reporter=tap "tests/**/*.test.mjs" # the suites (node expands the glob)
|
|
311
341
|
```
|
|
312
342
|
|
|
313
|
-
`doctor` checks each theme for unresolved tokens, dead/non-hermetic links, theme-key parity, author-time gates (every spec has a purpose line, the plugins parse, the learn-prompt literal stays extractable), and that a committed bundle still matches a fresh render of `src/`. CI (`.github/workflows/ci.yml`) runs both on every
|
|
343
|
+
`doctor` checks each theme for unresolved tokens, dead/non-hermetic links, theme-key parity, author-time gates (every spec has a purpose line, the plugins parse, the learn-prompt literal stays extractable), and that a committed bundle still matches a fresh render of `src/`. CI (`.github/workflows/ci.yml`) runs both on every PR and on every push to `main`, on both Linux and Windows. Publishing is a separate workflow (`.github/workflows/publish.yml`) that runs when CI finishes green on `main` and releases only a version npm does not have yet — see [Contributing](#-contributing).
|
|
314
344
|
|
|
315
345
|
### AI Harness Scorecard
|
|
316
346
|
|
|
@@ -325,7 +355,7 @@ geneseed scorecard --json # every check with its evidence
|
|
|
325
355
|
|
|
326
356
|
## 🔄 Keeping it current
|
|
327
357
|
|
|
328
|
-
**Installed from npm** —
|
|
358
|
+
**Installed from npm** — two commands: the second rebuilds every active install for you:
|
|
329
359
|
|
|
330
360
|
```bash
|
|
331
361
|
npm install -g geneseed@latest
|
|
@@ -335,13 +365,15 @@ geneseed rebuild-all # re-render every registered install in its own theme + m
|
|
|
335
365
|
**Installed from a clone** — the `git pull` route, which also refreshes the launchers:
|
|
336
366
|
|
|
337
367
|
```bash
|
|
338
|
-
./geneseed
|
|
339
|
-
./geneseed upgrade --setup
|
|
340
|
-
./geneseed
|
|
368
|
+
./geneseed upgrade # git pull, validate, then rebuild every install (remembers theme + emit mode)
|
|
369
|
+
./geneseed upgrade --setup # the same, then drop into the setup wizard (was: bootstrap)
|
|
370
|
+
./geneseed update # an alias of upgrade
|
|
341
371
|
```
|
|
342
372
|
|
|
343
373
|
**Local edits survive.** The self-improvement loops write to notes under `notebook/`, which no rebuild touches. If you or the agent edited deployed agent/skill files in place anyway, an upgrade exports those edits to an `improvements/` file inside the install; the rebuild then keeps each edited file instead of overwriting it. Details: [Upgrade](docs/guides/upgrade.md).
|
|
344
374
|
|
|
375
|
+
<p align="center"><img src="docs/assets/banner-docs.svg" alt="" width="880"></p>
|
|
376
|
+
|
|
345
377
|
## 📚 Documentation
|
|
346
378
|
|
|
347
379
|
| Page | Read it when… |
|
|
@@ -365,7 +397,7 @@ geneseed rebuild-all # re-render every registered install in its own theme + m
|
|
|
365
397
|
|
|
366
398
|
## 🤝 Contributing
|
|
367
399
|
|
|
368
|
-
Issues and PRs welcome at [github.com/Arylmera/Geneseed](https://github.com/Arylmera/Geneseed). The CI
|
|
400
|
+
Issues and PRs welcome at [github.com/Arylmera/Geneseed](https://github.com/Arylmera/Geneseed). The CI runs on every PR and on `main`, and the package has zero runtime dependencies — keep `doctor` green and the test suites passing. Adding a new theme is one JSON file in `themes/` with the same voice-token keys; `doctor` will tell you if any are missing.
|
|
369
401
|
|
|
370
402
|
Start with [`AGENTS.md`](AGENTS.md), the repo's working guide (`CLAUDE.md` imports it). Three things that bite when you don't know them:
|
|
371
403
|
|
|
@@ -387,6 +419,7 @@ Some skills and agents are adapted from other open-source skill collections, und
|
|
|
387
419
|
- `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.
|
|
388
420
|
- `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.
|
|
389
421
|
- `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, and part of the docker kit's compose-ops skill, rewritten for operations.
|
|
422
|
+
- `herdr` — [herdrdev/herdr](https://github.com/herdrdev/herdr) by herdrdev (Apache-2.0): the terminal-tools kit's herdr skill, condensed into house format with a Windows note.
|
|
390
423
|
- `i-have-adhd` — [ayghri/i-have-adhd](https://github.com/ayghri/i-have-adhd) by Ayoub Ghriss (MIT): the rules, rule-breaking cases and pre-send check of the adhd mode.
|
|
391
424
|
|
|
392
425
|
## 📄 License
|
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: **5.
|
|
23
|
+
> string. Current label: **5.5.0**.
|
|
24
24
|
|
|
25
25
|
## Capabilities
|
|
26
26
|
|
|
@@ -30,12 +30,12 @@ Every row below is present in the tree today; "Spec" names the design record.
|
|
|
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
32
|
| **Laws / Agents / Skills / Memory / Notebook** | 9 laws, 20 agents, 51 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:
|
|
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: the Invariants, then the user's `user-rules.md`, then the Ontology, then the active Doctrines, then the mode, then `PROFILE.md`, posture and theme, which inform and never bind. `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
|
-
| **`diff` + improvements export** | Deployed-vs-source drift report; export an `improvements
|
|
35
|
+
| **`diff` + improvements export** | Deployed-vs-source drift report; export an `improvements/improvements-<date>-<time>.md` back-port inside the install | `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` |
|
|
37
|
-
| **Terminal rendering** | There is no full-screen control panel: `
|
|
38
|
-
| **Web console** | Local browser UI (
|
|
37
|
+
| **Terminal rendering** | There is no full-screen control panel: `menu` is a verb that says so and prints the command list, and the retired `tui` points at `menu`. The display-width and glyph layer ships on, behind `status` and the install animation | `2026-06-07-tui-refactor-polish` · `2026-06-08-tui-modern-refresh` · `2026-06-11-windows-tui` |
|
|
38
|
+
| **Web console** | Local browser UI (Overview; Govern: Constitution, Personal; Build: Library, Kits, Loops, Factories; Run: Installs, Activity; Help: Docs, Settings), auto-build, in-app docs menu | `2026-06-12-web-ui-v2` · `2026-06-12-web-auto-build` · `2026-06-13-docs-menu` |
|
|
39
39
|
| **OpenCode adapter** | Native agents/skills mapping + plugins (context, learn, guard, workflow, notify, ponytail, activity); global-emit link integrity; JSONC config target | `2026-06-07-opencode-adapter-features` · `2026-06-07-global-emit-link-integrity` · `2026-06-12-opencode-jsonc-target` · `2026-06-16-ponytail-minimal-code-mode` |
|
|
40
40
|
| **Host hooks, per dialect** | Every host gets the hook surface its runtime offers, spoken in that runtime's own verdict dialect via `--host`: Claude Code asks (`permissionDecision`), OpenClaude asks exactly as Claude does (a Claude Code fork, under `~/.openclaude` / `.openclaude/`), Bob refuses by exit code 2 (five Claude-named events, nested `~/.bob/settings/settings.json`, no subagent event), OpenCode's guard throws. Laws I/IV are the hard tier everywhere; the consent rules ask where a host can ask and warn where it cannot. `tool-gate` fuses the two gates for hosts that run one command per event; `PreCompact` runs `learn` before Claude compacts; every block or ask lands in `notebook/gates.jsonl` on every host | [bob](adapters/bob/README.md) · [claude-code](adapters/claude-code/README.md) · [candidate hosts](docs/candidate-hosts.md) |
|
|
41
41
|
| **Workflow primitive** | Saved, code-driven subagent orchestration (`workflow` tool + runtime); shipped scripts include `dispatch` — decompose a goal, route each subtask to its owning agent, converge | `2026-06-09-opencode-workflow-primitive` |
|
|
@@ -43,9 +43,9 @@ Every row below is present in the tree today; "Spec" names the design record.
|
|
|
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
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` |
|
|
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 OpenCode's own prompt behind `geneseed-guard` hold it at the tool boundary | `2026-07-30-rule-front-door` |
|
|
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, OpenClaude; on Bob inside its `tool-gate`) and OpenCode's own prompt behind `geneseed-guard` hold it at the tool boundary | `2026-07-30-rule-front-door` |
|
|
47
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` |
|
|
48
|
-
| **Node runtime + npm package** | The whole harness runs from Node: every command `js/cli-table.json` declares, all
|
|
48
|
+
| **Node runtime + npm package** | The whole harness runs from Node: every command `js/cli-table.json` declares, all six 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, the generator's two self-comparisons and its CLI expectation matrix, 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` |
|
|
49
49
|
| **Runtime awareness** | MCP discovery, web research, tool-call batching, review discipline — carried by the doctrine packs (`ops 1` tool discovery, `process 4` read the docs first, `rigor 2`/`rigor 3` honest tests and cover-and-verify), not by the invariants | `2026-06-07-runtime-awareness-and-review-discipline` |
|
|
50
50
|
| **Shared tier** | One machine-wide folder (`~/.config/geneseed`) for memory, standing rules, profile, wiki manifest, exclude paths and notes, read by every global install on every host. Layered reads (project over host over shared), a fold in each global emit that moves existing stores aside, `user-rules.draft.md` decided only through the `rule` skill, and `--shared-tier on` for a project install | `2026-11-05-shared-tier` |
|
|
51
51
|
| **Run from anywhere / uninstall** | `link`/`unlink` onto PATH; global uninstall that keeps the memory store | `2026-06-07-version-and-uninstall` |
|
package/adapters/bob/README.md
CHANGED
|
@@ -125,6 +125,12 @@ id), `cwd` (the root workspace, with a lower-case drive letter on Windows), and
|
|
|
125
125
|
parent's hooks with the parent's `session_id` and no sub-agent id. Activity therefore shows
|
|
126
126
|
such a sub-agent as a branch with no id, which the next `Stop` closes, and marks the session
|
|
127
127
|
`attribution: false`: its files cannot be told from the parent's.
|
|
128
|
+
- `spawn_subagent` is registered only when `session.subagents` is on (the default), and only
|
|
129
|
+
for a mode whose groups hold `subagent`: `agent` and `plan` get every subagent, `ask` only
|
|
130
|
+
`explore`. A subagent can never spawn another (`SUBAGENT_FORBIDDEN_TOOLS` holds
|
|
131
|
+
`spawn_subagent`, and `start_subtask` too), so the depth is one level. Bob Shell, which reads the same `~/.bob`
|
|
132
|
+
install, reports that it has no subagents at all (reported by Bob Shell itself, not read in
|
|
133
|
+
code). So Foreman mode on Bob runs as direct wherever the tool is absent.
|
|
128
134
|
- After a compaction, Bob fires `SessionStart` with `source: "compact"`. The writer counts a
|
|
129
135
|
compaction there; any other Bob `SessionStart` is not recorded, because the first prompt's
|
|
130
136
|
`UserPromptSubmit` records the session right after it.
|
|
@@ -155,7 +161,12 @@ reports one that does not start.
|
|
|
155
161
|
|
|
156
162
|
**What fires.** `tool-gate` also counts skill and sub-agent calls for the web console's
|
|
157
163
|
Overview: `spawn_subagent` by its `name`, `start_subtask` by its `mode`. A subtask's `title` is
|
|
158
|
-
never recorded: it is free text, and the count keeps no prompt.
|
|
164
|
+
never recorded: it is free text, and the count keeps no prompt. A message typed as `/<skill>`
|
|
165
|
+
is counted on `UserPromptSubmit` when that skill is installed, from the payload's `prompt` field
|
|
166
|
+
as Claude Code sends it; that field is not verified on a live Bob session. Beside a Bob project
|
|
167
|
+
install the global install's count stands down, and it finds the project folder from the payload's
|
|
168
|
+
`cwd`. If that `cwd` follows a `cd` into another repo with a Bob project install that Bob never
|
|
169
|
+
loaded, the call is counted by neither install. This is not verified on a live Bob session either.
|
|
159
170
|
|
|
160
171
|
**Migration.** A re-emit over an older install unwires Geneseed's groups from the flat
|
|
161
172
|
`~/.bob/settings.json` (your own keys there are kept) and writes the new set to the
|
|
@@ -397,7 +397,8 @@ behaviour** — nothing changes the machine's current agent/model unless you opt
|
|
|
397
397
|
`.env` writes. `GENESEED_GUARD=off` disables it, `=warn` downgrades
|
|
398
398
|
blocks to warnings. Every **block** appends one line to the install's
|
|
399
399
|
`notebook/gates.jsonl` (rule `law-1` / `law-4` / `process-1` / `wiki` / `ownership`, a timestamp,
|
|
400
|
-
never the path or command) — the same ledger the
|
|
400
|
+
never the path or command; `<repo>/notebook` for a project install) — the same ledger the
|
|
401
|
+
Claude-family hooks write, so
|
|
401
402
|
`geneseed status` counts what the boundary caught on every host. Warnings are not
|
|
402
403
|
recorded.
|
|
403
404
|
- **Invisible context injection** (the default). The context plugin delivers via
|
|
@@ -408,8 +409,9 @@ behaviour** — nothing changes the machine's current agent/model unless you opt
|
|
|
408
409
|
- **Default permissions.** A fresh `opencode.json` gets a minimal policy that **asks**
|
|
409
410
|
before `git reflog expire`, `git gc --prune` and a force-push or delete of `main`/`master` —
|
|
410
411
|
**Rule IV**'s territory, in every build; the guard plugin decides every other data loss — and, **on an install that built the `process` pack in**, before every
|
|
411
|
-
`git commit` and `git push` (the host-level backstop for **Consent Before Push
|
|
412
|
-
|
|
412
|
+
`git commit` and `git push` (the host-level backstop for **Consent Before Push**). The
|
|
413
|
+
rule asks only for a commit or push onto the main branch, but a permission glob cannot read
|
|
414
|
+
which branch is checked out, so OpenCode asks for every commit and push. Build with
|
|
413
415
|
`--doctrines` leaving `process` out and those two entries are simply not written.
|
|
414
416
|
The whole block is added only when you have no `permission` key; an existing policy is
|
|
415
417
|
reconciled key by key — Geneseed adds back what a returning pack wants and removes
|
|
@@ -1382,14 +1382,68 @@ function runsUnpiped(command, line) {
|
|
|
1382
1382
|
return false;
|
|
1383
1383
|
}
|
|
1384
1384
|
|
|
1385
|
-
//
|
|
1386
|
-
|
|
1387
|
-
|
|
1388
|
-
|
|
1385
|
+
// `normalizeRun` is js/hosts/hooks-done.mjs's, copied by `node tests/twins.mjs --write`.
|
|
1386
|
+
function normalizeRun(command, sameProject) {
|
|
1387
|
+
const cmd = String(command).replace(/[ \t]+/g, ' ');
|
|
1388
|
+
return cmd.split(/(&&|\|\||[|;\n])/).map((seg, k) => {
|
|
1389
|
+
if (k % 2) return seg;
|
|
1390
|
+
const toks = seg.trim().match(/(?:"[^"]*"|'[^']*'|[^ "']|["'])+/g);
|
|
1391
|
+
if (!toks) return seg;
|
|
1392
|
+
const [tool] = toks;
|
|
1393
|
+
const test = tool === 'node' && toks.includes('--test');
|
|
1394
|
+
const out = [tool];
|
|
1395
|
+
let opts = true;
|
|
1396
|
+
for (let i = 1; i < toks.length; i += 1) {
|
|
1397
|
+
const t = toks[i];
|
|
1398
|
+
if (t === '--') opts = false;
|
|
1399
|
+
if (opts && tool === 'npm') {
|
|
1400
|
+
if (t === '--prefix' && i + 1 < toks.length && sameProject(toks[i + 1])) { i += 1; continue; }
|
|
1401
|
+
if (t.startsWith('--prefix=') && sameProject(t.slice(9))) continue;
|
|
1402
|
+
}
|
|
1403
|
+
if (tool === 'git' && out.length === 1 && t === '-C' && i + 1 < toks.length && sameProject(toks[i + 1])) { i += 1; continue; }
|
|
1404
|
+
if (opts && test) {
|
|
1405
|
+
if (/^--test-concurrency=\d+$/.test(t)) continue;
|
|
1406
|
+
if (t === '--test-concurrency' && /^\d+$/.test(toks[i + 1] ?? '')) { i += 1; continue; }
|
|
1407
|
+
}
|
|
1408
|
+
out.push(t);
|
|
1409
|
+
}
|
|
1410
|
+
if (out.length === toks.length) return seg;
|
|
1411
|
+
return `${seg.startsWith(' ') ? ' ' : ''}${out.join(' ')}${seg.endsWith(' ') ? ' ' : ''}`;
|
|
1412
|
+
}).join('');
|
|
1413
|
+
}
|
|
1414
|
+
|
|
1415
|
+
// The twin of hooks-done.mjs's `groupPasses`: both sides normalized (`normalizeRun`), a form
|
|
1416
|
+
// runs unpiped, and no flag in `refuse` skips the tests in the segment that ran it. Held equal
|
|
1417
|
+
// by tests/plugins/context_done.test.mjs.
|
|
1418
|
+
function groupPasses(command, g, sameProject = () => false) {
|
|
1419
|
+
const run = normalizeRun(command, sameProject)
|
|
1420
|
+
const forms = g.forms.map((f) => normalizeRun(f, sameProject))
|
|
1421
|
+
if (!forms.some((f) => runsUnpiped(run, f))) return false
|
|
1389
1422
|
if (!g.refuse) return true
|
|
1390
|
-
return
|
|
1423
|
+
return run.split(/&&|\|\||;|\n/).map((s) => s.trim())
|
|
1391
1424
|
.some((s) => !s.includes("|") && !g.refuse.test(s)
|
|
1392
|
-
&&
|
|
1425
|
+
&& forms.some((f) => s === f || s.startsWith(`${f} `)))
|
|
1426
|
+
}
|
|
1427
|
+
|
|
1428
|
+
// The twin of hooks-done.mjs's `projectDir`, async and over a known list: the `dirs` (as
|
|
1429
|
+
// `normalizeRun` hands them, quotes and all) that are the judged `root` ITSELF, by real path
|
|
1430
|
+
// (case-blind on Windows); a sibling worktree or the main checkout is not. A Set, so the sync
|
|
1431
|
+
// `normalizeRun` can ask it; a Git Bash `/c/...` path is not one. ONE DIFFERENCE FROM THE HOOK, in
|
|
1432
|
+
// the closed direction: a relative dir resolves against the git root here (the transform sees no
|
|
1433
|
+
// session cwd), against the session's cwd there, so `--prefix .` from a subfolder counts only in
|
|
1434
|
+
// the hook. The caller's probe answers true, so every dir `normalizeRun` could ask is collected,
|
|
1435
|
+
// a second `git -C` included.
|
|
1436
|
+
async function projectDirs(dirs, root, cwd) {
|
|
1437
|
+
const key = (p) => (process.platform === "win32" ? p.toLowerCase() : p)
|
|
1438
|
+
const ok = new Set()
|
|
1439
|
+
let me
|
|
1440
|
+
try { me = key(await fs.realpath(root)) } catch { return ok }
|
|
1441
|
+
for (const dir of new Set(dirs)) {
|
|
1442
|
+
const bare = /^(["'])(.*)\1$/.exec(dir)?.[2] ?? dir
|
|
1443
|
+
if (!bare) continue
|
|
1444
|
+
try { if (key(await fs.realpath(path.resolve(cwd, bare))) === me) ok.add(dir) } catch { /* not one */ }
|
|
1445
|
+
}
|
|
1446
|
+
return ok
|
|
1393
1447
|
}
|
|
1394
1448
|
|
|
1395
1449
|
// An `apply_patch` call names its targets only in `patchText` markers. Copied from
|
|
@@ -1421,7 +1475,13 @@ function patchSections(patchText) {
|
|
|
1421
1475
|
|
|
1422
1476
|
// The checks still owed, judged over the previous turn and the current one: a reminder lasts
|
|
1423
1477
|
// one turn, not the whole session. Our own injected messages (`geneseed-*` ids) open no turn.
|
|
1424
|
-
|
|
1478
|
+
// BACKGROUND RUNS: js/hosts/hooks-done.mjs holds a Claude Code `run_in_background` launch as
|
|
1479
|
+
// pending until its notification says exit 0. Nothing here does. OpenCode 2's bash tool takes
|
|
1480
|
+
// `background: true` ("Background commands return immediately", seen in the @opencode/cli 2.2.5
|
|
1481
|
+
// binary, 2026-11), but V2 is not judged. Whether V1's bash tool has a background mode is
|
|
1482
|
+
// UNVERIFIED (no V1 binary was inspected); if it has one, a launch would pass here, since only a
|
|
1483
|
+
// numeric non-zero `metadata.exit` refuses a completed call.
|
|
1484
|
+
async function doneOwed(messages, checks, root) {
|
|
1425
1485
|
const groups = checks.map((c) => (typeof c === "string" ? { label: c, forms: [c] } : c))
|
|
1426
1486
|
const prompts = []
|
|
1427
1487
|
messages.forEach((m, i) => {
|
|
@@ -1450,14 +1510,21 @@ function doneOwed(messages, checks, root) {
|
|
|
1450
1510
|
lastEdit = i
|
|
1451
1511
|
})
|
|
1452
1512
|
if (lastEdit === -1) return []
|
|
1453
|
-
const
|
|
1513
|
+
const runs = []
|
|
1454
1514
|
for (const p of tools.slice(lastEdit + 1)) {
|
|
1455
1515
|
const command = DONE_SHELL_TOOLS.has(String(p.tool).toLowerCase()) && p.state.input?.command
|
|
1456
1516
|
if (typeof command !== "string" || p.state.status !== "completed") continue
|
|
1457
1517
|
const exit = p.state.metadata?.exit
|
|
1458
1518
|
if (typeof exit === "number" && exit !== 0) continue
|
|
1459
|
-
|
|
1519
|
+
runs.push(command)
|
|
1460
1520
|
}
|
|
1521
|
+
// The dirs `normalizeRun` would ask about, resolved once off disk (it is sync, this reads async).
|
|
1522
|
+
const asked = []
|
|
1523
|
+
for (const c of [...runs, ...groups.flatMap((g) => g.forms)]) normalizeRun(c, (d) => { asked.push(d); return true })
|
|
1524
|
+
const ok = await projectDirs(asked, root, root)
|
|
1525
|
+
const same = (d) => ok.has(d)
|
|
1526
|
+
const passed = new Set()
|
|
1527
|
+
for (const command of runs) for (const g of groups) if (groupPasses(command, g, same)) passed.add(g.label)
|
|
1461
1528
|
return groups.map((g) => g.label).filter((l) => !passed.has(l))
|
|
1462
1529
|
}
|
|
1463
1530
|
|
|
@@ -1636,7 +1703,7 @@ export const GeneseedContext = async (ctx) => {
|
|
|
1636
1703
|
if (await doneGateOff()) return
|
|
1637
1704
|
const { root: gitRoot, source, blocking, checks } = await doneChecks(root)
|
|
1638
1705
|
if (!checks.length) return
|
|
1639
|
-
const owed = doneOwed(output.messages, checks, gitRoot)
|
|
1706
|
+
const owed = await doneOwed(output.messages, checks, gitRoot)
|
|
1640
1707
|
if (!owed.length) return
|
|
1641
1708
|
const stamp = Date.now()
|
|
1642
1709
|
output.messages.push({
|