@azure-id/orc 2.0.2 → 2.1.0

package/README.md

@@ -7,14 +7,14 @@
 *Intake → analyze → plan → score → parallel subagents → review → verify → ship.*
 
 ![npm](https://img.shields.io/npm/v/%40azure-id%2Forc?style=for-the-badge&color=cb3837&logo=npm)
-![Version](https://img.shields.io/badge/version-2.0.2-blue.svg?style=for-the-badge)
+![Version](https://img.shields.io/badge/version-2.1.0-blue.svg?style=for-the-badge)
 ![License](https://img.shields.io/badge/license-MIT-green.svg?style=for-the-badge)
 ![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg?style=for-the-badge)
 ![Claude Code](https://img.shields.io/badge/Claude_Code-Skills-purple.svg?style=for-the-badge)
 ![Dependencies](https://img.shields.io/badge/dependencies-zero-lightgrey.svg?style=for-the-badge)
 ![GitHub stars](https://img.shields.io/github/stars/azure-id/orc?style=for-the-badge&color=yellow)
 
-**Latest: v2.0.2** · updated 28-09-2026 · [full changelog](CHANGELOG.md)
+**Latest: v2.1.0** · updated 02-10-2026 · [full changelog](CHANGELOG.md)
 
 **On npm: [`@azure-id/orc`](https://www.npmjs.com/package/@azure-id/orc)** — `npm i -g @azure-id/orc`
 
@@ -255,6 +255,7 @@ ORC have terminal hook to see: Context Window %, 5 Hour usage %, Weekly usage %
 | **`/orc-fast`** | The fastest lane. Needs a fresh wiki **and** a cached code pattern; then it skips the analyst and planner entirely. A missing prerequisite falls back to `/orc-mini` — the chat never stops. | [see it](mock-run/orc-fast.md) |
 | **`/orc-quick`** | Ask for anything: a fix, a question, a defect hunt, a dependency bump, PR comments. Look → ask once → do. **It always asks which agent to dispatch**, and no setting can change that. A defect is **reproduced red before it is fixed**. | [see it](mock-run/orc-quick.md) |
 | **`/orc-wait`** | Wall-clock pause without losing the run. You see the window is nearly full, type `/orc-wait 30`, and ORC hands the run back to disk, waits in detached hops that **cost zero tokens**, and picks up where it stopped. Three modes decide how much finishes first: `safe` · `soft` (forces the checkpoint) · `hard` (fastest, can lose an in-flight return). `/orc-wait block <reason>` tells it not to stop you at all. | — |
+| **`/orc-fix`** | Fix one thing after a review: a Sonar issue, a red CI, a bug someone found. Inside a paused run it only **records** the fix (one observation and one `FIX` line in that run's trace), so the review that missed it is counted. With no run open, it fixes like `/orc-quick` and asks which agent to use. | [see it](mock-run/orc-fix.md) |
 | **`/orc-diy`** | Your own lane, composed in the terminal with `orc diy` and compiled. Unconfigured or stale → it refuses and offers plain `/orc`. | [see it](mock-run/orc-diy.md) |
 
 ### Work out what to build
@@ -617,8 +618,18 @@ fixed published formula turns them into a number. A cited risk forces a floor of
 70. The score maps through a published table to a **named, model-pinned agent**,
 so what ran is inspectable rather than requested in prose.
 
+The default table (since v2.1.0):
+
+| Score | Agent | Model · effort |
+|---|---|---|
+| `[0,21)` | `orc-executor-sonnet-5-low` | Sonnet 5 · low |
+| `[21,31)` | `orc-executor-sonnet-5-med` | Sonnet 5 · medium |
+| `[31,41)` | `orc-executor-sonnet-5-high` | Sonnet 5 · high |
+| `[41,90)` | `orc-executor-opus-5-low` | Opus 5.5 · low |
+| `[90,100]` | `orc-executor-opus-5-med` | Opus 5.5 · medium |
+
 > **The rule that catches everyone:** a subagent's model can never be higher than
-> your main session's. Run your session on Opus 5.
+> your main session's. Every band from score 41 needs an Opus 5.5 main session.
 
 **Full detail — the bands, `opus5_only`, and the tier guard `orc init` installs:
 [guides/model-selection.md](guides/model-selection.md).**
@@ -649,13 +660,13 @@ clobbers. `orc ui` ▸ Settings edits the same keys through the same validators.
 
 ```
 templates/
-├── skills/       31 skill folders, 38 SKILL.md files (a lane may ship subskills) —
+├── skills/       34 skill folders, 41 SKILL.md files (a lane may ship subskills) —
 │                 the lanes above, plus the ones with no command of their own:
 │                 context-combiner, orc-advisor, orc-judge, orc-analyze-mini,
 │                 and _shared/ (cross-lane contract prose)
-├── commands/     29 slash commands
+├── commands/     33 slash commands
 ├── hooks/        effort guard (PreToolUse) · statusline warning · behavior trace
-└── agents/       48 model-pinned subagents + MODEL-MAPPING.md
+└── agents/       50 model-pinned subagents + MODEL-MAPPING.md
 bin/cli.js        installer, config editor, flow composer, run-state reader, and
                   the deterministic half of every lane. Every read speaks --json
 bin/graph*.js     the code graph: store, extraction, resolution + its cache and
@@ -730,25 +741,42 @@ a current audit: [EVAL-REPORT.md](EVAL-REPORT.md).
 **Full history: [CHANGELOG.md](CHANGELOG.md)** — or `orc changelog`, which prints
 only what is newer than the version you have.
 
-### v2.0.2 — the lanes record what you answered, and the reviewer always gets the card _(2026-09-28)_
-
-**A patch from the live evals.** Habits now really work in a live run, and the reviewer
-always gets its card:
-
-- **Your answers are recorded correctly.** `orc trace write` checks every answer as it
-  arrives and hands a wrong one back with the right ids. At the end of a run it names
-  any question nobody recorded.
-- **The reviewer always gets the gotcha card.** A hook hands it to every reviewer,
-  verifier and judge, so a lane that forgets it cannot lose it.
-- **A run that writes no trace is stopped once** and told how to fix it.
-- **`/orc-quick` always takes the undo snapshot.**
-- **The compact rules card is on by default for `/orc-mini` and `/orc-fast`** (eval E4 passed).
-
-**What you have to do:** `orc update`.
+### v2.1.0 — the review counts, the score table moves up, and old logs can go _(2026-10-02)_
+
+- **A new score table with five bands.** Scores 0–40 go to Sonnet 5 (low,
+  medium, high). Scores 41–89 go to Opus 5.5 low, and 90–100 to Opus 5.5 medium.
+  Haiku is no longer in the table. **Every band from 41 needs an Opus 5.5 main
+  session.**
+- **Sonnet 5 runs on `claude-sonnet-5-5`.** The price table is correct again.
+- **The reviewer is `orc-reviewer-opus-5-low`.** In the live eval, low effort
+  found every seeded defect that was still in the diff.
+- **The wiki scanner and the CLAUDE.md writer use Opus 5.5 low** (they used Opus
+  4.8).
+- **Review quality no longer says "0 so far" after real reviews.** It counts
+  reviews from the traces. A clean review counts too.
+- **Your project's own review rule.** When CLAUDE.md or AGENTS.md asks for a
+  different review (for example `/code-review`), the lanes ask "ORC review, that
+  review, or skip". `orc review policy` shows what ORC found.
+- **New lane `/orc-fix`.** It records a fix after a review (Sonar, a red CI, a
+  bug) and who added the bug. The reviewer card shows it, and the panel shows
+  "Fixes after review".
+- **`orc clear logs`** shows old traces and run folders. `--apply` deletes them.
+  Nothing is deleted automatically unless you set `log_retention_auto: on`.
+- **The status line timer:** 1, 2, 3, 5 or 10 seconds. Below 1 second is refused,
+  because Claude Code does not support it.
+- **Behaviour tab fixes:** with `habits: off` you still see Review quality and
+  Gotchas, `/orc-fast` records your answers, and the answer log shows the question.
+
+**What you have to do:** `orc update`. If you compiled an `orc diy` flow, run
+`orc diy compile`. If a script names `orc-reviewer-opus-5-med`, change it to
+`orc-reviewer-opus-5-low`. The cost changes: read the CHANGELOG.
 
 <details>
-<summary><strong>Earlier releases</strong> — 124 of them, titles only. Full text in <a href="CHANGELOG.md">CHANGELOG.md</a>.</summary>
+<summary><strong>Earlier releases</strong> — 127 of them, titles only. Full text in <a href="CHANGELOG.md">CHANGELOG.md</a>.</summary>
 
+- **v2.0.4** — design the status line to the last cell · _2026-09-30_
+- **v2.0.3** — the status line you designed is the status line you see · _2026-09-30_
+- **v2.0.2** — the lanes record what you answered, and the reviewer always gets the card · _2026-09-28_
 - **v2.0.1** — the trace keeps the gate name, and the lanes find the habits rule · _2026-09-27_
 - **v2.0.0** — the coding lanes remember what you fixed and how you work · _2026-09-27_
 - **v1.9.2** — the code graph gets its own tab, and Opus 5 becomes Opus 5.5 · _2026-09-23_

package/bin/build-agents.js

@@ -34,8 +34,9 @@ const OUT_DIR = path.join(ROOT, "templates", "agents");
 // together). `effort: null` = a model with NO effort ladder (haiku): the
 // generator omits the `effort:` frontmatter line entirely.
 //
-// v1.0.0 W4 — the table is SIX bands, not eight, and the `opus5_only` ladder is
-// TWO, not three. Four of these agents are named by NO default row:
+// v1.0.0 W4 — the table was SIX bands, not eight, and the `opus5_only` ladder is
+// TWO, not three. v2.1.0 made the table FIVE bands (Sonnet 5 low/med/high, then
+// Opus 5.5 low/med). Seven of these agents are named by NO default row:
 // names them, and they ship anyway (D14). They stay reachable through
 // `rubric_bands_override`, `orc diy` `fixed_executor` and `extra_fallback_agent`,
 // and deleting a generated file that no row happens to name today would be a
@@ -44,13 +45,15 @@ const OUT_DIR = path.join(ROOT, "templates", "agents");
 // lies is worse than one that admits it is unreachable by default.
 const VARIANTS = [
   { name: "orc-executor-opus-5-med",     model: "claude-opus-5-5",     effort: "medium", band: "highest-complexity [90,100]" },
-  { name: "orc-executor-opus-5-low",     model: "claude-opus-5-5",     effort: "low",    band: "upper-complexity [65,90)" },
-  { name: "orc-executor-sonnet-5-high",  model: "claude-sonnet-5",  effort: "high",   band: "mid-complexity [55,65)" },
-  { name: "orc-executor-sonnet-4-6-high", model: "claude-sonnet-4-6", effort: "high",  band: "low-mid-complexity [40,55)" },
-  { name: "orc-executor-sonnet-4-6-med", model: "claude-sonnet-4-6", effort: "medium", band: "low-complexity [30,40)" },
-  { name: "orc-executor-haiku-4-5",      model: "claude-haiku-4-5",  effort: null,     band: "lowest-complexity [0,30)" },
-  // NAMED BY NO BAND since v1.0.0 W4 (D14) — kept on disk, dispatched only when a
-  // user names one explicitly.
+  { name: "orc-executor-opus-5-low",     model: "claude-opus-5-5",     effort: "low",    band: "upper-complexity [41,90)" },
+  { name: "orc-executor-sonnet-5-high",  model: "claude-sonnet-5-5",  effort: "high",   band: "mid-complexity [31,41)" },
+  { name: "orc-executor-sonnet-5-med",   model: "claude-sonnet-5-5",  effort: "medium", band: "low-complexity [21,31)" },
+  { name: "orc-executor-sonnet-5-low",   model: "claude-sonnet-5-5",  effort: "low",    band: "lowest-complexity [0,21)" },
+  // NAMED BY NO BAND since v1.0.0 W4 / v2.1.0 (D14) — kept on disk, dispatched
+  // only when a user names one explicitly.
+  { name: "orc-executor-sonnet-4-6-high", model: "claude-sonnet-4-6", effort: "high",  band: "none (opt-in only, see MODEL-MAPPING.md)" },
+  { name: "orc-executor-sonnet-4-6-med", model: "claude-sonnet-4-6", effort: "medium", band: "none (opt-in only, see MODEL-MAPPING.md)" },
+  { name: "orc-executor-haiku-4-5",      model: "claude-haiku-4-5",  effort: null,     band: "none (opt-in only, see MODEL-MAPPING.md)" },
   { name: "orc-executor-opus-5-high",    model: "claude-opus-5-5",    effort: "high",   band: "none (opt-in only, see MODEL-MAPPING.md)" },
   { name: "orc-executor-opus-4-8-high",  model: "claude-opus-4-8",  effort: "high",   band: "none (opt-in only, see MODEL-MAPPING.md)" },
   { name: "orc-executor-opus-4-7-high",  model: "claude-opus-4-7",  effort: "high",   band: "none (opt-in only, see MODEL-MAPPING.md)" },
@@ -66,20 +69,20 @@ const VARIANTS = [
 const TWIN_DIR = path.join(ROOT, "agents-src", "twins");
 const TWINS = [
   { family: "analyze-mini", variants: [
-    { name: "orc-analyze-mini-sonnet-5-high", model: "claude-sonnet-5", effort: "high", who: "Sonnet 5, high",
-      desc: "ORC mini System Analyst — claude-sonnet-5, high effort. Dispatched by /orc-mini and /orc-analyze-mini at analysis: single pass, no deep mode, no scouts." },
+    { name: "orc-analyze-mini-sonnet-5-high", model: "claude-sonnet-5-5", effort: "high", who: "Sonnet 5, high",
+      desc: "ORC mini System Analyst — claude-sonnet-5-5, high effort. Dispatched by /orc-mini and /orc-analyze-mini at analysis: single pass, no deep mode, no scouts." },
     { name: "orc-analyze-mini-opus-5-med", model: "claude-opus-5-5", effort: "medium", who: "Opus 5.5, medium",
       desc: "ORC mini System Analyst — claude-opus-5-5, medium effort. Dispatched by /orc-mini and /orc-analyze-mini, instead of orc-analyze-mini-sonnet-5-high when `opus5_only: true`." },
   ] },
   { family: "planner-mini", variants: [
-    { name: "orc-planner-mini-sonnet-5-high", model: "claude-sonnet-5", effort: "high", who: "Sonnet 5, high",
-      desc: "ORC mini Requirement Planner — claude-sonnet-5, high effort. Dispatched by /orc-mini at planning." },
+    { name: "orc-planner-mini-sonnet-5-high", model: "claude-sonnet-5-5", effort: "high", who: "Sonnet 5, high",
+      desc: "ORC mini Requirement Planner — claude-sonnet-5-5, high effort. Dispatched by /orc-mini at planning." },
     { name: "orc-planner-mini-opus-5-med", model: "claude-opus-5-5", effort: "medium", who: "Opus 5.5, medium",
       desc: "ORC mini Requirement Planner — claude-opus-5-5, medium effort. Dispatched by /orc-mini at planning, instead of orc-planner-mini-sonnet-5-high when `opus5_only: true`." },
   ] },
   { family: "pattern-codifier", variants: [
-    { name: "orc-pattern-codifier-sonnet-5-high", model: "claude-sonnet-5", effort: "high",
-      desc: "ORC Pattern Codifier — claude-sonnet-5, high effort. Dispatched by orc-pattern (lazy /orc miss, eager orc-wiki, or manual /orc-pattern) for ONE language." },
+    { name: "orc-pattern-codifier-sonnet-5-high", model: "claude-sonnet-5-5", effort: "high",
+      desc: "ORC Pattern Codifier — claude-sonnet-5-5, high effort. Dispatched by orc-pattern (lazy /orc miss, eager orc-wiki, or manual /orc-pattern) for ONE language." },
     { name: "orc-pattern-codifier-opus-5-med", model: "claude-opus-5-5", effort: "medium",
       desc: "ORC Pattern Codifier — claude-opus-5-5, medium effort. Dispatched by orc-pattern, instead of orc-pattern-codifier-sonnet-5-high when `opus5_only: true`." },
   ] },
@@ -90,8 +93,8 @@ const TWINS = [
       desc: "ORC Recon — claude-opus-5-5, low effort. Dispatched by /orc-quick at the dispatch gate, for a WIDE or SUBTLE read-only question. It never edits." },
   ] },
   { family: "retro", variants: [
-    { name: "orc-retro-sonnet-5-high", model: "claude-sonnet-5", effort: "high", who: "Sonnet 5, high",
-      desc: "ORC Retro miner — claude-sonnet-5, high effort. Dispatched by /orc-retro to mine the behavior traces. Read-only, report-only." },
+    { name: "orc-retro-sonnet-5-high", model: "claude-sonnet-5-5", effort: "high", who: "Sonnet 5, high",
+      desc: "ORC Retro miner — claude-sonnet-5-5, high effort. Dispatched by /orc-retro to mine the behavior traces. Read-only, report-only." },
     { name: "orc-retro-opus-5-med", model: "claude-opus-5-5", effort: "medium", who: "Opus 5.5, medium",
       desc: "ORC Retro miner — claude-opus-5-5, medium effort. Dispatched by /orc-retro, instead of orc-retro-sonnet-5-high when `opus5_only: true`. Read-only." },
   ] },
@@ -102,16 +105,12 @@ const TWINS = [
       desc: "ORC Code Scout — claude-opus-5-5, low effort. Dispatched by orc in the analyst's DEEP mode, instead of orc-scout-sonnet-4-6-high when `opus5_only: true`." },
   ] },
   { family: "claude-writer", variants: [
-    { name: "orc-claude-writer-opus-4-8-high", model: "claude-opus-4-8", effort: "high", who: "Opus 4.8, high",
-      desc: "ORC CLAUDE.md Writer — claude-opus-4-8, high effort. Dispatched by /orc-claude to create, update or refresh the repo-root CLAUDE.md." },
-    { name: "orc-claude-writer-opus-5-med", model: "claude-opus-5-5", effort: "medium", who: "Opus 5.5, medium",
-      desc: "ORC CLAUDE.md Writer — claude-opus-5-5, medium effort. Dispatched by /orc-claude, instead of orc-claude-writer-opus-4-8-high when `opus5_only: true`." },
+    { name: "orc-claude-writer-opus-5-low", model: "claude-opus-5-5", effort: "low", who: "Opus 5.5, low",
+      desc: "ORC CLAUDE.md Writer — claude-opus-5-5, low effort. Dispatched by /orc-claude to create, update or refresh the repo-root CLAUDE.md." },
   ] },
   { family: "wiki-scanner", variants: [
-    { name: "orc-wiki-scanner-opus-4-8-high", model: "claude-opus-4-8", effort: "high",
-      desc: "ORC Wiki Scanner — claude-opus-4-8, high effort. Dispatched by orc-wiki per scan-task (DEEP tier), ONE coverage area each." },
-    { name: "orc-wiki-scanner-opus-5-med", model: "claude-opus-5-5", effort: "medium",
-      desc: "ORC Wiki Scanner — claude-opus-5-5, medium effort. Dispatched by orc-wiki per scan-task, for BOTH tiers when `opus5_only: true`." },
+    { name: "orc-wiki-scanner-opus-5-low", model: "claude-opus-5-5", effort: "low",
+      desc: "ORC Wiki Scanner — claude-opus-5-5, low effort. Dispatched by orc-wiki per scan-task (DEEP tier), ONE coverage area each." },
   ] },
 ];