@atezer/figma-mcp-bridge 1.9.5 → 1.9.7

package/f-mcp-plugin/code.js

@@ -6,7 +6,95 @@
 
 // v1.8.0+: Plugin version reported in WebSocket "ready" handshake.
 // Keep in sync with package.json and src/core/version.ts.
-var FMCP_PLUGIN_VERSION = '1.9.5';
+var FMCP_PLUGIN_VERSION = '1.9.7';
+
+/**
+ * v1.9.6: Post-execute scan — figma_execute sonrasında oluşturulan node'ları
+ * otomatik tarayıp unbound fill/padding/radius/text-style tespit eder.
+ * Skill direktifi "return { createdNodeIds: [...] }" diyor — plugin bunu okuyup
+ * subtree'yi tarar. Violations varsa response'a _postExecuteScan field'ı eklenir,
+ * server bunu _DESIGN_SYSTEM_VIOLATIONS_BLOCKING'e dönüştürür.
+ */
+async function postExecuteScan(result) {
+  var nodeIds = [];
+  if (result && typeof result === 'object') {
+    if (Array.isArray(result.createdNodeIds)) nodeIds = result.createdNodeIds;
+    else if (Array.isArray(result.nodeIds)) nodeIds = result.nodeIds;
+    else if (Array.isArray(result.ids)) nodeIds = result.ids;
+    else if (typeof result.frameId === 'string') nodeIds = [result.frameId];
+    else if (typeof result.rootId === 'string') nodeIds = [result.rootId];
+    else if (typeof result.nodeId === 'string') nodeIds = [result.nodeId];
+  }
+  if (nodeIds.length === 0) return null;
+
+  var violations = [];
+  var maxViolations = 10;
+  var maxNodes = 500; // safety cap per subtree
+  var totalChecked = 0;
+
+  for (var i = 0; i < nodeIds.length && violations.length < maxViolations; i++) {
+    var root;
+    try { root = await figma.getNodeByIdAsync(nodeIds[i]); } catch (e) { continue; }
+    if (!root) continue;
+    var stack = [root];
+    var visited = 0;
+    while (stack.length > 0 && visited < maxNodes) {
+      var n = stack.pop(); visited++; totalChecked++;
+      if (!n) continue;
+
+      // Fill check (skip instances — their bindings come from main component)
+      if (Array.isArray(n.fills) && n.type !== 'INSTANCE') {
+        for (var fi = 0; fi < n.fills.length; fi++) {
+          var fl = n.fills[fi];
+          if (fl && fl.visible !== false && fl.type === 'SOLID') {
+            var fbv = n.boundVariables && n.boundVariables.fills;
+            if (!(fbv && (Array.isArray(fbv) ? fbv[fi] : true)) && violations.length < maxViolations) {
+              violations.push({ nodeId: n.id, nodeName: n.name, category: 'UNBOUND_FILL', hint: 'setBoundVariableForPaint cagrisi eksik' });
+            }
+          }
+        }
+      }
+
+      if ((n.type === 'FRAME' || n.type === 'COMPONENT') && n.boundVariables !== undefined) {
+        var padProps = ['paddingTop', 'paddingBottom', 'paddingLeft', 'paddingRight'];
+        for (var j = 0; j < padProps.length && violations.length < maxViolations; j++) {
+          if (typeof n[padProps[j]] === 'number' && n[padProps[j]] > 0 && !(n.boundVariables && n.boundVariables[padProps[j]])) {
+            violations.push({ nodeId: n.id, nodeName: n.name, category: 'UNBOUND_PADDING', prop: padProps[j], value: n[padProps[j]] });
+          }
+        }
+        var radProps = ['cornerRadius', 'topLeftRadius', 'topRightRadius', 'bottomLeftRadius', 'bottomRightRadius'];
+        for (var k = 0; k < radProps.length && violations.length < maxViolations; k++) {
+          if (typeof n[radProps[k]] === 'number' && n[radProps[k]] > 0 && !(n.boundVariables && n.boundVariables[radProps[k]])) {
+            violations.push({ nodeId: n.id, nodeName: n.name, category: 'UNBOUND_RADIUS', prop: radProps[k], value: n[radProps[k]] });
+          }
+        }
+        if (typeof n.itemSpacing === 'number' && n.itemSpacing > 0 && !(n.boundVariables && n.boundVariables.itemSpacing) && violations.length < maxViolations) {
+          violations.push({ nodeId: n.id, nodeName: n.name, category: 'UNBOUND_ITEMSPACING', value: n.itemSpacing });
+        }
+      }
+
+      if (n.type === 'TEXT' && !(n.textStyleId && typeof n.textStyleId === 'string' && n.textStyleId !== '') && violations.length < maxViolations) {
+        violations.push({ nodeId: n.id, nodeName: n.name, category: 'UNBOUND_TEXTSTYLE', sample: String(n.characters || '').slice(0, 30) });
+      }
+
+      if (n.children) {
+        for (var ci = 0; ci < n.children.length; ci++) stack.push(n.children[ci]);
+      }
+    }
+  }
+
+  return {
+    scanned: true,
+    rootsScanned: nodeIds.length,
+    totalChecked: totalChecked,
+    violationCount: violations.length,
+    violations: violations,
+    passed: violations.length === 0,
+    hint: violations.length > 0
+      ? '❌ v1.9.6 post-execute scan: ' + violations.length + ' unbound node tespit edildi. Kodu duzelt — her node icin setBoundVariable/setTextStyleIdAsync cagrisi eksik.'
+      : '✅ v1.9.6 post-execute scan: Tum node\'lar bound.',
+  };
+}
 
 // v1.9.5: Metadata summary builder for returnMode='summary' (screenshotsuz)
 async function buildNodeSummary(node, maxDepth) {
@@ -642,6 +730,17 @@ figma.ui.onmessage = async (msg) => {
         safeResult = { __serializationError: true, message: 'Result could not be serialized: ' + (serErr.message || String(serErr)), resultType: typeof result };
       }
 
+      // v1.9.6: Post-execute scan — oluşturulan node'larda unbound tespit
+      var postScan = null;
+      try {
+        postScan = await postExecuteScan(result);
+        if (postScan && postScan.violationCount > 0) {
+          console.warn('🌉 [F-MCP v1.9.6] Post-execute scan: ' + postScan.violationCount + ' unbound node detected');
+        }
+      } catch (psErr) {
+        console.warn('🌉 [F-MCP v1.9.6] Post-execute scan failed:', psErr && psErr.message ? psErr.message : String(psErr));
+      }
+
       figma.ui.postMessage({
         type: 'EXECUTE_CODE_RESULT',
         requestId: msg.requestId,
@@ -652,7 +751,8 @@ figma.ui.onmessage = async (msg) => {
         fileContext: {
           fileName: figma.root.name,
           fileKey: figma.fileKey || null
-        }
+        },
+        _postExecuteScan: postScan // v1.9.6: BLOCKING signal source for server
       });
 
     } catch (error) {
@@ -2839,6 +2939,211 @@ figma.ui.onmessage = async (msg) => {
     }
   }
 
+  // ============================================================================
+  // CREATE_MINI_DS (v1.9.7) — Boş dosyada minimal Design System kur.
+  // 2-phase batched: Phase 1 = Variable Collections + Variables + Text Styles
+  //                  Phase 2 = Components (Button/Input/Card)
+  // Her phase ayrı promise chain, timeout 30s içinde tamamlanır.
+  // ============================================================================
+  else if (msg.type === 'CREATE_MINI_DS') {
+    try {
+      console.log('🌉 [F-MCP v1.9.7] CREATE_MINI_DS starting...');
+
+      var primaryColor = msg.primaryColor || '#1464FF';
+      var fontFamily = msg.fontFamily || 'Inter';
+      var dsName = msg.name || 'Mini DS';
+      var includeComponents = msg.includeComponents !== false;
+
+      // ---------- Hex → RGB ----------
+      function hexToRgb(hex) {
+        var h = hex.replace('#', '');
+        if (h.length === 3) h = h[0]+h[0]+h[1]+h[1]+h[2]+h[2];
+        var r = parseInt(h.slice(0,2), 16) / 255;
+        var g = parseInt(h.slice(2,4), 16) / 255;
+        var b = parseInt(h.slice(4,6), 16) / 255;
+        return { r: r, g: g, b: b };
+      }
+      function mix(a, b, t) { return { r: a.r*(1-t)+b.r*t, g: a.g*(1-t)+b.g*t, b: a.b*(1-t)+b.b*t }; }
+
+      var primaryRgb = hexToRgb(primaryColor);
+      var black = { r: 0, g: 0, b: 0 };
+      var white = { r: 1, g: 1, b: 1 };
+
+      // ---------- PHASE 1: Variable Collections + Variables + Text Styles ----------
+      var colorCollection = figma.variables.createVariableCollection(dsName + ' — Colors');
+      var modeId = colorCollection.defaultModeId;
+      var colorVars = {};
+
+      function addColorVar(name, rgb) {
+        var v = figma.variables.createVariable(name, colorCollection, 'COLOR');
+        v.setValueForMode(modeId, rgb);
+        colorVars[name] = v;
+      }
+
+      addColorVar('primary/default', primaryRgb);
+      addColorVar('primary/hover', mix(primaryRgb, black, 0.1));
+      addColorVar('primary/disabled', mix(primaryRgb, white, 0.5));
+      addColorVar('bg/level-0', white);
+      addColorVar('bg/level-1', { r: 0.97, g: 0.97, b: 0.98 });
+      addColorVar('bg/level-2', { r: 0.93, g: 0.94, b: 0.96 });
+      addColorVar('text/primary', { r: 0.1, g: 0.1, b: 0.1 });
+      addColorVar('text/secondary', { r: 0.4, g: 0.4, b: 0.45 });
+      addColorVar('text/on-primary', white);
+      addColorVar('success/default', { r: 0.18, g: 0.73, b: 0.39 });
+      addColorVar('error/default', { r: 0.91, g: 0.22, b: 0.27 });
+      addColorVar('warning/default', { r: 0.98, g: 0.69, b: 0.13 });
+
+      var sizingCollection = figma.variables.createVariableCollection(dsName + ' — Sizing');
+      var sizingMode = sizingCollection.defaultModeId;
+      var sizingVars = {};
+      function addSizingVar(name, value) {
+        var v = figma.variables.createVariable(name, sizingCollection, 'FLOAT');
+        v.setValueForMode(sizingMode, value);
+        sizingVars[name] = v;
+      }
+      addSizingVar('spacing/xs', 4);
+      addSizingVar('spacing/sm', 8);
+      addSizingVar('spacing/md', 16);
+      addSizingVar('spacing/lg', 24);
+      addSizingVar('spacing/xl', 32);
+      addSizingVar('radius/sm', 4);
+      addSizingVar('radius/md', 8);
+      addSizingVar('radius/lg', 16);
+
+      // Text Styles (font loading required)
+      await figma.loadFontAsync({ family: fontFamily, style: 'Semi Bold' }).catch(function() {});
+      await figma.loadFontAsync({ family: fontFamily, style: 'Regular' }).catch(function() {});
+
+      function createTextStyle(name, fontSize, lineHeight, fontStyle) {
+        var ts = figma.createTextStyle();
+        ts.name = name;
+        try {
+          ts.fontName = { family: fontFamily, style: fontStyle };
+          ts.fontSize = fontSize;
+          ts.lineHeight = { unit: 'PIXELS', value: lineHeight };
+        } catch (e) {
+          console.warn('TextStyle ' + name + ' font set failed:', e.message);
+        }
+        return ts;
+      }
+
+      var titleStyle = createTextStyle(dsName + '/Title/Large', 24, 32, 'Semi Bold');
+      var bodyStyle = createTextStyle(dsName + '/Body/Default', 14, 20, 'Regular');
+      var captionStyle = createTextStyle(dsName + '/Caption/Small', 12, 16, 'Regular');
+
+      console.log('🌉 [F-MCP v1.9.7] Phase 1 done — variables + text styles created');
+
+      // ---------- PHASE 2: Components ----------
+      var componentIds = {};
+      if (includeComponents) {
+        // Button component
+        var buttonFrame = figma.createFrame();
+        buttonFrame.name = dsName + '/Button/Primary';
+        buttonFrame.layoutMode = 'HORIZONTAL';
+        buttonFrame.primaryAxisSizingMode = 'AUTO';
+        buttonFrame.counterAxisSizingMode = 'AUTO';
+        buttonFrame.primaryAxisAlignItems = 'CENTER';
+        buttonFrame.counterAxisAlignItems = 'CENTER';
+        buttonFrame.setBoundVariable('paddingLeft', sizingVars['spacing/md']);
+        buttonFrame.setBoundVariable('paddingRight', sizingVars['spacing/md']);
+        buttonFrame.setBoundVariable('paddingTop', sizingVars['spacing/sm']);
+        buttonFrame.setBoundVariable('paddingBottom', sizingVars['spacing/sm']);
+        buttonFrame.setBoundVariable('cornerRadius', sizingVars['radius/md']);
+        buttonFrame.fills = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: primaryRgb }, 'color', colorVars['primary/default'])];
+
+        var buttonText = figma.createText();
+        try {
+          buttonText.fontName = { family: fontFamily, style: 'Semi Bold' };
+          buttonText.characters = 'Button';
+          await buttonText.setTextStyleIdAsync(bodyStyle.id).catch(function() {});
+          buttonText.fills = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 1, g: 1, b: 1 } }, 'color', colorVars['text/on-primary'])];
+        } catch (e) { console.warn('Button text fail:', e.message); }
+        buttonFrame.appendChild(buttonText);
+        var buttonComp = figma.createComponentFromNode(buttonFrame);
+        componentIds.button = buttonComp.id;
+
+        // Input component
+        var inputFrame = figma.createFrame();
+        inputFrame.name = dsName + '/Input/Default';
+        inputFrame.resize(240, 40);
+        inputFrame.layoutMode = 'HORIZONTAL';
+        inputFrame.primaryAxisAlignItems = 'CENTER';
+        inputFrame.setBoundVariable('paddingLeft', sizingVars['spacing/md']);
+        inputFrame.setBoundVariable('paddingRight', sizingVars['spacing/md']);
+        inputFrame.setBoundVariable('cornerRadius', sizingVars['radius/md']);
+        inputFrame.fills = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 0.97, g: 0.97, b: 0.98 } }, 'color', colorVars['bg/level-1'])];
+        inputFrame.strokes = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 0.9, g: 0.9, b: 0.92 } }, 'color', colorVars['bg/level-2'])];
+        inputFrame.strokeWeight = 1;
+
+        var placeholder = figma.createText();
+        try {
+          placeholder.fontName = { family: fontFamily, style: 'Regular' };
+          placeholder.characters = 'Placeholder';
+          await placeholder.setTextStyleIdAsync(bodyStyle.id).catch(function() {});
+          placeholder.fills = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 0.4, g: 0.4, b: 0.45 } }, 'color', colorVars['text/secondary'])];
+        } catch (e) {}
+        inputFrame.appendChild(placeholder);
+        var inputComp = figma.createComponentFromNode(inputFrame);
+        componentIds.input = inputComp.id;
+
+        // Card component
+        var cardFrame = figma.createFrame();
+        cardFrame.name = dsName + '/Card/Default';
+        cardFrame.layoutMode = 'VERTICAL';
+        cardFrame.primaryAxisSizingMode = 'AUTO';
+        cardFrame.counterAxisSizingMode = 'AUTO';
+        cardFrame.setBoundVariable('paddingLeft', sizingVars['spacing/lg']);
+        cardFrame.setBoundVariable('paddingRight', sizingVars['spacing/lg']);
+        cardFrame.setBoundVariable('paddingTop', sizingVars['spacing/lg']);
+        cardFrame.setBoundVariable('paddingBottom', sizingVars['spacing/lg']);
+        cardFrame.setBoundVariable('itemSpacing', sizingVars['spacing/sm']);
+        cardFrame.setBoundVariable('cornerRadius', sizingVars['radius/lg']);
+        cardFrame.fills = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 1, g: 1, b: 1 } }, 'color', colorVars['bg/level-0'])];
+        cardFrame.strokes = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 0.93, g: 0.94, b: 0.96 } }, 'color', colorVars['bg/level-2'])];
+        cardFrame.strokeWeight = 1;
+
+        var cardTitle = figma.createText();
+        try {
+          cardTitle.fontName = { family: fontFamily, style: 'Semi Bold' };
+          cardTitle.characters = 'Card title';
+          await cardTitle.setTextStyleIdAsync(titleStyle.id).catch(function() {});
+          cardTitle.fills = [figma.variables.setBoundVariableForPaint({ type: 'SOLID', color: { r: 0.1, g: 0.1, b: 0.1 } }, 'color', colorVars['text/primary'])];
+        } catch (e) {}
+        cardFrame.appendChild(cardTitle);
+        var cardComp = figma.createComponentFromNode(cardFrame);
+        componentIds.card = cardComp.id;
+
+        console.log('🌉 [F-MCP v1.9.7] Phase 2 done — 3 components created');
+      }
+
+      figma.ui.postMessage({
+        type: 'CREATE_MINI_DS_RESULT',
+        requestId: msg.requestId,
+        success: true,
+        dsName: dsName,
+        variableCollectionIds: { colors: colorCollection.id, sizing: sizingCollection.id },
+        textStyleIds: { title: titleStyle.id, body: bodyStyle.id, caption: captionStyle.id },
+        componentIds: componentIds,
+        summary: {
+          colorVariableCount: Object.keys(colorVars).length,
+          sizingVariableCount: Object.keys(sizingVars).length,
+          textStyleCount: 3,
+          componentCount: Object.keys(componentIds).length,
+        },
+        hint: "v1.9.7 Mini DS hazir. Ekran kurmak icin figma_execute kullan: importVariableByKeyAsync + importComponentByKeyAsync ile key'leri al, instance + setBoundVariable yaparak olustur.",
+      });
+    } catch (error) {
+      var errorMsg = error && error.message ? error.message : String(error);
+      console.error('🌉 [F-MCP v1.9.7] CREATE_MINI_DS error:', errorMsg);
+      figma.ui.postMessage({
+        type: 'CREATE_MINI_DS_RESULT',
+        requestId: msg.requestId,
+        success: false,
+        error: errorMsg,
+      });
+    }
+  }
+
   // ============================================================================
   // DELETE_NODE - Delete a node
   // ============================================================================

package/f-mcp-plugin/ui.html

@@ -424,7 +424,7 @@
     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.9.5';
+    var FMCP_PLUGIN_VERSION = '1.9.7';
 
     // v1.9.2+ Startup log — Figma plugin iframe'de yeni kod yüklendiğini doğrulamak için.
     // Console'da bu log görünüyorsa plugin güncel. Görünmüyorsa iframe eski kopyayı tutuyor
@@ -778,11 +778,28 @@
         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)
+        // v1.9.5 method selection params
+        if (options.returnMode) params.returnMode = options.returnMode;
+        if (options.regionStrategy) params.regionStrategy = options.regionStrategy;
+        if (options.maxRegions != null) params.maxRegions = options.maxRegions;
+        if (options.sliceHeight != null) params.sliceHeight = options.sliceHeight;
+        if (options.requestedSlices) params.requestedSlices = options.requestedSlices;
       }
       return window.sendPluginCommand('CAPTURE_SCREENSHOT', params, 30000)
         .catch(function(err) { return { success: false, error: err.message || String(err) }; });
     };
 
+    // v1.9.7: Create Mini DS — variables + text styles + components in one call
+    window.createMiniDs = (params) => {
+      return window.sendPluginCommand('CREATE_MINI_DS', {
+        primaryColor: params.primaryColor || '#1464FF',
+        fontFamily: params.fontFamily || 'Inter',
+        name: params.name || 'Mini DS',
+        includeComponents: params.includeComponents !== false,
+      }, 45000) // 45s — font loading + 3 component creation takes time
+        .catch(function(err) { return { success: false, error: err.message || String(err) }; });
+    };
+
     // Batch export nodes as SVG/PNG/JPG/PDF with base64
     window.batchExportNodes = (nodeIds, format, scale, svgOutlineText, svgIncludeId, svgSimplifyStroke) => {
       return window.sendPluginCommand('BATCH_EXPORT_NODES', {
@@ -1881,6 +1898,7 @@
               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 === 'createMiniDs') return window.createMiniDs(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.9.5",
+	"version": "1.9.7",
 	"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",
@@ -27,7 +27,8 @@
 		"LICENSE"
 	],
 	"scripts": {
-		"prepublishOnly": "npm run build && npm run validate:fmcp-skills",
+		"prepublishOnly": "npm run generate:embedded-skills && npm run build && npm run validate:fmcp-skills",
+		"generate:embedded-skills": "node scripts/generate-embedded-skills.mjs",
 		"dev": "node dist/local-plugin-only.js",
 		"build:run": "npm run build && node dist/local-plugin-only.js",
 		"build": "tsc -p tsconfig.local.json",

package/skills/fmcp-intent-router/SKILL.md

@@ -28,18 +28,32 @@ Bu SKILL bu üç soruyu **upstream** çözer. Claude intent'i netleştirmeden hi
 
 Kullanıcı F-MCP ile ilgili herhangi bir talep yaptığında Claude bu 9 adımı SIRAYLA uygular. Hiçbir adım atlanmaz.
 
-### 🚨 Adım 0 — DS GATE (v1.9.1+ MUTLAK İLK KAPI)
+### 🚨 Adım 0 — DS GATE + BLANK FILE CHECK (v1.9.7+ MUTLAK İLK KAPI)
 
 **Herhangi bir intent analysis veya figma_* tool çağrısından ÖNCE:**
 
-1. `.claude/design-systems/active-ds.md` dosyasını oku
-2. `Status:` alanını kontrol et:
-   - **`✅ Aktif`** → DS net, Adım 1'e (Intent Analysis) geç
-   - **`❌ Henüz seçilmedi`** VEYA dosya yok → **DUR**, hiçbir tool çağırma, kullanıcıya DS sorusu sor:
-     > "Aktif bir design system belirlenmemiş. Hangi DS ile ilerlemek istersiniz?
-     > (Mevcut seçenekler için library listesini vermenizi istiyorum, veya SUI gibi spesifik bir isim verin.)
-     > Bu sorunun cevabı gelmeden hiçbir keşif / tarama yapmayacağım."
-3. Kullanıcı cevabı gelince `active-ds.md`'yi güncelle (`Status: ✅ Aktif`, `Library Name: <isim>`), sonra Adım 1'e geç.
+1. `figma_get_status` çağır — plugin bağlı mı, response'ta `_bootstrap` varsa direktifleri OKU (v1.9.7)
+2. `.claude/design-systems/active-ds.md` dosyasını oku
+3. `Status:` alanını kontrol et:
+   - **`✅ Aktif`** → DS net, Blank File Sub-Check'e geç (madde 5)
+   - **`❌ Henüz seçilmedi`** VEYA dosya yok → kullanıcıya DS sorusu sor (madde 4)
+4. **DS Sorusu (klasik):** "Aktif bir design system belirlenmemiş. Hangi DS ile ilerlemek istersiniz? (SUI / Material / kendi library)"
+
+5. **BLANK FILE SUB-CHECK (v1.9.7, ZORUNLU):** `figma_get_design_system_summary` çağır.
+   - `components === 0 && componentSets === 0 && variableCollections.length === 0` ise **BOŞ DOSYA** tespit edildi.
+   - `_nextStep: "BLANK_FILE_DIALOG_REQUIRED"` response'ta görünüyorsa, **kullanıcıya 4 seçenek sun** (AskUserQuestion tek call, 4 option):
+     ```
+     Q: "Bu dosyada henüz Design System yok. Nasıl ilerleyelim?"
+     (a) Team library import — "Hangi library? SUI, Material 3, iOS HIG, veya kendi library'niz?"
+     (b) Mini DS kur otomatik — figma_create_mini_ds tool'u çağrılır (12 color + 8 sizing + 3 text style + Button/Input/Card)
+     (c) Referans DS kopyala — "Material 3 template / iOS HIG template"
+     (d) DS'siz ilerle — linter tolerant mode, hardcoded değerler kabul (explicit acceptance)
+     ```
+   - **Seçim yapılmadan `figma_execute createFrame` YASAK.** Claude ham createFrame denerse plugin `_DESIGN_SYSTEM_VIOLATIONS_BLOCKING` flag'i döndürür, retry zorunlu olur.
+   - Kullanıcı "(b)" derse Claude `figma_create_mini_ds({ primaryColor, fontFamily, name })` tek tool çağrısı yapar, sonra ekran üretimine geçer.
+   - Kullanıcı "(a)" derse Claude `figma_get_library_variables(libraryName)` ile listeleme yapar, seçenek sunar.
+
+6. Seçim sonrası `active-ds.md`'yi güncelle (`Status: ✅ Aktif`, `Library Name: <isim>`), sonra Adım 1'e geç.
 
 **Neden bu kadar katı:**
 - DS belirsizken `figma_search_assets`, `figma_get_file_data`, `figma_get_library_variables` çağırmak = kullanıcının istemediği library'leri enumere etmek = **token israfı + UX bozulması**
@@ -235,6 +249,39 @@ Missing list'teki tüm soruları **TEK** `AskUserQuestion` çağrısında toplay
 - Sorulan her soru ≤30 kelime — uzun elicitation yasak.
 - Soruyu sormanın context maliyeti ≥ yanıtın değeri mi? Değilse sorma.
 
+### v1.9.6 Negative Intent Detection (KRITIK)
+
+Kullanıcı şu paternlerle **negatif/dışlayıcı** talimat verebilir — bunları ZORUNLU parse et:
+
+| Kullanıcı paterni | Anlam | Nasıl handle et |
+|---|---|---|
+| "X'i atla" / "X'i kullanma" / "X'ten bahsetme" | X referansını DIŞLA | `exclude_references: ["X"]` state'e yaz, o node/page/frame'e referans verme |
+| "X'e bakma" / "X yok say" / "X'i unut" | X sıfır-referans | Aynı |
+| "Y benzetme" / "Y gibi olmasın" | Y anti-pattern | `anti_pattern_refs: ["Y"]` — Y'ye ters tasarım yap |
+| "X dışında" / "X hariç" | Whitelist exclusion | `exclude_references: ["X"]` |
+| "Sıfırdan" / "baştan" / "yeni tasarım" | Mevcut iterasyonları atla | `start_fresh: true`, ideation/iterasyon referansları atla |
+
+**Örnek:**
+
+```
+Kullanıcı: "SUI Alt 3'e bakma, sıfırdan yeni bir Anasayfa tasarla"
+
+PARSE:
+  - exclude_references: ["SUI Alt 3", "241:11896"]  (SUI Alt 3 frame ID'si de dahil)
+  - start_fresh: true
+  - target_screen: "Anasayfa"
+  - DS: active-ds.md'den çek
+
+SONUÇ:
+  - SUI Alt 3 sayfası referans alınmaz
+  - Mevcut "SUI Alt 3 — Anasayfa" frame'i açılmaz, screenshot alınmaz
+  - ideation sayfası (ilham) kullanılabilir ama SUI Alt 3 bölümü atlanır
+```
+
+**Anti-pattern:** Kullanıcı "SUI Alt 3 atla" dedikten sonra onu screenshot alıp referans göstermek. v1.9.6'da bu explicit yasak — pre-flight'ta `exclude_references` kontrolü yapılır.
+
+**State persist:** `exclude_references` last-intent.md'ye yazılır; aynı oturum boyunca geçerli.
+
 **Örnek — generate-figma-screen:**
 
 ```

package/skills/fmcp-screen-orchestrator/SKILL.md

@@ -144,6 +144,32 @@ Benchmark/görselden DEĞER alma YASAK. Sadece NİYET: layout yönü, hiyerarşi
 2. **Content** — DS instance yerleşimi → screenshot → onay
 3. **Polish** — spacing, states, edge cases → son screenshot → audit
 
+### v1.9.7 Anti-Suppression Kuralı (MUTLAK — HARD enforcement)
+
+BLOCKING response gördüğünde YASAK ifadeler:
+- "bu projede geçerli değil"
+- "dosyada DS yok, bu uyarılar önemsiz"
+- "şimdilik skip edelim"
+- "sonra düzeltiriz"
+- "yine de devam ediyorum"
+
+**Server seviyesi enforcement (Katman 3):** Claude BLOCKING flag gördükten sonra **aynı nodeId** üzerinde ikinci `figma_execute` mutation yaparsa server **HARD_ERROR** döndürür — tool fail eder, response değil error. Claude bunu skip edemez.
+
+**Override escape hatch:** Sadece kullanıcı onayı ile `// FORCE_OVERRIDE` comment'i kod başına ekleyerek bypass edilebilir.
+
+**ZORUNLU davranış BLOCKING gördüğünde:**
+1. BLOCKING'i OKU — hangi nodeId, hangi kategori? (_postExecuteViolations.violations)
+2. Kök nedeni analiz et:
+   - UNBOUND_FILL → setBoundVariableForPaint eksik
+   - UNBOUND_PADDING → setBoundVariable eksik
+   - UNBOUND_TEXTSTYLE → setTextStyleIdAsync eksik
+   - NO_INSTANCE_USAGE → DS component yok, import edilmeli
+3. Kullanıcıya sor SADECE şu koşullarda:
+   - DS gerçekten yok → Adım 0 Blank File sub-check'e dön (4 option)
+   - Override gerekli → "BLOCKING'i geçici bypass etmek istiyor musun?"
+4. Kullanıcı override isterse `// FORCE_OVERRIDE` comment ile kod tekrar çalıştır
+5. Aksi takdirde kodu DÜZELT ve retry
+
 ### v1.9.5 Discovery Budget Rule (SERT)
 
 - **Maks 3 discovery çağrısı** (figma_get_*, figma_search_*, figma_execute read-only) sonra plan sun.