@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.
- package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +489 -23
- package/dist/bin/main.js +89 -29
- package/dist/bin/main.js.map +1 -1
- package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +1 -1
- package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +628 -41
- package/dist/host/claude/agents/orkestrel.md +52 -52
- package/dist/host/guides/abort.md +2 -0
- package/dist/host/guides/browser.md +1 -1
- package/dist/host/guides/contract.md +314 -210
- package/dist/host/guides/guide.md +10 -2
- package/dist/host/guides/mcp.md +9 -9
- package/dist/host/guides/middleware.md +474 -259
- package/dist/host/guides/probe.md +1 -2
- package/dist/host/guides/router.md +282 -165
- package/dist/host/guides/scaffold.md +27 -18
- package/dist/host/guides/server.md +419 -183
- package/dist/host/manifest.json +14 -14
- package/dist/host/scripts/browsers.sh +0 -0
- package/dist/host/scripts/codex.sh +0 -0
- package/dist/host/scripts/cursor.sh +0 -0
- package/dist/host/scripts/deps.sh +0 -0
- package/dist/host/scripts/npm.sh +0 -0
- package/dist/host/scripts/ollama.sh +0 -0
- package/dist/src/core/index.cjs +17 -17
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.js +17 -17
- package/dist/src/core/index.js.map +1 -1
- package/dist/src/server/index.cjs +6 -24
- package/dist/src/server/index.cjs.map +1 -1
- package/dist/src/server/index.d.cts +1 -1
- package/dist/src/server/index.d.ts +1 -1
- package/dist/src/server/index.js +7 -25
- package/dist/src/server/index.js.map +1 -1
- 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
|
|
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
|
|
2264
|
-
|
|
2265
|
-
|
|
2266
|
-
|
|
2267
|
-
|
|
2268
|
-
|
|
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.
|
|
2401
|
-
| `oxfmt` | `^0.
|
|
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. `
|
|
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
|
|
2431
|
-
| ----------- |
|
|
2432
|
-
| `new` | Declared versions and the vendored host
|
|
2433
|
-
| `audit` | Declared versions and the
|
|
2434
|
-
| `repair` | Declared versions and the vendored host
|
|
2435
|
-
| `catalog` | Organization membership, its packuments, and the selected guides
|
|
2436
|
-
| `overwrite` | Everything `repair` and `catalog` read
|
|
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
|