gsd-codex-cli 1.20.11 → 1.20.12

package/.codex/skills/get-shit-done-codex/SKILL.md

@@ -21,10 +21,14 @@ Use this skill to run `gsd-*` prompts under `Codex` while preserving upstream GS
 4. Preserve step ordering and gate behavior from workflow files.
 5. User-facing guidance should recommend `/prompts:gsd-*` prompts (Codex) and `/gsd:*` commands (Claude), not internal `node ... gsd-tools ...` plumbing.
 
-## Mandatory codex translations
-- Replace each `Task(...)` with: `spawn_agent` + `wait`.
-- Replace Bash/JQ patterns with PowerShell and `ConvertFrom-Json`.
-- Replace AskUserQuestion interactions with direct user prompts in chat.
+## Mandatory codex translations
+- Replace each `Task(...)` with: `spawn_agent` + `wait`.
+- Replace Bash/JQ patterns with PowerShell and `ConvertFrom-Json`.
+- Replace AskUserQuestion interactions with direct user prompts in chat.
+- Translate resolved model aliases before Codex subagent spawn:
+  - `inherit` (opus tier) -> `gpt-5.3-codex` (`xhigh`)
+  - `sonnet` -> `gpt-5.3-spark` (`xhigh`)
+  - `haiku` -> `gpt-5.1-codex-mini` (`high`)
 
 ## Subagent lifecycle (required)
 - Spawn only when the upstream workflow explicitly defines a `Task(...)` role.

package/.codex/skills/get-shit-done-codex/references/compat.md

@@ -20,6 +20,10 @@
 - `subagent_type=gsd-*` maps to equivalent role contract in `.claude/agents/gsd-*.md`.
 - Unspecified `subagent_type` values default to command-context Codex agent behavior.
 - Do not pass `agent_type=gsd-*` to `spawn_agent`. Codex only accepts `default`, `explorer`, or `worker` (or omit `agent_type`).
+- Translate GSD model aliases to Codex models when spawning:
+  - `inherit` (opus tier) -> `gpt-5.3-codex` with `xhigh` reasoning effort
+  - `sonnet` -> `gpt-5.3-spark` with `xhigh` reasoning effort
+  - `haiku` -> `gpt-5.1-codex-mini` with `high` reasoning effort
 
 ## Required GSD subagents
 - `gsd-project-researcher`

package/README.md

@@ -4,11 +4,11 @@ This repository packages the get-shit-done (GSD) workflow for Codex. It installs
 
 Use this fork if you want the GSD workflow inside Codex with a simple installer that works for a single project or your home directory.
 
-## Quick Install
-
-```bash
-npx gsd-codex-cli@latest --path .
-```
+## Quick Install
+
+```bash
+npx gsd-codex-cli@latest --path .
+```
 
 Install globally (prompts available from any project):
 
@@ -50,13 +50,21 @@ Re-run the installer to update your local or global install. It overwrites the e
 npx gsd-codex-cli@latest --path . --global
 ```
 
-## CLI Options
-
-```
---path <dir>   Install into a specific directory (defaults to current directory)
---global       Also install to your home directory (~/.codex and ~/.claude)
---help         Show help
-```
+## CLI Options
+
+```
+--path <target-dir>   Install into this directory (defaults to current directory)
+--global              Also install to your home directory
+--help                Show help
+```
+
+## Examples
+
+```bash
+npx gsd-codex-cli@latest --path .
+npx gsd-codex-cli@latest --global
+npx gsd-codex-cli@latest --path . --global
+```
 
 ## Development
 

package/bin/install-codex.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
 
 const args = process.argv.slice(2);
 const pkg = require('../package.json');
@@ -11,13 +11,13 @@ const repoRoot = path.resolve(__dirname, '..');
 const helpText = `
 ${pkg.name} v${pkg.version}
 
-Usage:
-  ${pkg.name} [--path <target-dir>] [--help]
-
-Options:
-  --path <target-dir>   Install into this directory (defaults to current directory)
-  --global              Also install .claude to your home directory (for manual sharing)
-  --help, -h            Show this help message
+Usage:
+  ${pkg.name} [--path <target-dir>] [--global] [--help]
+
+Options:
+  --path <target-dir>   Install into this directory (defaults to current directory)
+  --global              Also install .claude to your home directory (for manual sharing)
+  --help, -h            Show this help message
 
 Examples:
   npx gsd-codex-cli@latest --path .
@@ -43,16 +43,16 @@ if (pathArgIndex !== -1) {
   targetDir = path.resolve(process.cwd(), userPath);
 }
 
-const installGlobal = args.includes('--global');
+const installGlobal = args.includes('--global');
 
 function copyRecursive(source, destination) {
   if (!fs.existsSync(source)) return;
   fs.cpSync(source, destination, { recursive: true, force: true });
 }
 
-function ensureDir(dirPath) {
-  fs.mkdirSync(dirPath, { recursive: true });
-}
+function ensureDir(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true });
+}
 
 function resolveSourceDir(repoRelative, fallbackRelative) {
   const primary = path.join(repoRoot, repoRelative);
@@ -87,21 +87,28 @@ function copyCodexToDirectory(baseDir) {
   fs.writeFileSync(codexVersionDest, `${pkg.version}\n`);
 }
 
-copyCodexToDirectory(targetDir);
-
-if (installGlobal) {
-  // Global installs should place prompts at ~/.codex/prompts (not ~/.codex/.codex/prompts).
-  const globalBase = os.homedir();
-  copyCodexToDirectory(globalBase);
-}
-
-console.log(`\n${pkg.name}@${pkg.version} installed to:`);
-console.log(`  local: ${targetDir}`);
-if (installGlobal) {
-  console.log('  global: ~/.codex');
-}
-console.log('\nNext steps:');
-console.log('  1) Open your project in Codex');
-console.log('  2) Run /prompts:gsd-new-project, then /prompts:gsd-discuss-phase, /prompts:gsd-plan-phase, /prompts:gsd-execute-phase');
-console.log('  3) If something looks off, run /prompts:gsd-doctor');
-console.log('  4) Use .codex/prompts/* for all GSD commands in this fork');
+async function main() {
+  copyCodexToDirectory(targetDir);
+
+  if (installGlobal) {
+    // Global installs should place prompts at ~/.codex/prompts (not ~/.codex/.codex/prompts).
+    const globalBase = os.homedir();
+    copyCodexToDirectory(globalBase);
+  }
+
+  console.log(`\n${pkg.name}@${pkg.version} installed to:`);
+  console.log(`  local: ${targetDir}`);
+  if (installGlobal) {
+    console.log('  global: ~/.codex');
+  }
+  console.log('\nNext steps:');
+  console.log('  1) Open your project in Codex');
+  console.log('  2) Run /prompts:gsd-new-project, then /prompts:gsd-discuss-phase, /prompts:gsd-plan-phase, /prompts:gsd-execute-phase');
+  console.log('  3) If something looks off, run /prompts:gsd-doctor');
+  console.log('  4) Use .codex/prompts/* for all GSD commands in this fork');
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exit(1);
+});

package/get-shit-done/bin/gsd-tools.cjs

@@ -129,29 +129,55 @@ const { execSync } = require('child_process');
 
 // ─── Model Profile Table ─────────────────────────────────────────────────────
 
-const MODEL_PROFILES = {
-  'gsd-planner':              { quality: 'opus', balanced: 'opus',   budget: 'sonnet' },
-  'gsd-roadmapper':           { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
-  'gsd-executor':             { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
+const MODEL_PROFILES = {
+  'gsd-planner':              { quality: 'opus', balanced: 'opus',   budget: 'sonnet' },
+  'gsd-roadmapper':           { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
+  'gsd-executor':             { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
   'gsd-phase-researcher':     { quality: 'opus', balanced: 'sonnet', budget: 'haiku' },
   'gsd-project-researcher':   { quality: 'opus', balanced: 'sonnet', budget: 'haiku' },
   'gsd-research-synthesizer': { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
   'gsd-debugger':             { quality: 'opus', balanced: 'sonnet', budget: 'sonnet' },
   'gsd-codebase-mapper':      { quality: 'sonnet', balanced: 'haiku', budget: 'haiku' },
   'gsd-verifier':             { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
-  'gsd-plan-checker':         { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
-  'gsd-integration-checker':  { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
-};
+  'gsd-plan-checker':         { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+  'gsd-integration-checker':  { quality: 'sonnet', balanced: 'sonnet', budget: 'haiku' },
+};
+
+const CODEX_MODEL_MAP = {
+  // Opus-tier aliases resolve to `inherit` in GSD, then map to Codex 5.3 at xhigh effort.
+  inherit: { model: 'gpt-5.3-codex', reasoning_effort: 'xhigh' },
+  // Sonnet-tier aliases map to Spark 5.3 at xhigh effort.
+  sonnet: { model: 'gpt-5.3-spark', reasoning_effort: 'xhigh' },
+  // Haiku-tier aliases map to codex-mini at high effort.
+  haiku: { model: 'gpt-5.1-codex-mini', reasoning_effort: 'high' },
+};
 
 // ─── Helpers ──────────────────────────────────────────────────────────────────
 
-function parseIncludeFlag(args) {
+function parseIncludeFlag(args) {
   const includeIndex = args.indexOf('--include');
   if (includeIndex === -1) return new Set();
   const includeValue = args[includeIndex + 1];
   if (!includeValue) return new Set();
   return new Set(includeValue.split(',').map(s => s.trim()));
-}
+}
+
+function codexModelSpecFromAlias(alias) {
+  if (!alias) return null;
+  const normalized = String(alias).toLowerCase() === 'opus' ? 'inherit' : String(alias).toLowerCase();
+  return CODEX_MODEL_MAP[normalized] || null;
+}
+
+function withCodexModelHints(result) {
+  for (const [key, value] of Object.entries(result)) {
+    if (!key.endsWith('_model') || typeof value !== 'string') continue;
+    const spec = codexModelSpecFromAlias(value);
+    if (!spec) continue;
+    result[`${key}_codex`] = spec.model;
+    result[`${key}_reasoning_effort`] = spec.reasoning_effort;
+  }
+  return result;
+}
 
 function safeReadFile(filePath) {
   try {
@@ -1472,7 +1498,7 @@ function cmdStateRecordSession(cwd, options, raw) {
   }
 }
 
-function cmdResolveModel(cwd, agentType, raw) {
+function cmdResolveModel(cwd, agentType, raw) {
   if (!agentType) {
     error('agent-type required');
   }
@@ -1480,18 +1506,31 @@ function cmdResolveModel(cwd, agentType, raw) {
   const config = loadConfig(cwd);
   const profile = config.model_profile || 'balanced';
 
-  const agentModels = MODEL_PROFILES[agentType];
-  if (!agentModels) {
-    const result = { model: 'sonnet', profile, unknown_agent: true };
-    output(result, raw, 'sonnet');
-    return;
-  }
-
-  const resolved = agentModels[profile] || agentModels['balanced'] || 'sonnet';
-  const model = resolved === 'opus' ? 'inherit' : resolved;
-  const result = { model, profile };
-  output(result, raw, model);
-}
+  const agentModels = MODEL_PROFILES[agentType];
+  if (!agentModels) {
+    const codexSpec = codexModelSpecFromAlias('sonnet');
+    const result = {
+      model: 'sonnet',
+      profile,
+      unknown_agent: true,
+      codex_model: codexSpec?.model || null,
+      codex_reasoning_effort: codexSpec?.reasoning_effort || null,
+    };
+    output(result, raw, 'sonnet');
+    return;
+  }
+
+  const resolved = agentModels[profile] || agentModels['balanced'] || 'sonnet';
+  const model = resolved === 'opus' ? 'inherit' : resolved;
+  const codexSpec = codexModelSpecFromAlias(model);
+  const result = {
+    model,
+    profile,
+    codex_model: codexSpec?.model || null,
+    codex_reasoning_effort: codexSpec?.reasoning_effort || null,
+  };
+  output(result, raw, model);
+}
 
 function cmdFindPhase(cwd, phase, raw) {
   if (!phase) {
@@ -1998,8 +2037,9 @@ function cmdPhasePlanIndex(cwd, phase, raw) {
     has_checkpoints: hasCheckpoints,
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 function cmdStateSnapshot(cwd, raw) {
   const statePath = path.join(cwd, '.planning', 'STATE.md');
@@ -2099,8 +2139,9 @@ function cmdStateSnapshot(cwd, raw) {
     session,
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 function cmdSummaryExtract(cwd, summaryPath, fields, raw) {
   if (!summaryPath) {
@@ -2703,8 +2744,9 @@ function cmdRoadmapAnalyze(cwd, raw) {
     missing_phase_details: missingDetails.length > 0 ? missingDetails : null,
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 // ─── Phase Add ────────────────────────────────────────────────────────────────
 
@@ -3118,8 +3160,9 @@ function cmdPhaseRemove(cwd, targetPhase, options, raw) {
     state_updated: fs.existsSync(statePath),
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 // ─── Roadmap Update Plan Progress ────────────────────────────────────────────
 
@@ -3365,8 +3408,9 @@ function cmdPhaseComplete(cwd, phaseNum, raw) {
     state_updated: fs.existsSync(statePath),
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 // ─── Milestone Complete ───────────────────────────────────────────────────────
 
@@ -3502,8 +3546,9 @@ function cmdMilestoneComplete(cwd, version, options, raw) {
     state_updated: fs.existsSync(statePath),
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 // ─── Validate Consistency ─────────────────────────────────────────────────────
 
@@ -4299,8 +4344,9 @@ function cmdInitExecutePhase(cwd, phase, includes, raw) {
     result.roadmap_content = safeReadFile(path.join(cwd, '.planning', 'ROADMAP.md'));
   }
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 function cmdInitPlanPhase(cwd, phase, includes, raw) {
   if (!phase) {
@@ -4395,10 +4441,11 @@ function cmdInitPlanPhase(cwd, phase, includes, raw) {
     } catch {}
   }
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
-function cmdInitNewProject(cwd, raw) {
+function cmdInitNewProject(cwd, raw) {
   const config = loadConfig(cwd);
 
   // Detect Brave Search API key availability
@@ -4451,10 +4498,11 @@ function cmdInitNewProject(cwd, raw) {
     brave_search_available: hasBraveSearch,
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
-function cmdInitNewMilestone(cwd, raw) {
+function cmdInitNewMilestone(cwd, raw) {
   const config = loadConfig(cwd);
   const milestone = getMilestoneInfo(cwd);
 
@@ -4478,10 +4526,11 @@ function cmdInitNewMilestone(cwd, raw) {
     state_exists: pathExistsInternal(cwd, '.planning/STATE.md'),
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
-function cmdInitQuick(cwd, description, raw) {
+function cmdInitQuick(cwd, description, raw) {
   const config = loadConfig(cwd);
   const now = new Date();
   const slug = description ? generateSlugInternal(description)?.substring(0, 40) : null;
@@ -4527,8 +4576,9 @@ function cmdInitQuick(cwd, description, raw) {
     planning_exists: pathExistsInternal(cwd, '.planning'),
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 function cmdInitResume(cwd, raw) {
   const config = loadConfig(cwd);
@@ -4557,7 +4607,7 @@ function cmdInitResume(cwd, raw) {
   output(result, raw);
 }
 
-function cmdInitVerifyWork(cwd, phase, raw) {
+function cmdInitVerifyWork(cwd, phase, raw) {
   if (!phase) {
     error('phase required for init verify-work');
   }
@@ -4583,8 +4633,9 @@ function cmdInitVerifyWork(cwd, phase, raw) {
     has_verification: phaseInfo?.has_verification || false,
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 function cmdInitPhaseOp(cwd, phase, raw) {
   const config = loadConfig(cwd);
@@ -4759,7 +4810,7 @@ function cmdInitMilestoneOp(cwd, raw) {
   output(result, raw);
 }
 
-function cmdInitMapCodebase(cwd, raw) {
+function cmdInitMapCodebase(cwd, raw) {
   const config = loadConfig(cwd);
 
   // Check for existing codebase maps
@@ -4790,10 +4841,11 @@ function cmdInitMapCodebase(cwd, raw) {
     codebase_dir_exists: pathExistsInternal(cwd, '.planning/codebase'),
   };
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
-function cmdInitProgress(cwd, includes, raw) {
+function cmdInitProgress(cwd, includes, raw) {
   const config = loadConfig(cwd);
   const milestone = getMilestoneInfo(cwd);
 
@@ -4897,8 +4949,9 @@ function cmdInitProgress(cwd, includes, raw) {
     result.config_content = safeReadFile(path.join(cwd, '.planning', 'config.json'));
   }
 
-  output(result, raw);
-}
+  withCodexModelHints(result);
+  output(result, raw);
+}
 
 // ─── CLI Router ───────────────────────────────────────────────────────────────
 

package/get-shit-done/references/model-profile-resolution.md

@@ -24,11 +24,22 @@ Task(
 )
 ```
 
-**Note:** Opus-tier agents resolve to `"inherit"` (not `"opus"`). This causes the agent to use the parent session's model, avoiding conflicts with organization policies that may block specific opus versions.
+**Note:** Opus-tier agents resolve to `"inherit"` (not `"opus"`). This causes the agent to use the parent session's model, avoiding conflicts with organization policies that may block specific opus versions.
+
+## Codex alias mapping
+
+When running under Codex, map the resolved aliases to concrete Codex models:
+
+| Alias | Codex model | Reasoning effort |
+|-------|-------------|------------------|
+| `inherit` (`opus` tier) | `gpt-5.3-codex` | `xhigh` |
+| `sonnet` | `gpt-5.3-spark` | `xhigh` |
+| `haiku` | `gpt-5.1-codex-mini` | `high` |
 
 ## Usage
 
 1. Resolve once at orchestration start
 2. Store the profile value
 3. Look up each agent's model from the table when spawning
-4. Pass model parameter to each Task call (values: `"inherit"`, `"sonnet"`, `"haiku"`)
+4. Pass model parameter to each Task call (values: `"inherit"`, `"sonnet"`, `"haiku"`)
+5. In Codex mode, translate those aliases with the table above before spawning subagents

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-codex-cli",
-  "version": "1.20.11",
+  "version": "1.20.12",
   "description": "Codex-native package for the get-shit-done workflow with native subagent orchestration.",
   "bin": {
     "gsd-codex-cli": "bin/install-codex.js",