gsd-codex-cli 1.20.6 → 1.20.7

package/.codex/prompts/gsd-add-phase.md

@@ -15,6 +15,7 @@ Add phase to end of current milestone in roadmap
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-add-todo.md

@@ -15,6 +15,7 @@ Capture idea or task as todo from current conversation context
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-audit-milestone.md

@@ -15,6 +15,7 @@ Audit milestone completion against original intent before archiving
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-check-todos.md

@@ -15,6 +15,7 @@ List pending todos and select one to work on
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-complete-milestone.md

@@ -15,6 +15,7 @@ Archive completed milestone and prepare for next version
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

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

@@ -15,6 +15,7 @@ Systematic debugging with persistent state across context resets
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-discuss-phase.md

@@ -15,6 +15,7 @@ Gather phase context through adaptive questioning before planning
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-execute-phase.md

@@ -13,39 +13,42 @@ Execute all plans in a phase with wave-based parallelization
 - Use one of these engine paths (prefer local, fallback global):
   node .claude/get-shit-done/bin/gsd-tools.js ...
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
-- If `.js` is unavailable, use the same path with `.cjs`.
-- Run engine commands through PowerShell.
-- Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
-- No jq / bash-only constructs.
-
-## Subagent lifecycle (required)
-
-- Translate each upstream `Task(...)` into `spawn_agent` -> `wait` -> `close_agent`.
-- 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.
-- Check installed Codex fork version from `.codex/gsd/VERSION` (or `~/.codex/gsd/VERSION`).
-- Check latest published version with `npm view gsd-codex-cli version`.
-- If versions differ, 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> [--gaps-only]" from the user input.
-2. Run init:
-node <gsd-tools-path> init execute-phase [phase] --raw
-
-3. Load .claude/get-shit-done/workflows/execute-phase.md and execute it step-by-step.
-4. Translate each Task(...) in workflow into:
-   - spawn_agent with the matching role file context from .claude/agents/.
-   - 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 <gsd-tools-path> 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: `gsd-verify-work [phase]` (Codex) / `/gsd:verify-work [phase]` (Claude)
-- Never recommend internal `node ... gsd-tools ...` commands to the user.
+- If `.js` is unavailable, use the same path with `.cjs`.
+- Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
+- Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
+- No jq / bash-only constructs.
+
+## Subagent lifecycle (required)
+
+- Translate each upstream `Task(...)` into `spawn_agent` -> `wait` -> `close_agent`.
+- 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.
+
+## Input contract
+- The command argument is authoritative.
+- If user runs `gsd-execute-phase 28`, execute phase `28`. Do not auto-discover a different phase.
+- Parse flags only from the same argument string (`--gaps-only`, `--auto`).
+- If phase argument is missing or invalid, stop and ask for a valid phase number.
+
+## Execution
+1. Parse "<phase-number> [--gaps-only] [--auto]" from the command argument string.
+2. Treat parsed phase as the execution target and keep it unchanged for all downstream steps.
+3. Run init with the parsed phase:
+node <gsd-tools-path> init execute-phase <phase> --raw
+4. If `--gaps-only` is present, apply gap-closure filtering exactly as defined in the upstream workflow.
+5. If `--auto` is present, preserve auto-advance behavior from the upstream workflow.
+6. Load .claude/get-shit-done/workflows/execute-phase.md and execute it step-by-step.
+7. Translate each Task(...) in workflow into:
+   - spawn_agent with the matching role file context from .claude/agents/.
+   - wait for each spawned agent and apply returned output before moving forward.
+8. Preserve all gates and routing from upstream workflow.
+9. Preserve commit behavior using
+node <gsd-tools-path> commit "message" --files ....
+10. 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: `gsd-verify-work <phase>` (Codex) / `/gsd:verify-work <phase>` (Claude)
+- Never recommend internal `node ... gsd-tools ...` commands to the user.

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

@@ -15,6 +15,7 @@ Show available GSD commands and usage guide
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-insert-phase.md

@@ -15,6 +15,7 @@ Insert urgent work as decimal phase (for example 72.1) between existing phases
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-list-phase-assumptions.md

@@ -15,6 +15,7 @@ Surface Claude's assumptions about a phase approach before planning
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-map-codebase.md

@@ -15,6 +15,7 @@ Analyze codebase with parallel mapper agents to produce .planning/codebase/ docu
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-new-milestone.md

@@ -15,6 +15,7 @@ Start a new milestone cycle — update PROJECT.md and route to requirements
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-new-project.md

@@ -15,6 +15,7 @@ Initialize a new project with deep context gathering and PROJECT.md
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

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

@@ -15,6 +15,7 @@ Create context handoff when pausing work mid-phase
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-plan-milestone-gaps.md

@@ -15,6 +15,7 @@ Create phases to close all gaps identified by milestone audit
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-plan-phase.md

@@ -15,6 +15,7 @@ Create detailed execution plan for a phase (PLAN.md) with verification loop
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

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

@@ -15,6 +15,7 @@ Check project progress, show context, and route to next action
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

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

@@ -15,6 +15,7 @@ Execute a quick task with GSD guarantees (atomic commits, state tracking) but sk
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-remove-phase.md

@@ -15,6 +15,7 @@ Remove a future phase from roadmap and renumber subsequent phases
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-research-phase.md

@@ -15,6 +15,7 @@ Research how to implement a phase (standalone - usually use plan-phase instead)
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

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

@@ -15,6 +15,7 @@ Resume work from previous session with full context restoration
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

package/.codex/prompts/gsd-set-profile.md

@@ -15,6 +15,7 @@ Switch model profile for GSD agents (quality/balanced/budget)
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

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

@@ -15,6 +15,7 @@ Configure GSD workflow toggles and model profile
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

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

@@ -15,6 +15,7 @@ Update GSD to latest version with changelog display
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

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

@@ -15,6 +15,7 @@ Validate built features through conversational UAT
   node ~/.claude/get-shit-done/bin/gsd-tools.js ...
 - If `.js` is unavailable, use the same path with `.cjs`.
 - Run engine commands through PowerShell.
+- Do not set `node <path> ...` as one string variable and invoke `& $var`; run direct `node <path> ...` or `& node <path> ...`.
 - Parse JSON with ConvertFrom-Json; parse key/value output when workflow uses KEY=value raw mode.
 - No jq / bash-only constructs.
 

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

@@ -9,10 +9,12 @@
 - `C:/Users/Ahmed/.claude/get-shit-done/...` → `.claude/get-shit-done/...`
 - `C:/Users/Ahmed/.claude/agents/...` → `.claude/agents/...`
 
-## CLI mapping
-- Use `node .claude/get-shit-done/bin/gsd-tools.js ...`.
-- Keep `--raw` when upstream workflow uses it.
-- Parse JSON by `ConvertFrom-Json`.
+## CLI mapping
+- Use `node .claude/get-shit-done/bin/gsd-tools.js ...`.
+- Keep `--raw` when upstream workflow uses it.
+- Parse JSON by `ConvertFrom-Json`.
+- Do not assign `node <path> <args>` into a single PowerShell string and invoke `& $cmd`.
+- Use direct invocation: `node <path> ...` or `& node <path> ...`.
 
 ## Subagent mapping
 - `subagent_type=gsd-*` maps to equivalent role contract in `.claude/agents/gsd-*.md`.

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

@@ -7,17 +7,31 @@ $raw = & node .claude/get-shit-done/bin/gsd-tools.js state load --raw
 $data = $raw | ConvertFrom-Json
 ```
 
-## Key/value parse
-
-```powershell
-$raw = & node .claude/get-shit-done/bin/gsd-tools.js state load --raw
-$out = @{}
+## Key/value parse
+
+```powershell
+$raw = & node .claude/get-shit-done/bin/gsd-tools.js state load --raw
+$out = @{}
 $raw -split "`n" | ForEach-Object {
   if ($_ -match '^(.*?)=(.*)$') { $out[$Matches[1]] = $Matches[2] }
-}
-```
-
-## Syntax notes
-- Replace jq with `ConvertFrom-Json`.
-- Avoid bash-only heredocs and command substitution.
-- Use quoted paths for PowerShell compatibility.
+}
+```
+
+## Command invocation (important)
+
+```powershell
+# Good: path is separate from the command
+$gsd = ".claude/get-shit-done/bin/gsd-tools.js"
+$raw = & node $gsd init execute-phase 28 --raw
+```
+
+```powershell
+# Bad: this fails because PowerShell treats it as one command token
+$cmd = "node .claude/get-shit-done/bin/gsd-tools.js"
+$raw = & $cmd init execute-phase 28 --raw
+```
+
+## Syntax notes
+- Replace jq with `ConvertFrom-Json`.
+- Avoid bash-only heredocs and command substitution.
+- Use quoted paths for PowerShell compatibility.

package/package.json

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