canicode 0.7.1 → 0.8.1

package/dist/mcp/server.js

@@ -959,6 +959,211 @@ async function loadFromApi(fileKey, nodeId, token) {
   };
 }
 
+// src/core/adapters/tailwind-parser.ts
+var SPACING_SCALE = {
+  "0": 0,
+  "px": 1,
+  "0.5": 2,
+  "1": 4,
+  "1.5": 6,
+  "2": 8,
+  "2.5": 10,
+  "3": 12,
+  "3.5": 14,
+  "4": 16,
+  "5": 20,
+  "6": 24,
+  "7": 28,
+  "8": 32,
+  "9": 36,
+  "10": 40,
+  "11": 44,
+  "12": 48,
+  "14": 56,
+  "16": 64,
+  "20": 80,
+  "24": 96,
+  "28": 112,
+  "32": 128,
+  "36": 144,
+  "40": 160,
+  "44": 176,
+  "48": 192,
+  "52": 208,
+  "56": 224,
+  "60": 240,
+  "64": 256,
+  "72": 288,
+  "80": 320,
+  "96": 384
+};
+function resolveSpacing(value) {
+  const arbMatch = value.match(/^\[(\d+(?:\.\d+)?)px\]$/);
+  if (arbMatch?.[1]) return parseFloat(arbMatch[1]);
+  return SPACING_SCALE[value];
+}
+function extractStylesFromClasses(classes) {
+  const styles = {};
+  const tokens = classes.split(/\s+/);
+  for (const token of tokens) {
+    if (token === "flex" || token === "flex-row") {
+      styles.layoutMode = "HORIZONTAL";
+    } else if (token === "flex-col") {
+      styles.layoutMode = "VERTICAL";
+    } else if (token === "absolute") {
+      styles.layoutPositioning = "ABSOLUTE";
+    } else if (token === "relative" || token === "static") {
+      styles.layoutPositioning = "AUTO";
+    } else if (token === "w-full") {
+      styles.layoutSizingHorizontal = "FILL";
+    } else if (token === "h-full") {
+      styles.layoutSizingVertical = "FILL";
+    } else if (token === "w-fit") {
+      styles.layoutSizingHorizontal = "HUG";
+    } else if (token === "h-fit") {
+      styles.layoutSizingVertical = "HUG";
+    } else if (token.match(/^w-\[.+\]$/) || token.match(/^w-\d/)) {
+      styles.layoutSizingHorizontal = "FIXED";
+    } else if (token.match(/^h-\[.+\]$/) || token.match(/^h-\d/)) {
+      styles.layoutSizingVertical = "FIXED";
+    } else if (token.startsWith("gap-")) {
+      const val = token.slice(4);
+      const px = resolveSpacing(val);
+      if (px !== void 0) styles.itemSpacing = px;
+    } else if (token.startsWith("p-") && !token.startsWith("pl-") && !token.startsWith("pr-") && !token.startsWith("pt-") && !token.startsWith("pb-") && !token.startsWith("px-") && !token.startsWith("py-")) {
+      const val = token.slice(2);
+      const px = resolveSpacing(val);
+      if (px !== void 0) {
+        styles.paddingLeft = px;
+        styles.paddingRight = px;
+        styles.paddingTop = px;
+        styles.paddingBottom = px;
+      }
+    } else if (token.startsWith("px-")) {
+      const px = resolveSpacing(token.slice(3));
+      if (px !== void 0) {
+        styles.paddingLeft = px;
+        styles.paddingRight = px;
+      }
+    } else if (token.startsWith("py-")) {
+      const px = resolveSpacing(token.slice(3));
+      if (px !== void 0) {
+        styles.paddingTop = px;
+        styles.paddingBottom = px;
+      }
+    } else if (token.startsWith("pl-")) {
+      const px = resolveSpacing(token.slice(3));
+      if (px !== void 0) styles.paddingLeft = px;
+    } else if (token.startsWith("pr-")) {
+      const px = resolveSpacing(token.slice(3));
+      if (px !== void 0) styles.paddingRight = px;
+    } else if (token.startsWith("pt-")) {
+      const px = resolveSpacing(token.slice(3));
+      if (px !== void 0) styles.paddingTop = px;
+    } else if (token.startsWith("pb-")) {
+      const px = resolveSpacing(token.slice(3));
+      if (px !== void 0) styles.paddingBottom = px;
+    } else if (token.startsWith("bg-[")) {
+      const colorMatch = token.match(/^bg-\[(.+)\]$/);
+      if (colorMatch?.[1]) {
+        const color = colorMatch[1];
+        if (!styles.fills) styles.fills = [];
+        if (color.startsWith("var(")) {
+          styles.fills.push({ type: "SOLID", color: {}, boundVariable: color });
+        } else {
+          styles.fills.push({ type: "SOLID", color: parseHexColor(color) });
+        }
+      }
+    } else if (token === "shadow" || token.startsWith("shadow-")) {
+      if (!styles.effects) styles.effects = [];
+      styles.effects.push({ type: "DROP_SHADOW" });
+    }
+  }
+  return styles;
+}
+function parseHexColor(hex) {
+  const clean = hex.replace("#", "");
+  if (clean.length === 6 || clean.length === 8) {
+    return {
+      r: parseInt(clean.slice(0, 2), 16) / 255,
+      g: parseInt(clean.slice(2, 4), 16) / 255,
+      b: parseInt(clean.slice(4, 6), 16) / 255,
+      a: clean.length === 8 ? parseInt(clean.slice(6, 8), 16) / 255 : 1
+    };
+  }
+  return { r: 0, g: 0, b: 0, a: 1 };
+}
+function extractRootClasses(code) {
+  const match = code.match(/className="([^"]+)"/);
+  return match?.[1] ?? "";
+}
+function extractAllClasses(code) {
+  const classes = [];
+  const regex = /className="([^"]+)"/g;
+  let match;
+  while ((match = regex.exec(code)) !== null) {
+    if (match[1]) classes.push(match[1]);
+  }
+  return classes;
+}
+function parseDesignContextCode(code) {
+  const rootClasses = extractRootClasses(code);
+  const rootStyles = extractStylesFromClasses(rootClasses);
+  const allClasses = extractAllClasses(code);
+  const aggregatedFills = [...rootStyles.fills ?? []];
+  const aggregatedEffects = [...rootStyles.effects ?? []];
+  for (const cls of allClasses) {
+    const styles = extractStylesFromClasses(cls);
+    if (styles.fills) {
+      for (const fill of styles.fills) aggregatedFills.push(fill);
+    }
+    if (styles.effects) {
+      for (const effect of styles.effects) aggregatedEffects.push(effect);
+    }
+  }
+  return {
+    ...rootStyles,
+    ...aggregatedFills.length > 0 ? { fills: aggregatedFills } : {},
+    ...aggregatedEffects.length > 0 ? { effects: aggregatedEffects } : {}
+  };
+}
+function parseCodeHeader(code) {
+  const headerMatch = code.match(/\/\*\s*(.+?)\s*\*\//);
+  if (!headerMatch?.[1]) return {};
+  const header = headerMatch[1];
+  const result = {};
+  const nameParts = header.split(" \u2014 ");
+  if (nameParts[0]) result.name = nameParts[0].trim();
+  const dimMatch = header.match(/(\d+)x(\d+)/);
+  if (dimMatch?.[1] && dimMatch[2]) {
+    result.width = parseInt(dimMatch[1]);
+    result.height = parseInt(dimMatch[2]);
+  }
+  const typeMatch = header.match(/\b(COMPONENT|FRAME|INSTANCE|GROUP|SECTION)\b/);
+  if (typeMatch?.[1]) result.type = typeMatch[1];
+  if (header.includes("no auto-layout")) {
+    result.hasAutoLayout = false;
+  } else if (header.includes("auto-layout")) {
+    result.hasAutoLayout = true;
+    if (header.includes("vertical auto-layout")) result.layoutDirection = "VERTICAL";
+    else if (header.includes("horizontal auto-layout")) result.layoutDirection = "HORIZONTAL";
+  }
+  return result;
+}
+function enrichNodeWithStyles(node, styles) {
+  if (styles.layoutMode && !node.layoutMode) node.layoutMode = styles.layoutMode;
+  if (styles.layoutPositioning && !node.layoutPositioning) node.layoutPositioning = styles.layoutPositioning;
+  if (styles.layoutSizingHorizontal && !node.layoutSizingHorizontal) node.layoutSizingHorizontal = styles.layoutSizingHorizontal;
+  if (styles.layoutSizingVertical && !node.layoutSizingVertical) node.layoutSizingVertical = styles.layoutSizingVertical;
+  if (styles.itemSpacing !== void 0 && node.itemSpacing === void 0) node.itemSpacing = styles.itemSpacing;
+  if (styles.paddingLeft !== void 0 && node.paddingLeft === void 0) node.paddingLeft = styles.paddingLeft;
+  if (styles.paddingRight !== void 0 && node.paddingRight === void 0) node.paddingRight = styles.paddingRight;
+  if (styles.paddingTop !== void 0 && node.paddingTop === void 0) node.paddingTop = styles.paddingTop;
+  if (styles.paddingBottom !== void 0 && node.paddingBottom === void 0) node.paddingBottom = styles.paddingBottom;
+  if (styles.fills && !node.fills) node.fills = styles.fills;
+  if (styles.effects && !node.effects) node.effects = styles.effects;
+}
+
 // src/core/adapters/figma-mcp-adapter.ts
 var TAG_TYPE_MAP = {
   canvas: "CANVAS",
@@ -1089,6 +1294,54 @@ function parseMcpMetadataXml(xml, fileKey, fileName) {
     styles: {}
   };
 }
+function enrichWithDesignContext(file, designContextCode, targetNodeId) {
+  const header = parseCodeHeader(designContextCode);
+  const styles = parseDesignContextCode(designContextCode);
+  if (header.hasAutoLayout === true && header.layoutDirection) {
+    if (!styles.layoutMode) styles.layoutMode = header.layoutDirection;
+  } else if (header.hasAutoLayout === false) {
+    delete styles.layoutMode;
+  }
+  if (targetNodeId) {
+    const node = findNodeById2(file.document, targetNodeId);
+    if (node) {
+      enrichNodeWithStyles(node, styles);
+      enrichChildrenFromCode(node, designContextCode);
+      return;
+    }
+  }
+  enrichNodeWithStyles(file.document, styles);
+  enrichChildrenFromCode(file.document, designContextCode);
+}
+function enrichChildrenFromCode(parent, code) {
+  if (!parent.children) return;
+  for (const child of parent.children) {
+    const escapedName = child.name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const commentPattern = new RegExp(
+      `\\{/\\*\\s*${escapedName}(?:\\s*\u2014[^*]*)?\\s*\\*/\\}\\s*\\n\\s*<\\w+[^>]*className="([^"]*)"`
+    );
+    const match = code.match(commentPattern);
+    if (match?.[1]) {
+      const childStyles = parseDesignContextCode(
+        `<div className="${match[1]}">`
+      );
+      enrichNodeWithStyles(child, childStyles);
+    }
+    if (child.children) {
+      enrichChildrenFromCode(child, code);
+    }
+  }
+}
+function findNodeById2(node, id) {
+  if (node.id === id) return node;
+  if (node.children) {
+    for (const child of node.children) {
+      const found = findNodeById2(child, id);
+      if (found) return found;
+    }
+  }
+  return void 0;
+}
 
 // src/core/engine/design-data-parser.ts
 function parseDesignData(data, fileKey, fileName) {
@@ -1338,617 +1591,162 @@ function renderGaugeSvg(pct, size, strokeW, grade) {
           </svg>`;
 }
 
-// src/core/report-html/index.ts
-function generateHtmlReport(file, result, scores, options) {
-  const screenshotMap = new Map(
-    (options?.nodeScreenshots ?? []).map((ns) => [ns.nodeId, ns])
-  );
-  const figmaToken = options?.figmaToken;
-  const quickWins = getQuickWins(result.issues, 5);
-  const issuesByCategory = groupIssuesByCategory(result.issues);
-  return `<!DOCTYPE html>
-<html lang="en" class="antialiased">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>CanICode Report \u2014 ${esc(file.name)}</title>
-  <script src="https://cdn.tailwindcss.com"></script>
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
-  <script>
-    tailwind.config = {
-      theme: {
-        extend: {
-          fontFamily: { sans: ['Inter', 'ui-sans-serif', 'system-ui', '-apple-system', 'sans-serif'] },
-          colors: {
-            border: 'hsl(240 5.9% 90%)',
-            ring: 'hsl(240 5.9% 10%)',
-            background: 'hsl(0 0% 100%)',
-            foreground: 'hsl(240 10% 3.9%)',
-            muted: { DEFAULT: 'hsl(240 4.8% 95.9%)', foreground: 'hsl(240 3.8% 46.1%)' },
-            card: { DEFAULT: 'hsl(0 0% 100%)', foreground: 'hsl(240 10% 3.9%)' },
-          },
-          borderRadius: { lg: '0.5rem', md: 'calc(0.5rem - 2px)', sm: 'calc(0.5rem - 4px)' },
-        }
-      }
-    }
-  </script>
-  <style>
-    details summary::-webkit-details-marker { display: none; }
-    details summary::marker { content: ""; }
-    details summary { list-style: none; }
-    .gauge-fill { transition: stroke-dashoffset 0.8s cubic-bezier(0.4,0,0.2,1); }
-    @media print {
-      .no-print { display: none !important; }
-      .topbar-print { position: static !important; background: white !important; color: hsl(240 10% 3.9%) !important; }
-    }
-  </style>
-</head>
-<body class="bg-muted font-sans text-foreground min-h-screen">
-
-  <!-- Top Bar -->
-  <header class="topbar-print sticky top-0 z-50 bg-zinc-950 text-white border-b border-zinc-800">
-    <div class="max-w-[960px] mx-auto px-6 py-3 flex items-center gap-4">
-      <span class="font-semibold text-sm tracking-tight">CanICode</span>
-      <span class="text-zinc-400 text-sm truncate">${esc(file.name)}</span>
-      <span class="ml-auto text-zinc-500 text-xs no-print">${(/* @__PURE__ */ new Date()).toLocaleDateString()}</span>
-    </div>
-  </header>
-
-  <main class="max-w-[960px] mx-auto px-6 pb-16">
-
-    <!-- Overall Score -->
-    <section class="flex flex-col items-center pt-12 pb-6">
-      ${renderGaugeSvg(scores.overall.percentage, 200, 10, scores.overall.grade)}
-      <div class="mt-3 text-center">
-        <span class="text-lg font-semibold">${scores.overall.percentage}</span>
-        <span class="text-muted-foreground text-sm ml-1">/ 100</span>
-      </div>
-      <p class="text-muted-foreground text-sm mt-1">Overall Score</p>
-    </section>
-
-    <!-- Category Gauges -->
-    <section class="bg-card border border-border rounded-lg shadow-sm p-6 mb-6">
-      <div class="grid grid-cols-3 sm:grid-cols-6 gap-4">
-${CATEGORIES.map((cat) => {
-    const cs = scores.byCategory[cat];
-    const desc = CATEGORY_DESCRIPTIONS[cat];
-    return `        <a href="#cat-${cat}" class="flex flex-col items-center group relative cursor-pointer no-underline text-foreground hover:opacity-80 transition-opacity">
-          ${renderGaugeSvg(cs.percentage, 100, 7)}
-          <span class="text-xs font-medium mt-2.5 text-center leading-tight">${CATEGORY_LABELS[cat]}</span>
-          <span class="text-[11px] text-muted-foreground">${cs.issueCount} issues</span>
-          <div class="absolute bottom-full mb-2 left-1/2 -translate-x-1/2 hidden group-hover:block bg-zinc-900 text-white text-xs px-3 py-2 rounded-md whitespace-nowrap z-10 shadow-lg pointer-events-none">
-            ${esc(desc)}
-            <div class="absolute top-full left-1/2 -translate-x-1/2 border-4 border-transparent border-t-zinc-900"></div>
-          </div>
-        </a>`;
-  }).join("\n")}
-      </div>
-    </section>
-
-    <!-- Issue Summary -->
-    <section class="bg-card border border-border rounded-lg shadow-sm p-4 mb-6">
-      <div class="flex flex-wrap items-center justify-center gap-6">
-        ${renderSummaryDot("bg-red-500", scores.summary.blocking, "Blocking")}
-        ${renderSummaryDot("bg-amber-500", scores.summary.risk, "Risk")}
-        ${renderSummaryDot("bg-zinc-400", scores.summary.missingInfo, "Missing Info")}
-        ${renderSummaryDot("bg-green-500", scores.summary.suggestion, "Suggestion")}
-        <div class="border-l border-border pl-6 flex items-center gap-2">
-          <span class="text-xl font-bold tracking-tight">${scores.summary.totalIssues}</span>
-          <span class="text-sm text-muted-foreground">Total</span>
-        </div>
-      </div>
-    </section>
-
-${quickWins.length > 0 ? renderOpportunities(quickWins, file.fileKey) : ""}
-
-    <!-- Categories -->
-    <div class="space-y-3">
-${CATEGORIES.map((cat) => renderCategory(cat, scores, issuesByCategory.get(cat) ?? [], file.fileKey, screenshotMap, figmaToken)).join("\n")}
-    </div>
-
-    <!-- Footer -->
-    <footer class="mt-12 pt-6 border-t border-border text-center">
-      <p class="text-sm text-muted-foreground">Generated by <span class="font-semibold text-foreground">CanICode</span></p>
-      <p class="text-xs text-muted-foreground/60 mt-1">${(/* @__PURE__ */ new Date()).toLocaleString()} \xB7 ${result.nodeCount} nodes \xB7 Max depth ${result.maxDepth}</p>
-    </footer>
-
-  </main>
-
-${figmaToken ? `  <script>
-    const FIGMA_TOKEN = '${figmaToken}';
-    async function postComment(btn) {
-      const fileKey = btn.dataset.fileKey;
-      const nodeId = btn.dataset.nodeId.replace(/-/g, ':');
-      const rule = btn.dataset.rule;
-      const message = btn.dataset.message;
-      const path = btn.dataset.path;
-      const fix = btn.dataset.fix;
-      const why = btn.dataset.why;
-      const impact = btn.dataset.impact;
-
-      const commentBody = '[CanICode] ' + rule + '\\n\\nFix: ' + fix + '\\nWhy: ' + why + '\\nImpact: ' + impact + '\\n\\n' + message + '\\nNode: ' + path;
+// package.json
+var version = "0.8.1";
+var AnalysisNodeTypeSchema = z.enum([
+  "DOCUMENT",
+  "CANVAS",
+  "FRAME",
+  "GROUP",
+  "SECTION",
+  "COMPONENT",
+  "COMPONENT_SET",
+  "INSTANCE",
+  "RECTANGLE",
+  "ELLIPSE",
+  "VECTOR",
+  "TEXT",
+  "LINE",
+  "BOOLEAN_OPERATION",
+  "STAR",
+  "REGULAR_POLYGON",
+  "SLICE",
+  "STICKY",
+  "SHAPE_WITH_TEXT",
+  "CONNECTOR",
+  "WIDGET",
+  "EMBED",
+  "LINK_UNFURL",
+  "TABLE",
+  "TABLE_CELL"
+]);
+var LayoutModeSchema = z.enum(["NONE", "HORIZONTAL", "VERTICAL"]);
+var LayoutAlignSchema = z.enum(["MIN", "CENTER", "MAX", "STRETCH", "INHERIT"]);
+var LayoutPositioningSchema = z.enum(["AUTO", "ABSOLUTE"]);
+var BaseAnalysisNodeSchema = z.object({
+  // Basic identification
+  id: z.string(),
+  name: z.string(),
+  type: AnalysisNodeTypeSchema,
+  visible: z.boolean().default(true),
+  // Layout analysis
+  layoutMode: LayoutModeSchema.optional(),
+  layoutAlign: LayoutAlignSchema.optional(),
+  layoutPositioning: LayoutPositioningSchema.optional(),
+  layoutSizingHorizontal: z.enum(["FIXED", "HUG", "FILL"]).optional(),
+  layoutSizingVertical: z.enum(["FIXED", "HUG", "FILL"]).optional(),
+  primaryAxisAlignItems: z.string().optional(),
+  counterAxisAlignItems: z.string().optional(),
+  itemSpacing: z.number().optional(),
+  paddingLeft: z.number().optional(),
+  paddingRight: z.number().optional(),
+  paddingTop: z.number().optional(),
+  paddingBottom: z.number().optional(),
+  // Size/position analysis
+  absoluteBoundingBox: z.object({
+    x: z.number(),
+    y: z.number(),
+    width: z.number(),
+    height: z.number()
+  }).nullable().optional(),
+  // Component analysis
+  componentId: z.string().optional(),
+  componentPropertyDefinitions: z.record(z.string(), z.unknown()).optional(),
+  componentProperties: z.record(z.string(), z.unknown()).optional(),
+  // Style/token analysis
+  styles: z.record(z.string(), z.string()).optional(),
+  fills: z.array(z.unknown()).optional(),
+  strokes: z.array(z.unknown()).optional(),
+  effects: z.array(z.unknown()).optional(),
+  // Variable binding analysis (design tokens)
+  boundVariables: z.record(z.string(), z.unknown()).optional(),
+  // Text analysis
+  characters: z.string().optional(),
+  style: z.record(z.string(), z.unknown()).optional(),
+  // Handoff analysis
+  devStatus: z.object({
+    type: z.enum(["NONE", "READY_FOR_DEV", "COMPLETED"]),
+    description: z.string().optional()
+  }).optional(),
+  // Naming analysis metadata
+  isAsset: z.boolean().optional()
+});
+var AnalysisNodeSchema = BaseAnalysisNodeSchema.extend({
+  children: z.lazy(() => AnalysisNodeSchema.array().optional())
+});
+z.object({
+  fileKey: z.string(),
+  name: z.string(),
+  lastModified: z.string(),
+  version: z.string(),
+  document: AnalysisNodeSchema,
+  components: z.record(
+    z.string(),
+    z.object({
+      key: z.string(),
+      name: z.string(),
+      description: z.string()
+    })
+  ),
+  styles: z.record(
+    z.string(),
+    z.object({
+      key: z.string(),
+      name: z.string(),
+      styleType: z.string()
+    })
+  )
+});
+var IssueSchema = z.object({
+  nodeId: z.string(),
+  nodePath: z.string(),
+  figmaDeepLink: z.string().url(),
+  ruleId: z.string(),
+  message: z.string(),
+  severity: SeveritySchema
+});
+var CategoryScoreSchema = z.object({
+  category: CategorySchema,
+  score: z.number().min(0).max(100),
+  maxScore: z.number().min(0).max(100),
+  issueCount: z.object({
+    error: z.number().int().min(0),
+    warning: z.number().int().min(0),
+    info: z.number().int().min(0)
+  })
+});
+var ReportMetadataSchema = z.object({
+  fileKey: z.string(),
+  fileName: z.string(),
+  analyzedAt: z.string().datetime(),
+  version: z.string()
+});
+z.object({
+  metadata: ReportMetadataSchema,
+  totalScore: z.number().min(0).max(100),
+  categoryScores: z.array(CategoryScoreSchema),
+  issues: z.array(IssueSchema),
+  summary: z.object({
+    totalNodes: z.number().int().min(0),
+    analyzedNodes: z.number().int().min(0),
+    errorCount: z.number().int().min(0),
+    warningCount: z.number().int().min(0),
+    infoCount: z.number().int().min(0)
+  })
+});
 
-      btn.disabled = true;
-      btn.textContent = 'Sending...';
+// src/core/rules/excluded-names.ts
+var EXCLUDED_NAME_PATTERN = /(badge|close|dismiss|overlay|float|fab|dot|indicator|corner|decoration|tag|status|notification|icon|ico|image|asset|filter|dim|dimmed|bg|background|logo|avatar|divider|separator|nav|navigation|gnb|header|footer|sidebar|toolbar|modal|dialog|popup|toast|tooltip|dropdown|menu|sticky|spinner|loader|cursor|cta|chatbot|thumb|thumbnail|tabbar|tab-bar|statusbar|status-bar)/i;
+function isExcludedName(name) {
+  return EXCLUDED_NAME_PATTERN.test(name);
+}
 
-      try {
-        const res = await fetch('https://api.figma.com/v1/files/' + fileKey + '/comments', {
-          method: 'POST',
-          headers: { 'X-FIGMA-TOKEN': FIGMA_TOKEN, 'Content-Type': 'application/json' },
-          body: JSON.stringify({ message: commentBody, client_meta: { node_id: nodeId, node_offset: { x: 0, y: 0 } } }),
-        });
-        if (!res.ok) throw new Error(await res.text());
-        btn.textContent = 'Sent \\u2713';
-        btn.classList.remove('hover:bg-muted');
-        btn.classList.add('text-green-600', 'border-green-500/30');
-      } catch (e) {
-        btn.textContent = 'Failed \\u2717';
-        btn.classList.remove('hover:bg-muted');
-        btn.classList.add('text-red-600', 'border-red-500/30');
-        btn.disabled = false;
-        console.error('Failed to post Figma comment:', e);
-      }
-    }
-  </script>` : ""}
-</body>
-</html>`;
+// src/core/rules/layout/index.ts
+function isContainerNode(node) {
+  return node.type === "FRAME" || node.type === "GROUP" || node.type === "COMPONENT";
 }
-function renderSummaryDot(dotClass, count, label) {
-  return `<div class="flex items-center gap-2">
-          <span class="w-2.5 h-2.5 rounded-full ${dotClass}"></span>
-          <span class="text-lg font-bold tracking-tight">${count}</span>
-          <span class="text-sm text-muted-foreground">${label}</span>
-        </div>`;
-}
-function renderOpportunities(issues, fileKey) {
-  const maxAbs = issues.reduce((m, i) => Math.max(m, Math.abs(i.calculatedScore)), 1);
-  return `
-    <!-- Opportunities -->
-    <section class="bg-card border border-border rounded-lg shadow-sm mb-6 overflow-hidden">
-      <div class="px-6 py-4 border-b border-border">
-        <h2 class="text-sm font-semibold flex items-center gap-2">
-          <span class="w-2 h-2 rounded-full bg-red-500"></span>
-          Opportunities
-        </h2>
-        <p class="text-xs text-muted-foreground mt-1">Top blocking issues \u2014 fix these first for the biggest improvement.</p>
-      </div>
-      <div class="divide-y divide-border">
-${issues.map((issue) => {
-    const def = issue.rule.definition;
-    const link = buildFigmaDeepLink(fileKey, issue.violation.nodeId);
-    const barW = Math.round(Math.abs(issue.calculatedScore) / maxAbs * 100);
-    return `        <div class="px-6 py-3 flex items-center gap-4 hover:bg-muted/50 transition-colors">
-          <div class="flex-1 min-w-0">
-            <div class="text-sm font-medium truncate">${esc(def.name)}</div>
-            <div class="text-xs text-muted-foreground truncate mt-0.5">${esc(issue.violation.message)}</div>
-          </div>
-          <div class="w-32 flex items-center gap-2 shrink-0">
-            <div class="flex-1 h-1.5 bg-muted rounded-full overflow-hidden">
-              <div class="h-full bg-red-500 rounded-full" style="width:${barW}%"></div>
-            </div>
-            <span class="text-xs font-medium text-red-600 w-12 text-right">${issue.calculatedScore}</span>
-          </div>
-          <a href="${link}" target="_blank" rel="noopener" class="text-xs text-muted-foreground hover:text-foreground shrink-0 no-print">Figma \u2192</a>
-        </div>`;
-  }).join("\n")}
-      </div>
-    </section>`;
-}
-function renderCategory(cat, scores, issues, fileKey, screenshotMap, figmaToken) {
-  const cs = scores.byCategory[cat];
-  const hasProblems = issues.some((i) => i.config.severity === "blocking" || i.config.severity === "risk");
-  const bySeverity = /* @__PURE__ */ new Map();
-  for (const sev of SEVERITY_ORDER) bySeverity.set(sev, []);
-  for (const issue of issues) bySeverity.get(issue.config.severity)?.push(issue);
-  return `
-      <details id="cat-${cat}" class="bg-card border border-border rounded-lg shadow-sm overflow-hidden group"${hasProblems ? " open" : ""}>
-        <summary class="px-5 py-3.5 flex items-center gap-3 cursor-pointer hover:bg-muted/50 transition-colors select-none">
-          <span class="inline-flex items-center justify-center w-10 h-6 rounded-md text-xs font-bold border ${scoreBadgeStyle(cs.percentage)}">${cs.percentage}</span>
-          <div class="flex-1 min-w-0">
-            <div class="text-sm font-semibold">${CATEGORY_LABELS[cat]}</div>
-            <div class="text-xs text-muted-foreground">${esc(CATEGORY_DESCRIPTIONS[cat])}</div>
-          </div>
-          <span class="text-xs text-muted-foreground">${cs.issueCount} issues</span>
-          <svg class="w-4 h-4 text-muted-foreground transition-transform group-open:rotate-180 shrink-0 no-print" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path d="M19 9l-7 7-7-7"/></svg>
-        </summary>
-        <div class="border-t border-border">
-${issues.length === 0 ? '          <div class="px-5 py-4 text-sm text-green-600 font-medium">No issues found</div>' : SEVERITY_ORDER.filter((sev) => (bySeverity.get(sev)?.length ?? 0) > 0).map((sev) => renderSeverityGroup(sev, bySeverity.get(sev) ?? [], fileKey, screenshotMap, figmaToken)).join("\n")}
-        </div>
-      </details>`;
-}
-function renderSeverityGroup(sev, issues, fileKey, screenshotMap, figmaToken) {
-  return `          <div class="px-5 py-3">
-            <div class="flex items-center gap-2 mb-2">
-              <span class="w-2 h-2 rounded-full ${severityDot(sev)}"></span>
-              <span class="text-xs font-semibold uppercase tracking-wider">${SEVERITY_LABELS[sev]}</span>
-              <span class="text-xs text-muted-foreground ml-auto">${issues.length}</span>
-            </div>
-            <div class="space-y-1">
-${issues.map((issue) => renderIssueRow(issue, fileKey, screenshotMap, figmaToken)).join("\n")}
-            </div>
-          </div>`;
-}
-function renderIssueRow(issue, fileKey, screenshotMap, figmaToken) {
-  const sev = issue.config.severity;
-  const def = issue.rule.definition;
-  const link = buildFigmaDeepLink(fileKey, issue.violation.nodeId);
-  const screenshot = screenshotMap.get(issue.violation.nodeId);
-  const screenshotHtml = screenshot ? `<div class="mt-3"><a href="${link}" target="_blank" rel="noopener"><img src="data:image/png;base64,${screenshot.screenshotBase64}" alt="${esc(screenshot.nodePath)}" class="max-w-[240px] border border-border rounded-md"></a></div>` : "";
-  return `              <details class="border border-border rounded-md overflow-hidden">
-                <summary class="flex items-center gap-2.5 px-3 py-2 text-sm cursor-pointer hover:bg-muted/50 transition-colors">
-                  <span class="w-1.5 h-1.5 rounded-full ${severityDot(sev)} shrink-0"></span>
-                  <span class="font-medium shrink-0">${esc(def.name)}</span>
-                  <span class="text-muted-foreground truncate text-xs flex-1">${esc(issue.violation.message)}</span>
-                  <span class="inline-flex items-center px-1.5 py-0.5 text-[10px] font-medium rounded border ${severityBadge(sev)} shrink-0">${issue.calculatedScore}</span>
-                </summary>
-                <div class="px-3 py-3 bg-muted/30 border-t border-border text-sm space-y-2">
-                  <div class="font-mono text-xs text-muted-foreground break-all">${esc(issue.violation.nodePath)}</div>
-                  <div class="text-muted-foreground leading-relaxed space-y-1">
-                    <p><span class="font-medium text-foreground">Why:</span> ${esc(def.why)}</p>
-                    <p><span class="font-medium text-foreground">Impact:</span> ${esc(def.impact)}</p>
-                    <p><span class="font-medium text-foreground">Fix:</span> ${esc(def.fix)}</p>
-                  </div>${screenshotHtml}
-                  <div class="flex items-center gap-2 mt-1 no-print">
-                    <a href="${link}" target="_blank" rel="noopener" class="inline-flex items-center gap-1 px-2.5 py-1 text-xs font-medium border border-border rounded-md hover:bg-muted transition-colors">Open in Figma <span>\u2192</span></a>${figmaToken ? `
-                    <button onclick="postComment(this)" data-file-key="${esc(fileKey)}" data-node-id="${esc(issue.violation.nodeId)}" data-rule="${esc(def.name)}" data-message="${esc(issue.violation.message)}" data-path="${esc(issue.violation.nodePath)}" data-fix="${esc(def.fix)}" data-why="${esc(def.why)}" data-impact="${esc(def.impact)}" class="inline-flex items-center gap-1 px-2.5 py-1 text-xs font-medium border border-border rounded-md hover:bg-muted transition-colors cursor-pointer">Comment on Figma</button>` : ""}
-                  </div>
-                </div>
-              </details>`;
-}
-function getQuickWins(issues, limit) {
-  return issues.filter((issue) => issue.config.severity === "blocking").sort((a, b) => a.calculatedScore - b.calculatedScore).slice(0, limit);
-}
-function groupIssuesByCategory(issues) {
-  const grouped = /* @__PURE__ */ new Map();
-  for (const category of CATEGORIES) grouped.set(category, []);
-  for (const issue of issues) grouped.get(issue.rule.definition.category).push(issue);
-  return grouped;
-}
-var esc = escapeHtml;
-var RuleOverrideSchema = z.object({
-  score: z.number().int().max(0).optional(),
-  severity: SeveritySchema.optional(),
-  enabled: z.boolean().optional()
-});
-var ConfigFileSchema = z.object({
-  excludeNodeTypes: z.array(z.string()).optional(),
-  excludeNodeNames: z.array(z.string()).optional(),
-  gridBase: z.number().int().positive().optional(),
-  colorTolerance: z.number().int().positive().optional(),
-  rules: z.record(z.string(), RuleOverrideSchema).optional()
-});
-async function loadConfigFile(filePath) {
-  const absPath = resolve(filePath);
-  const raw = await readFile(absPath, "utf-8");
-  const parsed = JSON.parse(raw);
-  return ConfigFileSchema.parse(parsed);
-}
-function mergeConfigs(base, overrides) {
-  const merged = { ...base };
-  if (overrides.gridBase !== void 0) {
-    for (const [id, config2] of Object.entries(merged)) {
-      if (config2.options && "gridBase" in config2.options) {
-        merged[id] = {
-          ...config2,
-          options: { ...config2.options, gridBase: overrides.gridBase }
-        };
-      }
-    }
-  }
-  if (overrides.colorTolerance !== void 0) {
-    for (const [id, config2] of Object.entries(merged)) {
-      if (config2.options && "tolerance" in config2.options) {
-        merged[id] = {
-          ...config2,
-          options: { ...config2.options, tolerance: overrides.colorTolerance }
-        };
-      }
-    }
-  }
-  if (overrides.rules) {
-    for (const [ruleId, override] of Object.entries(overrides.rules)) {
-      const existing = merged[ruleId];
-      if (existing) {
-        merged[ruleId] = {
-          ...existing,
-          ...override.score !== void 0 && { score: override.score },
-          ...override.severity !== void 0 && { severity: override.severity },
-          ...override.enabled !== void 0 && { enabled: override.enabled }
-        };
-      }
-    }
-  }
-  return merged;
-}
-var MatchConditionSchema = z.object({
-  // Node type conditions
-  type: z.array(z.string()).optional(),
-  notType: z.array(z.string()).optional(),
-  // Name conditions (case-insensitive, substring match)
-  nameContains: z.string().optional(),
-  nameNotContains: z.string().optional(),
-  namePattern: z.string().optional(),
-  // Size conditions
-  minWidth: z.number().optional(),
-  maxWidth: z.number().optional(),
-  minHeight: z.number().optional(),
-  maxHeight: z.number().optional(),
-  // Layout conditions
-  hasAutoLayout: z.boolean().optional(),
-  hasChildren: z.boolean().optional(),
-  minChildren: z.number().optional(),
-  maxChildren: z.number().optional(),
-  // Component conditions
-  isComponent: z.boolean().optional(),
-  isInstance: z.boolean().optional(),
-  hasComponentId: z.boolean().optional(),
-  // Visibility
-  isVisible: z.boolean().optional(),
-  // Fill/style conditions
-  hasFills: z.boolean().optional(),
-  hasStrokes: z.boolean().optional(),
-  hasEffects: z.boolean().optional(),
-  // Depth condition
-  minDepth: z.number().optional(),
-  maxDepth: z.number().optional()
-});
-var CustomRuleSchema = z.object({
-  id: z.string(),
-  category: CategorySchema,
-  severity: SeveritySchema,
-  score: z.number().int().max(0),
-  match: MatchConditionSchema,
-  message: z.string().optional(),
-  why: z.string(),
-  impact: z.string(),
-  fix: z.string(),
-  // Backward compat: silently ignore the old prompt field
-  prompt: z.string().optional()
-});
-var CustomRulesFileSchema = z.array(CustomRuleSchema);
-
-// src/core/rules/custom/custom-rule-loader.ts
-async function loadCustomRules(filePath) {
-  const absPath = resolve(filePath);
-  const raw = await readFile(absPath, "utf-8");
-  const parsed = JSON.parse(raw);
-  const customRules = CustomRulesFileSchema.parse(parsed);
-  const rules = [];
-  const configs = {};
-  for (const cr of customRules) {
-    if (!cr.match) continue;
-    rules.push(toRule(cr));
-    configs[cr.id] = {
-      severity: cr.severity,
-      score: cr.score,
-      enabled: true
-    };
-  }
-  return { rules, configs };
-}
-function toRule(cr) {
-  return {
-    definition: {
-      id: cr.id,
-      name: cr.id.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()),
-      category: cr.category,
-      why: cr.why,
-      impact: cr.impact,
-      fix: cr.fix
-    },
-    check: createPatternCheck(cr)
-  };
-}
-function createPatternCheck(cr) {
-  return (node, context) => {
-    if (node.type === "DOCUMENT" || node.type === "CANVAS") return null;
-    const match = cr.match;
-    if (match.type && !match.type.includes(node.type)) return null;
-    if (match.notType && match.notType.includes(node.type)) return null;
-    if (match.nameContains !== void 0 && !node.name.toLowerCase().includes(match.nameContains.toLowerCase())) return null;
-    if (match.nameNotContains !== void 0 && node.name.toLowerCase().includes(match.nameNotContains.toLowerCase())) return null;
-    if (match.namePattern !== void 0 && !new RegExp(match.namePattern, "i").test(node.name)) return null;
-    const bbox = node.absoluteBoundingBox;
-    if (match.minWidth !== void 0 && (!bbox || bbox.width < match.minWidth)) return null;
-    if (match.maxWidth !== void 0 && (!bbox || bbox.width > match.maxWidth)) return null;
-    if (match.minHeight !== void 0 && (!bbox || bbox.height < match.minHeight)) return null;
-    if (match.maxHeight !== void 0 && (!bbox || bbox.height > match.maxHeight)) return null;
-    if (match.hasAutoLayout === true && !node.layoutMode) return null;
-    if (match.hasAutoLayout === false && node.layoutMode) return null;
-    if (match.hasChildren === true && (!node.children || node.children.length === 0)) return null;
-    if (match.hasChildren === false && node.children && node.children.length > 0) return null;
-    if (match.minChildren !== void 0 && (!node.children || node.children.length < match.minChildren)) return null;
-    if (match.maxChildren !== void 0 && node.children && node.children.length > match.maxChildren) return null;
-    if (match.isComponent === true && node.type !== "COMPONENT" && node.type !== "COMPONENT_SET") return null;
-    if (match.isComponent === false && (node.type === "COMPONENT" || node.type === "COMPONENT_SET")) return null;
-    if (match.isInstance === true && node.type !== "INSTANCE") return null;
-    if (match.isInstance === false && node.type === "INSTANCE") return null;
-    if (match.hasComponentId === true && !node.componentId) return null;
-    if (match.hasComponentId === false && node.componentId) return null;
-    if (match.isVisible === true && !node.visible) return null;
-    if (match.isVisible === false && node.visible) return null;
-    if (match.hasFills === true && (!node.fills || node.fills.length === 0)) return null;
-    if (match.hasFills === false && node.fills && node.fills.length > 0) return null;
-    if (match.hasStrokes === true && (!node.strokes || node.strokes.length === 0)) return null;
-    if (match.hasStrokes === false && node.strokes && node.strokes.length > 0) return null;
-    if (match.hasEffects === true && (!node.effects || node.effects.length === 0)) return null;
-    if (match.hasEffects === false && node.effects && node.effects.length > 0) return null;
-    if (match.minDepth !== void 0 && context.depth < match.minDepth) return null;
-    if (match.maxDepth !== void 0 && context.depth > match.maxDepth) return null;
-    const msg = (cr.message ?? `"${node.name}" matched custom rule "${cr.id}"`).replace(/\{name\}/g, node.name).replace(/\{type\}/g, node.type);
-    return {
-      ruleId: cr.id,
-      nodeId: node.id,
-      nodePath: context.path.join(" > "),
-      message: msg
-    };
-  };
-}
-
-// src/core/monitoring/events.ts
-var EVENT_PREFIX = "cic_";
-var EVENTS = {
-  // Analysis
-  ANALYSIS_STARTED: `${EVENT_PREFIX}analysis_started`,
-  ANALYSIS_COMPLETED: `${EVENT_PREFIX}analysis_completed`,
-  ANALYSIS_FAILED: `${EVENT_PREFIX}analysis_failed`,
-  // Report
-  REPORT_GENERATED: `${EVENT_PREFIX}report_generated`,
-  COMMENT_POSTED: `${EVENT_PREFIX}comment_posted`,
-  COMMENT_FAILED: `${EVENT_PREFIX}comment_failed`,
-  // MCP
-  MCP_TOOL_CALLED: `${EVENT_PREFIX}mcp_tool_called`,
-  // CLI
-  CLI_COMMAND: `${EVENT_PREFIX}cli_command`,
-  CLI_INIT: `${EVENT_PREFIX}cli_init`
-};
-
-// src/core/monitoring/capture.ts
-var monitoringEnabled = false;
-var posthogApiKey;
-var sentryDsn;
-var distinctId = "anonymous";
-var environment = "unknown";
-var version = "unknown";
-var commonProps = {};
-function uuid4() {
-  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
-    const r = Math.random() * 16 | 0;
-    const v = c === "x" ? r : r & 3 | 8;
-    return v.toString(16);
-  });
-}
-function parseSentryDsn(dsn) {
-  try {
-    const url = new URL(dsn);
-    const key = url.username;
-    const projectId = url.pathname.slice(1);
-    const host = url.protocol + "//" + url.host;
-    if (!key || !projectId) return null;
-    return { key, host, projectId };
-  } catch {
-    return null;
-  }
-}
-function initCapture(config2) {
-  if (config2.enabled === false) return;
-  if (!config2.posthogApiKey && !config2.sentryDsn) return;
-  monitoringEnabled = true;
-  posthogApiKey = config2.posthogApiKey;
-  sentryDsn = config2.sentryDsn;
-  distinctId = config2.distinctId ?? "anonymous";
-  environment = config2.environment ?? "unknown";
-  version = config2.version ?? "unknown";
-  commonProps = {
-    _sdk: "canicode",
-    _sdk_version: version,
-    _env: environment
-  };
-}
-function captureEvent(event, properties) {
-  if (!monitoringEnabled || !posthogApiKey) return;
-  try {
-    fetch("https://us.i.posthog.com/i/v0/e/", {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        api_key: posthogApiKey,
-        event,
-        distinct_id: distinctId,
-        properties: { ...commonProps, ...properties },
-        timestamp: (/* @__PURE__ */ new Date()).toISOString()
-      })
-    }).catch(() => {
-    });
-  } catch {
-  }
-}
-function captureError(error, context) {
-  if (!monitoringEnabled) return;
-  if (sentryDsn) {
-    const parsed = parseSentryDsn(sentryDsn);
-    if (parsed) {
-      try {
-        const eventId = uuid4();
-        const envelope = [
-          JSON.stringify({ event_id: eventId, sent_at: (/* @__PURE__ */ new Date()).toISOString(), dsn: sentryDsn }),
-          JSON.stringify({ type: "event", content_type: "application/json" }),
-          JSON.stringify({
-            event_id: eventId,
-            exception: { values: [{ type: error.name, value: error.message }] },
-            platform: "node",
-            environment,
-            release: `canicode@${version}`,
-            timestamp: Date.now() / 1e3,
-            extra: context
-          })
-        ].join("\n");
-        fetch(`${parsed.host}/api/${parsed.projectId}/envelope/`, {
-          method: "POST",
-          headers: {
-            "Content-Type": "application/x-sentry-envelope",
-            "X-Sentry-Auth": `Sentry sentry_version=7, sentry_key=${parsed.key}`
-          },
-          body: envelope
-        }).catch(() => {
-        });
-      } catch {
-      }
-    }
-  }
-  captureEvent("cic_error", { error: error.message, ...context });
-}
-function shutdownCapture() {
-  monitoringEnabled = false;
-  posthogApiKey = void 0;
-  sentryDsn = void 0;
-  distinctId = "anonymous";
-  environment = "unknown";
-  version = "unknown";
-  commonProps = {};
-}
-
-// src/core/monitoring/index.ts
-function initMonitoring(config2) {
-  initCapture(config2);
-}
-function trackEvent(event, properties) {
-  try {
-    captureEvent(event, properties);
-  } catch {
-  }
-}
-function trackError(error, context) {
-  try {
-    captureError(error, context);
-  } catch {
-  }
-}
-function shutdownMonitoring() {
-  try {
-    shutdownCapture();
-  } catch {
-  }
-}
-
-// src/core/monitoring/keys.ts
-var POSTHOG_API_KEY = "phc_rBFeG140KqJLpUnlpYDEFgdMM6JozZeqQsf9twXf5Dq" ;
-var SENTRY_DSN = "https://80a836a8300b25f17ef5bbf23afb5b3a@o4511080656207872.ingest.us.sentry.io/4511080661319680" ;
-
-// src/core/rules/excluded-names.ts
-var EXCLUDED_NAME_PATTERN = /(badge|close|dismiss|overlay|float|fab|dot|indicator|corner|decoration|tag|status|notification|icon|ico|image|asset|filter|dim|dimmed|bg|background|logo|avatar|divider|separator|nav|navigation|gnb|header|footer|sidebar|toolbar|modal|dialog|popup|toast|tooltip|dropdown|menu|sticky|spinner|loader|cursor|cta|chatbot|thumb|thumbnail|tabbar|tab-bar|statusbar|status-bar)/i;
-function isExcludedName(name) {
-  return EXCLUDED_NAME_PATTERN.test(name);
-}
-
-// src/core/rules/layout/index.ts
-function isContainerNode(node) {
-  return node.type === "FRAME" || node.type === "GROUP" || node.type === "COMPONENT";
-}
-function hasAutoLayout(node) {
-  return node.layoutMode !== void 0 && node.layoutMode !== "NONE";
+function hasAutoLayout(node) {
+  return node.layoutMode !== void 0 && node.layoutMode !== "NONE";
 }
 function hasTextContent(node) {
   return node.type === "TEXT" || (node.children?.some((c) => c.type === "TEXT") ?? false);
@@ -2568,546 +2366,1228 @@ var componentPropertyUnusedCheck = (node, _context) => {
   return null;
 };
 defineRule({
-  definition: componentPropertyUnusedDef,
-  check: componentPropertyUnusedCheck
+  definition: componentPropertyUnusedDef,
+  check: componentPropertyUnusedCheck
+});
+var singleUseComponentDef = {
+  id: "single-use-component",
+  name: "Single Use Component",
+  category: "component",
+  why: "Components used only once add complexity without reuse benefit",
+  impact: "Unnecessary abstraction increases maintenance overhead",
+  fix: "Consider inlining if this component won't be reused"
+};
+var singleUseComponentCheck = (node, context) => {
+  if (!isComponent(node)) return null;
+  let instanceCount = 0;
+  function countInstances(n) {
+    if (n.type === "INSTANCE" && n.componentId === node.id) {
+      instanceCount++;
+    }
+    if (n.children) {
+      for (const child of n.children) {
+        countInstances(child);
+      }
+    }
+  }
+  countInstances(context.file.document);
+  if (instanceCount === 1) {
+    return {
+      ruleId: singleUseComponentDef.id,
+      nodeId: node.id,
+      nodePath: context.path.join(" > "),
+      message: `Component "${node.name}" is only used once`
+    };
+  }
+  return null;
+};
+defineRule({
+  definition: singleUseComponentDef,
+  check: singleUseComponentCheck
+});
+
+// src/core/rules/naming/index.ts
+var DEFAULT_NAME_PATTERNS = [
+  /^Frame\s*\d*$/i,
+  /^Group\s*\d*$/i,
+  /^Rectangle\s*\d*$/i,
+  /^Ellipse\s*\d*$/i,
+  /^Vector\s*\d*$/i,
+  /^Line\s*\d*$/i,
+  /^Text\s*\d*$/i,
+  /^Image\s*\d*$/i,
+  /^Component\s*\d*$/i,
+  /^Instance\s*\d*$/i
+];
+var NON_SEMANTIC_NAMES = [
+  "rectangle",
+  "ellipse",
+  "vector",
+  "line",
+  "polygon",
+  "star",
+  "path",
+  "shape",
+  "image",
+  "fill",
+  "stroke"
+];
+function isDefaultName(name) {
+  return DEFAULT_NAME_PATTERNS.some((pattern) => pattern.test(name));
+}
+function isNonSemanticName(name) {
+  const normalized = name.toLowerCase().trim();
+  return NON_SEMANTIC_NAMES.includes(normalized);
+}
+function hasNumericSuffix(name) {
+  return /\s+\d+$/.test(name);
+}
+function detectNamingConvention(name) {
+  if (/^[a-z]+(-[a-z]+)*$/.test(name)) return "kebab-case";
+  if (/^[a-z]+(_[a-z]+)*$/.test(name)) return "snake_case";
+  if (/^[a-z]+([A-Z][a-z]*)*$/.test(name)) return "camelCase";
+  if (/^[A-Z][a-z]+([A-Z][a-z]*)*$/.test(name)) return "PascalCase";
+  if (/^[A-Z]+(_[A-Z]+)*$/.test(name)) return "SCREAMING_SNAKE_CASE";
+  if (/\s/.test(name)) return "Title Case";
+  return null;
+}
+var defaultNameDef = {
+  id: "default-name",
+  name: "Default Name",
+  category: "naming",
+  why: "Default names like 'Frame 123' provide no context about the element's purpose",
+  impact: "Designers and developers cannot understand the structure",
+  fix: "Rename with a descriptive, semantic name (e.g., 'Header', 'ProductCard')"
+};
+var defaultNameCheck = (node, context) => {
+  if (!node.name) return null;
+  if (isExcludedName(node.name)) return null;
+  if (!isDefaultName(node.name)) return null;
+  return {
+    ruleId: defaultNameDef.id,
+    nodeId: node.id,
+    nodePath: context.path.join(" > "),
+    message: `"${node.name}" is a default name - provide a meaningful name`
+  };
+};
+defineRule({
+  definition: defaultNameDef,
+  check: defaultNameCheck
+});
+var nonSemanticNameDef = {
+  id: "non-semantic-name",
+  name: "Non-Semantic Name",
+  category: "naming",
+  why: "Names like 'Rectangle' describe shape, not purpose",
+  impact: "Structure is hard to understand without context",
+  fix: "Use names that describe what the element represents (e.g., 'Divider', 'Avatar')"
+};
+var nonSemanticNameCheck = (node, context) => {
+  if (!node.name) return null;
+  if (isExcludedName(node.name)) return null;
+  if (!isNonSemanticName(node.name)) return null;
+  if (!node.children || node.children.length === 0) {
+    const shapeTypes = ["RECTANGLE", "ELLIPSE", "VECTOR", "LINE", "STAR", "REGULAR_POLYGON"];
+    if (shapeTypes.includes(node.type)) return null;
+  }
+  return {
+    ruleId: nonSemanticNameDef.id,
+    nodeId: node.id,
+    nodePath: context.path.join(" > "),
+    message: `"${node.name}" is a non-semantic name - describe its purpose`
+  };
+};
+defineRule({
+  definition: nonSemanticNameDef,
+  check: nonSemanticNameCheck
+});
+var inconsistentNamingConventionDef = {
+  id: "inconsistent-naming-convention",
+  name: "Inconsistent Naming Convention",
+  category: "naming",
+  why: "Mixed naming conventions at the same level create confusion",
+  impact: "Harder to navigate and maintain the design",
+  fix: "Use a consistent naming convention for sibling elements"
+};
+var inconsistentNamingConventionCheck = (node, context) => {
+  if (!context.siblings || context.siblings.length < 2) return null;
+  const conventions = /* @__PURE__ */ new Map();
+  for (const sibling of context.siblings) {
+    if (!sibling.name) continue;
+    const convention = detectNamingConvention(sibling.name);
+    if (convention) {
+      conventions.set(convention, (conventions.get(convention) ?? 0) + 1);
+    }
+  }
+  if (conventions.size < 2) return null;
+  let dominantConvention = "";
+  let maxCount = 0;
+  for (const [convention, count] of conventions) {
+    if (count > maxCount) {
+      maxCount = count;
+      dominantConvention = convention;
+    }
+  }
+  const nodeConvention = detectNamingConvention(node.name);
+  if (nodeConvention && nodeConvention !== dominantConvention && maxCount >= 2) {
+    return {
+      ruleId: inconsistentNamingConventionDef.id,
+      nodeId: node.id,
+      nodePath: context.path.join(" > "),
+      message: `"${node.name}" uses ${nodeConvention} while siblings use ${dominantConvention}`
+    };
+  }
+  return null;
+};
+defineRule({
+  definition: inconsistentNamingConventionDef,
+  check: inconsistentNamingConventionCheck
+});
+var numericSuffixNameDef = {
+  id: "numeric-suffix-name",
+  name: "Numeric Suffix Name",
+  category: "naming",
+  why: "Names with numeric suffixes often indicate copy-paste duplication",
+  impact: "Suggests the element might need componentization",
+  fix: "Remove the suffix or create a component if duplicated"
+};
+var numericSuffixNameCheck = (node, context) => {
+  if (!node.name) return null;
+  if (isExcludedName(node.name)) return null;
+  if (isDefaultName(node.name)) return null;
+  if (!hasNumericSuffix(node.name)) return null;
+  return {
+    ruleId: numericSuffixNameDef.id,
+    nodeId: node.id,
+    nodePath: context.path.join(" > "),
+    message: `"${node.name}" has a numeric suffix - consider renaming`
+  };
+};
+defineRule({
+  definition: numericSuffixNameDef,
+  check: numericSuffixNameCheck
+});
+var tooLongNameDef = {
+  id: "too-long-name",
+  name: "Too Long Name",
+  category: "naming",
+  why: "Very long names are hard to read and use in code",
+  impact: "Clutters the layer panel and makes selectors unwieldy",
+  fix: "Shorten the name while keeping it descriptive"
+};
+var tooLongNameCheck = (node, context, options) => {
+  if (!node.name) return null;
+  const maxLength = options?.["maxLength"] ?? getRuleOption("too-long-name", "maxLength", 50);
+  if (node.name.length <= maxLength) return null;
+  return {
+    ruleId: tooLongNameDef.id,
+    nodeId: node.id,
+    nodePath: context.path.join(" > "),
+    message: `"${node.name.substring(0, 30)}..." is ${node.name.length} chars (max: ${maxLength})`
+  };
+};
+defineRule({
+  definition: tooLongNameDef,
+  check: tooLongNameCheck
+});
+
+// src/core/rules/ai-readability/index.ts
+function hasAutoLayout2(node) {
+  return node.layoutMode !== void 0 && node.layoutMode !== "NONE";
+}
+function isContainerNode2(node) {
+  return node.type === "FRAME" || node.type === "GROUP" || node.type === "COMPONENT";
+}
+function hasOverlappingBounds(a, b) {
+  const boxA = a.absoluteBoundingBox;
+  const boxB = b.absoluteBoundingBox;
+  if (!boxA || !boxB) return false;
+  return !(boxA.x + boxA.width <= boxB.x || boxB.x + boxB.width <= boxA.x || boxA.y + boxA.height <= boxB.y || boxB.y + boxB.height <= boxA.y);
+}
+var ambiguousStructureDef = {
+  id: "ambiguous-structure",
+  name: "Ambiguous Structure",
+  category: "ai-readability",
+  why: "Overlapping nodes without Auto Layout create ambiguous visual hierarchy",
+  impact: "AI cannot reliably determine the reading order or structure",
+  fix: "Use Auto Layout to create clear, explicit structure"
+};
+var ambiguousStructureCheck = (node, context) => {
+  if (!isContainerNode2(node)) return null;
+  if (hasAutoLayout2(node)) return null;
+  if (!node.children || node.children.length < 2) return null;
+  for (let i = 0; i < node.children.length; i++) {
+    for (let j = i + 1; j < node.children.length; j++) {
+      const childA = node.children[i];
+      const childB = node.children[j];
+      if (childA && childB && hasOverlappingBounds(childA, childB)) {
+        if (childA.visible !== false && childB.visible !== false) {
+          return {
+            ruleId: ambiguousStructureDef.id,
+            nodeId: node.id,
+            nodePath: context.path.join(" > "),
+            message: `"${node.name}" has overlapping children without Auto Layout`
+          };
+        }
+      }
+    }
+  }
+  return null;
+};
+defineRule({
+  definition: ambiguousStructureDef,
+  check: ambiguousStructureCheck
 });
-var singleUseComponentDef = {
-  id: "single-use-component",
-  name: "Single Use Component",
-  category: "component",
-  why: "Components used only once add complexity without reuse benefit",
-  impact: "Unnecessary abstraction increases maintenance overhead",
-  fix: "Consider inlining if this component won't be reused"
+var zIndexDependentLayoutDef = {
+  id: "z-index-dependent-layout",
+  name: "Z-Index Dependent Layout",
+  category: "ai-readability",
+  why: "Using overlapping layers to create visual layout is hard to interpret",
+  impact: "Code generation may misinterpret the intended layout",
+  fix: "Restructure using Auto Layout to express the visual relationship explicitly"
 };
-var singleUseComponentCheck = (node, context) => {
-  if (!isComponent(node)) return null;
-  let instanceCount = 0;
-  function countInstances(n) {
-    if (n.type === "INSTANCE" && n.componentId === node.id) {
-      instanceCount++;
-    }
-    if (n.children) {
-      for (const child of n.children) {
-        countInstances(child);
+var zIndexDependentLayoutCheck = (node, context) => {
+  if (!isContainerNode2(node)) return null;
+  if (!node.children || node.children.length < 2) return null;
+  let significantOverlapCount = 0;
+  for (let i = 0; i < node.children.length; i++) {
+    for (let j = i + 1; j < node.children.length; j++) {
+      const childA = node.children[i];
+      const childB = node.children[j];
+      if (!childA || !childB) continue;
+      if (childA.visible === false || childB.visible === false) continue;
+      const boxA = childA.absoluteBoundingBox;
+      const boxB = childB.absoluteBoundingBox;
+      if (!boxA || !boxB) continue;
+      if (hasOverlappingBounds(childA, childB)) {
+        const overlapX = Math.min(boxA.x + boxA.width, boxB.x + boxB.width) - Math.max(boxA.x, boxB.x);
+        const overlapY = Math.min(boxA.y + boxA.height, boxB.y + boxB.height) - Math.max(boxA.y, boxB.y);
+        if (overlapX > 0 && overlapY > 0) {
+          const overlapArea = overlapX * overlapY;
+          const smallerArea = Math.min(
+            boxA.width * boxA.height,
+            boxB.width * boxB.height
+          );
+          if (overlapArea > smallerArea * 0.2) {
+            significantOverlapCount++;
+          }
+        }
       }
     }
   }
-  countInstances(context.file.document);
-  if (instanceCount === 1) {
+  if (significantOverlapCount > 0) {
     return {
-      ruleId: singleUseComponentDef.id,
+      ruleId: zIndexDependentLayoutDef.id,
       nodeId: node.id,
       nodePath: context.path.join(" > "),
-      message: `Component "${node.name}" is only used once`
+      message: `"${node.name}" uses layer stacking for layout (${significantOverlapCount} overlaps)`
     };
   }
   return null;
 };
 defineRule({
-  definition: singleUseComponentDef,
-  check: singleUseComponentCheck
+  definition: zIndexDependentLayoutDef,
+  check: zIndexDependentLayoutCheck
 });
-
-// src/core/rules/naming/index.ts
-var DEFAULT_NAME_PATTERNS = [
-  /^Frame\s*\d*$/i,
-  /^Group\s*\d*$/i,
-  /^Rectangle\s*\d*$/i,
-  /^Ellipse\s*\d*$/i,
-  /^Vector\s*\d*$/i,
-  /^Line\s*\d*$/i,
-  /^Text\s*\d*$/i,
-  /^Image\s*\d*$/i,
-  /^Component\s*\d*$/i,
-  /^Instance\s*\d*$/i
-];
-var NON_SEMANTIC_NAMES = [
-  "rectangle",
-  "ellipse",
-  "vector",
-  "line",
-  "polygon",
-  "star",
-  "path",
-  "shape",
-  "image",
-  "fill",
-  "stroke"
-];
-function isDefaultName(name) {
-  return DEFAULT_NAME_PATTERNS.some((pattern) => pattern.test(name));
-}
-function isNonSemanticName(name) {
-  const normalized = name.toLowerCase().trim();
-  return NON_SEMANTIC_NAMES.includes(normalized);
-}
-function hasNumericSuffix(name) {
-  return /\s+\d+$/.test(name);
-}
-function detectNamingConvention(name) {
-  if (/^[a-z]+(-[a-z]+)*$/.test(name)) return "kebab-case";
-  if (/^[a-z]+(_[a-z]+)*$/.test(name)) return "snake_case";
-  if (/^[a-z]+([A-Z][a-z]*)*$/.test(name)) return "camelCase";
-  if (/^[A-Z][a-z]+([A-Z][a-z]*)*$/.test(name)) return "PascalCase";
-  if (/^[A-Z]+(_[A-Z]+)*$/.test(name)) return "SCREAMING_SNAKE_CASE";
-  if (/\s/.test(name)) return "Title Case";
+var missingLayoutHintDef = {
+  id: "missing-layout-hint",
+  name: "Missing Layout Hint",
+  category: "ai-readability",
+  why: "Complex nesting without Auto Layout makes structure unpredictable",
+  impact: "AI may generate incorrect code due to ambiguous relationships",
+  fix: "Add Auto Layout or simplify the nesting structure"
+};
+var missingLayoutHintCheck = (node, context) => {
+  if (!isContainerNode2(node)) return null;
+  if (hasAutoLayout2(node)) return null;
+  if (!node.children || node.children.length === 0) return null;
+  const nestedContainers = node.children.filter((c) => isContainerNode2(c));
+  if (nestedContainers.length >= 2) {
+    const withoutLayout = nestedContainers.filter((c) => !hasAutoLayout2(c));
+    if (withoutLayout.length >= 2) {
+      return {
+        ruleId: missingLayoutHintDef.id,
+        nodeId: node.id,
+        nodePath: context.path.join(" > "),
+        message: `"${node.name}" has ${withoutLayout.length} nested containers without layout hints`
+      };
+    }
+  }
   return null;
-}
-var defaultNameDef = {
-  id: "default-name",
-  name: "Default Name",
-  category: "naming",
-  why: "Default names like 'Frame 123' provide no context about the element's purpose",
-  impact: "Designers and developers cannot understand the structure",
-  fix: "Rename with a descriptive, semantic name (e.g., 'Header', 'ProductCard')"
 };
-var defaultNameCheck = (node, context) => {
-  if (!node.name) return null;
-  if (isExcludedName(node.name)) return null;
-  if (!isDefaultName(node.name)) return null;
+defineRule({
+  definition: missingLayoutHintDef,
+  check: missingLayoutHintCheck
+});
+var invisibleLayerDef = {
+  id: "invisible-layer",
+  name: "Invisible Layer",
+  category: "ai-readability",
+  why: "Hidden layers add noise and may confuse analysis tools",
+  impact: "Exported code may include unnecessary elements",
+  fix: "Delete hidden layers or move them to a separate 'archive' page"
+};
+var invisibleLayerCheck = (node, context) => {
+  if (node.visible !== false) return null;
+  if (context.parent?.visible === false) return null;
   return {
-    ruleId: defaultNameDef.id,
+    ruleId: invisibleLayerDef.id,
     nodeId: node.id,
     nodePath: context.path.join(" > "),
-    message: `"${node.name}" is a default name - provide a meaningful name`
+    message: `"${node.name}" is hidden - consider removing if not needed`
   };
 };
 defineRule({
-  definition: defaultNameDef,
-  check: defaultNameCheck
+  definition: invisibleLayerDef,
+  check: invisibleLayerCheck
 });
-var nonSemanticNameDef = {
-  id: "non-semantic-name",
-  name: "Non-Semantic Name",
-  category: "naming",
-  why: "Names like 'Rectangle' describe shape, not purpose",
-  impact: "Structure is hard to understand without context",
-  fix: "Use names that describe what the element represents (e.g., 'Divider', 'Avatar')"
+var emptyFrameDef = {
+  id: "empty-frame",
+  name: "Empty Frame",
+  category: "ai-readability",
+  why: "Empty frames add noise and may indicate incomplete design",
+  impact: "Generates unnecessary wrapper elements in code",
+  fix: "Remove the frame or add content"
 };
-var nonSemanticNameCheck = (node, context) => {
-  if (!node.name) return null;
-  if (isExcludedName(node.name)) return null;
-  if (!isNonSemanticName(node.name)) return null;
-  if (!node.children || node.children.length === 0) {
-    const shapeTypes = ["RECTANGLE", "ELLIPSE", "VECTOR", "LINE", "STAR", "REGULAR_POLYGON"];
-    if (shapeTypes.includes(node.type)) return null;
+var emptyFrameCheck = (node, context) => {
+  if (node.type !== "FRAME") return null;
+  if (node.children && node.children.length > 0) return null;
+  if (node.absoluteBoundingBox) {
+    const { width, height } = node.absoluteBoundingBox;
+    if (width <= 48 && height <= 48) return null;
   }
   return {
-    ruleId: nonSemanticNameDef.id,
+    ruleId: emptyFrameDef.id,
     nodeId: node.id,
     nodePath: context.path.join(" > "),
-    message: `"${node.name}" is a non-semantic name - describe its purpose`
+    message: `"${node.name}" is an empty frame`
   };
 };
 defineRule({
-  definition: nonSemanticNameDef,
-  check: nonSemanticNameCheck
+  definition: emptyFrameDef,
+  check: emptyFrameCheck
+});
+
+// src/core/rules/handoff-risk/index.ts
+function hasAutoLayout3(node) {
+  return node.layoutMode !== void 0 && node.layoutMode !== "NONE";
+}
+function isContainerNode3(node) {
+  return node.type === "FRAME" || node.type === "GROUP" || node.type === "COMPONENT";
+}
+function isTextNode(node) {
+  return node.type === "TEXT";
+}
+function isImageNode(node) {
+  if (node.type === "RECTANGLE" && node.fills) {
+    for (const fill of node.fills) {
+      const fillObj = fill;
+      if (fillObj["type"] === "IMAGE") return true;
+    }
+  }
+  return false;
+}
+var hardcodeRiskDef = {
+  id: "hardcode-risk",
+  name: "Hardcode Risk",
+  category: "handoff-risk",
+  why: "Absolute positioning with fixed values creates inflexible layouts",
+  impact: "Layout will break when content changes or on different screens",
+  fix: "Use Auto Layout with relative positioning"
+};
+var hardcodeRiskCheck = (node, context) => {
+  if (!isContainerNode3(node)) return null;
+  if (node.layoutPositioning !== "ABSOLUTE") return null;
+  if (context.parent && hasAutoLayout3(context.parent)) {
+    return {
+      ruleId: hardcodeRiskDef.id,
+      nodeId: node.id,
+      nodePath: context.path.join(" > "),
+      message: `"${node.name}" uses absolute positioning with fixed values`
+    };
+  }
+  return null;
+};
+defineRule({
+  definition: hardcodeRiskDef,
+  check: hardcodeRiskCheck
 });
-var inconsistentNamingConventionDef = {
-  id: "inconsistent-naming-convention",
-  name: "Inconsistent Naming Convention",
-  category: "naming",
-  why: "Mixed naming conventions at the same level create confusion",
-  impact: "Harder to navigate and maintain the design",
-  fix: "Use a consistent naming convention for sibling elements"
+var textTruncationUnhandledDef = {
+  id: "text-truncation-unhandled",
+  name: "Text Truncation Unhandled",
+  category: "handoff-risk",
+  why: "Text nodes without truncation handling may overflow",
+  impact: "Long text will break the layout",
+  fix: "Set text truncation (ellipsis) or ensure container can grow"
 };
-var inconsistentNamingConventionCheck = (node, context) => {
-  if (!context.siblings || context.siblings.length < 2) return null;
-  const conventions = /* @__PURE__ */ new Map();
-  for (const sibling of context.siblings) {
-    if (!sibling.name) continue;
-    const convention = detectNamingConvention(sibling.name);
-    if (convention) {
-      conventions.set(convention, (conventions.get(convention) ?? 0) + 1);
+var textTruncationUnhandledCheck = (node, context) => {
+  if (!isTextNode(node)) return null;
+  if (!context.parent) return null;
+  if (!hasAutoLayout3(context.parent)) return null;
+  if (node.absoluteBoundingBox) {
+    const { width } = node.absoluteBoundingBox;
+    if (node.characters && node.characters.length > 50 && width < 300) {
+      return {
+        ruleId: textTruncationUnhandledDef.id,
+        nodeId: node.id,
+        nodePath: context.path.join(" > "),
+        message: `"${node.name}" may need text truncation handling`
+      };
     }
   }
-  if (conventions.size < 2) return null;
-  let dominantConvention = "";
-  let maxCount = 0;
-  for (const [convention, count] of conventions) {
-    if (count > maxCount) {
-      maxCount = count;
-      dominantConvention = convention;
+  return null;
+};
+defineRule({
+  definition: textTruncationUnhandledDef,
+  check: textTruncationUnhandledCheck
+});
+var imageNoPlaceholderDef = {
+  id: "image-no-placeholder",
+  name: "Image No Placeholder",
+  category: "handoff-risk",
+  why: "Images without placeholder state may cause layout shifts",
+  impact: "Poor user experience during image loading",
+  fix: "Define a placeholder state or background color"
+};
+var imageNoPlaceholderCheck = (node, context) => {
+  if (!isImageNode(node)) return null;
+  if (node.fills && Array.isArray(node.fills) && node.fills.length === 1) {
+    const fill = node.fills[0];
+    if (fill["type"] === "IMAGE") {
+      return {
+        ruleId: imageNoPlaceholderDef.id,
+        nodeId: node.id,
+        nodePath: context.path.join(" > "),
+        message: `"${node.name}" image has no placeholder fill`
+      };
     }
   }
-  const nodeConvention = detectNamingConvention(node.name);
-  if (nodeConvention && nodeConvention !== dominantConvention && maxCount >= 2) {
-    return {
-      ruleId: inconsistentNamingConventionDef.id,
-      nodeId: node.id,
-      nodePath: context.path.join(" > "),
-      message: `"${node.name}" uses ${nodeConvention} while siblings use ${dominantConvention}`
-    };
-  }
   return null;
 };
 defineRule({
-  definition: inconsistentNamingConventionDef,
-  check: inconsistentNamingConventionCheck
+  definition: imageNoPlaceholderDef,
+  check: imageNoPlaceholderCheck
 });
-var numericSuffixNameDef = {
-  id: "numeric-suffix-name",
-  name: "Numeric Suffix Name",
-  category: "naming",
-  why: "Names with numeric suffixes often indicate copy-paste duplication",
-  impact: "Suggests the element might need componentization",
-  fix: "Remove the suffix or create a component if duplicated"
+var prototypeLinkInDesignDef = {
+  id: "prototype-link-in-design",
+  name: "Prototype Link in Design",
+  category: "handoff-risk",
+  why: "Prototype connections may affect how the design is interpreted",
+  impact: "Developers may misunderstand which elements should be interactive",
+  fix: "Document interactions separately or use clear naming"
 };
-var numericSuffixNameCheck = (node, context) => {
-  if (!node.name) return null;
-  if (isExcludedName(node.name)) return null;
-  if (isDefaultName(node.name)) return null;
-  if (!hasNumericSuffix(node.name)) return null;
-  return {
-    ruleId: numericSuffixNameDef.id,
-    nodeId: node.id,
-    nodePath: context.path.join(" > "),
-    message: `"${node.name}" has a numeric suffix - consider renaming`
-  };
+var prototypeLinkInDesignCheck = (_node, _context) => {
+  return null;
 };
 defineRule({
-  definition: numericSuffixNameDef,
-  check: numericSuffixNameCheck
+  definition: prototypeLinkInDesignDef,
+  check: prototypeLinkInDesignCheck
 });
-var tooLongNameDef = {
-  id: "too-long-name",
-  name: "Too Long Name",
-  category: "naming",
-  why: "Very long names are hard to read and use in code",
-  impact: "Clutters the layer panel and makes selectors unwieldy",
-  fix: "Shorten the name while keeping it descriptive"
+var noDevStatusDef = {
+  id: "no-dev-status",
+  name: "No Dev Status",
+  category: "handoff-risk",
+  why: "Without dev status, developers cannot know if a design is ready",
+  impact: "May implement designs that are still in progress",
+  fix: "Mark frames as 'Ready for Dev' or 'Completed' when appropriate"
 };
-var tooLongNameCheck = (node, context, options) => {
-  if (!node.name) return null;
-  const maxLength = options?.["maxLength"] ?? getRuleOption("too-long-name", "maxLength", 50);
-  if (node.name.length <= maxLength) return null;
+var noDevStatusCheck = (node, context) => {
+  if (node.type !== "FRAME") return null;
+  if (context.depth > 1) return null;
+  if (node.devStatus) return null;
   return {
-    ruleId: tooLongNameDef.id,
+    ruleId: noDevStatusDef.id,
     nodeId: node.id,
     nodePath: context.path.join(" > "),
-    message: `"${node.name.substring(0, 30)}..." is ${node.name.length} chars (max: ${maxLength})`
+    message: `"${node.name}" has no dev status set`
   };
 };
 defineRule({
-  definition: tooLongNameDef,
-  check: tooLongNameCheck
+  definition: noDevStatusDef,
+  check: noDevStatusCheck
+});
+var SamplingStrategySchema = z.enum(["all", "top-issues", "random"]);
+z.enum([
+  "pending",
+  "analyzing",
+  "converting",
+  "evaluating",
+  "tuning",
+  "completed",
+  "failed"
+]);
+z.object({
+  input: z.string(),
+  token: z.string().optional(),
+  targetNodeId: z.string().optional(),
+  maxConversionNodes: z.number().int().positive().default(20),
+  samplingStrategy: SamplingStrategySchema.default("top-issues"),
+  outputPath: z.string().default("logs/calibration/calibration-report.md")
+});
+z.object({
+  nodeId: z.string(),
+  nodePath: z.string(),
+  totalScore: z.number(),
+  issueCount: z.number(),
+  flaggedRuleIds: z.array(z.string()),
+  severities: z.array(z.string())
+});
+var DifficultySchema = z.enum(["easy", "moderate", "hard", "failed"]);
+var RuleRelatedStruggleSchema = z.object({
+  ruleId: z.string(),
+  description: z.string(),
+  actualImpact: DifficultySchema
+});
+var UncoveredStruggleSchema = z.object({
+  description: z.string(),
+  suggestedCategory: z.string(),
+  estimatedImpact: DifficultySchema
+});
+z.object({
+  nodeId: z.string(),
+  nodePath: z.string(),
+  generatedCode: z.string(),
+  difficulty: DifficultySchema,
+  notes: z.string(),
+  ruleRelatedStruggles: z.array(RuleRelatedStruggleSchema),
+  uncoveredStruggles: z.array(UncoveredStruggleSchema),
+  durationMs: z.number()
+});
+var MismatchTypeSchema = z.enum([
+  "overscored",
+  "underscored",
+  "missing-rule",
+  "validated"
+]);
+z.object({
+  type: MismatchTypeSchema,
+  nodeId: z.string(),
+  nodePath: z.string(),
+  ruleId: z.string().optional(),
+  currentScore: z.number().optional(),
+  currentSeverity: SeveritySchema.optional(),
+  actualDifficulty: DifficultySchema,
+  reasoning: z.string()
+});
+var ConfidenceSchema = z.enum(["high", "medium", "low"]);
+z.object({
+  ruleId: z.string(),
+  currentScore: z.number(),
+  proposedScore: z.number(),
+  currentSeverity: SeveritySchema,
+  proposedSeverity: SeveritySchema.optional(),
+  reasoning: z.string(),
+  confidence: ConfidenceSchema,
+  supportingCases: z.number()
 });
+z.object({
+  suggestedId: z.string(),
+  category: z.string(),
+  description: z.string(),
+  suggestedSeverity: SeveritySchema,
+  suggestedScore: z.number(),
+  reasoning: z.string(),
+  supportingCases: z.number()
+});
+
+// src/core/report-html/index.ts
+function generateHtmlReport(file, result, scores, options) {
+  const screenshotMap = new Map(
+    (options?.nodeScreenshots ?? []).map((ns) => [ns.nodeId, ns])
+  );
+  const figmaToken = options?.figmaToken;
+  const quickWins = getQuickWins(result.issues, 5);
+  const issuesByCategory = groupIssuesByCategory(result.issues);
+  return `<!DOCTYPE html>
+<html lang="en" class="antialiased">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>CanICode Report \u2014 ${esc(file.name)}</title>
+  <script src="https://cdn.tailwindcss.com"></script>
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
+  <script>
+    tailwind.config = {
+      theme: {
+        extend: {
+          fontFamily: { sans: ['Inter', 'ui-sans-serif', 'system-ui', '-apple-system', 'sans-serif'] },
+          colors: {
+            border: 'hsl(240 5.9% 90%)',
+            ring: 'hsl(240 5.9% 10%)',
+            background: 'hsl(0 0% 100%)',
+            foreground: 'hsl(240 10% 3.9%)',
+            muted: { DEFAULT: 'hsl(240 4.8% 95.9%)', foreground: 'hsl(240 3.8% 46.1%)' },
+            card: { DEFAULT: 'hsl(0 0% 100%)', foreground: 'hsl(240 10% 3.9%)' },
+          },
+          borderRadius: { lg: '0.5rem', md: 'calc(0.5rem - 2px)', sm: 'calc(0.5rem - 4px)' },
+        }
+      }
+    }
+  </script>
+  <style>
+    details summary::-webkit-details-marker { display: none; }
+    details summary::marker { content: ""; }
+    details summary { list-style: none; }
+    .gauge-fill { transition: stroke-dashoffset 0.8s cubic-bezier(0.4,0,0.2,1); }
+    @media print {
+      .no-print { display: none !important; }
+      .topbar-print { position: static !important; background: white !important; color: hsl(240 10% 3.9%) !important; }
+    }
+  </style>
+</head>
+<body class="bg-muted font-sans text-foreground min-h-screen">
+
+  <!-- Top Bar -->
+  <header class="topbar-print sticky top-0 z-50 bg-zinc-950 text-white border-b border-zinc-800">
+    <div class="max-w-[960px] mx-auto px-6 py-3 flex items-center gap-4">
+      <span class="font-semibold text-sm tracking-tight">CanICode</span>
+      <span class="text-zinc-400 text-sm truncate">${esc(file.name)}</span>
+      <span class="ml-auto text-zinc-500 text-xs no-print">${(/* @__PURE__ */ new Date()).toLocaleDateString()}</span>
+    </div>
+  </header>
+
+  <main class="max-w-[960px] mx-auto px-6 pb-16">
+
+    <!-- Overall Score -->
+    <section class="flex flex-col items-center pt-12 pb-6">
+      ${renderGaugeSvg(scores.overall.percentage, 200, 10, scores.overall.grade)}
+      <div class="mt-3 text-center">
+        <span class="text-lg font-semibold">${scores.overall.percentage}</span>
+        <span class="text-muted-foreground text-sm ml-1">/ 100</span>
+      </div>
+      <p class="text-muted-foreground text-sm mt-1">Overall Score</p>
+    </section>
+
+    <!-- Category Gauges -->
+    <section class="bg-card border border-border rounded-lg shadow-sm p-6 mb-6">
+      <div class="grid grid-cols-3 sm:grid-cols-6 gap-4">
+${CATEGORIES.map((cat) => {
+    const cs = scores.byCategory[cat];
+    const desc = CATEGORY_DESCRIPTIONS[cat];
+    return `        <a href="#cat-${cat}" class="flex flex-col items-center group relative cursor-pointer no-underline text-foreground hover:opacity-80 transition-opacity">
+          ${renderGaugeSvg(cs.percentage, 100, 7)}
+          <span class="text-xs font-medium mt-2.5 text-center leading-tight">${CATEGORY_LABELS[cat]}</span>
+          <span class="text-[11px] text-muted-foreground">${cs.issueCount} issues</span>
+          <div class="absolute bottom-full mb-2 left-1/2 -translate-x-1/2 hidden group-hover:block bg-zinc-900 text-white text-xs px-3 py-2 rounded-md whitespace-nowrap z-10 shadow-lg pointer-events-none">
+            ${esc(desc)}
+            <div class="absolute top-full left-1/2 -translate-x-1/2 border-4 border-transparent border-t-zinc-900"></div>
+          </div>
+        </a>`;
+  }).join("\n")}
+      </div>
+    </section>
+
+    <!-- Issue Summary -->
+    <section class="bg-card border border-border rounded-lg shadow-sm p-4 mb-6">
+      <div class="flex flex-wrap items-center justify-center gap-6">
+        ${renderSummaryDot("bg-red-500", scores.summary.blocking, "Blocking")}
+        ${renderSummaryDot("bg-amber-500", scores.summary.risk, "Risk")}
+        ${renderSummaryDot("bg-zinc-400", scores.summary.missingInfo, "Missing Info")}
+        ${renderSummaryDot("bg-green-500", scores.summary.suggestion, "Suggestion")}
+        <div class="border-l border-border pl-6 flex items-center gap-2">
+          <span class="text-xl font-bold tracking-tight">${scores.summary.totalIssues}</span>
+          <span class="text-sm text-muted-foreground">Total</span>
+        </div>
+      </div>
+    </section>
 
-// src/core/rules/ai-readability/index.ts
-function hasAutoLayout2(node) {
-  return node.layoutMode !== void 0 && node.layoutMode !== "NONE";
+${quickWins.length > 0 ? renderOpportunities(quickWins, file.fileKey) : ""}
+
+    <!-- Categories -->
+    <div class="space-y-3">
+${CATEGORIES.map((cat) => renderCategory(cat, scores, issuesByCategory.get(cat) ?? [], file.fileKey, screenshotMap, figmaToken)).join("\n")}
+    </div>
+
+    <!-- Footer -->
+    <footer class="mt-12 pt-6 border-t border-border text-center">
+      <p class="text-sm text-muted-foreground">Generated by <span class="font-semibold text-foreground">CanICode</span> <span class="text-muted-foreground/60">v${version}</span></p>
+      <p class="text-xs text-muted-foreground/60 mt-1">${(/* @__PURE__ */ new Date()).toLocaleString()} \xB7 ${result.nodeCount} nodes \xB7 Max depth ${result.maxDepth}</p>
+    </footer>
+
+  </main>
+
+${figmaToken ? `  <script>
+    const FIGMA_TOKEN = '${figmaToken}';
+    async function postComment(btn) {
+      const fileKey = btn.dataset.fileKey;
+      const nodeId = btn.dataset.nodeId.replace(/-/g, ':');
+      const rule = btn.dataset.rule;
+      const message = btn.dataset.message;
+      const path = btn.dataset.path;
+      const fix = btn.dataset.fix;
+      const why = btn.dataset.why;
+      const impact = btn.dataset.impact;
+
+      const commentBody = '[CanICode] ' + rule + '\\n\\nFix: ' + fix + '\\nWhy: ' + why + '\\nImpact: ' + impact + '\\n\\n' + message + '\\nNode: ' + path;
+
+      btn.disabled = true;
+      btn.textContent = 'Sending...';
+
+      try {
+        const res = await fetch('https://api.figma.com/v1/files/' + fileKey + '/comments', {
+          method: 'POST',
+          headers: { 'X-FIGMA-TOKEN': FIGMA_TOKEN, 'Content-Type': 'application/json' },
+          body: JSON.stringify({ message: commentBody, client_meta: { node_id: nodeId, node_offset: { x: 0, y: 0 } } }),
+        });
+        if (!res.ok) throw new Error(await res.text());
+        btn.textContent = 'Sent \\u2713';
+        btn.classList.remove('hover:bg-muted');
+        btn.classList.add('text-green-600', 'border-green-500/30');
+      } catch (e) {
+        btn.textContent = 'Failed \\u2717';
+        btn.classList.remove('hover:bg-muted');
+        btn.classList.add('text-red-600', 'border-red-500/30');
+        btn.disabled = false;
+        console.error('Failed to post Figma comment:', e);
+      }
+    }
+  </script>` : ""}
+</body>
+</html>`;
 }
-function isContainerNode2(node) {
-  return node.type === "FRAME" || node.type === "GROUP" || node.type === "COMPONENT";
+function renderSummaryDot(dotClass, count, label) {
+  return `<div class="flex items-center gap-2">
+          <span class="w-2.5 h-2.5 rounded-full ${dotClass}"></span>
+          <span class="text-lg font-bold tracking-tight">${count}</span>
+          <span class="text-sm text-muted-foreground">${label}</span>
+        </div>`;
 }
-function hasOverlappingBounds(a, b) {
-  const boxA = a.absoluteBoundingBox;
-  const boxB = b.absoluteBoundingBox;
-  if (!boxA || !boxB) return false;
-  return !(boxA.x + boxA.width <= boxB.x || boxB.x + boxB.width <= boxA.x || boxA.y + boxA.height <= boxB.y || boxB.y + boxB.height <= boxA.y);
+function renderOpportunities(issues, fileKey) {
+  const maxAbs = issues.reduce((m, i) => Math.max(m, Math.abs(i.calculatedScore)), 1);
+  return `
+    <!-- Opportunities -->
+    <section class="bg-card border border-border rounded-lg shadow-sm mb-6 overflow-hidden">
+      <div class="px-6 py-4 border-b border-border">
+        <h2 class="text-sm font-semibold flex items-center gap-2">
+          <span class="w-2 h-2 rounded-full bg-red-500"></span>
+          Opportunities
+        </h2>
+        <p class="text-xs text-muted-foreground mt-1">Top blocking issues \u2014 fix these first for the biggest improvement.</p>
+      </div>
+      <div class="divide-y divide-border">
+${issues.map((issue) => {
+    const def = issue.rule.definition;
+    const link = buildFigmaDeepLink(fileKey, issue.violation.nodeId);
+    const barW = Math.round(Math.abs(issue.calculatedScore) / maxAbs * 100);
+    return `        <div class="px-6 py-3 flex items-center gap-4 hover:bg-muted/50 transition-colors">
+          <div class="flex-1 min-w-0">
+            <div class="text-sm font-medium truncate">${esc(def.name)}</div>
+            <div class="text-xs text-muted-foreground truncate mt-0.5">${esc(issue.violation.message)}</div>
+          </div>
+          <div class="w-32 flex items-center gap-2 shrink-0">
+            <div class="flex-1 h-1.5 bg-muted rounded-full overflow-hidden">
+              <div class="h-full bg-red-500 rounded-full" style="width:${barW}%"></div>
+            </div>
+            <span class="text-xs font-medium text-red-600 w-12 text-right">${issue.calculatedScore}</span>
+          </div>
+          <a href="${link}" target="_blank" rel="noopener" class="text-xs text-muted-foreground hover:text-foreground shrink-0 no-print">Figma \u2192</a>
+        </div>`;
+  }).join("\n")}
+      </div>
+    </section>`;
 }
-var ambiguousStructureDef = {
-  id: "ambiguous-structure",
-  name: "Ambiguous Structure",
-  category: "ai-readability",
-  why: "Overlapping nodes without Auto Layout create ambiguous visual hierarchy",
-  impact: "AI cannot reliably determine the reading order or structure",
-  fix: "Use Auto Layout to create clear, explicit structure"
-};
-var ambiguousStructureCheck = (node, context) => {
-  if (!isContainerNode2(node)) return null;
-  if (hasAutoLayout2(node)) return null;
-  if (!node.children || node.children.length < 2) return null;
-  for (let i = 0; i < node.children.length; i++) {
-    for (let j = i + 1; j < node.children.length; j++) {
-      const childA = node.children[i];
-      const childB = node.children[j];
-      if (childA && childB && hasOverlappingBounds(childA, childB)) {
-        if (childA.visible !== false && childB.visible !== false) {
-          return {
-            ruleId: ambiguousStructureDef.id,
-            nodeId: node.id,
-            nodePath: context.path.join(" > "),
-            message: `"${node.name}" has overlapping children without Auto Layout`
-          };
-        }
-      }
-    }
-  }
-  return null;
-};
-defineRule({
-  definition: ambiguousStructureDef,
-  check: ambiguousStructureCheck
+function renderCategory(cat, scores, issues, fileKey, screenshotMap, figmaToken) {
+  const cs = scores.byCategory[cat];
+  const hasProblems = issues.some((i) => i.config.severity === "blocking" || i.config.severity === "risk");
+  const bySeverity = /* @__PURE__ */ new Map();
+  for (const sev of SEVERITY_ORDER) bySeverity.set(sev, []);
+  for (const issue of issues) bySeverity.get(issue.config.severity)?.push(issue);
+  return `
+      <details id="cat-${cat}" class="bg-card border border-border rounded-lg shadow-sm overflow-hidden group"${hasProblems ? " open" : ""}>
+        <summary class="px-5 py-3.5 flex items-center gap-3 cursor-pointer hover:bg-muted/50 transition-colors select-none">
+          <span class="inline-flex items-center justify-center w-10 h-6 rounded-md text-xs font-bold border ${scoreBadgeStyle(cs.percentage)}">${cs.percentage}</span>
+          <div class="flex-1 min-w-0">
+            <div class="text-sm font-semibold">${CATEGORY_LABELS[cat]}</div>
+            <div class="text-xs text-muted-foreground">${esc(CATEGORY_DESCRIPTIONS[cat])}</div>
+          </div>
+          <span class="text-xs text-muted-foreground">${cs.issueCount} issues</span>
+          <svg class="w-4 h-4 text-muted-foreground transition-transform group-open:rotate-180 shrink-0 no-print" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path d="M19 9l-7 7-7-7"/></svg>
+        </summary>
+        <div class="border-t border-border">
+${issues.length === 0 ? '          <div class="px-5 py-4 text-sm text-green-600 font-medium">No issues found</div>' : SEVERITY_ORDER.filter((sev) => (bySeverity.get(sev)?.length ?? 0) > 0).map((sev) => renderSeverityGroup(sev, bySeverity.get(sev) ?? [], fileKey, screenshotMap, figmaToken)).join("\n")}
+        </div>
+      </details>`;
+}
+function renderSeverityGroup(sev, issues, fileKey, screenshotMap, figmaToken) {
+  return `          <div class="px-5 py-3">
+            <div class="flex items-center gap-2 mb-2">
+              <span class="w-2 h-2 rounded-full ${severityDot(sev)}"></span>
+              <span class="text-xs font-semibold uppercase tracking-wider">${SEVERITY_LABELS[sev]}</span>
+              <span class="text-xs text-muted-foreground ml-auto">${issues.length}</span>
+            </div>
+            <div class="space-y-1">
+${issues.map((issue) => renderIssueRow(issue, fileKey, screenshotMap, figmaToken)).join("\n")}
+            </div>
+          </div>`;
+}
+function renderIssueRow(issue, fileKey, screenshotMap, figmaToken) {
+  const sev = issue.config.severity;
+  const def = issue.rule.definition;
+  const link = buildFigmaDeepLink(fileKey, issue.violation.nodeId);
+  const screenshot = screenshotMap.get(issue.violation.nodeId);
+  const screenshotHtml = screenshot ? `<div class="mt-3"><a href="${link}" target="_blank" rel="noopener"><img src="data:image/png;base64,${screenshot.screenshotBase64}" alt="${esc(screenshot.nodePath)}" class="max-w-[240px] border border-border rounded-md"></a></div>` : "";
+  return `              <details class="border border-border rounded-md overflow-hidden">
+                <summary class="flex items-center gap-2.5 px-3 py-2 text-sm cursor-pointer hover:bg-muted/50 transition-colors">
+                  <span class="w-1.5 h-1.5 rounded-full ${severityDot(sev)} shrink-0"></span>
+                  <span class="font-medium shrink-0">${esc(def.name)}</span>
+                  <span class="text-muted-foreground truncate text-xs flex-1">${esc(issue.violation.message)}</span>
+                  <span class="inline-flex items-center px-1.5 py-0.5 text-[10px] font-medium rounded border ${severityBadge(sev)} shrink-0">${issue.calculatedScore}</span>
+                </summary>
+                <div class="px-3 py-3 bg-muted/30 border-t border-border text-sm space-y-2">
+                  <div class="font-mono text-xs text-muted-foreground break-all">${esc(issue.violation.nodePath)}</div>
+                  <div class="text-muted-foreground leading-relaxed space-y-1">
+                    <p><span class="font-medium text-foreground">Why:</span> ${esc(def.why)}</p>
+                    <p><span class="font-medium text-foreground">Impact:</span> ${esc(def.impact)}</p>
+                    <p><span class="font-medium text-foreground">Fix:</span> ${esc(def.fix)}</p>
+                  </div>${screenshotHtml}
+                  <div class="flex items-center gap-2 mt-1 no-print">
+                    <a href="${link}" target="_blank" rel="noopener" class="inline-flex items-center gap-1 px-2.5 py-1 text-xs font-medium border border-border rounded-md hover:bg-muted transition-colors">Open in Figma <span>\u2192</span></a>${figmaToken ? `
+                    <button onclick="postComment(this)" data-file-key="${esc(fileKey)}" data-node-id="${esc(issue.violation.nodeId)}" data-rule="${esc(def.name)}" data-message="${esc(issue.violation.message)}" data-path="${esc(issue.violation.nodePath)}" data-fix="${esc(def.fix)}" data-why="${esc(def.why)}" data-impact="${esc(def.impact)}" class="inline-flex items-center gap-1 px-2.5 py-1 text-xs font-medium border border-border rounded-md hover:bg-muted transition-colors cursor-pointer">Comment on Figma</button>` : ""}
+                  </div>
+                </div>
+              </details>`;
+}
+function getQuickWins(issues, limit) {
+  return issues.filter((issue) => issue.config.severity === "blocking").sort((a, b) => a.calculatedScore - b.calculatedScore).slice(0, limit);
+}
+function groupIssuesByCategory(issues) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const category of CATEGORIES) grouped.set(category, []);
+  for (const issue of issues) grouped.get(issue.rule.definition.category).push(issue);
+  return grouped;
+}
+var esc = escapeHtml;
+var RuleOverrideSchema = z.object({
+  score: z.number().int().max(0).optional(),
+  severity: SeveritySchema.optional(),
+  enabled: z.boolean().optional()
 });
-var zIndexDependentLayoutDef = {
-  id: "z-index-dependent-layout",
-  name: "Z-Index Dependent Layout",
-  category: "ai-readability",
-  why: "Using overlapping layers to create visual layout is hard to interpret",
-  impact: "Code generation may misinterpret the intended layout",
-  fix: "Restructure using Auto Layout to express the visual relationship explicitly"
-};
-var zIndexDependentLayoutCheck = (node, context) => {
-  if (!isContainerNode2(node)) return null;
-  if (!node.children || node.children.length < 2) return null;
-  let significantOverlapCount = 0;
-  for (let i = 0; i < node.children.length; i++) {
-    for (let j = i + 1; j < node.children.length; j++) {
-      const childA = node.children[i];
-      const childB = node.children[j];
-      if (!childA || !childB) continue;
-      if (childA.visible === false || childB.visible === false) continue;
-      const boxA = childA.absoluteBoundingBox;
-      const boxB = childB.absoluteBoundingBox;
-      if (!boxA || !boxB) continue;
-      if (hasOverlappingBounds(childA, childB)) {
-        const overlapX = Math.min(boxA.x + boxA.width, boxB.x + boxB.width) - Math.max(boxA.x, boxB.x);
-        const overlapY = Math.min(boxA.y + boxA.height, boxB.y + boxB.height) - Math.max(boxA.y, boxB.y);
-        if (overlapX > 0 && overlapY > 0) {
-          const overlapArea = overlapX * overlapY;
-          const smallerArea = Math.min(
-            boxA.width * boxA.height,
-            boxB.width * boxB.height
-          );
-          if (overlapArea > smallerArea * 0.2) {
-            significantOverlapCount++;
-          }
-        }
+var ConfigFileSchema = z.object({
+  excludeNodeTypes: z.array(z.string()).optional(),
+  excludeNodeNames: z.array(z.string()).optional(),
+  gridBase: z.number().int().positive().optional(),
+  colorTolerance: z.number().int().positive().optional(),
+  rules: z.record(z.string(), RuleOverrideSchema).optional()
+});
+async function loadConfigFile(filePath) {
+  const absPath = resolve(filePath);
+  const raw = await readFile(absPath, "utf-8");
+  const parsed = JSON.parse(raw);
+  return ConfigFileSchema.parse(parsed);
+}
+function mergeConfigs(base, overrides) {
+  const merged = { ...base };
+  if (overrides.gridBase !== void 0) {
+    for (const [id, config2] of Object.entries(merged)) {
+      if (config2.options && "gridBase" in config2.options) {
+        merged[id] = {
+          ...config2,
+          options: { ...config2.options, gridBase: overrides.gridBase }
+        };
       }
     }
   }
-  if (significantOverlapCount > 0) {
-    return {
-      ruleId: zIndexDependentLayoutDef.id,
-      nodeId: node.id,
-      nodePath: context.path.join(" > "),
-      message: `"${node.name}" uses layer stacking for layout (${significantOverlapCount} overlaps)`
-    };
+  if (overrides.colorTolerance !== void 0) {
+    for (const [id, config2] of Object.entries(merged)) {
+      if (config2.options && "tolerance" in config2.options) {
+        merged[id] = {
+          ...config2,
+          options: { ...config2.options, tolerance: overrides.colorTolerance }
+        };
+      }
+    }
   }
-  return null;
-};
-defineRule({
-  definition: zIndexDependentLayoutDef,
-  check: zIndexDependentLayoutCheck
-});
-var missingLayoutHintDef = {
-  id: "missing-layout-hint",
-  name: "Missing Layout Hint",
-  category: "ai-readability",
-  why: "Complex nesting without Auto Layout makes structure unpredictable",
-  impact: "AI may generate incorrect code due to ambiguous relationships",
-  fix: "Add Auto Layout or simplify the nesting structure"
-};
-var missingLayoutHintCheck = (node, context) => {
-  if (!isContainerNode2(node)) return null;
-  if (hasAutoLayout2(node)) return null;
-  if (!node.children || node.children.length === 0) return null;
-  const nestedContainers = node.children.filter((c) => isContainerNode2(c));
-  if (nestedContainers.length >= 2) {
-    const withoutLayout = nestedContainers.filter((c) => !hasAutoLayout2(c));
-    if (withoutLayout.length >= 2) {
-      return {
-        ruleId: missingLayoutHintDef.id,
-        nodeId: node.id,
-        nodePath: context.path.join(" > "),
-        message: `"${node.name}" has ${withoutLayout.length} nested containers without layout hints`
-      };
+  if (overrides.rules) {
+    for (const [ruleId, override] of Object.entries(overrides.rules)) {
+      const existing = merged[ruleId];
+      if (existing) {
+        merged[ruleId] = {
+          ...existing,
+          ...override.score !== void 0 && { score: override.score },
+          ...override.severity !== void 0 && { severity: override.severity },
+          ...override.enabled !== void 0 && { enabled: override.enabled }
+        };
+      }
     }
   }
-  return null;
-};
-defineRule({
-  definition: missingLayoutHintDef,
-  check: missingLayoutHintCheck
+  return merged;
+}
+var MatchConditionSchema = z.object({
+  // Node type conditions
+  type: z.array(z.string()).optional(),
+  notType: z.array(z.string()).optional(),
+  // Name conditions (case-insensitive, substring match)
+  nameContains: z.string().optional(),
+  nameNotContains: z.string().optional(),
+  namePattern: z.string().optional(),
+  // Size conditions
+  minWidth: z.number().optional(),
+  maxWidth: z.number().optional(),
+  minHeight: z.number().optional(),
+  maxHeight: z.number().optional(),
+  // Layout conditions
+  hasAutoLayout: z.boolean().optional(),
+  hasChildren: z.boolean().optional(),
+  minChildren: z.number().optional(),
+  maxChildren: z.number().optional(),
+  // Component conditions
+  isComponent: z.boolean().optional(),
+  isInstance: z.boolean().optional(),
+  hasComponentId: z.boolean().optional(),
+  // Visibility
+  isVisible: z.boolean().optional(),
+  // Fill/style conditions
+  hasFills: z.boolean().optional(),
+  hasStrokes: z.boolean().optional(),
+  hasEffects: z.boolean().optional(),
+  // Depth condition
+  minDepth: z.number().optional(),
+  maxDepth: z.number().optional()
 });
-var invisibleLayerDef = {
-  id: "invisible-layer",
-  name: "Invisible Layer",
-  category: "ai-readability",
-  why: "Hidden layers add noise and may confuse analysis tools",
-  impact: "Exported code may include unnecessary elements",
-  fix: "Delete hidden layers or move them to a separate 'archive' page"
-};
-var invisibleLayerCheck = (node, context) => {
-  if (node.visible !== false) return null;
-  if (context.parent?.visible === false) return null;
-  return {
-    ruleId: invisibleLayerDef.id,
-    nodeId: node.id,
-    nodePath: context.path.join(" > "),
-    message: `"${node.name}" is hidden - consider removing if not needed`
-  };
-};
-defineRule({
-  definition: invisibleLayerDef,
-  check: invisibleLayerCheck
+var CustomRuleSchema = z.object({
+  id: z.string(),
+  category: CategorySchema,
+  severity: SeveritySchema,
+  score: z.number().int().max(0),
+  match: MatchConditionSchema,
+  message: z.string().optional(),
+  why: z.string(),
+  impact: z.string(),
+  fix: z.string(),
+  // Backward compat: silently ignore the old prompt field
+  prompt: z.string().optional()
 });
-var emptyFrameDef = {
-  id: "empty-frame",
-  name: "Empty Frame",
-  category: "ai-readability",
-  why: "Empty frames add noise and may indicate incomplete design",
-  impact: "Generates unnecessary wrapper elements in code",
-  fix: "Remove the frame or add content"
-};
-var emptyFrameCheck = (node, context) => {
-  if (node.type !== "FRAME") return null;
-  if (node.children && node.children.length > 0) return null;
-  if (node.absoluteBoundingBox) {
-    const { width, height } = node.absoluteBoundingBox;
-    if (width <= 48 && height <= 48) return null;
+var CustomRulesFileSchema = z.array(CustomRuleSchema);
+
+// src/core/rules/custom/custom-rule-loader.ts
+async function loadCustomRules(filePath) {
+  const absPath = resolve(filePath);
+  const raw = await readFile(absPath, "utf-8");
+  const parsed = JSON.parse(raw);
+  const customRules = CustomRulesFileSchema.parse(parsed);
+  const rules = [];
+  const configs = {};
+  for (const cr of customRules) {
+    if (!cr.match) continue;
+    rules.push(toRule(cr));
+    configs[cr.id] = {
+      severity: cr.severity,
+      score: cr.score,
+      enabled: true
+    };
   }
+  return { rules, configs };
+}
+function toRule(cr) {
   return {
-    ruleId: emptyFrameDef.id,
-    nodeId: node.id,
-    nodePath: context.path.join(" > "),
-    message: `"${node.name}" is an empty frame`
+    definition: {
+      id: cr.id,
+      name: cr.id.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()),
+      category: cr.category,
+      why: cr.why,
+      impact: cr.impact,
+      fix: cr.fix
+    },
+    check: createPatternCheck(cr)
+  };
+}
+function createPatternCheck(cr) {
+  return (node, context) => {
+    if (node.type === "DOCUMENT" || node.type === "CANVAS") return null;
+    const match = cr.match;
+    if (match.type && !match.type.includes(node.type)) return null;
+    if (match.notType && match.notType.includes(node.type)) return null;
+    if (match.nameContains !== void 0 && !node.name.toLowerCase().includes(match.nameContains.toLowerCase())) return null;
+    if (match.nameNotContains !== void 0 && node.name.toLowerCase().includes(match.nameNotContains.toLowerCase())) return null;
+    if (match.namePattern !== void 0 && !new RegExp(match.namePattern, "i").test(node.name)) return null;
+    const bbox = node.absoluteBoundingBox;
+    if (match.minWidth !== void 0 && (!bbox || bbox.width < match.minWidth)) return null;
+    if (match.maxWidth !== void 0 && (!bbox || bbox.width > match.maxWidth)) return null;
+    if (match.minHeight !== void 0 && (!bbox || bbox.height < match.minHeight)) return null;
+    if (match.maxHeight !== void 0 && (!bbox || bbox.height > match.maxHeight)) return null;
+    if (match.hasAutoLayout === true && !node.layoutMode) return null;
+    if (match.hasAutoLayout === false && node.layoutMode) return null;
+    if (match.hasChildren === true && (!node.children || node.children.length === 0)) return null;
+    if (match.hasChildren === false && node.children && node.children.length > 0) return null;
+    if (match.minChildren !== void 0 && (!node.children || node.children.length < match.minChildren)) return null;
+    if (match.maxChildren !== void 0 && node.children && node.children.length > match.maxChildren) return null;
+    if (match.isComponent === true && node.type !== "COMPONENT" && node.type !== "COMPONENT_SET") return null;
+    if (match.isComponent === false && (node.type === "COMPONENT" || node.type === "COMPONENT_SET")) return null;
+    if (match.isInstance === true && node.type !== "INSTANCE") return null;
+    if (match.isInstance === false && node.type === "INSTANCE") return null;
+    if (match.hasComponentId === true && !node.componentId) return null;
+    if (match.hasComponentId === false && node.componentId) return null;
+    if (match.isVisible === true && !node.visible) return null;
+    if (match.isVisible === false && node.visible) return null;
+    if (match.hasFills === true && (!node.fills || node.fills.length === 0)) return null;
+    if (match.hasFills === false && node.fills && node.fills.length > 0) return null;
+    if (match.hasStrokes === true && (!node.strokes || node.strokes.length === 0)) return null;
+    if (match.hasStrokes === false && node.strokes && node.strokes.length > 0) return null;
+    if (match.hasEffects === true && (!node.effects || node.effects.length === 0)) return null;
+    if (match.hasEffects === false && node.effects && node.effects.length > 0) return null;
+    if (match.minDepth !== void 0 && context.depth < match.minDepth) return null;
+    if (match.maxDepth !== void 0 && context.depth > match.maxDepth) return null;
+    const msg = (cr.message ?? `"${node.name}" matched custom rule "${cr.id}"`).replace(/\{name\}/g, node.name).replace(/\{type\}/g, node.type);
+    return {
+      ruleId: cr.id,
+      nodeId: node.id,
+      nodePath: context.path.join(" > "),
+      message: msg
+    };
   };
+}
+
+// src/core/monitoring/events.ts
+var EVENT_PREFIX = "cic_";
+var EVENTS = {
+  // Analysis
+  ANALYSIS_STARTED: `${EVENT_PREFIX}analysis_started`,
+  ANALYSIS_COMPLETED: `${EVENT_PREFIX}analysis_completed`,
+  ANALYSIS_FAILED: `${EVENT_PREFIX}analysis_failed`,
+  // Report
+  REPORT_GENERATED: `${EVENT_PREFIX}report_generated`,
+  COMMENT_POSTED: `${EVENT_PREFIX}comment_posted`,
+  COMMENT_FAILED: `${EVENT_PREFIX}comment_failed`,
+  // MCP
+  MCP_TOOL_CALLED: `${EVENT_PREFIX}mcp_tool_called`,
+  // CLI
+  CLI_COMMAND: `${EVENT_PREFIX}cli_command`,
+  CLI_INIT: `${EVENT_PREFIX}cli_init`
 };
-defineRule({
-  definition: emptyFrameDef,
-  check: emptyFrameCheck
-});
 
-// src/core/rules/handoff-risk/index.ts
-function hasAutoLayout3(node) {
-  return node.layoutMode !== void 0 && node.layoutMode !== "NONE";
+// src/core/monitoring/capture.ts
+var monitoringEnabled = false;
+var posthogApiKey;
+var sentryDsn;
+var distinctId = "anonymous";
+var environment = "unknown";
+var version2 = "unknown";
+var commonProps = {};
+function uuid4() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
 }
-function isContainerNode3(node) {
-  return node.type === "FRAME" || node.type === "GROUP" || node.type === "COMPONENT";
+function parseSentryDsn(dsn) {
+  try {
+    const url = new URL(dsn);
+    const key = url.username;
+    const projectId = url.pathname.slice(1);
+    const host = url.protocol + "//" + url.host;
+    if (!key || !projectId) return null;
+    return { key, host, projectId };
+  } catch {
+    return null;
+  }
 }
-function isTextNode(node) {
-  return node.type === "TEXT";
+function initCapture(config2) {
+  if (config2.enabled === false) return;
+  if (!config2.posthogApiKey && !config2.sentryDsn) return;
+  monitoringEnabled = true;
+  posthogApiKey = config2.posthogApiKey;
+  sentryDsn = config2.sentryDsn;
+  distinctId = config2.distinctId ?? "anonymous";
+  environment = config2.environment ?? "unknown";
+  version2 = config2.version ?? "unknown";
+  commonProps = {
+    _sdk: "canicode",
+    _sdk_version: version2,
+    _env: environment
+  };
 }
-function isImageNode(node) {
-  if (node.type === "RECTANGLE" && node.fills) {
-    for (const fill of node.fills) {
-      const fillObj = fill;
-      if (fillObj["type"] === "IMAGE") return true;
+function captureEvent(event, properties) {
+  if (!monitoringEnabled || !posthogApiKey) return;
+  try {
+    fetch("https://us.i.posthog.com/i/v0/e/", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        api_key: posthogApiKey,
+        event,
+        distinct_id: distinctId,
+        properties: { ...commonProps, ...properties },
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      })
+    }).catch(() => {
+    });
+  } catch {
+  }
+}
+function captureError(error, context) {
+  if (!monitoringEnabled) return;
+  if (sentryDsn) {
+    const parsed = parseSentryDsn(sentryDsn);
+    if (parsed) {
+      try {
+        const eventId = uuid4();
+        const envelope = [
+          JSON.stringify({ event_id: eventId, sent_at: (/* @__PURE__ */ new Date()).toISOString(), dsn: sentryDsn }),
+          JSON.stringify({ type: "event", content_type: "application/json" }),
+          JSON.stringify({
+            event_id: eventId,
+            exception: { values: [{ type: error.name, value: error.message }] },
+            platform: "node",
+            environment,
+            release: `canicode@${version2}`,
+            timestamp: Date.now() / 1e3,
+            extra: context
+          })
+        ].join("\n");
+        fetch(`${parsed.host}/api/${parsed.projectId}/envelope/`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/x-sentry-envelope",
+            "X-Sentry-Auth": `Sentry sentry_version=7, sentry_key=${parsed.key}`
+          },
+          body: envelope
+        }).catch(() => {
+        });
+      } catch {
+      }
     }
   }
-  return false;
+  captureEvent("cic_error", { error: error.message, ...context });
 }
-var hardcodeRiskDef = {
-  id: "hardcode-risk",
-  name: "Hardcode Risk",
-  category: "handoff-risk",
-  why: "Absolute positioning with fixed values creates inflexible layouts",
-  impact: "Layout will break when content changes or on different screens",
-  fix: "Use Auto Layout with relative positioning"
-};
-var hardcodeRiskCheck = (node, context) => {
-  if (!isContainerNode3(node)) return null;
-  if (node.layoutPositioning !== "ABSOLUTE") return null;
-  if (context.parent && hasAutoLayout3(context.parent)) {
-    return {
-      ruleId: hardcodeRiskDef.id,
-      nodeId: node.id,
-      nodePath: context.path.join(" > "),
-      message: `"${node.name}" uses absolute positioning with fixed values`
-    };
+function shutdownCapture() {
+  monitoringEnabled = false;
+  posthogApiKey = void 0;
+  sentryDsn = void 0;
+  distinctId = "anonymous";
+  environment = "unknown";
+  version2 = "unknown";
+  commonProps = {};
+}
+
+// src/core/monitoring/index.ts
+function initMonitoring(config2) {
+  initCapture(config2);
+}
+function trackEvent(event, properties) {
+  try {
+    captureEvent(event, properties);
+  } catch {
   }
-  return null;
-};
-defineRule({
-  definition: hardcodeRiskDef,
-  check: hardcodeRiskCheck
-});
-var textTruncationUnhandledDef = {
-  id: "text-truncation-unhandled",
-  name: "Text Truncation Unhandled",
-  category: "handoff-risk",
-  why: "Text nodes without truncation handling may overflow",
-  impact: "Long text will break the layout",
-  fix: "Set text truncation (ellipsis) or ensure container can grow"
-};
-var textTruncationUnhandledCheck = (node, context) => {
-  if (!isTextNode(node)) return null;
-  if (!context.parent) return null;
-  if (!hasAutoLayout3(context.parent)) return null;
-  if (node.absoluteBoundingBox) {
-    const { width } = node.absoluteBoundingBox;
-    if (node.characters && node.characters.length > 50 && width < 300) {
-      return {
-        ruleId: textTruncationUnhandledDef.id,
-        nodeId: node.id,
-        nodePath: context.path.join(" > "),
-        message: `"${node.name}" may need text truncation handling`
-      };
-    }
+}
+function trackError(error, context) {
+  try {
+    captureError(error, context);
+  } catch {
   }
-  return null;
-};
-defineRule({
-  definition: textTruncationUnhandledDef,
-  check: textTruncationUnhandledCheck
-});
-var imageNoPlaceholderDef = {
-  id: "image-no-placeholder",
-  name: "Image No Placeholder",
-  category: "handoff-risk",
-  why: "Images without placeholder state may cause layout shifts",
-  impact: "Poor user experience during image loading",
-  fix: "Define a placeholder state or background color"
-};
-var imageNoPlaceholderCheck = (node, context) => {
-  if (!isImageNode(node)) return null;
-  if (node.fills && Array.isArray(node.fills) && node.fills.length === 1) {
-    const fill = node.fills[0];
-    if (fill["type"] === "IMAGE") {
-      return {
-        ruleId: imageNoPlaceholderDef.id,
-        nodeId: node.id,
-        nodePath: context.path.join(" > "),
-        message: `"${node.name}" image has no placeholder fill`
-      };
-    }
+}
+function shutdownMonitoring() {
+  try {
+    shutdownCapture();
+  } catch {
   }
-  return null;
-};
-defineRule({
-  definition: imageNoPlaceholderDef,
-  check: imageNoPlaceholderCheck
-});
-var prototypeLinkInDesignDef = {
-  id: "prototype-link-in-design",
-  name: "Prototype Link in Design",
-  category: "handoff-risk",
-  why: "Prototype connections may affect how the design is interpreted",
-  impact: "Developers may misunderstand which elements should be interactive",
-  fix: "Document interactions separately or use clear naming"
-};
-var prototypeLinkInDesignCheck = (_node, _context) => {
-  return null;
-};
-defineRule({
-  definition: prototypeLinkInDesignDef,
-  check: prototypeLinkInDesignCheck
-});
-var noDevStatusDef = {
-  id: "no-dev-status",
-  name: "No Dev Status",
-  category: "handoff-risk",
-  why: "Without dev status, developers cannot know if a design is ready",
-  impact: "May implement designs that are still in progress",
-  fix: "Mark frames as 'Ready for Dev' or 'Completed' when appropriate"
-};
-var noDevStatusCheck = (node, context) => {
-  if (node.type !== "FRAME") return null;
-  if (context.depth > 1) return null;
-  if (node.devStatus) return null;
-  return {
-    ruleId: noDevStatusDef.id,
-    nodeId: node.id,
-    nodePath: context.path.join(" > "),
-    message: `"${node.name}" has no dev status set`
-  };
-};
-defineRule({
-  definition: noDevStatusDef,
-  check: noDevStatusCheck
-});
+}
+
+// src/core/monitoring/keys.ts
+var POSTHOG_API_KEY = "phc_rBFeG140KqJLpUnlpYDEFgdMM6JozZeqQsf9twXf5Dq" ;
+var SENTRY_DSN = "https://80a836a8300b25f17ef5bbf23afb5b3a@o4511080656207872.ingest.us.sentry.io/4511080661319680" ;
 
 // src/mcp/server.ts
 config();
@@ -3127,16 +3607,21 @@ Two ways to provide design data:
 
 Typical flow with Figma MCP (recommended, no token needed):
   Step 1: Call the official Figma MCP's get_metadata tool to get the node tree
-  Step 2: Pass the result as designData to this tool
+  Step 2: Call the official Figma MCP's get_design_context tool on the same node to get style data
+  Step 3: Pass get_metadata result as designData and get_design_context code as designContext to this tool
+
+The designContext parameter enriches analysis with style information (colors, layout, spacing, effects)
+that get_metadata alone cannot provide. Without it, token and layout rules may not fire.
 
 IMPORTANT \u2014 Before calling this tool, check which data source is available:
-- If the official Figma MCP (https://mcp.figma.com/mcp) is connected: use get_metadata \u2192 designData flow. No token needed.
+- If the official Figma MCP (https://mcp.figma.com/mcp) is connected: use get_metadata + get_design_context \u2192 designData + designContext flow. No token needed.
 - If Figma MCP is NOT connected: use the input parameter with a Figma URL. This requires a FIGMA_TOKEN.
   Tell the user: "The official Figma MCP server is not connected. To use without a token, set it up:
   claude mcp add -s project -t http figma https://mcp.figma.com/mcp
   Otherwise, provide a Figma API token via FIGMA_TOKEN env var or the token parameter."`,
   {
     designData: z.string().optional().describe("Figma node data from Figma MCP get_metadata (XML or JSON). Pass this instead of input when using Figma MCP."),
+    designContext: z.string().optional().describe("Code output from Figma MCP get_design_context. Enriches designData with style info (colors, layout, spacing, effects). Highly recommended alongside designData."),
     input: z.string().optional().describe("Figma URL. Used when designData is not provided. Requires FIGMA_TOKEN."),
     fileKey: z.string().optional().describe("Figma file key (used with designData to generate deep links)"),
     fileName: z.string().optional().describe("Figma file name (used with designData for display)"),
@@ -3152,13 +3637,16 @@ IMPORTANT \u2014 Before calling this tool, check which data source is available:
     openWorldHint: true,
     title: "Analyze Figma Design"
   },
-  async ({ designData, input, fileKey, fileName, token, preset, targetNodeId, configPath, customRulesPath }) => {
+  async ({ designData, designContext, input, fileKey, fileName, token, preset, targetNodeId, configPath, customRulesPath }) => {
     trackEvent(EVENTS.MCP_TOOL_CALLED, { tool: "analyze" });
     try {
       let file;
       let nodeId;
       if (designData) {
         file = parseDesignData(designData, fileKey ?? "unknown", fileName);
+        if (designContext) {
+          enrichWithDesignContext(file, designContext, targetNodeId);
+        }
       } else if (input) {
         const loaded = await loadFile(input, token);
         file = loaded.file;
@@ -3191,10 +3679,10 @@ IMPORTANT \u2014 Before calling this tool, check which data source is available:
       const ts = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}-${String(now.getHours()).padStart(2, "0")}-${String(now.getMinutes()).padStart(2, "0")}`;
       ensureReportsDir();
       const reportPath = `${getReportsDir()}/report-${ts}-${file.fileKey}.html`;
-      await new Promise((resolve4, reject) => {
+      await new Promise((resolve6, reject) => {
         writeFile(reportPath, html, "utf-8", (err) => {
           if (err) reject(err);
-          else resolve4();
+          else resolve6();
         });
       });
       const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
@@ -3217,6 +3705,7 @@ IMPORTANT \u2014 Before calling this tool, check which data source is available:
             type: "text",
             text: JSON.stringify(
               {
+                version: pkg.version,
                 fileName: file.name,
                 nodeCount: result.nodeCount,
                 maxDepth: result.maxDepth,
@@ -3309,16 +3798,16 @@ Use this when the user asks about customization, configuration, rule settings, o
   },
   async ({ topic }) => {
     const { readFile: readFile4 } = await import('fs/promises');
-    const { resolve: resolve4, dirname } = await import('path');
+    const { resolve: resolve6, dirname: dirname2 } = await import('path');
     const { fileURLToPath } = await import('url');
     try {
-      const __dirname = dirname(fileURLToPath(import.meta.url));
-      const docPath = resolve4(__dirname, "../../docs/CUSTOMIZATION.md");
+      const __dirname = dirname2(fileURLToPath(import.meta.url));
+      const docPath = resolve6(__dirname, "../../docs/CUSTOMIZATION.md");
       let content;
       try {
         content = await readFile4(docPath, "utf-8");
       } catch {
-        const altPath = resolve4(__dirname, "../docs/CUSTOMIZATION.md");
+        const altPath = resolve6(__dirname, "../docs/CUSTOMIZATION.md");
         content = await readFile4(altPath, "utf-8");
       }
       if (topic && topic !== "all") {
@@ -3337,7 +3826,9 @@ Use this when the user asks about customization, configuration, rule settings, o
         }
       }
       return {
-        content: [{ type: "text", text: content }]
+        content: [{ type: "text", text: `canicode v${pkg.version}
+
+${content}` }]
       };
     } catch {
       return {