@orkestrel/scaffold 0.0.137 → 0.0.138

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/bin/main.js CHANGED
@@ -10,7 +10,7 @@ import { readdirSync } from "node:fs";
10
10
  import { parseArgs } from "node:util";
11
11
  var package_default = {
12
12
  name: "@orkestrel/scaffold",
13
- version: "0.0.137",
13
+ version: "0.0.138",
14
14
  description: "Scaffold workspaces with commands: new, audit, surface, repair, catalog, and overwrite.",
15
15
  keywords: [
16
16
  "audit",
@@ -106,7 +106,7 @@ var package_default = {
106
106
  "@orkestrel/contract": "^0.0.24",
107
107
  "@orkestrel/emitter": "^0.0.17",
108
108
  "@orkestrel/markdown": "^0.0.22",
109
- "@orkestrel/process": "^0.0.20",
109
+ "@orkestrel/process": "^0.0.21",
110
110
  "@orkestrel/template": "^0.0.15"
111
111
  },
112
112
  devDependencies: {
@@ -115,7 +115,7 @@ var package_default = {
115
115
  "@orkestrel/guide": "^0.0.32",
116
116
  "@orkestrel/html": "^0.0.17",
117
117
  "@orkestrel/probe": "^0.0.31",
118
- "@orkestrel/test": "^0.0.40",
118
+ "@orkestrel/test": "^0.0.42",
119
119
  "@types/node": "^24.19.2",
120
120
  "@vitest/browser-playwright": "^5.1.0",
121
121
  "oxfmt": "^0.78.0",
@@ -72,13 +72,17 @@ choose the capture destination, the matrix row, and the statechart run together.
72
72
 
73
73
  - Read `inject('variant')` for this run's variant name, `inject('variants')` for the declared list,
74
74
  and `inject('capture')` for whether this run writes frames.
75
- - Declare the provided types once, by augmenting Vitest's own `ProvidedContext` in the workspace's
76
- browser test setup module, so `inject` is typed rather than narrowed at each call.
75
+ - Keep the provided types the workspace's browser test setup module declares once: `scaffold new`
76
+ seeds it to extend Vitest's own `ProvidedContext` with `CaptureProvided` and `TaskMeta` with
77
+ `CaptureMeta` from `@orkestrel/capture`, so `inject` is typed rather than narrowed at each call.
77
78
  - Declare the variant list in `configs/app/vite.journey.config.ts`, the birth-owned wrapper a
78
79
  browser application is born with. Its presence is the journey axis. Rename and extend the seeded
79
80
  viewports for this application.
80
- - Activate the axis in a workspace born before it: write `configs/app/vite.journey.config.ts`, run
81
- `scaffold audit`, and add any missing planned dependencies it names before `scaffold repair`.
81
+ - Activate the axis in a workspace born before it: write `configs/app/vite.journey.config.ts` as
82
+ one `buildCaptureWrapper` call whose `project` option returns `appJourney(variant, mode,
83
+ override)`, run `scaffold audit`, and add any missing planned dependencies it names before
84
+ `scaffold repair`. Rewrite a wrapper that still calls `appJourney(variant, VARIANTS, mode)` the
85
+ same way.
82
86
  Check that the repair defines `appJourney` in the root configuration, emits `test:journey`,
83
87
  `journey`, and `capture`, and excludes the journey suite from the ordinary `app:browser` project.
84
88
  Place each script by `.claude/rules/workspace.md` § Test project matrix. When the repair preserves
@@ -86,9 +90,11 @@ choose the capture destination, the matrix row, and the statechart run together.
86
90
  - Name each variant per [captures.md](references/captures.md) → Variants.
87
91
  - Keep the provided variants as serializable `JourneyVariant` data: `name`, `width`, and `height`.
88
92
  Compose no callback merely to pass that data to a capture.
89
- - Use `npm run test:journey` for the whole suite. Use the scoped commands
90
- under Choosing what to run for iteration and stamped frames; keep the root configuration's
91
- `CAPTURE === '1'` read and its `capture` provide unchanged.
93
+ - Close the journey gate with `npx capture registry`, which runs the whole suite, ownerless cases
94
+ included, and then `npm run capture -- all`. Accept in place of that frames run a portfolio
95
+ whose `npx capture stale all` reads every frame current and exits 0. Run no
96
+ `npm run test:journey` for the gate. Use the scoped commands under Choosing what to run for
97
+ iteration and stamped frames.
92
98
  - Keep the journeys in `tests/app/browser/integration.test.ts`, and the journeys of the `vue`
93
99
  extension's application in `tests/app/vue/integration.test.ts`, which `npm run test:journey:vue`
94
100
  runs. Each variant project of a mode collects that file alone, and the application's ordinary
@@ -116,10 +122,12 @@ For an absent-configuration question, inspect
116
122
  `npm run journey -- <selector>` (`capture journey`) for owner-selected behavior with capture
117
123
  off, and `npm run capture -- <selector>` (`capture frames`) for capture-bearing journeys with
118
124
  `CAPTURE=1`. Keep the commands separate; never append capture work to a behavior run.
119
- - Before using scoped commands, wire the adopter-owned journey wrapper's discovery, selection
120
- request, tags, portfolios, registry, and final-case records to the package protocol. Read the
121
- `@orkestrel/capture` guide's Runner and Runner selection and process protocol sections; scaffold
122
- seeds the commands and dependency, while the application supplies these declarations.
125
+ - Build the journey wrapper with the `buildCaptureWrapper` factory from
126
+ `@orkestrel/capture/server`, as the `@orkestrel/capture` guide's Runner selection and process
127
+ protocol section shows under Wrapper; never wire discovery, the selection request, or the tags
128
+ by hand. Write each run record in the wrapper's final case through capture's core record
129
+ helpers, as the arrival journey `scaffold new` seeds does. Declare in the wrapper every owner
130
+ path the journey cases carry.
123
131
  - Select `all` or a colon-delimited owner path from the wrapper's tags: `<scope>`,
124
132
  `<scope>:<owner>`, or further declared descendants. Use the wrapper's names, never infer them
125
133
  from filenames. Keep behavior on the positive `owner:` filter and frames on its intersection
@@ -171,25 +179,13 @@ judging their freshness or completeness.
171
179
  invokes the hook without awaiting a returned promise.
172
180
  - Keep `applyTheme` as the workspace's own browser setup helper. Make it drive the theme control
173
181
  through the published journey verbs and await the announced theme state and settled paint.
174
- - Put the provided-context declaration in the browser test setup module, and consume the injected
182
+ - Keep the provided-context declaration in the browser test setup module, and consume the injected
175
183
  data in `tests/app/browser/integration.test.ts` through the following portfolio configuration.
176
184
  Mount the shipped application entry with its real provisions before the acceptance journey runs.
177
185
  - From `tests/app/browser/integration.test.ts`, pass `../../../tmp/captures/states` as the capture
178
186
  directory to write into the workspace's `tmp/captures/states` directory. The browser provider
179
187
  resolves a custom screenshot path relative to the test file's directory.
180
188
 
181
- ```ts
182
- import type { JourneyVariant } from '@orkestrel/test'
183
-
184
- declare module 'vitest' {
185
- interface ProvidedContext {
186
- readonly variant: string
187
- readonly variants: readonly JourneyVariant[]
188
- readonly capture: boolean
189
- }
190
- }
191
- ```
192
-
193
189
  ```ts
194
190
  import { createPortfolio } from '@orkestrel/test/browser'
195
191
  import { inject } from 'vitest'
@@ -281,9 +277,18 @@ and no title scheme.
281
277
  ([layer.md](references/layer.md) → Role vocabulary).
282
278
  - Every census phase states the screen state it starts from, measures the pointer route at arrival
283
279
  before any key, and proves a focus-presented state (a skip link, a focus tooltip) by its own case.
280
+ - Take a reachability row's stop set once, through one `collectTabStops` call or one `walkFocus`
281
+ call. Assert both the pointer route and the reached set against that one walk, never walking the
282
+ Tab cycle once per assertion. Keep the census set as the row's proof.
284
283
  - The reachability walk asserts that focusing each control leaves fixed chrome's geometry
285
284
  unchanged.
286
285
 
286
+ Take the row's walk from the journey layer:
287
+
288
+ ```ts
289
+ import { collectTabStops, walkFocus } from '@orkestrel/test/browser'
290
+ ```
291
+
287
292
  ## Declare the transport family
288
293
 
289
294
  - Name the block for what it proves — persistence, restart, storage failure.
@@ -317,8 +322,9 @@ transition, the runner, the mounted harness, and the gate that reads its tally.
317
322
  ## Generate the portfolio
318
323
 
319
324
  Follow [captures.md](references/captures.md) for the state registry and its placement rules, the
320
- variant matrix, the always-on filename proof, the capture-run membership proof, and how a state that
321
- exists only during an activation is captured.
325
+ variant matrix, the always-on filename proof, the capture-run membership proof, how a state that
326
+ exists only during an activation is captured, and when a capture-bearing journey navigates under
327
+ reduced motion.
322
328
 
323
329
  Where a capture and a green suite disagree, take the capture as the evidence and the fixture as the
324
330
  defect.
@@ -354,7 +360,7 @@ Completion requires all of:
354
360
  - the declared families each proven, the declaration asserted, and the transport family driven through real implementations;
355
361
  - the matrix family read once per declared variant, each style reading carrying its published control from [styles.md](references/styles.md) → The published controls, and the authored-class census and the `extractStyles` reading each reporting the population it walked;
356
362
  - the statechart table driven to a terminal status with no failed row, and the harness tally read from the object and from its markup;
357
- - the registry-times-variants filename proof and the state-placement proof green in an ordinary run, one capture run per variant writing every registered file, and the written artifact produced for every variant, named by that variant;
363
+ - the registry-times-variants filename proof and the state-placement proof green in an ordinary run, the journey gate under § Read the variant once green, every registered file written by its frames run or read current by `capture stale all`, and the written artifact produced for every variant, named by that variant;
358
364
  - the browser test setup module proven by `tests/setupBrowser.test.ts` in the `setup:browser` project `scaffold repair` registers;
359
365
  - each assertion class mutated, with the red reading and the green reading recorded;
360
366
  - the repository gates green, per `.agents/orchestration.md` § Acceptance.
@@ -15,7 +15,14 @@ import type {
15
15
  PortfolioInterface,
16
16
  PortfolioOptions,
17
17
  } from '@orkestrel/test/browser'
18
- import { captureFrame, createPortfolio, expandCaptures, readFrame } from '@orkestrel/test/browser'
18
+ import {
19
+ captureFrame,
20
+ createPortfolio,
21
+ expandCaptures,
22
+ readFrame,
23
+ settleCapture,
24
+ stageMedia,
25
+ } from '@orkestrel/test/browser'
19
26
  import { inject } from 'vitest'
20
27
  ```
21
28
 
@@ -28,12 +35,13 @@ file is written to, and the flag as `enabled`.
28
35
 
29
36
  - Place a state with `place(state)` for the whole page, and `place(state, element)` where the
30
37
  picture is one element.
31
- - Take `enabled` from `inject('capture')`, which the generated root configuration provides from the
32
- `CAPTURE` environment variable set to `1` in the shell that runs the axis. An ordinary run leaves
33
- it false, so `place` returns `undefined`, resizes nothing, writes nothing, records no placement,
34
- and still refuses an unregistered state and a second placement of one state.
35
- - Read `files` for the registry expanded across every variant, `placements` for what this run placed,
36
- and `paths` for what it wrote. Each hands back a snapshot.
38
+ - Take `enabled` from `inject('capture')`, which the wrapper's `buildCaptureWrapper` factory
39
+ provides from the `CAPTURE` environment variable set to `1` in the shell that runs the axis. An
40
+ ordinary run leaves it false, so `place` returns `undefined`, resizes nothing, writes nothing,
41
+ records no placement, and still refuses an unregistered state and a second placement of one state.
42
+ - Read `files` for the registry expanded across every variant, `observed` for every state this run
43
+ placed, written or not, `placements` for the states it wrote, and `paths` for what it wrote. Each
44
+ hands back a snapshot.
37
45
  - Reach for `readFrame` where the written image itself is the subject — its decoded size, or its
38
46
  pixels. `captureFrame` already reads each file back and compares its bytes against the frame it
39
47
  shot.
@@ -59,8 +67,9 @@ Declare the state names once in the journey file, and build the portfolio from t
59
67
  that ran declare.
60
68
  - Place a capture state from inside the journey that reaches it, immediately after the assertion
61
69
  that proves the screen is in the condition that state names.
62
- - Record each placed name in the suite's own set in the same step that calls `place`. That set, not
63
- `placements`, is what the always-on placement proof reads.
70
+ - Read the portfolio's `observed` list in the always-on placement proof: it lists every state
71
+ `place` and `view` accepted, written or not, in placement order, where `placements` lists only
72
+ the states a capture run wrote.
64
73
  - Give each owner-bearing case registry-derived `owner:` tags. Declare a placing case's states in
65
74
  `meta.states`, derive its capture scope and part tags from those states, and place only states
66
75
  of that owner. Give behavior-only cases no capture tag.
@@ -74,8 +83,8 @@ Declare the state names once in the journey file, and build the portfolio from t
74
83
  - Run `npm run journey -- <selector>` for behavior and `npm run capture -- <selector>` for frames.
75
84
  Take both commands from `node_modules/@orkestrel/capture`; follow
76
85
  [SKILL.md](../SKILL.md#choosing-what-to-run) for selector grammar, flags, refusals, and the
77
- case, changed-set, section or page, group, and `all` ladder. Retain `test:journey` as the
78
- whole-suite gate.
86
+ case, changed-set, section or page, group, and `all` ladder. Run the whole-suite gate
87
+ [SKILL.md](../SKILL.md#read-the-variant-once) names.
79
88
  - Inspect the changed set with `--changed <ref> --plan` before executing it. Keep a shared-input
80
89
  refusal explicit, and follow its next command without silently capturing the complement.
81
90
  - Use the authenticated selection request to refuse a case whose declared states cross the
@@ -104,8 +113,7 @@ these.
104
113
  `createPortfolio` refuses a `variant` no declared variant carries, and `files` expands the
105
114
  registry across the whole list rather than across the one being rendered.
106
115
  - Produce the complete stamped portfolio with `npm run capture -- all`, which runs the declared
107
- variant projects through the capture runner. Keep `npm run test:journey` as the complete
108
- behavioral gate; a bare capture-flag run supplies no manifest stamp.
116
+ variant projects through the capture runner; a bare capture-flag run supplies no manifest stamp.
109
117
 
110
118
  ## The proofs the suite owes
111
119
 
@@ -115,7 +123,7 @@ Write each of the following proofs into the suite. The package asserts none of t
115
123
  | -------------------- | -------------- | ------------------------------------------------------------------------------------------------------- |
116
124
  | Filename expansion | Always | `expandCaptures(states, variants)` has one entry per state and variant, all unique |
117
125
  | Declaration coverage | Always | The case declarations cover the registry, are disjoint, and match the owner and capture tag definitions |
118
- | Placement membership | Always | The suite's placed set equals the states declared by the cases that ran, as sets |
126
+ | Placement membership | Always | The portfolio's `observed` list equals the states declared by the cases that ran, as sets |
119
127
  | Disk membership | Under the flag | The written filenames equal the selected expansion for this run's variant, with no orphan on disk |
120
128
 
121
129
  - Keep the filename proof always-on, so a registry edit that introduces a duplicate or a collision
@@ -126,8 +134,8 @@ Write each of the following proofs into the suite. The package asserts none of t
126
134
  - Assert placement as set equality against the union of the states the cases that ran declare.
127
135
  When every case ran, require that union to equal the registry. Derive completeness from the
128
136
  recorded cases that ran and passed, never from the selector or a task's mode alone.
129
- - Read the placement proof from the suite's own set rather than from `placements`, which stays empty
130
- in an ordinary run. `place` refuses an unregistered name and a second placement of one state in
137
+ - Read the placement proof from `observed` rather than from `placements`, which stays empty in an
138
+ ordinary run. `place` refuses an unregistered name and a second placement of one state in
131
139
  every run, but a registered state that no journey placed reaches no refusal; the always-on
132
140
  placement proof catches it.
133
141
  - Under the flag, assert the written filenames equal the ran cases' declared states expanded for
@@ -148,6 +156,19 @@ after the click returns.
148
156
  through the normal verb and await the promise the listener recorded.
149
157
  - Fail the step when the listener never ran.
150
158
 
159
+ ## Navigate under reduced motion
160
+
161
+ Apply this section to a capture-bearing journey whose navigation runs transitions, smooth scrolls,
162
+ or entrance animations. Leave every other journey under default motion.
163
+
164
+ - Stage reduced motion with a `stageMedia({ motion: false })` call before the journey navigates,
165
+ then restore motion with a `stageMedia({ motion: true })` call before each `settleCapture()`
166
+ call.
167
+ - Keep one declared journey per transition kind under default motion end to end.
168
+ - Keep a journey on the default-motion path when its stage reads the `prefers-reduced-motion`
169
+ media feature once at mount: that stage keeps the reduced reading after the restore. The
170
+ `@orkestrel/test` guide's Place a capture portfolio section states this limit.
171
+
151
172
  ## Hygiene
152
173
 
153
174
  - Keep the portfolio out of version control.
@@ -64,6 +64,11 @@ A spawned harness produces each artifact itself.
64
64
 
65
65
  ## Preflight before spending a round
66
66
 
67
+ For a journey-generated portfolio, run the machine half of preflight as the pass the
68
+ `@orkestrel/capture` guide's Choosing what to run section names under Recommended pass. Its
69
+ `sheets` command carries every member of the `READER` line, so run no separate
70
+ `capture preflight all` command in the round.
71
+
67
72
  Open every artifact yourself before dispatching a verdict lane, whichever source produced it.
68
73
  Confirm each of the following:
69
74
 
@@ -41,60 +41,60 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
41
41
 
42
42
  <!-- orkestrel:catalog -->
43
43
 
44
- | Package | Version | Layer | Runtime dependencies | Peer dependencies |
45
- | ----------------------- | --------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
46
- | `@orkestrel/abort` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.24` | |
47
- | `@orkestrel/agent` | `0.0.45` | L5 | `@orkestrel/tool` `^0.0.24`, `@orkestrel/abort` `^0.0.18`, `@orkestrel/queue` `^0.0.24`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/ndjson` `^0.0.18`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27`, `@orkestrel/workflow` `^0.0.30`, `@orkestrel/workspace` `^0.0.20` | |
48
- | `@orkestrel/brief` | `0.0.19` | L4 | `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/interpret` `^0.0.24` | |
49
- | `@orkestrel/browser` | `0.0.34` | L5 | `@orkestrel/mcp` `^0.0.44`, `@orkestrel/html` `^0.0.17`, `@orkestrel/pool` `^0.0.22`, `@orkestrel/tool` `^0.0.24`, `@orkestrel/codec` `^0.0.11`, `@orkestrel/router` `^0.0.22`, `@orkestrel/server` `^0.0.28`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/markdown` `^0.0.22`, `@orkestrel/websocket` `^0.0.20` | |
50
- | `@orkestrel/budget` | `0.0.19` | L1 | `@orkestrel/contract` `^0.0.24` | |
51
- | `@orkestrel/capture` | `0.0.8` | L3 | `@orkestrel/process` `^0.0.20`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | `vite` `^8.3.8`, `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.61.0`, `@vitest/browser-playwright` `^4.1.12 \|\| ^5.0.5` |
52
- | `@orkestrel/codec` | `0.0.11` | L1 | `@orkestrel/contract` `^0.0.24` | |
53
- | `@orkestrel/console` | `0.0.21` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
54
- | `@orkestrel/contract` | `0.0.24` | L0 | | |
55
- | `@orkestrel/csv` | `0.0.15` | L2 | `@orkestrel/codec` `^0.0.11`, `@orkestrel/contract` `^0.0.24` | |
56
- | `@orkestrel/database` | `0.0.27` | L2 | `@orkestrel/sqlite` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/indexeddb` `^0.0.19` | |
57
- | `@orkestrel/emitter` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.24` | |
58
- | `@orkestrel/form` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
59
- | `@orkestrel/guide` | `0.0.32` | L3 | `@orkestrel/contract` `^0.0.24`, `@orkestrel/markdown` `^0.0.22` | |
60
- | `@orkestrel/html` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.24` | |
61
- | `@orkestrel/indexeddb` | `0.0.19` | L1 | `@orkestrel/contract` `^0.0.24` | |
62
- | `@orkestrel/interpret` | `0.0.24` | L3 | `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/template` `^0.0.15` | |
63
- | `@orkestrel/jsonrpc` | `0.0.4` | L1 | `@orkestrel/contract` `^0.0.24` | |
64
- | `@orkestrel/lsp` | `0.0.16` | L3 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/jsonrpc` `^0.0.4`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24` | |
65
- | `@orkestrel/markdown` | `0.0.22` | L2 | `@orkestrel/html` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
66
- | `@orkestrel/mcp` | `0.0.44` | L4 | `@orkestrel/sse` `^0.0.15`, `@orkestrel/tool` `^0.0.24`, `@orkestrel/codec` `^0.0.11`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/jsonrpc` `^0.0.4`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/websocket` `^0.0.20` | `@orkestrel/router` `^0.0.22`, `@orkestrel/server` `^0.0.28` |
67
- | `@orkestrel/middleware` | `0.0.33` | L4 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | `@orkestrel/server` `^0.0.28`, `@orkestrel/database` `^0.0.27` |
68
- | `@orkestrel/msg` | `0.0.18` | L2 | `@orkestrel/codec` `^0.0.11`, `@orkestrel/contract` `^0.0.24` | |
69
- | `@orkestrel/ndjson` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.24` | |
70
- | `@orkestrel/ollama` | `0.0.39` | L6 | `@orkestrel/tool` `^0.0.24`, `@orkestrel/agent` `^0.0.45`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/ndjson` `^0.0.18`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24` | |
71
- | `@orkestrel/pool` | `0.0.22` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
72
- | `@orkestrel/probe` | `0.0.31` | L5 | `@orkestrel/lsp` `^0.0.16`, `@orkestrel/mcp` `^0.0.44`, `@orkestrel/pool` `^0.0.22`, `@orkestrel/tool` `^0.0.24`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/process` `^0.0.20`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | `vitest` `^4.1.12 \|\| ^5.1.0`, `typescript` `^6.0.3 \|\| ^7.0.2` |
73
- | `@orkestrel/process` | `0.0.20` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
74
- | `@orkestrel/program` | `0.0.22` | L4 | `@orkestrel/rater` `^0.0.23`, `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/qualifier` `^0.0.23` | |
75
- | `@orkestrel/qualifier` | `0.0.23` | L3 | `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
76
- | `@orkestrel/queue` | `0.0.24` | L3 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
77
- | `@orkestrel/rater` | `0.0.23` | L3 | `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
78
- | `@orkestrel/reason` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
79
- | `@orkestrel/relation` | `0.0.25` | L3 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
80
- | `@orkestrel/router` | `0.0.22` | L2 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
81
- | `@orkestrel/scaffold` | `0.0.136` | L3 | `@orkestrel/console` `^0.0.20`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/process` `^0.0.19`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/markdown` `^0.0.21`, `@orkestrel/template` `^0.0.14` | |
82
- | `@orkestrel/sea` | `0.0.24` | L3 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24` | |
83
- | `@orkestrel/server` | `0.0.28` | L3 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/codec` `^0.0.11`, `@orkestrel/router` `^0.0.22`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | |
84
- | `@orkestrel/sqlite` | `0.0.19` | L1 | `@orkestrel/contract` `^0.0.24` | |
85
- | `@orkestrel/sse` | `0.0.15` | L2 | `@orkestrel/codec` `^0.0.11`, `@orkestrel/contract` `^0.0.24` | |
86
- | `@orkestrel/study` | `0.0.21` | L7 | `@orkestrel/tool` `^0.0.24`, `@orkestrel/abort` `^0.0.18`, `@orkestrel/agent` `^0.0.45`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/ollama` `^0.0.39`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | |
87
- | `@orkestrel/table` | `0.0.18` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
88
- | `@orkestrel/template` | `0.0.15` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
89
- | `@orkestrel/terminal` | `0.0.27` | L3 | `@orkestrel/sse` `^0.0.15`, `@orkestrel/form` `^0.0.19`, `@orkestrel/console` `^0.0.21`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
90
- | `@orkestrel/test` | `0.0.40` | L1 | `@orkestrel/contract` `^0.0.24` | `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.65.0` |
91
- | `@orkestrel/timeout` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.24` | |
92
- | `@orkestrel/tool` | `0.0.24` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
93
- | `@orkestrel/toolbox` | `0.0.34` | L6 | `@orkestrel/form` `^0.0.19`, `@orkestrel/tool` `^0.0.24`, `@orkestrel/agent` `^0.0.45`, `@orkestrel/server` `^0.0.28`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27`, `@orkestrel/relation` `^0.0.25`, `@orkestrel/terminal` `^0.0.27`, `@orkestrel/workflow` `^0.0.30`, `@orkestrel/workspace` `^0.0.20` | |
94
- | `@orkestrel/websocket` | `0.0.20` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
95
- | `@orkestrel/worker` | `0.0.24` | L4 | `@orkestrel/pool` `^0.0.22`, `@orkestrel/queue` `^0.0.24`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
96
- | `@orkestrel/workflow` | `0.0.30` | L4 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/queue` `^0.0.24`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
97
- | `@orkestrel/workspace` | `0.0.20` | L3 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
44
+ | Package | Version | Layer | Runtime dependencies | Peer dependencies |
45
+ | ----------------------- | --------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
46
+ | `@orkestrel/abort` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.24` | |
47
+ | `@orkestrel/agent` | `0.0.45` | L5 | `@orkestrel/tool` `^0.0.24`, `@orkestrel/abort` `^0.0.18`, `@orkestrel/queue` `^0.0.24`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/ndjson` `^0.0.18`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27`, `@orkestrel/workflow` `^0.0.30`, `@orkestrel/workspace` `^0.0.20` | |
48
+ | `@orkestrel/brief` | `0.0.19` | L4 | `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/interpret` `^0.0.24` | |
49
+ | `@orkestrel/browser` | `0.0.34` | L5 | `@orkestrel/mcp` `^0.0.44`, `@orkestrel/html` `^0.0.17`, `@orkestrel/pool` `^0.0.22`, `@orkestrel/tool` `^0.0.24`, `@orkestrel/codec` `^0.0.11`, `@orkestrel/router` `^0.0.22`, `@orkestrel/server` `^0.0.28`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/markdown` `^0.0.22`, `@orkestrel/websocket` `^0.0.20` | |
50
+ | `@orkestrel/budget` | `0.0.19` | L1 | `@orkestrel/contract` `^0.0.24` | |
51
+ | `@orkestrel/capture` | `0.0.10` | L3 | `@orkestrel/process` `^0.0.21`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | `vite` `^8.3.8`, `vitest` `^5.1.0`, `playwright` `^1.65.0`, `@orkestrel/test` `~0.0.41`, `@vitest/browser-playwright` `^5.0.5` |
52
+ | `@orkestrel/codec` | `0.0.11` | L1 | `@orkestrel/contract` `^0.0.24` | |
53
+ | `@orkestrel/console` | `0.0.21` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
54
+ | `@orkestrel/contract` | `0.0.24` | L0 | | |
55
+ | `@orkestrel/csv` | `0.0.15` | L2 | `@orkestrel/codec` `^0.0.11`, `@orkestrel/contract` `^0.0.24` | |
56
+ | `@orkestrel/database` | `0.0.27` | L2 | `@orkestrel/sqlite` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/indexeddb` `^0.0.19` | |
57
+ | `@orkestrel/emitter` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.24` | |
58
+ | `@orkestrel/form` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
59
+ | `@orkestrel/guide` | `0.0.32` | L3 | `@orkestrel/contract` `^0.0.24`, `@orkestrel/markdown` `^0.0.22` | |
60
+ | `@orkestrel/html` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.24` | |
61
+ | `@orkestrel/indexeddb` | `0.0.19` | L1 | `@orkestrel/contract` `^0.0.24` | |
62
+ | `@orkestrel/interpret` | `0.0.24` | L3 | `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/template` `^0.0.15` | |
63
+ | `@orkestrel/jsonrpc` | `0.0.4` | L1 | `@orkestrel/contract` `^0.0.24` | |
64
+ | `@orkestrel/lsp` | `0.0.16` | L3 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/jsonrpc` `^0.0.4`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24` | |
65
+ | `@orkestrel/markdown` | `0.0.22` | L2 | `@orkestrel/html` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
66
+ | `@orkestrel/mcp` | `0.0.44` | L4 | `@orkestrel/sse` `^0.0.15`, `@orkestrel/tool` `^0.0.24`, `@orkestrel/codec` `^0.0.11`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/jsonrpc` `^0.0.4`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/websocket` `^0.0.20` | `@orkestrel/router` `^0.0.22`, `@orkestrel/server` `^0.0.28` |
67
+ | `@orkestrel/middleware` | `0.0.33` | L4 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | `@orkestrel/server` `^0.0.28`, `@orkestrel/database` `^0.0.27` |
68
+ | `@orkestrel/msg` | `0.0.18` | L2 | `@orkestrel/codec` `^0.0.11`, `@orkestrel/contract` `^0.0.24` | |
69
+ | `@orkestrel/ndjson` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.24` | |
70
+ | `@orkestrel/ollama` | `0.0.39` | L6 | `@orkestrel/tool` `^0.0.24`, `@orkestrel/agent` `^0.0.45`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/ndjson` `^0.0.18`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24` | |
71
+ | `@orkestrel/pool` | `0.0.22` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
72
+ | `@orkestrel/probe` | `0.0.31` | L5 | `@orkestrel/lsp` `^0.0.16`, `@orkestrel/mcp` `^0.0.44`, `@orkestrel/pool` `^0.0.22`, `@orkestrel/tool` `^0.0.24`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/process` `^0.0.20`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | `vitest` `^4.1.12 \|\| ^5.1.0`, `typescript` `^6.0.3 \|\| ^7.0.2` |
73
+ | `@orkestrel/process` | `0.0.21` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
74
+ | `@orkestrel/program` | `0.0.22` | L4 | `@orkestrel/rater` `^0.0.23`, `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/qualifier` `^0.0.23` | |
75
+ | `@orkestrel/qualifier` | `0.0.23` | L3 | `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
76
+ | `@orkestrel/queue` | `0.0.24` | L3 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
77
+ | `@orkestrel/rater` | `0.0.23` | L3 | `@orkestrel/reason` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
78
+ | `@orkestrel/reason` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
79
+ | `@orkestrel/relation` | `0.0.25` | L3 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
80
+ | `@orkestrel/router` | `0.0.22` | L2 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
81
+ | `@orkestrel/scaffold` | `0.0.137` | L3 | `@orkestrel/console` `^0.0.21`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/markdown` `^0.0.22`, `@orkestrel/template` `^0.0.15` | |
82
+ | `@orkestrel/sea` | `0.0.24` | L3 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/process` `^0.0.20`, `@orkestrel/contract` `^0.0.24` | |
83
+ | `@orkestrel/server` | `0.0.28` | L3 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/codec` `^0.0.11`, `@orkestrel/router` `^0.0.22`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | |
84
+ | `@orkestrel/sqlite` | `0.0.19` | L1 | `@orkestrel/contract` `^0.0.24` | |
85
+ | `@orkestrel/sse` | `0.0.15` | L2 | `@orkestrel/codec` `^0.0.11`, `@orkestrel/contract` `^0.0.24` | |
86
+ | `@orkestrel/study` | `0.0.21` | L7 | `@orkestrel/tool` `^0.0.24`, `@orkestrel/abort` `^0.0.18`, `@orkestrel/agent` `^0.0.45`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/ollama` `^0.0.39`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24` | |
87
+ | `@orkestrel/table` | `0.0.18` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
88
+ | `@orkestrel/template` | `0.0.15` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
89
+ | `@orkestrel/terminal` | `0.0.27` | L3 | `@orkestrel/sse` `^0.0.15`, `@orkestrel/form` `^0.0.19`, `@orkestrel/console` `^0.0.21`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
90
+ | `@orkestrel/test` | `0.0.42` | L1 | `@orkestrel/contract` `^0.0.24` | `vitest` `^5.1.0`, `playwright` `^1.65.0` |
91
+ | `@orkestrel/timeout` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.24` | |
92
+ | `@orkestrel/tool` | `0.0.24` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
93
+ | `@orkestrel/toolbox` | `0.0.34` | L6 | `@orkestrel/form` `^0.0.19`, `@orkestrel/tool` `^0.0.24`, `@orkestrel/agent` `^0.0.45`, `@orkestrel/server` `^0.0.28`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27`, `@orkestrel/relation` `^0.0.25`, `@orkestrel/terminal` `^0.0.27`, `@orkestrel/workflow` `^0.0.30`, `@orkestrel/workspace` `^0.0.20` | |
94
+ | `@orkestrel/websocket` | `0.0.20` | L2 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24` | |
95
+ | `@orkestrel/worker` | `0.0.24` | L4 | `@orkestrel/pool` `^0.0.22`, `@orkestrel/queue` `^0.0.24`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
96
+ | `@orkestrel/workflow` | `0.0.30` | L4 | `@orkestrel/abort` `^0.0.18`, `@orkestrel/queue` `^0.0.24`, `@orkestrel/budget` `^0.0.19`, `@orkestrel/emitter` `^0.0.17`, `@orkestrel/timeout` `^0.0.18`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
97
+ | `@orkestrel/workspace` | `0.0.20` | L3 | `@orkestrel/emitter` `^0.0.17`, `@orkestrel/contract` `^0.0.24`, `@orkestrel/database` `^0.0.27` | |
98
98
 
99
99
  <!-- /orkestrel:catalog -->
100
100
 
@@ -100,7 +100,10 @@ The non-negotiables and design laws in `AGENTS.md` apply without exception and a
100
100
  twice;
101
101
  - a write that a platform API requires, such as `process.exitCode`, a DOM property, or a Vue `ref`
102
102
  value, and one write per key into a fresh local object that builds a fixture a literal cannot
103
- express, such as a cycle or a sparse array.
103
+ express, such as a cycle or a sparse array;
104
+ - a preallocated typed array written once per index, in index order, as the input a byte API
105
+ requires, such as zlib, a PNG encoder, or `Buffer`, which is a platform-API write; write no
106
+ index twice.
104
107
  - **Per-call state.** Keep state that the awaits or callbacks of one call change, other than a log,
105
108
  in `#` fields of an entity created for that call. Treat a list that more than one concurrently
106
109
  pending async path of one call appends to, such as the workers of a pool, as state of that call:
@@ -226,10 +226,12 @@ one environment, so each is its own project:
226
226
  module as their `globalSetup` option, and give no other project a global setup.
227
227
  - When a browser application selects the journey axis, register `journey:<variant>` projects
228
228
  through the birth-owned `configs/app/vite.journey.config.ts` wrapper. Keep the adopter's variant
229
- list there and compose each project through the root `appJourney(variant, variants, mode?, override?)`
230
- factory, which resolves the Vite mode to `browser` or an app-side browser extension and collects
231
- `tests/app/<application>/integration.test.ts` for that application. The factory merges its
232
- `override` last, through `mergeOverride`, so an override replaces nothing it does not name. Exclude each collected suite
229
+ list there, build the wrapper with one `buildCaptureWrapper` call from
230
+ `@orkestrel/capture/server`, and compose each project in its `project` option through the root
231
+ `appJourney(variant, mode?, override?)` factory, which resolves the Vite mode to `browser` or an
232
+ app-side browser extension and collects `tests/app/<application>/integration.test.ts` for that
233
+ application. The factory merges capture's `override` last, through `mergeOverride`, so an
234
+ override replaces nothing it does not name. Exclude each collected suite
233
235
  from its application project. Generate `test:journey` when the workspace has the base entry `app/browser/main.ts`, and one `test:journey:<framework>` per
234
236
  app-side browser extension, and place them by the gate-placement paragraph that follows.
235
237