harness-everything 0.30.5 → 0.30.6

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.
Files changed (67) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/CHANGELOG.md +23 -0
  4. package/ci/fable-mode-test.js +112 -51
  5. package/ci/mechanism-2t-workspace-identity.test.js +3 -1
  6. package/ci/mechanism-2z-claude-plugin-manifest.test.js +12 -0
  7. package/ci/router-workflow-plan.test.js +92 -7
  8. package/docs/platform-capabilities.md +8 -0
  9. package/docs/workflows/fable-mode.md +10 -9
  10. package/evals/fable-mode/tasks/negative-tier2-no-model.yaml +3 -3
  11. package/evals/fable-mode/tasks/positive-haiku-mode.yaml +1 -1
  12. package/evals/fable-mode/tasks/positive-opus-mode.yaml +1 -1
  13. package/evals/fable-mode/tasks/positive-sonnet-mode.yaml +1 -1
  14. package/evals/fable-mode/tasks/positive-trigger.yaml +1 -1
  15. package/fable-mode/SKILL.md +18 -12
  16. package/fable-mode/agents/fable-orchestrator.md +7 -6
  17. package/fable-mode/agents/fable-verifier.md +1 -1
  18. package/fable-mode/agents/fable-worker-haiku.md +5 -4
  19. package/fable-mode/agents/fable-worker-sonnet.md +5 -4
  20. package/fable-mode/behavior-profile-matrix.json +36 -0
  21. package/fable-mode/execution-guardrails/SKILL.md +3 -6
  22. package/fable-mode/execution-guardrails/references/guardrail-rules.md +8 -9
  23. package/fable-mode/fable-haiku/SKILL.md +7 -5
  24. package/fable-mode/fable-haiku/references/routing-notes.md +2 -1
  25. package/fable-mode/fable-opus/SKILL.md +8 -6
  26. package/fable-mode/fable-sonnet/SKILL.md +8 -6
  27. package/fable-mode/model-matrix.json +7 -30
  28. package/fable-mode/references/model-matrix.md +35 -30
  29. package/fable-mode/references/profile-lookup.md +19 -0
  30. package/fable-mode/runtime-model-floor-matrix.json +47 -0
  31. package/fable-mode/scripts/model-selector.js +106 -60
  32. package/fable-mode/scripts/workflow-plan-consumer.js +1 -1
  33. package/harness-everything/SKILL.md +1 -1
  34. package/harness-everything/references/router-workflow-plan.md +2 -2
  35. package/harness-everything/schemas/router-task-shape.schema.json +3 -2
  36. package/harness-everything/schemas/router-workflow-plan.schema.json +6 -5
  37. package/harness-everything/scripts/router-contract-core.js +19 -12
  38. package/harness-everything/scripts/tier-router.js +100 -12
  39. package/opencode-plugin/plugin.json +1 -1
  40. package/package.json +1 -1
  41. package/plugins/harness-everything/.codex-plugin/plugin.json +1 -1
  42. package/plugins/harness-everything/plugin.json +1 -1
  43. package/plugins/harness-everything/skills/fable-mode/SKILL.md +18 -12
  44. package/plugins/harness-everything/skills/fable-mode/agents/fable-orchestrator.md +7 -6
  45. package/plugins/harness-everything/skills/fable-mode/agents/fable-verifier.md +1 -1
  46. package/plugins/harness-everything/skills/fable-mode/agents/fable-worker-haiku.md +5 -4
  47. package/plugins/harness-everything/skills/fable-mode/agents/fable-worker-sonnet.md +5 -4
  48. package/plugins/harness-everything/skills/fable-mode/behavior-profile-matrix.json +36 -0
  49. package/plugins/harness-everything/skills/fable-mode/execution-guardrails/SKILL.md +3 -6
  50. package/plugins/harness-everything/skills/fable-mode/execution-guardrails/references/guardrail-rules.md +8 -9
  51. package/plugins/harness-everything/skills/fable-mode/fable-haiku/SKILL.md +7 -5
  52. package/plugins/harness-everything/skills/fable-mode/fable-haiku/references/routing-notes.md +2 -1
  53. package/plugins/harness-everything/skills/fable-mode/fable-opus/SKILL.md +8 -6
  54. package/plugins/harness-everything/skills/fable-mode/fable-sonnet/SKILL.md +8 -6
  55. package/plugins/harness-everything/skills/fable-mode/model-matrix.json +7 -30
  56. package/plugins/harness-everything/skills/fable-mode/references/model-matrix.md +35 -30
  57. package/plugins/harness-everything/skills/fable-mode/references/profile-lookup.md +19 -0
  58. package/plugins/harness-everything/skills/fable-mode/runtime-model-floor-matrix.json +47 -0
  59. package/plugins/harness-everything/skills/fable-mode/scripts/model-selector.js +106 -60
  60. package/plugins/harness-everything/skills/fable-mode/scripts/workflow-plan-consumer.js +1 -1
  61. package/plugins/harness-everything/skills/harness-everything/SKILL.md +1 -1
  62. package/plugins/harness-everything/skills/harness-everything/references/router-workflow-plan.md +2 -2
  63. package/plugins/harness-everything/skills/harness-everything/schemas/router-task-shape.schema.json +3 -2
  64. package/plugins/harness-everything/skills/harness-everything/schemas/router-workflow-plan.schema.json +6 -5
  65. package/plugins/harness-everything/skills/harness-everything/scripts/router-contract-core.js +19 -12
  66. package/plugins/harness-everything/skills/harness-everything/scripts/tier-router.js +100 -12
  67. package/sbom.cdx.json +7 -7
@@ -1,39 +1,45 @@
1
1
  ---
2
2
  name: fable-mode
3
- 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."
3
+ 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."
4
4
  license: Apache-2.0
5
5
  metadata:
6
6
  author: Miya Daniel
7
- version: 0.30.2
7
+ version: 0.30.6
8
8
  ---
9
9
 
10
- # Fable Mode (v3)
10
+ # Fable Mode
11
11
 
12
12
  ## Skill Contract
13
13
 
14
14
  | Component | Specification |
15
15
  | :--- | :--- |
16
- | **Trigger / Input** | Tier 3 work spanning multiple files, sources, or sessions. |
17
- | **Expected Output** | Stage map, named-agent briefs, failable checks, and skeptical review. |
18
- | **State Mutations** | Native host TODO tracker or a Markdown checklist; one JSON audit record per stage. |
19
- | **Enforcement Gate** | `<this-skill-dir>/scripts/model-selector.js`, stage contracts, and `<skills-repo-root>/harness-everything/scripts/verify-gate.js`. |
16
+ | **Trigger / Input** | Profile lookup or Tier 3 execution. |
17
+ | **Expected Output** | Profile record or verified stages. |
18
+ | **State Mutations** | Execution only: stage checklist and audit records. |
19
+ | **Enforcement Gate** | Execution: `<this-skill-dir>/scripts/model-selector.js`, stage contracts, and `<skills-repo-root>/harness-everything/scripts/verify-gate.js`. |
20
20
 
21
21
  ## USE FOR:
22
22
  - Large multi-file, multi-source, or multi-session work
23
- - Explicit `fable on haiku`, `fable on sonnet`, or `fable on opus` requests
23
+ - Fable profile explanations or explicit Fable execution requests
24
24
  - Work needing named delegation and cold verification
25
25
 
26
26
  ## DO NOT USE FOR:
27
27
  - One obvious single-pass edit
28
28
  - Ordinary Tier 2 implementation or bugfix work
29
29
 
30
+ ## Select Operation First
31
+
32
+ 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.
33
+
34
+ Execution follows the workflow below.
35
+
30
36
  ## Workflow
31
37
 
32
38
  1. Discover the runtime and lock the authorized file scope before edits.
33
39
  2. Write a numbered stage map with one artifact and pass condition per stage; allow at most two full replans.
34
- 3. Resolve the requested model with `model-selector.js`; never silently downgrade.
35
- 4. Delegate by named agent where available: Opus orchestrates, Sonnet reasons, Haiku handles mechanical work, and workers never spawn workers.
36
- 5. Write a stage contract, run its named check, then cold-review high-stakes artifacts with `fable-verifier`.
37
- 6. Record requested/effective model, fallback reason, stage brief, pass condition, verification command, and verifier result for every stage. Escalate unresolved blockers.
40
+ 3. Resolve the requested behavior profile with `model-selector.js`; `opus`, `sonnet`/`sonnect`, and `haiku` are compatibility aliases, not model bindings.
41
+ 4. Delegate by profile: orchestrator coordinates, reasoning handles bounded judgment, mechanical handles low-ambiguity work, and workers never spawn workers.
42
+ 5. Treat the host runtime-model floor as advisory; record its status without blocking Fable solely for model choice.
43
+ 6. Run each stage check, cold-review high-stakes artifacts, and audit profile/runtime/fallback fields.
38
44
 
39
45
  Deep dive: <this-skill-dir>/references/model-matrix.md
@@ -2,7 +2,7 @@
2
2
  name: fable-orchestrator
3
3
  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.
4
4
  tools: Read, Grep, Glob, Bash, Task, TodoWrite
5
- model: opus
5
+ model: inherit
6
6
  ---
7
7
 
8
8
  You are the fable orchestrator. You coordinate; you do not produce. You have no
@@ -18,7 +18,7 @@ and delegate.
18
18
  When a structured Harness workflow plan is supplied, consume it; do not rebuild
19
19
  its topology from tier labels or keywords. Fable may consume only the selected
20
20
  strategy, parallelism constraints, verifier requirement, workspace/memory hints,
21
- limits, and requested-model metadata. The router does not spawn workers and
21
+ limits, and requested-profile metadata. The router does not spawn workers and
22
22
  Fable does not reclassify the task.
23
23
 
24
24
  - `fable-staged` — execute validated stages sequentially.
@@ -31,11 +31,12 @@ Fable does not reclassify the task.
31
31
  If the plan is blocked, deferred, direct-single, or iterative-single, do not
32
32
  silently coerce it into Fable. Return control to the caller with the plan reason.
33
33
 
34
- Before the first stage, resolve the requested model with
34
+ Before the first stage, resolve the requested behavior profile with
35
35
  `fable-mode/scripts/model-selector.js`. Carry its JSON record into every stage
36
- brief. The workflow-plan consumer must never substitute a branded model. A
37
- missing model must produce the model selector's explicit `fallback` or `blocked`
38
- status. Every brief and handoff names requested versus effective model.
36
+ brief. Profile aliases never pin a branded model. Host runtime-model floors are
37
+ advisory metadata: below-floor or unknown remains visible but does not change or
38
+ block the profile. Agent availability still uses explicit `inline`/`stop`
39
+ fallback. Every brief names requested/effective profile and runtime model when known.
39
40
 
40
41
  ## Core loop
41
42
 
@@ -2,7 +2,7 @@
2
2
  name: fable-verifier
3
3
  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.
4
4
  tools: Read, Grep, Glob, Bash
5
- model: haiku
5
+ model: inherit
6
6
  ---
7
7
 
8
8
  You are a cold verifier. You receive a spec and an artifact. You were
@@ -2,7 +2,7 @@
2
2
  name: fable-worker-haiku
3
3
  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.
4
4
  tools: Read, Write, Edit, Grep, Glob, Bash, WebSearch, WebFetch
5
- model: haiku
5
+ model: inherit
6
6
  ---
7
7
 
8
8
  You are a fable stage worker for mechanical tasks. You receive one bounded
@@ -27,9 +27,10 @@ Rules, in order:
27
27
  5. **Report format:** artifact path, check command, check output, blockers.
28
28
  Short.
29
29
 
30
- Include the mode audit fields in the report: requested model, effective model,
31
- fallback reason, stage brief, pass condition, verification command, and verifier
32
- result. A fallback or blocker must remain visible in the report.
30
+ Include the audit fields in the report: requested/effective profile, profile alias,
31
+ runtime model/effort, runtime-floor status, fallback reason, stage brief, pass
32
+ condition, verification command, and verifier result. A fallback or blocker must
33
+ remain visible in the report.
33
34
 
34
35
  Do not spawn subagents.
35
36
 
@@ -2,7 +2,7 @@
2
2
  name: fable-worker-sonnet
3
3
  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.
4
4
  tools: Read, Write, Edit, Grep, Glob, Bash, WebSearch, WebFetch
5
- model: sonnet
5
+ model: inherit
6
6
  ---
7
7
 
8
8
  You are a fable stage worker. You receive one bounded assignment: a specific
@@ -26,9 +26,10 @@ Rules of the loop, in order:
26
26
  4. **Report format:** artifact path, check command, check output, confirmed
27
27
  facts vs. inferences (labeled), leftovers/recommendations. Keep it short.
28
28
 
29
- Include the mode audit fields in the report: requested model, effective model,
30
- fallback reason, stage brief, pass condition, verification command, and verifier
31
- result. Preserve any `fallback` or `blocked` status from the selector.
29
+ Include the audit fields in the report: requested/effective profile, profile alias,
30
+ runtime model/effort, runtime-floor status, fallback reason, stage brief, pass
31
+ condition, verification command, and verifier result. Preserve any agent
32
+ `fallback` or `blocked` status from the selector.
32
33
 
33
34
  Do not spawn subagents. Escalate rather than guess: if the assignment needs
34
35
  synthesis beyond you or its requirements are contradictory, stop and return the
@@ -0,0 +1,36 @@
1
+ {
2
+ "schemaVersion": 2,
3
+ "profiles": {
4
+ "mechanical": {
5
+ "legacyAlias": "haiku",
6
+ "aliases": [
7
+ "mechanical",
8
+ "haiku"
9
+ ],
10
+ "role": "mechanical-worker",
11
+ "useFor": "bulk mechanical work, format conversion, boilerplate, structured extraction, and other low-ambiguity tasks",
12
+ "agent": "fable-worker-haiku"
13
+ },
14
+ "reasoning": {
15
+ "legacyAlias": "sonnet",
16
+ "aliases": [
17
+ "reasoning",
18
+ "sonnet",
19
+ "sonnect"
20
+ ],
21
+ "role": "reasoning-worker",
22
+ "useFor": "non-trivial implementation, research synthesis, analysis, document drafting, and bounded design reasoning",
23
+ "agent": "fable-worker-sonnet"
24
+ },
25
+ "orchestrator": {
26
+ "legacyAlias": "opus",
27
+ "aliases": [
28
+ "orchestrator",
29
+ "opus"
30
+ ],
31
+ "role": "orchestrator",
32
+ "useFor": "stage decomposition, dependency management, cross-stage synthesis, architecture, and high-stakes final decisions",
33
+ "agent": "fable-orchestrator"
34
+ }
35
+ }
36
+ }
@@ -1,13 +1,10 @@
1
1
  ---
2
2
  name: execution-guardrails
3
- description: >-
4
- Always-on guardrails: verify findings before flagging warnings, batch
5
- minor caveats, and anchor search-and-replace edits with post-write checks.
6
- Use when raising warnings or performing search-and-replace file edits.
3
+ description: "Reference guardrails for verified warnings and safe replacements; active carriers must inject them explicitly."
7
4
  license: Apache-2.0
8
5
  metadata:
9
6
  author: Miya Daniel
10
- version: 0.30.2
7
+ version: 0.30.6
11
8
  ---
12
9
 
13
10
  # Execution Guardrails
@@ -40,6 +37,6 @@ metadata:
40
37
 
41
38
  Repeated matching execution failures remain governed by Rule-of-3 / `zoom-out`; warning batching never substitutes for that recovery path.
42
39
 
43
- These rules are always-on, even when `fable-mode`'s staged loop is not running.
40
+ This nested file is reference-only, not an always-on carrier; rules apply only when an active carrier injects them.
44
41
 
45
42
  Deep dive: <this-skill-dir>/references/guardrail-rules.md
@@ -1,9 +1,8 @@
1
1
  # Guardrail Rules — Full Detail
2
2
 
3
- Three rules extracted from fable-mode's operational section so they apply everywhere,
4
- not only inside the staged loop. A frontier model doesn't need a stage map for a simple
5
- task, but it still needs these — they encode the user's preferences, and no model ships
6
- knowing them.
3
+ Three rules extracted from fable-mode's operational section so active carriers can reuse
4
+ them outside the staged loop. A frontier model doesn't need a stage map for a simple task,
5
+ but any carrier that relies on these rules must load, copy, or inject them explicitly.
7
6
 
8
7
  ## 1. Verify before flag
9
8
 
@@ -53,8 +52,8 @@ Preferred order of tools: IDE native structured replace tool (`replace_string_in
53
52
 
54
53
  ## Relationship to fable-mode
55
54
 
56
- fable-mode's staged loop is optional and gated on task size. These guardrails are not
57
- optional and not gated. When fable-mode runs, its step 4 (self-critique) and all file
58
- edits inherit these rules. When fable-mode doesn't run, these rules apply anyway. In v3
59
- the per-model runners route to frontmatter-defined agents (`agents/*.md`) whose system
60
- prompts carry these rules inline, because spawned agents cannot see this skill.
55
+ fable-mode's staged loop is optional and gated on task size. These rules are intended as
56
+ baseline execution guidance wherever an active carrier loads them, but this nested
57
+ reference is not itself automatically discovered or always-on. In v3 the per-model
58
+ flow routes to frontmatter-defined agents (`agents/*.md`) whose system prompts carry
59
+ the required rules inline, because spawned agents cannot see this reference file.
@@ -1,14 +1,16 @@
1
1
  ---
2
2
  name: fable-haiku
3
- description: "Run staged fable work on Haiku for bulk mechanical tasks with explicit pass conditions, visible fallback handling, and a cold verifier pass."
3
+ description: "Reference mechanical behavior profile (legacy alias haiku) for bulk low-ambiguity work with explicit checks and cold verification; runtime model choice is separate."
4
4
  license: Apache-2.0
5
5
  metadata:
6
6
  author: Miya Daniel
7
- version: 0.30.2
7
+ version: 0.30.6
8
8
  ---
9
9
 
10
10
  # Fable Mode — Haiku
11
11
 
12
+ > **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.
13
+
12
14
  ## Skill Contract
13
15
 
14
16
  | Component | Specification |
@@ -28,9 +30,9 @@ metadata:
28
30
 
29
31
  ## Run it
30
32
 
31
- 1. Resolve `haiku` through `<this-skill-dir>/../scripts/model-selector.js`.
32
- 2. Spawn `fable-worker-haiku` when available; otherwise use an inline fallback only when the audit record says so.
33
+ 1. Resolve legacy alias `haiku` to the `mechanical` behavior profile through `<this-skill-dir>/../scripts/model-selector.js`.
34
+ 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.
33
35
  3. Brief one bounded output path and a named check; workers do not spawn workers.
34
36
  4. Route synthesis blockers to Sonnet/Opus and cold-review unsupervised delivery with `fable-verifier`.
35
37
 
36
- Use `<this-skill-dir>/../references/model-matrix.md` for the audit fields and fallback policy.
38
+ Use `<this-skill-dir>/../references/model-matrix.md` for behavior-profile aliases, runtime floors, audit fields, and fallback policy.
@@ -6,7 +6,8 @@ Details moved from SKILL.md.
6
6
 
7
7
  The worker is a real agent definition (`../agents/fable-worker-haiku.md`)
8
8
  invoked by name. Its system prompt carries the loop, the tightened verification
9
- rule, and the operational rules; this skill only routes.
9
+ rule, and the operational rules; this reference profile documents the route used after
10
+ `fable-mode` selects Haiku.
10
11
 
11
12
  ## Full run procedure
12
13
 
@@ -1,14 +1,16 @@
1
1
  ---
2
2
  name: fable-opus
3
- 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."
3
+ description: "Reference orchestrator behavior profile (legacy alias opus) for staged synthesis, architecture, named delegation, and cold verification; runtime model choice is separate."
4
4
  license: Apache-2.0
5
5
  metadata:
6
6
  author: Miya Daniel
7
- version: 0.30.2
7
+ version: 0.30.6
8
8
  ---
9
9
 
10
10
  # Fable Mode — Opus
11
11
 
12
+ > **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.
13
+
12
14
  ## Skill Contract
13
15
 
14
16
  | Component | Specification |
@@ -24,13 +26,13 @@ metadata:
24
26
 
25
27
  ## DO NOT USE FOR:
26
28
  - One obvious single-pass task
27
- - Bulk mechanical work (use `fable-haiku`) or bounded reasoning (use `fable-sonnet`)
29
+ - Bulk mechanical work (select `fable on haiku`) or bounded reasoning (select `fable on sonnet`)
28
30
 
29
31
  ## Run it
30
32
 
31
- 1. Resolve `opus` through `<this-skill-dir>/../scripts/model-selector.js`.
32
- 2. Spawn `fable-orchestrator` when the runtime exposes it; otherwise report the inline fallback explicitly.
33
+ 1. Resolve legacy alias `opus` to the `orchestrator` behavior profile through `<this-skill-dir>/../scripts/model-selector.js`.
34
+ 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.
33
35
  3. The orchestrator owns scope lock, at most two replans, stage contracts, named worker delegation, and escalation; it never produces artifacts itself.
34
36
  4. Cold-review high-stakes deliverables with `fable-verifier`; report every unverified stage.
35
37
 
36
- Use `<this-skill-dir>/../references/model-matrix.md` for the audit fields and fallback policy.
38
+ Use `<this-skill-dir>/../references/model-matrix.md` for behavior-profile aliases, runtime floors, audit fields, and fallback policy.
@@ -1,14 +1,16 @@
1
1
  ---
2
2
  name: fable-sonnet
3
- description: "Run staged fable work on Sonnet for non-trivial implementation, research synthesis, or bounded reasoning with explicit pass conditions and visible fallback handling."
3
+ description: "Reference reasoning behavior profile (legacy alias sonnet/sonnect) for non-trivial implementation, synthesis, and bounded judgment; runtime model choice is separate."
4
4
  license: Apache-2.0
5
5
  metadata:
6
6
  author: Miya Daniel
7
- version: 0.30.2
7
+ version: 0.30.6
8
8
  ---
9
9
 
10
10
  # Fable Mode — Sonnet
11
11
 
12
+ > **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.
13
+
12
14
  ## Skill Contract
13
15
 
14
16
  | Component | Specification |
@@ -24,13 +26,13 @@ metadata:
24
26
 
25
27
  ## DO NOT USE FOR:
26
28
  - One obvious single-pass task
27
- - Macro orchestration or final high-stakes decisions (use `fable-opus`)
29
+ - Macro orchestration or final high-stakes decisions (select `fable on opus`)
28
30
 
29
31
  ## Run it
30
32
 
31
- 1. Resolve `sonnet` through `<this-skill-dir>/../scripts/model-selector.js`; normalize `sonnect` to Sonnet.
32
- 2. Spawn `fable-worker-sonnet` when available, otherwise use a visible inline fallback.
33
+ 1. Resolve `sonnet` or `sonnect` to the `reasoning` behavior profile through `<this-skill-dir>/../scripts/model-selector.js`.
34
+ 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.
33
35
  3. Brief the exact artifact path, context, and pass condition; workers do not spawn workers.
34
36
  4. Send high-stakes artifacts to `fable-verifier` and escalate contradictions instead of guessing.
35
37
 
36
- Use `<this-skill-dir>/../references/model-matrix.md` for the audit fields and fallback policy.
38
+ Use `<this-skill-dir>/../references/model-matrix.md` for behavior-profile aliases, runtime floors, audit fields, and fallback policy.
@@ -1,32 +1,9 @@
1
1
  {
2
- "schemaVersion": 1,
3
- "modes": {
4
- "haiku": {
5
- "role": "bulk mechanical / format conversion",
6
- "agent": "fable-worker-haiku",
7
- "aliases": ["haiku"]
8
- },
9
- "sonnet": {
10
- "role": "non-trivial implementation / research synthesis / bounded stage reasoning",
11
- "agent": "fable-worker-sonnet",
12
- "aliases": ["sonnet", "sonnect"]
13
- },
14
- "opus": {
15
- "role": "macro orchestration / cross-stage synthesis / high-stakes architecture and final decision",
16
- "agent": "fable-orchestrator",
17
- "aliases": ["opus"]
18
- }
19
- },
20
- "fallbacks": {
21
- "inline": {
22
- "status": "fallback",
23
- "effectiveModel": "host-model",
24
- "reason": "requested model is unavailable; run inline on the declared host model"
25
- },
26
- "stop": {
27
- "status": "blocked",
28
- "effectiveModel": null,
29
- "reason": "requested model is unavailable and inline fallback was not authorized"
30
- }
31
- }
2
+ "schemaVersion": 2,
3
+ "deprecated": true,
4
+ "replacedBy": [
5
+ "behavior-profile-matrix.json",
6
+ "runtime-model-floor-matrix.json"
7
+ ],
8
+ "note": "Fable profiles define behavior and role assignment. Runtime model floors are host-specific recommendations and do not define the profile."
32
9
  }
@@ -1,41 +1,46 @@
1
- # Fable model matrix and execution audit
1
+ # Fable behavior profiles and runtime model floors
2
2
 
3
- Issue #27 defines three explicit execution modes. The mode selector is the
4
- machine-readable gate; this document is the human-facing contract.
3
+ 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.
5
4
 
6
- | Mode | Use for | Named agent |
7
- |---|---|---|
8
- | Haiku | Bulk mechanical work and format conversion | `fable-worker-haiku` |
9
- | Sonnet | Non-trivial implementation, research synthesis, bounded reasoning | `fable-worker-sonnet` |
10
- | Opus | Macro orchestration, cross-stage synthesis, high-stakes architecture and final decisions | `fable-orchestrator` |
5
+ ## Behavior Profile Matrix
6
+
7
+ | Canonical profile | Legacy alias | Role | Typical work | Named agent |
8
+ |---|---|---|---|---|
9
+ | `mechanical` | `haiku` | Mechanical worker | Bulk edits, format conversion, boilerplate, structured extraction | `fable-worker-haiku` |
10
+ | `reasoning` | `sonnet` / `sonnect` | Reasoning worker | Non-trivial implementation, research synthesis, analysis, bounded design | `fable-worker-sonnet` |
11
+ | `orchestrator` | `opus` | Orchestrator | Stage decomposition, dependency management, cross-stage synthesis, architecture/final decisions | `fable-orchestrator` |
12
+ | verifier | — | Cold reviewer | Spec-versus-artifact checks and independent re-verification | `fable-verifier` |
13
+
14
+ The machine-readable source is `fable-mode/behavior-profile-matrix.json`.
15
+
16
+ ## Runtime Model Floor Matrix
11
17
 
12
- Use the explicit entrypoints `fable-haiku`, `fable-sonnet`, and `fable-opus`.
13
- The accepted input `sonnect` normalizes to Sonnet. A normal Tier 2 prompt does
14
- not select a fable model.
18
+ 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.
15
19
 
16
- ## Deterministic selection
20
+ | Fable profile | Claude recommended floor | Codex recommended floor |
21
+ |---|---|---|
22
+ | `orchestrator` | Opus 5.5+ / medium+ | GPT-6 Sol+ / xhigh+ |
23
+ | `reasoning` | Sonnet 5.5+ / medium+ | GPT-6 Sol+ / medium+ |
24
+ | `mechanical` | Haiku 5.5+ | GPT-6 Luna 6+ / xhigh+ |
25
+
26
+ 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.
17
27
 
18
- Before each stage, run `fable-mode/scripts/model-selector.js` with the requested
19
- mode, the runtime's available modes, the host model, and the stage contract:
28
+ ## Resolution
20
29
 
21
30
  ```text
22
- 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
31
+ task
32
+ -> behavior profile
33
+ -> named role / agent
34
+ -> host adapter
35
+ -> advisory runtime floor
36
+ -> actual host-selected model
37
+ -> execute the SAME behavior contract
23
38
  ```
24
39
 
25
- The JSON result always records `requestedModel`, `effectiveModel`,
26
- `fallbackReason`, `stageBrief`, `passCondition`, `verificationCommand`, and
27
- `verifierResult`, plus available agents, status, agent, and escalation state. The
28
- CLI appends the same record as one JSON line to
29
- `.claude/harness-everything/state/fable-mode/audit.jsonl` (or the path supplied by
30
- `--audit-file`).
31
-
32
- If the requested model is unavailable, `--fallback inline` records the declared
33
- host model and a visible reason. `--fallback stop` emits `status: blocked`, a
34
- null effective model, and exit code 2. Neither path silently downgrades.
35
-
36
- The orchestrator still owns scope lock, at most two full replans, stage
37
- contracts, worker non-recursion, cold verification, and escalation. The native
38
- host TODO tracker or a Markdown checklist records stage progress; no CLI TODO
39
- state machine is part of this contract.
40
+ `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.
41
+
42
+ The audit record uses `requestedProfile`, `effectiveProfile`, `profileAlias`, `assignedRole`, `runtimeModel`, `runtimeEffort`, `recommendedRuntimeFloor`, `runtimeFloorStatus`, and `runtimeFloorReason`, plus stage verification fields.
43
+
44
+ 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.
40
45
 
41
46
  See [execution phases](execution-phases.md) for the staged run contract.
@@ -0,0 +1,19 @@
1
+ # Profile lookup
2
+
3
+ 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.
4
+
5
+ | Alias | Profile | Role | Named agent |
6
+ |---|---|---|---|
7
+ | haiku | mechanical | mechanical-worker | fable-worker-haiku |
8
+ | sonnet / sonnect | reasoning | reasoning-worker | fable-worker-sonnet |
9
+ | opus | orchestrator | orchestrator | fable-orchestrator |
10
+
11
+ 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.
12
+
13
+ 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.
14
+
15
+ Example for `fable on sonnect` with no supplied runtime:
16
+
17
+ ```json
18
+ {"requestedProfile":"reasoning","effectiveProfile":"reasoning","profileAlias":"sonnect","assignedRole":"reasoning-worker","runtimeModel":null,"runtimeEffort":null}
19
+ ```
@@ -0,0 +1,47 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "policy": "advisory-floor",
4
+ "belowFloorDisposition": "continue-with-visible-status",
5
+ "hosts": {
6
+ "claude": {
7
+ "orchestrator": {
8
+ "family": "opus",
9
+ "minVersion": "5.5",
10
+ "minEffort": "medium",
11
+ "display": "Opus 5.5+ / medium+"
12
+ },
13
+ "reasoning": {
14
+ "family": "sonnet",
15
+ "minVersion": "5.5",
16
+ "minEffort": "medium",
17
+ "display": "Sonnet 5.5+ / medium+"
18
+ },
19
+ "mechanical": {
20
+ "family": "haiku",
21
+ "minVersion": "5.5",
22
+ "minEffort": null,
23
+ "display": "Haiku 5.5+"
24
+ }
25
+ },
26
+ "codex": {
27
+ "orchestrator": {
28
+ "family": "sol",
29
+ "minGeneration": 6,
30
+ "minEffort": "xhigh",
31
+ "display": "GPT-6 Sol+ / xhigh+"
32
+ },
33
+ "reasoning": {
34
+ "family": "sol",
35
+ "minGeneration": 6,
36
+ "minEffort": "medium",
37
+ "display": "GPT-6 Sol+ / medium+"
38
+ },
39
+ "mechanical": {
40
+ "family": "luna",
41
+ "minGeneration": 6,
42
+ "minEffort": "xhigh",
43
+ "display": "GPT-6 Luna 6+ / xhigh+"
44
+ }
45
+ }
46
+ }
47
+ }