canicode 0.8.1 → 0.8.2

package/dist/cli/index.js

@@ -974,417 +974,8 @@ async function loadFromApi(fileKey, nodeId, token) {
   };
 }
 
-// src/core/engine/scoring.ts
-var SEVERITY_DENSITY_WEIGHT = {
-  blocking: 3,
-  risk: 2,
-  "missing-info": 1,
-  suggestion: 0.5
-};
-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;
-    }
-  }
-  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)`);
-  }
-  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");
-}
-var MatchConditionSchema = z.object({
-  // Node type conditions
-  type: z.array(z.string()).optional(),
-  notType: z.array(z.string()).optional(),
-  // Name conditions (case-insensitive, substring match)
-  nameContains: z.string().optional(),
-  nameNotContains: z.string().optional(),
-  namePattern: z.string().optional(),
-  // Size conditions
-  minWidth: z.number().optional(),
-  maxWidth: z.number().optional(),
-  minHeight: z.number().optional(),
-  maxHeight: z.number().optional(),
-  // Layout conditions
-  hasAutoLayout: z.boolean().optional(),
-  hasChildren: z.boolean().optional(),
-  minChildren: z.number().optional(),
-  maxChildren: z.number().optional(),
-  // Component conditions
-  isComponent: z.boolean().optional(),
-  isInstance: z.boolean().optional(),
-  hasComponentId: z.boolean().optional(),
-  // Visibility
-  isVisible: z.boolean().optional(),
-  // Fill/style conditions
-  hasFills: z.boolean().optional(),
-  hasStrokes: z.boolean().optional(),
-  hasEffects: z.boolean().optional(),
-  // Depth condition
-  minDepth: z.number().optional(),
-  maxDepth: z.number().optional()
-});
-var CustomRuleSchema = z.object({
-  id: z.string(),
-  category: CategorySchema,
-  severity: SeveritySchema,
-  score: z.number().int().max(0),
-  match: MatchConditionSchema,
-  message: z.string().optional(),
-  why: z.string(),
-  impact: z.string(),
-  fix: z.string(),
-  // Backward compat: silently ignore the old prompt field
-  prompt: z.string().optional()
-});
-var CustomRulesFileSchema = z.array(CustomRuleSchema);
-
-// src/core/rules/custom/custom-rule-loader.ts
-async function loadCustomRules(filePath) {
-  const absPath = resolve(filePath);
-  const raw = await readFile(absPath, "utf-8");
-  const parsed = JSON.parse(raw);
-  const customRules = CustomRulesFileSchema.parse(parsed);
-  const rules = [];
-  const configs = {};
-  for (const cr of customRules) {
-    if (!cr.match) continue;
-    rules.push(toRule(cr));
-    configs[cr.id] = {
-      severity: cr.severity,
-      score: cr.score,
-      enabled: true
-    };
-  }
-  return { rules, configs };
-}
-function toRule(cr) {
-  return {
-    definition: {
-      id: cr.id,
-      name: cr.id.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()),
-      category: cr.category,
-      why: cr.why,
-      impact: cr.impact,
-      fix: cr.fix
-    },
-    check: createPatternCheck(cr)
-  };
-}
-function createPatternCheck(cr) {
-  return (node, context) => {
-    if (node.type === "DOCUMENT" || node.type === "CANVAS") return null;
-    const match = cr.match;
-    if (match.type && !match.type.includes(node.type)) return null;
-    if (match.notType && match.notType.includes(node.type)) return null;
-    if (match.nameContains !== void 0 && !node.name.toLowerCase().includes(match.nameContains.toLowerCase())) return null;
-    if (match.nameNotContains !== void 0 && node.name.toLowerCase().includes(match.nameNotContains.toLowerCase())) return null;
-    if (match.namePattern !== void 0 && !new RegExp(match.namePattern, "i").test(node.name)) return null;
-    const bbox = node.absoluteBoundingBox;
-    if (match.minWidth !== void 0 && (!bbox || bbox.width < match.minWidth)) return null;
-    if (match.maxWidth !== void 0 && (!bbox || bbox.width > match.maxWidth)) return null;
-    if (match.minHeight !== void 0 && (!bbox || bbox.height < match.minHeight)) return null;
-    if (match.maxHeight !== void 0 && (!bbox || bbox.height > match.maxHeight)) return null;
-    if (match.hasAutoLayout === true && !node.layoutMode) return null;
-    if (match.hasAutoLayout === false && node.layoutMode) return null;
-    if (match.hasChildren === true && (!node.children || node.children.length === 0)) return null;
-    if (match.hasChildren === false && node.children && node.children.length > 0) return null;
-    if (match.minChildren !== void 0 && (!node.children || node.children.length < match.minChildren)) return null;
-    if (match.maxChildren !== void 0 && node.children && node.children.length > match.maxChildren) return null;
-    if (match.isComponent === true && node.type !== "COMPONENT" && node.type !== "COMPONENT_SET") return null;
-    if (match.isComponent === false && (node.type === "COMPONENT" || node.type === "COMPONENT_SET")) return null;
-    if (match.isInstance === true && node.type !== "INSTANCE") return null;
-    if (match.isInstance === false && node.type === "INSTANCE") return null;
-    if (match.hasComponentId === true && !node.componentId) return null;
-    if (match.hasComponentId === false && node.componentId) return null;
-    if (match.isVisible === true && !node.visible) return null;
-    if (match.isVisible === false && node.visible) return null;
-    if (match.hasFills === true && (!node.fills || node.fills.length === 0)) return null;
-    if (match.hasFills === false && node.fills && node.fills.length > 0) return null;
-    if (match.hasStrokes === true && (!node.strokes || node.strokes.length === 0)) return null;
-    if (match.hasStrokes === false && node.strokes && node.strokes.length > 0) return null;
-    if (match.hasEffects === true && (!node.effects || node.effects.length === 0)) return null;
-    if (match.hasEffects === false && node.effects && node.effects.length > 0) return null;
-    if (match.minDepth !== void 0 && context.depth < match.minDepth) return null;
-    if (match.maxDepth !== void 0 && context.depth > match.maxDepth) return null;
-    const msg = (cr.message ?? `"${node.name}" matched custom rule "${cr.id}"`).replace(/\{name\}/g, node.name).replace(/\{type\}/g, node.type);
-    return {
-      ruleId: cr.id,
-      nodeId: node.id,
-      nodePath: context.path.join(" > "),
-      message: msg
-    };
-  };
-}
-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;
-}
-
-// 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>`;
-}
-
 // package.json
-var version = "0.8.1";
+var version = "0.8.2";
 var AnalysisNodeTypeSchema = z.enum([
   "DOCUMENT",
   "CANVAS",
@@ -3239,434 +2830,863 @@ function renderValidatedRules(validatedRules) {
   for (const ruleId of validatedRules) {
     lines.push(`- \`${ruleId}\``);
   }
-  lines.push("");
-  return lines.join("\n");
+  lines.push("");
+  return lines.join("\n");
+}
+function renderMismatchDetails(mismatches) {
+  if (mismatches.length === 0) {
+    return "## Detailed Mismatch List\n\nNo mismatches found.\n";
+  }
+  const lines = [];
+  lines.push("## Detailed Mismatch List");
+  lines.push("");
+  const grouped = {};
+  for (const m of mismatches) {
+    const list = grouped[m.type];
+    if (list) {
+      list.push(m);
+    } else {
+      grouped[m.type] = [m];
+    }
+  }
+  for (const [type, cases] of Object.entries(grouped)) {
+    lines.push(`### ${type} (${cases.length})`);
+    lines.push("");
+    for (const c of cases) {
+      const ruleInfo = c.ruleId ? ` | Rule: \`${c.ruleId}\`` : "";
+      const scoreInfo = c.currentScore !== void 0 ? ` | Score: ${c.currentScore}` : "";
+      lines.push(`- **${c.nodePath}** (${c.nodeId})${ruleInfo}${scoreInfo} | Difficulty: ${c.actualDifficulty}`);
+      lines.push(`  > ${c.reasoning}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function renderApplicationGuide(adjustments) {
+  const lines = [];
+  lines.push("## Application Guide");
+  lines.push("");
+  lines.push("To apply these calibration results:");
+  lines.push("");
+  lines.push("1. Review each adjustment proposal above");
+  lines.push("2. Edit `src/core/rules/rule-config.ts` to update scores and severities");
+  lines.push("3. Run `pnpm test:run` to verify no tests break");
+  lines.push("4. Re-run calibration to confirm improvements");
+  lines.push("");
+  if (adjustments.length > 0) {
+    lines.push("### Suggested Changes to `rule-config.ts`");
+    lines.push("");
+    lines.push("```typescript");
+    for (const adj of adjustments) {
+      lines.push(`// ${adj.ruleId}: ${adj.currentScore} -> ${adj.proposedScore} (${adj.confidence} confidence)`);
+      if (adj.proposedSeverity) {
+        lines.push(`//   severity: "${adj.currentSeverity}" -> "${adj.proposedSeverity}"`);
+      }
+    }
+    lines.push("```");
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function getTimestamp() {
+  const now = /* @__PURE__ */ new Date();
+  return now.toLocaleTimeString("en-US", { hour: "2-digit", minute: "2-digit", hour12: false });
+}
+function getDateTimeString() {
+  const now = /* @__PURE__ */ new Date();
+  const year = now.getFullYear();
+  const month = String(now.getMonth() + 1).padStart(2, "0");
+  const day = String(now.getDate()).padStart(2, "0");
+  const hours = String(now.getHours()).padStart(2, "0");
+  const minutes = String(now.getMinutes()).padStart(2, "0");
+  return `${year}-${month}-${day}-${hours}-${minutes}`;
+}
+function extractFixtureName(fixturePath) {
+  const fileName = fixturePath.split("/").pop() ?? fixturePath;
+  return fileName.replace(/\.json$/, "");
+}
+var ActivityLogger = class {
+  logPath;
+  initialized = false;
+  constructor(fixturePath, logDir = "logs/activity") {
+    const dateTimeStr = getDateTimeString();
+    const fixtureName = fixturePath ? extractFixtureName(fixturePath) : "unknown";
+    this.logPath = resolve(logDir, `${dateTimeStr}-${fixtureName}.md`);
+  }
+  /**
+   * Ensure the log directory and file header exist
+   */
+  async ensureInitialized() {
+    if (this.initialized) return;
+    const dir = dirname(this.logPath);
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+    if (!existsSync(this.logPath)) {
+      const ts = getDateTimeString();
+      await writeFile(this.logPath, `# Calibration Activity Log \u2014 ${ts}
+
+`, "utf-8");
+    }
+    this.initialized = true;
+  }
+  /**
+   * Log a pipeline step
+   */
+  async logStep(activity) {
+    await this.ensureInitialized();
+    const lines = [];
+    lines.push(`## ${getTimestamp()} \u2014 ${activity.step}`);
+    if (activity.nodePath) {
+      lines.push(`- Node: ${activity.nodePath}`);
+    }
+    lines.push(`- Result: ${activity.result}`);
+    lines.push(`- Duration: ${activity.durationMs}ms`);
+    lines.push("");
+    await appendFile(this.logPath, lines.join("\n") + "\n", "utf-8");
+  }
+  /**
+   * Log a summary at pipeline completion
+   */
+  async logSummary(summary) {
+    await this.ensureInitialized();
+    const lines = [];
+    lines.push(`## ${getTimestamp()} \u2014 Pipeline Summary`);
+    lines.push(`- Status: ${summary.status}`);
+    lines.push(`- Total Duration: ${summary.totalDurationMs}ms`);
+    lines.push(`- Nodes Analyzed: ${summary.nodesAnalyzed}`);
+    lines.push(`- Nodes Converted: ${summary.nodesConverted}`);
+    lines.push(`- Mismatches Found: ${summary.mismatches}`);
+    lines.push(`- Adjustments Proposed: ${summary.adjustments}`);
+    lines.push("");
+    lines.push("---");
+    lines.push("");
+    await appendFile(this.logPath, lines.join("\n") + "\n", "utf-8");
+  }
+  getLogPath() {
+    return this.logPath;
+  }
+};
+
+// src/agents/orchestrator.ts
+function selectNodes(summaries, strategy, maxNodes) {
+  if (summaries.length === 0) return [];
+  switch (strategy) {
+    case "all":
+      return summaries.slice(0, maxNodes);
+    case "random": {
+      const shuffled = [...summaries];
+      for (let i = shuffled.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        const temp = shuffled[i];
+        shuffled[i] = shuffled[j];
+        shuffled[j] = temp;
+      }
+      return shuffled.slice(0, maxNodes);
+    }
+    case "top-issues":
+    default:
+      return summaries.slice(0, maxNodes);
+  }
+}
+var EXCLUDED_NODE_TYPES = /* @__PURE__ */ new Set([
+  "VECTOR",
+  "BOOLEAN_OPERATION",
+  "STAR",
+  "REGULAR_POLYGON",
+  "ELLIPSE",
+  "LINE"
+]);
+function findNode(root, nodeId) {
+  if (root.id === nodeId) return root;
+  if (root.children) {
+    for (const child of root.children) {
+      const found = findNode(child, nodeId);
+      if (found) return found;
+    }
+  }
+  return null;
 }
-function renderMismatchDetails(mismatches) {
-  if (mismatches.length === 0) {
-    return "## Detailed Mismatch List\n\nNo mismatches found.\n";
+function hasTextDescendant(node) {
+  if (node.type === "TEXT") return true;
+  if (node.children) {
+    for (const child of node.children) {
+      if (hasTextDescendant(child)) return true;
+    }
   }
-  const lines = [];
-  lines.push("## Detailed Mismatch List");
-  lines.push("");
-  const grouped = {};
-  for (const m of mismatches) {
-    const list = grouped[m.type];
-    if (list) {
-      list.push(m);
-    } else {
-      grouped[m.type] = [m];
+  return false;
+}
+var MIN_WIDTH = 200;
+var MIN_HEIGHT = 200;
+var ELIGIBLE_NODE_TYPES = /* @__PURE__ */ new Set([
+  "FRAME",
+  "COMPONENT",
+  "INSTANCE"
+]);
+function filterConversionCandidates(summaries, documentRoot) {
+  return summaries.filter((summary) => {
+    const node = findNode(documentRoot, summary.nodeId);
+    if (!node) return false;
+    if (EXCLUDED_NODE_TYPES.has(node.type)) return false;
+    if (!ELIGIBLE_NODE_TYPES.has(node.type)) return false;
+    if (isExcludedName(node.name)) return false;
+    const bbox = node.absoluteBoundingBox;
+    if (bbox && (bbox.width < MIN_WIDTH || bbox.height < MIN_HEIGHT)) return false;
+    if (!node.children || node.children.length < 3) return false;
+    if (!hasTextDescendant(node)) return false;
+    return true;
+  });
+}
+function isFigmaUrl2(input) {
+  return input.includes("figma.com/");
+}
+function isJsonFile2(input) {
+  return input.endsWith(".json");
+}
+async function loadFile2(input, token) {
+  if (isJsonFile2(input)) {
+    const filePath = resolve(input);
+    if (!existsSync(filePath)) {
+      throw new Error(`File not found: ${filePath}`);
     }
+    const file = await loadFigmaFileFromJson(filePath);
+    return { file, fileKey: file.fileKey, nodeId: void 0 };
   }
-  for (const [type, cases] of Object.entries(grouped)) {
-    lines.push(`### ${type} (${cases.length})`);
-    lines.push("");
-    for (const c of cases) {
-      const ruleInfo = c.ruleId ? ` | Rule: \`${c.ruleId}\`` : "";
-      const scoreInfo = c.currentScore !== void 0 ? ` | Score: ${c.currentScore}` : "";
-      lines.push(`- **${c.nodePath}** (${c.nodeId})${ruleInfo}${scoreInfo} | Difficulty: ${c.actualDifficulty}`);
-      lines.push(`  > ${c.reasoning}`);
+  if (isFigmaUrl2(input)) {
+    const { fileKey, nodeId } = parseFigmaUrl(input);
+    const figmaToken = token ?? process.env["FIGMA_TOKEN"];
+    if (!figmaToken) {
+      throw new Error(
+        "Figma token required. Provide token or set FIGMA_TOKEN environment variable."
+      );
     }
-    lines.push("");
+    const client = new FigmaClient({ token: figmaToken });
+    const response = await client.getFile(fileKey);
+    const file = transformFigmaResponse(fileKey, response);
+    return { file, fileKey, nodeId };
   }
-  return lines.join("\n");
+  throw new Error(
+    `Invalid input: ${input}. Provide a Figma URL or JSON file path.`
+  );
 }
-function renderApplicationGuide(adjustments) {
-  const lines = [];
-  lines.push("## Application Guide");
-  lines.push("");
-  lines.push("To apply these calibration results:");
-  lines.push("");
-  lines.push("1. Review each adjustment proposal above");
-  lines.push("2. Edit `src/core/rules/rule-config.ts` to update scores and severities");
-  lines.push("3. Run `pnpm test:run` to verify no tests break");
-  lines.push("4. Re-run calibration to confirm improvements");
-  lines.push("");
-  if (adjustments.length > 0) {
-    lines.push("### Suggested Changes to `rule-config.ts`");
-    lines.push("");
-    lines.push("```typescript");
-    for (const adj of adjustments) {
-      lines.push(`// ${adj.ruleId}: ${adj.currentScore} -> ${adj.proposedScore} (${adj.confidence} confidence)`);
-      if (adj.proposedSeverity) {
-        lines.push(`//   severity: "${adj.currentSeverity}" -> "${adj.proposedSeverity}"`);
-      }
+function buildRuleScoresMap() {
+  const scores = {};
+  for (const [id, config2] of Object.entries(RULE_CONFIGS)) {
+    scores[id] = { score: config2.score, severity: config2.severity };
+  }
+  return scores;
+}
+async function runCalibrationAnalyze(config2) {
+  const parsed = CalibrationConfigSchema.parse(config2);
+  const { file, fileKey, nodeId } = await loadFile2(parsed.input, parsed.token);
+  const analyzeOptions = nodeId ? { targetNodeId: nodeId } : {};
+  const analysisResult = analyzeFile(file, analyzeOptions);
+  const analysisOutput = runAnalysisAgent({ analysisResult });
+  const ruleScores = {
+    ...buildRuleScoresMap(),
+    ...extractRuleScores(analysisResult)
+  };
+  return { analysisOutput, ruleScores, fileKey };
+}
+function runCalibrationEvaluate(analysisJson, conversionJson, ruleScores) {
+  const evaluationOutput = runEvaluationAgent({
+    nodeIssueSummaries: analysisJson.nodeIssueSummaries.map((s) => ({
+      nodeId: s.nodeId,
+      nodePath: s.nodePath,
+      flaggedRuleIds: s.flaggedRuleIds
+    })),
+    conversionRecords: conversionJson.records,
+    ruleScores
+  });
+  const tuningOutput = runTuningAgent({
+    mismatches: evaluationOutput.mismatches,
+    ruleScores
+  });
+  const report = generateCalibrationReport({
+    fileKey: analysisJson.fileKey,
+    fileName: analysisJson.fileName,
+    analyzedAt: analysisJson.analyzedAt,
+    nodeCount: analysisJson.nodeCount,
+    issueCount: analysisJson.issueCount,
+    convertedNodeCount: conversionJson.records.length,
+    skippedNodeCount: conversionJson.skippedNodeIds.length,
+    scoreReport: analysisJson.scoreReport,
+    mismatches: evaluationOutput.mismatches,
+    validatedRules: evaluationOutput.validatedRules,
+    adjustments: tuningOutput.adjustments,
+    newRuleProposals: tuningOutput.newRuleProposals
+  });
+  return {
+    evaluationOutput,
+    tuningOutput,
+    report
+  };
+}
+async function runCalibration(config2, executor, options) {
+  const parsed = CalibrationConfigSchema.parse(config2);
+  const pipelineStart = Date.now();
+  const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const logger = new ActivityLogger(parsed.input) ;
+  try {
+    let stepStart = Date.now();
+    const { file, fileKey, nodeId } = await loadFile2(parsed.input, parsed.token);
+    const analyzeOptions = nodeId ? { targetNodeId: nodeId } : {};
+    const analysisResult = analyzeFile(file, analyzeOptions);
+    const analysisOutput = runAnalysisAgent({ analysisResult });
+    const ruleScores = {
+      ...buildRuleScoresMap(),
+      ...extractRuleScores(analysisResult)
+    };
+    await logger?.logStep({
+      step: "Analysis",
+      result: `${analysisResult.nodeCount} nodes, ${analysisResult.issues.length} issues, grade ${analysisOutput.scoreReport.overall.grade}`,
+      durationMs: Date.now() - stepStart
+    });
+    stepStart = Date.now();
+    const candidates = filterConversionCandidates(
+      analysisOutput.nodeIssueSummaries,
+      analysisResult.file.document
+    );
+    const selectedNodes = selectNodes(
+      candidates,
+      parsed.samplingStrategy,
+      parsed.maxConversionNodes
+    );
+    const conversionOutput = await runConversionAgent(
+      {
+        fileKey,
+        nodes: selectedNodes.map((n) => ({
+          nodeId: n.nodeId,
+          nodePath: n.nodePath,
+          flaggedRuleIds: n.flaggedRuleIds
+        }))
+      },
+      executor
+    );
+    await logger?.logStep({
+      step: "Conversion",
+      result: `${conversionOutput.records.length} converted, ${conversionOutput.skippedNodeIds.length} skipped`,
+      durationMs: Date.now() - stepStart
+    });
+    stepStart = Date.now();
+    const evaluationOutput = runEvaluationAgent({
+      nodeIssueSummaries: selectedNodes.map((n) => ({
+        nodeId: n.nodeId,
+        nodePath: n.nodePath,
+        flaggedRuleIds: n.flaggedRuleIds
+      })),
+      conversionRecords: conversionOutput.records,
+      ruleScores
+    });
+    await logger?.logStep({
+      step: "Evaluation",
+      result: `${evaluationOutput.mismatches.length} mismatches, ${evaluationOutput.validatedRules.length} validated`,
+      durationMs: Date.now() - stepStart
+    });
+    stepStart = Date.now();
+    const tuningOutput = runTuningAgent({
+      mismatches: evaluationOutput.mismatches,
+      ruleScores
+    });
+    await logger?.logStep({
+      step: "Tuning",
+      result: `${tuningOutput.adjustments.length} adjustments, ${tuningOutput.newRuleProposals.length} new rule proposals`,
+      durationMs: Date.now() - stepStart
+    });
+    const report = generateCalibrationReport({
+      fileKey,
+      fileName: file.name,
+      analyzedAt: startedAt,
+      nodeCount: analysisResult.nodeCount,
+      issueCount: analysisResult.issues.length,
+      convertedNodeCount: conversionOutput.records.length,
+      skippedNodeCount: conversionOutput.skippedNodeIds.length,
+      scoreReport: analysisOutput.scoreReport,
+      mismatches: evaluationOutput.mismatches,
+      validatedRules: evaluationOutput.validatedRules,
+      adjustments: tuningOutput.adjustments,
+      newRuleProposals: tuningOutput.newRuleProposals
+    });
+    const reportPath = resolve(parsed.outputPath);
+    const reportDir = resolve(parsed.outputPath, "..");
+    if (!existsSync(reportDir)) {
+      mkdirSync(reportDir, { recursive: true });
     }
-    lines.push("```");
-    lines.push("");
+    await writeFile(reportPath, report, "utf-8");
+    await logger?.logSummary({
+      totalDurationMs: Date.now() - pipelineStart,
+      nodesAnalyzed: analysisResult.nodeCount,
+      nodesConverted: conversionOutput.records.length,
+      mismatches: evaluationOutput.mismatches.length,
+      adjustments: tuningOutput.adjustments.length,
+      status: "completed"
+    });
+    return {
+      status: "completed",
+      scoreReport: analysisOutput.scoreReport,
+      nodeIssueSummaries: analysisOutput.nodeIssueSummaries,
+      mismatches: evaluationOutput.mismatches,
+      validatedRules: evaluationOutput.validatedRules,
+      adjustments: tuningOutput.adjustments,
+      newRuleProposals: tuningOutput.newRuleProposals,
+      reportPath,
+      logPath: logger?.getLogPath()
+    };
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    await logger?.logSummary({
+      totalDurationMs: Date.now() - pipelineStart,
+      nodesAnalyzed: 0,
+      nodesConverted: 0,
+      mismatches: 0,
+      adjustments: 0,
+      status: `failed: ${errorMessage}`
+    });
+    return {
+      status: "failed",
+      scoreReport: {
+        overall: { score: 0, maxScore: 100, percentage: 0, grade: "F" },
+        byCategory: {},
+        summary: { totalIssues: 0, blocking: 0, risk: 0, missingInfo: 0, suggestion: 0, nodeCount: 0 }
+      },
+      nodeIssueSummaries: [],
+      mismatches: [],
+      validatedRules: [],
+      adjustments: [],
+      newRuleProposals: [],
+      reportPath: parsed.outputPath,
+      error: errorMessage
+    };
   }
-  return lines.join("\n");
-}
-function getTimestamp() {
-  const now = /* @__PURE__ */ new Date();
-  return now.toLocaleTimeString("en-US", { hour: "2-digit", minute: "2-digit", hour12: false });
 }
-function getDateTimeString() {
-  const now = /* @__PURE__ */ new Date();
-  const year = now.getFullYear();
-  const month = String(now.getMonth() + 1).padStart(2, "0");
-  const day = String(now.getDate()).padStart(2, "0");
-  const hours = String(now.getHours()).padStart(2, "0");
-  const minutes = String(now.getMinutes()).padStart(2, "0");
-  return `${year}-${month}-${day}-${hours}-${minutes}`;
+
+// src/core/engine/scoring.ts
+var SEVERITY_DENSITY_WEIGHT = {
+  blocking: 3,
+  risk: 2,
+  "missing-info": 1,
+  suggestion: 0.5
+};
+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 extractFixtureName(fixturePath) {
-  const fileName = fixturePath.split("/").pop() ?? fixturePath;
-  return fileName.replace(/\.json$/, "");
+function clamp(value, min, max) {
+  return Math.max(min, Math.min(max, value));
 }
-var ActivityLogger = class {
-  logPath;
-  initialized = false;
-  constructor(fixturePath, logDir = "logs/activity") {
-    const dateTimeStr = getDateTimeString();
-    const fixtureName = fixturePath ? extractFixtureName(fixturePath) : "unknown";
-    this.logPath = resolve(logDir, `${dateTimeStr}-${fixtureName}.md`);
+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());
   }
-  /**
-   * Ensure the log directory and file header exist
-   */
-  async ensureInitialized() {
-    if (this.initialized) return;
-    const dir = dirname(this.logPath);
-    if (!existsSync(dir)) {
-      mkdirSync(dir, { recursive: true });
-    }
-    if (!existsSync(this.logPath)) {
-      const ts = getDateTimeString();
-      await writeFile(this.logPath, `# Calibration Activity Log \u2014 ${ts}
-
-`, "utf-8");
-    }
-    this.initialized = true;
+  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);
   }
-  /**
-   * Log a pipeline step
-   */
-  async logStep(activity) {
-    await this.ensureInitialized();
-    const lines = [];
-    lines.push(`## ${getTimestamp()} \u2014 ${activity.step}`);
-    if (activity.nodePath) {
-      lines.push(`- Node: ${activity.nodePath}`);
+  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);
     }
-    lines.push(`- Result: ${activity.result}`);
-    lines.push(`- Duration: ${activity.durationMs}ms`);
-    lines.push("");
-    await appendFile(this.logPath, lines.join("\n") + "\n", "utf-8");
+    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;
   }
-  /**
-   * Log a summary at pipeline completion
-   */
-  async logSummary(summary) {
-    await this.ensureInitialized();
-    const lines = [];
-    lines.push(`## ${getTimestamp()} \u2014 Pipeline Summary`);
-    lines.push(`- Status: ${summary.status}`);
-    lines.push(`- Total Duration: ${summary.totalDurationMs}ms`);
-    lines.push(`- Nodes Analyzed: ${summary.nodesAnalyzed}`);
-    lines.push(`- Nodes Converted: ${summary.nodesConverted}`);
-    lines.push(`- Mismatches Found: ${summary.mismatches}`);
-    lines.push(`- Adjustments Proposed: ${summary.adjustments}`);
-    lines.push("");
-    lines.push("---");
-    lines.push("");
-    await appendFile(this.logPath, lines.join("\n") + "\n", "utf-8");
+  let totalWeight = 0;
+  let weightedSum = 0;
+  for (const category of CATEGORIES) {
+    const weight = CATEGORY_WEIGHT[category];
+    weightedSum += categoryScores[category].percentage * weight;
+    totalWeight += weight;
   }
-  getLogPath() {
-    return this.logPath;
+  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;
+    }
   }
-};
-
-// src/agents/orchestrator.ts
-function selectNodes(summaries, strategy, maxNodes) {
-  if (summaries.length === 0) return [];
-  switch (strategy) {
-    case "all":
-      return summaries.slice(0, maxNodes);
-    case "random": {
-      const shuffled = [...summaries];
-      for (let i = shuffled.length - 1; i > 0; i--) {
-        const j = Math.floor(Math.random() * (i + 1));
-        const temp = shuffled[i];
-        shuffled[i] = shuffled[j];
-        shuffled[j] = temp;
+  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 shuffled.slice(0, maxNodes);
-    }
-    case "top-issues":
-    default:
-      return summaries.slice(0, maxNodes);
+    };
   }
+  return scores;
 }
-var EXCLUDED_NODE_TYPES = /* @__PURE__ */ new Set([
-  "VECTOR",
-  "BOOLEAN_OPERATION",
-  "STAR",
-  "REGULAR_POLYGON",
-  "ELLIPSE",
-  "LINE"
-]);
-function findNode(root, nodeId) {
-  if (root.id === nodeId) return root;
-  if (root.children) {
-    for (const child of root.children) {
-      const found = findNode(child, nodeId);
-      if (found) return found;
-    }
+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)`);
   }
-  return null;
+  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 hasTextDescendant(node) {
-  if (node.type === "TEXT") return true;
-  if (node.children) {
-    for (const child of node.children) {
-      if (hasTextDescendant(child)) return true;
-    }
+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 false;
+  return {
+    version,
+    fileName,
+    nodeCount: result.nodeCount,
+    maxDepth: result.maxDepth,
+    issueCount: result.issues.length,
+    scores: {
+      overall: scores.overall,
+      categories: scores.byCategory
+    },
+    issuesByRule,
+    summary: formatScoreSummary(scores)
+  };
 }
-var MIN_WIDTH = 200;
-var MIN_HEIGHT = 200;
-var ELIGIBLE_NODE_TYPES = /* @__PURE__ */ new Set([
-  "FRAME",
-  "COMPONENT",
-  "INSTANCE"
-]);
-function filterConversionCandidates(summaries, documentRoot) {
-  return summaries.filter((summary) => {
-    const node = findNode(documentRoot, summary.nodeId);
-    if (!node) return false;
-    if (EXCLUDED_NODE_TYPES.has(node.type)) return false;
-    if (!ELIGIBLE_NODE_TYPES.has(node.type)) return false;
-    if (isExcludedName(node.name)) return false;
-    const bbox = node.absoluteBoundingBox;
-    if (bbox && (bbox.width < MIN_WIDTH || bbox.height < MIN_HEIGHT)) return false;
-    if (!node.children || node.children.length < 3) return false;
-    if (!hasTextDescendant(node)) return false;
-    return true;
-  });
+var MatchConditionSchema = z.object({
+  // Node type conditions
+  type: z.array(z.string()).optional(),
+  notType: z.array(z.string()).optional(),
+  // Name conditions (case-insensitive, substring match)
+  nameContains: z.string().optional(),
+  nameNotContains: z.string().optional(),
+  namePattern: z.string().optional(),
+  // Size conditions
+  minWidth: z.number().optional(),
+  maxWidth: z.number().optional(),
+  minHeight: z.number().optional(),
+  maxHeight: z.number().optional(),
+  // Layout conditions
+  hasAutoLayout: z.boolean().optional(),
+  hasChildren: z.boolean().optional(),
+  minChildren: z.number().optional(),
+  maxChildren: z.number().optional(),
+  // Component conditions
+  isComponent: z.boolean().optional(),
+  isInstance: z.boolean().optional(),
+  hasComponentId: z.boolean().optional(),
+  // Visibility
+  isVisible: z.boolean().optional(),
+  // Fill/style conditions
+  hasFills: z.boolean().optional(),
+  hasStrokes: z.boolean().optional(),
+  hasEffects: z.boolean().optional(),
+  // Depth condition
+  minDepth: z.number().optional(),
+  maxDepth: z.number().optional()
+});
+var CustomRuleSchema = z.object({
+  id: z.string(),
+  category: CategorySchema,
+  severity: SeveritySchema,
+  score: z.number().int().max(0),
+  match: MatchConditionSchema,
+  message: z.string().optional(),
+  why: z.string(),
+  impact: z.string(),
+  fix: z.string(),
+  // Backward compat: silently ignore the old prompt field
+  prompt: z.string().optional()
+});
+var CustomRulesFileSchema = z.array(CustomRuleSchema);
+
+// src/core/rules/custom/custom-rule-loader.ts
+async function loadCustomRules(filePath) {
+  const absPath = resolve(filePath);
+  const raw = await readFile(absPath, "utf-8");
+  const parsed = JSON.parse(raw);
+  const customRules = CustomRulesFileSchema.parse(parsed);
+  const rules = [];
+  const configs = {};
+  for (const cr of customRules) {
+    if (!cr.match) continue;
+    rules.push(toRule(cr));
+    configs[cr.id] = {
+      severity: cr.severity,
+      score: cr.score,
+      enabled: true
+    };
+  }
+  return { rules, configs };
 }
-function isFigmaUrl2(input) {
-  return input.includes("figma.com/");
+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 isJsonFile2(input) {
-  return input.endsWith(".json");
+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
+    };
+  };
 }
-async function loadFile2(input, token) {
-  if (isJsonFile2(input)) {
-    const filePath = resolve(input);
-    if (!existsSync(filePath)) {
-      throw new Error(`File not found: ${filePath}`);
+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 }
+        };
+      }
     }
-    const file = await loadFigmaFileFromJson(filePath);
-    return { file, fileKey: file.fileKey, nodeId: void 0 };
   }
-  if (isFigmaUrl2(input)) {
-    const { fileKey, nodeId } = parseFigmaUrl(input);
-    const figmaToken = token ?? process.env["FIGMA_TOKEN"];
-    if (!figmaToken) {
-      throw new Error(
-        "Figma token required. Provide token or set FIGMA_TOKEN environment variable."
-      );
+  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 }
+        };
+      }
     }
-    const client = new FigmaClient({ token: figmaToken });
-    const response = await client.getFile(fileKey);
-    const file = transformFigmaResponse(fileKey, response);
-    return { file, fileKey, nodeId };
   }
-  throw new Error(
-    `Invalid input: ${input}. Provide a Figma URL or JSON file path.`
-  );
+  return merged;
 }
-function buildRuleScoresMap() {
-  const scores = {};
-  for (const [id, config2] of Object.entries(RULE_CONFIGS)) {
-    scores[id] = { score: config2.score, severity: config2.severity };
-  }
-  return 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"
+};
+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";
 }
-async function runCalibrationAnalyze(config2) {
-  const parsed = CalibrationConfigSchema.parse(config2);
-  const { file, fileKey, nodeId } = await loadFile2(parsed.input, parsed.token);
-  const analyzeOptions = nodeId ? { targetNodeId: nodeId } : {};
-  const analysisResult = analyzeFile(file, analyzeOptions);
-  const analysisOutput = runAnalysisAgent({ analysisResult });
-  const ruleScores = {
-    ...buildRuleScoresMap(),
-    ...extractRuleScores(analysisResult)
+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 { analysisOutput, ruleScores, fileKey };
+  return map[sev];
 }
-function runCalibrationEvaluate(analysisJson, conversionJson, ruleScores) {
-  const evaluationOutput = runEvaluationAgent({
-    nodeIssueSummaries: analysisJson.nodeIssueSummaries.map((s) => ({
-      nodeId: s.nodeId,
-      nodePath: s.nodePath,
-      flaggedRuleIds: s.flaggedRuleIds
-    })),
-    conversionRecords: conversionJson.records,
-    ruleScores
-  });
-  const tuningOutput = runTuningAgent({
-    mismatches: evaluationOutput.mismatches,
-    ruleScores
-  });
-  const report = generateCalibrationReport({
-    fileKey: analysisJson.fileKey,
-    fileName: analysisJson.fileName,
-    analyzedAt: analysisJson.analyzedAt,
-    nodeCount: analysisJson.nodeCount,
-    issueCount: analysisJson.issueCount,
-    convertedNodeCount: conversionJson.records.length,
-    skippedNodeCount: conversionJson.skippedNodeIds.length,
-    scoreReport: analysisJson.scoreReport,
-    mismatches: evaluationOutput.mismatches,
-    validatedRules: evaluationOutput.validatedRules,
-    adjustments: tuningOutput.adjustments,
-    newRuleProposals: tuningOutput.newRuleProposals
-  });
-  return {
-    evaluationOutput,
-    tuningOutput,
-    report
+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];
 }
-async function runCalibration(config2, executor, options) {
-  const parsed = CalibrationConfigSchema.parse(config2);
-  const pipelineStart = Date.now();
-  const startedAt = (/* @__PURE__ */ new Date()).toISOString();
-  const logger = new ActivityLogger(parsed.input) ;
-  try {
-    let stepStart = Date.now();
-    const { file, fileKey, nodeId } = await loadFile2(parsed.input, parsed.token);
-    const analyzeOptions = nodeId ? { targetNodeId: nodeId } : {};
-    const analysisResult = analyzeFile(file, analyzeOptions);
-    const analysisOutput = runAnalysisAgent({ analysisResult });
-    const ruleScores = {
-      ...buildRuleScoresMap(),
-      ...extractRuleScores(analysisResult)
-    };
-    await logger?.logStep({
-      step: "Analysis",
-      result: `${analysisResult.nodeCount} nodes, ${analysisResult.issues.length} issues, grade ${analysisOutput.scoreReport.overall.grade}`,
-      durationMs: Date.now() - stepStart
-    });
-    stepStart = Date.now();
-    const candidates = filterConversionCandidates(
-      analysisOutput.nodeIssueSummaries,
-      analysisResult.file.document
-    );
-    const selectedNodes = selectNodes(
-      candidates,
-      parsed.samplingStrategy,
-      parsed.maxConversionNodes
-    );
-    const conversionOutput = await runConversionAgent(
-      {
-        fileKey,
-        nodes: selectedNodes.map((n) => ({
-          nodeId: n.nodeId,
-          nodePath: n.nodePath,
-          flaggedRuleIds: n.flaggedRuleIds
-        }))
-      },
-      executor
-    );
-    await logger?.logStep({
-      step: "Conversion",
-      result: `${conversionOutput.records.length} converted, ${conversionOutput.skippedNodeIds.length} skipped`,
-      durationMs: Date.now() - stepStart
-    });
-    stepStart = Date.now();
-    const evaluationOutput = runEvaluationAgent({
-      nodeIssueSummaries: selectedNodes.map((n) => ({
-        nodeId: n.nodeId,
-        nodePath: n.nodePath,
-        flaggedRuleIds: n.flaggedRuleIds
-      })),
-      conversionRecords: conversionOutput.records,
-      ruleScores
-    });
-    await logger?.logStep({
-      step: "Evaluation",
-      result: `${evaluationOutput.mismatches.length} mismatches, ${evaluationOutput.validatedRules.length} validated`,
-      durationMs: Date.now() - stepStart
-    });
-    stepStart = Date.now();
-    const tuningOutput = runTuningAgent({
-      mismatches: evaluationOutput.mismatches,
-      ruleScores
-    });
-    await logger?.logStep({
-      step: "Tuning",
-      result: `${tuningOutput.adjustments.length} adjustments, ${tuningOutput.newRuleProposals.length} new rule proposals`,
-      durationMs: Date.now() - stepStart
-    });
-    const report = generateCalibrationReport({
-      fileKey,
-      fileName: file.name,
-      analyzedAt: startedAt,
-      nodeCount: analysisResult.nodeCount,
-      issueCount: analysisResult.issues.length,
-      convertedNodeCount: conversionOutput.records.length,
-      skippedNodeCount: conversionOutput.skippedNodeIds.length,
-      scoreReport: analysisOutput.scoreReport,
-      mismatches: evaluationOutput.mismatches,
-      validatedRules: evaluationOutput.validatedRules,
-      adjustments: tuningOutput.adjustments,
-      newRuleProposals: tuningOutput.newRuleProposals
-    });
-    const reportPath = resolve(parsed.outputPath);
-    const reportDir = resolve(parsed.outputPath, "..");
-    if (!existsSync(reportDir)) {
-      mkdirSync(reportDir, { recursive: true });
-    }
-    await writeFile(reportPath, report, "utf-8");
-    await logger?.logSummary({
-      totalDurationMs: Date.now() - pipelineStart,
-      nodesAnalyzed: analysisResult.nodeCount,
-      nodesConverted: conversionOutput.records.length,
-      mismatches: evaluationOutput.mismatches.length,
-      adjustments: tuningOutput.adjustments.length,
-      status: "completed"
-    });
-    return {
-      status: "completed",
-      scoreReport: analysisOutput.scoreReport,
-      nodeIssueSummaries: analysisOutput.nodeIssueSummaries,
-      mismatches: evaluationOutput.mismatches,
-      validatedRules: evaluationOutput.validatedRules,
-      adjustments: tuningOutput.adjustments,
-      newRuleProposals: tuningOutput.newRuleProposals,
-      reportPath,
-      logPath: logger?.getLogPath()
-    };
-  } catch (error) {
-    const errorMessage = error instanceof Error ? error.message : String(error);
-    await logger?.logSummary({
-      totalDurationMs: Date.now() - pipelineStart,
-      nodesAnalyzed: 0,
-      nodesConverted: 0,
-      mismatches: 0,
-      adjustments: 0,
-      status: `failed: ${errorMessage}`
-    });
-    return {
-      status: "failed",
-      scoreReport: {
-        overall: { score: 0, maxScore: 100, percentage: 0, grade: "F" },
-        byCategory: {},
-        summary: { totalIssues: 0, blocking: 0, risk: 0, missingInfo: 0, suggestion: 0, nodeCount: 0 }
-      },
-      nodeIssueSummaries: [],
-      mismatches: [],
-      validatedRules: [],
-      adjustments: [],
-      newRuleProposals: [],
-      reportPath: parsed.outputPath,
-      error: errorMessage
-    };
+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
@@ -4343,7 +4363,7 @@ function countNodes2(node) {
   }
   return count;
 }
-cli.command("analyze <input>", "Analyze a Figma file or JSON fixture").option("--preset <preset>", "Analysis preset (relaxed | dev-friendly | ai-ready | strict)").option("--output <path>", "HTML report output path").option("--token <token>", "Figma API token (or use FIGMA_TOKEN env var)").option("--api", "Load via Figma REST API (requires FIGMA_TOKEN)").option("--screenshot", "Include screenshot comparison in report (requires ANTHROPIC_API_KEY)").option("--custom-rules <path>", "Path to custom rules JSON file").option("--config <path>", "Path to config JSON file (override rule scores/settings)").option("--no-open", "Don't open report in browser after analysis").example("  canicode analyze https://www.figma.com/design/ABC123/MyDesign").example("  canicode analyze https://www.figma.com/design/ABC123/MyDesign --api --token YOUR_TOKEN").example("  canicode analyze ./fixtures/design.json --output report.html").example("  canicode analyze ./fixtures/design.json --custom-rules ./my-rules.json").example("  canicode analyze ./fixtures/design.json --config ./my-config.json").action(async (input, options) => {
+cli.command("analyze <input>", "Analyze a Figma file or JSON fixture").option("--preset <preset>", "Analysis preset (relaxed | dev-friendly | ai-ready | strict)").option("--output <path>", "HTML report output path").option("--token <token>", "Figma API token (or use FIGMA_TOKEN env var)").option("--api", "Load via Figma REST API (requires FIGMA_TOKEN)").option("--screenshot", "Include screenshot comparison in report (requires ANTHROPIC_API_KEY)").option("--custom-rules <path>", "Path to custom rules JSON file").option("--config <path>", "Path to config JSON file (override rule scores/settings)").option("--no-open", "Don't open report in browser after analysis").option("--json", "Output JSON results to stdout (same format as MCP)").example("  canicode analyze https://www.figma.com/design/ABC123/MyDesign").example("  canicode analyze https://www.figma.com/design/ABC123/MyDesign --api --token YOUR_TOKEN").example("  canicode analyze ./fixtures/design.json --output report.html").example("  canicode analyze ./fixtures/design.json --custom-rules ./my-rules.json").example("  canicode analyze ./fixtures/design.json --config ./my-config.json").action(async (input, options) => {
   const analysisStart = Date.now();
   trackEvent(EVENTS.ANALYSIS_STARTED, { source: isJsonFile(input) ? "fixture" : "figma" });
   try {
@@ -4419,6 +4439,10 @@ Analyzing: ${file.name}`);
     const result = analyzeFile(file, analyzeOptions);
     console.log(`Nodes: ${result.nodeCount} (max depth: ${result.maxDepth})`);
     const scores = calculateScores(result);
+    if (options.json) {
+      console.log(JSON.stringify(buildResultJson(file.name, result, scores), null, 2));
+      return;
+    }
     console.log("\n" + "=".repeat(50));
     console.log(formatScoreSummary(scores));
     console.log("=".repeat(50));