gsd-antigravity-kit 2.0.1 → 2.1.0

package/.agent/skills/gsd/bin/help-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.34.2",
+  "version": "1.37.1",
   "commands": {
     "state": {
       "description": "State operations.",
@@ -141,6 +141,12 @@
     "audit-uat": {
       "description": "Scan all phases for unresolved UAT/verification items"
     },
+    "audit-open": {
+      "description": "Audit-open operations.",
+      "subcommands": {
+        "[--json]": "Scan all .planning/ artifact types for unresolved items"
+      }
+    },
     "intel": {
       "description": "Intel operations.",
       "subcommands": {
@@ -217,5 +223,5 @@
       }
     }
   },
-  "tools_usage": "Commands: state, roadmap, requirements, phase, milestone, todo, workstream,\nfind-phase, resolve-model, commit, verify, template, init, check-commit,\nstats, audit-uat, uat, agent-skills, phases, docs-init, scan-sessions,\nextract-messages, profile-sample, write-profile, generate-antigravity-profile,\ngenerate-antigravity-md, history-digest, progress, scaffold, state-snapshot\n  Run with gsd:help <command> for detailed usage."
+  "tools_usage": "#### Atomic Commands:\n  state load                         Load project config + state\n  state json                         Output STATE.md frontmatter as JSON\n  state update <field> <value>       Update a STATE.md field\n  state get [section]                Get STATE.md content or section\n  state patch --field val ...        Batch update STATE.md fields\n  state begin-phase --phase N --name S --plans C  Update STATE.md for new phase start\n  state signal-waiting --type T --question Q --options \"A|B\" --phase P  Write WAITING.json signal\n  state signal-resume                Remove WAITING.json signal\n  resolve-model <agent-type>         Get model for agent based on profile\n  find-phase <phase>                 Find phase directory by number\n  commit <message> [--files f1 f2] [--no-verify]   Commit planning docs\n  commit-to-subrepo <msg> --files f1 f2  Route commits to sub-repos\n  verify-summary <path>              Verify a SUMMARY.md file\n  generate-slug <text>               Convert text to URL-safe slug\n  current-timestamp [format]         Get timestamp (full|date|filename)\n  list-todos [area]                  Count and enumerate pending todos\n  verify-path-exists <path>          Check file/directory existence\n  config-ensure-section              Initialize .planning/config.json\n  history-digest                     Aggregate all SUMMARY.md data\n  summary-extract <path> [--fields]  Extract structured data from SUMMARY.md\n  state-snapshot                     Structured parse of STATE.md\n  phase-plan-index <phase>           Index plans with waves and status\n  websearch <query>                  Search web via Brave API (if configured)\n[--limit N] [--freshness day|week|month]\n\n#### Phase Operations:\n  phase next-decimal <phase>         Calculate next decimal phase number\n  phase add <description> [--id ID]   Append new phase to roadmap + create dir\n  phase insert <after> <description> Insert decimal phase after existing\n  phase remove <phase> [--force]     Remove phase, renumber all subsequent\n  phase complete <phase>             Mark phase done, update state + roadmap\n\n#### Roadmap Operations:\n  roadmap get-phase <phase>          Extract phase section from ROADMAP.md\n  roadmap analyze                    Full roadmap parse with disk status\n  roadmap update-plan-progress <N>   Update progress table row from disk (PLAN vs SUMMARY counts)\n\n#### Requirements Operations:\n  requirements mark-complete <ids>   Mark requirement IDs as complete in REQUIREMENTS.md\nAccepts: REQ-01,REQ-02 or REQ-01 REQ-02 or [REQ-01, REQ-02]\n\n#### Milestone Operations:\n  milestone complete <version>       Archive milestone, create MILESTONES.md\n[--name <name>]\n[--archive-phases]               Move phase dirs to milestones/vX.Y-phases/\n\n#### Validation:\n  validate consistency               Check phase numbering, disk/roadmap sync\n  validate health [--repair]         Check .planning/ integrity, optionally repair\n  validate agents                    Check GSD agent installation status\n\n#### Progress:\n  progress [json|table|bar]          Render progress in various formats\n\n#### Todos:\n  todo complete <filename>           Move todo from pending to completed\n\n#### UAT Audit:\n  audit-uat                           Scan all phases for unresolved UAT/verification items\n  uat render-checkpoint --file <path> Render the current UAT checkpoint block\n\n#### Open Artifact Audit:\n  audit-open [--json]                 Scan all .planning/ artifact types for unresolved items\n\n#### Intel:\n  intel query <term>             Query intel files for a term\n  intel status                   Show intel file freshness\n  intel update                   Trigger intel refresh (returns agent spawn hint)\n  intel diff                     Show changed intel entries since last snapshot\n  intel snapshot                 Save current intel state as diff baseline\n  intel patch-meta <file>        Update _meta.updated_at in an intel file\n  intel validate                 Validate intel file structure\n  intel extract-exports <file>   Extract exported symbols from a source file\n\n#### Scaffolding:\n  scaffold context --phase <N>       Create CONTEXT.md template\n  scaffold uat --phase <N>           Create UAT.md template\n  scaffold verification --phase <N>  Create VERIFICATION.md template\n  scaffold phase-dir --phase <N>     Create phase directory\n  --name <name>\n\n#### Frontmatter CRUD:\n  frontmatter get <file> [--field k] Extract frontmatter as JSON\n  frontmatter set <file> --field k   Update single frontmatter field\n  --value jsonVal\n  frontmatter merge <file>           Merge JSON into frontmatter\n  --data '{json}'\n  frontmatter validate <file>        Validate required fields\n  --schema plan|summary|verification\n\n#### Verification Suite:\n  verify plan-structure <file>       Check PLAN.md structure + tasks\n  verify phase-completeness <phase>  Check all plans have summaries\n  verify references <file>           Check @-refs + paths resolve\n  verify commits <h1> [h2] ...      Batch verify commit hashes\n  verify artifacts <plan-file>       Check must_haves.artifacts\n  verify key-links <plan-file>       Check must_haves.key_links\n  verify schema-drift <phase> [--skip]  Detect schema file changes without push\n\n#### Template Fill:\n  template fill summary --phase N    Create pre-filled SUMMARY.md\n[--plan M] [--name \"...\"]\n[--fields '{json}']\n  template fill plan --phase N       Create pre-filled PLAN.md\n[--plan M] [--type execute|tdd]\n[--wave N] [--fields '{json}']\n  template fill verification         Create pre-filled VERIFICATION.md\n  --phase N [--fields '{json}']\n\n#### State Progression:\n  state advance-plan                 Increment plan counter\n  state record-metric --phase N      Record execution metrics\n  --plan M --duration Xmin\n[--tasks N] [--files N]\n  state update-progress              Recalculate progress bar\n  state add-decision --summary \"...\"  Add decision to STATE.md\n[--phase N] [--rationale \"...\"]\n[--summary-file path] [--rationale-file path]\n  state add-blocker --text \"...\"     Add blocker\n[--text-file path]\n  state resolve-blocker --text \"...\" Remove blocker\n  state record-session               Update session continuity\n  --stopped-at \"...\"\n[--resume-file path]\n  Compound Commands (workflow-specific initialization):\n  init execute-phase <phase>         All context for execute-phase workflow\n  init plan-phase <phase>            All context for plan-phase workflow\n  init new-project                   All context for new-project workflow\n  init new-milestone                 All context for new-milestone workflow\n  init quick <description>           All context for quick workflow\n  init resume                        All context for resume-project workflow\n  init verify-work <phase>           All context for verify-work workflow\n  init phase-op <phase>              Generic phase operation context\n  init todos [area]                  All context for todo workflows\n  init milestone-op                  All context for milestone operations\n  init map-codebase                  All context for map-codebase workflow\n  init progress                      All context for progress workflow\n\n#### Documentation:\n  docs-init                            Project context for docs-update workflow\n\n#### Learnings:\n  learnings list                       List all global learnings (JSON)\n  learnings query --tag <tag>          Query learnings by tag\n  learnings copy                       Copy from current project's LEARNINGS.md\n  learnings prune --older-than <dur>   Remove entries older than duration (e.g. 90d)\n  learnings delete <id>                Delete a learning by ID\n  GSD-2 Migration:\n  from-gsd2 [--path <dir>] [--force] [--dry-run]\n  Import a GSD-2 (.gsd/) project back to GSD v1 (.planning/) format"
 }

package/.agent/skills/gsd/bin/hooks/gsd-check-update-worker.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+// gsd-hook-version: 1.37.1
+// 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
+.agent/skills/gsd/bin/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/.agent/skills/gsd/bin/hooks/gsd-check-update.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// gsd-hook-version: 1.34.2
+// gsd-hook-version: 1.37.1
 // Check for GSD updates in background, write result to cache
 // Called by SessionStart hook - runs once per session
 
@@ -44,96 +44,21 @@ if (!fs.existsSync(cacheDir)) {
   fs.mkdirSync(cacheDir, { recursive: true });
 }
 
-// Run check in background (spawn background process, windowsHide prevents console flash)
-const child = spawn(process.execPath, ['-e', `
-  const fs = require('fs');
-  const path = require('path');
-  const { execSync } = require('child_process');
-
-  // 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;
-  }
-
-  const cacheFile = ${JSON.stringify(cacheFile)};
-  const projectVersionFile = ${JSON.stringify(projectVersionFile)};
-  const globalVersionFile = ${JSON.stringify(globalVersionFile)};
-
-  // 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
-.agent/skills/gsd/bin/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.js',
-    'gsd-context-monitor.js',
-    'gsd-prompt-guard.js',
-    'gsd-read-guard.js',
-    'gsd-statusline.js',
-    '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');
-            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 = execSync('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
-  };
-
-  fs.writeFileSync(cacheFile, JSON.stringify(result));
-`], {
+// 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
+  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/.agent/skills/gsd/bin/hooks/gsd-context-monitor.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// gsd-hook-version: 1.34.2
+// gsd-hook-version: 1.37.1
 // Context Monitor - PostToolUse/AfterTool hook (Gemini uses AfterTool)
 // Reads context metrics from the statusline bridge file and injects
 // warnings when context usage is high. This makes the AGENT aware of
@@ -21,6 +21,7 @@
 const fs = require('fs');
 const os = require('os');
 const path = require('path');
+const { spawn } = require('child_process');
 
 const WARNING_THRESHOLD = 35;  // remaining_percentage <= 35%
 const CRITICAL_THRESHOLD = 25; // remaining_percentage <= 25%
@@ -52,17 +53,19 @@ process.stdin.on('end', () => {
       process.exit(0);
     }
 
-    // Check if context warnings are disabled via config
+    // Check if context warnings are disabled via config.
+    // Quick sentinel check: skip config read entirely for non-GSD projects (#P2.5).
     const cwd = data.cwd || process.cwd();
-    const configPath = path.join(cwd, '.planning', 'config.json');
-    if (fs.existsSync(configPath)) {
+    const planningDir = path.join(cwd, '.planning');
+    if (fs.existsSync(planningDir)) {
       try {
+        const configPath = path.join(planningDir, 'config.json');
         const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
         if (config.hooks?.context_warnings === false) {
           process.exit(0);
         }
       } catch (e) {
-        // Ignore config parse errors
+        // Ignore config read/parse errors (config may not exist in .planning/)
       }
     }
 
@@ -126,6 +129,32 @@ process.stdin.on('end', () => {
     // Detect if GSD is active (has .planning/STATE.md in working directory)
     const isGsdActive = fs.existsSync(path.join(cwd, '.planning', 'STATE.md'));
 
+    // On CRITICAL with active GSD project, auto-record session state as a
+    // breadcrumb for /gsd-resume-work (#1974). Fire-and-forget subprocess —
+    // doesn't block the hook or the agent. Fires ONCE per CRITICAL session,
+    // guarded by warnData.criticalRecorded to prevent repeated overwrites
+    // of the "crash moment" record on every debounce cycle.
+    if (isCritical && isGsdActive && !warnData.criticalRecorded) {
+      try {
+        // Runtime-agnostic path: this hook lives at <runtime-config>/hooks/
+        // and gsd-tools.cjs lives at <runtime-config>/get-shit-done/bin/.
+        // Using __dirname makes this work on Antigravity, OpenCode, Gemini,
+        // Kilo, etc. without hardcoding ~/.antigravity/.
+        const gsdTools = path.join(__dirname, '..', 'get-shit-done', 'bin', 'gsd-tools.cjs');
+        // Coerce usedPct to a safe number in case bridge file is malformed
+        const safeUsedPct = Number(usedPct) || 0;
+        const stoppedAt = `context exhaustion at ${safeUsedPct}% (${new Date().toISOString().split('T')[0]})`;
+        spawn(
+          process.execPath,
+          [gsdTools, 'state', 'record-session', '--stopped-at', stoppedAt],
+          { cwd, detached: true, stdio: 'ignore' }
+        ).unref();
+        warnData.criticalRecorded = true;
+        // Persist the sentinel so subsequent debounce cycles don't re-fire
+        fs.writeFileSync(warnPath, JSON.stringify(warnData));
+      } catch { /* non-critical — don't let state recording break the hook */ }
+    }
+
     // Build advisory warning message (never use imperative commands that
     // override user preferences — see #884)
     let message;

package/.agent/skills/gsd/bin/hooks/gsd-phase-boundary.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+# gsd-hook-version: 1.37.1
 # gsd-phase-boundary.sh — PostToolUse hook: detect .planning/ file writes
 # Outputs a reminder when planning files are modified outside normal workflow.
 # Uses Node.js for JSON parsing (always available in GSD projects, no jq dependency).

package/.agent/skills/gsd/bin/hooks/gsd-prompt-guard.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// gsd-hook-version: 1.34.2
+// gsd-hook-version: 1.37.1
 // GSD Prompt Injection Guard — PreToolUse hook
 // Scans file content being written to .planning/ for prompt injection patterns.
 // Defense-in-depth: catches injected instructions before they enter agent context.

package/.agent/skills/gsd/bin/hooks/gsd-read-guard.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// gsd-hook-version: 1.34.2
+// gsd-hook-version: 1.37.1
 // GSD Read Guard — PreToolUse hook
 // Injects advisory guidance when Write/Edit targets an existing file,
 // reminding the model to Read the file first.
@@ -36,6 +36,11 @@ process.stdin.on('end', () => {
       process.exit(0);
     }
 
+    // Antigravity natively enforces read-before-edit — skip the advisory (#1984, #2344)
+    if (process.env.ANTIGRAVITY_SESSION_ID || process.env.CLAUDECODE) {
+      process.exit(0);
+    }
+
     const filePath = data.tool_input?.file_path || '';
     if (!filePath) {
       process.exit(0);

package/.agent/skills/gsd/bin/hooks/gsd-session-state.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+# gsd-hook-version: 1.37.1
 # gsd-session-state.sh — SessionStart hook: inject project state reminder
 # Outputs STATE.md head on every session start for orientation.
 #

package/.agent/skills/gsd/bin/hooks/gsd-statusline.js

@@ -1,20 +1,120 @@
 #!/usr/bin/env node
-// gsd-hook-version: 1.34.2
+// gsd-hook-version: 1.37.1
 // Antigravity Statusline - GSD Edition
-// Shows: model | current task | directory | context usage
+// Shows: model | current task (or GSD state) | directory | context usage
 
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-// Read JSON from stdin
-let input = '';
-// Timeout guard: if stdin doesn't close within 3s (e.g. pipe issues on
-// Windows/Git Bash), exit silently instead of hanging. See #775.
-const stdinTimeout = setTimeout(() => process.exit(0), 3000);
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', chunk => input += chunk);
-process.stdin.on('end', () => {
+// --- GSD state reader -------------------------------------------------------
+
+/**
+ * Walk up from dir looking for .planning/STATE.md.
+ * Returns parsed state object or null.
+ */
+function readGsdState(dir) {
+  const home = os.homedir();
+  let current = dir;
+  for (let i = 0; i < 10; i++) {
+    const candidate = path.join(current, '.planning', 'STATE.md');
+    if (fs.existsSync(candidate)) {
+      try {
+        return parseStateMd(fs.readFileSync(candidate, 'utf8'));
+      } catch (e) {
+        return null;
+      }
+    }
+    const parent = path.dirname(current);
+    if (parent === current || current === home) break;
+    current = parent;
+  }
+  return null;
+}
+
+/**
+ * Parse STATE.md frontmatter + Phase line from body.
+ * Returns { status, milestone, milestoneName, phaseNum, phaseTotal, phaseName }
+ */
+function parseStateMd(content) {
+  const state = {};
+
+  // YAML frontmatter between --- markers
+  const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (fmMatch) {
+    for (const line of fmMatch[1].split('\n')) {
+      const m = line.match(/^(\w+):\s*(.+)/);
+      if (!m) continue;
+      const [, key, val] = m;
+      const v = val.trim().replace(/^["']|["']$/g, '');
+      if (key === 'status') state.status = v === 'null' ? null : v;
+      if (key === 'milestone') state.milestone = v === 'null' ? null : v;
+      if (key === 'milestone_name') state.milestoneName = v === 'null' ? null : v;
+    }
+  }
+
+  // Phase: N of M (name)  or  Phase: none active (...)
+  const phaseMatch = content.match(/^Phase:\s*(\d+)\s+of\s+(\d+)(?:\s+\(([^)]+)\))?/m);
+  if (phaseMatch) {
+    state.phaseNum = phaseMatch[1];
+    state.phaseTotal = phaseMatch[2];
+    state.phaseName = phaseMatch[3] || null;
+  }
+
+  // Fallback: parse Status: from body when frontmatter is absent
+  if (!state.status) {
+    const bodyStatus = content.match(/^Status:\s*(.+)/m);
+    if (bodyStatus) {
+      const raw = bodyStatus[1].trim().toLowerCase();
+      if (raw.includes('ready to plan') || raw.includes('planning')) state.status = 'planning';
+      else if (raw.includes('execut')) state.status = 'executing';
+      else if (raw.includes('complet') || raw.includes('archived')) state.status = 'complete';
+    }
+  }
+
+  return state;
+}
+
+/**
+ * Format GSD state into display string.
+ * Format: "v1.9 Code Quality · executing · fix-graphiti-deployment (1/5)"
+ * Gracefully degrades when parts are missing.
+ */
+function formatGsdState(s) {
+  const parts = [];
+
+  // Milestone: version + name (skip placeholder "milestone")
+  if (s.milestone || s.milestoneName) {
+    const ver = s.milestone || '';
+    const name = (s.milestoneName && s.milestoneName !== 'milestone') ? s.milestoneName : '';
+    const ms = [ver, name].filter(Boolean).join(' ');
+    if (ms) parts.push(ms);
+  }
+
+  // Status
+  if (s.status) parts.push(s.status);
+
+  // Phase
+  if (s.phaseNum && s.phaseTotal) {
+    const phase = s.phaseName
+      ? `${s.phaseName} (${s.phaseNum}/${s.phaseTotal})`
+      : `ph ${s.phaseNum}/${s.phaseTotal}`;
+    parts.push(phase);
+  }
+
+  return parts.join(' · ');
+}
+
+// --- stdin ------------------------------------------------------------------
+
+function runStatusline() {
+  let input = '';
+  // Timeout guard: if stdin doesn't close within 3s (e.g. pipe issues on
+  // Windows/Git Bash), exit silently instead of hanging. See #775.
+  const stdinTimeout = setTimeout(() => process.exit(0), 3000);
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', chunk => input += chunk);
+  process.stdin.on('end', () => {
   clearTimeout(stdinTimeout);
   try {
     const data = JSON.parse(input);
@@ -24,9 +124,15 @@ process.stdin.on('end', () => {
     const remaining = data.context_window?.remaining_percentage;
 
     // Context window display (shows USED percentage scaled to usable context)
-    // Antigravity reserves ~16.5% for autocompact buffer, so usable context
-    // is 83.5% of the total window. We normalize to show 100% at that point.
-    const AUTO_COMPACT_BUFFER_PCT = 16.5;
+    // Antigravity reserves a buffer for autocompact. By default this is ~16.5%
+    // of the total window, but users can override it via ANTIGRAVITY_AUTO_COMPACT_WINDOW
+    // (a token count). When the env var is set, compute the buffer % dynamically so
+    // the meter correctly reflects early-compaction configurations (#2219).
+    const totalCtx = data.context_window?.total_tokens || 1_000_000;
+    const acw = parseInt(process.env.ANTIGRAVITY_AUTO_COMPACT_WINDOW || '0', 10);
+    const AUTO_COMPACT_BUFFER_PCT = acw > 0
+      ? Math.min(100, (acw / totalCtx) * 100)
+      : 16.5;
     let ctx = '';
     if (remaining != null) {
       // Normalize: subtract buffer from remaining, scale to usable range
@@ -94,6 +200,9 @@ process.stdin.on('end', () => {
       }
     }
 
+    // GSD state (milestone · status · phase) — shown when no todo task
+    const gsdStateStr = task ? '' : formatGsdState(readGsdState(dir) || {});
+
     // GSD update available?
     // Check shared cache first (#1421), fall back to runtime-specific cache for
     // backward compatibility with older gsd-check-update.js versions.
@@ -108,15 +217,34 @@ process.stdin.on('end', () => {
           gsdUpdate = '\x1b[33m⬆ /gsd-update\x1b[0m │ ';
         }
         if (cache.stale_hooks && cache.stale_hooks.length > 0) {
-          gsdUpdate += '\x1b[31m⚠ stale hooks — run /gsd-update\x1b[0m │ ';
+          // If installed version is ahead of npm latest, this is a dev install.
+          // Running /gsd-update would downgrade — show a contextual warning instead.
+          const isDevInstall = (() => {
+            if (!cache.installed || !cache.latest || cache.latest === 'unknown') return false;
+            const parseV = v => v.replace(/^v/, '').split('.').map(Number);
+            const [ai, bi, ci] = parseV(cache.installed);
+            const [an, bn, cn] = parseV(cache.latest);
+            return ai > an || (ai === an && bi > bn) || (ai === an && bi === bn && ci > cn);
+          })();
+          if (isDevInstall) {
+            gsdUpdate += '\x1b[33m⚠ dev install — re-run installer to sync hooks\x1b[0m │ ';
+          } else {
+            gsdUpdate += '\x1b[31m⚠ stale hooks — run /gsd-update\x1b[0m │ ';
+          }
         }
       } catch (e) {}
     }
 
     // Output
     const dirname = path.basename(dir);
-    if (task) {
-      process.stdout.write(`${gsdUpdate}\x1b[2m${model}\x1b[0m │ \x1b[1m${task}\x1b[0m │ \x1b[2m${dirname}\x1b[0m${ctx}`);
+    const middle = task
+      ? `\x1b[1m${task}\x1b[0m`
+      : gsdStateStr
+        ? `\x1b[2m${gsdStateStr}\x1b[0m`
+        : null;
+
+    if (middle) {
+      process.stdout.write(`${gsdUpdate}\x1b[2m${model}\x1b[0m │ ${middle} │ \x1b[2m${dirname}\x1b[0m${ctx}`);
     } else {
       process.stdout.write(`${gsdUpdate}\x1b[2m${model}\x1b[0m │ \x1b[2m${dirname}\x1b[0m${ctx}`);
     }
@@ -124,3 +252,9 @@ process.stdin.on('end', () => {
     // Silent fail - don't break statusline on parse errors
   }
 });
+}
+
+// Export helpers for unit tests. Harmless when run as a script.
+module.exports = { readGsdState, parseStateMd, formatGsdState };
+
+if (require.main === module) runStatusline();

package/.agent/skills/gsd/bin/hooks/gsd-validate-commit.sh

@@ -1,4 +1,5 @@
 #!/bin/bash
+# gsd-hook-version: 1.37.1
 # gsd-validate-commit.sh — PreToolUse hook: enforce Conventional Commits format
 # Blocks git commit commands with non-conforming messages (exit 2).
 # Allows conforming messages and all non-commit commands (exit 0).

package/.agent/skills/gsd/bin/hooks/gsd-workflow-guard.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// gsd-hook-version: 1.34.2
+// gsd-hook-version: 1.37.1
 // GSD Workflow Guard — PreToolUse hook
 // Detects when Antigravity attempts file edits outside a GSD workflow context
 // (no active /gsd- skill or Task subagent) and injects an advisory warning.