feat(#2089): migrate cursor onto imperative adapter + hook-bus/dispatch upgrades

hooks/gsd-cursor-pre-tool.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+// gsd-hook-version: {{GSD_VERSION}}
+// gsd-cursor-pre-tool.js — Cursor preToolUse hook (ADR-1239 / #2089)
+//
+// Cursor invokes this script before each tool call executes.
+// Protocol: JSON from Cursor on stdin; JSON response on stdout.
+//
+// Input schema (cursor preToolUse):
+//   { tool_name, tool_input, conversation_id, generation_id, model,
+//     hook_event_name, cursor_version, workspace_roots, user_email,
+//     transcript_path }
+//
+// Output schema (cursor preToolUse):
+//   { additional_context?: string, block?: boolean, reason?: string }
+//
+// Behaviour:
+//   - If a write-class tool targets .planning/, reminds the agent to keep
+//     STATE.md current before the write proceeds.
+//   - Fails open: any error silently exits 0 so a hook bug never wedges Cursor.
+//
+// Cursor docs: https://cursor.com/docs/hooks
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const WRITE_TOOL_RE = /write|edit|replace|create|delete|remove|append|apply|patch|insert|mkdir/i;
+const PATH_KEY_RE = /^(path|file|file_?path|filepath|target_?path|target|dir|directory|uri|filename)$/i;
+const PLANNING_PATH_RE = /(^|[\\/])\.planning([\\/]|$)/;
+
+let raw = '';
+const stdinTimeout = setTimeout(() => {
+  process.exit(0);
+}, 10000);
+
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => { raw += chunk; });
+process.stdin.on('end', () => {
+  clearTimeout(stdinTimeout);
+  try {
+    let input;
+    try { input = JSON.parse(raw || '{}'); } catch { process.stdout.write(JSON.stringify({})); return; }
+
+    const toolName = String(
+      input.tool_name || input.toolName || ''
+    ).toLowerCase();
+
+    const isWrite = WRITE_TOOL_RE.test(toolName);
+    if (!isWrite) { process.stdout.write(JSON.stringify({})); return; }
+
+    const paths = [];
+    const walk = (v, depth) => {
+      if (depth > 5 || paths.length > 64) return;
+      if (Array.isArray(v)) { for (const x of v) walk(x, depth + 1); return; }
+      if (v && typeof v === 'object') {
+        for (const k of Object.keys(v)) {
+          const val = v[k];
+          if (typeof val === 'string' && PATH_KEY_RE.test(k)) paths.push(val);
+          else walk(val, depth + 1);
+        }
+      }
+    };
+    walk(input.tool_input || input.toolInput || {}, 0);
+
+    if (paths.some((p) => PLANNING_PATH_RE.test(p))) {
+      process.stdout.write(JSON.stringify({
+        additional_context:
+          'GSD: .planning/ write detected — ensure STATE.md reflects the latest phase and progress after this change.',
+      }));
+      return;
+    }
+  } catch { /* fall through to empty response */ }
+
+  process.stdout.write(JSON.stringify({}));
+});

hooks/gsd-cursor-stop.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+// gsd-hook-version: {{GSD_VERSION}}
+// gsd-cursor-stop.js — Cursor stop hook (ADR-1239 / #2089)
+//
+// Cursor invokes this script when the agent stops responding.
+// Protocol: JSON from Cursor on stdin; JSON response on stdout.
+//
+// Input schema (cursor stop):
+//   { conversation_id, generation_id, model, hook_event_name,
+//     cursor_version, workspace_roots, user_email, transcript_path }
+//
+// Output schema (cursor stop):
+//   { additional_context?: string }
+//
+// Behaviour:
+//   - Reminds the user to verify work if .planning/ is present.
+//   - Fails open: any error silently exits 0.
+//
+// Cursor docs: https://cursor.com/docs/hooks
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+let raw = '';
+const stdinTimeout = setTimeout(() => {
+  process.exit(0);
+}, 10000);
+
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => { raw += chunk; });
+process.stdin.on('end', () => {
+  clearTimeout(stdinTimeout);
+  try {
+    const statePath = path.join(process.cwd(), '.planning', 'STATE.md');
+    if (fs.existsSync(statePath)) {
+      process.stdout.write(JSON.stringify({
+        additional_context:
+          'GSD: Agent stopping — run /gsd:verify-work or /gsd:progress to confirm the phase goal is met before ending the session.',
+      }));
+    } else {
+      process.stdout.write(JSON.stringify({}));
+    }
+  } catch {
+    process.stdout.write(JSON.stringify({}));
+  }
+});

hooks/gsd-cursor-subagent-start.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+// gsd-hook-version: {{GSD_VERSION}}
+// gsd-cursor-subagent-start.js — Cursor subagentStart hook (ADR-1239 / #2089)
+//
+// Cursor invokes this script when a subagent session starts.
+// Protocol: JSON from Cursor on stdin; JSON response on stdout.
+//
+// Input schema (cursor subagentStart):
+//   { session_id, is_background_agent, conversation_id, generation_id,
+//     model, hook_event_name, cursor_version, workspace_roots,
+//     user_email, transcript_path }
+//
+// Output schema (cursor subagentStart):
+//   { additional_context?: string }
+//
+// Behaviour:
+//   - Injects a brief GSD state reminder so subagents (planner, executor,
+//     verifier) have the current phase context.
+//   - Fails open: any error silently exits 0.
+//
+// Cursor docs: https://cursor.com/docs/hooks
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const MSG_PRESENT =
+  'GSD: Subagent session started — review .planning/STATE.md for the current phase and any blockers before acting.';
+const MSG_ABSENT =
+  'GSD: Subagent session started — no .planning/ workflow found.';
+
+let raw = '';
+const stdinTimeout = setTimeout(() => {
+  process.exit(0);
+}, 10000);
+
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => { raw += chunk; });
+process.stdin.on('end', () => {
+  clearTimeout(stdinTimeout);
+  try {
+    const statePath = path.join(process.cwd(), '.planning', 'STATE.md');
+    const statePresent = fs.existsSync(statePath);
+    const msg = statePresent ? MSG_PRESENT : MSG_ABSENT;
+    process.stdout.write(JSON.stringify({ additional_context: msg }));
+  } catch {
+    process.stdout.write(JSON.stringify({}));
+  }
+});

hooks/gsd-cursor-subagent-stop.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+// gsd-hook-version: {{GSD_VERSION}}
+// gsd-cursor-subagent-stop.js — Cursor subagentStop hook (ADR-1239 / #2089)
+//
+// Cursor invokes this script when a subagent session completes.
+// Protocol: JSON from Cursor on stdin; JSON response on stdout.
+//
+// Input schema (cursor subagentStop):
+//   { session_id, conversation_id, generation_id, model, hook_event_name,
+//     cursor_version, workspace_roots, user_email, transcript_path }
+//
+// Output schema (cursor subagentStop):
+//   { additional_context?: string }
+//
+// Behaviour:
+//   - Reminds the orchestrating agent to check the subagent's output.
+//   - Fails open: any error silently exits 0.
+//
+// Cursor docs: https://cursor.com/docs/hooks
+
+'use strict';
+
+let raw = '';
+const stdinTimeout = setTimeout(() => {
+  process.exit(0);
+}, 10000);
+
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', (chunk) => { raw += chunk; });
+process.stdin.on('end', () => {
+  clearTimeout(stdinTimeout);
+  try {
+    process.stdout.write(JSON.stringify({
+      additional_context:
+        'GSD: Subagent completed — review its output and update .planning/STATE.md if the phase progressed.',
+    }));
+  } catch {
+    process.stdout.write(JSON.stringify({}));
+  }
+});