@opengsd/get-shit-done-redux 1.0.0

package/sdk/dist/query-subprocess-adapter.js

@@ -0,0 +1,92 @@
+import { execFile } from 'node:child_process';
+import { isAbsolute, resolve } from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { timeoutMessage } from './query-failure-classification.js';
+export class QuerySubprocessAdapter {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async execJson(command, args) {
+        const fullArgs = this.commandArgs(command, args);
+        return new Promise((resolve, reject) => {
+            const child = execFile(process.execPath, fullArgs, {
+                cwd: this.deps.projectDir,
+                maxBuffer: 10 * 1024 * 1024,
+                timeout: this.deps.timeoutMs,
+                env: { ...process.env },
+            }, async (error, stdout, stderr) => {
+                const stderrStr = stderr?.toString() ?? '';
+                if (error) {
+                    reject(this.processExecutionError(command, args, error, stderrStr));
+                    return;
+                }
+                const raw = stdout?.toString() ?? '';
+                try {
+                    const parsed = await this.parseOutput(raw);
+                    resolve(parsed);
+                }
+                catch (parseErr) {
+                    reject(this.deps.createFailureError(`Failed to parse gsd-tools output for "${command}": ${parseErr instanceof Error ? parseErr.message : String(parseErr)}\nRaw output: ${raw.slice(0, 500)}`, command, args, 0, stderrStr));
+                }
+            });
+            child.on('error', (err) => {
+                reject(this.processSpawnError(command, args, err));
+            });
+        });
+    }
+    async execRaw(command, args) {
+        const fullArgs = [...this.commandArgs(command, args), '--raw'];
+        return new Promise((resolve, reject) => {
+            const child = execFile(process.execPath, fullArgs, {
+                cwd: this.deps.projectDir,
+                maxBuffer: 10 * 1024 * 1024,
+                timeout: this.deps.timeoutMs,
+                env: { ...process.env },
+            }, (error, stdout, stderr) => {
+                const stderrStr = stderr?.toString() ?? '';
+                if (error) {
+                    reject(this.processExecutionError(command, args, error, stderrStr));
+                    return;
+                }
+                resolve((stdout?.toString() ?? '').trim());
+            });
+            child.on('error', (err) => {
+                reject(this.processSpawnError(command, args, err));
+            });
+        });
+    }
+    commandArgs(command, args) {
+        const wsArgs = this.deps.workstream ? ['--ws', this.deps.workstream] : [];
+        return [this.deps.gsdToolsPath, command, ...args, ...wsArgs];
+    }
+    processExecutionError(command, args, error, stderrStr) {
+        if (error.killed || error.code === 'ETIMEDOUT') {
+            return this.deps.createTimeoutError(timeoutMessage(command, args, this.deps.timeoutMs), command, args, stderrStr, this.deps.timeoutMs);
+        }
+        return this.deps.createFailureError(`gsd-tools exited with code ${error.code ?? 'unknown'}: ${command} ${args.join(' ')}${stderrStr ? `\n${stderrStr}` : ''}`, command, args, typeof error.code === 'number' ? error.code : error.status ?? 1, stderrStr);
+    }
+    processSpawnError(command, args, err) {
+        return this.deps.createFailureError(`Failed to execute gsd-tools: ${err.message}`, command, args, null, '');
+    }
+    async parseOutput(raw) {
+        const trimmed = raw.trim();
+        if (trimmed === '') {
+            return null;
+        }
+        let jsonStr = trimmed;
+        if (jsonStr.startsWith('@file:')) {
+            const filePath = jsonStr.slice(6).trim();
+            const resolvedPath = isAbsolute(filePath) ? filePath : resolve(this.deps.projectDir, filePath);
+            try {
+                jsonStr = await readFile(resolvedPath, 'utf-8');
+            }
+            catch (err) {
+                const reason = err instanceof Error ? err.message : String(err);
+                throw new Error(`Failed to read gsd-tools @file: indirection at "${resolvedPath}": ${reason}`);
+            }
+        }
+        return JSON.parse(jsonStr);
+    }
+}
+//# sourceMappingURL=query-subprocess-adapter.js.map

package/sdk/dist/query-subprocess-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-subprocess-adapter.js","sourceRoot":"","sources":["../src/query-subprocess-adapter.ts"],"names":[],"mappings":"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"}

package/sdk/dist/query-tools-error-factory.d.ts

@@ -0,0 +1,16 @@
+import { GSDToolsError } from './gsd-tools-error.js';
+export interface QueryTimeoutErrorFactory {
+    createTimeoutError: (message: string, command: string, args: string[], stderr: string, timeoutMs: number) => GSDToolsError;
+}
+export interface QueryFailureErrorFactory {
+    createFailureError: (message: string, command: string, args: string[], exitCode: number | null, stderr: string) => GSDToolsError;
+}
+export type QueryToolsErrorFactory = QueryTimeoutErrorFactory & QueryFailureErrorFactory;
+export interface QueryNativeErrorFactory {
+    createNativeTimeoutError: (message: string, command: string, args: string[]) => GSDToolsError;
+    createNativeFailureError: (message: string, command: string, args: string[], cause: unknown) => GSDToolsError;
+}
+export declare function toToolsErrorFromUnknown(command: string, args: string[], err: unknown): GSDToolsError;
+export declare function createQueryToolsErrorFactory(): QueryToolsErrorFactory;
+export declare function createQueryNativeErrorFactory(defaultTimeoutMs: number): QueryNativeErrorFactory;
+//# sourceMappingURL=query-tools-error-factory.d.ts.map

package/sdk/dist/query-tools-error-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-tools-error-factory.d.ts","sourceRoot":"","sources":["../src/query-tools-error-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,WAAW,wBAAwB;IACvC,kBAAkB,EAAE,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,KACd,aAAa,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,kBAAkB,EAAE,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,MAAM,KACX,aAAa,CAAC;CACpB;AAED,MAAM,MAAM,sBAAsB,GAAG,wBAAwB,GAAG,wBAAwB,CAAC;AAEzF,MAAM,WAAW,uBAAuB;IACtC,wBAAwB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,aAAa,CAAC;IAC9F,wBAAwB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,KAAK,aAAa,CAAC;CAC/G;AAiBD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,GAAG,aAAa,CAWpG;AAED,wBAAgB,4BAA4B,IAAI,sBAAsB,CAOrE;AAED,wBAAgB,6BAA6B,CAAC,gBAAgB,EAAE,MAAM,GAAG,uBAAuB,CAO/F"}

package/sdk/dist/query-tools-error-factory.js

@@ -0,0 +1,33 @@
+import { GSDError, exitCodeFor } from './errors.js';
+import { GSDToolsError } from './gsd-tools-error.js';
+import { errorMessage, toFailureSignal } from './query-failure-classification.js';
+function timeoutToolsError(message, command, args, stderr = '', timeoutMs) {
+    return GSDToolsError.timeout(message, command, args, stderr, timeoutMs);
+}
+function failureToolsError(message, command, args, exitCode, stderr = '', cause) {
+    return GSDToolsError.failure(message, command, args, exitCode, stderr, cause === undefined ? undefined : { cause });
+}
+export function toToolsErrorFromUnknown(command, args, err) {
+    if (err instanceof GSDError) {
+        return failureToolsError(err.message, command, args, exitCodeFor(err.classification), '', err);
+    }
+    const msg = errorMessage(err);
+    const signal = toFailureSignal(err);
+    if (signal.kind === 'timeout') {
+        return timeoutToolsError(msg, command, args, '', signal.timeoutMs);
+    }
+    return failureToolsError(msg, command, args, 1, '', err instanceof Error ? err : undefined);
+}
+export function createQueryToolsErrorFactory() {
+    return {
+        createTimeoutError: (message, command, args, stderr, timeoutMs) => timeoutToolsError(message, command, args, stderr, timeoutMs),
+        createFailureError: (message, command, args, exitCode, stderr) => failureToolsError(message, command, args, exitCode, stderr),
+    };
+}
+export function createQueryNativeErrorFactory(defaultTimeoutMs) {
+    return {
+        createNativeTimeoutError: (message, command, args) => timeoutToolsError(message, command, args, '', defaultTimeoutMs),
+        createNativeFailureError: (message, command, args, cause) => failureToolsError(message, command, args, 1, '', cause),
+    };
+}
+//# sourceMappingURL=query-tools-error-factory.js.map

package/sdk/dist/query-tools-error-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-tools-error-factory.js","sourceRoot":"","sources":["../src/query-tools-error-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AA6BlF,SAAS,iBAAiB,CAAC,OAAe,EAAE,OAAe,EAAE,IAAc,EAAE,MAAM,GAAG,EAAE,EAAE,SAAkB;IAC1G,OAAO,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,iBAAiB,CACxB,OAAe,EACf,OAAe,EACf,IAAc,EACd,QAAuB,EACvB,MAAM,GAAG,EAAE,EACX,KAAe;IAEf,OAAO,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACtH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAE,IAAc,EAAE,GAAY;IACnF,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;QAC5B,OAAO,iBAAiB,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IACjG,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,kBAAkB,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,CAChE,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC;QAC9D,kBAAkB,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,CAC/D,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,gBAAwB;IACpE,OAAO;QACL,wBAAwB,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CACnD,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,gBAAgB,CAAC;QACjE,wBAAwB,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAC1D,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/sdk/dist/research-gate.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Research gate — validates RESEARCH.md for unresolved open questions
+ * before allowing plan-phase to proceed (#1602).
+ *
+ * Pure functions: no I/O, no side effects. The caller reads the file
+ * and passes the content string.
+ */
+export interface ResearchGateResult {
+    /** Whether research is clear to proceed to planning */
+    pass: boolean;
+    /** Unresolved questions found (empty if pass=true) */
+    unresolvedQuestions: string[];
+}
+/**
+ * Check RESEARCH.md content for unresolved open questions.
+ *
+ * Rules:
+ * - If no "## Open Questions" section exists → pass
+ * - If section header has "(RESOLVED)" suffix → pass
+ * - If section exists but is empty (only whitespace before next heading) → pass
+ * - Otherwise → fail with list of unresolved questions
+ */
+export declare function checkResearchGate(researchContent: string): ResearchGateResult;
+//# sourceMappingURL=research-gate.d.ts.map

package/sdk/dist/research-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-gate.d.ts","sourceRoot":"","sources":["../src/research-gate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,IAAI,EAAE,OAAO,CAAC;IACd,sDAAsD;IACtD,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAID;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,kBAAkB,CAiE7E"}

package/sdk/dist/research-gate.js

@@ -0,0 +1,70 @@
+/**
+ * Research gate — validates RESEARCH.md for unresolved open questions
+ * before allowing plan-phase to proceed (#1602).
+ *
+ * Pure functions: no I/O, no side effects. The caller reads the file
+ * and passes the content string.
+ */
+// ─── Open questions detection ───────────────────────────────────────────────
+/**
+ * Check RESEARCH.md content for unresolved open questions.
+ *
+ * Rules:
+ * - If no "## Open Questions" section exists → pass
+ * - If section header has "(RESOLVED)" suffix → pass
+ * - If section exists but is empty (only whitespace before next heading) → pass
+ * - Otherwise → fail with list of unresolved questions
+ */
+export function checkResearchGate(researchContent) {
+    // Find "## Open Questions" section (case-insensitive)
+    const sectionMatch = researchContent.match(/^##\s+Open\s+Questions\b([^\n]*)/im);
+    if (!sectionMatch) {
+        return { pass: true, unresolvedQuestions: [] };
+    }
+    // Check for (RESOLVED) suffix on the heading
+    const headingSuffix = sectionMatch[1].trim();
+    if (/\(resolved\)/i.test(headingSuffix)) {
+        return { pass: true, unresolvedQuestions: [] };
+    }
+    // Extract section content until next heading or EOF
+    const headingIndex = researchContent.indexOf(sectionMatch[0]);
+    const afterHeading = researchContent.slice(headingIndex + sectionMatch[0].length);
+    // Find next heading at same or higher level
+    const nextHeadingMatch = afterHeading.match(/\n##\s+[^\n]/);
+    const sectionBody = nextHeadingMatch
+        ? afterHeading.slice(0, nextHeadingMatch.index)
+        : afterHeading;
+    // Extract question items (numbered list or bullet points)
+    const unresolvedQuestions = [];
+    let totalQuestionLines = 0;
+    const lines = sectionBody.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Match: "1. **Question**", "- **Question**", "* **Question**", "1. Question"
+        const questionMatch = trimmed.match(/^(?:\d+[.)]\s*|\*\s+|-\s+)\*{0,2}([^*\n]+)\*{0,2}/);
+        if (questionMatch) {
+            totalQuestionLines++;
+            const questionText = questionMatch[1].trim();
+            // Skip questions marked as resolved inline (handles — RESOLVED, - RESOLVED, RESOLVED:, etc.)
+            if (!/\bresolved\b/i.test(trimmed)) {
+                unresolvedQuestions.push(questionText);
+            }
+        }
+    }
+    // Empty section body → pass
+    if (sectionBody.trim() === '') {
+        return { pass: true, unresolvedQuestions: [] };
+    }
+    // All question lines were resolved → pass
+    if (totalQuestionLines > 0 && unresolvedQuestions.length === 0) {
+        return { pass: true, unresolvedQuestions: [] };
+    }
+    // Unresolved questions found → fail
+    if (unresolvedQuestions.length > 0) {
+        return { pass: false, unresolvedQuestions };
+    }
+    // Section has content but no parseable question lines → fail conservatively
+    // (e.g., prose-style questions without list formatting)
+    return { pass: false, unresolvedQuestions: ['(unstructured open questions detected — review ## Open Questions section)'] };
+}
+//# sourceMappingURL=research-gate.js.map

package/sdk/dist/research-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-gate.js","sourceRoot":"","sources":["../src/research-gate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,eAAuB;IACvD,sDAAsD;IACtD,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CACxC,oCAAoC,CACrC,CAAC;IAEF,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC;IACjD,CAAC;IAED,6CAA6C;IAC7C,MAAM,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC;IACjD,CAAC;IAED,oDAAoD;IACpD,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,YAAY,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAElF,4CAA4C;IAC5C,MAAM,gBAAgB,GAAG,YAAY,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,gBAAgB;QAClC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC;QAC/C,CAAC,CAAC,YAAY,CAAC;IAEjB,0DAA0D;IAC1D,MAAM,mBAAmB,GAAa,EAAE,CAAC;IACzC,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,8EAA8E;QAC9E,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CACjC,mDAAmD,CACpD,CAAC;QACF,IAAI,aAAa,EAAE,CAAC;YAClB,kBAAkB,EAAE,CAAC;YACrB,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7C,6FAA6F;YAC7F,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnC,mBAAmB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC;IACjD,CAAC;IAED,0CAA0C;IAC1C,IAAI,kBAAkB,GAAG,CAAC,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC;IACjD,CAAC;IAED,oCAAoC;IACpC,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC9C,CAAC;IAED,4EAA4E;IAC5E,wDAAwD;IACxD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,2EAA2E,CAAC,EAAE,CAAC;AAC7H,CAAC"}

package/sdk/dist/runtime-bridge-sync/index.d.ts

@@ -0,0 +1,96 @@
+/**
+ * executeForCjs — synchronous SDK runtime bridge primitive.
+ *
+ * Provides a synchronous `executeForCjs()` function that CJS callers can use
+ * to invoke any registered SDK command without dealing with async/await or
+ * top-level-await restrictions that prevent CJS from using the async bridge.
+ *
+ * ## Mechanism
+ *
+ * Uses `synckit` (Atomics.wait + SharedArrayBuffer + worker_threads) to run
+ * the async `QueryRuntimeBridge.execute()` in a worker thread and block the
+ * calling thread until the result is available. The worker is spawned lazily
+ * on first call and reused for all subsequent calls.
+ *
+ * ## Worker overhead
+ *
+ * - First call (worker startup + native bridge construction): ~80 ms.
+ * - Subsequent calls (steady state): ~0.1 ms per call (excluding handler work).
+ *
+ * ## CRITICAL: Do NOT call from an async context
+ *
+ * `executeForCjs` uses `Atomics.wait` under the hood, which **blocks the
+ * calling thread**. Calling it from inside an async function that is itself
+ * running on the Node.js main thread event loop will **deadlock** because
+ * the event loop cannot process the worker's response message while blocked.
+ *
+ * Safe callers:
+ * - CJS modules evaluated at require-time (synchronous module initialisation).
+ * - Worker threads that are not using the event loop.
+ *
+ * Unsafe callers:
+ * - Any `async function` on the main thread.
+ * - Anything inside a `Promise` callback on the main thread.
+ *
+ * ## CJS consumption
+ *
+ * ```js
+ * const { executeForCjs } = require('@opengsd/gsd-sdk/dist/runtime-bridge-sync/index.js');
+ * const result = executeForCjs({ registryCommand: 'generate-slug', registryArgs: ['My Phase'], ... });
+ * if (result.ok) console.log(result.data); // { slug: 'my-phase' }
+ * ```
+ *
+ * @module runtime-bridge-sync
+ */
+import type { RuntimeBridgeExecuteInput } from '../query-runtime-bridge.js';
+export type { RuntimeBridgeExecuteInput };
+export type ExecuteForCjsInput = RuntimeBridgeExecuteInput;
+/**
+ * The 6 canonical error kinds from ADR-0001 Dispatch Policy Module.
+ */
+export type SyncErrorKind = 'unknown_command' | 'native_failure' | 'native_timeout' | 'fallback_failure' | 'validation_error' | 'internal_error';
+/**
+ * Discriminated union returned by `executeForCjs`.
+ *
+ * - `ok: true` — command executed successfully. `data` is the handler's return value.
+ * - `ok: false` — command failed. `errorKind` identifies the failure category.
+ */
+export type RuntimeBridgeSyncResult = {
+    ok: true;
+    data: unknown;
+    exitCode: 0;
+} | {
+    ok: false;
+    exitCode: number;
+    errorKind: SyncErrorKind;
+    errorDetails?: unknown;
+    stderrLines: string[];
+};
+/**
+ * Execute a registered SDK command synchronously.
+ *
+ * This function blocks the calling thread until the command completes.
+ * It must NOT be called from an async context on the main event-loop thread
+ * (see module-level JSDoc for details).
+ *
+ * @param input - The command input, matching RuntimeBridgeExecuteInput.
+ * @returns A RuntimeBridgeSyncResult — either ok:true with data, or ok:false with errorKind.
+ *
+ * @example
+ * ```js
+ * const { executeForCjs } = require('@opengsd/gsd-sdk/dist/runtime-bridge-sync/index.js');
+ * const result = executeForCjs({
+ *   registryCommand: 'generate-slug',
+ *   registryArgs: ['My Phase'],
+ *   legacyCommand: 'generate-slug',
+ *   legacyArgs: ['My Phase'],
+ *   mode: 'json',
+ *   projectDir: '/path/to/project',
+ * });
+ * if (result.ok) {
+ *   console.log(result.data.slug); // 'my-phase'
+ * }
+ * ```
+ */
+export declare function executeForCjs(input: RuntimeBridgeExecuteInput): RuntimeBridgeSyncResult;
+//# sourceMappingURL=index.d.ts.map

package/sdk/dist/runtime-bridge-sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime-bridge-sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAKH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAG5E,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAG1C,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAI3D;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,CAAC;AAErB;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAA;CAAE,GACxC;IACE,EAAE,EAAE,KAAK,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AA0CN;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,yBAAyB,GAAG,uBAAuB,CAEvF"}

package/sdk/dist/runtime-bridge-sync/index.js

@@ -0,0 +1,109 @@
+/**
+ * executeForCjs — synchronous SDK runtime bridge primitive.
+ *
+ * Provides a synchronous `executeForCjs()` function that CJS callers can use
+ * to invoke any registered SDK command without dealing with async/await or
+ * top-level-await restrictions that prevent CJS from using the async bridge.
+ *
+ * ## Mechanism
+ *
+ * Uses `synckit` (Atomics.wait + SharedArrayBuffer + worker_threads) to run
+ * the async `QueryRuntimeBridge.execute()` in a worker thread and block the
+ * calling thread until the result is available. The worker is spawned lazily
+ * on first call and reused for all subsequent calls.
+ *
+ * ## Worker overhead
+ *
+ * - First call (worker startup + native bridge construction): ~80 ms.
+ * - Subsequent calls (steady state): ~0.1 ms per call (excluding handler work).
+ *
+ * ## CRITICAL: Do NOT call from an async context
+ *
+ * `executeForCjs` uses `Atomics.wait` under the hood, which **blocks the
+ * calling thread**. Calling it from inside an async function that is itself
+ * running on the Node.js main thread event loop will **deadlock** because
+ * the event loop cannot process the worker's response message while blocked.
+ *
+ * Safe callers:
+ * - CJS modules evaluated at require-time (synchronous module initialisation).
+ * - Worker threads that are not using the event loop.
+ *
+ * Unsafe callers:
+ * - Any `async function` on the main thread.
+ * - Anything inside a `Promise` callback on the main thread.
+ *
+ * ## CJS consumption
+ *
+ * ```js
+ * const { executeForCjs } = require('@opengsd/gsd-sdk/dist/runtime-bridge-sync/index.js');
+ * const result = executeForCjs({ registryCommand: 'generate-slug', registryArgs: ['My Phase'], ... });
+ * if (result.ok) console.log(result.data); // { slug: 'my-phase' }
+ * ```
+ *
+ * @module runtime-bridge-sync
+ */
+import { createSyncFn } from 'synckit';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+// ─── Lazy sync-fn factory ──────────────────────────────────────────────────
+// Resolve worker path to the compiled dist artifact.
+//
+// The worker MUST be the compiled JS file (dist/runtime-bridge-sync/worker.js),
+// NOT the TypeScript source. This is because:
+// 1. synckit spawns the worker via Node.js directly (no tsx transform).
+// 2. When vitest runs tests from the TS source tree, import.meta.url points to
+//    src/, not dist/. We must redirect to dist/ in all cases.
+//
+// Strategy: navigate from the current file's directory to the package root,
+// then resolve to dist/runtime-bridge-sync/worker.js.
+// The current file lives either in:
+//   src/runtime-bridge-sync/ (vitest TS source context)
+//   dist/runtime-bridge-sync/ (compiled CJS/ESM consumer context)
+// In both cases, two levels up is the package root (sdk/).
+const _moduleUrl = import.meta.url;
+function resolveWorkerPath() {
+    const currentDir = dirname(fileURLToPath(_moduleUrl));
+    // currentDir is either src/runtime-bridge-sync or dist/runtime-bridge-sync.
+    // Two levels up is the sdk/ package root.
+    const pkgRoot = join(currentDir, '..', '..');
+    return join(pkgRoot, 'dist', 'runtime-bridge-sync', 'worker.js');
+}
+let _syncFn = null;
+function getSyncFn() {
+    if (_syncFn)
+        return _syncFn;
+    const workerPath = resolveWorkerPath();
+    _syncFn = createSyncFn(workerPath, { timeout: 60_000 });
+    return _syncFn;
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Execute a registered SDK command synchronously.
+ *
+ * This function blocks the calling thread until the command completes.
+ * It must NOT be called from an async context on the main event-loop thread
+ * (see module-level JSDoc for details).
+ *
+ * @param input - The command input, matching RuntimeBridgeExecuteInput.
+ * @returns A RuntimeBridgeSyncResult — either ok:true with data, or ok:false with errorKind.
+ *
+ * @example
+ * ```js
+ * const { executeForCjs } = require('@opengsd/gsd-sdk/dist/runtime-bridge-sync/index.js');
+ * const result = executeForCjs({
+ *   registryCommand: 'generate-slug',
+ *   registryArgs: ['My Phase'],
+ *   legacyCommand: 'generate-slug',
+ *   legacyArgs: ['My Phase'],
+ *   mode: 'json',
+ *   projectDir: '/path/to/project',
+ * });
+ * if (result.ok) {
+ *   console.log(result.data.slug); // 'my-phase'
+ * }
+ * ```
+ */
+export function executeForCjs(input) {
+    return getSyncFn()(input);
+}
+//# sourceMappingURL=index.js.map

package/sdk/dist/runtime-bridge-sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime-bridge-sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAsC1C,8EAA8E;AAE9E,qDAAqD;AACrD,EAAE;AACF,gFAAgF;AAChF,8CAA8C;AAC9C,wEAAwE;AACxE,+EAA+E;AAC/E,8DAA8D;AAC9D,EAAE;AACF,4EAA4E;AAC5E,sDAAsD;AACtD,oCAAoC;AACpC,wDAAwD;AACxD,kEAAkE;AAClE,2DAA2D;AAC3D,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;AAEnC,SAAS,iBAAiB;IACxB,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IACtD,4EAA4E;IAC5E,0CAA0C;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,WAAW,CAAC,CAAC;AACnE,CAAC;AAED,IAAI,OAAO,GAA2E,IAAI,CAAC;AAE3F,SAAS,SAAS;IAChB,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,OAAO,GAAG,YAAY,CACpB,UAAU,EACV,EAAE,OAAO,EAAE,MAAM,EAAE,CACpB,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,aAAa,CAAC,KAAgC;IAC5D,OAAO,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/sdk/dist/runtime-bridge-sync/worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/sdk/dist/runtime-bridge-sync/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/runtime-bridge-sync/worker.ts"],"names":[],"mappings":""}