canicode 0.10.0 → 0.10.2

package/README.md

@@ -57,7 +57,7 @@ Rule scores aren't guesswork. The calibration pipeline converts real Figma desig
 
 ```bash
 # 1. Save your Figma token AND install the /canicode-roundtrip skill
-canicode init --token figd_xxxxxxxxxxxxx
+npx canicode init --token figd_xxxxxxxxxxxxx
 
 # 2. Run the roundtrip on a Figma URL
 /canicode-roundtrip https://www.figma.com/design/ABC123/MyDesign?node-id=1-234
@@ -116,7 +116,7 @@ Each issue is classified: **Blocking** > **Risk** > **Missing Info** > **Suggest
 npx canicode analyze "https://www.figma.com/design/ABC123/MyDesign?node-id=1-234"
 ```
 
-Setup: `canicode init --token figd_xxxxxxxxxxxxx` — saves the token AND installs the Claude Code skills (see below).
+Setup: `npx canicode init --token figd_xxxxxxxxxxxxx` — saves the token AND installs the Claude Code skills (see below).
 
 > **Get your token:** Figma → Settings → Security → Personal access tokens → Generate new token
 
@@ -157,7 +157,7 @@ For Cursor / Claude Desktop config, see [`docs/CUSTOMIZATION.md`](docs/CUSTOMIZA
 <summary><strong>Claude Code Skills</strong> (lightweight, no MCP install)</summary>
 
 ```bash
-canicode init --token figd_xxxxxxxxxxxxx
+npx canicode init --token figd_xxxxxxxxxxxxx
 ```
 
 Saves your Figma token AND installs three skills into `./.claude/skills/`:
@@ -166,6 +166,8 @@ Saves your Figma token AND installs three skills into `./.claude/skills/`:
 - **canicode-gotchas** — standalone gotcha survey (use `/canicode-gotchas <figma-url>`)
 - **canicode-roundtrip** — full analyze → gotcha → apply roundtrip (use `/canicode-roundtrip <figma-url>`)
 
+> **Next:** install the Figma MCP server (`claude mcp add -s project -t http figma https://mcp.figma.com/mcp`) and restart Claude Code so both the skills and the MCP tools load. See the **MCP Server** section above for context.
+
 Flags: `--global` installs into `~/.claude/skills/` instead. `--no-skills` skips skill install (token only). `--force` overwrites existing skill files without prompting. Run `canicode docs setup` for the full setup guide.
 
 </details>

package/dist/cli/index.js

@@ -4015,7 +4015,7 @@ function computeApplyContext(violation, instanceContext) {
 }
 
 // package.json
-var version2 = "0.10.0";
+var version2 = "0.10.2";
 
 // src/core/engine/scoring.ts
 function computeTotalScorePerCategory(configs) {
@@ -6166,6 +6166,38 @@ async function promptOverwriteBatch(candidates) {
 }
 
 // src/cli/commands/init.ts
+function figmaMcpRegistered(cwd = process.cwd()) {
+  try {
+    const raw = readFileSync(join(cwd, ".mcp.json"), "utf-8");
+    const parsed = JSON.parse(raw);
+    const figma = parsed?.mcpServers?.["figma"];
+    return typeof figma === "object" && figma !== null;
+  } catch {
+    return false;
+  }
+}
+function formatNextSteps(opts) {
+  if (!opts.skillsInstalled) {
+    return `
+  Next: canicode analyze "https://www.figma.com/design/..."`;
+  }
+  if (opts.figmaMcpPresent) {
+    return [
+      "",
+      "  Next:",
+      "    1. Restart Claude Code (the newly installed skills only load on a fresh session)",
+      "    2. Run /canicode-roundtrip <figma-url>"
+    ].join("\n");
+  }
+  return [
+    "",
+    "  Next:",
+    "    1. Install Figma MCP:",
+    "         claude mcp add -s project -t http figma https://mcp.figma.com/mcp",
+    "    2. Restart Claude Code (so the new skills + Figma MCP tools both load)",
+    "    3. Run /canicode-roundtrip <figma-url>"
+  ].join("\n");
+}
 var InitOptionsSchema = z.object({
   token: z.string().optional(),
   global: z.boolean().optional(),
@@ -6227,8 +6259,12 @@ ${msg}`);
           ...skillSummary ?? {}
         });
         if (skillStepOk) {
-          console.log(`
-  Next: canicode analyze "https://www.figma.com/design/..."`);
+          console.log(
+            formatNextSteps({
+              figmaMcpPresent: figmaMcpRegistered(),
+              skillsInstalled: options.skills !== false
+            })
+          );
         }
         return;
       }