better-design 0.31.1 → 0.34.0

package/dist/index.js

@@ -1232,6 +1232,7 @@ var init_tool_names = __esm({
       "get-design-config",
       "get-design-system-kit",
       "get-design-system-status",
+      "get-inspiration",
       "get-jig-guide",
       "get-motion-guide",
       "get-react-native-guide",
@@ -1251,6 +1252,7 @@ var init_tool_names = __esm({
       "review-dashboard-structure",
       "review-illustration",
       "review-ui-code",
+      "send-feedback",
       "set-design-config",
       "update-feature-map"
     ];
@@ -1269,6 +1271,7 @@ var init_tool_names = __esm({
       "get-design-config",
       "get-design-system-kit",
       "get-design-system-status",
+      "get-inspiration",
       "get-jig-guide",
       "get-motion-guide",
       "get-react-native-guide",
@@ -1288,6 +1291,7 @@ var init_tool_names = __esm({
       "review-dashboard-structure",
       "review-illustration",
       "review-ui-code",
+      "send-feedback",
       "set-design-config",
       "update-feature-map"
     ]);
@@ -1374,6 +1378,7 @@ Better Design provides design systems, design principles and UI review checks fo
 
 - find-design-system searches the catalog. preview-design-system shows one system. get-design-system-kit returns its install command or CSS kit.
 - create-design-system generates a custom system. get-design-system-status reports its progress.
+- get-inspiration returns real App Store screenshot sets from shipped apps as images.
 - get-ui-principle, get-ux-principle and the platform guides return design principles and best practices on a topic.
 - get-review-rules, check-comprehension, inspect-spacing and review-dashboard-structure check finished interfaces.
 - find-icon-library, find-icons and install-icons return icon component files.`;
@@ -1386,9 +1391,9 @@ Better Design provides design systems, design principles and UI review checks fo
       "get-shopify-guide": "Returns Better Design's best practices for Shopify Liquid and Online Store 2.0 themes: theme architecture, Liquid objects and filters, section schema, localization, accessibility, performance and Theme Check validation, with links to Shopify's documentation. Pass `topic`, `query`, or nothing for the index of topics.",
       "get-motion-guide": "Returns best practices and components for building a product demo or promo video in code with Remotion: the brief, brand and motion tokens, format profiles, captions, pacing, rendering and review. `scaffold: true` returns a complete Remotion starter project. `component` returns one video component's source and install command, and no arguments lists the components. The components come from snapcn (MIT) through the Better Design registry.",
       "get-swiftui-guide": "Returns best practices and Swift examples for SwiftUI interfaces: layout and view composition, animation and gestures, Metal shader effects and the platform APIs they use. Pass `topic`, `query`, or nothing for the index of topics.",
-      "get-review-rules": "Returns Better Design's review rules for UI code, each with a severity: accessibility (WCAG 2.1), visual design, animation, content, comprehension and AI features. Pass `category` for one group. Use it when the user wants UI code reviewed. `maxTokens` limits the length of the response.",
+      "get-review-rules": "Returns Better Design's review rules for UI code, each with a severity: accessibility (WCAG 2.1), visual design, animation, content, comprehension and AI features. Pass `category` for one group. Use it when the user wants UI code reviewed. `maxTokens` limits the length of the response. The rules are read against source, so a clean self-review is not visual approval.",
       "get-widget-guide": "Returns a build brief for an interactive widget on an article or landing page, such as a calculator, estimator, converter, quiz or checklist. Pass what is known about the widget. The response lists any details still missing, and once the details are complete it returns the brief with rules for calculation accuracy, form behavior, search visibility, performance and privacy.",
-      "check-comprehension": "Checks interface copy for clarity with three tests: whether a person outside the team understands it, whether the screen can be explained in 15 seconds, and whether a screenshot alone says what the screen does. Pass the headline, body and action labels, or the markup. Returns each finding with a severity and a suggested fix. `knownTerms` lists words the audience already knows. Better Design runs the checks itself and calls no other API.",
+      "check-comprehension": 'Checks interface copy for clarity with three tests: whether a person outside the team understands it, whether the screen can be explained in 15 seconds, and whether a screenshot alone says what the screen does. Pass the headline, body and action labels, or the markup. Returns each finding with a severity and a suggested fix. `knownTerms` lists words the audience already knows. `surface: "slide"` adds a density test for slides. It reads text only, not screenshots or visual hierarchy, so a pass is not visual approval. Better Design runs the checks itself and calls no other API.',
       "review-dashboard-structure": "Reviews the source of a dashboard or overview page against a fixed rubric: complete source, unchanged data, supported claims, hierarchy, scan order and use of the installed Sidebar, StatCard and Table components. Pass the page source, the data fixture, its interpretation and the component sources. Returns PASS, or FAIL with every finding as a tool error.",
       "finalize-dashboard-review": "Captures a deployed dashboard at a public HTTPS URL in Better Design's own browser at 390, 1440 and 1728 pixels wide, compares it with the submitted source, data and components, and returns a receipt tied to that deployment. The receipt reports hierarchy, component, copy and spacing faults and any hidden data fields.",
       "find-icon-library": `Searches icon libraries by style, mood or use case, such as "minimal clean professional", and returns the closest matches with a note on each library's style.`,
@@ -1396,7 +1401,8 @@ Better Design provides design systems, design principles and UI review checks fo
       "install-icons": "Fetches the named icons from the public Iconify API and returns one React component file per icon, plus an index.ts barrel, as text for the caller to save. It writes no files. Takes a `libraryId` and icon names from find-icons.",
       "detect-icon-library": "Reads the contents of the `.library.json` file that an earlier icon install left in a project and returns the icon library the project uses and the icons it has installed, or reports that none is recorded.",
       "find-design-system": "Searches Better Design's catalog of design systems by industry, personality or a description of the interface, and returns ranked matches with a preview link for each. Use it when the user wants a design system or a visual direction for an app, site, page, dashboard or presentation.",
-      "get-design-system-kit": "Returns the build kit for a catalog design system or a generated project. `target` picks the format: `react` returns one shadcn install command for every component and the tokens, `html` returns framework-free token and component CSS for inline canvases, `react-native` and `swiftui` return mobile kits, `shopify` returns Liquid theme files, and `dtcg` returns a W3C Design Tokens document. `component` narrows the React install to one component.",
+      "get-design-system-kit": "Returns the build kit for a catalog design system or a generated project. `target` picks the format: `react` returns one shadcn install command for every component and the tokens, `html` returns framework-free token and component CSS for inline canvases, `react-native` and `swiftui` return mobile kits, `shopify` returns Liquid theme files, `dtcg` returns a W3C Design Tokens document, and `store-screenshots` returns slide files and a render script for App Store and Google Play screenshots. `component` narrows the React install to one component.",
+      "get-inspiration": 'Returns real reference designs from Better Design\'s library as images. `type` picks the collection: today `app-store-screenshots`, the App Store screenshot sets of shipped apps, each with its title and category. `category`, such as "Productivity", narrows the sets, and `limit` sets how many come back, 1 to 6.',
       "create-design-system": "Starts generating a custom design system from a description of the product and its look, and returns the project id and project URL at once. Generation runs in the background and typically takes 1 to 3 minutes. get-design-system-status reports progress and returns the install command when it finishes. `baseDesignSystemId` starts from a catalog system, and `brandCss` builds from an existing brand token sheet, such as the output of extract-design-system. Each call uses one credit from the user's Better Design account. Anyone with the registry or preview URL can view the generated source and previews.",
       "get-design-system-status": "Reports the progress of a design system started with create-design-system. While generation runs it returns the current stage. When generation finishes it returns the live preview URL and the `npx shadcn add` install command.",
       "preview-design-system": "Returns a visual preview of a catalog design system: its palette, typography, buttons, card, input and badge, with a link to the full live showcase. Takes an id from find-design-system.",
@@ -1406,12 +1412,13 @@ Better Design provides design systems, design principles and UI review checks fo
       "extract-design-system": "Reads design tokens from CSS the caller passes in and returns the semantic palette, radius, fonts and shadow scale, with a token sheet that converts every color to `oklch()`. It accepts hex, rgb, hsl, named and oklch colors across `:root`, `.dark` and `@theme` blocks. `sources` merges several inputs, including a sample of computed styles from a live page. The server cannot read files, so the caller passes the text.",
       "extract-from-url": "Fetches a public web page, reads its stylesheets and renders it in a headless browser to sample the colors, fonts and radii of its body, headings, links, buttons, inputs and cards, then returns the brand as an oklch token sheet. It reads the page the way a browser does and calls no other API. A call takes about 10 to 45 seconds.",
       "review-illustration": "Renders an SVG illustration in a browser and returns its visible faults against Better Design's illustration principles, such as open shapes, floating parts, inconsistent light and contents outside their container. Pass the SVG and what it is meant to show. Pass the returned `reviewToken` back to review the same drawing again. SVG that carries scripts, event handlers or remote references is refused.",
-      "inspect-spacing": "Measures spacing in a rendered interface from DOM geometry and returns the spacing faults with a correction for each. The first call returns a read-only capture script to run in the page. The second call takes the captured states, such as viewport widths or hover and focus states, and returns the measurements and findings.",
+      "inspect-spacing": "Measures spacing in a rendered interface from DOM geometry and returns the spacing faults with a correction for each. The first call returns a read-only capture script to run in the page. The second call takes the captured states, such as viewport widths or hover and focus states, and returns the measurements and findings. It measures geometry only, so a clean result is not visual approval.",
       "build-feature-map": "Drafts a map of a product's features and flows from its repository file list and returns it as JSON for .better-design/feature-map.json. Routes become screens, nested routes become flows, and components, API routes and hooks join the step they share a name with. Pass every path from `git ls-files` as `files`.",
       "read-feature-map": "Returns the flows in a feature map that match a flow name, a feature or a file path, with the screen, route, components and data files of every step. Pass the contents of .better-design/feature-map.json as `map`. With no filter it lists every flow.",
       "update-feature-map": "Applies one change to a feature map, such as adding, renaming or removing a feature, or setting, renaming or removing a flow, and returns the updated map.",
       "get-team-rules": "Returns the Markdown rules the user's Better Design team wrote for how their product is built and reviewed, or a note that the team has none yet.",
       "review-ui-code": "Reviews React component source and CSS and returns findings with line numbers and fixes: native elements that bypass the installed design system, undefined font variables, hardcoded colors and raw palette classes, generated-UI patterns, and WCAG faults such as missing alt text or accessible names. The same input always returns the same findings.",
+      "send-feedback": "Sends Better Design a report of a bug, a missing feature or wrong output in its tools or API: the kind of problem, the tool or endpoint, a one-sentence summary, and optionally what was tried, expected and returned. A person reads every report. It is available only on connections that use a Better Design API key.",
       "create-figma-prototype": "Reads a frame from the Figma file that has the Better Design plugin open and returns it as one HTML page built from the design system's components, with a report of every layer that could not be mapped. Name a frame, or omit the name to use the current selection."
     };
   }
@@ -1891,6 +1898,7 @@ function buildKitOutputSchema(enableShopifyKit = true) {
     componentExampleHtml: z5.string().min(1).optional().describe("HTML target only. Starter markup that demonstrates the required .ds wrapper and ds-* component classes."),
     tokensJson: z5.string().min(1).optional().describe("DTCG target only. The design tokens as a W3C Design Tokens (DTCG) document. Write it to tokens.json; every token tool reads this format, including Style Dictionary, Tokens Studio, Terrazzo, and the Figma plugins that create variables."),
     nativeFiles: z5.array(z5.object({ path: z5.string().min(1), content: z5.string().min(1) })).optional().describe("React Native and SwiftUI targets only. Write each file verbatim at its path: this system's stored theme and material, and the primitives that read it."),
+    screenshotFiles: z5.array(z5.object({ path: z5.string().min(1), content: z5.string().min(1) })).optional().describe("Store screenshots target only. Write each file verbatim at its path, then follow buildInstructions to capture screens, write the slides and render the PNG files."),
     unsupportedTokens: z5.array(z5.object({
       name: z5.string().min(1),
       value: z5.string().min(1),
@@ -4270,12 +4278,15 @@ var init_review_rules_description = __esm({
       "content",
       "comprehension",
       "ai-features",
+      "coverage-gaps",
       "all"
     ];
     REVIEW_RULES_DESCRIPTION = `Retrieves accessibility (WCAG 2.1), visual design, animation, content, comprehension, and AI feature review rules for analyzing code.
 
 You MUST call this after writing UI code to self-review your output, then fix every critical and serious issue BEFORE presenting the result.
 
+It returns rules to check against. It approves nothing: a clean self-review against these rules is not visual approval, because the rules are read against source, not against what renders.
+
 ${REDESIGN_SCOPE_CONTRACT}
 
 ${DESIGN_TRADEOFF_RULE}
@@ -4318,6 +4329,8 @@ ${DESIGN_TRADEOFF_RULE}
 - Critical: Output saved or sent without the user accepting it, silent failures, no manual path when AI is unavailable, user data read before consent, invented citations or unearned certainty
 - Serious: AI output with no visible marker, long runs with no sign or a Stop that deletes partial output, refusals that name no topic and offer no alternative, feedback controls with no destination
 
+Every rule carries an ID (\`rule/\u2026\`), a source and an exceptions line. Cite the ID in each finding. The \`coverage-gaps\` category lists the surfaces that have no rule yet.
+
 Use maxTokens to limit rule content (recommended: 5000\u201310000). Required workflow guidance is always returned in full.`;
   }
 });
@@ -5156,6 +5169,22 @@ These rules were read against source. They cannot see layout. Three checks remai
 2. Call \`inspect-spacing\` on the rendered DOM at 1440, 1728 and 390 wide. The first call returns a capture script and measures nothing; the layout is measured only when a second call, with the captured states, returns status \`completed\`. Rules read code; only measurement catches a label sitting 9px off its own circle, an active state that is 2px wider than its siblings and shifts the row, or a sidebar that leaves page background beside it on a wide screen.
 3. For dashboards, deploy the exact source to a public HTTPS preview, then call \`finalize-dashboard-review\` with that URL, the exact complete and visible source, unchanged fixture, and installed component source. Better Design's own browser captures the preview at 390, 1440, and 1728, content-addresses the live deployment, derives the factual interpretation, and issues the only valid review receipt. No trusted browser capture means incomplete. An invalid deployment revision, invalid geometry, or hidden fixture field also blocks approval. Any later source or deployment edit voids the receipt. Then confirm every nav item, link, tab and button works.
 
+## Presentations
+
+A deck passes only on rendered evidence. For every slide:
+
+1. Call \`check-comprehension\` with \`surface: "slide"\`. Keep one idea per slide and fix every density finding.
+2. Render the deck and review a screenshot of every slide: the title reads first, one element holds the eye, and nothing competes with it. Text checks and \`inspect-spacing\` cannot see this, so no score stands in for the screenshot.
+
+## Check the rules below in two passes
+
+An agent that reviews its own screen in one pass tends to approve it. Split the review:
+
+1. Per rule: give each rule section below (each \`# \` heading) to its own subagent, in a clean context that holds only that section and the source. A host without subagents checks one section at a time and writes down its findings before it reads the next.
+2. Skeptic pass: give every flag to one fresh subagent that tries to disprove it. It keeps a flag only when it can cite the file and line that break the rule.
+
+Cite the rule ID with every finding: the \`rule/\u2026\` line under each rule heading. Read its Exceptions line before you flag. A surface listed under coverage gaps has no rule yet, so say that instead of inventing one.
+
 Fix every critical and serious finding before you present.`;
   }
 });
@@ -5179,6 +5208,8 @@ function looksLikeCard(candidate) {
 }
 function redactSecrets(value) {
   let out = value.replace(/\u0000/g, "");
+  for (const pattern of CREDENTIAL_VALUE_PATTERNS) out = out.replace(pattern, "[redacted]");
+  out = out.replace(JWT_PATTERN, "$1[redacted]");
   for (const pattern of SECRET_PATTERNS) out = out.replace(pattern, "[redacted]");
   out = out.replace(EMAIL_PATTERN, "[redacted-email]");
   out = out.replace(
@@ -5197,7 +5228,7 @@ function redactUrl(raw) {
     return "[redacted]";
   }
 }
-var SECRET_PATTERNS, EMAIL_PATTERN, CARD_CANDIDATE_PATTERN, PHONE_PATTERNS;
+var SECRET_PATTERNS, CREDENTIAL_VALUE_PATTERNS, JWT_PATTERN, EMAIL_PATTERN, CARD_CANDIDATE_PATTERN, PHONE_PATTERNS;
 var init_redact = __esm({
   "../shared/src/redact.ts"() {
     "use strict";
@@ -5213,9 +5244,9 @@ var init_redact = __esm({
       /\bwhsec_[A-Za-z0-9]{16,}/g,
       /\bAIza[A-Za-z0-9_-]{30,}/g,
       /\bxox[abposr]-[A-Za-z0-9-]{10,}/g,
-      /\beyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]+/g,
-      // JWT
-      /\b(?:AKIA|ASIA)[A-Z0-9]{16}\b/g,
+      /\b(?:AKIA|ASIA)[A-Z0-9]{16}\b/g
+    ];
+    CREDENTIAL_VALUE_PATTERNS = [
       // key=value forms for the names that carry credentials. A quoted value is
       // taken whole, so a passphrase with spaces and a short password both go:
       // the old form needed eight characters and no spaces, which let
@@ -5223,8 +5254,13 @@ var init_redact = __esm({
       // through into a corpus held for 180 days. [BD-697]
       /(?:\b|_)(?:api[_-]?key|access[_-]?token|refresh[_-]?token|secret(?:[_-]?key)?|password|passwd|authorization)\b\s*[:=]\s*(?:"[^"]*"|'[^']*'|[A-Za-z0-9._~+/-]+)/gi,
       // Authorization headers separate the scheme from the token with a space.
-      /\b(?:bearer|basic|token)\s+[A-Za-z0-9._~+/-]{12,}=*/gi
+      /\b(?:bearer|basic|token)\s+[A-Za-z0-9._~+/-]{12,}=*/gi,
+      // A token in a query string, such as the claim link an agent gets when its
+      // free budget runs out. That link hands the agent's keys to whoever opens
+      // it. [BD-956]
+      /[?&]token=[A-Za-z0-9_-]{16,}/gi
     ];
+    JWT_PATTERN = /(?<![A-Za-z0-9_-])(?=[A-Za-z0-9_-]*\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-])([A-Za-z0-9_-]*?)(?<![A-Za-z0-9_])eyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]+/g;
     EMAIL_PATTERN = /(?<![A-Za-z0-9._%+-])[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b/g;
     CARD_CANDIDATE_PATTERN = /\b(?:\d[ -]?){12,18}\d\b/g;
     PHONE_PATTERNS = [
@@ -5358,7 +5394,7 @@ var init_extract = __esm({
 });
 
 // ../shared/src/mcp/comprehension/lexicon.ts
-var TECHNICAL_TERMS, PRODUCT_TERMS, KNOWN_ACRONYMS, VAGUE_ACTIONS, MAX_SENTENCE_WORDS, MAX_SCREEN_WORDS, MAX_ACTIONS, EXPLAIN_BUDGET_SECONDS;
+var TECHNICAL_TERMS, PRODUCT_TERMS, KNOWN_ACRONYMS, VAGUE_ACTIONS, MAX_SENTENCE_WORDS, MAX_SCREEN_WORDS, MAX_ACTIONS, EXPLAIN_BUDGET_SECONDS, MAX_SLIDE_WORDS, MAX_SLIDE_LINES, SLIDE_NAME;
 var init_lexicon = __esm({
   "../shared/src/mcp/comprehension/lexicon.ts"() {
     "use strict";
@@ -5467,6 +5503,9 @@ var init_lexicon = __esm({
     MAX_SCREEN_WORDS = 60;
     MAX_ACTIONS = 3;
     EXPLAIN_BUDGET_SECONDS = 15;
+    MAX_SLIDE_WORDS = 40;
+    MAX_SLIDE_LINES = 5;
+    SLIDE_NAME = /\b(slides?|deck|presentation)\b/i;
   }
 });
 
@@ -5541,7 +5580,7 @@ function estimateExplainSeconds(words2, insiderTermCount, actionCount) {
   const choosing = Math.max(0, actionCount - 1) * 3;
   return Math.round(speaking + defining + choosing);
 }
-function fifteenSecondFindings(words2, actions, seconds) {
+function fifteenSecondFindings(words2, actions, seconds, surface) {
   const findings = [];
   if (seconds > EXPLAIN_BUDGET_SECONDS) {
     findings.push({
@@ -5552,7 +5591,7 @@ function fifteenSecondFindings(words2, actions, seconds) {
       fix: "Cut to one idea and one next step. Move the rest behind a link or a later screen."
     });
   }
-  if (words2 > MAX_SCREEN_WORDS) {
+  if (surface === "screen" && words2 > MAX_SCREEN_WORDS) {
     findings.push({
       test: "fifteen-second",
       severity: "serious",
@@ -5613,7 +5652,30 @@ function screenshotFindings(copy, words2) {
   }
   return findings;
 }
+function slideFindings(words2, body) {
+  const findings = [];
+  if (words2 > MAX_SLIDE_WORDS) {
+    findings.push({
+      test: "slide",
+      severity: "serious",
+      problem: `The slide shows ${words2} words, so the audience reads instead of listening.`,
+      evidence: `${words2} words of visible copy`,
+      fix: `Keep a slide under about ${MAX_SLIDE_WORDS} words: a title that states the point and a few short lines.`
+    });
+  }
+  if (body.length > MAX_SLIDE_LINES) {
+    findings.push({
+      test: "slide",
+      severity: "serious",
+      problem: `The slide stacks ${body.length} lines of copy, which usually means more than one idea.`,
+      evidence: body.join(" | "),
+      fix: "Give each idea its own slide, with the point in the title."
+    });
+  }
+  return findings;
+}
 function analyzeComprehension(input) {
+  const surface = input.surface ?? (SLIDE_NAME.test(input.screen) ? "slide" : "screen");
   const copy = resolveCopy(input);
   const known = new Set((input.knownTerms ?? []).map((term) => term.trim().toLowerCase()));
   const visible = [copy.headline ?? "", ...copy.body, ...copy.actions].join(". ");
@@ -5622,13 +5684,16 @@ function analyzeComprehension(input) {
   const estimatedExplainSeconds = estimateExplainSeconds(words2, insiderTerms.length, copy.actions.length);
   const findings = [
     ...momTestFindings(visible, known, insiderTerms),
-    ...fifteenSecondFindings(words2, copy.actions, estimatedExplainSeconds),
-    ...screenshotFindings(copy, words2)
+    ...fifteenSecondFindings(words2, copy.actions, estimatedExplainSeconds, surface),
+    ...screenshotFindings(copy, words2),
+    ...surface === "slide" ? slideFindings(words2, copy.body) : []
   ];
+  const blocking = findings.some((finding3) => finding3.severity !== "minor");
   const longestSentence = sentences(visible).sort((a, b) => countWords(b) - countWords(a))[0] ?? "";
   return {
     screen: input.screen,
-    verdict: findings.some((finding3) => finding3.severity !== "minor") ? "revise" : "pass",
+    surface,
+    verdict: blocking ? "revise" : surface === "slide" ? "needs-screenshot" : "pass",
     findings,
     copy: { headline: copy.headline, body: copy.body, actions: copy.actions },
     stats: {
@@ -5672,7 +5737,8 @@ function formatStats(report) {
     "",
     `- Visible copy: ${words2} words across ${actionCount} action${actionCount === 1 ? "" : "s"}.`,
     `- Insider words found: ${insiderTerms.length > 0 ? insiderTerms.join(", ") : "none"}.`,
-    `- Rough explain time: about ${estimatedExplainSeconds} seconds. This is a heuristic budget from word count, insider words and choices, not a measurement of real users.`
+    `- Rough explain time: about ${estimatedExplainSeconds} seconds. This is a heuristic budget from word count, insider words and choices, not a measurement of real users.`,
+    "- It read text only: the copy passed in, or the text in the markup. It cannot see screenshots, text inside images, or visual hierarchy."
   ].join("\n");
 }
 function formatComprehensionReport(report) {
@@ -5680,8 +5746,11 @@ function formatComprehensionReport(report) {
     (totals, finding3) => ({ ...totals, [finding3.severity]: totals[finding3.severity] + 1 }),
     { critical: 0, serious: 0, minor: 0 }
   );
-  const verdict = report.verdict === "pass" ? "Pass. Nothing blocking. Read the copy once more out loud before you present it." : `Revise before presenting. ${counts.critical} critical, ${counts.serious} serious, ${counts.minor} minor.`;
-  const next = report.verdict === "pass" ? "Say in one sentence what a first-time user can do on this screen. If that sentence needs a second sentence to make sense, simplify the screen." : "Rewrite the copy so it survives all three tests, then call check-comprehension again on the new copy. Do not present the screen while a critical or serious finding stands.";
+  const { line: verdict, next } = report.verdict === "revise" ? {
+    line: `Revise before presenting. ${counts.critical} critical, ${counts.serious} serious, ${counts.minor} minor.`,
+    next: "Rewrite the copy so it survives every test, then call check-comprehension again on the new copy. Do not present the screen while a critical or serious finding stands."
+  } : VERDICTS[report.verdict];
+  const slideSection = report.surface === "slide" ? ["", formatTestSection(report, "slide")] : [];
   return [
     `# Comprehension check: ${report.screen}`,
     "",
@@ -5692,6 +5761,7 @@ function formatComprehensionReport(report) {
     formatTestSection(report, "fifteen-second"),
     "",
     formatTestSection(report, "screenshot"),
+    ...slideSection,
     "",
     formatStats(report),
     "",
@@ -5700,16 +5770,27 @@ function formatComprehensionReport(report) {
     next
   ].join("\n");
 }
-var TEST_TITLES, SEVERITY_ORDER;
+var TEST_TITLES, SEVERITY_ORDER, VERDICTS;
 var init_format = __esm({
   "../shared/src/mcp/comprehension/format.ts"() {
     "use strict";
     TEST_TITLES = {
       mom: "Mom test: would someone outside the team understand this?",
       "fifteen-second": "15 second test: can you explain the screen in 15 seconds?",
-      screenshot: "Screenshot test: with zero context, is it clear what this does?"
+      screenshot: "Screenshot test: with zero context, is it clear what this does?",
+      slide: "Slide test: one idea, and few enough words to hear the speaker?"
     };
     SEVERITY_ORDER = { critical: 0, serious: 1, minor: 2 };
+    VERDICTS = {
+      pass: {
+        line: "Pass. Nothing blocking. Read the copy once more out loud before you present it.",
+        next: "Say in one sentence what a first-time user can do on this screen. If that sentence needs a second sentence to make sense, simplify the screen."
+      },
+      "needs-screenshot": {
+        line: "The text passes. This is not approval: a slide passes only after you review its rendered screenshot.",
+        next: "Render the slide at its real size and look at the screenshot. Confirm it carries one idea, the title reads first, and one element holds the eye. Split or restyle the slide if any of the three fails."
+      }
+    };
   }
 });
 
@@ -5734,6 +5815,8 @@ function registerComprehensionTools({ server, provider, track, userId }) {
 
 Review rules catch what is broken. This catches what is unclear: copy that makes sense to the people who built the product and to nobody else.
 
+It reads text only: the copy you pass, or the text it extracts from your markup. It does not see what renders: not screenshots, text inside images, or visual hierarchy. A pass is a text result, not visual approval.
+
 Three tests, run on the screen's own words:
 1. Mom test. Would a person outside the team understand this? Flags insider vocabulary, unexplained acronyms and sentences too long to follow.
 2. 15 second test. If the screen takes longer than 15 seconds to explain, it is too complex. Flags word count, stacked concepts and competing actions.
@@ -5743,6 +5826,8 @@ Pass either the copy or the markup:
 - check-comprehension({ screen: "Lesson end card", headline: "Lesson complete", body: ["Claim the June badge by collecting more quest points from your daily, friend and weekend quests."], actions: ["Continue"] })
 - check-comprehension({ screen: "Billing page", code: "<section>\u2026the JSX you wrote\u2026</section>" })
 
+For a slide, pass surface: "slide" (a screen named slide, deck or presentation gets it by default) and call once per slide. A slide adds a density test, and it never passes on text: approve it only after you review its rendered screenshot.
+
 Use knownTerms for words your audience genuinely knows, so the check stops flagging them. Fix every critical and serious finding, then call this again on the rewritten copy.`,
       inputSchema: z9.object({
         screen: z9.string().trim().min(1).max(120).describe("What this screen is, e.g. 'lesson end card', 'billing page'."),
@@ -5751,6 +5836,7 @@ Use knownTerms for words your audience genuinely knows, so the check stops flagg
         actions: z9.array(z9.string().trim().min(1).max(120)).max(20).optional().describe("Visible button and link labels, e.g. ['Claim badge', 'Not now']."),
         code: z9.string().max(6e4).optional().describe("JSX, TSX or HTML for the screen. Copy is extracted from it when headline/body/actions are omitted."),
         knownTerms: z9.array(z9.string().trim().min(1).max(60)).max(50).optional().describe("Words this audience already knows, so they are not flagged as insider language."),
+        surface: z9.enum(["screen", "slide"]).optional().describe('"slide" adds the slide density test and withholds a pass until a screenshot review. Defaults to "slide" when the screen name says slide, deck or presentation.'),
         context: CONTEXT_ARG
       }),
       annotations: READ_ONLY_TOOL_ANNOTATIONS
@@ -10867,6 +10953,184 @@ ${FAQ_CARD_ITEM}
   }
 });
 
+// ../shared/src/mcp/store-screenshots.ts
+function renderScript() {
+  const sizes = JSON.stringify(STORE_SCREENSHOT_SIZES);
+  const feature = JSON.stringify(PLAY_FEATURE_GRAPHIC);
+  return `// Renders store screenshots from slides.json at the exact store sizes. [Better Design]
+// Run once per change: node store-screenshots/render.mjs
+import { chromium } from "playwright";
+import { mkdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const SIZES = ${sizes};
+const FEATURE = ${feature};
+const RANGE = ${JSON.stringify(STORE_SLIDE_RANGE)};
+const deck = JSON.parse(readFileSync(join(here, "slides.json"), "utf8"));
+
+if (deck.slides.length < RANGE.min || deck.slides.length > RANGE.max) {
+  throw new Error(\`slides.json holds \${deck.slides.length} slides. Use \${RANGE.min} to \${RANGE.max}: Google Play shows at most \${RANGE.max}.\`);
+}
+
+// App Store Connect rejects a PNG with an alpha channel, so check the header, not the look.
+function check(file, size) {
+  const png = readFileSync(file);
+  const width = png.readUInt32BE(16), height = png.readUInt32BE(20), colorType = png[25];
+  if (width !== size.width || height !== size.height) throw new Error(\`\${file} is \${width} x \${height}, not \${size.width} x \${size.height}.\`);
+  if (colorType !== 2) throw new Error(\`\${file} has a transparency layer. Give every slide an opaque background.\`);
+}
+
+async function shoot(browser, size, data, file) {
+  const page = await browser.newPage({ viewport: { width: size.width, height: size.height }, deviceScaleFactor: 1 });
+  await page.addInitScript((slide) => { window.__SLIDE__ = slide; }, data);
+  await page.goto(pathToFileURL(join(here, "slide.html")).href);
+  await page.evaluate(async () => {
+    await document.fonts.ready;
+    await Promise.all([...document.images].map((img) => img.decode().catch(() => { throw new Error("Missing capture: " + img.src); })));
+  });
+  await page.screenshot({ path: file, type: "png" });
+  await page.close();
+  check(file, size);
+}
+
+const browser = await chromium.launch();
+try {
+  for (const size of SIZES) {
+    mkdirSync(join(here, "out", size.id), { recursive: true });
+    for (const [i, slide] of deck.slides.entries()) {
+      const file = join(here, "out", size.id, String(i + 1).padStart(2, "0") + ".png");
+      await shoot(browser, size, { kind: "slide", app: deck.app, slide, frame: size.frame }, file);
+      console.log("wrote", file);
+    }
+  }
+  mkdirSync(join(here, "out", FEATURE.id), { recursive: true });
+  const feature = join(here, "out", FEATURE.id, "feature-graphic.png");
+  await shoot(browser, FEATURE, { kind: "feature", app: deck.app, slide: deck.featureGraphic, frame: "none" }, feature);
+  console.log("wrote", feature);
+} finally {
+  await browser.close();
+}
+`;
+}
+function buildStoreScreenshotFiles(tokensCss) {
+  return [
+    { path: "store-screenshots/theme.css", content: tokensCss },
+    { path: "store-screenshots/slides.json", content: `${JSON.stringify(EXAMPLE_SLIDES, null, 2)}
+` },
+    { path: "store-screenshots/slide.html", content: SLIDE_HTML },
+    { path: "store-screenshots/render.mjs", content: renderScript() }
+  ];
+}
+function fencedFile(file) {
+  const longest = Math.max(0, ...[...file.content.matchAll(/`+/g)].map((run) => run[0].length));
+  const fence3 = "`".repeat(Math.max(3, longest + 1));
+  return `## ${file.path}
+
+${fence3}
+${file.content.replace(/\n$/, "")}
+${fence3}`;
+}
+function storeScreenshotText(name, files) {
+  return [storeScreenshotInstructions(name), ...files.map(fencedFile)].join("\n\n");
+}
+function storeScreenshotInstructions(name) {
+  const sizes = [...STORE_SCREENSHOT_SIZES, PLAY_FEATURE_GRAPHIC].map((size) => `- ${size.label}: ${size.width} x ${size.height}, in \`store-screenshots/out/${size.id}/\``).join("\n");
+  return [
+    `# Store screenshots in ${name}`,
+    "",
+    "1. Write each file in `screenshotFiles` verbatim at its path.",
+    `2. Capture ${STORE_SLIDE_RANGE.min} to ${STORE_SLIDE_RANGE.max} app screens into \`store-screenshots/captures/\`. iOS Simulator: \`xcrun simctl io booted screenshot store-screenshots/captures/01.png\`. Android emulator: \`adb exec-out screencap -p > store-screenshots/captures/01.png\`.`,
+    '3. Edit `slides.json`: one outcome per slide, a headline a person understands in one second, and no claims such as "Best", "#1" or "Free", which Google Play rejects. Check every headline with Better Design\'s `check-comprehension` tool before you render.',
+    "4. Install Playwright once as a dev dependency with the project's package manager, then its browser: `npx playwright install chromium`.",
+    "5. Google Play asks the feature graphic to avoid pure white, black and dark gray. When this system's primary color is one of those, set `--feature-background` and `--feature-foreground` to a brand color pair at the end of `theme.css`.",
+    "6. Run `node store-screenshots/render.mjs`. It stops on any file with the wrong size or a transparency layer.",
+    "",
+    "It writes:",
+    sizes,
+    "",
+    "Google Play screenshots carry no drawn phone, because Google asks for no device imagery. Show the user every PNG before they upload it."
+  ].join("\n");
+}
+var STORE_SCREENSHOT_SIZES, PLAY_FEATURE_GRAPHIC, STORE_SLIDE_RANGE, EXAMPLE_SLIDES, SLIDE_HTML;
+var init_store_screenshots = __esm({
+  "../shared/src/mcp/store-screenshots.ts"() {
+    "use strict";
+    STORE_SCREENSHOT_SIZES = [
+      { id: "iphone-6-9", label: "iPhone 6.9 inch", width: 1320, height: 2868, frame: "phone" },
+      { id: "play-phone", label: "Google Play phone", width: 1080, height: 1920, frame: "none" }
+    ];
+    PLAY_FEATURE_GRAPHIC = {
+      id: "play-feature-graphic",
+      label: "Google Play feature graphic",
+      width: 1024,
+      height: 500,
+      frame: "none"
+    };
+    STORE_SLIDE_RANGE = { min: 3, max: 8 };
+    EXAMPLE_SLIDES = {
+      app: "Your app",
+      slides: [
+        { headline: "Say the first outcome in five words", subhead: "", capture: "captures/01.png" },
+        { headline: "Show the second outcome next", subhead: "", capture: "captures/02.png" },
+        { headline: "End on the reason to stay", subhead: "", capture: "captures/03.png" }
+      ],
+      featureGraphic: { headline: "Your app, in one line" }
+    };
+    SLIDE_HTML = `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<link rel="stylesheet" href="theme.css">
+<style>
+  html, body { margin: 0; width: 100vw; height: 100vh; overflow: hidden; }
+  body { background: var(--background); color: var(--foreground); font-family: var(--font-sans, system-ui, sans-serif);
+    display: flex; flex-direction: column; align-items: center; box-sizing: border-box; padding: 7vh 8vw 0; gap: 3vh; }
+  h1 { margin: 0; font-size: 7.5vw; line-height: 1.12; font-weight: 700; text-align: center; text-wrap: balance; letter-spacing: -0.02em; }
+  p { margin: 0; font-size: 4vw; line-height: 1.35; text-align: center; color: var(--muted-foreground); text-wrap: balance; }
+  .shot { flex: 1; min-height: 0; width: 100%; display: flex; justify-content: center; align-items: flex-start; }
+  .shot img { display: block; height: 100%; max-width: 100%; object-fit: cover; object-position: top; }
+  .phone { height: 104%; aspect-ratio: 9 / 19.5; box-sizing: border-box; padding: 1.6vw; border-radius: 11vw 11vw 0 0;
+    background: var(--foreground); overflow: hidden; }
+  .phone img { width: 100%; height: 100%; border-radius: 9.4vw 9.4vw 0 0; }
+  .bare img { border-radius: calc(var(--radius, 0.75rem) * 3) calc(var(--radius, 0.75rem) * 3) 0 0; }
+  body.feature { background: var(--feature-background, var(--primary)); color: var(--feature-foreground, var(--primary-foreground)); justify-content: center; align-items: flex-start; padding: 0 10vw; gap: 4vh; }
+  body.feature h1 { font-size: 7vw; text-align: left; }
+  body.feature .app { font-size: 3.4vw; font-weight: 600; opacity: 0.85; }
+</style>
+</head>
+<body>
+<script>
+  // The render script sets window.__SLIDE__ before this page loads.
+  const { kind, app, slide, frame } = window.__SLIDE__;
+  const add = (tag, className, text) => {
+    const el = document.createElement(tag);
+    if (className) el.className = className;
+    if (text) el.textContent = text;
+    return document.body.appendChild(el);
+  };
+  if (kind === "feature") {
+    document.body.classList.add("feature");
+    add("div", "app", app);
+    add("h1", "", slide.headline);
+  } else {
+    add("h1", "", slide.headline);
+    if (slide.subhead) add("p", "", slide.subhead);
+    const shot = add("div", "shot " + (frame === "phone" ? "" : "bare"));
+    const holder = frame === "phone" ? shot.appendChild(document.createElement("div")) : shot;
+    if (frame === "phone") holder.className = "phone";
+    const img = holder.appendChild(document.createElement("img"));
+    img.src = slide.capture;
+    img.alt = "";
+  }
+</script>
+</body>
+</html>
+`;
+  }
+});
+
 // ../shared/src/registry-css.ts
 function parseCssVars(css) {
   const out = { theme: {}, light: {}, dark: {} };
@@ -13892,36 +14156,38 @@ ${fence3}` }],
       )
     }, icons);
   });
+  const loadTokenSource = async ({ designSystemId, projectId }) => {
+    if (projectId) {
+      const result = await fetchProjectTokensCss(projectId, apiFetch, authContext);
+      return {
+        tokensCss: result?.tokensCss,
+        name: result?.name ?? `Project ${projectId.slice(0, 8)}`,
+        viewUrl: `${APP_BASE_URL}/projects/${projectId}`,
+        icons: result?.iconLibrary
+      };
+    }
+    if (!designSystemId) return null;
+    const ds = await provider.getDesignSystemById(designSystemId, { includeComponents: false, includeHtml: false });
+    return {
+      tokensCss: await fetchCatalogTokensCss(designSystemId),
+      name: ds?.metadata.title ?? designSystemId,
+      viewUrl: `${APP_BASE_URL}/design-systems/${designSystemId}`,
+      icons: ds ? await catalogKitIcons(ds.metadata, provider) : void 0
+    };
+  };
   const getDtcgKit = async ({
     designSystemId,
     projectId,
     context
   }) => tracked("get-design-system-kit", { target: "dtcg", designSystemId, projectId, context }, async () => {
-    let tokensCss;
-    let name;
-    let viewUrl;
-    let icons;
-    if (projectId) {
-      viewUrl = `${APP_BASE_URL}/projects/${projectId}`;
-      const result = await fetchProjectTokensCss(projectId, apiFetch, authContext);
-      tokensCss = result?.tokensCss;
-      icons = result?.iconLibrary;
-      name = result?.name ?? `Project ${projectId.slice(0, 8)}`;
-    } else if (designSystemId) {
-      viewUrl = `${APP_BASE_URL}/design-systems/${designSystemId}`;
-      const ds = await provider.getDesignSystemById(designSystemId, {
-        includeComponents: false,
-        includeHtml: false
-      });
-      tokensCss = await fetchCatalogTokensCss(designSystemId);
-      name = ds?.metadata.title ?? designSystemId;
-      icons = ds ? await catalogKitIcons(ds.metadata, provider) : void 0;
-    } else {
+    const source = await loadTokenSource({ designSystemId, projectId });
+    if (!source) {
       return {
         content: [{ type: "text", text: "For target dtcg, pass either a catalog designSystemId (from find-design-system) or a projectId (from create-design-system)." }],
         structuredContent: { status: "error", name: "Missing design system", tokensCss: "" }
       };
     }
+    const { tokensCss, name, viewUrl, icons } = source;
     if (!tokensCss) {
       return {
         content: [{ type: "text", text: `Could not load tokens for "${projectId ?? designSystemId}". A generated project may still be building. Check ${viewUrl}.` }],
@@ -13947,6 +14213,33 @@ ${fence3}` }],
       structuredContent: { status: "completed", name, viewUrl, tokensCss, tokensJson }
     }, icons);
   });
+  const getStoreScreenshots = async ({
+    designSystemId,
+    projectId,
+    context
+  }) => tracked("get-design-system-kit", { target: "store-screenshots", designSystemId, projectId, context }, async () => {
+    const source = await loadTokenSource({ designSystemId, projectId });
+    if (!source?.tokensCss) {
+      const reason = source ? `Could not load tokens for "${projectId ?? designSystemId}". A generated project may still be building. Check ${source.viewUrl}.` : "For target store-screenshots, pass either a catalog designSystemId (from find-design-system) or a projectId (from create-design-system).";
+      return {
+        content: [{ type: "text", text: reason }],
+        structuredContent: { status: "error", name: source?.name ?? "Missing design system", tokensCss: "" }
+      };
+    }
+    const files = buildStoreScreenshotFiles(source.tokensCss);
+    const instructions = storeScreenshotInstructions(source.name);
+    return {
+      content: [{ type: "text", text: storeScreenshotText(source.name, files) }],
+      structuredContent: {
+        status: "completed",
+        name: source.name,
+        viewUrl: source.viewUrl,
+        tokensCss: source.tokensCss,
+        buildInstructions: instructions,
+        screenshotFiles: files
+      }
+    };
+  });
   const fetchProjectMobilePrimitives = async (projectId) => {
     try {
       const res = await apiFetch(`${APP_BASE_URL}/api/projects/${projectId}/mobile/all.json`, { headers: authHeaders(authContext) });
@@ -14162,9 +14455,10 @@ ${BUILD_TARGET_RULE}`,
             "html",
             ...enableShopifyKit ? ["shopify"] : [],
             "dtcg",
+            "store-screenshots",
             ...enableMobileKits ? ["react-native", "swiftui"] : []
           ]
-        ).describe(`Required build target. Use "react" for any host with filesystem + terminal; use "html" only for inline chat canvases/artifacts.${enableShopifyKit ? ' Use "shopify" for Shopify stores and themes.' : ""} Use "dtcg" to hand the tokens to a design tool: it returns a W3C Design Tokens document for Style Dictionary, Tokens Studio, Terrazzo, or a Figma plugin that creates variables. ${enableMobileKits ? ` Use "react-native" for a React Native or Expo app and "swiftui" for an iOS app: each returns this system's stored mobile kit, its own material on native primitives, plus the handoff to the matching guide.` : ""}`),
+        ).describe(`Required build target. Use "react" for any host with filesystem + terminal; use "html" only for inline chat canvases/artifacts.${enableShopifyKit ? ' Use "shopify" for Shopify stores and themes.' : ""} Use "dtcg" to hand the tokens to a design tool: it returns a W3C Design Tokens document for Style Dictionary, Tokens Studio, Terrazzo, or a Figma plugin that creates variables. Use "store-screenshots" for App Store and Google Play screenshots in this system: it returns slide files and a render script that writes PNG files at the store sizes. ${enableMobileKits ? ` Use "react-native" for a React Native or Expo app and "swiftui" for an iOS app: each returns this system's stored mobile kit, its own material on native primitives, plus the handoff to the matching guide.` : ""}`),
         designSystemId: z14.string().min(1).optional().describe(`Catalog design system ID from find-design-system. Required for target react; for every other target pass this or projectId.`),
         projectId: z14.string().min(1).optional().describe(`Generated project ID from create-design-system / get-design-system-status. Supported with every target but react.`),
         component: z14.union([z14.string(), z14.array(z14.string())]).optional().describe("React target only. Pass only when the user asks to inspect specific component source code. Omit to scaffold the entire design system."),
@@ -14180,7 +14474,7 @@ ${BUILD_TARGET_RULE}`,
       // interactive preview path. [BD-240]
     },
     async ({ target, designSystemId, projectId, component, library, context }) => {
-      if (target !== "react" && target !== "html" && target !== "shopify" && target !== "dtcg" && target !== "react-native" && target !== "swiftui") {
+      if (target !== "react" && target !== "html" && target !== "shopify" && target !== "dtcg" && target !== "store-screenshots" && target !== "react-native" && target !== "swiftui") {
         return {
           content: [{ type: "text", text: `Unknown target "${target}".` }],
           structuredContent: { status: "error", name: "Unknown target", tokensCss: "" }
@@ -14192,6 +14486,9 @@ ${BUILD_TARGET_RULE}`,
       if (target === "dtcg") {
         return withRedesignContract(await getDtcgKit({ designSystemId, projectId, context }));
       }
+      if (target === "store-screenshots") {
+        return getStoreScreenshots({ designSystemId, projectId, context });
+      }
       if (target === "react-native" || target === "swiftui") {
         if (!enableMobileKits) {
           return {
@@ -14687,6 +14984,7 @@ var init_design_system_tools = __esm({
     init_shopify_kit();
     init_redesign_contract();
     init_selected_icon_handoff();
+    init_store_screenshots();
     init_shopify_primitives();
     init_preview_html();
     init_shared();
@@ -22772,7 +23070,7 @@ function columnToSchema(column, factory) {
   }
   return schema;
 }
-function numberColumnToSchema(column, z35, coerce) {
+function numberColumnToSchema(column, z38, coerce) {
   let unsigned = column.getSQLType().includes("unsigned");
   let min;
   let max;
@@ -22840,20 +23138,20 @@ function numberColumnToSchema(column, z35, coerce) {
     min = Number.MIN_SAFE_INTEGER;
     max = Number.MAX_SAFE_INTEGER;
   }
-  let schema = coerce === true || coerce?.number ? z35.coerce.number() : z35.number();
+  let schema = coerce === true || coerce?.number ? z38.coerce.number() : z38.number();
   schema = schema.min(min).max(max);
   return integer2 ? schema.int() : schema;
 }
-function bigintColumnToSchema(column, z35, coerce) {
+function bigintColumnToSchema(column, z38, coerce) {
   const unsigned = column.getSQLType().includes("unsigned");
   const min = unsigned ? 0n : CONSTANTS.INT64_MIN;
   const max = unsigned ? CONSTANTS.INT64_UNSIGNED_MAX : CONSTANTS.INT64_MAX;
-  const schema = coerce === true || coerce?.bigint ? z35.coerce.bigint() : z35.bigint();
+  const schema = coerce === true || coerce?.bigint ? z38.coerce.bigint() : z38.bigint();
   return schema.min(min).max(max);
 }
-function stringColumnToSchema(column, z35, coerce) {
+function stringColumnToSchema(column, z38, coerce) {
   if (isColumnType(column, ["PgUUID"])) {
-    return z35.string().uuid();
+    return z38.string().uuid();
   }
   let max;
   let regex;
@@ -22885,7 +23183,7 @@ function stringColumnToSchema(column, z35, coerce) {
     regex = /^[01]+$/;
     max = column.dimensions;
   }
-  let schema = coerce === true || coerce?.string ? z35.coerce.string() : z35.string();
+  let schema = coerce === true || coerce?.string ? z38.coerce.string() : z38.string();
   schema = regex ? schema.regex(regex) : schema;
   return max && fixed ? schema.length(max) : max ? schema.max(max) : schema;
 }
@@ -22981,15 +23279,74 @@ var init_drizzle_zod = __esm({
   }
 });
 
-// ../shared/src/schema.ts
+// ../shared/src/agent-feedback.ts
 import { z as z16 } from "zod";
-var vector2, messageRoleEnum, messageTypeEnum, designSystemStatusEnum, onboardingPathValues, onboardingPathSchema, onboardingPathSqlValues, mcpIssueCategoryValues, mcpIssueStatusValues, mcpIssueImprovementStatusValues, mcpIssueImprovementVerdictValues, mcpIssueImprovementStatusSchema, mcpIssueImprovementVerdictSchema, mcpIssueImprovementStatusSqlValues, mcpIssueImprovementVerdictSqlValues, designConfigSchema, projectMemoryDataSchema, projects, messages, projectMemory, fragments, usage, scrapeBlock, resourceAccess, user, signupAlertDeliveries, billingAlertDeliveries, TEAM_RULES_MAX_BYTES, teamRules, billingSubscription, githubInstallationClaim, githubInstallation, featureAccess, session, account, verification, jwks, oauthClient, oauthRefreshToken, oauthAccessToken, oauthConsent, designSystems, designSystemComponents, foundationalDocs, apiKeys, emailCampaignSends, emailCampaignSteps, projectEvents, iconLibraries, dsSearchQueries, mcpToolCalls, mcpClientConnections, evalVerdicts, generationInputs, mcpIssues, mcpIssueImprovements, projectsRelations, projectMemoryRelations, mcpIssuesRelations, mcpIssueImprovementsRelations, messagesRelations, fragmentsRelations, designSystemsRelations, designSystemComponentsRelations, insertProjectSchema, selectProjectSchema, insertMessageSchema, selectMessageSchema, insertFragmentSchema, selectFragmentSchema, insertProjectMemorySchema, selectProjectMemorySchema, insertDesignSystemSchema, selectDesignSystemSchema, insertDesignSystemComponentSchema, selectDesignSystemComponentSchema, insertFoundationalDocSchema, selectFoundationalDocSchema, insertIconLibrarySchema, selectIconLibrarySchema, insertApiKeySchema, selectApiKeySchema, insertUserSchema, selectUserSchema, insertSignupAlertDeliverySchema, selectSignupAlertDeliverySchema, insertEmailCampaignSendSchema, selectEmailCampaignSendSchema, insertEmailCampaignStepSchema, selectEmailCampaignStepSchema, insertMcpIssueImprovementSchema, selectMcpIssueImprovementSchema, pluginAuthNonces;
+var agentFeedbackKindValues, TEXT_MAX, SURFACE_MAX, SUMMARY_MAX, AGENT_FEEDBACK_CLIENT_MAX, FIELD_DESCRIPTIONS, optionalText, agentFeedbackInputSchema, AGENT_FEEDBACK_CONTRACT;
+var init_agent_feedback = __esm({
+  "../shared/src/agent-feedback.ts"() {
+    "use strict";
+    agentFeedbackKindValues = [
+      "bug",
+      "missing-feature",
+      "wrong-output",
+      "docs-gap",
+      "other"
+    ];
+    TEXT_MAX = 4e3;
+    SURFACE_MAX = 200;
+    SUMMARY_MAX = 500;
+    AGENT_FEEDBACK_CLIENT_MAX = 100;
+    FIELD_DESCRIPTIONS = {
+      kind: "What kind of problem this is.",
+      surface: "The endpoint path or MCP tool name you called.",
+      summary: "One sentence: what is wrong or missing.",
+      attempted: "What you tried to do, and the request you sent.",
+      expected: "What you expected to get back.",
+      actual: "What you got back instead.",
+      client: "Your agent name and version."
+    };
+    optionalText = (description) => z16.string().trim().max(TEXT_MAX).optional().describe(description);
+    agentFeedbackInputSchema = z16.object({
+      kind: z16.enum(agentFeedbackKindValues).describe(FIELD_DESCRIPTIONS.kind),
+      surface: z16.string().trim().min(1).max(SURFACE_MAX).describe(FIELD_DESCRIPTIONS.surface),
+      summary: z16.string().trim().min(1).max(SUMMARY_MAX).describe(FIELD_DESCRIPTIONS.summary),
+      attempted: optionalText(FIELD_DESCRIPTIONS.attempted),
+      expected: optionalText(FIELD_DESCRIPTIONS.expected),
+      actual: optionalText(FIELD_DESCRIPTIONS.actual),
+      client: z16.string().trim().max(AGENT_FEEDBACK_CLIENT_MAX).optional().describe(FIELD_DESCRIPTIONS.client)
+    });
+    AGENT_FEEDBACK_CONTRACT = {
+      method: "POST",
+      path: "/api/v1/feedback",
+      purpose: "Tell Better Design about a bug or a missing feature you hit while calling this API. A person reads every report.",
+      fields: {
+        kind: { required: true, description: FIELD_DESCRIPTIONS.kind, oneOf: agentFeedbackKindValues },
+        surface: { required: true, description: FIELD_DESCRIPTIONS.surface, maxLength: SURFACE_MAX },
+        summary: { required: true, description: FIELD_DESCRIPTIONS.summary, maxLength: SUMMARY_MAX },
+        attempted: { required: false, description: FIELD_DESCRIPTIONS.attempted, maxLength: TEXT_MAX },
+        expected: { required: false, description: FIELD_DESCRIPTIONS.expected, maxLength: TEXT_MAX },
+        actual: { required: false, description: FIELD_DESCRIPTIONS.actual, maxLength: TEXT_MAX },
+        client: { required: false, description: FIELD_DESCRIPTIONS.client, maxLength: AGENT_FEEDBACK_CLIENT_MAX }
+      },
+      notes: [
+        "Send it with your Better Design API key: Authorization: Bearer <key>.",
+        "Do not include secrets or personal data. Known secret shapes are removed before storage.",
+        "Sending feedback never spends credit."
+      ]
+    };
+  }
+});
+
+// ../shared/src/schema.ts
+import { z as z17 } from "zod";
+var vector2, messageRoleEnum, messageTypeEnum, designSystemStatusEnum, onboardingPathValues, onboardingPathSchema, onboardingPathSqlValues, mcpIssueCategoryValues, mcpIssueStatusValues, mcpIssueImprovementStatusValues, mcpIssueImprovementVerdictValues, mcpIssueImprovementStatusSchema, mcpIssueImprovementVerdictSchema, mcpIssueImprovementStatusSqlValues, mcpIssueImprovementVerdictSqlValues, designConfigSchema, projectMemoryDataSchema, projects, messages, projectMemory, fragments, usage, scrapeBlock, resourceAccess, user, signupAlertDeliveries, billingAlertDeliveries, billingEmailDeliveries, TEAM_RULES_MAX_BYTES, teamRules, agentFeedbackStatusValues, agentFeedback, billingSubscription, githubInstallationClaim, githubInstallation, featureAccess, session, account, verification, jwks, oauthClient, oauthRefreshToken, oauthAccessToken, oauthConsent, designSystems, designSystemComponents, foundationalDocs, apiKeys, emailCampaignSends, emailCampaignSteps, projectEvents, iconLibraries, dsSearchQueries, mcpToolCalls, mcpClientConnections, evalVerdicts, generationInputs, mcpIssues, mcpIssueImprovements, projectsRelations, projectMemoryRelations, mcpIssuesRelations, mcpIssueImprovementsRelations, messagesRelations, fragmentsRelations, designSystemsRelations, designSystemComponentsRelations, insertProjectSchema, selectProjectSchema, insertMessageSchema, selectMessageSchema, insertFragmentSchema, selectFragmentSchema, insertProjectMemorySchema, selectProjectMemorySchema, insertDesignSystemSchema, selectDesignSystemSchema, insertDesignSystemComponentSchema, selectDesignSystemComponentSchema, insertFoundationalDocSchema, selectFoundationalDocSchema, insertIconLibrarySchema, selectIconLibrarySchema, insertApiKeySchema, selectApiKeySchema, insertUserSchema, selectUserSchema, insertSignupAlertDeliverySchema, selectSignupAlertDeliverySchema, insertEmailCampaignSendSchema, selectEmailCampaignSendSchema, insertEmailCampaignStepSchema, selectEmailCampaignStepSchema, insertMcpIssueImprovementSchema, selectMcpIssueImprovementSchema, pluginAuthNonces;
 var init_schema2 = __esm({
   "../shared/src/schema.ts"() {
     "use strict";
     init_pg_core();
     init_drizzle_orm();
     init_drizzle_zod();
+    init_agent_feedback();
     vector2 = customType({
       dataType() {
         return "vector(768)";
@@ -23017,7 +23374,7 @@ var init_schema2 = __esm({
       "skip",
       "legacy"
     ];
-    onboardingPathSchema = z16.enum(onboardingPathValues);
+    onboardingPathSchema = z17.enum(onboardingPathValues);
     onboardingPathSqlValues = sql.raw(
       onboardingPathValues.map((path6) => `'${path6}'`).join(", ")
     );
@@ -23040,10 +23397,10 @@ var init_schema2 = __esm({
       "not_improved",
       "inconclusive"
     ];
-    mcpIssueImprovementStatusSchema = z16.enum(
+    mcpIssueImprovementStatusSchema = z17.enum(
       mcpIssueImprovementStatusValues
     );
-    mcpIssueImprovementVerdictSchema = z16.enum(
+    mcpIssueImprovementVerdictSchema = z17.enum(
       mcpIssueImprovementVerdictValues
     );
     mcpIssueImprovementStatusSqlValues = sql.raw(
@@ -23052,38 +23409,38 @@ var init_schema2 = __esm({
     mcpIssueImprovementVerdictSqlValues = sql.raw(
       mcpIssueImprovementVerdictValues.map((verdict) => `'${verdict}'`).join(", ")
     );
-    designConfigSchema = z16.object({
-      colors: z16.object({
-        primary: z16.string(),
-        secondary: z16.string(),
-        accent: z16.string(),
-        muted: z16.string(),
-        destructive: z16.string(),
-        background: z16.string(),
-        foreground: z16.string(),
-        card: z16.string(),
-        cardForeground: z16.string(),
-        popover: z16.string(),
-        popoverForeground: z16.string(),
-        border: z16.string(),
-        input: z16.string(),
-        ring: z16.string()
+    designConfigSchema = z17.object({
+      colors: z17.object({
+        primary: z17.string(),
+        secondary: z17.string(),
+        accent: z17.string(),
+        muted: z17.string(),
+        destructive: z17.string(),
+        background: z17.string(),
+        foreground: z17.string(),
+        card: z17.string(),
+        cardForeground: z17.string(),
+        popover: z17.string(),
+        popoverForeground: z17.string(),
+        border: z17.string(),
+        input: z17.string(),
+        ring: z17.string()
       }).partial(),
-      radius: z16.string(),
-      font: z16.object({
-        sans: z16.string(),
-        mono: z16.string()
+      radius: z17.string(),
+      font: z17.object({
+        sans: z17.string(),
+        mono: z17.string()
       }).partial(),
-      icons: z16.object({
-        libraryId: z16.string(),
-        variant: z16.string().nullable()
+      icons: z17.object({
+        libraryId: z17.string(),
+        variant: z17.string().nullable()
       }).partial()
     }).partial();
-    projectMemoryDataSchema = z16.object({
-      lockedIn: z16.array(z16.string()),
-      rejected: z16.array(z16.string()),
-      tone: z16.string().nullable(),
-      notes: z16.string().nullable()
+    projectMemoryDataSchema = z17.object({
+      lockedIn: z17.array(z17.string()),
+      rejected: z17.array(z17.string()),
+      tone: z17.string().nullable(),
+      notes: z17.string().nullable()
     });
     projects = pgTable("projects", {
       id: uuid("id").primaryKey().defaultRandom(),
@@ -23314,6 +23671,40 @@ var init_schema2 = __esm({
         )
       ]
     );
+    billingEmailDeliveries = pgTable(
+      "billing_email_deliveries",
+      {
+        id: text("id").primaryKey(),
+        userId: text("user_id").notNull().references(() => user.id, { onDelete: "cascade" }),
+        toEmail: text("to_email").notNull(),
+        /** The Stripe subscription the email is about, so the daily cap can count per subscription. */
+        stripeSubscriptionId: text("stripe_subscription_id").notNull(),
+        email: jsonb("email").$type().notNull(),
+        occurredAt: timestamp("occurred_at", { withTimezone: true }).notNull(),
+        status: text("status").$type().default("pending").notNull(),
+        attemptCount: integer("attempt_count").default(0).notNull(),
+        nextAttemptAt: timestamp("next_attempt_at", { withTimezone: true }).defaultNow().notNull(),
+        leaseUntil: timestamp("lease_until", { withTimezone: true }),
+        leaseToken: uuid("lease_token"),
+        deliveredAt: timestamp("delivered_at", { withTimezone: true }),
+        resendEmailId: text("resend_email_id"),
+        lastError: text("last_error"),
+        createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
+        updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
+      },
+      (t) => [
+        index("billing_email_deliveries_due_idx").on(t.status, t.nextAttemptAt, t.leaseUntil),
+        index("billing_email_deliveries_subscription_idx").on(t.stripeSubscriptionId, t.createdAt),
+        check(
+          "billing_email_deliveries_status_valid",
+          sql`${t.status} in ('pending', 'processing', 'delivered', 'failed')`
+        ),
+        check(
+          "billing_email_deliveries_processing_lease_valid",
+          sql`${t.status} <> 'processing' or (${t.leaseUntil} is not null and ${t.leaseToken} is not null)`
+        )
+      ]
+    );
     TEAM_RULES_MAX_BYTES = 32 * 1024;
     teamRules = pgTable(
       "team_rules",
@@ -23329,6 +23720,43 @@ var init_schema2 = __esm({
         )
       ]
     );
+    agentFeedbackStatusValues = [
+      "open",
+      "accepted",
+      "rejected",
+      "shipped"
+    ];
+    agentFeedback = pgTable(
+      "agent_feedback",
+      {
+        id: uuid("id").primaryKey().defaultRandom(),
+        userId: text("user_id").notNull().references(() => user.id, { onDelete: "cascade" }),
+        apiKeyId: text("api_key_id").references(() => apiKeys.id, { onDelete: "set null" }),
+        kind: text("kind", { enum: agentFeedbackKindValues }).notNull(),
+        // The endpoint path or MCP tool name the agent was calling.
+        surface: text("surface").notNull(),
+        summary: text("summary").notNull(),
+        attempted: text("attempted"),
+        expected: text("expected"),
+        actual: text("actual"),
+        // The agent's own name for itself, such as "claude-code/2.1".
+        client: text("client"),
+        // SHA-256 of kind, surface and the normalized summary, so identical
+        // reports group in the admin queue without a model call.
+        fingerprint: text("fingerprint").notNull(),
+        status: text("status", { enum: agentFeedbackStatusValues }).notNull().default("open"),
+        pullRequestUrl: text("pull_request_url"),
+        createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
+        updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
+      },
+      (t) => [
+        index("agent_feedback_status_created_idx").on(t.status, t.createdAt),
+        index("agent_feedback_fingerprint_idx").on(t.fingerprint),
+        // Deleting a user or an API key looks up its reports through these.
+        index("agent_feedback_user_id_idx").on(t.userId),
+        index("agent_feedback_api_key_id_idx").on(t.apiKeyId)
+      ]
+    );
     billingSubscription = pgTable(
       "billing_subscription",
       {
@@ -24135,7 +24563,7 @@ var init_schema2 = __esm({
 });
 
 // ../shared/src/mcp/tools/design-config-tools.ts
-import { z as z17 } from "zod";
+import { z as z18 } from "zod";
 function registerDesignConfigTools({
   server,
   tracked,
@@ -24186,7 +24614,7 @@ function registerDesignConfigTools({
     {
       title: "Get a Project's Tuned Design Config",
       description: `Read the user-tuned design config (exact color tokens, radius, fonts, icon library) of a generated project. Call this BEFORE building or restyling UI for the project, and again after the user tunes values on the project page, so you apply their exact numbers instead of guessing from adjectives.`,
-      inputSchema: z17.object({
+      inputSchema: z18.object({
         projectId: PROJECT_ID_ARG,
         context: CONTEXT_ARG
       }),
@@ -24215,7 +24643,7 @@ function registerDesignConfigTools({
     {
       title: "Set a Project's Design Config",
       description: `Write exact design-token values (colors, radius, fonts, icon library) onto a generated project. Use this when the user states concrete values ("make primary oklch(0.62 0.11 45)", "radius 12px"). It merges over the current config and persists, so the change survives restarts and every later get-design-config returns it. Saved config is publicly readable by anyone with the fragment config URL. For vague direction ("warmer", "more playful"), iterate with the user toward concrete values first; do not invent numbers on their behalf.`,
-      inputSchema: z17.object({
+      inputSchema: z18.object({
         projectId: PROJECT_ID_ARG,
         config: CONFIG_ARG,
         context: CONTEXT_ARG
@@ -24266,7 +24694,7 @@ var init_design_config_tools = __esm({
     "use strict";
     init_schema2();
     init_shared();
-    PROJECT_ID_ARG = z17.string().min(1).describe("The project id returned by create-design-system.");
+    PROJECT_ID_ARG = z18.string().min(1).describe("The project id returned by create-design-system.");
     CONFIG_ARG = designConfigSchema.describe(
       "Partial design config to merge over the current one. Only pass the fields the user changed. Colors are oklch() strings (e.g. 'oklch(0.62 0.11 45)'); radius is a CSS length (e.g. '0.75rem'); fonts are family names."
     );
@@ -24274,16 +24702,16 @@ var init_design_config_tools = __esm({
 });
 
 // ../shared/src/mcp/tools/jig-tools.ts
-import { z as z18 } from "zod";
+import { z as z19 } from "zod";
 function registerJigTools({ server, tracked }) {
   server.registerTool(
     "get-jig-guide",
     {
       title: "Get a Jig for Parameter Work",
       description: `Return the setup for a "jig", the tool you build to make the real thing precisely. Two kinds, both here. Use kind "tune-in-place" (default) when you are about to hard-code taste-based values in UI you are building: animation duration/easing/springs/stagger, particles, canvas physics, blur/glow/grain, gradient stops, shadow recipes, parallax speeds. It returns a control panel to wire to those parameters so the USER tunes by eye and you hard-code what they copy back. Use kind "standalone-tool" when the user wants a reusable custom tool instead: a generator, an image effect, a shader playground, an asset maker. That returns the Toolcraft starter kit (MIT), which ships a canvas and an export flow, with optional layers and a timeline. Tuning setups: React recommends DialKit (MIT, no re-render lag) with a dependency-free fallback; "vanilla" and "react-native" get dependency-free scaffolds.`,
-      inputSchema: z18.object({
-        kind: z18.enum(["tune-in-place", "standalone-tool"]).default("tune-in-place").describe("What the user needs. 'tune-in-place' (default): a control panel for parameters in the UI you are building. 'standalone-tool': a separate reusable design tool, scaffolded with Toolcraft."),
-        framework: z18.enum(["react", "vanilla", "react-native"]).optional().describe("Which tune-in-place setup to return. 'react' (default) for React/Next web projects; 'vanilla' for plain DOM or canvas work; 'react-native' for RN/Expo apps. Ignored when kind is 'standalone-tool'."),
+      inputSchema: z19.object({
+        kind: z19.enum(["tune-in-place", "standalone-tool"]).default("tune-in-place").describe("What the user needs. 'tune-in-place' (default): a control panel for parameters in the UI you are building. 'standalone-tool': a separate reusable design tool, scaffolded with Toolcraft."),
+        framework: z19.enum(["react", "vanilla", "react-native"]).optional().describe("Which tune-in-place setup to return. 'react' (default) for React/Next web projects; 'vanilla' for plain DOM or canvas work; 'react-native' for RN/Expo apps. Ignored when kind is 'standalone-tool'."),
         context: CONTEXT_ARG
       }),
       annotations: READ_ONLY_TOOL_ANNOTATIONS
@@ -25115,7 +25543,7 @@ var init_brand_sources = __esm({
 });
 
 // ../shared/src/mcp/tools/extract-tools.ts
-import { z as z19 } from "zod";
+import { z as z20 } from "zod";
 function authHeaders2(authContext) {
   if (!authContext) return {};
   const bearer = authContext.kind === "api-key" ? authContext.apiKey : authContext.accessToken;
@@ -25152,15 +25580,15 @@ JSON.stringify(${buildRoleSampleScript()})
 - kind "tokens": a design-tokens JSON export ($value entries, W3C format or the Figma variables API shape with 0..1 rgb floats).
 
 Common vendor names (Shopify's --color-button family) are mapped into empty semantic slots automatically and the mapping is reported in the output.`,
-      inputSchema: z19.object({
-        css: z19.string().trim().min(1).max(2e5).optional().describe("Full contents of the project's globals.css (or any CSS holding the design tokens / CSS custom properties). Optional when `sources` is given."),
-        sources: z19.array(z19.object({
-          name: z19.string().trim().min(1).max(120).describe("Label for this source, e.g. 'globals.css', 'live site sample', 'figma variables'."),
-          kind: z19.enum(["css", "computed", "tokens"]).optional().describe("Omit to infer: JSON with $value entries is tokens, JSON keyed by UI roles is computed, anything else is CSS."),
-          content: z19.string().trim().min(1).max(2e5)
+      inputSchema: z20.object({
+        css: z20.string().trim().min(1).max(2e5).optional().describe("Full contents of the project's globals.css (or any CSS holding the design tokens / CSS custom properties). Optional when `sources` is given."),
+        sources: z20.array(z20.object({
+          name: z20.string().trim().min(1).max(120).describe("Label for this source, e.g. 'globals.css', 'live site sample', 'figma variables'."),
+          kind: z20.enum(["css", "computed", "tokens"]).optional().describe("Omit to infer: JSON with $value entries is tokens, JSON keyed by UI roles is computed, anything else is CSS."),
+          content: z20.string().trim().min(1).max(2e5)
         })).max(10).optional().describe("Any mix of brand sources, merged in order (later sources win). See the tool description for how to gather each kind."),
-        name: z19.string().trim().min(1).max(120).optional().describe("Optional label for the extracted system, e.g. the app or repo name."),
-        maxTokens: z19.number().min(500).max(5e4).optional().describe("Maximum tokens to return. Truncates the token sheet to fit.")
+        name: z20.string().trim().min(1).max(120).optional().describe("Optional label for the extracted system, e.g. the app or repo name."),
+        maxTokens: z20.number().min(500).max(5e4).optional().describe("Maximum tokens to return. Truncates the token sheet to fit.")
       }),
       annotations: READ_ONLY_TOOL_ANNOTATIONS
     },
@@ -25191,10 +25619,10 @@ Common vendor names (Shopify's --color-button family) are mapped into empty sema
 Use this when the user names their site ("match uclips.eu", "use our website's style") or hands you any public URL whose look should be reused. Server side, Better Design fetches the page's stylesheets AND renders the page in a headless browser to sample what role elements actually look like (body, heading, link, button, input, card), then merges both, rendered truth last. That reads the brand even when the site's variable names are unrecognizable.
 
 Slow by nature (a real browser loads the page): expect 10 to 45 seconds. For CSS the user already has locally, prefer extract-design-system, which is instant.`,
-      inputSchema: z19.object({
-        url: z19.string().trim().min(8).max(2048).describe("Public http(s) URL of the page to read, usually the homepage."),
-        name: z19.string().trim().min(1).max(120).optional().describe("Optional label for the extracted system. Defaults to the site's hostname."),
-        maxTokens: z19.number().min(500).max(5e4).optional().describe("Maximum tokens to return. Truncates the token sheet to fit.")
+      inputSchema: z20.object({
+        url: z20.string().trim().min(8).max(2048).describe("Public http(s) URL of the page to read, usually the homepage."),
+        name: z20.string().trim().min(1).max(120).optional().describe("Optional label for the extracted system. Defaults to the site's hostname."),
+        maxTokens: z20.number().min(500).max(5e4).optional().describe("Maximum tokens to return. Truncates the token sheet to fit.")
       }),
       // Reads any public page the user names, so the set of hosts it reaches is
       // the open web, not Better Design's catalog. It stores nothing. [BD-316]
@@ -25244,7 +25672,7 @@ var init_extract_tools = __esm({
 });
 
 // ../shared/src/mcp/tools/illustration-tools.ts
-import { z as z20 } from "zod";
+import { z as z21 } from "zod";
 function fail(message) {
   return {
     content: [{ type: "text", text: message }],
@@ -25290,11 +25718,11 @@ How to call it:
 4. Stop when \`faults\` is empty.
 
 Markup carrying script, event handlers, remote references, or styles that reach outside the drawing is refused rather than cleaned, so the drawing you fix is the drawing you sent.`,
-      inputSchema: z20.object({
-        svg: z20.string().min(1).describe("The complete svg element you drew."),
-        intent: z20.string().min(1).describe('What it is meant to be, in plain words. For example "an open inbox tray with letters".'),
-        animated: z20.boolean().optional().describe("Set when the drawing was meant to move, so the motion checks apply."),
-        reviewToken: z20.string().optional().describe("The token from a previous review of this drawing. Reviews it again free.")
+      inputSchema: z21.object({
+        svg: z21.string().min(1).describe("The complete svg element you drew."),
+        intent: z21.string().min(1).describe('What it is meant to be, in plain words. For example "an open inbox tray with letters".'),
+        animated: z21.boolean().optional().describe("Set when the drawing was meant to move, so the motion checks apply."),
+        reviewToken: z21.string().optional().describe("The token from a previous review of this drawing. Reviews it again free.")
       }),
       outputSchema: REVIEW_OUTPUT_SCHEMA,
       // A review without a valid reviewToken passes the paywall, so it spends
@@ -25373,16 +25801,16 @@ var init_illustration_tools = __esm({
     init_shared();
     REVIEW_OUTPUT_SCHEMA = {
       /** Empty when nothing is visibly wrong. */
-      faults: z20.array(z20.string()),
+      faults: z21.array(z21.string()),
       /** Group ids in paint order, the parts an animation can target. */
-      layers: z20.array(z20.string()),
+      layers: z21.array(z21.string()),
       /** False when the markup was refused; faults says why. */
-      reviewed: z20.boolean(),
+      reviewed: z21.boolean(),
       /** True when the drawing could not be rendered, so only structure was checked. */
-      unseen: z20.boolean(),
+      unseen: z21.boolean(),
       /** Pass this back to review the same drawing again without spending another credit. */
-      reviewToken: z20.string(),
-      message: z20.string()
+      reviewToken: z21.string(),
+      message: z21.string()
     };
   }
 });
@@ -26744,7 +27172,7 @@ ul.evidence { padding-inline-start: 1rem; }
 });
 
 // ../shared/src/mcp/tools/inspection-tools.ts
-import { z as z21 } from "zod";
+import { z as z22 } from "zod";
 function coversRecommendedWidth(states, width) {
   return states.some(
     (state) => Math.abs(state.viewport.width - width) <= WIDTH_TOLERANCE
@@ -26800,36 +27228,38 @@ function registerInspectionTools({ server, provider, tracked }) {
 
 This is the runtime counterpart to get-review-rules. It automatically loads the live visual-design rubric, but it does not guess pixel values from a screenshot. Exact claims come from DOM geometry.
 
+It measures geometry only. A score of 100 is not visual approval: it cannot judge hierarchy, density, or whether the design works, so look at a screenshot before you call a screen done.
+
 Workflow:
 1. Call with no states to receive a read-only browser capture script in structuredContent.captureScript. Use detail: "full" if your client reads only text; it includes the script in text. That call measures nothing.
 2. Evaluate that script in each rendered state you need to review: at minimum 1440, 1728 and 390 wide. Also capture named hover, focus, selected, and open states when they change a control's surface or layout.
 3. Call again with the captured states and the project's spacing scale when known. The layout counts as measured only when this second call returns status \`completed\`; reading the snapshot yourself is not a measurement. The report and summary start with the highest-priority correction. Read structuredContent.findings or use detail: "full" for every returned finding, measurement, and fix. Structured evidence retains captured geometry and optional screenshots for report renderers.
 
 The capture reads visible layout geometry, computed spacing, corner radii, surface styles, the number of line boxes each text block rendered, and short accessible labels for interactive controls. It does not collect source code, cookies, form values, or network data. Add data-bd-inspect-label, data-bd-symmetry, data-bd-group, data-bd-compare-size, data-bd-align-group, and data-bd-align-edge attributes when the intended relationship cannot be inferred safely.`,
-      inputSchema: z21.object({
-        states: z21.array(spacingStateSchema).min(1).max(6).optional().describe("Rendered layout states from the capture script. Omit on the first call to receive the script."),
-        spacingScale: z21.array(finiteNumber.positive()).min(2).max(32).optional().describe("Project spacing tokens in CSS pixels. Defaults to 4, 8, 12, 16, 24, 32, 48, 64, 96, 128."),
+      inputSchema: z22.object({
+        states: z22.array(spacingStateSchema).min(1).max(6).optional().describe("Rendered layout states from the capture script. Omit on the first call to receive the script."),
+        spacingScale: z22.array(finiteNumber.positive()).min(2).max(32).optional().describe("Project spacing tokens in CSS pixels. Defaults to 4, 8, 12, 16, 24, 32, 48, 64, 96, 128."),
         tolerance: finiteNumber.min(0).max(4).optional().describe("Pixel tolerance for grouping measurements. Defaults to 1px."),
-        detail: z21.enum(["summary", "full"]).default("summary").describe("Defaults to a short summary alongside the inline report. Use full for the capture script or all findings and measurements in text-only clients."),
+        detail: z22.enum(["summary", "full"]).default("summary").describe("Defaults to a short summary alongside the inline report. Use full for the capture script or all findings and measurements in text-only clients."),
         context: CONTEXT_ARG
       }),
-      outputSchema: z21.object({
-        status: z21.enum(["needs-capture", "completed"]),
-        score: z21.number().optional(),
-        summary: z21.object({
-          critical: z21.number(),
-          serious: z21.number(),
-          moderate: z21.number(),
-          total: z21.number(),
-          truncated: z21.number().optional()
+      outputSchema: z22.object({
+        status: z22.enum(["needs-capture", "completed"]),
+        score: z22.number().optional(),
+        summary: z22.object({
+          critical: z22.number(),
+          serious: z22.number(),
+          moderate: z22.number(),
+          total: z22.number(),
+          truncated: z22.number().optional()
         }).optional(),
-        findings: z21.array(findingSchema).optional(),
-        capturedWidths: z21.array(z21.number()).optional(),
-        missingWidths: z21.array(z21.number()).optional(),
-        states: z21.array(overlayStateSchema).optional(),
-        rubric: z21.array(z21.object({ id: z21.string(), title: z21.string() })).optional(),
-        rubricStatus: z21.enum(["loaded", "unavailable"]).optional(),
-        captureScript: z21.string().optional()
+        findings: z22.array(findingSchema).optional(),
+        capturedWidths: z22.array(z22.number()).optional(),
+        missingWidths: z22.array(z22.number()).optional(),
+        states: z22.array(overlayStateSchema).optional(),
+        rubric: z22.array(z22.object({ id: z22.string(), title: z22.string() })).optional(),
+        rubricStatus: z22.enum(["loaded", "unavailable"]).optional(),
+        captureScript: z22.string().optional()
       }),
       annotations: READ_ONLY_TOOL_ANNOTATIONS,
       _meta: {
@@ -26889,7 +27319,8 @@ ${SPACING_CAPTURE_SCRIPT}
           detail === "full" ? `Spacing score: ${result.score}/100.` : "",
           coverageLine,
           findingsText,
-          result.summary.truncated ? `${result.summary.truncated} additional findings exceeded the analysis limit. Inspect smaller sections before treating this review as complete.` : ""
+          result.summary.truncated ? `${result.summary.truncated} additional findings exceeded the analysis limit. Inspect smaller sections before treating this review as complete.` : "",
+          GEOMETRY_ONLY
         ].filter(Boolean).join("\n\n");
         return {
           content: [{ type: "text", text: text3 }],
@@ -26906,7 +27337,7 @@ ${SPACING_CAPTURE_SCRIPT}
     )
   );
 }
-var finiteNumber, rectSchema, edgesSchema, cornerRadiusAxesSchema, cornerRadiusSchema, cornerRadiiSchema, styleSchema, elementSchema, screenshotSchema, spacingStateSchema, evidenceSchema, findingSchema, overlayStateSchema, RECOMMENDED_VIEWPORT_WIDTHS, WIDTH_TOLERANCE;
+var finiteNumber, rectSchema, edgesSchema, cornerRadiusAxesSchema, cornerRadiusSchema, cornerRadiiSchema, styleSchema, elementSchema, screenshotSchema, spacingStateSchema, evidenceSchema, findingSchema, overlayStateSchema, RECOMMENDED_VIEWPORT_WIDTHS, WIDTH_TOLERANCE, GEOMETRY_ONLY;
 var init_inspection_tools = __esm({
   "../shared/src/mcp/tools/inspection-tools.ts"() {
     "use strict";
@@ -26914,67 +27345,67 @@ var init_inspection_tools = __esm({
     init_finding_copy();
     init_spacing_inspection_html();
     init_shared();
-    finiteNumber = z21.number().finite();
-    rectSchema = z21.object({
+    finiteNumber = z22.number().finite();
+    rectSchema = z22.object({
       x: finiteNumber,
       y: finiteNumber,
       width: finiteNumber.nonnegative(),
       height: finiteNumber.nonnegative()
     });
-    edgesSchema = z21.object({
+    edgesSchema = z22.object({
       top: finiteNumber,
       right: finiteNumber,
       bottom: finiteNumber,
       left: finiteNumber
     });
-    cornerRadiusAxesSchema = z21.object({
+    cornerRadiusAxesSchema = z22.object({
       horizontal: finiteNumber.nonnegative(),
       vertical: finiteNumber.nonnegative()
     });
-    cornerRadiusSchema = z21.union([
+    cornerRadiusSchema = z22.union([
       cornerRadiusAxesSchema,
       finiteNumber.nonnegative().transform((value) => ({
         horizontal: value,
         vertical: value
       }))
     ]);
-    cornerRadiiSchema = z21.object({
+    cornerRadiiSchema = z22.object({
       topLeft: cornerRadiusSchema,
       topRight: cornerRadiusSchema,
       bottomRight: cornerRadiusSchema,
       bottomLeft: cornerRadiusSchema
     });
-    styleSchema = z21.object({
-      display: z21.string().max(60).optional(),
-      position: z21.string().max(60).optional(),
-      flexDirection: z21.string().max(60).optional(),
-      flexWrap: z21.string().max(60).optional(),
-      alignItems: z21.string().max(60).optional(),
-      justifyContent: z21.string().max(60).optional(),
+    styleSchema = z22.object({
+      display: z22.string().max(60).optional(),
+      position: z22.string().max(60).optional(),
+      flexDirection: z22.string().max(60).optional(),
+      flexWrap: z22.string().max(60).optional(),
+      alignItems: z22.string().max(60).optional(),
+      justifyContent: z22.string().max(60).optional(),
       rowGap: finiteNumber.optional(),
       columnGap: finiteNumber.optional(),
       padding: edgesSchema.optional(),
       margin: edgesSchema.optional(),
-      overflowX: z21.string().max(60).optional(),
-      overflowY: z21.string().max(60).optional(),
+      overflowX: z22.string().max(60).optional(),
+      overflowY: z22.string().max(60).optional(),
       borderRadius: cornerRadiiSchema.optional(),
-      backgroundColor: z21.string().max(160).optional(),
-      backgroundImage: z21.string().max(1e3).optional(),
-      boxShadow: z21.string().max(1e3).optional()
+      backgroundColor: z22.string().max(160).optional(),
+      backgroundImage: z22.string().max(1e3).optional(),
+      boxShadow: z22.string().max(1e3).optional()
     });
-    elementSchema = z21.object({
-      id: z21.string().min(1).max(300),
-      selector: z21.string().max(500).optional(),
-      tag: z21.string().max(80).optional(),
-      role: z21.string().max(80).optional(),
-      label: z21.string().max(160).optional(),
-      parentId: z21.string().max(300).optional(),
-      groupId: z21.string().max(300).optional(),
-      alignmentGroup: z21.string().max(300).optional(),
-      alignmentEdge: z21.enum(["left", "right", "top", "bottom", "center-x", "center-y"]).optional(),
-      expectedSymmetry: z21.enum(["horizontal", "vertical", "both"]).optional(),
-      compareSize: z21.enum(["width", "height", "both"]).optional(),
-      interactive: z21.boolean().optional(),
+    elementSchema = z22.object({
+      id: z22.string().min(1).max(300),
+      selector: z22.string().max(500).optional(),
+      tag: z22.string().max(80).optional(),
+      role: z22.string().max(80).optional(),
+      label: z22.string().max(160).optional(),
+      parentId: z22.string().max(300).optional(),
+      groupId: z22.string().max(300).optional(),
+      alignmentGroup: z22.string().max(300).optional(),
+      alignmentEdge: z22.enum(["left", "right", "top", "bottom", "center-x", "center-y"]).optional(),
+      expectedSymmetry: z22.enum(["horizontal", "vertical", "both"]).optional(),
+      compareSize: z22.enum(["width", "height", "both"]).optional(),
+      interactive: z22.boolean().optional(),
       rect: rectSchema,
       style: styleSchema.optional(),
       lineCount: finiteNumber.int().positive().optional(),
@@ -26983,44 +27414,45 @@ var init_inspection_tools = __esm({
       scrollWidth: finiteNumber.nonnegative().optional(),
       scrollHeight: finiteNumber.nonnegative().optional()
     });
-    screenshotSchema = z21.string().max(5e6).regex(/^data:image\/(?:png|jpeg|webp);base64,/, "Use a PNG, JPEG, or WebP data URL.");
-    spacingStateSchema = z21.object({
-      name: z21.string().min(1).max(100),
-      viewport: z21.object({
+    screenshotSchema = z22.string().max(5e6).regex(/^data:image\/(?:png|jpeg|webp);base64,/, "Use a PNG, JPEG, or WebP data URL.");
+    spacingStateSchema = z22.object({
+      name: z22.string().min(1).max(100),
+      viewport: z22.object({
         width: finiteNumber.positive().max(2e4),
         height: finiteNumber.positive().max(2e4),
         devicePixelRatio: finiteNumber.positive().max(10).optional()
       }),
-      elements: z21.array(elementSchema).max(1500),
+      elements: z22.array(elementSchema).max(1500),
       screenshotDataUrl: screenshotSchema.optional().describe("Optional browser screenshot as a data URL. It remains in the structured evidence for report renderers and is not persisted.")
     });
-    evidenceSchema = z21.object({
-      label: z21.string(),
-      value: z21.union([z21.number(), z21.string()]),
-      unit: z21.enum(["px", "count"]).optional()
+    evidenceSchema = z22.object({
+      label: z22.string(),
+      value: z22.union([z22.number(), z22.string()]),
+      unit: z22.enum(["px", "count"]).optional()
     });
-    findingSchema = z21.object({
-      id: z21.string(),
-      ruleId: z21.string(),
-      state: z21.string(),
-      severity: z21.enum(["critical", "serious", "moderate"]),
-      message: z21.string(),
-      fix: z21.string(),
-      elementIds: z21.array(z21.string()),
-      evidence: z21.array(evidenceSchema)
+    findingSchema = z22.object({
+      id: z22.string(),
+      ruleId: z22.string(),
+      state: z22.string(),
+      severity: z22.enum(["critical", "serious", "moderate"]),
+      message: z22.string(),
+      fix: z22.string(),
+      elementIds: z22.array(z22.string()),
+      evidence: z22.array(evidenceSchema)
     });
-    overlayStateSchema = z21.object({
-      name: z21.string(),
-      viewport: z21.object({
-        width: z21.number(),
-        height: z21.number(),
-        devicePixelRatio: z21.number().optional()
+    overlayStateSchema = z22.object({
+      name: z22.string(),
+      viewport: z22.object({
+        width: z22.number(),
+        height: z22.number(),
+        devicePixelRatio: z22.number().optional()
       }),
-      elements: z21.array(z21.object({ id: z21.string(), label: z21.string().optional(), rect: rectSchema })),
-      screenshotDataUrl: z21.string().optional()
+      elements: z22.array(z22.object({ id: z22.string(), label: z22.string().optional(), rect: rectSchema })),
+      screenshotDataUrl: z22.string().optional()
     });
     RECOMMENDED_VIEWPORT_WIDTHS = [390, 1440, 1728];
     WIDTH_TOLERANCE = 40;
+    GEOMETRY_ONLY = "This measured geometry only. A clean result or a score of 100 is not visual approval: it cannot judge hierarchy, density or whether the design works.";
   }
 });
 
@@ -27059,7 +27491,7 @@ var init_inspection_resource = __esm({
 });
 
 // ../shared/src/mcp/tools/dashboard-review-tools.ts
-import { z as z22 } from "zod";
+import { z as z23 } from "zod";
 function finding(id, severity, message, fix) {
   return { id, severity, message, fix };
 }
@@ -27566,11 +27998,11 @@ function registerDashboardReviewTools({ server, track }) {
 Pass the complete page module source, the unchanged fixture, the factual interpretation, and the installed Sidebar, StatCard, and Table source files. Never summarize, reconstruct, or submit only the overview component. The tool derives the overview contract from the fixture. It fails incomplete source, rewritten copy, unsupported claims, weak hierarchy, missing or under-composed installed components, raw aside/table markup, the wrong scan order, action color on every rate, and stepper rails on short flows.
 
 FAIL is blocking and returns an MCP tool error. Fix every finding and call the tool again until PASS. Then run check-comprehension and inspect-spacing, and call finalize-dashboard-review. Only its VALID source-bound receipt permits presentation.`,
-      inputSchema: z22.object({
-        screen: z22.string().trim().min(1).max(120).describe("What this dashboard is, e.g. 'funnel report overview'."),
-        source: z22.string().min(1).max(12e4).describe("Complete TSX or JSX source for the dashboard page."),
+      inputSchema: z23.object({
+        screen: z23.string().trim().min(1).max(120).describe("What this dashboard is, e.g. 'funnel report overview'."),
+        source: z23.string().min(1).max(12e4).describe("Complete TSX or JSX source for the dashboard page."),
         fixture: dashboardFixtureSchema.describe("The request's unchanged fixture object. The first step is the overview; remaining steps are dependent task screens."),
-        interpretation: z22.string().trim().min(1).max(2e3).describe("Exact supplied or factually derived takeaway that must appear after records."),
+        interpretation: z23.string().trim().min(1).max(2e3).describe("Exact supplied or factually derived takeaway that must appear after records."),
         componentSources: dashboardComponentSourcesSchema.optional().describe("Installed Sidebar, StatCard, and Table source files for compound-composition review."),
         context: CONTEXT_ARG
       }),
@@ -27618,34 +28050,34 @@ var init_dashboard_review_tools = __esm({
     "use strict";
     init_review_capture();
     init_shared();
-    dashboardFixtureSchema = z22.object({
-      stats: z22.array(z22.object({
-        label: z22.string().trim().min(1).max(300),
-        value: z22.string().trim().min(1).max(300)
+    dashboardFixtureSchema = z23.object({
+      stats: z23.array(z23.object({
+        label: z23.string().trim().min(1).max(300),
+        value: z23.string().trim().min(1).max(300)
       })).max(100).optional(),
-      records: z22.array(z22.object({
-        title: z22.string().trim().min(1).max(300),
-        detail: z22.string().trim().min(1).max(1e3),
-        meta: z22.string().trim().min(1).max(300),
-        status: z22.string().trim().min(1).max(300)
+      records: z23.array(z23.object({
+        title: z23.string().trim().min(1).max(300),
+        detail: z23.string().trim().min(1).max(1e3),
+        meta: z23.string().trim().min(1).max(300),
+        status: z23.string().trim().min(1).max(300)
       })).max(100).optional(),
-      steps: z22.array(z22.object({
-        title: z22.string().trim().min(1).max(300),
-        description: z22.string().trim().min(1).max(1e3),
-        action: z22.string().trim().min(1).max(200)
+      steps: z23.array(z23.object({
+        title: z23.string().trim().min(1).max(300),
+        description: z23.string().trim().min(1).max(1e3),
+        action: z23.string().trim().min(1).max(200)
       })).min(2).max(50)
     });
-    dashboardComponentSourcesSchema = z22.object({
-      sidebar: z22.string().min(1).max(12e4),
-      statCard: z22.string().min(1).max(12e4),
-      table: z22.string().min(1).max(12e4)
+    dashboardComponentSourcesSchema = z23.object({
+      sidebar: z23.string().min(1).max(12e4),
+      statCard: z23.string().min(1).max(12e4),
+      table: z23.string().min(1).max(12e4)
     });
   }
 });
 
 // ../shared/src/mcp/tools/final-ui-review-tools.ts
 import { createHash as createHash2 } from "crypto";
-import { z as z23 } from "zod";
+import { z as z24 } from "zod";
 function digest(value) {
   return createHash2("sha256").update(value).digest("hex");
 }
@@ -27656,7 +28088,9 @@ function comprehensionFindings(input) {
   const report = analyzeComprehension({
     screen: input.screen,
     code: input.visibleSource,
-    knownTerms: input.knownTerms
+    knownTerms: input.knownTerms,
+    // A dashboard is a screen even when its name mentions slides. [BD-593]
+    surface: "screen"
   });
   return report.findings.flatMap(
     (item, index2) => item.severity === "minor" ? [] : [
@@ -28057,15 +28491,15 @@ function registerFinalUiReviewTools({
       description: `Issue a source-bound receipt for a completed dashboard.
 
 Submit the public HTTPS preview plus exact source, unchanged data, and installed components. Better Design's own browser captures the deployed page at 390, 1440, and 1728 pixels and content-addresses the live deployment. No trusted browser capture means incomplete. The review blocks weak hierarchy, under-composed components, hidden fixture fields, unclear copy, spacing defects, unsupported interpretations, or source edits.`,
-      inputSchema: z23.object({
-        screen: z23.string().trim().min(1).max(120),
-        previewUrl: z23.string().url().max(2048).refine((value) => new URL(value).protocol === "https:", {
+      inputSchema: z24.object({
+        screen: z24.string().trim().min(1).max(120),
+        previewUrl: z24.string().url().max(2048).refine((value) => new URL(value).protocol === "https:", {
           message: "Use a public HTTPS preview URL."
         }).describe("Public HTTPS URL for the exact deployed dashboard route."),
-        source: z23.string().min(1).max(24e4).describe(
+        source: z24.string().min(1).max(24e4).describe(
           "Complete TSX or JSX page source, including its default export."
         ),
-        visibleSource: z23.string().min(1).max(12e4).describe(
+        visibleSource: z24.string().min(1).max(12e4).describe(
           "Exact visible screen component copied unchanged from source."
         ),
         fixture: dashboardFixtureSchema.describe(
@@ -28074,7 +28508,7 @@ Submit the public HTTPS preview plus exact source, unchanged data, and installed
         componentSources: dashboardComponentSourcesSchema.describe(
           "Exact installed Sidebar, StatCard, and Table component source files."
         ),
-        knownTerms: z23.array(z23.string().trim().min(1).max(60)).max(50).optional(),
+        knownTerms: z24.array(z24.string().trim().min(1).max(60)).max(50).optional(),
         context: CONTEXT_ARG
       }),
       annotations: READ_ONLY_OPEN_WORLD_TOOL_ANNOTATIONS
@@ -28145,7 +28579,7 @@ var init_final_ui_review_tools = __esm({
 });
 
 // ../shared/src/mcp/tools/widget-tools.ts
-import { z as z24 } from "zod";
+import { z as z25 } from "zod";
 function hasIntake(args) {
   return Boolean(args.widgetType || INTAKE_FIELDS.some(({ key }) => args[key]));
 }
@@ -28268,16 +28702,16 @@ var init_widget_tools = __esm({
     WIDGET_GUIDE_TOPIC = "better-widgets";
     WIDGET_GUIDE_TOOL = "get-widget-guide";
     MINIMUM_CONTRACT_HEADING = "## Minimum build contract";
-    WIDGET_GUIDE_INPUT_SCHEMA = z24.object({
-      widgetType: z24.enum(BETTER_WIDGET_TYPES).optional().describe("Widget kind: calculator, estimator, converter, generator, quiz, or checklist."),
-      userGoal: z24.string().trim().min(1).max(500).optional().describe("Who will use the widget and the decision or task it helps them complete."),
-      inputs: z24.string().trim().min(1).max(1e3).optional().describe("Required inputs, including units, allowed ranges, and defaults."),
-      interaction: z24.string().trim().min(1).max(750).optional().describe("How readers tune inputs and see feedback, including presets, custom controls, direct manipulation, and exact-value entry."),
-      transformation: z24.string().trim().min(1).max(1500).optional().describe("Formula, scoring rule, conversion, or transformation that produces the result."),
-      result: z24.string().trim().min(1).max(750).optional().describe("What the result shows, explains, and lets the user do next."),
-      hostFramework: z24.string().trim().min(1).max(300).optional().describe("The host framework and the page or component that will contain the widget."),
-      visualContext: z24.string().trim().min(1).max(750).optional().describe("Existing design tokens, components, or brand reference the widget must match."),
-      maxTokens: z24.number().min(2e3).max(5e4).optional().describe("Maximum tokens to return. Truncates content to fit. Recommended: 5000-10000."),
+    WIDGET_GUIDE_INPUT_SCHEMA = z25.object({
+      widgetType: z25.enum(BETTER_WIDGET_TYPES).optional().describe("Widget kind: calculator, estimator, converter, generator, quiz, or checklist."),
+      userGoal: z25.string().trim().min(1).max(500).optional().describe("Who will use the widget and the decision or task it helps them complete."),
+      inputs: z25.string().trim().min(1).max(1e3).optional().describe("Required inputs, including units, allowed ranges, and defaults."),
+      interaction: z25.string().trim().min(1).max(750).optional().describe("How readers tune inputs and see feedback, including presets, custom controls, direct manipulation, and exact-value entry."),
+      transformation: z25.string().trim().min(1).max(1500).optional().describe("Formula, scoring rule, conversion, or transformation that produces the result."),
+      result: z25.string().trim().min(1).max(750).optional().describe("What the result shows, explains, and lets the user do next."),
+      hostFramework: z25.string().trim().min(1).max(300).optional().describe("The host framework and the page or component that will contain the widget."),
+      visualContext: z25.string().trim().min(1).max(750).optional().describe("Existing design tokens, components, or brand reference the widget must match."),
+      maxTokens: z25.number().min(2e3).max(5e4).optional().describe("Maximum tokens to return. Truncates content to fit. Recommended: 5000-10000."),
       context: CONTEXT_ARG
     });
     INTAKE_FIELDS = [
@@ -28331,7 +28765,7 @@ The completed response combines a scoped build brief with Better Design's stable
 });
 
 // ../shared/src/mcp/feature-map/schema.ts
-import { z as z25 } from "zod";
+import { z as z26 } from "zod";
 function oneLine(text3) {
   return text3.replace(/\s+/g, " ").trim();
 }
@@ -28366,38 +28800,38 @@ var init_schema3 = __esm({
     "use strict";
     FEATURE_MAP_PATH = ".better-design/feature-map.json";
     FEATURE_MAP_LIMITS = { features: 200, flows: 100, steps: 50, paths: 200, name: 120 };
-    NAME = z25.string().trim().min(1).max(FEATURE_MAP_LIMITS.name);
-    PATHS = z25.array(z25.string().trim().min(1).max(500)).max(FEATURE_MAP_LIMITS.paths).default([]);
-    featureMapStepSchema = z25.object({
+    NAME = z26.string().trim().min(1).max(FEATURE_MAP_LIMITS.name);
+    PATHS = z26.array(z26.string().trim().min(1).max(500)).max(FEATURE_MAP_LIMITS.paths).default([]);
+    featureMapStepSchema = z26.object({
       name: NAME,
       /** URL path such as `/settings/billing`. Absent for a dialog or an email. */
-      route: z25.string().trim().max(300).optional(),
+      route: z26.string().trim().max(300).optional(),
       /** The file that renders the step, such as the route's page file. */
-      screen: z25.string().trim().max(500).optional(),
+      screen: z26.string().trim().max(500).optional(),
       /** What the user does here, such as "confirms the cancellation". */
-      action: z25.string().trim().max(300).optional(),
+      action: z26.string().trim().max(300).optional(),
       components: PATHS,
       /** API routes, server actions, hooks and queries the step reads or writes. */
       data: PATHS
     });
-    featureMapFlowSchema = z25.object({
+    featureMapFlowSchema = z26.object({
       id: NAME,
       name: NAME,
-      description: z25.string().trim().max(500).optional(),
-      steps: z25.array(featureMapStepSchema).min(1).max(FEATURE_MAP_LIMITS.steps)
+      description: z26.string().trim().max(500).optional(),
+      steps: z26.array(featureMapStepSchema).min(1).max(FEATURE_MAP_LIMITS.steps)
     });
-    featureMapFeatureSchema = z25.object({
+    featureMapFeatureSchema = z26.object({
       id: NAME,
       name: NAME,
-      description: z25.string().trim().max(500).optional(),
-      flows: z25.array(featureMapFlowSchema).max(FEATURE_MAP_LIMITS.flows),
+      description: z26.string().trim().max(500).optional(),
+      flows: z26.array(featureMapFlowSchema).max(FEATURE_MAP_LIMITS.flows),
       /** Components that belong to the feature but to no single step. */
       components: PATHS
     });
-    featureMapSchema = z25.object({
-      version: z25.literal(1),
-      product: z25.string().trim().max(120).optional(),
-      features: z25.array(featureMapFeatureSchema).max(FEATURE_MAP_LIMITS.features)
+    featureMapSchema = z26.object({
+      version: z26.literal(1),
+      product: z26.string().trim().max(120).optional(),
+      features: z26.array(featureMapFeatureSchema).max(FEATURE_MAP_LIMITS.features)
     });
   }
 });
@@ -28675,7 +29109,7 @@ var init_read = __esm({
 });
 
 // ../shared/src/mcp/feature-map/update.ts
-import { z as z26 } from "zod";
+import { z as z27 } from "zod";
 function find(items, ref) {
   const r = ref.trim();
   const index2 = items.findIndex((i) => i.id === r || i.name.toLowerCase() === r.toLowerCase());
@@ -28738,21 +29172,21 @@ var init_update2 = __esm({
   "../shared/src/mcp/feature-map/update.ts"() {
     "use strict";
     init_schema3();
-    NAME2 = z26.string().trim().min(1).max(120);
-    REF = z26.string().trim().min(1).max(120).describe("The id or exact name of an existing feature or flow.");
+    NAME2 = z27.string().trim().min(1).max(120);
+    REF = z27.string().trim().min(1).max(120).describe("The id or exact name of an existing feature or flow.");
     FLOW_INPUT = featureMapFlowSchema.omit({ id: true });
-    featureMapChangeSchema = z26.discriminatedUnion("op", [
-      z26.object({
-        op: z26.literal("add-feature"),
+    featureMapChangeSchema = z27.discriminatedUnion("op", [
+      z27.object({
+        op: z27.literal("add-feature"),
         name: NAME2,
-        description: z26.string().trim().max(500).optional(),
-        flows: z26.array(FLOW_INPUT).max(100).optional()
+        description: z27.string().trim().max(500).optional(),
+        flows: z27.array(FLOW_INPUT).max(100).optional()
       }),
-      z26.object({ op: z26.literal("rename-feature"), feature: REF, name: NAME2 }),
-      z26.object({ op: z26.literal("remove-feature"), feature: REF }),
-      z26.object({ op: z26.literal("set-flow"), feature: REF, flow: FLOW_INPUT }),
-      z26.object({ op: z26.literal("rename-flow"), feature: REF, flow: REF, name: NAME2 }),
-      z26.object({ op: z26.literal("remove-flow"), feature: REF, flow: REF })
+      z27.object({ op: z27.literal("rename-feature"), feature: REF, name: NAME2 }),
+      z27.object({ op: z27.literal("remove-feature"), feature: REF }),
+      z27.object({ op: z27.literal("set-flow"), feature: REF, flow: FLOW_INPUT }),
+      z27.object({ op: z27.literal("rename-flow"), feature: REF, flow: REF, name: NAME2 }),
+      z27.object({ op: z27.literal("remove-flow"), feature: REF, flow: REF })
     ]);
     idTaken = (items, id, except2) => items.some((item, i) => item.id === id && i !== except2);
     toFlow = (f) => ({ id: slugify(f.name), ...f });
@@ -28771,7 +29205,7 @@ var init_feature_map = __esm({
 });
 
 // ../shared/src/mcp/tools/feature-map-tools.ts
-import { z as z27 } from "zod";
+import { z as z28 } from "zod";
 function registerFeatureMapTools({ server, tracked }) {
   server.registerTool(
     "build-feature-map",
@@ -28782,9 +29216,9 @@ function registerFeatureMapTools({ server, tracked }) {
 Run \`git ls-files\` in the repository and pass every path as \`files\`. Routes become screens (Next.js app and pages routers, Remix and React Router flat routes, SvelteKit, Nuxt), each chain of nested routes becomes a flow (/settings/billing/cancel is Settings \u2192 Billing \u2192 Cancel), and components, API routes, hooks and server actions join the step whose name they share.
 
 The result is a first draft. Write it to ${FEATURE_MAP_PATH}, show the user the flows, and ask which steps are missing: a dialog, an email or a background job has no route, so add those with update-feature-map (op "set-flow").`,
-      inputSchema: z27.object({
-        files: z27.array(z27.string().max(500)).min(1).max(5e4).describe("Every file path in the repository, relative to its root, as printed by `git ls-files`."),
-        product: z27.string().trim().max(120).optional().describe("The product's name, stored at the top of the map."),
+      inputSchema: z28.object({
+        files: z28.array(z28.string().max(500)).min(1).max(5e4).describe("Every file path in the repository, relative to its root, as printed by `git ls-files`."),
+        product: z28.string().trim().max(120).optional().describe("The product's name, stored at the top of the map."),
         context: CONTEXT_ARG
       }),
       annotations: READ_ONLY_TOOL_ANNOTATIONS
@@ -28814,11 +29248,11 @@ ${serializeFeatureMap(map).trimEnd()}
       description: `Find the flows a change touches, with the screen, route, components and data files of every step. ${WHEN_TO_USE}
 
 Pass \`flow\` ("cancel account"), \`feature\` ("billing") or \`file\` (a path you are about to edit) to narrow it. With no query it lists every flow.`,
-      inputSchema: z27.object({
+      inputSchema: z28.object({
         map: MAP_ARG,
-        feature: z27.string().trim().max(120).optional().describe("A feature id or part of its name."),
-        flow: z27.string().trim().max(120).optional().describe("A flow id or part of its name."),
-        file: z27.string().trim().max(500).optional().describe("A file path or route; returns every flow that uses it."),
+        feature: z28.string().trim().max(120).optional().describe("A feature id or part of its name."),
+        flow: z28.string().trim().max(120).optional().describe("A flow id or part of its name."),
+        file: z28.string().trim().max(500).optional().describe("A file path or route; returns every flow that uses it."),
         context: CONTEXT_ARG
       }),
       annotations: READ_ONLY_TOOL_ANNOTATIONS
@@ -28844,7 +29278,7 @@ Changes, one per call:
 - { op: "remove-flow", feature, flow }
 
 \`feature\` and \`flow\` take an id or an exact name. Write the returned file to ${FEATURE_MAP_PATH}.`,
-      inputSchema: z27.object({
+      inputSchema: z28.object({
         map: MAP_ARG,
         change: featureMapChangeSchema,
         context: CONTEXT_ARG
@@ -28866,7 +29300,7 @@ var init_feature_map_tools = __esm({
     "use strict";
     init_feature_map();
     init_shared();
-    MAP_ARG = z27.string().min(1).max(2e6).describe(`The exact contents of ${FEATURE_MAP_PATH}.`);
+    MAP_ARG = z28.string().min(1).max(2e6).describe(`The exact contents of ${FEATURE_MAP_PATH}.`);
     text2 = (body, isError = false) => ({
       content: [{ type: "text", text: body }],
       isError
@@ -28887,8 +29321,185 @@ var init_feature_map_tools = __esm({
   }
 });
 
+// ../shared/src/mcp/inspiration.ts
+import { z as z29 } from "zod";
+function describeSet(set) {
+  const heading = `## ${set.title}${set.category ? ` (${set.category})` : ""}`;
+  if (!set.notes) return heading;
+  const written = /* @__PURE__ */ new Date(`${set.notes.writtenAt}T00:00:00Z`);
+  const date2 = Number.isNaN(written.getTime()) ? set.notes.writtenAt : NOTE_DATE.format(written);
+  return [
+    heading,
+    `Headlines: ${set.notes.headline}`,
+    `Slide order: ${set.notes.order}`,
+    `Framing: ${set.notes.framing}`,
+    `Color: ${set.notes.color}`,
+    `Better Design's notes, written by a vision model from these screenshots on ${date2}. The listing may have changed since.`
+  ].join("\n");
+}
+var INSPIRATION_TYPES, MAX_INSPIRATION_LIMIT, noteSchema, inspirationNotesFileSchema, indexFileSchema, indexEntrySchema, inspirationIndexSchema, NOTE_DATE;
+var init_inspiration = __esm({
+  "../shared/src/mcp/inspiration.ts"() {
+    "use strict";
+    INSPIRATION_TYPES = ["app-store-screenshots"];
+    MAX_INSPIRATION_LIMIT = 6;
+    noteSchema = z29.object({
+      slug: z29.string(),
+      /** The day the note was written, as YYYY-MM-DD. A listing can change after it. */
+      writtenAt: z29.string(),
+      headline: z29.string(),
+      order: z29.string(),
+      framing: z29.string(),
+      color: z29.string()
+    });
+    inspirationNotesFileSchema = z29.object({
+      model: z29.string(),
+      notes: z29.array(noteSchema)
+    });
+    indexFileSchema = z29.object({
+      key: z29.string(),
+      type: z29.string(),
+      width: z29.number(),
+      height: z29.number()
+    });
+    indexEntrySchema = z29.object({
+      title: z29.string(),
+      slug: z29.string(),
+      category: z29.string().nullish(),
+      files: z29.array(indexFileSchema)
+    });
+    inspirationIndexSchema = z29.object({
+      entries: z29.array(indexEntrySchema)
+    });
+    NOTE_DATE = new Intl.DateTimeFormat("en-GB", { day: "numeric", month: "long", year: "numeric", timeZone: "UTC" });
+  }
+});
+
+// ../shared/src/mcp/tools/inspiration-tools.ts
+import { z as z30 } from "zod";
+function describeSets(result) {
+  const lines = result.sets.map((set, i) => {
+    const category = set.category ? `, ${set.category}` : "";
+    return `${i + 1}. ${set.title}${category}: ${set.images.length} screenshot${set.images.length === 1 ? "" : "s"} below`;
+  });
+  return [
+    `# App Store screenshot sets`,
+    "",
+    ...lines,
+    "",
+    "Each image follows the set it belongs to. Read each set for its headline style, slide order, device framing and color, then propose two or three directions for the user's own screenshots and let the user pick one."
+  ].join("\n");
+}
+function noMatch(result, category) {
+  const asked = category ? `No App Store screenshot sets match the category "${category}".` : "The library holds no App Store screenshot sets yet.";
+  return `${asked} Categories in the library: ${result.categories.join(", ")}.`;
+}
+function registerInspirationTools({ server, tracked }, readInspiration2) {
+  server.registerTool(
+    "get-inspiration",
+    {
+      title: "Get Inspiration",
+      description: `Send real reference designs from Better Design's library as images, so you can study how shipped products solved the same design problem before you design the user's own.
+
+Use it before designing App Store or Google Play screenshots: pass \`type: "app-store-screenshots"\`, and a \`category\` such as "Health & Fitness" when the user's app has one. Each set arrives as its title and category, followed by its first screenshots.
+
+Then propose two or three directions drawn from what the sets do (headline style, slide order, device framing, color), and let the user choose before you build anything.`,
+      inputSchema: z30.object({
+        type: z30.enum(INSPIRATION_TYPES).describe('The kind of reference to send. Today: "app-store-screenshots".'),
+        category: z30.string().trim().min(1).max(60).optional().describe('Optional App Store category, for example "Productivity" or "Health & Fitness". Ignores case.'),
+        limit: z30.number().int().min(1).max(MAX_INSPIRATION_LIMIT).optional().describe(`How many sets to send, 1 to ${MAX_INSPIRATION_LIMIT}. Defaults to 3.`),
+        context: CONTEXT_ARG
+      }),
+      annotations: READ_ONLY_TOOL_ANNOTATIONS
+    },
+    async ({ type, category, limit, context }) => tracked("get-inspiration", { type, category: category ?? null, limit: limit ?? null, context }, async () => {
+      if (!readInspiration2) return { content: [{ type: "text", text: NOT_AVAILABLE }] };
+      const result = await readInspiration2({ type, category, limit });
+      if (result.sets.length === 0) {
+        return { content: [{ type: "text", text: noMatch(result, category) }] };
+      }
+      return {
+        content: [
+          { type: "text", text: describeSets(result) },
+          ...result.sets.flatMap((set) => [
+            { type: "text", text: describeSet(set) },
+            ...set.images.map((image) => ({
+              type: "image",
+              data: image.data,
+              mimeType: image.mimeType
+            }))
+          ])
+        ]
+      };
+    })
+  );
+}
+var NOT_AVAILABLE;
+var init_inspiration_tools = __esm({
+  "../shared/src/mcp/tools/inspiration-tools.ts"() {
+    "use strict";
+    init_shared();
+    init_inspiration();
+    NOT_AVAILABLE = "The inspiration library is not available from this server. Try again with the hosted Better Design MCP server or the latest `better-design` npm package.";
+  }
+});
+
+// ../shared/src/mcp/tools/feedback-tools.ts
+function createFeedbackSender(apiFetch, apiKey) {
+  return async (report) => {
+    const res = await apiFetch(`${APP_BASE_URL}/api/v1/feedback`, {
+      method: "POST",
+      headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
+      body: JSON.stringify(report),
+      signal: AbortSignal.timeout(15e3)
+    });
+    const body = await res.json().catch(() => ({}));
+    if (!res.ok || !body.id) throw new Error(body.message ?? `HTTP ${res.status}`);
+    return { id: body.id, status: body.status ?? "open", message: body.message ?? "" };
+  };
+}
+function registerFeedbackTools({ server, tracked }, sendFeedback) {
+  if (!sendFeedback) return;
+  server.registerTool(
+    "send-feedback",
+    {
+      title: "Send Feedback",
+      description: `Tell Better Design about a bug, a missing feature or wrong output you hit while using its tools or API. A person reads every report and approves any fix.
+
+Send one report per problem, once you have finished what the user asked. Say what you tried, what you expected and what came back. Leave out secrets, personal data and the user's private code. Sending a report never spends credit.`,
+      inputSchema: reportSchema,
+      // Each call stores one new report and publishes nothing. See
+      // `docs/mcp-tool-annotations.md`.
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false
+      }
+    },
+    // Usage telemetry records the kind only. The report itself goes to the queue.
+    async (report) => tracked("send-feedback", { kind: report.kind }, async () => {
+      const info = server.server.getClientVersion();
+      const client = info ? `${info.name}/${info.version}`.slice(0, AGENT_FEEDBACK_CLIENT_MAX) : void 0;
+      const receipt = await sendFeedback({ ...report, client });
+      return {
+        content: [{ type: "text", text: `Report ${receipt.id} sent. ${receipt.message}` }]
+      };
+    })
+  );
+}
+var reportSchema;
+var init_feedback_tools = __esm({
+  "../shared/src/mcp/tools/feedback-tools.ts"() {
+    "use strict";
+    init_agent_feedback();
+    init_shared();
+    reportSchema = agentFeedbackInputSchema.omit({ client: true });
+  }
+});
+
 // ../shared/src/mcp/tools.ts
-function registerAllTools(server, provider, onToolUsage, authContext, options = {}, apiFetch = globalThis.fetch, userId, captureDashboardBrowser2) {
+function registerAllTools(server, provider, onToolUsage, authContext, options = {}, apiFetch = globalThis.fetch, userId, captureDashboardBrowser2, readInspiration2, sendFeedback) {
   const { track, tracked } = createTracking(server, onToolUsage);
   const deps = {
     server,
@@ -28914,6 +29525,8 @@ function registerAllTools(server, provider, onToolUsage, authContext, options =
   registerInspectionTools(deps);
   registerFeatureMapTools(deps);
   registerTeamRulesTools(deps);
+  registerInspirationTools(deps, readInspiration2);
+  registerFeedbackTools(deps, sendFeedback);
   registerPreviewResource(deps);
   registerInspectionResource(deps);
 }
@@ -28937,6 +29550,8 @@ var init_tools = __esm({
     init_widget_tools();
     init_feature_map_tools();
     init_team_rules_tools();
+    init_inspiration_tools();
+    init_feedback_tools();
     init_shared();
   }
 });
@@ -28946,7 +29561,7 @@ var MCP_IMPLEMENTATION_VERSION;
 var init_version2 = __esm({
   "../shared/src/mcp/version.ts"() {
     "use strict";
-    MCP_IMPLEMENTATION_VERSION = "0.31.1";
+    MCP_IMPLEMENTATION_VERSION = "0.34.0";
   }
 });
 
@@ -28979,6 +29594,7 @@ __export(mcp_exports, {
   analyzeDashboardStructure: () => analyzeDashboardStructure,
   buildShopifyPrimitiveSet: () => buildShopifyPrimitiveSet,
   canonicalMcpToolName: () => canonicalMcpToolName,
+  createFeedbackSender: () => createFeedbackSender,
   createMcpServer: () => createMcpServer,
   declareAdvertisedSchemaDialect: () => declareAdvertisedSchemaDialect,
   deriveDashboardInterpretation: () => deriveDashboardInterpretation,
@@ -29011,7 +29627,9 @@ function createMcpServer(options) {
     apiFetch = globalThis.fetch,
     userId,
     captureDashboardBrowser: captureDashboardBrowser2,
-    directoryListing = false
+    directoryListing = false,
+    readInspiration: readInspiration2,
+    sendFeedback
   } = options;
   const server = new McpServer(
     { name, version: version2 },
@@ -29038,7 +29656,9 @@ function createMcpServer(options) {
     },
     apiFetch,
     userId,
-    captureDashboardBrowser2
+    captureDashboardBrowser2,
+    readInspiration2,
+    sendFeedback
   );
   return server;
 }
@@ -29055,6 +29675,7 @@ var init_mcp = __esm({
     init_advertised_schema();
     init_tool_names();
     init_principle_tools();
+    init_feedback_tools();
     init_instructions();
     init_session_guidance();
     init_shared();
@@ -29078,10 +29699,12 @@ __export(api_client_exports, {
   getSessionGuidance: () => getSessionGuidance,
   getTeamRules: () => getTeamRules,
   listPrinciples: () => listPrinciples,
+  readInspiration: () => readInspiration,
   searchDesignSystems: () => searchDesignSystems,
   searchIconLibraries: () => searchIconLibraries,
   searchIcons: () => searchIcons,
   searchPrinciples: () => searchPrinciples,
+  sendAgentFeedback: () => sendAgentFeedback,
   trackMcpInstalled: () => trackMcpInstalled,
   trackToolUsage: () => trackToolUsage
 });
@@ -29115,6 +29738,15 @@ function captureDashboardBrowser(input) {
     timeoutMs: 9e4
   });
 }
+function readInspiration(input) {
+  const params = new URLSearchParams({ type: input.type });
+  if (input.category) params.set("category", input.category);
+  if (input.limit !== void 0) params.set("limit", String(input.limit));
+  return request(`/v1/inspiration?${params}`, { timeoutMs: 3e4 });
+}
+function sendAgentFeedback(report) {
+  return request("/v1/feedback", { method: "POST", body: report });
+}
 async function searchDesignSystems(query, limit = 5) {
   return request(
     `/v1/design-systems/search?q=${encodeURIComponent(query)}&limit=${limit}`
@@ -31091,7 +31723,7 @@ var init_engine = __esm({
 });
 
 // ../shared/src/lint/config.ts
-import { z as z28 } from "zod";
+import { z as z31 } from "zod";
 function mergeReviewConfig(override) {
   if (!override) return DEFAULT_REVIEW_CONFIG;
   return {
@@ -31149,47 +31781,47 @@ var init_config = __esm({
         semanticTokens: { enabled: true }
       }
     };
-    reviewFlowStepSchema = z28.discriminatedUnion("action", [
-      z28.object({ action: z28.literal("click"), selector: z28.string() }),
-      z28.object({ action: z28.literal("type"), selector: z28.string(), value: z28.string() }),
-      z28.object({ action: z28.literal("press"), key: z28.string() }),
-      z28.object({ action: z28.literal("wait"), milliseconds: z28.number().finite().nonnegative() })
+    reviewFlowStepSchema = z31.discriminatedUnion("action", [
+      z31.object({ action: z31.literal("click"), selector: z31.string() }),
+      z31.object({ action: z31.literal("type"), selector: z31.string(), value: z31.string() }),
+      z31.object({ action: z31.literal("press"), key: z31.string() }),
+      z31.object({ action: z31.literal("wait"), milliseconds: z31.number().finite().nonnegative() })
     ]);
-    visualReviewConfigSchema = z28.object({
-      enabled: z28.boolean().optional(),
-      model: z28.object({
-        enabled: z28.boolean().optional(),
-        maxScreenshots: z28.number().int().nonnegative().optional()
+    visualReviewConfigSchema = z31.object({
+      enabled: z31.boolean().optional(),
+      model: z31.object({
+        enabled: z31.boolean().optional(),
+        maxScreenshots: z31.number().int().nonnegative().optional()
       }).optional(),
-      routes: z28.array(z28.string()).optional(),
-      viewports: z28.array(z28.enum(["desktop", "mobile", "reflow"])).optional(),
-      flows: z28.array(z28.object({
-        name: z28.string(),
-        persona: z28.string(),
-        path: z28.string().optional(),
-        steps: z28.array(reviewFlowStepSchema)
+      routes: z31.array(z31.string()).optional(),
+      viewports: z31.array(z31.enum(["desktop", "mobile", "reflow"])).optional(),
+      flows: z31.array(z31.object({
+        name: z31.string(),
+        persona: z31.string(),
+        path: z31.string().optional(),
+        steps: z31.array(reviewFlowStepSchema)
       })).optional(),
-      componentGallery: z28.object({
-        enabled: z28.boolean().optional(),
-        componentSelector: z28.string().optional(),
-        canvasSelector: z28.string().optional(),
-        labelSelector: z28.string().optional(),
-        maxComponents: z28.number().int().nonnegative().optional()
+      componentGallery: z31.object({
+        enabled: z31.boolean().optional(),
+        componentSelector: z31.string().optional(),
+        canvasSelector: z31.string().optional(),
+        labelSelector: z31.string().optional(),
+        maxComponents: z31.number().int().nonnegative().optional()
       }).optional()
     });
-    reviewConfigOverrideSchema = z28.object({
-      designSystem: z28.string().optional(),
+    reviewConfigOverrideSchema = z31.object({
+      designSystem: z31.string().optional(),
       visual: visualReviewConfigSchema.optional(),
-      rules: z28.object({
-        elements: z28.record(z28.string(), z28.object({ use: z28.string(), from: z28.string() })).optional(),
-        tokens: z28.record(z28.string(), z28.string()).optional(),
-        wcag: z28.object({
-          enabled: z28.boolean().optional(),
-          severity: z28.enum(["all", "critical+serious"]).optional()
+      rules: z31.object({
+        elements: z31.record(z31.string(), z31.object({ use: z31.string(), from: z31.string() })).optional(),
+        tokens: z31.record(z31.string(), z31.string()).optional(),
+        wcag: z31.object({
+          enabled: z31.boolean().optional(),
+          severity: z31.enum(["all", "critical+serious"]).optional()
         }).optional(),
-        slop: z28.object({ enabled: z28.boolean().optional() }).optional(),
-        copy: z28.object({ enabled: z28.boolean().optional() }).optional(),
-        semanticTokens: z28.object({ enabled: z28.boolean().optional() }).optional()
+        slop: z31.object({ enabled: z31.boolean().optional() }).optional(),
+        copy: z31.object({ enabled: z31.boolean().optional() }).optional(),
+        semanticTokens: z31.object({ enabled: z31.boolean().optional() }).optional()
       }).optional()
     });
   }
@@ -31565,7 +32197,7 @@ __export(review_tool_exports, {
   isReviewableSourcePath: () => isReviewableSourcePath,
   registerReviewTool: () => registerReviewTool
 });
-import { z as z29 } from "zod";
+import { z as z32 } from "zod";
 function isReviewableSourcePath(path6) {
   return /\.(tsx|jsx|ts|js|css)$/i.test(path6);
 }
@@ -31589,11 +32221,11 @@ get-review-rules gives you the judgment rules to apply yourself. This tool is th
 This source reviewer cannot judge rendered hierarchy or semantic color roles. After it passes, inspect the rendered dashboard and confirm title \u2192 metrics \u2192 records \u2192 interpretation, distinct action and status colors, and that a stepper begins only after a task starts.
 
 Fix every critical and serious finding, then call it again on the fixed source. Findings feed the same loop as a human code review: read, fix, re-check.`,
-      inputSchema: z29.object({
-        files: z29.array(
-          z29.object({
-            path: z29.string().trim().min(1).max(400).describe("Repo-relative file path, e.g. components/signup-form.tsx."),
-            content: z29.string().max(MAX_FILE_CHARS).describe("The file's full source.")
+      inputSchema: z32.object({
+        files: z32.array(
+          z32.object({
+            path: z32.string().trim().min(1).max(400).describe("Repo-relative file path, e.g. components/signup-form.tsx."),
+            content: z32.string().max(MAX_FILE_CHARS).describe("The file's full source.")
           })
         ).min(1).max(MAX_FILES).describe("The .tsx, .jsx, .ts, .js, and .css files to review, as written."),
         context: CONTEXT_ARG
@@ -31654,7 +32286,7 @@ review-ui-code({ files: [{ path: "components/signup-form.tsx", content: "..." },
 });
 
 // ../shared/src/mcp/figma-prototype.ts
-import { z as z30 } from "zod";
+import { z as z33 } from "zod";
 function escapeHtml(value) {
   return value.replace(/[&<>"]/g, (char2) => ESCAPES.get(char2) ?? char2);
 }
@@ -31688,63 +32320,63 @@ var colorSchema, paintSchema, sizingSchema, baseSchema, prototypeNodeSchema, pro
 var init_figma_prototype = __esm({
   "../shared/src/mcp/figma-prototype.ts"() {
     "use strict";
-    colorSchema = z30.object({ r: z30.number(), g: z30.number(), b: z30.number(), a: z30.number() });
-    paintSchema = z30.object({ variable: z30.string().optional(), color: colorSchema.optional() });
-    sizingSchema = z30.enum(["FIXED", "HUG", "FILL"]);
-    baseSchema = z30.object({
-      name: z30.string(),
-      width: z30.number(),
-      height: z30.number(),
-      x: z30.number(),
-      y: z30.number(),
-      sizing: z30.object({ horizontal: sizingSchema, vertical: sizingSchema }).optional(),
-      absolute: z30.boolean().optional(),
-      opacity: z30.number().optional()
+    colorSchema = z33.object({ r: z33.number(), g: z33.number(), b: z33.number(), a: z33.number() });
+    paintSchema = z33.object({ variable: z33.string().optional(), color: colorSchema.optional() });
+    sizingSchema = z33.enum(["FIXED", "HUG", "FILL"]);
+    baseSchema = z33.object({
+      name: z33.string(),
+      width: z33.number(),
+      height: z33.number(),
+      x: z33.number(),
+      y: z33.number(),
+      sizing: z33.object({ horizontal: sizingSchema, vertical: sizingSchema }).optional(),
+      absolute: z33.boolean().optional(),
+      opacity: z33.number().optional()
     });
-    prototypeNodeSchema = z30.lazy(() => z30.discriminatedUnion("kind", [
+    prototypeNodeSchema = z33.lazy(() => z33.discriminatedUnion("kind", [
       baseSchema.extend({
-        kind: z30.literal("instance"),
-        auditKey: z30.string(),
-        systemId: z30.string(),
-        texts: z30.array(z30.string()),
-        mainTexts: z30.array(z30.string())
+        kind: z33.literal("instance"),
+        auditKey: z33.string(),
+        systemId: z33.string(),
+        texts: z33.array(z33.string()),
+        mainTexts: z33.array(z33.string())
       }),
       baseSchema.extend({
-        kind: z30.literal("frame"),
-        layout: z30.object({
-          direction: z30.enum(["HORIZONTAL", "VERTICAL"]),
-          gap: z30.number(),
-          padding: z30.tuple([z30.number(), z30.number(), z30.number(), z30.number()]),
-          primary: z30.enum(["MIN", "CENTER", "MAX", "SPACE_BETWEEN"]),
-          counter: z30.enum(["MIN", "CENTER", "MAX", "BASELINE"]),
-          wrap: z30.boolean().optional()
+        kind: z33.literal("frame"),
+        layout: z33.object({
+          direction: z33.enum(["HORIZONTAL", "VERTICAL"]),
+          gap: z33.number(),
+          padding: z33.tuple([z33.number(), z33.number(), z33.number(), z33.number()]),
+          primary: z33.enum(["MIN", "CENTER", "MAX", "SPACE_BETWEEN"]),
+          counter: z33.enum(["MIN", "CENTER", "MAX", "BASELINE"]),
+          wrap: z33.boolean().optional()
         }).optional(),
         fill: paintSchema.optional(),
-        stroke: z30.object({ paint: paintSchema, weight: z30.number() }).optional(),
-        radius: z30.number().optional(),
-        clips: z30.boolean().optional(),
-        children: z30.array(prototypeNodeSchema)
+        stroke: z33.object({ paint: paintSchema, weight: z33.number() }).optional(),
+        radius: z33.number().optional(),
+        clips: z33.boolean().optional(),
+        children: z33.array(prototypeNodeSchema)
       }),
       baseSchema.extend({
-        kind: z30.literal("text"),
-        characters: z30.string(),
-        fontSize: z30.number(),
-        fontWeight: z30.number(),
-        lineHeight: z30.number().optional(),
-        letterSpacing: z30.number().optional(),
-        fontFamily: z30.string().optional(),
-        align: z30.enum(["LEFT", "CENTER", "RIGHT", "JUSTIFIED"]),
+        kind: z33.literal("text"),
+        characters: z33.string(),
+        fontSize: z33.number(),
+        fontWeight: z33.number(),
+        lineHeight: z33.number().optional(),
+        letterSpacing: z33.number().optional(),
+        fontFamily: z33.string().optional(),
+        align: z33.enum(["LEFT", "CENTER", "RIGHT", "JUSTIFIED"]),
         fill: paintSchema.optional()
       }),
       baseSchema.extend({
-        kind: z30.literal("shape"),
-        svg: z30.string(),
-        reason: z30.string()
+        kind: z33.literal("shape"),
+        svg: z33.string(),
+        reason: z33.string()
       })
     ]));
-    prototypeRequestSchema = z30.object({
-      type: z30.literal("better-design-figma-prototype"),
-      id: z30.string(),
+    prototypeRequestSchema = z33.object({
+      type: z33.literal("better-design-figma-prototype"),
+      id: z33.string(),
       frame: prototypeNodeSchema
     });
     ESCAPES = /* @__PURE__ */ new Map([["&", "&amp;"], ["<", "&lt;"], [">", "&gt;"], ['"', "&quot;"]]);
@@ -31930,7 +32562,7 @@ var init_figma_model_prompt = __esm({
 });
 
 // ../shared/src/mcp/figma-model.ts
-import { z as z31 } from "zod";
+import { z as z34 } from "zod";
 function fenced(text3, language) {
   const match = text3.match(new RegExp("```" + language + "[^\\n]*\\n([\\s\\S]*?)```", "i"));
   return match ? match[1] : null;
@@ -32136,8 +32768,8 @@ var init_figma_model = __esm({
     init_figma_prototype();
     init_html_kit();
     init_preview_html();
-    unplacedSchema = z31.object({
-      unplaced: z31.array(z31.object({ name: z31.string(), reason: z31.string() }))
+    unplacedSchema = z34.object({
+      unplaced: z34.array(z34.object({ name: z34.string(), reason: z34.string() }))
     });
     UNSAFE_BLOCKS = /<(script|iframe|object|embed|noscript)\b[\s\S]*?(<\/\1[^>]*>|$)/gi;
     UNSAFE_TAGS = /<\/?(meta|link|base|form|style)\b[^>]*(>|$)/gi;
@@ -32238,7 +32870,7 @@ var init_figma_model_handoff = __esm({
 });
 
 // ../shared/src/mcp/figma-model-providers.ts
-import { z as z32 } from "zod";
+import { z as z35 } from "zod";
 function serverLabel(url) {
   try {
     const parsed = new URL(url);
@@ -32331,19 +32963,19 @@ var init_figma_model_providers = __esm({
     DEFAULT_LOCAL_MODEL = "gemma4:latest";
     DEFAULT_LOCAL_BASE_URL = "http://localhost:11434/v1";
     MAX_OUTPUT_TOKENS = 16e3;
-    chatReplySchema = z32.object({
-      choices: z32.array(z32.object({
-        message: z32.object({ content: z32.string().nullable().optional() }),
-        finish_reason: z32.string().nullable().optional()
+    chatReplySchema = z35.object({
+      choices: z35.array(z35.object({
+        message: z35.object({ content: z35.string().nullable().optional() }),
+        finish_reason: z35.string().nullable().optional()
       })).min(1),
-      usage: z32.object({ prompt_tokens: z32.number(), completion_tokens: z32.number() }).optional()
+      usage: z35.object({ prompt_tokens: z35.number(), completion_tokens: z35.number() }).optional()
     });
-    errorCodeSchema = z32.object({ code: z32.string() });
+    errorCodeSchema = z35.object({ code: z35.string() });
   }
 });
 
 // ../shared/src/mcp/figma-relay.ts
-import { z as z33 } from "zod";
+import { z as z36 } from "zod";
 function noPluginMessage() {
   return "No Figma plugin is connected. Open the Figma file, run Plugins, Development, Better Design, and leave the panel open.";
 }
@@ -32357,35 +32989,35 @@ var init_figma_relay = __esm({
     "use strict";
     init_figma_prototype();
     FIGMA_RELAY_PORT = 4397;
-    relayRequestSchema = z33.object({
-      id: z33.string(),
+    relayRequestSchema = z36.object({
+      id: z36.string(),
       /** A frame name as it reads in Figma. Omitted means the current selection. */
-      frame: z33.string().optional(),
+      frame: z36.string().optional(),
       /**
        * `model` asks for the serialized frame and its PNG instead of a rendered
        * page, so a model can rebuild a frame that holds no library component.
        * Omitted means the library path, unchanged. [BD-866]
        */
-      mode: z33.enum(["library", "model"]).optional()
+      mode: z36.enum(["library", "model"]).optional()
     });
-    relayResultSchema = z33.object({
-      id: z33.string(),
-      html: z33.string().optional(),
-      error: z33.string().optional(),
-      components: z33.number().optional(),
-      report: z33.array(z33.object({ name: z33.string(), reason: z33.string() })).default([]),
-      frame: z33.string().optional(),
+    relayResultSchema = z36.object({
+      id: z36.string(),
+      html: z36.string().optional(),
+      error: z36.string().optional(),
+      components: z36.number().optional(),
+      report: z36.array(z36.object({ name: z36.string(), reason: z36.string() })).default([]),
+      frame: z36.string().optional(),
       /** The frames the plugin found, so a missing name can say what is there. */
-      frames: z33.array(z33.string()).optional(),
+      frames: z36.array(z36.string()).optional(),
       /** Model mode: the serialized frame, for the model to rebuild. */
       tree: prototypeNodeSchema.optional(),
       /** Model mode: the frame's PNG export, base64. */
-      png: z33.string().optional()
+      png: z36.string().optional()
     });
-    relayHelloSchema = z33.object({
-      file: z33.string(),
+    relayHelloSchema = z36.object({
+      file: z36.string(),
       /** The design system the file holds, when the plugin knows it. */
-      system: z33.string().optional()
+      system: z36.string().optional()
     });
     POLL_HOLD_MS = 25e3;
     REQUEST_TIMEOUT_MS = 3e5;
@@ -32553,7 +33185,7 @@ __export(figma_prototype_tool_exports, {
 });
 import { mkdir as mkdir2, readFile, stat, writeFile as writeFile2 } from "fs/promises";
 import { dirname as dirname3, resolve as resolve2 } from "path";
-import { z as z34 } from "zod";
+import { z as z37 } from "zod";
 async function ensureRelay() {
   if (relay) return relay;
   starting ??= startFigmaRelay().then((started) => {
@@ -32613,30 +33245,30 @@ function registerFigmaPrototypeTool(server) {
         "yourself: the tool returns a prompt file and the frame's image, you write the answer to a file, and",
         "you call this tool again with frameId and answerPath so it checks the page and reports what is missing."
       ].join(" "),
-      inputSchema: z34.object({
-        frame: z34.string().optional().describe("The frame's name as it reads in Figma. Omit to use the current selection."),
-        outputPath: z34.string().optional().describe("Where to write the HTML. Relative paths resolve against the working directory."),
-        mode: z34.enum(["library", "model"]).optional().describe(
+      inputSchema: z37.object({
+        frame: z37.string().optional().describe("The frame's name as it reads in Figma. Omit to use the current selection."),
+        outputPath: z37.string().optional().describe("Where to write the HTML. Relative paths resolve against the working directory."),
+        mode: z37.enum(["library", "model"]).optional().describe(
           "library (the default) maps components from a Better Design library. model asks a model to rebuild a frame from any file."
         ),
-        system: z34.string().optional().describe("Model mode: the catalog design system to build with, as find-design-system names it."),
-        provider: z34.enum(["agent", "openai-compatible"]).optional().describe(
+        system: z37.string().optional().describe("Model mode: the catalog design system to build with, as find-design-system names it."),
+        provider: z37.enum(["agent", "openai-compatible"]).optional().describe(
           "Model mode: agent (the default) hands the frame to you to rebuild; openai-compatible calls a local server, Ollama by default."
         ),
-        model: z34.string().optional().describe(`Model mode with openai-compatible: the local model id. Defaults to ${DEFAULT_LOCAL_MODEL}.`),
-        frameId: z34.string().optional().describe("Model mode, second call: the frameId the first call returned."),
-        answerPath: z34.string().optional().describe("Model mode, second call: the file holding your answer, as the prompt file asks.")
+        model: z37.string().optional().describe(`Model mode with openai-compatible: the local model id. Defaults to ${DEFAULT_LOCAL_MODEL}.`),
+        frameId: z37.string().optional().describe("Model mode, second call: the frameId the first call returned."),
+        answerPath: z37.string().optional().describe("Model mode, second call: the file holding your answer, as the prompt file asks.")
       }),
-      outputSchema: z34.object({
-        status: z34.enum(["completed", "failed", "needs-answer"]),
-        message: z34.string(),
-        frameId: z34.string().optional(),
-        promptPath: z34.string().optional(),
-        imagePath: z34.string().optional(),
-        path: z34.string().optional(),
-        components: z34.number().optional(),
-        report: z34.array(z34.object({ name: z34.string(), reason: z34.string() })).optional(),
-        model: z34.string().optional()
+      outputSchema: z37.object({
+        status: z37.enum(["completed", "failed", "needs-answer"]),
+        message: z37.string(),
+        frameId: z37.string().optional(),
+        promptPath: z37.string().optional(),
+        imagePath: z37.string().optional(),
+        path: z37.string().optional(),
+        components: z37.number().optional(),
+        report: z37.array(z37.object({ name: z37.string(), reason: z37.string() })).optional(),
+        model: z37.string().optional()
       }),
       annotations: { readOnlyHint: false, openWorldHint: true }
     },
@@ -32858,6 +33490,8 @@ async function startServer() {
   const { createHttpDataProvider: createHttpDataProvider2 } = await Promise.resolve().then(() => (init_http_data_provider(), http_data_provider_exports));
   const {
     captureDashboardBrowser: captureDashboardBrowser2,
+    readInspiration: readInspiration2,
+    sendAgentFeedback: sendAgentFeedback2,
     trackToolUsage: trackToolUsage2,
     trackMcpInstalled: trackMcpInstalled2
   } = await Promise.resolve().then(() => (init_api_client(), api_client_exports));
@@ -32883,7 +33517,9 @@ async function startServer() {
     name: "DesignSystems",
     version: MCP_IMPLEMENTATION_VERSION2,
     onToolUsage,
-    captureDashboardBrowser: captureDashboardBrowser2
+    captureDashboardBrowser: captureDashboardBrowser2,
+    readInspiration: readInspiration2,
+    sendFeedback: sendAgentFeedback2
   });
   registerReviewTool2(server, onToolUsage);
   registerFigmaPrototypeTool2(server);