@opengsd/get-shit-done-redux 1.0.0

package/sdk/dist/event-stream.js

@@ -0,0 +1,321 @@
+/**
+ * GSD Event Stream — maps SDKMessage variants to typed GSD events.
+ *
+ * Extends EventEmitter to provide a typed event bus. Includes:
+ * - SDKMessage → GSDEvent mapping
+ * - Transport management (subscribe/unsubscribe handlers)
+ * - Per-session cost tracking with cumulative totals
+ */
+import { EventEmitter } from 'node:events';
+import { GSDEventType, } from './types.js';
+// ─── GSDEventStream ──────────────────────────────────────────────────────────
+export class GSDEventStream extends EventEmitter {
+    transports = new Set();
+    costTracker = {
+        sessions: new Map(),
+        cumulativeCostUsd: 0,
+    };
+    constructor() {
+        super();
+        this.setMaxListeners(20);
+    }
+    // ─── Transport management ────────────────────────────────────────────
+    /** Subscribe a transport handler to receive all events. */
+    addTransport(handler) {
+        this.transports.add(handler);
+    }
+    /** Unsubscribe a transport handler. */
+    removeTransport(handler) {
+        this.transports.delete(handler);
+    }
+    /** Close all transports. */
+    closeAll() {
+        for (const transport of this.transports) {
+            try {
+                transport.close();
+            }
+            catch {
+                // Ignore transport close errors
+            }
+        }
+        this.transports.clear();
+    }
+    // ─── Event emission ──────────────────────────────────────────────────
+    /** Emit a typed GSD event to all listeners and transports. */
+    emitEvent(event) {
+        // Emit via EventEmitter for listener-based consumers
+        this.emit('event', event);
+        this.emit(event.type, event);
+        // Deliver to all transports — wrap in try/catch to prevent
+        // one bad transport from killing the stream
+        for (const transport of this.transports) {
+            try {
+                transport.onEvent(event);
+            }
+            catch {
+                // Silently ignore transport errors
+            }
+        }
+    }
+    // ─── SDKMessage mapping ──────────────────────────────────────────────
+    /**
+     * Map an SDKMessage to a GSDEvent.
+     * Returns null for non-actionable message types (user messages, replays, etc.).
+     */
+    mapSDKMessage(msg, context = {}) {
+        const base = {
+            timestamp: new Date().toISOString(),
+            sessionId: 'session_id' in msg ? msg.session_id : '',
+            phase: context.phase,
+            planName: context.planName,
+        };
+        switch (msg.type) {
+            case 'system':
+                return this.mapSystemMessage(msg, base);
+            case 'assistant':
+                return this.mapAssistantMessage(msg, base);
+            case 'result':
+                return this.mapResultMessage(msg, base);
+            case 'tool_progress':
+                return this.mapToolProgressMessage(msg, base);
+            case 'tool_use_summary':
+                return this.mapToolUseSummaryMessage(msg, base);
+            case 'rate_limit_event':
+                return this.mapRateLimitMessage(msg, base);
+            case 'stream_event':
+                return this.mapStreamEvent(msg, base);
+            // Non-actionable message types — ignore
+            case 'user':
+            case 'auth_status':
+            case 'prompt_suggestion':
+                return null;
+            default:
+                return null;
+        }
+    }
+    /**
+     * Map an SDKMessage and emit the resulting event (if any).
+     * Convenience method combining mapSDKMessage + emitEvent.
+     */
+    mapAndEmit(msg, context = {}) {
+        const event = this.mapSDKMessage(msg, context);
+        if (event) {
+            this.emitEvent(event);
+        }
+        return event;
+    }
+    // ─── Cost tracking ───────────────────────────────────────────────────
+    /** Get current cost totals. */
+    getCost() {
+        const activeId = this.costTracker.activeSessionId;
+        const sessionCost = activeId
+            ? (this.costTracker.sessions.get(activeId)?.costUsd ?? 0)
+            : 0;
+        return {
+            session: sessionCost,
+            cumulative: this.costTracker.cumulativeCostUsd,
+        };
+    }
+    /** Update cost for a session. */
+    updateCost(sessionId, costUsd) {
+        const existing = this.costTracker.sessions.get(sessionId);
+        const previousCost = existing?.costUsd ?? 0;
+        const delta = costUsd - previousCost;
+        const bucket = { sessionId, costUsd };
+        this.costTracker.sessions.set(sessionId, bucket);
+        this.costTracker.activeSessionId = sessionId;
+        this.costTracker.cumulativeCostUsd += delta;
+    }
+    // ─── Private mappers ─────────────────────────────────────────────────
+    mapSystemMessage(msg, base) {
+        // All system messages have a subtype
+        const subtype = msg.subtype;
+        switch (subtype) {
+            case 'init': {
+                const initMsg = msg;
+                return {
+                    ...base,
+                    type: GSDEventType.SessionInit,
+                    model: initMsg.model,
+                    tools: initMsg.tools,
+                    cwd: initMsg.cwd,
+                };
+            }
+            case 'api_retry': {
+                const retryMsg = msg;
+                return {
+                    ...base,
+                    type: GSDEventType.APIRetry,
+                    attempt: retryMsg.attempt,
+                    maxRetries: retryMsg.max_retries,
+                    retryDelayMs: retryMsg.retry_delay_ms,
+                    errorStatus: retryMsg.error_status,
+                };
+            }
+            case 'status': {
+                const statusMsg = msg;
+                return {
+                    ...base,
+                    type: GSDEventType.StatusChange,
+                    status: statusMsg.status,
+                };
+            }
+            case 'compact_boundary': {
+                const compactMsg = msg;
+                return {
+                    ...base,
+                    type: GSDEventType.CompactBoundary,
+                    trigger: compactMsg.compact_metadata.trigger,
+                    preTokens: compactMsg.compact_metadata.pre_tokens,
+                };
+            }
+            case 'task_started': {
+                const taskMsg = msg;
+                return {
+                    ...base,
+                    type: GSDEventType.TaskStarted,
+                    taskId: taskMsg.task_id,
+                    description: taskMsg.description,
+                    taskType: taskMsg.task_type,
+                };
+            }
+            case 'task_progress': {
+                const progressMsg = msg;
+                return {
+                    ...base,
+                    type: GSDEventType.TaskProgress,
+                    taskId: progressMsg.task_id,
+                    description: progressMsg.description,
+                    totalTokens: progressMsg.usage.total_tokens,
+                    toolUses: progressMsg.usage.tool_uses,
+                    durationMs: progressMsg.usage.duration_ms,
+                    lastToolName: progressMsg.last_tool_name,
+                };
+            }
+            case 'task_notification': {
+                const notifMsg = msg;
+                return {
+                    ...base,
+                    type: GSDEventType.TaskNotification,
+                    taskId: notifMsg.task_id,
+                    status: notifMsg.status,
+                    summary: notifMsg.summary,
+                };
+            }
+            // Non-actionable system subtypes
+            case 'hook_started':
+            case 'hook_progress':
+            case 'hook_response':
+            case 'local_command_output':
+            case 'session_state_changed':
+            case 'files_persisted':
+            case 'elicitation_complete':
+                return null;
+            default:
+                return null;
+        }
+    }
+    mapAssistantMessage(msg, base) {
+        const events = [];
+        // Extract text blocks — content blocks are a discriminated union with a 'type' field.
+        // Double-cast via unknown because BetaContentBlock's internal variants don't
+        // carry an index signature, so TS rejects the direct cast without a widening step.
+        const content = msg.message.content;
+        const textBlocks = content.filter((b) => b.type === 'text');
+        if (textBlocks.length > 0) {
+            const text = textBlocks.map(b => b.text).join('');
+            if (text.length > 0) {
+                events.push({
+                    ...base,
+                    type: GSDEventType.AssistantText,
+                    text,
+                });
+            }
+        }
+        // Extract tool_use blocks
+        const toolUseBlocks = content.filter((b) => b.type === 'tool_use');
+        for (const block of toolUseBlocks) {
+            events.push({
+                ...base,
+                type: GSDEventType.ToolCall,
+                toolName: block.name,
+                toolUseId: block.id,
+                input: block.input,
+            });
+        }
+        // Return the first event — for multi-event messages, emit the rest
+        // via separate emitEvent calls. This preserves the single-return contract
+        // while still handling multi-block messages.
+        if (events.length === 0)
+            return null;
+        if (events.length === 1)
+            return events[0];
+        // For multi-event assistant messages, emit all but the last directly,
+        // and return the last one for the caller to handle
+        for (let i = 0; i < events.length - 1; i++) {
+            this.emitEvent(events[i]);
+        }
+        return events[events.length - 1];
+    }
+    mapResultMessage(msg, base) {
+        // Update cost tracking
+        this.updateCost(msg.session_id, msg.total_cost_usd);
+        if (msg.subtype === 'success') {
+            const successMsg = msg;
+            return {
+                ...base,
+                type: GSDEventType.SessionComplete,
+                success: true,
+                totalCostUsd: successMsg.total_cost_usd,
+                durationMs: successMsg.duration_ms,
+                numTurns: successMsg.num_turns,
+                result: successMsg.result,
+            };
+        }
+        const errorMsg = msg;
+        return {
+            ...base,
+            type: GSDEventType.SessionError,
+            success: false,
+            totalCostUsd: errorMsg.total_cost_usd,
+            durationMs: errorMsg.duration_ms,
+            numTurns: errorMsg.num_turns,
+            errorSubtype: errorMsg.subtype,
+            errors: errorMsg.errors,
+        };
+    }
+    mapToolProgressMessage(msg, base) {
+        return {
+            ...base,
+            type: GSDEventType.ToolProgress,
+            toolName: msg.tool_name,
+            toolUseId: msg.tool_use_id,
+            elapsedSeconds: msg.elapsed_time_seconds,
+        };
+    }
+    mapToolUseSummaryMessage(msg, base) {
+        return {
+            ...base,
+            type: GSDEventType.ToolUseSummary,
+            summary: msg.summary,
+            toolUseIds: msg.preceding_tool_use_ids,
+        };
+    }
+    mapRateLimitMessage(msg, base) {
+        return {
+            ...base,
+            type: GSDEventType.RateLimit,
+            status: msg.rate_limit_info.status,
+            resetsAt: msg.rate_limit_info.resetsAt,
+            utilization: msg.rate_limit_info.utilization,
+        };
+    }
+    mapStreamEvent(msg, base) {
+        return {
+            ...base,
+            type: GSDEventType.StreamEvent,
+            event: msg.event,
+        };
+    }
+}
+//# sourceMappingURL=event-stream.js.map

package/sdk/dist/event-stream.js.map

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

package/sdk/dist/golden/capture.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Golden test helpers — run `gsd-tools.cjs` as a subprocess and capture JSON or raw stdout.
+ *
+ * Used by `golden.integration.test.ts` and `read-only-parity.integration.test.ts` to assert
+ * SDK `createRegistry()` output matches the legacy CJS CLI.
+ */
+/**
+ * Run `node gsd-tools.cjs <command> [...args]` in `projectDir` and parse stdout as JSON.
+ */
+export declare function captureGsdToolsOutput(command: string, args: string[], projectDir: string): Promise<unknown>;
+/**
+ * Run `node gsd-tools.cjs <command> [...args]` and return raw stdout (no JSON parse).
+ */
+export declare function captureGsdToolsStdout(command: string, args: string[], projectDir: string): Promise<string>;
+//# sourceMappingURL=capture.d.ts.map

package/sdk/dist/golden/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/golden/capture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmEH;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/sdk/dist/golden/capture.js

@@ -0,0 +1,67 @@
+/**
+ * Golden test helpers — run `gsd-tools.cjs` as a subprocess and capture JSON or raw stdout.
+ *
+ * Used by `golden.integration.test.ts` and `read-only-parity.integration.test.ts` to assert
+ * SDK `createRegistry()` output matches the legacy CJS CLI.
+ */
+import { execFile } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { isAbsolute, join } from 'node:path';
+import { resolveGsdToolsPath } from '../gsd-tools.js';
+const CAPTURE_TIMEOUT_MS = 120_000;
+const MAX_BUFFER = 10 * 1024 * 1024;
+function execGsdTools(projectDir, command, args) {
+    const script = resolveGsdToolsPath(projectDir);
+    const fullArgs = [script, command, ...args];
+    return new Promise((resolve, reject) => {
+        execFile(process.execPath, fullArgs, {
+            cwd: projectDir,
+            maxBuffer: MAX_BUFFER,
+            timeout: CAPTURE_TIMEOUT_MS,
+            env: { ...process.env },
+        }, (err, stdout, stderr) => {
+            if (err) {
+                const code = typeof err === 'object' && err && 'code' in err ? String(err.code) : '';
+                const stderrStr = stderr?.toString() ?? '';
+                reject(new Error(`gsd-tools failed (exit ${code}): ${stderrStr || (err instanceof Error ? err.message : String(err))}`));
+                return;
+            }
+            resolve({ stdout: stdout?.toString() ?? '', stderr: stderr?.toString() ?? '' });
+        });
+    });
+}
+/** Same `@file:` indirection handling as {@link GSDTools} private parseOutput (cwd = projectDir). */
+async function parseGsdToolsJson(raw, projectDir) {
+    const trimmed = raw.trim();
+    if (trimmed === '') {
+        return null;
+    }
+    let jsonStr = trimmed;
+    if (jsonStr.startsWith('@file:')) {
+        const rel = jsonStr.slice(6).trim();
+        const filePath = isAbsolute(rel) ? rel : join(projectDir, rel);
+        try {
+            jsonStr = await readFile(filePath, 'utf-8');
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            throw new Error(`Failed to read gsd-tools @file: indirection at "${filePath}": ${reason}`);
+        }
+    }
+    return JSON.parse(jsonStr);
+}
+/**
+ * Run `node gsd-tools.cjs <command> [...args]` in `projectDir` and parse stdout as JSON.
+ */
+export async function captureGsdToolsOutput(command, args, projectDir) {
+    const { stdout } = await execGsdTools(projectDir, command, args);
+    return parseGsdToolsJson(stdout, projectDir);
+}
+/**
+ * Run `node gsd-tools.cjs <command> [...args]` and return raw stdout (no JSON parse).
+ */
+export async function captureGsdToolsStdout(command, args, projectDir) {
+    const { stdout } = await execGsdTools(projectDir, command, args);
+    return stdout;
+}
+//# sourceMappingURL=capture.js.map

package/sdk/dist/golden/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/golden/capture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,kBAAkB,GAAG,OAAO,CAAC;AACnC,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpC,SAAS,YAAY,CACnB,UAAkB,EAClB,OAAe,EACf,IAAc;IAEd,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CACN,OAAO,CAAC,QAAQ,EAChB,QAAQ,EACR;YACE,GAAG,EAAE,UAAU;YACf,SAAS,EAAE,UAAU;YACrB,OAAO,EAAE,kBAAkB;YAC3B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;SACxB,EACD,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACtB,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAE,GAA6B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChH,MAAM,SAAS,GAAG,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;gBAC3C,MAAM,CACJ,IAAI,KAAK,CACP,0BAA0B,IAAI,MAAM,SAAS,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CACtG,CACF,CAAC;gBACF,OAAO;YACT,CAAC;YACD,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAClF,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qGAAqG;AACrG,KAAK,UAAU,iBAAiB,CAAC,GAAW,EAAE,UAAkB;IAC9D,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,GAAG,OAAO,CAAC;IACtB,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC/D,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,mDAAmD,QAAQ,MAAM,MAAM,EAAE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAe,EACf,IAAc,EACd,UAAkB;IAElB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACjE,OAAO,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAe,EACf,IAAc,EACd,UAAkB;IAElB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/sdk/dist/golden/golden-integration-covered.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Canonical commands exercised by `golden.integration.test.ts` (SDK dispatch vs
+ * `gsd-tools.cjs` where applicable). Update when adding `describe` blocks there.
+ */
+export declare const GOLDEN_INTEGRATION_MAIN_FILE_CANONICALS: readonly string[];
+//# sourceMappingURL=golden-integration-covered.d.ts.map

package/sdk/dist/golden/golden-integration-covered.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-integration-covered.d.ts","sourceRoot":"","sources":["../../src/golden/golden-integration-covered.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,uCAAuC,EAAE,SAAS,MAAM,EAwBjC,CAAC"}

package/sdk/dist/golden/golden-integration-covered.js

@@ -0,0 +1,30 @@
+/**
+ * Canonical commands exercised by `golden.integration.test.ts` (SDK dispatch vs
+ * `gsd-tools.cjs` where applicable). Update when adding `describe` blocks there.
+ */
+export const GOLDEN_INTEGRATION_MAIN_FILE_CANONICALS = [
+    'config-get',
+    'config-set',
+    'current-timestamp',
+    'detect-custom-files',
+    'docs-init',
+    'find-phase',
+    'frontmatter.get',
+    'frontmatter.validate',
+    'generate-slug',
+    'init.execute-phase',
+    'init.plan-phase',
+    'init.quick',
+    'init.resume',
+    'init.verify-work',
+    'intel.update',
+    'progress.json',
+    'roadmap.analyze',
+    'state.sync',
+    'state.validate',
+    'template.select',
+    'validate.consistency',
+    'verify.phase-completeness',
+    'verify.plan-structure',
+].sort((a, b) => a.localeCompare(b));
+//# sourceMappingURL=golden-integration-covered.js.map

package/sdk/dist/golden/golden-integration-covered.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-integration-covered.js","sourceRoot":"","sources":["../../src/golden/golden-integration-covered.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,uCAAuC,GAAsB;IACxE,YAAY;IACZ,YAAY;IACZ,mBAAmB;IACnB,qBAAqB;IACrB,WAAW;IACX,YAAY;IACZ,iBAAiB;IACjB,sBAAsB;IACtB,eAAe;IACf,oBAAoB;IACpB,iBAAiB;IACjB,YAAY;IACZ,aAAa;IACb,kBAAkB;IAClB,cAAc;IACd,eAAe;IACf,iBAAiB;IACjB,YAAY;IACZ,gBAAgB;IAChB,iBAAiB;IACjB,sBAAsB;IACtB,2BAA2B;IAC3B,uBAAuB;CACxB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/sdk/dist/golden/golden-mutation-covered.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Mutation canonicals with explicit subprocess JSON parity vs `gsd-tools.cjs`
+ * (see `mutation-subprocess.integration.test.ts` when present). Empty until those
+ * tests land; other mutations rely on `MUTATION_DEFERRED_REASON` in golden-policy.
+ */
+export declare const GOLDEN_MUTATION_SUBPROCESS_COVERED: readonly string[];
+//# sourceMappingURL=golden-mutation-covered.d.ts.map

package/sdk/dist/golden/golden-mutation-covered.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-mutation-covered.d.ts","sourceRoot":"","sources":["../../src/golden/golden-mutation-covered.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kCAAkC,EAAE,SAAS,MAAM,EAU/D,CAAC"}

package/sdk/dist/golden/golden-mutation-covered.js

@@ -0,0 +1,17 @@
+/**
+ * Mutation canonicals with explicit subprocess JSON parity vs `gsd-tools.cjs`
+ * (see `mutation-subprocess.integration.test.ts` when present). Empty until those
+ * tests land; other mutations rely on `MUTATION_DEFERRED_REASON` in golden-policy.
+ */
+export const GOLDEN_MUTATION_SUBPROCESS_COVERED = [
+    'state.update',
+    'state.patch',
+    'state.begin-phase',
+    'state.sync',
+    'phase.add',
+    'phase.add-batch',
+    'phase.insert',
+    'phases.clear',
+    'roadmap.update-plan-progress',
+];
+//# sourceMappingURL=golden-mutation-covered.js.map

package/sdk/dist/golden/golden-mutation-covered.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-mutation-covered.js","sourceRoot":"","sources":["../../src/golden/golden-mutation-covered.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,kCAAkC,GAAsB;IACnE,cAAc;IACd,aAAa;IACb,mBAAmB;IACnB,YAAY;IACZ,WAAW;IACX,iBAAiB;IACjB,cAAc;IACd,cAAc;IACd,8BAA8B;CAC/B,CAAC"}

package/sdk/dist/golden/golden-policy.d.ts

@@ -0,0 +1,10 @@
+/** True if this canonical command participates in mutation event wiring (see QUERY_MUTATION_COMMANDS). */
+export declare function isMutationCanonicalCmd(canonical: string): boolean;
+/**
+ * Canonical commands with an explicit subprocess JSON check vs gsd-tools.cjs
+ * (golden.integration.test.ts + read-only-parity.integration.test.ts).
+ */
+export declare const GOLDEN_PARITY_INTEGRATION_COVERED: Set<string>;
+export declare const GOLDEN_PARITY_EXCEPTIONS: Record<string, string>;
+export declare function verifyGoldenPolicyComplete(): void;
+//# sourceMappingURL=golden-policy.d.ts.map

package/sdk/dist/golden/golden-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-policy.d.ts","sourceRoot":"","sources":["../../src/golden/golden-policy.ts"],"names":[],"mappings":"AAWA,0GAA0G;AAC1G,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAMjE;AA2DD;;;GAGG;AACH,eAAO,MAAM,iCAAiC,aAA+B,CAAC;AAE9E,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAiC,CAAC;AAmB9F,wBAAgB,0BAA0B,IAAI,IAAI,CAiBjD"}

package/sdk/dist/golden/golden-policy.js

@@ -0,0 +1,98 @@
+/**
+ * Golden parity policy — every canonical registry command must be either:
+ * - Listed in `GOLDEN_PARITY_INTEGRATION_COVERED` (subprocess CJS check under `sdk/src/golden/*integration*.test.ts`), or
+ * - Documented in `GOLDEN_PARITY_EXCEPTIONS` with a stable rationale (mirrored in QUERY-HANDLERS.md § Golden registry coverage matrix).
+ */
+import { QUERY_MUTATION_COMMANDS } from '../query/index.js';
+import { getCanonicalRegistryCommands } from './registry-canonical-commands.js';
+import { GOLDEN_INTEGRATION_MAIN_FILE_CANONICALS } from './golden-integration-covered.js';
+import { GOLDEN_MUTATION_SUBPROCESS_COVERED } from './golden-mutation-covered.js';
+import { readOnlyGoldenCanonicals } from './read-only-golden-rows.js';
+/** True if this canonical command participates in mutation event wiring (see QUERY_MUTATION_COMMANDS). */
+export function isMutationCanonicalCmd(canonical) {
+    const spaced = canonical.replace(/\./g, ' ');
+    for (const m of QUERY_MUTATION_COMMANDS) {
+        if (m === canonical || m === spaced)
+            return true;
+    }
+    return false;
+}
+const MUTATION_DEFERRED_REASON = 'Listed in QUERY_MUTATION_COMMANDS — mutates `.planning/`, git, or profile files. Subprocess golden vs gsd-tools.cjs is covered where a tmp fixture or `--dry-run` exists in golden.integration.test.ts; otherwise handler parity lives in sdk/src/query/*-mutation.test.ts, commit.test.ts, phase-lifecycle.test.ts, workstream.test.ts, intel.test.ts, profile.test.ts, template.test.ts, docs-init.ts, or uat.test.ts as applicable.';
+/** Registry commands with no `gsd-tools.cjs` analogue — cannot have subprocess JSON parity. */
+const NO_CJS_SUBPROCESS_REASON = {
+    'phases.archive': 'No `gsd-tools.cjs` command for `phases archive` (SDK-only). Covered in sdk/src/query/phase-lifecycle.test.ts.',
+    'check.config-gates': 'SDK-only decision-routing query (`.planning/research/decision-routing-audit.md` §3.3). Covered in sdk/src/query/config-gates.test.ts.',
+    'check.phase-ready': 'SDK-only decision-routing query (audit §3.4). Covered in sdk/src/query/phase-ready.test.ts.',
+    'route.next-action': 'SDK-only decision-routing query (audit §3.1). Covered in sdk/src/query/route-next-action.test.ts.',
+    'check.auto-mode': 'SDK-only decision-routing query (audit §3.5). Covered in sdk/src/query/check-auto-mode.test.ts.',
+    'detect.phase-type': 'SDK-only decision-routing query (audit §3.6). Covered in sdk/src/query/detect-phase-type.test.ts.',
+    'check.completion': 'SDK-only decision-routing query (audit §3.7). Covered in sdk/src/query/check-completion.test.ts.',
+    'check.gates': 'SDK-only decision-routing query (audit §3.2). Covered in sdk/src/query/check-gates.test.ts.',
+    'check.verification-status': 'SDK-only decision-routing query (audit §3.8). Covered in sdk/src/query/check-verification-status.test.ts.',
+    'check.ship-ready': 'SDK-only decision-routing query (audit §3.9). Covered in sdk/src/query/check-ship-ready.test.ts.',
+    'phase.list-plans': 'SDK-only listing helper for agents (no `gsd-tools.cjs` mirror). Covered in sdk/src/query/phase-list-queries.test.ts.',
+    'phase.list-artifacts': 'SDK-only artifact enumeration (no CJS mirror). Covered in sdk/src/query/phase-list-queries.test.ts.',
+    'plan.task-structure': 'SDK-only structured plan parse (no CJS mirror). Covered in sdk/src/query/plan-task-structure.test.ts.',
+    'requirements.extract-from-plans': 'SDK-only requirements aggregation (no CJS mirror). Covered in sdk/src/query/requirements-extract-from-plans.test.ts.',
+    'commands': 'SDK-only registry introspection (no gsd-tools.cjs equivalent — the CJS layer has no self-describing verb). Covered in sdk/src/query/commands-list.test.ts. Closes #3121.',
+    'phase.mvp-mode': 'SDK-only MVP precedence resolver (CLI flag → roadmap → config → false). Centralizes the chain previously duplicated across plan-phase/execute-phase/verify-work/progress workflows. Covered in sdk/src/query/mvp.test.ts.',
+    'task.is-behavior-adding': 'SDK-only Behavior-Adding Task predicate for the MVP+TDD Gate (tdd=true + <behavior> block + non-test source files). Replaces prose-only specification in references/execute-mvp-tdd.md. Covered in sdk/src/query/mvp.test.ts.',
+    'user-story.validate': 'SDK-only User Story regex validator. Centralizes /^As a .+, I want to .+, so that .+\\.$/ previously hardcoded in verify-work workflow. Covered in sdk/src/query/mvp.test.ts.',
+};
+const READ_HANDLER_ONLY_REASON = (cmd) => `No ` +
+    '`toEqual` subprocess row yet for this read-only command — handler parity is covered in sdk/src/query/*.test.ts / decomposed-handlers.test.ts; add `captureGsdToolsOutput` + `registry.dispatch` in sdk/src/golden/ when JSON shapes are aligned (see QUERY-HANDLERS.md § Golden registry coverage matrix). Command: `' +
+    cmd +
+    '`.';
+function buildIntegrationCoveredSet() {
+    return new Set([
+        ...GOLDEN_INTEGRATION_MAIN_FILE_CANONICALS,
+        ...readOnlyGoldenCanonicals(),
+        ...GOLDEN_MUTATION_SUBPROCESS_COVERED,
+    ]);
+}
+/**
+ * Canonical commands with an explicit subprocess JSON check vs gsd-tools.cjs
+ * (golden.integration.test.ts + read-only-parity.integration.test.ts).
+ */
+export const GOLDEN_PARITY_INTEGRATION_COVERED = buildIntegrationCoveredSet();
+export const GOLDEN_PARITY_EXCEPTIONS = buildGoldenParityExceptions();
+function buildGoldenParityExceptions() {
+    const out = {};
+    for (const c of getCanonicalRegistryCommands()) {
+        if (GOLDEN_PARITY_INTEGRATION_COVERED.has(c))
+            continue;
+        if (Object.prototype.hasOwnProperty.call(NO_CJS_SUBPROCESS_REASON, c)) {
+            out[c] = NO_CJS_SUBPROCESS_REASON[c];
+            continue;
+        }
+        if (isMutationCanonicalCmd(c)) {
+            out[c] = MUTATION_DEFERRED_REASON;
+        }
+        else {
+            out[c] = READ_HANDLER_ONLY_REASON(c);
+        }
+    }
+    return out;
+}
+export function verifyGoldenPolicyComplete() {
+    const canon = getCanonicalRegistryCommands();
+    const missingException = [];
+    for (const c of canon) {
+        if (GOLDEN_PARITY_INTEGRATION_COVERED.has(c))
+            continue;
+        if (!Object.prototype.hasOwnProperty.call(GOLDEN_PARITY_EXCEPTIONS, c))
+            missingException.push(c);
+    }
+    if (missingException.length) {
+        throw new Error(`Missing GOLDEN_PARITY_EXCEPTIONS entry for:\n${missingException.join('\n')}`);
+    }
+    const stale = [];
+    for (const c of GOLDEN_PARITY_INTEGRATION_COVERED) {
+        if (!canon.includes(c))
+            stale.push(c);
+    }
+    if (stale.length) {
+        throw new Error(`Stale GOLDEN_PARITY_INTEGRATION_COVERED entries:\n${stale.join('\n')}`);
+    }
+}
+//# sourceMappingURL=golden-policy.js.map

package/sdk/dist/golden/golden-policy.js.map

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

package/sdk/dist/golden/init-golden-normalize.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Normalize `init quick` payloads for golden parity: CJS runs in a subprocess with a
+ * different clock than the in-process SDK, so time-derived fields cannot match exactly.
+ */
+/** Keys derived from `Date` / `quick_id` generation (init.cjs cmdInitQuick). */
+export declare const INIT_QUICK_VOLATILE_KEYS: readonly ["quick_id", "timestamp", "branch_name", "task_dir"];
+export declare function omitInitQuickVolatile(data: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=init-golden-normalize.d.ts.map

package/sdk/dist/golden/init-golden-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-golden-normalize.d.ts","sourceRoot":"","sources":["../../src/golden/init-golden-normalize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,+DAAgE,CAAC;AAEtG,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM5F"}