canicode 0.5.2 → 0.6.0

package/dist/mcp/server.js

@@ -1063,6 +1063,86 @@ var FigmaUrlParseError = class extends Error {
 function buildFigmaDeepLink(fileKey, nodeId) {
   return `https://www.figma.com/design/${fileKey}?node-id=${encodeURIComponent(nodeId)}`;
 }
+var AIREADY_DIR = join(homedir(), ".canicode");
+var CONFIG_PATH = join(AIREADY_DIR, "config.json");
+var REPORTS_DIR = join(AIREADY_DIR, "reports");
+function ensureDir(dir) {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+function readConfig() {
+  if (!existsSync(CONFIG_PATH)) {
+    return {};
+  }
+  try {
+    const raw = readFileSync(CONFIG_PATH, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function getFigmaToken() {
+  return process.env["FIGMA_TOKEN"] ?? readConfig().figmaToken;
+}
+function getReportsDir() {
+  return REPORTS_DIR;
+}
+function ensureReportsDir() {
+  ensureDir(REPORTS_DIR);
+}
+function getTelemetryEnabled() {
+  return readConfig().telemetry !== false;
+}
+function getPosthogApiKey() {
+  return process.env["POSTHOG_API_KEY"] ?? readConfig().posthogApiKey;
+}
+function getSentryDsn() {
+  return process.env["SENTRY_DSN"] ?? readConfig().sentryDsn;
+}
+
+// src/core/loader.ts
+function isFigmaUrl(input) {
+  return input.includes("figma.com/");
+}
+function isJsonFile(input) {
+  return input.endsWith(".json");
+}
+async function loadFile(input, token) {
+  if (isJsonFile(input)) {
+    const filePath = resolve(input);
+    if (!existsSync(filePath)) {
+      throw new Error(`File not found: ${filePath}`);
+    }
+    console.log(`Loading from JSON: ${filePath}`);
+    return { file: await loadFigmaFileFromJson(filePath) };
+  }
+  if (isFigmaUrl(input)) {
+    const { fileKey, nodeId } = parseFigmaUrl(input);
+    return loadFromApi(fileKey, nodeId, token);
+  }
+  throw new Error(
+    `Invalid input: ${input}. Provide a Figma URL or JSON file path.`
+  );
+}
+async function loadFromApi(fileKey, nodeId, token) {
+  console.log(`Fetching from Figma REST API: ${fileKey}`);
+  if (nodeId) {
+    console.log(`Target node: ${nodeId}`);
+  }
+  const figmaToken = token ?? getFigmaToken();
+  if (!figmaToken) {
+    throw new Error(
+      "Figma token required. Run 'canicode init --token YOUR_TOKEN' or set FIGMA_TOKEN env var."
+    );
+  }
+  const client = new FigmaClient({ token: figmaToken });
+  const response = await client.getFile(fileKey);
+  return {
+    file: transformFigmaResponse(fileKey, response),
+    nodeId
+  };
+}
 
 // src/adapters/figma-mcp-adapter.ts
 var TAG_TYPE_MAP = {
@@ -1194,118 +1274,6 @@ function parseMcpMetadataXml(xml, fileKey, fileName) {
     styles: {}
   };
 }
-var AIREADY_DIR = join(homedir(), ".canicode");
-var CONFIG_PATH = join(AIREADY_DIR, "config.json");
-var REPORTS_DIR = join(AIREADY_DIR, "reports");
-function ensureDir(dir) {
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-}
-function readConfig() {
-  if (!existsSync(CONFIG_PATH)) {
-    return {};
-  }
-  try {
-    const raw = readFileSync(CONFIG_PATH, "utf-8");
-    return JSON.parse(raw);
-  } catch {
-    return {};
-  }
-}
-function getFigmaToken() {
-  return process.env["FIGMA_TOKEN"] ?? readConfig().figmaToken;
-}
-function getReportsDir() {
-  return REPORTS_DIR;
-}
-function ensureReportsDir() {
-  ensureDir(REPORTS_DIR);
-}
-function getTelemetryEnabled() {
-  return readConfig().telemetry !== false;
-}
-function getPosthogApiKey() {
-  return process.env["POSTHOG_API_KEY"] ?? readConfig().posthogApiKey;
-}
-function getSentryDsn() {
-  return process.env["SENTRY_DSN"] ?? readConfig().sentryDsn;
-}
-
-// src/core/loader.ts
-function isFigmaUrl(input) {
-  return input.includes("figma.com/");
-}
-function isJsonFile(input) {
-  return input.endsWith(".json");
-}
-async function loadFile(input, token, mode = "auto") {
-  if (isJsonFile(input)) {
-    const filePath = resolve(input);
-    if (!existsSync(filePath)) {
-      throw new Error(`File not found: ${filePath}`);
-    }
-    console.log(`Loading from JSON: ${filePath}`);
-    return { file: await loadFigmaFileFromJson(filePath) };
-  }
-  if (isFigmaUrl(input)) {
-    const { fileKey, nodeId, fileName } = parseFigmaUrl(input);
-    if (mode === "mcp") {
-      return loadFromMcp(fileKey, nodeId, fileName);
-    }
-    if (mode === "api") {
-      return loadFromApi(fileKey, nodeId, token);
-    }
-    try {
-      console.log("Auto-detecting data source... trying MCP first.");
-      return await loadFromMcp(fileKey, nodeId, fileName);
-    } catch (mcpError) {
-      const mcpMsg = mcpError instanceof Error ? mcpError.message : String(mcpError);
-      console.log(`MCP unavailable (${mcpMsg}). Falling back to REST API.`);
-      return loadFromApi(fileKey, nodeId, token);
-    }
-  }
-  throw new Error(
-    `Invalid input: ${input}. Provide a Figma URL or JSON file path.`
-  );
-}
-async function loadFromMcp(fileKey, nodeId, fileName) {
-  console.log(`Loading via MCP: ${fileKey} (node: ${nodeId ?? "root"})`);
-  const file = await loadViaMcp(fileKey, nodeId ?? "0:1", fileName);
-  return { file, nodeId };
-}
-async function loadFromApi(fileKey, nodeId, token) {
-  console.log(`Fetching from Figma REST API: ${fileKey}`);
-  if (nodeId) {
-    console.log(`Target node: ${nodeId}`);
-  }
-  const figmaToken = token ?? getFigmaToken();
-  if (!figmaToken) {
-    throw new Error(
-      "Figma token required. Run 'canicode init --token YOUR_TOKEN' or set FIGMA_TOKEN env var."
-    );
-  }
-  const client = new FigmaClient({ token: figmaToken });
-  const response = await client.getFile(fileKey);
-  return {
-    file: transformFigmaResponse(fileKey, response),
-    nodeId
-  };
-}
-async function loadViaMcp(fileKey, nodeId, fileName) {
-  const { execSync } = await import('child_process');
-  const result = execSync(
-    `claude --print "Use the mcp__figma__get_metadata tool with fileKey=\\"${fileKey}\\" and nodeId=\\"${nodeId.replace(/-/g, ":")}\\" \u2014 return ONLY the raw XML output, nothing else."`,
-    { encoding: "utf-8", timeout: 12e4 }
-  );
-  const xmlStart = result.indexOf("<");
-  const xmlEnd = result.lastIndexOf(">");
-  if (xmlStart === -1 || xmlEnd === -1) {
-    throw new Error("MCP did not return valid XML metadata");
-  }
-  const xml = result.slice(xmlStart, xmlEnd + 1);
-  return parseMcpMetadataXml(xml, fileKey, fileName);
-}
 
 // src/core/design-data-parser.ts
 function parseDesignData(data, fileKey, fileName) {
@@ -3254,9 +3222,16 @@ Two ways to provide design data:
 1. designData \u2014 Pass Figma node data directly (from Figma MCP get_metadata). Recommended when using Figma MCP.
 2. input \u2014 Figma URL (fetches via REST API, requires FIGMA_TOKEN).
 
-Typical flow with Figma MCP:
-  Step 1: Call Figma MCP get_metadata to get the node tree
-  Step 2: Pass the result as designData to this tool`,
+Typical flow with Figma MCP (recommended, no token needed):
+  Step 1: Call the official Figma MCP's get_metadata tool to get the node tree
+  Step 2: Pass the result as designData to this tool
+
+IMPORTANT \u2014 Before calling this tool, check which data source is available:
+- If the official Figma MCP (https://mcp.figma.com/mcp) is connected: use get_metadata \u2192 designData flow. No token needed.
+- If Figma MCP is NOT connected: use the input parameter with a Figma URL. This requires a FIGMA_TOKEN.
+  Tell the user: "The official Figma MCP server is not connected. To use without a token, set it up:
+  claude mcp add -s project -t http figma https://mcp.figma.com/mcp
+  Otherwise, provide a Figma API token via FIGMA_TOKEN env var or the token parameter."`,
   {
     designData: z.string().optional().describe("Figma node data from Figma MCP get_metadata (XML or JSON). Pass this instead of input when using Figma MCP."),
     input: z.string().optional().describe("Figma URL. Used when designData is not provided. Requires FIGMA_TOKEN."),
@@ -3282,7 +3257,7 @@ Typical flow with Figma MCP:
       if (designData) {
         file = parseDesignData(designData, fileKey ?? "unknown", fileName);
       } else if (input) {
-        const loaded = await loadFile(input, token, "api");
+        const loaded = await loadFile(input, token);
         file = loaded.file;
         nodeId = loaded.nodeId;
       } else {