@pro-vi/designer 0.3.4 → 0.3.6

package/dist/cli.js

@@ -66,7 +66,8 @@ async function main() {
             const res = await c.iterate(prompt, {
                 file: flags.file,
                 timeoutMs: flags.timeoutMs ? Number(flags.timeoutMs) : undefined,
-                stabilityMs: flags.stabilityMs ? Number(flags.stabilityMs) : undefined
+                stabilityMs: flags.stabilityMs ? Number(flags.stabilityMs) : undefined,
+                decisive: Boolean(flags.decisive)
             });
             if (res.url)
                 console.log(`\nTaste here: ${res.url}\n`);
@@ -343,6 +344,7 @@ Flags:
   --file <f.html>         switch to this file before prompting
   --timeoutMs <n>         default 20 minutes
   --stabilityMs <n>       default 4 seconds
+  --decisive              tell Claude not to stop on clarifying questions; pick defaults and proceed
 
 Output: prints 'Taste here: <url>' then JSON metadata (done, newFiles, htmlPath, screenshotPath,
 htmlHash, chatReply). HTML is written to disk (read htmlPath if needed); it's not inline.
@@ -350,6 +352,10 @@ htmlHash, chatReply). HTML is written to disk (read htmlPath if needed); it's no
 Auto-appended to every prompt: 'Keep all generated files at the project root; no subfolders.'
 Override by explicitly contradicting it in your prompt text.
 
+With --decisive, also append: 'If you would otherwise stop to ask clarifying questions, do not.
+Choose the most defensible answer for each axis yourself and proceed.' Use when you want Claude
+to commit to a direction instead of blocking on the clarifying-questions affordance.
+
 Examples:
   designer prompt "add a Remember-me checkbox" --key feat-x
   designer prompt --prompt-file ./brief.md --key feat-x
@@ -536,18 +542,37 @@ async function checkOnDesignSurface() {
     const port = process.env.DESIGNER_CDP || '9222';
     try {
         const res = await fetch(`http://127.0.0.1:${port}/json/list`);
-        if (!res.ok)
-            return { name: 'logged into claude.ai/design', status: 'fail', detail: `HTTP ${res.status}` };
+        if (!res.ok) {
+            return {
+                name: 'claude.ai/design tab',
+                status: 'fail',
+                detail: `CDP HTTP ${res.status} — debug Chrome may have died. Run \`designer setup\` to relaunch it.`
+            };
+        }
         const tabs = await res.json();
         const onDesign = tabs.find((t) => t.url && /claude\.ai\/design/.test(t.url));
-        if (!onDesign)
-            return { name: 'logged into claude.ai/design', status: 'warn', detail: 'no tab on claude.ai/design — sign in and navigate there in the debug Chrome window' };
-        if (/login|sign in/i.test(onDesign.title || ''))
-            return { name: 'logged into claude.ai/design', status: 'fail', detail: 'on a login page; sign in inside the debug Chrome window' };
-        return { name: 'logged into claude.ai/design', status: 'ok', detail: onDesign.url };
+        if (!onDesign) {
+            return {
+                name: 'claude.ai/design tab',
+                status: 'warn',
+                detail: 'no tab on claude.ai/design in the debug Chrome window. Open https://claude.ai/design THERE (not in your normal Chrome — they are separate profiles with separate cookies).'
+            };
+        }
+        if (/login|sign in/i.test(onDesign.title || '')) {
+            return {
+                name: 'signed in to claude.ai/design',
+                status: 'fail',
+                detail: 'on a login page. Sign in INSIDE the debug Chrome window (not your normal Chrome — that profile is signed in but its cookies are not shared).'
+            };
+        }
+        return { name: 'signed in to claude.ai/design', status: 'ok', detail: onDesign.url };
     }
     catch {
-        return { name: 'logged into claude.ai/design', status: 'fail', detail: 'CDP not reachable; fix CDP first' };
+        return {
+            name: 'claude.ai/design tab',
+            status: 'fail',
+            detail: 'debug Chrome unreachable. Run `designer setup` to launch it.'
+        };
     }
 }
 function checkSelectors() {

package/dist/designer-controller.js

@@ -10,6 +10,7 @@ import { REPO_ROOT } from "./repo-root.js";
 import { ensureCdpUp } from "./cdp-ensure.js";
 const DESIGN_HOME = 'https://claude.ai/design';
 const FLAT_LAYOUT_SUFFIX = '\n\nFile layout: keep all generated files at the project root. No subfolders.';
+const DECISIVE_SUFFIX = '\n\nIf you would otherwise stop to ask clarifying questions, do not. Choose the most defensible answer for each axis yourself and proceed. Note your assumption in a one-line `<!-- assumed: ... -->` comment at the top of the relevant file so I can override on the next turn.';
 function loadSelectors() {
     const base = JSON.parse(fs.readFileSync(path.join(REPO_ROOT, 'selectors.json'), 'utf8'));
     const overridePath = path.join(os.homedir(), '.designer', 'selectors.override.json');
@@ -59,15 +60,26 @@ export class DesignerController {
         const url = await this.currentUrl();
         const inSession = /\/design\/p\/[a-f0-9-]+/i.test(url);
         const availableFiles = inSession ? await this.listFiles().catch(() => []) : [];
+        const awaitingClarification = inSession ? await this.detectAwaitingClarification() : false;
         return {
             key: this.key,
             stored,
             currentUrl: url,
             inSession,
             onHome: /\/design\/?$/.test(url) || url.endsWith('/design'),
-            availableFiles
+            availableFiles,
+            awaitingClarification
         };
     }
+    async detectAwaitingClarification() {
+        const turns = await this.getChatTurns().catch(() => []);
+        if (turns.length === 0)
+            return false;
+        const last = turns[turns.length - 1];
+        if (!last || last.role !== 'assistant')
+            return false;
+        return /Claude has some questions/i.test(last.text);
+    }
     async session({ action = 'status', name, fidelity = 'wireframe' } = {}) {
         if (action === 'status')
             return this.getStatus();
@@ -204,12 +216,13 @@ export class DesignerController {
         return true;
       })()`);
     }
-    async sendPrompt(prompt) {
+    async sendPrompt(prompt, { decisive = false } = {}) {
         const before = await this.fetchServedHtml();
         this._preSendHtml = before.html;
-        const effective = prompt + FLAT_LAYOUT_SUFFIX;
+        const effective = prompt + FLAT_LAYOUT_SUFFIX + (decisive ? DECISIVE_SUFFIX : '');
         await this._submitPrompt(effective);
-        appendHistory(this.key, { kind: 'prompt', prompt, suffixApplied: 'flat_layout' });
+        const suffixApplied = decisive ? 'flat_layout+decisive' : 'flat_layout';
+        appendHistory(this.key, { kind: 'prompt', prompt, suffixApplied });
         return { ok: true };
     }
     async waitForGenerationDone({ timeoutMs = 20 * 60_000, stabilityMs = 4000, pollMs = 1500 } = {}) {
@@ -274,13 +287,13 @@ export class DesignerController {
             throw new Error(`No active session for key=${this.key}. Call createSession first.`);
         await this.resumeSession();
     }
-    async iterate(prompt, { file, timeoutMs, stabilityMs } = {}) {
+    async iterate(prompt, { file, timeoutMs, stabilityMs, decisive } = {}) {
         await this._ensureInSession();
         if (file)
             await this.openFile(file);
         const preFiles = await this.listFiles().catch(() => []);
         const preChatCount = (await this.getChatTurns()).length;
-        await this.sendPrompt(prompt);
+        await this.sendPrompt(prompt, { decisive });
         const done = await this.waitForGenerationDone({ timeoutMs, stabilityMs });
         const postFiles = await this.listFiles().catch(() => []);
         const postTurns = await this.getChatTurns();

package/dist/mcp-server.js

@@ -37,9 +37,13 @@ server.registerTool('designer_prompt', {
         prompt: z.string(),
         file: z.string().optional().describe('Switch to this file before sending (targets the prompt at it).'),
         timeoutMs: z.number().optional().describe('Default 20m. Hi-fi generations can take 15+ min; bump this for complex multi-variant prompts.'),
-        stabilityMs: z.number().optional().describe('Default 4s.')
+        stabilityMs: z.number().optional().describe('Default 4s.'),
+        decisive: z
+            .boolean()
+            .optional()
+            .describe("Append a 'do not stop to ask clarifying questions' instruction. Use when you want Claude to commit to a direction (pick defensible defaults itself, document the assumption inline) instead of blocking on the ephemeral clarifying-questions affordance — which disappears on refresh and has no stable DOM contract to scrape.")
     }
-}, async ({ key, prompt, file, timeoutMs, stabilityMs }) => textResult(await getController(key).iterate(prompt, { file, timeoutMs, stabilityMs })));
+}, async ({ key, prompt, file, timeoutMs, stabilityMs, decisive }) => textResult(await getController(key).iterate(prompt, { file, timeoutMs, stabilityMs, decisive })));
 server.registerTool('designer_ask', {
     description: "Q&A with the design assistant — text-only, doesn't change any file. Use for 'why did you choose X?', 'compare A vs B', 'suggest 3 alternatives before I commit'. Returns the assistant's reply.",
     inputSchema: {

package/dist/setup.js

@@ -169,11 +169,11 @@ async function step4SignIn(port) {
         log('login', 'ok', `Signed in. Tab on ${tab.url.replace(/\?.*$/, '')}`);
         return true;
     }
-    log('login', 'wait', 'Sign in to Claude in the debug Chrome window I just opened, then navigate to claude.ai/design. I am polling.');
+    log('login', 'wait', 'Sign in to Claude in the DEBUG Chrome window I just opened (it is a separate window with no extensions/bookmarks — NOT your normal Chrome; the two have separate cookie jars). Then navigate to claude.ai/design. I am polling.');
     const ok = await pollUntil('login', async () => (await getDesignTab(port)) !== null, {
         intervalMs: 2000,
         timeoutMs: 10 * 60_000,
-        reminder: 'Still waiting for a tab on claude.ai/design (not on /login).',
+        reminder: 'Still waiting for a tab on claude.ai/design in the debug window (signing into your normal Chrome will not help — different profile).',
         hint60s: "If Chrome shows a Google 'new device' or 2FA prompt, complete that first — setup is waiting on you."
     });
     if (!ok) {

package/dist/ui-anchors.js

@@ -77,7 +77,11 @@ export const UI_ANCHORS = [
         category: 'session',
         description: 'html-viewer-iframe (design preview)',
         requires: 'session',
-        check: async (b) => ({ ok: await hasSelector(b, '[data-testid="html-viewer-iframe"]') })
+        check: async (b, url) => {
+            if (!/[?&]file=/.test(url))
+                return { ok: true, detail: '(no file open — iframe not expected)' };
+            return { ok: await hasSelector(b, '[data-testid="html-viewer-iframe"]') };
+        }
     },
     {
         id: 'session.chatMessages',
@@ -91,10 +95,12 @@ export const UI_ANCHORS = [
         category: 'pattern',
         description: 'iframe src is claudeusercontent.com with signed ?t= token',
         requires: 'session',
-        check: async (b) => {
+        check: async (b, url) => {
+            if (!/[?&]file=/.test(url))
+                return { ok: true, detail: '(no file open — iframe not expected)' };
             const src = await b.evalValue(`(() => { const el = document.querySelector('[data-testid="html-viewer-iframe"]'); return (el && el.src) || ''; })()`).catch(() => '');
             if (!src)
-                return { ok: false, detail: 'no iframe src (is a file open?)' };
+                return { ok: false, detail: 'file param present but iframe missing src' };
             const ok = /claudeusercontent\.com/.test(src) && /[?&]t=/.test(src);
             return { ok, detail: ok ? undefined : `src=${src.slice(0, 120)}...` };
         }
@@ -182,7 +188,7 @@ export const UI_ANCHORS = [
             }
             const match = url.match(/[?&]file=([^&]+)/);
             if (match && match[1]) {
-                const activeFile = decodeURIComponent(match[1]);
+                const activeFile = decodeURIComponent(match[1].replace(/\+/g, ' '));
                 if (!files.includes(activeFile)) {
                     return {
                         ok: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pro-vi/designer",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "type": "module",
   "description": "MCP + CLI for autonomous iteration of claude.ai/design — drives the design surface via agent-browser, downloads handoff bundles, and exposes a tasting harness for full-viewport variant comparison.",
   "license": "MIT",