@azure-id/orc 1.9.1 → 1.9.2

package/templates/skills/orc-fast/SKILL.md

@@ -99,7 +99,7 @@ migration) and write the intent-spec + a minimal checkpoint.
 ## Phase F2 — Slice build + dispatch (ONE executor)
 
 Build one slice for `orc-executor-sonnet-4-6-high` (dispatch BY NAME; model
-pinned in the agent file). **Under `opus5_only` it is `orc-executor-opus-5-low`** — forced, and while that mode is on this lane needs an Opus 5 main session, so the "runs fine at Sonnet medium" premise applies only with it off (`../_shared/opus5-only.md`).
+pinned in the agent file). **Under `opus5_only` it is `orc-executor-opus-5-low`** — forced, and while that mode is on this lane needs an Opus 5.5 main session, so the "runs fine at Sonnet medium" premise applies only with it off (`../_shared/opus5-only.md`).
 
 **Extra (`extra_enabled`, `../_shared/extra-dispatch.md`):** the same slice may run off Claude. **This lane has no score at all, so it holds a POSITION, not a band:** resolve `orc extra resolve --slot fast-executor --json` (set with `orc extra role set fast-executor <profile>/<model>`). No row on that slot = Claude, and that is an answer, not a gap. The `extra:` line joins the F0 preflight (P0, printed whenever the gate is on) and NAMES the agent it displaces — `orc-executor-sonnet-4-6-high`; dispatch through `orc extra dispatch --task <file> --json` with `slot: "fast-executor"` and **no `score`** (both is refused by name); validate with `return-validation.md` **§2b, not §2**; a failure runs `orc extra reconcile <task_id>` FIRST — a worktree that moved is RESUMED, never re-done — then falls back to that same pinned agent BY NAME, announced. Extra is orthogonal to the knowledge gate — a fresh wiki and a cached pattern are still required, and a foreign worker gets the same pointers-not-content slice.
 

package/templates/skills/orc-learn/SKILL.md

@@ -23,7 +23,7 @@ it — the human-onboarding lane. It is NOT the wiki: the wiki grounds the
 
 **Dispatch, don't do.** Whatever model this chat runs on, the skill only picks
 the topic/mode and spawns `orc-learn-writer-opus-5-low` (the pinned
-engine) — the deepening scan + all writes run at Opus 5 low regardless of
+engine) — the deepening scan + all writes run at Opus 5.5 low regardless of
 the caller's tier. The skill's only self-writes are the behavior-trace
 markers around the spawn. Interactivity is DELIBERATELY minimal but non-zero
 (unlike orc-claude): exactly one question per mode — "which feature?" (INIT)
@@ -173,16 +173,16 @@ exit code, and never re-derive a state word — the CLI's state words are the on
 state words, and **an exit code is an ANSWER wherever that contract says so, not
 a failure**. A call the answer does not name is a call this lane does not make.
 Exit ≠ 0 from the catalogue itself → say the CLI is unavailable and name the
-command you are about to run, out loud, before running it.
-
-## Rules — the anti-slop card (`../_shared/phases/rules.md`)
-
-`orc rules slice --lane orc-learn --json` is the ONLY assembler; never build
-the card here. It rides under the house rules and above the task —
-**house rules > your project's rules > ORC's own packs** — and its `line` prints
-VERBATIM at preflight. Returns gain `rules_applied[]`, `rules_conflicts[]` (a gap,
-never a silent choice) and `rules_overridden[]`.
-## Waiting mid-run (`/orc-wait`)
-
-Canonical: `../_shared/wait.md`. **`a lane that waits without a hand-back` has broken this contract.**
-Checkpoint **none** · safe point **single dispatch**. Nothing here to checkpoint, so all three modes behave identically — say so rather than asking. Never begin a wait between a dispatch and its validated return, or before the smoke gate has reported.
+command you are about to run, out loud, before running it.
+
+## Rules — the anti-slop card (`../_shared/phases/rules.md`)
+
+`orc rules slice --lane orc-learn --json` is the ONLY assembler; never build
+the card here. It rides under the house rules and above the task —
+**house rules > your project's rules > ORC's own packs** — and its `line` prints
+VERBATIM at preflight. Returns gain `rules_applied[]`, `rules_conflicts[]` (a gap,
+never a silent choice) and `rules_overridden[]`.
+## Waiting mid-run (`/orc-wait`)
+
+Canonical: `../_shared/wait.md`. **`a lane that waits without a hand-back` has broken this contract.**
+Checkpoint **none** · safe point **single dispatch**. Nothing here to checkpoint, so all three modes behave identically — say so rather than asking. Never begin a wait between a dispatch and its validated return, or before the smoke gate has reported.

package/templates/skills/orc-learn/examples/learn-run-mock.md

@@ -1,61 +1,61 @@
-# Worked example — orc-learn runs (mock; orient only, never execute from this)
-
-## Run 1 — INIT with a fresh wiki
-
-U: /orc-learn
-C: Repo root found. Reads wiki/INDEX.md + the wiki manifest → tier FRESH.
-   Presents the wiki's feature areas; user picks "orders". Slug: `orders`.
-   Spawns orc-learn-writer-opus-5-low with mode=init, covers from the
-   orders doc's globs (the skill never writes the docs itself).
-W: Reads the orders wiki doc for boundary + contracts, re-verifies against
-   code. Deepens: maps 14 functions (file:line), traces one real flow —
-   POST /orders → validate (routes/orders.ts:31) → price (pricing.ts:88) →
-   persist (repo/orders.ts:15) → emit event → 201. Harvests 3 invariants,
-   4 why-this-way findings, 2 couplings.
-W: Writes learning-docs/orders/knowledge.md (fingerprint header:
-   source_commit=HEAD, 9 hashed files; functions & flow; contracts; verify
-   commands from the wiki manifest's `commands`) and learning.md (mental
-   model, walkthrough of the SAME flow, 3 change recipes, gotchas, FAQ ×6).
-   Derives learning-docs/INDEX.md. Returns functions_mapped=14,
-   flow_traced=true, faq_count=6, actual_model=claude-opus-5,
-   actual_effort=low.
-C: Relays the report. `learning-docs/` not in .gitignore → offers the line;
-   user accepts → appended.
-
-## Run 2 — INIT, no wiki
-
-U: /orc-learn focus=src/billing
-C: No wiki/ → tier none (traced all the same). Asks only to confirm the
-   feature ("billing", from the focus pointer). Writer does a TARGETED scan
-   of src/billing/** only — never repo-wide — then deepens and writes the
-   pair as above.
-
-## Run 3 — REFRESH, multi-select
-
-U: /orc-learn refresh
-C: Reads each learning-docs/*/knowledge.md header; computes tiers on read:
-   orders STALE (drift hit pricing.ts), billing FRESH. Shows BOTH with
-   flags; user picks orders only. One writer dispatch regenerates the orders
-   pair (new source_commit, recomputed hashes, changelog line), re-derives
-   INDEX.md. billing: byte-untouched.
-
-## Run 4 — behavior trace (permanent, always on)
-
-The skill writes the run pointer (`run-learn-<slug>-<DDMMYY>-<HHMMSS>.txt` into
-`log_dir`) before the spawn, records these events as they happen, and — as a
-single-dispatch lane — dispatches the trace writer ONCE at run end to append
-them (`SPAWN`/`RETURN` come from the `orc-trace.js` hook as they occur):
-
-```
-[170726 10:02:01.050] writer   WIKI-CONSULT tier=FRESH :: topic-pick
-[170726 10:02:44.310] writer   DISPATCH orc-learn-writer :: init orders expect=opus-5/low
-[170726 10:02:44.420] hook     SPAWN orc-learn-writer-opus-5-low
-[170726 10:06:12.900] hook     RETURN
-[170726 10:06:13.010] writer   VERIFY writer actual=claude-opus-5/low ✅ MATCH
-[170726 10:06:13.120] writer   FINISH :: init orders
-```
-
-Then the writer packet returns and the run pointer is deleted (in that order).
-REFRESH traces one DISPATCH/VERIFY pair per
-selected feature, ending `FINISH :: refresh <n> features`. No phase/score/
-finding/verdict markers — this lane runs none of those phases.
+# Worked example — orc-learn runs (mock; orient only, never execute from this)
+
+## Run 1 — INIT with a fresh wiki
+
+U: /orc-learn
+C: Repo root found. Reads wiki/INDEX.md + the wiki manifest → tier FRESH.
+   Presents the wiki's feature areas; user picks "orders". Slug: `orders`.
+   Spawns orc-learn-writer-opus-5-low with mode=init, covers from the
+   orders doc's globs (the skill never writes the docs itself).
+W: Reads the orders wiki doc for boundary + contracts, re-verifies against
+   code. Deepens: maps 14 functions (file:line), traces one real flow —
+   POST /orders → validate (routes/orders.ts:31) → price (pricing.ts:88) →
+   persist (repo/orders.ts:15) → emit event → 201. Harvests 3 invariants,
+   4 why-this-way findings, 2 couplings.
+W: Writes learning-docs/orders/knowledge.md (fingerprint header:
+   source_commit=HEAD, 9 hashed files; functions & flow; contracts; verify
+   commands from the wiki manifest's `commands`) and learning.md (mental
+   model, walkthrough of the SAME flow, 3 change recipes, gotchas, FAQ ×6).
+   Derives learning-docs/INDEX.md. Returns functions_mapped=14,
+   flow_traced=true, faq_count=6, actual_model=claude-opus-5-5,
+   actual_effort=low.
+C: Relays the report. `learning-docs/` not in .gitignore → offers the line;
+   user accepts → appended.
+
+## Run 2 — INIT, no wiki
+
+U: /orc-learn focus=src/billing
+C: No wiki/ → tier none (traced all the same). Asks only to confirm the
+   feature ("billing", from the focus pointer). Writer does a TARGETED scan
+   of src/billing/** only — never repo-wide — then deepens and writes the
+   pair as above.
+
+## Run 3 — REFRESH, multi-select
+
+U: /orc-learn refresh
+C: Reads each learning-docs/*/knowledge.md header; computes tiers on read:
+   orders STALE (drift hit pricing.ts), billing FRESH. Shows BOTH with
+   flags; user picks orders only. One writer dispatch regenerates the orders
+   pair (new source_commit, recomputed hashes, changelog line), re-derives
+   INDEX.md. billing: byte-untouched.
+
+## Run 4 — behavior trace (permanent, always on)
+
+The skill writes the run pointer (`run-learn-<slug>-<DDMMYY>-<HHMMSS>.txt` into
+`log_dir`) before the spawn, records these events as they happen, and — as a
+single-dispatch lane — dispatches the trace writer ONCE at run end to append
+them (`SPAWN`/`RETURN` come from the `orc-trace.js` hook as they occur):
+
+```
+[170726 10:02:01.050] writer   WIKI-CONSULT tier=FRESH :: topic-pick
+[170726 10:02:44.310] writer   DISPATCH orc-learn-writer :: init orders expect=opus-5/low
+[170726 10:02:44.420] hook     SPAWN orc-learn-writer-opus-5-low
+[170726 10:06:12.900] hook     RETURN
+[170726 10:06:13.010] writer   VERIFY writer actual=claude-opus-5-5/low ✅ MATCH
+[170726 10:06:13.120] writer   FINISH :: init orders
+```
+
+Then the writer packet returns and the run pointer is deleted (in that order).
+REFRESH traces one DISPATCH/VERIFY pair per
+selected feature, ending `FINISH :: refresh <n> features`. No phase/score/
+finding/verdict markers — this lane runs none of those phases.

package/templates/skills/orc-mini/SKILL.md

@@ -16,7 +16,7 @@ below. Load its references and schemas by path — the HOT-PATH essentials
 (dispatch names, return-contract fields, artifact path) are inlined here so
 nothing is reconstructed from "full minus deltas."
 
-Run as **Opus 4.8 high**, or Opus 5 / Fable 5 at medium+ (as full; never downgrade).
+Run as **Opus 4.8 high**, or Opus 5.5 / Fable 5 at medium+ (as full; never downgrade).
 **You never implement — you spawn.** The one exception is the **smoke gate**: a
 read-only build+test run, not implementation — you still never write code.
 **Worked example** (orient only — never execute from it): `examples/mini-run-mock.md`.
@@ -158,7 +158,7 @@ mini skipped. Record the switch in the decision log.
 
 ## Dispatch via named agents (canonical name-map — dispatch BY these names)
 
-Models pinned in `.claude/agents/`; look one up here, never reconstruct a name (agent = skill-name + model-effort suffix). See `.claude/agents/MODEL-MAPPING.md`. `opus5_only: true` FORCES the right column and needs an Opus 5 main session — mini's cheap-lane premise is off while it is on (`../_shared/opus5-only.md`).
+Models pinned in `.claude/agents/`; look one up here, never reconstruct a name (agent = skill-name + model-effort suffix). See `.claude/agents/MODEL-MAPPING.md`. `opus5_only: true` FORCES the right column and needs an Opus 5.5 main session — mini's cheap-lane premise is off while it is on (`../_shared/opus5-only.md`).
 
 **Extra (`extra_enabled`, `../_shared/extra-dispatch.md`):** mini's ONE executor may run off Claude. It has no score, so resolve the pinned executor's **BAND, both edges, and require them to agree** — a partially covering row keeps the run on Claude and the preflight says so. Print the `extra:` line at intake whenever the gate is on (P0: `a lane that sends work off Claude without saying so`); dispatch via `orc extra dispatch --task <file> --json` with the IDENTICAL slice; validate with `return-validation.md` **§2b, not §2** (⛔ SUBSTITUTION replaces the downgrade check); a failure runs `orc extra reconcile <task_id>` FIRST — a worktree that moved is RESUMED, never re-done — then falls back to the pinned Claude agent, announced. A cited-risk change never leaves Claude (`extra_risk_tasks`, default `off`) — and mini's complexity read is not a substitute for that gate.
 
@@ -167,7 +167,7 @@ Models pinned in `.claude/agents/`; look one up here, never reconstruct a name (
 | mini analysis (docs only) | `orc-analyze-mini-sonnet-5-high` | claude-sonnet-5 / high | `orc-analyze-mini-opus-5-med` |
 | mini planning | `orc-planner-mini-sonnet-5-high` | claude-sonnet-5 / high | `orc-planner-mini-opus-5-med` |
 | mini execution | `orc-executor-sonnet-5-high` | claude-sonnet-5 / high | `orc-executor-opus-5-low` |
-| test authoring (opt-in) | `orc-test-author-opus-5-med` | claude-opus-5 / medium | unchanged |
+| test authoring (opt-in) | `orc-test-author-opus-5-med` | claude-opus-5-5 / medium | unchanged |
 
 ## Config
 

package/templates/skills/orc-verify/SKILL.md

@@ -5,7 +5,7 @@ description: >
   "/orc-verify", or "check the modified files". Runs INDEPENDENTLY —
   no orchestrator, no planning, no run folder required. Verifies only the
   git-modified changes in the working tree and shows a summary of results. Uses
-  Opus 5 medium effort. Read-only: it reports, it does not fix or commit.
+  Opus 5.5 medium effort. Read-only: it reports, it does not fix or commit.
 ---
 
 # ORC-VERIFY (standalone)
@@ -13,7 +13,7 @@ description: >
 A focused, dependency-free verify pass. No intake, no planning, no checkpoint —
 you point it at your uncommitted work and it tells you what's wrong.
 
-Run as Opus 5, medium effort.
+Run as Opus 5.5, medium effort.
 
 **Worked example** (orient only — never execute from it): `examples/verify-mock.md`.
 
@@ -97,16 +97,16 @@ exit code, and never re-derive a state word — the CLI's state words are the on
 state words, and **an exit code is an ANSWER wherever that contract says so, not
 a failure**. A call the answer does not name is a call this lane does not make.
 Exit ≠ 0 from the catalogue itself → say the CLI is unavailable and name the
-command you are about to run, out loud, before running it.
-
-## Rules — the anti-slop card (`../_shared/phases/rules.md`)
-
-`orc rules slice --lane orc-verify --json` is the ONLY assembler; never build
-the card here. It rides under the house rules and above the task —
-**house rules > your project's rules > ORC's own packs** — and its `line` prints
-VERBATIM at preflight. Returns gain `rules_applied[]`, `rules_conflicts[]` (a gap,
-never a silent choice) and `rules_overridden[]`.
-## Waiting mid-run (`/orc-wait`)
-
-Canonical: `../_shared/wait.md`. **`a lane that waits without a hand-back` has broken this contract.**
-Checkpoint **none** · safe point **single dispatch**. Nothing here to checkpoint, so all three modes behave identically — say so rather than asking. Never begin a wait between a dispatch and its validated return, or before the smoke gate has reported.
+command you are about to run, out loud, before running it.
+
+## Rules — the anti-slop card (`../_shared/phases/rules.md`)
+
+`orc rules slice --lane orc-verify --json` is the ONLY assembler; never build
+the card here. It rides under the house rules and above the task —
+**house rules > your project's rules > ORC's own packs** — and its `line` prints
+VERBATIM at preflight. Returns gain `rules_applied[]`, `rules_conflicts[]` (a gap,
+never a silent choice) and `rules_overridden[]`.
+## Waiting mid-run (`/orc-wait`)
+
+Canonical: `../_shared/wait.md`. **`a lane that waits without a hand-back` has broken this contract.**
+Checkpoint **none** · safe point **single dispatch**. Nothing here to checkpoint, so all three modes behave identically — say so rather than asking. Never begin a wait between a dispatch and its validated return, or before the smoke gate has reported.

package/templates/skills/orc-verify/examples/verify-mock.md

@@ -1,33 +1,33 @@
-# Example — Annotated Standalone Verify (dry run)
-
-V: = verifier (Opus 5 medium) · U: = user. Nothing real. Runs INDEPENDENTLY — no
-orchestrator, no planning, no run folder. Read-only: it reports, never fixes or commits.
-
-U: /orc-verify
-
-## Scope — git-modified changes only
-V: [git status/diff] 3 modified files: api/routes/orders.py, api/schemas.py,
-   tests/test_orders.py. Nothing staged beyond the working tree — verifying exactly
-   these changes (no repo-wide sweep).
-
-## Build + tests
-V: [detects Python/poetry/pytest]
-   $ poetry run pytest tests/test_orders.py  → 11 passed
-   $ poetry run mypy api/                     → clean
-   Build/type/test: GREEN.
-
-## Diff sanity + findings (P0–P3 ladder)
-V: Walks each hunk against intent inferred from the diff (every P0–P2 finding
-   anchored: file:line + the offending line quoted VERBATIM, else auto-P3):
-   ⛔ P1  api/routes/orders.py:42 — quote: `async def get_order(order_id: str):`
-      — new `/orders/{id}` route has no auth decorator; every sibling route
-      uses `@require_auth`. Security risk — likely unintended.
-      (Not P0: build/tests are green.)
-   • P3  api/schemas.py:18 — field `createdAt` breaks the snake_case convention
-      used elsewhere (`created_at`).
-   • P2  tests/test_orders.py — no negative-path test for a missing id.
-
-## Summary (read-only — no edits, no commit)
-V: 1 P1, 1 P2, 1 P3. Tests green but the missing auth decorator gates the
-   commit (P0/P1 = fix before commit; P2/P3 advisory). I don't edit or commit —
-   hand this to /orc or fix manually, then re-run /orc-verify.
+# Example — Annotated Standalone Verify (dry run)
+
+V: = verifier (Opus 5.5 medium) · U: = user. Nothing real. Runs INDEPENDENTLY — no
+orchestrator, no planning, no run folder. Read-only: it reports, never fixes or commits.
+
+U: /orc-verify
+
+## Scope — git-modified changes only
+V: [git status/diff] 3 modified files: api/routes/orders.py, api/schemas.py,
+   tests/test_orders.py. Nothing staged beyond the working tree — verifying exactly
+   these changes (no repo-wide sweep).
+
+## Build + tests
+V: [detects Python/poetry/pytest]
+   $ poetry run pytest tests/test_orders.py  → 11 passed
+   $ poetry run mypy api/                     → clean
+   Build/type/test: GREEN.
+
+## Diff sanity + findings (P0–P3 ladder)
+V: Walks each hunk against intent inferred from the diff (every P0–P2 finding
+   anchored: file:line + the offending line quoted VERBATIM, else auto-P3):
+   ⛔ P1  api/routes/orders.py:42 — quote: `async def get_order(order_id: str):`
+      — new `/orders/{id}` route has no auth decorator; every sibling route
+      uses `@require_auth`. Security risk — likely unintended.
+      (Not P0: build/tests are green.)
+   • P3  api/schemas.py:18 — field `createdAt` breaks the snake_case convention
+      used elsewhere (`created_at`).
+   • P2  tests/test_orders.py — no negative-path test for a missing id.
+
+## Summary (read-only — no edits, no commit)
+V: 1 P1, 1 P2, 1 P3. Tests green but the missing auth decorator gates the
+   commit (P0/P1 = fix before commit; P2/P3 advisory). I don't edit or commit —
+   hand this to /orc or fix manually, then re-run /orc-verify.

package/templates/skills/orc-wiki/references/extra.md

@@ -20,7 +20,7 @@ tier:
 | `wiki-scanner-light` | `orc-wiki-scanner-sonnet-5-high` |
 
 Both collapse onto `orc-wiki-scanner-opus-5-med` while `opus5_only` is on, which
-is why this adds **no agent and no pair**. Two slots and one Opus 5 agent is not
+is why this adds **no agent and no pair**. Two slots and one Opus 5.5 agent is not
 a contradiction: a slot names the POSITION, not the model.
 
 ```