@seybel/breakhound 1.0.8 → 1.0.10

package/dist/cli.js

@@ -77,6 +77,7 @@ function findingKey(f) {
 }
 function severityScore(f) {
   const e = f.evidence;
+  if (typeof e.dayWidthPx === "number") return -e.dayWidthPx;
   if (typeof e.overflowPx === "number") return e.overflowPx;
   if (typeof e.overlapWidth === "number" && typeof e.overlapHeight === "number") {
     return e.overlapWidth * e.overlapHeight;
@@ -173,6 +174,9 @@ function buildIssues(route, widths, results) {
       evidence = { ...evidence, fixedWidthPx: onlyWidth };
       suggestion = `It stays ${onlyWidth}px wide no matter the screen size. Replace the fixed width with max-width: 100% (or a fluid width) so it can shrink.`;
     }
+    if (f.detector === "calendar") {
+      suggestion = calendarSuggestion(ranges, widths[widths.length - 1] ?? 0, f.evidence);
+    }
     const issue = {
       id: issueId(route, f),
       fingerprint: findingKey(f),
@@ -195,6 +199,18 @@ function buildIssues(route, widths, results) {
     (a, b) => order[a.severity] - order[b.severity] || (a.ranges[0]?.from ?? 0) - (b.ranges[0]?.from ?? 0)
   );
 }
+function calendarSuggestion(ranges, widest, evidence) {
+  const last = ranges[ranges.length - 1]?.to ?? widest;
+  const list = (where) => `show the days as a list ${where} (an agenda view, one day per row), the usual choice for calendars on phones`;
+  if (last >= widest) {
+    return `Its 7 days don't fit side by side at any width up to ${widest}px. Give the calendar more room or show less in each day, and ${list("on small screens")}.`;
+  }
+  const below = `below ${last + 1}px`;
+  if (evidence.scrollsSideways) {
+    return `It already scrolls sideways, but its days are still too narrow ${below}. Give the grid a min-width so each day keeps its room as it scrolls, or ${list(below)}. Narrower days, or fewer than 7 columns, won't fix it.`;
+  }
+  return `A calendar needs its 7 days side by side, and ${below} they don't fit. Narrower days, or fewer than 7 columns, won't fix it. Either let it scroll sideways inside its own box ${below} (a wrapper with overflow-x: auto, and a min-width on the grid), which keeps one layout; or ${list(below)}.`;
+}
 function joinRanges(ranges) {
   const sorted = [...ranges].sort((a, b) => a.from - b.from);
   const out = [];
@@ -918,6 +934,7 @@ var DETECTOR_IDS = [
   "unexpected-wrap",
   "clipped-text",
   "squished-text",
+  "calendar",
   "distorted-media",
   "small-tap-target",
   "tiny-text",
@@ -1272,6 +1289,7 @@ var DETECTOR_LABELS = {
   "unexpected-wrap": "Unexpected wrap",
   "clipped-text": "Clipped text",
   "squished-text": "Squished text",
+  calendar: "Calendar too narrow",
   "distorted-media": "Distorted image",
   "small-tap-target": "Small tap target",
   "tiny-text": "Tiny text",
@@ -5317,12 +5335,34 @@ function enabledDetectors(config) {
   if (!overrides) return void 0;
   return DETECTOR_IDS.filter((id) => overrides[id] !== false);
 }
+var SEVERITY_RANK = { error: 0, warning: 1, info: 2 };
+function calendarChecks(issue, overrides) {
+  return String(issue.evidence.checksInside ?? "").split(" ").filter(Boolean).map((part) => {
+    const [id = "", severity = "error"] = part.split(":");
+    const o = overrides[id];
+    return { id, severity: typeof o === "string" ? o : severity };
+  }).filter((c) => overrides[c.id] !== false);
+}
+function keepIssue(issue, overrides) {
+  if (overrides[issue.detector] === false) return false;
+  if (issue.detector !== "calendar" || !issue.evidence.checksInside) return true;
+  return calendarChecks(issue, overrides).length > 0;
+}
 function applySeverity(routes, config) {
   const overrides = config.detectors ?? {};
   for (const route of routes) {
     for (const issue of route.issues) {
       const o = overrides[issue.detector];
       if (o === "error" || o === "warning" || o === "info") issue.severity = o;
+      else if (issue.detector === "calendar") {
+        const checks = calendarChecks(issue, overrides);
+        if (checks.length) {
+          issue.severity = checks.reduce(
+            (worst, c) => SEVERITY_RANK[c.severity] < SEVERITY_RANK[worst] ? c.severity : worst,
+            "info"
+          );
+        }
+      }
     }
   }
 }
@@ -5600,7 +5640,7 @@ async function saveExtensionScan(sent, config, cwd) {
   const off = config.detectors ?? {};
   const routes = sent.routes.map((r) => ({
     ...r,
-    issues: r.issues.filter((i) => off[i.detector] !== false)
+    issues: r.issues.filter((i) => keepIssue(i, off))
   }));
   applySeverity(routes, config);
   relativeSources(routes, project?.root ?? cwd, project?.basePath ?? "", project?.workspace);
@@ -5772,7 +5812,7 @@ async function runVerify(req) {
       root: req.cwd
     });
     const off = req.config.detectors ?? {};
-    for (const r of now.routes) r.issues = r.issues.filter((i) => off[i.detector] !== false);
+    for (const r of now.routes) r.issues = r.issues.filter((i) => keepIssue(i, off));
     return finishVerify(req, baseline, now);
   }
   const { settings } = baseline;
@@ -6294,6 +6334,12 @@ function checkRoutes(value) {
     }
     for (const i of r.issues) {
       const element = isObject(i) ? i.element : null;
+      if (isObject(i) && typeof i.detector === "string" && !DETECTOR_IDS.includes(i.detector)) {
+        throw new HttpError(
+          400,
+          `This project's breakhound doesn't know the check "${i.detector.slice(0, 40)}" yet. Restart your agent with the latest breakhound to send it.`
+        );
+      }
       if (!isObject(i) || typeof i.id !== "string" || typeof i.title !== "string" || !DETECTOR_IDS.includes(i.detector) || !SEVERITIES.has(String(i.severity)) || !Array.isArray(i.ranges) || !isObject(element) || typeof element.selector !== "string") {
         throw new HttpError(400, "Bad issue");
       }
@@ -6349,7 +6395,9 @@ async function startBridge(opts) {
           name: "breakhound",
           version: opts.version,
           root: opts.root,
-          project: projectName(opts.root)
+          project: projectName(opts.root),
+          // So a newer extension sends only checks this version knows.
+          detectors: DETECTOR_IDS
         });
       case "/breakhound/match": {
         if (typeof body.url !== "string") throw new HttpError(400, "No url");
@@ -6420,7 +6468,7 @@ async function startBridge(opts) {
       case "/breakhound/checks/progress": {
         const check = checks.get(String(body.id));
         if (check && typeof body.done === "number" && typeof body.message === "string") {
-          check.onProgress?.(body.done, body.message.slice(0, 200));
+          check.onProgress?.(body.done, body.message.slice(0, 400));
         }
         return reply({});
       }
@@ -6430,7 +6478,14 @@ async function startBridge(opts) {
         checks.delete(check.id);
         clearTimeout(check.timer);
         if (typeof body.error === "string") check.reject(new Error(body.error.slice(0, 500)));
-        else check.resolve(checkRoutes(body.routes));
+        else {
+          try {
+            check.resolve(checkRoutes(body.routes));
+          } catch (error) {
+            check.reject(error instanceof Error ? error : new Error(String(error)));
+            throw error;
+          }
+        }
         return reply({});
       }
       default:
@@ -6526,6 +6581,9 @@ async function startBridge(opts) {
   };
 }
 
+// src/icon.ts
+var ICON_PNG = "data:image/png;base64,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";
+
 // src/mcp.ts
 var PROTOCOL_VERSIONS = ["2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05"];
 var INSTRUCTIONS = `breakhound finds responsive layout bugs by resizing pages in a real browser, and tells you the exact widths where they happen.
@@ -6538,12 +6596,15 @@ How to fix issues with it:
 5. When verify is clean for a route, checkpoint it. That commits the fix on its own, so it can be undone later with undo.
 Before finishing, run verify with no routes to check every page.
 
-Issues sent from the extension are checked again in the developer's own browser: verify asks the open breakhound panel to scan the pages, so their login and browser carry over. If no panel is open, verify says so; ask the developer to open it rather than calling scan, which replaces their issues with a headless scan.`;
+scan and verify answer within about 45 seconds. When one says it's still running, it carries on: call it again with the same arguments to get its result, rather than something else. It says what it's waiting for; if that's the developer's browser tab, ask them to bring it into view.
+
+Issues sent from the extension are checked again in the developer's own browser: verify asks the open breakhound panel to scan the pages, so their login and browser carry over. If no panel is open, verify says so; ask the developer to open it rather than calling scan, which replaces their issues with a headless scan. Chrome doesn't draw a tab that's out of view, so before you first verify them, tell the developer in one line that breakhound is about to check your fixes in their Chrome tab, and that the tab needs to be in view (beside their editor is fine) until it's done.`;
 var FIX_PROMPT = `Fix the responsive layout issues breakhound found in this project.
 
 Start with list_issues: if I sent them from the breakhound extension they are already there, so don't scan again. Only scan when there are none.
 Work through the errors first, then the warnings. For each one: get_issue for the details, fix the cause in the code (not overflow: hidden), verify the routes you touched, and checkpoint each route once verify is clean for it.
 Before you finish, verify with no routes to check every page, and tell me what you fixed and anything you couldn't.`;
+var REPLY_WITHIN_MS = 45e3;
 var text = (t, isError = false) => ({
   content: [{ type: "text", text: t }],
   ...isError ? { isError } : {}
@@ -6602,6 +6663,7 @@ function createTools() {
   return [
     {
       name: "scan",
+      kind: "long",
       description: "Find the app (starting its dev server if needed), discover its routes and scan each one at every width from 320 to 1920px in a headless browser. Returns every issue with its id. The result is the baseline that verify compares with, replacing any issues the developer sent from the browser extension, so check list_issues first. Takes from seconds to a few minutes on large apps.",
       inputSchema: {
         type: "object",
@@ -6629,6 +6691,7 @@ function createTools() {
     },
     {
       name: "list_routes",
+      kind: "read",
       description: "Routes from the last scan, with their status and number of issues.",
       inputSchema: { type: "object", properties: {} },
       async run(_args, ctx) {
@@ -6638,6 +6701,7 @@ function createTools() {
     },
     {
       name: "list_issues",
+      kind: "read",
       description: "Issues from the last scan or verify, each listed once even when it shows up on several routes. Filter by route or severity.",
       inputSchema: {
         type: "object",
@@ -6657,6 +6721,7 @@ function createTools() {
     },
     {
       name: "get_issue",
+      kind: "read",
       description: "Everything about one issue: the widths, the element and where it is in the code (when known), measurements, computed styles, a likely fix, every page it is on, and a screenshot.",
       inputSchema: {
         type: "object",
@@ -6687,7 +6752,8 @@ function createTools() {
     },
     {
       name: "verify",
-      description: "Scan routes again and compare with the baseline from scan: which issues are fixed, which are still there, and which are new (a change broke something, maybe at another width or on another route). Pass the routes you changed for a quick check, and nothing to check every route before you finish.",
+      kind: "long",
+      description: "Scan routes again and compare with the baseline from scan: which issues are fixed, which are still there, and which are new (a change broke something, maybe at another width or on another route). Pass the routes you changed for a quick check, and nothing to check every route before you finish. Issues sent from the browser extension are checked in the developer's Chrome tab, which must be in view: tell them before you first call it.",
       inputSchema: {
         type: "object",
         properties: {
@@ -6861,6 +6927,8 @@ async function runMcpServer(version, io = { input: process.stdin, output: proces
   let clientCanListRoots = false;
   let root = process.env.BREAKHOUND_ROOT ?? null;
   let queue = Promise.resolve();
+  let job = null;
+  const replyWithinMs = Number(process.env.BREAKHOUND_REPLY_WITHIN_MS) || REPLY_WITHIN_MS;
   const send = (message) => io.output.write(`${JSON.stringify({ jsonrpc: "2.0", ...message })}
 `);
   const request = (method, params = {}) => new Promise((resolve8, reject) => {
@@ -6890,13 +6958,17 @@ async function runMcpServer(version, io = { input: process.stdin, output: proces
     root ??= cwd;
     return root;
   }
-  async function callTool(id, params) {
-    const tool = tools.find((t) => t.name === params.name);
-    if (!tool) {
-      send({ id, error: { code: -32602, message: `Unknown tool: ${String(params.name)}` } });
-      return;
-    }
+  const progressFor = (params) => {
     const token = params._meta?.progressToken;
+    return (done, message) => {
+      if (token !== void 0)
+        send({
+          method: "notifications/progress",
+          params: { progressToken: token, progress: done, message }
+        });
+    };
+  };
+  async function runTool(tool, params, progress) {
     try {
       const dir = await projectRoot();
       const { config, warnings } = await loadConfig(dir);
@@ -6907,22 +6979,93 @@ async function runMcpServer(version, io = { input: process.stdin, output: proces
           root: dir,
           config,
           bridge,
-          progress(done, message) {
-            if (token !== void 0)
-              send({
-                method: "notifications/progress",
-                params: { progressToken: token, progress: done, message }
-              });
-          }
+          progress
         })
       );
       if (warnings.length)
         result.content.push({ type: "text", text: `Config warnings: ${warnings.join(" ")}` });
-      send({ id, result });
+      return result;
     } catch (error) {
       if (error instanceof MemoryError) server.current = null;
-      send({ id, result: text(error instanceof Error ? error.message : String(error), true) });
+      return text(error instanceof Error ? error.message : String(error), true);
+    }
+  }
+  const running = (j) => `${j.label} has been running for ${Math.round((Date.now() - j.startedAt) / 1e3)}s${j.latest ? ` (${j.latest})` : ""}.`;
+  async function collect(j, params) {
+    const late = new Promise((r) => setTimeout(() => r(null), replyWithinMs).unref());
+    j.waiting = progressFor(params);
+    const result = await Promise.race([j.done, late]);
+    j.waiting = null;
+    if (result) {
+      if (job === j) job = null;
+      return result;
+    }
+    return text(
+      `Still running: ${running(j)} It carries on by itself. Call ${j.name} again with the same arguments to get its result; list_issues and get_issue answer meanwhile.`
+    );
+  }
+  async function callTool(id, params) {
+    const tool = tools.find((t) => t.name === params.name);
+    if (!tool) {
+      send({ id, error: { code: -32602, message: `Unknown tool: ${String(params.name)}` } });
+      return;
     }
+    const key = `${tool.name} ${JSON.stringify(params.arguments ?? {})}`;
+    const busy = job && !job.finished ? job : null;
+    if (tool.kind === "read") {
+      const result = await runTool(tool, params, progressFor(params));
+      if (busy)
+        result.content.push({
+          type: "text",
+          text: `Note: ${running(busy)} Call ${busy.name} again with the same arguments for its result.`
+        });
+      send({ id, result });
+      return;
+    }
+    if (job?.key === key) {
+      send({ id, result: await collect(job, params) });
+      return;
+    }
+    if (busy) {
+      send({
+        id,
+        result: text(
+          `Not yet: ${running(busy)} Call ${busy.name} again with the same arguments to get its result first.`,
+          true
+        )
+      });
+      return;
+    }
+    if (tool.kind !== "long") {
+      job = null;
+      queue = queue.then(() => runTool(tool, params, progressFor(params)));
+      send({ id, result: await queue });
+      return;
+    }
+    const args = params.arguments ?? {};
+    const routes = strings(args.routes);
+    const j = {
+      key,
+      name: tool.name,
+      label: `${tool.name}${routes.length ? ` of ${routes.join(", ")}` : ""}`,
+      startedAt: Date.now(),
+      latest: "",
+      finished: false,
+      waiting: null,
+      done: Promise.resolve(text(""))
+    };
+    j.done = queue.then(
+      () => runTool(tool, params, (done, message) => {
+        j.latest = message;
+        j.waiting?.(done, message);
+      })
+    );
+    j.done.then(() => {
+      j.finished = true;
+    });
+    queue = j.done;
+    job = j;
+    send({ id, result: await collect(j, params) });
   }
   function handle(message) {
     const { id, method } = message;
@@ -6948,7 +7091,13 @@ async function runMcpServer(version, io = { input: process.stdin, output: proces
           result: {
             protocolVersion: PROTOCOL_VERSIONS.includes(asked) ? asked : PROTOCOL_VERSIONS[0],
             capabilities: { tools: { listChanged: false }, prompts: { listChanged: false } },
-            serverInfo: { name: "breakhound", version: VERSION },
+            serverInfo: {
+              name: "breakhound",
+              version: VERSION,
+              // Shown beside the server by clients that show icons. No sizes: some clients' older
+              // schemas expect another shape for it, and an icon isn't worth a failed connection.
+              icons: [{ src: ICON_PNG, mimeType: "image/png" }]
+            },
             instructions: INSTRUCTIONS
           }
         });
@@ -6996,7 +7145,7 @@ async function runMcpServer(version, io = { input: process.stdin, output: proces
         });
         return;
       case "tools/call":
-        queue = queue.then(() => callTool(id, params));
+        void callTool(id, params);
         return;
       default:
         send({ id, error: { code: -32601, message: `Method not found: ${String(method)}` } });
@@ -7030,11 +7179,16 @@ import { createInterface as createInterface3 } from "readline/promises";
 import { styleText as styleText8 } from "util";
 var SERVER_NAME = "breakhound";
 var PACKAGE = "@seybel/breakhound";
+var LATEST = `${PACKAGE}@latest`;
 function startsOtherPackage(args) {
-  return Array.isArray(args) && args.includes("breakhound") && !args.includes(PACKAGE);
+  return Array.isArray(args) && args.includes("breakhound") && !args.some((a) => typeof a === "string" && a.startsWith(PACKAGE));
+}
+function wroteUntagged(args) {
+  return Array.isArray(args) && args.includes(PACKAGE) && args.includes("mcp");
 }
+var toLatest = (args) => args.map((a) => a === PACKAGE ? LATEST : a);
 function serverCommand(platform = process.platform) {
-  const args = ["-y", PACKAGE, "mcp"];
+  const args = ["-y", LATEST, "mcp"];
   return platform === "win32" ? { command: "cmd", args: ["/c", "npx", ...args] } : { command: "npx", args };
 }
 function jsonClient(id, name, file, key, entry) {
@@ -7055,8 +7209,11 @@ ${JSON.stringify({ [SERVER_NAME]: entry }, null, 2)}`
         }
       }
       const existing = data[key]?.[SERVER_NAME];
-      if (existing && !startsOtherPackage(existing.args)) return null;
-      data[key] = { ...data[key], [SERVER_NAME]: entry };
+      if (existing && !startsOtherPackage(existing.args) && !wroteUntagged(existing.args)) {
+        return null;
+      }
+      const next = existing && wroteUntagged(existing.args) ? { ...existing, args: toLatest(existing.args) } : entry;
+      data[key] = { ...data[key], [SERVER_NAME]: next };
       return `${JSON.stringify(data, null, 2)}
 `;
     }
@@ -7076,6 +7233,9 @@ args = ${JSON.stringify(args).replaceAll(",", ", ")}
       const table = /^\[mcp_servers\.breakhound\]\n(?:(?!\[)[^\n]*\n?)*/m;
       const found = current?.match(table)?.[0];
       if (found) {
+        if (found.includes(`"${PACKAGE}"`)) {
+          return current.replace(table, found.replace(`"${PACKAGE}"`, `"${LATEST}"`));
+        }
         if (found.includes(PACKAGE) || !/["']breakhound["']/.test(found)) return null;
         return current.replace(table, `${block}${found.endsWith("\n\n") ? "\n" : ""}`);
       }
@@ -7140,6 +7300,7 @@ function show(path, cwd) {
   const rel = relative7(cwd, path);
   return rel.startsWith("..") ? path.replace(homedir(), "~") : rel;
 }
+var NOT_SHOWING_UP = "Not showing up? Your agent runs breakhound only while this folder is open in it, and with breakhound switched on in its MCP settings (Cursor and VS Code may add it switched off), so check both. How, for each agent: https://seybel.github.io/breakhound/guide/agents#not-connected";
 async function installMcp(cwd, options = {}) {
   const home = options.home ?? homedir();
   const clients = options.clients?.length ? allClients(cwd, home).filter((c) => options.clients?.includes(c.id)) : detectClients(cwd, home);
@@ -7151,24 +7312,43 @@ async function installMcp(cwd, options = {}) {
     return 1;
   }
   const changes = [];
+  let alreadySetUp = false;
   for (const client of clients) {
     const current = existsSync15(client.file) ? readFileSync18(client.file, "utf8") : null;
     try {
       const next = client.update(current);
-      if (next === null)
+      if (next === null) {
+        alreadySetUp = true;
         console.log(
           `${styleText8("green", "\u2714")} ${client.name}: already set up in ${show(client.file, cwd)}`
         );
-      else changes.push({ client, next });
+      } else {
+        const updating2 = !!current && /["']@?(?:seybel\/)?breakhound["']/.test(current);
+        changes.push({ client, next, updating: updating2 });
+      }
     } catch (error) {
       console.log(`${styleText8("yellow", "!")} ${client.name}: ${error.message}`);
     }
   }
-  if (!changes.length) return 0;
-  console.log("\nbreakhound will add its MCP server to:\n");
+  if (!changes.length) {
+    if (alreadySetUp) console.log(`
+${NOT_SHOWING_UP}`);
+    return 0;
+  }
   const { command, args } = serverCommand();
-  for (const { client } of changes) {
-    console.log(`  ${client.name.padEnd(12)} ${show(client.file, cwd)}`);
+  const adding = changes.filter((c) => !c.updating);
+  const updating = changes.filter((c) => c.updating);
+  if (adding.length) {
+    console.log("\nbreakhound will add its MCP server to:\n");
+    for (const { client } of adding)
+      console.log(`  ${client.name.padEnd(12)} ${show(client.file, cwd)}`);
+  }
+  if (updating.length) {
+    console.log(
+      "\nbreakhound will update its MCP server, so your agent always starts the latest, in:\n"
+    );
+    for (const { client } of updating)
+      console.log(`  ${client.name.padEnd(12)} ${show(client.file, cwd)}`);
   }
   console.log(styleText8("dim", `
   The server runs: ${command} ${args.join(" ")}
@@ -7179,22 +7359,25 @@ async function installMcp(cwd, options = {}) {
       return 1;
     }
     const rl = createInterface3({ input: process.stdin, output: process.stdout });
-    const answer = (await rl.question("Add it? [Y/n] ")).trim().toLowerCase();
+    const answer = (await rl.question(adding.length ? "Add it? [Y/n] " : "Update it? [Y/n] ")).trim().toLowerCase();
     rl.close();
     if (answer && answer !== "y" && answer !== "yes") {
       console.log("Nothing changed.");
       return 0;
     }
   }
-  for (const { client, next } of changes) {
+  for (const { client, next, updating: updating2 } of changes) {
     mkdirSync3(dirname5(client.file), { recursive: true });
     writeFileSync8(client.file, next);
-    console.log(`${styleText8("green", "\u2714")} ${client.name}: added to ${show(client.file, cwd)}`);
+    console.log(
+      `${styleText8("green", "\u2714")} ${client.name}: ${updating2 ? "updated in" : "added to"} ${show(client.file, cwd)}`
+    );
   }
   console.log(
     `
 Restart your agent (or reload its MCP servers), then ask it to "fix the responsive issues breakhound finds".`
   );
+  console.log(NOT_SHOWING_UP);
   return 0;
 }
 
@@ -7299,7 +7482,7 @@ function normalizeBaseUrl(url) {
     throw new Error(`--url must be a URL like http://localhost:3000 (got "${url}")`);
   }
 }
-var SEVERITY_RANK = { error: 0, warning: 1, info: 2 };
+var SEVERITY_RANK2 = { error: 0, warning: 1, info: 2 };
 function positiveInt(name, value) {
   if (value === void 0) return void 0;
   const n = Number(value);
@@ -7356,7 +7539,7 @@ async function main(argv) {
   const cwd = process.cwd();
   const [command, ...rest2] = positionals;
   const askedFailOn = values["fail-on"];
-  if (askedFailOn !== void 0 && askedFailOn !== "none" && !Object.hasOwn(SEVERITY_RANK, askedFailOn)) {
+  if (askedFailOn !== void 0 && askedFailOn !== "none" && !Object.hasOwn(SEVERITY_RANK2, askedFailOn)) {
     throw new Error("--fail-on must be one of: error, warning, info, none");
   }
   if (command === "init") {
@@ -7508,7 +7691,7 @@ ${formatVerify(v, severities.length ? severities : severitiesAtOrAbove("info"))}
   const concurrency = positiveInt("concurrency", values.concurrency);
   const maxRoutes = positiveInt("max-routes", values["max-routes"]);
   const failOn = values["fail-on"] ?? fileConfig.failOn ?? "error";
-  if (failOn !== "none" && !Object.hasOwn(SEVERITY_RANK, failOn)) {
+  if (failOn !== "none" && !Object.hasOwn(SEVERITY_RANK2, failOn)) {
     throw new Error("--fail-on must be one of: error, warning, info, none");
   }
   const browsers = values.browsers?.split(",").map((b) => b.trim().toLowerCase()).filter(Boolean);
@@ -7546,9 +7729,9 @@ ${formatVerify(v, severities.length ? severities : severitiesAtOrAbove("info"))}
   }
   if (result.routes.some((r) => FAILED_STATUSES.includes(r.status))) return 2;
   if (failOn === "none") return 0;
-  const threshold = SEVERITY_RANK[failOn];
+  const threshold = SEVERITY_RANK2[failOn];
   const failing = result.routes.some(
-    (r) => r.issues.some((i) => SEVERITY_RANK[i.severity] <= threshold)
+    (r) => r.issues.some((i) => SEVERITY_RANK2[i.severity] <= threshold)
   );
   return failing ? 1 : 0;
 }

package/dist/index.d.cts

@@ -1,5 +1,7 @@
 export type Severity = "error" | "warning" | "info";
-export type DetectorId = "page-overflow" | "content-overflow" | "media-overflow" | "overlap" | "unexpected-wrap" | "clipped-text" | "squished-text" | "distorted-media" | "small-tap-target" | "tiny-text" | "oversized-text" | "edge-gutter" | "viewport-meta"
+export type DetectorId = "page-overflow" | "content-overflow" | "media-overflow" | "overlap" | "unexpected-wrap" | "clipped-text" | "squished-text"
+/** What breaks inside a month or week calendar, reported once as the calendar. */
+ | "calendar" | "distorted-media" | "small-tap-target" | "tiny-text" | "oversized-text" | "edge-gutter" | "viewport-meta"
 /** Opt-in: what a vision model noticed in screenshots. Never run in the page. */
  | "vision";
 /** Where an element comes from in the project's code. */

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export type Severity = "error" | "warning" | "info";
-export type DetectorId = "page-overflow" | "content-overflow" | "media-overflow" | "overlap" | "unexpected-wrap" | "clipped-text" | "squished-text" | "distorted-media" | "small-tap-target" | "tiny-text" | "oversized-text" | "edge-gutter" | "viewport-meta"
+export type DetectorId = "page-overflow" | "content-overflow" | "media-overflow" | "overlap" | "unexpected-wrap" | "clipped-text" | "squished-text"
+/** What breaks inside a month or week calendar, reported once as the calendar. */
+ | "calendar" | "distorted-media" | "small-tap-target" | "tiny-text" | "oversized-text" | "edge-gutter" | "viewport-meta"
 /** Opt-in: what a vision model noticed in screenshots. Never run in the page. */
  | "vision";
 /** Where an element comes from in the project's code. */

package/dist/inject.js

@@ -559,6 +559,169 @@
     return info;
   }
 
+  // ../analyzers/src/detectors/calendar.ts
+  var FOLDED = /* @__PURE__ */ new Set([
+    "page-overflow",
+    "content-overflow",
+    "media-overflow",
+    "overlap",
+    "clipped-text",
+    "squished-text"
+  ]);
+  var EVENT_CELL_HEIGHT = 56;
+  var ALIGN_PX = 2;
+  var MAX_LEVELS = 10;
+  var ALIASES = { weds: "wednesday" };
+  var normalize = (text) => text.replace(/\s+/g, " ").trim().toLowerCase().replace(/[.,:]$/, "");
+  var names = null;
+  function weekNames() {
+    const langs = [document.documentElement.lang, navigator.language, "en"].filter(Boolean);
+    const key = langs.join("|");
+    if (names?.key === key) return names.weeks;
+    const weeks = [];
+    for (const lang of new Set(langs)) {
+      try {
+        const format = (weekday) => new Intl.DateTimeFormat(lang, { weekday, timeZone: "UTC" });
+        const days = Array.from({ length: 7 }, (_, i) => new Date(Date.UTC(2024, 0, 1 + i)));
+        const long = days.map((d) => normalize(format("long").format(d)));
+        const exact = days.map(
+          (d, i) => /* @__PURE__ */ new Set([
+            long[i],
+            normalize(format("short").format(d)),
+            normalize(format("narrow").format(d))
+          ])
+        );
+        weeks.push({ long, exact });
+      } catch {
+      }
+    }
+    names = { key, weeks };
+    return weeks;
+  }
+  function isDay(text, week, day) {
+    if (week.exact[day]?.has(text) || ALIASES[text] === week.long[day]) return true;
+    return text.length >= 2 && (week.long[day]?.startsWith(text) ?? false);
+  }
+  function isWeek(texts) {
+    if (texts.length !== 7 || texts.some((t) => !t)) return false;
+    return weekNames().some(
+      (week) => Array.from({ length: 7 }, (_, start) => start).some(
+        (start) => texts.every((t, i) => isDay(t, week, (start + i) % 7))
+      )
+    );
+  }
+  var lined = (a, b) => Math.abs(a.rect.left - b.rect.left) <= ALIGN_PX && Math.abs(a.rect.width - b.rect.width) <= ALIGN_PX;
+  function dayCells(snap, scope, weekdays) {
+    const header = new Set(weekdays.map((w) => w.el));
+    const out = [];
+    for (const el of scope.querySelectorAll("*")) {
+      if (header.has(el) || weekdays.some((w) => w.el.contains(el))) continue;
+      const rec = snap.byElement.get(el);
+      if (!rec || rec.rect.height < 1) continue;
+      if (out.some((o) => o.el.contains(el))) continue;
+      if (weekdays.some((w) => lined(w, rec)) && rec.rect.top >= (weekdays[0]?.rect.bottom ?? 0) - 1)
+        out.push(rec);
+    }
+    return out;
+  }
+  function holdsEvents(days) {
+    const heights = days.map((d) => d.rect.height).sort((a, b) => a - b);
+    return (heights[Math.floor(heights.length / 2)] ?? 0) >= EVENT_CELL_HEIGHT;
+  }
+  function shownText(el) {
+    const text = el instanceof HTMLElement ? el.innerText : el.textContent;
+    return normalize((text ?? "").replace(/\d+/g, " "));
+  }
+  function weekRow(snap, cells) {
+    for (let start = 0; start <= 1 && start + 7 <= cells.length; start++) {
+      const row = cells.slice(start, start + 7).map((c) => snap.byElement.get(c)).filter((r) => !!r && r.rect.width > 0);
+      if (row.length !== 7 || !isWeek(row.map((r) => shownText(r.el)))) continue;
+      const tops = row.map((r) => Math.round(r.rect.top));
+      if (Math.max(...tops) - Math.min(...tops) <= ALIGN_PX) return row;
+    }
+    return null;
+  }
+  function scrollsSideways(snap, el) {
+    for (let p = el; p && p !== document.body; p = composedParent(p)) {
+      const overflow = snap.byElement.get(p)?.style.overflowX;
+      if (overflow === "auto" || overflow === "scroll") return true;
+    }
+    return false;
+  }
+  function findCalendars(snap) {
+    const found = [];
+    for (const rec of snap.records) {
+      const children = renderedChildren(rec.el);
+      if (children.length < 7) continue;
+      if (found.some((c) => c.root.contains(rec.el))) continue;
+      const weekdays = weekRow(snap, children);
+      if (!weekdays) continue;
+      let scope = rec.el;
+      for (let level = 0; scope && level < MAX_LEVELS; level++, scope = composedParent(scope)) {
+        if (scope === document.body) break;
+        const days = dayCells(snap, scope, weekdays);
+        const columns = new Set(days.map((d) => weekdays.findIndex((w) => lined(w, d))));
+        if (days.length < 7 || columns.size < 7) continue;
+        if (holdsEvents(days)) {
+          found.push({ root: scope, weekdays, days, scrolls: scrollsSideways(snap, scope) });
+        }
+        break;
+      }
+    }
+    return found;
+  }
+  var RANK = { error: 0, warning: 1, info: 2 };
+  function inside(root, el) {
+    for (let p = el ?? null; p; p = composedParent(p)) if (p === root) return true;
+    return false;
+  }
+  function foldCalendars(snap, findings, keep) {
+    const calendars = findCalendars(snap).filter((c) => keep(c.root));
+    if (!calendars.length) return findings;
+    const folded = /* @__PURE__ */ new Map();
+    const rest = [];
+    for (const f of findings) {
+      const calendar = FOLDED.has(f.detector) ? calendars.find(
+        (c) => inside(c.root, elementOf(f.element)) && (!f.related || inside(c.root, elementOf(f.related)))
+      ) : void 0;
+      if (!calendar) {
+        rest.push(f);
+        continue;
+      }
+      folded.set(calendar, [...folded.get(calendar) ?? [], f]);
+    }
+    for (const [calendar, list] of folded) {
+      const severity = list.reduce(
+        (worst, f) => RANK[f.severity] < RANK[worst] ? f.severity : worst,
+        "info"
+      );
+      const dayWidth = Math.round(Math.min(...calendar.weekdays.map((w) => w.rect.width)) * 10) / 10;
+      const kinds = [...new Map(list.map((f) => [f.detector, f])).values()];
+      const checks = /* @__PURE__ */ new Map();
+      for (const f of list) {
+        const was = checks.get(f.detector);
+        if (!was || RANK[f.severity] < RANK[was]) checks.set(f.detector, f.severity);
+      }
+      rest.push({
+        detector: "calendar",
+        severity,
+        title: "Calendar's 7 days don't fit side by side",
+        element: describe(calendar.root),
+        evidence: {
+          dayWidthPx: dayWidth,
+          elementsInside: new Set(list.map((f) => f.element.selector)).size,
+          found: kinds.map((f) => `${f.title} at ${f.element.selector}`).join("; "),
+          checksInside: [...checks].map(([id, s]) => `${id}:${s}`).join(" "),
+          ...calendar.scrolls ? { scrollsSideways: true } : {}
+        },
+        styles: {},
+        suggestion: "A calendar needs its 7 days side by side, so narrower days or fewer columns won't fix it. Let it scroll sideways inside its own box, or show the days as a list (an agenda view) on small screens.",
+        lineage: lineage(calendar.root)
+      });
+    }
+    return rest;
+  }
+
   // ../analyzers/src/detectors/page-overflow.ts
   var TOLERANCE = 0.5;
   var SIDEWAYS_CONTENT = /* @__PURE__ */ new Set(["TABLE", "PRE", "CODE"]);
@@ -1117,6 +1280,13 @@
   function name(rec) {
     return `\`${describe(rec.el).selector}\``;
   }
+  function itemsFit(grid) {
+    const { left, right } = grid.rect;
+    return Array.from(grid.el.children).every((child) => {
+      const r = child.getBoundingClientRect();
+      return r.width === 0 || r.left >= left - 1 && r.right <= right + 1;
+    });
+  }
   function suggestionFor(g) {
     if (g.spill?.direction === "down") {
       return `The content of ${name(g.spill.box)} is taller than its box at this width and runs down over what comes next. Its height is fixed (height or max-height) and the content no longer fits once it wraps; use min-height instead, or let it grow with its content.`;
@@ -1130,7 +1300,10 @@
       return `They sit side by side in the flex row ${name(lca)}, which runs out of room at this width. Let the row wrap (flex-wrap: wrap), let the item that should give way shrink (min-width: 0), or stack them below this width with a media query.`;
     }
     if (lca && display.includes("grid")) {
-      return `They share the grid ${name(lca)}, whose columns are too narrow here for what is in them. Use minmax(0, 1fr) columns so items can shrink, or switch to fewer columns below this width.`;
+      if (!itemsFit(lca)) {
+        return `They share the grid ${name(lca)}, whose columns are too narrow here for what is in them. Use minmax(0, 1fr) columns so items can shrink, or switch to fewer columns below this width.`;
+      }
+      return `They share the grid ${name(lca)}, whose columns have already shrunk as far as they go and are too narrow here for what is in them. Switch to fewer columns below this width.`;
     }
     return "These two areas stop making room for each other at this width. Stack them earlier with a media query, or let the narrower one shrink (min-width: 0).";
   }
@@ -1735,10 +1908,10 @@
     for (const rec of snap.records) {
       const s = rec.style;
       if (!s.containerType || s.containerType === "normal") continue;
-      const names = s.containerName.split(/\s+/);
+      const names2 = s.containerName.split(/\s+/);
       const size = rec.rect.width - (Number.parseFloat(s.paddingLeft) || 0) - (Number.parseFloat(s.paddingRight) || 0) - (Number.parseFloat(s.borderLeftWidth) || 0) - (Number.parseFloat(s.borderRightWidth) || 0);
       for (const q of queries) {
-        if (q.name && !names.includes(q.name)) continue;
+        if (q.name && !names2.includes(q.name)) continue;
         const unit = q.unit === "px" ? 1 : q.unit === "em" ? Number.parseFloat(s.fontSize) || 16 : rootFont;
         const threshold = q.value * unit;
         bits += (q.after ? size > threshold : size >= threshold) ? "1" : "0";
@@ -1854,12 +2027,12 @@
     }
   }
   function looksLikeMenu(el) {
-    const names = [
+    const names2 = [
       typeof el.className === "string" ? el.className : "",
       el.id,
       el.getAttribute("data-testid") ?? ""
     ].join(" ");
-    return MENU_CLASS.test(names) || MENU_LABEL.test(nameOf(el));
+    return MENU_CLASS.test(names2) || MENU_LABEL.test(nameOf(el));
   }
   function kindOf(el) {
     if (el.matches("details > summary")) {
@@ -2061,6 +2234,7 @@
     "unexpected-wrap",
     "clipped-text",
     "squished-text",
+    "calendar",
     "distorted-media",
     "small-tap-target",
     "tiny-text",
@@ -2196,7 +2370,7 @@
     const enabled = new Set(options.detectors ?? DETECTOR_IDS);
     const rules = options.ignore ?? [];
     const snap = snapshot();
-    const findings = [];
+    let findings = [];
     for (const [id, run] of Object.entries(DETECTORS)) {
       if (!enabled.has(id)) continue;
       for (const f of run(snap)) {
@@ -2204,6 +2378,13 @@
         findings.push(f);
       }
     }
+    if (enabled.has("calendar")) {
+      findings = foldCalendars(
+        snap,
+        findings,
+        (root) => !isIgnored(describe(root), "calendar", rules)
+      );
+    }
     const wraps = enabled.has("unexpected-wrap") ? wrapStats(snap).filter((w) => !isIgnored(w.element, "unexpected-wrap", rules)) : [];
     const containers = containerSignature(snap);
     return {

package/dist/schema.json

@@ -223,6 +223,25 @@
             }
           ]
         },
+        "calendar": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "string",
+              "const": "error"
+            },
+            {
+              "type": "string",
+              "const": "warning"
+            },
+            {
+              "type": "string",
+              "const": "info"
+            }
+          ]
+        },
         "distorted-media": {
           "anyOf": [
             {
@@ -386,6 +405,7 @@
                     "unexpected-wrap",
                     "clipped-text",
                     "squished-text",
+                    "calendar",
                     "distorted-media",
                     "small-tap-target",
                     "tiny-text",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seybel/breakhound",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "Find where your layout breaks across every viewport width, then hand the fix to your coding agent.",
   "keywords": [
     "responsive",