loadout-ai 0.7.0 → 0.8.0

package/dist/src/core/routing/route.js

@@ -4,17 +4,8 @@
 // Prices as of August 2026.
 export const MODEL_CATALOG = [
     // --- Anthropic (Claude Code) ---
-    {
-        id: "claude-fable-5",
-        provider: "anthropic",
-        name: "Claude Fable 5",
-        tier: "frontier",
-        inputCostPer1M: 10,
-        outputCostPer1M: 50,
-        nativeAgents: ["claude-code"],
-        current: true,
-        generation: "5",
-    },
+    // Haiku and the 4.x line are deliberately absent: for real coding work the
+    // choice is Opus or Sonnet, and offering a weaker tier invites picking it.
     {
         id: "claude-opus-5",
         provider: "anthropic",
@@ -37,51 +28,7 @@ export const MODEL_CATALOG = [
         current: true,
         generation: "5",
     },
-    {
-        id: "claude-opus-4-8",
-        provider: "anthropic",
-        name: "Claude Opus 4.8",
-        tier: "frontier",
-        inputCostPer1M: 5,
-        outputCostPer1M: 25,
-        nativeAgents: ["claude-code"],
-        current: false,
-        generation: "4",
-    },
-    {
-        id: "claude-opus-4-6",
-        provider: "anthropic",
-        name: "Claude Opus 4.6",
-        tier: "frontier",
-        inputCostPer1M: 5,
-        outputCostPer1M: 25,
-        nativeAgents: ["claude-code"],
-        current: false,
-        generation: "4",
-    },
-    {
-        id: "claude-sonnet-4-6",
-        provider: "anthropic",
-        name: "Claude Sonnet 4.6",
-        tier: "standard",
-        inputCostPer1M: 3,
-        outputCostPer1M: 15,
-        nativeAgents: ["claude-code"],
-        current: false,
-        generation: "4",
-    },
-    {
-        id: "claude-haiku-4-5",
-        provider: "anthropic",
-        name: "Claude Haiku 4.5",
-        tier: "fast",
-        inputCostPer1M: 1,
-        outputCostPer1M: 5,
-        nativeAgents: ["claude-code"],
-        current: true,
-        generation: "4",
-    },
-    // --- OpenAI (Codex) — GPT-5.6 family ---
+    // --- OpenAI (Codex) — the current GPT-5.6 tiers only ---
     {
         id: "gpt-5.6-sol",
         provider: "openai",
@@ -115,98 +62,6 @@ export const MODEL_CATALOG = [
         current: true,
         generation: "5.6",
     },
-    // --- OpenAI — GPT-5.5 ---
-    {
-        id: "gpt-5.5",
-        provider: "openai",
-        name: "GPT-5.5",
-        tier: "frontier",
-        inputCostPer1M: 5,
-        outputCostPer1M: 30,
-        nativeAgents: ["codex"],
-        current: true,
-        generation: "5.5",
-    },
-    // --- OpenAI — GPT-5.4 family ---
-    {
-        id: "gpt-5.4",
-        provider: "openai",
-        name: "GPT-5.4",
-        tier: "standard",
-        inputCostPer1M: 2.5,
-        outputCostPer1M: 15,
-        nativeAgents: ["codex"],
-        current: true,
-        generation: "5.4",
-    },
-    {
-        id: "gpt-5.4-mini",
-        provider: "openai",
-        name: "GPT-5.4 Mini",
-        tier: "fast",
-        inputCostPer1M: 0.75,
-        outputCostPer1M: 4.5,
-        nativeAgents: ["codex"],
-        current: true,
-        generation: "5.4",
-    },
-    // --- OpenAI — Codex-specific ---
-    {
-        id: "gpt-5.1-codex",
-        provider: "openai",
-        name: "GPT-5.1 Codex",
-        tier: "standard",
-        inputCostPer1M: 1.25,
-        outputCostPer1M: 10,
-        nativeAgents: ["codex"],
-        current: true,
-        generation: "5.1",
-    },
-    // --- OpenAI — o-series reasoning ---
-    {
-        id: "o3-pro",
-        provider: "openai",
-        name: "o3-pro",
-        tier: "frontier",
-        inputCostPer1M: 20,
-        outputCostPer1M: 80,
-        nativeAgents: ["codex"],
-        current: true,
-        generation: "o3",
-    },
-    {
-        id: "o3",
-        provider: "openai",
-        name: "o3",
-        tier: "frontier",
-        inputCostPer1M: 2,
-        outputCostPer1M: 8,
-        nativeAgents: ["codex"],
-        current: true,
-        generation: "o3",
-    },
-    {
-        id: "o4-mini",
-        provider: "openai",
-        name: "o4-mini",
-        tier: "standard",
-        inputCostPer1M: 1.1,
-        outputCostPer1M: 4.4,
-        nativeAgents: ["codex"],
-        current: true,
-        generation: "o4",
-    },
-    {
-        id: "o3-mini",
-        provider: "openai",
-        name: "o3-mini",
-        tier: "standard",
-        inputCostPer1M: 1.1,
-        outputCostPer1M: 4.4,
-        nativeAgents: ["codex"],
-        current: true,
-        generation: "o3",
-    },
 ];
 const TIER_LABELS = {
     frontier: "Frontier (deep reasoning)",
@@ -435,11 +290,28 @@ export function formatRouteRecommendation(rec, context = {}) {
     const { available, missing } = checked
         ? resolveAvailableAgents(rec.suggestedAgents, context.installedAgents)
         : { available: rec.suggestedAgents, missing: [] };
-    // Only recommend models an available agent can actually run.
+    // Only recommend models an available agent can actually run. Not every
+    // provider offers every tier — Claude Code has no fast tier — so when the
+    // recommended tier holds nothing the user can reach, step up to the nearest
+    // tier that does rather than naming a model they cannot run.
     const runnable = checked
         ? modelsRunnableBy(rec.models, available)
         : rec.models;
-    const shown = (runnable.length ? runnable : rec.models).slice(0, 4);
+    const stepUp = {
+        fast: "standard",
+        standard: "frontier",
+    };
+    let effective = runnable;
+    let tier = rec.tier;
+    let substituted;
+    while (checked && available.length && !effective.length && stepUp[tier]) {
+        const next = stepUp[tier];
+        effective = modelsRunnableBy(modelsForTier(next), available);
+        if (effective.length)
+            substituted = { from: rec.tier, to: next };
+        tier = next;
+    }
+    const shown = (effective.length ? effective : rec.models).slice(0, 4);
     const modelNames = shown.map((m) => `${m.name} ($${m.inputCostPer1M}/$${m.outputCostPer1M})`);
     const lines = [
         `Phase:    ${rec.phase}`,
@@ -448,6 +320,8 @@ export function formatRouteRecommendation(rec, context = {}) {
         `Agents:   ${available.length ? available.join(", ") : "none detected"}${missing.length ? `  (not installed: ${missing.join(", ")})` : ""}`,
         `Why:      ${rec.reason}`,
     ];
+    if (substituted)
+        lines.push(`Note:     your agents have no ${substituted.from}-tier model, so this shows`, `          the ${substituted.to} tier instead.`);
     if (rec.conserveAlternative) {
         const alt = rec.conserveAlternative;
         const altCheapest = cheapestInTier(alt.tier);
@@ -456,9 +330,7 @@ export function formatRouteRecommendation(rec, context = {}) {
     // Actionable next step: hand this task to a detected agent.
     if (context.description && available.length) {
         const target = available[0];
-        lines.push(``, `Hand off:`, `  loadout handoff send ${target} ${shellQuote(context.description)}`);
-        if (context.handoffReady === false)
-            lines.push(`  (run \`loadout handoff init\` once to enable)`);
+        lines.push(``, `Hand off:`, `  loadout handoff ${target} ${shellQuote(context.description)}`);
     }
     return lines.join("\n");
 }

package/docs/CANDIDATE_INTELLIGENCE.md

@@ -93,10 +93,16 @@ powers, platform behavior, category, and catalog policy.
 
 ## Distribute a trusted catalog release
 
-Maintainers sign a technically screened full catalog array with an Ed25519 key kept outside the
+> **Not implemented.** The signing flow below is a design sketch. `loadout keygen`,
+> `loadout catalog-sign`, and `loadout catalog-update` do not exist in the CLI
+> today; the catalog ships in the package and is verified by the evidence gate
+> instead. Kept here as the intended shape, not as instructions.
+
+Maintainers would sign a technically screened full catalog array with an Ed25519 key kept outside the
 repository:
 
 ```bash
+# Design sketch — these commands do not exist yet.
 loadout keygen --private-key /secure/catalog-private.pem \
   --public-key ./catalog-public.pem
 loadout catalog-sign --catalog ./catalog/packages.json \
@@ -104,9 +110,10 @@ loadout catalog-sign --catalog ./catalog/packages.json \
   --output ./catalog.signed.json
 ```
 
-Users preview the verified release before trusting it:
+Users would preview the verified release before trusting it:
 
 ```bash
+# Design sketch — these commands do not exist yet.
 loadout catalog-update --source ./catalog.signed.json \
   --public-key ./catalog-public.pem
 loadout catalog-update --source ./catalog.signed.json \

package/docs/CATALOG.md

@@ -12,7 +12,7 @@ Thank you to every maintainer and contributor whose work appears here. Loadout d
 - **License** is the SPDX identifier recorded in `catalog/packages.json` from GitHub metadata. **Review required** corresponds to `NOASSERTION`: no SPDX identifier was reported, so users must inspect the upstream terms instead of assuming permission.
 - **Reviewed revision** links to the immutable commit inspected for catalog admission. It is not necessarily the newest upstream commit.
 
-The machine-readable catalog remains the source of truth. Run `loadout catalog --coverage --json` to inspect coverage and `loadout capabilities` to inspect what each local agent adapter can actually manage.
+The machine-readable catalog remains the source of truth. Run `loadout catalog --coverage --json` to inspect coverage and `loadout doctor --verbose` to inspect what each local agent adapter can actually manage.
 
 ## All 53 credited repositories
 

package/docs/CREDENTIAL_AND_UPDATE_POLICY.md

@@ -26,6 +26,6 @@ verification restores the snapshot and quarantines the candidate commit. A user
 revoke a policy at any time; revocation prevents future mutations but never deletes
 existing snapshots.
 
-The local `loadout canary` command implements the non-mutating static gate. A
+Update safety runs as a non-mutating static gate during `loadout upgrade` previews. A
 transaction layer must provide verification and promotion callbacks before a
 candidate can be promoted; the command itself never installs a candidate.