harness-everything 0.30.5 → 0.30.7

package/evals/fable-mode/tasks/negative-tier2-no-model.yaml

@@ -1,6 +1,6 @@
 id: negative-fable-model-005
-name: Ordinary Tier 2 work does not select a fable model
-description: A normal Tier 2 bugfix must not route to a model-pinned fable entrypoint.
+name: Ordinary Tier 2 work does not select a fable profile
+description: A normal Tier 2 bugfix must not route to an explicit Fable behavior profile.
 tags:
   - negative-trigger
   - tier-2
@@ -10,7 +10,7 @@ expected:
   should_trigger: false
 graders:
   - type: text
-    name: no-model-pinned-route
+    name: no-explicit-profile-route
     config:
       contains:
         - "fable-opus"

package/evals/fable-mode/tasks/positive-haiku-mode.yaml

@@ -1,6 +1,6 @@
 id: positive-fable-haiku-002
 name: Explicit Haiku mode routes mechanical work
-description: "Stage large, multi-source or multi-session tasks through a written plan, named fable agents, failable per-stage checks, and skeptical delivery review; use fable-opus, fable-sonnet, or fable-haiku for explicit model selection."
+description: "Stage large tasks through plans, named fable agents, failable checks, and skeptical review; fable on opus|sonnet|haiku selects a behavior profile, not a runtime model."
 tags:
   - positive-trigger
   - fable-haiku

package/evals/fable-mode/tasks/positive-opus-mode.yaml

@@ -1,6 +1,6 @@
 id: positive-fable-opus-004
 name: Explicit Opus mode routes macro orchestration
-description: "Stage large, multi-source or multi-session tasks through a written plan, named fable agents, failable per-stage checks, and skeptical delivery review; use fable-opus, fable-sonnet, or fable-haiku for explicit model selection."
+description: "Stage large tasks through plans, named fable agents, failable checks, and skeptical review; fable on opus|sonnet|haiku selects a behavior profile, not a runtime model."
 tags:
   - positive-trigger
   - fable-opus

package/evals/fable-mode/tasks/positive-sonnet-mode.yaml

@@ -1,6 +1,6 @@
 id: positive-fable-sonnet-003
 name: Explicit Sonnet mode routes reasoning work
-description: "Stage large, multi-source or multi-session tasks through a written plan, named fable agents, failable per-stage checks, and skeptical delivery review; use fable-opus, fable-sonnet, or fable-haiku for explicit model selection."
+description: "Stage large tasks through plans, named fable agents, failable checks, and skeptical review; fable on opus|sonnet|haiku selects a behavior profile, not a runtime model."
 tags:
   - positive-trigger
   - fable-sonnet

package/evals/fable-mode/tasks/positive-trigger.yaml

@@ -1,6 +1,6 @@
 id: positive-fable-mode-001
 name: On-scope prompt triggers fable-mode
-description: "Stage large, multi-source or multi-session tasks through a written plan, named fable agents, failable per-stage checks, and skeptical delivery review; use fable-opus, fable-sonnet, or fable-haiku for explicit model selection."
+description: "Stage large tasks through plans, named fable agents, failable checks, and skeptical review; fable on opus|sonnet|haiku selects a behavior profile, not a runtime model."
 tags:
   - positive-trigger
 inputs:

package/fable-mode/SKILL.md

@@ -1,39 +1,45 @@
 ---
 name: fable-mode
-description: "Stage large, multi-source or multi-session tasks through a written plan, named fable agents, failable per-stage checks, and skeptical delivery review; use fable-opus, fable-sonnet, or fable-haiku for explicit model selection."
+description: "Stage large tasks through plans, named fable agents, failable checks, and skeptical review; fable on opus|sonnet|haiku selects a behavior profile, not a runtime model."
 license: Apache-2.0
 metadata:
   author: Miya Daniel
-  version: 0.30.2
+  version: 0.30.7
 ---
 
-# Fable Mode (v3)
+# Fable Mode
 
 ## Skill Contract
 
 | Component | Specification |
 | :--- | :--- |
-| **Trigger / Input** | Tier 3 work spanning multiple files, sources, or sessions. |
-| **Expected Output** | Stage map, named-agent briefs, failable checks, and skeptical review. |
-| **State Mutations** | Native host TODO tracker or a Markdown checklist; one JSON audit record per stage. |
-| **Enforcement Gate** | `<this-skill-dir>/scripts/model-selector.js`, stage contracts, and `<skills-repo-root>/harness-everything/scripts/verify-gate.js`. |
+| **Trigger / Input** | Profile lookup or Tier 3 execution. |
+| **Expected Output** | Profile record or verified stages. |
+| **State Mutations** | Execution only: stage checklist and audit records. |
+| **Enforcement Gate** | Execution: `<this-skill-dir>/scripts/model-selector.js`, stage contracts, and `<skills-repo-root>/harness-everything/scripts/verify-gate.js`. |
 
 ## USE FOR:
 - Large multi-file, multi-source, or multi-session work
-- Explicit `fable on haiku`, `fable on sonnet`, or `fable on opus` requests
+- Fable profile explanations or explicit Fable execution requests
 - Work needing named delegation and cold verification
 
 ## DO NOT USE FOR:
 - One obvious single-pass edit
 - Ordinary Tier 2 implementation or bugfix work
 
+## Select Operation First
+
+For explanation/profile-only lookup, read only `<this-skill-dir>/references/profile-lookup.md` and answer. No stage state, delegation, or selector source reads. Quoted aliases do not start Fable. Mixed execution retains its topology.
+
+Execution follows the workflow below.
+
 ## Workflow
 
 1. Discover the runtime and lock the authorized file scope before edits.
-2. Write a numbered stage map with one artifact and pass condition per stage; allow at most two full replans.
-3. Resolve the requested model with `model-selector.js`; never silently downgrade.
-4. Delegate by named agent where available: Opus orchestrates, Sonnet reasons, Haiku handles mechanical work, and workers never spawn workers.
-5. Write a stage contract, run its named check, then cold-review high-stakes artifacts with `fable-verifier`.
-6. Record requested/effective model, fallback reason, stage brief, pass condition, verification command, and verifier result for every stage. Escalate unresolved blockers.
+2. Set artifact/check per stage; advisory replans never halt. Rule-of-3 applies to 3 same-signature failures.
+3. Resolve the requested behavior profile with `model-selector.js`; `opus`, `sonnet`/`sonnect`, and `haiku` are compatibility aliases, not model bindings.
+4. Delegate by profile: orchestrator coordinates, reasoning handles bounded judgment, mechanical handles low-ambiguity work, and workers never spawn workers.
+5. Treat the host runtime-model floor as advisory; record its status without blocking Fable solely for model choice.
+6. Run each stage check, cold-review high-stakes artifacts, and audit profile/runtime/fallback fields.
 
 Deep dive: <this-skill-dir>/references/model-matrix.md

package/fable-mode/agents/fable-orchestrator.md

@@ -2,7 +2,7 @@
 name: fable-orchestrator
 description: Staged-execution orchestrator for large, multi-part, or multi-session tasks. Use when fable-mode discipline must run with enforced delegation — it consumes the router topology, writes a dependency/write-set stage map, delegates ALL artifact production to fable-worker-sonnet / fable-worker-haiku, verifies every stage with a failable check, and sends high-stakes deliverables to fable-verifier for a cold re-check. It has no Write or Edit tool, so it cannot do the work itself.
 tools: Read, Grep, Glob, Bash, Task, TodoWrite
-model: opus
+model: inherit
 ---
 
 You are the fable orchestrator. You coordinate; you do not produce. You have no
@@ -18,7 +18,7 @@ and delegate.
 When a structured Harness workflow plan is supplied, consume it; do not rebuild
 its topology from tier labels or keywords. Fable may consume only the selected
 strategy, parallelism constraints, verifier requirement, workspace/memory hints,
-limits, and requested-model metadata. The router does not spawn workers and
+limits, and requested-profile metadata. The router does not spawn workers and
 Fable does not reclassify the task.
 
 - `fable-staged` — execute validated stages sequentially.
@@ -31,11 +31,12 @@ Fable does not reclassify the task.
 If the plan is blocked, deferred, direct-single, or iterative-single, do not
 silently coerce it into Fable. Return control to the caller with the plan reason.
 
-Before the first stage, resolve the requested model with
+Before the first stage, resolve the requested behavior profile with
 `fable-mode/scripts/model-selector.js`. Carry its JSON record into every stage
-brief. The workflow-plan consumer must never substitute a branded model. A
-missing model must produce the model selector's explicit `fallback` or `blocked`
-status. Every brief and handoff names requested versus effective model.
+brief. Profile aliases never pin a branded model. Host runtime-model floors are
+advisory metadata: below-floor or unknown remains visible but does not change or
+block the profile. Agent availability still uses explicit `inline`/`stop`
+fallback. Every brief names requested/effective profile and runtime model when known.
 
 ## Core loop
 

package/fable-mode/agents/fable-verifier.md

@@ -2,7 +2,7 @@
 name: fable-verifier
 description: Cold verifier for finished fable deliverables. Brief it with ONLY the spec and the artifact path — never the producer's reasoning — and it re-runs the named checks from scratch and returns pass/fail per check. Read-only by design; it cannot fix anything, only judge it. Use for high-stakes deliverables after the producing agent claims its checks passed.
 tools: Read, Grep, Glob, Bash
-model: haiku
+model: inherit
 ---
 
 You are a cold verifier. You receive a spec and an artifact. You were

package/fable-mode/agents/fable-worker-haiku.md

@@ -2,7 +2,7 @@
 name: fable-worker-haiku
 description: Fable stage worker for bulk mechanical work — file processing, format conversion, boilerplate, structured extraction, batch edits. Cheap and parallelizable. Produces one verifiable artifact per assignment with tightened verification (no bare "unverified" allowed). Spawned by fable-orchestrator or directly by a fable skill; does not spawn further agents.
 tools: Read, Write, Edit, Grep, Glob, Bash, WebSearch, WebFetch
-model: haiku
+model: inherit
 ---
 
 You are a fable stage worker for mechanical tasks. You receive one bounded
@@ -27,9 +27,10 @@ Rules, in order:
 5. **Report format:** artifact path, check command, check output, blockers.
    Short.
 
-Include the mode audit fields in the report: requested model, effective model,
-fallback reason, stage brief, pass condition, verification command, and verifier
-result. A fallback or blocker must remain visible in the report.
+Include the audit fields in the report: requested/effective profile, profile alias,
+runtime model/effort, runtime-floor status, fallback reason, stage brief, pass
+condition, verification command, and verifier result. A fallback or blocker must
+remain visible in the report.
 
 Do not spawn subagents.
 

package/fable-mode/agents/fable-worker-sonnet.md

@@ -2,7 +2,7 @@
 name: fable-worker-sonnet
 description: Fable stage worker for tasks needing real reasoning — research synthesis, nontrivial code, analysis, document drafting. Produces one verifiable artifact per assignment and reports the named check that proves it. Spawned by fable-orchestrator or directly by a fable skill; does not spawn further agents.
 tools: Read, Write, Edit, Grep, Glob, Bash, WebSearch, WebFetch
-model: sonnet
+model: inherit
 ---
 
 You are a fable stage worker. You receive one bounded assignment: a specific
@@ -26,9 +26,10 @@ Rules of the loop, in order:
 4. **Report format:** artifact path, check command, check output, confirmed
    facts vs. inferences (labeled), leftovers/recommendations. Keep it short.
 
-Include the mode audit fields in the report: requested model, effective model,
-fallback reason, stage brief, pass condition, verification command, and verifier
-result. Preserve any `fallback` or `blocked` status from the selector.
+Include the audit fields in the report: requested/effective profile, profile alias,
+runtime model/effort, runtime-floor status, fallback reason, stage brief, pass
+condition, verification command, and verifier result. Preserve any agent
+`fallback` or `blocked` status from the selector.
 
 Do not spawn subagents. Escalate rather than guess: if the assignment needs
 synthesis beyond you or its requirements are contradictory, stop and return the

package/fable-mode/behavior-profile-matrix.json

@@ -0,0 +1,36 @@
+{
+  "schemaVersion": 2,
+  "profiles": {
+    "mechanical": {
+      "legacyAlias": "haiku",
+      "aliases": [
+        "mechanical",
+        "haiku"
+      ],
+      "role": "mechanical-worker",
+      "useFor": "bulk mechanical work, format conversion, boilerplate, structured extraction, and other low-ambiguity tasks",
+      "agent": "fable-worker-haiku"
+    },
+    "reasoning": {
+      "legacyAlias": "sonnet",
+      "aliases": [
+        "reasoning",
+        "sonnet",
+        "sonnect"
+      ],
+      "role": "reasoning-worker",
+      "useFor": "non-trivial implementation, research synthesis, analysis, document drafting, and bounded design reasoning",
+      "agent": "fable-worker-sonnet"
+    },
+    "orchestrator": {
+      "legacyAlias": "opus",
+      "aliases": [
+        "orchestrator",
+        "opus"
+      ],
+      "role": "orchestrator",
+      "useFor": "stage decomposition, dependency management, cross-stage synthesis, architecture, and high-stakes final decisions",
+      "agent": "fable-orchestrator"
+    }
+  }
+}

package/fable-mode/execution-guardrails/SKILL.md

@@ -1,13 +1,10 @@
 ---
 name: execution-guardrails
-description: >-
-  Always-on guardrails: verify findings before flagging warnings, batch
-  minor caveats, and anchor search-and-replace edits with post-write checks.
-  Use when raising warnings or performing search-and-replace file edits.
+description: "Reference guardrails for verified warnings and safe replacements; active carriers must inject them explicitly."
 license: Apache-2.0
 metadata:
   author: Miya Daniel
-  version: 0.30.2
+  version: 0.30.7
 ---
 
 # Execution Guardrails
@@ -40,6 +37,6 @@ metadata:
 
 Repeated matching execution failures remain governed by Rule-of-3 / `zoom-out`; warning batching never substitutes for that recovery path.
 
-These rules are always-on, even when `fable-mode`'s staged loop is not running.
+This nested file is reference-only, not an always-on carrier; rules apply only when an active carrier injects them.
 
 Deep dive: <this-skill-dir>/references/guardrail-rules.md

package/fable-mode/execution-guardrails/references/guardrail-rules.md

@@ -1,9 +1,8 @@
 # Guardrail Rules — Full Detail
 
-Three rules extracted from fable-mode's operational section so they apply everywhere,
-not only inside the staged loop. A frontier model doesn't need a stage map for a simple
-task, but it still needs these — they encode the user's preferences, and no model ships
-knowing them.
+Three rules extracted from fable-mode's operational section so active carriers can reuse
+them outside the staged loop. A frontier model doesn't need a stage map for a simple task,
+but any carrier that relies on these rules must load, copy, or inject them explicitly.
 
 ## 1. Verify before flag
 
@@ -53,8 +52,8 @@ Preferred order of tools: IDE native structured replace tool (`replace_string_in
 
 ## Relationship to fable-mode
 
-fable-mode's staged loop is optional and gated on task size. These guardrails are not
-optional and not gated. When fable-mode runs, its step 4 (self-critique) and all file
-edits inherit these rules. When fable-mode doesn't run, these rules apply anyway. In v3
-the per-model runners route to frontmatter-defined agents (`agents/*.md`) whose system
-prompts carry these rules inline, because spawned agents cannot see this skill.
+fable-mode's staged loop is optional and gated on task size. These rules are intended as
+baseline execution guidance wherever an active carrier loads them, but this nested
+reference is not itself automatically discovered or always-on. In v3 the per-model
+flow routes to frontmatter-defined agents (`agents/*.md`) whose system prompts carry
+the required rules inline, because spawned agents cannot see this reference file.

package/fable-mode/fable-haiku/SKILL.md

@@ -1,14 +1,16 @@
 ---
 name: fable-haiku
-description: "Run staged fable work on Haiku for bulk mechanical tasks with explicit pass conditions, visible fallback handling, and a cold verifier pass."
+description: "Reference mechanical behavior profile (legacy alias haiku) for bulk low-ambiguity work with explicit checks and cold verification; runtime model choice is separate."
 license: Apache-2.0
 metadata:
   author: Miya Daniel
-  version: 0.30.2
+  version: 0.30.7
 ---
 
 # Fable Mode — Haiku
 
+> **Reference profile, not a standalone plugin skill.** Invoke this profile through `fable-mode` with `fable on haiku`; plugin manifests do not register this nested directory independently.
+
 ## Skill Contract
 
 | Component | Specification |
@@ -28,9 +30,9 @@ metadata:
 
 ## Run it
 
-1. Resolve `haiku` through `<this-skill-dir>/../scripts/model-selector.js`.
-2. Spawn `fable-worker-haiku` when available; otherwise use an inline fallback only when the audit record says so.
+1. Resolve legacy alias `haiku` to the `mechanical` behavior profile through `<this-skill-dir>/../scripts/model-selector.js`.
+2. Spawn `fable-worker-haiku` when available; otherwise use the explicit inline/stop agent fallback. The runtime-model floor is advisory and never changes the profile.
 3. Brief one bounded output path and a named check; workers do not spawn workers.
 4. Route synthesis blockers to Sonnet/Opus and cold-review unsupervised delivery with `fable-verifier`.
 
-Use `<this-skill-dir>/../references/model-matrix.md` for the audit fields and fallback policy.
+Use `<this-skill-dir>/../references/model-matrix.md` for behavior-profile aliases, runtime floors, audit fields, and fallback policy.

package/fable-mode/fable-haiku/references/routing-notes.md

@@ -6,7 +6,8 @@ Details moved from SKILL.md.
 
 The worker is a real agent definition (`../agents/fable-worker-haiku.md`)
 invoked by name. Its system prompt carries the loop, the tightened verification
-rule, and the operational rules; this skill only routes.
+rule, and the operational rules; this reference profile documents the route used after
+`fable-mode` selects Haiku.
 
 ## Full run procedure
 

package/fable-mode/fable-opus/SKILL.md

@@ -1,14 +1,16 @@
 ---
 name: fable-opus
-description: "Run staged fable orchestration on Opus for cross-stage synthesis, high-stakes architecture, and final decisions with named workers, cold verification, and visible fallback handling."
+description: "Reference orchestrator behavior profile (legacy alias opus) for staged synthesis, architecture, named delegation, and cold verification; runtime model choice is separate."
 license: Apache-2.0
 metadata:
   author: Miya Daniel
-  version: 0.30.2
+  version: 0.30.7
 ---
 
 # Fable Mode — Opus
 
+> **Reference profile, not a standalone plugin skill.** Invoke this profile through `fable-mode` with `fable on opus`; plugin manifests do not register this nested directory independently.
+
 ## Skill Contract
 
 | Component | Specification |
@@ -24,13 +26,13 @@ metadata:
 
 ## DO NOT USE FOR:
 - One obvious single-pass task
-- Bulk mechanical work (use `fable-haiku`) or bounded reasoning (use `fable-sonnet`)
+- Bulk mechanical work (select `fable on haiku`) or bounded reasoning (select `fable on sonnet`)
 
 ## Run it
 
-1. Resolve `opus` through `<this-skill-dir>/../scripts/model-selector.js`.
-2. Spawn `fable-orchestrator` when the runtime exposes it; otherwise report the inline fallback explicitly.
-3. The orchestrator owns scope lock, at most two replans, stage contracts, named worker delegation, and escalation; it never produces artifacts itself.
+1. Resolve legacy alias `opus` to the `orchestrator` behavior profile through `<this-skill-dir>/../scripts/model-selector.js`.
+2. Spawn `fable-orchestrator` when available; otherwise use the explicit inline/stop agent fallback. The runtime-model floor is advisory and never changes the profile.
+3. The orchestrator owns scope boundaries, advisory replan guidance (never a hard stop), stage contracts, named worker delegation, and escalation; it never produces artifacts itself. After three same-signature failures, Rule-of-3 / `zoom-out` is mandatory.
 4. Cold-review high-stakes deliverables with `fable-verifier`; report every unverified stage.
 
-Use `<this-skill-dir>/../references/model-matrix.md` for the audit fields and fallback policy.
+Use `<this-skill-dir>/../references/model-matrix.md` for behavior-profile aliases, runtime floors, audit fields, and fallback policy.

package/fable-mode/fable-sonnet/SKILL.md

@@ -1,14 +1,16 @@
 ---
 name: fable-sonnet
-description: "Run staged fable work on Sonnet for non-trivial implementation, research synthesis, or bounded reasoning with explicit pass conditions and visible fallback handling."
+description: "Reference reasoning behavior profile (legacy alias sonnet/sonnect) for non-trivial implementation, synthesis, and bounded judgment; runtime model choice is separate."
 license: Apache-2.0
 metadata:
   author: Miya Daniel
-  version: 0.30.2
+  version: 0.30.7
 ---
 
 # Fable Mode — Sonnet
 
+> **Reference profile, not a standalone plugin skill.** Invoke this profile through `fable-mode` with `fable on sonnet`; plugin manifests do not register this nested directory independently.
+
 ## Skill Contract
 
 | Component | Specification |
@@ -24,13 +26,13 @@ metadata:
 
 ## DO NOT USE FOR:
 - One obvious single-pass task
-- Macro orchestration or final high-stakes decisions (use `fable-opus`)
+- Macro orchestration or final high-stakes decisions (select `fable on opus`)
 
 ## Run it
 
-1. Resolve `sonnet` through `<this-skill-dir>/../scripts/model-selector.js`; normalize `sonnect` to Sonnet.
-2. Spawn `fable-worker-sonnet` when available, otherwise use a visible inline fallback.
+1. Resolve `sonnet` or `sonnect` to the `reasoning` behavior profile through `<this-skill-dir>/../scripts/model-selector.js`.
+2. Spawn `fable-worker-sonnet` when available; otherwise use the explicit inline/stop agent fallback. The runtime-model floor is advisory and never changes the profile.
 3. Brief the exact artifact path, context, and pass condition; workers do not spawn workers.
 4. Send high-stakes artifacts to `fable-verifier` and escalate contradictions instead of guessing.
 
-Use `<this-skill-dir>/../references/model-matrix.md` for the audit fields and fallback policy.
+Use `<this-skill-dir>/../references/model-matrix.md` for behavior-profile aliases, runtime floors, audit fields, and fallback policy.

package/fable-mode/model-matrix.json

@@ -1,32 +1,9 @@
 {
-  "schemaVersion": 1,
-  "modes": {
-    "haiku": {
-      "role": "bulk mechanical / format conversion",
-      "agent": "fable-worker-haiku",
-      "aliases": ["haiku"]
-    },
-    "sonnet": {
-      "role": "non-trivial implementation / research synthesis / bounded stage reasoning",
-      "agent": "fable-worker-sonnet",
-      "aliases": ["sonnet", "sonnect"]
-    },
-    "opus": {
-      "role": "macro orchestration / cross-stage synthesis / high-stakes architecture and final decision",
-      "agent": "fable-orchestrator",
-      "aliases": ["opus"]
-    }
-  },
-  "fallbacks": {
-    "inline": {
-      "status": "fallback",
-      "effectiveModel": "host-model",
-      "reason": "requested model is unavailable; run inline on the declared host model"
-    },
-    "stop": {
-      "status": "blocked",
-      "effectiveModel": null,
-      "reason": "requested model is unavailable and inline fallback was not authorized"
-    }
-  }
+  "schemaVersion": 2,
+  "deprecated": true,
+  "replacedBy": [
+    "behavior-profile-matrix.json",
+    "runtime-model-floor-matrix.json"
+  ],
+  "note": "Fable profiles define behavior and role assignment. Runtime model floors are host-specific recommendations and do not define the profile."
 }

package/fable-mode/references/execution-phases.md

@@ -16,7 +16,8 @@ flowchart TD
 
 Read the relevant files and sources before producing an artifact. Lock the
 authorized write scope in the handoff. Number the stages, assign one artifact
-and one pass condition to each, and allow no more than two full replans.
+and one pass condition to each. Replan counts are advisory and never a hard
+stop; three same-signature failures still require Rule-of-3 `zoom-out`.
 
 ## Delegation
 

package/fable-mode/references/model-matrix.md

@@ -1,41 +1,46 @@
-# Fable model matrix and execution audit
+# Fable behavior profiles and runtime model floors
 
-Issue #27 defines three explicit execution modes. The mode selector is the
-machine-readable gate; this document is the human-facing contract.
+Fable profiles define **how work is performed and which role owns it**. They do not select or require a branded runtime model. The historical names `haiku`, `sonnet`/`sonnect`, and `opus` remain accepted aliases so existing prompts keep working.
 
-| Mode | Use for | Named agent |
-|---|---|---|
-| Haiku | Bulk mechanical work and format conversion | `fable-worker-haiku` |
-| Sonnet | Non-trivial implementation, research synthesis, bounded reasoning | `fable-worker-sonnet` |
-| Opus | Macro orchestration, cross-stage synthesis, high-stakes architecture and final decisions | `fable-orchestrator` |
+## Behavior Profile Matrix
+
+| Canonical profile | Legacy alias | Role | Typical work | Named agent |
+|---|---|---|---|---|
+| `mechanical` | `haiku` | Mechanical worker | Bulk edits, format conversion, boilerplate, structured extraction | `fable-worker-haiku` |
+| `reasoning` | `sonnet` / `sonnect` | Reasoning worker | Non-trivial implementation, research synthesis, analysis, bounded design | `fable-worker-sonnet` |
+| `orchestrator` | `opus` | Orchestrator | Stage decomposition, dependency management, cross-stage synthesis, architecture/final decisions | `fable-orchestrator` |
+| verifier | — | Cold reviewer | Spec-versus-artifact checks and independent re-verification | `fable-verifier` |
+
+The machine-readable source is `fable-mode/behavior-profile-matrix.json`.
+
+## Runtime Model Floor Matrix
 
-Use the explicit entrypoints `fable-haiku`, `fable-sonnet`, and `fable-opus`.
-The accepted input `sonnect` normalizes to Sonnet. A normal Tier 2 prompt does
-not select a fable model.
+Runtime floors are **host-specific recommendations**, not Fable identity and not an execution gate. A newer compatible model/effort may be used. If the active runtime is below or cannot be compared to the floor, Fable continues with the same behavior profile and records the status visibly.
 
-## Deterministic selection
+| Fable profile | Claude recommended floor | Codex recommended floor |
+|---|---|---|
+| `orchestrator` | Opus 5.5+ / medium+ | GPT-6 Sol+ / xhigh+ |
+| `reasoning` | Sonnet 5.5+ / medium+ | GPT-6 Sol+ / medium+ |
+| `mechanical` | Haiku 5.5+ | GPT-6 Luna 6+ / xhigh+ |
+
+The machine-readable source is `fable-mode/runtime-model-floor-matrix.json`. These are Harness support baselines, not claims that every host currently exposes every listed model.
 
-Before each stage, run `fable-mode/scripts/model-selector.js` with the requested
-mode, the runtime's available modes, the host model, and the stage contract:
+## Resolution
 
 ```text
-node fable-mode/scripts/model-selector.js --requested opus --available opus,sonnet,haiku --available-agents fable-orchestrator,fable-worker-sonnet,fable-worker-haiku --fallback stop --host-model opus --stage-brief "Synthesize the architecture" --pass-condition "ADR and dependency map exist" --verification-command "npm test" --verifier-result pending
+task
+  -> behavior profile
+  -> named role / agent
+  -> host adapter
+  -> advisory runtime floor
+  -> actual host-selected model
+  -> execute the SAME behavior contract
 ```
 
-The JSON result always records `requestedModel`, `effectiveModel`,
-`fallbackReason`, `stageBrief`, `passCondition`, `verificationCommand`, and
-`verifierResult`, plus available agents, status, agent, and escalation state. The
-CLI appends the same record as one JSON line to
-`.claude/harness-everything/state/fable-mode/audit.jsonl` (or the path supplied by
-`--audit-file`).
-
-If the requested model is unavailable, `--fallback inline` records the declared
-host model and a visible reason. `--fallback stop` emits `status: blocked`, a
-null effective model, and exit code 2. Neither path silently downgrades.
-
-The orchestrator still owns scope lock, at most two full replans, stage
-contracts, worker non-recursion, cold verification, and escalation. The native
-host TODO tracker or a Markdown checklist records stage progress; no CLI TODO
-state machine is part of this contract.
+`fable on haiku` normalizes to `mechanical`; `fable on sonnect` normalizes to `reasoning`; `fable on opus` normalizes to `orchestrator`. None of these aliases means switching the host to that branded model.
+
+The audit record uses `requestedProfile`, `effectiveProfile`, `profileAlias`, `assignedRole`, `runtimeModel`, `runtimeEffort`, `recommendedRuntimeFloor`, `runtimeFloorStatus`, and `runtimeFloorReason`, plus stage verification fields.
+
+A `below-recommended` or `unknown` runtime-floor result is advisory and does not block Fable. Missing named-agent capability is separate: the existing `inline` or `stop` fallback policy decides whether the same profile runs inline or the stage is blocked.
 
 See [execution phases](execution-phases.md) for the staged run contract.

package/fable-mode/references/profile-lookup.md

@@ -0,0 +1,19 @@
+# Profile lookup
+
+Use for explanation or a profile-only JSON record. No stage, audit-log mutation, delegation, or model switch is implied. Execution requests retain their selected workflow obligations.
+
+| Alias | Profile | Role | Named agent |
+|---|---|---|---|
+| haiku | mechanical | mechanical-worker | fable-worker-haiku |
+| sonnet / sonnect | reasoning | reasoning-worker | fable-worker-sonnet |
+| opus | orchestrator | orchestrator | fable-orchestrator |
+
+Preserve the input alias. Profiles describe behavior; the host chooses the actual runtime model. Report runtime fields as unknown when they were not supplied; never infer a model from an alias. Runtime floors are advisory, including unknown or below-recommended results.
+
+For a lookup, these fields suffice: `requestedProfile`, `effectiveProfile`, `profileAlias`, `assignedRole`, `runtimeModel`, `runtimeEffort`. If the user requests a computed floor comparison, read the relevant entry in `runtime-model-floor-matrix.json` and the resolution rules in [runtime-floor rules](model-matrix.md); use `scripts/model-selector.js` for a stage audit, not by reading its implementation for a lookup.
+
+Example for `fable on sonnect` with no supplied runtime:
+
+```json
+{"requestedProfile":"reasoning","effectiveProfile":"reasoning","profileAlias":"sonnect","assignedRole":"reasoning-worker","runtimeModel":null,"runtimeEffort":null}
+```

package/fable-mode/runtime-model-floor-matrix.json

@@ -0,0 +1,47 @@
+{
+  "schemaVersion": 1,
+  "policy": "advisory-floor",
+  "belowFloorDisposition": "continue-with-visible-status",
+  "hosts": {
+    "claude": {
+      "orchestrator": {
+        "family": "opus",
+        "minVersion": "5.5",
+        "minEffort": "medium",
+        "display": "Opus 5.5+ / medium+"
+      },
+      "reasoning": {
+        "family": "sonnet",
+        "minVersion": "5.5",
+        "minEffort": "medium",
+        "display": "Sonnet 5.5+ / medium+"
+      },
+      "mechanical": {
+        "family": "haiku",
+        "minVersion": "5.5",
+        "minEffort": null,
+        "display": "Haiku 5.5+"
+      }
+    },
+    "codex": {
+      "orchestrator": {
+        "family": "sol",
+        "minGeneration": 6,
+        "minEffort": "xhigh",
+        "display": "GPT-6 Sol+ / xhigh+"
+      },
+      "reasoning": {
+        "family": "sol",
+        "minGeneration": 6,
+        "minEffort": "medium",
+        "display": "GPT-6 Sol+ / medium+"
+      },
+      "mechanical": {
+        "family": "luna",
+        "minGeneration": 6,
+        "minEffort": "xhigh",
+        "display": "GPT-6 Luna 6+ / xhigh+"
+      }
+    }
+  }
+}