@wrongstack/sdd 0.284.1 → 0.285.0

package/dist/sdd-board-projector.d.ts

@@ -0,0 +1,83 @@
+/**
+ * SddBoardProjector
+ *
+ * Composes a live SDD board snapshot from a running graph and streams it to
+ * every surface. It subscribes to `TaskTracker` mutations (the source of truth
+ * for task state) plus the run's `sdd.*` lifecycle events (status / wave /
+ * deadlock), and on each change — throttled — rebuilds a `SddBoardSnapshot`,
+ * emits `sdd.board.snapshot` on the EventBus, persists it (JSON) and appends the
+ * triggering event to the board's JSONL log.
+ *
+ * The graph is the single source of truth: task status/assignee/worktree live
+ * on the nodes (the run mutates them through the tracker), so the projector
+ * mostly re-derives the snapshot and only tracks run-level status/wave/deadlock.
+ */
+import type { EventBus } from '@wrongstack/core/kernel';
+import type { TaskGraph } from '@wrongstack/core/types';
+import type { TaskTracker } from '@wrongstack/core/tasking';
+import type { SddBoardStore } from './sdd-board-store.js';
+export interface SddBoardProjectorOptions {
+    runId: string;
+    graph: TaskGraph;
+    tracker: TaskTracker;
+    events: EventBus;
+    /** Parent session id for emitted `sdd.board.snapshot` events. */
+    sessionId?: string | (() => string | undefined) | undefined;
+    /** Persist snapshots + JSONL events (optional — omit for in-memory only). */
+    store?: SddBoardStore | undefined;
+    specId?: string | undefined;
+    /** Run-level default worker model/provider/fallbacks (shown in the board header). */
+    defaultModel?: string | undefined;
+    defaultProvider?: string | undefined;
+    fallbackModels?: string[] | undefined;
+    /** Base branch the run's squash commits land on (for the board + rollback). */
+    baseBranch?: string | undefined;
+    /** Snapshot coalescing window in ms (default 250). */
+    throttleMs?: number | undefined;
+    /** Clock injection for tests; defaults to Date.now. */
+    now?: (() => number) | undefined;
+}
+export declare class SddBoardProjector {
+    private readonly o;
+    private readonly now;
+    private readonly throttleMs;
+    private readonly shortId;
+    private status;
+    private wave;
+    private startedAt;
+    private deadlockChains;
+    /** Live activity feed, most recent first (capped). */
+    private feed;
+    private static readonly FEED_CAP;
+    private finished;
+    private runDeadlocked;
+    private runStopped;
+    /** Squash commits the run landed on the base branch (for post-run rollback). */
+    private mergedCommits;
+    /** Base branch reported by the run at start (overrides the constructor option). */
+    private runBaseBranch;
+    private dirty;
+    private timer;
+    private readonly unsubs;
+    /** Tail of in-flight persistence, so callers can await a settled state. */
+    private lastSave;
+    constructor(opts: SddBoardProjectorOptions);
+    private pushFeed;
+    /** ` (title…)` suffix for a feed line, or '' when the node/title is missing. */
+    private titleOf;
+    private assigneeOf;
+    /** Latest snapshot, built on demand (e.g. for a late-joining client). */
+    snapshot(): import("./board-types.js").SddBoardSnapshot;
+    /** Resolve once all in-flight snapshot persistence has settled. */
+    drain(): Promise<void>;
+    /** Stop projecting and release subscriptions. */
+    dispose(): void;
+    /** Subscribe to a run event scoped to this run id; also append to JSONL. */
+    private onRun;
+    private resolveStatus;
+    private build;
+    private markDirty;
+    private flush;
+    private currentSessionId;
+}
+//# sourceMappingURL=sdd-board-projector.d.ts.map

package/dist/sdd-board-projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdd-board-projector.d.ts","sourceRoot":"","sources":["../src/sdd-board-projector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAQ5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,QAAQ,CAAC;IACjB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC5D,6EAA6E;IAC7E,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,qFAAqF;IACrF,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,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uDAAuD;IACvD,GAAG,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CAClC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAA2B;IAC7C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAE9C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAA0B;IAChD,sDAAsD;IACtD,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAM;IACtC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,UAAU,CAAS;IAC3B,gFAAgF;IAChF,OAAO,CAAC,aAAa,CAA6D;IAClF,mFAAmF;IACnF,OAAO,CAAC,aAAa,CAAqB;IAE1C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAoC;IAEpD,YAAY,IAAI,EAAE,wBAAwB,EA6IzC;IAED,OAAO,CAAC,QAAQ;IAKhB,gFAAgF;IAChF,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,UAAU;IAIlB,yEAAyE;IACzE,QAAQ,gDAEP;IAED,mEAAmE;IAC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAED,iDAAiD;IACjD,OAAO,IAAI,IAAI,CAOd;IAID,4EAA4E;IAC5E,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,KAAK;IAuBb,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,KAAK;IAqBb,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/sdd-board-store.d.ts

@@ -0,0 +1,59 @@
+import type { SddBoardSnapshot } from './board-types.js';
+export interface SddBoardStoreOptions {
+    /** Directory for board snapshots + event logs (wpaths.projectSddBoards). */
+    baseDir: string;
+}
+export interface SddBoardIndexEntry {
+    runId: string;
+    specId?: string | undefined;
+    title: string;
+    status: string;
+    total: number;
+    completed: number;
+    updatedAt: number;
+}
+/** One appended line in a board's JSONL event log. */
+export interface SddBoardEvent {
+    ts: number;
+    type: string;
+    payload?: unknown;
+}
+/**
+ * File-backed SDD board storage. Each board (= one parallel run) has:
+ *   - `<runId>.json`        — latest full snapshot (atomic; resume + standalone-webui mirror)
+ *   - `<runId>.events.jsonl`— append-only event log (audit / replay)
+ *   - `<runId>.control.jsonl` — append-only command queue (cross-process control, written by readers)
+ * plus `_index.json` for fast listing. JSON for state, JSONL for streams.
+ */
+export declare class SddBoardStore {
+    private readonly baseDir;
+    private readonly indexPath;
+    constructor(opts: SddBoardStoreOptions);
+    snapshotPath(runId: string): string;
+    eventsPath(runId: string): string;
+    controlPath(runId: string): string;
+    saveSnapshot(snapshot: SddBoardSnapshot): Promise<void>;
+    load(runId: string): Promise<SddBoardSnapshot | null>;
+    list(): Promise<SddBoardIndexEntry[]>;
+    loadLatestForSpec(specId: string): Promise<SddBoardSnapshot | null>;
+    /** Append one line to the board's JSONL event log (best-effort, never throws). */
+    appendEvent(runId: string, event: SddBoardEvent): Promise<void>;
+    /** Append a control command (used by readers to steer a CLI-owned run). */
+    appendControl(runId: string, command: {
+        ts: number;
+        type: string;
+        payload?: unknown;
+    }): Promise<void>;
+    /** Read + truncate the control queue (the run drains it). Returns parsed commands. */
+    drainControl(runId: string): Promise<Array<{
+        ts: number;
+        type: string;
+        payload?: unknown;
+    }>>;
+    delete(runId: string): Promise<void>;
+    private safe;
+    private readIndex;
+    private updateIndex;
+    private removeFromIndex;
+}
+//# sourceMappingURL=sdd-board-store.d.ts.map

package/dist/sdd-board-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdd-board-store.d.ts","sourceRoot":"","sources":["../src/sdd-board-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,IAAI,EAAE,oBAAoB,EAGrC;IAED,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElC;IACD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhC;IACD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjC;IAEK,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5D;IAEK,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAO1D;IAEK,IAAI,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAG1C;IAEK,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAGxE;IAED,kFAAkF;IAC5E,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpE;IAED,2EAA2E;IACrE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1G;IAED,sFAAsF;IAChF,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAwBjG;IAEK,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzC;IAID,OAAO,CAAC,IAAI;YAIE,SAAS;YAWT,WAAW;YAiBX,eAAe;CAK9B"}

package/dist/sdd-interview-driver.d.ts

@@ -0,0 +1,131 @@
+import type { TaskGraph } from '@wrongstack/core/types';
+import { AISpecBuilder, type AISpecPhase } from './spec-builder.js';
+import type { SpecStore } from './spec-store.js';
+import type { TaskGraphStore } from './task-graph-store.js';
+import { TaskTracker } from '@wrongstack/core/tasking';
+import { type SddBoardTask, type SddBoardColumn } from './board-types.js';
+export interface SddInterviewDriverOptions {
+    /** Disk-backed spec store (`wpaths.projectSpecs`). */
+    specStore: SpecStore;
+    /** Disk-backed task-graph store (`wpaths.projectTaskGraphs`). */
+    graphStore: TaskGraphStore;
+    /** Persist the interview session here so a reconnect can resume it. */
+    sessionPath?: string | undefined;
+    /** Project context string injected into the questioning prompt. */
+    projectContext?: string | undefined;
+    minQuestions?: number | undefined;
+    maxQuestions?: number | undefined;
+}
+/** A serialisable view of the interview, streamed to observing surfaces. */
+export interface SddInterviewSnapshot {
+    sessionId: string;
+    phase: AISpecPhase;
+    title: string;
+    /** The operator's original goal prompt (verbatim). `title` is a short heading. */
+    goal: string;
+    questionCount: number;
+    minQuestions: number;
+    maxQuestions: number;
+    answers: Array<{
+        question: string;
+        answer: string;
+    }>;
+    spec?: {
+        id: string;
+        title: string;
+        overview: string;
+        requirements: Array<{
+            priority: string;
+            description: string;
+        }>;
+    } | undefined;
+    graphId?: string | undefined;
+    taskCount: number;
+    /**
+     * Topologically-laid-out task graph (once decomposed) — lets the wizard
+     * render the same animated DAG as the live board ("decomposition reveal").
+     */
+    board?: {
+        tasks: SddBoardTask[];
+        columns: SddBoardColumn[];
+    } | undefined;
+    /** The current AI prompt for this phase (what to send the agent next). */
+    prompt: string;
+}
+/** What `ingestAgentOutput` detected and acted on. */
+export interface SddIngestResult {
+    specDetected: boolean;
+    implementationDetected: boolean;
+    tasksDetected: boolean;
+    graphId?: string | undefined;
+}
+export declare class SddInterviewDriver {
+    readonly builder: AISpecBuilder;
+    private readonly o;
+    private readonly minQuestions;
+    private readonly maxQuestions;
+    private tracker;
+    private graph;
+    constructor(opts: SddInterviewDriverOptions);
+    /** Begin a fresh interview. Returns the first AI prompt (a question kickoff). */
+    start(title: string, intent?: string): string;
+    /**
+     * Resume a previously-persisted interview from disk. Re-hydrates the task
+     * graph too when one was already produced. Returns true if a session loaded.
+     */
+    loadExisting(): Promise<boolean>;
+    phase(): AISpecPhase;
+    currentPrompt(): string;
+    getTracker(): TaskTracker | null;
+    getGraph(): TaskGraph | null;
+    /** Record a Q/A pair (the agent asked `question`, the user replied `answer`). */
+    submitAnswer(question: string, answer: string): void;
+    /**
+     * Feed the agent's text output back into the interview. Detects, in order:
+     *  1. a Specification JSON  → setSpec (phase → spec_review) + persist to SpecStore
+     *  2. an implementation plan (implementation phase) → setImplementation
+     *  3. a task JSON array      → build + persist a TaskGraph
+     * Each step is independent and best-effort; a malformed payload is ignored
+     * rather than thrown, so a chatty agent turn never breaks the interview.
+     */
+    ingestAgentOutput(text: string): Promise<SddIngestResult>;
+    /**
+     * Advance to the next phase (mirrors `/sdd approve`). When moving into the
+     * executing phase, guarantees a task graph exists — deterministically
+     * generating one from the approved spec if the agent never emitted a valid
+     * task array. Returns the new phase and its AI prompt.
+     */
+    approve(): Promise<{
+        phase: AISpecPhase;
+        prompt: string;
+    }>;
+    /**
+     * Ensure a TaskGraph exists for the approved spec. If the agent already
+     * produced one (via `ingestAgentOutput`), returns it; otherwise builds a
+     * deterministic graph from the spec's requirements via TaskGenerator. This is
+     * the robustness backstop: a run can always start, even if the model never
+     * emitted a parseable task array.
+     */
+    ensureTaskGraph(): Promise<TaskGraph | null>;
+    snapshot(): SddInterviewSnapshot;
+    private persistSpec;
+    private persistGraph;
+    /**
+     * Port of the CLI `trySaveImplementationPlan` operating on this driver's
+     * builder. Captures the prose plan that precedes the task JSON block.
+     */
+    private trySaveImplementationPlan;
+    /**
+     * Port of the CLI `trySaveTasksFromAIOutput`: parse a task JSON array from the
+     * agent output, build (or extend) the tracker + graph, persist to disk, and
+     * link the graphId to the session. Returns the graphId on success.
+     */
+    private tryBuildTasksFromOutput;
+}
+/**
+ * True when the text reads like conversational filler rather than a structured
+ * implementation plan. Ported verbatim from the CLI detection so behaviour is
+ * identical across surfaces.
+ */
+export declare function isExplanatoryText(text: string): boolean;
+//# sourceMappingURL=sdd-interview-driver.d.ts.map

package/dist/sdd-interview-driver.d.ts.map

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

package/dist/sdd-lifecycle.d.ts

@@ -0,0 +1,146 @@
+/** Force-remove every git worktree + branch a previous run left behind. */
+export declare function cleanupSddWorktrees(projectRoot: string): Promise<{
+    removed: number;
+}>;
+/**
+ * Detect and clean up stale worktrees from a crashed previous run.
+ * No-op when the project is clean. Called on SDD/Director boot to
+ * prevent orphaned worktrees from conflicting with the next run's
+ * `allocate()`.
+ *
+ * P2 #B6 (sprint2 audit).
+ */
+export declare function cleanupStaleWorktrees(projectRoot: string): Promise<{
+    removed: number;
+    detected: number;
+}>;
+export interface CleanupStaleSddOptions {
+    projectRoot: string;
+    /** Board snapshot dir (`wpaths.projectSddBoards`) — read for the liveness guard. */
+    boardsDir: string;
+    /** A `running` board updated within this window is treated as live → skip. Default 120_000 (2 min). */
+    runningLiveMs?: number | undefined;
+    /** A `paused` board updated within this window is treated as live → skip. Default 1_800_000 (30 min). */
+    pausedLiveMs?: number | undefined;
+    /** Injectable clock for tests. */
+    now?: (() => number) | undefined;
+}
+export interface CleanupStaleSddResult {
+    /** True when a sweep ran (orphans were found and removed). */
+    swept: boolean;
+    removed: number;
+    detected: number;
+    /** Set when the sweep was skipped because a run appears live. */
+    skippedReason?: string | undefined;
+}
+/**
+ * Liveness-guarded stale-worktree sweep for boot + run-start. Worktrees live
+ * under `<projectRoot>/.wrongstack/worktrees` and a sweep force-removes ALL of
+ * them — so it must NEVER run under a genuinely live run (possibly in another
+ * process). The guard reads the latest board: a `running` board updated within
+ * `runningLiveMs`, or a `paused` one within `pausedLiveMs`, is treated as live
+ * and the sweep is skipped. A crashed run leaves its board frozen as `running`
+ * → once it ages past the window it is correctly swept. Any other status
+ * (completed / failed / stopped / deadlocked / idle) is always sweepable.
+ * Never throws — best-effort cleanup.
+ */
+export declare function cleanupStaleSddWorktrees(opts: CleanupStaleSddOptions): Promise<CleanupStaleSddResult>;
+export interface RollbackFromDiskOptions {
+    projectRoot: string;
+    /** Directory holding persisted board snapshots (`wpaths.projectSddBoards`). */
+    boardsDir: string;
+    /** Specific run to roll back. Omit → the most recently updated board. */
+    runId?: string | undefined;
+}
+/**
+ * Roll back a finished run's merged commits by reading its persisted board
+ * snapshot (base branch + commit SHAs) and reverting each. History-preserving;
+ * refuses on a dirty tree or revert conflict (surfaced in `reason`). Returns
+ * `ok:false` with a reason when there is no board, no base branch, or nothing to
+ * revert.
+ */
+export declare function rollbackSddRunFromDisk(opts: RollbackFromDiskOptions): Promise<{
+    ok: boolean;
+    reverted: number;
+    reason?: string;
+}>;
+export interface DestroySddProjectOptions {
+    projectRoot: string;
+    /** Resolved wstack paths to delete. */
+    paths: {
+        projectSpecs: string;
+        projectTaskGraphs: string;
+        projectSddSession: string;
+        projectSddBoards: string;
+    };
+    /**
+     * Also revert this run's already-merged squash commits (history-preserving
+     * `git revert`) BEFORE deleting the board that records them. Off by default —
+     * a plain destroy wipes worktrees + artifacts but leaves merged commits on the
+     * base branch (un-merged worktree work is destroyed regardless, since its
+     * branch is force-removed). When on and the working tree is dirty, the revert
+     * is refused and surfaced in `revertReason` (the destroy still proceeds).
+     */
+    revertMerged?: boolean | undefined;
+    /** Which run's merged commits to revert. Omit → the most recently updated board. */
+    runId?: string | undefined;
+}
+export interface DestroySddProjectResult {
+    worktreesRemoved: number;
+    /** Human labels of the artifacts that were deleted. */
+    deleted: string[];
+    /** Number of merged commits reverted (only when `revertMerged` was set). */
+    reverted: number;
+    /** Whether the optional merged-commit revert succeeded (undefined → not requested). */
+    revertOk?: boolean | undefined;
+    /** Why the revert did not fully apply (dirty tree, conflict, nothing to revert). */
+    revertReason?: string | undefined;
+}
+/**
+ * Destroy an SDD project: optionally revert its merged commits, then clean every
+ * worktree + branch, then delete the on-disk artifacts (specs, task-graphs,
+ * session, boards). The revert is opt-in (`revertMerged`) and runs FIRST — it
+ * reads the board snapshot that the artifact deletion removes. Best-effort: a
+ * missing path is simply skipped. The caller is responsible for stopping any
+ * active run first.
+ */
+export declare function destroySddProject(opts: DestroySddProjectOptions): Promise<DestroySddProjectResult>;
+/** Lifecycle operation kinds shared by every surface (WebUI / TUI / CLI). */
+export type SddLifecycleOp = 'cleanup_worktrees' | 'rollback' | 'destroy';
+export interface SddLifecycleOptions {
+    projectRoot: string;
+    /** Resolved wstack paths (required for `destroy`; boards dir is enough for `rollback`). */
+    paths: {
+        projectSpecs: string;
+        projectTaskGraphs: string;
+        projectSddSession: string;
+        projectSddBoards: string;
+    };
+    /** Target a specific run (rollback / destroy). Omit → most recently updated board. */
+    runId?: string | undefined;
+    /** `destroy` only: also revert merged commits before wiping. */
+    revertMerged?: boolean | undefined;
+}
+/** Uniform result for any lifecycle op — drives identical UI wording everywhere. */
+export interface SddLifecycleResult {
+    op: SddLifecycleOp;
+    ok: boolean;
+    /** Worktrees removed (cleanup_worktrees / destroy). */
+    removed?: number | undefined;
+    /** Merged commits reverted (rollback / destroy with revertMerged). */
+    reverted?: number | undefined;
+    /** Artifact labels deleted (destroy). */
+    deleted?: string[] | undefined;
+    /** Failure / partial reason, surfaced verbatim in the UI. */
+    reason?: string | undefined;
+}
+/**
+ * Apply a post-run SDD lifecycle operation from disk and return a uniform result.
+ * The single entry point shared by the WebUI board handler, the TUI overlay, and
+ * the CLI `/sdd` host so every surface reports the same thing. The caller must
+ * ensure no run is active (these operate on git + on-disk state, not the live
+ * run) — `cleanup`/`destroy` force-remove worktrees, `rollback` refuses on a
+ * dirty tree. Never throws.
+ */
+export declare function applySddLifecycle(op: SddLifecycleOp, opts: SddLifecycleOptions): Promise<SddLifecycleResult>;
+//# sourceMappingURL=sdd-lifecycle.d.ts.map

package/dist/sdd-lifecycle.d.ts.map

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