rivet-design 0.16.2 → 0.17.0

package/dist/services/ProjectLibrary.js

@@ -0,0 +1,261 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectLibrary = exports.currentLibraryRoot = void 0;
+const libraryErrors_1 = require("./libraryErrors");
+const fs_1 = __importDefault(require("fs"));
+const installationChannel_1 = require("../install/installationChannel");
+const path_1 = __importDefault(require("path"));
+const ProjectRegistry_1 = require("./ProjectRegistry");
+const ProjectImport_1 = require("./ProjectImport");
+const BundleMetadataStore_1 = require("../storage/library/BundleMetadataStore");
+const ProjectStorage_1 = require("./ProjectStorage");
+const TreeStore_1 = require("./TreeStore");
+const VariantHistoryService_1 = require("./VariantHistoryService");
+const historyRoots_1 = require("./historyRoots");
+/** Resolves the installation's library root, with explicit isolated roots for automation. */
+const currentLibraryRoot = (env = process.env) => {
+    const channel = (0, installationChannel_1.installationChannel)(env);
+    return env.RIVET_LIBRARY_ROOT
+        ? path_1.default.resolve(env.RIVET_LIBRARY_ROOT)
+        : (0, ProjectRegistry_1.libraryRoot)({ channel });
+};
+exports.currentLibraryRoot = currentLibraryRoot;
+/** Serves project-scoped saved history without starting application runtimes. */
+class ProjectLibrary {
+    registry;
+    owners = new Map();
+    issues = new Map();
+    isClosed = false;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /** Opens the project library independently of any selected workspace. */
+    static async open(root = (0, exports.currentLibraryRoot)()) {
+        return new ProjectLibrary(await ProjectRegistry_1.ProjectRegistry.open(root));
+    }
+    /** Registers an opened project and imports its quiescent supported history. */
+    async prepare(projectPath) {
+        const project = this.registry.register({ projectPath });
+        for (const nested of (0, historyRoots_1.nestedFreshSessionWorkdirs)(project.projectPath))
+            this.registry.attachHistoryRoot({
+                projectId: project.id,
+                projectPath: nested,
+            });
+        let migration;
+        try {
+            migration = await (0, ProjectImport_1.importProject)({
+                registry: this.registry,
+                projectId: project.id,
+            });
+        }
+        catch (error) {
+            // Unimportable saved history never blocks opening the working folder;
+            // the project keeps its project-local storage and reports the failure.
+            migration = {
+                status: 'deferred',
+                reason: error instanceof Error ? error.message : String(error),
+            };
+        }
+        if (project.storageKind !== this.registry.get(project.id).storageKind)
+            await this.invalidate(project.id);
+        if (migration.status === 'diverged' || migration.status === 'deferred')
+            this.issues.set(project.id, migration.reason ??
+                'Preserved source history differs from the imported bundle');
+        return { project: this.registry.get(project.id), migration };
+    }
+    /** Relinks a working folder and refreshes its storage attachment. */
+    async relink(args) {
+        const project = this.registry.relink(args);
+        await this.invalidate(project.id);
+        this.issues.delete(project.id);
+        return project;
+    }
+    /** Closes cached metadata before changing the project's storage attachment. */
+    async invalidate(projectId) {
+        const pending = this.owners.get(projectId);
+        this.owners.delete(projectId);
+        if (!pending)
+            return;
+        const owner = await pending;
+        owner.history.metadata.closeAll();
+        owner.bundle?.close();
+    }
+    /** Lists registered workspaces and known issues without opening saved history. */
+    listProjects() {
+        return this.registry
+            .list()
+            .map((project) => ({ ...project, issue: this.issues.get(project.id) }));
+    }
+    /** Builds the library view from saved history and current workspace availability. */
+    async snapshot() {
+        const variants = await this.listVariants();
+        return {
+            projects: this.listProjects(),
+            variants: variants.map(({ projectId, manifest, hasStaticPreview }) => ({
+                projectId,
+                sessionId: manifest.sessionId,
+                variantId: manifest.variantId,
+                label: manifest.label,
+                brief: manifest.brief,
+                createdAt: manifest.createdAt,
+                hasStaticPreview,
+                hasInteractivePreview: manifest.serve?.kind === 'dev-server',
+            })),
+        };
+    }
+    /** Applies metadata edits through the exact direction's authoritative history owner. */
+    async updateVariant(args) {
+        const found = await this.variant(args);
+        if (!found)
+            throw new libraryErrors_1.LibraryError('variant_not_found', 'Unknown saved direction');
+        const target = { ...args, projectPath: found.projectPath };
+        if (args.label !== undefined)
+            await found.history.renameVariant({ ...target, label: args.label });
+        if (args.status)
+            await found.history.markStatus({ ...target, status: args.status });
+    }
+    /** Verifies the selected project and saved direction before delivering navigation. */
+    async assertNavigationTarget(target) {
+        if (target.projectId)
+            this.registry.get(target.projectId);
+        if (target.projectId &&
+            target.sessionId &&
+            target.variantId &&
+            !(await this.variant({
+                projectId: target.projectId,
+                sessionId: target.sessionId,
+                variantId: target.variantId,
+            })))
+            throw new libraryErrors_1.LibraryError('variant_not_found', 'Unknown saved direction');
+    }
+    /** Returns one shared history service for a project's persisted storage owner. */
+    async history(projectId) {
+        return (await this.owner(projectId)).history;
+    }
+    /** Registers a generated directory with the same history owner before generation writes. */
+    async attachGeneratedRoot({ projectId, projectPath, }) {
+        fs_1.default.mkdirSync(projectPath, { recursive: true });
+        this.registry.attachHistoryRoot({ projectId, projectPath });
+        const owner = await this.owner(projectId);
+        if (!owner.bundle)
+            return;
+        const dataDirectory = this.registry.bundleDirectory(projectId);
+        for (const root of new Set([
+            path_1.default.resolve(projectPath),
+            fs_1.default.realpathSync(projectPath),
+        ])) {
+            owner.storage.attach({
+                projectPath: root,
+                dataDirectory,
+                cacheDirectory: path_1.default.join(this.registry.root, 'cache', projectId),
+            });
+        }
+    }
+    /** Lists one project's directions, including preserved generated history roots. */
+    async listProject(projectId) {
+        const project = this.registry.get(projectId);
+        if (!project.isAvailable && project.storageKind === 'project')
+            throw new Error('Working folder and project-local history are unavailable');
+        const history = await this.history(projectId);
+        const roots = project.storageKind === 'bundle'
+            ? [project.projectPath]
+            : this.registry.historyRoots(projectId);
+        const entries = (await Promise.all(roots.map(async (projectPath) => (await history.listVariantsFromIndex({ projectPath })).map((entry) => ({ ...entry, projectId, projectPath }))))).flat();
+        const unique = new Map();
+        for (const entry of entries) {
+            if (entry.manifest.status === 'removed' ||
+                entry.manifest.status === 'cancelled')
+                continue;
+            const key = `${entry.manifest.sessionId}:${entry.manifest.variantId}`;
+            const existing = unique.get(key);
+            if (existing &&
+                JSON.stringify(existing.manifest) !== JSON.stringify(entry.manifest))
+                throw new Error('Conflicting history identities across attached roots');
+            unique.set(key, entry);
+        }
+        return [...unique.values()];
+    }
+    /** Aggregates readable projects while retaining individual project availability errors. */
+    async listVariants(projectId) {
+        if (projectId)
+            return this.listProject(projectId);
+        const projects = this.registry.list();
+        const results = await Promise.allSettled(projects.map((project) => this.listProject(project.id)));
+        return results
+            .flatMap((result, index) => {
+            if (result.status === 'fulfilled')
+                return result.value;
+            this.issues.set(projects[index].id, result.reason instanceof Error
+                ? result.reason.message
+                : String(result.reason));
+            return [];
+        })
+            .sort((a, b) => b.manifest.createdAt.localeCompare(a.manifest.createdAt));
+    }
+    /** Resolves an exact reference together with the filesystem root that owns it. */
+    async variant(reference) {
+        const project = this.registry.get(reference.projectId);
+        const history = await this.history(project.id);
+        const roots = project.storageKind === 'bundle'
+            ? [project.projectPath]
+            : this.registry.historyRoots(project.id);
+        for (const projectPath of roots) {
+            const detail = await history.getVariant({ ...reference, projectPath });
+            if (detail)
+                return { detail, projectPath, history };
+        }
+        return null;
+    }
+    /** Releases metadata connections; running project processes have separate lifetimes. */
+    close() {
+        if (this.isClosed)
+            return;
+        this.isClosed = true;
+        for (const owner of this.owners.values())
+            void owner.then((value) => {
+                value.history.metadata.closeAll();
+                value.bundle?.close();
+            }, () => undefined);
+        this.registry.close();
+    }
+    /** Initializes one storage owner and shares it across concurrent library reads. */
+    owner(projectId) {
+        const existing = this.owners.get(projectId);
+        if (existing)
+            return existing;
+        const pending = this.createOwner(projectId);
+        this.owners.set(projectId, pending);
+        void pending.catch(() => this.owners.delete(projectId));
+        return pending;
+    }
+    /** Attaches bundle metadata only when its registry activation is committed. */
+    async createOwner(projectId) {
+        const project = this.registry.get(projectId);
+        const storage = new ProjectStorage_1.ProjectStorage();
+        let bundle;
+        if (project.storageKind === 'bundle') {
+            const dataDirectory = this.registry.bundleDirectory(projectId);
+            if (!fs_1.default.existsSync(path_1.default.join(dataDirectory, 'metadata.sqlite')))
+                throw new Error('The saved project database is missing');
+            const roots = this.registry.historyRoots(projectId);
+            bundle = await BundleMetadataStore_1.BundleMetadataStore.open({
+                directory: dataDirectory,
+                project,
+            });
+            for (const projectPath of roots) {
+                storage.attach({
+                    projectPath,
+                    dataDirectory,
+                    cacheDirectory: path_1.default.join(this.registry.root, 'cache', projectId),
+                });
+            }
+        }
+        const history = new VariantHistoryService_1.VariantHistoryService(new TreeStore_1.TreeStore(storage), undefined, { bundle });
+        return { history, storage, bundle };
+    }
+}
+exports.ProjectLibrary = ProjectLibrary;
+//# sourceMappingURL=ProjectLibrary.js.map

package/dist/services/ProjectLibrary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectLibrary.js","sourceRoot":"","sources":["../../src/services/ProjectLibrary.ts"],"names":[],"mappings":";;;;;;AAKA,mDAA+C;AAC/C,4CAAoB;AACpB,wEAAqE;AACrE,gDAAwB;AACxB,uDAI2B;AAC3B,mDAA0E;AAC1E,gFAA6E;AAC7E,qDAAkD;AAClD,2CAAwC;AACxC,mEAIiC;AACjC,iDAA4D;AAiB5D,6FAA6F;AACtF,MAAM,kBAAkB,GAAG,CAChC,MAAyB,OAAO,CAAC,GAAG,EAC5B,EAAE;IACV,MAAM,OAAO,GAAG,IAAA,yCAAmB,EAAC,GAAG,CAAC,CAAC;IACzC,OAAO,GAAG,CAAC,kBAAkB;QAC3B,CAAC,CAAC,cAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QACtC,CAAC,CAAC,IAAA,6BAAW,EAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAC/B,CAAC,CAAC;AAPW,QAAA,kBAAkB,sBAO7B;AAEF,iFAAiF;AACjF,MAAa,cAAc;IAII;IAHZ,MAAM,GAAG,IAAI,GAAG,EAAiC,CAAC;IAC1D,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpC,QAAQ,GAAG,KAAK,CAAC;IACzB,YAA6B,QAAyB;QAAzB,aAAQ,GAAR,QAAQ,CAAiB;IAAG,CAAC;IAE1D,yEAAyE;IACzE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,IAAA,0BAAkB,GAAE;QAC3C,OAAO,IAAI,cAAc,CAAC,MAAM,iCAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,OAAO,CACX,WAAmB;QAEnB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QACxD,KAAK,MAAM,MAAM,IAAI,IAAA,yCAA0B,EAAC,OAAO,CAAC,WAAW,CAAC;YAClE,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;gBAC9B,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,WAAW,EAAE,MAAM;aACpB,CAAC,CAAC;QACL,IAAI,SAA8B,CAAC;QACnC,IAAI,CAAC;YACH,SAAS,GAAG,MAAM,IAAA,6BAAa,EAAC;gBAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,SAAS,EAAE,OAAO,CAAC,EAAE;aACtB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sEAAsE;YACtE,uEAAuE;YACvE,SAAS,GAAG;gBACV,MAAM,EAAE,UAAU;gBAClB,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC/D,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW;YACnE,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,SAAS,CAAC,MAAM,KAAK,UAAU,IAAI,SAAS,CAAC,MAAM,KAAK,UAAU;YACpE,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,OAAO,CAAC,EAAE,EACV,SAAS,CAAC,MAAM;gBACd,2DAA2D,CAC9D,CAAC;QACJ,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC;IAC/D,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,MAAM,CAAC,IAGZ;QACC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,+EAA+E;IACvE,KAAK,CAAC,UAAU,CAAC,SAAiB;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9B,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC;QAC5B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAClC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,kFAAkF;IAClF,YAAY;QACV,OAAO,IAAI,CAAC,QAAQ;aACjB,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,QAAQ;QACZ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC3C,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE;YAC7B,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC,CAAC;gBACrE,SAAS;gBACT,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,gBAAgB;gBAChB,qBAAqB,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,KAAK,YAAY;aAC7D,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED,wFAAwF;IACxF,KAAK,CAAC,aAAa,CACjB,IAA+D;QAE/D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YACR,MAAM,IAAI,4BAAY,CAAC,mBAAmB,EAAE,yBAAyB,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;QAC3D,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAC1B,MAAM,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACtE,IAAI,IAAI,CAAC,MAAM;YACb,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,sFAAsF;IACtF,KAAK,CAAC,sBAAsB,CAAC,MAA2B;QACtD,IAAI,MAAM,CAAC,SAAS;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC1D,IACE,MAAM,CAAC,SAAS;YAChB,MAAM,CAAC,SAAS;YAChB,MAAM,CAAC,SAAS;YAChB,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC;gBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;YAEH,MAAM,IAAI,4BAAY,CAAC,mBAAmB,EAAE,yBAAyB,CAAC,CAAC;IAC3E,CAAC;IAED,kFAAkF;IAClF,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/C,CAAC;IAED,4FAA4F;IAC5F,KAAK,CAAC,mBAAmB,CAAC,EACxB,SAAS,EACT,WAAW,GAIZ;QACC,YAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO;QAC1B,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAC/D,KAAK,MAAM,IAAI,IAAI,IAAI,GAAG,CAAC;YACzB,cAAI,CAAC,OAAO,CAAC,WAAW,CAAC;YACzB,YAAE,CAAC,YAAY,CAAC,WAAW,CAAC;SAC7B,CAAC,EAAE,CAAC;YACH,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBACnB,WAAW,EAAE,IAAI;gBACjB,aAAa;gBACb,cAAc,EAAE,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC;aAClE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,mFAAmF;IAC3E,KAAK,CAAC,WAAW,CAAC,SAAiB;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;YAC3D,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;QACJ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,KAAK,GACT,OAAO,CAAC,WAAW,KAAK,QAAQ;YAC9B,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;YACvB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,CACd,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAC9B,CAAC,MAAM,OAAO,CAAC,qBAAqB,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CACxD,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAClD,CACF,CACF,CACF,CAAC,IAAI,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;QACjD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IACE,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS;gBACnC,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,WAAW;gBAErC,SAAS;YACX,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YACtE,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACjC,IACE,QAAQ;gBACR,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAEpE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;YAC1E,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,2FAA2F;IAC3F,KAAK,CAAC,YAAY,CAAC,SAAkB;QACnC,IAAI,SAAS;YAAE,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CACxD,CAAC;QACF,OAAO,OAAO;aACX,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YACzB,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;gBAAE,OAAO,MAAM,CAAC,KAAK,CAAC;YACvD,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAClB,MAAM,CAAC,MAAM,YAAY,KAAK;gBAC5B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO;gBACvB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAC1B,CAAC;YACF,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,kFAAkF;IAClF,KAAK,CAAC,OAAO,CAAC,SAA2B;QAKvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,KAAK,GACT,OAAO,CAAC,WAAW,KAAK,QAAQ;YAC9B,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;YACvB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7C,KAAK,MAAM,WAAW,IAAI,KAAK,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,GAAG,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;YACvE,IAAI,MAAM;gBAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wFAAwF;IACxF,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YACtC,KAAK,KAAK,CAAC,IAAI,CACb,CAAC,KAAK,EAAE,EAAE;gBACR,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBAClC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;YACxB,CAAC,EACD,GAAG,EAAE,CAAC,SAAS,CAChB,CAAC;QACJ,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,mFAAmF;IAC3E,KAAK,CAAC,SAAiB;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACpC,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,+EAA+E;IACvE,KAAK,CAAC,WAAW,CAAC,SAAiB;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,+BAAc,EAAE,CAAC;QACrC,IAAI,MAAuC,CAAC;QAC5C,IAAI,OAAO,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAC/D,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC;gBAC7D,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;YAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YACpD,MAAM,GAAG,MAAM,yCAAmB,CAAC,IAAI,CAAC;gBACtC,SAAS,EAAE,aAAa;gBACxB,OAAO;aACR,CAAC,CAAC;YACH,KAAK,MAAM,WAAW,IAAI,KAAK,EAAE,CAAC;gBAChC,OAAO,CAAC,MAAM,CAAC;oBACb,WAAW;oBACX,aAAa;oBACb,cAAc,EAAE,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC;iBAClE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,6CAAqB,CACvC,IAAI,qBAAS,CAAC,OAAO,CAAC,EACtB,SAAS,EACT,EAAE,MAAM,EAAE,CACX,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;CACF;AA9RD,wCA8RC"}

package/dist/services/ProjectMetadataStore.d.ts

@@ -1,16 +1,7 @@
-import type { VariantHistoryManifest, VariantHistoryStatus } from './VariantHistoryService';
-import { type ProjectMetadataMigration } from './projectMetadataMigrations';
-/** A variant row as stored in (or destined for) the projection. `manifest`
- *  reproduces the on-disk manifest exactly; `hasStaticPreview` is the listing
- *  affordance captured when the row was projected. */
-export interface VariantIndexEntry {
-    manifest: VariantHistoryManifest;
-    hasStaticPreview: boolean;
-}
-export interface VariantIndexEntryInput extends VariantIndexEntry {
-    /** The manifest file's mtime when projected — freshness-audit metadata. */
-    manifestMtimeMs: number;
-}
+import { ProjectStorage } from './ProjectStorage';
+import type { VariantHistoryManifest, VariantHistoryStatus, VariantIndexEntry, VariantIndexEntryInput } from '../types/variant-history';
+export type { VariantIndexEntry, VariantIndexEntryInput, } from '../types/variant-history';
+import { type ProjectMetadataMigration } from '../storage/project-metadata/migrations';
 /**
  * Embedded SQLite metadata projection at `<project>/.rivet/rivet.db`.
  *
@@ -25,6 +16,7 @@ export interface VariantIndexEntryInput extends VariantIndexEntry {
  * timeout for cross-process access.
  */
 export declare class ProjectMetadataStore {
+    private readonly storage;
     private readonly handles;
     /** Projects whose index must rebuild before it can be trusted again,
      *  regardless of the durable state row. Recording staleness here cannot
@@ -35,7 +27,7 @@ export declare class ProjectMetadataStore {
     private readonly migrations;
     /** `migrations` is injectable so tests can exercise upgrade paths with
      *  synthetic lists; production callers use the default. */
-    constructor(migrations?: readonly ProjectMetadataMigration[]);
+    constructor(migrations?: readonly ProjectMetadataMigration[], storage?: ProjectStorage);
     databasePath(projectPath: string): string;
     hasDatabase(projectPath: string): boolean;
     /**
@@ -109,10 +101,6 @@ export declare class ProjectMetadataStore {
     writeVariantsUiState(projectPath: string, json: string): Promise<void>;
     /** Close every open handle. For tests and process shutdown. */
     closeAll(): void;
-    private selectEntries;
-    private upsertRow;
-    private readState;
-    private writeState;
     /**
      * Open the project's database, creating and migrating it as needed. A
      * corrupt file is deleted (with its WAL/SHM siblings) and recreated once —
@@ -122,7 +110,6 @@ export declare class ProjectMetadataStore {
      * @effect Creates `.rivet/` and the database file; caches the open handle.
      */
     private openDatabase;
-    private openAndMigrate;
     private deleteDatabaseFiles;
 }
 //# sourceMappingURL=ProjectMetadataStore.d.ts.map

package/dist/services/ProjectMetadataStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProjectMetadataStore.d.ts","sourceRoot":"","sources":["../../src/services/ProjectMetadataStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,6BAA6B,CAAC;AA2BrC;;sDAEsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,2EAA2E;IAC3E,eAAe,EAAE,MAAM,CAAC;CACzB;AAkBD;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D;;;;iFAI6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IAEjE;+DAC2D;gBAEzD,UAAU,GAAE,SAAS,wBAAwB,EAAgC;IAK/E,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAIzC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;OAKG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD;;;;;;OAMG;IACG,yBAAyB,CAAC,IAAI,EAAE;QACpC,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,sBAAsB,CAAC;QACjC,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,OAAO,CAAC;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjB;;;;;;;OAOG;IACG,mBAAmB,CAAC,IAAI,EAAE;QAC9B,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,sBAAsB,EAAE,CAAC;KACnC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjB;;kFAE8E;IACxE,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAShE;;;;;;;;OAQG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAazD,YAAY,CAAC,IAAI,EAAE;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,oBAAoB,CAAC;KAC/B,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAW1B,cAAc,CAAC,IAAI,EAAE;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAehC;;;;;OAKG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMtE;;;;OAIG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5E,+DAA+D;IAC/D,QAAQ,IAAI,IAAI;IAWhB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,SAAS;IAkCjB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,UAAU;IAOlB;;;;;;;OAOG;YACW,YAAY;YAqDZ,cAAc;IA4B5B,OAAO,CAAC,mBAAmB;CAY5B"}
+{"version":3,"file":"ProjectMetadataStore.d.ts","sourceRoot":"","sources":["../../src/services/ProjectMetadataStore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,wCAAwC,CAAC;AAsBhD;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAoB;IAc7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAb1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IACrE;;;;iFAI6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IAEjE;+DAC2D;gBAEzD,UAAU,GAAE,SAAS,wBAAwB,EAAgC,EAC5D,OAAO,GAAE,cAAqC;IAKjE,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAOzC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;OAKG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD;;;;;;OAMG;IACG,yBAAyB,CAAC,IAAI,EAAE;QACpC,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,sBAAsB,CAAC;QACjC,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,OAAO,CAAC;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjB;;;;;;;OAOG;IACG,mBAAmB,CAAC,IAAI,EAAE;QAC9B,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,sBAAsB,EAAE,CAAC;KACnC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjB;;kFAE8E;IACxE,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAShE;;;;;;;;OAQG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAazD,YAAY,CAAC,IAAI,EAAE;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,oBAAoB,CAAC;KAC/B,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAK1B,cAAc,CAAC,IAAI,EAAE;QACzB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKhC;;;;;OAKG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMtE;;;;OAIG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5E,+DAA+D;IAC/D,QAAQ,IAAI,IAAI;IAWhB;;;;;;;OAOG;YACW,YAAY;IAsD1B,OAAO,CAAC,mBAAmB;CAY5B"}

package/dist/services/ProjectMetadataStore.js

@@ -1,37 +1,4 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -39,10 +6,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProjectMetadataStore = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+const ProjectStorage_1 = require("./ProjectStorage");
 const logger_1 = require("../utils/logger");
-const projectMetadataMigrations_1 = require("./projectMetadataMigrations");
+const ProjectMetadataRecords_1 = require("../storage/project-metadata/ProjectMetadataRecords");
+const migrations_1 = require("../storage/project-metadata/migrations");
 const log = (0, logger_1.createLogger)('ProjectMetadataStore');
-const RIVET_DIRNAME = '.rivet';
 const DATABASE_FILENAME = 'rivet.db';
 /** Extra files SQLite keeps alongside the database in WAL mode. Removed
  *  together with the database when recovering from corruption — a stale WAL
@@ -57,19 +25,6 @@ const VARIANT_INDEX_STALE = 'stale';
  *  the arrangement to the default, which callers accept as the trade-off for
  *  keeping this out of a separate `.rivet` file. */
 const VARIANTS_UI_STATE_KEY = 'variants_ui_state';
-/** How long a statement waits on a cross-process lock before failing. The
- *  CLI and server processes can open the same project database. */
-const BUSY_TIMEOUT_MS = 5_000;
-/** node:sqlite is loaded lazily so its one-time ExperimentalWarning fires
- *  only in processes that actually touch the projection, not on every CLI
- *  invocation's stderr. */
-let databaseSyncCtor = null;
-const loadDatabaseSync = async () => {
-    if (!databaseSyncCtor) {
-        databaseSyncCtor = (await Promise.resolve().then(() => __importStar(require('node:sqlite')))).DatabaseSync;
-    }
-    return databaseSyncCtor;
-};
 /**
  * Embedded SQLite metadata projection at `<project>/.rivet/rivet.db`.
  *
@@ -84,6 +39,7 @@ const loadDatabaseSync = async () => {
  * timeout for cross-process access.
  */
 class ProjectMetadataStore {
+    storage;
     handles = new Map();
     /** Projects whose index must rebuild before it can be trusted again,
      *  regardless of the durable state row. Recording staleness here cannot
@@ -94,11 +50,12 @@ class ProjectMetadataStore {
     migrations;
     /** `migrations` is injectable so tests can exercise upgrade paths with
      *  synthetic lists; production callers use the default. */
-    constructor(migrations = projectMetadataMigrations_1.PROJECT_METADATA_MIGRATIONS) {
+    constructor(migrations = migrations_1.PROJECT_METADATA_MIGRATIONS, storage = new ProjectStorage_1.ProjectStorage()) {
+        this.storage = storage;
         this.migrations = migrations;
     }
     databasePath(projectPath) {
-        return path_1.default.join(projectPath, RIVET_DIRNAME, DATABASE_FILENAME);
+        return path_1.default.join(this.storage.resolve(projectPath).dataDirectory, DATABASE_FILENAME);
     }
     hasDatabase(projectPath) {
         return fs_1.default.existsSync(this.databasePath(projectPath));
@@ -121,7 +78,7 @@ class ProjectMetadataStore {
      */
     async upsertVariantFromManifest(args) {
         const db = await this.openDatabase(args.projectPath);
-        this.upsertRow(db, args);
+        db.upsert(args);
     }
     /**
      * Replace the project's entire variants index with `entries` and mark it
@@ -133,20 +90,13 @@ class ProjectMetadataStore {
      */
     async rebuildVariantIndex(args) {
         const db = await this.openDatabase(args.projectPath);
-        db.exec('BEGIN IMMEDIATE');
-        try {
-            db.exec('DELETE FROM variants');
-            for (const entry of args.entries) {
-                this.upsertRow(db, { ...entry, projectPath: args.projectPath });
-            }
-            this.writeState(db, VARIANT_INDEX_STATE_KEY, VARIANT_INDEX_READY);
-            db.exec('COMMIT');
-            this.staleOverrides.delete(path_1.default.resolve(args.projectPath));
-        }
-        catch (err) {
-            db.exec('ROLLBACK');
-            throw err;
-        }
+        db.transaction(() => {
+            db.clearVariants();
+            for (const entry of args.entries)
+                db.upsert(entry);
+            db.writeState(VARIANT_INDEX_STATE_KEY, VARIANT_INDEX_READY);
+        });
+        this.staleOverrides.delete(path_1.default.resolve(args.projectPath));
     }
     /** Whether the variants index can serve reads: the database exists, opens
      *  at a supported schema version, no in-process staleness override is
@@ -159,7 +109,7 @@ class ProjectMetadataStore {
                 return false;
         }
         const db = await this.openDatabase(projectPath);
-        return this.readState(db, VARIANT_INDEX_STATE_KEY) === VARIANT_INDEX_READY;
+        return db.readState(VARIANT_INDEX_STATE_KEY) === VARIANT_INDEX_READY;
     }
     /**
      * Flag the variants index as out of sync with the manifests on disk, so
@@ -174,7 +124,7 @@ class ProjectMetadataStore {
         this.staleOverrides.add(path_1.default.resolve(projectPath));
         try {
             const db = await this.openDatabase(projectPath);
-            this.writeState(db, VARIANT_INDEX_STATE_KEY, VARIANT_INDEX_STALE);
+            db.writeState(VARIANT_INDEX_STATE_KEY, VARIANT_INDEX_STALE);
         }
         catch (err) {
             log.warn(`markVariantIndexStale: durable stale flag failed for ${projectPath} — the in-memory override still forces a rebuild in this process`, err);
@@ -182,21 +132,11 @@ class ProjectMetadataStore {
     }
     async listVariants(args) {
         const db = await this.openDatabase(args.projectPath);
-        const conditions = [];
-        const params = [];
-        if (args.status) {
-            conditions.push('status = ?');
-            params.push(args.status);
-        }
-        return this.selectEntries(db, conditions, params, args.limit);
+        return db.list({ status: args.status, limit: args.limit });
     }
     async searchVariants(args) {
         const db = await this.openDatabase(args.projectPath);
-        // Escape LIKE wildcards so the query only ever matches literally.
-        const escaped = args.query.replace(/[\\%_]/g, (match) => `\\${match}`);
-        const pattern = `%${escaped}%`;
-        const clause = "(label LIKE ? ESCAPE '\\' OR brief LIKE ? ESCAPE '\\' OR session_prompt LIKE ? ESCAPE '\\' OR run_label LIKE ? ESCAPE '\\')";
-        return this.selectEntries(db, [clause], [pattern, pattern, pattern, pattern], args.limit);
+        return db.search({ query: args.query, limit: args.limit });
     }
     /**
      * Read the variants panel's stored UI arrangement, or null when none has
@@ -208,7 +148,7 @@ class ProjectMetadataStore {
         if (!this.hasDatabase(projectPath))
             return null;
         const db = await this.openDatabase(projectPath);
-        return this.readState(db, VARIANTS_UI_STATE_KEY);
+        return db.readState(VARIANTS_UI_STATE_KEY);
     }
     /**
      * Persist the variants panel's UI arrangement.
@@ -217,7 +157,7 @@ class ProjectMetadataStore {
      */
     async writeVariantsUiState(projectPath, json) {
         const db = await this.openDatabase(projectPath);
-        this.writeState(db, VARIANTS_UI_STATE_KEY, json);
+        db.writeState(VARIANTS_UI_STATE_KEY, json);
     }
     /** Close every open handle. For tests and process shutdown. */
     closeAll() {
@@ -231,38 +171,6 @@ class ProjectMetadataStore {
         }
         this.handles.clear();
     }
-    selectEntries(db, conditions, params, limit) {
-        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
-        // Newest-first with id tiebreaks so equal timestamps order predictably.
-        let sql = `SELECT manifest_json, has_static_preview FROM variants ${where} ORDER BY created_at DESC, session_id ASC, variant_id ASC`;
-        if (limit !== undefined && limit > 0) {
-            sql += ' LIMIT ?';
-            params = [...params, limit];
-        }
-        const rows = db.prepare(sql).all(...params);
-        return rows.map((row) => ({
-            manifest: JSON.parse(row.manifest_json),
-            hasStaticPreview: row.has_static_preview === 1,
-        }));
-    }
-    upsertRow(db, args) {
-        const { manifest } = args;
-        db.prepare(`INSERT OR REPLACE INTO variants (
-        session_id, variant_id, label, brief, session_prompt, run_label,
-        status, created_at, status_changed_at, has_tree, serve_kind,
-        has_static_preview, manifest_mtime_ms, manifest_json
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(manifest.sessionId, manifest.variantId, manifest.label, manifest.brief, manifest.sessionPrompt, manifest.runLabel ?? null, manifest.status, manifest.createdAt, manifest.statusChangedAt, manifest.tree ? 1 : 0, manifest.serve?.kind ?? null, args.hasStaticPreview ? 1 : 0, Math.round(args.manifestMtimeMs), JSON.stringify(manifest));
-    }
-    readState(db, key) {
-        const row = db
-            .prepare('SELECT value FROM metadata_state WHERE key = ?')
-            .get(key);
-        return row?.value ?? null;
-    }
-    writeState(db, key, value) {
-        db.prepare(`INSERT INTO metadata_state (key, value, updated_at) VALUES (?, ?, ?)
-       ON CONFLICT(key) DO UPDATE SET value = excluded.value, updated_at = excluded.updated_at`).run(key, value, new Date().toISOString());
-    }
     /**
      * Open the project's database, creating and migrating it as needed. A
      * corrupt file is deleted (with its WAL/SHM siblings) and recreated once —
@@ -290,28 +198,27 @@ class ProjectMetadataStore {
             this.handles.delete(key);
         }
         fs_1.default.mkdirSync(path_1.default.dirname(dbPath), { recursive: true });
-        let opened;
+        let db;
         try {
-            opened = await this.openAndMigrate(dbPath);
+            db = await ProjectMetadataRecords_1.ProjectMetadataRecords.open(dbPath, this.migrations);
         }
         catch (err) {
-            if (err instanceof projectMetadataMigrations_1.UnsupportedSchemaVersionError)
+            if (err instanceof migrations_1.UnsupportedSchemaVersionError)
                 throw err;
             log.warn(`openDatabase: ${dbPath} is unreadable — recreating the projection`, err);
             this.deleteDatabaseFiles(dbPath);
-            opened = await this.openAndMigrate(dbPath);
+            db = await ProjectMetadataRecords_1.ProjectMetadataRecords.open(dbPath, this.migrations);
         }
-        const { db, wasUpgraded } = opened;
-        if (wasUpgraded) {
-            // Migrations only change schema shape (see projectMetadataMigrations)
+        if (db.wasUpgraded) {
+            // Storage migrations only change schema shape
             // — any column they add that derives from manifests starts empty.
             // Marking the index stale makes the next read re-project every row,
             // so migrations never need data backfills of their own. Outside
-            // openAndMigrate so a failed flag write can't look like corruption;
+            // connection setup so a failed flag write can't look like corruption;
             // the in-memory override alone already forces the rebuild.
             this.staleOverrides.add(key);
             try {
-                this.writeState(db, VARIANT_INDEX_STATE_KEY, VARIANT_INDEX_STALE);
+                db.writeState(VARIANT_INDEX_STATE_KEY, VARIANT_INDEX_STALE);
             }
             catch (err) {
                 log.warn(`openDatabase: durable stale flag failed after upgrading ${dbPath}`, err);
@@ -320,31 +227,6 @@ class ProjectMetadataStore {
         this.handles.set(key, db);
         return db;
     }
-    async openAndMigrate(dbPath) {
-        const DatabaseSync = await loadDatabaseSync();
-        const db = new DatabaseSync(dbPath);
-        try {
-            db.exec('PRAGMA journal_mode = WAL');
-            db.exec(`PRAGMA busy_timeout = ${BUSY_TIMEOUT_MS}`);
-            const { fromVersion, toVersion } = (0, projectMetadataMigrations_1.applyProjectMetadataMigrations)(db, {
-                migrations: this.migrations,
-            });
-            const wasUpgraded = fromVersion > 0 && toVersion > fromVersion;
-            if (wasUpgraded) {
-                log.info(`openAndMigrate: upgraded ${dbPath} from schema version ${fromVersion} to ${toVersion} — index will rebuild on next read`);
-            }
-            return { db, wasUpgraded };
-        }
-        catch (err) {
-            try {
-                db.close();
-            }
-            catch {
-                // The open error is the one worth surfacing.
-            }
-            throw err;
-        }
-    }
     deleteDatabaseFiles(dbPath) {
         for (const target of [
             dbPath,