canicode 0.3.1 → 0.3.2

package/dist/mcp/server.js

@@ -464,11 +464,15 @@ var RuleEngine = class {
   enabledRuleIds;
   disabledRuleIds;
   targetNodeId;
+  excludeNamePattern;
+  excludeNodeTypes;
   constructor(options = {}) {
     this.configs = options.configs ?? RULE_CONFIGS;
     this.enabledRuleIds = options.enabledRules ? new Set(options.enabledRules) : null;
     this.disabledRuleIds = new Set(options.disabledRules ?? []);
     this.targetNodeId = options.targetNodeId;
+    this.excludeNamePattern = options.excludeNodeNames && options.excludeNodeNames.length > 0 ? new RegExp(`\\b(${options.excludeNodeNames.join("|")})\\b`, "i") : null;
+    this.excludeNodeTypes = options.excludeNodeTypes && options.excludeNodeTypes.length > 0 ? new Set(options.excludeNodeTypes) : null;
   }
   /**
    * Analyze a Figma file and return issues
@@ -522,6 +526,12 @@ var RuleEngine = class {
    */
   traverseAndCheck(node, file, rules, maxDepth, issues, depth, path, parent, siblings) {
     const nodePath = [...path, node.name];
+    if (this.excludeNodeTypes && this.excludeNodeTypes.has(node.type)) {
+      return;
+    }
+    if (this.excludeNamePattern && this.excludeNamePattern.test(node.name)) {
+      return;
+    }
     const context = {
       file,
       parent,
@@ -1380,7 +1390,7 @@ function generateHtmlReport(file, result, scores, options) {
 ${CATEGORIES.map((cat) => {
     const cs = scores.byCategory[cat];
     const desc = CATEGORY_DESCRIPTIONS[cat];
-    return `        <div class="flex flex-col items-center group relative">
+    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>
@@ -1388,7 +1398,7 @@ ${CATEGORIES.map((cat) => {
             ${esc(desc)}
             <div class="absolute top-full left-1/2 -translate-x-1/2 border-4 border-transparent border-t-zinc-900"></div>
           </div>
-        </div>`;
+        </a>`;
   }).join("\n")}
       </div>
     </section>
@@ -1526,7 +1536,7 @@ function renderCategory(cat, scores, issues, fileKey, screenshotMap, figmaToken)
   for (const sev of SEVERITY_ORDER) bySeverity.set(sev, []);
   for (const issue of issues) bySeverity.get(issue.config.severity)?.push(issue);
   return `
-      <details class="bg-card border border-border rounded-lg shadow-sm overflow-hidden group"${hasProblems ? " open" : ""}>
+      <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">
@@ -3000,6 +3010,60 @@ server.tool(
     };
   }
 );
+server.tool(
+  "docs",
+  `Get the customization guide for CanICode.
+
+Returns documentation on:
+- Config overrides (excludeNodeNames, excludeNodeTypes, gridBase, colorTolerance, per-rule score/severity/enabled)
+- Custom rules (how to add project-specific checks)
+- All 39 rule IDs with default scores and severity
+- Example configs (strict, relaxed, mobile-first)
+
+Use this when the user asks about customization, configuration, rule settings, or how to adjust scores.`,
+  {
+    topic: z.enum(["all", "config", "custom-rules", "rules"]).optional().describe("Specific topic: config (overrides), custom-rules (adding new rules), rules (all rule IDs). Default: all")
+  },
+  async ({ topic }) => {
+    const { readFile: readFile4 } = await import('fs/promises');
+    const { resolve: resolve4, dirname } = await import('path');
+    const { fileURLToPath } = await import('url');
+    try {
+      const __dirname = dirname(fileURLToPath(import.meta.url));
+      const docPath = resolve4(__dirname, "../../docs/CUSTOMIZATION.md");
+      let content;
+      try {
+        content = await readFile4(docPath, "utf-8");
+      } catch {
+        const altPath = resolve4(__dirname, "../docs/CUSTOMIZATION.md");
+        content = await readFile4(altPath, "utf-8");
+      }
+      if (topic && topic !== "all") {
+        const sections = {
+          "config": "## Config Overrides",
+          "custom-rules": "## Custom Rules",
+          "rules": "### All Rule IDs"
+        };
+        const header = sections[topic];
+        if (header) {
+          const startIdx = content.indexOf(header);
+          if (startIdx !== -1) {
+            const nextH2 = content.indexOf("\n## ", startIdx + header.length);
+            content = nextH2 !== -1 ? content.slice(startIdx, nextH2) : content.slice(startIdx);
+          }
+        }
+      }
+      return {
+        content: [{ type: "text", text: content }]
+      };
+    } catch {
+      return {
+        content: [{ type: "text", text: "Customization guide not found. See: https://github.com/let-sunny/canicode/blob/main/docs/CUSTOMIZATION.md" }],
+        isError: true
+      };
+    }
+  }
+);
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);