rivet-design 0.17.3 → 0.17.5

package/dist/services/FeatureFlagService.d.ts

@@ -1,24 +1,9 @@
-/**
- * Evaluates PostHog feature flags for the current user.
- *
- * Env-var overrides are handled in evaluateFlags.ts, not here.
- */
 declare class FeatureFlagService {
     private posthog;
     constructor();
     private get defaultUserKey();
-    /**
-     * Gets the feature flag user key for this evaluation.
-     */
     private getUserKey;
-    /**
-     * Fetch all flags for the selected user in a single request.
-     */
     getAllFlags(userKey?: string): Promise<Record<string, boolean | string>>;
-    /**
-     * Evaluate a single flag for the selected user.
-     * Useful when a flag key is missing from getAllFlags() (e.g. inactive flags).
-     */
     isFeatureEnabled(key: string, userKey?: string): Promise<boolean | null>;
     shutdown(): Promise<void>;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"FeatureFlagService.d.ts","sourceRoot":"","sources":["../../src/services/FeatureFlagService.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,OAAO,CAAwB;;IAsBvC,OAAO,KAAK,cAAc,GAEzB;IAED;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACG,WAAW,CACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;IAW5C;;;OAGG;IACG,gBAAgB,CACpB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAiBpB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAMhC;AAID,wBAAgB,qBAAqB,IAAI,kBAAkB,CAK1D"}
+{"version":3,"file":"FeatureFlagService.d.ts","sourceRoot":"","sources":["../../src/services/FeatureFlagService.ts"],"names":[],"mappings":"AAcA,cAAM,kBAAkB;IACtB,OAAO,CAAC,OAAO,CAAwB;;IAqBvC,OAAO,KAAK,cAAc,GAEzB;IAED,OAAO,CAAC,UAAU;IAOZ,WAAW,CACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC;IAWtC,gBAAgB,CACpB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAepB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAMhC;AAID,wBAAgB,qBAAqB,IAAI,kBAAkB,CAK1D"}

package/dist/services/FeatureFlagService.js

@@ -7,20 +7,10 @@ const ConfigManager_1 = require("./ConfigManager");
 const proxy_1 = require("../config/proxy");
 const log = (0, logger_1.createLogger)('FeatureFlagService');
 const POSTHOG_PUBLIC_API_KEY = 'phc_Ntj9tXHbS64XgYxlTfhglRmFivFsfm0AERph4ZlnNH';
-/**
- * Opt out of live PostHog flag evaluation. When set, flags resolve from local
- * registry defaults + env overrides only — deterministic, with no dependency on
- * remote flag state. Used by e2e/CI (see e2e/scripts/start-rivet-e2e.ts).
- */
 const remoteFlagsDisabled = () => {
     const v = process.env.RIVET_DISABLE_REMOTE_FLAGS;
     return v !== undefined && v !== 'false' && v !== '0';
 };
-/**
- * Evaluates PostHog feature flags for the current user.
- *
- * Env-var overrides are handled in evaluateFlags.ts, not here.
- */
 class FeatureFlagService {
     posthog = null;
     constructor() {
@@ -31,7 +21,6 @@ class FeatureFlagService {
         try {
             this.posthog = new posthog_node_1.PostHog(POSTHOG_PUBLIC_API_KEY, {
                 host: proxy_1.POSTHOG_HOST,
-                // Disable periodic flushing — this client is only used for flag reads
                 flushAt: 1,
                 flushInterval: 0,
             });
@@ -44,18 +33,12 @@ class FeatureFlagService {
     get defaultUserKey() {
         return (0, ConfigManager_1.getConfigManager)().getEmail() ?? (0, ConfigManager_1.getConfigManager)().getAnonymousId();
     }
-    /**
-     * Gets the feature flag user key for this evaluation.
-     */
     getUserKey(userKey) {
         const trimmedUserKey = userKey?.trim();
         return trimmedUserKey && trimmedUserKey.length > 0
             ? trimmedUserKey
             : this.defaultUserKey;
     }
-    /**
-     * Fetch all flags for the selected user in a single request.
-     */
     async getAllFlags(userKey) {
         if (!this.posthog)
             return {};
@@ -67,17 +50,11 @@ class FeatureFlagService {
             return {};
         }
     }
-    /**
-     * Evaluate a single flag for the selected user.
-     * Useful when a flag key is missing from getAllFlags() (e.g. inactive flags).
-     */
     async isFeatureEnabled(key, userKey) {
         if (!this.posthog)
             return null;
         try {
             const enabled = await this.posthog.isFeatureEnabled(key, this.getUserKey(userKey));
-            // PostHog can return undefined for flags that are inactive/unresolved.
-            // Treat unresolved as disabled; reserve null for transport/runtime failures.
             return enabled ?? false;
         }
         catch (error) {

package/dist/services/FeatureFlagService.js.map

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

package/dist/services/GatewayClient.d.ts

@@ -5,12 +5,7 @@ type GatewayRequestOptions = {
     prompt: string;
     timeoutMs?: number;
 };
-/** Anthropic-supported image media types for multimodal content blocks. */
 export type GatewayImageMediaType = 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';
-/**
- * One image attached to a gateway request as an Anthropic `image` content
- * block. `data` is the raw base64-encoded bytes WITHOUT a `data:` URI prefix.
- */
 export type GatewayImageContent = {
     mediaType: GatewayImageMediaType;
     data: string;
@@ -27,44 +22,22 @@ type GatewayToolUseOptions = {
         input_schema: Record<string, unknown>;
         strict?: boolean;
     };
-    /** Wrap the system prompt in a cache_control block for prompt caching. */
     cacheSystemPrompt?: boolean;
-    /** Optional images sent ahead of the text prompt as Anthropic image
-     *  content blocks. Enables multimodal (vision) tool-use calls such as the
-     *  design self-critique scoring a rendered screenshot. */
     images?: GatewayImageContent[];
     timeoutMs?: number;
 };
 export declare const asReasonText: (value: unknown) => string;
-/**
- * Sends authenticated requests to the Rivet LLM gateway.
- * Handles JWT auth, automatic token refresh on 401, and rate limit errors.
- */
 export declare class GatewayClient {
     private configManager;
     private gatewayUrl;
     private proxyUrl;
     constructor(gatewayUrl?: string, proxyUrl?: string);
-    /** Send a message to the gateway and return the raw text response. */
     sendMessage(options: GatewayRequestOptions): Promise<string>;
-    /**
-     * Send a request that forces the model to invoke a single tool, and return
-     * the parsed `input` of that tool call. Throws if the model didn't call the
-     * tool (which the API guarantees won't happen with `tool_choice: { type:
-     * 'tool' }`, but we check anyway).
-     */
     sendToolUse<TInput>(options: GatewayToolUseOptions): Promise<TInput>;
-    /**
-     * Force a vision tool-use call that scores one or more images against a
-     * rubric, returning the parsed tool `input`. Thin wrapper over
-     * `sendToolUse` that attaches the image content blocks — used by the
-     * design self-critique to score a rendered variant screenshot.
-     */
     scoreImage<TInput>(options: GatewayToolUseOptions & {
         images: GatewayImageContent[];
     }): Promise<TInput>;
     private postMessages;
-    /** Refresh the access token using the stored refresh token. */
     private refreshAccessToken;
 }
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"GatewayClient.d.ts","sourceRoot":"","sources":["../../src/services/GatewayClient.ts"],"names":[],"mappings":"AAMA,KAAK,qBAAqB,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,qBAAqB,GAC7B,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,WAAW,CAAC;AAEhB;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,qBAAqB,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;8DAE0D;IAC1D,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AA4BF,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAsB7C,CAAC;AAEF;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;gBAEb,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAKlD,sEAAsE;IAChE,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBlE;;;;;OAKG;IACG,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyC1E;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EACrB,OAAO,EAAE,qBAAqB,GAAG;QAAE,MAAM,EAAE,mBAAmB,EAAE,CAAA;KAAE,GACjE,OAAO,CAAC,MAAM,CAAC;YAIJ,YAAY;IAoF1B,+DAA+D;YACjD,kBAAkB;CAoCjC"}
+{"version":3,"file":"GatewayClient.d.ts","sourceRoot":"","sources":["../../src/services/GatewayClient.ts"],"names":[],"mappings":"AAMA,KAAK,qBAAqB,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B,WAAW,GACX,YAAY,GACZ,YAAY,GACZ,WAAW,CAAC;AAEhB,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,qBAAqB,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAsBF,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,MAsB7C,CAAC;AAEF,qBAAa,aAAa;IACxB,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;gBAEb,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAK5C,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB5D,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAyCpE,UAAU,CAAC,MAAM,EACrB,OAAO,EAAE,qBAAqB,GAAG;QAAE,MAAM,EAAE,mBAAmB,EAAE,CAAA;KAAE,GACjE,OAAO,CAAC,MAAM,CAAC;YAIJ,YAAY;YAmFZ,kBAAkB;CAoCjC"}

package/dist/services/GatewayClient.js

@@ -5,12 +5,6 @@ const logger_1 = require("../utils/logger");
 const ConfigManager_1 = require("./ConfigManager");
 const proxy_1 = require("../config/proxy");
 const log = (0, logger_1.createLogger)('GatewayClient');
-/**
- * Build the Anthropic `messages[0].content` for a user turn. Returns the
- * bare prompt string when there are no images (text-only, unchanged); when
- * images are present, returns an array of image blocks followed by the text
- * block so the model sees the screenshot(s) before the instruction.
- */
 const buildUserContent = (prompt, images) => {
     if (!images || images.length === 0) {
         return prompt;
@@ -52,10 +46,6 @@ const asReasonText = (value) => {
     return '';
 };
 exports.asReasonText = asReasonText;
-/**
- * Sends authenticated requests to the Rivet LLM gateway.
- * Handles JWT auth, automatic token refresh on 401, and rate limit errors.
- */
 class GatewayClient {
     configManager = (0, ConfigManager_1.getConfigManager)();
     gatewayUrl;
@@ -64,7 +54,6 @@ class GatewayClient {
         this.gatewayUrl = gatewayUrl || proxy_1.GATEWAY_URL;
         this.proxyUrl = proxyUrl || proxy_1.PROXY_URL;
     }
-    /** Send a message to the gateway and return the raw text response. */
     async sendMessage(options) {
         const result = await this.postMessages({
             model: options.model,
@@ -78,12 +67,6 @@ class GatewayClient {
         }
         return content;
     }
-    /**
-     * Send a request that forces the model to invoke a single tool, and return
-     * the parsed `input` of that tool call. Throws if the model didn't call the
-     * tool (which the API guarantees won't happen with `tool_choice: { type:
-     * 'tool' }`, but we check anyway).
-     */
     async sendToolUse(options) {
         const systemContent = options.cacheSystemPrompt
             ? [
@@ -117,12 +100,6 @@ class GatewayClient {
         }
         return toolUse.input;
     }
-    /**
-     * Force a vision tool-use call that scores one or more images against a
-     * rubric, returning the parsed tool `input`. Thin wrapper over
-     * `sendToolUse` that attaches the image content blocks — used by the
-     * design self-critique to score a rendered variant screenshot.
-     */
     async scoreImage(options) {
         return this.sendToolUse(options);
     }
@@ -159,7 +136,6 @@ class GatewayClient {
                 clearTimeout(timeout);
             }
         }
-        // Handle 401 — could be token expiry or a spend limit rejection from the gateway
         if (response.status === 401 && retryCount === 0) {
             const errBody = await response.json().catch(() => ({}));
             const reason = (0, exports.asReasonText)(errBody.message ?? errBody.error ?? errBody);
@@ -189,7 +165,6 @@ class GatewayClient {
         }
         return response.json();
     }
-    /** Refresh the access token using the stored refresh token. */
     async refreshAccessToken() {
         const refreshToken = this.configManager.getRefreshToken();
         if (!refreshToken) {

package/dist/services/GatewayClient.js.map

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

package/dist/services/HistoryReplayService.d.ts

@@ -1,6 +1,5 @@
 import type { ChildProcess } from 'child_process';
 import type { VariantHistoryService } from './VariantHistoryService';
-/** Dev-server plumbing the replay path borrows from WorktreeManager. */
 export interface ReplayDevServerManager {
     findFreePortFrom(startPort: number): Promise<number>;
     releasePort?(port: number): void;
@@ -11,17 +10,6 @@ export declare class HistoryReplayError extends Error {
     readonly code: 'REPLAY_UNAVAILABLE' | 'REPLAY_START_FAILED';
     constructor(code: 'REPLAY_UNAVAILABLE' | 'REPLAY_START_FAILED', message: string);
 }
-/**
- * Boots past dev-server variants from their tree-store refs: materialize the
- * exact committed tree as a detached worktree, overlay the gitignored runtime
- * the snapshot deliberately excludes (.env, node_modules), substitute the
- * allocated port into the persisted serve recipe, and start the same dev
- * server the live session ran.
- *
- * Replays are kept in a small LRU pool so split panes can hold multiple past
- * full-stack variants at once. Replay previews are read-only in v1 — no
- * comment/visual-edit scoping (see the design doc's affected-contracts table).
- */
 export declare class HistoryReplayService {
     private readonly history;
     private readonly devServers;
@@ -29,9 +17,9 @@ export declare class HistoryReplayService {
     private readonly idleTtlMs;
     private readonly maxActiveReplays;
     private readonly replays;
+    private readonly stoppedWorkspaces;
+    private readonly runtimeOverlays;
     private globalProxyKey;
-    /** Serializes run/stop transitions so a double-click can't boot two
-     *  servers for the same history target. */
     private transition;
     constructor(deps: {
         history: VariantHistoryService;
@@ -40,13 +28,11 @@ export declare class HistoryReplayService {
         idleTtlMs?: number;
         maxActiveReplays?: number;
     });
-    /** The replay currently selected for the main preview, if any. */
     current(): {
         sessionId: string;
         variantId: string;
         port: number;
     } | null;
-    /** Returns the port for a target-addressed replay pane, if it is running. */
     getPort(sessionId: string, variantId: string): number | null;
     run(args: {
         projectPath: string;
@@ -57,31 +43,15 @@ export declare class HistoryReplayService {
         port: number;
         alreadyRunning: boolean;
     }>;
-    /** @effect Stops either a specific replay or all active replays. */
     stop(args?: {
         sessionId: string;
         variantId: string;
     }): Promise<void>;
-    /** @effect Full teardown for process shutdown. */
     shutdown(): Promise<void>;
     private stopReplay;
     private stopAllReplays;
     private touch;
     private enforceReplayLimit;
-    /**
-     * Copy/symlink the gitignored runtime the snapshot deliberately excludes:
-     * `.env*` files (copied — secrets never enter the store) and the host
-     * project's `node_modules` (symlinked — no install). Applied at the
-     * worktree root and, for nested projects, at the recipe cwd.
-     *
-     * Root alignment: the snapshot (and hence the worktree and `recipe.cwd`)
-     * is rooted at the project's GIT root, but `projectPath` — the history
-     * owner — is the possibly-nested directory the user opened. When
-     * projectPath ends with recipe.cwd, projectPath IS the host's nested
-     * project dir and the host git root is projectPath minus that suffix;
-     * appending recipe.cwd to projectPath would double the segment
-     * (<root>/app/app) and miss every overlay.
-     */
     private overlayRuntime;
     private cleanupWorktree;
     private enqueue;

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

@@ -1 +1 @@
-{"version":3,"file":"HistoryReplayService.d.ts","sourceRoot":"","sources":["../../src/services/HistoryReplayService.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,KAAK,EAEV,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAgBjC,wEAAwE;AACxE,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,CACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAEzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB;gBAAlD,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,EAC3D,OAAO,EAAE,MAAM;CAKlB;AAaD;;;;;;;;;;GAUG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAgC;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,cAAc,CAAuB;IAC7C;+CAC2C;IAC3C,OAAO,CAAC,UAAU,CAAuC;gBAE7C,IAAI,EAAE;QAChB,OAAO,EAAE,qBAAqB,CAAC;QAC/B,UAAU,EAAE,sBAAsB,CAAC;QACnC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;QAClD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B;IAWD,kEAAkE;IAClE,OAAO,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAYxE,6EAA6E;IAC7E,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOtD,GAAG,CAAC,IAAI,EAAE;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;IAyHtD,oEAAoE;IAC9D,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1E,kDAAkD;IAC5C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAIjB,UAAU;YAsBV,cAAc;IAO5B,OAAO,CAAC,KAAK;YAcC,kBAAkB;IAYhC;;;;;;;;;;;;;OAaG;YACW,cAAc;YAkDd,eAAe;IAW7B,OAAO,CAAC,OAAO;CAMhB"}
+{"version":3,"file":"HistoryReplayService.d.ts","sourceRoot":"","sources":["../../src/services/HistoryReplayService.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,KAAK,EAEV,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AASjC,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,CACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAEzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,qBAAqB;gBAAlD,IAAI,EAAE,oBAAoB,GAAG,qBAAqB,EAC3D,OAAO,EAAE,MAAM;CAKlB;AAcD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAgC;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAG9B;IACJ,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAClE,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,UAAU,CAAuC;gBAE7C,IAAI,EAAE;QAChB,OAAO,EAAE,qBAAqB,CAAC;QAC/B,UAAU,EAAE,sBAAsB,CAAC;QACnC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;QAClD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B;IAWD,OAAO,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAYxE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOtD,GAAG,CAAC,IAAI,EAAE;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,CAAC;IAqIhD,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAIjB,UAAU;YAqCV,cAAc;IAO5B,OAAO,CAAC,KAAK;YAcC,kBAAkB;YAYlB,cAAc;YA8Cd,eAAe;IAa7B,OAAO,CAAC,OAAO;CAKhB"}

package/dist/services/HistoryReplayService.js

@@ -8,16 +8,10 @@ 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 DependencyPreparationService_1 = require("./DependencyPreparationService");
 const log = (0, logger_1.createLogger)('HistoryReplayService');
-// Replay servers are on-demand; reclaim one that hasn't been touched in a
-// while so browsed-then-abandoned history entries don't pin dev servers (and
-// their worktrees) forever. Target-addressed proxy hits refresh this timer;
-// main-preview replay views also refresh it when the user picks the row.
 const DEFAULT_IDLE_TTL_MS = 30 * 60 * 1000;
 const DEFAULT_MAX_ACTIVE_REPLAYS = 3;
-// Existing projects scan from their framework default in the live path; for
-// replay we don't re-resolve the environment — scanning from the common
-// default keeps replays off the user's own dev server without an env lookup.
 const REPLAY_PORT_SCAN_START = 3000;
 const PORT_PLACEHOLDER = '${PORT}';
 class HistoryReplayError extends Error {
@@ -29,17 +23,6 @@ class HistoryReplayError extends Error {
     }
 }
 exports.HistoryReplayError = HistoryReplayError;
-/**
- * Boots past dev-server variants from their tree-store refs: materialize the
- * exact committed tree as a detached worktree, overlay the gitignored runtime
- * the snapshot deliberately excludes (.env, node_modules), substitute the
- * allocated port into the persisted serve recipe, and start the same dev
- * server the live session ran.
- *
- * Replays are kept in a small LRU pool so split panes can hold multiple past
- * full-stack variants at once. Replay previews are read-only in v1 — no
- * comment/visual-edit scoping (see the design doc's affected-contracts table).
- */
 class HistoryReplayService {
     history;
     devServers;
@@ -47,9 +30,9 @@ class HistoryReplayService {
     idleTtlMs;
     maxActiveReplays;
     replays = new Map();
+    stoppedWorkspaces = new Map();
+    runtimeOverlays = new Map();
     globalProxyKey = null;
-    /** Serializes run/stop transitions so a double-click can't boot two
-     *  servers for the same history target. */
     transition = Promise.resolve();
     constructor(deps) {
         this.history = deps.history;
@@ -58,7 +41,6 @@ class HistoryReplayService {
         this.idleTtlMs = deps.idleTtlMs ?? DEFAULT_IDLE_TTL_MS;
         this.maxActiveReplays = Math.max(1, deps.maxActiveReplays ?? DEFAULT_MAX_ACTIVE_REPLAYS);
     }
-    /** The replay currently selected for the main preview, if any. */
     current() {
         const replay = this.globalProxyKey
             ? this.replays.get(this.globalProxyKey)
@@ -71,7 +53,6 @@ class HistoryReplayService {
             port: replay.port,
         };
     }
-    /** Returns the port for a target-addressed replay pane, if it is running. */
     getPort(sessionId, variantId) {
         const replay = this.replays.get(replayKey(sessionId, variantId));
         if (!replay)
@@ -105,8 +86,24 @@ class HistoryReplayService {
             let worktreePath = null;
             let port;
             try {
-                worktreePath = await store.materializeWorktree(args.projectPath, manifest.tree.commitSha);
+                const stopped = this.stoppedWorkspaces.get(key);
+                this.stoppedWorkspaces.delete(key);
+                if (stopped &&
+                    stopped.projectPath === args.projectPath &&
+                    stopped.commitSha === manifest.tree.commitSha &&
+                    fs_1.default.existsSync(stopped.worktreePath)) {
+                    worktreePath = stopped.worktreePath;
+                }
+                else {
+                    if (stopped)
+                        await this.cleanupWorktree(stopped.projectPath, stopped.worktreePath);
+                    worktreePath = await store.materializeWorktree(args.projectPath, manifest.tree.commitSha);
+                }
                 await this.overlayRuntime(args.projectPath, worktreePath, recipe);
+                await DependencyPreparationService_1.previewDependencies.prepare({
+                    cwd: path_1.default.resolve(worktreePath, recipe.cwd),
+                    workspaceRoot: worktreePath,
+                });
                 port = await this.devServers.findFreePortFrom(REPLAY_PORT_SCAN_START);
                 const boundPort = port;
                 const cwd = path_1.default.resolve(worktreePath, recipe.cwd);
@@ -116,6 +113,7 @@ class HistoryReplayService {
                 ])));
                 this.devServers.releasePort?.(boundPort);
                 const replay = {
+                    commitSha: manifest.tree.commitSha,
                     key,
                     sessionId: args.sessionId,
                     variantId: args.variantId,
@@ -128,11 +126,6 @@ class HistoryReplayService {
                         variantId: args.variantId,
                     }), this.idleTtlMs),
                 };
-                // A replay server that dies on its own must not leave the slot
-                // claimed (or the iframe proxied onto a dead socket). Guard on the
-                // replay OBJECT, not the key: a late 'exit' from a previous process
-                // of the same variant (same key) must not clear the freshly booted
-                // replacement's slot.
                 proc.once('exit', () => {
                     if (this.replays.get(key) !== replay)
                         return;
@@ -143,10 +136,6 @@ class HistoryReplayService {
                         this.globalProxyKey = null;
                         this.switchPreviewPort?.(null);
                     }
-                    // Through the transition queue, not detached: a crash cleanup must
-                    // not run concurrently with a new run()'s materialize, and queued
-                    // ordering makes any subsequent run()/stop() a deterministic
-                    // barrier for the removal.
                     void this.enqueue(() => this.cleanupWorktree(args.projectPath, replay.worktreePath));
                 });
                 this.replays.set(key, replay);
@@ -173,17 +162,21 @@ class HistoryReplayService {
             }
         });
     }
-    /** @effect Stops either a specific replay or all active replays. */
     async stop(args) {
         await this.enqueue(async () => {
             if (args) {
-                await this.stopReplay(replayKey(args.sessionId, args.variantId));
+                await this.stopReplay(replayKey(args.sessionId, args.variantId), {
+                    retainWorkspace: true,
+                });
                 return;
             }
             await this.stopAllReplays();
+            for (const stopped of this.stoppedWorkspaces.values()) {
+                await this.cleanupWorktree(stopped.projectPath, stopped.worktreePath);
+            }
+            this.stoppedWorkspaces.clear();
         });
     }
-    /** @effect Full teardown for process shutdown. */
     async shutdown() {
         await this.stop();
     }
@@ -199,13 +192,27 @@ class HistoryReplayService {
         catch (err) {
             log.warn(`Failed to stop replay dev server for ${replay.key}`, err);
         }
-        // Default: the proxy must never be left pointing at the dead replay port
-        // (TTL expiry, explicit stop).
         if (opts.retargetProxy !== false && this.globalProxyKey === key) {
             this.globalProxyKey = null;
             this.switchPreviewPort?.(null);
         }
-        await this.cleanupWorktree(replay.projectPath, replay.worktreePath);
+        if (opts.retainWorkspace) {
+            this.stoppedWorkspaces.set(key, {
+                projectPath: replay.projectPath,
+                worktreePath: replay.worktreePath,
+                commitSha: replay.commitSha,
+            });
+            while (this.stoppedWorkspaces.size > this.maxActiveReplays) {
+                const oldest = this.stoppedWorkspaces.entries().next().value;
+                if (!oldest)
+                    break;
+                this.stoppedWorkspaces.delete(oldest[0]);
+                await this.cleanupWorktree(oldest[1].projectPath, oldest[1].worktreePath);
+            }
+        }
+        else {
+            await this.cleanupWorktree(replay.projectPath, replay.worktreePath);
+        }
     }
     async stopAllReplays() {
         const keys = Array.from(this.replays.keys());
@@ -231,21 +238,12 @@ class HistoryReplayService {
             await this.stopReplay(evictKey);
         }
     }
-    /**
-     * Copy/symlink the gitignored runtime the snapshot deliberately excludes:
-     * `.env*` files (copied — secrets never enter the store) and the host
-     * project's `node_modules` (symlinked — no install). Applied at the
-     * worktree root and, for nested projects, at the recipe cwd.
-     *
-     * Root alignment: the snapshot (and hence the worktree and `recipe.cwd`)
-     * is rooted at the project's GIT root, but `projectPath` — the history
-     * owner — is the possibly-nested directory the user opened. When
-     * projectPath ends with recipe.cwd, projectPath IS the host's nested
-     * project dir and the host git root is projectPath minus that suffix;
-     * appending recipe.cwd to projectPath would double the segment
-     * (<root>/app/app) and miss every overlay.
-     */
     async overlayRuntime(projectPath, worktreePath, recipe) {
+        for (const file of this.runtimeOverlays.get(worktreePath) ?? []) {
+            await promises_1.default.rm(file, { force: true });
+        }
+        const overlaid = new Set();
+        this.runtimeOverlays.set(worktreePath, overlaid);
         const hostRoot = resolveHostRoot(projectPath, recipe.cwd);
         const roots = [
             { host: hostRoot, target: worktreePath },
@@ -272,21 +270,19 @@ class HistoryReplayService {
                     if (!fs_1.default.existsSync(dest)) {
                         await promises_1.default
                             .copyFile(path_1.default.join(host, entry), dest)
+                            .then(() => {
+                            overlaid.add(dest);
+                        })
                             .catch((err) => log.warn(`overlay: .env copy failed for ${dest}`, err));
                     }
                 }
             }
-            const hostModules = path_1.default.join(host, 'node_modules');
-            const targetModules = path_1.default.join(target, 'node_modules');
-            if (fs_1.default.existsSync(hostModules) && !fs_1.default.existsSync(targetModules)) {
-                await promises_1.default
-                    .symlink(hostModules, targetModules, 'dir')
-                    .catch((err) => log.warn(`overlay: node_modules symlink failed for ${targetModules}`, err));
-            }
         }
     }
     async cleanupWorktree(projectPath, worktreePath) {
         try {
+            this.runtimeOverlays.delete(worktreePath);
+            DependencyPreparationService_1.previewDependencies.forget(worktreePath);
             await this.history.store.removeWorktree(projectPath, worktreePath);
         }
         catch (err) {
@@ -295,17 +291,11 @@ class HistoryReplayService {
     }
     enqueue(task) {
         const next = this.transition.catch(() => undefined).then(task);
-        // Detached observer must swallow rejections — callers handle `next`.
         this.transition = next.catch(() => undefined);
         return next;
     }
 }
 exports.HistoryReplayService = HistoryReplayService;
-/** Host counterpart of the snapshot root. `cwd` is snapshot-root-relative;
- *  when the opened project path ends with it, the user opened the nested
- *  project dir and the host root is the enclosing git root. Otherwise the
- *  opened path already is the root (cwd === '.') or layouts diverged —
- *  fall back to the opened path. */
 const resolveHostRoot = (projectPath, cwd) => {
     if (cwd === '.' || cwd === '')
         return projectPath;