@orkestrel/scaffold 0.0.121 → 0.0.123

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/dist/agents/skills/orkestrel-dispatch/scripts/brief.js +57 -9
  2. package/dist/agents/skills/orkestrel-dispatch/scripts/chain.js +22 -2
  3. package/dist/agents/skills/orkestrel-harden/scripts/interleave.js +539 -0
  4. package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +1163 -0
  5. package/dist/agents/skills/orkestrel-publish/scripts/pins.js +5 -5
  6. package/dist/agents/skills/orkestrel-publish/scripts/wave.js +67 -5
  7. package/dist/bin/main.js +8 -6
  8. package/dist/bin/main.js.map +1 -1
  9. package/dist/host/agents/orchestration.md +29 -18
  10. package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +7 -6
  11. package/dist/host/agents/skills/orkestrel-dispatch/references/launch.md +3 -2
  12. package/dist/host/agents/skills/orkestrel-dispatch/scripts/brief.ts +65 -9
  13. package/dist/host/agents/skills/orkestrel-dispatch/scripts/chain.ts +28 -2
  14. package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +4 -2
  15. package/dist/host/agents/skills/orkestrel-falsify/references/brief.md +3 -2
  16. package/dist/host/agents/skills/orkestrel-harden/SKILL.md +24 -11
  17. package/dist/host/agents/skills/orkestrel-harden/references/bindings.md +18 -12
  18. package/dist/host/agents/skills/orkestrel-harden/references/document.md +1 -0
  19. package/dist/host/agents/skills/orkestrel-harden/references/equivalence.md +2 -1
  20. package/dist/host/agents/skills/orkestrel-harden/references/hardening.md +4 -4
  21. package/dist/host/agents/skills/orkestrel-harden/references/methods.md +642 -0
  22. package/dist/host/agents/skills/orkestrel-harden/scripts/interleave.ts +665 -0
  23. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +16 -15
  24. package/dist/host/agents/skills/orkestrel-parallel/references/{claude.md → claude-code.md} +13 -13
  25. package/dist/host/agents/skills/orkestrel-parallel/references/t3.md +1 -0
  26. package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +1433 -0
  27. package/dist/host/agents/skills/orkestrel-publish/SKILL.md +12 -9
  28. package/dist/host/agents/skills/orkestrel-publish/references/release.md +2 -2
  29. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +39 -8
  30. package/dist/host/agents/skills/orkestrel-publish/references/window.md +5 -1
  31. package/dist/host/agents/skills/orkestrel-publish/scripts/pins.ts +5 -5
  32. package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +86 -7
  33. package/dist/host/claude/AGENTS.md +2 -2
  34. package/dist/host/claude/agents/analyst.md +1 -1
  35. package/dist/host/claude/agents/builder.md +1 -1
  36. package/dist/host/claude/agents/distiller.md +2 -1
  37. package/dist/host/claude/agents/grok.md +2 -2
  38. package/dist/host/claude/agents/opus.md +8 -7
  39. package/dist/host/claude/agents/orkestrel.md +7 -7
  40. package/dist/host/claude/agents/planner.md +3 -3
  41. package/dist/host/claude/agents/reviewer.md +3 -3
  42. package/dist/host/claude/agents/scout.md +2 -1
  43. package/dist/host/claude/agents/verifier.md +2 -2
  44. package/dist/host/claude/rules/campaign.md +15 -13
  45. package/dist/host/claude/rules/documentation.md +1 -0
  46. package/dist/host/claude/rules/names.md +13 -7
  47. package/dist/host/claude/rules/patterns.md +14 -0
  48. package/dist/host/claude/rules/quality.md +4 -1
  49. package/dist/host/claude/rules/tests.md +5 -1
  50. package/dist/host/claude/rules/workspace.md +9 -0
  51. package/dist/host/claude/rules/writing.md +1 -1
  52. package/dist/host/claude/skills/orkestrel-harden/SKILL.md +1 -1
  53. package/dist/host/claude/skills/orkestrel-parallel/SKILL.md +1 -1
  54. package/dist/host/codex/agents/analyst.toml +6 -6
  55. package/dist/host/codex/agents/astra.toml +1 -1
  56. package/dist/host/codex/agents/builder.toml +1 -1
  57. package/dist/host/codex/agents/distiller.toml +4 -2
  58. package/dist/host/codex/agents/grok.toml +5 -2
  59. package/dist/host/codex/agents/opus.toml +6 -4
  60. package/dist/host/codex/agents/planner.toml +6 -5
  61. package/dist/host/codex/agents/reviewer.toml +9 -8
  62. package/dist/host/codex/agents/scout.toml +5 -1
  63. package/dist/host/codex/agents/verifier.toml +8 -3
  64. package/dist/host/dotfiles/gitignore +1 -2
  65. package/dist/host/guides/agent.md +1119 -457
  66. package/dist/host/guides/ndjson.md +81 -21
  67. package/dist/host/guides/ollama.md +22 -18
  68. package/dist/host/guides/probe.md +29 -27
  69. package/dist/host/guides/scaffold.md +42 -15
  70. package/dist/host/guides/study.md +538 -450
  71. package/dist/host/manifest.json +81 -63
  72. package/dist/host/tests/config.test.ts +7 -0
  73. package/dist/src/core/index.cjs +14 -8
  74. package/dist/src/core/index.cjs.map +1 -1
  75. package/dist/src/core/index.d.cts +1 -4
  76. package/dist/src/core/index.d.ts +1 -4
  77. package/dist/src/core/index.js +14 -8
  78. package/dist/src/core/index.js.map +1 -1
  79. package/dist/src/server/index.cjs +87 -8
  80. package/dist/src/server/index.cjs.map +1 -1
  81. package/dist/src/server/index.d.cts +50 -6
  82. package/dist/src/server/index.d.ts +50 -6
  83. package/dist/src/server/index.js +87 -10
  84. package/dist/src/server/index.js.map +1 -1
  85. package/package.json +2 -2
@@ -21,13 +21,13 @@ description: Run an Orkestrel release from layer order to registry confirmation,
21
21
 
22
22
  ## Scripts
23
23
 
24
- | Script | Does |
25
- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
26
- | `scripts/compare.ts` | `[--package NAME] [--version V] [--tarball PATH] [--dist dist] [--json]`, run from the package root after its build: fetches the published tarball and lists the material differences from the rebuilt `dist/` (sourcemaps excluded, whitespace-only differences ignored). Exit 0 when nothing differs, 3 when something does, 2 when the tarball cannot be read, 64 on usage (no package name, no `dist/`, or `--tarball` with no path). |
27
- | `scripts/pins.ts` | `--version PRIOR [--range PRIOR_RANGE ...] [--paths src,tests] [--json]`, run from the package root: lists every line under the paths carrying the prior version literal or a prior range literal, once per line, sweeping a one-comparator range such as `^8.3.0` for its bare version in any form. Exit 0 with no hits, 3 with hits, 64 on usage (no literal, or a flag with no value). |
28
- | `scripts/swap.ts` | One mode per run, from any directory: `--pin --consumer DIR --source DIR [--source DIR ...] [--override NAME ...] [--no-build] [--dry-run] [--json]` refuses a source whose packed manifest names a local dependency spec in any dependency field (a `file:` or `link:` prefix, a path start of `.`, `~/`, `/`, `\`, or a drive letter, or a protocol-free archive name ending in `.tgz`, `.tar.gz`, or `.tar` that is not a `user/repo` shorthand), builds and packs each source into `<consumer>/tmp/tarballs/` under a name carrying its SHA-256, records each replaced range in the ledger `pins.json` there, the record of which build the consumer runs, writes each tarball's absolute `file:` spec and each `--override` (repeatable, like `--source`) where oxfmt sorts it, installs, and proves that every pinned source, an override-only one included, is installed with the source's bytes; `--restore --consumer DIR [--package NAME ...] [--json]` puts back each recorded range and override, keeps an `overrides` block that existed before the pin, installs, proves the restored copy, and lists the re-pin arguments, and refuses with 64, before it writes anything, a ledger whose package or override keys are not package names or whose removal would leave `node_modules`; `--status --consumer DIR [--json]` writes nothing and reports drift between the ledger, the manifest, the tarballs, the installed bytes, and the source commits, a manifest spec holding its tarball only when it names the ledger archive's location. `--pin` and `--restore` write a receipt under `tmp/units/`. Exit 0 on success, 1 when a command or a proof failed, 3 when `--status` reports drift, 64 on usage. |
29
- | `scripts/wave.ts` | `--visit [--target DIR] [--offline] [--regenerate] [--from STEP] [--to STEP] [--prior VERSION] [--dry-run] [--json] [--out FILE]` runs one repository's visit in the order [wave.md](references/wave.md) § Visit a repository fixes (pin, commit, overwrite, verify, install, pins, format, record, gates, compare), stops at the first failing step, journals each executed step's full output under the target's `tmp/units/wave/` when the work tree ignores `tmp/` and names the journal in its row, and prints each step's exit (a failed step names the `code: message` refusal or the `note` a JSON verb writes on stdout, else the last stderr lines), the bump ruling (the rebuilt dist against the published tarball, and the final runtime dependency set against the published manifest), and a row for `.orkestrel/release.md`; `--prior` names the version a pre-ruled bump replaced so the self-pin sweep finds it; `--plan` prints the packages by layer from the catalog table. An install that fails `ERESOLVE` names the rerun command, and `--regenerate` replaces the lockfile and `node_modules` from the manifest under the refusals and proof [wave.md](references/wave.md) § Regenerate a lock the install cannot move states; `record` commits the overwrite's writes as `Overwrite with scaffold VERSION`, then paths dirtied only by that invocation's successful `format` step as `Format with oxfmt VERSION`, reading the formatter version from the target's installed manifest and attributing paths from dirty sets collected immediately before and after formatting; it refuses every other dirty path by name before committing. On `--from record`, it reports the absent format evidence and commits only the overwrite receipt's paths and the manifest pair. The visit runs the target's own executable as scaffold only when the target's manifest names `@orkestrel/scaffold`, and otherwise refuses, naming the install the target needs. Exit 0 when every step passed, 1 when one failed, 2 when a reading failed, 64 on usage, including `--regenerate` with `--plan`. |
30
- | `scripts/window.ts` | `--whoami [--wait SECONDS]` reads or polls `npm whoami`; `--login` prints the operator's login command and polls `whoami` until it answers; `--publish DIR... --otp CODE` refuses a batch whose nearest `.git` entry is a file, including ancestor entries, with exit 3 before contacting npm; it names a linked worktree's primary clone or identifies a submodule, then uploads back to back with `npm publish --ignore-scripts --otp`, journals each upload under `tmp/units/`, stops at the first refusal naming where to resume, and confirms each accepted version against the registry; `--confirm NAME@VERSION...` re-reads the registry until it serves the version. Exit 0 on success, 3 when not, 64 on usage. |
24
+ | Script | Does |
25
+ | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
26
+ | `scripts/compare.ts` | `[--package NAME] [--version V] [--tarball PATH] [--dist dist] [--json]`, run from the package root after its build: fetches the published tarball and lists the material differences from the rebuilt `dist/` (sourcemaps excluded, whitespace-only differences ignored). Exit 0 when nothing differs, 3 when something does, 2 when the tarball cannot be read, 64 on usage (no package name, no `dist/`, or `--tarball` with no path). |
27
+ | `scripts/pins.ts` | `--version PRIOR [--range PRIOR_RANGE ...] [--paths src,tests,guides] [--json]`, run from the package root: lists every line under the paths (`src`, `tests`, and `guides` by default) carrying the prior version literal or a prior range literal, once per line, sweeping a one-comparator range such as `^8.3.0` for its bare version in any form. Exit 0 with no hits, 3 with hits, 64 on usage (no literal, or a flag with no value). |
28
+ | `scripts/swap.ts` | One mode per run, from any directory: `--pin --consumer DIR --source DIR [--source DIR ...] [--override NAME ...] [--no-build] [--dry-run] [--json]` refuses a source whose packed manifest names a local dependency spec in any dependency field (a `file:` or `link:` prefix, a path start of `.`, `~/`, `/`, `\`, or a drive letter, or a protocol-free archive name ending in `.tgz`, `.tar.gz`, or `.tar` that is not a `user/repo` shorthand), builds and packs each source into `<consumer>/tmp/tarballs/` under a name carrying its SHA-256, records each replaced range in the ledger `pins.json` there, the record of which build the consumer runs, writes each tarball's absolute `file:` spec and each `--override` (repeatable, like `--source`) where oxfmt sorts it, installs, and proves that every pinned source, an override-only one included, is installed with the source's bytes; `--restore --consumer DIR [--package NAME ...] [--json]` puts back each recorded range and override, keeps an `overrides` block that existed before the pin, installs, proves the restored copy, and lists the re-pin arguments, and refuses with 64, before it writes anything, a ledger whose package or override keys are not package names or whose removal would leave `node_modules`; `--status --consumer DIR [--json]` writes nothing and reports drift between the ledger, the manifest, the tarballs, the installed bytes, and the source commits, a manifest spec holding its tarball only when it names the ledger archive's location. `--pin` and `--restore` write a receipt under `tmp/units/`. Exit 0 on success, 1 when a command or a proof failed, 3 when `--status` reports drift, 64 on usage. |
29
+ | `scripts/wave.ts` | `--visit [--target DIR] [--offline] [--regenerate] [--from STEP] [--to STEP] [--prior VERSION] [--dry-run] [--json] [--out FILE]` runs one repository's visit in the order [wave.md](references/wave.md) § Visit a repository fixes (pin, commit, overwrite, verify, install, pins, format, record, gates, compare), stops at the first failing step, journals each executed step's full output under the target's `tmp/units/wave/` when the work tree ignores `tmp/` and names the journal in its row, and prints each step's exit (a failed step names the `code: message` refusal or the `note` a JSON verb writes on stdout, else the last stderr lines), the bump ruling (the rebuilt dist against the published tarball, and the final runtime dependency set against the published manifest), and a row for `.orkestrel/release.md`; `--prior` names the version a pre-ruled bump replaced so the self-pin sweep finds it; the `pins` step sweeps every range that moved since that version's `Release <version>` commit as well as every range the visit moved, and a run that executes the sweep names its source in the row; `--plan` prints the packages by layer from the catalog table. An install that fails `ERESOLVE` names the rerun command, and `--regenerate` replaces the lockfile and `node_modules` from the manifest under the refusals and proof [wave.md](references/wave.md) § Regenerate a lock the install cannot move states; `record` commits the overwrite's writes as `Overwrite with scaffold VERSION`, then paths dirtied only by that invocation's successful `format` step as `Format with oxfmt VERSION`, reading the formatter version from the target's installed manifest and attributing paths from dirty sets collected immediately before and after formatting; it refuses every other dirty path by name before committing. On `--from record`, it reports the absent format evidence and commits only the overwrite receipt's paths and the manifest pair. The visit runs the target's own executable as scaffold only when the target's manifest names `@orkestrel/scaffold`, and otherwise refuses, naming the install the target needs. Exit 0 when every step passed, 1 when one failed, 2 when a reading failed, 64 on usage, including `--regenerate` with `--plan`. |
30
+ | `scripts/window.ts` | `--whoami [--wait SECONDS]` reads or polls `npm whoami`; `--login` prints the operator's login command and polls `whoami` until it answers; `--publish DIR... --otp CODE` refuses a batch whose nearest `.git` entry is a file, including ancestor entries, with exit 3 before contacting npm; it names a linked worktree's primary clone or identifies a submodule, then uploads back to back with `npm publish --ignore-scripts --otp`, journals each upload under `tmp/units/`, stops at the first refusal naming where to resume, and confirms each accepted version against the registry; `--confirm NAME@VERSION...` re-reads the registry until it serves the version. Exit 0 on success, 3 when not, 64 on usage. |
31
31
 
32
32
  The user's current instruction wins. `references/release.md` binds every release: the credential and authorization law, the upload serialization, the tarball swap, what a bump obliges downstream, and the layer order. Nothing here weakens it. Where this skill disagrees with it, report the drift instead of following the skill.
33
33
 
@@ -56,7 +56,8 @@ The user's current instruction wins. `references/release.md` binds every release
56
56
  § Prepare a layer.
57
57
 
58
58
  Run that sequence for every layer, from the registry reading to the registry close;
59
- [wave.md](references/wave.md) § Refresh the registry between layers owns the refresh.
59
+ [wave.md](references/wave.md) § Refresh the registry between layers owns the refresh. After the
60
+ last layer of a fleet wave serves, close the wave per [wave.md](references/wave.md) § Close the wave.
60
61
 
61
62
  ## Accept the release
62
63
 
@@ -71,7 +72,9 @@ Completion requires:
71
72
  - every gate that proved a package ran outside the window and against the artifact that shipped;
72
73
  - every gate red at a package's baseline for a cause `ROADMAP.md` already carries is recorded as a
73
74
  standing reading beside the package's row with its carrier, and the release report names it. A
74
- standing reading is not a gate the release ran.
75
+ standing reading is not a gate the release ran;
76
+ - every standing host-bound reading with no `ROADMAP.md` item for its cause is recorded in
77
+ `.orkestrel/release.md`, and the release report names that cause for a `ROADMAP.md` item.
75
78
 
76
79
  Report the layers in publish order, each package with its registry-confirmed version, the bump
77
80
  rulings and their evidence, the approvals the user granted, and anything still unpublished. End
@@ -30,11 +30,11 @@ When a consumer needs a dependency's unpublished source, to meet a defect that l
30
30
  - A development `devDependencies` bump reaches nobody: re-pin, prove the gates green, commit to `main`; do not bump or publish.
31
31
  - A development bump that moves the published artifact is a runtime bump. Prove the direction with the build: rebuild after the re-pin and run `node .agents/skills/orkestrel-publish/scripts/compare.ts`, which compares `dist/` against the published tarball on material content only. Exit 3 bumps and publishes that package, and its dependents follow the runtime rule.
32
32
  - A `0.0.x` caret pins one exact release, so the fleet publishes in topological layer order derived from runtime `dependencies` and `peerDependencies` edges, never from a development edge.
33
- - Read each package's version and layer from the catalog table in `.claude/agents/orkestrel.md`, regenerated with `scaffold catalog` before sequencing a cascade. Never write a second order elsewhere.
33
+ - Read each package's version and layer from the catalog table in `.claude/agents/orkestrel.md`, refreshed per [wave.md](wave.md) § Prepare a layer before sequencing a cascade. Never write a second order elsewhere.
34
34
 
35
35
  ## The scaffold surface
36
36
 
37
- - After a package's first publish, run `scaffold catalog --all` in the scaffold checkout and release scaffold, so the `surface` rule reads the package's guide from that release.
37
+ - After a package's first publish, refresh the catalog in the scaffold checkout per [wave.md](wave.md) § Prepare a layer and release scaffold, so the `surface` rule reads the package's guide from that release.
38
38
  - When a `@orkestrel/guide` release refuses a guide form its parser read before, push each catalog package's conforming guide to that package's `main`, the releasing package's own included, before the scaffold release that carries the catalog refresh; the `surface` rule parses every hosted guide, a target's own among them.
39
39
  - `scaffold` is a development dependency of every package, so it publishes on its own and propagates as files, never as a cascade. Each package builds against the published `scaffold`.
40
40
  - `scaffold` ships `dist/host`, the vendored file set every target receives through `repair`. Bump and publish `scaffold` when any vendored byte or the set of vendored paths changes.
@@ -107,13 +107,16 @@ skips the catalog step and exits `1` with a note naming that refusal, so run the
107
107
 
108
108
  When the target is the `@orkestrel/scaffold` package, expect the runner to record the overwrite step
109
109
  as skipped and to read the verify audit's foreign-path findings as expected; never run the `scaffold repair` or `scaffold overwrite` command
110
- against that checkout.
110
+ against that checkout. After `scripts/swap.ts --restore` there, re-pin every `@orkestrel` range to
111
+ the caret of the version the registry serves, install, and build before the visit, because the
112
+ visit runs the checkout's own built `dist`.
111
113
 
112
114
  When a refused build leaves no `dist/host` for `scaffold catalog`, run a verified published scaffold
113
115
  executable from owned scratch to refresh the catalog, then rerun the build.
114
116
 
115
- Run visits in parallel slices of disjoint repositories, each slice strictly serial inside itself,
116
- reporting per target. Refuse a failed target, name it, repair it, and re-run it alone.
117
+ Run visits one at a time under `.agents/skills/orkestrel-parallel/SKILL.md` § Bound the host,
118
+ reporting per target. Refuse a failed target, name it, repair it, and rerun it alone; class a
119
+ failure that passes alone per `.agents/skills/orkestrel-dispatch/SKILL.md` § Write the brief.
117
120
 
118
121
  ### Regenerate a lock the install cannot move
119
122
 
@@ -167,7 +170,9 @@ registry copy over any staged tip, so every consumer stays red until that tip is
167
170
 
168
171
  ## Prepare a layer
169
172
 
170
- - After the re-pin and before `prepublishOnly`, run `scaffold surface` live over every candidate checkout of the layer, never with `--offline`. Stop the upload on any exit but `0`, and resolve every name it reports under `.claude/rules/names.md` § Fleet name ownership. In scaffold's own layer, run `scaffold catalog`, then `npm run build`, so `host.json` records the refreshed files' digests, and then `scaffold surface --from .`.
173
+ - After the re-pin and before `prepublishOnly`, run `scaffold surface` live over every candidate checkout of the layer, never with `--offline`. Stop the upload on any exit but `0`, and resolve every name it reports under `.claude/rules/names.md` § Fleet name ownership.
174
+ - When the candidate is a package scaffold loads at run time (`@orkestrel/guide`) and the scaffold its checkout installs exports `resolveSurfaceLoader` from `@orkestrel/scaffold/server`, run `npm run build` in that checkout, then run `scaffold surface` from it; the run loads the package through the checkout's own exports and refuses with `TARGET` while its build output is absent. When the installed scaffold lacks that export, run `scaffold surface` from a published scaffold install that resolves the package, with `--target` naming the candidate.
175
+ - In scaffold's own layer, run `scaffold catalog --all`; track each mirror it adds with `git add`; add each added mirror's path to the declared vendored inventory in `tests/distribution.test.ts`; then run `npm run build`, so `host.json` records the refreshed files' digests, and then `scaffold surface --from .`.
171
176
  - In the scaffold release that opens a transfer under `.claude/rules/names.md` § Fleet name ownership rule 5, declare it in `SURFACE_TRANSFERS` before `npm run build`. In the scaffold visit that closes it, remove the declaration before the build and confirm `host.json` no longer records the name.
172
177
  - When `scaffold surface` prints an advisory, rule it under `.claude/rules/names.md` § Fleet name ownership before the upload; an advisory never stops the upload.
173
178
  - Begin each release chain plan with the clean reinstall and the clean, whether it runs in a clone or the checkout.
@@ -191,10 +196,16 @@ Prepare a published package's layer in this order, after the visit has ruled the
191
196
  bumped manifest.
192
197
  3. **Sweep the self-pins**, per the following section: the bump moves the version class.
193
198
  4. **Run `prepublishOnly` to green on the candidate commit, in a fresh clone or, where the user rules clones out, in the checkout, in the order the package's own chain fixes.** Run every release step whose inputs remain valid after a failure and report each result. Before using a serial chain that stops on failure, split aggregate commands into their component steps and record each step's prerequisites. After a failure, run the independent steps in separate chains, mark dependent steps blocked, and keep the release result failed while a required step fails or remains blocked.
194
- Run the visit and this script on a Node whose bundled npm meets the `MINIMUM_NPM_VERSION` floor a
195
- generated workspace declares in `devEngines`: the scripts spawn the npm CLI beside the running
196
- Node binary when one is there, so a `PATH` change reaches them only where none is.
199
+ Run this chain and the visit's gates on the newest release of the lowest Node major the
200
+ package's `engines.node` admits, on a Node whose bundled npm meets the `MINIMUM_NPM_VERSION`
201
+ floor a generated workspace declares in `devEngines`, launched under the `PATH` the
202
+ `orkestrel-dispatch` skill's reference Long-running commands § Launch requires. The publish
203
+ scripts spawn the npm CLI beside the running Node binary when one is there, whatever `PATH`
204
+ holds.
197
205
  5. **Write the release commit before the window opens. Push it only after the registry serves its version.**
206
+ While a release commit waits for its upload, dispatch no writer into that checkout. When one
207
+ ran, upload from a `git archive` export of the release commit, installed with `npm ci`, built,
208
+ and proved by `test:distribution -- --mode release` apart from the checkout.
198
209
 
199
210
  Where an inventory taken before the round already ruled every dist moved, apply the bump before
200
211
  the visit, pass the replaced version through `--prior` so the self-pin sweep finds it, and complete
@@ -216,7 +227,10 @@ re-pin install, not after the manifest edit.
216
227
 
217
228
  - Run `node .agents/skills/orkestrel-publish/scripts/pins.ts --version <prior> --range <prior range> ...`
218
229
  with the prior version and the prior range of every re-pinned dependency, rule on every hit, and
219
- move every generated-manifest snapshot hit with its re-pin.
230
+ move every generated-manifest snapshot hit with its re-pin. The visit's `pins` step passes every
231
+ range that moved since the prior version's `Release <version>` commit beside the ranges the visit
232
+ moved, and `pins.ts` sweeps `src`, `tests`, and `guides` by default; on a run by hand, pass the
233
+ same ranges with `--range`.
220
234
  A canned packument in a fixture and a looked-up version in a CLI suite carry the version with no
221
235
  tripwire comment beside them, and a generated-manifest fixture carries the ranges and never the
222
236
  package's own version, so one run names both classes.
@@ -244,3 +258,20 @@ takes the self-pin sweep too, because the snapshot class moves with no bump.
244
258
  an install in that gap fails `E404`.
245
259
  - Run every visit and install that follows a publish with `npm_config_prefer_online=true`. A
246
260
  cached packument answers `notarget` for a version the registry already serves.
261
+
262
+ ## Close the wave
263
+
264
+ After the last layer serves, re-pin the development ranges the visits left behind. A visit re-pins
265
+ only what the registry serves when it runs, so a `devDependencies` range naming a package that a
266
+ later layer published still names the earlier release, and the install nests older copies of that
267
+ package's own dependencies.
268
+
269
+ 1. Take a registry sweep after the last window confirms. In every catalog package, list each
270
+ `devDependencies` range on an `@orkestrel` package that trails the release the sweep reads.
271
+ 2. In each listed package, re-pin those ranges to the caret of the served release, install, and
272
+ sweep the self-pins per § Sweep the self-pins, because the snapshot class moves with no bump.
273
+ 3. Run the package's gates, then rule its bump under § Rule on the bump. Commit the re-pin of a
274
+ package the ruling leaves unbumped as `Re-pin <names> development ranges`; prepare and publish
275
+ each bumped package per § Prepare a layer, in layer order.
276
+ 4. Take the sweep again after those publishes, because each release they add can leave another
277
+ package's development range trailing. Close the wave when a sweep lists no trailing range.
@@ -91,7 +91,11 @@ rest of the layer either fits inside it or takes another approval.
91
91
  `npm publish --ignore-scripts --otp=<code>` command uploads with no browser authorization and no
92
92
  poll. The code has its own life: measured on 2026-09-04 against `registry.npmjs.org`, one code
93
93
  carried every upload of a layer started within about a minute of its first use, and a code read
94
- before its layer was ready was refused at its first upload.
94
+ before its layer was ready was refused at its first upload. Measured on 2026-10-31 against the
95
+ same registry, one code carried 11 of 14 uploads in one batch before `EOTP` refused the 12th, and
96
+ 13 of 13 in another.
97
+ - Read the session with `window.ts --whoami` before asking the user for a code; when it answers
98
+ nothing, run `window.ts --login` first.
95
99
  - Prepare the whole layer, then ask for one code at the moment the layer's first upload starts, and
96
100
  chase the layer's uploads back-to-back inside that code's life with no gate between them. A code
97
101
  read minutes earlier is already spent.
@@ -1,6 +1,6 @@
1
- // Sweep source and tests for a prior version or range literal after a bump or a re-pin. Run from
2
- // the publishing package's root:
3
- // node .agents/skills/orkestrel-publish/scripts/pins.ts --version 0.0.76 [--range ^0.0.16 ...] [--paths src,tests] [--json]
1
+ // Sweep source, tests, and guides for a prior version or range literal after a bump or a re-pin.
2
+ // Run from the publishing package's root:
3
+ // node .agents/skills/orkestrel-publish/scripts/pins.ts --version 0.0.76 [--range ^0.0.16 ...] [--paths src,tests,guides] [--json]
4
4
  // `--range` repeats. A version hit is the literal bounded by characters other than digits and dots,
5
5
  // so `~0.0.76` and `"0.0.76"` both hit and `0.0.760` does not. A range that is one comparator over
6
6
  // one version (`^8.3.0`, `~8.3.0`, `>=8.3.0`, `v8.3.0`) hits its bare version in any form, bounded the
@@ -35,7 +35,7 @@ export const FLAGS: readonly string[] = ['--version', '--range', '--paths', '--j
35
35
 
36
36
  /** Holds the usage line the script prints on a usage refusal. */
37
37
  export const USAGE =
38
- 'usage: pins.ts --version PRIOR [--range PRIOR_RANGE ...] [--paths src,tests] [--json]'
38
+ 'usage: pins.ts --version PRIOR [--range PRIOR_RANGE ...] [--paths src,tests,guides] [--json]'
39
39
 
40
40
  /** Describes one requested literal and the pattern that finds it in a line. */
41
41
  export interface Literal {
@@ -255,7 +255,7 @@ export function main(argv: readonly string[]): number {
255
255
  }
256
256
  const version = readOptions(argv, '--version')[0]
257
257
  const ranges = readOptions(argv, '--range')
258
- const paths = (readOptions(argv, '--paths')[0] ?? 'src,tests').split(',')
258
+ const paths = (readOptions(argv, '--paths')[0] ?? 'src,tests,guides').split(',')
259
259
  if (version === undefined && ranges.length === 0) {
260
260
  console.error(USAGE)
261
261
  return 64
@@ -10,8 +10,9 @@
10
10
  // is staged from that checkout), verify (`scaffold audit --json` prints the releases envelope and
11
11
  // the audit's writable dependency population matches its lookup bounds; on @orkestrel/scaffold itself an audit exit of 1 is
12
12
  // read as the expected foreign-path findings of its own canonical sources), install,
13
- // pins (the self-pin sweep with --prior or the manifest version and every range the visit moved; hits are reported, not
14
- // fatal), format, record (commit the overwrite paths, then this run's formatter rewrites), gates
13
+ // pins (the self-pin sweep with --prior or the manifest version and every range that moved since
14
+ // that version's `Release <version>` commit or during the visit; hits are reported, not fatal),
15
+ // format, record (commit the overwrite paths, then this run's formatter rewrites), gates
15
16
  // (format:check, lint:check, check, build, test), and compare (the rebuilt
16
17
  // dist against the published tarball, and the final runtime dependency set against the published
17
18
  // manifest `npm view NAME --json` serves; both readings are reported, not fatal). The summary
@@ -1745,9 +1746,77 @@ export function runVerify(
1745
1746
  )
1746
1747
  }
1747
1748
 
1749
+ /**
1750
+ * Reads the ranges the manifest declared in the commit that released a version.
1751
+ *
1752
+ * @remarks
1753
+ * The fleet's release commit carries the subject `Release <version>` and touches the manifest, and
1754
+ * the upload is exported from it, so its manifest holds the ranges the version shipped. A re-pin
1755
+ * made after it, committed or not, differs from those ranges, which `HEAD` alone cannot show.
1756
+ *
1757
+ * @param target - The target directory.
1758
+ * @param version - The released version.
1759
+ * @returns The ranges keyed by `field name` from the newest commit whose subject is exactly
1760
+ * `Release <version>`, or undefined when the target is no work tree, no such commit touched its
1761
+ * manifest, or that manifest is unreadable.
1762
+ */
1763
+ export function readReleasedRanges(
1764
+ target: string,
1765
+ version: string,
1766
+ ): ReadonlyMap<string, string> | undefined {
1767
+ const subject = `Release ${version}`
1768
+ const log = spawnSync(
1769
+ 'git',
1770
+ ['log', '--format=%H %s', '--fixed-strings', `--grep=${subject}`, '--', 'package.json'],
1771
+ { cwd: target, encoding: 'utf8', windowsHide: true, maxBuffer: 64 * 1024 * 1024 },
1772
+ )
1773
+ if (log.status !== 0) return undefined
1774
+ const commit = log.stdout
1775
+ .split(/\r\n|\n/u)
1776
+ .map((line) => /^([0-9a-f]+) (.*)$/u.exec(line))
1777
+ .find((match) => match?.[2] === subject)?.[1]
1778
+ if (commit === undefined) return undefined
1779
+ const shown = spawnSync('git', ['show', `${commit}:./package.json`], {
1780
+ cwd: target,
1781
+ encoding: 'utf8',
1782
+ windowsHide: true,
1783
+ maxBuffer: 64 * 1024 * 1024,
1784
+ })
1785
+ const manifest = shown.status === 0 ? parseJsonRecord(shown.stdout) : undefined
1786
+ return manifest === undefined ? undefined : readRanges(manifest, RANGE_FIELDS)
1787
+ }
1788
+
1789
+ /**
1790
+ * Collects every prior range that no longer stands in the final ranges.
1791
+ *
1792
+ * @param after - The ranges the manifest declares after the visit.
1793
+ * @param priors - Each earlier reading of the ranges, such as the release commit's and the visit's
1794
+ * starting ones.
1795
+ * @returns Each distinct range an earlier reading declared under a key whose final range differs,
1796
+ * in reading order.
1797
+ */
1798
+ export function collectPriorRanges(
1799
+ after: ReadonlyMap<string, string>,
1800
+ priors: ReadonlyArray<ReadonlyMap<string, string>>,
1801
+ ): readonly string[] {
1802
+ return [
1803
+ ...new Set(
1804
+ priors.flatMap((prior) =>
1805
+ [...prior].filter(([key, range]) => after.get(key) !== range).map(([, range]) => range),
1806
+ ),
1807
+ ),
1808
+ ]
1809
+ }
1810
+
1748
1811
  /**
1749
1812
  * Runs the pins step.
1750
1813
  *
1814
+ * @remarks
1815
+ * The sweep takes every range that moved since the prior version's release commit as well as every
1816
+ * range the visit moved, so a re-pin made before the visit is swept too. Without that commit, or
1817
+ * under --dry-run, it takes the visit's moves alone; a run that executes the sweep names its source
1818
+ * in the row's note.
1819
+ *
1751
1820
  * @param runner - The visit's state.
1752
1821
  * @param before - The ranges the manifest declared before the visit.
1753
1822
  * @param version - The version to sweep for, or undefined when none is known.
@@ -1758,20 +1827,30 @@ export function runPins(
1758
1827
  before: ReadonlyMap<string, string>,
1759
1828
  version: string | undefined,
1760
1829
  ): number | undefined {
1761
- const after = readRanges(readManifest(runner.target) ?? {}, RANGE_FIELDS)
1762
- const prior = [...before]
1763
- .filter(([name, range]) => after.get(name) !== range)
1764
- .flatMap(([, range]) => ['--range', range])
1765
1830
  if (version === undefined) {
1766
1831
  appendStep(runner, 'pins', basename(PINS), 'no prior version to sweep for; pass --prior')
1767
1832
  return undefined
1768
1833
  }
1834
+ const after = readRanges(readManifest(runner.target) ?? {}, RANGE_FIELDS)
1835
+ const released = runner.dry ? undefined : readReleasedRanges(runner.target, version)
1836
+ const prior = collectPriorRanges(after, released === undefined ? [before] : [released, before])
1837
+ const source =
1838
+ released === undefined
1839
+ ? `no "Release ${version}" commit touched package.json; swept the ranges this visit moved`
1840
+ : `swept the ranges moved since the "Release ${version}" commit and by this visit`
1769
1841
  const swept = runStep(
1770
1842
  runner,
1771
1843
  'pins',
1772
1844
  process.execPath,
1773
- [PINS, '--version', version, ...prior],
1845
+ [PINS, '--version', version, ...prior.flatMap((range) => ['--range', range])],
1774
1846
  runner.target,
1847
+ (result) => {
1848
+ const verdict = readVerdict(result)
1849
+ return {
1850
+ ...verdict,
1851
+ note: [verdict.note, source].filter((part) => part !== undefined).join('; '),
1852
+ }
1853
+ },
1775
1854
  )
1776
1855
  return swept === undefined
1777
1856
  ? undefined
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## Dispatch
6
6
 
7
- - `.agents/skills/orkestrel-parallel/references/claude.md` owns starting, continuing, tracking, and backgrounding lanes in Claude Code, and its quirks. Choose continuation or a fresh context per `.agents/orchestration.md` § Sessions and consultation.
7
+ - `.agents/skills/orkestrel-parallel/references/claude-code.md` owns starting, continuing, tracking, and backgrounding lanes in Claude Code, and its quirks. Choose continuation or a fresh context per `.agents/orchestration.md` § Sessions and consultation.
8
8
  - Serialize writing Workflow nodes, and give every `agent()` node a model alias from § Models and an effort.
9
9
  - Probe a bench with `node .agents/skills/orkestrel-dispatch/scripts/bench.ts`, launch a lane through `scripts/launch.ts`, and read its answer with `scripts/result.ts`, all from the dispatch skill. `.agents/platforms/<platform>.md` owns the host shell's quirks.
10
10
 
@@ -25,7 +25,7 @@
25
25
 
26
26
  ## Wiring
27
27
 
28
- - `.mcp.json` registers `probe` from `node_modules/@orkestrel/probe/dist/bin/main.js`. Run `npm ci --ignore-scripts` before the first `prove` call in a fresh checkout.
28
+ - In the `@orkestrel/scaffold` checkout, `.mcp.json` registers `probe` from `node_modules/@orkestrel/probe/dist/bin/main.js`; run `npm ci --ignore-scripts` before the first `prove` call in a fresh checkout. A target holds no `.mcp.json`, so register `probe` there per `.claude/rules/quality.md` § Instruments.
29
29
  - `.claude/settings.json` hooks: `SessionStart` runs the Cloud setup hooks under `scripts/` and the dispatch skill's `sweep.ts --report`; `Stop` runs `git diff --check`. `scripts/` holds Cloud setup hooks and nothing else.
30
30
  - `claude mcp serve` exposes this harness to a Codex- or Cursor-primary session.
31
31
  - `.claude/skills/<name>/SKILL.md` loads `.agents/skills/<name>/SKILL.md` and adds nothing.
@@ -14,7 +14,7 @@ Read `.agents/transports/codex.md` and follow it exactly. It owns the command, t
14
14
 
15
15
  ## Do
16
16
 
17
- 1. Take the dispatch's brief, or write one to `tmp/codex/<unit>-brief.md` from the dispatch's objective, evidence slice, claims, scope, and return shape. For an audit, take the dispatch-named skill's verdict shape before the `orkestrel-falsify` default and carry the claims under that skill's procedure. Require the actual diff and status only for a code subject. Carry the objective lens: correctness under adverse orderings, what the contracts and installed declarations permit, dependency and range truth, the missing seam or the assertion that cannot fail, the letter of the rules.
17
+ 1. Take the dispatch's brief, or write one to `tmp/codex/<unit>-brief.md` from the dispatch's objective, evidence slice, claims, scope, and return shape. For an audit, take the dispatch-named skill's verdict shape before the `orkestrel-falsify` default and carry the claims under that skill's procedure. Require the actual diff and status only for a code subject. Carry the objective lens `.agents/orchestration.md` § Roles states into the brief, and the receipts the dispatch supplies for each probe a claim needs, because this route runs none.
18
18
  2. Run `node .agents/skills/orkestrel-dispatch/scripts/brief.ts --check <brief>` and fix every missing path.
19
19
  3. Resolve the `codex exec` command per the transport, as the `launch.ts` line it shows.
20
20
  4. Run the command yourself only when the lane finishes inside the foreground cap the harness page's Background row states (`.agents/skills/orkestrel-parallel/references/`), and return the answer read with `node .agents/skills/orkestrel-dispatch/scripts/result.ts --codex`, with the journal path and session id. Otherwise return the brief path, the resolved command, and the journal path; the Orchestrator launches it under a cap per `.agents/skills/orkestrel-dispatch/SKILL.md` § Launch.
@@ -22,7 +22,7 @@ On Claude Sonnet 5.5, you implement a fully specified unit with a closed shape.
22
22
 
23
23
  - A unit that leaves naming, API shape, or architecture open, or that spans packages: report it as belonging to `astra` or `opus`.
24
24
  - A unit whose mechanism is open: a protocol, a lock, a retry class, or a termination path; report it as belonging to `astra` or `opus`.
25
- - Installing, committing, pushing, reading a secret, or a destructive command.
25
+ - Installing, committing outside a branch, clone, copy, or worktree the brief names, pushing, reading a secret, or a destructive command.
26
26
 
27
27
  ## Return
28
28
 
@@ -16,7 +16,8 @@ On Claude Haiku 5.5, you read and distill the supplied evidence. You decide noth
16
16
  2. Read every named input in full. Record each fact with `file:line`.
17
17
  3. Separate what the inputs state from what you infer; label inference.
18
18
  4. Name every input row the distillate did not reach.
19
+ 5. When the inputs outlast one turn, stop at a clean boundary and never sample. A partial read never counts as a whole read.
19
20
 
20
21
  ## Return
21
22
 
22
- `Question`, `Evidence` (cited facts), `Contradictions` (each conflicting statement cited), `Distillate` (the smallest context the next engine needs), `Unknowns`. Nothing else, and no recommendation.
23
+ `Question`, `Evidence` (cited facts), `Contradictions` (each conflicting statement cited), `Distillate` (the smallest context the next engine needs), `Unknowns`, `Coverage` (per input: its identity, the last line read without a gap, and the next slice). Nothing else, and no recommendation.
@@ -15,11 +15,11 @@ Read `.agents/transports/cursor.md` and follow it exactly. It owns the model pin
15
15
  ## Do
16
16
 
17
17
  1. Require a bounded question and an exact file scope from the dispatch. Refuse an unbounded one.
18
- 2. Write the brief to `tmp/cursor/<unit>-brief.md`: read-only, the evidence sought, `file:line` pointers required, no raw dumps, no decisions.
18
+ 2. Write the brief to `tmp/cursor/<unit>-brief.md`: read-only, the evidence sought, `file:line` pointers required, no raw dumps, no decisions, and a stop at a clean boundary with a coverage table when the inputs outlast one answer; a partial read never counts as a whole read.
19
19
  3. Resolve the command per the transport: `node .agents/skills/orkestrel-dispatch/scripts/bench.ts --cursor --resolve` prints the entry, and the transport shows the `launch.ts` line.
20
20
  4. Run the command yourself only as `.agents/transports/cursor.md` § Command allows, and return the answer read with `scripts/result.ts --cursor`. Otherwise return the brief path, the resolved command, and the journal path; the Orchestrator launches it under a cap.
21
21
  5. Launch with `--status`, so `launch.ts` records `git status --porcelain` before and after. Any change is a deviation.
22
22
 
23
23
  ## Return
24
24
 
25
- `Question` (one line), `Evidence` (cited facts), `Distillate` (the smallest context the next engine needs), `Unknowns`, `Journal` (path and session id from the `init` event), `Deviation` (dark bench, command failure, dirty containment). Nothing else.
25
+ `Question` (one line), `Evidence` (cited facts), `Distillate` (the smallest context the next engine needs), `Unknowns`, `Coverage` (per input: its identity, the last line read without a gap, and the next slice), `Journal` (path and session id from the `init` event), `Deviation` (dark bench, command failure, dirty containment). Nothing else.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: opus
3
- description: 'Opus 5.5 implementation of one bounded nontrivial unit whose judgment load is subjective: API shape, naming, ergonomics, guide voice. Owns and validates its files under the orchestration contract, proves each claim, and never accepts its own output.'
3
+ description: 'Opus 5.5 implementation of one bounded nontrivial unit whose judgment load is subjective by default (API shape, naming, ergonomics, guide voice) and objective when the dispatch names it. Owns and validates its files under the orchestration contract, proves each claim, and never accepts its own output.'
4
4
  tools: Read, Grep, Glob, Edit, Write, Bash
5
5
  model: opus
6
6
  effort: high
@@ -12,15 +12,16 @@ On Claude Opus 5.5, you implement one dispatched unit and spawn nothing.
12
12
  ## Do
13
13
 
14
14
  1. Read the brief, `AGENTS.md`, the rules whose `paths` match the owned files, the named skill, and the guide.
15
- 2. Follow `AGENTS.md` § Work loop: types first, prove the claim, implement, test, consolidate, document. Select the instrument per `AGENTS.md` § Work loop and `.claude/rules/quality.md` § Instruments and return the evidence that instrument produced.
16
- 3. Apply `.agents/orchestration.md` § Parallelism for shared-file ownership.
17
- 4. Apply `.agents/orchestration.md` § Parallelism for validation ownership and the `orkestrel-parallel` skill § Implement in phases when that procedure applies.
18
- 5. Leave no probe behind, per `.claude/rules/tests.md` § Probes.
19
- 6. Finish the whole unit. Stop only per `.agents/orchestration.md` § Deviation protocol.
15
+ 2. Hold the load the dispatch names and say which one: subjective by default, objective when the dispatch assigns it. Under the objective load, prove every refusal and failure path the contract states.
16
+ 3. Follow `AGENTS.md` § Work loop: types first, prove the claim, implement, test, consolidate, document. Select the instrument per `AGENTS.md` § Work loop and `.claude/rules/quality.md` § Instruments and return the evidence that instrument produced.
17
+ 4. Apply `.agents/orchestration.md` § Parallelism for shared-file ownership.
18
+ 5. Apply `.agents/orchestration.md` § Parallelism for validation ownership and the `orkestrel-parallel` skill § Implement in phases when that procedure applies.
19
+ 6. Leave no probe behind, per `.claude/rules/tests.md` § Probes.
20
+ 7. Finish the whole unit. Stop only per `.agents/orchestration.md` § Deviation protocol.
20
21
 
21
22
  ## Refuse
22
23
 
23
- Adding a dependency, suppressing a diagnostic, mocking project-owned behavior, leaving a TODO in scope, committing, pushing, installing, reading a secret, a destructive command.
24
+ Adding a dependency, suppressing a diagnostic, mocking project-owned behavior, leaving a TODO in scope, committing outside a branch, clone, copy, or worktree the brief names, pushing, installing, reading a secret, a destructive command.
24
25
 
25
26
  ## Return
26
27
 
@@ -44,7 +44,7 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
44
44
  | Package | Version | Layer | Runtime dependencies | Peer dependencies |
45
45
  | ----------------------- | --------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
46
46
  | `@orkestrel/abort` | `0.0.15` | L1 | `@orkestrel/contract` `^0.0.21` | |
47
- | `@orkestrel/agent` | `0.0.34` | L5 | `@orkestrel/tool` `^0.0.21`, `@orkestrel/abort` `^0.0.15`, `@orkestrel/queue` `^0.0.19`, `@orkestrel/budget` `^0.0.16`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/timeout` `^0.0.15`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/database` `^0.0.20`, `@orkestrel/workflow` `^0.0.25`, `@orkestrel/workspace` `^0.0.14` | |
47
+ | `@orkestrel/agent` | `0.0.35` | L5 | `@orkestrel/tool` `^0.0.21`, `@orkestrel/abort` `^0.0.15`, `@orkestrel/queue` `^0.0.19`, `@orkestrel/budget` `^0.0.16`, `@orkestrel/ndjson` `^0.0.15`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/timeout` `^0.0.15`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/database` `^0.0.20`, `@orkestrel/workflow` `^0.0.25`, `@orkestrel/workspace` `^0.0.14` | |
48
48
  | `@orkestrel/brief` | `0.0.14` | L4 | `@orkestrel/reason` `^0.0.16`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/interpret` `^0.0.19` | |
49
49
  | `@orkestrel/browser` | `0.0.31` | L5 | `@orkestrel/mcp` `^0.0.41`, `@orkestrel/html` `^0.0.14`, `@orkestrel/pool` `^0.0.19`, `@orkestrel/tool` `^0.0.21`, `@orkestrel/codec` `^0.0.8`, `@orkestrel/router` `^0.0.19`, `@orkestrel/server` `^0.0.25`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/process` `^0.0.17`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/markdown` `^0.0.19`, `@orkestrel/websocket` `^0.0.17` | |
50
50
  | `@orkestrel/budget` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.21` | |
@@ -66,10 +66,10 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
66
66
  | `@orkestrel/mcp` | `0.0.41` | L4 | `@orkestrel/sse` `^0.0.12`, `@orkestrel/tool` `^0.0.21`, `@orkestrel/codec` `^0.0.8`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/jsonrpc` `^0.0.1`, `@orkestrel/process` `^0.0.17`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/websocket` `^0.0.17` | `@orkestrel/router` `^0.0.19`, `@orkestrel/server` `^0.0.25` |
67
67
  | `@orkestrel/middleware` | `0.0.27` | L4 | `@orkestrel/abort` `^0.0.15`, `@orkestrel/budget` `^0.0.16`, `@orkestrel/timeout` `^0.0.15`, `@orkestrel/contract` `^0.0.21` | `@orkestrel/server` `^0.0.25`, `@orkestrel/database` `^0.0.20` |
68
68
  | `@orkestrel/msg` | `0.0.15` | L2 | `@orkestrel/codec` `^0.0.8`, `@orkestrel/contract` `^0.0.21` | |
69
- | `@orkestrel/ndjson` | `0.0.14` | L1 | `@orkestrel/contract` `^0.0.21` | |
70
- | `@orkestrel/ollama` | `0.0.28` | L6 | `@orkestrel/tool` `^0.0.21`, `@orkestrel/agent` `^0.0.34`, `@orkestrel/budget` `^0.0.16`, `@orkestrel/ndjson` `^0.0.14`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/process` `^0.0.17`, `@orkestrel/contract` `^0.0.21` | |
69
+ | `@orkestrel/ndjson` | `0.0.15` | L1 | `@orkestrel/contract` `^0.0.21` | |
70
+ | `@orkestrel/ollama` | `0.0.29` | L6 | `@orkestrel/tool` `^0.0.21`, `@orkestrel/agent` `^0.0.35`, `@orkestrel/budget` `^0.0.16`, `@orkestrel/ndjson` `^0.0.15`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/process` `^0.0.17`, `@orkestrel/contract` `^0.0.21` | |
71
71
  | `@orkestrel/pool` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21` | |
72
- | `@orkestrel/probe` | `0.0.27` | L5 | `@orkestrel/lsp` `^0.0.13`, `@orkestrel/mcp` `^0.0.41`, `@orkestrel/pool` `^0.0.19`, `@orkestrel/tool` `^0.0.21`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/process` `^0.0.17`, `@orkestrel/timeout` `^0.0.15`, `@orkestrel/contract` `^0.0.21` | `vitest` `^4.1.12 \|\| ^5.0.5`, `typescript` `^6.0.3 \|\| ^7.0.2` |
72
+ | `@orkestrel/probe` | `0.0.28` | L5 | `@orkestrel/lsp` `^0.0.13`, `@orkestrel/mcp` `^0.0.41`, `@orkestrel/pool` `^0.0.19`, `@orkestrel/tool` `^0.0.21`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/process` `^0.0.17`, `@orkestrel/timeout` `^0.0.15`, `@orkestrel/contract` `^0.0.21` | `vitest` `^4.1.12 \|\| ^5.0.5`, `typescript` `^6.0.3 \|\| ^7.0.2` |
73
73
  | `@orkestrel/process` | `0.0.17` | L2 | `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21` | |
74
74
  | `@orkestrel/program` | `0.0.19` | L4 | `@orkestrel/rater` `^0.0.20`, `@orkestrel/reason` `^0.0.16`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/qualifier` `^0.0.20` | |
75
75
  | `@orkestrel/qualifier` | `0.0.20` | L3 | `@orkestrel/reason` `^0.0.16`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21` | |
@@ -78,19 +78,19 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
78
78
  | `@orkestrel/reason` | `0.0.16` | L2 | `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21` | |
79
79
  | `@orkestrel/relation` | `0.0.18` | L3 | `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/database` `^0.0.20` | |
80
80
  | `@orkestrel/router` | `0.0.19` | L2 | `@orkestrel/abort` `^0.0.15`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21` | |
81
- | `@orkestrel/scaffold` | `0.0.120` | L3 | `@orkestrel/console` `^0.0.17`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/process` `^0.0.17`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/markdown` `^0.0.19`, `@orkestrel/template` `^0.0.12` | |
81
+ | `@orkestrel/scaffold` | `0.0.122` | L3 | `@orkestrel/console` `^0.0.18`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/process` `^0.0.17`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/markdown` `^0.0.19`, `@orkestrel/template` `^0.0.12` | |
82
82
  | `@orkestrel/sea` | `0.0.21` | L3 | `@orkestrel/emitter` `^0.0.14`, `@orkestrel/process` `^0.0.17`, `@orkestrel/contract` `^0.0.21` | |
83
83
  | `@orkestrel/server` | `0.0.25` | L3 | `@orkestrel/abort` `^0.0.15`, `@orkestrel/codec` `^0.0.8`, `@orkestrel/router` `^0.0.19`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/timeout` `^0.0.15`, `@orkestrel/contract` `^0.0.21` | |
84
84
  | `@orkestrel/sqlite` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.21` | |
85
85
  | `@orkestrel/sse` | `0.0.12` | L2 | `@orkestrel/codec` `^0.0.8`, `@orkestrel/contract` `^0.0.21` | |
86
- | `@orkestrel/study` | `0.0.8` | L7 | `@orkestrel/tool` `^0.0.21`, `@orkestrel/abort` `^0.0.15`, `@orkestrel/agent` `^0.0.34`, `@orkestrel/budget` `^0.0.16`, `@orkestrel/ollama` `^0.0.28`, `@orkestrel/timeout` `^0.0.15`, `@orkestrel/contract` `^0.0.21` | |
86
+ | `@orkestrel/study` | `0.0.10` | L7 | `@orkestrel/tool` `^0.0.21`, `@orkestrel/abort` `^0.0.15`, `@orkestrel/agent` `^0.0.35`, `@orkestrel/budget` `^0.0.16`, `@orkestrel/ollama` `^0.0.29`, `@orkestrel/timeout` `^0.0.15`, `@orkestrel/contract` `^0.0.21` | |
87
87
  | `@orkestrel/table` | `0.0.14` | L2 | `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21` | |
88
88
  | `@orkestrel/template` | `0.0.12` | L2 | `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21` | |
89
89
  | `@orkestrel/terminal` | `0.0.22` | L3 | `@orkestrel/sse` `^0.0.12`, `@orkestrel/form` `^0.0.15`, `@orkestrel/console` `^0.0.17`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/database` `^0.0.20` | |
90
90
  | `@orkestrel/test` | `0.0.32` | L1 | `@orkestrel/contract` `^0.0.21` | `vitest` `^4.1.12 \|\| ^5.0.5`, `playwright` `^1.64.1` |
91
91
  | `@orkestrel/timeout` | `0.0.15` | L1 | `@orkestrel/contract` `^0.0.21` | |
92
92
  | `@orkestrel/tool` | `0.0.21` | L2 | `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21` | |
93
- | `@orkestrel/toolbox` | `0.0.23` | L6 | `@orkestrel/form` `^0.0.15`, `@orkestrel/tool` `^0.0.21`, `@orkestrel/agent` `^0.0.34`, `@orkestrel/server` `^0.0.25`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/database` `^0.0.20`, `@orkestrel/relation` `^0.0.18`, `@orkestrel/terminal` `^0.0.22`, `@orkestrel/workflow` `^0.0.25`, `@orkestrel/workspace` `^0.0.14` | |
93
+ | `@orkestrel/toolbox` | `0.0.24` | L6 | `@orkestrel/form` `^0.0.15`, `@orkestrel/tool` `^0.0.21`, `@orkestrel/agent` `^0.0.35`, `@orkestrel/server` `^0.0.25`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/database` `^0.0.20`, `@orkestrel/relation` `^0.0.18`, `@orkestrel/terminal` `^0.0.22`, `@orkestrel/workflow` `^0.0.25`, `@orkestrel/workspace` `^0.0.14` | |
94
94
  | `@orkestrel/websocket` | `0.0.17` | L2 | `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21` | |
95
95
  | `@orkestrel/worker` | `0.0.19` | L4 | `@orkestrel/pool` `^0.0.19`, `@orkestrel/queue` `^0.0.19`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/database` `^0.0.20` | |
96
96
  | `@orkestrel/workflow` | `0.0.25` | L4 | `@orkestrel/abort` `^0.0.15`, `@orkestrel/queue` `^0.0.19`, `@orkestrel/budget` `^0.0.16`, `@orkestrel/emitter` `^0.0.14`, `@orkestrel/timeout` `^0.0.15`, `@orkestrel/contract` `^0.0.21`, `@orkestrel/database` `^0.0.20` | |
@@ -1,13 +1,13 @@
1
1
  ---
2
2
  name: planner
3
- description: 'Opus 5.5 design and consultation lane, read-only: proposes a coherent API shape, vocabulary, architecture, alternatives, and bounded units for one design brief, or gives a consultation at a seam. Holds the subjective lane by default and the objective lane when the dispatch assigns it. Never implements or accepts.'
3
+ description: 'Opus 5.5 design and consultation lane by default, read-only: proposes a coherent API shape, vocabulary, architecture, alternatives, and bounded units for one design brief, or gives a consultation at a seam, including the Fable 5.1 consultation on the engine the dispatch names. Holds the subjective lane by default and the objective lane when the dispatch assigns it. Never implements or accepts.'
4
4
  tools: Read, Grep, Glob
5
5
  model: opus
6
6
  effort: high
7
7
  permissionMode: plan
8
8
  ---
9
9
 
10
- On Claude Opus 5.5, design a dispatched unit or give a read-only consultation under `.agents/orchestration.md` § Sessions and consultation. Run no command and edit nothing; return the proposal or consultation in your final message.
10
+ On Claude Opus 5.5 by default, or on the engine the dispatch names, design a dispatched unit or give a read-only consultation under `.agents/orchestration.md` § Sessions and consultation. You also carry the read-only consultation `.agents/orchestration.md` § Engines admits for Claude Fable 5.1, on the engine the dispatch names. Run no command and edit nothing; return the proposal or consultation in your final message.
11
11
 
12
12
  ## Do
13
13
 
@@ -15,7 +15,7 @@ For a consultation, follow `.agents/orchestration.md` § Sessions and consultati
15
15
  follow these steps.
16
16
 
17
17
  1. Read the brief, `AGENTS.md`, the rules whose `paths` match the subject, the named skill, the guide, and the supplied distillate. Work from the brief alone; never look for or reconcile the other lane's answer.
18
- 2. Hold the lane the dispatch names and say which one: subjective (shape, naming, ergonomics, design fit) or objective (correctness, constraints, what the contracts permit).
18
+ 2. Hold the lane the dispatch names and say which one, under the lens `.agents/orchestration.md` § Roles gives that lane.
19
19
  3. Propose one design. Name each real alternative that a constraint favors and why the design wins; leave out an option nothing favors.
20
20
  4. Cut every unit to a fully specified brief a cheap executor could implement; name each unit's role and engine, owned files, dependencies, and acceptance criteria.
21
21
  5. Name every judgment call under `Tensions` for the other lane or the Orchestrator to rule.