@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.
- package/dist/agents/skills/orkestrel-harden/scripts/interleave.js +539 -0
- package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +1163 -0
- package/dist/bin/main.js +21 -19
- package/dist/bin/main.js.map +1 -1
- package/dist/host/agents/orchestration.md +13 -7
- package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +4 -3
- package/dist/host/agents/skills/orkestrel-dispatch/references/launch.md +1 -1
- package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +4 -2
- package/dist/host/agents/skills/orkestrel-falsify/references/brief.md +2 -2
- package/dist/host/agents/skills/orkestrel-harden/SKILL.md +16 -3
- package/dist/host/agents/skills/orkestrel-harden/references/bindings.md +18 -12
- package/dist/host/agents/skills/orkestrel-harden/references/document.md +1 -0
- package/dist/host/agents/skills/orkestrel-harden/references/equivalence.md +2 -1
- package/dist/host/agents/skills/orkestrel-harden/references/hardening.md +1 -1
- package/dist/host/agents/skills/orkestrel-harden/references/methods.md +642 -0
- package/dist/host/agents/skills/orkestrel-harden/scripts/interleave.ts +665 -0
- package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +14 -13
- package/dist/host/agents/skills/orkestrel-parallel/references/claude-code.md +13 -13
- package/dist/host/agents/skills/orkestrel-parallel/references/t3.md +1 -0
- package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +1433 -0
- package/dist/host/agents/skills/orkestrel-publish/SKILL.md +2 -1
- package/dist/host/agents/skills/orkestrel-publish/references/wave.md +18 -1
- package/dist/host/claude/AGENTS.md +1 -1
- package/dist/host/claude/agents/analyst.md +1 -1
- package/dist/host/claude/agents/builder.md +1 -1
- package/dist/host/claude/agents/distiller.md +2 -1
- package/dist/host/claude/agents/grok.md +2 -2
- package/dist/host/claude/agents/opus.md +2 -2
- package/dist/host/claude/agents/orkestrel.md +30 -30
- package/dist/host/claude/agents/reviewer.md +2 -2
- package/dist/host/claude/agents/scout.md +2 -1
- package/dist/host/claude/agents/verifier.md +1 -1
- package/dist/host/claude/rules/campaign.md +12 -11
- package/dist/host/claude/rules/documentation.md +1 -0
- package/dist/host/claude/rules/patterns.md +14 -0
- package/dist/host/claude/rules/quality.md +4 -1
- package/dist/host/claude/rules/tests.md +4 -0
- package/dist/host/claude/rules/writing.md +1 -1
- package/dist/host/claude/skills/orkestrel-parallel/SKILL.md +1 -1
- package/dist/host/codex/agents/analyst.toml +4 -1
- package/dist/host/codex/agents/astra.toml +1 -1
- package/dist/host/codex/agents/builder.toml +1 -1
- package/dist/host/codex/agents/distiller.toml +4 -2
- package/dist/host/codex/agents/grok.toml +5 -2
- package/dist/host/codex/agents/opus.toml +3 -3
- package/dist/host/codex/agents/reviewer.toml +6 -2
- package/dist/host/codex/agents/scout.toml +5 -1
- package/dist/host/codex/agents/verifier.toml +6 -1
- package/dist/host/guides/agent.md +1119 -457
- package/dist/host/guides/contract.md +226 -104
- package/dist/host/guides/database.md +12 -12
- package/dist/host/guides/ndjson.md +94 -21
- package/dist/host/guides/ollama.md +22 -18
- package/dist/host/guides/probe.md +29 -27
- package/dist/host/guides/reason.md +377 -114
- package/dist/host/guides/scaffold.md +43 -21
- package/dist/host/guides/study.md +538 -450
- package/dist/host/guides/tool.md +163 -58
- package/dist/host/manifest.json +70 -52
- package/dist/src/core/index.cjs +21 -20
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.d.cts +1 -4
- package/dist/src/core/index.d.ts +1 -4
- package/dist/src/core/index.js +21 -20
- package/dist/src/core/index.js.map +1 -1
- package/dist/src/server/index.cjs +87 -8
- package/dist/src/server/index.cjs.map +1 -1
- package/dist/src/server/index.d.cts +50 -6
- package/dist/src/server/index.d.ts +50 -6
- package/dist/src/server/index.js +87 -10
- package/dist/src/server/index.js.map +1 -1
- 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
|
|
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
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
`
|
|
407
|
-
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
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
|
|
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
|
|
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,
|