@orkestrel/scaffold 0.0.136 → 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 +11 -11
- 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-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/agent.md +3 -1
- package/dist/host/guides/brief.md +16 -16
- package/dist/host/guides/browser.md +1 -1
- package/dist/host/guides/capture.md +442 -313
- package/dist/host/guides/database.md +14 -11
- package/dist/host/guides/process.md +139 -53
- package/dist/host/guides/reason.md +1 -1
- package/dist/host/guides/scaffold.md +33 -21
- package/dist/host/guides/test.md +353 -232
- package/dist/host/guides/tool.md +2 -1
- package/dist/host/guides/toolbox.md +44 -44
- package/dist/host/guides/workflow.md +2 -2
- package/dist/host/manifest.json +20 -20
- package/dist/host/tests/config.test.ts +19 -27
- package/dist/src/core/index.cjs +144 -65
- 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 +144 -65
- package/dist/src/core/index.js.map +1 -1
- package/package.json +11 -11
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.
|
|
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",
|
|
@@ -102,20 +102,20 @@ var package_default = {
|
|
|
102
102
|
"prepublishOnly": "npm run format:check && npm run lint:check && npm run check && npm run build && npm test && npm run test:templates && npm run test:distribution -- --mode release"
|
|
103
103
|
},
|
|
104
104
|
dependencies: {
|
|
105
|
-
"@orkestrel/console": "^0.0.
|
|
105
|
+
"@orkestrel/console": "^0.0.21",
|
|
106
106
|
"@orkestrel/contract": "^0.0.24",
|
|
107
|
-
"@orkestrel/emitter": "^0.0.
|
|
108
|
-
"@orkestrel/markdown": "^0.0.
|
|
109
|
-
"@orkestrel/process": "^0.0.
|
|
110
|
-
"@orkestrel/template": "^0.0.
|
|
107
|
+
"@orkestrel/emitter": "^0.0.17",
|
|
108
|
+
"@orkestrel/markdown": "^0.0.22",
|
|
109
|
+
"@orkestrel/process": "^0.0.21",
|
|
110
|
+
"@orkestrel/template": "^0.0.15"
|
|
111
111
|
},
|
|
112
112
|
devDependencies: {
|
|
113
113
|
"@microsoft/api-extractor": "^7.60.1",
|
|
114
|
-
"@orkestrel/browser": "^0.0.
|
|
115
|
-
"@orkestrel/guide": "^0.0.
|
|
116
|
-
"@orkestrel/html": "^0.0.
|
|
117
|
-
"@orkestrel/probe": "^0.0.
|
|
118
|
-
"@orkestrel/test": "^0.0.
|
|
114
|
+
"@orkestrel/browser": "^0.0.34",
|
|
115
|
+
"@orkestrel/guide": "^0.0.32",
|
|
116
|
+
"@orkestrel/html": "^0.0.17",
|
|
117
|
+
"@orkestrel/probe": "^0.0.31",
|
|
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
|
-
-
|
|
76
|
-
|
|
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
|
|
81
|
-
`
|
|
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
|
-
-
|
|
90
|
-
|
|
91
|
-
`
|
|
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
|
-
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
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
|
-
-
|
|
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,
|
|
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,
|
|
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 {
|
|
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
|
|
32
|
-
`CAPTURE` environment variable set to `1` in the shell that runs the axis. An
|
|
33
|
-
it false, so `place` returns `undefined`, resizes nothing, writes nothing,
|
|
34
|
-
and still refuses an unregistered state and a second placement of one state.
|
|
35
|
-
- Read `files` for the registry expanded across every variant, `
|
|
36
|
-
and `paths` for what it wrote. Each
|
|
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
|
-
-
|
|
63
|
-
`
|
|
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.
|
|
78
|
-
|
|
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
|
|
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
|
|
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
|
|
130
|
-
|
|
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.
|
|
47
|
-
| `@orkestrel/agent` | `0.0.
|
|
48
|
-
| `@orkestrel/brief` | `0.0.
|
|
49
|
-
| `@orkestrel/browser` | `0.0.
|
|
50
|
-
| `@orkestrel/budget` | `0.0.
|
|
51
|
-
| `@orkestrel/capture` | `0.0.
|
|
52
|
-
| `@orkestrel/codec` | `0.0.
|
|
53
|
-
| `@orkestrel/console` | `0.0.
|
|
54
|
-
| `@orkestrel/contract` | `0.0.24` | L0 | |
|
|
55
|
-
| `@orkestrel/csv` | `0.0.
|
|
56
|
-
| `@orkestrel/database` | `0.0.
|
|
57
|
-
| `@orkestrel/emitter` | `0.0.
|
|
58
|
-
| `@orkestrel/form` | `0.0.
|
|
59
|
-
| `@orkestrel/guide` | `0.0.
|
|
60
|
-
| `@orkestrel/html` | `0.0.
|
|
61
|
-
| `@orkestrel/indexeddb` | `0.0.19` | L1 | `@orkestrel/contract` `^0.0.24` |
|
|
62
|
-
| `@orkestrel/interpret` | `0.0.
|
|
63
|
-
| `@orkestrel/jsonrpc` | `0.0.
|
|
64
|
-
| `@orkestrel/lsp` | `0.0.
|
|
65
|
-
| `@orkestrel/markdown` | `0.0.
|
|
66
|
-
| `@orkestrel/mcp` | `0.0.
|
|
67
|
-
| `@orkestrel/middleware` | `0.0.
|
|
68
|
-
| `@orkestrel/msg` | `0.0.
|
|
69
|
-
| `@orkestrel/ndjson` | `0.0.
|
|
70
|
-
| `@orkestrel/ollama` | `0.0.
|
|
71
|
-
| `@orkestrel/pool` | `0.0.
|
|
72
|
-
| `@orkestrel/probe` | `0.0.
|
|
73
|
-
| `@orkestrel/process` | `0.0.
|
|
74
|
-
| `@orkestrel/program` | `0.0.
|
|
75
|
-
| `@orkestrel/qualifier` | `0.0.
|
|
76
|
-
| `@orkestrel/queue` | `0.0.
|
|
77
|
-
| `@orkestrel/rater` | `0.0.
|
|
78
|
-
| `@orkestrel/reason` | `0.0.
|
|
79
|
-
| `@orkestrel/relation` | `0.0.
|
|
80
|
-
| `@orkestrel/router` | `0.0.
|
|
81
|
-
| `@orkestrel/scaffold` | `0.0.
|
|
82
|
-
| `@orkestrel/sea` | `0.0.
|
|
83
|
-
| `@orkestrel/server` | `0.0.
|
|
84
|
-
| `@orkestrel/sqlite` | `0.0.19` | L1 | `@orkestrel/contract` `^0.0.24` |
|
|
85
|
-
| `@orkestrel/sse` | `0.0.
|
|
86
|
-
| `@orkestrel/study` | `0.0.
|
|
87
|
-
| `@orkestrel/table` | `0.0.
|
|
88
|
-
| `@orkestrel/template` | `0.0.
|
|
89
|
-
| `@orkestrel/terminal` | `0.0.
|
|
90
|
-
| `@orkestrel/test` | `0.0.
|
|
91
|
-
| `@orkestrel/timeout` | `0.0.
|
|
92
|
-
| `@orkestrel/tool` | `0.0.
|
|
93
|
-
| `@orkestrel/toolbox` | `0.0.
|
|
94
|
-
| `@orkestrel/websocket` | `0.0.
|
|
95
|
-
| `@orkestrel/worker` | `0.0.
|
|
96
|
-
| `@orkestrel/workflow` | `0.0.
|
|
97
|
-
| `@orkestrel/workspace` | `0.0.
|
|
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
|
|
230
|
-
|
|
231
|
-
`
|
|
232
|
-
|
|
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
|
|
|
@@ -535,6 +535,8 @@ The `builtins` option of `AgentOptions` enables the tools an agent serves itself
|
|
|
535
535
|
|
|
536
536
|
The constructor refuses the `builtins` option with `AgentError` code `'BUILTIN'` when an entry is no `AgentBuiltin` name, when a name repeats, when it lists `unload` without `load`, and when the tool manager already holds a tool under an enabled name. Each run owns its built-in tools, so a tool a host registers later under an enabled name is never advertised or dispatched. With `builtins` absent, no skill holds a tool back and no skill body renders.
|
|
537
537
|
|
|
538
|
+
Each built-in's door repairs a lossless leaf before its handler runs, as the `repairValue` function of `@orkestrel/contract` repairs it: a finite number given for an argument, `-0` excepted, reads as its digits, so `{ skill: 7 }` loads the skill `'7'`. Every other malformed argument refuses with the tool's `'ARGUMENTS'` error before the handler runs. Each built-in's description in `BUILTIN_TOOLS` states the repair to the model, and the ledger's room admission and the read of what a run shows repair a stored call's arguments the same way.
|
|
539
|
+
|
|
538
540
|
The following agent lets the model load a skill, and the skill's tool waits for that load:
|
|
539
541
|
|
|
540
542
|
```ts
|
|
@@ -587,7 +589,7 @@ const plain = createScope({ name: 'plain', workspaces: ['orders'] })
|
|
|
587
589
|
await agent.generate({ prompt: { content: 'Check order 9.' }, scope: plain }) // renders orders
|
|
588
590
|
```
|
|
589
591
|
|
|
590
|
-
What a run shows comes from its conversation. Each turn reads the conversation's stored messages for every successful `load`, `unload`, and `switch` call, recognized by the note it returned, and keeps what the registries hold and the ceiling admits. The shown skills are the model's, in load order, and a skill loaded again after its unload goes last. A denied, refused, or failed call shows nothing, and so does a tool message whose text equals a note but answers another tool's call. A record counts only while the run enables its built-in, so a host tool under a built-in's name on a run that doesn't enable it shows nothing. A stored record can't name its writer, so a record such a tool wrote counts after a run enables the built-in, bounded by the registry and the ceiling as every record is. The read
|
|
592
|
+
What a run shows comes from its conversation. Each turn reads the conversation's stored messages for every successful `load`, `unload`, and `switch` call, recognized by the note it returned, and keeps what the registries hold and the ceiling admits. The shown skills are the model's, in load order, and a skill loaded again after its unload goes last. A denied, refused, or failed call shows nothing, and so does a tool message whose text equals a note but answers another tool's call. A record counts only while the run enables its built-in, so a host tool under a built-in's name on a run that doesn't enable it shows nothing. A stored record can't name its writer, so a record such a tool wrote counts after a run enables the built-in, bounded by the registry and the ceiling as every record is. The read repairs each call's arguments through the `repairValue` function of `@orkestrel/contract`, as the tool's door repairs them, so a `{ skill: 1 }` the door repaired to `'1'` shows the skill `'1'`. A fold keeps the record, because the read covers each section's retained originals before the live tail, and a conversation restored from its `ConversationSnapshot` shows what it showed when the snapshot was taken. A skill the ceiling excludes, or the registry no longer holds, shows nothing, and it shows again with no further `load` when it is admitted again. The loop reads no record while `builtins` lists none of `load`, `unload`, and `switch`. In the following runs, the second conversation shows nothing until its own load, and the restored one shows the skill from its first request:
|
|
591
593
|
|
|
592
594
|
```ts
|
|
593
595
|
import type { ProviderInterface } from '@orkestrel/agent'
|