From 7ffe3a767914a381c326cf988967e5757ee982f6 Mon Sep 17 00:00:00 2001
From: Ercan Er <ercan.er@medeniyet.edu.tr>
Date: Tue, 1 Sep 2026 20:32:57 +0300
Subject: [PATCH] fix: paket adlarindaki "win32" karisikligini gider

Bir kullanici "win32" adini "32 bit Windows" diye okudu, 64 bit makinesinde
yanlis paketi (linux) kurdu ve Claude Desktop art arda platform uyumsuzlugu
uyarisi verdi.

win32 bir bit sayisi degil, Windows'un platform kimligi. Manifest'te dogru
olan bu kimlik, ama DOSYA ADINDA insan gozune yanlis okunuyor.

- package-extension.py varsayilan cikti adi artik windows/macos/linux
  (CI'in urettigi release dosya adlariyla ayni)
- TROUBLESHOOTING.md: yanlis platform paketi kurulunca ne olur, nasil
  duzeltilir, ve win32 aciklamasi

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 docs/TROUBLESHOOTING.md | 22 ++++++++++++++++++++++
 package-extension.py    |  7 ++++++-
 2 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/docs/TROUBLESHOOTING.md b/docs/TROUBLESHOOTING.md
index b7b7be2..3c892f0 100644
--- a/docs/TROUBLESHOOTING.md
+++ b/docs/TROUBLESHOOTING.md
@@ -8,6 +8,28 @@ Reinstall the CLI and make sure the npm global bin directory is on your PATH:
 npm install -g @anthropic-ai/claude-code
 ```
 
+## Claude Desktop, kurduğum eklenti için "bu paket bu platform için değil" diyor
+
+Her `.mcpb` paketi **tek bir işletim sistemi** içindir; içinde yalnızca o
+sistemin ikili dosyası vardır. Yanlış paketi kurarsan Claude Desktop uyarı
+verir ve eklenti çalışmaz.
+
+Son sürümden işletim sistemine uyanı indir:
+
+| İşletim sistemi | Dosya |
+|---|---|
+| Windows (32 ve 64 bit fark etmez) | `claude-code-setup-windows.mcpb` |
+| macOS | `claude-code-setup-macos.mcpb` |
+| Linux | `claude-code-setup-linux.mcpb` |
+
+Eski sürümlerde Windows paketinin adında `win32` geçiyordu. Bu "32 bit"
+demek değil — `win32`, Windows'un platform kimliğidir ve 64 bit makineler
+için de doğru dosyadır. Kafa karışıklığını önlemek için adlandırma
+`windows` olarak değiştirildi.
+
+Yanlış paketi kurduysan: Claude Desktop → Settings → Extensions'tan kaldır,
+doğru dosyayı sürükle.
+
 ## `memory-search` says "Memory database not found"
 
 Run `memory-index` first. The database lives at `~/.claude/memory_index.db`. If your notes are not in the default `~/claude_global_memory/knowledge` directory, pass `--source`:
diff --git a/package-extension.py b/package-extension.py
index 737d974..502789c 100644
--- a/package-extension.py
+++ b/package-extension.py
@@ -52,7 +52,12 @@ def main() -> int:
     manifest["server"]["mcp_config"]["command"] = "${__dirname}/" + entry
     manifest.setdefault("compatibility", {})["platforms"] = [platform]
 
-    default_name = f"{manifest['name']}-{manifest['version']}-{platform}.mcpb"
+    # Dosya adinda platform KIMLIGINI kullanma: "win32" insan gozune
+    # "32 bit Windows" gibi gorunuyor ve kullanicilar 64 bit makinede
+    # yanlislikla baska platformun paketini seciyor. Adlar CI'in urettigi
+    # release dosya adlariyla da ayni olsun.
+    friendly = {"win32": "windows", "darwin": "macos", "linux": "linux"}
+    default_name = f"{manifest['name']}-{friendly.get(platform, platform)}.mcpb"
     out = pathlib.Path(sys.argv[2]) if len(sys.argv) > 2 else ROOT / default_name
 
     with zipfile.ZipFile(out, "w", zipfile.ZIP_DEFLATED) as z: