gsd-remix 1.0.2 → 1.1.0

package/get-shit-done/workflows/validate-phase.md

@@ -1,176 +0,0 @@
-<purpose>
-Audit Nyquist validation gaps for a completed phase. Generate missing tests. Update VALIDATION.md.
-</purpose>
-
-<required_reading>
-@~/.claude/get-shit-done/references/ui-brand.md
-</required_reading>
-
-<available_agent_types>
-Valid GSD subagent types (use exact names — do not fall back to 'general-purpose'):
-- gsd-nyquist-auditor — Validates verification coverage
-</available_agent_types>
-
-<process>
-
-## 0. Initialize
-
-```bash
-INIT=$(gsd-remix-sdk query init.phase-op "${PHASE_ARG}")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-AGENT_SKILLS_AUDITOR=$(gsd-remix-sdk query agent-skills gsd-nyquist-auditor 2>/dev/null)
-```
-
-Parse: `phase_dir`, `phase_number`, `phase_name`, `phase_slug`, `padded_phase`.
-
-```bash
-AUDITOR_MODEL=$(gsd-remix-sdk query resolve-model gsd-nyquist-auditor --raw)
-NYQUIST_CFG=$(gsd-remix-sdk query config-get workflow.nyquist_validation --raw)
-```
-
-If `NYQUIST_CFG` is `false`: exit with "Nyquist validation is disabled. Enable via /gsd-settings."
-
-Display banner: `GSD > VALIDATE PHASE {N}: {name}`
-
-## 1. Detect Input State
-
-```bash
-VALIDATION_FILE=$(ls "${PHASE_DIR}"/*-VALIDATION.md 2>/dev/null | head -1)
-SUMMARY_FILES=$(ls "${PHASE_DIR}"/*-SUMMARY.md 2>/dev/null)
-```
-
-- **State A** (`VALIDATION_FILE` non-empty): Audit existing
-- **State B** (`VALIDATION_FILE` empty, `SUMMARY_FILES` non-empty): Reconstruct from artifacts
-- **State C** (`SUMMARY_FILES` empty): Exit — "Phase {N} not executed. Run /gsd-execute-phase {N} ${GSD_WS} first."
-
-## 2. Discovery
-
-### 2a. Read Phase Artifacts
-
-Read all PLAN and SUMMARY files. Extract: task lists, requirement IDs, key-files changed, verify blocks.
-
-### 2b. Build Requirement-to-Task Map
-
-Per task: `{ task_id, plan_id, wave, requirement_ids, has_automated_command }`
-
-### 2c. Detect Test Infrastructure
-
-State A: Parse from existing VALIDATION.md Test Infrastructure table.
-State B: Filesystem scan:
-
-```bash
-find . -name "pytest.ini" -o -name "jest.config.*" -o -name "vitest.config.*" -o -name "pyproject.toml" 2>/dev/null | head -10
-find . \( -name "*.test.*" -o -name "*.spec.*" -o -name "test_*" \) -not -path "*/node_modules/*" 2>/dev/null | head -40
-```
-
-### 2d. Cross-Reference
-
-Match each requirement to existing tests by filename, imports, test descriptions. Record: requirement → test_file → status.
-
-## 3. Gap Analysis
-
-Classify each requirement:
-
-| Status | Criteria |
-|--------|----------|
-| COVERED | Test exists, targets behavior, runs green |
-| PARTIAL | Test exists, failing or incomplete |
-| MISSING | No test found |
-
-Build: `{ task_id, requirement, gap_type, suggested_test_path, suggested_command }`
-
-No gaps → skip to Step 6, set `nyquist_compliant: true`.
-
-## 4. Present Gap Plan
-
-
-**Text mode (`workflow.text_mode: true` in config or `--text` flag):** Set `TEXT_MODE=true` if `--text` is present in `$ARGUMENTS` OR `text_mode` from init JSON is `true`. When TEXT_MODE is active, replace every `AskUserQuestion` call with a plain-text numbered list and ask the user to type their choice number. This is required for non-Claude runtimes (OpenAI Codex, Gemini CLI, etc.) where `AskUserQuestion` is not available.
-Call AskUserQuestion with gap table and options:
-1. "Fix all gaps" → Step 5
-2. "Skip — mark manual-only" → add to Manual-Only, Step 6
-3. "Cancel" → exit
-
-## 5. Spawn gsd-nyquist-auditor
-
-```
-Task(
-  prompt="Read ~/.claude/agents/gsd-nyquist-auditor.md for instructions.\n\n" +
-    "<files_to_read>{PLAN, SUMMARY, impl files, VALIDATION.md}</files_to_read>" +
-    "<gaps>{gap list}</gaps>" +
-    "<test_infrastructure>{framework, config, commands}</test_infrastructure>" +
-    "<constraints>Never modify impl files. Max 3 debug iterations. Escalate impl bugs.</constraints>" +
-    "${AGENT_SKILLS_AUDITOR}",
-  subagent_type="gsd-nyquist-auditor",
-  model="{AUDITOR_MODEL}",
-  description="Fill validation gaps for Phase {N}"
-)
-```
-
-Handle return:
-- `## GAPS FILLED` → record tests + map updates, Step 6
-- `## PARTIAL` → record resolved, move escalated to manual-only, Step 6
-- `## ESCALATE` → move all to manual-only, Step 6
-
-## 6. Generate/Update VALIDATION.md
-
-**State B (create):**
-1. Read template from `~/.claude/get-shit-done/templates/VALIDATION.md`
-2. Fill: frontmatter, Test Infrastructure, Per-Task Map, Manual-Only, Sign-Off
-3. Write to `${PHASE_DIR}/${PADDED_PHASE}-VALIDATION.md`
-
-**State A (update):**
-1. Update Per-Task Map statuses, add escalated to Manual-Only, update frontmatter
-2. Append audit trail:
-
-```markdown
-## Validation Audit {date}
-| Metric | Count |
-|--------|-------|
-| Gaps found | {N} |
-| Resolved | {M} |
-| Escalated | {K} |
-```
-
-## 7. Commit
-
-```bash
-git add {test_files}
-git commit -m "test(phase-${PHASE}): add Nyquist validation tests"
-
-gsd-remix-sdk query commit "docs(phase-${PHASE}): add/update validation strategy"
-```
-
-## 8. Results + Routing
-
-**Compliant:**
-```
-GSD > PHASE {N} IS NYQUIST-COMPLIANT
-All requirements have automated verification.
-▶ Next: /gsd-audit-milestone ${GSD_WS}
-```
-
-**Partial:**
-```
-GSD > PHASE {N} VALIDATED (PARTIAL)
-{M} automated, {K} manual-only.
-▶ Retry: /gsd-validate-phase {N} ${GSD_WS}
-```
-
-Display `/clear` reminder.
-
-</process>
-
-<success_criteria>
-- [ ] Nyquist config checked (exit if disabled)
-- [ ] Input state detected (A/B/C)
-- [ ] State C exits cleanly
-- [ ] PLAN/SUMMARY files read, requirement map built
-- [ ] Test infrastructure detected
-- [ ] Gaps classified (COVERED/PARTIAL/MISSING)
-- [ ] User gate with gap table
-- [ ] Auditor spawned with complete context
-- [ ] All three return formats handled
-- [ ] VALIDATION.md created or updated
-- [ ] Test files committed separately
-- [ ] Results with routing presented
-</success_criteria>

package/hooks/dist/gsd-check-update-worker.js

@@ -1,108 +0,0 @@
-#!/usr/bin/env node
-// gsd-hook-version: {{GSD_VERSION}}
-// Background worker spawned by gsd-check-update.js (SessionStart hook).
-// Checks for GSD updates and stale hooks, writes result to cache file.
-// Receives paths via environment variables set by the parent hook.
-//
-// Using a separate file (rather than node -e '<inline code>') avoids the
-// template-literal regex-escaping problem: regex source is plain JS here.
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { execFileSync } = require('child_process');
-
-const cacheFile = process.env.GSD_CACHE_FILE;
-const projectVersionFile = process.env.GSD_PROJECT_VERSION_FILE;
-const globalVersionFile = process.env.GSD_GLOBAL_VERSION_FILE;
-
-// Compare semver: true if a > b (a is strictly newer than b)
-// Strips pre-release suffixes (e.g. '3-beta.1' → '3') to avoid NaN from Number()
-function isNewer(a, b) {
-  const pa = (a || '').split('.').map(s => Number(s.replace(/-.*/, '')) || 0);
-  const pb = (b || '').split('.').map(s => Number(s.replace(/-.*/, '')) || 0);
-  for (let i = 0; i < 3; i++) {
-    if (pa[i] > pb[i]) return true;
-    if (pa[i] < pb[i]) return false;
-  }
-  return false;
-}
-
-// Check project directory first (local install), then global
-let installed = '0.0.0';
-let configDir = '';
-try {
-  if (fs.existsSync(projectVersionFile)) {
-    installed = fs.readFileSync(projectVersionFile, 'utf8').trim();
-    configDir = path.dirname(path.dirname(projectVersionFile));
-  } else if (fs.existsSync(globalVersionFile)) {
-    installed = fs.readFileSync(globalVersionFile, 'utf8').trim();
-    configDir = path.dirname(path.dirname(globalVersionFile));
-  }
-} catch (e) {}
-
-// Check for stale hooks — compare hook version headers against installed VERSION
-// Hooks are installed at configDir/hooks/ (e.g. ~/.claude/hooks/) (#1421)
-// Only check hooks that GSD currently ships — orphaned files from removed features
-// (e.g., gsd-intel-*.js) must be ignored to avoid permanent stale warnings (#1750)
-const MANAGED_HOOKS = [
-  'gsd-check-update-worker.js',
-  'gsd-check-update.js',
-  'gsd-context-monitor.js',
-  'gsd-phase-boundary.sh',
-  'gsd-prompt-guard.js',
-  'gsd-read-guard.js',
-  'gsd-read-injection-scanner.js',
-  'gsd-session-state.sh',
-  'gsd-statusline.js',
-  'gsd-validate-commit.sh',
-  'gsd-workflow-guard.js',
-];
-
-let staleHooks = [];
-if (configDir) {
-  const hooksDir = path.join(configDir, 'hooks');
-  try {
-    if (fs.existsSync(hooksDir)) {
-      const hookFiles = fs.readdirSync(hooksDir).filter(f => MANAGED_HOOKS.includes(f));
-      for (const hookFile of hookFiles) {
-        try {
-          const content = fs.readFileSync(path.join(hooksDir, hookFile), 'utf8');
-          // Match both JS (//) and bash (#) comment styles
-          const versionMatch = content.match(/(?:\/\/|#) gsd-hook-version:\s*(.+)/);
-          if (versionMatch) {
-            const hookVersion = versionMatch[1].trim();
-            if (isNewer(installed, hookVersion) && !hookVersion.includes('{{')) {
-              staleHooks.push({ file: hookFile, hookVersion, installedVersion: installed });
-            }
-          } else {
-            // No version header at all — definitely stale (pre-version-tracking)
-            staleHooks.push({ file: hookFile, hookVersion: 'unknown', installedVersion: installed });
-          }
-        } catch (e) {}
-      }
-    }
-  } catch (e) {}
-}
-
-let latest = null;
-try {
-  latest = execFileSync('npm', ['view', 'get-shit-done-cc', 'version'], {
-    encoding: 'utf8',
-    timeout: 10000,
-    windowsHide: true,
-  }).trim();
-} catch (e) {}
-
-const result = {
-  update_available: latest && isNewer(latest, installed),
-  installed,
-  latest: latest || 'unknown',
-  checked: Math.floor(Date.now() / 1000),
-  stale_hooks: staleHooks.length > 0 ? staleHooks : undefined,
-};
-
-if (cacheFile) {
-  try { fs.writeFileSync(cacheFile, JSON.stringify(result)); } catch (e) {}
-}

package/hooks/dist/gsd-check-update.js

@@ -1,63 +0,0 @@
-#!/usr/bin/env node
-// gsd-hook-version: {{GSD_VERSION}}
-// Check for GSD updates in background, write result to cache
-// Called by SessionStart hook - runs once per session
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { spawn } = require('child_process');
-
-const homeDir = os.homedir();
-const cwd = process.cwd();
-
-// Detect runtime config directory (supports Claude, OpenCode, Kilo, Gemini)
-// Respects CLAUDE_CONFIG_DIR for custom config directory setups
-function detectConfigDir(baseDir) {
-  // Check env override first (supports multi-account setups)
-  const envDir = process.env.CLAUDE_CONFIG_DIR;
-  if (envDir && fs.existsSync(path.join(envDir, 'get-shit-done', 'VERSION'))) {
-    return envDir;
-  }
-  for (const dir of ['.claude', '.gemini', '.config/kilo', '.kilo', '.config/opencode', '.opencode']) {
-    if (fs.existsSync(path.join(baseDir, dir, 'get-shit-done', 'VERSION'))) {
-      return path.join(baseDir, dir);
-    }
-  }
-  return envDir || path.join(baseDir, '.claude');
-}
-
-const globalConfigDir = detectConfigDir(homeDir);
-const projectConfigDir = detectConfigDir(cwd);
-// Use a shared, tool-agnostic cache directory to avoid multi-runtime
-// resolution mismatches when different runtimes trigger update checks (#1421).
-const cacheDir = path.join(homeDir, '.cache', 'gsd');
-const cacheFile = path.join(cacheDir, 'gsd-update-check.json');
-
-// VERSION file locations (check project first, then global)
-const projectVersionFile = path.join(projectConfigDir, 'get-shit-done', 'VERSION');
-const globalVersionFile = path.join(globalConfigDir, 'get-shit-done', 'VERSION');
-
-// Ensure cache directory exists
-if (!fs.existsSync(cacheDir)) {
-  fs.mkdirSync(cacheDir, { recursive: true });
-}
-
-// Run check in background via a dedicated worker script.
-// Spawning a file (rather than node -e '<inline code>') keeps the worker logic
-// in plain JS with no template-literal regex-escaping concerns, and makes the
-// worker independently testable.
-const workerPath = path.join(__dirname, 'gsd-check-update-worker.js');
-const child = spawn(process.execPath, [workerPath], {
-  stdio: 'ignore',
-  windowsHide: true,
-  detached: true,  // Required on Windows for proper process detachment
-  env: {
-    ...process.env,
-    GSD_CACHE_FILE: cacheFile,
-    GSD_PROJECT_VERSION_FILE: projectVersionFile,
-    GSD_GLOBAL_VERSION_FILE: globalVersionFile,
-  },
-});
-
-child.unref();

package/hooks/gsd-check-update-worker.js

@@ -1,108 +0,0 @@
-#!/usr/bin/env node
-// gsd-hook-version: {{GSD_VERSION}}
-// Background worker spawned by gsd-check-update.js (SessionStart hook).
-// Checks for GSD updates and stale hooks, writes result to cache file.
-// Receives paths via environment variables set by the parent hook.
-//
-// Using a separate file (rather than node -e '<inline code>') avoids the
-// template-literal regex-escaping problem: regex source is plain JS here.
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { execFileSync } = require('child_process');
-
-const cacheFile = process.env.GSD_CACHE_FILE;
-const projectVersionFile = process.env.GSD_PROJECT_VERSION_FILE;
-const globalVersionFile = process.env.GSD_GLOBAL_VERSION_FILE;
-
-// Compare semver: true if a > b (a is strictly newer than b)
-// Strips pre-release suffixes (e.g. '3-beta.1' → '3') to avoid NaN from Number()
-function isNewer(a, b) {
-  const pa = (a || '').split('.').map(s => Number(s.replace(/-.*/, '')) || 0);
-  const pb = (b || '').split('.').map(s => Number(s.replace(/-.*/, '')) || 0);
-  for (let i = 0; i < 3; i++) {
-    if (pa[i] > pb[i]) return true;
-    if (pa[i] < pb[i]) return false;
-  }
-  return false;
-}
-
-// Check project directory first (local install), then global
-let installed = '0.0.0';
-let configDir = '';
-try {
-  if (fs.existsSync(projectVersionFile)) {
-    installed = fs.readFileSync(projectVersionFile, 'utf8').trim();
-    configDir = path.dirname(path.dirname(projectVersionFile));
-  } else if (fs.existsSync(globalVersionFile)) {
-    installed = fs.readFileSync(globalVersionFile, 'utf8').trim();
-    configDir = path.dirname(path.dirname(globalVersionFile));
-  }
-} catch (e) {}
-
-// Check for stale hooks — compare hook version headers against installed VERSION
-// Hooks are installed at configDir/hooks/ (e.g. ~/.claude/hooks/) (#1421)
-// Only check hooks that GSD currently ships — orphaned files from removed features
-// (e.g., gsd-intel-*.js) must be ignored to avoid permanent stale warnings (#1750)
-const MANAGED_HOOKS = [
-  'gsd-check-update-worker.js',
-  'gsd-check-update.js',
-  'gsd-context-monitor.js',
-  'gsd-phase-boundary.sh',
-  'gsd-prompt-guard.js',
-  'gsd-read-guard.js',
-  'gsd-read-injection-scanner.js',
-  'gsd-session-state.sh',
-  'gsd-statusline.js',
-  'gsd-validate-commit.sh',
-  'gsd-workflow-guard.js',
-];
-
-let staleHooks = [];
-if (configDir) {
-  const hooksDir = path.join(configDir, 'hooks');
-  try {
-    if (fs.existsSync(hooksDir)) {
-      const hookFiles = fs.readdirSync(hooksDir).filter(f => MANAGED_HOOKS.includes(f));
-      for (const hookFile of hookFiles) {
-        try {
-          const content = fs.readFileSync(path.join(hooksDir, hookFile), 'utf8');
-          // Match both JS (//) and bash (#) comment styles
-          const versionMatch = content.match(/(?:\/\/|#) gsd-hook-version:\s*(.+)/);
-          if (versionMatch) {
-            const hookVersion = versionMatch[1].trim();
-            if (isNewer(installed, hookVersion) && !hookVersion.includes('{{')) {
-              staleHooks.push({ file: hookFile, hookVersion, installedVersion: installed });
-            }
-          } else {
-            // No version header at all — definitely stale (pre-version-tracking)
-            staleHooks.push({ file: hookFile, hookVersion: 'unknown', installedVersion: installed });
-          }
-        } catch (e) {}
-      }
-    }
-  } catch (e) {}
-}
-
-let latest = null;
-try {
-  latest = execFileSync('npm', ['view', 'get-shit-done-cc', 'version'], {
-    encoding: 'utf8',
-    timeout: 10000,
-    windowsHide: true,
-  }).trim();
-} catch (e) {}
-
-const result = {
-  update_available: latest && isNewer(latest, installed),
-  installed,
-  latest: latest || 'unknown',
-  checked: Math.floor(Date.now() / 1000),
-  stale_hooks: staleHooks.length > 0 ? staleHooks : undefined,
-};
-
-if (cacheFile) {
-  try { fs.writeFileSync(cacheFile, JSON.stringify(result)); } catch (e) {}
-}

package/hooks/gsd-check-update.js

@@ -1,63 +0,0 @@
-#!/usr/bin/env node
-// gsd-hook-version: {{GSD_VERSION}}
-// Check for GSD updates in background, write result to cache
-// Called by SessionStart hook - runs once per session
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { spawn } = require('child_process');
-
-const homeDir = os.homedir();
-const cwd = process.cwd();
-
-// Detect runtime config directory (supports Claude, OpenCode, Kilo, Gemini)
-// Respects CLAUDE_CONFIG_DIR for custom config directory setups
-function detectConfigDir(baseDir) {
-  // Check env override first (supports multi-account setups)
-  const envDir = process.env.CLAUDE_CONFIG_DIR;
-  if (envDir && fs.existsSync(path.join(envDir, 'get-shit-done', 'VERSION'))) {
-    return envDir;
-  }
-  for (const dir of ['.claude', '.gemini', '.config/kilo', '.kilo', '.config/opencode', '.opencode']) {
-    if (fs.existsSync(path.join(baseDir, dir, 'get-shit-done', 'VERSION'))) {
-      return path.join(baseDir, dir);
-    }
-  }
-  return envDir || path.join(baseDir, '.claude');
-}
-
-const globalConfigDir = detectConfigDir(homeDir);
-const projectConfigDir = detectConfigDir(cwd);
-// Use a shared, tool-agnostic cache directory to avoid multi-runtime
-// resolution mismatches when different runtimes trigger update checks (#1421).
-const cacheDir = path.join(homeDir, '.cache', 'gsd');
-const cacheFile = path.join(cacheDir, 'gsd-update-check.json');
-
-// VERSION file locations (check project first, then global)
-const projectVersionFile = path.join(projectConfigDir, 'get-shit-done', 'VERSION');
-const globalVersionFile = path.join(globalConfigDir, 'get-shit-done', 'VERSION');
-
-// Ensure cache directory exists
-if (!fs.existsSync(cacheDir)) {
-  fs.mkdirSync(cacheDir, { recursive: true });
-}
-
-// Run check in background via a dedicated worker script.
-// Spawning a file (rather than node -e '<inline code>') keeps the worker logic
-// in plain JS with no template-literal regex-escaping concerns, and makes the
-// worker independently testable.
-const workerPath = path.join(__dirname, 'gsd-check-update-worker.js');
-const child = spawn(process.execPath, [workerPath], {
-  stdio: 'ignore',
-  windowsHide: true,
-  detached: true,  // Required on Windows for proper process detachment
-  env: {
-    ...process.env,
-    GSD_CACHE_FILE: cacheFile,
-    GSD_PROJECT_VERSION_FILE: projectVersionFile,
-    GSD_GLOBAL_VERSION_FILE: globalVersionFile,
-  },
-});
-
-child.unref();

package/sdk/src/golden/fixtures/profile-sample-sessions/demo-project/sample.jsonl

@@ -1,3 +0,0 @@
-{"type":"user","userType":"external","message":{"content":"profile sample message one"},"timestamp":1700000000000,"cwd":"/fixture/proj"}
-{"type":"assistant","message":{"content":"ok"},"timestamp":1700000000001}
-{"type":"user","userType":"external","message":{"content":"profile sample message two"},"timestamp":1700000000002,"cwd":"/fixture/proj"}