@atezer/figma-mcp-bridge 1.7.29 → 1.9.0

package/f-mcp-plugin/ui.html

@@ -422,6 +422,9 @@
     window.__figmaPendingRequests = new Map();
     window.__figmaFileKey = null;
     window.__figmaFileName = null;
+    // v1.8.0+: Plugin version reported in WebSocket "ready" handshake.
+    // Keep in sync with package.json, src/core/version.ts, f-mcp-plugin/code.js.
+    var FMCP_PLUGIN_VERSION = '1.8.2';
 
     let requestIdCounter = 0;
 
@@ -699,6 +702,32 @@
         .catch(function(err) { return { success: false, error: err.message || String(err) }; });
     };
 
+    // v1.8.1+: High-level clone-to-device (preserves instances + bindings)
+    // v1.8.2: Timeout 30s → 120s (complex benchmarks with 200+ children are slow)
+    window.cloneScreenToDevice = (params) => {
+      return window.sendPluginCommand('CLONE_SCREEN_TO_DEVICE', {
+        sourceNodeId: params.sourceNodeId,
+        targetWidth: params.targetWidth,
+        targetHeight: params.targetHeight,
+        targetDeviceName: params.targetDeviceName,
+        newName: params.newName || null,
+        targetParentId: params.targetParentId || null,
+        position: params.position || null,
+      }, 120000)
+        .catch(function(err) { return { success: false, error: err.message || String(err) }; });
+    };
+
+    // v1.8.1+: Validate screen DS compliance (read-only audit)
+    // v1.8.2: Timeout 30s → 90s (tree walker with Promise.all on getMainComponentAsync is slow for 100+ nodes)
+    window.validateScreen = (params) => {
+      return window.sendPluginCommand('VALIDATE_SCREEN', {
+        nodeId: params.nodeId,
+        expectedDs: params.expectedDs || null,
+        minScore: typeof params.minScore === 'number' ? params.minScore : 80,
+      }, 90000)
+        .catch(function(err) { return { success: false, error: err.message || String(err) }; });
+    };
+
     // Delete a node
     window.deleteNode = (nodeId) => {
       return window.sendPluginCommand('DELETE_NODE', { nodeId: nodeId })
@@ -741,8 +770,9 @@
     window.captureScreenshot = (nodeId, options) => {
       var params = { nodeId: nodeId };
       if (options) {
-        if (options.format) params.format = options.format;  // PNG, JPG, SVG
-        if (options.scale) params.scale = options.scale;      // 1, 2, 4, etc.
+        if (options.format) params.format = options.format;            // PNG, JPG
+        if (options.scale != null) params.scale = options.scale;       // 1, 2, 4, etc.
+        if (options.jpegQuality != null) params.jpegQuality = options.jpegQuality;  // 30-100 (v1.8.0)
       }
       return window.sendPluginCommand('CAPTURE_SCREENSHOT', params, 30000)
         .catch(function(err) { return { success: false, error: err.message || String(err) }; });
@@ -1409,7 +1439,8 @@
           currentWs.send(JSON.stringify({
             type: 'ready',
             fileKey: window.__figmaFileKey || null,
-            fileName: window.__figmaFileName || null
+            fileName: window.__figmaFileName || null,
+            pluginVersion: (typeof FMCP_PLUGIN_VERSION !== 'undefined' ? FMCP_PLUGIN_VERSION : '1.8.0')
           }));
           startKeepAlive(currentWs);
           if (mcpHandshakeTimer) clearTimeout(mcpHandshakeTimer);
@@ -1456,10 +1487,26 @@
                 status: 'ready'
               });
               mcpActivePort = mcpConnectedPort;
-              // Adım 4: Ana bağlantı hazır — diğer portları da tara (ilk + periyodik)
+              // Adım 4: Ana bağlantı hazır — diğer portları da tara (ilk + sınırlı periyodik)
+              // v1.9.6: Flood azaltma — interval 10s → 60s, maksimum 5 tarama sonrası dur.
+              // Gerekçe: Önceki davranış her 10s'de 15 başarısız WebSocket denemesi yapıyordu
+              // (dakikada ~90 console error). 137 dk'lık oturumda 12000+ teorik error birikimi.
+              // Yeni davranış: ilk 500ms + sonraki 5 dk'da dakikada 1 scan → toplam 6 scan,
+              // sonra otomatik dur. Yeni client sonradan bağlanırsa onConnect event'i ile yeniden
+              // tetiklenir (connectToExtraPort başarılı olursa mcpConnections güncellenir).
               setTimeout(function() { if (typeof scanOtherPorts === 'function') scanOtherPorts(); }, 500);
               if (!extraPortScanTimer) {
-                extraPortScanTimer = setInterval(function() { if (typeof scanOtherPorts === 'function') scanOtherPorts(); }, 10000);
+                var scanCount = 0;
+                var MAX_SCANS = 5;  // 5 × 60s = 5 dk boyunca periyodik tarama, sonra dur
+                extraPortScanTimer = setInterval(function() {
+                  scanCount++;
+                  if (scanCount > MAX_SCANS) {
+                    clearInterval(extraPortScanTimer);
+                    extraPortScanTimer = null;
+                    return;
+                  }
+                  if (typeof scanOtherPorts === 'function') scanOtherPorts();
+                }, 60000);  // v1.9.6: 10000 → 60000 (dakikada 1 scan)
               }
               return;
             }
@@ -1573,6 +1620,12 @@
               if (method === 'setNodeCornerRadius') {
                 return window.setNodeCornerRadius(params.nodeId, params.radius);
               }
+              if (method === 'cloneScreenToDevice') {
+                return window.cloneScreenToDevice(params);
+              }
+              if (method === 'validateScreen') {
+                return window.validateScreen(params);
+              }
               if (method === 'cloneNode') {
                 return window.cloneNode(params.nodeId);
               }
@@ -1709,7 +1762,8 @@
           ws.send(JSON.stringify({
             type: 'ready',
             fileKey: window.__figmaFileKey || null,
-            fileName: window.__figmaFileName || null
+            fileName: window.__figmaFileName || null,
+            pluginVersion: (typeof FMCP_PLUGIN_VERSION !== 'undefined' ? FMCP_PLUGIN_VERSION : '1.8.0')
           }));
           handshakeTimer = setTimeout(function() {
             if (!handshakeOk) { try { ws.close(); } catch(e) {} }
@@ -1799,6 +1853,8 @@
               if (method === 'setNodeStrokes') return window.setNodeStrokes(params.nodeId, params.strokes, params.strokeWeight);
               if (method === 'setNodeOpacity') return window.setNodeOpacity(params.nodeId, params.opacity);
               if (method === 'setNodeCornerRadius') return window.setNodeCornerRadius(params.nodeId, params.radius);
+              if (method === 'cloneScreenToDevice') return window.cloneScreenToDevice(params);
+              if (method === 'validateScreen') return window.validateScreen(params);
               if (method === 'cloneNode') return window.cloneNode(params.nodeId);
               if (method === 'deleteNode') return window.deleteNode(params.nodeId);
               if (method === 'renameNode') return window.renameNode(params.nodeId, params.newName);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atezer/figma-mcp-bridge",
-	"version": "1.7.29",
+	"version": "1.9.0",
 	"description": "F-MCP ATezer: MCP server and Figma plugin bridge for Claude/Cursor. No REST token required.",
 	"type": "module",
 	"main": "dist/local-plugin-only.js",

package/skills/SKILL_INDEX.md

@@ -19,7 +19,7 @@ Tüm skill'ler `.fmcp-brand-profile.json` dosyasını okuyarak marka ses/ton, ti
 
 **Oluşturma:** `ux-copy-guidance` skill'i profil yoksa otomatik 3-soru akışı başlatır. Manuel olarak da proje köküne `.fmcp-brand-profile.json` dosyası eklenebilir.
 
-## Skill Listesi (20 skill)
+## Skill Listesi (25 skill)
 
 ### Temel Kurallar
 
@@ -42,6 +42,18 @@ Tüm skill'ler `.fmcp-brand-profile.json` dosyasını okuyarak marka ses/ton, ti
 | `generate-figma-screen` | [generate-figma-screen/SKILL.md](generate-figma-screen/SKILL.md) | designer, uidev | Kod/açıklamadan Figma'da ekran oluşturma |
 | `generate-figma-library` | [generate-figma-library/SKILL.md](generate-figma-library/SKILL.md) | designops, designer | Koddan DS kütüphanesi inşa (5 fazlı) |
 | `figjam-diagram-builder` | [figjam-diagram-builder/SKILL.md](figjam-diagram-builder/SKILL.md) | designer, designops, po | FigJam diyagram/süreç şeması |
+| `inspiration-intake` | [inspiration-intake/SKILL.md](inspiration-intake/SKILL.md) | designer, uidev | Image / Figma benchmark / URL'den structural_intent çıkarma ("inspiration only" disiplinle, değer çıkarmaz — ön-işleme katmanı) |
+
+### Cross-Platform Orkestratörler
+
+Agent orkestrasyon mantığını tek kaynaktan 4 platforma taşıyan skill'ler (Claude Code / Cursor / Claude Desktop / Claude Web). Condensed-first: her orchestrator Essentials bölümü %80 case'i kapsar, Advanced sadece edge case'lerde okunur. Kurulum rehberleri: [install/](../install/)
+
+| Skill | Dosya | Personalar | Kısa açıklama |
+|---|---|---|---|
+| `fmcp-screen-orchestrator` | [fmcp-screen-orchestrator/SKILL.md](fmcp-screen-orchestrator/SKILL.md) | designer, uidev | DS-compliant Figma ekran üretimi orkestratörü — 4 intake modu (text/benchmark/image/no_idea), DS fallback chain, step-by-step mode, self-audit gate |
+| `fmcp-ds-audit-orchestrator` | [fmcp-ds-audit-orchestrator/SKILL.md](fmcp-ds-audit-orchestrator/SKILL.md) | designops, uidev | 5 audit tipi orkestrasyonu (compliance / a11y / drift / visual_qa / impact), read-only discipline, cache-first audit |
+| `fmcp-token-sync-orchestrator` | [fmcp-token-sync-orchestrator/SKILL.md](fmcp-token-sync-orchestrator/SKILL.md) | designops, uidev | Token sync orkestratörü (CSS / Tailwind / Swift / Compose / Sass), diff preview zorunluluğu, binding coverage raporu |
+| `fmcp-screen-recipes` | [fmcp-screen-recipes/SKILL.md](fmcp-screen-recipes/SKILL.md) | designer, uidev | Fast Path cookbook — 9 standart ekran tipi (login/payment/profile/list/detail/form/onboarding/dashboard/settings) için linear 9-adımlı recipe. Figma native device presets, SUI native variable modes, chunking built-in (Rule 5a), her adımda Türkçe micro-report. Common case'de %40-50 daha hızlı, generate-figma-screen'i atlar. |
 
 ### DS Denetim ve Düzeltme
 

package/skills/apply-figma-design-system/SKILL.md

@@ -6,6 +6,43 @@ metadata:
   personas:
     - designer
     - designops
+required_inputs:
+  - name: target_scope
+    type: enum
+    options:
+      - "Seçili frame (node ID ver)"
+      - "Mevcut sayfa (tüm frameler)"
+      - "Tüm dosya (tüm sayfalar)"
+    question: "Hangi kapsamı DS'ye hizalayalım?"
+    required: true
+  - name: target_node_id
+    type: string
+    question: "Hedef node ID nedir? (target_scope 'Seçili frame' ise zorunlu)"
+    required: false
+    skip_if: "target_scope != 'Seçili frame (node ID ver)'"
+  - name: design_system
+    type: from_state
+    source: ".claude/design-systems/active-ds.md#Library Name"
+    fallback_question: "Hangi tasarım sistemine hizalayalım? (❖ SUI / Material / Custom)"
+    required: true
+  - name: backup_before_apply
+    type: boolean
+    question: "Yazmadan önce mevcut ekranın yedeğini (duplicate) alayım mı?"
+    required: false
+    default: true
+  - name: preserve_content
+    type: boolean
+    question: "İçeriği (metin, değerler) koruyayım mı yoksa DS default'larıyla mı değiştirelim?"
+    required: false
+    default: true
+  - name: swap_strategy
+    type: enum
+    options:
+      - "Bölüm bölüm (güvenli, yavaş)"
+      - "Tümünü tek seferde (hızlı, risk)"
+    question: "Hangi swap stratejisi?"
+    required: false
+    default: "Bölüm bölüm (güvenli, yavaş)"
 ---
 
 # Apply Figma Design System (geniş yazma)

package/skills/audit-figma-design-system/SKILL.md

@@ -7,6 +7,44 @@ metadata:
     - designer
     - designops
     - po
+required_inputs:
+  - name: target_scope
+    type: enum
+    options:
+      - "Seçili frame (node ID ver)"
+      - "Mevcut sayfa"
+      - "Tüm dosya"
+      - "Son oluşturulan ekran (last-intent.md'den)"
+    question: "Ne denetleyelim?"
+    required: true
+  - name: target_node_id
+    type: string
+    question: "Hedef node ID? (target_scope 'Seçili frame' ise zorunlu)"
+    required: false
+    skip_if: "target_scope != 'Seçili frame (node ID ver)'"
+  - name: design_system
+    type: from_state
+    source: ".claude/design-systems/active-ds.md#Library Name"
+    fallback_question: "Hangi DS'ye göre denet? (❖ SUI / Material / Custom)"
+    required: true
+  - name: severity_threshold
+    type: enum
+    options:
+      - "low (tüm bulgular)"
+      - "medium (önemli olanlar)"
+      - "high (sadece kritik)"
+    question: "En düşük severity seviyesi nedir?"
+    required: false
+    default: "medium (önemli olanlar)"
+  - name: report_format
+    type: enum
+    options:
+      - "Markdown rapor"
+      - "JSON çıktı"
+      - "Chat inline özet"
+    question: "Raporu nasıl istersin?"
+    required: false
+    default: "Markdown rapor"
 ---
 
 # Audit Figma Design System (tuval içi)

package/skills/code-design-mapper/SKILL.md

@@ -6,6 +6,43 @@ metadata:
   personas:
     - uidev
     - designops
+required_inputs:
+  - name: direction
+    type: enum
+    options:
+      - "Figma → Kod (tek component kodla)"
+      - "Kod → Figma (mevcut koddan Figma component üret)"
+      - "Bi-directional mapping (mapping tablosu)"
+    question: "Hangi yönde eşleştirme?"
+    required: true
+  - name: figma_component_id
+    type: string
+    question: "Hangi Figma component? (node ID veya component key)"
+    required: false
+    skip_if: "direction == 'Kod → Figma (mevcut koddan Figma component üret)'"
+  - name: code_component_path
+    type: string
+    question: "Kod tarafındaki component path nedir? (örn: ./src/components/Button.tsx)"
+    required: false
+  - name: platform
+    type: enum
+    options:
+      - "iOS (SwiftUI)"
+      - "Android (Compose)"
+      - "Web (React)"
+      - "Web (Vue)"
+      - "Multi-platform (hepsi)"
+    question: "Hangi platform?"
+    required: true
+  - name: mapping_output
+    type: enum
+    options:
+      - "JSON mapping file"
+      - "Markdown tablo"
+      - "Code Connect format"
+    question: "Mapping çıktısı nasıl istersen?"
+    required: false
+    default: "Markdown tablo"
 ---
 
 # Code-Design Mapper (Multi-Platform)

package/skills/design-token-pipeline/SKILL.md

@@ -6,6 +6,50 @@ metadata:
   personas:
     - uidev
     - designops
+required_inputs:
+  - name: direction
+    type: enum
+    options:
+      - "Figma → Kod (variable'ları export et)"
+      - "Kod → Figma (kod token'larını Figma'ya yaz)"
+      - "Bi-directional sync (iki yönlü)"
+    question: "Hangi yönde token pipeline?"
+    required: true
+  - name: target_format
+    type: enum
+    options:
+      - "iOS Swift (Color/Font/Spacing)"
+      - "Android colors.xml + dimens.xml"
+      - "Android Compose Theme.kt"
+      - "Web CSS variables"
+      - "Web Tailwind config"
+      - "Web Sass/SCSS"
+      - "Web TypeScript/JSON"
+      - "Multi-format (tümü)"
+    question: "Hangi format(lar)?"
+    required: true
+    skip_if: "direction == 'Kod → Figma (kod token''larını Figma''ya yaz)'"
+  - name: source_path
+    type: string
+    question: "Kaynak path nedir? (Kod kaynağı için, örn: ./src/tokens veya ./design-tokens.json)"
+    required: false
+    skip_if: "direction == 'Figma → Kod (variable''ları export et)'"
+  - name: output_path
+    type: string
+    question: "Çıktı path nedir? (örn: ./src/design-tokens)"
+    required: false
+    default: "./design-tokens"
+    skip_if: "direction == 'Kod → Figma (kod token''larını Figma''ya yaz)'"
+  - name: token_types
+    type: string_list
+    question: "Hangi token türleri? (colors, typography, spacing, radius, shadow, z-index — 'all' veya seçili)"
+    required: false
+    default: "all"
+  - name: include_themes
+    type: boolean
+    question: "Theme modları (light/dark) dahil edilsin mi?"
+    required: false
+    default: true
 ---
 
 # Design Token Pipeline (Multi-Platform)