@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.
- package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +489 -23
- package/dist/bin/main.js +6 -6
- package/dist/host/agents/skills/orkestrel-journey/SKILL.md +33 -27
- package/dist/host/agents/skills/orkestrel-journey/references/captures.md +37 -16
- 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/agents/skills/orkestrel-polish/references/capture-harness.md +5 -0
- package/dist/host/claude/agents/orkestrel.md +54 -54
- package/dist/host/claude/rules/typescript.md +4 -1
- package/dist/host/claude/rules/workspace.md +6 -4
- package/dist/host/guides/capture.md +442 -313
- package/dist/host/guides/contract.md +314 -210
- package/dist/host/guides/middleware.md +489 -259
- package/dist/host/guides/process.md +139 -53
- package/dist/host/guides/router.md +282 -165
- package/dist/host/guides/scaffold.md +35 -23
- package/dist/host/guides/server.md +417 -181
- package/dist/host/guides/test.md +353 -232
- package/dist/host/manifest.json +18 -18
- 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/host/tests/config.test.ts +19 -27
- package/dist/src/core/index.cjs +139 -60
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.d.cts +1 -1
- package/dist/src/core/index.d.ts +1 -1
- package/dist/src/core/index.js +139 -60
- package/dist/src/core/index.js.map +1 -1
- 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
|
|
732
|
-
`reporter`
|
|
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
|
|
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
|
|
1506
|
-
|
|
1507
|
-
reads `
|
|
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
|
|
1523
|
-
|
|
1524
|
-
|
|
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,
|
|
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
|
|
1747
|
-
|
|
1748
|
-
|
|
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.
|
|
1762
|
-
`
|
|
1763
|
-
|
|
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.
|
|
2349
|
-
|
|
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`,
|
|
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.
|
|
2389
|
-
| `oxfmt` | `^0.
|
|
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 |
|