@wrongstack/sdd 0.284.1 → 0.285.0

package/dist/spec-builder.d.ts

@@ -0,0 +1,139 @@
+import type { Specification } from '@wrongstack/core/types';
+import type { SpecStore } from './spec-store.js';
+export type AISpecPhase = 'questioning' | 'spec_review' | 'implementation' | 'task_review' | 'executing' | 'done';
+export interface CollectedAnswer {
+    question: string;
+    answer: string;
+    timestamp: number;
+}
+export interface AISpecSession {
+    id: string;
+    phase: AISpecPhase;
+    title: string;
+    userIntent: string;
+    projectContext: string;
+    answers: CollectedAnswer[];
+    questionCount: number;
+    spec?: Specification | undefined;
+    implementation?: string | undefined;
+    taskGraphId?: string | undefined;
+    approved: boolean;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface AISpecBuilderOptions {
+    store: SpecStore;
+    /** Minimum questions the AI should ask. Default: 2 */
+    minQuestions?: number | undefined;
+    /** Maximum questions before forcing spec generation. Default: 10 */
+    maxQuestions?: number | undefined;
+    /** Project context string (package.json, file structure, etc.) */
+    projectContext?: string | undefined;
+    /** Path to persist session state. If set, session survives process restarts. */
+    sessionPath?: string | undefined;
+}
+/**
+ * AI-driven specification builder. Instead of static questions, this builder
+ * tracks conversation state and generates prompts that instruct the AI agent
+ * to ask contextual questions and build specifications interactively.
+ */
+export declare class AISpecBuilder {
+    private session;
+    private readonly store;
+    private readonly minQuestions;
+    private readonly maxQuestions;
+    private readonly sessionPath?;
+    constructor(opts: AISpecBuilderOptions);
+    /** Save session state to disk. */
+    saveSession(): Promise<void>;
+    /** Load session state from disk. Returns true if a session was loaded. */
+    loadSession(): Promise<boolean>;
+    /** Delete saved session from disk. */
+    deleteSession(): Promise<void>;
+    /** Auto-save helper — calls saveSession() but never throws.
+     *  Failures are surfaced via process.emitWarning so a persistent
+     *  ENOSPC / EACCES doesn't silently strand session edits in memory. */
+    private autoSave;
+    /** Start a new session with a title and optional intent. */
+    startSession(title: string, intent?: string): void;
+    /** Get current session state (readonly). */
+    getSession(): Readonly<AISpecSession>;
+    /** Get the current phase. */
+    getPhase(): AISpecPhase;
+    /**
+     * Get the AI prompt for the current phase.
+     * This prompt is injected into the conversation so the AI agent knows
+     * what to do next (ask a question, generate a spec, etc.).
+     */
+    getAIPrompt(): string;
+    /**
+     * Record a question/answer pair from the AI conversation.
+     * Call this when the AI asks a question and the user responds.
+     */
+    addAnswer(question: string, answer: string): void;
+    /**
+     * Check if more questions should be asked.
+     * Returns false if max reached or if the AI has signaled it has enough info.
+     */
+    shouldContinueQuestioning(): boolean;
+    /**
+     * Check if minimum questions have been asked.
+     */
+    hasMetMinimumQuestions(): boolean;
+    /**
+     * Set the generated specification and move to spec_review phase.
+     */
+    setSpec(spec: Specification): void;
+    /**
+     * Approve the current phase and advance to the next.
+     * questioning → spec_review (requires spec to be set)
+     * spec_review → implementation
+     * implementation → task_review (requires implementation to be set)
+     * task_review → executing
+     * executing → done
+     */
+    approve(): AISpecPhase;
+    /**
+     * Set the implementation plan text.
+     */
+    setImplementation(plan: string): void;
+    /**
+     * Mark session as done.
+     */
+    markDone(): void;
+    /**
+     * Set the task graph ID for this session.
+     */
+    setTaskGraphId(graphId: string): void;
+    /**
+     * Get the task graph ID for this session.
+     */
+    getTaskGraphId(): string | undefined;
+    /**
+     * Save the current spec to the store.
+     */
+    saveSpec(): Promise<Specification>;
+    /**
+     * Parse a spec from a JSON string (from AI output).
+     * Validates and normalizes the structure.
+     */
+    parseSpecFromJSON(jsonStr: string): Specification;
+    /**
+     * Extract JSON from AI output (handles ```json blocks and raw JSON).
+     */
+    extractJSON(text: string): string | null;
+    /**
+     * Detect if AI output contains a spec (JSON block).
+     */
+    hasSpecInOutput(text: string): boolean;
+    /**
+     * Try to parse a spec from AI output text.
+     * Returns null if no valid spec found.
+     */
+    tryParseSpecFromOutput(text: string): Specification | null;
+    /**
+     * Extract a JSON array from AI output (for task lists).
+     */
+    extractJSONArray(text: string): string | null;
+}
+//# sourceMappingURL=spec-builder.d.ts.map

package/dist/spec-builder.d.ts.map

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

package/dist/spec-parser.d.ts

@@ -0,0 +1,14 @@
+import type { SpecAnalysis, SpecValidationResult, Specification } from '@wrongstack/core/types';
+export declare class SpecParser {
+    parse(content: string): Specification;
+    private extractTitle;
+    private extractVersion;
+    private extractOverview;
+    private extractSections;
+    private extractRequirements;
+    private parseRequirementLine;
+    private mapSectionType;
+    analyze(spec: Specification): SpecAnalysis;
+    validate(spec: Specification): SpecValidationResult;
+}
+//# sourceMappingURL=spec-parser.d.ts.map

package/dist/spec-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-parser.d.ts","sourceRoot":"","sources":["../src/spec-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAGZ,oBAAoB,EACpB,aAAa,EACd,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,UAAU;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAiBpC;IAED,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,eAAe;IA+CvB,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,oBAAoB;IAmC5B,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CA2DzC;IAED,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,oBAAoB,CAqClD;CACF"}

package/dist/spec-store.d.ts

@@ -0,0 +1,36 @@
+import type { Specification, SpecStatus } from '@wrongstack/core/types';
+export interface SpecStoreOptions {
+    /** Directory where spec files are stored. Defaults to `.wrongstack/specs`. */
+    baseDir: string;
+}
+export interface SpecIndexEntry {
+    id: string;
+    title: string;
+    version: string;
+    status: SpecStatus;
+    updatedAt: number;
+    filePath: string;
+}
+/**
+ * File-backed spec storage. Each spec is a JSON file under `baseDir/`.
+ * An index file (`_index.json`) tracks all specs for fast listing.
+ */
+export declare class SpecStore {
+    private readonly baseDir;
+    private readonly indexPath;
+    constructor(opts: SpecStoreOptions);
+    save(spec: Specification): Promise<void>;
+    load(id: string): Promise<Specification | null>;
+    list(): Promise<SpecIndexEntry[]>;
+    delete(id: string): Promise<boolean>;
+    exists(id: string): Promise<boolean>;
+    /** Create a new spec with defaults, assign ID, and persist. */
+    createDraft(title: string, overview?: string): Promise<Specification>;
+    /** Update spec fields and persist. */
+    update(id: string, patch: Partial<Omit<Specification, 'id' | 'createdAt'>>): Promise<Specification | null>;
+    private filePath;
+    private readIndex;
+    private updateIndex;
+    private removeFromIndex;
+}
+//# sourceMappingURL=spec-store.d.ts.map

package/dist/spec-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-store.d.ts","sourceRoot":"","sources":["../src/spec-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD;;;GAGG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,IAAI,EAAE,gBAAgB,EAGjC;IAEK,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7C;IAEK,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAOpD;IAEK,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAGtC;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQzC;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOzC;IAED,+DAA+D;IACzD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAe1E;IAED,sCAAsC;IAChC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAY/G;IAED,OAAO,CAAC,QAAQ;YAIF,SAAS;YAWT,WAAW;YAmBX,eAAe;CAK9B"}

package/dist/spec-templates.d.ts

@@ -0,0 +1,22 @@
+import type { SpecTemplate } from '@wrongstack/core/types';
+/**
+ * Built-in spec templates for common development scenarios.
+ */
+export declare const SPEC_TEMPLATES: SpecTemplate[];
+/**
+ * Get a template by ID.
+ */
+export declare function getTemplate(id: string): SpecTemplate | undefined;
+/**
+ * List all available templates.
+ */
+export declare function listTemplates(): Array<{
+    id: string;
+    name: string;
+    description: string;
+}>;
+/**
+ * Generate a markdown skeleton from a template.
+ */
+export declare function templateToMarkdown(template: SpecTemplate, title?: string): string;
+//# sourceMappingURL=spec-templates.d.ts.map

package/dist/spec-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-templates.d.ts","sourceRoot":"","sources":["../src/spec-templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EA+FxC,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAExF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAajF"}

package/dist/spec-versioning.d.ts

@@ -0,0 +1,49 @@
+import type { Specification, SpecRequirement } from '@wrongstack/core/types';
+import type { TaskGraph } from '@wrongstack/core/types';
+export interface SpecVersion {
+    version: string;
+    spec: Specification;
+    timestamp: number;
+    changeDescription?: string | undefined;
+}
+export interface SpecDiff {
+    added: SpecRequirement[];
+    removed: SpecRequirement[];
+    modified: Array<{
+        requirement: SpecRequirement;
+        previousVersion: SpecRequirement;
+        changes: string[];
+    }>;
+    summary: string;
+}
+/**
+ * Track spec versions and compute diffs between versions.
+ */
+export declare class SpecVersioning {
+    private versions;
+    /** Record a new version of a spec. */
+    recordVersion(spec: Specification, changeDescription?: string): SpecVersion;
+    /** Get version history for a spec. */
+    getHistory(specId: string): SpecVersion[];
+    /** Get a specific version of a spec. */
+    getVersion(specId: string, version: string): SpecVersion | undefined;
+    /** Get the latest version of a spec. */
+    getLatest(specId: string): SpecVersion | undefined;
+    /** Compute diff between two versions of a spec. */
+    diff(oldSpec: Specification, newSpec: Specification): SpecDiff;
+    /**
+     * Update a task graph incrementally based on spec changes.
+     * - Added requirements → new tasks
+     * - Removed requirements → remove tasks
+     * - Modified requirements → update task descriptions
+     * Returns the updated graph and list of changes made.
+     */
+    updateTaskGraph(graph: TaskGraph, oldSpec: Specification, newSpec: Specification): {
+        graph: TaskGraph;
+        changes: string[];
+    };
+    private compareRequirements;
+    private buildTaskDescription;
+    private mapReqType;
+}
+//# sourceMappingURL=spec-versioning.d.ts.map

package/dist/spec-versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-versioning.d.ts","sourceRoot":"","sources":["../src/spec-versioning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,wBAAwB,CAAC;AAGlE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC;QACd,WAAW,EAAE,eAAe,CAAC;QAC7B,eAAe,EAAE,eAAe,CAAC;QACjC,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAoC;IAEpD,sCAAsC;IACtC,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,WAAW,CAa1E;IAED,sCAAsC;IACtC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAExC;IAED,wCAAwC;IACxC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGnE;IAED,wCAAwC;IACxC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGjD;IAED,mDAAmD;IACnD,IAAI,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,GAAG,QAAQ,CA2C7D;IAED;;;;;;OAMG;IACH,eAAe,CACb,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,aAAa,GACrB;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAwDzC;IAED,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,UAAU;CAgBnB"}

package/dist/start-sdd-run.d.ts

@@ -0,0 +1,67 @@
+import type { Agent } from '@wrongstack/core';
+import type { AgentFactory } from '@wrongstack/core';
+import type { EventBus } from '@wrongstack/core/kernel';
+import type { TaskGraph } from '@wrongstack/core/types';
+import type { TaskTracker } from '@wrongstack/core/tasking';
+import type { WorktreeManager } from '@wrongstack/core';
+import { SddBoardProjector } from './sdd-board-projector.js';
+import type { SddBoardStore } from './sdd-board-store.js';
+import type { SddRunRegistry } from './sdd-run-registry.js';
+import { SddParallelRun, type RunResult, type SddProgress, type SddParallelRunOptions } from './sdd-parallel-run.js';
+export interface StartSddRunOptions {
+    tracker: TaskTracker;
+    graph: TaskGraph;
+    /** Leader agent — seeds the default factory and the run's project context. */
+    agent: Agent;
+    projectRoot: string;
+    events: EventBus;
+    /** Parent session id for all SDD EventBus emissions. */
+    sessionId?: string | (() => string | undefined) | undefined;
+    /** Per-task agent factory. Omit to run every task on the leader agent. */
+    subagentFactory?: AgentFactory | undefined;
+    /** Board snapshot/event persistence (also drained for cross-process control). */
+    boardStore: SddBoardStore;
+    /** Registry the run is registered with for in-process control. */
+    registry?: SddRunRegistry | undefined;
+    parallelSlots?: number | undefined;
+    /** Opt-in hard wall-clock cap per task (ms). Omit → no cap (idle reaper guards). */
+    taskTimeoutMs?: number | undefined;
+    /** Idle reaper per task (ms); resets on activity. Default 600_000 (10 min). */
+    taskIdleTimeoutMs?: number | undefined;
+    /** End-of-run failed-task auto-retry sweeps (bounded). Default 2. */
+    maxFailedRetrySweeps?: number | undefined;
+    /** Post-task verification gate (forwarded to SddParallelRun). Omit → no gate. */
+    verifyTask?: SddParallelRunOptions['verifyTask'];
+    /** Merge-conflict resolver (forwarded to SddParallelRun). Omit → retry-on-fresh-base then fail. */
+    conflictResolver?: SddParallelRunOptions['conflictResolver'];
+    /** Failure supervisor (forwarded to SddParallelRun). Omit → no rescue, plain terminal-fail. */
+    superviseFailure?: SddParallelRunOptions['superviseFailure'];
+    /** Run-level default worker model / provider / fallback chain (task overrides win). */
+    defaultModel?: string | undefined;
+    defaultProvider?: string | undefined;
+    fallbackModels?: string[] | undefined;
+    /** Per-task git worktree isolation. Omit → tasks share the working tree. */
+    worktrees?: WorktreeManager | undefined;
+    /** Bounded deadlock recovery rounds (default 1). */
+    maxRecoveryRounds?: number | undefined;
+    /** Progress callback (e.g. CLI renderer line). */
+    onProgress?: ((p: SddProgress) => void) | undefined;
+    /** Control-file drain interval in ms (default 500). */
+    controlDrainMs?: number | undefined;
+}
+export interface SddRunHandle {
+    run: SddParallelRun;
+    runId: string;
+    projector: SddBoardProjector;
+    /** Resolves when the run finishes AND all teardown (drain/dispose/clear) is done. */
+    completion: Promise<RunResult>;
+    /** Request a clean stop (idempotent). */
+    stop(): void;
+}
+/**
+ * Wire up and start an SDD parallel run. Returns immediately with a handle whose
+ * `completion` promise resolves once the run finishes and teardown is complete.
+ * Orphaned in_progress tasks are reset up-front so a crashed prior run re-executes.
+ */
+export declare function startSddRun(opts: StartSddRunOptions): SddRunHandle;
+//# sourceMappingURL=start-sdd-run.d.ts.map

package/dist/start-sdd-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-sdd-run.d.ts","sourceRoot":"","sources":["../src/start-sdd-run.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EACL,cAAc,EACd,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,8EAA8E;IAC9E,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,QAAQ,CAAC;IACjB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC5D,0EAA0E;IAC1E,eAAe,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAC3C,iFAAiF;IACjF,UAAU,EAAE,aAAa,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,qEAAqE;IACrE,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,iFAAiF;IACjF,UAAU,CAAC,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACjD,mGAAmG;IACnG,gBAAgB,CAAC,EAAE,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;IAC7D,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;IAC7D,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,4EAA4E;IAC5E,SAAS,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACxC,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,kDAAkD;IAClD,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACpD,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,cAAc,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,iBAAiB,CAAC;IAC7B,qFAAqF;IACrF,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,yCAAyC;IACzC,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,CA2HlE"}

package/dist/task-flow.d.ts

@@ -0,0 +1,99 @@
+import type { EventBus } from '@wrongstack/core/kernel';
+import type { DoneCondition } from '@wrongstack/core/types';
+import type { SpecAnalysis, Specification } from '@wrongstack/core/types';
+import type { TaskGraph, TaskNode } from '@wrongstack/core/types';
+import { TaskTracker } from '@wrongstack/core/tasking';
+/**
+ * Extended event map used internally by TaskFlow and multi-agent components.
+ * These events are emitted on the injected EventBus and are a subset of
+ * the full EventMap — they do not require a separate registration.
+ */
+export interface TaskFlowEventMap {
+    'phase.change': {
+        from: TaskFlowPhase;
+        to: TaskFlowPhase;
+    };
+    'task.started': {
+        taskId: string;
+    };
+    'task.completed': {
+        taskId: string;
+        result?: unknown | undefined;
+    };
+    'task.failed': {
+        taskId: string;
+        error: string;
+    };
+    'task.review': {
+        taskId: string;
+    };
+    'spec.analyzed': {
+        analysis: SpecAnalysis;
+    };
+    progress: {
+        percent: number;
+        message: string;
+    };
+    done: {
+        graph: TaskGraph;
+    };
+    error: {
+        phase: TaskFlowPhase;
+        error: Error;
+    };
+}
+export type TaskFlowPhase = 'idle' | 'parsing' | 'analyzing' | 'generating' | 'executing' | 'reviewing' | 'completing' | 'done' | 'failed';
+export type TaskFlowEventName = keyof TaskFlowEventMap;
+export interface TaskFlowOptions {
+    tracker: TaskTracker;
+    events: EventBus;
+    doneCondition?: DoneCondition | undefined;
+    maxConcurrent?: number | undefined;
+}
+export interface TaskFlowExecutionContext {
+    executeTask: (task: TaskNode) => Promise<unknown>;
+    onTaskComplete?: (task: TaskNode | undefined, result: unknown) => void;
+    onTaskFail?: (task: TaskNode | undefined, error: Error) => void;
+}
+export declare class TaskFlow {
+    private readonly opts;
+    private phase;
+    private spec;
+    private graph;
+    private stopped;
+    constructor(opts: TaskFlowOptions);
+    private emit;
+    fromSpec(specContent: string): Promise<TaskGraph>;
+    execute(ctx: TaskFlowExecutionContext): Promise<TaskGraph>;
+    reviewTask(taskId: string, approved: boolean, comment?: string): Promise<void>;
+    stop(): void;
+    getPhase(): TaskFlowPhase;
+    getGraph(): TaskGraph | null;
+    getSpec(): Specification | null;
+    private setPhase;
+    private getExecutableTasks;
+    private executeSingleTask;
+    private checkDoneCondition;
+    private emitProgress;
+}
+export interface SpecDrivenDevOptions {
+    workingDirectory: string;
+    events: EventBus;
+    doneCondition?: DoneCondition | undefined;
+}
+export declare class SpecDrivenDev {
+    private store;
+    private tracker;
+    private readonly events;
+    private flows;
+    constructor(opts: SpecDrivenDevOptions);
+    createFlow(specContent: string, options?: Partial<TaskFlowOptions>): Promise<TaskFlow>;
+    getTracker(): TaskTracker;
+    getFlow(graphId: string): TaskFlow | undefined;
+    listFlows(): {
+        id: string;
+        title: string;
+        phase: TaskFlowPhase;
+    }[];
+}
+//# sourceMappingURL=task-flow.d.ts.map

package/dist/task-flow.d.ts.map

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

package/dist/task-generator.d.ts

@@ -0,0 +1,39 @@
+import type { Specification } from '@wrongstack/core/types';
+import type { TaskGraph, TaskPriority, TaskType } from '@wrongstack/core/types';
+import type { TaskStore, TaskTracker } from '@wrongstack/core/tasking';
+export interface TaskGeneratorOptions {
+    taskTracker: TaskTracker;
+    /**
+     * Opt-in (default off): derive each task's completion-gate
+     * `metadata.verificationCommand` from an acceptance criterion that carries a
+     * runnable-command marker (`$ <cmd>`, or `run:`/`verify:`/`cmd:` prefix). Off
+     * by default so the common case stays fast — auto-running a check per task is
+     * exactly the slowness the robustness initiative set out to avoid; enable it
+     * explicitly (the CLI gates it behind WRONGSTACK_SDD_VERIFY_FROM_ACCEPTANCE).
+     */
+    verificationFromAcceptance?: boolean | undefined;
+}
+/**
+ * Pull a runnable verification command out of a requirement's acceptance
+ * criteria. A criterion qualifies only when it carries an explicit marker —
+ * `$ <cmd>` (shell-prompt style) or a `run:` / `verify:` / `cmd:` prefix — so
+ * free-text criteria are never mistaken for commands. Returns the first match.
+ */
+export declare function extractVerificationCommand(criteria: readonly string[]): string | undefined;
+export interface GeneratedTask {
+    specRequirementId?: string | undefined;
+    title: string;
+    description: string;
+    type: TaskType;
+    priority: TaskPriority;
+    estimateHours?: number | undefined;
+    tags?: string[] | undefined;
+}
+export declare class TaskGenerator {
+    private readonly opts;
+    constructor(opts: TaskGeneratorOptions);
+    generateFromSpec(spec: Specification): Promise<TaskGraph>;
+    generateSubtasks(parentTaskId: string, spec: Specification): Promise<void>;
+}
+export { TaskStore };
+//# sourceMappingURL=task-generator.d.ts.map

package/dist/task-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-generator.d.ts","sourceRoot":"","sources":["../src/task-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,WAAW,CAAC;IACzB;;;;;;;OAOG;IACH,0BAA0B,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAO1F;AAED,MAAM,WAAW,aAAa;IAC5B,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC7B;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,oBAAoB,EAAI;IAErD,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAG9D;IAEK,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB/E;CACF;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/task-graph-store.d.ts

@@ -0,0 +1,33 @@
+import type { TaskGraph } from '@wrongstack/core/types';
+export interface TaskGraphStoreOptions {
+    /** Directory where task graph files are stored. Defaults to `.wrongstack/task-graphs`. */
+    baseDir: string;
+}
+export interface TaskGraphIndexEntry {
+    id: string;
+    specId: string;
+    title: string;
+    nodeCount: number;
+    completedCount: number;
+    updatedAt: number;
+    filePath: string;
+}
+/**
+ * File-backed task graph storage. Each graph is a JSON file under `baseDir/`.
+ * An index file (`_index.json`) tracks all graphs for fast listing.
+ */
+export declare class TaskGraphStore {
+    private readonly baseDir;
+    private readonly indexPath;
+    constructor(opts: TaskGraphStoreOptions);
+    save(graph: TaskGraph): Promise<void>;
+    load(id: string): Promise<TaskGraph | null>;
+    list(): Promise<TaskGraphIndexEntry[]>;
+    delete(id: string): Promise<boolean>;
+    exists(id: string): Promise<boolean>;
+    private filePath;
+    private readIndex;
+    private updateIndex;
+    private removeFromIndex;
+}
+//# sourceMappingURL=task-graph-store.d.ts.map

package/dist/task-graph-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-graph-store.d.ts","sourceRoot":"","sources":["../src/task-graph-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,wBAAwB,CAAC;AAElE,MAAM,WAAW,qBAAqB;IACpC,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA0BD;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,IAAI,EAAE,qBAAqB,EAGtC;IAEK,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAK1C;IAEK,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAOhD;IAEK,IAAI,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAG3C;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQzC;IAEK,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOzC;IAED,OAAO,CAAC,QAAQ;YAIF,SAAS;YAWT,WAAW;YAuBX,eAAe;CAK9B"}

package/dist/task-tracker.d.ts

@@ -0,0 +1,2 @@
+export { type TaskStore, type TaskTrackerOptions, type TaskTransition, type TaskTrackerChange, type TaskTrackerListener, TaskTracker, } from '@wrongstack/core';
+//# sourceMappingURL=task-tracker.d.ts.map

package/dist/task-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-tracker.d.ts","sourceRoot":"","sources":["../src/task-tracker.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,WAAW,GACZ,MAAM,kBAAkB,CAAC"}

package/dist/task-visualizer.d.ts

@@ -0,0 +1,26 @@
+import type { TaskGraph, TaskProgress } from '@wrongstack/core/types';
+import type { Specification } from '@wrongstack/core/types';
+/**
+ * Render a task graph as ASCII art for terminal display.
+ */
+export declare function renderTaskGraph(graph: TaskGraph, opts?: {
+    compact?: boolean | undefined;
+}): string;
+/**
+ * Render a progress bar.
+ */
+export declare function renderProgress(progress: TaskProgress): string;
+/**
+ * Render a compact task list (for quick status checks).
+ */
+export declare function renderTaskList(graph: TaskGraph): string;
+/**
+ * Render spec analysis summary.
+ */
+export declare function renderSpecAnalysis(spec: Specification, analysis: {
+    completeness: number;
+    gaps: string[];
+    risks: string[];
+    suggestions: string[];
+}): string;
+//# sourceMappingURL=task-visualizer.d.ts.map

package/dist/task-visualizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-visualizer.d.ts","sourceRoot":"","sources":["../src/task-visualizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAY,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AA4B5D;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAE,GAAG,MAAM,CAsDlG;AA+CD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAU7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CA+BvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GACzF,MAAM,CAqCR"}

package/dist/verify-task.d.ts

@@ -0,0 +1,23 @@
+import type { TaskNode } from '@wrongstack/core/types';
+import type { TaskResult } from '@wrongstack/core/types';
+export interface CommandVerifierOptions {
+    /** Metadata key holding the shell command to run. Default 'verificationCommand'. */
+    metadataKey?: string;
+    /** Kill + fail the verification after this many ms. Default 180_000 (3 min). */
+    timeoutMs?: number;
+}
+/**
+ * Build a `verifyTask` closure (shape matches {@link SddParallelRunOptions.verifyTask}).
+ * Returns `{ ok: true }` immediately when the task carries no verification command,
+ * otherwise spawns the command in `cwd` (shell, output discarded) and resolves
+ * `{ ok: false, reason }` on non-zero exit, spawn error, or timeout.
+ */
+export declare function makeCommandVerifier(options?: CommandVerifierOptions): (info: {
+    task: TaskNode;
+    result: TaskResult;
+    cwd: string;
+}) => Promise<{
+    ok: boolean;
+    reason?: string;
+}>;
+//# sourceMappingURL=verify-task.d.ts.map

package/dist/verify-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-task.d.ts","sourceRoot":"","sources":["../src/verify-task.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,sBAA2B,UAI/B;IACrC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb,KAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA0C9C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrongstack/sdd",
-  "version": "0.284.1",
+  "version": "0.285.0",
   "license": "MIT",
   "description": "WrongStack Spec-Driven Development engine — standalone package extracted from @wrongstack/core. Task graph generation, tracking, execution, lifecycle management, and AI-driven spec building for SDD workflows.",
   "repository": {
@@ -26,18 +26,17 @@
     "dist"
   ],
   "dependencies": {
-    "@wrongstack/core": "0.284.1"
+    "@wrongstack/core": "0.285.0"
   },
   "devDependencies": {
     "@types/node": "^26.0.1",
-    "tsup": "^8.5.1",
-    "typescript": "^6.0.3"
+    "typescript": "^7.0.2"
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "node ../../scripts/build-package.mjs",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\""