canicode 0.11.4 → 0.11.5

package/.claude-plugin/marketplace.json

@@ -0,0 +1,13 @@
+{
+  "name": "canicode",
+  "owner": {
+    "name": "let-sunny"
+  },
+  "plugins": [
+    {
+      "name": "canicode",
+      "source": ".",
+      "description": "Lint Figma designs for AI code-gen and roundtrip the answers back into the file. CLI + MCP server."
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "canicode",
-  "version": "0.11.4",
+  "version": "0.11.5",
   "description": "Lint Figma designs for AI code-gen and roundtrip the answers back into the file. CLI + MCP server.",
   "skills": [
     "./skills/canicode",

package/README.md

@@ -90,6 +90,16 @@ claude mcp add canicode -- npx --yes --package=canicode canicode-mcp
 
 Restart Claude Code or reload MCP (Cursor) so canicode tools (`analyze`, `gotcha-survey`, …) load — same cold-session requirement as the Figma MCP (#433).
 
+**Smoke test (no Figma token needed):**
+
+```bash
+git clone https://github.com/let-sunny/canicode.git
+cd canicode && pnpm install && pnpm build
+canicode analyze ./fixtures/done/desktop-home-page
+```
+
+Loads a bundled fixture (no Figma API call, no token), opens the HTML report in a browser (pass `--no-open` to skip auto-launch). Use any directory under `fixtures/done/` — `desktop-*` are screen-scale, `mobile-*` are mobile viewports.
+
 <details>
 <summary><strong>All channels</strong></summary>
 
@@ -128,11 +138,14 @@ Each row below is a **complete** install. Don't run more than one — they cover
 
 | If you use… | Install |
 |-------------|---------|
-| **Claude Code** (recommended for the roundtrip workflow) | `npx canicode init --token figd_xxxxxxxxxxxxx` — saves the token AND drops `/canicode`, `/canicode-gotchas`, `/canicode-roundtrip` skills into `./.claude/skills/`. The skills already know how to call canicode via `npx canicode …`, no MCP install needed. |
+| **Claude Code** (recommended for the roundtrip workflow) | `npx canicode init --token figd_xxxxxxxxxxxxx` — saves the token AND drops `/canicode`, `/canicode-gotchas`, `/canicode-roundtrip` skills into `./.claude/skills/`. The skills already know how to call canicode via `npx canicode …`, so no **canicode** MCP install is needed; the **Figma** MCP is still required for the `/canicode-roundtrip` apply step — see the prereq below. |
 | **Cursor / Claude Desktop / other MCP host** | Add canicode to the host’s MCP config — see [`docs/CUSTOMIZATION.md`](docs/CUSTOMIZATION.md#cursor-mcp-canicode). Example (Cursor project file): `npx` + `canicode-mcp` via `--package=canicode`. |
+| **OpenClaw / other AgentSkills-compatible host** | Manual skill copy — see [Other agents (manual install)](docs/CUSTOMIZATION.md#other-agents-manual-install). Best-effort docs, not a support commitment. |
 | **Just the CLI** (CI, scripts) | Nothing. `npx canicode analyze "<figma-url>"` works directly. Run `canicode init --token …` once if you want the token persisted to `~/.canicode/config.json`. |
 
-> **Get your token:** Figma → Settings → Security → Personal access tokens → Generate new token
+> **Get your token:** Figma → Settings → Security → Personal access tokens → Generate new token. [Figma's PAT docs](https://help.figma.com/hc/en-us/articles/8085703771159-Manage-personal-access-tokens)
+> **Scope:** Read-only is sufficient for canicode.
+> **Expiry:** Tokens default to 90 days; check the dropdown when generating.
 
 > **Roundtrip prerequisite:** the `/canicode-roundtrip` skill calls the Figma MCP server to read and write the design. Install it once with `claude mcp add -s project -t http figma https://mcp.figma.com/mcp` and restart Claude Code so the new MCP tools load.
 
@@ -150,9 +163,11 @@ Drops 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>`)
 
+> The install copies 7 files total — the three SKILL.md files above plus four canicode-roundtrip helper files (`helpers.js`, `helpers-bootstrap.js`, `helpers-installer.js`, `canicode-roundtrip-helpers.d.ts`) used by the roundtrip Step 4 apply path. The CLI summary's `files installed: 7` reflects this file count.
+
 > **Explicit invocation:** the SKILL.md `description` fields advertise TRIGGER conditions so the model auto-routes Figma-URL prompts to the right skill, but routing is non-deterministic. For deterministic invocation, type `/canicode <figma-url>`, `/canicode-gotchas <figma-url>`, or `/canicode-roundtrip <figma-url>` directly — the slash command bypasses model-based routing.
 
-The skills shell out to `npx canicode …` for analyze / gotcha-survey when the canicode MCP server is not installed — both paths produce the same JSON shape. The Figma MCP server is still required for the apply step (Step 4 in `/canicode-roundtrip`); see the prereq note above.
+The skills shell out to `npx canicode …` for analyze / gotcha-survey, so installing the **canicode** MCP server is optional (both paths produce the same JSON shape). The **Figma** MCP server, however, is required for the apply step (Step 4 in `/canicode-roundtrip`); see the prereq note above.
 
 Flags: `--global` installs into `~/.claude/skills/` instead. `--cursor-skills` also installs Cursor copies under `.cursor/skills/`. `--force` overwrites existing skill files without prompting. Run `canicode docs setup` for the full setup guide.
 
@@ -184,6 +199,8 @@ For Cursor / Claude Desktop config, see [`docs/CUSTOMIZATION.md`](docs/CUSTOMIZA
 npx canicode analyze "https://www.figma.com/design/ABC123/MyDesign?node-id=1-234"
 ```
 
+> Pass `--ready-min-grade <S|A+|A|B+|B|C+|C|D|F>` to override the codegen-readiness threshold (default: A; from #483).
+
 Setup: `npx canicode init --token figd_xxxxxxxxxxxxx` saves the token and installs the Claude Code skills into `./.claude/skills/`.
 
 **Figma API Rate Limits** — Rate limits depend on **where the file lives**, not just your plan.

package/dist/cli/index.js

@@ -4245,7 +4245,7 @@ function computeApplyContext(violation, instanceContext) {
 }
 
 // package.json
-var version2 = "0.11.4";
+var version2 = "0.11.5";
 
 // src/core/engine/scoring.ts
 var GRADE_ORDER = ["S", "A+", "A", "B+", "B", "C+", "C", "D", "F"];
@@ -7268,9 +7268,9 @@ async function runInitSkillInstallSteps(options) {
     });
     console.log(`
   Skills installed to: ${summary.targetDir}/`);
-    console.log(`    installed:   ${summary.installed.length}`);
-    console.log(`    overwritten: ${summary.overwritten.length}`);
-    console.log(`    skipped:     ${summary.skipped.length}`);
+    console.log(`    files installed:   ${summary.installed.length}`);
+    console.log(`    files overwritten: ${summary.overwritten.length}`);
+    console.log(`    files skipped:     ${summary.skipped.length}`);
     if (summary.skipped.length > 0) {
       console.log(`  (Re-run with --force to overwrite skipped files.)`);
     }
@@ -7294,9 +7294,9 @@ async function runInitSkillInstallSteps(options) {
       });
       console.log(`
   Cursor skills installed to: ${cSummary.targetDir}/`);
-      console.log(`    installed:   ${cSummary.installed.length}`);
-      console.log(`    overwritten: ${cSummary.overwritten.length}`);
-      console.log(`    skipped:     ${cSummary.skipped.length}`);
+      console.log(`    files installed:   ${cSummary.installed.length}`);
+      console.log(`    files overwritten: ${cSummary.overwritten.length}`);
+      console.log(`    files skipped:     ${cSummary.skipped.length}`);
       if (cSummary.skipped.length > 0) {
         console.log(`  (Re-run with --force to overwrite skipped files.)`);
       }