@atezer/figma-mcp-bridge 1.9.1 → 1.9.3

package/CHANGELOG.md

@@ -12,6 +12,58 @@ Bu dosya [Keep a Changelog](https://keepachangelog.com/tr/1.1.0/) biçimine uygu
 
 Bu changelog'a ekleme öncesi sürümlerin tam ayrıntıları için `git log` kullanılabilir.
 
+## [1.9.3] - 2026-04-17
+
+### DS Cache İki Katmanlı Mimari + Güvenlik Redact
+
+Tasarım sistemi cache framework'ü **public template + user-local cache** olarak iki katmana ayrıldı. Kurumsal Figma library key'leri (componentKey, variableKey, file key) artık **repo'ya yazılmaz**; her kullanıcının makinesinde `~/.claude/data/fcm-ds/<file-key>/` altında tutulur.
+
+**Neden:**
+
+FCM açık kaynak MCP server/plugin dağıtımı — `@atezer/figma-mcp-bridge` npm paketi ve GitHub repo public. Önceki `tokens.md` / `components.md` stub'ları gerçek key ile doldurulduğunda kurumsal Figma IP'si (hash key'ler, file key'ler) repo'ya sızıyor ve kullanıcıya özel çözüm sunmuyordu. Ek olarak Figma'da variable/component rename olunca cache'lenmiş key invalid oluyordu.
+
+**Değişiklikler:**
+
+- `.claude/design-systems/README.md`: İki-katman mimari dokümante edildi (public template vs user-local cache), skill okuma sırası tanımlandı (user-local → repo template → runtime resolve)
+- `.claude/design-systems/active-ds.md`: Gerçek `file key` kaldırıldı, user-local pointer pattern'ine geçildi
+- `.claude/design-systems/sui/tokens.md`: Generic token isim paternleri (spacing/radius/surface/typography rol haritası) — variableKey yok
+- `.claude/design-systems/sui/components.md`: Generic component isim paternleri (Top usage-ranked) + eksik listesi + primitive fallback tablosu — componentKey yok
+- `.claude/design-systems/sui/SUI_CHEATSHEET.md` (yeni): 10 bölümlük workflow rehberi (karar ağacı, 9 recipe index, 5-tab IA, custom dashboard pattern, 3 mutlak kural, anti-pattern listesi, hedef metrikleri, sorun giderme)
+- `.gitignore`: DS cache güvenlik katmanı eklendi (`.claude/design-systems/*/_meta.md`, `*.cache.md`, `*.local.md`)
+- `CHANGELOG.md`: v1.7.30 entry'sinden `P31qJTP8XVupmZG4BlTtPG` file key redact
+- `install/TOKEN-BUDGET.md`: Text style import key redact (`fb3591835c86d00580e1f0cea2343d033107dc67`)
+
+**Kullanıcı için ne değişir:**
+
+- İlk kurulum: `/ds-sync sui` (veya "SUI cache oluştur") komutu ile kendi makinenizde user-local cache oluşur; repo'ya girmez
+- `fmcp-screen-recipes` cache-first mantığı değişmez ama artık önce user-local'e bakar, yoksa repo template'ine düşer, yoksa runtime resolve yapar
+- Mevcut cache'i olan kullanıcılar: `.claude/design-systems/<lib>/` altında gerçek key varsa manuel olarak `~/.claude/data/fcm-ds/<file-key>/` altına taşıyın
+
+**Regresyon:** Sıfır. Plugin / MCP server kodu değişmedi; yalnızca `.claude/` dokümantasyon + `.gitignore` + iki CHANGELOG redact.
+
+**Not:** `.claude/` klasörü npm paketinin `files` alanında değildir; bu release npm paket içeriğini değiştirmez. Release yalnızca CHANGELOG + version tutarlılığı içindir.
+
+## [1.9.2] - 2026-04-17
+
+### Plugin Version Sync + Diagnostic Startup Log (v1.9.1 Tamamlayıcı Hotfix)
+
+v1.9.1 release'inde plugin tarafındaki `FMCP_PLUGIN_VERSION` string'i (`ui.html` + `code.js`) `'1.8.2'`'de kalmıştı — server-side kod v1.9.1 olarak yayınlanmış olmasına rağmen. Bu hotfix plugin version'unu senkronize eder ve plugin yüklendiğinde belirgin bir startup log ekler.
+
+**Değişiklikler:**
+
+- `f-mcp-plugin/ui.html`: `FMCP_PLUGIN_VERSION = '1.8.2'` → `'1.9.2'`
+- `f-mcp-plugin/code.js`: aynı
+- `f-mcp-plugin/ui.html`: Plugin yüklendiğinde `console.log('[F-MCP v1.9.2] Plugin loaded — server-side sibling discovery active')` startup log'u eklendi
+
+**Neden önemli:**
+
+v1.9.1'de plugin tarafı kod düzeltildi (welcome handler'a `activeBridges` branch eklendi, `scanOtherPorts` artık sadece fallback olarak çalışıyor) ama Figma plugin iframe'i bazen eski cache'ini tutuyor. Bu hotfix'teki startup log sayesinde:
+
+- Plugin'i açıp DevTools → Console'da `[F-MCP v1.9.2]` log'u görüyorsan → **yeni kod yüklendi, blind scan devre dışı**
+- Log göremiyorsan → eski cache hâlâ aktif, `docs/TROUBLESHOOTING.md`'deki plugin remove + re-add talimatını uygula
+
+**Regresyon:** Sıfır. Sadece version string güncellemesi ve tek satır console.log — fonksiyonel davranış aynen kalır.
+
 ## [1.9.1] - 2026-04-17
 
 ### Plugin Multi-Bridge Discovery — Server-Side (Console Errors Tamamen Giderildi)
@@ -453,7 +505,7 @@ F-MCP Bridge ile SUI gibi team library tabanli tasarim sistemleri kullanmak arti
 - `src/local-plugin-only.ts`: 1 bug fix + 1 enrichment + 3 yeni tool + description guncellemeleri
 - `skills/figma-canvas-ops/SKILL.md`, `skills/generate-figma-screen/SKILL.md`, `skills/fmcp-project-rules/SKILL.md`
 
-**Test Edildi:** Sahifinans Playground (`P31qJTP8XVupmZG4BlTtPG`) dosyasinda SUI kutuphanesi ile uctan uca dogrulandi: `figma_search_assets` 25 variable + 4 lib collection donduruyor, `figma_get_library_variables` 84-100 SUI variable key'iyle donuyor, frame olusturma → `figma_bind_variable` ile `Surface/background level-0` baglama → screenshot dogrulamasi basarili, `_warnings` static analiz hem success hem error path'lerinde calisiyor.
+**Test Edildi:** Ozel bir consumer Figma dosyasi uzerinde SUI kutuphanesi ile uctan uca dogrulandi: `figma_search_assets` 25 variable + 4 lib collection donduruyor, `figma_get_library_variables` 84-100 variable key'iyle donuyor, frame olusturma → `figma_bind_variable` ile `Surface/background level-0` baglama → screenshot dogrulamasi basarili, `_warnings` static analiz hem success hem error path'lerinde calisiyor.
 
 ---
 

package/README.md

@@ -117,9 +117,10 @@ Detay: [UPDATE.md](docs/UPDATE.md)
 
 | Sorun | Çözüm |
 |-------|-------|
-| Plugin "no server" diyor | AI aracınızı yeniden başlatın |
+| Plugin "no server" diyor | Önce AI aracını (Claude Desktop / Cursor / Claude Code) açın, sonra Figma'da plugin'i çalıştırın |
 | Plugin "connecting..." diyor | Bekleyin, otomatik bağlanır |
 | Yeni araçlar görünmüyor | AI aracını tamamen kapatıp tekrar açın |
+| DevTools console'da WebSocket hataları | v1.9.1+ ile server-side probe ile giderildi. Plugin hâlâ eski kodu cache'liyorsa: Figma → Plugins → Development → Manage plugins in development → Remove → Import plugin from manifest |
 
 Daha fazla: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
 

package/dist/core/version.d.ts

@@ -1,3 +1,3 @@
 /** F-MCP version — keep in sync with package.json during version bumps. */
-export declare const FMCP_VERSION = "1.9.1";
+export declare const FMCP_VERSION = "1.9.2";
 //# sourceMappingURL=version.d.ts.map

package/dist/core/version.js

@@ -1,3 +1,3 @@
 /** F-MCP version — keep in sync with package.json during version bumps. */
-export const FMCP_VERSION = "1.9.1";
+export const FMCP_VERSION = "1.9.2";
 //# sourceMappingURL=version.js.map

package/f-mcp-plugin/code.js

@@ -6,7 +6,7 @@
 
 // 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.8.2';
+var FMCP_PLUGIN_VERSION = '1.9.2';
 
 // Console log buffer for figma_get_console_logs (no CDP)
 var __consoleLogBuffer = [];

package/f-mcp-plugin/ui.html

@@ -424,7 +424,12 @@
     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';
+    var FMCP_PLUGIN_VERSION = '1.9.2';
+
+    // 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
+    // (plugin remove + re-add gerekli). Bkz. docs/TROUBLESHOOTING.md.
+    console.log('[F-MCP v' + FMCP_PLUGIN_VERSION + '] Plugin loaded — server-side sibling discovery active');
 
     let requestIdCounter = 0;
 

package/package.json

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