@opengsd/get-shit-done-redux 1.0.0

package/sdk/dist/gsd-transport.js

@@ -0,0 +1,78 @@
+import { toFailureSignal } from './query-failure-classification.js';
+import { GSDToolsError } from './gsd-tools-error.js';
+export class GSDTransport {
+    registry;
+    adapters;
+    constructor(registry, adapters) {
+        this.registry = registry;
+        this.adapters = adapters;
+    }
+    async run(request, policy, onDecision) {
+        const useNative = this.shouldUseNative(request, policy);
+        if (useNative) {
+            try {
+                const native = await this.adapters.dispatchNative(request);
+                onDecision?.({ dispatchMode: 'native' });
+                return this.projectNativeOutput(request, native.data);
+            }
+            catch (error) {
+                if (this.shouldRethrowNativeError(error, policy))
+                    throw error;
+                onDecision?.({ dispatchMode: 'subprocess', reason: 'native_failure_fallback' });
+            }
+        }
+        else {
+            const reason = this.subprocessReason(request, policy);
+            if (!policy.allowFallbackToSubprocess && reason === 'native_unregistered') {
+                throw GSDToolsError.failure(`Subprocess fallback disabled: command '${request.registryCommand}' cannot run without native dispatch`, request.legacyCommand, request.legacyArgs, null);
+            }
+            onDecision?.({ dispatchMode: 'subprocess', reason });
+        }
+        return this.dispatchSubprocess(request);
+    }
+    shouldUseNative(request, policy) {
+        // Phase 5.0 worker fix: dispatchNative now correctly threads projectDir and
+        // workstream per-request (see worker.ts dispatchNative closure). Workstream
+        // commands no longer need to force subprocess — native dispatch handles them.
+        return policy.preferNative && this.registry.has(request.registryCommand);
+    }
+    subprocessReason(request, policy) {
+        if (!policy.preferNative)
+            return 'native_not_preferred';
+        if (!this.registry.has(request.registryCommand))
+            return 'native_unregistered';
+        throw new Error(`Unexpected subprocess reason state for command '${request.registryCommand}' with preferNative=${String(policy.preferNative)}`);
+    }
+    shouldRethrowNativeError(error, policy) {
+        if (!policy.allowFallbackToSubprocess)
+            return true;
+        // Do not subprocess-fallback after a timed-out native dispatch:
+        // the timeout does not cancel the native handler, so falling through
+        // would run the same command twice (double-execution race).
+        return toFailureSignal(error).kind === 'timeout';
+    }
+    dispatchSubprocess(request) {
+        if (request.mode === 'raw') {
+            return this.adapters.execSubprocessRaw(request.legacyCommand, request.legacyArgs);
+        }
+        return this.adapters.execSubprocessJson(request.legacyCommand, request.legacyArgs);
+    }
+    projectNativeOutput(request, data) {
+        if (request.mode === 'raw') {
+            if (this.adapters.formatNativeRaw) {
+                return this.adapters.formatNativeRaw(request.registryCommand, data).trim();
+            }
+            return this.toRaw(data);
+        }
+        return data;
+    }
+    toRaw(data) {
+        if (typeof data === 'string')
+            return data.trim();
+        const json = JSON.stringify(data, null, 2);
+        if (json == null)
+            return '';
+        return json.trim();
+    }
+}
+//# sourceMappingURL=gsd-transport.js.map

package/sdk/dist/gsd-transport.js.map

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

package/sdk/dist/index.d.ts

@@ -0,0 +1,127 @@
+/**
+ * GSD SDK — Public API for running GSD plans programmatically.
+ *
+ * The GSD class composes plan parsing, config loading, prompt building,
+ * and session running into a single `executePlan()` call.
+ *
+ * @example
+ * ```typescript
+ * import { GSD } from '@opengsd/gsd-sdk';
+ *
+ * const gsd = new GSD({ projectDir: '/path/to/project' });
+ * const result = await gsd.executePlan('.planning/phases/01-auth/01-auth-01-PLAN.md');
+ *
+ * if (result.success) {
+ *   console.log(`Plan completed in ${result.durationMs}ms, cost: $${result.totalCostUsd}`);
+ * } else {
+ *   console.error(`Plan failed: ${result.error?.messages.join(', ')}`);
+ * }
+ * ```
+ */
+import type { GSDOptions, PlanResult, SessionOptions, GSDEvent, TransportHandler, PhaseRunnerOptions, PhaseRunnerResult, MilestoneRunnerOptions, MilestoneRunnerResult } from './types.js';
+import { GSDTools } from './gsd-tools.js';
+import { GSDEventStream } from './event-stream.js';
+export { PlanningJournal } from './planning-journal.js';
+export type { PlanningEvent, PlanningEventActor, PlanningJournalAppendInput } from './planning-journal.js';
+export { PlanningRuntime } from './planning-runtime.js';
+export declare class GSD {
+    private readonly projectDir;
+    private readonly gsdToolsPath;
+    private readonly sessionId?;
+    private readonly defaultModel?;
+    private readonly defaultMaxBudgetUsd;
+    private readonly defaultMaxTurns;
+    private readonly autoMode;
+    private readonly workstream?;
+    private readonly strictSdk?;
+    private readonly allowFallbackToSubprocess?;
+    readonly eventStream: GSDEventStream;
+    constructor(options: GSDOptions);
+    /**
+     * Execute a single GSD plan file.
+     *
+     * Reads the plan from disk, parses it, loads project config,
+     * optionally reads the agent definition, then runs a query() session.
+     *
+     * @param planPath - Path to the PLAN.md file (absolute or relative to projectDir)
+     * @param options - Per-execution overrides
+     * @returns PlanResult with cost, duration, success/error status
+     */
+    executePlan(planPath: string, options?: SessionOptions): Promise<PlanResult>;
+    /**
+     * Subscribe a simple handler to receive all GSD events.
+     */
+    onEvent(handler: (event: GSDEvent) => void): void;
+    /**
+     * Subscribe a transport handler to receive all GSD events.
+     * Transports provide structured onEvent/close lifecycle.
+     */
+    addTransport(handler: TransportHandler): void;
+    /**
+     * Create a GSDTools instance for state management operations.
+     */
+    createTools(): GSDTools;
+    /**
+     * Run a full phase lifecycle: discuss → research → plan → execute → verify → advance.
+     *
+     * Creates the necessary collaborators (GSDTools, PromptFactory, ContextEngine),
+     * loads project config, instantiates a PhaseRunner, and delegates to `runner.run()`.
+     *
+     * @param phaseNumber - The phase number to execute (e.g. "01", "02")
+     * @param options - Per-phase overrides for budget, turns, model, and callbacks
+     * @returns PhaseRunnerResult with per-step results, overall success, cost, and timing
+     */
+    runPhase(phaseNumber: string, options?: PhaseRunnerOptions): Promise<PhaseRunnerResult>;
+    /**
+     * Run a full milestone: discover phases, execute each incomplete one in order,
+     * re-discover after each completion to catch dynamically inserted phases.
+     *
+     * @param prompt - The user prompt describing the milestone goal
+     * @param options - Per-milestone overrides for budget, turns, model, and callbacks
+     * @returns MilestoneRunnerResult with per-phase results, overall success, cost, and timing
+     */
+    run(prompt: string, options?: MilestoneRunnerOptions): Promise<MilestoneRunnerResult>;
+    /**
+     * Filter to incomplete phases and sort numerically.
+     * Uses parseFloat to handle decimal phase numbers (e.g. '5.1').
+     */
+    private filterAndSortPhases;
+    /**
+     * Load the gsd-executor agent definition if available.
+     * Falls back gracefully — returns undefined if not found.
+     */
+    private loadAgentDefinition;
+}
+export { parsePlan, parsePlanFile } from './plan-parser.js';
+export { loadConfig } from './config.js';
+export type { GSDConfig } from './config.js';
+export { GSDTools, GSDToolsError, resolveGsdToolsPath } from './gsd-tools.js';
+export { runPlanSession, runPhaseStepSession } from './session-runner.js';
+export { buildExecutorPrompt, parseAgentTools } from './prompt-builder.js';
+export type { ExecutorPromptOptions } from './prompt-builder.js';
+export * from './types.js';
+export { GSDEventStream } from './event-stream.js';
+export type { EventStreamContext } from './event-stream.js';
+export { ContextEngine, PHASE_FILE_MANIFEST } from './context-engine.js';
+export type { FileSpec } from './context-engine.js';
+export { truncateMarkdown, extractCurrentMilestone, DEFAULT_TRUNCATION_OPTIONS } from './context-truncation.js';
+export type { TruncationOptions } from './context-truncation.js';
+export { getToolsForPhase, PHASE_AGENT_MAP, PHASE_DEFAULT_TOOLS } from './tool-scoping.js';
+export { checkResearchGate } from './research-gate.js';
+export type { ResearchGateResult } from './research-gate.js';
+export { PromptFactory, extractBlock, extractSteps, PHASE_WORKFLOW_MAP } from './phase-prompt.js';
+export { GSDLogger } from './logger.js';
+export type { LogLevel, LogEntry, GSDLoggerOptions } from './logger.js';
+export { PhaseRunner, PhaseRunnerError } from './phase-runner.js';
+export type { PhaseRunnerDeps, VerificationOutcome } from './phase-runner.js';
+export { CLITransport } from './cli-transport.js';
+export { WSTransport } from './ws-transport.js';
+export type { WSTransportOptions } from './ws-transport.js';
+export { createRegistry, normalizeQueryCommand } from './query/index.js';
+export { isPhaseUatPassed, phaseUatPassed, REASON_CODE, ERROR_CODE, PhaseUatPassedError, } from './query/phase-uat-passed.js';
+export type { UatReason, ReasonCode, ErrorCode, } from './query/phase-uat-passed.js';
+export { validateWorkstreamName, relPlanningPath } from './workstream-utils.js';
+export { InitRunner } from './init-runner.js';
+export type { InitRunnerDeps } from './init-runner.js';
+export type { InitConfig, InitResult, InitStepResult, InitStepName } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/sdk/dist/index.d.ts.map

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

package/sdk/dist/index.js

@@ -0,0 +1,300 @@
+/**
+ * GSD SDK — Public API for running GSD plans programmatically.
+ *
+ * The GSD class composes plan parsing, config loading, prompt building,
+ * and session running into a single `executePlan()` call.
+ *
+ * @example
+ * ```typescript
+ * import { GSD } from '@opengsd/gsd-sdk';
+ *
+ * const gsd = new GSD({ projectDir: '/path/to/project' });
+ * const result = await gsd.executePlan('.planning/phases/01-auth/01-auth-01-PLAN.md');
+ *
+ * if (result.success) {
+ *   console.log(`Plan completed in ${result.durationMs}ms, cost: $${result.totalCostUsd}`);
+ * } else {
+ *   console.error(`Plan failed: ${result.error?.messages.join(', ')}`);
+ * }
+ * ```
+ */
+import { readFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { GSDEventType } from './types.js';
+import { parsePlanFile } from './plan-parser.js';
+import { loadConfig } from './config.js';
+import { GSDTools, resolveGsdToolsPath } from './gsd-tools.js';
+import { runPlanSession } from './session-runner.js';
+import { GSDEventStream } from './event-stream.js';
+import { PhaseRunner } from './phase-runner.js';
+import { ContextEngine } from './context-engine.js';
+import { PromptFactory } from './phase-prompt.js';
+export { PlanningJournal } from './planning-journal.js';
+export { PlanningRuntime } from './planning-runtime.js';
+// ─── GSD class ───────────────────────────────────────────────────────────────
+export class GSD {
+    projectDir;
+    gsdToolsPath;
+    sessionId;
+    defaultModel;
+    defaultMaxBudgetUsd;
+    defaultMaxTurns;
+    autoMode;
+    workstream;
+    strictSdk;
+    allowFallbackToSubprocess;
+    eventStream;
+    constructor(options) {
+        this.projectDir = resolve(options.projectDir);
+        this.gsdToolsPath =
+            options.gsdToolsPath ?? resolveGsdToolsPath(this.projectDir);
+        this.sessionId = options.sessionId;
+        this.defaultModel = options.model;
+        this.defaultMaxBudgetUsd = options.maxBudgetUsd ?? 5.0;
+        this.defaultMaxTurns = options.maxTurns ?? 50;
+        this.autoMode = options.autoMode ?? false;
+        this.workstream = options.workstream;
+        this.strictSdk = options.strictSdk;
+        this.allowFallbackToSubprocess = options.allowFallbackToSubprocess;
+        this.eventStream = new GSDEventStream();
+    }
+    /**
+     * Execute a single GSD plan file.
+     *
+     * Reads the plan from disk, parses it, loads project config,
+     * optionally reads the agent definition, then runs a query() session.
+     *
+     * @param planPath - Path to the PLAN.md file (absolute or relative to projectDir)
+     * @param options - Per-execution overrides
+     * @returns PlanResult with cost, duration, success/error status
+     */
+    async executePlan(planPath, options) {
+        // Resolve plan path relative to project dir
+        const absolutePlanPath = resolve(this.projectDir, planPath);
+        // Parse the plan
+        const plan = await parsePlanFile(absolutePlanPath);
+        // Load project config
+        const config = await loadConfig(this.projectDir, this.workstream);
+        // Try to load agent definition for tool restrictions
+        const agentDef = await this.loadAgentDefinition();
+        // Merge defaults with per-call options
+        const sessionOptions = {
+            maxTurns: options?.maxTurns ?? this.defaultMaxTurns,
+            maxBudgetUsd: options?.maxBudgetUsd ?? this.defaultMaxBudgetUsd,
+            model: options?.model ?? this.defaultModel,
+            cwd: options?.cwd ?? this.projectDir,
+            allowedTools: options?.allowedTools,
+        };
+        return runPlanSession(plan, config, sessionOptions, agentDef, this.eventStream, {
+            phase: undefined, // Phase context set by higher-level orchestrators
+            planName: plan.frontmatter.plan,
+        });
+    }
+    /**
+     * Subscribe a simple handler to receive all GSD events.
+     */
+    onEvent(handler) {
+        this.eventStream.on('event', handler);
+    }
+    /**
+     * Subscribe a transport handler to receive all GSD events.
+     * Transports provide structured onEvent/close lifecycle.
+     */
+    addTransport(handler) {
+        this.eventStream.addTransport(handler);
+    }
+    /**
+     * Create a GSDTools instance for state management operations.
+     */
+    createTools() {
+        return new GSDTools({
+            projectDir: this.projectDir,
+            gsdToolsPath: this.gsdToolsPath,
+            workstream: this.workstream,
+            eventStream: this.eventStream,
+            sessionId: this.sessionId,
+            strictSdk: this.strictSdk,
+            allowFallbackToSubprocess: this.allowFallbackToSubprocess,
+            onDispatchEvent: (event) => {
+                this.eventStream.emitEvent({
+                    type: GSDEventType.StreamEvent,
+                    timestamp: new Date().toISOString(),
+                    sessionId: this.sessionId ?? '',
+                    event,
+                });
+            },
+        });
+    }
+    /**
+     * Run a full phase lifecycle: discuss → research → plan → execute → verify → advance.
+     *
+     * Creates the necessary collaborators (GSDTools, PromptFactory, ContextEngine),
+     * loads project config, instantiates a PhaseRunner, and delegates to `runner.run()`.
+     *
+     * @param phaseNumber - The phase number to execute (e.g. "01", "02")
+     * @param options - Per-phase overrides for budget, turns, model, and callbacks
+     * @returns PhaseRunnerResult with per-step results, overall success, cost, and timing
+     */
+    async runPhase(phaseNumber, options) {
+        const tools = this.createTools();
+        const promptFactory = new PromptFactory({ projectDir: this.projectDir });
+        const contextEngine = new ContextEngine(this.projectDir, undefined, undefined, this.workstream);
+        const config = await loadConfig(this.projectDir, this.workstream);
+        // Auto mode: force auto_advance on and skip_discuss off so self-discuss kicks in
+        if (this.autoMode) {
+            config.workflow.auto_advance = true;
+            config.workflow.skip_discuss = false;
+        }
+        const runner = new PhaseRunner({
+            projectDir: this.projectDir,
+            tools,
+            promptFactory,
+            contextEngine,
+            eventStream: this.eventStream,
+            config,
+        });
+        return runner.run(phaseNumber, options);
+    }
+    /**
+     * Run a full milestone: discover phases, execute each incomplete one in order,
+     * re-discover after each completion to catch dynamically inserted phases.
+     *
+     * @param prompt - The user prompt describing the milestone goal
+     * @param options - Per-milestone overrides for budget, turns, model, and callbacks
+     * @returns MilestoneRunnerResult with per-phase results, overall success, cost, and timing
+     */
+    async run(prompt, options) {
+        const tools = this.createTools();
+        const startTime = Date.now();
+        const phaseResults = [];
+        let success = true;
+        // Discover initial phases
+        const initialAnalysis = await tools.roadmapAnalyze();
+        const incompletePhases = this.filterAndSortPhases(initialAnalysis.phases);
+        // Emit MilestoneStart
+        this.eventStream.emitEvent({
+            type: GSDEventType.MilestoneStart,
+            timestamp: new Date().toISOString(),
+            sessionId: `milestone-${Date.now()}`,
+            phaseCount: incompletePhases.length,
+            prompt,
+        });
+        // Loop through phases, re-discovering after each completion
+        let currentPhases = incompletePhases;
+        while (currentPhases.length > 0) {
+            const phase = currentPhases[0];
+            try {
+                const result = await this.runPhase(phase.number, options);
+                phaseResults.push(result);
+                if (!result.success) {
+                    success = false;
+                    break;
+                }
+                // Notify callback if present; stop if requested
+                if (options?.onPhaseComplete) {
+                    const verdict = await options.onPhaseComplete(result, phase);
+                    if (verdict === 'stop') {
+                        break;
+                    }
+                }
+                // Re-discover phases to catch dynamically inserted ones
+                const updatedAnalysis = await tools.roadmapAnalyze();
+                currentPhases = this.filterAndSortPhases(updatedAnalysis.phases);
+            }
+            catch (err) {
+                // Phase threw an unexpected error — record as failure and stop
+                phaseResults.push({
+                    phaseNumber: phase.number,
+                    phaseName: phase.phase_name,
+                    steps: [],
+                    success: false,
+                    totalCostUsd: 0,
+                    totalDurationMs: 0,
+                });
+                success = false;
+                break;
+            }
+        }
+        const totalCostUsd = phaseResults.reduce((sum, r) => sum + r.totalCostUsd, 0);
+        const totalDurationMs = Date.now() - startTime;
+        // Emit MilestoneComplete
+        this.eventStream.emitEvent({
+            type: GSDEventType.MilestoneComplete,
+            timestamp: new Date().toISOString(),
+            sessionId: `milestone-${Date.now()}`,
+            success,
+            totalCostUsd,
+            totalDurationMs,
+            phasesCompleted: phaseResults.filter(r => r.success).length,
+        });
+        return {
+            success,
+            phases: phaseResults,
+            totalCostUsd,
+            totalDurationMs,
+        };
+    }
+    /**
+     * Filter to incomplete phases and sort numerically.
+     * Uses parseFloat to handle decimal phase numbers (e.g. '5.1').
+     */
+    filterAndSortPhases(phases) {
+        return phases
+            .filter(p => !p.roadmap_complete)
+            .sort((a, b) => parseFloat(a.number) - parseFloat(b.number));
+    }
+    /**
+     * Load the gsd-executor agent definition if available.
+     * Falls back gracefully — returns undefined if not found.
+     */
+    async loadAgentDefinition() {
+        const paths = [
+            // Repo-local GSD installation
+            join(this.projectDir, '.claude', 'get-shit-done', 'agents', 'gsd-executor.md'),
+            // Repo-local agents directory
+            join(this.projectDir, '.claude', 'agents', 'gsd-executor.md'),
+            // Global home directory
+            join(homedir(), '.claude', 'agents', 'gsd-executor.md'),
+            join(this.projectDir, 'agents', 'gsd-executor.md'),
+        ];
+        for (const p of paths) {
+            try {
+                return await readFile(p, 'utf-8');
+            }
+            catch {
+                // Not found at this path, try next
+            }
+        }
+        return undefined;
+    }
+}
+// ─── Re-exports for advanced usage ──────────────────────────────────────────
+export { parsePlan, parsePlanFile } from './plan-parser.js';
+export { loadConfig } from './config.js';
+export { GSDTools, GSDToolsError, resolveGsdToolsPath } from './gsd-tools.js';
+export { runPlanSession, runPhaseStepSession } from './session-runner.js';
+export { buildExecutorPrompt, parseAgentTools } from './prompt-builder.js';
+export * from './types.js';
+// S02: Event stream, context, prompt, and logging modules
+export { GSDEventStream } from './event-stream.js';
+export { ContextEngine, PHASE_FILE_MANIFEST } from './context-engine.js';
+export { truncateMarkdown, extractCurrentMilestone, DEFAULT_TRUNCATION_OPTIONS } from './context-truncation.js';
+export { getToolsForPhase, PHASE_AGENT_MAP, PHASE_DEFAULT_TOOLS } from './tool-scoping.js';
+export { checkResearchGate } from './research-gate.js';
+export { PromptFactory, extractBlock, extractSteps, PHASE_WORKFLOW_MAP } from './phase-prompt.js';
+export { GSDLogger } from './logger.js';
+// S03: Phase lifecycle state machine
+export { PhaseRunner, PhaseRunnerError } from './phase-runner.js';
+// S05: Transports
+export { CLITransport } from './cli-transport.js';
+export { WSTransport } from './ws-transport.js';
+// Query registry argv normalization (matches `gsd-sdk query` and `GSDTools` hot path)
+export { createRegistry, normalizeQueryCommand } from './query/index.js';
+// Phase UAT predicate — programmatic API surface (#3184)
+export { isPhaseUatPassed, phaseUatPassed, REASON_CODE, ERROR_CODE, PhaseUatPassedError, } from './query/phase-uat-passed.js';
+// Workstream utilities
+export { validateWorkstreamName, relPlanningPath } from './workstream-utils.js';
+// Init workflow
+export { InitRunner } from './init-runner.js';
+//# sourceMappingURL=index.js.map

package/sdk/dist/index.js.map

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

package/sdk/dist/init-runner.d.ts

@@ -0,0 +1,90 @@
+/**
+ * InitRunner — orchestrates the GSD new-project init workflow.
+ *
+ * Workflow: setup → config → PROJECT.md → parallel research (4 sessions)
+ *         → synthesis → requirements → roadmap
+ *
+ * Each step calls Agent SDK `query()` via `runPhaseStepSession()` with
+ * prompts derived from GSD-1 workflow/agent/template files on disk.
+ */
+import type { InitConfig, InitResult } from './types.js';
+import type { GSDTools } from './gsd-tools.js';
+import type { GSDEventStream } from './event-stream.js';
+export interface InitRunnerDeps {
+    projectDir: string;
+    tools: GSDTools;
+    eventStream: GSDEventStream;
+    config?: Partial<InitConfig>;
+    /** Override for SDK prompts directory. Defaults to package-relative sdk/prompts/. */
+    sdkPromptsDir?: string;
+}
+export declare class InitRunner {
+    private readonly projectDir;
+    private readonly tools;
+    private readonly eventStream;
+    private readonly config;
+    private readonly sessionId;
+    private readonly sdkPromptsDir;
+    constructor(deps: InitRunnerDeps);
+    /**
+     * Run the full init workflow.
+     *
+     * @param input - User input: PRD content, project description, etc.
+     * @returns InitResult with per-step results, artifacts, and totals.
+     */
+    run(input: string): Promise<InitResult>;
+    private runStep;
+    private runParallelResearch;
+    /**
+     * Build the PROJECT.md synthesis prompt.
+     * Reads the project template and combines with user input.
+     */
+    private buildProjectPrompt;
+    /**
+     * Build a research prompt for a specific research type.
+     * Reads the agent definition and research template.
+     */
+    private buildResearchPrompt;
+    /**
+     * Build the synthesis prompt.
+     * Reads synthesizer agent def and all 4 research outputs.
+     */
+    private buildSynthesisPrompt;
+    /**
+     * Build the requirements prompt.
+     * Reads PROJECT.md + FEATURES.md for requirement derivation.
+     */
+    private buildRequirementsPrompt;
+    /**
+     * Build the roadmap prompt.
+     * Reads PROJECT.md + REQUIREMENTS.md + research/SUMMARY.md + config.json.
+     */
+    private buildRoadmapPrompt;
+    /**
+     * Run a single Agent SDK session via runPhaseStepSession.
+     */
+    private runSession;
+    /**
+     * Read a file from the GSD templates directory.
+     * Tries sdk/prompts/{relativePath} first (headless versions), then
+     * falls back to GSD-1 originals (~/.claude/get-shit-done/).
+     */
+    private readGSDFile;
+    /**
+     * Read an agent definition.
+     * Tries installed agents first (complete, up-to-date versions), then
+     * falls back to SDK bundled copies.
+     */
+    private readAgentFile;
+    /**
+     * Execute a git command in the project directory.
+     */
+    private execGit;
+    private emitEvent;
+    private buildResult;
+    /**
+     * Extract cost from a step return value if it's a PlanResult.
+     */
+    private extractCost;
+}
+//# sourceMappingURL=init-runner.d.ts.map

package/sdk/dist/init-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-runner.d.ts","sourceRoot":"","sources":["../src/init-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EAUX,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAsCxD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,CAAC;IAChB,WAAW,EAAE,cAAc,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7B,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,IAAI,EAAE,cAAc;IAiBhC;;;;;OAKG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;YAoK/B,OAAO;YA2DP,mBAAmB;IAiDjC;;;OAGG;YACW,kBAAkB;IAoBhC;;;OAGG;YACW,mBAAmB;IA4CjC;;;OAGG;YACW,oBAAoB;IAyClC;;;OAGG;YACW,uBAAuB;IA4CrC;;;OAGG;YACW,kBAAkB;IAiDhC;;OAEG;YACW,UAAU;IAoBxB;;;;OAIG;YACW,WAAW;IAkBzB;;;;OAIG;YACW,aAAa;IAoB3B;;OAEG;IACH,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,WAAW;IA0BnB;;OAEG;IACH,OAAO,CAAC,WAAW;CAMpB"}