@opengsd/gsd-core 1.4.4 → 1.4.5

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gsd-core",
   "displayName": "GSD Core",
-  "version": "1.4.4",
+  "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.4",
+  "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/workflows/settings-advanced.md

@@ -672,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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengsd/gsd-core",
-  "version": "1.4.4",
+  "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",