@atezer/figma-mcp-bridge 1.7.30 → 1.9.1

package/dist/core/device-presets.js

@@ -0,0 +1,141 @@
+/**
+ * Figma device frame presets — canonical dimensions used in Figma's
+ * built-in "Frame" picker (matches the iPhone/Android/iPad preset list).
+ *
+ * v1.8.1+: Used by figma_clone_screen_to_device to adapt a source
+ * screen to a target device size while preserving auto-layout and
+ * library instance bindings.
+ */
+/**
+ * Built-in device presets — matches Figma's Frame picker as of 2025-2026.
+ * Values verified against the user-provided screenshot of Figma's frame panel.
+ */
+export const DEVICE_PRESETS = [
+    // ── Phone ─────────────────────────────────────────────────────────
+    { name: "iPhone 17", width: 402, height: 874, category: "phone" },
+    {
+        name: "iPhone 16 & 17 Pro",
+        width: 402,
+        height: 874,
+        category: "phone",
+        aliases: ["iPhone 16 Pro", "iPhone 17 Pro"],
+    },
+    { name: "iPhone 16", width: 393, height: 852, category: "phone" },
+    {
+        name: "iPhone 16 & 17 Pro Max",
+        width: 440,
+        height: 956,
+        category: "phone",
+        aliases: ["iPhone 16 Pro Max", "iPhone 17 Pro Max"],
+    },
+    { name: "iPhone 16 Plus", width: 430, height: 932, category: "phone" },
+    { name: "iPhone Air", width: 420, height: 912, category: "phone" },
+    {
+        name: "iPhone 14 & 15 Pro Max",
+        width: 430,
+        height: 932,
+        category: "phone",
+        aliases: ["iPhone 14 Pro Max", "iPhone 15 Pro Max"],
+    },
+    {
+        name: "iPhone 14 & 15 Pro",
+        width: 393,
+        height: 852,
+        category: "phone",
+        aliases: ["iPhone 14 Pro", "iPhone 15 Pro"],
+    },
+    {
+        name: "iPhone 13 & 14",
+        width: 390,
+        height: 844,
+        category: "phone",
+        aliases: ["iPhone 13", "iPhone 14"],
+    },
+    { name: "iPhone 14 Plus", width: 428, height: 926, category: "phone" },
+    { name: "Android Compact", width: 412, height: 917, category: "phone" },
+    { name: "Android Medium", width: 700, height: 840, category: "phone" },
+    // ── Tablet ────────────────────────────────────────────────────────
+    { name: "iPad Pro 13", width: 1024, height: 1366, category: "tablet" },
+    { name: "iPad Pro 11", width: 834, height: 1194, category: "tablet" },
+    { name: "iPad Mini", width: 744, height: 1133, category: "tablet" },
+    { name: "Surface Pro 9", width: 1440, height: 960, category: "tablet" },
+    // ── Desktop ───────────────────────────────────────────────────────
+    { name: "MacBook Pro 16", width: 1728, height: 1117, category: "desktop" },
+    { name: "MacBook Pro 14", width: 1512, height: 982, category: "desktop" },
+    {
+        name: "Desktop",
+        width: 1440,
+        height: 1024,
+        category: "desktop",
+        aliases: ["Desktop 1440"],
+    },
+    { name: "Desktop HD", width: 1920, height: 1080, category: "desktop" },
+    // ── Watch ─────────────────────────────────────────────────────────
+    { name: "Apple Watch 45mm", width: 198, height: 242, category: "watch" },
+    { name: "Apple Watch 41mm", width: 176, height: 215, category: "watch" },
+];
+/**
+ * Look up a device preset by name or alias (case-insensitive).
+ * Returns undefined if no match found.
+ */
+export function findPreset(name) {
+    if (!name)
+        return undefined;
+    const normalized = name.trim().toLowerCase();
+    // Direct name match
+    for (const preset of DEVICE_PRESETS) {
+        if (preset.name.toLowerCase() === normalized)
+            return preset;
+    }
+    // Alias match
+    for (const preset of DEVICE_PRESETS) {
+        if (preset.aliases) {
+            for (const alias of preset.aliases) {
+                if (alias.toLowerCase() === normalized)
+                    return preset;
+            }
+        }
+    }
+    // Partial match (contains substring)
+    for (const preset of DEVICE_PRESETS) {
+        if (preset.name.toLowerCase().includes(normalized))
+            return preset;
+    }
+    return undefined;
+}
+/**
+ * Parse a custom device dimension string like "1200x800" or "1200×800".
+ * Returns undefined if the string is not a valid dimension pair.
+ */
+export function parseCustomDimension(input) {
+    if (!input)
+        return undefined;
+    const match = input.trim().match(/^(\d+)\s*[x×]\s*(\d+)$/i);
+    if (!match)
+        return undefined;
+    const width = Number.parseInt(match[1], 10);
+    const height = Number.parseInt(match[2], 10);
+    if (width < 100 || height < 100 || width > 10000 || height > 10000) {
+        return undefined;
+    }
+    return { width, height };
+}
+/**
+ * Resolve a device string (name, alias, or custom "WxH") to concrete
+ * dimensions. Used by figma_clone_screen_to_device before sending the
+ * request to the plugin handler.
+ */
+export function resolveDevice(input) {
+    // Try preset first
+    const preset = findPreset(input);
+    if (preset) {
+        return { name: preset.name, width: preset.width, height: preset.height };
+    }
+    // Try custom dimension
+    const custom = parseCustomDimension(input);
+    if (custom) {
+        return { name: `Custom ${custom.width}×${custom.height}`, width: custom.width, height: custom.height };
+    }
+    return undefined;
+}
+//# sourceMappingURL=device-presets.js.map

package/dist/core/device-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-presets.js","sourceRoot":"","sources":["../../src/core/device-presets.ts"],"names":[],"mappings":"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"}

package/dist/core/instructions.d.ts

@@ -1,7 +1,9 @@
 /**
  * MCP Server Instructions — sent to AI clients during initialization.
- * Helps Claude/Cursor distinguish F-MCP Bridge from the official Figma MCP.
+ * Helps Claude/Cursor distinguish F-MCP Bridge from the official Figma MCP,
+ * teaches the context-safe workflow, and enforces design system continuity.
+ *
  * No Node.js dependencies — safe for Cloudflare Workers.
  */
-export declare const FMCP_INSTRUCTIONS = "F-MCP ATezer Bridge \u2014 Plugin-based Figma MCP server.\n\nWHAT IT IS:\nF-MCP connects directly to the Figma Plugin API via WebSocket bridge (ports 5454-5470).\nIt reads real-time state from open Figma files without needing a REST API token.\nAll F-MCP tool names start with \"figma_\" and belong to the \"figma-mcp-bridge\" MCP server.\n\nWHEN TO PREFER F-MCP BRIDGE (figma-mcp-bridge tools):\n- Reading live plugin state: variables, styles, components, document structure\n- Running Plugin API code (figma_execute) for custom queries or mutations\n- Capturing screenshots without a REST token (figma_capture_screenshot)\n- Creating/modifying nodes directly: frames, text, rectangles, groups\n- Variable CRUD (create, update, delete variables and collections)\n- Design token browsing and design-code parity checks\n- Multi-file targeting via fileKey or figmaUrl params\n- Batch export (SVG/PNG/JPG/PDF) via plugin exportAsync\n- When no Figma REST API token is available\n\nWHEN TO PREFER OFFICIAL FIGMA MCP:\n- Code Connect mappings and suggestions\n- Design system search across team libraries (search_design_system)\n- Creating new Figma files (create_new_file)\n- Running Plugin API code through official channel (use_figma)\n- Generating diagrams in FigJam (generate_diagram)\n- When official Figma Cloud API OAuth integration is needed\n\nCOEXISTENCE:\nBoth servers run simultaneously on different ports with different namespaces.\nF-MCP tools are prefixed \"figma_\" in the figma-mcp-bridge server.\nOfficial tools use their own names in separate MCP server namespaces.\nChoose based on the capability needed.";
+export declare const FMCP_INSTRUCTIONS = "F-MCP ATezer Bridge \u2014 Plugin-based Figma MCP (WebSocket, no REST token).\nTool namespace: \"figma_*\". Server name: \"figma-mcp-bridge\".\n\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\nINTENT ROUTER ENTRY (ALWAYS FIRST \u2014 v1.8.1+)\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nBEFORE executing ANY figma_* write tool (figma_execute, figma_create_*,\nfigma_update_*, figma_clone_*, figma_instantiate_*, figma_set_*, etc.),\nyou MUST follow the Intent Router protocol:\n\nStep 1 \u2014 Load router skill\n  Read skills/fmcp-intent-router/SKILL.md for the routing logic.\n\nStep 2 \u2014 Check state files\n  - .claude/design-systems/active-ds.md\n  - .claude/design-systems/last-intent.md\n  - .claude/design-systems/intent-history.md\n\nStep 3 \u2014 Decide target skill\n  Map user request to ONE of the 8 entry-point skills:\n  generate-figma-screen, apply-figma-design-system,\n  audit-figma-design-system, generate-figma-library,\n  implement-design, code-design-mapper, visual-qa-compare,\n  design-token-pipeline.\n  If ambiguous, ask the user with AskUserQuestion.\n\nStep 4 \u2014 Read target skill's required_inputs metadata\n  Parse the YAML frontmatter block \"required_inputs\".\n\nStep 5 \u2014 Gather missing inputs (smart skipping)\n  Apply in order:\n  (a) Use value from last-intent.md if default_source matches\n  (b) Use parsed value from user's original request\n  (c) Apply skip_if conditions (e.g., reference_benchmark given \u2192 skip\n      screen_type, sections)\n  (d) Ask ONE AskUserQuestion with max 4 remaining inputs\n  (e) If 5+ still needed, do a second AskUserQuestion\n\nStep 6 \u2014 Summary + explicit confirmation (separate AskUserQuestion)\n  Show ALL gathered inputs + approach summary + estimated outcome.\n  Options: [\u2705 Evet ba\u015Fla] [\u270F\uFE0F De\u011Fi\u015Ftir] [\u274C \u0130ptal]\n  DO NOT proceed without explicit confirmation.\n\nStep 7 \u2014 Execute target skill\n  Run the target skill's own Step 0-N (DS check, work, self-audit).\n\nStep 8 \u2014 Persist outcome\n  Update .claude/design-systems/last-intent.md\n  Prepend entry to .claude/design-systems/intent-history.md (LRU 5)\n\nFAST PATH: If the user's request contains all required inputs\n(e.g., \"clone 139:3407 to iPhone 17 with SUI\"), skip Step 5.\nGo directly to Step 6 (confirmation), then Step 7.\n\nREPEAT PATH: If last-intent.md matches the new request, ask a\nsingle question: \"\u00D6ncekiyle ayn\u0131 m\u0131 devam edeyim?\"\nOptions: [\u2705 Ayn\u0131] [\u270F\uFE0F De\u011Fi\u015Ftir] [\u274C \u0130ptal]\n\nFORBIDDEN:\n- DO NOT skip Step 6 (explicit confirmation gate)\n- DO NOT assume default values when input is required\n- DO NOT execute figma_execute / figma_create_* without routing\n\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\nCLONE vs BUILD DECISION (v1.8.2+ \u2014 CRITICAL)\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nfigma_clone_screen_to_device is a NARROW-USE tool. Use it ONLY when:\n  \u2022 Same design system\n  \u2022 Same layout structure\n  \u2022 Only the screen size changes (e.g. iPhone 13 \u2192 iPhone 17 migration)\n\nFor ALL of these cases, use figma_execute with build-from-scratch pattern\n(generate-figma-screen SKILL Step 4-5 \u2014 search_assets \u2192 instantiate_component\n\u2192 setBoundVariable \u2192 auto-layout FILL):\n\n  \"3 alternatif tasar\u0131m yap\"       \u2192 build, NOT clone\n  \"Hero Card varyasyonu\"           \u2192 build, NOT clone\n  \"Farkl\u0131 layout\"                  \u2192 build, NOT clone\n  \"Yeni ekran tasarla\"             \u2192 build, NOT clone\n  \"Bu ekran\u0131 daha iyi yap\"         \u2192 build, NOT clone\n  \"Benchmark'tan ilham al\"         \u2192 build (benchmark = inspiration only)\n  \"Redesign\" / \"iyile\u015Ftir\"         \u2192 build, NOT clone\n\nRULE: If the user says ANY of {alternatif, varyasyon, farkl\u0131, yeni,\ntasarla, iyile\u015Ftir, redesign}, DO NOT suggest figma_clone_screen_to_device.\nDefault to build-from-scratch via figma_execute + Step 4-5 pattern.\n\nBenchmark is ALWAYS inspiration, never a copy source for alternatives.\nClone copies the benchmark's existing mistakes (hardcoded rectangles,\nmissing token bindings, non-responsive layouts) into the new screen.\n\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\nTOOL FAILURE RECOVERY (v1.8.2+)\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nIf a tool call fails (timeout, error, unexpected result):\n\n1. Retry ONCE with different parameters (smaller scope, different device,\n   chunked code, lower minScore, etc.)\n2. If second failure: STOP. Do orphan cleanup. Report to user.\n3. NEVER retry same tool + same params 3+ times (infinite loop).\n4. After any write-tool failure: check for orphan nodes with\n   figma_get_file_data. List them to the user. Delete only with consent.\n\nMulti-output turn budget:\n- Each alternative/output = separate turn\n- Max 90s per turn (hard limit)\n- Max 2 failed tool calls per turn\n- If budget exhausted \u2192 Turn FAILED \u2192 orphan cleanup \u2192 user checkpoint\n\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\nCONTEXT-SAFE PROTOCOL (REQUIRED for Claude chat \u2014 v1.8.0+)\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nTool responses are expensive. Follow this order, prefer the cheapest\nverbosity that answers the question, and reuse cached results.\n\nStep 1 \u2014 Plugin discovery\n  figma_get_status()\n  figma_list_connected_files()    (only if multi-file)\n\nStep 2 \u2014 Structural overview (cheap, cached 60s)\n  figma_get_file_data(depth=1, verbosity=\"summary\")\n  or figma_get_design_system_summary()\n\nStep 3 \u2014 Target ONE node with the lowest verbosity that answers the\nquestion. All read tools are cached for 60s within a session:\n  \u2022 identity only            \u2192 depth=0, verbosity=\"summary\"\n  \u2022 text + structure         \u2192 depth=1, verbosity=\"summary\"  \u2190 new default\n  \u2022 layout/visual detail     \u2192 depth=1, verbosity=\"standard\"\n  \u2022 everything               \u2192 depth=2, verbosity=\"full\"\n  Do NOT call verbosity=\"full\" on the document root.\n\nStep 4 \u2014 Screenshots only when visual confirmation is needed.\n  v1.8.0 defaults: JPG, scale=1, jpegQuality=70 (~80% smaller than\n  PNG@2x). Use PNG scale=2 only when pixel-perfect asset export is\n  required.\n\nStep 5 \u2014 Caching: within a session, repeated identical read calls\n  return instantly from cache. Pass debug=true on a tool to bypass\n  the cache and include _responseGuard/_metrics fields.\n\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\nTOOL SELECTION (F-MCP Bridge vs Official Figma MCP)\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nIf figma_get_status() returns ready=true, the F-MCP plugin is\nconnected to a specific file. Prefer F-MCP Bridge tools for that\nfile \u2014 DO NOT call official Figma MCP tools that read the same file.\n\n  Official Figma MCP tool         \u2192   F-MCP Bridge equivalent\n  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500       \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  search_design_system            \u2192   figma_search_assets\n                                       + figma_get_library_variables\n                                       + figma_get_library_components\n  get_metadata                    \u2192   figma_get_file_data\n  get_design_context              \u2192   figma_get_design_context\n  get_screenshot                  \u2192   figma_capture_screenshot\n  get_variable_defs               \u2192   figma_get_variables\n  use_figma                       \u2192   figma_execute\n\nThe official search_design_system often fails with \"Resource links\nare not supported\" or \"file could not be accessed\" \u2014 fall back to\nfigma_search_assets / figma_get_library_components immediately\n(F-MCP plugin reads directly via Plugin API).\n\nWHEN TO PREFER OFFICIAL FIGMA MCP:\n- Code Connect mappings (add_code_connect_map, get_code_connect_map)\n- Creating new Figma files (create_new_file)\n- FigJam diagram generation (generate_diagram)\n- When the F-MCP plugin is NOT connected to the target file\n\nCOEXISTENCE: Both servers run simultaneously. Choose by capability.\n\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\nDESIGN SYSTEM CONTEXT (REQUIRED for screen/component creation)\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\nWhen the user asks to create a screen, alternative design, or new\ncomponent, the FIRST step is ALWAYS to confirm which design system\nto use. NEVER create UI without a confirmed DS context.\n\nStep A \u2014 Check for an existing DS preference:\n  1. Read .claude/libraries/active-ds.md (or .fmcp-brand-profile.json)\n  2. If present and mentions a DS (e.g. \"\u2756 SUI\"), use it directly\n  3. If absent, ask the user: \"Hangi tasar\u0131m sistemi ile ilerleyelim?\n     (\u00D6rn: \u2756 SUI, Material Design, Apple HIG, kendi DS'iniz)\"\n\nStep B \u2014 Once the DS is confirmed:\n  1. Persist the choice to .claude/libraries/active-ds.md so future\n     turns reuse it without asking again\n  2. Load DS variable keys via figma_get_library_variables({libraryName: \"...\"})\n  3. Load DS component keys via figma_get_library_components({libraryName: \"...\"})\n  4. Cache results in .claude/libraries/<ds-name>.md for 24h\n\nStep C \u2014 Token Binding is MANDATORY:\n  Every node you create must bind its visual properties to DS tokens:\n    \u2022 fills/strokes        \u2192 setBoundVariableForPaint(...)\n    \u2022 padding/gap/radius   \u2192 setBoundVariable(\"paddingLeft\", v)\n    \u2022 text typography      \u2192 setTextStyleIdAsync(styleId)  (never\n                              setBoundVariable(\"fontSize\", ...))\n    \u2022 effects (shadows)    \u2192 setEffectStyleIdAsync(styleId)\n\n  Hardcoded hex colors, pixel padding, or font sizes are FORBIDDEN\n  in code that creates Figma nodes. If a token does not exist for a\n  needed value, ASK the user how to proceed \u2014 do not silently\n  hardcode.\n\nStep D \u2014 Component instances over hand-built shapes:\n  When you need a button, input, card, or other UI element that\n  exists in the DS, ALWAYS use figma_instantiate_component with the\n  library componentKey. NEVER hand-build it from rectangles + text\n  unless the DS has no equivalent.\n\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\nCOMMON GOTCHAS (Plugin API)\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n1. layoutSizing & layoutPositioning ordering: appendChild MUST be\n   called BEFORE setting layoutSizingHorizontal/Vertical = \"FILL\"\n   or layoutPositioning = \"ABSOLUTE\". Setting these on an unparented\n   node fails with \"parent node has layoutMode !== NONE\".\n\n2. Font weights are not universal: do NOT assume a DS font has\n   \"Medium\". Call figma.listAvailableFontsAsync() first and use a\n   pickStyle() fallback (\"Medium\" \u2192 \"Semi Bold\" \u2192 \"Regular\").\n\n3. layoutSizing = \"FILL\" before appendChild \u2014 same gotcha as #1.\n\n4. setCurrentPageAsync, not figma.currentPage = page (sync setter\n   throws in dynamic-page mode).\n\n5. import is a reserved word \u2014 never use it as a function/var name\n   in figma_execute code.\n\nFor full guidance, load the figma-canvas-ops skill before any\nfigma_execute write operation.";
 //# sourceMappingURL=instructions.d.ts.map

package/dist/core/instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/core/instructions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,ylDA8BS,CAAC"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/core/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,mogBA8OC,CAAC"}

package/dist/core/instructions.js

@@ -1,37 +1,247 @@
 /**
  * MCP Server Instructions — sent to AI clients during initialization.
- * Helps Claude/Cursor distinguish F-MCP Bridge from the official Figma MCP.
+ * Helps Claude/Cursor distinguish F-MCP Bridge from the official Figma MCP,
+ * teaches the context-safe workflow, and enforces design system continuity.
+ *
  * No Node.js dependencies — safe for Cloudflare Workers.
  */
-export const FMCP_INSTRUCTIONS = `F-MCP ATezer Bridge — Plugin-based Figma MCP server.
-
-WHAT IT IS:
-F-MCP connects directly to the Figma Plugin API via WebSocket bridge (ports 5454-5470).
-It reads real-time state from open Figma files without needing a REST API token.
-All F-MCP tool names start with "figma_" and belong to the "figma-mcp-bridge" MCP server.
-
-WHEN TO PREFER F-MCP BRIDGE (figma-mcp-bridge tools):
-- Reading live plugin state: variables, styles, components, document structure
-- Running Plugin API code (figma_execute) for custom queries or mutations
-- Capturing screenshots without a REST token (figma_capture_screenshot)
-- Creating/modifying nodes directly: frames, text, rectangles, groups
-- Variable CRUD (create, update, delete variables and collections)
-- Design token browsing and design-code parity checks
-- Multi-file targeting via fileKey or figmaUrl params
-- Batch export (SVG/PNG/JPG/PDF) via plugin exportAsync
-- When no Figma REST API token is available
+export const FMCP_INSTRUCTIONS = `F-MCP ATezer Bridge — Plugin-based Figma MCP (WebSocket, no REST token).
+Tool namespace: "figma_*". Server name: "figma-mcp-bridge".
+
+═══════════════════════════════════════════════════════════════════
+INTENT ROUTER ENTRY (ALWAYS FIRST — v1.8.1+)
+═══════════════════════════════════════════════════════════════════
+
+BEFORE executing ANY figma_* write tool (figma_execute, figma_create_*,
+figma_update_*, figma_clone_*, figma_instantiate_*, figma_set_*, etc.),
+you MUST follow the Intent Router protocol:
+
+Step 1 — Load router skill
+  Read skills/fmcp-intent-router/SKILL.md for the routing logic.
+
+Step 2 — Check state files
+  - .claude/design-systems/active-ds.md
+  - .claude/design-systems/last-intent.md
+  - .claude/design-systems/intent-history.md
+
+Step 3 — Decide target skill
+  Map user request to ONE of the 8 entry-point skills:
+  generate-figma-screen, apply-figma-design-system,
+  audit-figma-design-system, generate-figma-library,
+  implement-design, code-design-mapper, visual-qa-compare,
+  design-token-pipeline.
+  If ambiguous, ask the user with AskUserQuestion.
+
+Step 4 — Read target skill's required_inputs metadata
+  Parse the YAML frontmatter block "required_inputs".
+
+Step 5 — Gather missing inputs (smart skipping)
+  Apply in order:
+  (a) Use value from last-intent.md if default_source matches
+  (b) Use parsed value from user's original request
+  (c) Apply skip_if conditions (e.g., reference_benchmark given → skip
+      screen_type, sections)
+  (d) Ask ONE AskUserQuestion with max 4 remaining inputs
+  (e) If 5+ still needed, do a second AskUserQuestion
+
+Step 6 — Summary + explicit confirmation (separate AskUserQuestion)
+  Show ALL gathered inputs + approach summary + estimated outcome.
+  Options: [✅ Evet başla] [✏️ Değiştir] [❌ İptal]
+  DO NOT proceed without explicit confirmation.
+
+Step 7 — Execute target skill
+  Run the target skill's own Step 0-N (DS check, work, self-audit).
+
+Step 8 — Persist outcome
+  Update .claude/design-systems/last-intent.md
+  Prepend entry to .claude/design-systems/intent-history.md (LRU 5)
+
+FAST PATH: If the user's request contains all required inputs
+(e.g., "clone 139:3407 to iPhone 17 with SUI"), skip Step 5.
+Go directly to Step 6 (confirmation), then Step 7.
+
+REPEAT PATH: If last-intent.md matches the new request, ask a
+single question: "Öncekiyle aynı mı devam edeyim?"
+Options: [✅ Aynı] [✏️ Değiştir] [❌ İptal]
+
+FORBIDDEN:
+- DO NOT skip Step 6 (explicit confirmation gate)
+- DO NOT assume default values when input is required
+- DO NOT execute figma_execute / figma_create_* without routing
+
+═══════════════════════════════════════════════════════════════════
+CLONE vs BUILD DECISION (v1.8.2+ — CRITICAL)
+═══════════════════════════════════════════════════════════════════
+
+figma_clone_screen_to_device is a NARROW-USE tool. Use it ONLY when:
+  • Same design system
+  • Same layout structure
+  • Only the screen size changes (e.g. iPhone 13 → iPhone 17 migration)
+
+For ALL of these cases, use figma_execute with build-from-scratch pattern
+(generate-figma-screen SKILL Step 4-5 — search_assets → instantiate_component
+→ setBoundVariable → auto-layout FILL):
+
+  "3 alternatif tasarım yap"       → build, NOT clone
+  "Hero Card varyasyonu"           → build, NOT clone
+  "Farklı layout"                  → build, NOT clone
+  "Yeni ekran tasarla"             → build, NOT clone
+  "Bu ekranı daha iyi yap"         → build, NOT clone
+  "Benchmark'tan ilham al"         → build (benchmark = inspiration only)
+  "Redesign" / "iyileştir"         → build, NOT clone
+
+RULE: If the user says ANY of {alternatif, varyasyon, farklı, yeni,
+tasarla, iyileştir, redesign}, DO NOT suggest figma_clone_screen_to_device.
+Default to build-from-scratch via figma_execute + Step 4-5 pattern.
+
+Benchmark is ALWAYS inspiration, never a copy source for alternatives.
+Clone copies the benchmark's existing mistakes (hardcoded rectangles,
+missing token bindings, non-responsive layouts) into the new screen.
+
+═══════════════════════════════════════════════════════════════════
+TOOL FAILURE RECOVERY (v1.8.2+)
+═══════════════════════════════════════════════════════════════════
+
+If a tool call fails (timeout, error, unexpected result):
+
+1. Retry ONCE with different parameters (smaller scope, different device,
+   chunked code, lower minScore, etc.)
+2. If second failure: STOP. Do orphan cleanup. Report to user.
+3. NEVER retry same tool + same params 3+ times (infinite loop).
+4. After any write-tool failure: check for orphan nodes with
+   figma_get_file_data. List them to the user. Delete only with consent.
+
+Multi-output turn budget:
+- Each alternative/output = separate turn
+- Max 90s per turn (hard limit)
+- Max 2 failed tool calls per turn
+- If budget exhausted → Turn FAILED → orphan cleanup → user checkpoint
+
+═══════════════════════════════════════════════════════════════════
+CONTEXT-SAFE PROTOCOL (REQUIRED for Claude chat — v1.8.0+)
+═══════════════════════════════════════════════════════════════════
+
+Tool responses are expensive. Follow this order, prefer the cheapest
+verbosity that answers the question, and reuse cached results.
+
+Step 1 — Plugin discovery
+  figma_get_status()
+  figma_list_connected_files()    (only if multi-file)
+
+Step 2 — Structural overview (cheap, cached 60s)
+  figma_get_file_data(depth=1, verbosity="summary")
+  or figma_get_design_system_summary()
+
+Step 3 — Target ONE node with the lowest verbosity that answers the
+question. All read tools are cached for 60s within a session:
+  • identity only            → depth=0, verbosity="summary"
+  • text + structure         → depth=1, verbosity="summary"  ← new default
+  • layout/visual detail     → depth=1, verbosity="standard"
+  • everything               → depth=2, verbosity="full"
+  Do NOT call verbosity="full" on the document root.
+
+Step 4 — Screenshots only when visual confirmation is needed.
+  v1.8.0 defaults: JPG, scale=1, jpegQuality=70 (~80% smaller than
+  PNG@2x). Use PNG scale=2 only when pixel-perfect asset export is
+  required.
+
+Step 5 — Caching: within a session, repeated identical read calls
+  return instantly from cache. Pass debug=true on a tool to bypass
+  the cache and include _responseGuard/_metrics fields.
+
+═══════════════════════════════════════════════════════════════════
+TOOL SELECTION (F-MCP Bridge vs Official Figma MCP)
+═══════════════════════════════════════════════════════════════════
+
+If figma_get_status() returns ready=true, the F-MCP plugin is
+connected to a specific file. Prefer F-MCP Bridge tools for that
+file — DO NOT call official Figma MCP tools that read the same file.
+
+  Official Figma MCP tool         →   F-MCP Bridge equivalent
+  ─────────────────────────────       ──────────────────────────────
+  search_design_system            →   figma_search_assets
+                                       + figma_get_library_variables
+                                       + figma_get_library_components
+  get_metadata                    →   figma_get_file_data
+  get_design_context              →   figma_get_design_context
+  get_screenshot                  →   figma_capture_screenshot
+  get_variable_defs               →   figma_get_variables
+  use_figma                       →   figma_execute
+
+The official search_design_system often fails with "Resource links
+are not supported" or "file could not be accessed" — fall back to
+figma_search_assets / figma_get_library_components immediately
+(F-MCP plugin reads directly via Plugin API).
 
 WHEN TO PREFER OFFICIAL FIGMA MCP:
-- Code Connect mappings and suggestions
-- Design system search across team libraries (search_design_system)
+- Code Connect mappings (add_code_connect_map, get_code_connect_map)
 - Creating new Figma files (create_new_file)
-- Running Plugin API code through official channel (use_figma)
-- Generating diagrams in FigJam (generate_diagram)
-- When official Figma Cloud API OAuth integration is needed
-
-COEXISTENCE:
-Both servers run simultaneously on different ports with different namespaces.
-F-MCP tools are prefixed "figma_" in the figma-mcp-bridge server.
-Official tools use their own names in separate MCP server namespaces.
-Choose based on the capability needed.`;
+- FigJam diagram generation (generate_diagram)
+- When the F-MCP plugin is NOT connected to the target file
+
+COEXISTENCE: Both servers run simultaneously. Choose by capability.
+
+═══════════════════════════════════════════════════════════════════
+DESIGN SYSTEM CONTEXT (REQUIRED for screen/component creation)
+═══════════════════════════════════════════════════════════════════
+
+When the user asks to create a screen, alternative design, or new
+component, the FIRST step is ALWAYS to confirm which design system
+to use. NEVER create UI without a confirmed DS context.
+
+Step A — Check for an existing DS preference:
+  1. Read .claude/libraries/active-ds.md (or .fmcp-brand-profile.json)
+  2. If present and mentions a DS (e.g. "❖ SUI"), use it directly
+  3. If absent, ask the user: "Hangi tasarım sistemi ile ilerleyelim?
+     (Örn: ❖ SUI, Material Design, Apple HIG, kendi DS'iniz)"
+
+Step B — Once the DS is confirmed:
+  1. Persist the choice to .claude/libraries/active-ds.md so future
+     turns reuse it without asking again
+  2. Load DS variable keys via figma_get_library_variables({libraryName: "..."})
+  3. Load DS component keys via figma_get_library_components({libraryName: "..."})
+  4. Cache results in .claude/libraries/<ds-name>.md for 24h
+
+Step C — Token Binding is MANDATORY:
+  Every node you create must bind its visual properties to DS tokens:
+    • fills/strokes        → setBoundVariableForPaint(...)
+    • padding/gap/radius   → setBoundVariable("paddingLeft", v)
+    • text typography      → setTextStyleIdAsync(styleId)  (never
+                              setBoundVariable("fontSize", ...))
+    • effects (shadows)    → setEffectStyleIdAsync(styleId)
+
+  Hardcoded hex colors, pixel padding, or font sizes are FORBIDDEN
+  in code that creates Figma nodes. If a token does not exist for a
+  needed value, ASK the user how to proceed — do not silently
+  hardcode.
+
+Step D — Component instances over hand-built shapes:
+  When you need a button, input, card, or other UI element that
+  exists in the DS, ALWAYS use figma_instantiate_component with the
+  library componentKey. NEVER hand-build it from rectangles + text
+  unless the DS has no equivalent.
+
+═══════════════════════════════════════════════════════════════════
+COMMON GOTCHAS (Plugin API)
+═══════════════════════════════════════════════════════════════════
+
+1. layoutSizing & layoutPositioning ordering: appendChild MUST be
+   called BEFORE setting layoutSizingHorizontal/Vertical = "FILL"
+   or layoutPositioning = "ABSOLUTE". Setting these on an unparented
+   node fails with "parent node has layoutMode !== NONE".
+
+2. Font weights are not universal: do NOT assume a DS font has
+   "Medium". Call figma.listAvailableFontsAsync() first and use a
+   pickStyle() fallback ("Medium" → "Semi Bold" → "Regular").
+
+3. layoutSizing = "FILL" before appendChild — same gotcha as #1.
+
+4. setCurrentPageAsync, not figma.currentPage = page (sync setter
+   throws in dynamic-page mode).
+
+5. import is a reserved word — never use it as a function/var name
+   in figma_execute code.
+
+For full guidance, load the figma-canvas-ops skill before any
+figma_execute write operation.`;
 //# sourceMappingURL=instructions.js.map

package/dist/core/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/core/instructions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCA8BM,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/core/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+BA8OF,CAAC"}

package/dist/core/plugin-bridge-connector.d.ts

@@ -101,7 +101,33 @@ export declare class PluginBridgeConnector {
     captureScreenshot(nodeId: string | null, options?: {
         format?: string;
         scale?: number;
+        jpegQuality?: number;
     }): Promise<PluginScreenshotPayload>;
+    /**
+     * v1.8.1+: Clone a source screen and adapt it to a target device dimension.
+     * Preserves library instances, bound variables, and auto-layout where possible.
+     */
+    cloneScreenToDevice(params: {
+        sourceNodeId: string;
+        targetWidth: number;
+        targetHeight: number;
+        targetDeviceName: string;
+        newName?: string;
+        targetParentId?: string;
+        position?: {
+            x: number;
+            y: number;
+        };
+    }): Promise<unknown>;
+    /**
+     * v1.8.1+: Validate a screen against design-system discipline criteria.
+     * Returns a DS compliance score + violation list.
+     */
+    validateScreen(params: {
+        nodeId: string;
+        expectedDs?: string;
+        minScore?: number;
+    }): Promise<unknown>;
     setInstanceProperties(nodeId: string, properties: Record<string, unknown>): Promise<PluginCrudResult>;
     getDocumentStructure(depth?: number, verbosity?: string, opts?: {
         excludeScreenshot?: boolean;

package/dist/core/plugin-bridge-connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-bridge-connector.d.ts","sourceRoot":"","sources":["../../src/core/plugin-bridge-connector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin-bridge-connector.d.ts","sourceRoot":"","sources":["../../src/core/plugin-bridge-connector.ts"],"names":[],"mappings":"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"}

package/dist/core/plugin-bridge-connector.js

@@ -161,6 +161,20 @@ export class PluginBridgeConnector {
     async captureScreenshot(nodeId, options) {
         return this.bridge.request("captureScreenshot", { nodeId, options }, this.fileKey);
     }
+    /**
+     * v1.8.1+: Clone a source screen and adapt it to a target device dimension.
+     * Preserves library instances, bound variables, and auto-layout where possible.
+     */
+    async cloneScreenToDevice(params) {
+        return this.bridge.request("cloneScreenToDevice", params, this.fileKey);
+    }
+    /**
+     * v1.8.1+: Validate a screen against design-system discipline criteria.
+     * Returns a DS compliance score + violation list.
+     */
+    async validateScreen(params) {
+        return this.bridge.request("validateScreen", params, this.fileKey);
+    }
     async setInstanceProperties(nodeId, properties) {
         return this.bridge.request("setInstanceProperties", { nodeId, properties }, this.fileKey);
     }
@@ -181,10 +195,12 @@ export class PluginBridgeConnector {
         return this.bridge.request("getDocumentStructure", params, this.fileKey);
     }
     async getNodeContext(nodeId, depth, verbosity, opts) {
+        // v1.8.0: Aligned with MCP tool defaults (depth=1, verbosity=summary)
+        // for context safety. Pre-v1.8.0 was depth=2, verbosity=standard.
         const params = {
             nodeId,
-            depth: depth ?? 2,
-            verbosity: verbosity ?? "standard",
+            depth: depth ?? 1,
+            verbosity: verbosity ?? "summary",
         };
         if (opts?.excludeScreenshot !== undefined)
             params.excludeScreenshot = opts.excludeScreenshot;