@orkestrel/scaffold 0.0.138 → 0.0.140

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 (34) hide show
  1. package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +489 -23
  2. package/dist/bin/main.js +89 -29
  3. package/dist/bin/main.js.map +1 -1
  4. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +1 -1
  5. package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +628 -41
  6. package/dist/host/claude/agents/orkestrel.md +52 -52
  7. package/dist/host/guides/abort.md +2 -0
  8. package/dist/host/guides/browser.md +1 -1
  9. package/dist/host/guides/contract.md +314 -210
  10. package/dist/host/guides/guide.md +10 -2
  11. package/dist/host/guides/mcp.md +9 -9
  12. package/dist/host/guides/middleware.md +474 -259
  13. package/dist/host/guides/probe.md +1 -2
  14. package/dist/host/guides/router.md +282 -165
  15. package/dist/host/guides/scaffold.md +27 -18
  16. package/dist/host/guides/server.md +419 -183
  17. package/dist/host/manifest.json +14 -14
  18. package/dist/host/scripts/browsers.sh +0 -0
  19. package/dist/host/scripts/codex.sh +0 -0
  20. package/dist/host/scripts/cursor.sh +0 -0
  21. package/dist/host/scripts/deps.sh +0 -0
  22. package/dist/host/scripts/npm.sh +0 -0
  23. package/dist/host/scripts/ollama.sh +0 -0
  24. package/dist/src/core/index.cjs +17 -17
  25. package/dist/src/core/index.cjs.map +1 -1
  26. package/dist/src/core/index.js +17 -17
  27. package/dist/src/core/index.js.map +1 -1
  28. package/dist/src/server/index.cjs +6 -24
  29. package/dist/src/server/index.cjs.map +1 -1
  30. package/dist/src/server/index.d.cts +1 -1
  31. package/dist/src/server/index.d.ts +1 -1
  32. package/dist/src/server/index.js +7 -25
  33. package/dist/src/server/index.js.map +1 -1
  34. package/package.json +14 -14
@@ -1266,7 +1266,7 @@ standard error, so a piped value is never polluted.
1266
1266
  | Verb | Value |
1267
1267
  | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1268
1268
  | `new` | `MaterializeResult` — `target`, `written`, `skipped`, `removed` — plus `provenance` |
1269
- | `audit` | `Audit` — `findings` and `questions` — plus `releases` and `provenance`; findings carry `ownership` |
1269
+ | `audit` | `Audit` — `findings` and `questions` — plus `releases` and `provenance`, which carries `guides` when mirrors were compared; findings carry `ownership` |
1270
1270
  | `surface` | `owners` with each owner's `source`, `collisions` with each entry's `standing` (`error`, `recorded`, or `closed`), and `provenance` with `guides` and `record` |
1271
1271
  | `repair` | `MaterializeResult` plus `audit`, the terminal audit taken after the write, `releases`, and `provenance` |
1272
1272
  | `catalog` | `MaterializeResult` plus `mirrors`, `provenance`, optional `membership` with `entries`, `dropped`, and `releases`, and an explanatory `note` on a partial run |
@@ -2260,12 +2260,17 @@ target holds. The refusal is deliberate at `0.0.x` and there is no migration pat
2260
2260
 
2261
2261
  ## Fleet catalog
2262
2262
 
2263
- During `audit`, a present foreign guide whose bytes differ from the hosted guide produces a
2264
- non-blocking question whose `field` is `guides`. Its message names the mirror path and `catalog`
2265
- as the refresh action. The message says
2266
- "differs from the hosted guide": byte inequality establishes no chronology. The question sits
2267
- outside repair findings, so `repair` preserves a present mirror. The target's own guide and its
2268
- guide index are excluded, and the comparison follows the `guides` group selection.
2263
+ During an online `audit` that selects the `guides` group, each present `guides/*.md` mirror is
2264
+ compared with the guide on its package's `main` branch, the read `catalog` performs. A mirror
2265
+ differing from that guide produces a non-blocking question whose `field` is `guides`. Its message
2266
+ names the mirror path and `catalog` as the refresh action, or `catalog --all` when the target does
2267
+ not declare the package. The message says "differs from the guide on" the package's `main` branch:
2268
+ byte inequality establishes no chronology. A mirror that cannot be read from its repository
2269
+ produces a non-blocking `guides` question that names the cause and states that the mirror was not
2270
+ compared. The comparison covers a mirror only when the hosted catalog lists its package. The
2271
+ target's own guide, the guide index, and nested paths are excluded. Offline, `audit` reads no
2272
+ repository and raises no `guides` question. The question sits outside repair findings, so `repair`
2273
+ preserves a present mirror, and the `Materializer` audit raises no guide question.
2269
2274
 
2270
2275
  `catalog` rewrites one marker-bounded region in `CATALOG_AGENT_PATH` and nothing else in that file.
2271
2276
  The region holds a table with these columns:
@@ -2350,7 +2355,10 @@ the baseline toolchain a generated workspace receives is the toolchain scaffold
2350
2355
  browser framework can override a floor through `TOOLCHAIN_HOLDS`. The rows scaffold does
2351
2356
  not install are seeds — `@orkestrel/capture`, `@vitejs/plugin-vue`, `vue`, `vue-tsc`, `vite-plugin-singlefile`, and the
2352
2357
  application-server fleet packages — and each carries the highest triple its supported major served
2353
- when it was written.
2358
+ when it was written. The three application-server fleet seeds (`@orkestrel/middleware`,
2359
+ `@orkestrel/router`, and `@orkestrel/server`) carry the version the committed catalog in
2360
+ `.claude/agents/orkestrel.md` lists, and the constants proof holds them there and checks that the
2361
+ catalog's runtime and peer edges among the three admit the seeded versions.
2354
2362
  [`tests/src/core/constants.test.ts`](../tests/src/core/constants.test.ts) names that seeded set, so a
2355
2363
  row entering or leaving the manifest moves a test rather than passing unnoticed. `sass`, the one row
2356
2364
  of `STYLES_DEV_DEPENDENCIES`, is a seed as well: it carries the `^1.105.1` range the
@@ -2397,8 +2405,8 @@ The dependency tables select these floors:
2397
2405
  | TypeScript | `^6.0.3` | A selected `src/vue` or `app/vue` face |
2398
2406
  | Vitest | `^5.1.0` | Every workspace |
2399
2407
  | `@vitest/browser-playwright` | `^5.1.0` | Browser tooling |
2400
- | `oxlint` | `^1.93.0` | Every workspace |
2401
- | `oxfmt` | `^0.78.0` | Every workspace |
2408
+ | `oxlint` | `^1.94.0` | Every workspace |
2409
+ | `oxfmt` | `^0.79.0` | Every workspace |
2402
2410
  | `@microsoft/api-extractor` | `^7.60.1` | Declaration builds; uses its bundled TypeScript 6.0.3 engine |
2403
2411
  | `playwright` | `^1.64.1` | Browser tooling |
2404
2412
  | Vite | `^8.3.8` | Every workspace |
@@ -2417,7 +2425,8 @@ alike.
2417
2425
 
2418
2426
  ### What each verb reads
2419
2427
 
2420
- `new`, `audit`, and `repair` read declared versions and the vendored host. `catalog` reads
2428
+ `new`, `audit`, and `repair` read declared versions and the vendored host. `audit` also reads the
2429
+ upstream guide of each present guide mirror when the `guides` group is selected. `catalog` reads
2421
2430
  organization membership, its packuments, and the selected guides. `overwrite` reads every surface
2422
2431
  that `repair` and `catalog` read. A network-forced floor is drift except for a successful `new` run;
2423
2432
  an explicit `--offline` floor is intentional, and the verb's result decides its exit. `catalog` has
@@ -2427,13 +2436,13 @@ Each verb resolves a surface's complete answer before it opens that surface's wr
2427
2436
  a partial answer never becomes a partial pin set. `overwrite` keeps the repair and removal work it
2428
2437
  committed before a later catalog refusal and records that refusal in `note`.
2429
2438
 
2430
- | Verb | Reads live | When the network forces a floor | With `--offline` |
2431
- | ----------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
2432
- | `new` | Declared versions and the vendored host | Writes the distributed version and host floors; exits `0` after creating the workspace | Reads no upstream surface, writes the same floors, and exits `0` after creating the workspace |
2433
- | `audit` | Declared versions and the vendored host | Compares through the distributed floors and exits `1` | Compares through the floors; exits `0` for an aligned target or `1` for drift |
2434
- | `repair` | Declared versions and the vendored host | Repairs from the distributed floors and exits `1`, even when the terminal audit is aligned | Repairs from the floors; the terminal audit decides exit `0` or `1` |
2435
- | `catalog` | Organization membership, its packuments, and the selected guides | Refreshes guides alone on a membership outage; refuses version failure; preserves present mirrors or fills absent mirrors from the verified host; exits `1` | Is a usage error; exits `2` and writes nothing |
2436
- | `overwrite` | Everything `repair` and `catalog` read | Keeps completed repair and deletion work, names each floor or refused catalog step in `note`, and exits `1` | Repairs, deletes, and writes version floors; skips `catalog`, records that refusal in `note`, and exits `1` |
2439
+ | Verb | Reads live | When the network forces a floor | With `--offline` |
2440
+ | ----------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
2441
+ | `new` | Declared versions and the vendored host | Writes the distributed version and host floors; exits `0` after creating the workspace | Reads no upstream surface, writes the same floors, and exits `0` after creating the workspace |
2442
+ | `audit` | Declared versions, the vendored host, and the present guide mirrors | Compares through the distributed floors, or reports `provenance.guides` as `floor` after an unread guide, and exits `1` | Compares through the floors and reads no guide; exits `0` for an aligned target or `1` for drift |
2443
+ | `repair` | Declared versions and the vendored host | Repairs from the distributed floors and exits `1`, even when the terminal audit is aligned | Repairs from the floors; the terminal audit decides exit `0` or `1` |
2444
+ | `catalog` | Organization membership, its packuments, and the selected guides | Refreshes guides alone on a membership outage; refuses version failure; preserves present mirrors or fills absent mirrors from the verified host; exits `1` | Is a usage error; exits `2` and writes nothing |
2445
+ | `overwrite` | Everything `repair` and `catalog` read | Keeps completed repair and deletion work, names each floor or refused catalog step in `note`, and exits `1` | Repairs, deletes, and writes version floors; skips `catalog`, records that refusal in `note`, and exits `1` |
2437
2446
 
2438
2447
  A fleet row is compared exactly — `^0.1.0` is stale the moment the registry serves `0.1.2` — and
2439
2448
  that inequality alone raises `audit` to exit `1`. A foreign row is compared inside its declared