canicode 0.8.0 → 0.8.2

package/dist/mcp/server.js

@@ -1361,2006 +1361,2253 @@ function parseDesignData(data, fileKey, fileName) {
   );
 }
 
-// src/core/engine/scoring.ts
-var SEVERITY_DENSITY_WEIGHT = {
-  blocking: 3,
-  risk: 2,
-  "missing-info": 1,
-  suggestion: 0.5
+// package.json
+var version = "0.8.2";
+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)
+  })
+});
+
+// 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 hasTextContent(node) {
+  return node.type === "TEXT" || (node.children?.some((c) => c.type === "TEXT") ?? false);
+}
+var noAutoLayoutDef = {
+  id: "no-auto-layout",
+  name: "No Auto Layout",
+  category: "layout",
+  why: "Frames without Auto Layout require manual positioning for every element",
+  impact: "Layout breaks on content changes, harder to maintain and scale",
+  fix: "Apply Auto Layout to the frame with appropriate direction and spacing"
 };
-var TOTAL_RULES_PER_CATEGORY = {
-  layout: 11,
-  token: 7,
-  component: 6,
-  naming: 5,
-  "ai-readability": 5,
-  "handoff-risk": 5
+var noAutoLayoutCheck = (node, context) => {
+  if (node.type !== "FRAME") return null;
+  if (hasAutoLayout(node)) return null;
+  if (!node.children || node.children.length === 0) return null;
+  return {
+    ruleId: noAutoLayoutDef.id,
+    nodeId: node.id,
+    nodePath: context.path.join(" > "),
+    message: `Frame "${node.name}" has no Auto Layout`
+  };
 };
-var CATEGORY_WEIGHT = {
-  layout: 1,
-  token: 1,
-  component: 1,
-  naming: 1,
-  "ai-readability": 1,
-  "handoff-risk": 1
+defineRule({
+  definition: noAutoLayoutDef,
+  check: noAutoLayoutCheck
+});
+var absolutePositionInAutoLayoutDef = {
+  id: "absolute-position-in-auto-layout",
+  name: "Absolute Position in Auto Layout",
+  category: "layout",
+  why: "Absolute positioning inside Auto Layout breaks the automatic flow",
+  impact: "Element will not respond to sibling changes, may overlap unexpectedly",
+  fix: "Remove absolute positioning or use proper Auto Layout alignment"
 };
-var DENSITY_WEIGHT = 0.7;
-var DIVERSITY_WEIGHT = 0.3;
-var SCORE_FLOOR = 5;
-function calculateGrade(percentage) {
-  if (percentage >= 95) return "S";
-  if (percentage >= 90) return "A+";
-  if (percentage >= 85) return "A";
-  if (percentage >= 80) return "B+";
-  if (percentage >= 75) return "B";
-  if (percentage >= 70) return "C+";
-  if (percentage >= 65) return "C";
-  if (percentage >= 50) return "D";
-  return "F";
-}
-function clamp(value, min, max) {
-  return Math.max(min, Math.min(max, value));
+function isSmallRelativeToParent(node, parent) {
+  const nodeBB = node.absoluteBoundingBox;
+  const parentBB = parent.absoluteBoundingBox;
+  if (!nodeBB || !parentBB) return false;
+  if (parentBB.width === 0 || parentBB.height === 0) return false;
+  const widthRatio = nodeBB.width / parentBB.width;
+  const heightRatio = nodeBB.height / parentBB.height;
+  return widthRatio < 0.25 && heightRatio < 0.25;
 }
-function calculateScores(result) {
-  const categoryScores = initializeCategoryScores();
-  const nodeCount = result.nodeCount;
-  const uniqueRulesPerCategory = /* @__PURE__ */ new Map();
-  for (const category of CATEGORIES) {
-    uniqueRulesPerCategory.set(category, /* @__PURE__ */ new Set());
-  }
-  for (const issue of result.issues) {
-    const category = issue.rule.definition.category;
-    const severity = issue.config.severity;
-    const ruleId = issue.rule.definition.id;
-    categoryScores[category].issueCount++;
-    categoryScores[category].bySeverity[severity]++;
-    categoryScores[category].weightedIssueCount += SEVERITY_DENSITY_WEIGHT[severity];
-    uniqueRulesPerCategory.get(category).add(ruleId);
-  }
-  for (const category of CATEGORIES) {
-    const catScore = categoryScores[category];
-    const uniqueRules = uniqueRulesPerCategory.get(category);
-    const totalRules = TOTAL_RULES_PER_CATEGORY[category];
-    catScore.uniqueRuleCount = uniqueRules.size;
-    let densityScore = 100;
-    if (nodeCount > 0 && catScore.issueCount > 0) {
-      const density = catScore.weightedIssueCount / nodeCount;
-      densityScore = clamp(Math.round(100 - density * 100), 0, 100);
-    }
-    catScore.densityScore = densityScore;
-    let diversityScore = 100;
-    if (catScore.issueCount > 0) {
-      const diversityRatio = uniqueRules.size / totalRules;
-      diversityScore = clamp(Math.round((1 - diversityRatio) * 100), 0, 100);
-    }
-    catScore.diversityScore = diversityScore;
-    const combinedScore = densityScore * DENSITY_WEIGHT + diversityScore * DIVERSITY_WEIGHT;
-    catScore.percentage = catScore.issueCount > 0 ? clamp(Math.round(combinedScore), SCORE_FLOOR, 100) : 100;
-    catScore.score = catScore.percentage;
-    catScore.maxScore = 100;
-  }
-  let totalWeight = 0;
-  let weightedSum = 0;
-  for (const category of CATEGORIES) {
-    const weight = CATEGORY_WEIGHT[category];
-    weightedSum += categoryScores[category].percentage * weight;
-    totalWeight += weight;
-  }
-  const overallPercentage = totalWeight > 0 ? Math.round(weightedSum / totalWeight) : 100;
-  const summary = {
-    totalIssues: result.issues.length,
-    blocking: 0,
-    risk: 0,
-    missingInfo: 0,
-    suggestion: 0,
-    nodeCount
+var absolutePositionInAutoLayoutCheck = (node, context) => {
+  if (!context.parent) return null;
+  if (!hasAutoLayout(context.parent)) return null;
+  if (node.layoutPositioning !== "ABSOLUTE") return null;
+  if (node.type === "VECTOR" || node.type === "BOOLEAN_OPERATION" || node.type === "LINE" || node.type === "ELLIPSE" || node.type === "STAR" || node.type === "REGULAR_POLYGON") return null;
+  if (isExcludedName(node.name)) return null;
+  if (isSmallRelativeToParent(node, context.parent)) return null;
+  if (context.parent.type === "COMPONENT") return null;
+  return {
+    ruleId: absolutePositionInAutoLayoutDef.id,
+    nodeId: node.id,
+    nodePath: context.path.join(" > "),
+    message: `"${node.name}" uses absolute positioning inside Auto Layout parent "${context.parent.name}". If intentional (badge, overlay, close button), rename to badge-*, overlay-*, close-* to suppress this warning.`
   };
-  for (const issue of result.issues) {
-    switch (issue.config.severity) {
-      case "blocking":
-        summary.blocking++;
-        break;
-      case "risk":
-        summary.risk++;
-        break;
-      case "missing-info":
-        summary.missingInfo++;
-        break;
-      case "suggestion":
-        summary.suggestion++;
-        break;
-    }
+};
+defineRule({
+  definition: absolutePositionInAutoLayoutDef,
+  check: absolutePositionInAutoLayoutCheck
+});
+var fixedWidthInResponsiveContextDef = {
+  id: "fixed-width-in-responsive-context",
+  name: "Fixed Width in Responsive Context",
+  category: "layout",
+  why: "Fixed width inside Auto Layout prevents responsive behavior",
+  impact: "Content will not adapt to container size changes",
+  fix: "Use 'Fill' or 'Hug' instead of fixed width"
+};
+var fixedWidthInResponsiveContextCheck = (node, context) => {
+  if (!context.parent) return null;
+  if (!hasAutoLayout(context.parent)) return null;
+  if (!isContainerNode(node)) return null;
+  if (node.layoutSizingHorizontal) {
+    if (node.layoutSizingHorizontal !== "FIXED") return null;
+  } else {
+    if (node.layoutAlign === "STRETCH") return null;
+    if (!node.absoluteBoundingBox) return null;
+    if (node.layoutAlign !== "INHERIT") return null;
   }
+  if (isExcludedName(node.name)) return null;
   return {
-    overall: {
-      score: overallPercentage,
-      maxScore: 100,
-      percentage: overallPercentage,
-      grade: calculateGrade(overallPercentage)
-    },
-    byCategory: categoryScores,
-    summary
+    ruleId: fixedWidthInResponsiveContextDef.id,
+    nodeId: node.id,
+    nodePath: context.path.join(" > "),
+    message: `"${node.name}" has fixed width inside Auto Layout`
   };
-}
-function initializeCategoryScores() {
-  const scores = {};
-  for (const category of CATEGORIES) {
-    scores[category] = {
-      category,
-      score: 100,
-      maxScore: 100,
-      percentage: 100,
-      issueCount: 0,
-      uniqueRuleCount: 0,
-      weightedIssueCount: 0,
-      densityScore: 100,
-      diversityScore: 100,
-      bySeverity: {
-        blocking: 0,
-        risk: 0,
-        "missing-info": 0,
-        suggestion: 0
-      }
-    };
-  }
-  return scores;
-}
-function formatScoreSummary(report) {
-  const lines = [];
-  lines.push(`Overall: ${report.overall.grade} (${report.overall.percentage}%)`);
-  lines.push("");
-  lines.push("By Category:");
-  for (const category of CATEGORIES) {
-    const cat = report.byCategory[category];
-    lines.push(`  ${category}: ${cat.percentage}% (${cat.issueCount} issues, ${cat.uniqueRuleCount} rules)`);
-  }
-  lines.push("");
-  lines.push("Issues:");
-  lines.push(`  Blocking: ${report.summary.blocking}`);
-  lines.push(`  Risk: ${report.summary.risk}`);
-  lines.push(`  Missing Info: ${report.summary.missingInfo}`);
-  lines.push(`  Suggestion: ${report.summary.suggestion}`);
-  lines.push(`  Total: ${report.summary.totalIssues}`);
-  return lines.join("\n");
-}
-
-// src/core/ui-constants.ts
-var GAUGE_R = 54;
-var GAUGE_C = Math.round(2 * Math.PI * GAUGE_R);
-var CATEGORY_DESCRIPTIONS = {
-  layout: "Auto Layout, responsive constraints, nesting depth, absolute positioning",
-  token: "Design token binding for colors, fonts, shadows, spacing grid",
-  component: "Component reuse, detached instances, variant coverage",
-  naming: "Semantic layer names, naming conventions, default names",
-  "ai-readability": "Structure clarity for AI code generation, z-index, empty frames",
-  "handoff-risk": "Hardcoded values, text truncation, image placeholders, dev status"
-};
-var SEVERITY_ORDER = [
-  "blocking",
-  "risk",
-  "missing-info",
-  "suggestion"
-];
-
-// src/core/ui-helpers.ts
-function gaugeColor(pct) {
-  if (pct >= 75) return "#22c55e";
-  if (pct >= 50) return "#f59e0b";
-  return "#ef4444";
-}
-function escapeHtml(text) {
-  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
-}
-function severityDot(sev) {
-  const map = {
-    blocking: "bg-red-500",
-    risk: "bg-amber-500",
-    "missing-info": "bg-zinc-400",
-    suggestion: "bg-green-500"
-  };
-  return map[sev];
-}
-function severityBadge(sev) {
-  const map = {
-    blocking: "bg-red-500/10 text-red-600 border-red-500/20",
-    risk: "bg-amber-500/10 text-amber-600 border-amber-500/20",
-    "missing-info": "bg-zinc-500/10 text-zinc-600 border-zinc-500/20",
-    suggestion: "bg-green-500/10 text-green-600 border-green-500/20"
-  };
-  return map[sev];
-}
-function scoreBadgeStyle(pct) {
-  if (pct >= 75) return "bg-green-500/10 text-green-700 border-green-500/20";
-  if (pct >= 50) return "bg-amber-500/10 text-amber-700 border-amber-500/20";
-  return "bg-red-500/10 text-red-700 border-red-500/20";
-}
-function renderGaugeSvg(pct, size, strokeW, grade) {
-  const offset = GAUGE_C * (1 - pct / 100);
-  const color = gaugeColor(pct);
-  if (grade) {
-    return `<svg width="${size}" height="${size}" viewBox="0 0 120 120" class="gauge-svg block">
-            <circle cx="60" cy="60" r="${GAUGE_R}" fill="none" stroke-width="${strokeW}" stroke="#e4e4e7" class="stroke-border" />
-            <circle cx="60" cy="60" r="${GAUGE_R}" fill="none" stroke="${color}" stroke-width="${strokeW}" stroke-linecap="round" stroke-dasharray="${GAUGE_C}" stroke-dashoffset="${offset}" transform="rotate(-90 60 60)" class="gauge-fill" />
-            <text x="60" y="60" text-anchor="middle" dominant-baseline="central" fill="currentColor" font-size="48" font-weight="700" font-family="Inter,-apple-system,sans-serif" class="font-sans">${escapeHtml(grade)}</text>
-          </svg>`;
-  }
-  return `<svg width="${size}" height="${size}" viewBox="0 0 120 120" class="gauge-svg block">
-            <circle cx="60" cy="60" r="${GAUGE_R}" fill="none" stroke-width="${strokeW}" stroke="#e4e4e7" class="stroke-border" />
-            <circle cx="60" cy="60" r="${GAUGE_R}" fill="none" stroke="${color}" stroke-width="${strokeW}" stroke-linecap="round" stroke-dasharray="${GAUGE_C}" stroke-dashoffset="${offset}" transform="rotate(-90 60 60)" class="gauge-fill" />
-            <text x="60" y="62" text-anchor="middle" dominant-baseline="central" fill="currentColor" font-size="28" font-weight="700" font-family="Inter,-apple-system,sans-serif" class="font-sans">${pct}</text>
-          </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;
-
-      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 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()
+};
+defineRule({
+  definition: fixedWidthInResponsiveContextDef,
+  check: fixedWidthInResponsiveContextCheck
 });
-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`
+var missingResponsiveBehaviorDef = {
+  id: "missing-responsive-behavior",
+  name: "Missing Responsive Behavior",
+  category: "layout",
+  why: "Elements without constraints won't adapt to different screen sizes",
+  impact: "Layout will break or look wrong on different devices",
+  fix: "Set appropriate constraints (left/right, top/bottom, scale, etc.)"
 };
-
-// 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;
+var missingResponsiveBehaviorCheck = (node, context) => {
+  if (!isContainerNode(node)) return null;
+  if (context.parent && hasAutoLayout(context.parent)) return null;
+  if (context.depth < 2) return null;
+  if (!hasAutoLayout(node) && !node.layoutAlign) {
+    return {
+      ruleId: missingResponsiveBehaviorDef.id,
+      nodeId: node.id,
+      nodePath: context.path.join(" > "),
+      message: `"${node.name}" has no responsive behavior configured`
+    };
   }
-}
-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
+  return null;
+};
+defineRule({
+  definition: missingResponsiveBehaviorDef,
+  check: missingResponsiveBehaviorCheck
+});
+var groupUsageDef = {
+  id: "group-usage",
+  name: "Group Usage",
+  category: "layout",
+  why: "Groups don't support Auto Layout and have limited layout control",
+  impact: "Harder to maintain consistent spacing and alignment",
+  fix: "Convert Group to Frame and apply Auto Layout"
+};
+var groupUsageCheck = (node, context) => {
+  if (node.type !== "GROUP") return null;
+  return {
+    ruleId: groupUsageDef.id,
+    nodeId: node.id,
+    nodePath: context.path.join(" > "),
+    message: `"${node.name}" is a Group - consider converting to Frame with Auto Layout`
   };
-}
-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 {
+};
+defineRule({
+  definition: groupUsageDef,
+  check: groupUsageCheck
+});
+var fixedSizeInAutoLayoutDef = {
+  id: "fixed-size-in-auto-layout",
+  name: "Fixed Size in Auto Layout",
+  category: "layout",
+  why: "Fixed sizes inside Auto Layout limit flexibility",
+  impact: "Element won't adapt to content or container changes",
+  fix: "Consider using 'Hug' for content-driven sizing"
+};
+var fixedSizeInAutoLayoutCheck = (node, context) => {
+  if (!context.parent) return null;
+  if (!hasAutoLayout(context.parent)) return null;
+  if (!isContainerNode(node)) return null;
+  if (!node.absoluteBoundingBox) return null;
+  const { width, height } = node.absoluteBoundingBox;
+  if (width <= 48 && height <= 48) return null;
+  return null;
+};
+defineRule({
+  definition: fixedSizeInAutoLayoutDef,
+  check: fixedSizeInAutoLayoutCheck
+});
+var missingMinWidthDef = {
+  id: "missing-min-width",
+  name: "Missing Min Width",
+  category: "layout",
+  why: "Without min-width, containers can collapse to unusable sizes",
+  impact: "Text truncation or layout collapse on narrow screens",
+  fix: "Set a minimum width constraint on the container"
+};
+var missingMinWidthCheck = (node, context) => {
+  if (!isContainerNode(node) && !hasTextContent(node)) return null;
+  if (node.absoluteBoundingBox) {
+    const { width, height } = node.absoluteBoundingBox;
+    if (width <= 48 && height <= 24) return null;
   }
-}
-
-// 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 hasTextContent(node) {
-  return node.type === "TEXT" || (node.children?.some((c) => c.type === "TEXT") ?? false);
-}
-var noAutoLayoutDef = {
-  id: "no-auto-layout",
-  name: "No Auto Layout",
+  if (!context.parent || !hasAutoLayout(context.parent)) return null;
+  return null;
+};
+defineRule({
+  definition: missingMinWidthDef,
+  check: missingMinWidthCheck
+});
+var missingMaxWidthDef = {
+  id: "missing-max-width",
+  name: "Missing Max Width",
   category: "layout",
-  why: "Frames without Auto Layout require manual positioning for every element",
-  impact: "Layout breaks on content changes, harder to maintain and scale",
-  fix: "Apply Auto Layout to the frame with appropriate direction and spacing"
+  why: "Without max-width, content can stretch too wide on large screens",
+  impact: "Poor readability and layout on wide screens",
+  fix: "Set a maximum width constraint, especially for text containers"
 };
-var noAutoLayoutCheck = (node, context) => {
-  if (node.type !== "FRAME") return null;
-  if (hasAutoLayout(node)) return null;
-  if (!node.children || node.children.length === 0) return null;
+var missingMaxWidthCheck = (node, _context) => {
+  if (!isContainerNode(node) && !hasTextContent(node)) return null;
+  if (node.absoluteBoundingBox) {
+    const { width } = node.absoluteBoundingBox;
+    if (width <= 200) return null;
+  }
+  return null;
+};
+defineRule({
+  definition: missingMaxWidthDef,
+  check: missingMaxWidthCheck
+});
+var deepNestingDef = {
+  id: "deep-nesting",
+  name: "Deep Nesting",
+  category: "layout",
+  why: "Deep nesting makes the structure hard to understand and maintain",
+  impact: "Increases complexity, harder to debug layout issues",
+  fix: "Flatten the structure by removing unnecessary wrapper frames"
+};
+var deepNestingCheck = (node, context, options) => {
+  const maxDepth = options?.["maxDepth"] ?? getRuleOption("deep-nesting", "maxDepth", 5);
+  if (context.depth < maxDepth) return null;
+  if (!isContainerNode(node)) return null;
   return {
-    ruleId: noAutoLayoutDef.id,
+    ruleId: deepNestingDef.id,
     nodeId: node.id,
     nodePath: context.path.join(" > "),
-    message: `Frame "${node.name}" has no Auto Layout`
+    message: `"${node.name}" is nested ${context.depth} levels deep (max: ${maxDepth})`
   };
 };
 defineRule({
-  definition: noAutoLayoutDef,
-  check: noAutoLayoutCheck
+  definition: deepNestingDef,
+  check: deepNestingCheck
 });
-var absolutePositionInAutoLayoutDef = {
-  id: "absolute-position-in-auto-layout",
-  name: "Absolute Position in Auto Layout",
+var overflowHiddenAbuseDef = {
+  id: "overflow-hidden-abuse",
+  name: "Overflow Hidden Abuse",
   category: "layout",
-  why: "Absolute positioning inside Auto Layout breaks the automatic flow",
-  impact: "Element will not respond to sibling changes, may overlap unexpectedly",
-  fix: "Remove absolute positioning or use proper Auto Layout alignment"
+  why: "Using clip content to hide layout problems masks underlying issues",
+  impact: "Content may be unintentionally cut off, problems harder to diagnose",
+  fix: "Fix the underlying layout issue instead of hiding overflow"
 };
-function isSmallRelativeToParent(node, parent) {
-  const nodeBB = node.absoluteBoundingBox;
-  const parentBB = parent.absoluteBoundingBox;
-  if (!nodeBB || !parentBB) return false;
-  if (parentBB.width === 0 || parentBB.height === 0) return false;
-  const widthRatio = nodeBB.width / parentBB.width;
-  const heightRatio = nodeBB.height / parentBB.height;
-  return widthRatio < 0.25 && heightRatio < 0.25;
+var overflowHiddenAbuseCheck = (_node, _context) => {
+  return null;
+};
+defineRule({
+  definition: overflowHiddenAbuseDef,
+  check: overflowHiddenAbuseCheck
+});
+var inconsistentSiblingLayoutDirectionDef = {
+  id: "inconsistent-sibling-layout-direction",
+  name: "Inconsistent Sibling Layout Direction",
+  category: "layout",
+  why: "Sibling containers with mixed layout directions without clear reason create confusion",
+  impact: "Harder to understand and maintain the design structure",
+  fix: "Use consistent layout direction for similar sibling elements"
+};
+var inconsistentSiblingLayoutDirectionCheck = (node, context) => {
+  if (!isContainerNode(node)) return null;
+  if (!context.siblings || context.siblings.length < 2) return null;
+  const siblingContainers = context.siblings.filter(
+    (s) => isContainerNode(s) && s.id !== node.id
+  );
+  if (siblingContainers.length === 0) return null;
+  const myDirection = node.layoutMode;
+  if (!myDirection || myDirection === "NONE") return null;
+  const siblingDirections = siblingContainers.map((s) => s.layoutMode).filter((d) => d && d !== "NONE");
+  if (siblingDirections.length === 0) return null;
+  const allSameSiblingDirection = siblingDirections.every(
+    (d) => d === siblingDirections[0]
+  );
+  if (allSameSiblingDirection && siblingDirections[0] !== myDirection) {
+    if (context.parent?.layoutMode === "HORIZONTAL" && myDirection === "VERTICAL") {
+      return null;
+    }
+    return {
+      ruleId: inconsistentSiblingLayoutDirectionDef.id,
+      nodeId: node.id,
+      nodePath: context.path.join(" > "),
+      message: `"${node.name}" has ${myDirection} layout while siblings use ${siblingDirections[0]}`
+    };
+  }
+  return null;
+};
+defineRule({
+  definition: inconsistentSiblingLayoutDirectionDef,
+  check: inconsistentSiblingLayoutDirectionCheck
+});
+
+// src/core/rules/token/index.ts
+function hasStyleReference(node, styleType) {
+  return node.styles !== void 0 && styleType in node.styles;
 }
-var absolutePositionInAutoLayoutCheck = (node, context) => {
-  if (!context.parent) return null;
-  if (!hasAutoLayout(context.parent)) return null;
-  if (node.layoutPositioning !== "ABSOLUTE") return null;
-  if (node.type === "VECTOR" || node.type === "BOOLEAN_OPERATION" || node.type === "LINE" || node.type === "ELLIPSE" || node.type === "STAR" || node.type === "REGULAR_POLYGON") return null;
-  if (isExcludedName(node.name)) return null;
-  if (isSmallRelativeToParent(node, context.parent)) return null;
-  if (context.parent.type === "COMPONENT") return null;
+function hasBoundVariable(node, key) {
+  return node.boundVariables !== void 0 && key in node.boundVariables;
+}
+function isOnGrid(value, gridBase) {
+  return value % gridBase === 0;
+}
+var rawColorDef = {
+  id: "raw-color",
+  name: "Raw Color",
+  category: "token",
+  why: "Raw hex colors are not connected to the design system",
+  impact: "Color changes require manual updates across the entire design",
+  fix: "Use a color style or variable instead of raw hex values"
+};
+var rawColorCheck = (node, context) => {
+  if (!node.fills || !Array.isArray(node.fills)) return null;
+  if (node.fills.length === 0) return null;
+  if (hasStyleReference(node, "fill")) return null;
+  if (hasBoundVariable(node, "fills")) return null;
+  for (const fill of node.fills) {
+    const fillObj = fill;
+    if (fillObj["type"] === "SOLID" && fillObj["color"]) {
+      return {
+        ruleId: rawColorDef.id,
+        nodeId: node.id,
+        nodePath: context.path.join(" > "),
+        message: `"${node.name}" uses raw color without style or variable`
+      };
+    }
+  }
+  return null;
+};
+defineRule({
+  definition: rawColorDef,
+  check: rawColorCheck
+});
+var rawFontDef = {
+  id: "raw-font",
+  name: "Raw Font",
+  category: "token",
+  why: "Text without text styles is disconnected from the type system",
+  impact: "Typography changes require manual updates across the design",
+  fix: "Apply a text style to maintain consistency"
+};
+var rawFontCheck = (node, context) => {
+  if (node.type !== "TEXT") return null;
+  if (hasStyleReference(node, "text")) return null;
+  if (hasBoundVariable(node, "fontFamily") || hasBoundVariable(node, "fontSize")) {
+    return null;
+  }
   return {
-    ruleId: absolutePositionInAutoLayoutDef.id,
+    ruleId: rawFontDef.id,
     nodeId: node.id,
     nodePath: context.path.join(" > "),
-    message: `"${node.name}" uses absolute positioning inside Auto Layout parent "${context.parent.name}". If intentional (badge, overlay, close button), rename to badge-*, overlay-*, close-* to suppress this warning.`
+    message: `"${node.name}" has no text style applied`
   };
 };
 defineRule({
-  definition: absolutePositionInAutoLayoutDef,
-  check: absolutePositionInAutoLayoutCheck
+  definition: rawFontDef,
+  check: rawFontCheck
 });
-var fixedWidthInResponsiveContextDef = {
-  id: "fixed-width-in-responsive-context",
-  name: "Fixed Width in Responsive Context",
-  category: "layout",
-  why: "Fixed width inside Auto Layout prevents responsive behavior",
-  impact: "Content will not adapt to container size changes",
-  fix: "Use 'Fill' or 'Hug' instead of fixed width"
+var inconsistentSpacingDef = {
+  id: "inconsistent-spacing",
+  name: "Inconsistent Spacing",
+  category: "token",
+  why: "Spacing values outside the grid system break visual consistency",
+  impact: "Inconsistent visual rhythm and harder to maintain",
+  fix: "Use spacing values from the design system grid (e.g., 8pt increments)"
 };
-var fixedWidthInResponsiveContextCheck = (node, context) => {
-  if (!context.parent) return null;
-  if (!hasAutoLayout(context.parent)) return null;
-  if (!isContainerNode(node)) return null;
-  if (node.layoutSizingHorizontal) {
-    if (node.layoutSizingHorizontal !== "FIXED") return null;
-  } else {
-    if (node.layoutAlign === "STRETCH") return null;
-    if (!node.absoluteBoundingBox) return null;
-    if (node.layoutAlign !== "INHERIT") return null;
+var inconsistentSpacingCheck = (node, context, options) => {
+  const gridBase = options?.["gridBase"] ?? getRuleOption("inconsistent-spacing", "gridBase", 4);
+  const paddings = [
+    node.paddingLeft,
+    node.paddingRight,
+    node.paddingTop,
+    node.paddingBottom
+  ].filter((p) => p !== void 0 && p > 0);
+  for (const padding of paddings) {
+    if (!isOnGrid(padding, gridBase)) {
+      return {
+        ruleId: inconsistentSpacingDef.id,
+        nodeId: node.id,
+        nodePath: context.path.join(" > "),
+        message: `"${node.name}" has padding ${padding}px not on ${gridBase}pt grid`
+      };
+    }
+  }
+  if (node.itemSpacing !== void 0 && node.itemSpacing > 0) {
+    if (!isOnGrid(node.itemSpacing, gridBase)) {
+      return {
+        ruleId: inconsistentSpacingDef.id,
+        nodeId: node.id,
+        nodePath: context.path.join(" > "),
+        message: `"${node.name}" has item spacing ${node.itemSpacing}px not on ${gridBase}pt grid`
+      };
+    }
+  }
+  return null;
+};
+defineRule({
+  definition: inconsistentSpacingDef,
+  check: inconsistentSpacingCheck
+});
+var magicNumberSpacingDef = {
+  id: "magic-number-spacing",
+  name: "Magic Number Spacing",
+  category: "token",
+  why: "Arbitrary spacing values make the system harder to understand",
+  impact: "Unpredictable spacing, harder to create consistent layouts",
+  fix: "Round spacing to the nearest grid value or use spacing tokens"
+};
+var magicNumberSpacingCheck = (node, context, options) => {
+  const gridBase = options?.["gridBase"] ?? getRuleOption("magic-number-spacing", "gridBase", 4);
+  const allSpacings = [
+    node.paddingLeft,
+    node.paddingRight,
+    node.paddingTop,
+    node.paddingBottom,
+    node.itemSpacing
+  ].filter((s) => s !== void 0 && s > 0);
+  for (const spacing of allSpacings) {
+    const commonValues = [1, 2, 4];
+    if (!isOnGrid(spacing, gridBase) && !commonValues.includes(spacing)) {
+      if (spacing % 2 !== 0 && spacing > 4) {
+        return {
+          ruleId: magicNumberSpacingDef.id,
+          nodeId: node.id,
+          nodePath: context.path.join(" > "),
+          message: `"${node.name}" uses magic number spacing: ${spacing}px`
+        };
+      }
+    }
+  }
+  return null;
+};
+defineRule({
+  definition: magicNumberSpacingDef,
+  check: magicNumberSpacingCheck
+});
+var rawShadowDef = {
+  id: "raw-shadow",
+  name: "Raw Shadow",
+  category: "token",
+  why: "Shadow effects without styles are disconnected from the design system",
+  impact: "Shadow changes require manual updates across the design",
+  fix: "Create and apply an effect style for shadows"
+};
+var rawShadowCheck = (node, context) => {
+  if (!node.effects || !Array.isArray(node.effects)) return null;
+  if (node.effects.length === 0) return null;
+  if (hasStyleReference(node, "effect")) return null;
+  for (const effect of node.effects) {
+    const effectObj = effect;
+    if (effectObj["type"] === "DROP_SHADOW" || effectObj["type"] === "INNER_SHADOW") {
+      return {
+        ruleId: rawShadowDef.id,
+        nodeId: node.id,
+        nodePath: context.path.join(" > "),
+        message: `"${node.name}" has shadow effect without effect style`
+      };
+    }
   }
-  if (isExcludedName(node.name)) return null;
-  return {
-    ruleId: fixedWidthInResponsiveContextDef.id,
-    nodeId: node.id,
-    nodePath: context.path.join(" > "),
-    message: `"${node.name}" has fixed width inside Auto Layout`
-  };
+  return null;
 };
 defineRule({
-  definition: fixedWidthInResponsiveContextDef,
-  check: fixedWidthInResponsiveContextCheck
+  definition: rawShadowDef,
+  check: rawShadowCheck
 });
-var missingResponsiveBehaviorDef = {
-  id: "missing-responsive-behavior",
-  name: "Missing Responsive Behavior",
-  category: "layout",
-  why: "Elements without constraints won't adapt to different screen sizes",
-  impact: "Layout will break or look wrong on different devices",
-  fix: "Set appropriate constraints (left/right, top/bottom, scale, etc.)"
+var rawOpacityDef = {
+  id: "raw-opacity",
+  name: "Raw Opacity",
+  category: "token",
+  why: "Hardcoded opacity values are not connected to design tokens",
+  impact: "Opacity changes require manual updates",
+  fix: "Use opacity variables or consider if opacity is truly needed"
 };
-var missingResponsiveBehaviorCheck = (node, context) => {
-  if (!isContainerNode(node)) return null;
-  if (context.parent && hasAutoLayout(context.parent)) return null;
-  if (context.depth < 2) return null;
-  if (!hasAutoLayout(node) && !node.layoutAlign) {
-    return {
-      ruleId: missingResponsiveBehaviorDef.id,
-      nodeId: node.id,
-      nodePath: context.path.join(" > "),
-      message: `"${node.name}" has no responsive behavior configured`
-    };
-  }
+var rawOpacityCheck = (node, _context) => {
+  if (hasBoundVariable(node, "opacity")) return null;
   return null;
 };
 defineRule({
-  definition: missingResponsiveBehaviorDef,
-  check: missingResponsiveBehaviorCheck
+  definition: rawOpacityDef,
+  check: rawOpacityCheck
 });
-var groupUsageDef = {
-  id: "group-usage",
-  name: "Group Usage",
-  category: "layout",
-  why: "Groups don't support Auto Layout and have limited layout control",
-  impact: "Harder to maintain consistent spacing and alignment",
-  fix: "Convert Group to Frame and apply Auto Layout"
+var multipleFillColorsDef = {
+  id: "multiple-fill-colors",
+  name: "Multiple Fill Colors",
+  category: "token",
+  why: "Similar but slightly different colors indicate inconsistent token usage",
+  impact: "Visual inconsistency and harder to maintain brand colors",
+  fix: "Consolidate to a single color token or style"
 };
-var groupUsageCheck = (node, context) => {
-  if (node.type !== "GROUP") return null;
-  return {
-    ruleId: groupUsageDef.id,
-    nodeId: node.id,
-    nodePath: context.path.join(" > "),
-    message: `"${node.name}" is a Group - consider converting to Frame with Auto Layout`
-  };
+var multipleFillColorsCheck = (_node, _context, _options) => {
+  return null;
 };
 defineRule({
-  definition: groupUsageDef,
-  check: groupUsageCheck
+  definition: multipleFillColorsDef,
+  check: multipleFillColorsCheck
 });
-var fixedSizeInAutoLayoutDef = {
-  id: "fixed-size-in-auto-layout",
-  name: "Fixed Size in Auto Layout",
-  category: "layout",
-  why: "Fixed sizes inside Auto Layout limit flexibility",
-  impact: "Element won't adapt to content or container changes",
-  fix: "Consider using 'Hug' for content-driven sizing"
+
+// src/core/rules/component/index.ts
+function isComponentInstance(node) {
+  return node.type === "INSTANCE";
+}
+function isComponent(node) {
+  return node.type === "COMPONENT" || node.type === "COMPONENT_SET";
+}
+function collectFrameNames(node, names = /* @__PURE__ */ new Map()) {
+  if (node.type === "FRAME" && node.name) {
+    const existing = names.get(node.name) ?? [];
+    existing.push(node.id);
+    names.set(node.name, existing);
+  }
+  if (node.children) {
+    for (const child of node.children) {
+      collectFrameNames(child, names);
+    }
+  }
+  return names;
+}
+var missingComponentDef = {
+  id: "missing-component",
+  name: "Missing Component",
+  category: "component",
+  why: "Repeated identical structures should be componentized",
+  impact: "Changes require manual updates in multiple places",
+  fix: "Create a component from the repeated structure"
 };
-var fixedSizeInAutoLayoutCheck = (node, context) => {
-  if (!context.parent) return null;
-  if (!hasAutoLayout(context.parent)) return null;
-  if (!isContainerNode(node)) return null;
-  if (!node.absoluteBoundingBox) return null;
-  const { width, height } = node.absoluteBoundingBox;
-  if (width <= 48 && height <= 48) return null;
+var missingComponentCheck = (node, context, options) => {
+  if (node.type !== "FRAME") return null;
+  const minRepetitions = options?.["minRepetitions"] ?? getRuleOption("missing-component", "minRepetitions", 3);
+  const frameNames = collectFrameNames(context.file.document);
+  const sameNameFrames = frameNames.get(node.name);
+  if (sameNameFrames && sameNameFrames.length >= minRepetitions) {
+    if (sameNameFrames[0] === node.id) {
+      return {
+        ruleId: missingComponentDef.id,
+        nodeId: node.id,
+        nodePath: context.path.join(" > "),
+        message: `"${node.name}" appears ${sameNameFrames.length} times - consider making it a component`
+      };
+    }
+  }
   return null;
 };
 defineRule({
-  definition: fixedSizeInAutoLayoutDef,
-  check: fixedSizeInAutoLayoutCheck
+  definition: missingComponentDef,
+  check: missingComponentCheck
 });
-var missingMinWidthDef = {
-  id: "missing-min-width",
-  name: "Missing Min Width",
-  category: "layout",
-  why: "Without min-width, containers can collapse to unusable sizes",
-  impact: "Text truncation or layout collapse on narrow screens",
-  fix: "Set a minimum width constraint on the container"
+var detachedInstanceDef = {
+  id: "detached-instance",
+  name: "Detached Instance",
+  category: "component",
+  why: "Detached instances lose their connection to the source component",
+  impact: "Updates to the component won't propagate to this instance",
+  fix: "Reset the instance or create a new variant if customization is needed"
 };
-var missingMinWidthCheck = (node, context) => {
-  if (!isContainerNode(node) && !hasTextContent(node)) return null;
-  if (node.absoluteBoundingBox) {
-    const { width, height } = node.absoluteBoundingBox;
-    if (width <= 48 && height <= 24) return null;
+var detachedInstanceCheck = (node, context) => {
+  if (node.type !== "FRAME") return null;
+  const components = context.file.components;
+  const nodeName = node.name.toLowerCase();
+  for (const [, component] of Object.entries(components)) {
+    if (nodeName.includes(component.name.toLowerCase())) {
+      return {
+        ruleId: detachedInstanceDef.id,
+        nodeId: node.id,
+        nodePath: context.path.join(" > "),
+        message: `"${node.name}" may be a detached instance of component "${component.name}"`
+      };
+    }
   }
-  if (!context.parent || !hasAutoLayout(context.parent)) return null;
   return null;
 };
 defineRule({
-  definition: missingMinWidthDef,
-  check: missingMinWidthCheck
+  definition: detachedInstanceDef,
+  check: detachedInstanceCheck
 });
-var missingMaxWidthDef = {
-  id: "missing-max-width",
-  name: "Missing Max Width",
-  category: "layout",
-  why: "Without max-width, content can stretch too wide on large screens",
-  impact: "Poor readability and layout on wide screens",
-  fix: "Set a maximum width constraint, especially for text containers"
+var nestedInstanceOverrideDef = {
+  id: "nested-instance-override",
+  name: "Nested Instance Override",
+  category: "component",
+  why: "Excessive overrides in instances make components harder to maintain",
+  impact: "Component updates may not work as expected",
+  fix: "Create a variant or new component for significantly different use cases"
 };
-var missingMaxWidthCheck = (node, _context) => {
-  if (!isContainerNode(node) && !hasTextContent(node)) return null;
-  if (node.absoluteBoundingBox) {
-    const { width } = node.absoluteBoundingBox;
-    if (width <= 200) return null;
+var nestedInstanceOverrideCheck = (node, context) => {
+  if (!isComponentInstance(node)) return null;
+  if (!node.componentProperties) return null;
+  const overrideCount = Object.keys(node.componentProperties).length;
+  if (overrideCount > 5) {
+    return {
+      ruleId: nestedInstanceOverrideDef.id,
+      nodeId: node.id,
+      nodePath: context.path.join(" > "),
+      message: `"${node.name}" has ${overrideCount} property overrides - consider creating a variant`
+    };
   }
   return null;
 };
 defineRule({
-  definition: missingMaxWidthDef,
-  check: missingMaxWidthCheck
+  definition: nestedInstanceOverrideDef,
+  check: nestedInstanceOverrideCheck
 });
-var deepNestingDef = {
-  id: "deep-nesting",
-  name: "Deep Nesting",
-  category: "layout",
-  why: "Deep nesting makes the structure hard to understand and maintain",
-  impact: "Increases complexity, harder to debug layout issues",
-  fix: "Flatten the structure by removing unnecessary wrapper frames"
+var variantNotUsedDef = {
+  id: "variant-not-used",
+  name: "Variant Not Used",
+  category: "component",
+  why: "Using instances but not leveraging variants defeats their purpose",
+  impact: "Manual changes instead of using designed variants",
+  fix: "Use the appropriate variant instead of overriding the default"
 };
-var deepNestingCheck = (node, context, options) => {
-  const maxDepth = options?.["maxDepth"] ?? getRuleOption("deep-nesting", "maxDepth", 5);
-  if (context.depth < maxDepth) return null;
-  if (!isContainerNode(node)) return null;
-  return {
-    ruleId: deepNestingDef.id,
-    nodeId: node.id,
-    nodePath: context.path.join(" > "),
-    message: `"${node.name}" is nested ${context.depth} levels deep (max: ${maxDepth})`
-  };
+var variantNotUsedCheck = (_node, _context) => {
+  return null;
 };
 defineRule({
-  definition: deepNestingDef,
-  check: deepNestingCheck
+  definition: variantNotUsedDef,
+  check: variantNotUsedCheck
 });
-var overflowHiddenAbuseDef = {
-  id: "overflow-hidden-abuse",
-  name: "Overflow Hidden Abuse",
-  category: "layout",
-  why: "Using clip content to hide layout problems masks underlying issues",
-  impact: "Content may be unintentionally cut off, problems harder to diagnose",
-  fix: "Fix the underlying layout issue instead of hiding overflow"
+var componentPropertyUnusedDef = {
+  id: "component-property-unused",
+  name: "Component Property Unused",
+  category: "component",
+  why: "Component properties should be utilized to expose customization",
+  impact: "Hardcoded values that should be configurable",
+  fix: "Connect the value to a component property"
 };
-var overflowHiddenAbuseCheck = (_node, _context) => {
+var componentPropertyUnusedCheck = (node, _context) => {
+  if (!isComponent(node)) return null;
+  if (!node.componentPropertyDefinitions) return null;
+  const definedProps = Object.keys(node.componentPropertyDefinitions);
+  if (definedProps.length === 0) return null;
   return null;
 };
 defineRule({
-  definition: overflowHiddenAbuseDef,
-  check: overflowHiddenAbuseCheck
+  definition: componentPropertyUnusedDef,
+  check: componentPropertyUnusedCheck
 });
-var inconsistentSiblingLayoutDirectionDef = {
-  id: "inconsistent-sibling-layout-direction",
-  name: "Inconsistent Sibling Layout Direction",
-  category: "layout",
-  why: "Sibling containers with mixed layout directions without clear reason create confusion",
-  impact: "Harder to understand and maintain the design structure",
-  fix: "Use consistent layout direction for similar sibling elements"
+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 inconsistentSiblingLayoutDirectionCheck = (node, context) => {
-  if (!isContainerNode(node)) return null;
-  if (!context.siblings || context.siblings.length < 2) return null;
-  const siblingContainers = context.siblings.filter(
-    (s) => isContainerNode(s) && s.id !== node.id
-  );
-  if (siblingContainers.length === 0) return null;
-  const myDirection = node.layoutMode;
-  if (!myDirection || myDirection === "NONE") return null;
-  const siblingDirections = siblingContainers.map((s) => s.layoutMode).filter((d) => d && d !== "NONE");
-  if (siblingDirections.length === 0) return null;
-  const allSameSiblingDirection = siblingDirections.every(
-    (d) => d === siblingDirections[0]
-  );
-  if (allSameSiblingDirection && siblingDirections[0] !== myDirection) {
-    if (context.parent?.layoutMode === "HORIZONTAL" && myDirection === "VERTICAL") {
-      return null;
+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: inconsistentSiblingLayoutDirectionDef.id,
+      ruleId: singleUseComponentDef.id,
       nodeId: node.id,
       nodePath: context.path.join(" > "),
-      message: `"${node.name}" has ${myDirection} layout while siblings use ${siblingDirections[0]}`
+      message: `Component "${node.name}" is only used once`
     };
   }
   return null;
 };
 defineRule({
-  definition: inconsistentSiblingLayoutDirectionDef,
-  check: inconsistentSiblingLayoutDirectionCheck
+  definition: singleUseComponentDef,
+  check: singleUseComponentCheck
 });
 
-// src/core/rules/token/index.ts
-function hasStyleReference(node, styleType) {
-  return node.styles !== void 0 && styleType in node.styles;
+// 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 hasBoundVariable(node, key) {
-  return node.boundVariables !== void 0 && key in node.boundVariables;
+function isNonSemanticName(name) {
+  const normalized = name.toLowerCase().trim();
+  return NON_SEMANTIC_NAMES.includes(normalized);
 }
-function isOnGrid(value, gridBase) {
-  return value % gridBase === 0;
+function hasNumericSuffix(name) {
+  return /\s+\d+$/.test(name);
 }
-var rawColorDef = {
-  id: "raw-color",
-  name: "Raw Color",
-  category: "token",
-  why: "Raw hex colors are not connected to the design system",
-  impact: "Color changes require manual updates across the entire design",
-  fix: "Use a color style or variable instead of raw hex values"
-};
-var rawColorCheck = (node, context) => {
-  if (!node.fills || !Array.isArray(node.fills)) return null;
-  if (node.fills.length === 0) return null;
-  if (hasStyleReference(node, "fill")) return null;
-  if (hasBoundVariable(node, "fills")) return null;
-  for (const fill of node.fills) {
-    const fillObj = fill;
-    if (fillObj["type"] === "SOLID" && fillObj["color"]) {
-      return {
-        ruleId: rawColorDef.id,
-        nodeId: node.id,
-        nodePath: context.path.join(" > "),
-        message: `"${node.name}" uses raw color without style or variable`
-      };
-    }
-  }
+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')"
 };
-defineRule({
-  definition: rawColorDef,
-  check: rawColorCheck
-});
-var rawFontDef = {
-  id: "raw-font",
-  name: "Raw Font",
-  category: "token",
-  why: "Text without text styles is disconnected from the type system",
-  impact: "Typography changes require manual updates across the design",
-  fix: "Apply a text style to maintain consistency"
-};
-var rawFontCheck = (node, context) => {
-  if (node.type !== "TEXT") return null;
-  if (hasStyleReference(node, "text")) return null;
-  if (hasBoundVariable(node, "fontFamily") || hasBoundVariable(node, "fontSize")) {
-    return null;
-  }
+var defaultNameCheck = (node, context) => {
+  if (!node.name) return null;
+  if (isExcludedName(node.name)) return null;
+  if (!isDefaultName(node.name)) return null;
   return {
-    ruleId: rawFontDef.id,
+    ruleId: defaultNameDef.id,
     nodeId: node.id,
     nodePath: context.path.join(" > "),
-    message: `"${node.name}" has no text style applied`
+    message: `"${node.name}" is a default name - provide a meaningful name`
   };
 };
 defineRule({
-  definition: rawFontDef,
-  check: rawFontCheck
-});
-var inconsistentSpacingDef = {
-  id: "inconsistent-spacing",
-  name: "Inconsistent Spacing",
-  category: "token",
-  why: "Spacing values outside the grid system break visual consistency",
-  impact: "Inconsistent visual rhythm and harder to maintain",
-  fix: "Use spacing values from the design system grid (e.g., 8pt increments)"
-};
-var inconsistentSpacingCheck = (node, context, options) => {
-  const gridBase = options?.["gridBase"] ?? getRuleOption("inconsistent-spacing", "gridBase", 4);
-  const paddings = [
-    node.paddingLeft,
-    node.paddingRight,
-    node.paddingTop,
-    node.paddingBottom
-  ].filter((p) => p !== void 0 && p > 0);
-  for (const padding of paddings) {
-    if (!isOnGrid(padding, gridBase)) {
-      return {
-        ruleId: inconsistentSpacingDef.id,
-        nodeId: node.id,
-        nodePath: context.path.join(" > "),
-        message: `"${node.name}" has padding ${padding}px not on ${gridBase}pt grid`
-      };
-    }
-  }
-  if (node.itemSpacing !== void 0 && node.itemSpacing > 0) {
-    if (!isOnGrid(node.itemSpacing, gridBase)) {
-      return {
-        ruleId: inconsistentSpacingDef.id,
-        nodeId: node.id,
-        nodePath: context.path.join(" > "),
-        message: `"${node.name}" has item spacing ${node.itemSpacing}px not on ${gridBase}pt grid`
-      };
-    }
-  }
-  return null;
-};
-defineRule({
-  definition: inconsistentSpacingDef,
-  check: inconsistentSpacingCheck
+  definition: defaultNameDef,
+  check: defaultNameCheck
 });
-var magicNumberSpacingDef = {
-  id: "magic-number-spacing",
-  name: "Magic Number Spacing",
-  category: "token",
-  why: "Arbitrary spacing values make the system harder to understand",
-  impact: "Unpredictable spacing, harder to create consistent layouts",
-  fix: "Round spacing to the nearest grid value or use spacing tokens"
+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 magicNumberSpacingCheck = (node, context, options) => {
-  const gridBase = options?.["gridBase"] ?? getRuleOption("magic-number-spacing", "gridBase", 4);
-  const allSpacings = [
-    node.paddingLeft,
-    node.paddingRight,
-    node.paddingTop,
-    node.paddingBottom,
-    node.itemSpacing
-  ].filter((s) => s !== void 0 && s > 0);
-  for (const spacing of allSpacings) {
-    const commonValues = [1, 2, 4];
-    if (!isOnGrid(spacing, gridBase) && !commonValues.includes(spacing)) {
-      if (spacing % 2 !== 0 && spacing > 4) {
-        return {
-          ruleId: magicNumberSpacingDef.id,
-          nodeId: node.id,
-          nodePath: context.path.join(" > "),
-          message: `"${node.name}" uses magic number spacing: ${spacing}px`
-        };
-      }
-    }
+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 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: magicNumberSpacingDef,
-  check: magicNumberSpacingCheck
+  definition: nonSemanticNameDef,
+  check: nonSemanticNameCheck
 });
-var rawShadowDef = {
-  id: "raw-shadow",
-  name: "Raw Shadow",
-  category: "token",
-  why: "Shadow effects without styles are disconnected from the design system",
-  impact: "Shadow changes require manual updates across the design",
-  fix: "Create and apply an effect style for shadows"
+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 rawShadowCheck = (node, context) => {
-  if (!node.effects || !Array.isArray(node.effects)) return null;
-  if (node.effects.length === 0) return null;
-  if (hasStyleReference(node, "effect")) return null;
-  for (const effect of node.effects) {
-    const effectObj = effect;
-    if (effectObj["type"] === "DROP_SHADOW" || effectObj["type"] === "INNER_SHADOW") {
-      return {
-        ruleId: rawShadowDef.id,
-        nodeId: node.id,
-        nodePath: context.path.join(" > "),
-        message: `"${node.name}" has shadow effect without effect style`
-      };
+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: rawShadowDef,
-  check: rawShadowCheck
+  definition: inconsistentNamingConventionDef,
+  check: inconsistentNamingConventionCheck
 });
-var rawOpacityDef = {
-  id: "raw-opacity",
-  name: "Raw Opacity",
-  category: "token",
-  why: "Hardcoded opacity values are not connected to design tokens",
-  impact: "Opacity changes require manual updates",
-  fix: "Use opacity variables or consider if opacity is truly needed"
+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 rawOpacityCheck = (node, _context) => {
-  if (hasBoundVariable(node, "opacity")) return null;
-  return null;
+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: rawOpacityDef,
-  check: rawOpacityCheck
+  definition: numericSuffixNameDef,
+  check: numericSuffixNameCheck
 });
-var multipleFillColorsDef = {
-  id: "multiple-fill-colors",
-  name: "Multiple Fill Colors",
-  category: "token",
-  why: "Similar but slightly different colors indicate inconsistent token usage",
-  impact: "Visual inconsistency and harder to maintain brand colors",
-  fix: "Consolidate to a single color token or style"
+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 multipleFillColorsCheck = (_node, _context, _options) => {
-  return null;
+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: multipleFillColorsDef,
-  check: multipleFillColorsCheck
+  definition: tooLongNameDef,
+  check: tooLongNameCheck
 });
 
-// src/core/rules/component/index.ts
-function isComponentInstance(node) {
-  return node.type === "INSTANCE";
+// src/core/rules/ai-readability/index.ts
+function hasAutoLayout2(node) {
+  return node.layoutMode !== void 0 && node.layoutMode !== "NONE";
 }
-function isComponent(node) {
-  return node.type === "COMPONENT" || node.type === "COMPONENT_SET";
+function isContainerNode2(node) {
+  return node.type === "FRAME" || node.type === "GROUP" || node.type === "COMPONENT";
 }
-function collectFrameNames(node, names = /* @__PURE__ */ new Map()) {
-  if (node.type === "FRAME" && node.name) {
-    const existing = names.get(node.name) ?? [];
-    existing.push(node.id);
-    names.set(node.name, existing);
-  }
-  if (node.children) {
-    for (const child of node.children) {
-      collectFrameNames(child, names);
-    }
-  }
-  return names;
+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 missingComponentDef = {
-  id: "missing-component",
-  name: "Missing Component",
-  category: "component",
-  why: "Repeated identical structures should be componentized",
-  impact: "Changes require manual updates in multiple places",
-  fix: "Create a component from the repeated structure"
+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 missingComponentCheck = (node, context, options) => {
-  if (node.type !== "FRAME") return null;
-  const minRepetitions = options?.["minRepetitions"] ?? getRuleOption("missing-component", "minRepetitions", 3);
-  const frameNames = collectFrameNames(context.file.document);
-  const sameNameFrames = frameNames.get(node.name);
-  if (sameNameFrames && sameNameFrames.length >= minRepetitions) {
-    if (sameNameFrames[0] === node.id) {
-      return {
-        ruleId: missingComponentDef.id,
-        nodeId: node.id,
-        nodePath: context.path.join(" > "),
-        message: `"${node.name}" appears ${sameNameFrames.length} times - consider making it a component`
-      };
+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: missingComponentDef,
-  check: missingComponentCheck
+  definition: ambiguousStructureDef,
+  check: ambiguousStructureCheck
 });
-var detachedInstanceDef = {
-  id: "detached-instance",
-  name: "Detached Instance",
-  category: "component",
-  why: "Detached instances lose their connection to the source component",
-  impact: "Updates to the component won't propagate to this instance",
-  fix: "Reset the instance or create a new variant if customization is needed"
+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 detachedInstanceCheck = (node, context) => {
-  if (node.type !== "FRAME") return null;
-  const components = context.file.components;
-  const nodeName = node.name.toLowerCase();
-  for (const [, component] of Object.entries(components)) {
-    if (nodeName.includes(component.name.toLowerCase())) {
-      return {
-        ruleId: detachedInstanceDef.id,
-        nodeId: node.id,
-        nodePath: context.path.join(" > "),
-        message: `"${node.name}" may be a detached instance of component "${component.name}"`
-      };
+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++;
+          }
+        }
+      }
     }
   }
-  return null;
-};
-defineRule({
-  definition: detachedInstanceDef,
-  check: detachedInstanceCheck
-});
-var nestedInstanceOverrideDef = {
-  id: "nested-instance-override",
-  name: "Nested Instance Override",
-  category: "component",
-  why: "Excessive overrides in instances make components harder to maintain",
-  impact: "Component updates may not work as expected",
-  fix: "Create a variant or new component for significantly different use cases"
-};
-var nestedInstanceOverrideCheck = (node, context) => {
-  if (!isComponentInstance(node)) return null;
-  if (!node.componentProperties) return null;
-  const overrideCount = Object.keys(node.componentProperties).length;
-  if (overrideCount > 5) {
+  if (significantOverlapCount > 0) {
     return {
-      ruleId: nestedInstanceOverrideDef.id,
+      ruleId: zIndexDependentLayoutDef.id,
       nodeId: node.id,
       nodePath: context.path.join(" > "),
-      message: `"${node.name}" has ${overrideCount} property overrides - consider creating a variant`
+      message: `"${node.name}" uses layer stacking for layout (${significantOverlapCount} overlaps)`
     };
   }
   return null;
 };
 defineRule({
-  definition: nestedInstanceOverrideDef,
-  check: nestedInstanceOverrideCheck
+  definition: zIndexDependentLayoutDef,
+  check: zIndexDependentLayoutCheck
 });
-var variantNotUsedDef = {
-  id: "variant-not-used",
-  name: "Variant Not Used",
-  category: "component",
-  why: "Using instances but not leveraging variants defeats their purpose",
-  impact: "Manual changes instead of using designed variants",
-  fix: "Use the appropriate variant instead of overriding the default"
+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 variantNotUsedCheck = (_node, _context) => {
+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;
 };
 defineRule({
-  definition: variantNotUsedDef,
-  check: variantNotUsedCheck
+  definition: missingLayoutHintDef,
+  check: missingLayoutHintCheck
 });
-var componentPropertyUnusedDef = {
-  id: "component-property-unused",
-  name: "Component Property Unused",
-  category: "component",
-  why: "Component properties should be utilized to expose customization",
-  impact: "Hardcoded values that should be configurable",
-  fix: "Connect the value to a component property"
+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 componentPropertyUnusedCheck = (node, _context) => {
-  if (!isComponent(node)) return null;
-  if (!node.componentPropertyDefinitions) return null;
-  const definedProps = Object.keys(node.componentPropertyDefinitions);
-  if (definedProps.length === 0) return null;
-  return null;
+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: componentPropertyUnusedDef,
-  check: componentPropertyUnusedCheck
+  definition: invisibleLayerDef,
+  check: invisibleLayerCheck
 });
-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 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 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 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: emptyFrameDef.id,
+    nodeId: node.id,
+    nodePath: context.path.join(" > "),
+    message: `"${node.name}" is an empty frame`
+  };
+};
+defineRule({
+  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;
     }
   }
-  countInstances(context.file.document);
-  if (instanceCount === 1) {
+  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: singleUseComponentDef.id,
+      ruleId: hardcodeRiskDef.id,
       nodeId: node.id,
       nodePath: context.path.join(" > "),
-      message: `Component "${node.name}" is only used once`
+      message: `"${node.name}" uses absolute positioning with fixed values`
     };
   }
   return null;
 };
 defineRule({
-  definition: singleUseComponentDef,
-  check: singleUseComponentCheck
+  definition: hardcodeRiskDef,
+  check: hardcodeRiskCheck
 });
-
-// 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 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`
+      };
+    }
+  }
+  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`
+      };
+    }
+  }
   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: 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: defaultNameDef,
-  check: defaultNameCheck
+  definition: prototypeLinkInDesignDef,
+  check: prototypeLinkInDesignCheck
 });
-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 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 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 noDevStatusCheck = (node, context) => {
+  if (node.type !== "FRAME") return null;
+  if (context.depth > 1) return null;
+  if (node.devStatus) return null;
   return {
-    ruleId: nonSemanticNameDef.id,
+    ruleId: noDevStatusDef.id,
     nodeId: node.id,
     nodePath: context.path.join(" > "),
-    message: `"${node.name}" is a non-semantic name - describe its purpose`
+    message: `"${node.name}" has no dev status set`
   };
 };
 defineRule({
-  definition: nonSemanticNameDef,
-  check: nonSemanticNameCheck
+  definition: noDevStatusDef,
+  check: noDevStatusCheck
 });
-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 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/engine/scoring.ts
+var SEVERITY_DENSITY_WEIGHT = {
+  blocking: 3,
+  risk: 2,
+  "missing-info": 1,
+  suggestion: 0.5
 };
-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 TOTAL_RULES_PER_CATEGORY = {
+  layout: 11,
+  token: 7,
+  component: 6,
+  naming: 5,
+  "ai-readability": 5,
+  "handoff-risk": 5
+};
+var CATEGORY_WEIGHT = {
+  layout: 1,
+  token: 1,
+  component: 1,
+  naming: 1,
+  "ai-readability": 1,
+  "handoff-risk": 1
+};
+var DENSITY_WEIGHT = 0.7;
+var DIVERSITY_WEIGHT = 0.3;
+var SCORE_FLOOR = 5;
+function calculateGrade(percentage) {
+  if (percentage >= 95) return "S";
+  if (percentage >= 90) return "A+";
+  if (percentage >= 85) return "A";
+  if (percentage >= 80) return "B+";
+  if (percentage >= 75) return "B";
+  if (percentage >= 70) return "C+";
+  if (percentage >= 65) return "C";
+  if (percentage >= 50) return "D";
+  return "F";
+}
+function clamp(value, min, max) {
+  return Math.max(min, Math.min(max, value));
+}
+function calculateScores(result) {
+  const categoryScores = initializeCategoryScores();
+  const nodeCount = result.nodeCount;
+  const uniqueRulesPerCategory = /* @__PURE__ */ new Map();
+  for (const category of CATEGORIES) {
+    uniqueRulesPerCategory.set(category, /* @__PURE__ */ new Set());
+  }
+  for (const issue of result.issues) {
+    const category = issue.rule.definition.category;
+    const severity = issue.config.severity;
+    const ruleId = issue.rule.definition.id;
+    categoryScores[category].issueCount++;
+    categoryScores[category].bySeverity[severity]++;
+    categoryScores[category].weightedIssueCount += SEVERITY_DENSITY_WEIGHT[severity];
+    uniqueRulesPerCategory.get(category).add(ruleId);
+  }
+  for (const category of CATEGORIES) {
+    const catScore = categoryScores[category];
+    const uniqueRules = uniqueRulesPerCategory.get(category);
+    const totalRules = TOTAL_RULES_PER_CATEGORY[category];
+    catScore.uniqueRuleCount = uniqueRules.size;
+    let densityScore = 100;
+    if (nodeCount > 0 && catScore.issueCount > 0) {
+      const density = catScore.weightedIssueCount / nodeCount;
+      densityScore = clamp(Math.round(100 - density * 100), 0, 100);
+    }
+    catScore.densityScore = densityScore;
+    let diversityScore = 100;
+    if (catScore.issueCount > 0) {
+      const diversityRatio = uniqueRules.size / totalRules;
+      diversityScore = clamp(Math.round((1 - diversityRatio) * 100), 0, 100);
+    }
+    catScore.diversityScore = diversityScore;
+    const combinedScore = densityScore * DENSITY_WEIGHT + diversityScore * DIVERSITY_WEIGHT;
+    catScore.percentage = catScore.issueCount > 0 ? clamp(Math.round(combinedScore), SCORE_FLOOR, 100) : 100;
+    catScore.score = catScore.percentage;
+    catScore.maxScore = 100;
+  }
+  let totalWeight = 0;
+  let weightedSum = 0;
+  for (const category of CATEGORIES) {
+    const weight = CATEGORY_WEIGHT[category];
+    weightedSum += categoryScores[category].percentage * weight;
+    totalWeight += weight;
+  }
+  const overallPercentage = totalWeight > 0 ? Math.round(weightedSum / totalWeight) : 100;
+  const summary = {
+    totalIssues: result.issues.length,
+    blocking: 0,
+    risk: 0,
+    missingInfo: 0,
+    suggestion: 0,
+    nodeCount
+  };
+  for (const issue of result.issues) {
+    switch (issue.config.severity) {
+      case "blocking":
+        summary.blocking++;
+        break;
+      case "risk":
+        summary.risk++;
+        break;
+      case "missing-info":
+        summary.missingInfo++;
+        break;
+      case "suggestion":
+        summary.suggestion++;
+        break;
     }
   }
-  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 {
+    overall: {
+      score: overallPercentage,
+      maxScore: 100,
+      percentage: overallPercentage,
+      grade: calculateGrade(overallPercentage)
+    },
+    byCategory: categoryScores,
+    summary
+  };
+}
+function initializeCategoryScores() {
+  const scores = {};
+  for (const category of CATEGORIES) {
+    scores[category] = {
+      category,
+      score: 100,
+      maxScore: 100,
+      percentage: 100,
+      issueCount: 0,
+      uniqueRuleCount: 0,
+      weightedIssueCount: 0,
+      densityScore: 100,
+      diversityScore: 100,
+      bySeverity: {
+        blocking: 0,
+        risk: 0,
+        "missing-info": 0,
+        suggestion: 0
+      }
+    };
+  }
+  return scores;
+}
+function formatScoreSummary(report) {
+  const lines = [];
+  lines.push(`Overall: ${report.overall.grade} (${report.overall.percentage}%)`);
+  lines.push("");
+  lines.push("By Category:");
+  for (const category of CATEGORIES) {
+    const cat = report.byCategory[category];
+    lines.push(`  ${category}: ${cat.percentage}% (${cat.issueCount} issues, ${cat.uniqueRuleCount} rules)`);
   }
-  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}`
-    };
+  lines.push("");
+  lines.push("Issues:");
+  lines.push(`  Blocking: ${report.summary.blocking}`);
+  lines.push(`  Risk: ${report.summary.risk}`);
+  lines.push(`  Missing Info: ${report.summary.missingInfo}`);
+  lines.push(`  Suggestion: ${report.summary.suggestion}`);
+  lines.push(`  Total: ${report.summary.totalIssues}`);
+  return lines.join("\n");
+}
+function buildResultJson(fileName, result, scores) {
+  const issuesByRule = {};
+  for (const issue of result.issues) {
+    const id = issue.violation.ruleId;
+    issuesByRule[id] = (issuesByRule[id] ?? 0) + 1;
   }
-  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`
+    version,
+    fileName,
+    nodeCount: result.nodeCount,
+    maxDepth: result.maxDepth,
+    issueCount: result.issues.length,
+    scores: {
+      overall: scores.overall,
+      categories: scores.byCategory
+    },
+    issuesByRule,
+    summary: formatScoreSummary(scores)
   };
+}
+
+// src/core/ui-constants.ts
+var GAUGE_R = 54;
+var GAUGE_C = Math.round(2 * Math.PI * GAUGE_R);
+var CATEGORY_DESCRIPTIONS = {
+  layout: "Auto Layout, responsive constraints, nesting depth, absolute positioning",
+  token: "Design token binding for colors, fonts, shadows, spacing grid",
+  component: "Component reuse, detached instances, variant coverage",
+  naming: "Semantic layer names, naming conventions, default names",
+  "ai-readability": "Structure clarity for AI code generation, z-index, empty frames",
+  "handoff-risk": "Hardcoded values, text truncation, image placeholders, dev status"
 };
-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})`
+var SEVERITY_ORDER = [
+  "blocking",
+  "risk",
+  "missing-info",
+  "suggestion"
+];
+
+// src/core/ui-helpers.ts
+function gaugeColor(pct) {
+  if (pct >= 75) return "#22c55e";
+  if (pct >= 50) return "#f59e0b";
+  return "#ef4444";
+}
+function escapeHtml(text) {
+  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
+}
+function severityDot(sev) {
+  const map = {
+    blocking: "bg-red-500",
+    risk: "bg-amber-500",
+    "missing-info": "bg-zinc-400",
+    suggestion: "bg-green-500"
   };
-};
-defineRule({
-  definition: tooLongNameDef,
-  check: tooLongNameCheck
-});
+  return map[sev];
+}
+function severityBadge(sev) {
+  const map = {
+    blocking: "bg-red-500/10 text-red-600 border-red-500/20",
+    risk: "bg-amber-500/10 text-amber-600 border-amber-500/20",
+    "missing-info": "bg-zinc-500/10 text-zinc-600 border-zinc-500/20",
+    suggestion: "bg-green-500/10 text-green-600 border-green-500/20"
+  };
+  return map[sev];
+}
+function scoreBadgeStyle(pct) {
+  if (pct >= 75) return "bg-green-500/10 text-green-700 border-green-500/20";
+  if (pct >= 50) return "bg-amber-500/10 text-amber-700 border-amber-500/20";
+  return "bg-red-500/10 text-red-700 border-red-500/20";
+}
+function renderGaugeSvg(pct, size, strokeW, grade) {
+  const offset = GAUGE_C * (1 - pct / 100);
+  const color = gaugeColor(pct);
+  if (grade) {
+    return `<svg width="${size}" height="${size}" viewBox="0 0 120 120" class="gauge-svg block">
+            <circle cx="60" cy="60" r="${GAUGE_R}" fill="none" stroke-width="${strokeW}" stroke="#e4e4e7" class="stroke-border" />
+            <circle cx="60" cy="60" r="${GAUGE_R}" fill="none" stroke="${color}" stroke-width="${strokeW}" stroke-linecap="round" stroke-dasharray="${GAUGE_C}" stroke-dashoffset="${offset}" transform="rotate(-90 60 60)" class="gauge-fill" />
+            <text x="60" y="60" text-anchor="middle" dominant-baseline="central" fill="currentColor" font-size="48" font-weight="700" font-family="Inter,-apple-system,sans-serif" class="font-sans">${escapeHtml(grade)}</text>
+          </svg>`;
+  }
+  return `<svg width="${size}" height="${size}" viewBox="0 0 120 120" class="gauge-svg block">
+            <circle cx="60" cy="60" r="${GAUGE_R}" fill="none" stroke-width="${strokeW}" stroke="#e4e4e7" class="stroke-border" />
+            <circle cx="60" cy="60" r="${GAUGE_R}" fill="none" stroke="${color}" stroke-width="${strokeW}" stroke-linecap="round" stroke-dasharray="${GAUGE_C}" stroke-dashoffset="${offset}" transform="rotate(-90 60 60)" class="gauge-fill" />
+            <text x="60" y="62" text-anchor="middle" dominant-baseline="central" fill="currentColor" font-size="28" font-weight="700" font-family="Inter,-apple-system,sans-serif" class="font-sans">${pct}</text>
+          </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>
 
-// 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();
@@ -3445,17 +3692,16 @@ IMPORTANT \u2014 Before calling this tool, check which data source is available:
         ...effectiveNodeId ? { targetNodeId: effectiveNodeId } : {}
       });
       const scores = calculateScores(result);
-      const summary = formatScoreSummary(scores);
       const figmaToken = token ?? process.env["FIGMA_TOKEN"];
       const html = generateHtmlReport(file, result, scores, { figmaToken });
       const now = /* @__PURE__ */ new Date();
       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";
@@ -3467,31 +3713,11 @@ IMPORTANT \u2014 Before calling this tool, check which data source is available:
         percentage: scores.overall.percentage,
         source: designData ? "mcp-data" : "url"
       });
-      const issuesByRule = {};
-      for (const issue of result.issues) {
-        const id = issue.violation.ruleId;
-        issuesByRule[id] = (issuesByRule[id] ?? 0) + 1;
-      }
       return {
         content: [
           {
             type: "text",
-            text: JSON.stringify(
-              {
-                fileName: file.name,
-                nodeCount: result.nodeCount,
-                maxDepth: result.maxDepth,
-                issueCount: result.issues.length,
-                scores: {
-                  overall: scores.overall,
-                  categories: scores.byCategory
-                },
-                issuesByRule,
-                summary
-              },
-              null,
-              2
-            )
+            text: JSON.stringify(buildResultJson(file.name, result, scores), null, 2)
           }
         ]
       };
@@ -3548,6 +3774,20 @@ server.tool(
     };
   }
 );
+server.tool(
+  "version",
+  "Get the current canicode version. Use this when the user asks what version is installed.",
+  {},
+  {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: false,
+    title: "Get Version"
+  },
+  async () => ({
+    content: [{ type: "text", text: `canicode v${pkg.version}` }]
+  })
+);
 server.tool(
   "docs",
   `Get the customization guide for CanICode.
@@ -3570,16 +3810,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") {
@@ -3598,7 +3838,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 {