@ahmed118glitch/get-shit-done-codex 1.18.3 → 1.18.4

package/README.md

@@ -1,86 +1,102 @@
-# Get Shit Done (GSD)
-
-Get Shit Done is a planning-first workflow system for AI coding agents. This repository packages the core GSD engine, workflow templates, runtime command surfaces, and a Codex prompt layer.
-
-## What Is In This Repository
-
-- `commands/gsd/`: command source files used by runtime installers
-- `get-shit-done/bin/gsd-tools.js`: core CLI utilities and state/workflow helpers
-- `get-shit-done/workflows/`: end-to-end command workflows
-- `get-shit-done/templates/`: planning and state templates
-- `get-shit-done/references/`: supporting reference docs
-- `agents/`: role-specific agent instruction files
-- `hooks/` and `scripts/build-hooks.js`: hook sources and build pipeline
-- `.codex/prompts/` and `.codex/skills/`: Codex-native prompt and skill layer
-
-## Install
-
-Prerequisite: Node.js `>=16.7.0`.
-
-```bash
-npx @ahmed118glitch/get-shit-done-codex@latest --path .
-```
-
-Common examples:
-
-```bash
-# Install Codex files into the current project directory
-npx @ahmed118glitch/get-shit-done-codex@latest --path .
-
-# Install into an explicit target folder:
-npx @ahmed118glitch/get-shit-done-codex@latest --path /path/to/project
-
-# Install shared copy under your home directory as well:
-npx @ahmed118glitch/get-shit-done-codex@latest --global
-
-# Run the runtime installer (Claude/OpenCode/Gemini) from this scoped package:
-npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc --help
-```
-
-## Runtime Command Surface
-
-- Claude Code and Gemini CLI use `/gsd:<command>` (example: `/gsd:help`)
-- OpenCode uses `/gsd-<command>` (example: `/gsd-help`)
-- Codex prompt files are in `.codex/prompts/gsd-*.md`
-
-## Quick Workflow
-
-1. Start a project with `new-project`
-2. Plan a phase with `plan-phase`
-3. Execute the phase with `execute-phase`
-4. Verify with `verify-work`
-5. Repeat per phase or milestone
-
-Installed commands create and update planning artifacts under `.planning/` (for example: `PROJECT.md`, `REQUIREMENTS.md`, `ROADMAP.md`, `STATE.md`).
-
-## Source Paths vs Installed Paths
-
-Repository source paths:
-
-- `commands/gsd/*`
-- `get-shit-done/workflows/*`
-- `get-shit-done/templates/*`
-
-Installed runtime targets:
-
-- Claude global: `~/.claude`
-- OpenCode global: `~/.config/opencode` (or platform XDG equivalent)
-- Gemini global: `~/.gemini`
-- Local mode: runtime folders in the current project
-
-## Development
-
-```bash
-npm test
-npm run build:hooks
-```
-
-Keep command and workflow behavior aligned across `commands/gsd/` and `get-shit-done/workflows/` when making changes.
-
-## Security
-
-Report vulnerabilities privately via `SECURITY.md`.
-
-## License
-
+# Get Shit Done (GSD)
+
+Get Shit Done is a planning-first workflow system for AI coding agents. This repository packages the core GSD engine, workflow templates, runtime command surfaces, and a Codex prompt layer.
+
+## What Is In This Repository
+
+- `commands/gsd/`: command source files used by runtime installers
+- `get-shit-done/bin/gsd-tools.js`: core CLI utilities and state/workflow helpers
+- `get-shit-done/workflows/`: end-to-end command workflows
+- `get-shit-done/templates/`: planning and state templates
+- `get-shit-done/references/`: supporting reference docs
+- `agents/`: role-specific agent instruction files
+- `hooks/` and `scripts/build-hooks.js`: hook sources and build pipeline
+- `.codex/prompts/` and `.codex/skills/`: Codex-native prompt and skill layer
+
+## Install
+
+Prerequisite: Node.js `>=16.7.0`.
+
+```bash
+npx @ahmed118glitch/get-shit-done-codex@latest --path .
+```
+
+Common examples:
+
+```bash
+# Install Codex files into the current project directory
+npx @ahmed118glitch/get-shit-done-codex@latest --path .
+
+# Install into an explicit target folder:
+npx @ahmed118glitch/get-shit-done-codex@latest --path /path/to/project
+
+# Install shared copy under your home directory as well:
+npx @ahmed118glitch/get-shit-done-codex@latest --global
+
+# Run the runtime installer from this scoped package (examples):
+npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc --all --global
+npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc --claude --local
+```
+
+Global install writes prompts to `~/.codex/prompts` (not nested).
+
+## Verify Install
+
+```bash
+# Project prompts
+ls ./.codex/prompts/gsd-*.md
+
+# Global prompts (if you used --global)
+ls ~/.codex/prompts/gsd-*.md
+```
+
+## Runtime Command Surface
+
+- Claude Code and Gemini CLI use `/gsd:<command>` (example: `/gsd:help`)
+- OpenCode uses `/gsd-<command>` (example: `/gsd-help`)
+- Codex prompt files are in `.codex/prompts/gsd-*.md`
+
+## Quick Workflow
+
+Use the command surface above (`/gsd:<command>`, `/gsd-<command>`, or Codex `gsd-*` prompts).
+
+1. Start a project with `new-project`
+2. Plan a phase with `plan-phase`
+3. Execute the phase with `execute-phase`
+4. Verify with `verify-work`
+5. Repeat per phase or milestone
+
+Installed commands create and update planning artifacts under `.planning/` (for example: `PROJECT.md`, `REQUIREMENTS.md`, `ROADMAP.md`, `STATE.md`).
+
+## Source Paths vs Installed Paths
+
+Repository source paths:
+
+- `commands/gsd/*`
+- `get-shit-done/workflows/*`
+- `get-shit-done/templates/*`
+
+Installed runtime targets:
+
+- Claude global: `~/.claude`
+- OpenCode global: `~/.config/opencode` (or platform XDG equivalent)
+- Gemini global: `~/.gemini`
+- Codex global prompts/skills: `~/.codex/prompts`, `~/.codex/skills`
+- Local mode: runtime folders in the current project
+
+## Development
+
+```bash
+npm test
+npm run build:hooks
+```
+
+Keep command and workflow behavior aligned across `commands/gsd/` and `get-shit-done/workflows/` when making changes.
+
+## Security
+
+Report vulnerabilities privately via `SECURITY.md`.
+
+## License
+
 MIT (`LICENSE`).

package/bin/install-codex.js

@@ -1,100 +1,100 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const args = process.argv.slice(2);
-const pkg = require('../package.json');
-const repoRoot = path.resolve(__dirname, '..');
-
-const helpText = `
-${pkg.name} v${pkg.version}
-
-Usage:
-  get-shit-done-codex [--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
-
-Examples:
-  npx @ahmed118glitch/get-shit-done-codex@latest --path .
-  npx @ahmed118glitch/get-shit-done-codex@latest --path ./my-project
-`;
-
-if (args.includes('--help') || args.includes('-h')) {
-  console.log(helpText);
-  process.exit(0);
-}
-
-const pathArgIndex = args.findIndex((arg, index) => {
-  if (arg === '--path') return true;
-  return false;
-});
-let targetDir = process.cwd();
-if (pathArgIndex !== -1) {
-  const userPath = args[pathArgIndex + 1];
-  if (!userPath || userPath.startsWith('-')) {
-    console.error('Error: --path requires a directory argument.');
-    process.exit(1);
-  }
-  targetDir = path.resolve(process.cwd(), userPath);
-}
-
-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 resolveSourceDir(repoRelative, fallbackRelative) {
-  const primary = path.join(repoRoot, repoRelative);
-  const fallback = fallbackRelative ? path.join(repoRoot, fallbackRelative) : null;
-
-  if (fs.existsSync(primary)) return primary;
-  if (fallback && fs.existsSync(fallback)) return fallback;
-
-  const fallbackMessage = fallbackRelative ? ` or ${fallbackRelative}` : '';
-  throw new Error(`Missing source directory "${repoRelative}"${fallbackMessage} in repository root ${repoRoot}`);
-}
-
-function copyCodexToDirectory(baseDir) {
-  const targetCodex = path.join(baseDir, '.codex');
-  const targetClaude = path.join(baseDir, '.claude');
-  const sourceCodex = path.join(repoRoot, '.codex');
-  const sourceGetShitDone = resolveSourceDir('get-shit-done', '.claude/get-shit-done');
-  const sourceAgents = resolveSourceDir('agents', '.claude/agents');
-
-  ensureDir(baseDir);
-  ensureDir(targetCodex);
-  ensureDir(targetClaude);
-
-  copyRecursive(sourceCodex, targetCodex);
-  copyRecursive(sourceGetShitDone, path.join(targetClaude, 'get-shit-done'));
-  copyRecursive(sourceAgents, path.join(targetClaude, 'agents'));
-}
-
-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} 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 prompt gsd-new-project, then gsd-plan-phase, gsd-execute-phase');
-console.log('  3) Use .codex/prompts/* for all GSD commands in this fork');
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const args = process.argv.slice(2);
+const pkg = require('../package.json');
+const repoRoot = path.resolve(__dirname, '..');
+
+const helpText = `
+${pkg.name} v${pkg.version}
+
+Usage:
+  get-shit-done-codex [--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
+
+Examples:
+  npx @ahmed118glitch/get-shit-done-codex@latest --path .
+  npx @ahmed118glitch/get-shit-done-codex@latest --path ./my-project
+`;
+
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(helpText);
+  process.exit(0);
+}
+
+const pathArgIndex = args.findIndex((arg, index) => {
+  if (arg === '--path') return true;
+  return false;
+});
+let targetDir = process.cwd();
+if (pathArgIndex !== -1) {
+  const userPath = args[pathArgIndex + 1];
+  if (!userPath || userPath.startsWith('-')) {
+    console.error('Error: --path requires a directory argument.');
+    process.exit(1);
+  }
+  targetDir = path.resolve(process.cwd(), userPath);
+}
+
+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 resolveSourceDir(repoRelative, fallbackRelative) {
+  const primary = path.join(repoRoot, repoRelative);
+  const fallback = fallbackRelative ? path.join(repoRoot, fallbackRelative) : null;
+
+  if (fs.existsSync(primary)) return primary;
+  if (fallback && fs.existsSync(fallback)) return fallback;
+
+  const fallbackMessage = fallbackRelative ? ` or ${fallbackRelative}` : '';
+  throw new Error(`Missing source directory "${repoRelative}"${fallbackMessage} in repository root ${repoRoot}`);
+}
+
+function copyCodexToDirectory(baseDir) {
+  const targetCodex = path.join(baseDir, '.codex');
+  const targetClaude = path.join(baseDir, '.claude');
+  const sourceCodex = path.join(repoRoot, '.codex');
+  const sourceGetShitDone = resolveSourceDir('get-shit-done', '.claude/get-shit-done');
+  const sourceAgents = resolveSourceDir('agents', '.claude/agents');
+
+  ensureDir(baseDir);
+  ensureDir(targetCodex);
+  ensureDir(targetClaude);
+
+  copyRecursive(sourceCodex, targetCodex);
+  copyRecursive(sourceGetShitDone, path.join(targetClaude, 'get-shit-done'));
+  copyRecursive(sourceAgents, path.join(targetClaude, 'agents'));
+}
+
+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} 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 prompt gsd-new-project, then gsd-plan-phase, gsd-execute-phase');
+console.log('  3) Use .codex/prompts/* for all GSD commands in this fork');

package/get-shit-done/workflows/help.md

@@ -17,9 +17,9 @@ Display the complete GSD command reference. Output ONLY the reference content. D
 
 GSD evolves fast. Update periodically:
 
-```bash
-npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc
-```
+```bash
+npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc
+```
 
 ## Core Workflow
 
@@ -322,7 +322,7 @@ Update GSD to latest version with changelog preview.
 - Displays changelog entries for versions you've missed
 - Highlights breaking changes
 - Confirms before running install
-- Better than raw `npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc`
+- Better than raw `npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc`
 
 Usage: `/gsd:update`
 

package/get-shit-done/workflows/update.md

@@ -46,15 +46,15 @@ Proceed to install step (treat as version 0.0.0 for comparison).
 <step name="check_latest_version">
 Check npm for latest version:
 
-```bash
-npm view @ahmed118glitch/get-shit-done-codex version 2>/dev/null
-```
+```bash
+npm view @ahmed118glitch/get-shit-done-codex version 2>/dev/null
+```
 
 **If npm check fails:**
 ```
 Couldn't check for updates (offline or npm unavailable).
 
-To update manually: `npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc --global`
+To update manually: `npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc --global`
 ```
 
 Exit.
@@ -145,14 +145,14 @@ Use AskUserQuestion:
 Run the update using the install type detected in step 1:
 
 **If LOCAL install:**
-```bash
-npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc --local
-```
+```bash
+npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc --local
+```
 
 **If GLOBAL install (or unknown):**
-```bash
-npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc --global
-```
+```bash
+npx --yes --package=@ahmed118glitch/get-shit-done-codex@latest get-shit-done-cc --global
+```
 
 Capture output. If install fails, show error and exit.
 

package/package.json

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