@orkestrel/scaffold 0.0.137 → 0.0.139

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 (33) hide show
  1. package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +489 -23
  2. package/dist/bin/main.js +6 -6
  3. package/dist/host/agents/skills/orkestrel-journey/SKILL.md +33 -27
  4. package/dist/host/agents/skills/orkestrel-journey/references/captures.md +37 -16
  5. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +1 -1
  6. package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +628 -41
  7. package/dist/host/agents/skills/orkestrel-polish/references/capture-harness.md +5 -0
  8. package/dist/host/claude/agents/orkestrel.md +54 -54
  9. package/dist/host/claude/rules/typescript.md +4 -1
  10. package/dist/host/claude/rules/workspace.md +6 -4
  11. package/dist/host/guides/capture.md +442 -313
  12. package/dist/host/guides/contract.md +314 -210
  13. package/dist/host/guides/middleware.md +489 -259
  14. package/dist/host/guides/process.md +139 -53
  15. package/dist/host/guides/router.md +282 -165
  16. package/dist/host/guides/scaffold.md +35 -23
  17. package/dist/host/guides/server.md +417 -181
  18. package/dist/host/guides/test.md +353 -232
  19. package/dist/host/manifest.json +18 -18
  20. package/dist/host/scripts/browsers.sh +0 -0
  21. package/dist/host/scripts/codex.sh +0 -0
  22. package/dist/host/scripts/cursor.sh +0 -0
  23. package/dist/host/scripts/deps.sh +0 -0
  24. package/dist/host/scripts/npm.sh +0 -0
  25. package/dist/host/scripts/ollama.sh +0 -0
  26. package/dist/host/tests/config.test.ts +19 -27
  27. package/dist/src/core/index.cjs +139 -60
  28. package/dist/src/core/index.cjs.map +1 -1
  29. package/dist/src/core/index.d.cts +1 -1
  30. package/dist/src/core/index.d.ts +1 -1
  31. package/dist/src/core/index.js +139 -60
  32. package/dist/src/core/index.js.map +1 -1
  33. package/package.json +6 -6
@@ -728,8 +728,8 @@ in `src/bin/*.ts` and refuses a relative import of `src/core` or `src/server` fr
728
728
  would bundle a second copy of the environment. The distribution proof reads `dist/bin` as its own
729
729
  face and reports a library source copied into it. The gate refuses a module whose `./<name>`
730
730
  subpath another planned subpath takes, such as `src/bin/server.ts` beside `src/server`, and names
731
- both. A consumer loads a module by its subpath, as `--reporter=@orkestrel/test/reporter` loads the
732
- `reporter` module of `@orkestrel/test`.
731
+ both. A consumer loads a module by its subpath: in a package named `@orkestrel/sample`,
732
+ `src/bin/reporter.ts` publishes `./reporter`, which `--reporter=@orkestrel/sample/reporter` loads.
733
733
 
734
734
  When an existing workspace adds a `src/bin` module, `overwrite` writes every row its manifest
735
735
  lacks: `exports["./<name>"]`, `dist/bin` in `files`, `check:src:bin`, `build:src:bin`, and
@@ -1498,13 +1498,18 @@ scaffold creates it when absent and preserves your edits during `repair`. It imp
1498
1498
  at 1280 × 800 and `compact` at 390 × 844 without a theme. Rename and extend those variants for
1499
1499
  your application; apply themes through the application's interface in your tests.
1500
1500
 
1501
- The wrapper registers `journey:<name>` for each variant through the root factory. Each app-side
1501
+ The wrapper is one `buildCaptureWrapper` call from `@orkestrel/capture/server`, whose `project`
1502
+ option builds each variant's project through the root factory as `appJourney(variant, mode,
1503
+ override)`. It declares the owner `pages:arrival`, the first variant `desktop`, the final case
1504
+ `closes the run`, the evidence root `tmp/captures/states`, the integrity inputs, the shared and
1505
+ test sources, and one scoped `states` portfolio; extend the owner list with every owner path your
1506
+ journey cases carry. The wrapper registers `journey:<name>` for each variant. Each app-side
1502
1507
  browser face also receives `journey:<name>` as `capture journey --mode <name>` and `capture:<name>`
1503
1508
  as `capture frames --mode <name>`. Each project
1504
1509
  collects the integration suite of the application the Vite mode selects, sets the variant
1505
- viewport, and provides `variant`
1506
- as its name, `variants` as the declared list, and `capture` as a boolean. The root configuration
1507
- reads `process.env.CAPTURE === '1'` for that boolean. The generated `test:journey` script runs
1510
+ viewport, and receives the values the `CaptureProvided` type of `@orkestrel/capture` declares,
1511
+ `variant`, `variants`, and `capture` among them, through the override the factory passes. The
1512
+ factory reads the `CAPTURE` variable, and the root configuration reads none. The generated `test:journey` script runs
1508
1513
  `vitest run --config configs/app/vite.journey.config.ts --no-cache --reporter=dot`, and the generated
1509
1514
  `test` chain runs it after the application projects only in a private workspace. In a publishing
1510
1515
  workspace, application and journey suites run on demand outside release gates and chains.
@@ -1519,9 +1524,11 @@ or a colon-delimited owner path declared by the wrapper. Narrow with `--variant
1519
1524
  `--case <exact-full-name>`; frames also accept `--state <name>`. Replace the selector with
1520
1525
  `--changed <ref>` and inspect `--plan` before executing the changed set. The package refuses
1521
1526
  shared changes that cannot be narrowed and prints the explicit whole-suite command.
1522
- The application wires the wrapper's discovery, tags, portfolios, registry, selection request,
1523
- and final-case records to the capture protocol before running these commands. Scaffold seeds
1524
- the dependency and scripts; it defines no application owner or state registry.
1527
+ The wrapper factory answers discovery, reads the selection request, derives the owner tags, and
1528
+ mounts the progress plugin of `@orkestrel/test`, and the seeded arrival journey writes each run
1529
+ record in its final case, so `capture registry` and `npm run capture -- all` run on a workspace
1530
+ as `new` creates it. Each further screen adds its owner to the wrapper and its states to the
1531
+ journey that places them.
1525
1532
 
1526
1533
  The generated browser resolver and gate cover Chromium alone. The emitted `configs/browsers.ts` doc
1527
1534
  block states the condition that reopens engine selection, and is that condition's one home.
@@ -1741,12 +1748,12 @@ page carrying a repeated or malformed stamp, and a page whose head does not clos
1741
1748
 
1742
1749
  The journey follows the same modes. The birth-owned `configs/app/vite.journey.config.ts` wrapper
1743
1750
  keeps your variant list and passes the Vite mode to the root
1744
- `appJourney(variant, variants, mode?, override?)` factory, which selects the application through
1751
+ `appJourney(variant, mode?, override?)` factory, which selects the application through
1745
1752
  `resolveApplication` as well. Each variant project collects
1746
- `tests/app/<application>/integration.test.ts` alone, sets the variant viewport, and provides
1747
- `variant`, `variants`, and `capture`. The factory merges an optional `UserConfig` override last,
1748
- through `mergeOverride`, so a wrapper changes only the fields it names and the project keeps its
1749
- include and exclude replacement, viewport, commands, and plugin rules. The manifest runs `test:journey` for the base
1753
+ `tests/app/<application>/integration.test.ts` alone and sets the variant viewport. The factory
1754
+ merges an optional `UserConfig` override last, through `mergeOverride`, so the capture wrapper
1755
+ factory's override adds its owner tags, its provided values, and its `readCaptureFrames` command,
1756
+ and the project keeps its include and exclude replacement, viewport, commands, and plugin rules. The manifest runs `test:journey` for the base
1750
1757
  application and `test:journey:<framework>`, the same command with `--mode <framework>`, for each
1751
1758
  app-side browser extension. A private workspace runs them after `npm run test:app` in `test`.
1752
1759
  A publishing workspace keeps those scripts available on demand and invokes neither application
@@ -1758,9 +1765,13 @@ Scaffold seeds one birth-owned arrival journey per application at
1758
1765
  the Vue journey mounts `App.vue`. Each resolves the level-1 heading by its role and the workspace
1759
1766
  name, then proves the Journey, Refusal, and Matrix families the `orkestrel-journey` skill names,
1760
1767
  and proves Capture as well when `CAPTURE=1` sets the `capture` value. The seeded wrapper declares
1761
- two variants, which is what makes the journey owe Matrix. A journey workspace's
1762
- `tests/setupBrowser.ts` seed carries the `ProvidedContext` augmentation that types the three
1763
- provided values.
1768
+ two variants, which is what makes the journey owe Matrix. The arrival case owns `pages:arrival`
1769
+ and places the `<application>-arrival` state in the scoped `pages` directory, and a final
1770
+ `closes the run` case writes the run record and its journey artifact through the
1771
+ `collectCaptureCases`, `buildCaptureDestinations`, `buildCaptureRun`, and `renderCaptureArtifact`
1772
+ helpers of `@orkestrel/capture`. A journey workspace's `tests/setupBrowser.ts` seed extends
1773
+ `ProvidedContext` with `CaptureProvided` and `TaskMeta` with `CaptureMeta`, and declares the
1774
+ `readCaptureFrames` browser command.
1764
1775
 
1765
1776
  ### Vendored files and their refresh
1766
1777
 
@@ -2345,11 +2356,12 @@ row entering or leaving the manifest moves a test rather than passing unnoticed.
2345
2356
  of `STYLES_DEV_DEPENDENCIES`, is a seed as well: it carries the `^1.105.1` range the
2346
2357
  `@orkestrel/veneer` checkout declared on 2026-09-30, and that test names it in the seeded set.
2347
2358
 
2348
- `CAPTURE_DEV_DEPENDENCIES` seeds `@orkestrel/capture` at `^0.0.5`, the first release whose commands
2349
- take `--mode`, only when the blueprint plans a journey: the `journey` axis with the base entry or
2350
- an app-side browser face. `CAPTURE_UPSTREAM` withholds that
2359
+ `CAPTURE_DEV_DEPENDENCIES` seeds `@orkestrel/capture` at `^0.0.10`, which exports the
2360
+ `buildCaptureWrapper` factory the seeded journey wrapper calls, only when the blueprint plans a
2361
+ journey: the `journey` axis with the base entry or an app-side browser face. `CAPTURE_UPSTREAM` withholds that
2351
2362
  seed from capture itself and its fleet runtime closure: `@orkestrel/contract`,
2352
- `@orkestrel/emitter`, `@orkestrel/process`, and `@orkestrel/timeout`. The frozen, sorted list
2363
+ `@orkestrel/emitter`, `@orkestrel/process`, `@orkestrel/test`, which capture takes as a peer, and
2364
+ `@orkestrel/timeout`. The frozen, sorted list
2353
2365
  follows dependencies and peers from capture's installed manifests and moves with the capture
2354
2366
  pin. Scaffold does not install capture; planning proofs cover every listed exclusion and an
2355
2367
  unlisted journey workspace. The installed closure-equality proof lands when scaffold installs
@@ -2385,8 +2397,8 @@ The dependency tables select these floors:
2385
2397
  | TypeScript | `^6.0.3` | A selected `src/vue` or `app/vue` face |
2386
2398
  | Vitest | `^5.1.0` | Every workspace |
2387
2399
  | `@vitest/browser-playwright` | `^5.1.0` | Browser tooling |
2388
- | `oxlint` | `^1.93.0` | Every workspace |
2389
- | `oxfmt` | `^0.78.0` | Every workspace |
2400
+ | `oxlint` | `^1.94.0` | Every workspace |
2401
+ | `oxfmt` | `^0.79.0` | Every workspace |
2390
2402
  | `@microsoft/api-extractor` | `^7.60.1` | Declaration builds; uses its bundled TypeScript 6.0.3 engine |
2391
2403
  | `playwright` | `^1.64.1` | Browser tooling |
2392
2404
  | Vite | `^8.3.8` | Every workspace |