rivet-design 0.9.3 → 0.9.5

package/dist/services/VariantHistoryService.d.ts

@@ -0,0 +1,117 @@
+export type VariantHistoryStatus = 'completed' | 'committed' | 'rejected' | 'cancelled';
+export type VariantHistoryKind = 'diff' | 'project-created';
+/** Where the persisted DESIGN.md came from. Slug entries point at a curated
+ *  catalog inspiration; markdown entries carry user-supplied / Agent Browser
+ *  extracted content. `label` is always human-readable for the history UI. */
+export interface VariantDesignSource {
+    kind: 'slug' | 'markdown';
+    label: string;
+    /** Catalog slug — present only when `kind === 'slug'`. */
+    slug?: string;
+}
+export interface VariantHistoryManifest {
+    schemaVersion: number;
+    variantId: string;
+    sessionId: string;
+    label: string;
+    brief: string;
+    sessionPrompt: string;
+    kind: VariantHistoryKind;
+    status: VariantHistoryStatus;
+    createdAt: string;
+    statusChangedAt: string;
+    baseSha?: string;
+    destinationPath?: string;
+    changedFilesCount: number;
+    designSource?: VariantDesignSource;
+}
+export interface VariantHistorySessionFile {
+    schemaVersion: number;
+    sessionId: string;
+    createdAt: string;
+    sessionPrompt: string;
+    projectKind: 'existing' | 'fresh';
+}
+export interface PersistVariantArgs {
+    projectPath: string;
+    sessionId: string;
+    variantId: string;
+    label: string;
+    brief: string;
+    sessionPrompt: string;
+    kind: VariantHistoryKind;
+    /** Required when kind === 'diff'. */
+    diff?: string;
+    /** Required when kind === 'project-created'. Directory whose contents are copied into `files/`. */
+    sourceDir?: string;
+    baseSha?: string;
+    destinationPath?: string;
+    changedFilesCount: number;
+    /** Defaults to 'completed'. Use 'committed' / 'rejected' when persisting at commit time. */
+    initialStatus?: VariantHistoryStatus;
+    projectKind: 'existing' | 'fresh';
+    /** Generated DESIGN.md body to persist as a top-level artifact alongside
+     *  the diff/files. Currently only populated for fresh-project variants —
+     *  existing-project variants don't generate a DESIGN.md. */
+    designMarkdown?: string;
+    designSource?: VariantDesignSource;
+}
+export interface ListVariantsArgs {
+    projectPath: string;
+    limit?: number;
+    status?: VariantHistoryStatus;
+}
+export interface VariantHistoryEntry {
+    manifest: VariantHistoryManifest;
+    /** Absolute path to the variant's directory under `.rivet/variants/<sessionId>/<variantId>/`. */
+    variantDir: string;
+    /** True when `files/index.html` exists on disk — i.e. the variant can be
+     *  rendered as a static preview in an iframe. Vite_app variants and diff
+     *  variants are false. Computed at list/get time so the UI can filter
+     *  click-to-preview affordances without poking the disk itself. */
+    hasStaticPreview: boolean;
+}
+export interface VariantHistoryDetail extends VariantHistoryEntry {
+    /** Diff body — present for `kind: 'diff'` variants. */
+    diff?: string;
+    /** Project-relative file list under `files/` — present for `kind: 'project-created'` variants. */
+    files?: string[];
+    /** Generated DESIGN.md body — present when the variant was scaffolded with
+     *  a design context (fresh-project variants only). */
+    designMarkdown?: string;
+}
+export declare class VariantHistoryService {
+    variantsRoot(projectPath: string): string;
+    sessionDir(projectPath: string, sessionId: string): string;
+    variantDir(projectPath: string, sessionId: string, variantId: string): string;
+    persistVariant(args: PersistVariantArgs): Promise<void>;
+    markStatus(args: {
+        projectPath: string;
+        sessionId: string;
+        variantId: string;
+        status: VariantHistoryStatus;
+        /** Optional manifest patch applied alongside the status flip. Used at
+         *  commit time so the chosen fresh-project variant records the path
+         *  the materialized project landed at. */
+        destinationPath?: string;
+    }): Promise<void>;
+    listVariants(args: ListVariantsArgs): Promise<VariantHistoryEntry[]>;
+    getVariant(args: {
+        projectPath: string;
+        sessionId: string;
+        variantId: string;
+    }): Promise<VariantHistoryDetail | null>;
+    /**
+     * Read the persisted static-preview HTML for a variant. Returns null when
+     * the variant isn't on disk or doesn't have a `files/index.html`. Used by
+     * the REST history-static endpoint that backs the AgentVariantsPanel
+     * iframe when a past variant is clicked.
+     */
+    readStaticPreview(args: {
+        projectPath: string;
+        sessionId: string;
+        variantId: string;
+    }): Promise<string | null>;
+    ensureGitignore(projectPath: string): Promise<void>;
+}
+//# sourceMappingURL=VariantHistoryService.d.ts.map

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

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

package/dist/services/VariantHistoryService.js

@@ -0,0 +1,385 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VariantHistoryService = void 0;
+const fs_1 = __importDefault(require("fs"));
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const logger_1 = require("../utils/logger");
+const log = (0, logger_1.createLogger)('VariantHistoryService');
+const HISTORY_SCHEMA_VERSION = 1;
+const RIVET_DIRNAME = '.rivet';
+const VARIANTS_DIRNAME = 'variants';
+const SESSION_FILENAME = 'session.json';
+const MANIFEST_FILENAME = 'manifest.json';
+const DIFF_FILENAME = 'diff.patch';
+const FILES_DIRNAME = 'files';
+const DESIGN_FILENAME = 'DESIGN.md';
+const STATIC_INDEX_FILENAME = 'index.html';
+const GITIGNORE_FILENAME = '.gitignore';
+const GITIGNORE_LINE = '.rivet/';
+const COPY_EXCLUDE = new Set([
+    'node_modules',
+    '.git',
+    '.vite',
+    '.rivet',
+    'dist',
+    'build',
+    '.next',
+    '.cache',
+]);
+/** Statuses that are end-states from the user's perspective — once a variant
+ *  reaches one of these, history must not silently regress it (e.g. a late
+ *  `persistVariant` from the success path shouldn't reset a `committed`
+ *  manifest to `completed`, and `markPersistedVariantsCancelled` shouldn't
+ *  overwrite the chosen variant's `committed` status with `cancelled`). */
+const TERMINAL_STATUSES = new Set([
+    'committed',
+    'rejected',
+]);
+/** Reject ids containing path separators, `..`, or NUL bytes so caller-
+ *  controlled REST/MCP input can't escape `<project>/.rivet/variants/`. ids
+ *  are produced by `crypto.randomUUID()` and stored slugs, both of which fit
+ *  this character class. */
+const SAFE_ID_PATTERN = /^[A-Za-z0-9_-]+$/;
+const assertSafeId = (value, name) => {
+    if (!SAFE_ID_PATTERN.test(value)) {
+        throw new Error(`VariantHistoryService: invalid ${name} '${value}' — must match ${SAFE_ID_PATTERN}`);
+    }
+};
+class VariantHistoryService {
+    variantsRoot(projectPath) {
+        return path_1.default.join(projectPath, RIVET_DIRNAME, VARIANTS_DIRNAME);
+    }
+    sessionDir(projectPath, sessionId) {
+        return path_1.default.join(this.variantsRoot(projectPath), sessionId);
+    }
+    variantDir(projectPath, sessionId, variantId) {
+        return path_1.default.join(this.sessionDir(projectPath, sessionId), variantId);
+    }
+    async persistVariant(args) {
+        assertSafeId(args.sessionId, 'sessionId');
+        assertSafeId(args.variantId, 'variantId');
+        if (args.kind === 'diff' && args.diff === undefined) {
+            throw new Error(`persistVariant: kind='diff' requires a diff body (sessionId=${args.sessionId} variantId=${args.variantId})`);
+        }
+        if (args.kind === 'project-created' && !args.sourceDir) {
+            throw new Error(`persistVariant: kind='project-created' requires sourceDir (sessionId=${args.sessionId} variantId=${args.variantId})`);
+        }
+        const sessionDir = this.sessionDir(args.projectPath, args.sessionId);
+        const variantDir = this.variantDir(args.projectPath, args.sessionId, args.variantId);
+        await promises_1.default.mkdir(variantDir, { recursive: true });
+        // Race guard: persistVariant runs at code_gen success and again on retries
+        // / late callbacks. If the manifest has already reached a terminal status
+        // via markStatus (committed/rejected), preserve that status so the late
+        // persist doesn't silently reset the user's pick to `completed`.
+        const existingManifestPath = path_1.default.join(variantDir, MANIFEST_FILENAME);
+        let preservedStatus;
+        let preservedStatusChangedAt;
+        let preservedDestinationPath;
+        try {
+            const raw = await promises_1.default.readFile(existingManifestPath, 'utf8');
+            const prior = JSON.parse(raw);
+            if (TERMINAL_STATUSES.has(prior.status)) {
+                preservedStatus = prior.status;
+                preservedStatusChangedAt = prior.statusChangedAt;
+                preservedDestinationPath = prior.destinationPath;
+            }
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'ENOENT') {
+                log.warn(`persistVariant: prior manifest read failed at ${existingManifestPath}`, err);
+            }
+        }
+        const sessionPath = path_1.default.join(sessionDir, SESSION_FILENAME);
+        if (!fs_1.default.existsSync(sessionPath)) {
+            const sessionFile = {
+                schemaVersion: HISTORY_SCHEMA_VERSION,
+                sessionId: args.sessionId,
+                createdAt: new Date().toISOString(),
+                sessionPrompt: args.sessionPrompt,
+                projectKind: args.projectKind,
+            };
+            await promises_1.default.writeFile(sessionPath, `${JSON.stringify(sessionFile, null, 2)}\n`, 'utf8');
+        }
+        const now = new Date().toISOString();
+        const manifest = {
+            schemaVersion: HISTORY_SCHEMA_VERSION,
+            variantId: args.variantId,
+            sessionId: args.sessionId,
+            label: args.label,
+            brief: args.brief,
+            sessionPrompt: args.sessionPrompt,
+            kind: args.kind,
+            status: preservedStatus ?? args.initialStatus ?? 'completed',
+            createdAt: now,
+            statusChangedAt: preservedStatusChangedAt ?? now,
+            baseSha: args.baseSha,
+            destinationPath: preservedDestinationPath ?? args.destinationPath,
+            changedFilesCount: args.changedFilesCount,
+            designSource: args.designSource,
+        };
+        await promises_1.default.writeFile(path_1.default.join(variantDir, MANIFEST_FILENAME), `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
+        if (args.kind === 'diff') {
+            await promises_1.default.writeFile(path_1.default.join(variantDir, DIFF_FILENAME), args.diff ?? '', 'utf8');
+        }
+        else {
+            const filesDir = path_1.default.join(variantDir, FILES_DIRNAME);
+            await promises_1.default.rm(filesDir, { recursive: true, force: true });
+            await copyDirFiltered(args.sourceDir, filesDir);
+        }
+        if (args.designMarkdown !== undefined) {
+            await promises_1.default.writeFile(path_1.default.join(variantDir, DESIGN_FILENAME), args.designMarkdown, 'utf8');
+        }
+        await this.ensureGitignore(args.projectPath);
+        log.info(`Persisted variant ${args.variantId} (session ${args.sessionId}, kind ${args.kind}, status ${manifest.status})`);
+    }
+    async markStatus(args) {
+        assertSafeId(args.sessionId, 'sessionId');
+        assertSafeId(args.variantId, 'variantId');
+        const manifestPath = path_1.default.join(this.variantDir(args.projectPath, args.sessionId, args.variantId), MANIFEST_FILENAME);
+        let manifest;
+        try {
+            const raw = await promises_1.default.readFile(manifestPath, 'utf8');
+            manifest = JSON.parse(raw);
+        }
+        catch (err) {
+            // ENOENT is the expected "variant was never persisted" case — any
+            // caller that drives the state machine via stubs skips the persistence
+            // hook. Only surface unexpected errors (permission denied, corrupt JSON).
+            const code = err.code;
+            if (code !== 'ENOENT') {
+                log.warn(`markStatus: manifest read failed at ${manifestPath} (session ${args.sessionId} variant ${args.variantId})`, err);
+            }
+            return;
+        }
+        // Refuse to downgrade a terminal status. Specifically blocks
+        // markPersistedVariantsCancelled from rewriting a committed/rejected
+        // variant as `cancelled` when the session tears down post-commit, and
+        // prevents stray late-cancels from clobbering a finalized pick.
+        if (TERMINAL_STATUSES.has(manifest.status) &&
+            manifest.status !== args.status) {
+            return;
+        }
+        const destinationChanged = args.destinationPath !== undefined &&
+            manifest.destinationPath !== args.destinationPath;
+        if (manifest.status === args.status && !destinationChanged)
+            return;
+        manifest.status = args.status;
+        manifest.statusChangedAt = new Date().toISOString();
+        if (args.destinationPath !== undefined) {
+            manifest.destinationPath = args.destinationPath;
+        }
+        await promises_1.default.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
+    }
+    async listVariants(args) {
+        const root = this.variantsRoot(args.projectPath);
+        if (!fs_1.default.existsSync(root))
+            return [];
+        let sessionIds;
+        try {
+            sessionIds = await promises_1.default.readdir(root);
+        }
+        catch (err) {
+            log.warn(`listVariants: failed to read ${root}`, err);
+            return [];
+        }
+        const entries = [];
+        for (const sessionId of sessionIds) {
+            const sessionDir = path_1.default.join(root, sessionId);
+            const stat = await safeStat(sessionDir);
+            if (!stat?.isDirectory())
+                continue;
+            let variantIds;
+            try {
+                variantIds = await promises_1.default.readdir(sessionDir);
+            }
+            catch {
+                continue;
+            }
+            for (const variantId of variantIds) {
+                const variantDir = path_1.default.join(sessionDir, variantId);
+                const vStat = await safeStat(variantDir);
+                if (!vStat?.isDirectory())
+                    continue;
+                const manifest = await readManifest(path_1.default.join(variantDir, MANIFEST_FILENAME));
+                if (!manifest)
+                    continue;
+                if (args.status && manifest.status !== args.status)
+                    continue;
+                const hasStaticPreview = await fileExists(path_1.default.join(variantDir, FILES_DIRNAME, STATIC_INDEX_FILENAME));
+                entries.push({ manifest, variantDir, hasStaticPreview });
+            }
+        }
+        entries.sort((a, b) => b.manifest.createdAt.localeCompare(a.manifest.createdAt));
+        if (args.limit !== undefined && args.limit > 0) {
+            return entries.slice(0, args.limit);
+        }
+        return entries;
+    }
+    async getVariant(args) {
+        assertSafeId(args.sessionId, 'sessionId');
+        assertSafeId(args.variantId, 'variantId');
+        const variantDir = this.variantDir(args.projectPath, args.sessionId, args.variantId);
+        const manifest = await readManifest(path_1.default.join(variantDir, MANIFEST_FILENAME));
+        if (!manifest)
+            return null;
+        const hasStaticPreview = await fileExists(path_1.default.join(variantDir, FILES_DIRNAME, STATIC_INDEX_FILENAME));
+        const detail = {
+            manifest,
+            variantDir,
+            hasStaticPreview,
+        };
+        if (manifest.kind === 'diff') {
+            try {
+                detail.diff = await promises_1.default.readFile(path_1.default.join(variantDir, DIFF_FILENAME), 'utf8');
+            }
+            catch {
+                detail.diff = '';
+            }
+        }
+        else {
+            detail.files = await listFilesRecursive(path_1.default.join(variantDir, FILES_DIRNAME));
+        }
+        try {
+            detail.designMarkdown = await promises_1.default.readFile(path_1.default.join(variantDir, DESIGN_FILENAME), 'utf8');
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'ENOENT') {
+                log.warn(`getVariant: DESIGN.md read failed at ${variantDir}`, err);
+            }
+        }
+        return detail;
+    }
+    /**
+     * Read the persisted static-preview HTML for a variant. Returns null when
+     * the variant isn't on disk or doesn't have a `files/index.html`. Used by
+     * the REST history-static endpoint that backs the AgentVariantsPanel
+     * iframe when a past variant is clicked.
+     */
+    async readStaticPreview(args) {
+        assertSafeId(args.sessionId, 'sessionId');
+        assertSafeId(args.variantId, 'variantId');
+        const indexPath = path_1.default.join(this.variantDir(args.projectPath, args.sessionId, args.variantId), FILES_DIRNAME, STATIC_INDEX_FILENAME);
+        try {
+            return await promises_1.default.readFile(indexPath, 'utf8');
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'ENOENT') {
+                log.warn(`readStaticPreview: failed at ${indexPath}`, err);
+            }
+            return null;
+        }
+    }
+    async ensureGitignore(projectPath) {
+        const gitignorePath = path_1.default.join(projectPath, GITIGNORE_FILENAME);
+        let current = '';
+        try {
+            current = await promises_1.default.readFile(gitignorePath, 'utf8');
+        }
+        catch (err) {
+            const code = err.code;
+            if (code !== 'ENOENT') {
+                log.warn(`ensureGitignore: read ${gitignorePath} failed`, err);
+                return;
+            }
+        }
+        // Any line that, on its own, already excludes the whole `.rivet/` tree.
+        // Narrower patterns like `.rivet/variants/` (what older Rivet versions
+        // wrote) do NOT count — we want `.rivet/<slug>/` snapshots, manifests, and
+        // history all covered by a single broad rule, so we append the broader
+        // pattern alongside.
+        const lines = current.split(/\r?\n/);
+        const alreadyCoversAll = lines.some((line) => {
+            const trimmed = line.trim();
+            return (trimmed === '.rivet' ||
+                trimmed === '.rivet/' ||
+                trimmed === '/.rivet' ||
+                trimmed === '/.rivet/' ||
+                trimmed === '**/.rivet' ||
+                trimmed === '**/.rivet/');
+        });
+        if (alreadyCoversAll)
+            return;
+        const needsNewline = current.length > 0 && !current.endsWith('\n');
+        const appended = `${current}${needsNewline ? '\n' : ''}${GITIGNORE_LINE}\n`;
+        await promises_1.default.writeFile(gitignorePath, appended, 'utf8');
+        log.info(`Appended ${GITIGNORE_LINE} to ${gitignorePath}`);
+    }
+}
+exports.VariantHistoryService = VariantHistoryService;
+async function readManifest(manifestPath) {
+    try {
+        const raw = await promises_1.default.readFile(manifestPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.variantId !== 'string')
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+async function safeStat(p) {
+    try {
+        return await promises_1.default.stat(p);
+    }
+    catch {
+        return null;
+    }
+}
+async function fileExists(p) {
+    try {
+        const s = await promises_1.default.stat(p);
+        return s.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function copyDirFiltered(src, dest) {
+    await promises_1.default.mkdir(dest, { recursive: true });
+    const entries = await promises_1.default.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        if (COPY_EXCLUDE.has(entry.name))
+            continue;
+        const from = path_1.default.join(src, entry.name);
+        const to = path_1.default.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDirFiltered(from, to);
+        }
+        else if (entry.isFile()) {
+            await promises_1.default.copyFile(from, to);
+        }
+        // Symlinks are deliberately dropped. Source dirs are agent-controlled
+        // (variant worktrees) and `readStaticPreview` later serves whatever
+        // `files/index.html` points at through the history static route —
+        // preserving a symlink to e.g. ~/.ssh/id_rsa would turn that route into
+        // a host-file read primitive.
+    }
+}
+async function listFilesRecursive(root) {
+    if (!fs_1.default.existsSync(root))
+        return [];
+    const out = [];
+    const walk = async (dir, prefix) => {
+        const entries = await promises_1.default.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                await walk(path_1.default.join(dir, entry.name), rel);
+            }
+            else if (entry.isFile()) {
+                out.push(rel);
+            }
+        }
+    };
+    await walk(root, '');
+    return out.sort();
+}
+//# sourceMappingURL=VariantHistoryService.js.map

package/dist/services/VariantHistoryService.js.map

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

package/dist/services/WorktreeManager.d.ts

@@ -2,6 +2,7 @@ import { type ChildProcess } from 'child_process';
 import { type TemplateBundle } from './templates/viteReactTs';
 import type { DesignContextEntry } from '../mcp/agent-variants/contracts';
 import type { SourceContextInput } from '../mcp/agent-variants/contracts';
+export declare const FRESH_WORKTREES_DIRNAME = ".rivet-variants";
 export declare const INSTANCE_PREFIX: string;
 export declare class WorktreeManager {
     private readonly resolveProjectPath;
@@ -69,6 +70,13 @@ export declare class WorktreeManager {
      * which would wipe the user's pre-existing work.
      */
     applyDiff(diff: string, reverse: boolean): Promise<void>;
+    /**
+     * Apply a unified diff to an arbitrary project path. Same engine as
+     * `applyDiff` but the cwd is a parameter, so callers (e.g. the variants
+     * orchestrator) can target the user's project regardless of which path this
+     * manager instance was constructed with.
+     */
+    applyDiffToProject(diff: string, projectPath: string): Promise<void>;
     /** Bind port 0 to get an OS-assigned free port */
     getFreePort(): Promise<number>;
     /** Validate a diff via `git apply --check` without modifying files */
@@ -85,22 +93,34 @@ export declare class WorktreeManager {
      *  For existing-project sessions, asks git to unregister the worktree
      *  (handles `.git/worktrees/*` cleanup) and falls back to plain rm. For
      *  fresh-project sessions (no projectPath) the worktrees are detached
-     *  directories with their own `.git` — git registry cleanup is a no-op
-     *  and we just rm the matching `/tmp` directories.
+     *  directories with their own `.git` under `<destinationParent>/.rivet-variants/`
+     *  — git registry cleanup is a no-op and we just rm the matching dirs.
+     *
+     *  `freshDestinationParent` is required when the session was fresh; pass
+     *  `path.dirname(projectContext.workspacePath)` so we know which
+     *  `.rivet-variants/` root to sweep.
      */
-    cleanupSession(sessionId: string): Promise<void>;
+    cleanupSession(sessionId: string, freshDestinationParent?: string): Promise<void>;
     /**
      * Create N worktrees for a fresh-project session by writing a template
-     * bundle into each `/tmp/rivet-variants-pid<PID>-<sessionId>-<i>` directory,
-     * optionally writing a DESIGN.md per slot, and committing a baseline.
+     * bundle into each `<destinationParent>/.rivet-variants/rivet-variants-pid<PID>-<sessionId>-<i>`
+     * directory, optionally writing a DESIGN.md per slot, and committing a
+     * baseline.
+     *
+     * Worktrees live under the user's destinationParent (not /tmp) so commit
+     * time can be a same-volume rename instead of a cross-volume copy. The
+     * destinationParent is registered to a small JSON file so a future MCP
+     * startup can sweep orphans even when the original process crashed.
      *
      * Does NOT run `npm install` — the orchestrator dispatches that as a
      * background task so failures surface via work-item state without blocking
      * the MCP tool response.
      *
-     * @effect Creates /tmp directories, writes template files, runs git init/add/commit.
+     * @effect Creates directories under destinationParent, writes template
+     *         files, runs git init/add/commit, appends destinationParent to
+     *         the fresh-worktree-roots registry.
      */
-    createFreshWorktrees(sessionId: string, count: number, template: TemplateBundle, designContext?: ReadonlyArray<DesignContextEntry | undefined>, sourceContext?: SourceContextInput): Promise<string[]>;
+    createFreshWorktrees(sessionId: string, count: number, template: TemplateBundle, designContext: ReadonlyArray<DesignContextEntry | undefined> | undefined, sourceContext: SourceContextInput | undefined, destinationParent: string): Promise<string[]>;
     /**
      * Write SOURCE_CONTEXT.md when source context exists for the session.
      *
@@ -113,13 +133,51 @@ export declare class WorktreeManager {
      * @effect Writes DESIGN.md when a design context is available.
      */
     private writeDesignContext;
+    /**
+     * Move a worktree to its history location preserving contents. Used by the
+     * orchestrator at commit time so unchosen variants survive on disk as
+     * runnable references (siblings of the chosen project).
+     *
+     * Returns the destination path (`<historyDir>/<folderName>`).
+     *
+     * @effect renames `srcWorktreePath` → `<historyDir>/<folderName>`, creating
+     *         the historyDir if needed.
+     */
+    moveWorktreeToHistory(srcWorktreePath: string, historyDir: string, folderName: string): string;
+    /**
+     * Repoint a worktree's `node_modules` at a relative symlink so it tracks
+     * the chosen variant's real install after both have moved into their new
+     * permanent homes. Idempotent — removes any existing entry first.
+     */
+    repointNodeModulesSymlink(worktreePath: string, sharedNodeModulesAbsPath: string): void;
     /** Remove all fresh worktrees for a session.
      *
-     *  @effect Removes /tmp directories matching ${INSTANCE_PREFIX}-<sessionId>-*.
+     *  @effect Removes directories under <destinationParent>/.rivet-variants/
+     *          matching ${INSTANCE_PREFIX}-<sessionId>-*. Also removes the
+     *          .rivet-variants/ parent if it becomes empty so the editor file
+     *          tree doesn't accumulate noise.
+     *
+     *  When `preserve` is provided, entries whose basenames are in the set are
+     *  skipped — used by the orchestrator after a vite_app commit, where the
+     *  unchosen variant worktrees have already been moved to a sibling history
+     *  dir and must not be re-deleted.
      */
-    cleanupFreshWorktrees(sessionId: string): void;
+    cleanupFreshWorktrees(sessionId: string, destinationParent: string, preserve?: ReadonlySet<string>): void;
     private assertSafeSessionId;
 }
+/**
+ * Append a freshRoot path to the registry (de-duped). Called by
+ * createFreshWorktrees so future MCP startups can sweep orphans even if
+ * the original process crashed before teardown ran.
+ */
+export declare const registerFreshWorktreeRoot: (freshRoot: string) => void;
+/**
+ * Sweep orphan worktrees from /tmp (existing-project flow) and from every
+ * registered fresh-worktree root (fresh-project flow). Filters by
+ * INSTANCE_PREFIX (includes PID) so each server instance only removes its
+ * own worktrees and never touches those of sibling instances. Prunes
+ * registry entries whose directory no longer exists so the file stays small.
+ */
 export declare const cleanupOrphanedWorktrees: () => void;
 /**
  * Prune stale worktree registry entries for a project (`.git/worktrees/<name>`