geneseed 5.5.0 → 5.6.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 +24 -0
- package/README.md +9 -9
- package/SHIPPED.md +1 -1
- package/docs/concepts/enforcement-table.md +1 -1
- package/docs/concepts/foreman-mode.md +1 -1
- package/docs/concepts/hooks.md +1 -1
- package/docs/extending.md +1 -1
- package/docs/guides/install.md +5 -5
- package/docs/reference/profiles.md +84 -0
- package/harness.config.json +1 -1
- package/js/build/export.mjs +11 -16
- package/js/hosts/hooks.mjs +20 -6
- package/package.json +1 -1
- package/profiles/autonomous.json +14 -0
- package/profiles/corporate.json +14 -0
- package/profiles/mentor.json +13 -0
- package/profiles/minimal.json +15 -0
- package/src/agents/devops-engineer.md +6 -5
- package/src/agents/kubernetes-specialist.md +3 -1
- package/src/agents/spring-boot-engineer.md +3 -3
- package/src/agents/spring-reviewer.md +4 -2
- package/src/skills/codebase-design.md +2 -2
- package/src/skills/commit.md +4 -0
- package/src/skills/diagram-design/SKILL.md +12 -7
- package/src/skills/diagram-design/VENDOR.md +19 -14
- package/src/skills/diagram-design/references/layout-budget.md +7 -1
- package/src/skills/diagram-design/references/onboarding.md +1 -1
- package/src/skills/diagram-design/references/primitives-core.md +1 -1
- package/src/skills/diagram-design/references/semantic-patterns.md +1 -1
- package/src/skills/diagram-design/references/style-guide.md +1 -1
- package/src/skills/diagram-design/references/type-dependency.md +69 -0
- package/src/skills/diagram-design/references/type-event-modeling.md +36 -0
- package/src/skills/diagram-design/references/type-requirement-traceability.md +45 -0
- package/src/skills/diagram-design/references/type-sbgn.md +80 -0
- package/src/skills/diagram-design/references/type-scatter.md +1 -1
- package/src/skills/diagram-design/references/type-steps.md +180 -0
- package/src/skills/diagram-design/references/type-unit-grid.md +63 -0
- package/src/skills/geneseed-code-review.md +2 -1
- package/src/skills/parallel-agents.md +1 -1
- package/src/skills/react-view-transitions/AGENTS.md +26 -26
- package/src/skills/react-view-transitions/SKILL.md +1 -1
- package/src/skills/react-view-transitions/VENDOR.md +12 -3
- package/src/skills/spring-boot/cloud.md +19 -1
- package/src/skills/spring-boot/logging.md +5 -3
- package/src/skills/spring-boot/web.md +27 -2
- package/src/skills/spring-boot.md +4 -2
- package/src/skills/spring-data-jpa.md +18 -4
- package/src/skills/spring-testing.md +4 -0
- package/src/upstreams.json +4 -4
- package/web/dist/assets/{Activity-LKsDzsnK.js → Activity-bUSPM3Dl.js} +1 -1
- package/web/dist/assets/{ActivityDetail-DhwTfPm6.js → ActivityDetail-AHRoXeFN.js} +1 -1
- package/web/dist/assets/{Bonsai-CePMLrpr.js → Bonsai-B5XY9pid.js} +1 -1
- package/web/dist/assets/{CopyButton-CuoaJ6k7.js → CopyButton-C0wwRR9H.js} +1 -1
- package/web/dist/assets/{Dashboard-D1VKuvLe.js → Dashboard-DPAA96EI.js} +2 -2
- package/web/dist/assets/{Docs-CUrHJKaU.js → Docs-CpGDq165.js} +1 -1
- package/web/dist/assets/{Factories-Ci1XfmSy.js → Factories-cNhETa5Q.js} +1 -1
- package/web/dist/assets/{GreenhouseView-CNfH2lPK.js → GreenhouseView-DO3ADmT9.js} +1 -1
- package/web/dist/assets/{Installs-ZHQZM1iS.js → Installs-D3dDyq10.js} +1 -1
- package/web/dist/assets/{JournalView-CMsWahkS.js → JournalView--W-Lw_V9.js} +1 -1
- package/web/dist/assets/{Kits-CkliyK0n.js → Kits-ChfehxY6.js} +1 -1
- package/web/dist/assets/Laws-CNxYmV36.js +4 -0
- package/web/dist/assets/{LibRows-Brv0Hmkr.js → LibRows-CiPvsRYB.js} +1 -1
- package/web/dist/assets/{Library-BYmiLjJr.js → Library-BxQvbwVU.js} +1 -1
- package/web/dist/assets/{Loops-ytm-xJ68.js → Loops-DAblKkyq.js} +1 -1
- package/web/dist/assets/{OperatorHudView-KaqCx_HP.js → OperatorHudView-QtSaSyYm.js} +1 -1
- package/web/dist/assets/{Personal-CmcnRKYE.js → Personal-DxSGv638.js} +1 -1
- package/web/dist/assets/{Settings-tUrpdOfq.js → Settings-CgTbhvRv.js} +1 -1
- package/web/dist/assets/{Tabs-CD7etcGD.js → Tabs-Cf4X1hdz.js} +1 -1
- package/web/dist/assets/{index-COKbhFNo.js → index-B_pTwZra.js} +3 -3
- package/web/dist/assets/index-CzfImiYb.css +1 -0
- package/web/dist/index.html +2 -2
- package/web/dist/assets/Laws-hh4O3HZ4.js +0 -4
- package/web/dist/assets/index-Ba_Kg3Af.css +0 -1
package/CHANGELOG.md
CHANGED
|
@@ -8,6 +8,30 @@ label. For the capability ↔ spec map, see [SHIPPED.md](SHIPPED.md).
|
|
|
8
8
|
|
|
9
9
|
## [Unreleased]
|
|
10
10
|
|
|
11
|
+
## [5.6.0] — 2026-11-17
|
|
12
|
+
|
|
13
|
+
### Changed
|
|
14
|
+
|
|
15
|
+
- **Catching your own branch up with its base no longer asks.** Off the main branch, the commit gate now accepts a plain `git fetch` in the same command as your commits, merges and pushes, so `git fetch origin && git merge origin/main && git commit … && git push origin <branch>` goes through in one piece. A fetch into a local branch (`origin main:main`) or one with an option that runs a program (`--upload-pack=`) still asks. A Foreman worker's local merge in its own worktree may fetch first too.
|
|
16
|
+
- **Commits stop asking because of how the message is written.** Claude Code tends to commit with `-m "$(cat <<'EOF' … EOF)"`, and the gate cannot see inside a `$(`, so every such commit asked, even on your own branch. The commit skill now says to pass a body as `git commit -F - <<'EOF'` with the delimiter quoted, a form the gate already reads. The docs say why the other form asks.
|
|
17
|
+
|
|
18
|
+
## [5.5.1] — 2026-11-17
|
|
19
|
+
|
|
20
|
+
### Added
|
|
21
|
+
|
|
22
|
+
- **Four more Shipped install profiles.** `mentor` (a learner: mentor posture, prudent trust, every gate armed, the ownership gate included), `corporate` (a locked-down work PC: prudent trust, `--strict-consent`, no login item), `autonomous` (a fluent user who delegates: expert posture, foreman mode, aggressive trust, 1m context, the deletion and secrets gates armed) and `minimal` (a small model or a tight token budget: assistant posture, the `craft` and `rigor` packs only, eight niche skills left out). [Install profiles](docs/reference/profiles.md) gives the reason for each choice.
|
|
23
|
+
|
|
24
|
+
### Changed
|
|
25
|
+
|
|
26
|
+
- **The Constitution page's doctrine switches apply on their own.** There is no Apply button to click: once the switches have been still for a moment, the install rebuilds once with the whole selection, so a burst of clicks or a pack switch is still one rebuild. A plain rule rebuilds without a dialog; a change that also removes a gate or a hook, or offers to re-arm one, still asks, and a no puts the switches back. The switches lock while their rebuild runs. A rebuild the server refuses keeps the change on screen with Retry and Revert, and is never retried on its own.
|
|
27
|
+
- `geneseed export` writes the harness release as the version of every entity, skills and agents included; it no longer reads the never-bumped per-entity versions of `registry.json`.
|
|
28
|
+
- `geneseed export` writes the constitution as a side package: a skill or an agent that cites a law no longer lists the `laws` entity in its `requires`, so a library can take the skills and agents without the laws. The `laws` entity itself is still exported (the profile's `laws: false` still leaves it out).
|
|
29
|
+
|
|
30
|
+
### Fixed
|
|
31
|
+
|
|
32
|
+
- The one-line `starter` install failed on a second run, and Windows PowerShell 5.1 could not run it: `git clone` refuses an existing folder, and PowerShell 5.1 has no `&&`. The README and the install guide now give a line that clones the first time and pulls on later runs, so the same line installs, updates and repairs. On Windows the line runs through `cmd /c`, so it works in cmd, PowerShell 5.1 and PowerShell 7.
|
|
33
|
+
- `geneseed export` lost the constitution's `LAWS.md` index on Windows and macOS: it shared a folder with `laws.md`, the same file on a case-insensitive file system. The laws file is now `laws-<stem>.md` (`laws-universal.md`), and a test refuses any two exported paths that differ only by case. A library that took an earlier export holds a stale `laws.md`: remove it by hand.
|
|
34
|
+
|
|
11
35
|
## [5.5.0] — 2026-11-15
|
|
12
36
|
|
|
13
37
|
**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.
|
package/README.md
CHANGED
|
@@ -30,14 +30,14 @@
|
|
|
30
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
31
|
|
|
32
32
|
```bat
|
|
33
|
-
git clone https://github.com/Arylmera/Geneseed.git && cd Geneseed && .\install.cmd --profile starter
|
|
33
|
+
cmd /c "(if exist Geneseed (git -C Geneseed pull) else (git clone https://github.com/Arylmera/Geneseed.git)) && cd Geneseed && .\install.cmd --profile starter"
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
```bash
|
|
37
|
-
git clone https://github.com/Arylmera/Geneseed.git && cd Geneseed && ./install --profile starter
|
|
37
|
+
{ [ -d Geneseed ] && git -C Geneseed pull || git clone https://github.com/Arylmera/Geneseed.git; } && cd Geneseed && ./install --profile starter
|
|
38
38
|
```
|
|
39
39
|
|
|
40
|
-
The first line is for Windows (cmd or
|
|
40
|
+
The first line is for Windows (cmd, PowerShell 5.1 or 7), the second for macOS and Linux. Run it from the folder that gets the clone. It clones the first time and pulls on later runs, so the same line installs, updates and repairs. Want to choose the theme, the host and the rest yourself? Run the wizard instead:
|
|
41
41
|
|
|
42
42
|
```bash
|
|
43
43
|
npx geneseed setup
|
|
@@ -88,21 +88,21 @@ geneseed-build --theme imperial # Warhammer 40k voice, identical structure
|
|
|
88
88
|
|
|
89
89
|
### 🧭 New to AI agents? One line, no questions
|
|
90
90
|
|
|
91
|
-
|
|
91
|
+
Run one line from the folder that gets the clone. It clones Geneseed the first time and pulls on later runs, so the same line installs, updates and repairs. 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
92
|
|
|
93
|
-
Windows (cmd
|
|
93
|
+
Windows (cmd, PowerShell 5.1 or 7):
|
|
94
94
|
|
|
95
95
|
```bat
|
|
96
|
-
git clone https://github.com/Arylmera/Geneseed.git && cd Geneseed && .\install.cmd --profile starter
|
|
96
|
+
cmd /c "(if exist Geneseed (git -C Geneseed pull) else (git clone https://github.com/Arylmera/Geneseed.git)) && cd Geneseed && .\install.cmd --profile starter"
|
|
97
97
|
```
|
|
98
98
|
|
|
99
99
|
macOS, Linux:
|
|
100
100
|
|
|
101
101
|
```bash
|
|
102
|
-
git clone https://github.com/Arylmera/Geneseed.git && cd Geneseed && ./install --profile starter
|
|
102
|
+
{ [ -d Geneseed ] && git -C Geneseed pull || git clone https://github.com/Arylmera/Geneseed.git; } && cd Geneseed && ./install --profile starter
|
|
103
103
|
```
|
|
104
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.
|
|
105
|
+
`starter` is a neutral voice, a candid peer posture, the agent working each task itself, and every guardrail armed except the ownership gate. `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
106
|
|
|
107
107
|
### ⚡ The short way — `npx`
|
|
108
108
|
|
|
@@ -414,7 +414,7 @@ Some skills and agents are adapted from other open-source skill collections, und
|
|
|
414
414
|
- `diagram-design` — [cathrynlavery/diagram-design](https://github.com/cathrynlavery/diagram-design) by Cathryn Lavery (MIT): the vendored `diagram-design` skill, trimmed (no Python helpers, two of its examples).
|
|
415
415
|
- `mattpocock-skills` — [mattpocock/skills](https://github.com/mattpocock/skills) by Matt Pocock (MIT): the vocabulary and procedures behind codebase-design, wayfinder, prototype, develop, handoff and research, the spec pass of geneseed-code-review, the question rounds and questionnaire of brainstorm, the slicing of plan, the reproduction step of debug, the integration-branch rules of parallel-agents, the trigger-pruning of skill-forge, and the dated-history rule of wiki.
|
|
416
416
|
- `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.
|
|
417
|
-
- `mattpocock-skills-2509` — [mattpocock/skills](https://github.com/mattpocock/skills) by Matt Pocock (MIT), a second key for the same repo, at
|
|
417
|
+
- `mattpocock-skills-2509` — [mattpocock/skills](https://github.com/mattpocock/skills) by Matt Pocock (MIT), a second key for the same repo, pinned at 5beb35b0: the PR body of ship and the guardrail clause of rule.
|
|
418
418
|
- `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.
|
|
419
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.
|
|
420
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.
|
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.6.0**.
|
|
24
24
|
|
|
25
25
|
## Capabilities
|
|
26
26
|
|
|
@@ -24,7 +24,7 @@ silently guarding the wrong rule after a renumber. See [ADR 0005](../adr/0005-st
|
|
|
24
24
|
| `sealed-secrets` | law | ask: rule-gate (credential-shaped content outside `.env*`). Switchable per install with `--no-secrets-gate` (see [Exclusions](exclusions.md)): this scan stands down on every host, the guard plugin's path block included | same as Claude Code | block: guard plugin (key/credential file path, or vendor-prefixed secret content); warns only on `.env*` | block (exit 2) |
|
|
25
25
|
| `deletion-is-deliberate` | law | ask: git-gate, only on real data loss judged against the repository's state (the list in [Hooks](hooks.md): a protected branch deleted or force-pushed, an unpushed unmerged branch deleted, unpushed commits abandoned by `reset --hard`, uncommitted work discarded other than by `reset --hard`, a stash dropped, the reflog pruned, files git cannot restore removed); asks when it cannot verify. Switchable per install with `--no-deletion-gate` (see [Exclusions](exclusions.md)): the real-loss check and the Law IV `permission.bash` keys stand down, everything else in this table stays **+** ask: git-gate, catastrophic shell (`rm -rf` of `/`, a drive root or `~`, `mkfs`, `dd` over a raw disk, `format`, fork bomb), whatever the state and even with the switch off | same as Claude Code | ask: permission prompt (`git reflog expire*`, `git gc --prune*`, a force push or delete of `main`/`master` by name) **+** block: guard plugin (catastrophic shell, the hook's check plus its own stricter text match: `rm -rf` of `/`, a drive root or `~`, fork bomb, `format`, `dd` over a raw disk) **+** block: guard plugin (every other real-loss case, the same state-aware decisions as the hook) | block (exit 2) |
|
|
26
26
|
| `persist-insight` | process | ask: rule-gate (a write to `user-rules.md` or `user-rules.draft.md`; memory is written freely, and the [change report](hooks.md#the-change-report) and the web console show it). Togglable: build without the process pack, or drop this rule alone with `--exclude-rules`: the hook goes on every host (`--no-rule-store`), OpenCode's `permission.edit` keys on the rule files too. The change report still lists rule-file changes | same as Claude Code | ask: OpenCode's own prompt (`permission.edit`, and `evaluate` on OpenCode 2); the guard plugin refuses a file-tool write the host cannot prompt for | block a file-tool write: exit 2, no ask tier; a parsed shell write only warns |
|
|
27
|
-
| `consent-before-push` | process | ask: git-gate, on a commit or push onto the main branch (`main`, `master`, a remote's default branch, or the branch the main checkout holds when the command runs in a linked worktree). Off the main branch, a session's commit, local merge and plain push of the checked-out branch (`git push [-u] <remote> <branch>`, or `HEAD:<branch>`) pass. A bare `git push`, a push of another branch, a forced push, a tag push, or any form the gate cannot read still asks, and so does everything in a repository with no remote or whose remote has no default branch recorded (`git remote set-head origin --auto`). A sub-agent's push always asks. With `--strict-consent` (the *Strict consent* switch on the console's Constitution page), every commit and push asks again, as before 2026-11. A sub-agent's commit or merge (`agent_id` in the payload) in a linked worktree, on a branch that is not shared, passes: a Foreman worker's own batch ([Foreman mode](foreman-mode.md) has the exact conditions). A git hook or `core.hooksPath` that pushes on commit is not seen. A push, or a command that mixes one in, still asks. Togglable: build without the process pack, or drop this rule alone with `--exclude-rules` (see [Exclusions](exclusions.md)). Only this question drops; the `deletion-is-deliberate` gate stays. | same as Claude Code | ask: permission prompt (`git commit*`/`git push*`), wired only when the process pack is on; a `loop/*` push is statically allowed. A glob sees only the command, never the worktree, so a worker's commit still asks | log only |
|
|
27
|
+
| `consent-before-push` | process | ask: git-gate, on a commit or push onto the main branch (`main`, `master`, a remote's default branch, or the branch the main checkout holds when the command runs in a linked worktree). Off the main branch, a session's commit, local merge and plain push of the checked-out branch (`git push [-u] <remote> <branch>`, or `HEAD:<branch>`) pass, with a plain `git fetch` (no `a:b` refspec, no `--upload-pack=`) allowed in the same chain. A bare `git push`, a push of another branch, a forced push, a tag push, or any form the gate cannot read still asks, and so does everything in a repository with no remote or whose remote has no default branch recorded (`git remote set-head origin --auto`). A sub-agent's push always asks. With `--strict-consent` (the *Strict consent* switch on the console's Constitution page), every commit and push asks again, as before 2026-11. A sub-agent's commit or merge (`agent_id` in the payload) in a linked worktree, on a branch that is not shared, passes: a Foreman worker's own batch ([Foreman mode](foreman-mode.md) has the exact conditions). A git hook or `core.hooksPath` that pushes on commit is not seen. A push, or a command that mixes one in, still asks. Togglable: build without the process pack, or drop this rule alone with `--exclude-rules` (see [Exclusions](exclusions.md)). Only this question drops; the `deletion-is-deliberate` gate stays. | same as Claude Code | ask: permission prompt (`git commit*`/`git push*`), wired only when the process pack is on; a `loop/*` push is statically allowed. A glob sees only the command, never the worktree, so a worker's commit still asks | log only |
|
|
28
28
|
| `external-gate` | rigor | ask: rule-gate (a write under a project's `.geneseed/protected-checks.txt` list, or to a gate's own configuration: hook settings, `excludes.json`, `AGENT.md` gate markers, the hook shim) | same as Claude Code | ask: OpenCode's own `permission.edit` rules, written by the emit (every `opencode.json(c)`, the hook settings, the install's `AGENT.md`, `excludes.json`, manifest, plugins, the hook shim); block: guard plugin (the protected-checks list, and the other hosts' Geneseed-only files) | block (exit 2), writes only; a hook `settings.json` only when the edit changes Geneseed's own hook entries |
|
|
29
29
|
| `verify-before-asserting` | law | block at Stop, again only after a new edit or a changed background verdict, at most 3 times per continuation and 10 per turn: the done gate in `learn`, at SubagentStop too for a sub-agent's own turn (a turn that edited files, while a check in the project's `.geneseed/done-checks.txt` has not passed since the last edit; a check matches as a prefix of the command once both drop `npm --prefix`/`git -C` naming the judged project's own root and `--test-concurrency N`). Without that file, the checks are inferred from the git root's manifests and only warn (a `systemMessage` at Stop, never a block); switchable per install with `--no-done-gate` (see [Exclusions](exclusions.md)) | same as Claude Code (a frozen fork, and no check runs a model turn: [What is verified](host-matrix.md#what-is-verified)); that its SubagentStop sends `agent_transcript_path` is unverified, and without it a sub-agent's turn is not judged | remind: context plugin, on the next request (OpenCode 1 only; OpenCode 2 is not judged, and logs so) | not judged: Stop carries no transcript (log line) |
|
|
30
30
|
| `commands-must-return` | ops | ask: git-gate (a recursive scan rooted at a filesystem root: `find /`, `du`, `grep -r`, `rg`, `Get-ChildItem -Recurse` at `/`, `/c`, `C:\`). Togglable: build without the ops pack, or drop this rule alone with `--exclude-rules`: the check goes on every host (`--no-root-scan`) | same as Claude Code | block: guard plugin (same root-scan pattern) | block (exit 2) |
|
|
@@ -38,7 +38,7 @@ Bob's `start_subtask` (the `subtask` group, held by the `agent` mode) does not c
|
|
|
38
38
|
|
|
39
39
|
A task worker is one `developer` agent in its own git worktree. It explores, implements and tests in a single context, loading skills as it needs them, so nothing it read is lost in a hand-off. After two repair rounds on its own failing tests it returns with its findings instead of looping.
|
|
40
40
|
|
|
41
|
-
A worker can lead a small team inside its own worktree. It can start read-only helpers (`explorer`, `researcher`) at any time. It can also start writing **sub-workers**, each in its own worktree branched from the worker's branch. The worker commits and merges their branches into its own branch, locally, and re-runs the proof after each merge. *Consent Before Push* names this as a batch. The git gate lets a commit or merge through without a prompt only when all of these hold: the host marks the call as a sub-agent's (Claude Code's `agent_id`), the directory is a linked worktree, and its branch is not shared (`main`, `master`, `develop`, `development`, `release/*`, `hotfix/*`, a remote's default, or the branch the main checkout has, in any letter case). The command may hold only adds, read-only git commands and plain commit or merge arguments with one quoted message, after at most one `cd`; anything that can run a second command (`(`, `@`, `$`, `{`, a backtick) asks. A session that only runs in a worktree, as the desktop app's do,
|
|
41
|
+
A worker can lead a small team inside its own worktree. It can start read-only helpers (`explorer`, `researcher`) at any time. It can also start writing **sub-workers**, each in its own worktree branched from the worker's branch. The worker commits and merges their branches into its own branch, locally, and re-runs the proof after each merge. *Consent Before Push* names this as a batch. The git gate lets a commit or merge through without a prompt only when all of these hold: the host marks the call as a sub-agent's (Claude Code's `agent_id`), the directory is a linked worktree, and its branch is not shared (`main`, `master`, `develop`, `development`, `release/*`, `hotfix/*`, a remote's default, or the branch the main checkout has, in any letter case). The command may hold only adds, read-only git commands, a plain `git fetch` (no `a:b` refspec, no option that names a program) and plain commit or merge arguments with one quoted message, after at most one `cd`; anything that can run a second command (`(`, `@`, `$`, `{`, a backtick) asks. A session that only runs in a worktree, as the desktop app's do, is judged by the own-branch pass instead ([Hooks](hooks.md)). A push still asks everywhere. Bob sends no sub-agent field, so Bob still logs its warning. On OpenCode the static `git commit*` permission still asks, because a permission glob sees only the command, not the worktree. The gate reads the command, not git's own hooks: a `post-commit` hook or a `core.hooksPath` can push on commit, on any branch, as it always could. Nesting stops at two levels below the session: session → worker → sub-worker. A sub-worker starts nothing. A lead holds every member's result before it ends. The blind reviewer is still the session's, never the worker's.
|
|
42
42
|
|
|
43
43
|
| Host | What caps the depth |
|
|
44
44
|
| --- | --- |
|
package/docs/concepts/hooks.md
CHANGED
|
@@ -67,7 +67,7 @@ On Bob, a subagent's files cannot be told apart from its session's files (its ho
|
|
|
67
67
|
- removing files (`rm`, `rmdir`, `del`, `erase`, `Remove-Item`) that git cannot restore: untracked, ignored or modified files, a repository's `.git`, or anything outside a repository.
|
|
68
68
|
|
|
69
69
|
A force push to a feature branch, the protected-branch-only forms above on a feature branch, a new branch (`checkout -b`, `switch -c`), `reset --hard` over uncommitted work or to a commit that keeps every unpushed one, `branch -D` of a pushed branch, or `rm` of a tracked, unmodified file passes. When the gate cannot tell — a glob or `$variable` it would have to expand, a `cd` it cannot follow, `sh -c`/`xargs`, git failing or missing — it asks, and says it could not verify. To read the state it runs `git` itself, only once a command already looked destructive; every other command pays nothing. That is a Rule, so it holds in every build — unless you switch its gate off for one install with `--no-deletion-gate` (or the switch on Rule IV in the console's Constitution page). The hook is then wired with `--no-deletion-gate` and this check stands down; the Rule's text still binds the agent, and the catastrophic-command check above and the root-scan and consent checks below still run ([Exclusions](exclusions.md)).
|
|
70
|
-
- **A `git commit` or `git push` onto the main branch** gets a prompt citing *Consent Before Push*: the main branch changes only through a pull request with green checks. The main branch is `main`, `master`, a remote's default branch, or, in a linked worktree, the branch the main checkout holds. On any other branch, a commit, a local merge and a plain push of the checked-out branch (`git push -u origin feature`, `git push origin HEAD:feature`) pass. A bare `git push` (where `push.default` and your git config decide the target), a push of a branch other than the checked-out one, a forced push, a tag push, a sub-agent's push, or a command the gate cannot read still asks. A quoted message is data: `git commit -m "fix(hooks): x"` passes, and so does a bash `git commit -F - <<'EOF'` heredoc whose delimiter is quoted; a `$(` or a backtick inside double quotes still asks
|
|
70
|
+
- **A `git commit` or `git push` onto the main branch** gets a prompt citing *Consent Before Push*: the main branch changes only through a pull request with green checks. The main branch is `main`, `master`, a remote's default branch, or, in a linked worktree, the branch the main checkout holds. On any other branch, a commit, a local merge and a plain push of the checked-out branch (`git push -u origin feature`, `git push origin HEAD:feature`) pass, and so does a plain `git fetch` chained with them (`git fetch origin && git merge origin/main`); a fetch into a local branch (`origin main:main`) or one with an option that names a program (`--upload-pack=`) asks. A bare `git push` (where `push.default` and your git config decide the target), a push of a branch other than the checked-out one, a forced push, a tag push, a sub-agent's push, or a command the gate cannot read still asks. A quoted message is data: `git commit -m "fix(hooks): x"` passes, and so does a bash `git commit -F - <<'EOF'` heredoc whose delimiter is quoted; a `$(` or a backtick inside double quotes still asks, so Claude Code's habit of `-m "$(cat <<'EOF' … EOF)"` asks on every commit: the commit skill steers the agent to `-F -`. In a repository with no remote, or with a remote whose default branch is not recorded (`git remote add` records none; `git remote set-head origin --auto` does), the gate cannot tell your branch from the default one, so every commit and push asks. Build with `--strict-consent` (or turn on *Strict consent* on the console's Constitution page) and every commit and push asks again. This part belongs to the **process** doctrine pack: build without it, or exclude that rule, and the hook stays wired with `--no-consent` — commits and pushes go through without asking, real data loss is still stopped ([Rules](rules.md)).
|
|
71
71
|
- **A recursive scan of a whole filesystem** — `find /`, `du -sh /`, `grep -r foo /`, `rg x C:\`, `Get-ChildItem C:\ -Recurse` — gets a prompt citing *Commands Must Return* (on Bob, it is blocked). In Git Bash `/` mounts every drive and mounted share, so such a scan runs for hours, and `| head` does not stop it. The prompt tells the agent to search a specific directory instead. A deeper path (`find /c/Users/me/project`), `ls /` without `-R` (`ls -r` is reverse order, not recursion), a quoted argument (a search pattern such as `grep -rn "/" src`), a `#` comment, and the remote half of an `ssh` command pass. It belongs to the **ops** pack: build without it, or exclude that rule, and the hook is wired with `--no-root-scan` and this check stands down (also on Bob and in the OpenCode guard); every other check stays ([Exclusions](exclusions.md)).
|
|
72
72
|
- **A shell write to a protected check or a gate's own configuration** gets the same *External Gate* prompt as a write tool (see rule-gate below; on Bob, it is blocked). `--no-consent` does not touch it.
|
|
73
73
|
- Any other command passes untouched.
|
package/docs/extending.md
CHANGED
|
@@ -124,7 +124,7 @@ Notes that matter:
|
|
|
124
124
|
held to it as a sum) because `node --test` over a glob that matches nothing prints `# tests 0`
|
|
125
125
|
and **exits 0**. Node's default reporter changed between majors, which is how a green 1043-test
|
|
126
126
|
suite once reported zero.
|
|
127
|
-
- `--cli` runs the ~
|
|
127
|
+
- `--cli` runs the ~280-cell CLI/hook matrix against the expectations written in each cell —
|
|
128
128
|
the only end-to-end gate on what a verb prints. CI runs it in `node-cells` on both platforms.
|
|
129
129
|
A cell that needs a broken checkout plants its fault as an **edit of the real file**
|
|
130
130
|
(`{ "edit": [[find, replace]] }` in `tests/helpers/matrix/cli.*.json`), never as a copy of it;
|
package/docs/guides/install.md
CHANGED
|
@@ -10,21 +10,21 @@ Geneseed builds a harness (the rules, agents, skills and hooks your AI coding to
|
|
|
10
10
|
|
|
11
11
|
## New to AI agents: one line, no questions
|
|
12
12
|
|
|
13
|
-
You need **git** and **Node 22.7 or newer**.
|
|
13
|
+
You need **git** and **Node 22.7 or newer**. Run one line from the folder that gets the clone. It clones Geneseed the first time and pulls on later runs, so the same line installs, updates and repairs. It runs the installer with the `starter` profile:
|
|
14
14
|
|
|
15
|
-
Windows (cmd
|
|
15
|
+
Windows (cmd, PowerShell 5.1 or 7):
|
|
16
16
|
|
|
17
17
|
```bat
|
|
18
|
-
git clone https://github.com/Arylmera/Geneseed.git && cd Geneseed && .\install.cmd --profile starter
|
|
18
|
+
cmd /c "(if exist Geneseed (git -C Geneseed pull) else (git clone https://github.com/Arylmera/Geneseed.git)) && cd Geneseed && .\install.cmd --profile starter"
|
|
19
19
|
```
|
|
20
20
|
|
|
21
21
|
macOS, Linux:
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
|
-
git clone https://github.com/Arylmera/Geneseed.git && cd Geneseed && ./install --profile starter
|
|
24
|
+
{ [ -d Geneseed ] && git -C Geneseed pull || git clone https://github.com/Arylmera/Geneseed.git; } && cd Geneseed && ./install --profile starter
|
|
25
25
|
```
|
|
26
26
|
|
|
27
|
-
It asks nothing. It installs the harness globally 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 a summary with the console's address. With no tool on the machine it installs nothing and prints where to get each one.
|
|
27
|
+
It asks nothing. It installs the harness globally 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 a summary with the console's address. With no tool on the machine it installs nothing and prints where to get each one. `starter` is a neutral voice, a candid peer posture, and every guardrail armed except the ownership gate. [Install profiles](../reference/profiles.md) has the details: how to save your own setup as a Personal profile, apply a profile to one project with `geneseed profile apply`, and how a team adds a Shipped one.
|
|
28
28
|
|
|
29
29
|
## The 5-minute path
|
|
30
30
|
|
|
@@ -116,6 +116,90 @@ A gate that is off in the global install runs nowhere, so the line does not name
|
|
|
116
116
|
|
|
117
117
|
`peer` and not `expert`, because `expert` does not explain the basics a new user needs; not `mentor`, because it checks understanding with questions. Every gate stays armed except the ownership gate, whose first-write stop is heavy for a new user. `200k`, because most machines run a 200k-token model, a locked-down work PC included; `guillaume-claude-global` sets `1m` for a 1M-token model.
|
|
118
118
|
|
|
119
|
+
## `mentor`
|
|
120
|
+
|
|
121
|
+
```json
|
|
122
|
+
{
|
|
123
|
+
"description": "For a learner (a junior, a student): neutral voice, mentor posture, every guardrail, the ownership gate included.",
|
|
124
|
+
"hosts": ["opencode", "bob", "claude", "openclaude"],
|
|
125
|
+
"theme": "neutral",
|
|
126
|
+
"footprint": "lean",
|
|
127
|
+
"posture": "mentor",
|
|
128
|
+
"mode": "direct",
|
|
129
|
+
"trust": "prudent",
|
|
130
|
+
"doctrines": "all",
|
|
131
|
+
"kits": [],
|
|
132
|
+
"contextWindow": "200k",
|
|
133
|
+
"login": true
|
|
134
|
+
}
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
`mentor`, because it explains the reasoning behind each step and checks understanding before it moves on. A learner needs that; a fluent user does not. `prudent`, so that a loop stops for a person at a lower risk score ([Loop risk](../concepts/loop-risk.md)). The profile turns no gate off. The ownership gate stays armed: in an application repo, it asks the learner to set up ownership, and then the learner decides each part of the code ([Ownership](../concepts/ownership.md)).
|
|
138
|
+
|
|
139
|
+
## `corporate`
|
|
140
|
+
|
|
141
|
+
```json
|
|
142
|
+
{
|
|
143
|
+
"description": "For a locked-down work PC: neutral voice, every guardrail except the ownership gate, strict consent, no login item.",
|
|
144
|
+
"hosts": ["opencode", "bob", "claude", "openclaude"],
|
|
145
|
+
"theme": "neutral",
|
|
146
|
+
"footprint": "lean",
|
|
147
|
+
"posture": "peer",
|
|
148
|
+
"mode": "direct",
|
|
149
|
+
"trust": "prudent",
|
|
150
|
+
"doctrines": "all",
|
|
151
|
+
"kits": [],
|
|
152
|
+
"contextWindow": "200k",
|
|
153
|
+
"gates": { "ownershipGate": false, "ownBranchPass": false },
|
|
154
|
+
"login": false
|
|
155
|
+
}
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
`prudent`, because a work machine holds code that other people answer for. `ownBranchPass: false` is `--strict-consent`: every commit and push asks, on your own branch too, not only on the main branch. The ownership gate is off, as in `starter`: a team that wants ownership writes `mode: on` in its repo's `AGENTS.md`, and that section binds with the gate off. `login: false`, because a policy often blocks a login item on a managed PC. Start the console by hand with `geneseed web start`.
|
|
159
|
+
|
|
160
|
+
## `autonomous`
|
|
161
|
+
|
|
162
|
+
```json
|
|
163
|
+
{
|
|
164
|
+
"description": "For a fluent user who delegates: expert posture, foreman mode, aggressive loops, every guardrail except the ownership gate.",
|
|
165
|
+
"hosts": ["opencode", "bob", "claude", "openclaude"],
|
|
166
|
+
"theme": "neutral",
|
|
167
|
+
"footprint": "lean",
|
|
168
|
+
"posture": "expert",
|
|
169
|
+
"mode": "foreman",
|
|
170
|
+
"trust": "aggressive",
|
|
171
|
+
"doctrines": "all",
|
|
172
|
+
"kits": [],
|
|
173
|
+
"contextWindow": "1m",
|
|
174
|
+
"gates": { "ownershipGate": false },
|
|
175
|
+
"login": true
|
|
176
|
+
}
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
`expert` and `foreman`, because this user gives a task and lets background workers do it. `aggressive` lets a loop accept a higher risk score before it stops for a person ([Loop risk](../concepts/loop-risk.md)). The deletion gate and the secrets gate stay armed: a worker that runs alone must not lose work or leak a key. Only the ownership gate is off, because its first-write stop interrupts the work. `1m`, because a user who delegates large tasks usually runs a 1M-token model. On a 200k-token model, save your own profile with `contextWindow` set to `200k`.
|
|
180
|
+
|
|
181
|
+
## `minimal`
|
|
182
|
+
|
|
183
|
+
```json
|
|
184
|
+
{
|
|
185
|
+
"description": "For a small model or a tight token budget: the smallest always-on context, two doctrine packs, niche skills left out.",
|
|
186
|
+
"hosts": ["opencode", "bob", "claude", "openclaude"],
|
|
187
|
+
"theme": "neutral",
|
|
188
|
+
"footprint": "lean",
|
|
189
|
+
"posture": "assistant",
|
|
190
|
+
"mode": "direct",
|
|
191
|
+
"trust": "balanced",
|
|
192
|
+
"doctrines": ["craft", "rigor"],
|
|
193
|
+
"excludeSkills": ["brick-forge", "bruno", "daydream", "factory", "factory-forge", "forge-mcp", "prototype", "react-view-transitions"],
|
|
194
|
+
"kits": [],
|
|
195
|
+
"contextWindow": "200k",
|
|
196
|
+
"gates": { "ownershipGate": false },
|
|
197
|
+
"login": true
|
|
198
|
+
}
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
Each choice makes the always-on context smaller. `assistant` does what you ask and stops, so a small model gets a narrow task and few chances to drift. `craft` and `rigor` are the packs about how code is written and proven; the other packs stay in `doctrines/` for reference. The excluded skills serve rare tasks. A skill that the harness links to cannot be excluded, so `council`, `deck`, `pipeline` and `workflow` stay. Every gate except the ownership gate stays armed, because a gate costs no context. To measure the gain on your machine, build `starter` and `minimal` into two empty folders with `geneseed profile apply <name> --project <dir> --hosts claude`, then compare the size of each `CLAUDE.md` and the number of skills.
|
|
202
|
+
|
|
119
203
|
## Save your own
|
|
120
204
|
|
|
121
205
|
```bash
|
package/harness.config.json
CHANGED
|
@@ -2,5 +2,5 @@
|
|
|
2
2
|
"_comment": "version is a human-readable release label only; the canonical identity of an installed harness is the source fingerprint stamped in .geneseed-version (see `harness version`), not this string.",
|
|
3
3
|
"theme": "neutral",
|
|
4
4
|
"product": "Geneseed",
|
|
5
|
-
"version": "5.
|
|
5
|
+
"version": "5.6.0"
|
|
6
6
|
}
|
package/js/build/export.mjs
CHANGED
|
@@ -31,8 +31,9 @@
|
|
|
31
31
|
* An agent keeps the whole of its seven sections, step 0 and Self-improvement included: that
|
|
32
32
|
* shape is the contract a persona library reads;
|
|
33
33
|
* - host keys (`disable-model-invocation`, `disallowedTools`, ...) are not written at all.
|
|
34
|
-
* A citation of a law or doctrine stays the principle's name, and the entity `
|
|
35
|
-
* exported constitution
|
|
34
|
+
* A citation of a law or doctrine stays the principle's name, and the entity does NOT `require`
|
|
35
|
+
* the exported constitution: the laws are a side package a library may take or leave, and a
|
|
36
|
+
* skill or an agent installs without them (the user decided, 2026-11).
|
|
36
37
|
*
|
|
37
38
|
* NOT EXPORTED: an alias (a second name for one skill), the authoring templates, and a vendored
|
|
38
39
|
* folder skill. The last is a third party's folder shipped verbatim under its own licence and
|
|
@@ -88,7 +89,6 @@ const PROFILE_DEFAULTS = {
|
|
|
88
89
|
};
|
|
89
90
|
const LIST_KEYS = ['compatibleTools', 'exclude'];
|
|
90
91
|
const NAME_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
|
|
91
|
-
const CITES_RE = /\{\{(?:LAW|DOCTRINE):[a-z0-9-]+\}\}/;
|
|
92
92
|
|
|
93
93
|
/** A refusal: the message is the whole of what the user needs, so no stack is printed. */
|
|
94
94
|
class ExportError extends Error {}
|
|
@@ -161,13 +161,6 @@ function metadataYaml(m) {
|
|
|
161
161
|
|
|
162
162
|
const frontmatter = (name, description) => `---\nname: ${name}\ndescription: ${yamlStr(description)}\n---\n\n`;
|
|
163
163
|
|
|
164
|
-
/** The registry's row for one entity: its version and nothing else is read. */
|
|
165
|
-
function registryVersions() {
|
|
166
|
-
try {
|
|
167
|
-
return JSON.parse(readText(path.join(ROOT, 'registry.json'))).entities ?? {};
|
|
168
|
-
} catch { return {}; }
|
|
169
|
-
}
|
|
170
|
-
|
|
171
164
|
/**
|
|
172
165
|
* Rewrite every reference to another exported entity to its exported name, and collect them.
|
|
173
166
|
* Two spellings carry a reference in the sources: a Markdown link to the entity's spec
|
|
@@ -226,7 +219,6 @@ export function planExport({ profile = { ...PROFILE_DEFAULTS }, theme = 'neutral
|
|
|
226
219
|
// a lean line.
|
|
227
220
|
const { items } = renderAll(cfg, theme, { footprint: 'full' });
|
|
228
221
|
const srcRel = (it) => relPosix(cfg.src, it.src);
|
|
229
|
-
const versions = registryVersions();
|
|
230
222
|
const release = sourceReleaseVersion(cfg);
|
|
231
223
|
|
|
232
224
|
// The roster: flat specs under skills/ and agents/, minus templates and what the profile drops.
|
|
@@ -289,11 +281,12 @@ export function planExport({ profile = { ...PROFILE_DEFAULTS }, theme = 'neutral
|
|
|
289
281
|
description = agentDescription(s.it.text);
|
|
290
282
|
body = link(body);
|
|
291
283
|
}
|
|
292
|
-
if (profile.laws && CITES_RE.test(readText(s.it.src))) requires.add(lawsName);
|
|
293
284
|
files.push({ rel: `${dir}/${s.kind === 'skill' ? 'SKILL.md' : 'AGENT.md'}`, text: frontmatter(s.name, description) + body });
|
|
294
285
|
files.push({ rel: `${dir}/metadata.yaml`, text: metadataYaml({
|
|
295
286
|
...base, type: s.kind, requires: [...requires].sort(),
|
|
296
|
-
|
|
287
|
+
// Every entity carries the harness release, as the laws do: the set ships as one, and the
|
|
288
|
+
// per-entity versions in registry.json were never bumped (the user decided, 2026-11).
|
|
289
|
+
version: release,
|
|
297
290
|
...creditsOf(s.it.src, cfg.src),
|
|
298
291
|
}) });
|
|
299
292
|
entities.push({ type: s.kind, name: s.name, source: srcRel(s.it), path: dir });
|
|
@@ -325,15 +318,17 @@ export function planExport({ profile = { ...PROFILE_DEFAULTS }, theme = 'neutral
|
|
|
325
318
|
: tier === 'laws'
|
|
326
319
|
? ['Laws', `the invariants, always in force (${rules} rules)`]
|
|
327
320
|
: ['Ontology', 'how the agent thinks, decides and behaves'];
|
|
328
|
-
|
|
321
|
+
// `laws-<stem>.md`, never `laws.md`: beside the `LAWS.md` index that name is the SAME file
|
|
322
|
+
// on a case-insensitive file system (Windows, macOS), and the index was silently lost.
|
|
323
|
+
const file = tier === 'ontology' ? 'ontology.md' : `${tier}-${stem}.md`;
|
|
329
324
|
parts.push({ rank: ['ontology', 'laws'].indexOf(tier) >= 0 ? ['ontology', 'laws'].indexOf(tier) : 2 + packs.indexOf(stem), file, title, what });
|
|
330
325
|
files.push({ rel: `${dir}/${file}`, text: `# ${title}\n\n${body}\n` });
|
|
331
326
|
}
|
|
332
327
|
parts.sort((x, y) => x.rank - y.rank);
|
|
333
328
|
files.push({ rel: `${dir}/LAWS.md`, text: [
|
|
334
329
|
`# ${lawsName}`, '',
|
|
335
|
-
'The constitution the skills and agents of this collection cite by principle name.
|
|
336
|
-
+ 'file per category:', '',
|
|
330
|
+
'The constitution the skills and agents of this collection cite by principle name. It is a '
|
|
331
|
+
+ 'side package: no skill or agent requires it. One file per category:', '',
|
|
337
332
|
...parts.map((x) => `- \`${x.file}\` — ${x.title}: ${x.what}`), '',
|
|
338
333
|
].join('\n') });
|
|
339
334
|
files.push({ rel: `${dir}/metadata.yaml`, text: metadataYaml({
|
package/js/hosts/hooks.mjs
CHANGED
|
@@ -136,6 +136,14 @@ const ARG_RE = '[\\w./:@^~=+,-]+';
|
|
|
136
136
|
const SEG_ADD_RE = new RegExp(`^git\\s+add(\\s+${ARG_RE})*$`);
|
|
137
137
|
const SEG_COMMIT_RE = new RegExp(`^git\\s+commit(\\s+-q)?\\s+(-F\\s+|--file[=\\s])${ARG_RE}(\\s+-q)?$`);
|
|
138
138
|
const SEG_READONLY_RE = new RegExp(`^git\\s+(status|diff|log|rev-parse|show)(\\s+${ARG_RE})*$`);
|
|
139
|
+
// A fetch writes only remote-tracking refs, FETCH_HEAD and tags git will not clobber, never a
|
|
140
|
+
// local branch, as long as no refspec names a destination (`a:b`, `+a:b`) and no option names a
|
|
141
|
+
// program (`--upload-pack=<cmd>` runs one). So: a few flags that take no value, then at most one
|
|
142
|
+
// remote and its branches, each a plain name whose first character is alphanumeric (no `:`, no
|
|
143
|
+
// `+`, no flag, no `.` or path for the remote). Added for the own-branch and worker passes
|
|
144
|
+
// (2026-11-17): `git fetch origin && git merge origin/main && git commit …` is how a branch
|
|
145
|
+
// catches up with its base, and the fetch alone made the whole chain ask.
|
|
146
|
+
const SEG_FETCH_RE = /^git\s+fetch(?:\s+(?:--prune|-p|--tags|-t|--no-tags|--all|--quiet|-q))*(?:\s+[A-Za-z0-9][A-Za-z0-9._-]*(?:\s+[A-Za-z0-9][\w./-]*)*)?$/;
|
|
139
147
|
|
|
140
148
|
/**
|
|
141
149
|
* `git push`, exactly: `[-u|--set-upstream] <remote> HEAD:<branch>` or
|
|
@@ -209,8 +217,9 @@ const SHARED_BRANCH_RE = /^(?:main|master|develop|development|(?:release|hotfix)
|
|
|
209
217
|
* sets on tool events inside a subagent or in-process teammate). A session that merely runs in
|
|
210
218
|
* a worktree, as the desktop app's do, has none and asks. A host that sends none asks always.
|
|
211
219
|
* - The command: none of `UNSAFE_CHARS_RE` or `SUBSHELL_CHARS_RE`, no `push` word anywhere (a mixed
|
|
212
|
-
* command asks), every segment an add, a read-only look,
|
|
213
|
-
* leading `cd <path>` (an agent's shell starts in the
|
|
220
|
+
* command asks), every segment an add, a read-only look, a fetch (`SEG_FETCH_RE`) or
|
|
221
|
+
* `SEG_LOCAL_RE`, after at most one leading `cd <path>` (an agent's shell starts in the
|
|
222
|
+
* parent's checkout). The `cd` target and
|
|
214
223
|
* `cwd` are resolved with `realpathSync`, git's physical path; `cd -`, `~` or a path that does
|
|
215
224
|
* not resolve asks.
|
|
216
225
|
* - The tree: `cwd` a linked worktree (`mainWorktreeOf`, read off disk, no spawn), its branch
|
|
@@ -232,7 +241,7 @@ export function worktreeExempt(command, cwd, agentId) {
|
|
|
232
241
|
segments.shift();
|
|
233
242
|
}
|
|
234
243
|
if (!segments.length || !segments.every((seg) => SEG_ADD_RE.test(seg) || SEG_READONLY_RE.test(seg)
|
|
235
|
-
|| SEG_LOCAL_RE.test(seg))) return false;
|
|
244
|
+
|| SEG_FETCH_RE.test(seg) || SEG_LOCAL_RE.test(seg))) return false;
|
|
236
245
|
const main = mainWorktreeOf(dir);
|
|
237
246
|
const branch = main && currentBranch(dir);
|
|
238
247
|
if (!branch || branch.includes('..') || SHARED_BRANCH_RE.test(branch)) return false;
|
|
@@ -339,7 +348,8 @@ function maskMessages(command, shell) {
|
|
|
339
348
|
* - No `agentId`: a sub-agent never pushes, and its local commits are `worktreeExempt`'s to judge.
|
|
340
349
|
* - The command, with its messages masked (`maskMessages`): none of `UNSAFE_CHARS_RE` or
|
|
341
350
|
* `SUBSHELL_CHARS_RE`; every segment an add, a
|
|
342
|
-
* read-only look, a plain commit or merge (`SEG_LOCAL_RE`, or the
|
|
351
|
+
* read-only look, a fetch (`SEG_FETCH_RE`), a plain commit or merge (`SEG_LOCAL_RE`, or the
|
|
352
|
+
* loop's `-F` commit), or a
|
|
343
353
|
* plain push (`SEG_PUSH_RE`) of THIS branch, spelled `<branch>`, `HEAD:<branch>` or
|
|
344
354
|
* `HEAD:refs/heads/<branch>`; after at most one leading `cd <path>`. Bare `git push` asks:
|
|
345
355
|
* `push.default` and the global config decide where it goes, and this read cannot see them.
|
|
@@ -384,7 +394,8 @@ export function ownBranchExempt(command, cwd, agentId, shell = null) {
|
|
|
384
394
|
const taken = [...protectedBranches(root), main && currentBranch(main)].filter(Boolean);
|
|
385
395
|
if (taken.some((b) => b.toLowerCase() === branch.toLowerCase())) return false;
|
|
386
396
|
return segments.every((seg) => {
|
|
387
|
-
if (SEG_ADD_RE.test(seg) || SEG_READONLY_RE.test(seg) ||
|
|
397
|
+
if (SEG_ADD_RE.test(seg) || SEG_READONLY_RE.test(seg) || SEG_FETCH_RE.test(seg) || SEG_LOCAL_RE.test(seg)
|
|
398
|
+
|| SEG_COMMIT_RE.test(seg)) return true;
|
|
388
399
|
const push = SEG_PUSH_RE.exec(seg);
|
|
389
400
|
if (!push) return false;
|
|
390
401
|
const ref = push[2];
|
|
@@ -1583,8 +1594,11 @@ export const cmdRuleGate = guardGate(ruleGate, 'rule-gate');
|
|
|
1583
1594
|
* for PreToolUse), so `gitDecide`/`ruleDecide` keep reading the Claude shape unchanged and
|
|
1584
1595
|
* never learn Bob exists. A no-op for an already-Claude-shaped payload: every field it sets
|
|
1585
1596
|
* is only filled in when the Claude-named field is absent.
|
|
1597
|
+
*
|
|
1598
|
+
* Exported for the in-process loss-table rows of tests/unit/hook_gates.test.mjs, which hand
|
|
1599
|
+
* Bob's own payload shape to `gitDecide` without a spawn per row.
|
|
1586
1600
|
*/
|
|
1587
|
-
function normaliseBobPayload(payload) {
|
|
1601
|
+
export function normaliseBobPayload(payload) {
|
|
1588
1602
|
if (!payload || typeof payload !== 'object') return payload;
|
|
1589
1603
|
const out = { ...payload };
|
|
1590
1604
|
if (!out.tool_input && payload.input && typeof payload.input === 'object') {
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"//": "Every field here is argued and gated in tests/unit/package_manifest.test.mjs. `files`, `bin`, `exports` and `engines` each have a test that fails when reality drifts from this file; `version` mirrors harness.config.json and is gated too. Read that docblock before editing this one.",
|
|
3
3
|
"name": "geneseed",
|
|
4
|
-
"version": "5.
|
|
4
|
+
"version": "5.6.0",
|
|
5
5
|
"description": "A portable, theme-able harness you implant once and use everywhere to grow a disciplined AI coding agent.",
|
|
6
6
|
"keywords": [
|
|
7
7
|
"ai",
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"description": "For a fluent user who delegates: expert posture, foreman mode, aggressive loops, every guardrail except the ownership gate.",
|
|
3
|
+
"hosts": ["opencode", "bob", "claude", "openclaude"],
|
|
4
|
+
"theme": "neutral",
|
|
5
|
+
"footprint": "lean",
|
|
6
|
+
"posture": "expert",
|
|
7
|
+
"mode": "foreman",
|
|
8
|
+
"trust": "aggressive",
|
|
9
|
+
"doctrines": "all",
|
|
10
|
+
"kits": [],
|
|
11
|
+
"contextWindow": "1m",
|
|
12
|
+
"gates": { "ownershipGate": false },
|
|
13
|
+
"login": true
|
|
14
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
{
|
|
2
|
+
"description": "For a locked-down work PC: neutral voice, every guardrail except the ownership gate, strict consent, no login item.",
|
|
3
|
+
"hosts": ["opencode", "bob", "claude", "openclaude"],
|
|
4
|
+
"theme": "neutral",
|
|
5
|
+
"footprint": "lean",
|
|
6
|
+
"posture": "peer",
|
|
7
|
+
"mode": "direct",
|
|
8
|
+
"trust": "prudent",
|
|
9
|
+
"doctrines": "all",
|
|
10
|
+
"kits": [],
|
|
11
|
+
"contextWindow": "200k",
|
|
12
|
+
"gates": { "ownershipGate": false, "ownBranchPass": false },
|
|
13
|
+
"login": false
|
|
14
|
+
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
{
|
|
2
|
+
"description": "For a learner (a junior, a student): neutral voice, mentor posture, every guardrail, the ownership gate included.",
|
|
3
|
+
"hosts": ["opencode", "bob", "claude", "openclaude"],
|
|
4
|
+
"theme": "neutral",
|
|
5
|
+
"footprint": "lean",
|
|
6
|
+
"posture": "mentor",
|
|
7
|
+
"mode": "direct",
|
|
8
|
+
"trust": "prudent",
|
|
9
|
+
"doctrines": "all",
|
|
10
|
+
"kits": [],
|
|
11
|
+
"contextWindow": "200k",
|
|
12
|
+
"login": true
|
|
13
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
{
|
|
2
|
+
"description": "For a small model or a tight token budget: the smallest always-on context, two doctrine packs, niche skills left out.",
|
|
3
|
+
"hosts": ["opencode", "bob", "claude", "openclaude"],
|
|
4
|
+
"theme": "neutral",
|
|
5
|
+
"footprint": "lean",
|
|
6
|
+
"posture": "assistant",
|
|
7
|
+
"mode": "direct",
|
|
8
|
+
"trust": "balanced",
|
|
9
|
+
"doctrines": ["craft", "rigor"],
|
|
10
|
+
"excludeSkills": ["brick-forge", "bruno", "daydream", "factory", "factory-forge", "forge-mcp", "prototype", "react-view-transitions"],
|
|
11
|
+
"kits": [],
|
|
12
|
+
"contextWindow": "200k",
|
|
13
|
+
"gates": { "ownershipGate": false },
|
|
14
|
+
"login": true
|
|
15
|
+
}
|
|
@@ -25,11 +25,12 @@ Builds CI/CD pipelines and delivery automation for Spring Boot applications.
|
|
|
25
25
|
1. Detect the CI the project already uses (GitHub Actions, GitLab CI, Jenkins, other) and extend it; do not switch providers. With none present, ask the user which to use.
|
|
26
26
|
2. Pipeline order: checkout, restore build cache, `./mvnw verify` (or `./gradlew build`), publish test results, build image, scan, push, deploy.
|
|
27
27
|
3. Cache the Maven or Gradle repository keyed on the build files.
|
|
28
|
-
4. Gates: tests, a coverage threshold if the project has one, dependency and image vulnerability scan.
|
|
29
|
-
5.
|
|
30
|
-
6.
|
|
31
|
-
7.
|
|
32
|
-
8.
|
|
28
|
+
4. Gates: tests, a coverage threshold if the project has one, dependency and image vulnerability scan, `kustomize build` of every overlay when the project has them. Testcontainers needs a Docker daemon local to the job (on CircleCI the machine executor: a remote Docker's container ports are unreachable); confirm the integration tests ran (spring-testing skill).
|
|
29
|
+
5. Docker Compose for local dependencies: follow the spring-boot skill's cloud side file (healthchecks).
|
|
30
|
+
6. Build images with the project's chosen method (`spring-boot:build-image` by default); tag with version or commit SHA, never `latest` in production.
|
|
31
|
+
7. Stages dev, staging, prod, with approval before prod.
|
|
32
|
+
8. Secrets come from the CI secret store or a vault, never from files in the repository.
|
|
33
|
+
9. Lint the pipeline file before handing off.
|
|
33
34
|
|
|
34
35
|
## Output contract
|
|
35
36
|
- Files changed, the stage list and what was validated.
|
|
@@ -29,7 +29,9 @@ Deploys Spring Boot 4 applications on Kubernetes.
|
|
|
29
29
|
5. Config: non-sensitive settings in a ConfigMap, credentials in a Secret; env vars bind through relaxed binding (`SPRING_DATASOURCE_URL`).
|
|
30
30
|
6. Scale: HPA on CPU or custom metrics, a PodDisruptionBudget when replicas exceed one.
|
|
31
31
|
7. Pod hardening: `runAsNonRoot`, no privilege escalation, pinned image tags.
|
|
32
|
-
8.
|
|
32
|
+
8. What committed manifests may name, probes for dependencies deployed beside the service, and manifests for several platforms: follow the spring-boot skill's cloud side file.
|
|
33
|
+
9. Check the target before giving deploy steps (`kubectl config current-context`, `oc whoami --show-server`); on OpenShift expose through Routes, not port forwarding.
|
|
34
|
+
10. Validate with a dry run or linter before handing off.
|
|
33
35
|
|
|
34
36
|
## Output contract
|
|
35
37
|
- Files changed and a one-line summary; say what was validated and what was not.
|
|
@@ -24,12 +24,12 @@ Implements Spring Boot 4 / Java 21+ features, following the spring-boot, spring-
|
|
|
24
24
|
## Procedure
|
|
25
25
|
0. Read first, each if it exists — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}): `{{PATH_MEMORY}}/agents/<your-name>.md`, then the feedback notes `{{PATH_NOTES}}/agent-notes/<your-name>.md` and `{{PATH_NOTES}}/agent-notes/_general.md`, then this repo's `{{PATH_PROJECT_NOTES}}/agent-notes/<your-name>.md` and `_general.md` there, which win where they disagree.
|
|
26
26
|
1. Follow the project's existing layout and build tool; match its group id, packages and CI. Lombok is fine when the project already uses it.
|
|
27
|
-
2. Constructor injection; records for request and response DTOs; `@Valid` on request bodies; one `@RestControllerAdvice` for errors.
|
|
27
|
+
2. Constructor injection; records for request and response DTOs; `@Valid` on request bodies; one `@RestControllerAdvice` for errors and `PagedModel` for lists, as the spring-boot skill's web side file shows.
|
|
28
28
|
3. Services: `@Transactional(readOnly = true)` on the class, `@Transactional` on mutating methods. Never call a transactional or `@Async` method through `this`.
|
|
29
29
|
4. Group related settings in `@ConfigurationProperties`, not scattered `@Value`.
|
|
30
30
|
5. Outbound HTTP: `RestClient` for blocking calls, `@HttpExchange` interfaces for declarative clients; keep `WebClient` for reactive code only.
|
|
31
|
-
6. Persistence uses `jakarta.persistence`; never return entities from controllers.
|
|
32
|
-
7. Tests: positive and negative cases; `@MockitoBean` and `@MockitoSpyBean` for replaced beans; Testcontainers with `@ServiceConnection
|
|
31
|
+
6. Persistence uses `jakarta.persistence`; never return entities from controllers. On a relational database the migration tool owns the schema (`ddl-auto: validate`): write the migration in the same change as the entity (spring-data-jpa skill).
|
|
32
|
+
7. Tests: positive and negative cases; `@MockitoBean` and `@MockitoSpyBean` for replaced beans; Testcontainers with `@ServiceConnection`; what the integration tests must cover is in the spring-testing skill.
|
|
33
33
|
8. Defaults worth setting: `server.shutdown=graceful` and `spring.lifecycle.timeout-per-shutdown-phase`.
|
|
34
34
|
9. Run the affected build and tests before handing off ({{LAW:verify-before-asserting}}).
|
|
35
35
|
|
|
@@ -23,15 +23,17 @@ Spring-specific review only. Generic correctness, naming and structure belong to
|
|
|
23
23
|
|
|
24
24
|
## Procedure
|
|
25
25
|
0. Read first, each if it exists — your durable lessons from prior dispatches ({{DOCTRINE:persist-insight}}): `{{PATH_MEMORY}}/agents/<your-name>.md`, then the feedback notes `{{PATH_NOTES}}/agent-notes/<your-name>.md` and `{{PATH_NOTES}}/agent-notes/_general.md`, then this repo's `{{PATH_PROJECT_NOTES}}/agent-notes/<your-name>.md` and `_general.md` there, which win where they disagree.
|
|
26
|
-
1. Read the changed files and the build file to learn the Boot version.
|
|
26
|
+
1. Read the changed files and the build file to learn the Boot version. Review only the change: flag pre-existing code only where the change makes it worse, and never a choice the project documents on purpose.
|
|
27
27
|
2. Check, in this order:
|
|
28
28
|
- Injection: field `@Autowired`, circular dependencies.
|
|
29
29
|
- Transactions: multi-step writes without `@Transactional`; self-invocation bypassing the proxy; transactions held across remote calls.
|
|
30
30
|
- Persistence: N+1 on lazy collections (use `JOIN FETCH` or `@EntityGraph`), unbounded `findAll()`, entities returned from controllers, legacy `javax` persistence imports (the package is `jakarta.persistence`).
|
|
31
|
+
- Schema: an entity change with no migration in the same change, an edited applied migration, `ddl-auto: update` or `create` outside tests.
|
|
32
|
+
- Web: `Page`/`PageImpl` returned from a controller (use `PagedModel`) unless `spring.data.web.pageable.serialization-mode: via-dto` is set; a catch-all handler that returns the exception message; a stale update that does not answer 409.
|
|
31
33
|
- Boot 4 API misuse: the removed Boot test-package mock and spy bean annotations (use `@MockitoBean`/`@MockitoSpyBean`), new `RestTemplate` code or blocking `WebClient` (use `RestClient`), new `TestRestTemplate` tests (prefer `RestTestClient`), `@DynamicPropertySource` where `@ServiceConnection` supports the container, `WebSecurityConfigurerAdapter`.
|
|
32
34
|
- Test slices: `@SpringBootTest` where `@WebMvcTest` or `@DataJpaTest` would do; slices missing their collaborators.
|
|
33
35
|
- Configuration: raw `@Value` for property groups, secrets in committed config.
|
|
34
|
-
- Actuator: endpoints exposed beyond need, `show-details` open to anonymous callers.
|
|
36
|
+
- Actuator: endpoints exposed beyond need, `show-details` open to anonymous callers, probe paths blocked by security (cloud side file).
|
|
35
37
|
3. Verify by running the tests rather than assuming ({{LAW:verify-before-asserting}}).
|
|
36
38
|
|
|
37
39
|
## Output contract
|