@atezer/figma-mcp-bridge 1.9.2 → 1.9.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/CHANGELOG.md +32 -1
  2. package/README.md +2 -1
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -12,6 +12,37 @@ Bu dosya [Keep a Changelog](https://keepachangelog.com/tr/1.1.0/) biçimine uygu
12
12
 
13
13
  Bu changelog'a ekleme öncesi sürümlerin tam ayrıntıları için `git log` kullanılabilir.
14
14
 
15
+ ## [1.9.3] - 2026-04-17
16
+
17
+ ### DS Cache İki Katmanlı Mimari + Güvenlik Redact
18
+
19
+ 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.
20
+
21
+ **Neden:**
22
+
23
+ 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.
24
+
25
+ **Değişiklikler:**
26
+
27
+ - `.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)
28
+ - `.claude/design-systems/active-ds.md`: Gerçek `file key` kaldırıldı, user-local pointer pattern'ine geçildi
29
+ - `.claude/design-systems/sui/tokens.md`: Generic token isim paternleri (spacing/radius/surface/typography rol haritası) — variableKey yok
30
+ - `.claude/design-systems/sui/components.md`: Generic component isim paternleri (Top usage-ranked) + eksik listesi + primitive fallback tablosu — componentKey yok
31
+ - `.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)
32
+ - `.gitignore`: DS cache güvenlik katmanı eklendi (`.claude/design-systems/*/_meta.md`, `*.cache.md`, `*.local.md`)
33
+ - `CHANGELOG.md`: v1.7.30 entry'sinden `P31qJTP8XVupmZG4BlTtPG` file key redact
34
+ - `install/TOKEN-BUDGET.md`: Text style import key redact (`fb3591835c86d00580e1f0cea2343d033107dc67`)
35
+
36
+ **Kullanıcı için ne değişir:**
37
+
38
+ - İlk kurulum: `/ds-sync sui` (veya "SUI cache oluştur") komutu ile kendi makinenizde user-local cache oluşur; repo'ya girmez
39
+ - `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
40
+ - 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
41
+
42
+ **Regresyon:** Sıfır. Plugin / MCP server kodu değişmedi; yalnızca `.claude/` dokümantasyon + `.gitignore` + iki CHANGELOG redact.
43
+
44
+ **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.
45
+
15
46
  ## [1.9.2] - 2026-04-17
16
47
 
17
48
  ### Plugin Version Sync + Diagnostic Startup Log (v1.9.1 Tamamlayıcı Hotfix)
@@ -474,7 +505,7 @@ F-MCP Bridge ile SUI gibi team library tabanli tasarim sistemleri kullanmak arti
474
505
  - `src/local-plugin-only.ts`: 1 bug fix + 1 enrichment + 3 yeni tool + description guncellemeleri
475
506
  - `skills/figma-canvas-ops/SKILL.md`, `skills/generate-figma-screen/SKILL.md`, `skills/fmcp-project-rules/SKILL.md`
476
507
 
477
- **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.
508
+ **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.
478
509
 
479
510
  ---
480
511
 
package/README.md CHANGED
@@ -117,9 +117,10 @@ Detay: [UPDATE.md](docs/UPDATE.md)
117
117
 
118
118
  | Sorun | Çözüm |
119
119
  |-------|-------|
120
- | Plugin "no server" diyor | AI aracınızı yeniden başlatın |
120
+ | Plugin "no server" diyor | Önce AI aracını (Claude Desktop / Cursor / Claude Code) açın, sonra Figma'da plugin'i çalıştırın |
121
121
  | Plugin "connecting..." diyor | Bekleyin, otomatik bağlanır |
122
122
  | Yeni araçlar görünmüyor | AI aracını tamamen kapatıp tekrar açın |
123
+ | 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 |
123
124
 
124
125
  Daha fazla: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
125
126
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atezer/figma-mcp-bridge",
3
- "version": "1.9.2",
3
+ "version": "1.9.3",
4
4
  "description": "F-MCP ATezer: MCP server and Figma plugin bridge for Claude/Cursor. No REST token required.",
5
5
  "type": "module",
6
6
  "main": "dist/local-plugin-only.js",