rivet-design 0.16.3 → 0.17.0

package/dist/services/HubDiscovery.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HubDiscovery = void 0;
+const crypto_1 = require("crypto");
+const zod_1 = require("zod");
+const pid_1 = require("../utils/pid");
+const CoordinatorRecords_1 = require("../storage/library/CoordinatorRecords");
+const HubRecordSchema = zod_1.z.object({
+    pid: zod_1.z.number().int().positive(),
+    token: zod_1.z.string().uuid(),
+    port: zod_1.z.number().int().positive().nullable(),
+});
+/** Coordinates process ownership through one transactional user-level record. */
+class HubDiscovery {
+    records;
+    constructor(records) {
+        this.records = records;
+    }
+    /** Opens channel-scoped discovery without starting a coordinator. */
+    static async open(root) {
+        return new HubDiscovery(await CoordinatorRecords_1.CoordinatorRecords.open(root));
+    }
+    /** Reads the current process identity and its listening port, if ready. */
+    read() {
+        const row = this.records.read();
+        return row ? HubRecordSchema.parse(row) : null;
+    }
+    /** Elects one live candidate; a dead process cannot retain coordinator ownership. */
+    claim() {
+        return this.records.transaction(() => {
+            const record = this.read();
+            if (record && (0, pid_1.isPidAlive)(record.pid))
+                return { status: 'occupied', record };
+            const token = (0, crypto_1.randomUUID)();
+            this.records.assign({ pid: process.pid, token, port: null });
+            return { status: 'owned', token };
+        });
+    }
+    /** Publishes readiness only for the process that still owns this coordinator. */
+    publish({ token, port }) {
+        if (!this.records.publish({ pid: process.pid, token, port }))
+            throw new Error('Coordinator ownership changed before startup completed');
+    }
+    /** Removes only this process's matching ownership record on graceful shutdown. */
+    release(token) {
+        this.records.release({ pid: process.pid, token });
+    }
+    /** Clears an unverified record only while its ownership and readiness still match. */
+    discard(record) {
+        return this.records.discard(record);
+    }
+    /** Releases the discovery database handle. */
+    close() {
+        this.records.close();
+    }
+}
+exports.HubDiscovery = HubDiscovery;
+//# sourceMappingURL=HubDiscovery.js.map

package/dist/services/HubDiscovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HubDiscovery.js","sourceRoot":"","sources":["../../src/services/HubDiscovery.ts"],"names":[],"mappings":";;;AAAA,mCAAoC;AACpC,6BAAwB;AACxB,sCAA0C;AAC1C,8EAA2E;AAE3E,MAAM,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/B,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAChC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACxB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAKH,iFAAiF;AACjF,MAAa,YAAY;IACc;IAArC,YAAqC,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;IAAG,CAAC;IAEpE,qEAAqE;IACrE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY;QAC5B,OAAO,IAAI,YAAY,CAAC,MAAM,uCAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,2EAA2E;IAC3E,IAAI;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAChC,OAAO,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjD,CAAC;IAED,qFAAqF;IACrF,KAAK;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC3B,IAAI,MAAM,IAAI,IAAA,gBAAU,EAAC,MAAM,CAAC,GAAG,CAAC;gBAClC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,IAAA,mBAAU,GAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,iFAAiF;IACjF,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAmC;QACtD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC9E,CAAC;IAED,kFAAkF;IAClF,OAAO,CAAC,KAAa;QACnB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,sFAAsF;IACtF,OAAO,CAAC,MAAiB;QACvB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,8CAA8C;IAC9C,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AA9CD,oCA8CC"}

package/dist/services/HubNavigation.d.ts

@@ -0,0 +1,36 @@
+export interface HubNavigationTarget {
+    projectId?: string;
+    sessionId?: string;
+    variantId?: string;
+}
+export interface HubNavigationRequest extends HubNavigationTarget {
+    requestId: string;
+}
+export interface HubViewNavigation extends HubNavigationRequest {
+    sequence: number;
+}
+interface NavigationResult {
+    handled: boolean;
+}
+/** Delivers ordered explicit opens to one browser view without changing other views. */
+export declare class HubNavigation {
+    private sequence;
+    private readonly views;
+    private readonly requests;
+    private readonly pendingRequests;
+    /** Refreshes browser presence independently of project runtime or preview usage. */
+    connect({ viewId, isFocused }: {
+        viewId: string;
+        isFocused: boolean;
+    }): void;
+    /** Queues one idempotent navigation and waits for its receiving view to acknowledge it. */
+    request(request: HubNavigationRequest): Promise<NavigationResult>;
+    /** Returns only this view's ordered navigation queue. */
+    pending(viewId: string): HubViewNavigation[];
+    /** Accepts acknowledgement only from the receiving view for its pending sequence. */
+    acknowledge(viewId: string, sequence: number): boolean;
+    /** Releases navigation waiters when the coordinator shuts down. */
+    close(): void;
+}
+export {};
+//# sourceMappingURL=HubNavigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HubNavigation.d.ts","sourceRoot":"","sources":["../../src/services/HubNavigation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAeD,wFAAwF;AACxF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;IACzE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwC;IAExE,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAQ5E,2FAA2F;IAC3F,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8BjE,yDAAyD;IACzD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAM5C,qFAAqF;IACrF,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAStD,mEAAmE;IACnE,KAAK,IAAI,IAAI;CAOd"}

package/dist/services/HubNavigation.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HubNavigation = void 0;
+const VIEW_TIMEOUT_MS = 10_000;
+const ACK_TIMEOUT_MS = 2_000;
+const REQUEST_HISTORY_LIMIT = 500;
+/** Delivers ordered explicit opens to one browser view without changing other views. */
+class HubNavigation {
+    sequence = 0;
+    views = new Map();
+    requests = new Map();
+    pendingRequests = new Map();
+    /** Refreshes browser presence independently of project runtime or preview usage. */
+    connect({ viewId, isFocused }) {
+        const now = Date.now();
+        this.views.set(viewId, {
+            lastSeen: now,
+            lastFocused: isFocused ? now : (this.views.get(viewId)?.lastFocused ?? 0),
+        });
+    }
+    /** Queues one idempotent navigation and waits for its receiving view to acknowledge it. */
+    request(request) {
+        const existing = this.requests.get(request.requestId);
+        if (existing)
+            return existing;
+        const now = Date.now();
+        const selected = [...this.views.entries()]
+            .filter(([, view]) => now - view.lastSeen < VIEW_TIMEOUT_MS)
+            .sort((a, b) => b[1].lastFocused - a[1].lastFocused || b[1].lastSeen - a[1].lastSeen)[0];
+        if (!selected)
+            return Promise.resolve({ handled: false });
+        const sequence = ++this.sequence;
+        const promise = new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.pendingRequests.delete(sequence);
+                resolve({ handled: false });
+            }, ACK_TIMEOUT_MS);
+            this.pendingRequests.set(sequence, {
+                navigation: { ...request, sequence },
+                viewId: selected[0],
+                finish: resolve,
+                timer,
+            });
+        });
+        this.requests.set(request.requestId, promise);
+        if (this.requests.size > REQUEST_HISTORY_LIMIT)
+            this.requests.delete(this.requests.keys().next().value);
+        return promise;
+    }
+    /** Returns only this view's ordered navigation queue. */
+    pending(viewId) {
+        return [...this.pendingRequests.values()]
+            .filter((request) => request.viewId === viewId)
+            .map((request) => request.navigation);
+    }
+    /** Accepts acknowledgement only from the receiving view for its pending sequence. */
+    acknowledge(viewId, sequence) {
+        const pending = this.pendingRequests.get(sequence);
+        if (!pending || pending.viewId !== viewId)
+            return false;
+        clearTimeout(pending.timer);
+        this.pendingRequests.delete(sequence);
+        pending.finish({ handled: true });
+        return true;
+    }
+    /** Releases navigation waiters when the coordinator shuts down. */
+    close() {
+        for (const pending of this.pendingRequests.values()) {
+            clearTimeout(pending.timer);
+            pending.finish({ handled: false });
+        }
+        this.pendingRequests.clear();
+    }
+}
+exports.HubNavigation = HubNavigation;
+//# sourceMappingURL=HubNavigation.js.map

package/dist/services/HubNavigation.js.map

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

package/dist/services/ProjectCardPreviews.d.ts

@@ -0,0 +1,27 @@
+import type { LibraryProjectPreview } from '../types/project-library';
+import type { ProjectLibrary } from './ProjectLibrary';
+import type { ProjectRuntimeService } from './ProjectRuntimeService';
+import type { StaticLibraryPreviews } from './StaticLibraryPreviews';
+import type { TelemetryService } from './TelemetryService';
+/** Supplies cached Original images, or the first saved static direction for fresh projects. */
+export declare class ProjectCardPreviews {
+    private readonly services;
+    private readonly pending;
+    private readonly cache;
+    private readonly screenshots;
+    constructor(services: {
+        library: ProjectLibrary;
+        runtime: ProjectRuntimeService;
+        previews: StaticLibraryPreviews;
+        telemetry?: TelemetryService;
+    });
+    /** Deduplicates image work by project without activating its runtime or changing preview selection. */
+    get(projectId: string): Promise<LibraryProjectPreview | null>;
+    /** Releases screenshot processes before the coordinator closes its history stores. */
+    close(): Promise<void>;
+    /** Reuses valid captures and retains Original images while their working runtime is stopped. */
+    private load;
+    /** Keeps filesystem provenance in the cache and returns only image presentation data. */
+    private publicPreview;
+}
+//# sourceMappingURL=ProjectCardPreviews.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectCardPreviews.d.ts","sourceRoot":"","sources":["../../src/services/ProjectCardPreviews.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAKtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAK3D,+FAA+F;AAC/F,qBAAa,mBAAmB;IAS5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAR3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGpB;IACJ,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;gBAG3C,QAAQ,EAAE;QACzB,OAAO,EAAE,cAAc,CAAC;QACxB,OAAO,EAAE,qBAAqB,CAAC;QAC/B,QAAQ,EAAE,qBAAqB,CAAC;QAChC,SAAS,CAAC,EAAE,gBAAgB,CAAC;KAC9B;IAKH,uGAAuG;IACvG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAY7D,sFAAsF;IAChF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,gGAAgG;YAClF,IAAI;IAoElB,yFAAyF;IACzF,OAAO,CAAC,aAAa;CAOtB"}

package/dist/services/ProjectCardPreviews.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectCardPreviews = void 0;
+const ProjectPreviewCache_1 = require("../storage/library/ProjectPreviewCache");
+const ProjectScreenshotService_1 = require("./ProjectScreenshotService");
+const logger_1 = require("../utils/logger");
+const log = (0, logger_1.createLogger)('ProjectCardPreviews');
+/** Supplies cached Original images, or the first saved static direction for fresh projects. */
+class ProjectCardPreviews {
+    services;
+    pending = new Map();
+    cache;
+    screenshots = new ProjectScreenshotService_1.ProjectScreenshotService();
+    constructor(services) {
+        this.services = services;
+        this.cache = new ProjectPreviewCache_1.ProjectPreviewCache(services.library.registry.root);
+    }
+    /** Deduplicates image work by project without activating its runtime or changing preview selection. */
+    get(projectId) {
+        this.services.library.registry.get(projectId);
+        const existing = this.pending.get(projectId);
+        if (existing)
+            return existing;
+        const pending = this.load(projectId);
+        this.pending.set(projectId, pending);
+        void pending
+            .finally(() => this.pending.delete(projectId))
+            .catch(() => undefined);
+        return pending;
+    }
+    /** Releases screenshot processes before the coordinator closes its history stores. */
+    async close() {
+        await this.screenshots.close();
+        await Promise.allSettled(this.pending.values());
+    }
+    /** Reuses valid captures and retains Original images while their working runtime is stopped. */
+    async load(projectId) {
+        const { library, runtime, previews, telemetry } = this.services;
+        const project = library.registry.get(projectId);
+        let cached = null;
+        const startedAt = Date.now();
+        try {
+            const stored = await this.cache.read(projectId);
+            if (stored?.projectPath === project.projectPath)
+                cached = stored;
+            let url = await runtime.originalPreviewUrl(projectId);
+            let sourceKey = 'original';
+            let label = 'Original';
+            if (!url) {
+                if (cached?.sourceKey === 'original')
+                    return this.publicPreview(cached);
+                const first = (await library.listVariants(projectId))
+                    .filter((entry) => entry.manifest.projectKind === 'fresh' && entry.hasStaticPreview)
+                    .sort((a, b) => a.manifest.createdAt.localeCompare(b.manifest.createdAt))[0];
+                if (!first)
+                    return null;
+                const { manifest } = first;
+                sourceKey = JSON.stringify([
+                    manifest.sessionId,
+                    manifest.variantId,
+                    manifest.tree?.treeSha,
+                    manifest.statusChangedAt,
+                ]);
+                label = manifest.label;
+                if (cached?.sourceKey !== sourceKey)
+                    cached = null;
+                if (cached)
+                    return { ...this.publicPreview(cached), label };
+                url = await previews.url({
+                    projectId,
+                    sessionId: manifest.sessionId,
+                    variantId: manifest.variantId,
+                });
+            }
+            if (cached?.sourceKey === sourceKey)
+                return this.publicPreview(cached);
+            const preview = {
+                sourceKey,
+                projectPath: project.projectPath,
+                dataUrl: await this.screenshots.capture(url),
+                label,
+                capturedAt: new Date().toISOString(),
+            };
+            await this.cache.write(projectId, preview);
+            telemetry?.trackLibraryOperation({
+                operation: 'thumbnail_capture',
+                outcome: 'completed',
+                durationMs: Date.now() - startedAt,
+            });
+            return this.publicPreview(preview);
+        }
+        catch (error) {
+            log.debug('Project image is unavailable; retaining its last capture', error);
+            telemetry?.trackLibraryOperation({
+                operation: 'thumbnail_capture',
+                outcome: 'failed',
+                durationMs: Date.now() - startedAt,
+            });
+            return cached ? this.publicPreview(cached) : null;
+        }
+    }
+    /** Keeps filesystem provenance in the cache and returns only image presentation data. */
+    publicPreview(preview) {
+        return {
+            dataUrl: preview.dataUrl,
+            label: preview.label,
+            capturedAt: preview.capturedAt,
+        };
+    }
+}
+exports.ProjectCardPreviews = ProjectCardPreviews;
+//# sourceMappingURL=ProjectCardPreviews.js.map

package/dist/services/ProjectCardPreviews.js.map

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

package/dist/services/ProjectFolderPicker.d.ts

@@ -0,0 +1,20 @@
+interface FolderPickerCommand {
+    executable: string;
+    args: string[];
+    cancelExitCode?: number;
+}
+interface FolderPickerOptions {
+    commands?: FolderPickerCommand[];
+}
+/** Owns one system folder dialog at a time, independently of project registration. */
+export declare class ProjectFolderPicker {
+    private active;
+    private readonly commands;
+    constructor({ commands }?: FolderPickerOptions);
+    /** Opens the host dialog and returns a verified folder, or null when cancelled. */
+    pick(): Promise<string | null>;
+    /** Dismisses the owned dialog when the coordinator shuts down. */
+    close(): void;
+}
+export {};
+//# sourceMappingURL=ProjectFolderPicker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectFolderPicker.d.ts","sourceRoot":"","sources":["../../src/services/ProjectFolderPicker.ts"],"names":[],"mappings":"AAQA,UAAU,mBAAmB;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AACD,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAwGD,sFAAsF;AACtF,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;gBAErC,EAAE,QAAiC,EAAE,GAAE,mBAAwB;IAI3E,mFAAmF;IAC7E,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqDpC,kEAAkE;IAClE,KAAK,IAAI,IAAI;CAGd"}

package/dist/services/ProjectFolderPicker.js

@@ -0,0 +1,174 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectFolderPicker = void 0;
+const child_process_1 = require("child_process");
+const promises_1 = __importDefault(require("fs/promises"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const util_1 = require("util");
+const libraryErrors_1 = require("./libraryErrors");
+const windowPlacement_1 = require("../utils/windowPlacement");
+const execute = (0, util_1.promisify)(child_process_1.execFile);
+const PICKER_TIMEOUT_MS = 5 * 60 * 1000;
+const PICKER_OUTPUT_LIMIT = 64 * 1024;
+const PICKER_TITLE = 'Open a Rivet project';
+const MAC_FOLDER_SCRIPT = `
+ObjC.import('AppKit');
+const anchor = $.NSEvent.mouseLocation;
+const application = $.NSApplication.sharedApplication;
+application.setActivationPolicy($.NSApplicationActivationPolicyAccessory);
+application.finishLaunching;
+const panel = $.NSOpenPanel.openPanel;
+panel.canChooseFiles = false;
+panel.canChooseDirectories = true;
+panel.allowsMultipleSelection = false;
+panel.title = 'Open a Rivet project';
+panel.prompt = 'Open';
+const screens = $.NSScreen.screens;
+let screen = $.NSScreen.mainScreen;
+for (let index = 0; index < screens.count; index++) {
+  const candidate = screens.objectAtIndex(index);
+  if ($.NSPointInRect(anchor, candidate.frame)) {
+    screen = candidate;
+    break;
+  }
+}
+const visible = screen.visibleFrame;
+const position = (${windowPlacement_1.getWindowTopLeft.toString()})({
+  anchor,
+  bounds: {
+    x: visible.origin.x,
+    y: visible.origin.y,
+    width: visible.size.width,
+    height: visible.size.height,
+  },
+  size: {
+    width: panel.frame.size.width,
+    height: panel.frame.size.height,
+  },
+});
+panel.setFrameTopLeftPoint($.NSMakePoint(position.x, position.y));
+application.activateIgnoringOtherApps(true);
+panel.makeKeyAndOrderFront(null);
+panel.runModal === $.NSModalResponseOK ? ObjC.unwrap(panel.URL.path) : '';
+`;
+const WINDOWS_FOLDER_SCRIPT = `
+$ErrorActionPreference = 'Stop'
+[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+Add-Type -AssemblyName System.Windows.Forms
+[System.Windows.Forms.Application]::EnableVisualStyles()
+$dialog = [System.Windows.Forms.FolderBrowserDialog]::new()
+$dialog.Description = 'Open a Rivet project'
+try {
+  if ($dialog.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) {
+    [Console]::Write($dialog.SelectedPath)
+  }
+} finally {
+  $dialog.Dispose()
+}`;
+/** Selects host folder dialogs without constructing a shell command from user input. */
+const folderPickerCommands = () => {
+    switch (process.platform) {
+        case 'darwin':
+            return [
+                {
+                    executable: '/usr/bin/osascript',
+                    args: ['-l', 'JavaScript', '-e', MAC_FOLDER_SCRIPT],
+                },
+            ];
+        case 'win32':
+            return [
+                {
+                    executable: 'powershell.exe',
+                    args: [
+                        '-NoProfile',
+                        '-NonInteractive',
+                        '-STA',
+                        '-Command',
+                        WINDOWS_FOLDER_SCRIPT,
+                    ],
+                },
+            ];
+        case 'linux': {
+            const zenity = {
+                executable: 'zenity',
+                args: ['--file-selection', '--directory', '--title', PICKER_TITLE],
+                cancelExitCode: 1,
+            };
+            const kdialog = {
+                executable: 'kdialog',
+                args: ['--getexistingdirectory', os_1.default.homedir(), '--title', PICKER_TITLE],
+                cancelExitCode: 1,
+            };
+            return process.env.XDG_CURRENT_DESKTOP?.toLowerCase().includes('kde')
+                ? [kdialog, zenity]
+                : [zenity, kdialog];
+        }
+        default:
+            return [];
+    }
+};
+/** Owns one system folder dialog at a time, independently of project registration. */
+class ProjectFolderPicker {
+    active = null;
+    commands;
+    constructor({ commands = folderPickerCommands() } = {}) {
+        this.commands = commands;
+    }
+    /** Opens the host dialog and returns a verified folder, or null when cancelled. */
+    async pick() {
+        if (this.active)
+            throw new libraryErrors_1.LibraryError('folder_picker_busy', 'A folder picker is already open. Choose a folder or cancel it first.');
+        const controller = new AbortController();
+        this.active = controller;
+        try {
+            for (const command of this.commands) {
+                let output;
+                try {
+                    const result = await execute(command.executable, command.args, {
+                        encoding: 'utf8',
+                        windowsHide: true,
+                        timeout: PICKER_TIMEOUT_MS,
+                        maxBuffer: PICKER_OUTPUT_LIMIT,
+                        signal: controller.signal,
+                    });
+                    output = result.stdout;
+                }
+                catch (error) {
+                    if (controller.signal.aborted)
+                        return null;
+                    const failure = error;
+                    if (failure.code === 'ENOENT')
+                        continue;
+                    if (command.cancelExitCode !== undefined &&
+                        failure.code === command.cancelExitCode &&
+                        !failure.stderr?.trim())
+                        return null;
+                    throw new libraryErrors_1.LibraryError('folder_picker_unavailable', 'Could not open the system folder picker. Try again, or run rivet open --project <path> in a terminal.');
+                }
+                const selected = output.replace(/\r?\n$/, '');
+                if (!selected)
+                    return null;
+                if (!path_1.default.isAbsolute(selected))
+                    throw new Error('Select an existing folder.');
+                const canonical = await promises_1.default.realpath(selected);
+                if (!(await promises_1.default.stat(canonical)).isDirectory())
+                    throw new Error('Select an existing folder.');
+                return canonical;
+            }
+            throw new libraryErrors_1.LibraryError('folder_picker_unavailable', 'No system folder picker is available. On Linux, install Zenity or KDialog, or run rivet open --project <path> in a terminal.');
+        }
+        finally {
+            this.active = null;
+        }
+    }
+    /** Dismisses the owned dialog when the coordinator shuts down. */
+    close() {
+        this.active?.abort();
+    }
+}
+exports.ProjectFolderPicker = ProjectFolderPicker;
+//# sourceMappingURL=ProjectFolderPicker.js.map

package/dist/services/ProjectFolderPicker.js.map

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

package/dist/services/ProjectImport.d.ts

@@ -0,0 +1,13 @@
+import type { ProjectRegistry } from './ProjectRegistry';
+interface ImportOptions {
+    registry: ProjectRegistry;
+    projectId: string;
+}
+export type ProjectImportResult = {
+    status: 'imported' | 'current' | 'deferred' | 'diverged';
+    reason?: string;
+};
+/** Copies and verifies a quiescent source before publishing its durable bundle. */
+export declare const importProject: ({ registry, projectId, }: ImportOptions) => Promise<ProjectImportResult>;
+export {};
+//# sourceMappingURL=ProjectImport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectImport.d.ts","sourceRoot":"","sources":["../../src/services/ProjectImport.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASzD,UAAU,aAAa;IACrB,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAuEF,mFAAmF;AACnF,eAAO,MAAM,aAAa,GAAU,0BAGjC,aAAa,KAAG,OAAO,CAAC,mBAAmB,CAiM7C,CAAC"}