fix(commands): wire profile phase_models into spawn-site model resolution

commands/trekreview.md

@@ -92,10 +92,12 @@ as the file is parseable:
 ```bash
 node ${CLAUDE_PLUGIN_ROOT}/lib/validators/brief-validator.mjs --soft --json "{brief_path}"
 
-# v5.1.1 — resolve the review-phase brief signal. The JSON is captured as
+# v5.9 — composed phase-model resolution (brief > profile > default) for the
+# review phase. ONE call returns {effort, model, source}; captured as
 # phase_signal_result and used in Phase 7 at the reviewer-launch site to
-# inject the brief-resolved model.
-node ${CLAUDE_PLUGIN_ROOT}/lib/profiles/phase-signal-resolver.mjs --brief "{brief_path}" --phase review --json
+# inject the resolved model. Append --profile {profile} when the operator
+# passed --profile.
+node ${CLAUDE_PLUGIN_ROOT}/lib/profiles/resolver.mjs --resolve-phase-model --phase review --brief-path "{brief_path}" [--profile {profile}] --json
 ```
 
 Read the JSON output. If `valid: false` AND any error has code
@@ -420,7 +422,7 @@ the contract for that handover (see `docs/HANDOVER-CONTRACTS.md`).
 
 ## Profile (v4.1)
 
-Accepts `--profile <name>` where `<name>` is `economy`, `balanced`, `premium`,
+Accepts `--profile <name>` where `<name>` is `economy`, `balanced`, `premium`, `fable`,
 or a custom profile under `voyage-profiles/`. Default: `premium`.
 
 Resolution order (per `lib/profiles/resolver.mjs`):
@@ -452,13 +454,15 @@ model_for_phase  = brief.phase_signals[<phase>]?.model  ?? profile.phase_models[
 ```
 
 The brief signal wins per-phase when present; the profile fills any
-gaps. Composition is mechanically resolved via
-`node ${CLAUDE_PLUGIN_ROOT}/lib/profiles/phase-signal-resolver.mjs`
-invoked in Phase 2; the resolved JSON is captured as `phase_signal_result`
-and passed to `Agent` tool calls explicitly. The resolver controls only
-the orchestrator and the model parameter at Agent-spawn sites — sub-agents
-otherwise read `model:` from their own `agents/*.md` frontmatter (still
-pinned to `opus`).
+gaps. Both fields are mechanically resolved by the single composed CLI
+`node ${CLAUDE_PLUGIN_ROOT}/lib/profiles/resolver.mjs --resolve-phase-model`
+invoked in Phase 2; the resolved JSON `{effort, model, source}` is captured
+as `phase_signal_result` and passed to `Agent` tool calls explicitly. The
+resolver controls the `model` parameter at Agent-spawn sites only — the
+orchestrator's own model is fixed at invocation time (command frontmatter
+omits `model:`, so it follows the session model) and cannot be switched
+mid-turn. Sub-agents fall back to `model:` in their own `agents/*.md`
+frontmatter when no spawn-site injection happens.
 
 For `/trekreview` specifically: `effort == 'low'` activates the existing
 `--quick`-equivalent code-path (skip the brief-conformance reviewer; run
@@ -515,10 +519,11 @@ Low effort: skip the brief-conformance reviewer entirely (existing
   `findings:\n  - a\n  - b`.
 - **Refuse-with-suggestion above 100 files / 100K tokens.** Never run
   blind on a giant diff. Use AskUserQuestion to surface the gate.
-- **Cost.** Sub-agents use their pinned `model:` frontmatter (currently `opus`).
-  When `phase_signals[<phase>].model` is set, the orchestrator AND Agent-spawn
-  sites use the resolved model (`phase_signal_result.model`) for that phase.
-  Frontmatter is the default; brief signal is the per-phase override.
+- **Cost.** Model resolution at Agent-spawn sites is a three-layer fallback:
+  brief `phase_signals[<phase>].model` > `profile.phase_models[<phase>]` >
+  agent frontmatter `model:`. The composed resolver returns the first two
+  layers as `phase_signal_result.model`; spawn sites inject it, and agent
+  frontmatter is the fallback when no injection happens.
 - **Privacy.** Never log secrets, tokens, or credentials in review.md.
   Findings citing files with secret-like content must redact the secret
   in the `detail` field.