@orkestrel/scaffold 0.0.108 → 0.0.110
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-dispatch/scripts/bench.js +326 -91
- package/dist/agents/skills/orkestrel-dispatch/scripts/brief.js +110 -14
- package/dist/agents/skills/orkestrel-dispatch/scripts/chain.js +280 -0
- package/dist/agents/skills/orkestrel-dispatch/scripts/cite.js +188 -26
- package/dist/agents/skills/orkestrel-dispatch/scripts/launch.js +142 -43
- package/dist/agents/skills/orkestrel-dispatch/scripts/login.js +240 -62
- package/dist/agents/skills/orkestrel-dispatch/scripts/patch.js +323 -0
- package/dist/agents/skills/orkestrel-dispatch/scripts/result.js +169 -32
- package/dist/agents/skills/orkestrel-dispatch/scripts/sweep.js +290 -69
- package/dist/agents/skills/orkestrel-falsify/scripts/mutate.js +560 -0
- package/dist/agents/skills/orkestrel-harden/scripts/discovery.js +1052 -205
- package/dist/agents/skills/orkestrel-harden/scripts/measure.js +361 -0
- package/dist/agents/skills/orkestrel-harden/scripts/titles.js +455 -80
- package/dist/agents/skills/orkestrel-parallel/scripts/cases.js +327 -0
- package/dist/agents/skills/orkestrel-publish/scripts/compare.js +298 -51
- package/dist/agents/skills/orkestrel-publish/scripts/pins.js +170 -13
- package/dist/agents/skills/orkestrel-publish/scripts/swap.js +956 -191
- package/dist/agents/skills/orkestrel-publish/scripts/wave.js +707 -112
- package/dist/agents/skills/orkestrel-publish/scripts/window.js +235 -41
- package/dist/agents/skills/orkestrel-scout/scripts/map.js +341 -54
- package/dist/agents/templates/brief.md +6 -2
- package/dist/bin/main.js +51 -46
- package/dist/bin/main.js.map +1 -1
- package/dist/host/AGENTS.md +23 -21
- package/dist/host/agents/orchestration.md +85 -54
- package/dist/host/agents/platforms/windows.md +8 -3
- package/dist/host/agents/skills/orkestrel-align/SKILL.md +10 -13
- package/dist/host/agents/skills/orkestrel-align/references/fleet.md +4 -10
- package/dist/host/agents/skills/orkestrel-align/references/integration.md +1 -1
- package/dist/host/agents/skills/orkestrel-build/SKILL.md +16 -48
- package/dist/host/agents/skills/orkestrel-build/agents/openai.yaml +1 -1
- package/dist/host/agents/skills/orkestrel-debrief/SKILL.md +19 -16
- package/dist/host/agents/skills/orkestrel-debrief/agents/openai.yaml +1 -1
- package/dist/host/agents/skills/orkestrel-debrief/references/field-testing.md +15 -28
- package/dist/host/agents/skills/orkestrel-debrief/references/instruction-audit.md +5 -6
- package/dist/host/agents/skills/orkestrel-debrief/references/retention.md +4 -6
- package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +36 -25
- package/dist/host/agents/skills/orkestrel-dispatch/references/launch.md +4 -5
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/bench.ts +366 -75
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/brief.ts +126 -16
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/chain.ts +323 -0
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/cite.ts +220 -31
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/launch.ts +176 -33
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/login.ts +294 -59
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/patch.ts +401 -0
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/result.ts +199 -34
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/sweep.ts +330 -69
- package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +14 -12
- package/dist/host/agents/skills/orkestrel-falsify/references/brief.md +2 -5
- package/dist/host/agents/skills/orkestrel-falsify/references/reconcile.md +2 -1
- package/dist/host/agents/skills/orkestrel-falsify/scripts/mutate.ts +701 -0
- package/dist/host/agents/skills/orkestrel-harden/SKILL.md +31 -24
- package/dist/host/agents/skills/orkestrel-harden/references/bindings.md +23 -81
- package/dist/host/agents/skills/orkestrel-harden/references/centralization.md +4 -5
- package/dist/host/agents/skills/orkestrel-harden/references/contract.md +2 -0
- package/dist/host/agents/skills/orkestrel-harden/references/document.md +33 -0
- package/dist/host/agents/skills/orkestrel-harden/references/equivalence.md +6 -3
- package/dist/host/agents/skills/orkestrel-harden/references/hardening.md +34 -18
- package/dist/host/agents/skills/orkestrel-harden/references/research.md +2 -0
- package/dist/host/agents/skills/orkestrel-harden/scripts/discovery.ts +1272 -279
- package/dist/host/agents/skills/orkestrel-harden/scripts/measure.ts +425 -0
- package/dist/host/agents/skills/orkestrel-harden/scripts/titles.ts +603 -98
- package/dist/host/agents/skills/orkestrel-journey/SKILL.md +79 -98
- package/dist/host/agents/skills/orkestrel-journey/references/captures.md +54 -17
- package/dist/host/agents/skills/orkestrel-journey/references/decide.md +1 -20
- package/dist/host/agents/skills/orkestrel-journey/references/layer.md +21 -31
- package/dist/host/agents/skills/orkestrel-journey/references/styles.md +1 -1
- package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +33 -29
- package/dist/host/agents/skills/orkestrel-parallel/references/claude.md +15 -13
- package/dist/host/agents/skills/orkestrel-parallel/references/cloud.md +28 -0
- package/dist/host/agents/skills/orkestrel-parallel/references/codex.md +1 -0
- package/dist/host/agents/skills/orkestrel-parallel/references/cursor.md +13 -13
- package/dist/host/agents/skills/orkestrel-parallel/references/t3.md +13 -13
- package/dist/host/agents/skills/orkestrel-parallel/scripts/cases.ts +389 -0
- package/dist/host/agents/skills/orkestrel-polish/SKILL.md +16 -20
- package/dist/host/agents/skills/orkestrel-polish/references/capture-harness.md +16 -26
- package/dist/host/agents/skills/orkestrel-publish/SKILL.md +12 -26
- package/dist/host/agents/skills/orkestrel-publish/agents/openai.yaml +2 -2
- package/dist/host/agents/skills/orkestrel-publish/references/adopt.md +23 -0
- package/dist/host/agents/skills/orkestrel-publish/references/release.md +4 -4
- package/dist/host/agents/skills/orkestrel-publish/references/wave.md +13 -10
- package/dist/host/agents/skills/orkestrel-publish/references/window.md +21 -26
- package/dist/host/agents/skills/orkestrel-publish/scripts/compare.ts +348 -59
- package/dist/host/agents/skills/orkestrel-publish/scripts/pins.ts +202 -22
- package/dist/host/agents/skills/orkestrel-publish/scripts/swap.ts +1061 -191
- package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +812 -140
- package/dist/host/agents/skills/orkestrel-publish/scripts/window.ts +280 -38
- package/dist/host/agents/skills/orkestrel-scout/SKILL.md +3 -3
- package/dist/host/agents/skills/orkestrel-scout/scripts/map.ts +428 -70
- package/dist/host/agents/templates/brief.md +6 -2
- package/dist/host/agents/transports/claude-cli.md +3 -3
- package/dist/host/agents/transports/codex.md +3 -8
- package/dist/host/agents/transports/cursor.md +2 -3
- package/dist/host/claude/AGENTS.md +2 -3
- package/dist/host/claude/agents/analyst.md +3 -3
- package/dist/host/claude/agents/astra.md +4 -4
- package/dist/host/claude/agents/builder.md +4 -3
- package/dist/host/claude/agents/checker.md +1 -1
- package/dist/host/claude/agents/distiller.md +1 -1
- package/dist/host/claude/agents/grok.md +1 -1
- package/dist/host/claude/agents/opus.md +3 -3
- package/dist/host/claude/agents/orkestrel.md +57 -90
- package/dist/host/claude/agents/researcher.md +1 -1
- package/dist/host/claude/agents/reviewer.md +6 -2
- package/dist/host/claude/agents/scout.md +1 -1
- package/dist/host/claude/agents/verifier.md +2 -2
- package/dist/host/claude/rules/application.md +14 -21
- package/dist/host/claude/rules/architecture.md +34 -44
- package/dist/host/claude/rules/browser.md +3 -4
- package/dist/host/claude/rules/campaign.md +3 -2
- package/dist/host/claude/rules/documentation.md +25 -12
- package/dist/host/claude/rules/names.md +9 -4
- package/dist/host/claude/rules/patterns.md +6 -7
- package/dist/host/claude/rules/portability.md +1 -1
- package/dist/host/claude/rules/quality.md +7 -6
- package/dist/host/claude/rules/styles.md +2 -2
- package/dist/host/claude/rules/tests.md +68 -115
- package/dist/host/claude/rules/typescript.md +7 -9
- package/dist/host/claude/rules/workspace.md +27 -26
- package/dist/host/claude/rules/writing.md +2 -5
- package/dist/host/claude/skills/orkestrel-dispatch/SKILL.md +1 -1
- package/dist/host/claude/skills/orkestrel-harden/SKILL.md +1 -1
- package/dist/host/claude/skills/orkestrel-publish/SKILL.md +1 -1
- package/dist/host/claude/skills/orkestrel-scout/SKILL.md +1 -1
- package/dist/host/codex/agents/analyst.toml +9 -3
- package/dist/host/codex/agents/astra.toml +10 -7
- package/dist/host/codex/agents/builder.toml +4 -4
- package/dist/host/codex/agents/opus.toml +6 -6
- package/dist/host/codex/agents/orkestrel.toml +1 -1
- package/dist/host/codex/agents/researcher.toml +2 -2
- package/dist/host/codex/agents/reviewer.toml +2 -2
- package/dist/host/codex/agents/verifier.toml +4 -4
- package/dist/host/codex/config.toml +1 -1
- package/dist/host/configs/helpers.ts +21 -1
- package/dist/host/configs/policy.ts +299 -15
- package/dist/host/cursor/rules/orchestration.mdc +1 -1
- package/dist/host/dotfiles/oxlintrc.json +137 -3
- package/dist/host/guides/agent.md +111 -134
- package/dist/host/guides/capture.md +801 -0
- package/dist/host/guides/probe.md +27 -8
- package/dist/host/guides/scaffold.md +97 -19
- package/dist/host/guides/study.md +534 -440
- package/dist/host/guides/test.md +111 -44
- package/dist/host/manifest.json +170 -244
- package/dist/host/tests/config.test.ts +977 -187
- package/dist/host/tests/policy.test.ts +165 -1
- package/dist/host/tests/setupPolicy.ts +1246 -33
- package/dist/src/core/index.cjs +222 -90
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.d.cts +126 -40
- package/dist/src/core/index.d.ts +126 -40
- package/dist/src/core/index.js +217 -89
- package/dist/src/core/index.js.map +1 -1
- package/dist/src/server/index.cjs +20 -27
- package/dist/src/server/index.cjs.map +1 -1
- package/dist/src/server/index.js +21 -28
- package/dist/src/server/index.js.map +1 -1
- package/package.json +11 -11
- package/dist/agents/skills/orkestrel-dispatch/scripts/helpers.js +0 -283
- package/dist/host/agents/skills/orkestrel-dispatch/references/bench.md +0 -25
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/helpers.ts +0 -333
- package/dist/host/guides/supervisor.md +0 -4890
|
@@ -27,7 +27,7 @@ UNKNOWN and how the unit reports it.
|
|
|
27
27
|
## Scope
|
|
28
28
|
|
|
29
29
|
- **Owned.** FILES, including the tests that pin the behavior, the fixtures derived from a constant, and the materialized copy of a template.
|
|
30
|
-
- **Shared (report-only).** FILES; return an exact patch.
|
|
30
|
+
- **Shared (report-only).** FILES; return an exact patch as an edit file: one `### <path>` block per edit, each with a `reason:` line and fenced `old:` and `new:` texts, that `.agents/skills/orkestrel-dispatch/scripts/patch.ts` applies.
|
|
31
31
|
- **Off-limits.** FILES. Never list `tmp/probes/` here.
|
|
32
32
|
- **Made false by this change.** FILES, derived by running the suite or by a named search bound.
|
|
33
33
|
- **Tools and limits.** ALLOWED_TOOLS; scoped validation only; no tree-wide source-mutating command. For a verifier, declare each permitted output path per `.agents/orchestration.md` § Permission floor.
|
|
@@ -42,7 +42,7 @@ RETURN_SHAPE through OUTPUT_MECHANISM. No process diary.
|
|
|
42
42
|
|
|
43
43
|
## Deviation contract
|
|
44
44
|
|
|
45
|
-
Stop and report (expected, found, evidence, done or not done, one hypothesis) on OBJECTIVE_CONFLICT. Settle ANCILLARY_CHOICES yourself and record them.
|
|
45
|
+
Stop and report (expected, found, evidence, done or not done, one hypothesis) on OBJECTIVE_CONFLICT. Settle ANCILLARY_CHOICES yourself and record them. Enumerate the failure classes the unit may meet with the action each takes; anything else stops and reports.
|
|
46
46
|
|
|
47
47
|
## Acceptance criteria
|
|
48
48
|
|
|
@@ -52,8 +52,12 @@ Stop and report (expected, found, evidence, done or not done, one hypothesis) on
|
|
|
52
52
|
|
|
53
53
|
**Observations, not criteria.** TIMING_SENSITIVE_OR_TREE_WIDE_GATES the unit reports and the Orchestrator re-runs.
|
|
54
54
|
|
|
55
|
+
**Estimate and stop.** ESTIMATED_COST of the unit and STOP_COST, the cost at which it stops and reports; the unit's report records the observed cost beside that estimate.
|
|
56
|
+
|
|
55
57
|
**Measurement.** FIXTURE_KINDS: the realistic heavy loads a cost claim is read under, named by kind; the unit sizes and reads them per `.claude/rules/quality.md` § Performance.
|
|
56
58
|
|
|
57
59
|
## Review evidence
|
|
58
60
|
|
|
59
61
|
The actual diff and `git status --porcelain` for a code change; the capture portfolio for a rendered surface; the proposal, the canon it must satisfy, and its motivation for a process proposal.
|
|
62
|
+
|
|
63
|
+
**Release bar.** RELEASE_BAR_OR_NONE: for a review brief, the observable consequences that make a finding outside the claims enter the terminal line; `none` puts every substantiated outside finding there.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Claude transport contract
|
|
2
2
|
|
|
3
|
-
For harnesses that route work to the Claude Opus 5.5 bench, follow this file. Routes: `planner`, `reviewer`, `opus`. Read `.agents/orchestration.md` first; its Codex mapping uses native roles without this transport or a Claude probe.
|
|
3
|
+
For harnesses that route work to the Claude Opus 5.5 bench, follow this file. Routes: `planner`, `reviewer`, `opus`. Read `.agents/orchestration.md` first; its Codex mapping uses native roles without this transport or a Claude probe. `.agents/skills/orkestrel-dispatch/SKILL.md` § Launch owns the driver and launch contract.
|
|
4
4
|
|
|
5
5
|
## Command
|
|
6
6
|
|
|
@@ -9,9 +9,9 @@ node .agents/skills/orkestrel-dispatch/scripts/launch.ts --journal tmp/claude/<u
|
|
|
9
9
|
```
|
|
10
10
|
|
|
11
11
|
- Pass the permission mode the route pins and `--model opus` for every route. Never substitute another alias, `fable`, or a fixed Claude model id.
|
|
12
|
-
- Write the brief to `tmp/claude/<unit>-brief.md` with `scripts/brief.ts --lane claude`; the prompt is a pointer to it.
|
|
12
|
+
- Write the brief to `tmp/claude/<unit>-brief.md` with `scripts/brief.ts --lane claude`; the prompt is a pointer to it.
|
|
13
13
|
- Read the answer and the session id with `node .agents/skills/orkestrel-dispatch/scripts/result.ts --claude tmp/claude/<unit>.jsonl`. A unit with no journal ran on its driver's engine, however normal its answer reads.
|
|
14
|
-
- A driver pinned `workspace-write` writes the brief itself.
|
|
14
|
+
- A driver pinned `workspace-write` writes the brief itself.
|
|
15
15
|
- A driver never launches long work, recommends a cap, detaches, polls, restarts, or kills a run.
|
|
16
16
|
|
|
17
17
|
## Availability
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# Codex transport contract
|
|
2
2
|
|
|
3
|
-
Every driver that carries a brief to the Codex GPT-6 Astra bench follows this file. Routes: `analyst` (audit, objective design argument) and `astra` (implementation). For native roles, use the canonical Codex mapping in `.agents/orchestration.md` without a bench launch or probe.
|
|
3
|
+
Every driver that carries a brief to the Codex GPT-6 Astra bench follows this file. Routes: `analyst` (audit, objective design argument) and `astra` (implementation). For native roles, use the canonical Codex mapping in `.agents/orchestration.md` without a bench launch or probe. `.agents/skills/orkestrel-dispatch/SKILL.md` § Launch owns the driver and launch contract.
|
|
4
4
|
|
|
5
5
|
## Models and effort
|
|
6
6
|
|
|
7
7
|
```text
|
|
8
8
|
CODEX_ASTRA_MODEL=gpt-6-astra effort high; xhigh only for a stated hard-reasoning need
|
|
9
|
-
CODEX_MECHANICAL_MODEL=gpt-6.1-sol fully specified
|
|
9
|
+
CODEX_MECHANICAL_MODEL=gpt-6.1-sol a fully specified unit with a closed shape
|
|
10
10
|
CODEX_READING_MODEL=gpt-6-luna absorption and research when the Cursor bench is dark; record the substitution
|
|
11
11
|
```
|
|
12
12
|
|
|
@@ -34,7 +34,6 @@ node .agents/skills/orkestrel-dispatch/scripts/launch.ts --journal tmp/codex/<un
|
|
|
34
34
|
- On the measured Windows host `read-only` and `workspace-write` reject every shell command with `blocked by policy`. Recheck when the host or the Codex version changes. Under `danger-full-access` the brief states read-only where the route is read-only, and the launch script records `git status --porcelain` before and after; any difference is a deviation. This mode detects tracked changes only; it does not enforce read-only access.
|
|
35
35
|
- Recorded POSIX sandbox behavior, to recheck when conditions change: network denied, `.git` mounted read-only, loopback bind fails `EPERM`, a grandchild process is denied. Route installs, live fetches, servers, process-tree proofs, and lockfile generation to the Orchestrator or a native writer.
|
|
36
36
|
- A nested `git` inside the sandbox has reported `not a git repository` while the unit's own `git status` worked; name this in the brief so the unit does not diagnose the checkout.
|
|
37
|
-
- When a sandbox rejects a write, the unit stops and reports it. It never tries another write mechanism.
|
|
38
37
|
- A Windows shell write can re-encode text. Edit a line carrying a code point above `0x7F` with the exec's patch tool, never with `Set-Content`, `Out-File`, or `>`.
|
|
39
38
|
|
|
40
39
|
## Availability
|
|
@@ -42,13 +41,9 @@ node .agents/skills/orkestrel-dispatch/scripts/launch.ts --journal tmp/codex/<un
|
|
|
42
41
|
- Probe with `node .agents/skills/orkestrel-dispatch/scripts/bench.ts --codex` before the first use in a session: it reads `codex --version` and `codex login status`, then runs one bounded exec and reports `live`. Neither the version nor the login status alone is liveness.
|
|
43
42
|
- Binary absent: report it; the Orchestrator names `npm install -g @openai/codex` to the user and re-probes when the user answers.
|
|
44
43
|
- Not logged in: the Orchestrator runs `node .agents/skills/orkestrel-dispatch/scripts/login.ts --codex` in the background, which journals `codex login --device-auth` to `tmp/codex/login.log`, prints the URL and the one-time code for the user, and polls the status until it answers; then it re-probes with `bench.ts --codex`.
|
|
45
|
-
- Recovery impossible: record the bench dark.
|
|
44
|
+
- Recovery impossible: record the bench dark; `.agents/orchestration.md` § Benches owns the substitution.
|
|
46
45
|
- Never authenticate on the user's behalf, read an auth file, or substitute a key or token.
|
|
47
46
|
|
|
48
|
-
## Routing exclusion
|
|
49
|
-
|
|
50
|
-
For harnesses that route `opus` to Claude, route a unit that authors path-containment, import-resolution-boundary, unescaped-input, or credential-exposure proofs to `opus` from the start and record the Codex bench dark for that unit only. For native Codex roles, report a harness refusal through the deviation protocol; the `opus` role uses the same harness.
|
|
51
|
-
|
|
52
47
|
## Journals
|
|
53
48
|
|
|
54
49
|
Journals live under `tmp/codex/` and are never committed. `.agents/orchestration.md` § Cleanup owns their deletion.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Cursor transport contract
|
|
2
2
|
|
|
3
|
-
Every driver that carries a brief to the Cursor Grok 4.7 Extra High bench follows this file. Route: `grok`.
|
|
3
|
+
Every driver that carries a brief to the Cursor Grok 4.7 Extra High bench follows this file. Route: `grok`. Read `.agents/orchestration.md` first; it owns the role set and the routing. `.agents/skills/orkestrel-dispatch/SKILL.md` § Launch owns the driver and launch contract.
|
|
4
4
|
|
|
5
5
|
## Model
|
|
6
6
|
|
|
@@ -21,8 +21,7 @@ node .agents/skills/orkestrel-dispatch/scripts/launch.ts --journal tmp/cursor/<u
|
|
|
21
21
|
|
|
22
22
|
- Write the brief to `tmp/cursor/<unit>-brief.md` with `scripts/brief.ts --lane cursor`; the prompt is a pointer to it.
|
|
23
23
|
- Read the answer and the session id with `node .agents/skills/orkestrel-dispatch/scripts/result.ts --cursor tmp/cursor/<unit>.jsonl`. The `init` event carries the session id; resume through the CLI's `--resume` option, probed before its first use.
|
|
24
|
-
- A driver runs a lane itself when the lane finishes
|
|
25
|
-
- A driver pinned read-only writes nothing: it returns the brief text, its intended path, the resolved command, and the journal paths, and the Orchestrator writes and launches.
|
|
24
|
+
- A driver runs a lane itself when the lane finishes inside the foreground cap the harness page's Background row states (`.agents/skills/orkestrel-parallel/references/`), and returns the result. For anything longer its job ends at drafting: return the brief path, the resolved command, and the journal path. A driver never recommends a cap and never detaches a run.
|
|
26
25
|
|
|
27
26
|
## Containment
|
|
28
27
|
|
|
@@ -6,12 +6,11 @@
|
|
|
6
6
|
|
|
7
7
|
- `.agents/skills/orkestrel-parallel/references/claude.md` owns starting, continuing, tracking, and backgrounding lanes in Claude Code, and its quirks. Choose continuation or a fresh context per `.agents/orchestration.md` § Sessions and consultation.
|
|
8
8
|
- Serialize writing Workflow nodes, and give every `agent()` node a model alias from § Models and an effort.
|
|
9
|
-
- Use the built-in `Explore` agent with `model: haiku` for an exact bounded lookup; apply `.agents/orchestration.md` § Routing.
|
|
10
9
|
- Probe a bench with `node .agents/skills/orkestrel-dispatch/scripts/bench.ts`, launch a lane through `scripts/launch.ts`, and read its answer with `scripts/result.ts`, all from the dispatch skill. `.agents/platforms/<platform>.md` owns the host shell's quirks.
|
|
11
10
|
|
|
12
11
|
## Models
|
|
13
12
|
|
|
14
|
-
- Use the aliases `haiku`, `sonnet`, and `opus` in role frontmatter, a Workflow node, and a per-invocation `model`. Never `fable`, never `inherit`, never a fixed model ID, and never a dispatch that takes its model from the session, including an `Explore` call or a Workflow node without `model
|
|
13
|
+
- Use the aliases `haiku`, `sonnet`, and `opus` in role frontmatter, a Workflow node, and a per-invocation `model`. Never `fable`, except the consultant dispatch `.agents/orchestration.md` § Engines admits, which passes `model: fable` per invocation; never `inherit`, never a fixed model ID, and never a dispatch that takes its model from the session, including an `Explore` call or a Workflow node without `model`; `.agents/orchestration.md` § Engines owns where Claude Fable 5.1 may run.
|
|
15
14
|
- Keep `CLAUDE_CODE_SUBAGENT_MODEL` at `sonnet` in the `env` object of `.claude/settings.json`. It serves a subagent that no role frontmatter and no dispatch assigned a model; frontmatter and a per-invocation `model` outrank it (measured 2026-10-08 on Claude Code 2.1.294: `general-purpose` took it, `Plan` did not). Never set `CLAUDE_CODE_SUBAGENT_MODEL_FORCE`; it overrides every role.
|
|
16
15
|
- An alias serves the model the installed Claude Code maps it to. After a model release, measure the mapping with `claude -p "Reply with the single word OK." --model <alias> --output-format json --max-turns 1` and read `modelUsage`; when a newer model answers by id and the alias lags, update Claude Code through the host's package manager and measure again. Claude Code 2.1.294 serves Haiku 5.5 as `haiku`, Sonnet 5.5 as `sonnet`, and Opus 5.5 as `opus` (measured 2026-10-08). When a measurement moves an alias, update, in the same change, the version each `.claude/agents/` charter names in its description and opening line and the rows of `.agents/orchestration.md` § Engines.
|
|
17
16
|
- Run the main session on `fable` or `opus` at high effort. Apply `.agents/orchestration.md` § Cache; check Claude Code's documented behavior for the installed version, model, and provider before changing model options.
|
|
@@ -19,7 +18,7 @@
|
|
|
19
18
|
|
|
20
19
|
## Context and cache
|
|
21
20
|
|
|
22
|
-
-
|
|
21
|
+
- A role that edits source, designs, or rules on conformance or drift loads the contract. A driver, a gate runner, and a bulk or lookup reader set `omitClaudeMd: true`, and their charters carry the permission floor they need.
|
|
23
22
|
- Check whether MCP definitions load into the prefix or through deferred tool search before attributing a cache change to a server change.
|
|
24
23
|
- Reload loaded project instructions through `/clear`, `/compact`, or a restart when required by the installed version. Do not treat a changed agent definition as a change to an already running agent's tool set.
|
|
25
24
|
- Route supporting reads per `.agents/orchestration.md` § Routing. The main context holds decisions.
|
|
@@ -3,21 +3,21 @@ name: analyst
|
|
|
3
3
|
description: 'Haiku 5.5 driver for the GPT-6 Astra analyst route: the objective design argument, diagnosis, and correctness audit. Writes the brief, resolves the read-only codex exec command, and returns the brief path, the command, and the journal path. Analyzes nothing itself and endorses nothing.'
|
|
4
4
|
tools: Bash, Read, Grep, Glob
|
|
5
5
|
model: haiku
|
|
6
|
-
effort:
|
|
6
|
+
effort: low
|
|
7
7
|
permissionMode: default
|
|
8
8
|
omitClaudeMd: true
|
|
9
9
|
---
|
|
10
10
|
|
|
11
11
|
On Claude Haiku 5.5, you drive the Astra `analyst` route. Do not analyze, judge, implement, or endorse the result yourself.
|
|
12
12
|
|
|
13
|
-
Read `.agents/transports/codex.md` and follow it exactly. It owns the command, the sandbox
|
|
13
|
+
Read `.agents/transports/codex.md` and follow it exactly. It owns the command, the sandbox, the journal, and the recovery ladder. The route writes nothing.
|
|
14
14
|
|
|
15
15
|
## Do
|
|
16
16
|
|
|
17
17
|
1. Take the dispatch's brief, or write one to `tmp/codex/<unit>-brief.md` from the dispatch's objective, evidence slice, claims, scope, and return shape. For an audit, the brief names `tmp/units/<unit>-claims.md` and the `orkestrel-falsify` verdict shape.
|
|
18
18
|
2. Run `node .agents/skills/orkestrel-dispatch/scripts/brief.ts --check <brief>` and fix every missing path.
|
|
19
19
|
3. Resolve the `codex exec` command per the transport, as the `launch.ts` line it shows.
|
|
20
|
-
4.
|
|
20
|
+
4. Run the command yourself only when the lane finishes inside the foreground cap the harness page's Background row states (`.agents/skills/orkestrel-parallel/references/`), and return the answer read with `node .agents/skills/orkestrel-dispatch/scripts/result.ts --codex`, with the journal path and session id. Otherwise return the brief path, the resolved command, and the journal path; the Orchestrator launches it under a cap per `.agents/skills/orkestrel-dispatch/SKILL.md` § Launch.
|
|
21
21
|
|
|
22
22
|
## Refuse
|
|
23
23
|
|
|
@@ -3,18 +3,18 @@ name: astra
|
|
|
3
3
|
description: 'Haiku 5.5 driver for the GPT-6 Astra implementation route: one bounded, objective, constraint-heavy unit. Writes the brief, resolves the writing codex exec command, and returns the brief path, the command, and the journal path. Implements nothing itself and endorses nothing.'
|
|
4
4
|
tools: Bash, Read, Grep, Glob
|
|
5
5
|
model: haiku
|
|
6
|
-
effort:
|
|
6
|
+
effort: low
|
|
7
7
|
permissionMode: default
|
|
8
8
|
omitClaudeMd: true
|
|
9
9
|
---
|
|
10
10
|
|
|
11
11
|
On Claude Haiku 5.5, you drive the Astra implementation route. Do not implement, judge, or endorse the result yourself.
|
|
12
12
|
|
|
13
|
-
Read `.agents/transports/codex.md` and follow it exactly. It owns the command, the sandbox
|
|
13
|
+
Read `.agents/transports/codex.md` and follow it exactly. It owns the command, the sandbox, the journal, and the recovery ladder. The route writes.
|
|
14
14
|
|
|
15
15
|
## Do
|
|
16
16
|
|
|
17
|
-
1. Take the dispatch's brief, or write one to `tmp/codex/<unit>-brief.md` from the dispatch: objective, owned and off-limits files, acceptance criteria cheap-first, the `AGENTS.md` non-negotiables and the rules scoped to the owned paths, the guide, the return shape, and the deviation contract. The brief forbids installs, commits, pushes, credentials, destructive commands, shared-file edits, and tree-wide mutating gates, and tells the unit it is the sole writer in its checkout.
|
|
17
|
+
1. Take the dispatch's brief, or write one to `tmp/codex/<unit>-brief.md` from the dispatch: objective, owned and off-limits files, acceptance criteria cheap-first, the `AGENTS.md` non-negotiables and the rules scoped to the owned paths, the guide, the return shape, and the deviation contract. The brief has the unit select the instrument per `AGENTS.md` § Work loop and `.claude/rules/quality.md` § Instruments and return the evidence that instrument produced. The brief forbids installs, commits, pushes, credentials, destructive commands, shared-file edits, and tree-wide mutating gates, and tells the unit it is the sole writer in its checkout.
|
|
18
18
|
2. Run `node .agents/skills/orkestrel-dispatch/scripts/brief.ts --check <brief>` and fix every missing path.
|
|
19
19
|
3. Resolve the `codex exec` command per the transport, as the `launch.ts` line it shows.
|
|
20
20
|
4. Return the brief path, the resolved command, and the journal path. Do not launch; the Orchestrator launches under a cap and verifies with `git status --porcelain`, the diff, and scoped validation.
|
|
@@ -22,5 +22,5 @@ Read `.agents/transports/codex.md` and follow it exactly. It owns the command, t
|
|
|
22
22
|
## Refuse
|
|
23
23
|
|
|
24
24
|
- A unit that needs no write: report it as misrouted to `analyst`.
|
|
25
|
-
- A unit
|
|
25
|
+
- A unit that authors a proof class `.agents/orchestration.md` § Routing sends to `opus`: report it as routed to `opus`.
|
|
26
26
|
- A second writer in the same checkout.
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: builder
|
|
3
|
-
description: 'Sonnet 5.5 implementation of
|
|
3
|
+
description: 'Sonnet 5.5 implementation of a fully specified unit with a closed shape, in src, app, tests, or configs: the brief or the types fix its names, API, and architecture. Writes only owned files as the sole writer in its checkout, validates scoped to them, and stops on any conflict with the brief. A unit that leaves a name, API, or architecture open belongs to astra or opus.'
|
|
4
4
|
tools: Read, Grep, Glob, Edit, Write, Bash
|
|
5
5
|
model: sonnet
|
|
6
6
|
effort: low
|
|
7
7
|
permissionMode: acceptEdits
|
|
8
8
|
---
|
|
9
9
|
|
|
10
|
-
On Claude Sonnet 5.5, you implement
|
|
10
|
+
On Claude Sonnet 5.5, you implement a fully specified unit with a closed shape. The dispatch is the plan; do not re-plan.
|
|
11
11
|
|
|
12
12
|
## Do
|
|
13
13
|
|
|
@@ -15,12 +15,13 @@ On Claude Sonnet 5.5, you implement one bounded unit with a closed shape. The di
|
|
|
15
15
|
2. Write only the owned files. Return an exact patch for a shared file; never edit it.
|
|
16
16
|
3. At the size the brief names, follow `AGENTS.md` § Work loop. Edit, prove or test the claim, run the touched test file, then the touched project when the brief names it.
|
|
17
17
|
4. Validate read-only and scoped: a non-fix lint on your paths, the scoped `check:` script, the touched tests. Never run `format`, lint `--fix`, `build`, or the whole suite.
|
|
18
|
-
5.
|
|
18
|
+
5. Leave no probe behind, per `.claude/rules/tests.md` § Probes.
|
|
19
19
|
6. Stop and report per `.agents/orchestration.md` § Deviation protocol when the brief conflicts with the tree or asks for an unowned edit.
|
|
20
20
|
|
|
21
21
|
## Refuse
|
|
22
22
|
|
|
23
23
|
- A unit that leaves naming, API shape, or architecture open, or that spans packages: report it as belonging to `astra` or `opus`.
|
|
24
|
+
- A unit whose mechanism is open: a protocol, a lock, a retry class, or a termination path; report it as belonging to `astra` or `opus`.
|
|
24
25
|
- Installing, committing, pushing, reading a secret, or a destructive command.
|
|
25
26
|
|
|
26
27
|
## Return
|
|
@@ -3,7 +3,7 @@ name: checker
|
|
|
3
3
|
description: 'Haiku 5.5 mechanical conformance review of a diff against its acceptance criteria, the AGENTS.md letter, the applicable rules, scope honesty, and guide parity. One piece of evidence per item; no judgment calls. Dispatched when criteria are mechanically checkable. Never edits.'
|
|
4
4
|
tools: Read, Grep, Glob
|
|
5
5
|
model: haiku
|
|
6
|
-
effort:
|
|
6
|
+
effort: low
|
|
7
7
|
permissionMode: dontAsk
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -3,7 +3,7 @@ name: distiller
|
|
|
3
3
|
description: 'Haiku 5.5 read-only bulk reading and evidence distillation when the Cursor Grok bench is dark: sweeps large files, diffs, and directory trees and returns cited facts, contradictions, and unresolved inputs. Never designs, implements, reviews, or accepts.'
|
|
4
4
|
tools: Read, Grep, Glob
|
|
5
5
|
model: haiku
|
|
6
|
-
effort:
|
|
6
|
+
effort: low
|
|
7
7
|
permissionMode: dontAsk
|
|
8
8
|
omitClaudeMd: true
|
|
9
9
|
---
|
|
@@ -3,7 +3,7 @@ name: grok
|
|
|
3
3
|
description: 'Haiku 5.5 driver for the Cursor Grok bench: context absorption, distillation, broad mapping, and exploration. Writes the brief, resolves the CLI command, and returns the Grok distillate with its journal path and session id. Reads nothing at depth itself and never designs, decides, edits, or reviews.'
|
|
4
4
|
tools: Bash, Read, Grep, Glob
|
|
5
5
|
model: haiku
|
|
6
|
-
effort:
|
|
6
|
+
effort: low
|
|
7
7
|
permissionMode: default
|
|
8
8
|
omitClaudeMd: true
|
|
9
9
|
---
|
|
@@ -12,10 +12,10 @@ On Claude Opus 5.5, you implement one dispatched unit and spawn nothing.
|
|
|
12
12
|
## Do
|
|
13
13
|
|
|
14
14
|
1. Read the brief, `AGENTS.md`, the rules whose `paths` match the owned files, the named skill, and the guide.
|
|
15
|
-
2. Follow `AGENTS.md` § Work loop: types first, prove the claim
|
|
15
|
+
2. Follow `AGENTS.md` § Work loop: types first, prove the claim, implement, test, consolidate, document. Select the instrument per `AGENTS.md` § Work loop and `.claude/rules/quality.md` § Instruments and return the evidence that instrument produced.
|
|
16
16
|
3. Write only the owned files; return an exact patch for a shared file.
|
|
17
17
|
4. Validate read-only and scoped: the `check:` script of the touched project, the touched test file, then the touched project. Never run `format`, lint `--fix`, `build`, or the whole suite.
|
|
18
|
-
5.
|
|
18
|
+
5. Leave no probe behind, per `.claude/rules/tests.md` § Probes.
|
|
19
19
|
6. Finish the whole unit. Stop only per `.agents/orchestration.md` § Deviation protocol.
|
|
20
20
|
|
|
21
21
|
## Refuse
|
|
@@ -24,4 +24,4 @@ Adding a dependency, suppressing a diagnostic, mocking project-owned behavior, l
|
|
|
24
24
|
|
|
25
25
|
## Return
|
|
26
26
|
|
|
27
|
-
Touched files with one line each, diffstat, scoped validation commands and results, the
|
|
27
|
+
Touched files with one line each, diffstat, scoped validation commands and results, the instrument's closing evidence per claim, failing-first test names, shared-file patches, deviation state. No process diary.
|
|
@@ -43,59 +43,59 @@ so network-controlled descriptions never enter agent instruction context.
|
|
|
43
43
|
|
|
44
44
|
<!-- orkestrel:catalog -->
|
|
45
45
|
|
|
46
|
-
| Package | Version | Layer | Runtime dependencies | Peer dependencies
|
|
47
|
-
| ----------------------- | --------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
48
|
-
| `@orkestrel/abort` | `0.0.13` | L1 | `@orkestrel/contract` `^0.0.19` |
|
|
49
|
-
| `@orkestrel/agent` | `0.0.
|
|
50
|
-
| `@orkestrel/brief` | `0.0.11` | L4 | `@orkestrel/reason` `^0.0.13`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/interpret` `^0.0.16` |
|
|
51
|
-
| `@orkestrel/browser` | `0.0.29` | L5 | `@orkestrel/mcp` `^0.0.39`, `@orkestrel/html` `^0.0.12`, `@orkestrel/pool` `^0.0.17`, `@orkestrel/tool` `^0.0.19`, `@orkestrel/codec` `^0.0.6`, `@orkestrel/router` `^0.0.17`, `@orkestrel/server` `^0.0.23`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/markdown` `^0.0.17`, `@orkestrel/websocket` `^0.0.15` |
|
|
52
|
-
| `@orkestrel/budget` | `0.0.14` | L1 | `@orkestrel/contract` `^0.0.19` |
|
|
53
|
-
| `@orkestrel/
|
|
54
|
-
| `@orkestrel/
|
|
55
|
-
| `@orkestrel/
|
|
56
|
-
| `@orkestrel/
|
|
57
|
-
| `@orkestrel/
|
|
58
|
-
| `@orkestrel/
|
|
59
|
-
| `@orkestrel/
|
|
60
|
-
| `@orkestrel/
|
|
61
|
-
| `@orkestrel/
|
|
62
|
-
| `@orkestrel/
|
|
63
|
-
| `@orkestrel/
|
|
64
|
-
| `@orkestrel/
|
|
65
|
-
| `@orkestrel/
|
|
66
|
-
| `@orkestrel/
|
|
67
|
-
| `@orkestrel/
|
|
68
|
-
| `@orkestrel/
|
|
69
|
-
| `@orkestrel/
|
|
70
|
-
| `@orkestrel/
|
|
71
|
-
| `@orkestrel/
|
|
72
|
-
| `@orkestrel/
|
|
73
|
-
| `@orkestrel/
|
|
74
|
-
| `@orkestrel/
|
|
75
|
-
| `@orkestrel/
|
|
76
|
-
| `@orkestrel/
|
|
77
|
-
| `@orkestrel/
|
|
78
|
-
| `@orkestrel/
|
|
79
|
-
| `@orkestrel/
|
|
80
|
-
| `@orkestrel/
|
|
81
|
-
| `@orkestrel/
|
|
82
|
-
| `@orkestrel/
|
|
83
|
-
| `@orkestrel/
|
|
84
|
-
| `@orkestrel/
|
|
85
|
-
| `@orkestrel/
|
|
86
|
-
| `@orkestrel/
|
|
87
|
-
| `@orkestrel/
|
|
88
|
-
| `@orkestrel/table` | `0.0.12` | L2 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` |
|
|
89
|
-
| `@orkestrel/template` | `0.0.10` | L2 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` |
|
|
90
|
-
| `@orkestrel/terminal` | `0.0.20` | L3 | `@orkestrel/sse` `^0.0.10`, `@orkestrel/form` `^0.0.12`, `@orkestrel/console` `^0.0.16`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/database` `^0.0.18` |
|
|
91
|
-
| `@orkestrel/test` | `0.0.
|
|
92
|
-
| `@orkestrel/timeout` | `0.0.13` | L1 | `@orkestrel/contract` `^0.0.19` |
|
|
93
|
-
| `@orkestrel/tool` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` |
|
|
94
|
-
| `@orkestrel/toolbox` | `0.0.
|
|
95
|
-
| `@orkestrel/websocket` | `0.0.15` | L2 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` |
|
|
96
|
-
| `@orkestrel/worker` | `0.0.17` | L4 | `@orkestrel/pool` `^0.0.17`, `@orkestrel/queue` `^0.0.17`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/database` `^0.0.18` |
|
|
97
|
-
| `@orkestrel/workflow` | `0.0.23` | L4 | `@orkestrel/abort` `^0.0.13`, `@orkestrel/queue` `^0.0.17`, `@orkestrel/budget` `^0.0.14`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/timeout` `^0.0.13`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/database` `^0.0.18` |
|
|
98
|
-
| `@orkestrel/workspace` | `0.0.12` | L3 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/database` `^0.0.18` |
|
|
46
|
+
| Package | Version | Layer | Runtime dependencies | Peer dependencies |
|
|
47
|
+
| ----------------------- | --------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
|
|
48
|
+
| `@orkestrel/abort` | `0.0.13` | L1 | `@orkestrel/contract` `^0.0.19` | |
|
|
49
|
+
| `@orkestrel/agent` | `0.0.32` | L5 | `@orkestrel/tool` `^0.0.19`, `@orkestrel/abort` `^0.0.13`, `@orkestrel/queue` `^0.0.17`, `@orkestrel/budget` `^0.0.14`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/timeout` `^0.0.13`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/database` `^0.0.18`, `@orkestrel/workflow` `^0.0.23`, `@orkestrel/workspace` `^0.0.12` | |
|
|
50
|
+
| `@orkestrel/brief` | `0.0.11` | L4 | `@orkestrel/reason` `^0.0.13`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/interpret` `^0.0.16` | |
|
|
51
|
+
| `@orkestrel/browser` | `0.0.29` | L5 | `@orkestrel/mcp` `^0.0.39`, `@orkestrel/html` `^0.0.12`, `@orkestrel/pool` `^0.0.17`, `@orkestrel/tool` `^0.0.19`, `@orkestrel/codec` `^0.0.6`, `@orkestrel/router` `^0.0.17`, `@orkestrel/server` `^0.0.23`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/markdown` `^0.0.17`, `@orkestrel/websocket` `^0.0.15` | |
|
|
52
|
+
| `@orkestrel/budget` | `0.0.14` | L1 | `@orkestrel/contract` `^0.0.19` | |
|
|
53
|
+
| `@orkestrel/capture` | `0.0.1` | L3 | `@orkestrel/process` `^0.0.15`, `@orkestrel/timeout` `^0.0.13`, `@orkestrel/contract` `^0.0.19` | `vite` `^8.3.5`, `vitest` `^4.1.12 \|\| ^5.0.5`, `playwright` `^1.61.0`, `@vitest/browser-playwright` `^4.1.12 \|\| ^5.0.5` |
|
|
54
|
+
| `@orkestrel/codec` | `0.0.6` | L1 | `@orkestrel/contract` `^0.0.19` | |
|
|
55
|
+
| `@orkestrel/console` | `0.0.16` | L2 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` | |
|
|
56
|
+
| `@orkestrel/contract` | `0.0.19` | L0 | | |
|
|
57
|
+
| `@orkestrel/csv` | `0.0.10` | L1 | `@orkestrel/contract` `^0.0.19` | |
|
|
58
|
+
| `@orkestrel/database` | `0.0.18` | L2 | `@orkestrel/sqlite` `^0.0.14`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/indexeddb` `^0.0.14` | |
|
|
59
|
+
| `@orkestrel/emitter` | `0.0.12` | L1 | `@orkestrel/contract` `^0.0.19` | |
|
|
60
|
+
| `@orkestrel/form` | `0.0.13` | L2 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` | |
|
|
61
|
+
| `@orkestrel/guide` | `0.0.25` | L3 | `@orkestrel/contract` `^0.0.19`, `@orkestrel/markdown` `^0.0.17` | |
|
|
62
|
+
| `@orkestrel/html` | `0.0.12` | L1 | `@orkestrel/contract` `^0.0.19` | |
|
|
63
|
+
| `@orkestrel/indexeddb` | `0.0.14` | L1 | `@orkestrel/contract` `^0.0.19` | |
|
|
64
|
+
| `@orkestrel/interpret` | `0.0.16` | L3 | `@orkestrel/reason` `^0.0.13`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/template` `^0.0.10` | |
|
|
65
|
+
| `@orkestrel/lsp` | `0.0.11` | L3 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/process` `^0.0.15`, `@orkestrel/contract` `^0.0.19` | |
|
|
66
|
+
| `@orkestrel/markdown` | `0.0.17` | L2 | `@orkestrel/html` `^0.0.12`, `@orkestrel/contract` `^0.0.19` | |
|
|
67
|
+
| `@orkestrel/mcp` | `0.0.39` | L4 | `@orkestrel/sse` `^0.0.10`, `@orkestrel/tool` `^0.0.19`, `@orkestrel/codec` `^0.0.6`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/process` `^0.0.15`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/websocket` `^0.0.15` | `@orkestrel/router` `^0.0.17`, `@orkestrel/server` `^0.0.23` |
|
|
68
|
+
| `@orkestrel/middleware` | `0.0.25` | L4 | `@orkestrel/abort` `^0.0.13`, `@orkestrel/budget` `^0.0.14`, `@orkestrel/timeout` `^0.0.13`, `@orkestrel/contract` `^0.0.19` | `@orkestrel/server` `^0.0.23`, `@orkestrel/database` `^0.0.18` |
|
|
69
|
+
| `@orkestrel/msg` | `0.0.13` | L1 | `@orkestrel/contract` `^0.0.19` | |
|
|
70
|
+
| `@orkestrel/ndjson` | `0.0.12` | L1 | `@orkestrel/contract` `^0.0.19` | |
|
|
71
|
+
| `@orkestrel/ollama` | `0.0.26` | L6 | `@orkestrel/tool` `^0.0.19`, `@orkestrel/agent` `^0.0.32`, `@orkestrel/budget` `^0.0.14`, `@orkestrel/ndjson` `^0.0.12`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/process` `^0.0.15`, `@orkestrel/contract` `^0.0.19` | |
|
|
72
|
+
| `@orkestrel/pool` | `0.0.17` | L2 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` | |
|
|
73
|
+
| `@orkestrel/probe` | `0.0.25` | L5 | `@orkestrel/lsp` `^0.0.11`, `@orkestrel/mcp` `^0.0.39`, `@orkestrel/pool` `^0.0.17`, `@orkestrel/tool` `^0.0.19`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/timeout` `^0.0.13`, `@orkestrel/contract` `^0.0.19` | `vitest` `^4.1.12 \|\| ^5.0.5`, `typescript` `^6.0.3 \|\| ^7.0.2` |
|
|
74
|
+
| `@orkestrel/process` | `0.0.15` | L2 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` | |
|
|
75
|
+
| `@orkestrel/program` | `0.0.16` | L4 | `@orkestrel/rater` `^0.0.17`, `@orkestrel/reason` `^0.0.13`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/qualifier` `^0.0.17` | |
|
|
76
|
+
| `@orkestrel/qualifier` | `0.0.17` | L3 | `@orkestrel/reason` `^0.0.13`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` | |
|
|
77
|
+
| `@orkestrel/queue` | `0.0.17` | L3 | `@orkestrel/abort` `^0.0.13`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/timeout` `^0.0.13`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/database` `^0.0.18` | |
|
|
78
|
+
| `@orkestrel/rater` | `0.0.17` | L3 | `@orkestrel/reason` `^0.0.13`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` | |
|
|
79
|
+
| `@orkestrel/reason` | `0.0.13` | L2 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` | |
|
|
80
|
+
| `@orkestrel/relation` | `0.0.16` | L3 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/database` `^0.0.18` | |
|
|
81
|
+
| `@orkestrel/router` | `0.0.17` | L2 | `@orkestrel/abort` `^0.0.13`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` | |
|
|
82
|
+
| `@orkestrel/scaffold` | `0.0.108` | L3 | `@orkestrel/console` `^0.0.16`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/process` `^0.0.15`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/markdown` `^0.0.17`, `@orkestrel/template` `^0.0.10` | |
|
|
83
|
+
| `@orkestrel/sea` | `0.0.19` | L3 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/process` `^0.0.15`, `@orkestrel/contract` `^0.0.19` | |
|
|
84
|
+
| `@orkestrel/server` | `0.0.23` | L3 | `@orkestrel/abort` `^0.0.13`, `@orkestrel/codec` `^0.0.6`, `@orkestrel/router` `^0.0.17`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/timeout` `^0.0.13`, `@orkestrel/contract` `^0.0.19` | |
|
|
85
|
+
| `@orkestrel/sqlite` | `0.0.14` | L1 | `@orkestrel/contract` `^0.0.19` | |
|
|
86
|
+
| `@orkestrel/sse` | `0.0.10` | L1 | `@orkestrel/contract` `^0.0.19` | |
|
|
87
|
+
| `@orkestrel/study` | `0.0.6` | L7 | `@orkestrel/tool` `^0.0.19`, `@orkestrel/abort` `^0.0.13`, `@orkestrel/agent` `^0.0.32`, `@orkestrel/budget` `^0.0.14`, `@orkestrel/ollama` `^0.0.26`, `@orkestrel/timeout` `^0.0.13`, `@orkestrel/contract` `^0.0.19` | |
|
|
88
|
+
| `@orkestrel/table` | `0.0.12` | L2 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` | |
|
|
89
|
+
| `@orkestrel/template` | `0.0.10` | L2 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` | |
|
|
90
|
+
| `@orkestrel/terminal` | `0.0.20` | L3 | `@orkestrel/sse` `^0.0.10`, `@orkestrel/form` `^0.0.12`, `@orkestrel/console` `^0.0.16`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/database` `^0.0.18` | |
|
|
91
|
+
| `@orkestrel/test` | `0.0.30` | L1 | `@orkestrel/contract` `^0.0.19` | `vitest` `^4.1.12 \|\| ^5.0.5`, `playwright` `^1.64.1` |
|
|
92
|
+
| `@orkestrel/timeout` | `0.0.13` | L1 | `@orkestrel/contract` `^0.0.19` | |
|
|
93
|
+
| `@orkestrel/tool` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` | |
|
|
94
|
+
| `@orkestrel/toolbox` | `0.0.21` | L6 | `@orkestrel/form` `^0.0.13`, `@orkestrel/tool` `^0.0.19`, `@orkestrel/agent` `^0.0.32`, `@orkestrel/server` `^0.0.23`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/database` `^0.0.18`, `@orkestrel/relation` `^0.0.16`, `@orkestrel/terminal` `^0.0.20`, `@orkestrel/workflow` `^0.0.23`, `@orkestrel/workspace` `^0.0.12` | |
|
|
95
|
+
| `@orkestrel/websocket` | `0.0.15` | L2 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19` | |
|
|
96
|
+
| `@orkestrel/worker` | `0.0.17` | L4 | `@orkestrel/pool` `^0.0.17`, `@orkestrel/queue` `^0.0.17`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/database` `^0.0.18` | |
|
|
97
|
+
| `@orkestrel/workflow` | `0.0.23` | L4 | `@orkestrel/abort` `^0.0.13`, `@orkestrel/queue` `^0.0.17`, `@orkestrel/budget` `^0.0.14`, `@orkestrel/emitter` `^0.0.12`, `@orkestrel/timeout` `^0.0.13`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/database` `^0.0.18` | |
|
|
98
|
+
| `@orkestrel/workspace` | `0.0.12` | L3 | `@orkestrel/emitter` `^0.0.12`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/database` `^0.0.18` | |
|
|
99
99
|
|
|
100
100
|
<!-- /orkestrel:catalog -->
|
|
101
101
|
|
|
@@ -103,35 +103,9 @@ Repositories map as `github: orkestrel/<name>` to `npm: @orkestrel/<name>`.
|
|
|
103
103
|
|
|
104
104
|
## Versions
|
|
105
105
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
new version reaches no consumer on its own.
|
|
110
|
-
|
|
111
|
-
A **runtime** bump therefore obliges a re-publish of every package downstream of it, in
|
|
112
|
-
layer order. Report that cascade whenever you sequence cross-package work or state blast
|
|
113
|
-
radius: name each downstream package, its declared range, and its layer. A package whose
|
|
114
|
-
pin names an older version runs that older version, whatever the registry holds.
|
|
115
|
-
|
|
116
|
-
A **development** bump obliges nothing. A `devDependencies` range reaches no consumer of
|
|
117
|
-
the published package, so re-pin it, prove the gates still green, and stop. Never report a
|
|
118
|
-
development bump as a cascade. It becomes one only when the rebuilt `dist/` differs
|
|
119
|
-
materially from the published artifact after the re-pin — sourcemaps excluded,
|
|
120
|
-
whitespace-only differences ignored — meaning the published surface moved, through a
|
|
121
|
-
forced `src`/`app` edit or a changed toolchain emit, and the package then bumps on that
|
|
122
|
-
account rather than on the dependency's. A superfluous diff obliges nothing.
|
|
123
|
-
|
|
124
|
-
The `Layer` column in the catalog table is the publish round, derived from the runtime
|
|
125
|
-
and peer edges in the same row. `L0` depends on nothing else in the fleet and publishes
|
|
126
|
-
first; each later layer publishes only after every layer before it is on the registry. A
|
|
127
|
-
row with no layer sits in a cycle and cannot be placed in a round at all. Packages in
|
|
128
|
-
one layer are independent of each other and may publish in any order within it.
|
|
129
|
-
|
|
130
|
-
Report a disagreeing pin as a defect, never as drift to tidy later. When packages in
|
|
131
|
-
one install graph pin different versions of a dependency, npm installs both copies, and the
|
|
132
|
-
compiler reads those copies as distinct types. The symptom is a type error naming
|
|
133
|
-
one type as not assignable to itself. `npm ls @orkestrel/<name>` is the evidence: one line
|
|
134
|
-
is sound, and nesting is the finding.
|
|
106
|
+
Report the cascade a bump obliges per `.agents/skills/orkestrel-publish/references/release.md` § What a bump obliges: name each downstream package, its declared range, and its layer. The `Layer` column of the catalog table is the publish round. A package whose pin names an older version runs that older version, whatever the registry holds.
|
|
107
|
+
|
|
108
|
+
Report a disagreeing pin as a defect. `npm ls @orkestrel/<name>` is the evidence: one line is sound, and nesting is the finding.
|
|
135
109
|
|
|
136
110
|
## Evidence workflow
|
|
137
111
|
|
|
@@ -142,14 +116,7 @@ is sound, and nesting is the finding.
|
|
|
142
116
|
4. Sequence cross-package work dependency-first; identify every affected consumer.
|
|
143
117
|
5. Return the smallest evidence set the Orchestrator needs.
|
|
144
118
|
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
- published src environments: `src/core`, `src/browser`, `src/server`;
|
|
148
|
-
- private app environments: `app/core`, `app/browser`, `app/server`;
|
|
149
|
-
- thin target configuration: `configs/src`, `configs/app`;
|
|
150
|
-
- mirrored tests under `tests/src` and `tests/app`;
|
|
151
|
-
- public barrels at each environment's `index.ts`, using only `export *`;
|
|
152
|
-
- package behavior in `guides/<package>.md`.
|
|
119
|
+
Orient by `AGENTS.md` § Project model; package behavior lives in `guides/<package>.md`.
|
|
153
120
|
|
|
154
121
|
## Output
|
|
155
122
|
|
|
@@ -3,7 +3,7 @@ name: researcher
|
|
|
3
3
|
description: 'Haiku 5.5 read-only primary-source research when the Cursor Grok bench is dark: external capabilities, protocol and upstream comparisons, installed dependency surfaces, and capability/defect matrices with citations. Never designs, edits, or decides.'
|
|
4
4
|
tools: Read, Grep, Glob, WebFetch, WebSearch
|
|
5
5
|
model: haiku
|
|
6
|
-
effort:
|
|
6
|
+
effort: low
|
|
7
7
|
permissionMode: dontAsk
|
|
8
8
|
omitClaudeMd: true
|
|
9
9
|
---
|