@gkorepanov/ccodex 0.4.9 → 0.4.11

package/dist/handoff/lineageStore.js

@@ -0,0 +1,515 @@
+import { chmodSync, copyFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+const SCHEMA_VERSION = 3;
+const LEGACY_SCHEMA_VERSION = 2;
+/**
+ * Minimal cross-provider source of truth.
+ *
+ * Provider-owned Thread, Turn and settings payloads deliberately have no column
+ * in this schema. Provider segments retain only the boundary IDs needed to read
+ * and slice the native provider transcript. Full JSON is accepted only for
+ * CCodex-owned synthetic turns. In-flight provider switches live in the
+ * operational journal, which is cleared when the transaction settles.
+ */
+export class LineageStore {
+    path;
+    database;
+    constructor(path) {
+        this.path = path;
+        mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+        this.database = new DatabaseSync(path);
+        this.database.exec(`
+      PRAGMA journal_mode=WAL;
+      PRAGMA synchronous=FULL;
+      PRAGMA busy_timeout=5000;
+      PRAGMA foreign_keys=ON;
+    `);
+        chmodSync(path, 0o600);
+        if (this.needsLegacyMigration())
+            return;
+        const version = this.userVersion();
+        this.createSchema();
+        if (version < 3)
+            this.migrateCatalogIdentities();
+        if (this.userVersion() < SCHEMA_VERSION)
+            this.database.exec(`PRAGMA user_version = ${SCHEMA_VERSION}`);
+    }
+    close() { this.database.close(); }
+    createTask(identity, epoch) {
+        return this.transaction(() => {
+            this.database.prepare(`
+        INSERT INTO lineage_tasks (
+          public_thread_id, current_epoch_id, revision, session_id, created_at, forked_from_id, parent_thread_id
+        ) VALUES (?, ?, 1, ?, ?, ?, ?)
+      `).run(identity.publicThreadId, identity.currentEpochId, identity.parentThreadId ? identity.sessionId : identity.publicThreadId, identity.createdAt, identity.forkedFromId ?? null, identity.parentThreadId ?? null);
+            this.database.prepare(`
+        INSERT INTO lineage_epochs (
+          epoch_id, public_thread_id, ordinal, provider, backend_thread_id, state,
+          archive_pending, delete_done
+        ) VALUES (?, ?, 0, ?, ?, ?, 0, 0)
+      `).run(epoch.epochId, identity.publicThreadId, epoch.provider, epoch.backendThreadId, epoch.state ?? "current");
+            return this.getTask(identity.publicThreadId);
+        });
+    }
+    getTask(publicThreadId) {
+        const row = this.database.prepare(`
+      SELECT * FROM lineage_tasks WHERE public_thread_id = ?
+    `).get(publicThreadId);
+        return row ? this.taskFromRow(row) : undefined;
+    }
+    listTasks() {
+        return this.database.prepare(`
+      SELECT * FROM lineage_tasks ORDER BY public_thread_id ASC
+    `).all().map((row) => this.taskFromRow(row));
+    }
+    getEpoch(epochId) {
+        const row = this.database.prepare(`
+      SELECT * FROM lineage_epochs WHERE epoch_id = ?
+    `).get(epochId);
+        return row ? this.epochFromRow(row) : undefined;
+    }
+    listMappings() {
+        return this.database.prepare(`
+      SELECT * FROM lineage_epochs ORDER BY public_thread_id ASC, ordinal ASC
+    `).all().map((row) => this.epochFromRow(row));
+    }
+    listEpochs(publicThreadId) {
+        return this.database.prepare(`
+      SELECT * FROM lineage_epochs WHERE public_thread_id = ? ORDER BY ordinal ASC
+    `).all(publicThreadId).map((row) => this.epochFromRow(row));
+    }
+    findEpoch(provider, backendThreadId) {
+        const row = this.database.prepare(`
+      SELECT * FROM lineage_epochs WHERE provider = ? AND backend_thread_id = ?
+    `).get(provider, backendThreadId);
+        return row ? this.epochFromRow(row) : undefined;
+    }
+    pendingStockArchives() {
+        return this.listMappings().filter((epoch) => epoch.provider === "stock" && epoch.archivePending);
+    }
+    markStockArchived(epochId) {
+        return Number(this.database.prepare(`
+      UPDATE lineage_epochs SET archive_pending = 0 WHERE epoch_id = ? AND provider = 'stock'
+    `).run(epochId).changes) === 1;
+    }
+    markEpochDeleted(epochId) {
+        return Number(this.database.prepare(`
+      UPDATE lineage_epochs SET delete_done = 1 WHERE epoch_id = ?
+    `).run(epochId).changes) === 1;
+    }
+    epochBelongsToLineage(publicThreadId, epochId) {
+        return this.database.prepare(`
+      SELECT 1 FROM lineage_epochs WHERE epoch_id = ? AND public_thread_id = ?
+      UNION ALL
+      SELECT 1 FROM lineage_segments WHERE public_thread_id = ? AND epoch_id = ?
+      LIMIT 1
+    `).get(epochId, publicThreadId, publicThreadId, epochId) !== undefined;
+    }
+    epochReferenceCount(epochId) {
+        const current = this.database.prepare(`
+      SELECT COUNT(*) AS count FROM lineage_tasks WHERE current_epoch_id = ?
+    `).get(epochId).count;
+        const segments = this.database.prepare(`
+      SELECT COUNT(DISTINCT public_thread_id) AS count FROM lineage_segments WHERE epoch_id = ?
+    `).get(epochId).count;
+        return current + segments;
+    }
+    taskEpochs(publicThreadId) {
+        return this.database.prepare(`
+      SELECT DISTINCT epoch.* FROM lineage_epochs epoch
+      LEFT JOIN lineage_segments segment ON segment.epoch_id = epoch.epoch_id
+      WHERE epoch.public_thread_id = ? OR segment.public_thread_id = ?
+      ORDER BY epoch.public_thread_id ASC, epoch.ordinal ASC
+    `).all(publicThreadId, publicThreadId)
+            .map((row) => this.epochFromRow(row));
+    }
+    deleteTask(publicThreadId) {
+        return this.transaction(() => {
+            const deleted = Number(this.database.prepare(`
+        DELETE FROM lineage_tasks WHERE public_thread_id = ?
+      `).run(publicThreadId).changes) === 1;
+            if (!deleted)
+                return false;
+            this.database.prepare(`
+        DELETE FROM lineage_epochs
+        WHERE delete_done = 1
+          AND epoch_id NOT IN (SELECT current_epoch_id FROM lineage_tasks)
+          AND epoch_id NOT IN (SELECT epoch_id FROM lineage_segments WHERE epoch_id IS NOT NULL)
+      `).run();
+            return true;
+        });
+    }
+    createForkTask(identity, epoch, inheritedSegments) {
+        return this.transaction(() => {
+            this.database.prepare(`
+        INSERT INTO lineage_tasks (
+          public_thread_id, current_epoch_id, revision, session_id, created_at, forked_from_id, parent_thread_id
+        ) VALUES (?, ?, 1, ?, ?, ?, ?)
+      `).run(identity.publicThreadId, identity.currentEpochId, identity.parentThreadId ? identity.sessionId : identity.publicThreadId, identity.createdAt, identity.forkedFromId ?? null, identity.parentThreadId ?? null);
+            this.database.prepare(`
+        INSERT INTO lineage_epochs (
+          epoch_id, public_thread_id, ordinal, provider, backend_thread_id, state,
+          archive_pending, delete_done
+        ) VALUES (?, ?, 0, ?, ?, ?, 0, 0)
+      `).run(epoch.epochId, identity.publicThreadId, epoch.provider, epoch.backendThreadId, epoch.state ?? "current");
+            inheritedSegments.forEach((segment, position) => this.insertSegment(identity.publicThreadId, position, segment));
+            return this.getTask(identity.publicThreadId);
+        });
+    }
+    listSegments(publicThreadId) {
+        return this.database.prepare(`
+      SELECT * FROM lineage_segments WHERE public_thread_id = ? ORDER BY position ASC
+    `).all(publicThreadId).map((row) => row.kind === "provider" ? {
+            kind: "provider",
+            position: row.position,
+            epochId: row.epoch_id,
+            startTurnId: row.start_turn_id,
+            endTurnId: row.end_turn_id,
+        } : {
+            kind: "synthetic",
+            position: row.position,
+            publicTurnId: row.public_turn_id,
+            turn: JSON.parse(row.synthetic_turn_json),
+        });
+    }
+    replaceSegments(publicThreadId, expectedRevision, segments) {
+        return this.transaction(() => {
+            const task = this.getTask(publicThreadId);
+            if (!task || task.revision !== expectedRevision)
+                return false;
+            this.database.prepare("DELETE FROM lineage_segments WHERE public_thread_id = ?").run(publicThreadId);
+            segments.forEach((segment, position) => this.insertSegment(publicThreadId, position, segment));
+            return Number(this.database.prepare(`
+        UPDATE lineage_tasks SET revision = revision + 1
+        WHERE public_thread_id = ? AND revision = ?
+      `).run(publicThreadId, expectedRevision).changes) === 1;
+        });
+    }
+    commitEpoch(publicThreadId, expectedEpochId, expectedRevision, sourceBoundary, target, syntheticTurns = []) {
+        return this.transaction(() => {
+            const task = this.getTask(publicThreadId);
+            if (!task || task.currentEpochId !== expectedEpochId || task.revision !== expectedRevision)
+                return undefined;
+            const ordinal = this.database.prepare(`
+        SELECT COALESCE(MAX(ordinal), -1) + 1 AS ordinal
+        FROM lineage_epochs WHERE public_thread_id = ?
+      `).get(publicThreadId).ordinal;
+            const sealed = this.database.prepare(`
+        UPDATE lineage_epochs SET state = 'sealed', start_turn_id = ?, end_turn_id = ?,
+          archive_pending = CASE WHEN provider = 'stock' THEN 1 ELSE 0 END
+        WHERE epoch_id = ? AND public_thread_id = ? AND state = 'current'
+      `).run(sourceBoundary.startTurnId, sourceBoundary.endTurnId, expectedEpochId, publicThreadId);
+            if (Number(sealed.changes) !== 1)
+                return undefined;
+            this.database.prepare(`
+        INSERT INTO lineage_epochs (
+          epoch_id, public_thread_id, ordinal, provider, backend_thread_id, state,
+          archive_pending, delete_done
+        ) VALUES (?, ?, ?, ?, ?, 'current', 0, 0)
+      `).run(target.epochId, publicThreadId, ordinal, target.provider, target.backendThreadId);
+            const nextPosition = this.database.prepare(`
+        SELECT COALESCE(MAX(position), -1) + 1 AS position
+        FROM lineage_segments WHERE public_thread_id = ?
+      `).get(publicThreadId).position;
+            this.insertSegment(publicThreadId, nextPosition, {
+                kind: "provider",
+                epochId: expectedEpochId,
+                startTurnId: sourceBoundary.startTurnId,
+                endTurnId: sourceBoundary.endTurnId,
+            });
+            syntheticTurns.forEach((synthetic, index) => this.insertSegment(publicThreadId, nextPosition + index + 1, {
+                kind: "synthetic",
+                publicTurnId: synthetic.publicTurnId,
+                turn: synthetic.turn,
+            }));
+            const updated = this.database.prepare(`
+        UPDATE lineage_tasks SET current_epoch_id = ?, revision = revision + 1
+        WHERE public_thread_id = ? AND current_epoch_id = ? AND revision = ?
+      `).run(target.epochId, publicThreadId, expectedEpochId, expectedRevision);
+            if (Number(updated.changes) !== 1)
+                throw new Error("Epoch commit lost its task CAS.");
+            return this.getTask(publicThreadId);
+        });
+    }
+    commitRollback(publicThreadId, expectedEpochId, expectedRevision, target, retainedSegments) {
+        return this.transaction(() => {
+            const task = this.getTask(publicThreadId);
+            if (!task || task.currentEpochId !== expectedEpochId || task.revision !== expectedRevision)
+                return undefined;
+            const sourceBoundary = [...retainedSegments].reverse().find((segment) => segment.kind === "provider" && segment.epochId === expectedEpochId);
+            const sealed = this.database.prepare(`
+        UPDATE lineage_epochs SET state = 'sealed',
+          start_turn_id = COALESCE(?, start_turn_id), end_turn_id = COALESCE(?, end_turn_id),
+          archive_pending = CASE WHEN provider = 'stock' THEN 1 ELSE archive_pending END
+        WHERE epoch_id = ? AND public_thread_id = ? AND state = 'current'
+      `).run(sourceBoundary?.startTurnId ?? null, sourceBoundary?.endTurnId ?? null, expectedEpochId, publicThreadId);
+            if (Number(sealed.changes) !== 1)
+                return undefined;
+            const ordinal = this.database.prepare(`
+        SELECT COALESCE(MAX(ordinal), -1) + 1 AS ordinal
+        FROM lineage_epochs WHERE public_thread_id = ?
+      `).get(publicThreadId).ordinal;
+            this.database.prepare(`
+        INSERT INTO lineage_epochs (
+          epoch_id, public_thread_id, ordinal, provider, backend_thread_id, state,
+          archive_pending, delete_done
+        ) VALUES (?, ?, ?, ?, ?, 'current', 0, 0)
+      `).run(target.epochId, publicThreadId, ordinal, target.provider, target.backendThreadId);
+            this.database.prepare("DELETE FROM lineage_segments WHERE public_thread_id = ?").run(publicThreadId);
+            retainedSegments.forEach((segment, position) => this.insertSegment(publicThreadId, position, segment));
+            const updated = this.database.prepare(`
+        UPDATE lineage_tasks SET current_epoch_id = ?, revision = revision + 1
+        WHERE public_thread_id = ? AND current_epoch_id = ? AND revision = ?
+      `).run(target.epochId, publicThreadId, expectedEpochId, expectedRevision);
+            if (Number(updated.changes) !== 1)
+                throw new Error("Rollback commit lost its task CAS.");
+            return this.getTask(publicThreadId);
+        });
+    }
+    needsLegacyMigration() {
+        return this.userVersion() < LEGACY_SCHEMA_VERSION && this.hasTable("logical_threads");
+    }
+    legacyBackendRefs() {
+        if (!this.needsLegacyMigration() || !this.hasTable("provider_epochs"))
+            return [];
+        return this.database.prepare(`
+      SELECT DISTINCT provider, backend_thread_id FROM provider_epochs
+      WHERE delete_done = 0 AND backend_thread_id NOT LIKE 'ccodex-provisional:%'
+      ORDER BY provider, backend_thread_id
+    `).all().map((row) => ({
+            provider: row.provider,
+            backendThreadId: row.backend_thread_id,
+        }));
+    }
+    finalizeLegacyMigration(validated, backupPath = `${this.path}.pre-lineage-v2.bak`) {
+        if (!this.needsLegacyMigration())
+            return;
+        const missing = this.legacyBackendRefs().filter((ref) => !validated.has(`${ref.provider}:${ref.backendThreadId}`));
+        if (missing.length > 0) {
+            throw new Error(`Lineage migration requires validated provider backends: ${missing.map((ref) => `${ref.provider}:${ref.backendThreadId}`).join(", ")}`);
+        }
+        this.database.exec("PRAGMA wal_checkpoint(TRUNCATE)");
+        if (!existsSync(backupPath))
+            copyFileSync(this.path, backupPath, 0);
+        this.transaction(() => {
+            this.createSchema();
+            if (this.hasTable("logical_threads"))
+                this.importLegacyLineage();
+            this.scrubLegacySnapshots();
+            this.database.exec(`PRAGMA user_version = ${SCHEMA_VERSION}`);
+        });
+        chmodSync(this.path, 0o600);
+        chmodSync(backupPath, 0o600);
+    }
+    createSchema() {
+        this.database.exec(`
+      CREATE TABLE IF NOT EXISTS lineage_tasks (
+        public_thread_id TEXT PRIMARY KEY,
+        current_epoch_id TEXT NOT NULL,
+        revision INTEGER NOT NULL,
+        session_id TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        forked_from_id TEXT,
+        parent_thread_id TEXT
+      );
+      CREATE TABLE IF NOT EXISTS lineage_epochs (
+        epoch_id TEXT PRIMARY KEY,
+        public_thread_id TEXT NOT NULL,
+        ordinal INTEGER NOT NULL,
+        provider TEXT NOT NULL CHECK(provider IN ('claude', 'stock')),
+        backend_thread_id TEXT NOT NULL,
+        state TEXT NOT NULL CHECK(state IN ('current', 'sealed', 'provisional')),
+        start_turn_id TEXT,
+        end_turn_id TEXT,
+        archive_pending INTEGER NOT NULL DEFAULT 0,
+        delete_done INTEGER NOT NULL DEFAULT 0,
+        UNIQUE(public_thread_id, ordinal),
+        UNIQUE(provider, backend_thread_id)
+      );
+      CREATE UNIQUE INDEX IF NOT EXISTS lineage_epochs_one_current
+        ON lineage_epochs(public_thread_id) WHERE state = 'current';
+      CREATE TABLE IF NOT EXISTS lineage_segments (
+        public_thread_id TEXT NOT NULL REFERENCES lineage_tasks(public_thread_id) ON DELETE CASCADE,
+        position INTEGER NOT NULL,
+        kind TEXT NOT NULL CHECK(kind IN ('provider', 'synthetic')),
+        epoch_id TEXT REFERENCES lineage_epochs(epoch_id),
+        start_turn_id TEXT,
+        end_turn_id TEXT,
+        public_turn_id TEXT,
+        synthetic_turn_json TEXT,
+        PRIMARY KEY(public_thread_id, position),
+        CHECK((kind = 'provider' AND epoch_id IS NOT NULL AND start_turn_id IS NOT NULL
+          AND end_turn_id IS NOT NULL AND public_turn_id IS NULL AND synthetic_turn_json IS NULL)
+          OR (kind = 'synthetic' AND epoch_id IS NULL AND start_turn_id IS NULL
+          AND end_turn_id IS NULL AND public_turn_id IS NOT NULL AND synthetic_turn_json IS NOT NULL))
+      );
+      DROP TABLE IF EXISTS lineage_switch_jobs;
+    `);
+    }
+    importLegacyLineage() {
+        const threads = this.database.prepare("SELECT * FROM logical_threads")
+            .all();
+        for (const row of threads) {
+            const thread = JSON.parse(row.thread_json);
+            this.database.prepare(`
+        INSERT OR IGNORE INTO lineage_tasks (
+          public_thread_id, current_epoch_id, revision, session_id, created_at, forked_from_id, parent_thread_id
+        ) VALUES (?, ?, ?, ?, ?, ?, ?)
+      `).run(row.public_thread_id, row.current_epoch_id, row.revision, thread.parentThreadId ? thread.sessionId || row.public_thread_id : row.public_thread_id, thread.createdAt, thread.forkedFromId, thread.parentThreadId);
+        }
+        if (!this.hasTable("provider_epochs"))
+            return;
+        const epochs = this.database.prepare("SELECT * FROM provider_epochs ORDER BY public_thread_id, ordinal")
+            .all();
+        for (const row of epochs) {
+            this.database.prepare(`
+        INSERT OR IGNORE INTO lineage_epochs (
+          epoch_id, public_thread_id, ordinal, provider, backend_thread_id, state,
+          archive_pending, delete_done
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(row.epoch_id, row.public_thread_id, row.ordinal, row.provider, row.backend_thread_id, row.state, row.archive_pending ?? 0, row.delete_done ?? 0);
+        }
+        if (!this.hasTable("logical_turns"))
+            return;
+        const turns = this.database.prepare("SELECT * FROM logical_turns ORDER BY public_thread_id, position")
+            .all();
+        for (const publicThreadId of new Set(turns.map((row) => row.public_thread_id))) {
+            const currentEpochId = this.getTask(publicThreadId).currentEpochId;
+            this.importLegacyTurns(publicThreadId, currentEpochId, turns.filter((row) => row.public_thread_id === publicThreadId));
+        }
+    }
+    migrateCatalogIdentities() {
+        this.transaction(() => {
+            this.database.prepare(`
+        UPDATE lineage_tasks SET session_id = public_thread_id
+        WHERE parent_thread_id IS NULL AND session_id != public_thread_id
+      `).run();
+            this.database.exec("PRAGMA user_version = 3");
+        });
+    }
+    importLegacyTurns(publicThreadId, currentEpochId, turns) {
+        let position = 0;
+        let providerRun;
+        const flush = () => {
+            if (!providerRun)
+                return;
+            this.insertSegment(publicThreadId, position++, {
+                kind: "provider",
+                epochId: providerRun.epochId,
+                startTurnId: providerRun.startTurnId,
+                endTurnId: providerRun.endTurnId,
+            });
+            this.database.prepare(`
+        UPDATE lineage_epochs SET
+          start_turn_id = COALESCE(start_turn_id, ?), end_turn_id = ?
+        WHERE epoch_id = ?
+      `).run(providerRun.startTurnId, providerRun.endTurnId, providerRun.epochId);
+            providerRun = undefined;
+        };
+        for (const row of turns) {
+            if (row.kind === "provider" && row.epoch_id && row.provider_turn_id) {
+                if (row.epoch_id === currentEpochId) {
+                    flush();
+                    continue;
+                }
+                if (providerRun?.epochId === row.epoch_id)
+                    providerRun.endTurnId = row.provider_turn_id;
+                else {
+                    flush();
+                    providerRun = {
+                        epochId: row.epoch_id,
+                        startTurnId: row.provider_turn_id,
+                        endTurnId: row.provider_turn_id,
+                    };
+                }
+                continue;
+            }
+            flush();
+            this.insertSegment(publicThreadId, position++, {
+                kind: "synthetic",
+                publicTurnId: row.public_turn_id,
+                turn: JSON.parse(row.turn_json),
+            });
+        }
+        flush();
+    }
+    scrubLegacySnapshots() {
+        if (this.hasTable("logical_threads")) {
+            for (const task of this.database.prepare("SELECT * FROM lineage_tasks").all()) {
+                this.database.prepare(`
+          UPDATE logical_threads SET thread_json = ? WHERE public_thread_id = ?
+        `).run(JSON.stringify({
+                    id: task.public_thread_id,
+                    sessionId: task.session_id,
+                    createdAt: task.created_at,
+                    forkedFromId: task.forked_from_id,
+                    parentThreadId: task.parent_thread_id,
+                }), task.public_thread_id);
+            }
+        }
+        if (this.hasTable("provider_epochs")) {
+            this.database.prepare("UPDATE provider_epochs SET model = '', settings_json = '{}'").run();
+        }
+        if (this.hasTable("logical_turns")) {
+            this.database.prepare("UPDATE logical_turns SET turn_json = '{}' WHERE kind = 'provider'").run();
+        }
+        if (this.hasTable("provider_switch_jobs")) {
+            this.database.prepare("DELETE FROM provider_switch_jobs").run();
+        }
+    }
+    insertSegment(publicThreadId, position, segment) {
+        this.database.prepare(`
+      INSERT INTO lineage_segments (
+        public_thread_id, position, kind, epoch_id, start_turn_id, end_turn_id,
+        public_turn_id, synthetic_turn_json
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(publicThreadId, position, segment.kind, segment.kind === "provider" ? segment.epochId : null, segment.kind === "provider" ? segment.startTurnId : null, segment.kind === "provider" ? segment.endTurnId : null, segment.kind === "synthetic" ? segment.publicTurnId : null, segment.kind === "synthetic" ? JSON.stringify(segment.turn) : null);
+    }
+    taskFromRow(row) {
+        return {
+            publicThreadId: row.public_thread_id,
+            currentEpochId: row.current_epoch_id,
+            revision: row.revision,
+            sessionId: row.session_id,
+            createdAt: row.created_at,
+            ...(row.forked_from_id ? { forkedFromId: row.forked_from_id } : {}),
+            ...(row.parent_thread_id ? { parentThreadId: row.parent_thread_id } : {}),
+        };
+    }
+    epochFromRow(row) {
+        return {
+            epochId: row.epoch_id,
+            publicThreadId: row.public_thread_id,
+            ordinal: row.ordinal,
+            provider: row.provider,
+            backendThreadId: row.backend_thread_id,
+            state: row.state,
+            ...(row.start_turn_id ? { startTurnId: row.start_turn_id } : {}),
+            ...(row.end_turn_id ? { endTurnId: row.end_turn_id } : {}),
+            archivePending: row.archive_pending === 1,
+            deleteDone: row.delete_done === 1,
+        };
+    }
+    hasTable(name) {
+        return this.database.prepare(`
+      SELECT 1 AS found FROM sqlite_master WHERE type = 'table' AND name = ?
+    `).get(name) !== undefined;
+    }
+    userVersion() {
+        return this.database.prepare("PRAGMA user_version").get().user_version;
+    }
+    transaction(action) {
+        this.database.exec("BEGIN IMMEDIATE");
+        try {
+            const result = action();
+            this.database.exec("COMMIT");
+            return result;
+        }
+        catch (error) {
+            this.database.exec("ROLLBACK");
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=lineageStore.js.map

package/dist/handoff/lineageStore.js.map

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

package/dist/handoff/providerEpochs.d.ts

@@ -1,18 +1,32 @@
 import type { Thread } from "../codex/generated/v2/Thread.js";
 import type { Turn } from "../codex/generated/v2/Turn.js";
-import { HandoffStore, type LogicalThread, type NewLogicalTurn, type ProviderEpoch, type ProviderKind } from "./store.js";
+import { LineageStore, type EpochBoundary, type NewTranscriptSegment, type TranscriptSegment } from "./lineageStore.js";
+import { HandoffStore, type LogicalThread, type ProviderEpoch, type ProviderKind } from "./store.js";
 export interface ResolvedProviderEpoch {
     readonly logical: LogicalThread;
     readonly epoch: ProviderEpoch;
 }
+export interface LegacyProviderSnapshots {
+    readonly threads: ReadonlyMap<string, Thread>;
+    readonly epochs: ReadonlyMap<string, ProviderEpoch>;
+}
+export declare function stockSwitchThreadSource(jobId: string, source: string | null): string;
 export declare class ProviderEpochs {
-    private readonly store;
-    constructor(store: HandoffStore);
+    private readonly lineage;
+    private readonly legacyMirror?;
+    private readonly legacySnapshots?;
+    constructor(lineage: LineageStore, legacyMirror?: HandoffStore | undefined, legacySnapshots?: LegacyProviderSnapshots | undefined);
     resolve(publicThreadId: string): ResolvedProviderEpoch | undefined;
     publicId(provider: ProviderKind, backendThreadId: string): string | undefined;
     hiddenBackendIds(provider?: ProviderKind): Set<string>;
+    mappings(): EpochBoundary[];
+    segments(publicThreadId: string): TranscriptSegment[];
+    epoch(epochId: string): EpochBoundary | undefined;
+    configuredEpoch(epochId: string): ProviderEpoch | undefined;
+    belongs(publicThreadId: string, epochId: string): boolean;
     seed(thread: Thread, provider: ProviderKind, model: string, settings: Record<string, unknown>): ResolvedProviderEpoch;
+    createFork(thread: Thread, backendThreadId: string, provider: ProviderKind, model: string, settings: Record<string, unknown>, inheritedSegments: readonly NewTranscriptSegment[]): ResolvedProviderEpoch;
+    projectThread(publicThreadId: string, backend: Thread, includeTurns: boolean, historicalTurns?: readonly Turn[]): Thread;
+    /** Legacy-test helper; production history is assembled from provider segments. */
     visibleTurns(publicThreadId: string, currentBackendTurns: readonly Turn[]): Turn[];
-    snapshotTurns(publicThreadId: string, currentBackendTurns: readonly Turn[]): NewLogicalTurn[];
-    projectThread(publicThreadId: string, backend: Thread, includeTurns: boolean): Thread;
 }