@opengsd/gsd-core 1.4.3 → 1.4.5

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gsd-core",
   "displayName": "GSD Core",
-  "version": "1.4.3",
+  "version": "1.4.5",
   "description": "GSD Core is a meta-prompting, context engineering, and spec-driven development system for AI coding agents.",
   "author": {
     "name": "open-gsd",

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-core",
-  "version": "1.4.3",
+  "version": "1.4.5",
   "description": "GSD Core — a meta-prompting, context engineering, and spec-driven development system for AI coding agents. Loads gsd's operating context into every Gemini CLI session.",
   "contextFileName": "GEMINI.md"
 }

package/gsd-core/bin/lib/core.cjs

@@ -1283,6 +1283,7 @@ function _warnUnknownProfileOverrides(parsed, configLabel) {
 // between cases that intentionally exercise the warning path repeatedly.
 function _resetRuntimeWarningCacheForTests() {
     _warnedConfigKeys.clear();
+    _modelPolicyUnmappableWarned.clear();
 }
 /**
  * #2517 — Resolve the runtime-aware tier entry for (runtime, tier).
@@ -1312,6 +1313,26 @@ function _resolveRuntimeTier(config, tier) {
         overrides: config['model_profile_overrides'],
     });
 }
+// Reverse of the Claude tier-default IDs, plus the Fable alias which Claude
+// Code's Agent tool accepts but which is not a GSD model-profile tier (#1133).
+const CLAUDE_POLICY_ID_TO_ALIAS = {
+    ...Object.fromEntries(Object.entries(model_catalog_cjs_1.MODEL_ALIAS_MAP)
+        .filter((e) => typeof e[1] === 'string')
+        .map(([aliasName, id]) => [id, aliasName])),
+    'claude-fable-5': 'fable',
+};
+const CLAUDE_AGENT_ALIASES = new Set(['opus', 'sonnet', 'haiku', 'fable']);
+// Dedupe stderr warnings so repeated agent resolutions don't spam (#1133).
+const _modelPolicyUnmappableWarned = new Set();
+function warnModelPolicyUnmappable(agentType, policyModel, tier) {
+    const key = `${agentType}::${policyModel}::${tier}`;
+    if (_modelPolicyUnmappableWarned.has(key))
+        return;
+    _modelPolicyUnmappableWarned.add(key);
+    // MUST go to stderr — resolve-model's JSON result is parsed from stdout.
+    process.stderr.write(`gsd: warning — model_policy resolved "${policyModel}" for ${agentType}, ` +
+        `but it has no Claude agent alias; using "${tier}" instead.\n`);
+}
 /**
  * #49 — Provider-neutral model policy preset resolution.
  */
@@ -1389,15 +1410,32 @@ function resolveModelInternal(cwd, agentType) {
         : (profile === 'inherit'
             ? 'inherit'
             : (agentModels ? (agentModels[profile] || agentModels['balanced']) : null));
-    // 2.5. model_policy preset (#49)
+    // 2.5. model_policy preset (#49, #1133)
     const configRuntime = config['runtime'];
-    if (configRuntime && configRuntime !== 'claude' && tier && tier !== 'inherit') {
+    if (tier && tier !== 'inherit') {
+        const onClaude = !configRuntime || configRuntime === 'claude';
+        const effectiveRuntime = configRuntime || 'claude';
         const mergedPolicy = config['model_policy']
-            ? { ...config['model_policy'], runtime: configRuntime }
+            ? { ...config['model_policy'], runtime: effectiveRuntime }
             : null;
         const policyModel = resolveModelPolicy(mergedPolicy, tier);
-        if (policyModel)
-            return policyModel;
+        if (policyModel) {
+            // Non-Claude runtimes take full model IDs verbatim (unchanged behavior).
+            if (!onClaude)
+                return policyModel;
+            // Claude Code's Agent tool takes tier aliases (opus/sonnet/haiku/fable),
+            // not full model IDs — map the policy-resolved ID back to an alias (#1133).
+            const aliasForId = CLAUDE_POLICY_ID_TO_ALIAS[policyModel];
+            if (aliasForId)
+                return aliasForId;
+            // The policy value may already be a bare Claude agent alias (e.g. "fable").
+            if (CLAUDE_AGENT_ALIASES.has(policyModel))
+                return policyModel;
+            // No Claude alias for this ID (e.g. a pinned minor version like
+            // claude-opus-4-5). Warn once and fall through to the tier alias rather
+            // than returning an ID Claude Code cannot spawn.
+            warnModelPolicyUnmappable(agentType, policyModel, tier);
+        }
     }
     // 3. Runtime-aware resolution (#2517)
     if (configRuntime && configRuntime !== 'claude' && tier && tier !== 'inherit') {

package/gsd-core/bin/shared/model-catalog.json

@@ -89,6 +89,11 @@
       "sonnet": { "low": { "model": "claude-haiku-4-5" }, "medium": { "model": "claude-sonnet-4-6" }, "high": { "model": "claude-opus-4-8" } },
       "haiku":  { "low": { "model": "claude-haiku-4-5" }, "medium": { "model": "claude-haiku-4-5" }, "high": { "model": "claude-sonnet-4-6" } }
     },
+    "anthropic-fable": {
+      "opus":   { "low": { "model": "claude-opus-4-5" }, "medium": { "model": "claude-opus-4-8" }, "high": { "model": "claude-fable-5" } },
+      "sonnet": { "low": { "model": "claude-haiku-4-5" }, "medium": { "model": "claude-sonnet-4-6" }, "high": { "model": "claude-fable-5" } },
+      "haiku":  { "low": { "model": "claude-haiku-4-5" }, "medium": { "model": "claude-haiku-4-5" }, "high": { "model": "claude-sonnet-4-6" } }
+    },
     "openai": {
       "opus":   { "low": { "model": "gpt-5.3-codex", "reasoning_effort": "medium" }, "medium": { "model": "gpt-5.5", "reasoning_effort": "high" }, "high": { "model": "gpt-5.5", "reasoning_effort": "xhigh" } },
       "sonnet": { "low": { "model": "gpt-5.4-mini", "reasoning_effort": "low" }, "medium": { "model": "gpt-5.3-codex", "reasoning_effort": "medium" }, "high": { "model": "gpt-5.5", "reasoning_effort": "medium" } },

package/gsd-core/workflows/settings-advanced.md

@@ -84,7 +84,7 @@ Runtime Model Tiers:
 - `model_profile_overrides.<runtime>.haiku` (default: built-in for the runtime, or absent)
 
 Model Policy:
-- `model_policy.provider` (default: `null` — known values: anthropic, openai, google, qwen)
+- `model_policy.provider` (default: `null` — known values: anthropic, anthropic-fable, openai, google, qwen)
 - `model_policy.budget` (default: `null` — known values: high, medium, low)
 - `model_policy.high` (default: `null` — model ID for the high-cost tier; used by generic provider path)
 - `model_policy.medium` (default: `null` — model ID for the medium-cost tier; used by generic provider path)
@@ -624,15 +624,16 @@ AskUserQuestion([
     multiSelect: false,
     options: [
       { label: "anthropic", description: "claude-opus-4-8 / claude-sonnet-4-6 / claude-haiku-4-5 (Anthropic / Claude)" },
+      { label: "anthropic-fable", description: "claude-fable-5 / claude-sonnet-4-6 / claude-haiku-4-5 (Anthropic / Claude Fable opt-in)" },
       { label: "openai", description: "gpt-5.5 / gpt-5.3-codex / gpt-5.4-mini (OpenAI / Codex)" },
-      { label: "google", description: "gemini-3-pro / gemini-3-flash / gemini-2.5-flash-lite (Google Gemini)" },
-      { label: "qwen", description: "qwen3-max-2026-01-23 / qwen3-coder-plus / qwen3-coder-next (Qwen)" }
+      { label: "Other known provider", description: "Type google or qwen; both still use the canonical tier mapping." }
     ]
   }
 ])
 ```
 
-After the user picks a provider, ask:
+If the user selects "Other known provider", ask them to type `google` or `qwen`.
+Use the typed value as the provider. After the user picks or types a provider, ask:
 
 ```text
 AskUserQuestion([
@@ -653,9 +654,12 @@ Canonical tier mappings by provider and budget:
 
 | Provider  | Budget | high                       | medium                     | low                        |
 |-----------|--------|----------------------------|----------------------------|----------------------------|
-| anthropic | high   | claude-opus-4-8            | claude-opus-4-8            | claude-opus-4-8            |
+| anthropic | high   | claude-opus-4-8            | claude-opus-4-8            | claude-sonnet-4-6          |
 | anthropic | medium | claude-opus-4-8            | claude-sonnet-4-6          | claude-haiku-4-5           |
 | anthropic | low    | claude-haiku-4-5           | claude-haiku-4-5           | claude-haiku-4-5           |
+| anthropic-fable | high   | claude-fable-5             | claude-fable-5             | claude-sonnet-4-6          |
+| anthropic-fable | medium | claude-opus-4-8            | claude-sonnet-4-6          | claude-haiku-4-5           |
+| anthropic-fable | low    | claude-haiku-4-5           | claude-haiku-4-5           | claude-haiku-4-5           |
 | openai    | high   | gpt-5.5                    | gpt-5.5                    | gpt-5.5                    |
 | openai    | medium | gpt-5.5                    | gpt-5.3-codex              | gpt-5.4-mini               |
 | openai    | low    | gpt-5.4-mini               | gpt-5.4-mini               | gpt-5.4-mini               |
@@ -668,6 +672,8 @@ Canonical tier mappings by provider and budget:
 
 Look up the selected (provider, budget) row and proceed to Step E to write those values.
 
+> **claude runtime note:** On the default `claude` runtime, policy-resolved model IDs (e.g. `claude-fable-5`) are mapped to Claude Code agent aliases (`fable`, `opus`, `sonnet`, `haiku`); an ID with no corresponding alias emits a stderr warning and falls back to the configured tier alias.
+
 **Step D — Generic-provider path:**
 
 Prompt the user to enter each model ID as a free-text input. An empty input means "keep
@@ -713,7 +719,7 @@ Proceed to Step E.
 
 ```bash
 # Known-provider path — write all four keys atomically:
-gsd_run query config-set model_policy.provider "<provider>"   # e.g., anthropic / openai / google / qwen
+gsd_run query config-set model_policy.provider "<provider>"   # e.g., anthropic / anthropic-fable / openai / google / qwen
 gsd_run query config-set model_policy.budget   "<budget>"    # high / medium / low
 gsd_run query config-set model_policy.high     "<high-id>"
 gsd_run query config-set model_policy.medium   "<medium-id>"
@@ -775,7 +781,7 @@ Display:
 | fast_mode.routing_tier_defaults.standard   | {true/false} |
 | fast_mode.routing_tier_defaults.heavy      | {true/false} |
 | fast_mode.agent_overrides.<agent-id>       | {true/false} |
-| model_policy.provider                      | {anthropic/openai/google/qwen/custom/null} |
+| model_policy.provider                      | {anthropic/anthropic-fable/openai/google/qwen/custom/null} |
 | model_policy.budget                        | {high/medium/low/null} |
 | model_policy.high                          | {model-id/null} |
 | model_policy.medium                        | {model-id/null} |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengsd/gsd-core",
-  "version": "1.4.3",
+  "version": "1.4.5",
   "description": "GSD Core is a meta-prompting, context engineering, and spec-driven development system for AI coding agents.",
   "bin": {
     "gsd-core": "bin/install.js",