@atezer/figma-mcp-bridge 1.7.30 → 1.9.1

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,13 +1487,50 @@
                 status: 'ready'
               });
               mcpActivePort = mcpConnectedPort;
-              // Adım 4: Ana bağlantı hazır — diğer portları da tara (ilk + periyodik)
-              setTimeout(function() { if (typeof scanOtherPorts === 'function') scanOtherPorts(); }, 500);
-              if (!extraPortScanTimer) {
-                extraPortScanTimer = setInterval(function() { if (typeof scanOtherPorts === 'function') scanOtherPorts(); }, 10000);
+              // v1.9.1+: Server'dan gelen aktif bridge listesi varsa, SADECE listed'a bagla
+              // (blind scan elenir → DevTools console'da 0 error). Aksi halde fallback scan.
+              if (msg.activeBridges && Array.isArray(msg.activeBridges)) {
+                var _host = getMcpBridgeHost();
+                for (var _i = 0; _i < msg.activeBridges.length; _i++) {
+                  var _p = msg.activeBridges[_i];
+                  if (typeof _p === 'number' && _p !== mcpConnectedPort && !mcpConnections.has(_p)) {
+                    connectToExtraPort(_p, _host);
+                  }
+                }
+                // scanOtherPorts ve periyodik timer CAGRILMAZ — server bize dogru listeyi verdi.
+                // Yeni sibling baglanirsa server 'activeBridgesUpdate' push mesajiyla bildirir (30s icinde).
+              } else {
+                // FALLBACK (v1.9.0 server veya uyumsuz): eski scan davranisi korunur.
+                // v1.9.6: Flood azaltma — interval 60s, maksimum 5 tarama sonrası dur.
+                setTimeout(function() { if (typeof scanOtherPorts === 'function') scanOtherPorts(); }, 500);
+                if (!extraPortScanTimer) {
+                  var scanCount = 0;
+                  var MAX_SCANS = 5;
+                  extraPortScanTimer = setInterval(function() {
+                    scanCount++;
+                    if (scanCount > MAX_SCANS) {
+                      clearInterval(extraPortScanTimer);
+                      extraPortScanTimer = null;
+                      return;
+                    }
+                    if (typeof scanOtherPorts === 'function') scanOtherPorts();
+                  }, 60000);
+                }
               }
               return;
             }
+            // v1.9.1+: Server push update — yeni sibling kesfedilince gelir.
+            if (msg.type === 'activeBridgesUpdate' && Array.isArray(msg.activeBridges)) {
+              var _upHost = getMcpBridgeHost();
+              for (var _ui = 0; _ui < msg.activeBridges.length; _ui++) {
+                var _up = msg.activeBridges[_ui];
+                if (typeof _up === 'number' && _up !== mcpConnectedPort && !mcpConnections.has(_up)) {
+                  connectToExtraPort(_up, _upHost);
+                }
+              }
+              // Kapanmis port'larin baglantisi onclose ile otomatik mcpConnections'dan silinir.
+              return;
+            }
             if (msg.type === 'tokenStatus') {
               updateTokenUI(msg.hasToken, msg.rateLimit || null, __tokenExpiresAt);
               return;
@@ -1573,6 +1641,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 +1783,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 +1874,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);
@@ -1895,12 +1972,11 @@
       }
       var nextIdx = (currentIdx + direction + ports.length) % ports.length;
       mcpActivePort = ports[nextIdx].port;
-      // Geriye uyumluluk: mcpBridgeWs aktif bağlantıya çevir
-      var activeConn = mcpConnections.get(mcpActivePort);
-      if (activeConn && activeConn.ws) {
-        mcpBridgeWs = activeConn.ws;
-        mcpConnectedPort = mcpActivePort;
-      }
+      // v1.9.1+ FIX: mcpBridgeWs ve mcpConnectedPort DEGISTIRILMEZ.
+      // Her connection kendi closure ws'inde zaten paralel calisir (main: line 1682 wsRef=mcpBridgeWs,
+      // extra: line 1866 wsRef=ws). Onceki kod mcpBridgeWs'i degistirerek main handler'in response
+      // routing'ini bozuyordu (switch sonrasi main'den gelen istekler yanlis porta cevap veriyordu).
+      // Simdi switch sadece UI "aktif port" gostergesi (port label + buton vurgulamasi) icin kullanilir.
       updatePortLabel();
       updateStatus('Ready', true, false);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atezer/figma-mcp-bridge",
-	"version": "1.7.30",
+	"version": "1.9.1",
 	"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)