rivet-design 0.11.9 → 0.11.10

package/dist/services/staticProjectTarget.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.needsStaticEntryPath = exports.resolveStaticProjectTarget = exports.listStaticHtmlEntryFiles = exports.isStaticHtmlFilePath = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const STATIC_HTML_EXTENSIONS = new Set(['.html', '.htm']);
+const DEFAULT_STATIC_ENTRY = 'index.html';
+/** Returns true when a path points at an HTML document Rivet can serve directly. */
+const isStaticHtmlFilePath = (filePath) => STATIC_HTML_EXTENSIONS.has(path_1.default.extname(filePath).toLowerCase());
+exports.isStaticHtmlFilePath = isStaticHtmlFilePath;
+/** Lists top-level HTML documents in stable order for static project entry selection. */
+const listStaticHtmlEntryFiles = (projectPath) => {
+    if (!fs_1.default.existsSync(projectPath))
+        return [];
+    const stats = fs_1.default.statSync(projectPath);
+    if (!stats.isDirectory())
+        return [];
+    return fs_1.default
+        .readdirSync(projectPath, { withFileTypes: true })
+        .filter((entry) => entry.isFile() && (0, exports.isStaticHtmlFilePath)(entry.name))
+        .map((entry) => entry.name)
+        .sort((left, right) => left.localeCompare(right));
+};
+exports.listStaticHtmlEntryFiles = listStaticHtmlEntryFiles;
+const normalizeEntryPath = (entryPath) => entryPath.split(path_1.default.sep).join('/');
+const resolveEntryPath = (projectPath, entryPath) => {
+    const resolvedProjectPath = path_1.default.resolve(projectPath);
+    const resolvedEntryPath = path_1.default.isAbsolute(entryPath)
+        ? path_1.default.resolve(entryPath)
+        : path_1.default.resolve(resolvedProjectPath, entryPath);
+    const relativeEntryPath = path_1.default.relative(resolvedProjectPath, resolvedEntryPath);
+    if (relativeEntryPath === '' ||
+        relativeEntryPath.startsWith('..') ||
+        path_1.default.isAbsolute(relativeEntryPath)) {
+        throw new Error(`Static entry must be inside projectPath: ${entryPath}`);
+    }
+    return normalizeEntryPath(relativeEntryPath);
+};
+/** Resolves a folder or direct HTML file into the static root and entry file. */
+const resolveStaticProjectTarget = ({ targetPath, entryPath, }) => {
+    const resolvedTargetPath = path_1.default.resolve(targetPath);
+    if (!fs_1.default.existsSync(resolvedTargetPath)) {
+        throw new Error(`Project path does not exist: ${resolvedTargetPath}`);
+    }
+    const targetStats = fs_1.default.statSync(resolvedTargetPath);
+    if (targetStats.isFile()) {
+        if (!(0, exports.isStaticHtmlFilePath)(resolvedTargetPath)) {
+            throw new Error(`Static project file must be an HTML file: ${targetPath}`);
+        }
+        const projectPath = path_1.default.dirname(resolvedTargetPath);
+        return {
+            projectPath,
+            entryPath: path_1.default.basename(resolvedTargetPath),
+            htmlEntryFiles: (0, exports.listStaticHtmlEntryFiles)(projectPath),
+        };
+    }
+    if (!targetStats.isDirectory()) {
+        throw new Error(`Project path must be a directory or HTML file: ${targetPath}`);
+    }
+    const htmlEntryFiles = (0, exports.listStaticHtmlEntryFiles)(resolvedTargetPath);
+    if (entryPath) {
+        return {
+            projectPath: resolvedTargetPath,
+            entryPath: resolveEntryPath(resolvedTargetPath, entryPath),
+            htmlEntryFiles,
+        };
+    }
+    if (htmlEntryFiles.includes(DEFAULT_STATIC_ENTRY)) {
+        return {
+            projectPath: resolvedTargetPath,
+            entryPath: DEFAULT_STATIC_ENTRY,
+            htmlEntryFiles,
+        };
+    }
+    if (htmlEntryFiles.length === 1) {
+        return {
+            projectPath: resolvedTargetPath,
+            entryPath: htmlEntryFiles[0],
+            htmlEntryFiles,
+        };
+    }
+    return {
+        projectPath: resolvedTargetPath,
+        entryPath: DEFAULT_STATIC_ENTRY,
+        htmlEntryFiles,
+    };
+};
+exports.resolveStaticProjectTarget = resolveStaticProjectTarget;
+/** Returns true when a static folder needs the caller to choose among HTML files. */
+const needsStaticEntryPath = (target) => target.htmlEntryFiles.length > 1 &&
+    !target.htmlEntryFiles.includes(DEFAULT_STATIC_ENTRY) &&
+    target.entryPath === DEFAULT_STATIC_ENTRY;
+exports.needsStaticEntryPath = needsStaticEntryPath;
+//# sourceMappingURL=staticProjectTarget.js.map

package/dist/services/staticProjectTarget.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"staticStarter.d.ts","sourceRoot":"","sources":["../../src/services/staticStarter.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,k1FAoG/B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAetE"}
+{"version":3,"file":"staticStarter.d.ts","sourceRoot":"","sources":["../../src/services/staticStarter.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,k1FAoG/B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAiBtE"}

package/dist/services/staticStarter.js

@@ -8,6 +8,7 @@ exports.ensureStaticStarterCanvas = ensureStaticStarterCanvas;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const logger_1 = require("../utils/logger");
+const staticProjectTarget_1 = require("./staticProjectTarget");
 const log = (0, logger_1.createLogger)('staticStarter');
 /**
  * Minimal, dependency-free landing page written into an empty static workspace
@@ -132,7 +133,7 @@ exports.STATIC_STARTER_HTML = `<!doctype html>
  */
 function ensureStaticStarterCanvas(projectPath) {
     try {
-        if (fs_1.default.existsSync(path_1.default.join(projectPath, 'index.html')))
+        if ((0, staticProjectTarget_1.listStaticHtmlEntryFiles)(projectPath).length > 0)
             return false;
         if (fs_1.default.existsSync(path_1.default.join(projectPath, '.rivet')))
             return false;

package/dist/services/staticStarter.js.map

@@ -1 +1 @@
-{"version":3,"file":"staticStarter.js","sourceRoot":"","sources":["../../src/services/staticStarter.ts"],"names":[],"mappings":";;;;;;AAgIA,8DAeC;AA/ID,4CAAoB;AACpB,gDAAwB;AACxB,4CAA+C;AAE/C,MAAM,GAAG,GAAG,IAAA,qBAAY,EAAC,eAAe,CAAC,CAAC;AAE1C;;;;GAIG;AACU,QAAA,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoGlC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,SAAgB,yBAAyB,CAAC,WAAmB;IAC3D,IAAI,CAAC;QACH,IAAI,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACtE,IAAI,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAClE,YAAE,CAAC,aAAa,CACd,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,EACpC,2BAAmB,EACnB,MAAM,CACP,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,yDAAyD,WAAW,EAAE,CAAC,CAAC;QACjF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,yCAAyC,WAAW,GAAG,EAAE,GAAG,CAAC,CAAC;QACvE,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"staticStarter.js","sourceRoot":"","sources":["../../src/services/staticStarter.ts"],"names":[],"mappings":";;;;;;AAiIA,8DAiBC;AAlJD,4CAAoB;AACpB,gDAAwB;AACxB,4CAA+C;AAC/C,+DAAiE;AAEjE,MAAM,GAAG,GAAG,IAAA,qBAAY,EAAC,eAAe,CAAC,CAAC;AAE1C;;;;GAIG;AACU,QAAA,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoGlC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,SAAgB,yBAAyB,CAAC,WAAmB;IAC3D,IAAI,CAAC;QACH,IAAI,IAAA,8CAAwB,EAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACnE,IAAI,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAClE,YAAE,CAAC,aAAa,CACd,cAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,EACpC,2BAAmB,EACnB,MAAM,CACP,CAAC;QACF,GAAG,CAAC,IAAI,CACN,yDAAyD,WAAW,EAAE,CACvE,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,yCAAyC,WAAW,GAAG,EAAE,GAAG,CAAC,CAAC;QACvE,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/utils/skills/claude-skill.d.ts

@@ -1,4 +1,4 @@
-export declare const CLAUDE_SKILL_VERSION = 23;
+export declare const CLAUDE_SKILL_VERSION = 24;
 export declare const CLAUDE_SKILL_DIR = "rivet";
 export declare const CLAUDE_SKILL_FILENAME = "SKILL.md";
 export declare const CLAUDE_SKILL_CONTENT: string;

package/dist/utils/skills/claude-skill.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CLAUDE_SKILL_CONTENT = exports.CLAUDE_SKILL_FILENAME = exports.CLAUDE_SKILL_DIR = exports.CLAUDE_SKILL_VERSION = void 0;
 const shared_variants_protocol_1 = require("./shared-variants-protocol");
-exports.CLAUDE_SKILL_VERSION = 23;
+exports.CLAUDE_SKILL_VERSION = 24;
 const CLAUDE_SKILL_VERSION_MARKER = `[//]: # (rivet-skill-version: ${exports.CLAUDE_SKILL_VERSION})`;
 exports.CLAUDE_SKILL_DIR = 'rivet';
 exports.CLAUDE_SKILL_FILENAME = 'SKILL.md';
@@ -17,13 +17,13 @@ const AGENT_VARIANTS_SECTION = (0, shared_variants_protocol_1.buildAgentVariants
 });
 exports.CLAUDE_SKILL_CONTENT = `---
 name: rivet
-description: Rivet — two flows. Visual editor for point-and-click UI changes ("open rivet", "use rivet", "make a visual change"). Agent-variants for exploring N parallel design directions before committing ("create variants of X", "show me 3-5 options for X", "build me a settings page from scratch", "create a new Vite todo app", "scaffold a Next.js dashboard"). Pick the flow based on the user's request — see "Picking the flow" below.
+description: Rivet — design agent for point-and-click UI changes ("open rivet", "use rivet", "make a visual change") and exploring N parallel design directions before committing ("create variants of X", "show me 3-5 options for X", "build me a settings page from scratch", "create a new Vite todo app", "scaffold a Next.js dashboard"). Pick the flow based on the user's request — see "Picking the flow" below.
 ---
 
 ${CLAUDE_SKILL_VERSION_MARKER}
 # Rivet
 
-Two flows: the **visual editor** (point-and-click changes to a web app — including an empty or HTML-only folder, which opens in static mode) and the **agent-variants flow** (explore N parallel design directions before committing).
+Rivet is a **design agent** with two flows: the **visual editor** (point-and-click changes to a web app — including an empty or HTML-only folder, which opens in static mode) and the **agent-variants flow** (explore N parallel design directions before committing).
 
 ${shared_variants_protocol_1.PICKING_THE_FLOW_TABLE}
 
@@ -31,10 +31,10 @@ ${shared_variants_protocol_1.PICKING_THE_FLOW_TABLE}
 
 ## Starting a session
 
-An **empty or HTML-only folder is a valid target** — \`detect_project\` returns \`framework: 'static'\` for it and \`open_visual_editor\` opens it in static mode (no dev server). When the user says "open rivet" / "use rivet here" in such a folder, open the editor — do NOT refuse or reroute to variants because there's "no app yet."
+An **empty folder, HTML-only folder, or standalone HTML file is a valid target** — \`open_visual_editor\` detects the framework and starts the right preview backend. When the user says "open rivet" / "use rivet here" in such a target, open the editor — do NOT refuse or reroute to variants because there's "no app yet."
 
-1. Call \`detect_project\` — returns project info including \`framework\` and \`projectPath\`
-2. Call \`open_visual_editor({ projectPath, framework })\` — do NOT pass \`startPort\` or any port; the tool handles port selection automatically
+1. Call \`open_visual_editor({ projectPath })\` — pass a specific HTML file as \`projectPath\` when the user names one; otherwise pass the folder. Do NOT pass \`startPort\` or any port unless the user provided a running server.
+2. If \`opened: false\`, follow \`nextStep\` / \`nextAction\`; for \`entry_path_required\`, call \`open_visual_editor\` again with the target HTML file or \`entryPath\`.
 3. Tell the user: "Rivet is ready — make your visual changes and click 'Send to Claude Code'."
 4. Call \`watch_for_changes({ sessionId })\` to wait for the user's changes.
 
@@ -57,7 +57,7 @@ When the user says they're done, call \`close_visual_editor({ sessionId })\`.
 
 ## Rules
 
-- **Always call \`detect_project\` first** — never assume the dev server is running
+- Call \`open_visual_editor\` directly; it detects the project and starts the preview backend
 - **Always use \`watch_for_changes\`** to wait for user changes — do NOT use Monitor, background shell commands, or manual polling
 - **Never auto-commit** after applying visual changes — let the user decide
 - The dev server stays running after \`close_visual_editor\`

package/dist/utils/skills/cursor-rules.d.ts

@@ -1,4 +1,4 @@
-export declare const CURSOR_RULES_VERSION = 22;
+export declare const CURSOR_RULES_VERSION = 23;
 export declare const CURSOR_RULES_FILENAME = "rivet.mdc";
 export declare const CURSOR_RULES_CONTENT: string;
 //# sourceMappingURL=cursor-rules.d.ts.map

package/dist/utils/skills/cursor-rules.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CURSOR_RULES_CONTENT = exports.CURSOR_RULES_FILENAME = exports.CURSOR_RULES_VERSION = void 0;
 const shared_variants_protocol_1 = require("./shared-variants-protocol");
-exports.CURSOR_RULES_VERSION = 22;
+exports.CURSOR_RULES_VERSION = 23;
 exports.CURSOR_RULES_FILENAME = 'rivet.mdc';
 const CURSOR_RULES_VERSION_MARKER = `rivet-rules-version: ${exports.CURSOR_RULES_VERSION}`;
 const AGENT_VARIANTS_SECTION = (0, shared_variants_protocol_1.buildAgentVariantsSection)({
@@ -15,13 +15,13 @@ const AGENT_VARIANTS_SECTION = (0, shared_variants_protocol_1.buildAgentVariants
     nativeGenLabel: 'Task tool',
 });
 exports.CURSOR_RULES_CONTENT = `---
-description: Rivet — apply when the user says "open rivet", "open the visual editor", "create variants", "show me options for X", "build me X from scratch", "create a new Y app", or wants to make visual/UI changes or explore design directions
+description: Rivet — design agent for point-and-click UI changes ("open rivet", "open the visual editor") and exploring N parallel design directions ("create variants", "show me options for X", "build me X from scratch", "create a new Y app")
 alwaysApply: false
 ---
 <!-- ${CURSOR_RULES_VERSION_MARKER} -->
 # Rivet
 
-Two flows: the **visual editor** (point-and-click changes to a web app — including an empty or HTML-only folder, which opens in static mode) and the **agent-variants flow** (explore N parallel design directions before committing).
+Rivet is a **design agent** with two flows: the **visual editor** (point-and-click changes to a web app — including an empty or HTML-only folder, which opens in static mode) and the **agent-variants flow** (explore N parallel design directions before committing).
 
 > Tip: type \`@rivet.mdc\` in chat to invoke this rule manually.
 
@@ -31,10 +31,10 @@ ${shared_variants_protocol_1.PICKING_THE_FLOW_TABLE}
 
 ## Starting a session
 
-An **empty or HTML-only folder is a valid target** — \`detect_project\` returns \`framework: 'static'\` for it and \`open_visual_editor\` opens it in static mode (no dev server). When the user says "open rivet" / "use rivet here" in such a folder, open the editor — do NOT refuse or reroute to variants because there's "no app yet."
+An **empty folder, HTML-only folder, or standalone HTML file is a valid target** — \`open_visual_editor\` detects the framework and starts the right preview backend. When the user says "open rivet" / "use rivet here" in such a target, open the editor — do NOT refuse or reroute to variants because there's "no app yet."
 
-1. Call \`detect_project\` — returns project info including \`framework\` and \`projectPath\`
-2. Call \`open_visual_editor({ projectPath, framework })\` — do NOT pass \`startPort\` or any port; the tool handles port selection automatically
+1. Call \`open_visual_editor({ projectPath })\` — pass a specific HTML file as \`projectPath\` when the user names one; otherwise pass the folder. Do NOT pass \`startPort\` or any port unless the user provided a running server.
+2. If \`opened: false\`, follow \`nextStep\` / \`nextAction\`; for \`entry_path_required\`, call \`open_visual_editor\` again with the target HTML file or \`entryPath\`.
 3. Tell the user: "Rivet is ready — make your visual changes and click 'Send to Cursor'."
 4. Call \`watch_for_changes({ sessionId })\` to wait for the user's changes.
 
@@ -55,7 +55,7 @@ When the user says they're done, call \`close_visual_editor({ sessionId })\`.
 
 ## Rules
 
-- **Always call \`detect_project\` first** — never assume the dev server is running
+- Call \`open_visual_editor\` directly; it detects the project and starts the preview backend
 - **Always use \`watch_for_changes\`** to wait for user changes — do NOT use Monitor, background shell commands, or manual polling
 - **Never auto-commit** after applying visual changes — let the user decide
 - Always stop and ask before re-entering the watch loop

package/dist/utils/skills/shared-variants-protocol.js

@@ -47,7 +47,7 @@ There are three sub-flows. Pick by project state:
    - \`target\` (optional): \`{ type: 'element'|'file'|'route', ref }\` — set this for refinement requests pinned to a specific element/file/route
    - \`projectPath\` (optional): defaults to the MCP server's cwd; pass explicitly if the variants target a different directory
 
-   Response: \`{ sessionId, stage: 'work_items_ready', mode: 'existing', leaseId, leaseTtlMs, variants: [{ variantId, briefId, label, workItem }], project: { projectPath, framework }, visualEditor? }\`. The server already detected the framework, opened the Rivet visual editor (share \`visualEditor.url\` with the user immediately), and started every variant — you do NOT need to call \`detect_project\`, \`open_visual_editor\`, or \`continue_variants(request_work)\`. Each \`variants[i].workItem\` carries \`input.worktreePath\` (where to edit files) and \`attempt\`.
+   Response: \`{ sessionId, stage: 'work_items_ready', mode: 'existing', leaseId, leaseTtlMs, variants: [{ variantId, briefId, label, workItem }], project: { projectPath, framework }, visualEditor? }\`. The server already detected the framework, opened the Rivet visual editor (share \`visualEditor.url\` with the user immediately), and started every variant — you do NOT need to call \`open_visual_editor\` or \`continue_variants(request_work)\`. Each \`variants[i].workItem\` carries \`input.worktreePath\` (where to edit files) and \`attempt\`.
 
 2. ${opts.step9}
 
@@ -82,7 +82,7 @@ For brand-new projects the user describes from scratch ("build me a Vite todo ap
    - \`framework\` (optional, defaults to \`'vite'\`)
    - \`destinationParent\` (optional, absolute path; defaults to the user's home dir)
 
-   Response: \`{ sessionId, stage: 'work_items_ready', mode: 'zero_to_one', leaseId, leaseTtlMs, variants: [...], scaffoldBaseWorkItemId, destinationPath, visualEditor? }\`. The server opened the editor for you if \`visualEditor\` is present — share \`visualEditor.url\` with the user immediately ("Generating variants — watch here: <url>"). Skip the manual \`detect_project\` / \`open_visual_editor\` step here because the zero-to-one destination is a brand-new directory the server derives — it doesn't exist on disk yet, so \`detect_project\` on it would fail. This applies ONLY to the not-yet-created zero-to-one destination. An **existing** empty or HTML-only folder is a perfectly valid \`open_visual_editor\` target (it opens in static mode) — do not generalize this skip to "empty dirs can't be opened." Each \`variants[i].workItem\` carries \`input\` and \`attempt\`.
+   Response: \`{ sessionId, stage: 'work_items_ready', mode: 'zero_to_one', leaseId, leaseTtlMs, variants: [...], scaffoldBaseWorkItemId, destinationPath, visualEditor? }\`. The server opened the editor for you if \`visualEditor\` is present — share \`visualEditor.url\` with the user immediately ("Generating variants — watch here: <url>"). Skip the manual \`open_visual_editor\` step here because the zero-to-one destination is a brand-new directory the server derives. This applies ONLY to the not-yet-created zero-to-one destination. An **existing** empty or HTML-only folder is a perfectly valid \`open_visual_editor\` target (it opens in static mode) — do not generalize this skip to "empty dirs can't be opened." Each \`variants[i].workItem\` carries \`input\` and \`attempt\`.
 
 2. **From here, follow Sub-flow A steps 2-5** (parallel code-gen with first-line label using each variant's \`workItem.input.worktreePath\` and the shared \`leaseId\`, then ready, watch, apply). The work items are \`static_preview\` for zero-to-one — agent output must be passed to \`report_variant_complete\` as a JSON **object** with shape \`{ html: string, css?: string, js?: string }\` (self-contained HTML, no React/Vite-only imports). Do NOT stringify it — pass \`output: { html: "<!doctype html>..." }\`, not \`output: "{\\"html\\": \\"...\\"}"\`. On commit, the apply payload is \`payload.kind === 'project-created'\` — the server materialized the chosen variant to \`destinationPath\`.
 
@@ -130,7 +130,7 @@ ${describe_motion_protocol_1.DESCRIBE_MOTION_PROTOCOL}
 
 - **Never** generate variants natively (${opts.nativeGenLabel}, parallel tool calls, your own creative process) without going through \`start_variants\` first.
 - Always pass the user's prompt verbatim — don't paraphrase.
-- Prefer \`start_variants\` (with the matching \`mode\`) over the older \`propose_variants\` → \`report_variant_briefs\` → \`approve_variant_briefs\` chain. The unified call also handles \`detect_project\`, \`open_visual_editor\`, and \`continue_variants(request_work)\` server-side. The older tools and standalone \`detect_project\` / \`open_visual_editor\` stay registered for the Visual Editor flow (point-and-click changes without variants).
+- Prefer \`start_variants\` (with the matching \`mode\`) over the older \`propose_variants\` → \`report_variant_briefs\` → \`approve_variant_briefs\` chain. The unified call also handles project detection, \`open_visual_editor\`, and \`continue_variants(request_work)\` server-side. The older variant tools and standalone \`open_visual_editor\` stay registered for the Visual Editor flow (point-and-click changes without variants).
 - For source-grounded fresh projects, pass the raw references as \`userContext\` to \`start_variants\` and do the design/motion extraction DURING source planning (report \`extract_design_system\` / \`describe_motion\` actions with metadata) — don't pre-summarize references before kickoff.
 - Briefs are never an approval gate — reporting them starts the directions immediately. Do not pause to ask the user "do these look good?" before generating. If you mention briefs in chat at all they are PLAIN TEXT; do not render UI, open a browser tab, or fabricate a URL.
 - The user picks AFTER seeing the variants render LIVE in the iframe, not before. Hand off to the iframe chip for visual cycling + commit.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rivet-design",
-  "version": "0.11.9",
+  "version": "0.11.10",
   "description": "Local visual web development tool with AI-powered code modification",
   "main": "dist/index.js",
   "workspaces": [