@orkestrel/scaffold 0.0.122 → 0.0.124

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/dist/agents/skills/orkestrel-harden/scripts/interleave.js +539 -0
  2. package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +1163 -0
  3. package/dist/bin/main.js +21 -19
  4. package/dist/bin/main.js.map +1 -1
  5. package/dist/host/agents/orchestration.md +13 -7
  6. package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +4 -3
  7. package/dist/host/agents/skills/orkestrel-dispatch/references/launch.md +1 -1
  8. package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +4 -2
  9. package/dist/host/agents/skills/orkestrel-falsify/references/brief.md +2 -2
  10. package/dist/host/agents/skills/orkestrel-harden/SKILL.md +16 -3
  11. package/dist/host/agents/skills/orkestrel-harden/references/bindings.md +18 -12
  12. package/dist/host/agents/skills/orkestrel-harden/references/document.md +1 -0
  13. package/dist/host/agents/skills/orkestrel-harden/references/equivalence.md +2 -1
  14. package/dist/host/agents/skills/orkestrel-harden/references/hardening.md +1 -1
  15. package/dist/host/agents/skills/orkestrel-harden/references/methods.md +642 -0
  16. package/dist/host/agents/skills/orkestrel-harden/scripts/interleave.ts +665 -0
  17. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +14 -13
  18. package/dist/host/agents/skills/orkestrel-parallel/references/claude-code.md +13 -13
  19. package/dist/host/agents/skills/orkestrel-parallel/references/t3.md +1 -0
  20. package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +1433 -0
  21. package/dist/host/agents/skills/orkestrel-publish/SKILL.md +2 -1
  22. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +18 -1
  23. package/dist/host/claude/AGENTS.md +1 -1
  24. package/dist/host/claude/agents/analyst.md +1 -1
  25. package/dist/host/claude/agents/builder.md +1 -1
  26. package/dist/host/claude/agents/distiller.md +2 -1
  27. package/dist/host/claude/agents/grok.md +2 -2
  28. package/dist/host/claude/agents/opus.md +2 -2
  29. package/dist/host/claude/agents/orkestrel.md +30 -30
  30. package/dist/host/claude/agents/reviewer.md +2 -2
  31. package/dist/host/claude/agents/scout.md +2 -1
  32. package/dist/host/claude/agents/verifier.md +1 -1
  33. package/dist/host/claude/rules/campaign.md +12 -11
  34. package/dist/host/claude/rules/documentation.md +1 -0
  35. package/dist/host/claude/rules/patterns.md +14 -0
  36. package/dist/host/claude/rules/quality.md +4 -1
  37. package/dist/host/claude/rules/tests.md +4 -0
  38. package/dist/host/claude/rules/writing.md +1 -1
  39. package/dist/host/claude/skills/orkestrel-parallel/SKILL.md +1 -1
  40. package/dist/host/codex/agents/analyst.toml +4 -1
  41. package/dist/host/codex/agents/astra.toml +1 -1
  42. package/dist/host/codex/agents/builder.toml +1 -1
  43. package/dist/host/codex/agents/distiller.toml +4 -2
  44. package/dist/host/codex/agents/grok.toml +5 -2
  45. package/dist/host/codex/agents/opus.toml +3 -3
  46. package/dist/host/codex/agents/reviewer.toml +6 -2
  47. package/dist/host/codex/agents/scout.toml +5 -1
  48. package/dist/host/codex/agents/verifier.toml +6 -1
  49. package/dist/host/guides/agent.md +1119 -457
  50. package/dist/host/guides/contract.md +226 -104
  51. package/dist/host/guides/database.md +12 -12
  52. package/dist/host/guides/ndjson.md +94 -21
  53. package/dist/host/guides/ollama.md +22 -18
  54. package/dist/host/guides/probe.md +29 -27
  55. package/dist/host/guides/reason.md +377 -114
  56. package/dist/host/guides/scaffold.md +43 -21
  57. package/dist/host/guides/study.md +538 -450
  58. package/dist/host/guides/tool.md +163 -58
  59. package/dist/host/manifest.json +70 -52
  60. package/dist/src/core/index.cjs +21 -20
  61. package/dist/src/core/index.cjs.map +1 -1
  62. package/dist/src/core/index.d.cts +1 -4
  63. package/dist/src/core/index.d.ts +1 -4
  64. package/dist/src/core/index.js +21 -20
  65. package/dist/src/core/index.js.map +1 -1
  66. package/dist/src/server/index.cjs +87 -8
  67. package/dist/src/server/index.cjs.map +1 -1
  68. package/dist/src/server/index.d.cts +50 -6
  69. package/dist/src/server/index.d.ts +50 -6
  70. package/dist/src/server/index.js +87 -10
  71. package/dist/src/server/index.js.map +1 -1
  72. package/package.json +15 -15
@@ -393,19 +393,18 @@ only a verdict you assembled by hand and passed to `computeReceipt` yourself.
393
393
  than the message beside it. **A `claimant` issue is a tool's diagnostic about a candidate draft,
394
394
  and nothing else. Every other claimant fault is a throw.** That invariant is what lets one union
395
395
  serve both an issue and a failure: without it, a caller's own mistake — a test path no project
396
- collects, a `Claim.project` path that escapes the workspace — would arrive as a `claimant`
396
+ collects, a `Claim.project` path that resolves outside the workspace — would arrive as a `claimant`
397
397
  issue and satisfy the condition that a test which never ran must never satisfy. A `workspace` issue
398
398
  carries the target tree's own defect, such as a symbolic link in a mutation path, a mutation path
399
399
  whose existing components cannot be inspected, a specification directory the target tree blocks
400
400
  probe from creating, a Vitest project the root configuration declares as a path string, into which
401
401
  the runtime stage can install no overlay, or a covered module the workspace's own configuration
402
- served before the runtime overlay. An `instrument` issue carries this package's own
403
- message about an inspection that did not complete — a specification it could not write, after its
404
- directory exists, for a reason the target tree does not own, a module that ran no test, or a covered
405
- module probe's own loader received and did not resolve.
406
- `formatIssue` renders the value first as `[claimant]`, `[workspace]`, or `[instrument]`, so the
407
- ownership survives `formatVerdict`. A clean runtime stage result means every collected test
408
- passed, not that the module reported itself passed.
402
+ served before the runtime overlay. An `instrument` issue carries this package's own message about an
403
+ inspection that did not complete — a specification it could not write, after its directory exists,
404
+ for a reason the target tree does not own, a module that ran no test, or a covered module probe's
405
+ own loader received and did not resolve. `formatIssue` renders the value first as `[claimant]`,
406
+ `[workspace]`, or `[instrument]`, so the ownership survives `formatVerdict`. A clean runtime stage
407
+ result means every collected test passed, not that the module reported itself passed.
409
408
 
410
409
  **A diagnostic about a project belongs to the workspace.** The compiler reports a configuration
411
410
  fault — a JSON syntax error, an option it cannot apply, a `types` entry or an extended project it
@@ -468,17 +467,17 @@ and does not match the contract it is read against, `destroyed` builds a replace
468
467
  teardown is permanent, and `deadline` changes the budget or the work it bounds. Neither axis is
469
468
  derivable from the other. These are the pairs this package raises:
470
469
 
471
- | Party | Code | Raised when |
472
- | ------------ | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
473
- | `claimant` | `refused` | An input is rejected: a path escaping the workspace, a caller-supplied name the host refuses to inspect or create — an overlong component and one carrying a NUL byte are the shapes this package meets — a claim the tool guard rejects, a control repeating the case's candidate drafts and test byte for byte, a candidate naming no scoped project, a caller-named project whose diagnostic names no file, or a lint inspection its caller supplied no bound for. |
474
- | `claimant` | `missing` | The declared test path names no configured Vitest project, or names one the root configuration does not define. |
475
- | `claimant` | `destroyed` | A probe, a server, or a stage is used after its `destroy`. |
476
- | `claimant` | `deadline` | `ProbeOptions.deadline` expired while the stage was performing claimant-owned work, so the claim outran the budget. That stage was replaced before the next inspection began. The lint stage raises the same pair on its own when the bound its caller supplied stops a diagnostics wait, and a coordinator that armed that bound replaces the pair with its own refusal. |
477
- | `workspace` | `refused` | A mutation path crosses a symbolic link in the target tree. |
478
- | `workspace` | `missing` | The target tree does not install a tool probe resolves from it, or publishes no binary under that tool's name. |
479
- | `workspace` | `malformed` | The target tree publishes something probe cannot read: an unparsable manifest, a `bin` entry that is not a path, a TypeScript project its own compiler refuses, an unsupported tool version, a mutation path whose existing components cannot be inspected, or a directory it blocks probe from creating for the boot workbench. |
480
- | `instrument` | `malformed` | probe's own tooling could not serve: a boot control that did not report red, a language server frame it could not parse, a schema or verdict of its own it could not validate. |
481
- | `instrument` | `deadline` | A stage was not performing claimant-owned work when its budget expired, or a language server did not answer its teardown exchange within the stage's own bound. |
470
+ | Party | Code | Raised when |
471
+ | ------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
472
+ | `claimant` | `refused` | An input is rejected: a path resolving outside the workspace, a caller-supplied name the host refuses to inspect or create — an overlong component and one carrying a NUL byte are the shapes this package meets — a claim the tool guard rejects, a control repeating the case's candidate drafts and test byte for byte, a candidate naming no scoped project, a caller-named project whose diagnostic names no file, or a lint inspection its caller supplied no bound for. |
473
+ | `claimant` | `missing` | The declared test path names no configured Vitest project, or names one the root configuration does not define. |
474
+ | `claimant` | `destroyed` | A probe, a server, or a stage is used after its `destroy`. |
475
+ | `claimant` | `deadline` | `ProbeOptions.deadline` expired while the stage was performing claimant-owned work, so the claim outran the budget. That stage was replaced before the next inspection began. The lint stage raises the same pair on its own when the bound its caller supplied stops a diagnostics wait, and a coordinator that armed that bound replaces the pair with its own refusal. |
476
+ | `workspace` | `refused` | A mutation path crosses a symbolic link in the target tree. |
477
+ | `workspace` | `missing` | The target tree does not install a tool probe resolves from it, or publishes no binary under that tool's name. |
478
+ | `workspace` | `malformed` | The target tree publishes something probe cannot read: an unparsable manifest, a `bin` entry that is not a path, a TypeScript project its own compiler refuses, an unsupported tool version, a mutation path whose existing components cannot be inspected, or a directory it blocks probe from creating for the boot workbench. |
479
+ | `instrument` | `malformed` | probe's own tooling could not serve: a boot control that did not report red, a language server frame it could not parse, a schema or verdict of its own it could not validate. |
480
+ | `instrument` | `deadline` | A stage was not performing claimant-owned work when its budget expired, or a language server did not answer its teardown exchange within the stage's own bound. |
482
481
 
483
482
  A TypeScript project whose JSON the compiler cannot parse reaches you as that `workspace` and
484
483
  `malformed` pair, carrying the compiler's own diagnostic, the stage, and the project you named in
@@ -873,8 +872,8 @@ itself.
873
872
  The project digest is the digest of the `compilerOptions` member of `tsc --showConfig -p <project>`,
874
873
  read against the mirrored copy of the project with the mirror as the current directory, so the
875
874
  digest and the check read one set of files. `computeWorkspaceDigest` canonicalizes the record: a
876
- relative path the project declares that escapes the workspace root resolves against the mirror's
877
- own ancestors, and the mirror carries nothing such a path names. It still **moves with the
875
+ relative path the project declares that points outside the workspace root resolves against the
876
+ mirror's own ancestors, and the mirror carries nothing such a path names. It still **moves with the
878
877
  TypeScript version**, because a compiler decides which options it resolves and how it spells them.
879
878
  That is contained rather than surprising: the token already names `typescript@<version>`, so any
880
879
  policy pinning a digest already pins the version.
@@ -907,8 +906,8 @@ rather than as a limit on the token.
907
906
 
908
907
  ## What containment reaches
909
908
 
910
- Containment is not one rule, and the difference between its rules decides what a hostile claim can
911
- do.
909
+ Containment is not one rule, and the difference between its rules decides what an untrusted claim
910
+ can do.
912
911
 
913
912
  **Every path a claim carries is contained lexically.** `isDraft` refuses an absolute `Draft.path`
914
913
  and one that traverses out of the workspace, and `resolveWorkspaceFile` refuses the same shapes
@@ -958,12 +957,15 @@ indeterminate answer preserves the resource; only confirmed absence permits the
958
957
  **A read is contained lexically only, and that is the reach to plan for.** The mirror carries
959
958
  regular files inside the workspace only: a symbolic link is not carried, so a file reached only
960
959
  through one is absent from the mirror and the compiler reports what its absence causes, as a
961
- claimant issue like any other. A candidate path beneath an in-workspace symbolic link resolves to a
960
+ claimant issue like any other. Of the workspace-root `tmp/` directory the mirror carries only
961
+ `tmp/probes/`, because the scaffold tmp layout keeps nothing else there that an inspection reads,
962
+ and a consumer's ignored data must never be read or copied; the match is the lowercase `tmp`
963
+ spelling exactly, and a `tmp` directory below the root is walked like any other. A candidate path beneath an in-workspace symbolic link resolves to a
962
964
  file outside the workspace, and Oxlint, which reads the workspace directly rather than a mirror of
963
965
  it, inspects it there. A `Claim.project` that reaches outside the workspace through `extends`,
964
966
  `files`, `include`, or project references reaches nothing there: the type stage reads a project
965
- against the mirror, so an escaping relative path resolves against the mirror's own ancestors, and
966
- the mirror carries nothing such a path names.
967
+ against the mirror, so a relative path that points outside the workspace resolves against the
968
+ mirror's own ancestors, and the mirror carries nothing such a path names.
967
969
 
968
970
  Measured on 2026-08-20: with `link` a symbolic link to a directory outside the workspace,
969
971
  `isDraft({ path: 'link/secret.ts', text })` returns `true`,
@@ -1239,7 +1241,7 @@ server, and the supervising Codex process remained present; no synthetic load wa
1239
1241
  the package declares, what `verdict.digest` covers, and the flagship claim run for its receipt.
1240
1242
  - [`helpers.test.ts`](../tests/src/core/helpers.test.ts) — the formatters, the receipt token's
1241
1243
  conditions, and the generated specification's marker.
1242
- - [`validators.test.ts`](../tests/src/core/validators.test.ts) — every guard against hostile shapes,
1244
+ - [`validators.test.ts`](../tests/src/core/validators.test.ts) — every guard against malformed shapes,
1243
1245
  including the draft path the advertised schema admits and the guard refuses.
1244
1246
  - [`errors.test.ts`](../tests/src/core/errors.test.ts) — the failure guard against lookalikes and a
1245
1247
  duplicate copy of the package, and every failure path a test can drive without a resident tool,