@ontrails/core 1.0.0-beta.13 → 1.0.0-beta.15

package/dist/internal/signal-ref.js

@@ -0,0 +1,41 @@
+const LATE_BOUND_SIGNAL_REF = Symbol('trails.late-bound-signal-ref');
+const LATE_BOUND_SIGNAL_MARKER_PREFIX = '@@trails:late-bound-signal-ref:';
+const defineLateBoundSignalRef = (value, ref) => {
+    Object.defineProperty(value, LATE_BOUND_SIGNAL_REF, {
+        configurable: false,
+        enumerable: false,
+        value: ref,
+        writable: false,
+    });
+    return value;
+};
+export const getLateBoundSignalRef = (signal) => signal === undefined
+    ? undefined
+    : signal[LATE_BOUND_SIGNAL_REF];
+export const attachLateBoundSignalRef = (signal, ref) => Object.freeze(defineLateBoundSignalRef({
+    ...signal,
+}, ref));
+export const cloneSignalWithId = (signal, id) => {
+    const clone = {
+        ...signal,
+        id,
+    };
+    const ref = getLateBoundSignalRef(signal);
+    return Object.freeze(ref ? defineLateBoundSignalRef(clone, ref) : clone);
+};
+export const createLateBoundSignalMarker = (ref, displayId) => `${LATE_BOUND_SIGNAL_MARKER_PREFIX}${ref.token}:${displayId}`;
+export const parseLateBoundSignalMarker = (value) => {
+    if (!value.startsWith(LATE_BOUND_SIGNAL_MARKER_PREFIX)) {
+        return null;
+    }
+    const remainder = value.slice(LATE_BOUND_SIGNAL_MARKER_PREFIX.length);
+    const separator = remainder.indexOf(':');
+    if (separator <= 0 || separator === remainder.length - 1) {
+        return null;
+    }
+    return {
+        displayId: remainder.slice(separator + 1),
+        token: remainder.slice(0, separator),
+    };
+};
+//# sourceMappingURL=signal-ref.js.map

package/dist/internal/signal-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-ref.js","sourceRoot":"","sources":["../../src/internal/signal-ref.ts"],"names":[],"mappings":"AAYA,MAAM,qBAAqB,GAAG,MAAM,CAAC,8BAA8B,CAAC,CAAC;AACrE,MAAM,+BAA+B,GAAG,iCAAiC,CAAC;AAE1E,MAAM,wBAAwB,GAAG,CAC/B,KAAQ,EACR,GAAuB,EACpB,EAAE;IACL,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,qBAAqB,EAAE;QAClD,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,GAAG;QACV,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,MAAyC,EACT,EAAE,CAClC,MAAM,KAAK,SAAS;IAClB,CAAC,CAAC,SAAS;IACX,CAAC,CAAG,MAAuC,CAAC,qBAAqB,CAEjD,CAAC;AAErB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,MAAiB,EACjB,GAAuB,EACZ,EAAE,CACb,MAAM,CAAC,MAAM,CACX,wBAAwB,CACtB;IACE,GAAG,MAAM;CACV,EACD,GAAG,CACJ,CACW,CAAC;AAEjB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,MAAiB,EACjB,EAAU,EACC,EAAE;IACb,MAAM,KAAK,GAAG;QACZ,GAAG,MAAM;QACT,EAAE;KACH,CAAC;IACF,MAAM,GAAG,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,MAAM,CAClB,GAAG,CAAC,CAAC,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CACtC,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,GAAuB,EACvB,SAAiB,EACT,EAAE,CAAC,GAAG,+BAA+B,GAAG,GAAG,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;AAE3E,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,KAAa,EACiB,EAAE;IAChC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,+BAA+B,CAAC,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,+BAA+B,CAAC,MAAM,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,KAAK,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;QACzC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;KACrC,CAAC;AACJ,CAAC,CAAC"}

package/dist/internal/topo-saves.d.ts

@@ -0,0 +1,53 @@
+import type { Database } from 'bun:sqlite';
+export interface TopoSaveRecord {
+    readonly createdAt: string;
+    readonly gitDirty: boolean;
+    readonly gitSha?: string;
+    readonly id: string;
+    readonly resourceCount: number;
+    readonly signalCount: number;
+    readonly trailCount: number;
+}
+export interface CreateTopoSaveInput {
+    readonly createdAt?: string;
+    readonly gitDirty?: boolean;
+    readonly gitSha?: string;
+    readonly id?: string;
+    readonly resourceCount?: number;
+    readonly signalCount?: number;
+    readonly trailCount?: number;
+}
+export interface TopoPinRecord {
+    readonly createdAt: string;
+    readonly name: string;
+    readonly saveId: string;
+}
+export interface CreateTopoPinInput {
+    readonly createdAt?: string;
+    readonly name: string;
+    readonly saveId: string;
+}
+/**
+ * Current topo subsystem schema version. Exported so read-only callers can
+ * peek at `meta_schema_versions` and skip the write-mode migration escalation
+ * when the store is already current.
+ */
+export declare const TOPO_SCHEMA_VERSION = 5;
+export declare const ensureTopoHistorySchema: (db: Database) => void;
+export declare const insertTopoSaveRecord: (db: Database, input?: CreateTopoSaveInput) => TopoSaveRecord;
+export declare const createTopoSave: (db: Database, input?: CreateTopoSaveInput) => TopoSaveRecord;
+export declare const pinTopoSave: (db: Database, input: CreateTopoPinInput) => TopoPinRecord;
+export declare const listTopoSaves: (db: Database) => readonly TopoSaveRecord[];
+export declare const listTopoPins: (db: Database) => readonly TopoPinRecord[];
+export declare const countTopoSaves: (db: Database) => number;
+export declare const countTopoPins: (db: Database) => number;
+export declare const getTopoSave: (db: Database, id: string) => TopoSaveRecord | undefined;
+export declare const getTopoPin: (db: Database, name: string) => TopoPinRecord | undefined;
+export declare const countPrunableTopoSaves: (db: Database, options: {
+    readonly keep: number;
+}) => number;
+export declare const pruneUnpinnedTopoSaves: (db: Database, options: {
+    readonly keep: number;
+}) => number;
+export declare const unpinTopoSave: (db: Database, name: string) => boolean;
+//# sourceMappingURL=topo-saves.d.ts.map

package/dist/internal/topo-saves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topo-saves.d.ts","sourceRoot":"","sources":["../../src/internal/topo-saves.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA6J3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAiLD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,eAAO,MAAM,uBAAuB,GAAI,IAAI,QAAQ,KAAG,IAQtD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,IAAI,QAAQ,EACZ,QAAQ,mBAAmB,KAC1B,cA2BF,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,IAAI,QAAQ,EACZ,QAAQ,mBAAmB,KAC1B,cAGF,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,IAAI,QAAQ,EACZ,OAAO,kBAAkB,KACxB,aAkBF,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,IAAI,QAAQ,KAAG,SAAS,cAAc,EAYnE,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,IAAI,QAAQ,KAAG,SAAS,aAAa,EAYjE,CAAC;AASF,eAAO,MAAM,cAAc,GAAI,IAAI,QAAQ,KAAG,MAK7C,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,IAAI,QAAQ,KAAG,MAQ5C,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,IAAI,QAAQ,EACZ,IAAI,MAAM,KACT,cAAc,GAAG,SAYnB,CAAC;AAEF,eAAO,MAAM,UAAU,GACrB,IAAI,QAAQ,EACZ,MAAM,MAAM,KACX,aAAa,GAAG,SAYlB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,IAAI,QAAQ,EACZ,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KACjC,MAkBF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,IAAI,QAAQ,EACZ,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KACjC,MAyBF,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,IAAI,QAAQ,EAAE,MAAM,MAAM,KAAG,OAI1D,CAAC"}

package/dist/internal/topo-saves.js

@@ -0,0 +1,449 @@
+import { ensureSubsystemSchema } from './trails-db.js';
+const TOPO_SUBSYSTEM = 'topo';
+const TOPO_TABLE_STATEMENTS = [
+    `CREATE TABLE IF NOT EXISTS topo_saves (
+    id TEXT PRIMARY KEY,
+    git_sha TEXT,
+    git_dirty INTEGER NOT NULL DEFAULT 0,
+    trail_count INTEGER NOT NULL DEFAULT 0,
+    signal_count INTEGER NOT NULL DEFAULT 0,
+    resource_count INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_pins (
+    name TEXT PRIMARY KEY,
+    save_id TEXT NOT NULL,
+    created_at TEXT NOT NULL,
+    FOREIGN KEY (save_id) REFERENCES topo_saves(id)
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_trails (
+    id TEXT NOT NULL,
+    intent TEXT,
+    idempotent INTEGER NOT NULL DEFAULT 0,
+    has_output INTEGER NOT NULL DEFAULT 0,
+    has_examples INTEGER NOT NULL DEFAULT 0,
+    example_count INTEGER NOT NULL DEFAULT 0,
+    description TEXT,
+    meta TEXT,
+    save_id TEXT NOT NULL,
+    PRIMARY KEY (id, save_id),
+    FOREIGN KEY (save_id) REFERENCES topo_saves(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_crossings (
+    source_id TEXT NOT NULL,
+    target_id TEXT NOT NULL,
+    save_id TEXT NOT NULL,
+    PRIMARY KEY (source_id, target_id, save_id),
+    FOREIGN KEY (save_id) REFERENCES topo_saves(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_trail_resources (
+    trail_id TEXT NOT NULL,
+    resource_id TEXT NOT NULL,
+    save_id TEXT NOT NULL,
+    PRIMARY KEY (trail_id, resource_id, save_id),
+    FOREIGN KEY (save_id) REFERENCES topo_saves(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_resources (
+    id TEXT NOT NULL,
+    has_mock INTEGER NOT NULL DEFAULT 0,
+    has_health INTEGER NOT NULL DEFAULT 0,
+    save_id TEXT NOT NULL,
+    PRIMARY KEY (id, save_id),
+    FOREIGN KEY (save_id) REFERENCES topo_saves(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_signals (
+    id TEXT NOT NULL,
+    description TEXT,
+    save_id TEXT NOT NULL,
+    PRIMARY KEY (id, save_id),
+    FOREIGN KEY (save_id) REFERENCES topo_saves(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_trail_signals (
+    trail_id TEXT NOT NULL,
+    signal_id TEXT NOT NULL,
+    save_id TEXT NOT NULL,
+    PRIMARY KEY (trail_id, signal_id, save_id),
+    FOREIGN KEY (save_id) REFERENCES topo_saves(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_trailheads (
+    trail_id TEXT NOT NULL,
+    trailhead TEXT NOT NULL,
+    derived_name TEXT NOT NULL,
+    method TEXT,
+    save_id TEXT NOT NULL,
+    PRIMARY KEY (trail_id, trailhead, save_id),
+    FOREIGN KEY (save_id) REFERENCES topo_saves(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_examples (
+    id TEXT PRIMARY KEY,
+    trail_id TEXT NOT NULL,
+    ordinal INTEGER NOT NULL,
+    name TEXT NOT NULL,
+    description TEXT,
+    input TEXT NOT NULL,
+    expected TEXT,
+    error TEXT,
+    save_id TEXT NOT NULL,
+    FOREIGN KEY (save_id) REFERENCES topo_saves(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_schemas (
+    owner_id TEXT NOT NULL,
+    owner_kind TEXT NOT NULL,
+    schema_kind TEXT NOT NULL,
+    zod_hash TEXT NOT NULL,
+    json_schema TEXT NOT NULL,
+    save_id TEXT NOT NULL,
+    PRIMARY KEY (owner_id, owner_kind, schema_kind, save_id),
+    FOREIGN KEY (save_id) REFERENCES topo_saves(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_exports (
+    save_id TEXT PRIMARY KEY,
+    trailhead_map TEXT NOT NULL,
+    trailhead_hash TEXT NOT NULL,
+    serialized_lock TEXT NOT NULL,
+    FOREIGN KEY (save_id) REFERENCES topo_saves(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_trail_fires (
+    trail_id TEXT NOT NULL,
+    signal_id TEXT NOT NULL,
+    save_id TEXT NOT NULL,
+    PRIMARY KEY (trail_id, signal_id, save_id),
+    FOREIGN KEY (save_id) REFERENCES topo_saves(id) ON DELETE CASCADE
+  )`,
+    `CREATE TABLE IF NOT EXISTS topo_trail_on (
+    trail_id TEXT NOT NULL,
+    signal_id TEXT NOT NULL,
+    save_id TEXT NOT NULL,
+    PRIMARY KEY (trail_id, signal_id, save_id),
+    FOREIGN KEY (save_id) REFERENCES topo_saves(id) ON DELETE CASCADE
+  )`,
+];
+const TOPO_INDEX_STATEMENTS = [
+    'CREATE INDEX IF NOT EXISTS idx_topo_saves_created_at ON topo_saves(created_at DESC)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_pins_save_id ON topo_pins(save_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_trails_save_id ON topo_trails(save_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_crossings_save_id ON topo_crossings(save_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_trail_resources_save_id ON topo_trail_resources(save_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_resources_save_id ON topo_resources(save_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_signals_save_id ON topo_signals(save_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_trail_signals_save_id ON topo_trail_signals(save_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_trailheads_save_id ON topo_trailheads(save_id)',
+    'CREATE UNIQUE INDEX IF NOT EXISTS idx_topo_examples_save_trail_ordinal ON topo_examples(save_id, trail_id, ordinal)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_schemas_save_id ON topo_schemas(save_id)',
+    `CREATE INDEX IF NOT EXISTS idx_topo_schemas_lookup
+   ON topo_schemas(owner_id, owner_kind, schema_kind, zod_hash)`,
+    'CREATE INDEX IF NOT EXISTS idx_topo_trail_fires_save_id ON topo_trail_fires(save_id)',
+    'CREATE INDEX IF NOT EXISTS idx_topo_trail_on_save_id ON topo_trail_on(save_id)',
+];
+const rowToSave = (row) => ({
+    createdAt: row.created_at,
+    gitDirty: row.git_dirty === 1,
+    id: row.id,
+    resourceCount: row.resource_count,
+    signalCount: row.signal_count,
+    trailCount: row.trail_count,
+    ...(row.git_sha === null ? {} : { gitSha: row.git_sha }),
+});
+const rowToPin = (row) => ({
+    createdAt: row.created_at,
+    name: row.name,
+    saveId: row.save_id,
+});
+const tableExists = (db, tableName) => {
+    const row = db
+        .query("SELECT name FROM sqlite_master WHERE type = 'table' AND name = ?")
+        .get(tableName);
+    return row?.name === tableName;
+};
+const runStatements = (db, statements) => {
+    for (const statement of statements) {
+        db.run(statement);
+    }
+};
+const LEGACY_PROVISION_TABLES = [
+    'topo_provisions',
+    'topo_trail_provisions',
+];
+const ALL_TOPO_TABLES = [
+    'topo_exports',
+    'topo_schemas',
+    'topo_examples',
+    'topo_trailheads',
+    'topo_trail_signals',
+    'topo_signals',
+    'topo_trail_on',
+    'topo_trail_fires',
+    'topo_resources',
+    'topo_trail_resources',
+    'topo_crossings',
+    'topo_trails',
+    'topo_pins',
+    'topo_saves',
+];
+const notifyLegacyDrop = (savesCleared) => {
+    // biome-ignore lint/suspicious/noConsole: one-shot migration notice
+    console.info(savesCleared
+        ? 'topo store schema updated per ADR-0023; previous topo saves cleared'
+        : 'topo store schema updated per ADR-0023; legacy provision tables removed');
+};
+const topoSavesHasLegacyProvisionColumn = (db) => {
+    if (!tableExists(db, 'topo_saves')) {
+        return false;
+    }
+    const columns = db
+        .query('PRAGMA table_info(topo_saves)')
+        .all();
+    return columns.some((column) => column.name === 'provision_count');
+};
+const dropAllTopoTables = (db) => {
+    for (const table of ALL_TOPO_TABLES) {
+        db.run(`DROP TABLE IF EXISTS ${table}`);
+    }
+};
+const dropLegacyProvisionTables = (db) => {
+    let dropped = false;
+    for (const table of LEGACY_PROVISION_TABLES) {
+        if (tableExists(db, table)) {
+            db.run(`DROP TABLE IF EXISTS ${table}`);
+            dropped = true;
+        }
+    }
+    return dropped;
+};
+/**
+ * Drop legacy provision schema per ADR-0023.
+ *
+ * Returns `true` when anything legacy was dropped — either the orphan
+ * `topo_provisions` / `topo_trail_provisions` tables, or the full topo
+ * table set (because `topo_saves` still carried the legacy `provision_count`
+ * column). In either case the caller MUST recreate every table from scratch,
+ * regardless of the recorded subsystem version. The version-delta migration
+ * branches only add incremental tables and cannot be trusted to rebuild
+ * missing base tables.
+ *
+ * Pure-rename stores (v4 with `resource_count` already in place) return
+ * `false` and skip the rebuild path.
+ */
+const dropLegacyProvisionSchema = (db) => {
+    const droppedLegacyTables = dropLegacyProvisionTables(db);
+    const hasLegacyColumn = topoSavesHasLegacyProvisionColumn(db);
+    if (hasLegacyColumn) {
+        dropAllTopoTables(db);
+    }
+    const anyDropHappened = droppedLegacyTables || hasLegacyColumn;
+    if (anyDropHappened) {
+        notifyLegacyDrop(hasLegacyColumn);
+    }
+    return anyDropHappened;
+};
+const createAllTopoTables = (db) => {
+    runStatements(db, TOPO_TABLE_STATEMENTS);
+    runStatements(db, TOPO_INDEX_STATEMENTS);
+};
+const createSchemaCacheAndExportTables = (db) => {
+    // v2→v3: add schema cache and export tables
+    runStatements(db, TOPO_TABLE_STATEMENTS.slice(10, 12));
+    runStatements(db, TOPO_INDEX_STATEMENTS.slice(10, 12));
+};
+const createSignalEdgeTables = (db) => {
+    // v3→v4: add persisted signal edges (fires/on)
+    runStatements(db, TOPO_TABLE_STATEMENTS.slice(12));
+    runStatements(db, TOPO_INDEX_STATEMENTS.slice(12));
+};
+const runVersionDeltaMigration = (db, currentVersion) => {
+    if (currentVersion < 2) {
+        createAllTopoTables(db);
+        return;
+    }
+    if (currentVersion === 2) {
+        createSchemaCacheAndExportTables(db);
+    }
+    if (currentVersion < 4) {
+        createSignalEdgeTables(db);
+        return;
+    }
+    // currentVersion >= 4: (re)create all tables with the new resource*
+    // names. IF NOT EXISTS guards keep this safe when the store was already
+    // consistent.
+    createAllTopoTables(db);
+};
+const runTopoMigration = (db, currentVersion) => {
+    // v4→v5 (ADR-0023): drop any legacy `provision*` tables and rebuild
+    // `topo_saves` when it still carries the legacy `provision_count`
+    // column. Runs before the create-if-not-exists statements below so
+    // the new schema lands cleanly. Rows are not migrated.
+    const legacyDropHappened = dropLegacyProvisionSchema(db);
+    // When any legacy artifact was dropped — orphan provision tables OR the
+    // full topo table set — the version-delta branches can't be trusted to
+    // recreate the base tables (v2/v3 deltas only add incremental tables and
+    // would leave the store permanently missing `topo_resources`,
+    // `topo_trail_resources`, etc.). Rebuild everything from scratch and skip
+    // the old deltas.
+    if (legacyDropHappened) {
+        createAllTopoTables(db);
+        return;
+    }
+    runVersionDeltaMigration(db, currentVersion);
+};
+/**
+ * Current topo subsystem schema version. Exported so read-only callers can
+ * peek at `meta_schema_versions` and skip the write-mode migration escalation
+ * when the store is already current.
+ */
+export const TOPO_SCHEMA_VERSION = 5;
+export const ensureTopoHistorySchema = (db) => {
+    ensureSubsystemSchema(db, {
+        migrate: (currentVersion) => {
+            runTopoMigration(db, currentVersion);
+        },
+        subsystem: TOPO_SUBSYSTEM,
+        version: TOPO_SCHEMA_VERSION,
+    });
+};
+export const insertTopoSaveRecord = (db, input) => {
+    const record = {
+        createdAt: input?.createdAt ?? new Date().toISOString(),
+        gitDirty: input?.gitDirty ?? false,
+        id: input?.id ?? Bun.randomUUIDv7(),
+        resourceCount: input?.resourceCount ?? 0,
+        signalCount: input?.signalCount ?? 0,
+        trailCount: input?.trailCount ?? 0,
+        ...(input?.gitSha === undefined ? {} : { gitSha: input.gitSha }),
+    };
+    db.run(`INSERT INTO topo_saves (
+      id, git_sha, git_dirty, trail_count, signal_count, resource_count, created_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?)`, [
+        record.id,
+        record.gitSha ?? null,
+        record.gitDirty ? 1 : 0,
+        record.trailCount,
+        record.signalCount,
+        record.resourceCount,
+        record.createdAt,
+    ]);
+    return record;
+};
+export const createTopoSave = (db, input) => {
+    ensureTopoHistorySchema(db);
+    return insertTopoSaveRecord(db, input);
+};
+export const pinTopoSave = (db, input) => {
+    ensureTopoHistorySchema(db);
+    const record = {
+        createdAt: input.createdAt ?? new Date().toISOString(),
+        name: input.name,
+        saveId: input.saveId,
+    };
+    db.run(`INSERT INTO topo_pins (name, save_id, created_at) VALUES (?, ?, ?)
+     ON CONFLICT(name) DO UPDATE SET
+       save_id = excluded.save_id,
+       created_at = excluded.created_at`, [record.name, record.saveId, record.createdAt]);
+    return record;
+};
+export const listTopoSaves = (db) => {
+    if (!tableExists(db, 'topo_saves')) {
+        return [];
+    }
+    const rows = db
+        .query(`SELECT id, git_sha, git_dirty, trail_count, signal_count, resource_count, created_at
+       FROM topo_saves
+       ORDER BY created_at DESC, id DESC`)
+        .all();
+    return rows.map(rowToSave);
+};
+export const listTopoPins = (db) => {
+    if (!tableExists(db, 'topo_pins')) {
+        return [];
+    }
+    const rows = db
+        .query(`SELECT name, save_id, created_at
+       FROM topo_pins
+       ORDER BY created_at ASC, name ASC`)
+        .all();
+    return rows.map(rowToPin);
+};
+const countSaves = (db) => {
+    const row = db
+        .query('SELECT COUNT(*) as count FROM topo_saves')
+        .get();
+    return row?.count ?? 0;
+};
+export const countTopoSaves = (db) => {
+    if (!tableExists(db, 'topo_saves')) {
+        return 0;
+    }
+    return countSaves(db);
+};
+export const countTopoPins = (db) => {
+    if (!tableExists(db, 'topo_pins')) {
+        return 0;
+    }
+    const row = db
+        .query('SELECT COUNT(*) as count FROM topo_pins')
+        .get();
+    return row?.count ?? 0;
+};
+export const getTopoSave = (db, id) => {
+    if (!tableExists(db, 'topo_saves')) {
+        return undefined;
+    }
+    const row = db
+        .query(`SELECT id, git_sha, git_dirty, trail_count, signal_count, resource_count, created_at
+       FROM topo_saves
+       WHERE id = ?`)
+        .get(id);
+    return row === null || row === undefined ? undefined : rowToSave(row);
+};
+export const getTopoPin = (db, name) => {
+    if (!tableExists(db, 'topo_pins')) {
+        return undefined;
+    }
+    const row = db
+        .query(`SELECT name, save_id, created_at
+       FROM topo_pins
+       WHERE name = ?`)
+        .get(name);
+    return row === null || row === undefined ? undefined : rowToPin(row);
+};
+export const countPrunableTopoSaves = (db, options) => {
+    if (!tableExists(db, 'topo_saves') || !tableExists(db, 'topo_pins')) {
+        return 0;
+    }
+    const row = db
+        .query(`SELECT COUNT(*) as count
+       FROM (
+         SELECT save.id
+         FROM topo_saves save
+         LEFT JOIN topo_pins pin ON pin.save_id = save.id
+         WHERE pin.save_id IS NULL
+         ORDER BY save.created_at DESC, save.id DESC
+         LIMIT -1 OFFSET ?
+       )`)
+        .get(options.keep);
+    return row?.count ?? 0;
+};
+export const pruneUnpinnedTopoSaves = (db, options) => {
+    if (!tableExists(db, 'topo_saves') || !tableExists(db, 'topo_pins')) {
+        return 0;
+    }
+    if (countPrunableTopoSaves(db, options) === 0) {
+        return 0;
+    }
+    db.run(`DELETE FROM topo_saves
+     WHERE id IN (
+       SELECT save.id
+       FROM topo_saves save
+       LEFT JOIN topo_pins pin ON pin.save_id = save.id
+       WHERE pin.save_id IS NULL
+       ORDER BY save.created_at DESC, save.id DESC
+       LIMIT -1 OFFSET ?
+     )`, [options.keep]);
+    return (db.query('SELECT changes() as changes').get()
+        ?.changes ?? 0);
+};
+export const unpinTopoSave = (db, name) => {
+    ensureTopoHistorySchema(db);
+    const result = db.run('DELETE FROM topo_pins WHERE name = ?', [name]);
+    return result.changes > 0;
+};
+//# sourceMappingURL=topo-saves.js.map

package/dist/internal/topo-saves.js.map

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

package/dist/internal/topo-snapshots.d.ts

@@ -0,0 +1,57 @@
+import type { Database } from 'bun:sqlite';
+export interface TopoSnapshot {
+    readonly createdAt: string;
+    readonly gitDirty: boolean;
+    readonly gitSha?: string;
+    readonly id: string;
+    readonly pinnedAs?: string;
+    readonly resourceCount: number;
+    readonly signalCount: number;
+    readonly trailCount: number;
+}
+export interface CreateTopoSnapshotInput {
+    readonly createdAt?: string;
+    readonly gitDirty?: boolean;
+    readonly gitSha?: string;
+    readonly id?: string;
+    readonly resourceCount?: number;
+    readonly signalCount?: number;
+    readonly trailCount?: number;
+}
+export interface ListTopoSnapshotsOptions {
+    readonly before?: string;
+    readonly limit?: number;
+    readonly pinned?: boolean;
+}
+/**
+ * Current topo subsystem schema version.
+ *
+ * Version 8 adds `pattern TEXT` column to `topo_trails`.
+ *
+ * Version 7 defined the snapshot-first topo tables (`topo_snapshots`,
+ * `topo_surfaces`, and `snapshot_id` foreign keys) as the only supported
+ * schema. Older pre-release tables are ignored in place; we create the current
+ * tables and advance the subsystem version without translating or deleting
+ * legacy rows.
+ */
+export declare const TOPO_SCHEMA_VERSION = 8;
+export declare const ensureTopoSnapshotSchema: (db: Database) => void;
+export declare const insertTopoSnapshotRecord: (db: Database, input?: CreateTopoSnapshotInput) => TopoSnapshot;
+export declare const readTopoSnapshot: (db: Database, id: string) => TopoSnapshot | undefined;
+export declare const readPinnedTopoSnapshot: (db: Database, name: string) => TopoSnapshot | undefined;
+export declare const listTopoSnapshots: (db: Database, options?: ListTopoSnapshotsOptions) => readonly TopoSnapshot[];
+export declare const countTopoSnapshots: (db: Database) => number;
+export declare const countPinnedSnapshots: (db: Database) => number;
+export declare const countPrunableSnapshots: (db: Database, options: {
+    readonly keep: number;
+}) => number;
+export declare const createTopoSnapshot: (db: Database, input?: CreateTopoSnapshotInput) => TopoSnapshot;
+export declare const pinTopoSnapshot: (db: Database, input: {
+    readonly id: string;
+    readonly name: string;
+}) => TopoSnapshot | undefined;
+export declare const unpinTopoSnapshot: (db: Database, nameOrId: string) => TopoSnapshot | undefined;
+export declare const pruneUnpinnedSnapshots: (db: Database, options: {
+    readonly keep: number;
+}) => number;
+//# sourceMappingURL=topo-snapshots.d.ts.map

package/dist/internal/topo-snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topo-snapshots.d.ts","sourceRoot":"","sources":["../../src/internal/topo-snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAoB,MAAM,YAAY,CAAC;AAoJ7D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAiCD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,eAAO,MAAM,wBAAwB,GAAI,IAAI,QAAQ,KAAG,IAWvD,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,IAAI,QAAQ,EACZ,QAAQ,uBAAuB,KAC9B,YA4BF,CAAC;AASF,eAAO,MAAM,gBAAgB,GAC3B,IAAI,QAAQ,EACZ,IAAI,MAAM,KACT,YAAY,GAAG,SAYjB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,IAAI,QAAQ,EACZ,MAAM,MAAM,KACX,YAAY,GAAG,SAajB,CAAC;AAiFF,eAAO,MAAM,iBAAiB,GAC5B,IAAI,QAAQ,EACZ,UAAU,wBAAwB,KACjC,SAAS,YAAY,EAAsD,CAAC;AAW/E,eAAO,MAAM,kBAAkB,GAAI,IAAI,QAAQ,KAAG,MAKjD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,IAAI,QAAQ,KAAG,MAKnD,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,IAAI,QAAQ,EACZ,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KACjC,MAiBF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,IAAI,QAAQ,EACZ,QAAQ,uBAAuB,KAC9B,YAGF,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,IAAI,QAAQ,EACZ,OAAO;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KACpD,YAAY,GAAG,SAmBjB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,IAAI,QAAQ,EACZ,UAAU,MAAM,KACf,YAAY,GAAG,SAgBjB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,IAAI,QAAQ,EACZ,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KACjC,MAwBF,CAAC"}