rivet-design 0.16.3 → 0.17.0

package/dist/storage/library/BundleMetadataStore.js

@@ -0,0 +1,317 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BundleMetadataStore = void 0;
+const path_1 = __importDefault(require("path"));
+const crypto_1 = require("crypto");
+const drizzle_orm_1 = require("drizzle-orm");
+const migrations_1 = require("./migrations");
+const database_1 = require("./database");
+const bundle_1 = require("./schema/bundle");
+const PRESENTATION_KEY = 'variants_ui_state';
+const PROJECT_SINGLETON = 1;
+/** Stable keys preserve request-less grouping and immutable snapshot provenance. */
+const identifier = (value) => (0, crypto_1.createHash)('sha256').update(JSON.stringify(value)).digest('hex');
+/** Owns a bundle's metadata, independently of exported manifests and catalog caches. */
+class BundleMetadataStore {
+    db;
+    project;
+    isClosed = false;
+    constructor(db, project) {
+        this.db = db;
+        this.project = project;
+    }
+    /** Opens and validates a bundle without repairing or replacing durable user data. */
+    static async open({ directory, project, }) {
+        const db = await (0, database_1.openDurableDatabase)({
+            databasePath: path_1.default.join(directory, 'metadata.sqlite'),
+            schema: migrations_1.BUNDLE_SCHEMA,
+        });
+        try {
+            const now = new Date().toISOString();
+            db.insert(bundle_1.project)
+                .values({
+                singleton: PROJECT_SINGLETON,
+                id: project.id,
+                name: project.name,
+                createdAt: now,
+                updatedAt: now,
+            })
+                .onConflictDoNothing()
+                .run();
+            if (db.select({ id: bundle_1.project.id }).from(bundle_1.project).get()?.id !== project.id)
+                throw new Error('Bundle project identity does not match registration');
+            return new BundleMetadataStore(db, project);
+        }
+        catch (error) {
+            (0, database_1.closeDatabase)(db);
+            throw error;
+        }
+    }
+    /** Publishes verified artifact metadata and increments its revision in one transaction. */
+    upsertVariant(manifest, artifactPath) {
+        (0, database_1.transaction)(this.db, () => this.writeVariant(manifest, artifactPath));
+    }
+    /** Applies a metadata edit while holding the database write transaction. */
+    updateVariant(args) {
+        return (0, database_1.transaction)(this.db, () => {
+            const manifest = this.getVariant(args.sessionId, args.variantId);
+            if (!manifest)
+                return false;
+            const before = JSON.stringify(manifest);
+            args.update(manifest);
+            if (JSON.stringify(manifest) !== before)
+                this.writeVariant(manifest);
+            return true;
+        });
+    }
+    /** Reads the relative artifact directory published with a direction. */
+    artifactPath(sessionId, variantId) {
+        return (this.db
+            .select({ path: bundle_1.variants.artifactPath })
+            .from(bundle_1.variants)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(bundle_1.variants.sessionId, sessionId), (0, drizzle_orm_1.eq)(bundle_1.variants.variantId, variantId)))
+            .get()?.path ?? null);
+    }
+    /** Writes metadata within the caller's transaction after artifact verification. */
+    writeVariant(manifest, artifactPath) {
+        const { sessionId, variantId, label, brief, status, createdAt, statusChangedAt, changedFilesCount, tree, base, parent, parentVariant, ...details } = manifest;
+        this.db
+            .insert(bundle_1.sessions)
+            .values({
+            id: sessionId,
+            initialPrompt: manifest.sessionPrompt,
+            projectKind: manifest.projectKind,
+            sourceWorkspaceId: this.project.workspaceId,
+            createdAt,
+            details: {},
+        })
+            .onConflictDoNothing()
+            .run();
+        const existing = this.db
+            .select({ batchId: bundle_1.variants.batchId })
+            .from(bundle_1.variants)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(bundle_1.variants.sessionId, sessionId), (0, drizzle_orm_1.eq)(bundle_1.variants.variantId, variantId)))
+            .get();
+        const batchId = existing?.batchId ??
+            identifier([
+                sessionId,
+                manifest.requestId ?? null,
+                manifest.requestId ? null : (manifest.runLabel ?? null),
+            ]);
+        const batchLabel = manifest.runLabel ?? null;
+        this.db
+            .insert(bundle_1.batches)
+            .values({
+            id: batchId,
+            sessionId,
+            requestId: manifest.requestId ?? null,
+            label: batchLabel,
+            createdAt,
+        })
+            .onConflictDoUpdate({
+            target: [bundle_1.batches.sessionId, bundle_1.batches.id],
+            set: { label: batchLabel },
+        })
+            .run();
+        const metadata = {
+            batchId,
+            label,
+            brief,
+            status,
+            statusChangedAt,
+            changedFilesCount,
+            details,
+            snapshotId: this.putSnapshot(tree, createdAt),
+            baseSnapshotId: this.putSnapshot(base, createdAt),
+            parentSnapshotId: this.putSnapshot(parent, createdAt),
+            parentSessionId: parentVariant?.sessionId ?? null,
+            parentVariantId: parentVariant?.variantId ?? null,
+        };
+        this.db
+            .insert(bundle_1.variants)
+            .values({
+            sessionId,
+            variantId,
+            createdAt,
+            artifactPath: artifactPath ?? null,
+            ...metadata,
+        })
+            .onConflictDoUpdate({
+            target: [bundle_1.variants.sessionId, bundle_1.variants.variantId],
+            set: {
+                ...metadata,
+                ...(artifactPath !== undefined ? { artifactPath } : {}),
+            },
+        })
+            .run();
+    }
+    /** Reads one exact direction; missing identifiers never fall back to another session. */
+    getVariant(sessionId, variantId) {
+        const row = this.db
+            .select()
+            .from(bundle_1.variants)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(bundle_1.variants.sessionId, sessionId), (0, drizzle_orm_1.eq)(bundle_1.variants.variantId, variantId)))
+            .get();
+        return row ? this.decodeVariant(row) : null;
+    }
+    /** Lists published metadata in stable creation order without reading artifact files. */
+    listVariants() {
+        return this.db
+            .select()
+            .from(bundle_1.variants)
+            .orderBy((0, drizzle_orm_1.desc)(bundle_1.variants.createdAt), bundle_1.variants.sessionId, bundle_1.variants.variantId)
+            .all()
+            .map((row) => this.decodeVariant(row));
+    }
+    /** Preserves session-level metadata such as whole-canvas deployments. */
+    putSession(session) {
+        (0, database_1.transaction)(this.db, () => {
+            this.db
+                .insert(bundle_1.sessions)
+                .values({
+                id: session.sessionId,
+                initialPrompt: session.sessionPrompt,
+                projectKind: session.projectKind,
+                sourceWorkspaceId: this.project.workspaceId,
+                createdAt: session.createdAt,
+                details: session,
+            })
+                .onConflictDoUpdate({ target: bundle_1.sessions.id, set: { details: session } })
+                .run();
+        });
+    }
+    /** Reads stored session metadata, including imported extension fields. */
+    getSession(sessionId) {
+        const row = this.db
+            .select()
+            .from(bundle_1.sessions)
+            .where((0, drizzle_orm_1.eq)(bundle_1.sessions.id, sessionId))
+            .get();
+        if (!row)
+            return null;
+        return {
+            schemaVersion: 2,
+            sessionId,
+            sessionPrompt: row.initialPrompt,
+            projectKind: row.projectKind,
+            createdAt: row.createdAt,
+            ...row.details,
+        };
+    }
+    /** Stores the editor's pins and ordering without involving a derived catalog. */
+    setPresentation(value) {
+        (0, database_1.transaction)(this.db, () => {
+            const updatedAt = new Date().toISOString();
+            const serializedValue = JSON.stringify(value);
+            this.db
+                .insert(bundle_1.presentation)
+                .values({ key: PRESENTATION_KEY, value: serializedValue, updatedAt })
+                .onConflictDoUpdate({
+                target: bundle_1.presentation.key,
+                set: { value: serializedValue, updatedAt },
+            })
+                .run();
+        });
+    }
+    /** Returns the stored presentation document or null before the first edit. */
+    getPresentation() {
+        const row = this.db
+            .select({ value: bundle_1.presentation.value })
+            .from(bundle_1.presentation)
+            .where((0, drizzle_orm_1.eq)(bundle_1.presentation.key, PRESENTATION_KEY))
+            .get();
+        return row ? JSON.parse(row.value) : null;
+    }
+    /** Releases the bundle database handle. */
+    close() {
+        if (!this.isClosed) {
+            (0, database_1.closeDatabase)(this.db);
+            this.isClosed = true;
+        }
+    }
+    /** Records an immutable ref/commit pair, separately from mutable ref names. */
+    putSnapshot(pointer, createdAt) {
+        if (!pointer)
+            return null;
+        const id = identifier([pointer.ref, pointer.commitSha]);
+        this.db
+            .insert(bundle_1.snapshots)
+            .values({
+            id,
+            gitRef: pointer.ref,
+            commitSha: pointer.commitSha,
+            treeSha: pointer.treeSha ?? null,
+            createdAt,
+        })
+            .onConflictDoUpdate({
+            target: bundle_1.snapshots.id,
+            set: {
+                treeSha: (0, drizzle_orm_1.sql) `coalesce(${bundle_1.snapshots.treeSha}, ${pointer.treeSha ?? null})`,
+            },
+        })
+            .run();
+        return id;
+    }
+    /** Reconstructs a saved pointer from its durable provenance record. */
+    snapshot(id) {
+        if (id === null)
+            return undefined;
+        const row = this.db
+            .select()
+            .from(bundle_1.snapshots)
+            .where((0, drizzle_orm_1.eq)(bundle_1.snapshots.id, id))
+            .get();
+        if (!row)
+            throw new Error('Missing snapshot metadata');
+        return {
+            ref: row.gitRef,
+            commitSha: row.commitSha,
+            ...(row.treeSha ? { treeSha: row.treeSha } : {}),
+        };
+    }
+    /** Reconstructs the history contract from scalar records and extension metadata. */
+    decodeVariant(row) {
+        const tree = this.snapshot(row.snapshotId);
+        const base = this.snapshot(row.baseSnapshotId);
+        const parent = this.snapshot(row.parentSnapshotId);
+        if (tree && !tree.treeSha)
+            throw new Error('Missing snapshot tree metadata');
+        return {
+            ...row.details,
+            sessionId: row.sessionId,
+            variantId: row.variantId,
+            label: row.label,
+            brief: row.brief,
+            status: row.status,
+            createdAt: row.createdAt,
+            statusChangedAt: row.statusChangedAt,
+            changedFilesCount: row.changedFilesCount,
+            ...(tree?.treeSha
+                ? {
+                    tree: {
+                        ref: tree.ref,
+                        commitSha: tree.commitSha,
+                        treeSha: tree.treeSha,
+                    },
+                }
+                : {}),
+            ...(base ? { base: { ref: base.ref, commitSha: base.commitSha } } : {}),
+            ...(parent
+                ? { parent: { ref: parent.ref, commitSha: parent.commitSha } }
+                : {}),
+            ...(row.parentVariantId && row.parentSessionId
+                ? {
+                    parentVariant: {
+                        sessionId: row.parentSessionId,
+                        variantId: row.parentVariantId,
+                    },
+                }
+                : {}),
+        };
+    }
+}
+exports.BundleMetadataStore = BundleMetadataStore;
+//# sourceMappingURL=BundleMetadataStore.js.map

package/dist/storage/library/BundleMetadataStore.js.map

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

package/dist/storage/library/CoordinatorRecords.d.ts

@@ -0,0 +1,25 @@
+import { coordinator } from './schema/coordinator';
+type CoordinatorRecord = Pick<typeof coordinator.$inferSelect, 'pid' | 'token' | 'port'>;
+/** Persists coordinator ownership and readiness in the channel's runtime directory. */
+export declare class CoordinatorRecords {
+    private readonly db;
+    private constructor();
+    /** Opens the durable coordinator record. */
+    static open(root: string): Promise<CoordinatorRecords>;
+    /** Holds the write lock while a caller checks and assigns process ownership. */
+    transaction<T>(operation: () => T): T;
+    /** Reads the recorded owner and its published port. */
+    read(): CoordinatorRecord | null;
+    /** Replaces the owner within the caller's ownership transaction. */
+    assign(record: CoordinatorRecord): void;
+    /** Updates readiness only while the supplied process still owns the record. */
+    publish({ pid, token, port }: CoordinatorRecord): boolean;
+    /** Deletes only the supplied process identity. */
+    release({ pid, token }: Omit<CoordinatorRecord, 'port'>): void;
+    /** Deletes an observed record only if neither its owner nor readiness has changed. */
+    discard({ pid, token, port }: CoordinatorRecord): boolean;
+    /** Releases the discovery database connection. */
+    close(): void;
+}
+export {};
+//# sourceMappingURL=CoordinatorRecords.d.ts.map

package/dist/storage/library/CoordinatorRecords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoordinatorRecords.d.ts","sourceRoot":"","sources":["../../../src/storage/library/CoordinatorRecords.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,KAAK,iBAAiB,GAAG,IAAI,CAC3B,OAAO,WAAW,CAAC,YAAY,EAC/B,KAAK,GAAG,OAAO,GAAG,MAAM,CACzB,CAAC;AAGF,uFAAuF;AACvF,qBAAa,kBAAkB;IACT,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAvC,OAAO;IAEP,4CAA4C;WAC/B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAS5D,gFAAgF;IAChF,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC;IAIrC,uDAAuD;IACvD,IAAI,IAAI,iBAAiB,GAAG,IAAI;IAchC,oEAAoE;IACpE,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAQvC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,iBAAiB,GAAG,OAAO;IAkBzD,kDAAkD;IAClD,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,IAAI;IAS9D,sFAAsF;IACtF,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,iBAAiB,GAAG,OAAO;IAkBzD,kDAAkD;IAClD,KAAK,IAAI,IAAI;CAGd"}

package/dist/storage/library/CoordinatorRecords.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoordinatorRecords = void 0;
+const path_1 = __importDefault(require("path"));
+const drizzle_orm_1 = require("drizzle-orm");
+const database_1 = require("./database");
+const migrations_1 = require("./migrations");
+const coordinator_1 = require("./schema/coordinator");
+const COORDINATOR_SINGLETON = 1;
+/** Persists coordinator ownership and readiness in the channel's runtime directory. */
+class CoordinatorRecords {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Opens the durable coordinator record. */
+    static async open(root) {
+        return new CoordinatorRecords(await (0, database_1.openDurableDatabase)({
+            databasePath: path_1.default.join(root, 'runtime', 'coordinator.sqlite'),
+            schema: migrations_1.COORDINATOR_SCHEMA,
+        }));
+    }
+    /** Holds the write lock while a caller checks and assigns process ownership. */
+    transaction(operation) {
+        return (0, database_1.transaction)(this.db, operation);
+    }
+    /** Reads the recorded owner and its published port. */
+    read() {
+        return (this.db
+            .select({
+            pid: coordinator_1.coordinator.pid,
+            token: coordinator_1.coordinator.token,
+            port: coordinator_1.coordinator.port,
+        })
+            .from(coordinator_1.coordinator)
+            .where((0, drizzle_orm_1.eq)(coordinator_1.coordinator.singleton, COORDINATOR_SINGLETON))
+            .get() ?? null);
+    }
+    /** Replaces the owner within the caller's ownership transaction. */
+    assign(record) {
+        this.db
+            .insert(coordinator_1.coordinator)
+            .values({ singleton: COORDINATOR_SINGLETON, ...record })
+            .onConflictDoUpdate({ target: coordinator_1.coordinator.singleton, set: record })
+            .run();
+    }
+    /** Updates readiness only while the supplied process still owns the record. */
+    publish({ pid, token, port }) {
+        return this.transaction(() => {
+            return (this.db
+                .update(coordinator_1.coordinator)
+                .set({ port })
+                .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(coordinator_1.coordinator.singleton, COORDINATOR_SINGLETON), (0, drizzle_orm_1.eq)(coordinator_1.coordinator.pid, pid), (0, drizzle_orm_1.eq)(coordinator_1.coordinator.token, token)))
+                .run().changes === 1);
+        });
+    }
+    /** Deletes only the supplied process identity. */
+    release({ pid, token }) {
+        this.transaction(() => {
+            this.db
+                .delete(coordinator_1.coordinator)
+                .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(coordinator_1.coordinator.pid, pid), (0, drizzle_orm_1.eq)(coordinator_1.coordinator.token, token)))
+                .run();
+        });
+    }
+    /** Deletes an observed record only if neither its owner nor readiness has changed. */
+    discard({ pid, token, port }) {
+        return (this.db
+            .delete(coordinator_1.coordinator)
+            .where((0, drizzle_orm_1.and)((0, drizzle_orm_1.eq)(coordinator_1.coordinator.singleton, COORDINATOR_SINGLETON), (0, drizzle_orm_1.eq)(coordinator_1.coordinator.pid, pid), (0, drizzle_orm_1.eq)(coordinator_1.coordinator.token, token), port === null
+            ? (0, drizzle_orm_1.isNull)(coordinator_1.coordinator.port)
+            : (0, drizzle_orm_1.eq)(coordinator_1.coordinator.port, port)))
+            .run().changes === 1);
+    }
+    /** Releases the discovery database connection. */
+    close() {
+        (0, database_1.closeDatabase)(this.db);
+    }
+}
+exports.CoordinatorRecords = CoordinatorRecords;
+//# sourceMappingURL=CoordinatorRecords.js.map

package/dist/storage/library/CoordinatorRecords.js.map

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

package/dist/storage/library/ProjectPreviewCache.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+declare const PreviewSchema: z.ZodObject<{
+    sourceKey: z.ZodString;
+    projectPath: z.ZodString;
+    dataUrl: z.ZodString;
+    label: z.ZodString;
+    capturedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    dataUrl: string;
+    projectPath: string;
+    sourceKey: string;
+    capturedAt: string;
+}, {
+    label: string;
+    dataUrl: string;
+    projectPath: string;
+    sourceKey: string;
+    capturedAt: string;
+}>;
+export type CachedProjectPreview = z.infer<typeof PreviewSchema>;
+/** Persists disposable project images outside authoritative bundles and metadata. */
+export declare class ProjectPreviewCache {
+    private readonly root;
+    constructor(root: string);
+    /** Reads a validated cache entry; missing or malformed images can be regenerated. */
+    read(projectId: string): Promise<CachedProjectPreview | null>;
+    /** Atomically replaces one private image without exposing partially written bytes. */
+    write(projectId: string, preview: CachedProjectPreview): Promise<void>;
+    /** Restricts cache filenames to registered project identifiers. */
+    private file;
+}
+export {};
+//# sourceMappingURL=ProjectPreviewCache.d.ts.map

package/dist/storage/library/ProjectPreviewCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectPreviewCache.d.ts","sourceRoot":"","sources":["../../../src/storage/library/ProjectPreviewCache.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;EAMjB,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIjE,qFAAqF;AACrF,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,MAAM;IAEzC,qFAAqF;IAC/E,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAiBnE,sFAAsF;IAChF,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB5E,mEAAmE;IACnE,OAAO,CAAC,IAAI;CAQb"}

package/dist/storage/library/ProjectPreviewCache.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectPreviewCache = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const crypto_1 = require("crypto");
+const zod_1 = require("zod");
+const PreviewSchema = zod_1.z.object({
+    sourceKey: zod_1.z.string(),
+    projectPath: zod_1.z.string(),
+    dataUrl: zod_1.z.string().startsWith('data:image/jpeg;base64,'),
+    label: zod_1.z.string(),
+    capturedAt: zod_1.z.string().datetime(),
+});
+const OWNER_ONLY_DIRECTORY = 0o700;
+const OWNER_ONLY_FILE = 0o600;
+/** Persists disposable project images outside authoritative bundles and metadata. */
+class ProjectPreviewCache {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    /** Reads a validated cache entry; missing or malformed images can be regenerated. */
+    async read(projectId) {
+        try {
+            const raw = JSON.parse(await promises_1.default.readFile(this.file(projectId), 'utf8'));
+            const result = PreviewSchema.safeParse(raw);
+            return result.success ? result.data : null;
+        }
+        catch (error) {
+            if (error instanceof SyntaxError ||
+                error.code === 'ENOENT')
+                return null;
+            throw error;
+        }
+    }
+    /** Atomically replaces one private image without exposing partially written bytes. */
+    async write(projectId, preview) {
+        const target = this.file(projectId);
+        await promises_1.default.mkdir(path_1.default.dirname(target), {
+            recursive: true,
+            mode: OWNER_ONLY_DIRECTORY,
+        });
+        const temporary = `${target}.${(0, crypto_1.randomUUID)()}.tmp`;
+        try {
+            await promises_1.default.writeFile(temporary, JSON.stringify(PreviewSchema.parse(preview)), { mode: OWNER_ONLY_FILE });
+            await promises_1.default.rename(temporary, target);
+        }
+        finally {
+            await promises_1.default.rm(temporary, { force: true });
+        }
+    }
+    /** Restricts cache filenames to registered project identifiers. */
+    file(projectId) {
+        return path_1.default.join(this.root, 'cache', zod_1.z.string().uuid().parse(projectId), 'project-preview.json');
+    }
+}
+exports.ProjectPreviewCache = ProjectPreviewCache;
+//# sourceMappingURL=ProjectPreviewCache.js.map

package/dist/storage/library/ProjectPreviewCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectPreviewCache.js","sourceRoot":"","sources":["../../../src/storage/library/ProjectPreviewCache.ts"],"names":[],"mappings":";;;;;;AAAA,2DAA6B;AAC7B,gDAAwB;AACxB,mCAAoC;AACpC,6BAAwB;AAExB,MAAM,aAAa,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7B,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;IACrB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE;IACvB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,yBAAyB,CAAC;IACzD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,KAAK,CAAC;AACnC,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B,qFAAqF;AACrF,MAAa,mBAAmB;IACD;IAA7B,YAA6B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE7C,qFAAqF;IACrF,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,GAAY,IAAI,CAAC,KAAK,CAC7B,MAAM,kBAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAChD,CAAC;YACF,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC5C,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IACE,KAAK,YAAY,WAAW;gBAC3B,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAElD,OAAO,IAAI,CAAC;YACd,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,sFAAsF;IACtF,KAAK,CAAC,KAAK,CAAC,SAAiB,EAAE,OAA6B;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,kBAAE,CAAC,KAAK,CAAC,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YACnC,SAAS,EAAE,IAAI;YACf,IAAI,EAAE,oBAAoB;SAC3B,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,IAAA,mBAAU,GAAE,MAAM,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,kBAAE,CAAC,SAAS,CAChB,SAAS,EACT,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAC5C,EAAE,IAAI,EAAE,eAAe,EAAE,CAC1B,CAAC;YACF,MAAM,kBAAE,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;gBAAS,CAAC;YACT,MAAM,kBAAE,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,mEAAmE;IAC3D,IAAI,CAAC,SAAiB;QAC5B,OAAO,cAAI,CAAC,IAAI,CACd,IAAI,CAAC,IAAI,EACT,OAAO,EACP,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAClC,sBAAsB,CACvB,CAAC;IACJ,CAAC;CACF;AAlDD,kDAkDC"}

package/dist/storage/library/ProjectRecords.d.ts

@@ -0,0 +1,64 @@
+export type ProjectRecord = ReturnType<ProjectRecords['list']>[number];
+/** Persists project identities and their machine-specific workspace attachments. */
+export declare class ProjectRecords {
+    private readonly db;
+    private constructor();
+    /** Opens the registry with its durable schema and write coordination. */
+    static open(root: string): Promise<ProjectRecords>;
+    /** Runs related reads and writes under one immediate transaction. */
+    transaction<T>(operation: () => T): T;
+    /** Lists persisted attachments in stable last-opened order. */
+    list(): {
+        id: string;
+        workspaceId: string;
+        name: string;
+        projectPath: string;
+        createdAt: string;
+        lastOpenedAt: string;
+        storageKind: "project" | "bundle";
+        sourceFingerprint: string | null;
+    }[];
+    /** Reads a single project and its workspace attachment. */
+    get(projectId: string): {
+        id: string;
+        workspaceId: string;
+        name: string;
+        projectPath: string;
+        createdAt: string;
+        lastOpenedAt: string;
+        storageKind: "project" | "bundle";
+        sourceFingerprint: string | null;
+    } | null;
+    /** Finds the owner of a canonical workspace or attributed history root. */
+    findByPath(canonicalPath: string): {
+        id: string;
+        workspaceId: string;
+        name: string;
+        projectPath: string;
+        createdAt: string;
+        lastOpenedAt: string;
+        storageKind: "project" | "bundle";
+        sourceFingerprint: string | null;
+    } | null;
+    /** Inserts a project and its workspace within the caller's transaction. */
+    insert(record: {
+        id: string;
+        name: string;
+        workspaceId: string;
+        canonicalPath: string;
+        createdAt: string;
+    }): void;
+    /** Records the time a registered project was opened. */
+    recordOpening(projectId: string, lastOpenedAt: string): void;
+    /** Records one explicitly attributed generated history directory. */
+    attachHistoryRoot(projectId: string, canonicalPath: string): void;
+    /** Lists the persisted generated history attachments for a project. */
+    historyRoots(projectId: string): string[];
+    /** Updates a workspace attachment without changing either identity. */
+    relink(projectId: string, canonicalPath: string): void;
+    /** Publishes the authoritative storage owner and its verified source fingerprint. */
+    activateBundle(projectId: string, sourceFingerprint: string | null): void;
+    /** Releases the registry connection. */
+    close(): void;
+}
+//# sourceMappingURL=ProjectRecords.d.ts.map

package/dist/storage/library/ProjectRecords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectRecords.d.ts","sourceRoot":"","sources":["../../../src/storage/library/ProjectRecords.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,oFAAoF;AACpF,qBAAa,cAAc;IACL,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAvC,OAAO;IAEP,yEAAyE;WAC5D,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IASxD,qEAAqE;IACrE,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC;IAIrC,+DAA+D;IAC/D,IAAI;;;;;;;;;;IASJ,2DAA2D;IAC3D,GAAG,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;IAWrB,2EAA2E;IAC3E,UAAU,CAAC,aAAa,EAAE,MAAM;;;;;;;;;;IAoBhC,2EAA2E;IAC3E,MAAM,CAAC,MAAM,EAAE;QACb,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI;IAoBR,wDAAwD;IACxD,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAQ5D,qEAAqE;IACrE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAQjE,uEAAuE;IACvE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IASzC,uEAAuE;IACvE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAQtD,qFAAqF;IACrF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAUzE,wCAAwC;IACxC,KAAK,IAAI,IAAI;CAGd"}