@orkestrel/scaffold 0.0.129 → 0.0.131

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.
@@ -88,6 +88,7 @@ The harness's own engine orchestrates: Claude Fable 5.2 or Claude Opus 5.5 in Cl
88
88
  ## Pace
89
89
 
90
90
  - Spend process only where it changes a result. Launch, run, and report: no fixed clock windows, readiness-only turns, per-command acknowledgments, hash pins of a brief, or process queries beyond the recorded process ids.
91
+ - When no acceptance check reads a run's result anymore, stop the run.
91
92
  - When a verifier lane fails in its harness rather than in the gate, run the gate once yourself and read its exit code; write no comparator, snapshot, or retry chain to obtain evidence.
92
93
  - Keep valid receipts. Re-run a check only when a change to its inputs, configuration, environment, or claim could alter what it proved, and then run the narrowest check that covers the change. Never repeat a passing check to collect another receipt or to have every suite pass in one command; name the receipt that covers each check a brief does not rerun.
93
94
  - Ask the user only for a decision that is theirs: scope, the spend ceiling and stop line § Hold the plan names, a conflicting ruling, a credential, publication, or a commit or push the law reserves. Decide routine matters yourself, such as time and lane allowances, retries, and order, and report them, with time in whole minutes.
@@ -13,6 +13,7 @@ The commands an agent runs on a Windows host, and their quirks. `.claude/rules/p
13
13
  - Detach a run from the session's process tree with WMI: `Invoke-CimMethod -ClassName Win32_Process -MethodName Create -Arguments @{ CommandLine = '<command>' }`. The run starts under `WmiPrvSE.exe`, outside the session's job and process tree (verified 2026-10-16). It receives the user's registry environment, not the caller's, so pass each value it needs on its command line. Record its journal and pid-file paths before the launch.
14
14
  - Spawn npm without a shell through its JavaScript entry: `node <node directory>/node_modules/npm/bin/npm-cli.js <arguments>`. A `.cmd` shim cannot start without a shell, and `launch.ts` reports exit `127`.
15
15
  - `cmd /c` keeps a trailing space inside `set VAR=value && …`; write `set "VAR=value"`.
16
+ - When a file name would carry a script name such as `test:app`, write `-` for each `:`: NTFS reads `name:stream` as an alternate data stream, so the write lands in a stream of `name` and no file of the intended name appears.
16
17
  - Deliver a console Ctrl+C through `WScript.Shell` `AppActivate` then `SendKeys('^c')` after confirming activation when no computer-use tool is available.
17
18
  - A `rename` onto a freshly hard-linked file can return `EPERM` while a scanner holds it.
18
19
  - A child CLI can leak orphaned `conhost.exe` processes and open console windows. Count them with `Get-Process conhost` at each launch while such a lane is live.
@@ -26,6 +26,7 @@ T3 hosts Claude, Codex, and Cursor lanes as app-owned child tasks of a thread, a
26
26
  - When a launch's reply is missing or ambiguous, inspect the recorded task before retrying. A timeout on a parent wait cancels no child work.
27
27
  - When a send carries a consequential message, use `auto` and read the target to confirm it arrived: a `queue` send reported as queued, on a run that had already completed, never reached its target (2026-11-05).
28
28
  - When a child's status reads completed, read its thread and the process list before acting on that status: its background shell can wake it for another turn. Check a child's claim about its own shell the same way (2026-11-05).
29
+ - When a child ends its turn while a background command it started still runs, wait for the `delegated-task:provider-continuation` notification that command's exit delivers to the parent, carrying the child's next report; never relaunch the child or poll its thread for it (2026-11-10).
29
30
  - When a finished child still holds servers past the idle stop, stop them by recorded process id, and read `.agents/platforms/` for what each child costs on the host.
30
31
  - When a thread shows a nonzero `pendingRequestCount` and `t3_pending_request` lists nothing, read it as an approval nobody can answer, because that tool lists no approvals (2026-11-06).
31
32
  - When a lane must be interrupted and restarted, use `restart`; never use it as a resume. Create no ordinary top-level thread as a delegated lane.
@@ -88,6 +88,7 @@ Every verdict returns:
88
88
  - one line per item, in the brief's numbering:
89
89
  - `RENDERED-PROVEN(<capture>)` — the artifact shows it;
90
90
  - `REGRESSED(<capture>, <what regressed>)` — the artifact shows it is now worse;
91
+ - `REFUTED(<capture>, <what it shows>)` — the artifact shows a seeded candidate is false;
91
92
  - `NOT-EVIDENCED(<what the portfolio lacks>)` — the portfolio cannot decide it;
92
93
  - referrals to another lane, each with the specific evidence and no verdict attached;
93
94
  - exactly one final line: `CONVERGED` or `ANOTHER ROUND(<item list>)`.
@@ -44,11 +44,11 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
44
44
  | Package | Version | Layer | Runtime dependencies | Peer dependencies |
45
45
  | ----------------------- | --------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
46
46
  | `@orkestrel/abort` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.22` | |
47
- | `@orkestrel/agent` | `0.0.39` | L5 | `@orkestrel/tool` `^0.0.22`, `@orkestrel/abort` `^0.0.16`, `@orkestrel/queue` `^0.0.21`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/ndjson` `^0.0.16`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22`, `@orkestrel/workflow` `^0.0.27`, `@orkestrel/workspace` `^0.0.16` | |
47
+ | `@orkestrel/agent` | `0.0.40` | L5 | `@orkestrel/tool` `^0.0.22`, `@orkestrel/abort` `^0.0.16`, `@orkestrel/queue` `^0.0.21`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/ndjson` `^0.0.16`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22`, `@orkestrel/workflow` `^0.0.27`, `@orkestrel/workspace` `^0.0.16` | |
48
48
  | `@orkestrel/brief` | `0.0.17` | L4 | `@orkestrel/reason` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/interpret` `^0.0.22` | |
49
49
  | `@orkestrel/browser` | `0.0.32` | L5 | `@orkestrel/mcp` `^0.0.42`, `@orkestrel/html` `^0.0.15`, `@orkestrel/pool` `^0.0.20`, `@orkestrel/tool` `^0.0.22`, `@orkestrel/codec` `^0.0.9`, `@orkestrel/router` `^0.0.20`, `@orkestrel/server` `^0.0.26`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/markdown` `^0.0.20`, `@orkestrel/websocket` `^0.0.18` | |
50
50
  | `@orkestrel/budget` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.22` | |
51
- | `@orkestrel/capture` | `0.0.5` | L3 | `@orkestrel/process` `^0.0.18`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | `vite` `^8.3.7`, `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.61.0`, `@vitest/browser-playwright` `^4.1.12 \|\| ^5.0.5` |
51
+ | `@orkestrel/capture` | `0.0.6` | L3 | `@orkestrel/process` `^0.0.18`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | `vite` `^8.3.7`, `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.61.0`, `@vitest/browser-playwright` `^4.1.12 \|\| ^5.0.5` |
52
52
  | `@orkestrel/codec` | `0.0.9` | L1 | `@orkestrel/contract` `^0.0.22` | |
53
53
  | `@orkestrel/console` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
54
54
  | `@orkestrel/contract` | `0.0.22` | L0 | | |
@@ -64,10 +64,10 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
64
64
  | `@orkestrel/lsp` | `0.0.14` | L3 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/jsonrpc` `^0.0.2`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22` | |
65
65
  | `@orkestrel/markdown` | `0.0.20` | L2 | `@orkestrel/html` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
66
66
  | `@orkestrel/mcp` | `0.0.42` | L4 | `@orkestrel/sse` `^0.0.13`, `@orkestrel/tool` `^0.0.22`, `@orkestrel/codec` `^0.0.9`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/jsonrpc` `^0.0.2`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/websocket` `^0.0.18` | `@orkestrel/router` `^0.0.20`, `@orkestrel/server` `^0.0.26` |
67
- | `@orkestrel/middleware` | `0.0.29` | L4 | `@orkestrel/abort` `^0.0.16`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | `@orkestrel/server` `^0.0.26`, `@orkestrel/database` `^0.0.22` |
67
+ | `@orkestrel/middleware` | `0.0.30` | L4 | `@orkestrel/abort` `^0.0.16`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | `@orkestrel/server` `^0.0.26`, `@orkestrel/database` `^0.0.22` |
68
68
  | `@orkestrel/msg` | `0.0.16` | L2 | `@orkestrel/codec` `^0.0.9`, `@orkestrel/contract` `^0.0.22` | |
69
69
  | `@orkestrel/ndjson` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.22` | |
70
- | `@orkestrel/ollama` | `0.0.33` | L6 | `@orkestrel/tool` `^0.0.22`, `@orkestrel/agent` `^0.0.39`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/ndjson` `^0.0.16`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22` | |
70
+ | `@orkestrel/ollama` | `0.0.34` | L6 | `@orkestrel/tool` `^0.0.22`, `@orkestrel/agent` `^0.0.40`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/ndjson` `^0.0.16`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22` | |
71
71
  | `@orkestrel/pool` | `0.0.20` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
72
72
  | `@orkestrel/probe` | `0.0.29` | L5 | `@orkestrel/lsp` `^0.0.14`, `@orkestrel/mcp` `^0.0.42`, `@orkestrel/pool` `^0.0.20`, `@orkestrel/tool` `^0.0.22`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | `vitest` `^4.1.12 \|\| ^5.1.0`, `typescript` `^6.0.3 \|\| ^7.0.2` |
73
73
  | `@orkestrel/process` | `0.0.18` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
@@ -78,19 +78,19 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
78
78
  | `@orkestrel/reason` | `0.0.17` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
79
79
  | `@orkestrel/relation` | `0.0.20` | L3 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22` | |
80
80
  | `@orkestrel/router` | `0.0.20` | L2 | `@orkestrel/abort` `^0.0.16`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
81
- | `@orkestrel/scaffold` | `0.0.128` | L3 | `@orkestrel/console` `^0.0.19`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/markdown` `^0.0.20`, `@orkestrel/template` `^0.0.13` | |
81
+ | `@orkestrel/scaffold` | `0.0.130` | L3 | `@orkestrel/console` `^0.0.19`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/markdown` `^0.0.20`, `@orkestrel/template` `^0.0.13` | |
82
82
  | `@orkestrel/sea` | `0.0.22` | L3 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22` | |
83
83
  | `@orkestrel/server` | `0.0.26` | L3 | `@orkestrel/abort` `^0.0.16`, `@orkestrel/codec` `^0.0.9`, `@orkestrel/router` `^0.0.20`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | |
84
84
  | `@orkestrel/sqlite` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.22` | |
85
85
  | `@orkestrel/sse` | `0.0.13` | L2 | `@orkestrel/codec` `^0.0.9`, `@orkestrel/contract` `^0.0.22` | |
86
- | `@orkestrel/study` | `0.0.16` | L7 | `@orkestrel/tool` `^0.0.22`, `@orkestrel/abort` `^0.0.16`, `@orkestrel/agent` `^0.0.39`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/ollama` `^0.0.33`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | |
86
+ | `@orkestrel/study` | `0.0.17` | L7 | `@orkestrel/tool` `^0.0.22`, `@orkestrel/abort` `^0.0.16`, `@orkestrel/agent` `^0.0.40`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/ollama` `^0.0.34`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | |
87
87
  | `@orkestrel/table` | `0.0.15` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
88
88
  | `@orkestrel/template` | `0.0.13` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
89
89
  | `@orkestrel/terminal` | `0.0.24` | L3 | `@orkestrel/sse` `^0.0.13`, `@orkestrel/form` `^0.0.16`, `@orkestrel/console` `^0.0.19`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22` | |
90
90
  | `@orkestrel/test` | `0.0.33` | L1 | `@orkestrel/contract` `^0.0.22` | `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.64.1` |
91
91
  | `@orkestrel/timeout` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.22` | |
92
92
  | `@orkestrel/tool` | `0.0.22` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
93
- | `@orkestrel/toolbox` | `0.0.28` | L6 | `@orkestrel/form` `^0.0.16`, `@orkestrel/tool` `^0.0.22`, `@orkestrel/agent` `^0.0.39`, `@orkestrel/server` `^0.0.26`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22`, `@orkestrel/relation` `^0.0.20`, `@orkestrel/terminal` `^0.0.24`, `@orkestrel/workflow` `^0.0.27`, `@orkestrel/workspace` `^0.0.16` | |
93
+ | `@orkestrel/toolbox` | `0.0.29` | L6 | `@orkestrel/form` `^0.0.16`, `@orkestrel/tool` `^0.0.22`, `@orkestrel/agent` `^0.0.40`, `@orkestrel/server` `^0.0.26`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22`, `@orkestrel/relation` `^0.0.20`, `@orkestrel/terminal` `^0.0.24`, `@orkestrel/workflow` `^0.0.27`, `@orkestrel/workspace` `^0.0.16` | |
94
94
  | `@orkestrel/websocket` | `0.0.18` | L2 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
95
95
  | `@orkestrel/worker` | `0.0.21` | L4 | `@orkestrel/pool` `^0.0.20`, `@orkestrel/queue` `^0.0.21`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22` | |
96
96
  | `@orkestrel/workflow` | `0.0.27` | L4 | `@orkestrel/abort` `^0.0.16`, `@orkestrel/queue` `^0.0.21`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22` | |
@@ -133,6 +133,8 @@ Use these orthogonal contract mechanisms:
133
133
 
134
134
  - Choose a hand guard or a shape-derived guard by how often the check runs and the representation it reads: a hand guard with a directional parity test on a per-element path, a derived guard at a once-per-entity door, and a diagnostic computed only after a refusal.
135
135
  - Admit an owned record from its raw form before any projection or fallback, so that corrupt-present stays apart from absent.
136
+ - When a person, a model, or a client authored a value, admit it whole against the contract this package owns for it: refuse the value when it omits a member the contract requires or carries a member the contract does not declare, and never remove a member to admit the rest. Apply § Foreign contracts, not this bullet, to a value another package publishes.
137
+ - When that contract is a compiled `@orkestrel/contract` contract, admit through the `admitValue` function and return its faults in the refusal; call the contract's `parse` method only to project an owned value outward.
136
138
  - State shape soundness, lossless semantic admission, and authoring validity as separate claims, and prove each at its own door.
137
139
  - Treat persistence canonicalization as part of the declared identity round trip: when a store reorders or rewrites a value, compare identity by the value the declaration states.
138
140
  - Make a refusal bound cover the ownership and capture work paid before validation: read the limit during capture, with one counter per door call.