@bhargavvc/sdd-cc 1.35.0 → 1.42.4

package/sdk/dist/golden/init-golden-normalize.js

@@ -0,0 +1,14 @@
+/**
+ * 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 const INIT_QUICK_VOLATILE_KEYS = ['quick_id', 'timestamp', 'branch_name', 'task_dir'];
+export function omitInitQuickVolatile(data) {
+    const o = { ...data };
+    for (const k of INIT_QUICK_VOLATILE_KEYS) {
+        delete o[k];
+    }
+    return o;
+}
+//# sourceMappingURL=init-golden-normalize.js.map

package/sdk/dist/golden/init-golden-normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-golden-normalize.js","sourceRoot":"","sources":["../../src/golden/init-golden-normalize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gFAAgF;AAChF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,CAAU,CAAC;AAEtG,MAAM,UAAU,qBAAqB,CAAC,IAA6B;IACjE,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IACtB,KAAK,MAAM,CAAC,IAAI,wBAAwB,EAAE,CAAC;QACzC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/sdk/dist/golden/read-only-golden-rows.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Read-only subprocess golden rows: SDK `registry.dispatch` vs `sdd-tools.cjs` JSON on stdout.
+ * Imported by `read-only-parity.integration.test.ts` and `golden-policy.ts` coverage accounting.
+ */
+export type JsonParityRow = {
+    canonical: string;
+    sdkArgs: string[];
+    cjs: string;
+    cjsArgs: string[];
+};
+/** Repo-relative fixtures (cwd = sdd repo root). */
+export declare const GOLDEN_PLAN = ".planning/phases/09-foundation-and-test-infrastructure/09-01-PLAN.md";
+/**
+ * Strict `toEqual` JSON parity rows verified on this repository.
+ * (Expand as more handlers are aligned with `sdd-tools.cjs`.)
+ */
+export declare const READ_ONLY_JSON_PARITY_ROWS: JsonParityRow[];
+/** Canonicals from JSON rows plus special-case subprocess tests in read-only-parity integration. */
+export declare function readOnlyGoldenCanonicals(): Set<string>;
+//# sourceMappingURL=read-only-golden-rows.d.ts.map

package/sdk/dist/golden/read-only-golden-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only-golden-rows.d.ts","sourceRoot":"","sources":["../../src/golden/read-only-golden-rows.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,WAAW,yEAAyE,CAAC;AAElG;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,aAAa,EA4CrD,CAAC;AAEF,oGAAoG;AACpG,wBAAgB,wBAAwB,IAAI,GAAG,CAAC,MAAM,CAAC,CAUtD"}

package/sdk/dist/golden/read-only-golden-rows.js

@@ -0,0 +1,67 @@
+/**
+ * Read-only subprocess golden rows: SDK `registry.dispatch` vs `sdd-tools.cjs` JSON on stdout.
+ * Imported by `read-only-parity.integration.test.ts` and `golden-policy.ts` coverage accounting.
+ */
+/** Repo-relative fixtures (cwd = sdd repo root). */
+export const GOLDEN_PLAN = '.planning/phases/09-foundation-and-test-infrastructure/09-01-PLAN.md';
+/**
+ * Strict `toEqual` JSON parity rows verified on this repository.
+ * (Expand as more handlers are aligned with `sdd-tools.cjs`.)
+ */
+export const READ_ONLY_JSON_PARITY_ROWS = [
+    { canonical: 'resolve-model', sdkArgs: ['sdd-planner'], cjs: 'resolve-model', cjsArgs: ['sdd-planner'] },
+    { canonical: 'phase-plan-index', sdkArgs: ['9'], cjs: 'phase-plan-index', cjsArgs: ['9'] },
+    { canonical: 'roadmap.get-phase', sdkArgs: ['9'], cjs: 'roadmap', cjsArgs: ['get-phase', '9'] },
+    { canonical: 'list.todos', sdkArgs: [], cjs: 'list-todos', cjsArgs: [] },
+    { canonical: 'phase.next-decimal', sdkArgs: ['9'], cjs: 'phase', cjsArgs: ['next-decimal', '9'] },
+    { canonical: 'phases.list', sdkArgs: [], cjs: 'phases', cjsArgs: ['list'] },
+    { canonical: 'verify.summary', sdkArgs: [GOLDEN_PLAN], cjs: 'verify-summary', cjsArgs: [GOLDEN_PLAN] },
+    { canonical: 'verify.path-exists', sdkArgs: ['.planning/STATE.md'], cjs: 'verify-path-exists', cjsArgs: ['.planning/STATE.md'] },
+    { canonical: 'verify.artifacts', sdkArgs: [GOLDEN_PLAN], cjs: 'verify', cjsArgs: ['artifacts', GOLDEN_PLAN] },
+    { canonical: 'websearch', sdkArgs: ['typescript', '--limit', '1'], cjs: 'websearch', cjsArgs: ['typescript', '--limit', '1'] },
+    { canonical: 'workstream.get', sdkArgs: ['default'], cjs: 'workstream', cjsArgs: ['get', 'default'] },
+    { canonical: 'workstream.list', sdkArgs: [], cjs: 'workstream', cjsArgs: ['list'] },
+    { canonical: 'workstream.status', sdkArgs: ['default'], cjs: 'workstream', cjsArgs: ['status', 'default'] },
+    { canonical: 'learnings.list', sdkArgs: [], cjs: 'learnings', cjsArgs: ['list'] },
+    { canonical: 'intel.status', sdkArgs: [], cjs: 'intel', cjsArgs: ['status'] },
+    { canonical: 'intel.diff', sdkArgs: [], cjs: 'intel', cjsArgs: ['diff'] },
+    { canonical: 'intel.validate', sdkArgs: [], cjs: 'intel', cjsArgs: ['validate'] },
+    { canonical: 'intel.query', sdkArgs: ['sdd'], cjs: 'intel', cjsArgs: ['query', 'sdd'] },
+    {
+        canonical: 'intel.extract-exports',
+        sdkArgs: ['sdk/src/query/utils.ts'],
+        cjs: 'intel',
+        cjsArgs: ['extract-exports', 'sdk/src/query/utils.ts'],
+    },
+    { canonical: 'init.list-workspaces', sdkArgs: [], cjs: 'init', cjsArgs: ['list-workspaces'] },
+    { canonical: 'agent-skills', sdkArgs: [], cjs: 'agent-skills', cjsArgs: [] },
+    { canonical: 'scan-sessions', sdkArgs: ['--json'], cjs: 'scan-sessions', cjsArgs: ['--json'] },
+    { canonical: 'stats.json', sdkArgs: [], cjs: 'stats', cjsArgs: ['json'] },
+    { canonical: 'todo.match-phase', sdkArgs: ['9'], cjs: 'todo', cjsArgs: ['match-phase', '9'] },
+    { canonical: 'verify.key-links', sdkArgs: [GOLDEN_PLAN], cjs: 'verify', cjsArgs: ['key-links', GOLDEN_PLAN] },
+    { canonical: 'verify.schema-drift', sdkArgs: ['9'], cjs: 'verify', cjsArgs: ['schema-drift', '9'] },
+    { canonical: 'state-snapshot', sdkArgs: [], cjs: 'state-snapshot', cjsArgs: [] },
+    { canonical: 'history.digest', sdkArgs: [], cjs: 'history-digest', cjsArgs: [] },
+    { canonical: 'audit-uat', sdkArgs: [], cjs: 'audit-uat', cjsArgs: [] },
+    { canonical: 'skill-manifest', sdkArgs: [], cjs: 'skill-manifest', cjsArgs: [] },
+    { canonical: 'validate.agents', sdkArgs: [], cjs: 'validate', cjsArgs: ['agents'] },
+    {
+        canonical: 'uat.render-checkpoint',
+        sdkArgs: ['--file', 'sdk/src/golden/fixtures/uat-render-checkpoint-sample.md'],
+        cjs: 'uat',
+        cjsArgs: ['render-checkpoint', '--file', 'sdk/src/golden/fixtures/uat-render-checkpoint-sample.md'],
+    },
+];
+/** Canonicals from JSON rows plus special-case subprocess tests in read-only-parity integration. */
+export function readOnlyGoldenCanonicals() {
+    const s = new Set(READ_ONLY_JSON_PARITY_ROWS.map((r) => r.canonical));
+    s.add('verify.commits');
+    s.add('config-path');
+    s.add('state.json');
+    s.add('state.load');
+    s.add('audit-open');
+    s.add('state.get');
+    s.add('summary.extract');
+    return s;
+}
+//# sourceMappingURL=read-only-golden-rows.js.map

package/sdk/dist/golden/read-only-golden-rows.js.map

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

package/sdk/dist/golden/registry-canonical-commands.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Canonical registry command strings for golden parity — one primary name per unique
+ * native handler (dedupes dotted vs space-delimited aliases on the same function).
+ */
+export declare function getCanonicalRegistryCommands(): string[];
+//# sourceMappingURL=registry-canonical-commands.d.ts.map

package/sdk/dist/golden/registry-canonical-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-canonical-commands.d.ts","sourceRoot":"","sources":["../../src/golden/registry-canonical-commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,wBAAgB,4BAA4B,IAAI,MAAM,EAAE,CAsBvD"}

package/sdk/dist/golden/registry-canonical-commands.js

@@ -0,0 +1,30 @@
+/**
+ * Canonical registry command strings for golden parity — one primary name per unique
+ * native handler (dedupes dotted vs space-delimited aliases on the same function).
+ */
+import { createRegistry } from '../query/index.js';
+export function getCanonicalRegistryCommands() {
+    const registry = createRegistry();
+    const byHandler = new Map();
+    for (const cmd of registry.commands()) {
+        const h = registry.getHandler(cmd);
+        if (!h)
+            continue;
+        const list = byHandler.get(h) ?? [];
+        list.push(cmd);
+        byHandler.set(h, list);
+    }
+    const out = [];
+    for (const cmds of byHandler.values()) {
+        cmds.sort((a, b) => a.localeCompare(b));
+        const dotted = cmds.find((c) => c.includes('.'));
+        if (dotted) {
+            out.push(dotted);
+            continue;
+        }
+        const kebab = cmds.find((c) => c.includes('-'));
+        out.push(kebab ?? cmds[0]);
+    }
+    return out.sort((a, b) => a.localeCompare(b));
+}
+//# sourceMappingURL=registry-canonical-commands.js.map

package/sdk/dist/golden/registry-canonical-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-canonical-commands.js","sourceRoot":"","sources":["../../src/golden/registry-canonical-commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,MAAM,UAAU,4BAA4B;IAC1C,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IACpD,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACf,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACjD,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/sdk/dist/index.d.ts

@@ -0,0 +1,125 @@
+/**
+ * SDD SDK — Public API for running SDD plans programmatically.
+ *
+ * The SDD class composes plan parsing, config loading, prompt building,
+ * and session running into a single `executePlan()` call.
+ *
+ * @example
+ * ```typescript
+ * import { SDD } from '@bhargavvc/sdk';
+ *
+ * const sdd = new SDD({ projectDir: '/path/to/project' });
+ * const result = await sdd.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 { SDDOptions, PlanResult, SessionOptions, SDDEvent, TransportHandler, PhaseRunnerOptions, PhaseRunnerResult, MilestoneRunnerOptions, MilestoneRunnerResult } from './types.js';
+import { SDDTools } from './sdd-tools.js';
+import { SDDEventStream } 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 SDD {
+    private readonly projectDir;
+    private readonly sddToolsPath;
+    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: SDDEventStream;
+    constructor(options: SDDOptions);
+    /**
+     * Execute a single SDD 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 SDD events.
+     */
+    onEvent(handler: (event: SDDEvent) => void): void;
+    /**
+     * Subscribe a transport handler to receive all SDD events.
+     * Transports provide structured onEvent/close lifecycle.
+     */
+    addTransport(handler: TransportHandler): void;
+    /**
+     * Create a SDDTools instance for state management operations.
+     */
+    createTools(): SDDTools;
+    /**
+     * Run a full phase lifecycle: discuss → research → plan → execute → verify → advance.
+     *
+     * Creates the necessary collaborators (SDDTools, 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 sdd-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 { SDDConfig } from './config.js';
+export { SDDTools, SDDToolsError, resolveSddToolsPath } from './sdd-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 { SDDEventStream } 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 { SDDLogger } from './logger.js';
+export type { LogLevel, LogEntry, SDDLoggerOptions } 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 { 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,298 @@
+/**
+ * SDD SDK — Public API for running SDD plans programmatically.
+ *
+ * The SDD class composes plan parsing, config loading, prompt building,
+ * and session running into a single `executePlan()` call.
+ *
+ * @example
+ * ```typescript
+ * import { SDD } from '@bhargavvc/sdk';
+ *
+ * const sdd = new SDD({ projectDir: '/path/to/project' });
+ * const result = await sdd.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 { SDDEventType } from './types.js';
+import { parsePlanFile } from './plan-parser.js';
+import { loadConfig } from './config.js';
+import { SDDTools, resolveSddToolsPath } from './sdd-tools.js';
+import { runPlanSession } from './session-runner.js';
+import { SDDEventStream } 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';
+// ─── SDD class ───────────────────────────────────────────────────────────────
+export class SDD {
+    projectDir;
+    sddToolsPath;
+    sessionId;
+    defaultModel;
+    defaultMaxBudgetUsd;
+    defaultMaxTurns;
+    autoMode;
+    workstream;
+    strictSdk;
+    allowFallbackToSubprocess;
+    eventStream;
+    constructor(options) {
+        this.projectDir = resolve(options.projectDir);
+        this.sddToolsPath =
+            options.sddToolsPath ?? resolveSddToolsPath(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 SDDEventStream();
+    }
+    /**
+     * Execute a single SDD 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 SDD events.
+     */
+    onEvent(handler) {
+        this.eventStream.on('event', handler);
+    }
+    /**
+     * Subscribe a transport handler to receive all SDD events.
+     * Transports provide structured onEvent/close lifecycle.
+     */
+    addTransport(handler) {
+        this.eventStream.addTransport(handler);
+    }
+    /**
+     * Create a SDDTools instance for state management operations.
+     */
+    createTools() {
+        return new SDDTools({
+            projectDir: this.projectDir,
+            sddToolsPath: this.sddToolsPath,
+            workstream: this.workstream,
+            eventStream: this.eventStream,
+            sessionId: this.sessionId,
+            strictSdk: this.strictSdk,
+            allowFallbackToSubprocess: this.allowFallbackToSubprocess,
+            onDispatchEvent: (event) => {
+                this.eventStream.emitEvent({
+                    type: SDDEventType.StreamEvent,
+                    timestamp: new Date().toISOString(),
+                    sessionId: this.sessionId ?? '',
+                    event,
+                });
+            },
+        });
+    }
+    /**
+     * Run a full phase lifecycle: discuss → research → plan → execute → verify → advance.
+     *
+     * Creates the necessary collaborators (SDDTools, 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: SDDEventType.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: SDDEventType.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 sdd-executor agent definition if available.
+     * Falls back gracefully — returns undefined if not found.
+     */
+    async loadAgentDefinition() {
+        const paths = [
+            // Repo-local SDD installation
+            join(this.projectDir, '.claude', 'sdd', 'agents', 'sdd-executor.md'),
+            // Repo-local agents directory
+            join(this.projectDir, '.claude', 'agents', 'sdd-executor.md'),
+            // Global home directory
+            join(homedir(), '.claude', 'agents', 'sdd-executor.md'),
+            join(this.projectDir, 'agents', 'sdd-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 { SDDTools, SDDToolsError, resolveSddToolsPath } from './sdd-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 { SDDEventStream } 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 { SDDLogger } 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 `sdd-sdk query` and `SDDTools` hot path)
+export { createRegistry, normalizeQueryCommand } from './query/index.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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"}