@substrate-ai/sdlc 0.19.54

package/dist/run-model/run-manifest.js

@@ -0,0 +1,481 @@
+/**
+ * RunManifest — atomic file-backed run state — Story 52-1.
+ *
+ * Provides typed read/write operations with atomic file replacement
+ * so run state survives process crashes without corruption.
+ *
+ * File layout (relative to baseDir):
+ *   {run-id}.json      — primary manifest
+ *   {run-id}.json.bak  — backup written before rename
+ *   {run-id}.json.tmp  — temporary write target (fsync'd before rename)
+ */
+import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { RunManifestSchema, ManifestReadError } from './schemas.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Default base directory for run manifests. */
+function defaultBaseDir() {
+    return join(process.cwd(), '.substrate', 'runs');
+}
+/** Build the primary manifest path for a given run ID. */
+function primaryPath(baseDir, runId) {
+    return join(baseDir, `${runId}.json`);
+}
+/** Build the backup path. */
+function bakPath(baseDir, runId) {
+    return join(baseDir, `${runId}.json.bak`);
+}
+/** Build the temporary write path. */
+function tmpPath(baseDir, runId) {
+    return join(baseDir, `${runId}.json.tmp`);
+}
+/**
+ * Attempt to read and parse a manifest file.
+ * Returns the parsed data, or null if the file is missing or fails Zod validation.
+ */
+async function tryReadFile(filePath) {
+    try {
+        const raw = await fs.readFile(filePath, 'utf-8');
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+        const result = RunManifestSchema.safeParse(parsed);
+        if (!result.success) {
+            return null;
+        }
+        return result.data;
+    }
+    catch {
+        // File missing or unreadable
+        return null;
+    }
+}
+/**
+ * Build a minimal RunManifestData from Dolt pipeline_runs table.
+ * Used in degraded-mode when all file sources fail.
+ */
+async function reconstructFromDolt(runId, adapter) {
+    try {
+        const rows = await adapter.query('SELECT id, config_json, created_at, updated_at FROM pipeline_runs WHERE id = ?', [runId]);
+        if (rows.length === 0) {
+            return null;
+        }
+        const row = rows[0];
+        let cliFlags = {};
+        if (row.config_json) {
+            try {
+                const parsed = JSON.parse(row.config_json);
+                if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                    cliFlags = parsed;
+                }
+            }
+            catch {
+                // ignore parse failure
+            }
+        }
+        const now = new Date().toISOString();
+        const data = {
+            run_id: runId,
+            cli_flags: cliFlags,
+            story_scope: [],
+            supervisor_pid: null,
+            supervisor_session_id: null,
+            per_story_state: {},
+            recovery_history: [],
+            cost_accumulation: { per_story: {}, run_total: 0 },
+            pending_proposals: [],
+            generation: 0,
+            created_at: row.created_at ?? now,
+            updated_at: row.updated_at ?? now,
+        };
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// RunManifest class
+// ---------------------------------------------------------------------------
+/**
+ * Typed, atomic file-backed run manifest.
+ *
+ * Each instance is bound to a specific run ID and base directory.
+ * Use `RunManifest.create()` to initialize a new manifest,
+ * or `RunManifest.read()` to load an existing one.
+ */
+export class RunManifest {
+    runId;
+    baseDir;
+    /** Optional Dolt adapter for degraded-mode fallback on read. */
+    doltAdapter;
+    constructor(runId, baseDir = defaultBaseDir(), doltAdapter = null) {
+        this.runId = runId;
+        this.baseDir = baseDir;
+        this.doltAdapter = doltAdapter;
+    }
+    // -------------------------------------------------------------------------
+    // Path helpers (instance methods for convenience)
+    // -------------------------------------------------------------------------
+    get primaryPath() {
+        return primaryPath(this.baseDir, this.runId);
+    }
+    get bakPath() {
+        return bakPath(this.baseDir, this.runId);
+    }
+    get tmpPath() {
+        return tmpPath(this.baseDir, this.runId);
+    }
+    // -------------------------------------------------------------------------
+    // read() — instance convenience wrapper
+    // -------------------------------------------------------------------------
+    /**
+     * Read this manifest from disk (multi-tier fallback).
+     *
+     * Delegates to `RunManifest.read()` with this instance's runId, baseDir,
+     * and doltAdapter. Primarily used by `SupervisorLock` (and tests that mock it).
+     *
+     * @throws ManifestReadError if all sources fail
+     */
+    async read() {
+        return RunManifest.read(this.runId, this.baseDir, this.doltAdapter);
+    }
+    // -------------------------------------------------------------------------
+    // update() — partial atomic update
+    // -------------------------------------------------------------------------
+    /**
+     * Atomically update specific fields in the manifest.
+     *
+     * Reads the current manifest, merges in the provided partial data (shallow
+     * merge), then writes the result atomically. Generation is incremented and
+     * `updated_at` is refreshed by `write()`.
+     *
+     * Callers should pass only the fields they intend to change. Do NOT use this
+     * to change `run_id` or `created_at` — those are immutable after creation.
+     *
+     * @throws ManifestReadError if the current manifest cannot be read
+     */
+    async update(partial) {
+        const current = await this.read();
+        const merged = {
+            ...current,
+            ...partial,
+        };
+        await this.write(merged);
+    }
+    // -------------------------------------------------------------------------
+    // write()
+    // -------------------------------------------------------------------------
+    /**
+     * Atomically write the manifest to disk.
+     *
+     * Sequence:
+     *   1. Auto-increment `generation`, set `updated_at`
+     *   2. Serialize to JSON and validate round-trip
+     *   3. Ensure baseDir exists (mkdir -p)
+     *   4. Write to `.tmp` via open → write → datasync → close (fsync)
+     *   5. If primary exists, copy to `.bak`
+     *   6. Rename `.tmp` → primary path
+     */
+    async write(data) {
+        // Read current generation from disk to increment correctly
+        let currentGeneration = 0;
+        const existing = await tryReadFile(this.primaryPath);
+        if (existing !== null) {
+            currentGeneration = existing.generation;
+        }
+        const fullData = {
+            ...data,
+            generation: currentGeneration + 1,
+            updated_at: new Date().toISOString(),
+        };
+        // Serialize and validate round-trip
+        const json = JSON.stringify(fullData, null, 2);
+        // Validate parse round-trip — if this throws, do not proceed
+        JSON.parse(json);
+        // Ensure base directory exists
+        await fs.mkdir(this.baseDir, { recursive: true });
+        // Write to .tmp using open → write → datasync → close (NOT writeFile — no fsync)
+        const tmp = this.tmpPath;
+        const fileHandle = await fs.open(tmp, 'w');
+        try {
+            await fileHandle.write(json, 0, 'utf-8');
+            await fileHandle.datasync();
+        }
+        finally {
+            await fileHandle.close();
+        }
+        // Backup current primary to .bak (if primary exists)
+        try {
+            await fs.copyFile(this.primaryPath, this.bakPath);
+        }
+        catch {
+            // Primary does not exist yet — no backup needed
+        }
+        // Atomic rename: .tmp → primary
+        await fs.rename(tmp, this.primaryPath);
+    }
+    // -------------------------------------------------------------------------
+    // Static factory: open()
+    // -------------------------------------------------------------------------
+    /**
+     * Return a bound `RunManifest` instance without performing any file I/O.
+     *
+     * Use `open()` when you want to call instance methods (`read()`, `patchCLIFlags()`)
+     * on an existing run without reading the manifest upfront.
+     *
+     * ```typescript
+     * await RunManifest.open(runId, runsDir).patchCLIFlags(cliFlags)
+     * ```
+     */
+    static open(runId, baseDir = defaultBaseDir(), doltAdapter = null) {
+        return new RunManifest(runId, baseDir, doltAdapter);
+    }
+    // -------------------------------------------------------------------------
+    // Instance: patchCLIFlags()
+    // -------------------------------------------------------------------------
+    /**
+     * Read the current manifest (or create a minimal default), merge the provided
+     * CLI flags into `cli_flags`, and write the result atomically.
+     *
+     * Non-fatal: callers should wrap in try/catch and log a warning on failure.
+     * The pipeline must not abort if manifest write fails.
+     */
+    async patchCLIFlags(flags) {
+        let existingData;
+        try {
+            const read = await RunManifest.read(this.runId, this.baseDir, this.doltAdapter);
+            // Strip generation and updated_at — write() re-computes them
+            const { generation: _gen, updated_at: _ts, ...rest } = read;
+            existingData = rest;
+        }
+        catch {
+            // No existing manifest — bootstrap a minimal default
+            const now = new Date().toISOString();
+            existingData = {
+                run_id: this.runId,
+                cli_flags: {},
+                story_scope: [],
+                supervisor_pid: null,
+                supervisor_session_id: null,
+                per_story_state: {},
+                recovery_history: [],
+                cost_accumulation: { per_story: {}, run_total: 0 },
+                pending_proposals: [],
+                created_at: now,
+            };
+        }
+        await this.write({
+            ...existingData,
+            cli_flags: { ...existingData.cli_flags, ...flags },
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Instance: patchStoryState() — atomic upsert for per-story lifecycle state
+    // -------------------------------------------------------------------------
+    /**
+     * Atomically upsert the per-story lifecycle state for a single story key.
+     *
+     * Reads the current manifest (or creates a minimal default if absent),
+     * shallowly merges `updates` into `per_story_state[storyKey]`, and writes
+     * the result atomically via a single `write()` call.
+     *
+     * Fields not included in `updates` on an existing entry are preserved unchanged.
+     *
+     * Non-fatal: callers MUST wrap in `.catch((err) => logger.warn(...))`.
+     * The pipeline must never abort due to a manifest write failure.
+     *
+     * @param storyKey - Story key (e.g. '52-4')
+     * @param updates  - Partial PerStoryState fields to merge
+     */
+    async patchStoryState(storyKey, updates) {
+        let existingData;
+        try {
+            const read = await RunManifest.read(this.runId, this.baseDir, this.doltAdapter);
+            // Strip generation and updated_at — write() re-computes them
+            const { generation: _gen, updated_at: _ts, ...rest } = read;
+            existingData = rest;
+        }
+        catch {
+            // No existing manifest — bootstrap a minimal default so we can write the entry
+            const now = new Date().toISOString();
+            existingData = {
+                run_id: this.runId,
+                cli_flags: {},
+                story_scope: [],
+                supervisor_pid: null,
+                supervisor_session_id: null,
+                per_story_state: {},
+                recovery_history: [],
+                cost_accumulation: { per_story: {}, run_total: 0 },
+                pending_proposals: [],
+                created_at: now,
+            };
+        }
+        // Shallow-merge updates into the existing entry (or create if absent).
+        // When no existing entry is present, provide sensible defaults for the three
+        // required fields (status, phase, started_at) so the merged result passes
+        // PerStoryStateSchema validation on read. In normal pipeline operation the
+        // orchestrator always creates the entry via the 'dispatched' transition before
+        // calling persistVerificationResult or any other partial-patch helper, so
+        // `existing` is defined in the vast majority of cases. This guard handles
+        // callers that patch verification_result or cost_usd in isolation (e.g. tests).
+        const existing = existingData.per_story_state[storyKey];
+        const merged = {
+            status: 'pending',
+            phase: '',
+            started_at: new Date().toISOString(),
+            ...existing,
+            ...updates,
+        };
+        await this.write({
+            ...existingData,
+            per_story_state: {
+                ...existingData.per_story_state,
+                [storyKey]: merged,
+            },
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Instance: appendRecoveryEntry() — atomic append and cost update
+    // -------------------------------------------------------------------------
+    /**
+     * Atomically append a recovery entry and update cost accumulation.
+     *
+     * Reads the current manifest, appends `entry` to `recovery_history[]`,
+     * increments `cost_accumulation.per_story[entry.story_key]` by `entry.cost_usd`,
+     * increments `cost_accumulation.run_total` by `entry.cost_usd`, then writes
+     * atomically via a single `write()` call.
+     *
+     * Non-fatal: callers MUST wrap in `.catch((err) => logger.warn(...))`.
+     * The pipeline must never abort due to a manifest write failure.
+     *
+     * `entry.cost_usd` is the cost of this single retry attempt only (NOT cumulative).
+     * Cumulative per-story retry cost is tracked in `cost_accumulation.per_story`.
+     *
+     * @param entry - Recovery entry to append (attempt_number is 1-indexed)
+     */
+    async appendRecoveryEntry(entry) {
+        let existingData;
+        try {
+            const read = await RunManifest.read(this.runId, this.baseDir, this.doltAdapter);
+            const { generation: _gen, updated_at: _ts, ...rest } = read;
+            existingData = rest;
+        }
+        catch {
+            // No existing manifest — bootstrap a minimal default so we can write the entry
+            const now = new Date().toISOString();
+            existingData = {
+                run_id: this.runId,
+                cli_flags: {},
+                story_scope: [],
+                supervisor_pid: null,
+                supervisor_session_id: null,
+                per_story_state: {},
+                recovery_history: [],
+                cost_accumulation: { per_story: {}, run_total: 0 },
+                pending_proposals: [],
+                created_at: now,
+            };
+        }
+        const prevStoryCost = existingData.cost_accumulation.per_story[entry.story_key] ?? 0;
+        const updated = {
+            ...existingData,
+            recovery_history: [...existingData.recovery_history, entry],
+            cost_accumulation: {
+                per_story: {
+                    ...existingData.cost_accumulation.per_story,
+                    [entry.story_key]: prevStoryCost + entry.cost_usd,
+                },
+                run_total: existingData.cost_accumulation.run_total + entry.cost_usd,
+            },
+        };
+        await this.write(updated);
+    }
+    // -------------------------------------------------------------------------
+    // Static factory: create()
+    // -------------------------------------------------------------------------
+    /**
+     * Create a new manifest with `generation: 0` and write it.
+     * Returns a bound `RunManifest` instance.
+     */
+    static async create(runId, initialData, baseDir = defaultBaseDir(), doltAdapter = null) {
+        const instance = new RunManifest(runId, baseDir, doltAdapter);
+        const now = new Date().toISOString();
+        const data = {
+            ...initialData,
+            created_at: now,
+        };
+        await instance.write(data);
+        return instance;
+    }
+    // -------------------------------------------------------------------------
+    // Static: read()
+    // -------------------------------------------------------------------------
+    /**
+     * Read a manifest from disk with multi-tier fallback.
+     *
+     * Attempts sources in order:
+     *   1. Primary `.json`
+     *   2. Backup `.json.bak`  (preferred over primary if generation is higher)
+     *   3. Temporary `.json.tmp`
+     *   4. Dolt degraded reconstruction (if doltAdapter is provided)
+     *
+     * Generation tiebreak: if `.bak` has a higher `generation` than primary,
+     * `.bak` is preferred (indicates primary was overwritten mid-rename).
+     *
+     * @throws ManifestReadError if all sources fail
+     */
+    static async read(runId, baseDir = defaultBaseDir(), doltAdapter = null) {
+        const attempted = [];
+        const primary = primaryPath(baseDir, runId);
+        const bak = bakPath(baseDir, runId);
+        const tmp = tmpPath(baseDir, runId);
+        // Attempt primary and bak, then apply generation tiebreak
+        attempted.push(primary);
+        const primaryData = await tryReadFile(primary);
+        attempted.push(bak);
+        const bakData = await tryReadFile(bak);
+        // Generation tiebreak: prefer bak if it has a higher generation (newer write)
+        if (primaryData !== null && bakData !== null) {
+            if (bakData.generation > primaryData.generation) {
+                // .bak is newer — use it
+                return bakData;
+            }
+            // primary is fine
+            return primaryData;
+        }
+        if (primaryData !== null) {
+            return primaryData;
+        }
+        if (bakData !== null) {
+            return bakData;
+        }
+        // Try .tmp
+        attempted.push(tmp);
+        const tmpData = await tryReadFile(tmp);
+        if (tmpData !== null) {
+            return tmpData;
+        }
+        // Dolt degraded reconstruction
+        if (doltAdapter !== null) {
+            const doltSource = 'dolt:pipeline_runs';
+            attempted.push(doltSource);
+            const doltData = await reconstructFromDolt(runId, doltAdapter);
+            if (doltData !== null) {
+                // Log degraded mode warning
+                console.warn(`[RunManifest] Degraded mode: reconstructed run ${runId} from Dolt pipeline_runs. ` +
+                    `per_story_state and recovery_history are empty.`);
+                return doltData;
+            }
+        }
+        throw new ManifestReadError(`Failed to read manifest for run ${runId}: all sources exhausted`, attempted);
+    }
+}
+//# sourceMappingURL=run-manifest.js.map

package/dist/run-model/run-manifest.js.map

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

package/dist/run-model/schemas.d.ts

@@ -0,0 +1,117 @@
+/**
+ * RunManifest Zod schemas — Story 52-1 / Story 52-8.
+ *
+ * Provides runtime validation for the run manifest file.
+ * All schemas mirror the TypeScript interfaces in `types.ts`.
+ */
+import { z } from 'zod';
+export { RecoveryEntrySchema, CostAccumulationSchema } from './recovery-history.js';
+/**
+ * Schema for a pending supervisor proposal.
+ * Uses z.union for extensible type field (follows v0.19.6 ReadinessFindingCategory pattern).
+ */
+export declare const ProposalSchema: z.ZodObject<{
+    id: z.ZodString;
+    created_at: z.ZodString;
+    description: z.ZodString;
+    type: z.ZodUnion<readonly [z.ZodLiteral<"retry">, z.ZodLiteral<"fix">, z.ZodLiteral<"escalate">, z.ZodLiteral<"skip">, z.ZodString]>;
+    story_key: z.ZodOptional<z.ZodString>;
+    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Zod schema for the full run manifest data.
+ * Validated on every read; write validates via JSON round-trip.
+ *
+ * `cost_accumulation` uses `.default({ per_story: {}, run_total: 0 })` so
+ * pre-Phase-D manifests that omit this field parse without error (AC7).
+ */
+export declare const RunManifestSchema: z.ZodObject<{
+    run_id: z.ZodString;
+    cli_flags: z.ZodPipe<z.ZodObject<{
+        stories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        halt_on: z.ZodOptional<z.ZodEnum<{
+            all: "all";
+            critical: "critical";
+            none: "none";
+        }>>;
+        cost_ceiling: z.ZodOptional<z.ZodNumber>;
+        agent: z.ZodOptional<z.ZodString>;
+        skip_verification: z.ZodOptional<z.ZodBoolean>;
+        events: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodTransform<Record<string, unknown>, {
+        stories?: string[] | undefined;
+        halt_on?: "all" | "critical" | "none" | undefined;
+        cost_ceiling?: number | undefined;
+        agent?: string | undefined;
+        skip_verification?: boolean | undefined;
+        events?: boolean | undefined;
+    }>>;
+    story_scope: z.ZodArray<z.ZodString>;
+    supervisor_pid: z.ZodNullable<z.ZodNumber>;
+    supervisor_session_id: z.ZodNullable<z.ZodString>;
+    per_story_state: z.ZodRecord<z.ZodString, z.ZodObject<{
+        status: z.ZodUnion<readonly [z.ZodLiteral<"pending">, z.ZodLiteral<"dispatched">, z.ZodLiteral<"in-review">, z.ZodLiteral<"complete">, z.ZodLiteral<"failed">, z.ZodLiteral<"escalated">, z.ZodLiteral<"recovered">, z.ZodLiteral<"verification-failed">, z.ZodLiteral<"gated">, z.ZodLiteral<"skipped">, z.ZodString]>;
+        phase: z.ZodString;
+        started_at: z.ZodString;
+        completed_at: z.ZodOptional<z.ZodString>;
+        verification_result: z.ZodOptional<z.ZodObject<{
+            storyKey: z.ZodString;
+            checks: z.ZodArray<z.ZodObject<{
+                checkName: z.ZodString;
+                status: z.ZodEnum<{
+                    pass: "pass";
+                    warn: "warn";
+                    fail: "fail";
+                }>;
+                details: z.ZodString;
+                duration_ms: z.ZodNumber;
+            }, z.core.$strip>>;
+            status: z.ZodEnum<{
+                pass: "pass";
+                warn: "warn";
+                fail: "fail";
+            }>;
+            duration_ms: z.ZodNumber;
+        }, z.core.$strip>>;
+        cost_usd: z.ZodOptional<z.ZodNumber>;
+        review_cycles: z.ZodOptional<z.ZodNumber>;
+        dispatches: z.ZodOptional<z.ZodNumber>;
+        retry_count: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    recovery_history: z.ZodArray<z.ZodObject<{
+        story_key: z.ZodString;
+        attempt_number: z.ZodNumber;
+        strategy: z.ZodString;
+        root_cause: z.ZodString;
+        outcome: z.ZodUnion<readonly [z.ZodLiteral<"retried">, z.ZodLiteral<"escalated">, z.ZodLiteral<"skipped">, z.ZodString]>;
+        cost_usd: z.ZodNumber;
+        timestamp: z.ZodString;
+    }, z.core.$strip>>;
+    cost_accumulation: z.ZodDefault<z.ZodObject<{
+        per_story: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        run_total: z.ZodNumber;
+    }, z.core.$strip>>;
+    pending_proposals: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        created_at: z.ZodString;
+        description: z.ZodString;
+        type: z.ZodUnion<readonly [z.ZodLiteral<"retry">, z.ZodLiteral<"fix">, z.ZodLiteral<"escalate">, z.ZodLiteral<"skip">, z.ZodString]>;
+        story_key: z.ZodOptional<z.ZodString>;
+        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    generation: z.ZodNumber;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Error thrown when all read sources for a manifest fail.
+ *
+ * Includes `attempted_sources` listing each path/source tried,
+ * so callers can diagnose which files were corrupt or missing.
+ */
+export declare class ManifestReadError extends Error {
+    /** List of sources (file paths or source names) that were attempted. */
+    readonly attempted_sources: string[];
+    constructor(message: string, attempted_sources: string[]);
+}
+//# sourceMappingURL=schemas.d.ts.map

package/dist/run-model/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/run-model/schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAMnF;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;iBAazB,CAAA;AAMF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoB5B,CAAA;AAMF;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,wEAAwE;IACxE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;gBAExB,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE;CAKzD"}