@monoes/monodesign 1.2.23 → 1.2.25

package/README.md

@@ -101,7 +101,7 @@ Source: [`cli/engine/registry/antipatterns.mjs`](packages/@monoes/monodesign/cli
 |---|---|---|
 | `regex` | Source text / CSS-in-JS scan | none |
 | `static-html` | HTMLparser2 static DOM parse | none |
-| `browser` | Puppeteer live-page scan | `puppeteer` (optional) |
+| `browser` | Live-page scan | `@monoes/monobrowse` (optional) with an installed Chrome, Chromium or Edge, else a `puppeteer` you install yourself |
 | `visual` | Visual contrast analysis | `@monoes/monobrowse` (optional) |
 
 ### Auto-Fix
@@ -198,7 +198,7 @@ Search order: `DESIGN.md` → `.agents/context/DESIGN.md` → `docs/DESIGN.md`.
 ```
 
 **Dependencies:** `css-select`, `css-tree`, `domutils`, `fflate`, `htmlparser2`, `marked`  
-**Optional:** `@monoes/monobrowse` (browser detection), `puppeteer` (live URL scanning)
+**Optional:** `@monoes/monobrowse` (browser detection and live URL scanning). `puppeteer` is no longer a dependency; install it yourself only for URL scans on a machine with no Chrome, Chromium or Edge. Through `monomind design detect`, monomind downloads a Chrome on first use instead.
 
 ---
 

package/cli/engine/engines/browser/drivers.mjs

@@ -175,6 +175,31 @@ function createMonobrowsePage(mb, client, sessionId, targetId, port) {
   };
 }
 
+// monobrowse's "the CDP endpoint never opened in time" errors: port 0 waits for
+// DevToolsActivePort, a forced port for the listener itself. Other launch
+// failures (no Chrome, spawn refused, Chrome exited, port squatted) would only
+// fail the same way again.
+const CDP_PORT_TIMEOUT_RE = /did not report a CDP port in .* within \d+ms|failed to start on port \d+ within \d+ms/;
+
+// Chrome's first launch on a cold Windows CI runner can take longer than the
+// whole launch timeout to open its CDP port (#583), while every launch after it
+// in the same job is quick. So a timeout gets one more attempt. monobrowse has
+// already killed the timed-out Chrome; its profile dir is dropped and the retry
+// gets a new one, because a leftover Chrome process could still hold the old
+// dir's singleton lock and the retry would hand off to it and exit.
+async function launchWithColdStartRetry(launch, config) {
+  for (let attempt = 1; ; attempt++) {
+    const userDataDir = mkdtempSync(join(tmpdir(), 'monodesign-cdp-'));
+    try {
+      const port = await launch({ ...config, userDataDir });
+      return { port, userDataDir };
+    } catch (error) {
+      removeProfileDir(userDataDir);
+      if (attempt >= 2 || !CDP_PORT_TIMEOUT_RE.test(error?.message ?? '')) throw error;
+    }
+  }
+}
+
 async function launchMonobrowseBrowser(options = {}) {
   const mb = await import('@monoes/monobrowse');
   const headless = options.headless ?? true;
@@ -210,8 +235,10 @@ async function launchMonobrowseBrowser(options = {}) {
   // where this bites: its singleton lock survives the previous Chrome being
   // force-killed, and outlives the port being released. A unique dir removes
   // the sharing entirely rather than racing the lock's cleanup.
-  const userDataDir = mkdtempSync(join(tmpdir(), 'monodesign-cdp-'));
-  const launchedPort = await mb.launchBrowser({ port, headless, args: launchArgs, launchTimeoutMs, userDataDir });
+  const { port: launchedPort, userDataDir } = await launchWithColdStartRetry(
+    mb.launchBrowser,
+    { port, headless, args: launchArgs, launchTimeoutMs },
+  );
   // Control connection (to the initial about:blank tab) — used for lifecycle
   // commands; detection pages get their own dedicated connections.
   const control = await mb.connectToTarget(launchedPort);
@@ -334,6 +361,7 @@ export {
   launchDetectionBrowser,
   launchMonobrowseBrowser,
   launchPuppeteerBrowser,
+  launchWithColdStartRetry,
   normalizeBrowserHandle,
   wrapPuppeteerBrowser,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoes/monodesign",
-  "version": "1.2.23",
+  "version": "1.2.25",
   "description": "Frontend design intelligence for AI agents — design tokens, antipattern detection, and the monodesign skill",
   "type": "module",
   "main": "./dist/index.js",
@@ -44,8 +44,10 @@
     "marked": "^18.0.0"
   },
   "optionalDependencies": {
-    "puppeteer": "^25.1.0",
-    "@monoes/monobrowse": "1.0.28"
+    "@monoes/monobrowse": "1.0.30"
+  },
+  "devDependencies": {
+    "puppeteer": "^25.1.0"
   },
   "scripts": {
     "prebuild": "node ../../../scripts/build-fs.mjs clean dist tsconfig.tsbuildinfo",

package/skill/SKILL.src.md

@@ -1,6 +1,6 @@
 ---
 name: monodesign
-description: "Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, research users, build a component system, generate design images, or otherwise improve a frontend interface. Covers websites, landing pages, dashboards, product UI, app shells, components, forms, settings, onboarding, and empty states. Handles UX review, visual hierarchy, information architecture, cognitive load, accessibility, performance, responsive behavior, theming, anti-patterns, typography, fonts, spacing, layout, alignment, color, motion, micro-interactions, UX copy, error states, edge cases, i18n, reusable design systems, tokens, brand identity, visual storytelling, UX research, usability testing, image generation prompts, and inclusive representation. Also use for bland designs that need to become bolder or more delightful, loud designs that should become quieter, live browser iteration on UI elements, or ambitious visual effects that should feel technically extraordinary. Not for backend-only or non-UI tasks."
+description: "Design, redesign, critique, audit or polish a frontend UI: landing pages, dashboards, components, forms; make it bolder or quieter; type, color, motion, a11y, design systems. Not for non-UI."
 version: 2.0.0
 argument-hint: "[{{command_hint}}] [target]"
 user-invocable: true