gsd-codex-cli 1.20.2 → 1.20.4

package/.codex/prompts/gsd-settings.md

@@ -12,8 +12,10 @@ Configure GSD workflow toggles and model profile
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- Resolve gsd-tools path (prefer .cjs, fallback to .js):
+  $GsdTools = if (Test-Path ".claude/get-shit-done/bin/gsd-tools.cjs") { ".claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path ".claude/get-shit-done/bin/gsd-tools.js") { ".claude/get-shit-done/bin/gsd-tools.js" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs") { "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.js") { "$HOME/.claude/get-shit-done/bin/gsd-tools.js" } else { throw "Missing gsd-tools in .claude or $HOME/.claude. Reinstall GSD." }
+- Run engine commands through PowerShell:
+  node $GsdTools ...
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 
@@ -23,10 +25,18 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Spawn only when the upstream workflow defines an agent role.
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
+## Update check
+- Best-effort only; do not fail if offline.
+- Run:
+  $installed = if (Test-Path ".codex/gsd/VERSION") { (Get-Content ".codex/gsd/VERSION" -Raw).Trim() } elseif (Test-Path "$HOME/.codex/gsd/VERSION") { (Get-Content "$HOME/.codex/gsd/VERSION" -Raw).Trim() } else { $null }
+  $latest = $null; try { $latest = (npm view gsd-codex-cli version).Trim() } catch {}
+- If $installed and $latest and $installed -ne $latest, surface:
+  "Update available: $installed -> $latest. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
+
 ## Execution
 1. Parse [none] from the user input.
 2. Run init:
-node .claude/get-shit-done/bin/gsd-tools.js config-ensure-section --raw
+node $GsdTools config-ensure-section --raw
 
 3. Load .claude/get-shit-done/workflows/settings.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -34,10 +44,10 @@ node .claude/get-shit-done/bin/gsd-tools.js config-ensure-section --raw
    - wait for each spawned agent and apply returned output before moving forward.
 5. Preserve all gates and routing from upstream workflow.
 6. Preserve commit behavior using 
-node .claude/get-shit-done/bin/gsd-tools.js commit "message" --files ....
-7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
-
-## Completion output
-- Summarize key artifacts created/updated and next recommended command.
-
-
+node $GsdTools commit "message" --files ....
+7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
+
+## Completion output
+- Summarize key artifacts created/updated.
+- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

package/.codex/prompts/gsd-update.md

@@ -12,8 +12,10 @@ Update GSD to latest version with changelog display
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- Resolve gsd-tools path (prefer .cjs, fallback to .js):
+  $GsdTools = if (Test-Path ".claude/get-shit-done/bin/gsd-tools.cjs") { ".claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path ".claude/get-shit-done/bin/gsd-tools.js") { ".claude/get-shit-done/bin/gsd-tools.js" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs") { "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.js") { "$HOME/.claude/get-shit-done/bin/gsd-tools.js" } else { throw "Missing gsd-tools in .claude or $HOME/.claude. Reinstall GSD." }
+- Run engine commands through PowerShell:
+  node $GsdTools ...
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 
@@ -23,6 +25,14 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Spawn only when the upstream workflow defines an agent role.
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
+## Update check
+- Best-effort only; do not fail if offline.
+- Run:
+  $installed = if (Test-Path ".codex/gsd/VERSION") { (Get-Content ".codex/gsd/VERSION" -Raw).Trim() } elseif (Test-Path "$HOME/.codex/gsd/VERSION") { (Get-Content "$HOME/.codex/gsd/VERSION" -Raw).Trim() } else { $null }
+  $latest = $null; try { $latest = (npm view gsd-codex-cli version).Trim() } catch {}
+- If $installed and $latest and $installed -ne $latest, surface:
+  "Update available: $installed -> $latest. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
+
 ## Execution
 1. Parse [none] from the user input.
 2. Run init:
@@ -34,10 +44,10 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
    - wait for each spawned agent and apply returned output before moving forward.
 5. Preserve all gates and routing from upstream workflow.
 6. Preserve commit behavior using 
-node .claude/get-shit-done/bin/gsd-tools.js commit "message" --files ....
-7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
-
-## Completion output
-- Summarize key artifacts created/updated and next recommended command.
-
-
+node $GsdTools commit "message" --files ....
+7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
+
+## Completion output
+- Summarize key artifacts created/updated.
+- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

package/.codex/prompts/gsd-verify-work.md

@@ -12,8 +12,10 @@ Validate built features through conversational UAT
 - Use .codex/skills/get-shit-done-codex semantics.
 - Treat upstream workflow as the source of truth.
 - Replace user-specific paths with workspace-relative paths (.claude/..., .planning/...).
-- Run engine commands through PowerShell: 
-node .claude/get-shit-done/bin/gsd-tools.js ...
+- Resolve gsd-tools path (prefer .cjs, fallback to .js):
+  $GsdTools = if (Test-Path ".claude/get-shit-done/bin/gsd-tools.cjs") { ".claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path ".claude/get-shit-done/bin/gsd-tools.js") { ".claude/get-shit-done/bin/gsd-tools.js" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs") { "$HOME/.claude/get-shit-done/bin/gsd-tools.cjs" } elseif (Test-Path "$HOME/.claude/get-shit-done/bin/gsd-tools.js") { "$HOME/.claude/get-shit-done/bin/gsd-tools.js" } else { throw "Missing gsd-tools in .claude or $HOME/.claude. Reinstall GSD." }
+- Run engine commands through PowerShell:
+  node $GsdTools ...
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 
@@ -23,10 +25,18 @@ node .claude/get-shit-done/bin/gsd-tools.js ...
 - Spawn only when the upstream workflow defines an agent role.
 - Use `.claude/agents/gsd-*.md` as role context for each spawned agent.
 - Do not advance workflow steps until wait and close complete.
+## Update check
+- Best-effort only; do not fail if offline.
+- Run:
+  $installed = if (Test-Path ".codex/gsd/VERSION") { (Get-Content ".codex/gsd/VERSION" -Raw).Trim() } elseif (Test-Path "$HOME/.codex/gsd/VERSION") { (Get-Content "$HOME/.codex/gsd/VERSION" -Raw).Trim() } else { $null }
+  $latest = $null; try { $latest = (npm view gsd-codex-cli version).Trim() } catch {}
+- If $installed and $latest and $installed -ne $latest, surface:
+  "Update available: $installed -> $latest. Next: gsd-update (Codex) / /gsd:update (Claude) or re-run npx gsd-codex-cli@latest."
+
 ## Execution
 1. Parse "[phase number, for example 4]" from the user input.
 2. Run init:
-node .claude/get-shit-done/bin/gsd-tools.js init verify-work $PHASE --raw
+node $GsdTools init verify-work $PHASE --raw
 
 3. Load .claude/get-shit-done/workflows/verify-work.md and execute it step-by-step.
 4. Translate each Task(...) in workflow into:
@@ -34,10 +44,10 @@ node .claude/get-shit-done/bin/gsd-tools.js init verify-work $PHASE --raw
    - wait for each spawned agent and apply returned output before moving forward.
 5. Preserve all gates and routing from upstream workflow.
 6. Preserve commit behavior using 
-node .claude/get-shit-done/bin/gsd-tools.js commit "message" --files ....
-7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
-
-## Completion output
-- Summarize key artifacts created/updated and next recommended command.
-
-
+node $GsdTools commit "message" --files ....
+7. If commit preflight fails (no git / no commit flag), proceed in read-only mode and report clearly.
+
+## Completion output
+- Summarize key artifacts created/updated.
+- Next recommended command: use the next user-facing GSD command (Codex prompt name + Claude slash command).
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

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

@@ -14,11 +14,12 @@ Use this skill to run `gsd-*` prompts under `Codex` while preserving upstream GS
 - Keep `.claude/agents/gsd-*.md` as role contracts for subagents.
 - Keep `.codex/prompts/gsd-*.md` as Codex-native orchestrators.
 
-## Core rules
-1. Do not change command semantics.
-2. Do not change source workflow logic unless necessary for Codex command compatibility.
-3. Use workspace-relative paths.
-4. Preserve step ordering and gate behavior from workflow files.
+## Core rules
+1. Do not change command semantics.
+2. Do not change source workflow logic unless necessary for Codex command compatibility.
+3. Use workspace-relative paths.
+4. Preserve step ordering and gate behavior from workflow files.
+5. User-facing guidance should recommend `gsd-*` prompts (Codex) and `/gsd:*` commands (Claude), not internal `node ... gsd-tools ...` plumbing.
 
 ## Mandatory codex translations
 - Replace each `Task(...)` with: `spawn_agent` + `wait`.

package/README.md

@@ -1,89 +1,89 @@
-# Get Shit Done - Codex Fork
-
-This repository packages the get-shit-done (GSD) workflow for Codex. It installs Codex prompts plus the supporting GSD reference files used by the workflows and agents.
-
-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 .
-```
-
-Install globally (prompts available from any project):
-
-```bash
-npx gsd-codex-cli@latest --global
-```
-
-You can combine both:
-
-```bash
-npx gsd-codex-cli@latest --path . --global
-```
-
-## What Gets Installed
-
-The installer copies these directories into the target location:
-
-- `.codex/prompts` and `.codex/skills` for Codex commands
-- `.claude/get-shit-done` for workflow references
-- `.claude/agents` for agent definitions
-
-This fork is Codex-first, but the Claude assets are kept alongside for compatibility with the upstream workflow files.
-
-## Using the Prompts
-
-Open your project in Codex and run these prompts from the prompt list:
-
-- `gsd-new-project`
-- `gsd-plan-phase`
-- `gsd-execute-phase`
-
-All Codex prompts live in `.codex/prompts`.
-
-## Update
-
-Re-run the installer to update your local or global install. It overwrites the existing files with the latest version.
-
-```bash
-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
-```
-
-## Development
-
-```bash
-git clone https://github.com/redstar1337/get-shit-done-codex.git
-cd get-shit-done-codex
-node bin/install-codex.js --path .
-```
-
-Run tests and build hooks:
-
-```bash
-npm test
-npm run build:hooks
-```
-
-## Notes
-
-- This package is published as `gsd-codex-cli`. Use `npx gsd-codex-cli@latest` for installs.
-- The npm binary names `get-shit-done-codex` and `get-shit-done-cc` are still provided for compatibility after install.
-
-## Upstream
-
-GSD originated in the upstream repository by TACHES. This fork keeps the core workflow and adds Codex-native prompts and packaging.
-
-Upstream: https://github.com/glittercowboy/get-shit-done
-
-## License
-
+# Get Shit Done - Codex Fork
+
+This repository packages the get-shit-done (GSD) workflow for Codex. It installs Codex prompts plus the supporting GSD reference files used by the workflows and agents.
+
+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 .
+```
+
+Install globally (prompts available from any project):
+
+```bash
+npx gsd-codex-cli@latest --global
+```
+
+You can combine both:
+
+```bash
+npx gsd-codex-cli@latest --path . --global
+```
+
+## What Gets Installed
+
+The installer copies these directories into the target location:
+
+- `.codex/prompts` and `.codex/skills` for Codex commands
+- `.claude/get-shit-done` for workflow references
+- `.claude/agents` for agent definitions
+
+This fork is Codex-first, but the Claude assets are kept alongside for compatibility with the upstream workflow files.
+
+## Using the Prompts
+
+Open your project in Codex and run these prompts from the prompt list:
+
+- `gsd-new-project`
+- `gsd-plan-phase`
+- `gsd-execute-phase`
+
+All Codex prompts live in `.codex/prompts`.
+
+## Update
+
+Re-run the installer to update your local or global install. It overwrites the existing files with the latest version.
+
+```bash
+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
+```
+
+## Development
+
+```bash
+git clone https://github.com/redstar1337/get-shit-done-codex.git
+cd get-shit-done-codex
+node bin/install-codex.js --path .
+```
+
+Run tests and build hooks:
+
+```bash
+npm test
+npm run build:hooks
+```
+
+## Notes
+
+- This package is published as `gsd-codex-cli`. Use `npx gsd-codex-cli@latest` for installs.
+- The npm binary names `get-shit-done-codex` and `get-shit-done-cc` are still provided for compatibility after install.
+
+## Upstream
+
+GSD originated in the upstream repository by TACHES. This fork keeps the core workflow and adds Codex-native prompts and packaging.
+
+Upstream: https://github.com/glittercowboy/get-shit-done
+
+## License
+
 MIT. See `LICENSE`.

package/bin/install-codex.js

@@ -72,6 +72,7 @@ function copyCodexToDirectory(baseDir) {
   const sourceGetShitDone = resolveSourceDir('get-shit-done', '.claude/get-shit-done');
   const sourceAgents = resolveSourceDir('agents', '.claude/agents');
   const versionDest = path.join(targetClaude, 'get-shit-done', 'VERSION');
+  const codexVersionDest = path.join(targetCodex, 'gsd', 'VERSION');
 
   ensureDir(baseDir);
   ensureDir(targetCodex);
@@ -82,6 +83,8 @@ function copyCodexToDirectory(baseDir) {
   copyRecursive(sourceAgents, path.join(targetClaude, 'agents'));
   ensureDir(path.dirname(versionDest));
   fs.writeFileSync(versionDest, `${pkg.version}\n`);
+  ensureDir(path.dirname(codexVersionDest));
+  fs.writeFileSync(codexVersionDest, `${pkg.version}\n`);
 }
 
 copyCodexToDirectory(targetDir);
@@ -97,7 +100,8 @@ 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 prompt gsd-new-project, then gsd-plan-phase, gsd-execute-phase');
-console.log('  3) Use .codex/prompts/* for all GSD commands in this fork');
+console.log('\nNext steps:');
+console.log('  1) Open your project in Codex');
+console.log('  2) Run prompt gsd-new-project, then gsd-discuss-phase, gsd-plan-phase, gsd-execute-phase');
+console.log('  3) If something looks off, run prompt gsd-doctor');
+console.log('  4) Use .codex/prompts/* for all GSD commands in this fork');

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

@@ -56,6 +56,9 @@
  * Todos:
  *   todo complete <filename>           Move todo from pending to completed
  *
+ * Update:
+ *   update check                       Check npm for newer GSD version
+ *
  * Scaffolding:
  *   scaffold context --phase <N>       Create CONTEXT.md template
  *   scaffold uat --phase <N>           Create UAT.md template
@@ -121,6 +124,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
 const { execSync } = require('child_process');
 
 // ─── Model Profile Table ─────────────────────────────────────────────────────
@@ -580,6 +584,47 @@ function cmdVerifyPathExists(cwd, targetPath, raw) {
   }
 }
 
+function cmdUpdateCheck(cwd, raw) {
+  const homeDir = os.homedir();
+  const cacheDir = path.join(homeDir, '.claude', 'cache');
+  const cacheFile = path.join(cacheDir, 'gsd-update-check.json');
+  const projectVersionFile = path.join(cwd, '.claude', 'get-shit-done', 'VERSION');
+  const globalVersionFile = path.join(homeDir, '.claude', 'get-shit-done', 'VERSION');
+
+  let installed = '0.0.0';
+  try {
+    if (fs.existsSync(projectVersionFile)) {
+      installed = fs.readFileSync(projectVersionFile, 'utf8').trim();
+    } else if (fs.existsSync(globalVersionFile)) {
+      installed = fs.readFileSync(globalVersionFile, 'utf8').trim();
+    }
+  } catch {}
+
+  let latest = null;
+  try {
+    latest = execSync('npm view gsd-codex-cli version', { encoding: 'utf8', timeout: 10000, windowsHide: true }).trim();
+  } catch {}
+  if (!latest) {
+    try {
+      latest = execSync('npm view get-shit-done-cc version', { encoding: 'utf8', timeout: 10000, windowsHide: true }).trim();
+    } catch {}
+  }
+
+  const result = {
+    update_available: !!(latest && installed && latest !== installed),
+    installed,
+    latest: latest || 'unknown',
+    checked: Math.floor(Date.now() / 1000),
+  };
+
+  try {
+    fs.mkdirSync(cacheDir, { recursive: true });
+    fs.writeFileSync(cacheFile, JSON.stringify(result));
+  } catch {}
+
+  output(result, raw);
+}
+
 function cmdConfigEnsureSection(cwd, raw) {
   const configPath = path.join(cwd, '.planning', 'config.json');
   const planningDir = path.join(cwd, '.planning');
@@ -2697,35 +2742,35 @@ function cmdPhaseAdd(cwd, description, raw) {
   // Build phase entry
   const phaseEntry = `\n### Phase ${newPhaseNum}: ${description}\n\n**Goal:** [To be planned]\n**Depends on:** Phase ${maxPhase}\n**Plans:** 0 plans\n\nPlans:\n- [ ] TBD (run /gsd:plan-phase ${newPhaseNum} to break down)\n`;
 
-  // Find insertion point: inside last milestone block (if grouped), otherwise before Progress or end
-  const progressMatch = content.match(/^##\s+Progress\b/m);
-  const progressIdx = progressMatch ? progressMatch.index : -1;
-  const searchEnd = progressIdx >= 0 ? progressIdx : content.length;
-  const beforeProgress = content.slice(0, searchEnd);
-
-  const milestonePattern = /^###\s+.*v\d+\.\d+.*$/gmi;
-  const milestoneHeaders = [];
-  let mm;
-  while ((mm = milestonePattern.exec(beforeProgress)) !== null) {
-    milestoneHeaders.push({ index: mm.index });
-  }
-
-  let insertIdx = content.length;
-  if (milestoneHeaders.length > 0) {
-    const target = milestoneHeaders[milestoneHeaders.length - 1];
-    let nextHeaderIdx = searchEnd;
-    for (const header of milestoneHeaders) {
-      if (header.index > target.index) {
-        nextHeaderIdx = header.index;
-        break;
-      }
-    }
-    insertIdx = nextHeaderIdx;
-  } else if (progressIdx >= 0) {
-    insertIdx = progressIdx;
-  }
-
-  const updatedContent = content.slice(0, insertIdx) + phaseEntry + content.slice(insertIdx);
+  // Find insertion point: inside last milestone block (if grouped), otherwise before Progress or end
+  const progressMatch = content.match(/^##\s+Progress\b/m);
+  const progressIdx = progressMatch ? progressMatch.index : -1;
+  const searchEnd = progressIdx >= 0 ? progressIdx : content.length;
+  const beforeProgress = content.slice(0, searchEnd);
+
+  const milestonePattern = /^###\s+.*v\d+\.\d+.*$/gmi;
+  const milestoneHeaders = [];
+  let mm;
+  while ((mm = milestonePattern.exec(beforeProgress)) !== null) {
+    milestoneHeaders.push({ index: mm.index });
+  }
+
+  let insertIdx = content.length;
+  if (milestoneHeaders.length > 0) {
+    const target = milestoneHeaders[milestoneHeaders.length - 1];
+    let nextHeaderIdx = searchEnd;
+    for (const header of milestoneHeaders) {
+      if (header.index > target.index) {
+        nextHeaderIdx = header.index;
+        break;
+      }
+    }
+    insertIdx = nextHeaderIdx;
+  } else if (progressIdx >= 0) {
+    insertIdx = progressIdx;
+  }
+
+  const updatedContent = content.slice(0, insertIdx) + phaseEntry + content.slice(insertIdx);
 
   fs.writeFileSync(roadmapPath, updatedContent, 'utf-8');
 
@@ -5063,10 +5108,19 @@ async function main() {
       break;
     }
 
-    case 'history-digest': {
-      cmdHistoryDigest(cwd, raw);
-      break;
-    }
+    case 'update': {
+      const subcommand = args[1];
+      if (subcommand === 'check') {
+        cmdUpdateCheck(cwd, raw);
+      } else {
+        error('Unknown update subcommand. Available: check');
+      }
+      break;
+    }
+    case 'history-digest': {
+      cmdHistoryDigest(cwd, raw);
+      break;
+    }
 
     case 'phases': {
       const subcommand = args[1];

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

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+// Backward-compatible wrapper: some workflows/prompts reference gsd-tools.js.
+// Canonical implementation lives in gsd-tools.cjs (CommonJS) to avoid ESM issues.
+
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const cjsPath = path.join(__dirname, 'gsd-tools.cjs');
+const args = process.argv.slice(2);
+
+const result = spawnSync(process.execPath, [cjsPath, ...args], { stdio: 'inherit' });
+
+if (result.error) {
+  console.error(result.error.message || String(result.error));
+  process.exit(1);
+}
+
+if (result.signal) {
+  // Mirror the child termination signal if possible.
+  try {
+    process.kill(process.pid, result.signal);
+  } catch {
+    process.exit(1);
+  }
+}
+
+process.exit(typeof result.status === 'number' ? result.status : 0);
+

package/package.json

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