@pro-vi/designer 0.3.8 → 0.3.10

package/README.md

@@ -118,7 +118,7 @@ Writes `tasting.html` with variant tabs + 1/2/3 shortcuts + persistent notes, se
 ## Operations
 
 - `designer doctor` — diagnose setup state. Exits 2 on failure.
-- `designer health [--json]` — probe 17 UI anchors. Wire into cron to catch claude.ai UI regressions.
+- `designer health [--json]` — probe every UI anchor designer depends on. Wire into cron to catch claude.ai UI regressions.
 - **Daily CI** in `.github/workflows/`: `daily-health.yml` runs the auth-required UI probe on a self-hosted macOS runner once per day; `ci.yml` typechecks + builds + does a Docker clean-room install smoke on every PR; `release-please.yml` opens a release PR on conventional commits, merging it tags + publishes via `release-publish.yml`. Selector regressions land as auto-opened PRs under the `selectors-drift` label.
 
 ## Known quirks

package/bin/designer.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+// Cross-platform entry: works on macOS/Linux/Windows.
+// Resolves the repo root from this file's location, prefers the compiled
+// dist/cli.js, falls back to tsx+source for dev/clone-and-run mode.
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const BIN_DIR = path.dirname(fs.realpathSync(__filename));
+const REPO_ROOT = path.resolve(BIN_DIR, '..');
+
+const DIST_CLI = path.join(REPO_ROOT, 'dist', 'cli.js');
+const SRC_CLI = path.join(REPO_ROOT, 'cli.ts');
+const TSX_BIN = path.join(REPO_ROOT, 'node_modules', '.bin', process.platform === 'win32' ? 'tsx.cmd' : 'tsx');
+
+const argv = process.argv.slice(2);
+
+// Prefer compiled output (npm-installed users + post-build dev). Fall back to
+// tsx-on-source (clone-and-run dev mode, before tsc emits dist/).
+if (fs.existsSync(DIST_CLI)) {
+  const r = spawnSync(process.execPath, [DIST_CLI, ...argv], { stdio: 'inherit' });
+  process.exit(r.status ?? 1);
+}
+
+if (fs.existsSync(TSX_BIN) && fs.existsSync(SRC_CLI)) {
+  // shell:true lets Windows resolve the .cmd shim for tsx without a separate code path.
+  const r = spawnSync(TSX_BIN, [SRC_CLI, ...argv], { stdio: 'inherit', shell: process.platform === 'win32' });
+  process.exit(r.status ?? 1);
+}
+
+console.error('[designer] No runnable found.');
+console.error(`           Expected ${DIST_CLI} (compiled) or ${TSX_BIN} + ${SRC_CLI} (dev).`);
+console.error(`           Run: cd ${REPO_ROOT} && npm install && npm run build`);
+process.exit(1);

package/dist/browser.js

@@ -1,4 +1,4 @@
-import { spawn } from 'node:child_process';
+import { xspawn } from "./cross-platform.js";
 const BIN = process.env.DESIGNER_AGENT_BROWSER_BIN || 'agent-browser';
 const DEFAULT_SESSION = process.env.DESIGNER_SESSION_NAME || 'designer';
 const CDP = process.env.DESIGNER_CDP ?? '9222';
@@ -12,14 +12,15 @@ export function createBrowser({ session = DEFAULT_SESSION, headed = true, timeou
     function connectFlags() {
         if (!cdp)
             return [];
+        const scope = ['--session', `designer-cdp-${cdp.replace(/[^a-zA-Z0-9.-]/g, '_')}`];
         if (cdp === 'auto' || cdp === '1' || cdp === 'true')
-            return ['--auto-connect'];
-        return ['--cdp', cdp];
+            return [...scope, '--auto-connect'];
+        return [...scope, '--cdp', cdp];
     }
     function run(args, { input, parseJson = false } = {}) {
         return new Promise((resolve, reject) => {
             const finalArgs = [...connectFlags(), ...args];
-            const child = spawn(BIN, finalArgs, { env: baseEnv, stdio: ['pipe', 'pipe', 'pipe'] });
+            const child = xspawn(BIN, finalArgs, { env: baseEnv, stdio: ['pipe', 'pipe', 'pipe'] });
             let stdout = '';
             let stderr = '';
             child.stdout.on('data', (d) => (stdout += d.toString()));
@@ -64,6 +65,15 @@ export function createBrowser({ session = DEFAULT_SESSION, headed = true, timeou
         activateTab: async (index) => {
             await run(['tab', String(index)]);
         },
+        reload: () => run(['reload']),
+        cookies: async () => {
+            const out = await run(['cookies', 'get', '--json']);
+            const env = JSON.parse(out);
+            if (env.success === false) {
+                throw new Error(`agent-browser cookies get failed: ${JSON.stringify(env.error)}`);
+            }
+            return env.data?.cookies ?? [];
+        },
         snapshot: ({ interactive = true, scope } = {}) => {
             const args = ['snapshot', '--json'];
             if (interactive)
@@ -98,9 +108,9 @@ export function createBrowser({ session = DEFAULT_SESSION, headed = true, timeou
                 args.push('--full');
             return run(args);
         },
-        eval: (js) => run(['eval', js]),
+        eval: (js) => run(['eval', '--stdin'], { input: js }),
         evalValue: async (js) => {
-            const out = await run(['eval', js]);
+            const out = await run(['eval', '--stdin'], { input: js });
             try {
                 return JSON.parse(out);
             }

package/dist/cdp-ensure.js

@@ -1,10 +1,11 @@
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
-import { spawn, spawnSync } from 'node:child_process';
+import { spawn } from 'node:child_process';
+import { defaultChromeBin, isChromeRunning, QUIT_CHROME_HINT } from "./cross-platform.js";
 const PORT = process.env.DESIGNER_CDP || '9222';
 const PROFILE = path.join(os.homedir(), '.chrome-designer-profile');
-const CHROME_BIN = process.env.CHROME_BIN || '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome';
+const CHROME_BIN = process.env.CHROME_BIN || defaultChromeBin();
 async function isCdpUp() {
     try {
         const res = await fetch(`http://127.0.0.1:${PORT}/json/version`, { signal: AbortSignal.timeout(1500) });
@@ -14,10 +15,6 @@ async function isCdpUp() {
         return false;
     }
 }
-function chromeRunning() {
-    const r = spawnSync('pgrep', ['-f', 'Google Chrome.app/Contents/MacOS/Google Chrome'], { stdio: 'pipe' });
-    return r.status === 0 && (r.stdout?.toString().trim().length ?? 0) > 0;
-}
 function sleep(ms) {
     return new Promise((r) => setTimeout(r, ms));
 }
@@ -27,8 +24,8 @@ export async function ensureCdpUp() {
     if (!fs.existsSync(PROFILE)) {
         throw new Error(`CDP not up on :${PORT} and no dedicated Chrome profile at ${PROFILE}. Run: designer setup`);
     }
-    if (chromeRunning()) {
-        throw new Error(`CDP not up on :${PORT} and a non-debug Chrome is already running. Quit Chrome (Cmd+Q) and retry, or run: designer setup`);
+    if (isChromeRunning()) {
+        throw new Error(`CDP not up on :${PORT} and a non-debug Chrome is already running. ${QUIT_CHROME_HINT} Then retry, or run: designer setup`);
     }
     if (!fs.existsSync(CHROME_BIN)) {
         throw new Error(`CDP not up on :${PORT} and Chrome not found at ${CHROME_BIN}. Set CHROME_BIN or install Chrome.`);

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env -S node --import tsx
 import fs from 'node:fs';
 import path from 'node:path';
-import { spawn, spawnSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
+import { xspawn, xspawnSync, WHICH, IS_WIN } from "./cross-platform.js";
 import { DesignerController } from "./designer-controller.js";
 import { listSessions, getSession } from "./session-store.js";
 import { createBrowser } from "./browser.js";
@@ -12,6 +12,7 @@ import { runSetup } from "./setup.js";
 import { startMcpServer } from "./mcp-server.js";
 import { REPO_ROOT } from "./repo-root.js";
 import { runHealth } from "./ui-anchors.js";
+import { PACKAGE_VERSION } from "./package-meta.js";
 const [, , cmd, ...rest] = process.argv;
 function parseFlags(args) {
     const out = { _: [] };
@@ -37,6 +38,10 @@ function parseFlags(args) {
 const flags = parseFlags(rest);
 const key = flags.key || 'default';
 async function main() {
+    if (cmd === '--version' || cmd === '-v' || cmd === 'version' || flags.version === true || flags.v === true) {
+        console.log(PACKAGE_VERSION);
+        return;
+    }
     if (flags.help === true || flags.h === true) {
         if (cmd && HELP[cmd]) {
             console.log(HELP[cmd]);
@@ -533,7 +538,7 @@ function checkDeps() {
 }
 async function checkAgentBrowser() {
     return new Promise((resolve) => {
-        const c = spawn('agent-browser', ['--version'], { stdio: 'pipe' });
+        const c = xspawn('agent-browser', ['--version'], { stdio: 'pipe' });
         let v = '';
         c.stdout.on('data', (d) => (v += d.toString()));
         c.on('error', () => resolve({ name: 'agent-browser installed', status: 'fail', detail: 'binary not found on PATH; install from https://github.com/agent-browser/agent-browser' }));
@@ -553,7 +558,7 @@ async function checkCdp() {
         return {
             name: `CDP at port ${port}`,
             status: 'fail',
-            detail: `not reachable. Run: ./scripts/designer-chrome.sh (launches Chrome with --remote-debugging-port=${port} in a dedicated profile)`
+            detail: `not reachable. Run: ${IS_WIN ? 'powershell scripts\\designer-chrome.ps1' : './scripts/designer-chrome.sh'} (launches Chrome with --remote-debugging-port=${port} in a dedicated profile)`
         };
     }
 }
@@ -619,11 +624,11 @@ function checkSkillInstalled() {
     return { name: 'designer-loop skill installed', status: 'ok', detail: skillDir };
 }
 async function checkMcpRegistered() {
-    const which = spawnSync('which', ['claude'], { stdio: 'pipe' });
+    const which = xspawnSync(WHICH, ['claude'], { stdio: 'pipe' });
     if (which.status !== 0) {
         return { name: 'MCP registered with Claude Code', status: 'warn', detail: 'claude CLI not on PATH; install Claude Code to verify' };
     }
-    const list = spawnSync('claude', ['mcp', 'list'], { stdio: 'pipe' });
+    const list = xspawnSync('claude', ['mcp', 'list'], { stdio: 'pipe' });
     if (list.status !== 0) {
         return { name: 'MCP registered with Claude Code', status: 'fail', detail: `\`claude mcp list\` exited ${list.status}` };
     }

package/dist/cross-platform.js

@@ -0,0 +1,50 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawn as nodeSpawn, spawnSync as nodeSpawnSync } from 'node:child_process';
+import crossSpawn from 'cross-spawn';
+export const IS_WIN = process.platform === 'win32';
+export const IS_MAC = process.platform === 'darwin';
+export const xspawn = crossSpawn;
+export const xspawnSync = crossSpawn.sync;
+export const WHICH = IS_WIN ? 'where' : 'which';
+export function defaultChromeBin() {
+    if (IS_WIN) {
+        const candidates = [
+            path.join(process.env['ProgramFiles'] || 'C:\\Program Files', 'Google', 'Chrome', 'Application', 'chrome.exe'),
+            path.join(process.env['ProgramFiles(x86)'] || 'C:\\Program Files (x86)', 'Google', 'Chrome', 'Application', 'chrome.exe'),
+            path.join(process.env['LOCALAPPDATA'] || '', 'Google', 'Chrome', 'Application', 'chrome.exe'),
+        ];
+        for (const c of candidates)
+            if (c && fs.existsSync(c))
+                return c;
+        return candidates[0] ?? 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe';
+    }
+    if (IS_MAC)
+        return '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome';
+    for (const c of ['/usr/bin/google-chrome', '/usr/bin/chromium', '/usr/bin/chromium-browser']) {
+        if (fs.existsSync(c))
+            return c;
+    }
+    return '/usr/bin/google-chrome';
+}
+export function isChromeRunning() {
+    if (IS_WIN) {
+        const r = nodeSpawnSync('tasklist', ['/FI', 'IMAGENAME eq chrome.exe', '/NH', '/FO', 'CSV'], { stdio: 'pipe' });
+        if (r.status !== 0)
+            return false;
+        const out = r.stdout?.toString() || '';
+        return out.toLowerCase().includes('chrome.exe');
+    }
+    if (IS_MAC) {
+        const r = nodeSpawnSync('pgrep', ['-f', 'Google Chrome.app/Contents/MacOS/Google Chrome'], { stdio: 'pipe' });
+        return r.status === 0 && (r.stdout?.toString().trim().length ?? 0) > 0;
+    }
+    const r = nodeSpawnSync('pgrep', ['-f', 'chrome'], { stdio: 'pipe' });
+    return r.status === 0 && (r.stdout?.toString().trim().length ?? 0) > 0;
+}
+export const QUIT_CHROME_HINT = IS_WIN
+    ? 'Close all Chrome windows (or end chrome.exe in Task Manager).'
+    : IS_MAC
+        ? 'Cmd+Q on the Chrome menu, then close Activity Monitor entries if any.'
+        : 'Close all Chrome windows or `pkill chrome`.';
+export { nodeSpawn, nodeSpawnSync };

package/dist/designer-controller.js

@@ -2,7 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 import crypto from 'node:crypto';
-import { spawn } from 'node:child_process';
+import { xspawn } from "./cross-platform.js";
 import { createBrowser } from "./browser.js";
 import { sessionDir, saveIteration } from "./artifact-store.js";
 import { upsertSession, appendHistory, getSession } from "./session-store.js";
@@ -574,7 +574,7 @@ export class DesignerController {
         const buf = Buffer.from(await res.arrayBuffer());
         fs.writeFileSync(tgzPath, buf);
         await new Promise((resolve, reject) => {
-            const child = spawn('tar', ['-xzf', tgzPath, '-C', bundleDir], { stdio: 'pipe' });
+            const child = xspawn('tar', ['-xzf', tgzPath, '-C', bundleDir], { stdio: 'pipe' });
             let err = '';
             child.stderr.on('data', (d) => (err += d.toString()));
             child.on('close', (code) => code === 0 ? resolve() : reject(new Error(`tar exited ${code}: ${err}`)));

package/dist/mcp-server.js

@@ -7,7 +7,8 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { z } from 'zod';
 import { DesignerController } from "./designer-controller.js";
 import { sessionDir } from "./artifact-store.js";
-const server = new McpServer({ name: 'designer', version: '0.3.0' });
+import { PACKAGE_VERSION } from "./package-meta.js";
+const server = new McpServer({ name: 'designer', version: PACKAGE_VERSION });
 const controllers = new Map();
 function getController(key) {
     const k = key || 'default';

package/dist/package-meta.js

@@ -0,0 +1,12 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { REPO_ROOT } from "./repo-root.js";
+function readPackageMetadata() {
+    const raw = JSON.parse(fs.readFileSync(path.join(REPO_ROOT, 'package.json'), 'utf8'));
+    return {
+        name: typeof raw.name === 'string' ? raw.name : 'designer',
+        version: typeof raw.version === 'string' ? raw.version : '0.0.0'
+    };
+}
+export const PACKAGE_METADATA = readPackageMetadata();
+export const PACKAGE_VERSION = PACKAGE_METADATA.version;

package/dist/repo-root.js

@@ -1,7 +1,8 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 function findRepoRoot() {
-    let dir = path.dirname(new URL(import.meta.url).pathname);
+    let dir = path.dirname(fileURLToPath(import.meta.url));
     for (let i = 0; i < 8; i++) {
         if (fs.existsSync(path.join(dir, 'package.json')))
             return dir;
@@ -10,6 +11,6 @@ function findRepoRoot() {
             break;
         dir = parent;
     }
-    throw new Error('repo-root: could not find package.json walking up from ' + new URL(import.meta.url).pathname);
+    throw new Error('repo-root: could not find package.json walking up from ' + fileURLToPath(import.meta.url));
 }
 export const REPO_ROOT = findRepoRoot();

package/dist/setup.js

@@ -1,14 +1,15 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
-import { spawn, spawnSync } from 'node:child_process';
+import { spawn } from 'node:child_process';
 import { createHash } from 'node:crypto';
 import { REPO_ROOT } from "./repo-root.js";
+import { defaultChromeBin, isChromeRunning, xspawnSync, WHICH, IS_WIN, QUIT_CHROME_HINT } from "./cross-platform.js";
 import { createBrowser } from "./browser.js";
 const SKILL_SRC = path.join(REPO_ROOT, 'skills', 'designer-loop', 'SKILL.md');
 const SKILL_DEST_DIR = path.join(os.homedir(), '.claude', 'skills', 'designer-loop');
 const SKILL_DEST = path.join(SKILL_DEST_DIR, 'SKILL.md');
-const CHROME_BIN = process.env.CHROME_BIN || '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome';
+const CHROME_BIN = process.env.CHROME_BIN || defaultChromeBin();
 const DEFAULT_PORT = process.env.DESIGNER_CDP || '9222';
 const PROFILE = path.join(os.homedir(), '.chrome-designer-profile');
 function log(stage, status, msg) {
@@ -32,13 +33,14 @@ async function verifySignedIn(browser) {
     return browser.evalValue(js).catch(() => false);
 }
 function chromeRunning() {
-    const r = spawnSync('pgrep', ['-f', 'Google Chrome.app/Contents/MacOS/Google Chrome'], { stdio: 'pipe' });
-    return r.status === 0 && (r.stdout?.toString().trim().length ?? 0) > 0;
+    return isChromeRunning();
 }
 function cdpChromeProfileStatus(port) {
     if (!/^\d+$/.test(port))
         return 'unknown';
-    const r = spawnSync('sh', ['-c', `ps -Axww -o command | grep -- '--remote-debugging-port=${port}' | grep -v grep`], { stdio: 'pipe' });
+    if (IS_WIN)
+        return 'unknown';
+    const r = xspawnSync('sh', ['-c', `ps -Axww -o command | grep -- '--remote-debugging-port=${port}' | grep -v grep`], { stdio: 'pipe' });
     if (r.status !== 0)
         return 'unknown';
     const out = r.stdout?.toString() ?? '';
@@ -107,7 +109,7 @@ async function step1NpmInstall() {
     else {
         log('deps', 'wait', 'running npm install...');
     }
-    const r = spawnSync('npm', ['install'], { cwd: REPO_ROOT, stdio: 'inherit' });
+    const r = xspawnSync('npm', ['install'], { cwd: REPO_ROOT, stdio: 'inherit' });
     if (r.status !== 0) {
         log('deps', 'fail', `npm install exited ${r.status}`);
         return false;
@@ -116,9 +118,9 @@ async function step1NpmInstall() {
     return true;
 }
 function step2AgentBrowser() {
-    const r = spawnSync('agent-browser', ['--version'], { stdio: 'pipe' });
+    const r = xspawnSync('agent-browser', ['--version'], { stdio: 'pipe' });
     if (r.status !== 0) {
-        log('agent-browser', 'fail', 'not found on PATH. Install: brew install agent-browser  OR  npm i -g agent-browser');
+        log('agent-browser', 'fail', 'not found on PATH. Install: npm i -g agent-browser');
         return false;
     }
     log('agent-browser', 'ok', r.stdout?.toString().trim() || 'present');
@@ -144,11 +146,11 @@ async function step3Chrome(port) {
         }
     }
     if (chromeRunning()) {
-        log('chrome', 'wait', 'A non-debug Chrome is running. Quit it (Cmd+Q on the Chrome menu, then close Activity Monitor entries if any). I am polling.');
+        log('chrome', 'wait', `A non-debug Chrome is running. ${QUIT_CHROME_HINT} I am polling.`);
         const quit = await pollUntil('chrome', () => !chromeRunning(), {
             intervalMs: 1000,
             timeoutMs: 5 * 60_000,
-            reminder: 'Still waiting for Chrome to fully quit. Cmd+Q on Chrome.'
+            reminder: `Still waiting for Chrome to fully quit. ${QUIT_CHROME_HINT}`
         });
         if (!quit) {
             log('chrome', 'fail', 'Timed out waiting for Chrome to quit. Quit manually then re-run setup.');
@@ -160,7 +162,14 @@ async function step3Chrome(port) {
         log('chrome', 'fail', `Chrome not found at ${CHROME_BIN}. Set CHROME_BIN to override.`);
         return false;
     }
-    const child = spawn(CHROME_BIN, ['--remote-debugging-port=' + port, '--user-data-dir=' + PROFILE, 'https://claude.ai/design'], {
+    const child = spawn(CHROME_BIN, [
+        '--remote-debugging-port=' + port,
+        '--user-data-dir=' + PROFILE,
+        '--no-first-run',
+        '--no-default-browser-check',
+        '--disable-search-engine-choice-screen',
+        'https://claude.ai/design'
+    ], {
         detached: true,
         stdio: 'ignore'
     });
@@ -171,7 +180,8 @@ async function step3Chrome(port) {
         reminder: `Waiting for CDP at :${port}...`
     });
     if (!up) {
-        log('chrome', 'fail', 'Chrome launched but CDP did not come up. Try `./scripts/designer-chrome.sh` manually.');
+        const fallback = IS_WIN ? 'scripts\\designer-chrome.ps1' : './scripts/designer-chrome.sh';
+        log('chrome', 'fail', `Chrome launched but CDP did not come up. Try \`${fallback}\` manually.`);
         return false;
     }
     log('chrome', 'ok', `CDP up on :${port}`);
@@ -181,7 +191,28 @@ async function step4SignIn(port) {
     const browser = createBrowser({ session: 'designer-setup', cdp: port });
     await browser.open('https://claude.ai/design').catch(() => undefined);
     await sleep(2500);
-    const ok = await pollUntil('login', () => verifySignedIn(browser), {
+    const MAX_RECOVERY_NAVS = 4;
+    const hasAuthCookie = async () => {
+        try {
+            return (await browser.cookies()).some((c) => /^sessionKey/.test(c.name) && /claude\.ai$/.test(c.domain) && c.value.length > 20);
+        }
+        catch {
+            return false;
+        }
+    };
+    let recoveryNavs = 0;
+    const checkSignedIn = async () => {
+        if (await verifySignedIn(browser))
+            return true;
+        if (recoveryNavs < MAX_RECOVERY_NAVS && (await hasAuthCookie())) {
+            recoveryNavs++;
+            await browser.open('https://claude.ai/design').catch(() => undefined);
+            await sleep(3000);
+            return verifySignedIn(browser);
+        }
+        return false;
+    };
+    const ok = await pollUntil('login', checkSignedIn, {
         intervalMs: 2000,
         timeoutMs: 10 * 60_000,
         reminder: 'Sign in to Claude in the DEBUG Chrome window I just opened (a separate window with no extensions/bookmarks — NOT your normal Chrome; the two have separate cookie jars). Then return to claude.ai/design. I am polling.',
@@ -189,6 +220,9 @@ async function step4SignIn(port) {
     });
     if (!ok) {
         log('login', 'fail', 'Timed out waiting for a signed-in claude.ai/design session. Re-run setup when ready.');
+        const watched = await browser.url().catch(() => '(unreachable)');
+        const authCookie = await hasAuthCookie();
+        log('login', 'fail', `Watched tab: ${watched} | Claude auth cookie: ${authCookie ? 'present — login succeeded but the tab stayed stale; re-run: designer setup' : 'absent (or watched tab is off claude.ai origin) — see watched URL above'}`);
         return false;
     }
     const url = (await browser.url().catch(() => '')) || 'claude.ai/design';
@@ -217,25 +251,21 @@ function step5Skill() {
     return true;
 }
 function step6Mcp(port) {
-    const claudeBin = spawnSync('which', ['claude'], { stdio: 'pipe' });
+    const claudeBin = xspawnSync(WHICH, ['claude'], { stdio: 'pipe' });
     if (claudeBin.status !== 0) {
         log('mcp', 'wait', 'claude CLI not on PATH; skipping MCP registration. Install Claude Code to register.');
         return true;
     }
-    const list = spawnSync('claude', ['mcp', 'list'], { stdio: 'pipe' });
+    const list = xspawnSync('claude', ['mcp', 'list'], { stdio: 'pipe' });
     const stdout = list.stdout?.toString() || '';
     if (/(\s|^)designer\b/i.test(stdout)) {
         log('mcp', 'ok', 'Already registered.');
         return true;
     }
-    const wrapper = path.join(REPO_ROOT, 'bin', 'designer');
-    if (!fs.existsSync(wrapper)) {
-        log('mcp', 'fail', `Missing wrapper ${wrapper}`);
-        return false;
-    }
-    const cmd = ['mcp', 'add', '--scope', 'user', '--transport', 'stdio', 'designer', '--', 'env', `DESIGNER_CDP=${port}`, wrapper, 'mcp', 'serve'];
+    const envFlags = port === '9222' ? [] : ['-e', `DESIGNER_CDP=${port}`];
+    const cmd = ['mcp', 'add', '--scope', 'user', '--transport', 'stdio', ...envFlags, 'designer', '--', 'designer', 'mcp', 'serve'];
     log('mcp', 'wait', `Registering: claude ${cmd.join(' ')}`);
-    const reg = spawnSync('claude', cmd, { stdio: 'inherit' });
+    const reg = xspawnSync('claude', cmd, { stdio: 'inherit' });
     if (reg.status !== 0) {
         log('mcp', 'fail', `claude mcp add exited ${reg.status}. Run manually:\n   claude ${cmd.join(' ')}`);
         return false;

package/dist/tasting.js

@@ -1,6 +1,27 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { spawn } from 'node:child_process';
+import { IS_WIN, IS_MAC, xspawn, xspawnSync } from "./cross-platform.js";
+function findPython() {
+    const candidates = IS_WIN ? ['py', 'python', 'python3'] : ['python3', 'python'];
+    for (const c of candidates) {
+        const r = xspawnSync(c, ['--version'], { stdio: 'pipe' });
+        if (r.status === 0)
+            return c;
+    }
+    return null;
+}
+function openUrl(url) {
+    if (IS_WIN) {
+        spawn('cmd', ['/c', 'start', '""', url], { stdio: 'ignore', detached: true }).unref();
+    }
+    else if (IS_MAC) {
+        spawn('open', [url], { stdio: 'ignore', detached: true }).unref();
+    }
+    else {
+        spawn('xdg-open', [url], { stdio: 'ignore', detached: true }).unref();
+    }
+}
 export function writeTastingHtml({ projectDir, variants, outPath, title = 'Tasting' }) {
     const target = outPath || path.join(projectDir, 'tasting.html');
     const html = renderTastingHtml({ variants, title });
@@ -85,7 +106,11 @@ function escapeHtml(s) {
 const servers = new Map();
 export async function serveAndOpen(projectDir, { file = 'tasting.html', port } = {}) {
     const chosenPort = port || (await pickFreePort(8765));
-    const child = spawn('python3', ['-m', 'http.server', String(chosenPort)], {
+    const python = findPython();
+    if (!python) {
+        throw new Error('tasting requires Python 3. Install python3 (macOS/Linux) or Python 3 from python.org (Windows).');
+    }
+    const child = xspawn(python, ['-m', 'http.server', String(chosenPort)], {
         cwd: projectDir,
         stdio: 'ignore',
         detached: true
@@ -93,7 +118,7 @@ export async function serveAndOpen(projectDir, { file = 'tasting.html', port } =
     child.unref();
     await sleep(500);
     const url = `http://127.0.0.1:${chosenPort}/${encodeURI(file)}`;
-    spawn('open', [url], { stdio: 'ignore', detached: true }).unref();
+    openUrl(url);
     const pid = child.pid ?? -1;
     servers.set(projectDir, { port: chosenPort, pid });
     return { url, port: chosenPort, pid };

package/dist/ui-anchors.js

@@ -9,6 +9,25 @@ async function hasButtonMatching(browser, pattern) {
         .catch(() => false));
 }
 export const UI_ANCHORS = [
+    {
+        id: 'login.signedIn',
+        category: 'pattern',
+        description: 'signed in (claude.ai is rendering the app shell, not the login wall)',
+        requires: 'any',
+        check: async (b, url) => {
+            if (/claude\.ai\/login/.test(url)) {
+                return { ok: false, detail: `signed out — Chrome is on the login wall (${url.slice(0, 80)}). Run: designer setup` };
+            }
+            if (/claude\.ai\/design/.test(url)) {
+                const signedIn = (await hasSelector(b, '[data-testid="project-creator"]')) ||
+                    (await hasSelector(b, '[data-testid="chat-composer-input"]'));
+                return signedIn
+                    ? { ok: true }
+                    : { ok: false, detail: `login wall rendered at ${url.slice(0, 80)} (no app shell) — signed out. Run: designer setup` };
+            }
+            return { ok: true, detail: `not on a claude.ai/design surface (url=${url.slice(0, 60)}) — sign-in not checked here` };
+        }
+    },
     {
         id: 'home.creator',
         category: 'home',
@@ -65,6 +84,31 @@ export const UI_ANCHORS = [
         requires: 'session',
         check: async (b) => ({ ok: await hasSelector(b, '[data-testid="chat-composer-input"]') })
     },
+    {
+        id: 'session.composerFillable',
+        category: 'session',
+        description: 'composer is fillable (textarea or contenteditable, per _submitPrompt)',
+        requires: 'session',
+        check: async (b) => {
+            const shape = await b
+                .evalValue(`(() => {
+            const el = document.querySelector('[data-testid="chat-composer-input"]');
+            if (!el) return { found: false };
+            const fillable = el instanceof HTMLTextAreaElement || el.isContentEditable;
+            return { found: true, tag: el.tagName, contentEditable: el.isContentEditable, fillable };
+          })()`)
+                .catch(() => ({ found: false }));
+            if (!shape.found)
+                return { ok: false, detail: 'composer not found' };
+            if (shape.fillable) {
+                return { ok: true, detail: shape.contentEditable ? 'contenteditable' : `<${(shape.tag || '').toLowerCase()}>` };
+            }
+            return {
+                ok: false,
+                detail: `composer is <${(shape.tag || '?').toLowerCase()}> — neither textarea nor contenteditable; _submitPrompt cannot fill it (composer shape drifted)`
+            };
+        }
+    },
     {
         id: 'session.sendButton',
         category: 'session',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pro-vi/designer",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "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",
@@ -23,13 +23,14 @@
     "anthropic"
   ],
   "bin": {
-    "designer": "./bin/designer"
+    "designer": "./bin/designer.mjs"
   },
   "scripts": {
     "mcp": "tsx mcp-server.ts",
     "cli": "tsx cli.ts",
     "setup": "tsx cli.ts setup",
     "doctor": "tsx cli.ts doctor",
+    "test": "npm run build && node --test tests/cli-metadata.test.mjs",
     "check": "tsc --noEmit",
     "build": "tsc -p tsconfig.build.json",
     "prepack": "npm run check && npm run build",
@@ -42,9 +43,11 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.102.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
+    "cross-spawn": "^7.0.6",
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
     "@types/node": "^25.6.0",
     "tsx": "^4.21.0",
     "typescript": "^6.0.3"
@@ -54,13 +57,15 @@
   },
   "os": [
     "darwin",
-    "linux"
+    "linux",
+    "win32"
   ],
   "files": [
     "dist/",
     "bin/",
     "skills/",
     "scripts/designer-chrome.sh",
+    "scripts/designer-chrome.ps1",
     "scripts/postinstall.mjs",
     "selectors.json",
     "README.md",

package/scripts/designer-chrome.ps1

@@ -0,0 +1,50 @@
+# Launch a Chrome instance with remote debugging enabled, in a dedicated
+# user-data-dir so the default profile's debug-port lockdown (Chrome 136+)
+# doesn't block us. Sign in to Claude once inside the launched window;
+# the profile persists.
+#
+# PowerShell equivalent of scripts/designer-chrome.sh for Windows users.
+
+$ErrorActionPreference = 'Stop'
+
+$Port    = if ($env:DESIGNER_CDP) { $env:DESIGNER_CDP } else { '9222' }
+$Profile = Join-Path $env:USERPROFILE '.chrome-designer-profile'
+
+# Default Chrome locations on Windows. Override with $env:CHROME_BIN.
+$DefaultChromes = @(
+  (Join-Path ${env:ProgramFiles}        'Google\Chrome\Application\chrome.exe'),
+  (Join-Path ${env:ProgramFiles(x86)}   'Google\Chrome\Application\chrome.exe'),
+  (Join-Path $env:LOCALAPPDATA          'Google\Chrome\Application\chrome.exe')
+)
+$Chrome = if ($env:CHROME_BIN) { $env:CHROME_BIN } else { $DefaultChromes | Where-Object { Test-Path $_ } | Select-Object -First 1 }
+
+if (-not $Chrome -or -not (Test-Path $Chrome)) {
+  Write-Error "[designer-chrome] Chrome not found. Set `$env:CHROME_BIN to override."
+  exit 1
+}
+
+# CDP already listening?
+try {
+  $null = Invoke-WebRequest -UseBasicParsing -Uri "http://127.0.0.1:$Port/json/version" -TimeoutSec 2
+  Write-Host "[designer-chrome] CDP already listening on port $Port - nothing to do."
+  Write-Host "                  curl http://127.0.0.1:$Port/json/version"
+  exit 0
+} catch {
+  # not running - continue
+}
+
+# Warn if a non-debug Chrome is up
+if (Get-Process -Name chrome -ErrorAction SilentlyContinue) {
+  Write-Warning "[designer-chrome] Chrome is already running."
+  Write-Warning "                  If it's NOT a debug-mode Chrome, the launched window may not get the debug port."
+  Write-Warning "                  Close existing Chrome windows first, or accept the risk and continue."
+}
+
+Write-Host "[designer-chrome] Launching: $Chrome --remote-debugging-port=$Port --user-data-dir=$Profile"
+Write-Host "[designer-chrome] Sign in to claude.ai in the new window. Then navigate to https://claude.ai/design."
+Write-Host "[designer-chrome] When done, leave this window open. The CDP server runs as long as Chrome runs."
+
+& $Chrome `
+  "--remote-debugging-port=$Port" `
+  "--user-data-dir=$Profile" `
+  "https://claude.ai/design"

package/bin/designer

@@ -1,35 +0,0 @@
-#!/usr/bin/env bash
-# Wrapper that resolves the repo's tsx + cli.ts regardless of the user's cwd.
-# Lets users type `designer <verb>` (after `npm link` or PATH symlink)
-# instead of the verbose `node_modules/.bin/tsx cli.ts <verb>`.
-
-set -e
-
-# Resolve symlinks to find the real script location, then back up to repo root.
-SOURCE="${BASH_SOURCE[0]}"
-while [ -h "$SOURCE" ]; do
-  DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
-  SOURCE="$(readlink "$SOURCE")"
-  [[ "$SOURCE" != /* ]] && SOURCE="$DIR/$SOURCE"
-done
-BIN_DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
-REPO_ROOT="$(cd "$BIN_DIR/.." && pwd)"
-
-DIST_CLI="$REPO_ROOT/dist/cli.js"
-TSX="$REPO_ROOT/node_modules/.bin/tsx"
-SRC_CLI="$REPO_ROOT/cli.ts"
-
-# Prefer compiled output (npm-installed users + post-build dev). Fall back to
-# tsx-on-source (clone-and-run dev mode, before tsc emits dist/).
-if [ -f "$DIST_CLI" ]; then
-  exec node "$DIST_CLI" "$@"
-fi
-
-if [ -x "$TSX" ] && [ -f "$SRC_CLI" ]; then
-  exec "$TSX" "$SRC_CLI" "$@"
-fi
-
-echo "[designer] No runnable found." >&2
-echo "           Expected $DIST_CLI (compiled) or $TSX + $SRC_CLI (dev)." >&2
-echo "           Run: cd $REPO_ROOT && npm install && npm run build" >&2
-exit 1