stageflow 0.25.0 → 0.30.0

package/dist/runstore/sqlite/applyStorePragmas.d.ts

@@ -0,0 +1,39 @@
+import type Database from "better-sqlite3";
+/** Residual WAL size that triggers a crash-path checkpoint attempt at Host boot. */
+export declare const CRASH_WAL_CHECKPOINT_THRESHOLD_BYTES: number;
+export declare function readSqliteBusyTimeoutMs(env?: NodeJS.ProcessEnv): number;
+export declare function readSqliteSynchronous(env?: NodeJS.ProcessEnv): string;
+export declare function readWalAutocheckpointPages(env?: NodeJS.ProcessEnv): number;
+/**
+ * Apply durability and coordination pragmas on every store open (Host and workers).
+ * Does not run quick_check or crash-path WAL handling — those are Host-boot only.
+ */
+export declare function applyStorePragmas(db: Database.Database, env?: NodeJS.ProcessEnv): void;
+export declare function assertStoreQuickCheck(db: Database.Database): void;
+export type StoreIntegrityCheckOutcome = {
+    ok: true;
+} | {
+    ok: false;
+    detail: string;
+};
+export declare function runStoreIntegrityCheck(db: {
+    pragma: (source: string, options?: {
+        simple?: boolean;
+    }) => unknown;
+}): StoreIntegrityCheckOutcome;
+export declare function isSqliteCorruptError(err: unknown): boolean;
+export declare function rethrowAsStoreIntegrityFailed(err: unknown): never;
+export type CrashWalCheckpointResult = {
+    attempted: boolean;
+    walBytes: number;
+    busy: boolean;
+    completed: boolean;
+};
+/**
+ * Crash-path residual WAL: if the sidecar exceeds the threshold, attempt
+ * wal_checkpoint(TRUNCATE). Slot 4 owns clean-close checkpoint in close().
+ */
+export declare function maybeCheckpointResidualWal(storeRoot: string, db: Database.Database, options?: {
+    thresholdBytes?: number;
+    log?: (message: string, fields?: Record<string, unknown>) => void;
+}): CrashWalCheckpointResult;

package/dist/runstore/sqlite/applyStorePragmas.js

@@ -0,0 +1,145 @@
+import { existsSync, statSync } from "node:fs";
+import path from "node:path";
+import { StoreOpenError } from "./storeOpenError.js";
+const DEFAULT_SQLITE_BUSY_TIMEOUT_MS = 5000;
+const DEFAULT_WAL_AUTOCHECKPOINT_PAGES = 1000;
+/** Residual WAL size that triggers a crash-path checkpoint attempt at Host boot. */
+export const CRASH_WAL_CHECKPOINT_THRESHOLD_BYTES = 64 * 1024 * 1024;
+const ALLOWED_SYNCHRONOUS = new Set(["OFF", "NORMAL", "FULL", "EXTRA"]);
+export function readSqliteBusyTimeoutMs(env = process.env) {
+    const raw = env.STAGEFLOW_SQLITE_BUSY_TIMEOUT_MS;
+    if (raw === undefined || raw.trim() === "") {
+        return DEFAULT_SQLITE_BUSY_TIMEOUT_MS;
+    }
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return DEFAULT_SQLITE_BUSY_TIMEOUT_MS;
+    }
+    return parsed;
+}
+export function readSqliteSynchronous(env = process.env) {
+    const raw = env.STAGEFLOW_SQLITE_SYNCHRONOUS?.trim().toUpperCase();
+    if (raw === undefined || raw === "")
+        return "FULL";
+    if (!ALLOWED_SYNCHRONOUS.has(raw))
+        return "FULL";
+    return raw;
+}
+export function readWalAutocheckpointPages(env = process.env) {
+    const raw = env.STAGEFLOW_SQLITE_WAL_AUTOCHECKPOINT;
+    if (raw === undefined || raw.trim() === "") {
+        return DEFAULT_WAL_AUTOCHECKPOINT_PAGES;
+    }
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return DEFAULT_WAL_AUTOCHECKPOINT_PAGES;
+    }
+    return parsed;
+}
+/**
+ * Apply durability and coordination pragmas on every store open (Host and workers).
+ * Does not run quick_check or crash-path WAL handling — those are Host-boot only.
+ */
+export function applyStorePragmas(db, env = process.env) {
+    db.pragma("journal_mode = WAL");
+    db.pragma(`busy_timeout = ${readSqliteBusyTimeoutMs(env)}`);
+    db.pragma("foreign_keys = ON");
+    db.pragma(`synchronous = ${readSqliteSynchronous(env)}`);
+    db.pragma(`wal_autocheckpoint = ${readWalAutocheckpointPages(env)}`);
+}
+export function assertStoreQuickCheck(db) {
+    let result;
+    try {
+        result = db.pragma("quick_check", { simple: true });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new StoreOpenError(`store_integrity_failed: ${message}. Refuse to serve; restore with sf restore.`, "store_integrity_failed", { cause: message });
+    }
+    if (result !== "ok") {
+        throw new StoreOpenError(`store_integrity_failed: quick_check returned ${String(result)}. Refuse to serve; restore with sf restore.`, "store_integrity_failed", { quick_check: result });
+    }
+}
+export function runStoreIntegrityCheck(db) {
+    let result;
+    try {
+        result = db.pragma("integrity_check", { simple: true });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, detail: message };
+    }
+    if (result === "ok") {
+        return { ok: true };
+    }
+    return { ok: false, detail: String(result) };
+}
+export function isSqliteCorruptError(err) {
+    if (err instanceof StoreOpenError && err.code === "store_integrity_failed") {
+        return true;
+    }
+    const code = err?.code;
+    if (code === "SQLITE_CORRUPT" || code === "SQLITE_NOTADB")
+        return true;
+    const message = err instanceof Error ? err.message : String(err);
+    return /malformed|corrupt|file is not a database/i.test(message);
+}
+export function rethrowAsStoreIntegrityFailed(err) {
+    if (err instanceof StoreOpenError)
+        throw err;
+    const message = err instanceof Error ? err.message : String(err);
+    throw new StoreOpenError(`store_integrity_failed: ${message}. Refuse to serve; restore with sf restore.`, "store_integrity_failed", { cause: message });
+}
+/**
+ * Crash-path residual WAL: if the sidecar exceeds the threshold, attempt
+ * wal_checkpoint(TRUNCATE). Slot 4 owns clean-close checkpoint in close().
+ */
+export function maybeCheckpointResidualWal(storeRoot, db, options) {
+    const threshold = options?.thresholdBytes ?? CRASH_WAL_CHECKPOINT_THRESHOLD_BYTES;
+    const walPath = path.join(storeRoot, "state.db-wal");
+    if (!existsSync(walPath)) {
+        return { attempted: false, walBytes: 0, busy: false, completed: false };
+    }
+    let walBytes = 0;
+    try {
+        walBytes = statSync(walPath).size;
+    }
+    catch {
+        return { attempted: false, walBytes: 0, busy: false, completed: false };
+    }
+    if (walBytes <= threshold) {
+        return { attempted: false, walBytes, busy: false, completed: false };
+    }
+    const log = options?.log;
+    log?.("store.crash_wal.checkpoint_start", {
+        wal_bytes: walBytes,
+        threshold_bytes: threshold,
+    });
+    try {
+        const rows = db.pragma("wal_checkpoint(TRUNCATE)");
+        const row = rows[0];
+        const busy = (row?.busy ?? 0) !== 0;
+        if (busy) {
+            log?.("store.crash_wal.checkpoint_busy", {
+                wal_bytes: walBytes,
+                note: "concurrent holder; checkpoint incomplete",
+            });
+            return { attempted: true, walBytes, busy: true, completed: false };
+        }
+        log?.("store.crash_wal.checkpoint_done", {
+            wal_bytes: walBytes,
+            checkpointed: row?.checkpointed,
+        });
+        return { attempted: true, walBytes, busy: false, completed: true };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const busy = /SQLITE_BUSY|database is locked/i.test(message);
+        log?.("store.crash_wal.checkpoint_failed", {
+            wal_bytes: walBytes,
+            busy,
+            error: message,
+        });
+        return { attempted: true, walBytes, busy, completed: false };
+    }
+}

package/dist/runstore/sqlite/migrations/001-baseline.d.ts

@@ -0,0 +1,7 @@
+import type Database from "better-sqlite3";
+export declare const MIGRATION_001: {
+    version: number;
+    name: string;
+    minStageflowVersion: string;
+    up(db: Database.Database): void;
+};

package/dist/runstore/sqlite/migrations/001-baseline.js

@@ -0,0 +1,10 @@
+import { PACKAGE_VERSION } from "../../../package-meta.js";
+import { applyBaselineSchema } from "../schema.js";
+export const MIGRATION_001 = {
+    version: 1,
+    name: "001_baseline",
+    minStageflowVersion: PACKAGE_VERSION,
+    up(db) {
+        applyBaselineSchema(db);
+    },
+};

package/dist/runstore/sqlite/migrations/002-repository-binding.d.ts

@@ -0,0 +1,7 @@
+import type Database from "better-sqlite3";
+export declare const MIGRATION_002: {
+    version: number;
+    name: string;
+    minStageflowVersion: string;
+    up(db: Database.Database): void;
+};

package/dist/runstore/sqlite/migrations/002-repository-binding.js

@@ -0,0 +1,29 @@
+import { PACKAGE_VERSION } from "../../../package-meta.js";
+const BINDING_COLUMNS = [
+    "repository",
+    "ref",
+    "resolved_sha",
+    "run_branch",
+    "git_author_name",
+    "git_author_email",
+];
+function addColumn(db, name) {
+    try {
+        db.exec(`ALTER TABLE runs ADD COLUMN ${name} TEXT`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (!/duplicate column name/i.test(message))
+            throw err;
+    }
+}
+export const MIGRATION_002 = {
+    version: 2,
+    name: "002_repository_binding",
+    minStageflowVersion: PACKAGE_VERSION,
+    up(db) {
+        for (const name of BINDING_COLUMNS) {
+            addColumn(db, name);
+        }
+    },
+};

package/dist/runstore/sqlite/migrations/003-run-lifecycle.d.ts

@@ -0,0 +1,7 @@
+import type Database from "better-sqlite3";
+export declare const MIGRATION_003: {
+    version: number;
+    name: string;
+    minStageflowVersion: string;
+    up(db: Database.Database): void;
+};

package/dist/runstore/sqlite/migrations/003-run-lifecycle.js

@@ -0,0 +1,28 @@
+import { PACKAGE_VERSION } from "../../../package-meta.js";
+const LIFECYCLE_COLUMNS = [
+    { name: "cancel_reason", type: "TEXT" },
+    { name: "finished_at", type: "TEXT" },
+    { name: "slimmed_at", type: "TEXT" },
+    { name: "disk_bytes", type: "INTEGER" },
+    { name: "disk_measured_at", type: "TEXT" },
+];
+function addColumn(db, name, type) {
+    try {
+        db.exec(`ALTER TABLE runs ADD COLUMN ${name} ${type}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (!/duplicate column name/i.test(message))
+            throw err;
+    }
+}
+export const MIGRATION_003 = {
+    version: 3,
+    name: "003_run_lifecycle",
+    minStageflowVersion: PACKAGE_VERSION,
+    up(db) {
+        for (const col of LIFECYCLE_COLUMNS) {
+            addColumn(db, col.name, col.type);
+        }
+    },
+};

package/dist/runstore/sqlite/migrations/004-auto-resume-count.d.ts

@@ -0,0 +1,7 @@
+import type Database from "better-sqlite3";
+export declare const MIGRATION_004: {
+    version: number;
+    name: string;
+    minStageflowVersion: string;
+    up(db: Database.Database): void;
+};

package/dist/runstore/sqlite/migrations/004-auto-resume-count.js

@@ -0,0 +1,19 @@
+import { PACKAGE_VERSION } from "../../../package-meta.js";
+function addAutoResumeCountColumn(db) {
+    try {
+        db.exec(`ALTER TABLE stage_executions ADD COLUMN auto_resume_count INTEGER NOT NULL DEFAULT 0`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (!/duplicate column name/i.test(message))
+            throw err;
+    }
+}
+export const MIGRATION_004 = {
+    version: 4,
+    name: "004_auto_resume_count",
+    minStageflowVersion: PACKAGE_VERSION,
+    up(db) {
+        addAutoResumeCountColumn(db);
+    },
+};

package/dist/runstore/sqlite/migrations/005-config-origins.d.ts

@@ -0,0 +1,7 @@
+import type Database from "better-sqlite3";
+export declare const MIGRATION_005: {
+    version: number;
+    name: string;
+    minStageflowVersion: string;
+    up(db: Database.Database): void;
+};

package/dist/runstore/sqlite/migrations/005-config-origins.js

@@ -0,0 +1,19 @@
+import { PACKAGE_VERSION } from "../../../package-meta.js";
+function addColumn(db) {
+    try {
+        db.exec(`ALTER TABLE runs ADD COLUMN config_origins_json TEXT`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (!/duplicate column name/i.test(message))
+            throw err;
+    }
+}
+export const MIGRATION_005 = {
+    version: 5,
+    name: "005_config_origins",
+    minStageflowVersion: PACKAGE_VERSION,
+    up(db) {
+        addColumn(db);
+    },
+};

package/dist/runstore/sqlite/migrations/006-pipeline-body-and-caller.d.ts

@@ -0,0 +1,7 @@
+import type Database from "better-sqlite3";
+export declare const MIGRATION_006: {
+    version: number;
+    name: string;
+    minStageflowVersion: string;
+    up(db: Database.Database): void;
+};

package/dist/runstore/sqlite/migrations/006-pipeline-body-and-caller.js

@@ -0,0 +1,28 @@
+import { PACKAGE_VERSION } from "../../../package-meta.js";
+const RUN_COLUMNS = [
+    { name: "pipeline_source", type: "TEXT" },
+    { name: "pipeline_body", type: "TEXT" },
+    { name: "caller_id", type: "TEXT" },
+    { name: "run_manifest", type: "TEXT" },
+    { name: "skip_gates", type: "INTEGER" },
+];
+function addColumn(db, name, type) {
+    try {
+        db.exec(`ALTER TABLE runs ADD COLUMN ${name} ${type}`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (!/duplicate column name/i.test(message))
+            throw err;
+    }
+}
+export const MIGRATION_006 = {
+    version: 6,
+    name: "006_pipeline_body_and_caller",
+    minStageflowVersion: PACKAGE_VERSION,
+    up(db) {
+        for (const col of RUN_COLUMNS) {
+            addColumn(db, col.name, col.type);
+        }
+    },
+};

package/dist/runstore/sqlite/migrations/007-projects-registry.d.ts

@@ -0,0 +1,7 @@
+import type Database from "better-sqlite3";
+export declare const MIGRATION_007: {
+    version: number;
+    name: string;
+    minStageflowVersion: string;
+    up(db: Database.Database): void;
+};

package/dist/runstore/sqlite/migrations/007-projects-registry.js

@@ -0,0 +1,31 @@
+import path from "node:path";
+import { PACKAGE_VERSION } from "../../../package-meta.js";
+import { normalizeProjectRoot } from "../../normalizeCatalogPath.js";
+export const MIGRATION_007 = {
+    version: 7,
+    name: "007_projects_registry",
+    minStageflowVersion: PACKAGE_VERSION,
+    up(db) {
+        db.exec(`
+CREATE TABLE IF NOT EXISTS projects (
+  project_root TEXT PRIMARY KEY NOT NULL,
+  created_at TEXT NOT NULL
+);
+`);
+        const runCols = db.prepare(`PRAGMA table_info(runs)`).all().map((c) => c.name);
+        if (!runCols.includes("project_root"))
+            return;
+        const now = new Date().toISOString();
+        const insert = db.prepare(`INSERT OR IGNORE INTO projects (project_root, created_at) VALUES (?, ?)`);
+        const rows = db
+            .prepare(`SELECT DISTINCT project_root FROM runs
+         WHERE project_root IS NOT NULL AND project_root != ''`)
+            .all();
+        for (const row of rows) {
+            const raw = row.project_root;
+            if (!path.isAbsolute(raw))
+                continue;
+            insert.run(normalizeProjectRoot(raw), now);
+        }
+    },
+};

package/dist/runstore/sqlite/migrations/008-triggers-table.d.ts

@@ -0,0 +1,7 @@
+import type Database from "better-sqlite3";
+export declare const MIGRATION_008: {
+    version: number;
+    name: string;
+    minStageflowVersion: string;
+    up(db: Database.Database): void;
+};

package/dist/runstore/sqlite/migrations/008-triggers-table.js

@@ -0,0 +1,19 @@
+import { PACKAGE_VERSION } from "../../../package-meta.js";
+export const MIGRATION_008 = {
+    version: 8,
+    name: "008_triggers_table",
+    minStageflowVersion: PACKAGE_VERSION,
+    up(db) {
+        db.exec(`
+CREATE TABLE IF NOT EXISTS triggers (
+  id TEXT PRIMARY KEY NOT NULL,
+  definition_ref TEXT NOT NULL,
+  enabled INTEGER NOT NULL DEFAULT 1,
+  last_fired_at TEXT,
+  last_run_id TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+`);
+    },
+};

package/dist/runstore/sqlite/migrations/009-trigger-next-run.d.ts

@@ -0,0 +1,7 @@
+import type Database from "better-sqlite3";
+export declare const MIGRATION_009: {
+    version: number;
+    name: string;
+    minStageflowVersion: string;
+    up(db: Database.Database): void;
+};

package/dist/runstore/sqlite/migrations/009-trigger-next-run.js

@@ -0,0 +1,19 @@
+import { PACKAGE_VERSION } from "../../../package-meta.js";
+function addNextRunAtColumn(db) {
+    try {
+        db.exec(`ALTER TABLE triggers ADD COLUMN next_run_at TEXT`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (!/duplicate column name/i.test(message))
+            throw err;
+    }
+}
+export const MIGRATION_009 = {
+    version: 9,
+    name: "009_trigger_next_run",
+    minStageflowVersion: PACKAGE_VERSION,
+    up(db) {
+        addNextRunAtColumn(db);
+    },
+};

package/dist/runstore/sqlite/migrations/010-trigger-adapter-state.d.ts

@@ -0,0 +1,7 @@
+import type Database from "better-sqlite3";
+export declare const MIGRATION_010: {
+    version: number;
+    name: string;
+    minStageflowVersion: string;
+    up(db: Database.Database): void;
+};

package/dist/runstore/sqlite/migrations/010-trigger-adapter-state.js

@@ -0,0 +1,17 @@
+import { PACKAGE_VERSION } from "../../../package-meta.js";
+export const MIGRATION_010 = {
+    version: 10,
+    name: "010_trigger_adapter_state",
+    minStageflowVersion: PACKAGE_VERSION,
+    up(db) {
+        db.exec(`
+CREATE TABLE IF NOT EXISTS trigger_adapter_state (
+  trigger_id TEXT NOT NULL,
+  key TEXT NOT NULL,
+  value TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (trigger_id, key)
+);
+`);
+    },
+};

package/dist/runstore/sqlite/migrations/index.d.ts

@@ -0,0 +1,21 @@
+import type Database from "better-sqlite3";
+export type SqliteMigration = {
+    version: number;
+    name: string;
+    minStageflowVersion: string;
+    up: (db: Database.Database) => void;
+};
+export declare const CURRENT_SCHEMA_VERSION: number;
+export type SchemaMigrationRow = {
+    version: number;
+    name: string;
+    applied_at: string;
+    min_stageflow_version: string;
+};
+export declare function readSchemaMigrationRow(db: Database.Database, version: number): SchemaMigrationRow | undefined;
+export declare function assertSchemaVersion(db: Database.Database, options?: {
+    migrations?: SqliteMigration[];
+}): void;
+export declare function applyPendingMigrations(db: Database.Database, options?: {
+    migrations?: SqliteMigration[];
+}): void;

package/dist/runstore/sqlite/migrations/index.js

@@ -0,0 +1,78 @@
+import { StoreSchemaError } from "../storeSchemaError.js";
+import { MIGRATION_001 } from "./001-baseline.js";
+import { MIGRATION_002 } from "./002-repository-binding.js";
+import { MIGRATION_003 } from "./003-run-lifecycle.js";
+import { MIGRATION_004 } from "./004-auto-resume-count.js";
+import { MIGRATION_005 } from "./005-config-origins.js";
+import { MIGRATION_006 } from "./006-pipeline-body-and-caller.js";
+import { MIGRATION_007 } from "./007-projects-registry.js";
+import { MIGRATION_008 } from "./008-triggers-table.js";
+import { MIGRATION_009 } from "./009-trigger-next-run.js";
+import { MIGRATION_010 } from "./010-trigger-adapter-state.js";
+const DEFAULT_MIGRATIONS = [
+    MIGRATION_001,
+    MIGRATION_002,
+    MIGRATION_003,
+    MIGRATION_004,
+    MIGRATION_005,
+    MIGRATION_006,
+    MIGRATION_007,
+    MIGRATION_008,
+    MIGRATION_009,
+    MIGRATION_010,
+];
+export const CURRENT_SCHEMA_VERSION = DEFAULT_MIGRATIONS[DEFAULT_MIGRATIONS.length - 1].version;
+function throwStoreSchemaTooNew(db, version, maxKnown) {
+    const row = readSchemaMigrationRow(db, version);
+    const minVersion = row?.min_stageflow_version ?? "unknown";
+    throw new StoreSchemaError(`store_schema_too_new: on_disk=${version} binary_max=${maxKnown} min_stageflow=${minVersion}`, "store_schema_too_new");
+}
+export function readSchemaMigrationRow(db, version) {
+    const table = db
+        .prepare(`SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'schema_migrations'`)
+        .get();
+    if (!table)
+        return undefined;
+    return db
+        .prepare(`SELECT version, name, applied_at, min_stageflow_version FROM schema_migrations WHERE version = ?`)
+        .get(version);
+}
+export function assertSchemaVersion(db, options) {
+    const migrations = options?.migrations ?? DEFAULT_MIGRATIONS;
+    const version = db.pragma("user_version", { simple: true });
+    const maxKnown = migrations[migrations.length - 1]?.version ?? 0;
+    if (version > maxKnown) {
+        throwStoreSchemaTooNew(db, version, maxKnown);
+    }
+    if (version < maxKnown) {
+        throw new StoreSchemaError(`store_schema_migration_required: on_disk=${version} binary_max=${maxKnown}`, "store_schema_migration_required");
+    }
+}
+export function applyPendingMigrations(db, options) {
+    const migrations = options?.migrations ?? DEFAULT_MIGRATIONS;
+    let version = db.pragma("user_version", { simple: true });
+    const maxKnown = migrations[migrations.length - 1]?.version ?? 0;
+    if (version > maxKnown) {
+        throwStoreSchemaTooNew(db, version, maxKnown);
+    }
+    for (const migration of migrations) {
+        if (migration.version <= version)
+            continue;
+        if (migration.version !== version + 1) {
+            throw new Error(`Missing migration between schema version ${version} and ${migration.version}`);
+        }
+        db.transaction(() => {
+            migration.up(db);
+            const appliedAt = new Date().toISOString();
+            db.prepare(`INSERT INTO schema_migrations (version, name, applied_at, min_stageflow_version)
+         VALUES (@version, @name, @applied_at, @min_stageflow_version)`).run({
+                version: migration.version,
+                name: migration.name,
+                applied_at: appliedAt,
+                min_stageflow_version: migration.minStageflowVersion,
+            });
+            db.pragma(`user_version = ${migration.version}`);
+        })();
+        version = migration.version;
+    }
+}

package/dist/runstore/sqlite/schema.d.ts

@@ -1 +1,20 @@
-export declare const SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS runs (\n  run_id TEXT PRIMARY KEY,\n  pipeline_id TEXT NOT NULL,\n  task_id TEXT,\n  task_yaml TEXT NOT NULL,\n  status TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  checkout_root TEXT,\n  pipeline_dag_json TEXT,\n  git_sha TEXT,\n  ci_pr_url TEXT,\n  ci_job_url TEXT,\n  pipeline_path TEXT,\n  task_path TEXT,\n  project_root TEXT\n);\n\nCREATE TABLE IF NOT EXISTS run_submissions (\n  submission_key TEXT PRIMARY KEY,\n  request_hash TEXT NOT NULL,\n  run_id TEXT NOT NULL UNIQUE REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS stages (\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  status TEXT,\n  summary TEXT,\n  envelope_json TEXT,\n  started_at TEXT,\n  finished_at TEXT,\n  PRIMARY KEY (run_id, stage_id),\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS stage_events (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  at TEXT NOT NULL,\n  event TEXT NOT NULL,\n  payload_json TEXT,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_runs_status_created\n  ON runs (status, created_at DESC);\n\nCREATE INDEX IF NOT EXISTS idx_runs_pipeline_created\n  ON runs (pipeline_id, created_at DESC);\n\nCREATE INDEX IF NOT EXISTS idx_stage_events_run_stage_at\n  ON stage_events (run_id, stage_id, at);\n\nCREATE TABLE IF NOT EXISTS stage_executions (\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  attempt INTEGER NOT NULL,\n  status TEXT NOT NULL,\n  verification_outcome TEXT NOT NULL DEFAULT 'not_run',\n  started_at TEXT,\n  finished_at TEXT,\n  envelope_json TEXT,\n  cost_usd REAL,\n  usage_json TEXT,\n  PRIMARY KEY (run_id, stage_id, attempt),\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_stage_executions_run_stage\n  ON stage_executions (run_id, stage_id, attempt);\n\nCREATE TABLE IF NOT EXISTS verification_check_results (\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  attempt INTEGER NOT NULL,\n  check_id TEXT NOT NULL,\n  check_type TEXT NOT NULL,\n  status TEXT NOT NULL,\n  started_at TEXT,\n  finished_at TEXT,\n  evidence_json TEXT,\n  PRIMARY KEY (run_id, stage_id, attempt, check_id),\n  FOREIGN KEY (run_id, stage_id, attempt)\n    REFERENCES stage_executions(run_id, stage_id, attempt)\n);\n\nCREATE INDEX IF NOT EXISTS idx_verification_check_results_execution\n  ON verification_check_results (run_id, stage_id, attempt, check_id);\n\nCREATE TABLE IF NOT EXISTS feedback_loops (\n  run_id TEXT NOT NULL,\n  loop_id TEXT NOT NULL,\n  source_stage_id TEXT NOT NULL,\n  source_attempt INTEGER NOT NULL,\n  policy_json TEXT NOT NULL,\n  state TEXT NOT NULL,\n  current_replay_id TEXT,\n  current_replay_number INTEGER,\n  deferred_send_back_json TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  PRIMARY KEY (run_id, loop_id),\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_feedback_loops_run_state\n  ON feedback_loops (run_id, state, created_at);\n\nCREATE TABLE IF NOT EXISTS feedback_replays (\n  run_id TEXT NOT NULL,\n  replay_id TEXT NOT NULL,\n  loop_id TEXT NOT NULL,\n  source_stage_id TEXT NOT NULL,\n  source_attempt INTEGER NOT NULL,\n  target_stage_id TEXT NOT NULL,\n  replay_number INTEGER NOT NULL,\n  max_replays INTEGER NOT NULL,\n  replay_session TEXT NOT NULL,\n  route_stage_ids_json TEXT NOT NULL,\n  feedback_envelope_json TEXT NOT NULL,\n  status TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  PRIMARY KEY (run_id, replay_id),\n  FOREIGN KEY (run_id, loop_id) REFERENCES feedback_loops(run_id, loop_id)\n);\n\nCREATE UNIQUE INDEX IF NOT EXISTS idx_feedback_replays_loop_number\n  ON feedback_replays (run_id, loop_id, replay_number);\nCREATE INDEX IF NOT EXISTS idx_feedback_replays_run_loop\n  ON feedback_replays (run_id, loop_id, created_at);\n\nCREATE TABLE IF NOT EXISTS feedback_replay_stage_passes (\n  run_id TEXT NOT NULL,\n  replay_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  stage_attempt INTEGER NOT NULL,\n  session_origin_attempt INTEGER,\n  session_mode TEXT NOT NULL,\n  status TEXT NOT NULL,\n  started_at TEXT,\n  finished_at TEXT,\n  emitted_envelope_json TEXT,\n  PRIMARY KEY (run_id, replay_id, stage_id),\n  FOREIGN KEY (run_id, replay_id) REFERENCES feedback_replays(run_id, replay_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_feedback_replay_stage_passes_replay\n  ON feedback_replay_stage_passes (run_id, replay_id, stage_id);\n\nCREATE TABLE IF NOT EXISTS fork_generations (\n  run_id TEXT NOT NULL,\n  generation_id TEXT NOT NULL,\n  replay_id TEXT,\n  fork_parent_stage_id TEXT NOT NULL,\n  generation_number INTEGER NOT NULL,\n  clone_stage_ids_json TEXT NOT NULL,\n  status TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  PRIMARY KEY (run_id, generation_id),\n  FOREIGN KEY (run_id, replay_id) REFERENCES feedback_replays(run_id, replay_id)\n);\n\nCREATE UNIQUE INDEX IF NOT EXISTS idx_fork_generations_parent_number\n  ON fork_generations (run_id, fork_parent_stage_id, generation_number);\nCREATE INDEX IF NOT EXISTS idx_fork_generations_run_replay\n  ON fork_generations (run_id, replay_id, created_at);\n";
+import type Database from "better-sqlite3";
+export declare const A2A_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS a2a_contexts (\n  context_id TEXT PRIMARY KEY,\n  caller_id TEXT NOT NULL,\n  created_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS a2a_tasks (\n  task_id TEXT PRIMARY KEY,\n  context_id TEXT NOT NULL,\n  caller_id TEXT NOT NULL,\n  publication_id TEXT NOT NULL,\n  publication_revision TEXT NOT NULL,\n  submission_key TEXT NOT NULL UNIQUE,\n  run_id TEXT,\n  state TEXT NOT NULL,\n  result_json TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS a2a_tasks_context ON a2a_tasks(context_id);\nCREATE INDEX IF NOT EXISTS a2a_tasks_caller ON a2a_tasks(caller_id);\n\nCREATE TABLE IF NOT EXISTS a2a_messages (\n  caller_id TEXT NOT NULL,\n  message_id TEXT NOT NULL,\n  task_id TEXT NOT NULL,\n  operation TEXT NOT NULL,\n  request_hash TEXT NOT NULL,\n  outcome_json TEXT,\n  created_at TEXT NOT NULL,\n  PRIMARY KEY (caller_id, message_id)\n);\n\nCREATE TABLE IF NOT EXISTS a2a_artifacts (\n  artifact_id TEXT PRIMARY KEY,\n  task_id TEXT NOT NULL,\n  name TEXT NOT NULL,\n  media_type TEXT,\n  size INTEGER NOT NULL,\n  content_path TEXT NOT NULL,\n  hash TEXT NOT NULL,\n  created_at TEXT NOT NULL\n);\nCREATE INDEX IF NOT EXISTS a2a_artifacts_task ON a2a_artifacts(task_id);\n";
+export declare const SCHEMA_MIGRATIONS_DDL = "\nCREATE TABLE IF NOT EXISTS schema_migrations (\n  version INTEGER PRIMARY KEY,\n  name TEXT NOT NULL,\n  applied_at TEXT NOT NULL,\n  min_stageflow_version TEXT NOT NULL\n);\n";
+export declare const SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS runs (\n  run_id TEXT PRIMARY KEY,\n  pipeline_id TEXT NOT NULL,\n  task_id TEXT,\n  task_yaml TEXT NOT NULL,\n  status TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  checkout_root TEXT,\n  pipeline_dag_json TEXT,\n  git_sha TEXT,\n  ci_pr_url TEXT,\n  ci_job_url TEXT,\n  pipeline_path TEXT,\n  task_path TEXT,\n  project_root TEXT,\n  repository TEXT,\n  ref TEXT,\n  resolved_sha TEXT,\n  run_branch TEXT,\n  git_author_name TEXT,\n  git_author_email TEXT,\n  cancel_reason TEXT,\n  finished_at TEXT,\n  slimmed_at TEXT,\n  disk_bytes INTEGER,\n  disk_measured_at TEXT,\n  config_origins_json TEXT,\n  pipeline_source TEXT,\n  pipeline_body TEXT,\n  caller_id TEXT,\n  run_manifest TEXT,\n  skip_gates INTEGER\n);\n\nCREATE TABLE IF NOT EXISTS projects (\n  project_root TEXT PRIMARY KEY NOT NULL,\n  created_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS run_submissions (\n  submission_key TEXT PRIMARY KEY,\n  request_hash TEXT NOT NULL,\n  run_id TEXT NOT NULL UNIQUE REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS stages (\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  status TEXT,\n  summary TEXT,\n  envelope_json TEXT,\n  started_at TEXT,\n  finished_at TEXT,\n  PRIMARY KEY (run_id, stage_id),\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE TABLE IF NOT EXISTS stage_events (\n  id INTEGER PRIMARY KEY AUTOINCREMENT,\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  at TEXT NOT NULL,\n  event TEXT NOT NULL,\n  payload_json TEXT,\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_runs_status_created\n  ON runs (status, created_at DESC);\n\nCREATE INDEX IF NOT EXISTS idx_runs_pipeline_created\n  ON runs (pipeline_id, created_at DESC);\n\nCREATE INDEX IF NOT EXISTS idx_stage_events_run_stage_at\n  ON stage_events (run_id, stage_id, at);\n\nCREATE TABLE IF NOT EXISTS stage_executions (\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  attempt INTEGER NOT NULL,\n  status TEXT NOT NULL,\n  verification_outcome TEXT NOT NULL DEFAULT 'not_run',\n  started_at TEXT,\n  finished_at TEXT,\n  envelope_json TEXT,\n  cost_usd REAL,\n  usage_json TEXT,\n  auto_resume_count INTEGER NOT NULL DEFAULT 0,\n  PRIMARY KEY (run_id, stage_id, attempt),\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_stage_executions_run_stage\n  ON stage_executions (run_id, stage_id, attempt);\n\nCREATE TABLE IF NOT EXISTS verification_check_results (\n  run_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  attempt INTEGER NOT NULL,\n  check_id TEXT NOT NULL,\n  check_type TEXT NOT NULL,\n  status TEXT NOT NULL,\n  started_at TEXT,\n  finished_at TEXT,\n  evidence_json TEXT,\n  PRIMARY KEY (run_id, stage_id, attempt, check_id),\n  FOREIGN KEY (run_id, stage_id, attempt)\n    REFERENCES stage_executions(run_id, stage_id, attempt)\n);\n\nCREATE INDEX IF NOT EXISTS idx_verification_check_results_execution\n  ON verification_check_results (run_id, stage_id, attempt, check_id);\n\nCREATE TABLE IF NOT EXISTS feedback_loops (\n  run_id TEXT NOT NULL,\n  loop_id TEXT NOT NULL,\n  source_stage_id TEXT NOT NULL,\n  source_attempt INTEGER NOT NULL,\n  policy_json TEXT NOT NULL,\n  state TEXT NOT NULL,\n  current_replay_id TEXT,\n  current_replay_number INTEGER,\n  deferred_send_back_json TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  PRIMARY KEY (run_id, loop_id),\n  FOREIGN KEY (run_id) REFERENCES runs(run_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_feedback_loops_run_state\n  ON feedback_loops (run_id, state, created_at);\n\nCREATE TABLE IF NOT EXISTS feedback_replays (\n  run_id TEXT NOT NULL,\n  replay_id TEXT NOT NULL,\n  loop_id TEXT NOT NULL,\n  source_stage_id TEXT NOT NULL,\n  source_attempt INTEGER NOT NULL,\n  target_stage_id TEXT NOT NULL,\n  replay_number INTEGER NOT NULL,\n  max_replays INTEGER NOT NULL,\n  replay_session TEXT NOT NULL,\n  route_stage_ids_json TEXT NOT NULL,\n  feedback_envelope_json TEXT NOT NULL,\n  status TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  PRIMARY KEY (run_id, replay_id),\n  FOREIGN KEY (run_id, loop_id) REFERENCES feedback_loops(run_id, loop_id)\n);\n\nCREATE UNIQUE INDEX IF NOT EXISTS idx_feedback_replays_loop_number\n  ON feedback_replays (run_id, loop_id, replay_number);\nCREATE INDEX IF NOT EXISTS idx_feedback_replays_run_loop\n  ON feedback_replays (run_id, loop_id, created_at);\n\nCREATE TABLE IF NOT EXISTS feedback_replay_stage_passes (\n  run_id TEXT NOT NULL,\n  replay_id TEXT NOT NULL,\n  stage_id TEXT NOT NULL,\n  stage_attempt INTEGER NOT NULL,\n  session_origin_attempt INTEGER,\n  session_mode TEXT NOT NULL,\n  status TEXT NOT NULL,\n  started_at TEXT,\n  finished_at TEXT,\n  emitted_envelope_json TEXT,\n  PRIMARY KEY (run_id, replay_id, stage_id),\n  FOREIGN KEY (run_id, replay_id) REFERENCES feedback_replays(run_id, replay_id)\n);\n\nCREATE INDEX IF NOT EXISTS idx_feedback_replay_stage_passes_replay\n  ON feedback_replay_stage_passes (run_id, replay_id, stage_id);\n\nCREATE TABLE IF NOT EXISTS fork_generations (\n  run_id TEXT NOT NULL,\n  generation_id TEXT NOT NULL,\n  replay_id TEXT,\n  fork_parent_stage_id TEXT NOT NULL,\n  generation_number INTEGER NOT NULL,\n  clone_stage_ids_json TEXT NOT NULL,\n  status TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  PRIMARY KEY (run_id, generation_id),\n  FOREIGN KEY (run_id, replay_id) REFERENCES feedback_replays(run_id, replay_id)\n);\n\nCREATE UNIQUE INDEX IF NOT EXISTS idx_fork_generations_parent_number\n  ON fork_generations (run_id, fork_parent_stage_id, generation_number);\nCREATE INDEX IF NOT EXISTS idx_fork_generations_run_replay\n  ON fork_generations (run_id, replay_id, created_at);\n";
+export declare function ensureCheckoutRootColumn(db: Database.Database): void;
+export declare function ensureCiIdentityColumns(db: Database.Database): void;
+export declare function ensurePipelineDagColumn(db: Database.Database): void;
+export declare function ensureRunLocatorColumns(db: Database.Database): void;
+export declare function ensureStageExecutionsTable(db: Database.Database): void;
+export declare function ensureStageExecutionAutoResumeCountColumn(db: Database.Database): void;
+export declare function ensureStageExecutionVerificationOutcomeColumn(db: Database.Database): void;
+export declare function ensureStageExecutionCostColumns(db: Database.Database): void;
+export declare function backfillVerificationOutcomes(db: Database.Database): void;
+export declare function ensureStageEventsAttemptColumn(db: Database.Database): void;
+export declare function ensureVerificationCheckResultsTable(db: Database.Database): void;
+export declare function ensureFeedbackReplayStagePassEnvelopeColumn(db: Database.Database): void;
+export declare function ensureFeedbackReplayStagePassSessionOriginColumn(db: Database.Database): void;
+export declare function ensureFeedbackLoopDeferredSendBackColumn(db: Database.Database): void;
+export declare function ensureConfigOriginsColumn(db: Database.Database): void;
+export declare function applyBaselineSchema(db: Database.Database): void;