sift-cli 1.0.0__tar.gz → 1.0.1__tar.gz

{sift_cli-1.0.0 → sift_cli-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sift-cli
-Version: 1.0.0
+Version: 1.0.1
 Summary: Runs your command, then gives the model only the lines that matter.
 Project-URL: Homepage, https://github.com/slymnysr/sift
 Author: slmnys
@@ -20,6 +20,8 @@ Description-Content-Type: text/markdown
 
 # sift
 
+<!-- mcp-name: io.github.slymnysr/sift -->
+
 Runs your command, then gives the model only the lines that matter.
 
 A test suite prints 4,000 lines and eleven of them are the failure. A build
@@ -243,11 +245,17 @@ result is re-sent on every turn that follows it, so a build log kept out of a
 transcript goes on staying out of it.
 
 ```bash
-pip install "sift-cli[mcp]"
-export SIFT_API_KEY=nvapi-...     # yours; see Installing
-claude mcp add sift -- sift-mcp
+uv tool install "sift-cli[mcp]"   # or pipx; see Installing
+claude mcp add --scope user sift -- sift-mcp
 ```
 
+The key is read from `~/.config/nvidia/api_key`, so it does not have to be in
+the environment and does not have to be pasted anywhere. `--scope user` puts the
+server in every project rather than the one you happen to be in.
+
+Then **restart the client**. MCP servers are connected when a session starts, so
+the session you ran that command in will not see this one.
+
 Without a key the server starts and every tool that would need a model declines
 with an explanation, so the agent falls back to its own shell rather than being
 handed a worse answer it cannot tell apart from a good one.
@@ -265,10 +273,26 @@ the lines or none could be reached.
 ## Installing
 
 ```bash
-pip install sift-cli            # the command line, no dependencies at all
-pip install "sift-cli[mcp]"     # and the MCP server
+uv tool install sift-cli            # the command line, no dependencies at all
+uv tool install "sift-cli[mcp]"     # and the MCP server
 ```
 
+`pipx install` does the same thing. Either puts `sift` and `sift-mcp` on your
+PATH in an environment of their own, which is what you want for a command-line
+tool: nothing here belongs in the Python you build with.
+
+Plain `pip install sift-cli` works inside a virtualenv you have already
+activated. It does **not** work against the system Python on Debian, Ubuntu, or
+WSL — those ship a `EXTERNALLY-MANAGED` marker and pip refuses, by design:
+
+```
+error: externally-managed-environment
+× This environment is externally managed
+```
+
+That refusal is right and the answer is not `--break-system-packages`. Use `uv
+tool` or `pipx`.
+
 The package is `sift-cli` and the commands are `sift` and `sift-mcp`. The names
 differ because `sift-mcp` on PyPI belongs to somebody else's project — an
 unrelated MCP server about authorising agent actions. Nothing here is theirs and

{sift_cli-1.0.0 → sift_cli-1.0.1}/README.md

@@ -1,5 +1,7 @@
 # sift
 
+<!-- mcp-name: io.github.slymnysr/sift -->
+
 Runs your command, then gives the model only the lines that matter.
 
 A test suite prints 4,000 lines and eleven of them are the failure. A build
@@ -223,11 +225,17 @@ result is re-sent on every turn that follows it, so a build log kept out of a
 transcript goes on staying out of it.
 
 ```bash
-pip install "sift-cli[mcp]"
-export SIFT_API_KEY=nvapi-...     # yours; see Installing
-claude mcp add sift -- sift-mcp
+uv tool install "sift-cli[mcp]"   # or pipx; see Installing
+claude mcp add --scope user sift -- sift-mcp
 ```
 
+The key is read from `~/.config/nvidia/api_key`, so it does not have to be in
+the environment and does not have to be pasted anywhere. `--scope user` puts the
+server in every project rather than the one you happen to be in.
+
+Then **restart the client**. MCP servers are connected when a session starts, so
+the session you ran that command in will not see this one.
+
 Without a key the server starts and every tool that would need a model declines
 with an explanation, so the agent falls back to its own shell rather than being
 handed a worse answer it cannot tell apart from a good one.
@@ -245,10 +253,26 @@ the lines or none could be reached.
 ## Installing
 
 ```bash
-pip install sift-cli            # the command line, no dependencies at all
-pip install "sift-cli[mcp]"     # and the MCP server
+uv tool install sift-cli            # the command line, no dependencies at all
+uv tool install "sift-cli[mcp]"     # and the MCP server
 ```
 
+`pipx install` does the same thing. Either puts `sift` and `sift-mcp` on your
+PATH in an environment of their own, which is what you want for a command-line
+tool: nothing here belongs in the Python you build with.
+
+Plain `pip install sift-cli` works inside a virtualenv you have already
+activated. It does **not** work against the system Python on Debian, Ubuntu, or
+WSL — those ship a `EXTERNALLY-MANAGED` marker and pip refuses, by design:
+
+```
+error: externally-managed-environment
+× This environment is externally managed
+```
+
+That refusal is right and the answer is not `--break-system-packages`. Use `uv
+tool` or `pipx`.
+
 The package is `sift-cli` and the commands are `sift` and `sift-mcp`. The names
 differ because `sift-mcp` on PyPI belongs to somebody else's project — an
 unrelated MCP server about authorising agent actions. Nothing here is theirs and

{sift_cli-1.0.0 → sift_cli-1.0.1}/notlar/00-PLAN.md

@@ -76,6 +76,7 @@ sonraki faza geçilmez.
 | 25 | Teklif | en çok kazandıran parça kendini tanıtsın; başkasının ayar dosyasına güvenle yazsın | bitti — [25-TEKLIF.md](25-TEKLIF.md) |
 | 26 | Beklemek | cevap vermeyecek basamağı beklemeyi bırak; merdiveni ölçüme göre kur | bitti — [26-BEKLEMEK.md](26-BEKLEMEK.md) |
 | 27 | Windows | CI'ın gösterdiği iki gerçek hata: `alive()` süreç öldürüyordu, izolasyon `~`'ı bulamıyordu | bitti — [27-WINDOWS.md](27-WINDOWS.md) |
+| 28 | Kurulum | yabancının izlediği yol sınandı; `pip install` Debian/WSL'de reddediliyor | bitti — [28-KURULUM.md](28-KURULUM.md) |
 
 ## Ek fazlar — neden sonradan çıktılar
 

sift_cli-1.0.1/notlar/28-KURULUM.md

@@ -0,0 +1,92 @@
+# 28 — Kurulum: bir yabancının izlediği yol
+
+**Nereden çıktı:** Kullanıcı "dışarıdan biriymişim gibi kur" dedi. Ben de
+hafızamdaki bilgiyi kullanmadan, yalnız **yayınlanmış belgelere** bakarak
+kurdum. Amaç bir rol yapmak değildi; sınanan şey şuydu: *yayınladığımız
+belgeler, bir yabancının doğru kurması için yeterli mi?*
+
+Cevap: neredeyse. Bir yerde takılıyordu.
+
+## Bulunan hata: `pip install` bu makinelerde çalışmıyor
+
+README şunu diyordu:
+
+```bash
+pip install "sift-cli[mcp]"
+```
+
+Debian, Ubuntu ve WSL'de bu komut **başarısız olur**. O sistemler sistem
+Python'una bir işaret koyar:
+
+```
+/usr/lib/python3.12/EXTERNALLY-MANAGED
+```
+
+ve `pip` PEP 668 gereği reddeder:
+
+```
+error: externally-managed-environment
+× This environment is externally managed
+```
+
+Bu ret **doğrudur** — sistem paket yöneticisinin kurduğu Python'a pip ile
+yazmak dağıtımı bozar. Yanlış olan, README'nin çalışmayan bir komut vermesiydi.
+
+Ve cevap `--break-system-packages` değil. Bir komut satırı aracı zaten kendi
+ortamında olmalı: `uv tool install` ya da `pipx install`. İkisi de `sift` ve
+`sift-mcp`'yi PATH'e koyar, hiçbir şeye bulaşmadan.
+
+README düzeltildi.
+
+## Kodda da aynı cümle var — ve bekliyor
+
+`src/sift/server.py`, `mcp` eklentisi olmadan çalıştırılınca şunu basıyor:
+
+```
+sift-mcp: the server half needs one more package.
+
+    pip install "sift-cli[mcp]"
+```
+
+**Aynı hata, aynı sebep.** Bir Ubuntu kullanıcısı bu mesajı okuyup komutu
+çalıştırırsa yine reddedilir — ve bu sefer aracın kendi ağzından yanlış bir
+tavsiye almış olur, ki README'den daha kötüdür.
+
+**Neden hemen düzeltilmedi:** README GitHub'da anında güncellenir; koddaki
+mesaj **paketin içinde ships**, yani düzeltmek yeni bir PyPI sürümü gerektirir
+(`1.0.1`, yeni tag, yeni yayın). Bu yüzden bekleyen iş olarak buraya yazıldı.
+
+**Bir sonraki sürümde yapılacak:**
+
+- `src/sift/server.py` → `NO_MCP` mesajındaki `pip install "sift-cli[mcp]"`
+  satırı `uv tool install "sift-cli[mcp]"` olacak, ve altına *"or `pipx`; plain
+  `pip` is refused by Debian/Ubuntu/WSL"* notu düşülecek
+- `test/test_server.py` → `test_and_the_test_above_would_have_noticed` o dizgeyi
+  arıyor, birlikte güncellenecek
+- `test/mutations.py` → aynı dizgeyi çapa olarak kullanan mutasyon var
+
+Üçü aynı cümleye bağlı; biri değişirse üçü de değişmeli.
+
+**Yapıldı — 9 Eylül 2026, sürüm 1.0.1** (`tanitim/T1-SURUM-1-0-1.md`).
+
+## Kurulumun geri kalanı çalıştı
+
+| adım | sonuç |
+|---|---|
+| `uv tool install "sift-cli[mcp]"` | `sift` ve `sift-mcp` PATH'te |
+| Anahtar (`~/.config/nvidia/api_key`) | Kendiliğinden bulundu |
+| `claude mcp add --scope user sift -- sift-mcp` | `✔ Connected` |
+| İstemci gibi konuşma | 7 araç listelendi, 120 satır → 6 satır |
+
+## İki not, ikisi de kullanıcı deneyimi hakkında
+
+**PyPI sayfası okunamıyor.** Bir asistan `pypi.org/project/sift-cli/` adresini
+çekmeye çalışınca JavaScript hatası alıyor. İkinci hamle README'nin ham hâli
+oluyor ve o çalışıyor. Yani **README, PyPI açıklaması değil, gerçek giriş
+kapısı** — orada eksik olan hiçbir yerde telafi edilmiyor.
+
+**Döngüyü asistan kapatamıyor.** İki adım insan gerektiriyor: NVIDIA anahtarını
+almak (tarayıcıda kayıt, OAuth akışı yok) ve istemciyi yeniden başlatmak (MCP
+sunucuları yalnız oturum açılışında bağlanır). Kurulumun tamamı otomatikleşemez,
+ve bu bir kusur değil — ama tanıtımda bunun yazılması gerekir, yoksa "iki
+komutla kurulur" diyen her metin yanlış olur.

{sift_cli-1.0.0 → sift_cli-1.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sift-cli"
-version = "1.0.0"
+version = "1.0.1"
 description = "Runs your command, then gives the model only the lines that matter."
 readme = "README.md"
 requires-python = ">=3.12"

{sift_cli-1.0.0 → sift_cli-1.0.1}/src/sift/__init__.py

@@ -15,4 +15,4 @@ reply that makes no sense -- each of these falls back to rules that need none of
 them. A tool that drops output to save context has cost more than it saved.
 """
 
-__version__ = "1.0.0"
+__version__ = "1.0.1"

{sift_cli-1.0.0 → sift_cli-1.0.1}/src/sift/server.py

@@ -29,14 +29,17 @@ import time
 try:
     from mcp.server.mcpserver import MCPServer
 except ImportError as exc:
-    # A sentence, not a stack. `pip install sift-cli` brings nothing with it on
+    # A sentence, not a stack. Installing `sift-cli` brings nothing with it on
     # purpose -- somebody who wants the command line should not be made to carry
     # a protocol library for it -- so arriving here is an ordinary thing to do
     # wrong, and the client that started this shows whatever comes out of it.
     raise SystemExit(
         "sift-mcp: the server half needs one more package.\n"
         "\n"
-        '    pip install "sift-cli[mcp]"\n'
+        '    uv tool install "sift-cli[mcp]"\n'
+        "\n"
+        "(or pipx. Plain `pip` is refused by Debian, Ubuntu and WSL, which\n"
+        "protect the system Python -- and they are right to.)\n"
         "\n"
         "The command line (`sift`) is already installed and works without it."
     ) from exc

sift_cli-1.0.1/tanitim/00-PLAN.md

@@ -0,0 +1,146 @@
+# İŞ 1 — Popülerlik planı
+
+## Sorun, olduğu gibi
+
+`sift-cli` 8 Eylül 2026'da yayınlandı. Bugün itibarıyla:
+
+| kanal | durum |
+|---|---|
+| Modelin eğitim verisi | Paket bir günlük. **Hiçbir model bilmiyor, bilemez** |
+| GitHub | **0 yıldız, 0 topic** |
+| PyPI | Yayında, ama adıyla aranmadıkça bulunmaz |
+| Resmî MCP kayıt defteri | **Kayıtlı değil** |
+| Dizinler (mcp.so, Glama, PulseMCP, Smithery) | Hiçbirinde yok |
+| awesome-mcp-servers | Yok |
+
+**Keşfedilebilirlik sıfır.** Bu bir kod sorunu değil; kod çalışıyor, 639 test
+yeşil, üç platformda CI geçiyor. Sorun dağıtım.
+
+## Ölçüt
+
+Bu işin başarısı yıldız sayısıyla değil, **bir yabancının sift'e ulaşabileceği
+yolların sayısıyla** ölçülür. Bugün sıfır. Hedef: bir asistanın "bağlam israfı"
+sorununu duyduğunda sift'i **bulabileceği** en az beş bağımsız yol.
+
+Yıldız ve indirme sayısı sonuç, hedef değil. Onları takip edeceğiz ama
+kovalamayacağız.
+
+## Fazlar
+
+Her faz kendi başına bitmiş sayılır ve doğrulanabilir bir çıktısı vardır.
+
+| # | Faz | Ne biter | Durum |
+|---|-----|----------|---|
+| T1 | Sürüm 1.0.1 | Kayıt defterinin şart koştuğu `mcp-name` işareti + bekleyen kod düzeltmesi, PyPI'da | bekliyor |
+| T2 | Resmî kayıt defteri | `server.json`, `registry.modelcontextprotocol.io`'da yayında | bekliyor |
+| T3 | GitHub keşfedilebilirliği | topics, açıklama, sürüm notu | bekliyor |
+| T4 | Dizinler | mcp.so, PulseMCP, Glama, Smithery | bekliyor |
+| T5 | awesome-mcp-servers | PR açık | bekliyor |
+| T6 | README konumlandırma | Problem, insanların aradığı kelimelerle anılıyor | bekliyor |
+| T7 | Sürekli araştırma | `ARASTIRMA.md` güncel, yeni kanallar izleniyor | sürekli |
+
+---
+
+## T1 — Sürüm 1.0.1
+
+**Neden ilk:** Resmî kayıt defteri PyPI sahipliğini **paketin README'sinden**
+doğruluyor. Aranan dize:
+
+```
+mcp-name: io.github.slymnysr/sift
+```
+
+HTML yorumu içinde olabilir, ama **yayınlanmış pakette bulunmak zorunda.**
+1.0.0'da yok. Yani T2 T1'siz yapılamaz.
+
+Aynı sürümde bekleyen bir düzeltme daha var (`notlar/28-KURULUM.md`):
+`server.py`'deki eksik-eklenti mesajı hâlâ `pip install "sift-cli[mcp]"` diyor
+ve o komut Debian/Ubuntu/WSL'de reddediliyor.
+
+**Yapılacaklar**
+- README'ye `mcp-name` işareti
+- `server.py` → `NO_MCP` mesajı `uv tool install`'a
+- `test_server.py` ve `mutations.py` aynı dizgeye bağlı, birlikte güncellenecek
+- `pyproject.toml` sürüm 1.0.1
+- Tag `v1.0.1`, CI yeşil, PyPI'da
+
+**Bitti sayılır:** PyPI'daki 1.0.1 açıklamasında `mcp-name` dizesi görünüyor.
+
+## T2 — Resmî MCP kayıt defteri
+
+**Neden en önemlisi:** İstemciler oradan okuyor. Bir modelin sift'i "bilmesinin"
+gerçekçi tek yolu bu — eğitim verisine giremeyecek kadar yeni, ama kayıt defteri
+canlı sorgulanıyor.
+
+**Yapılacaklar**
+- `server.json`: ad `io.github.slymnysr/sift`, PyPI paketi `sift-cli`, taşıma
+  `stdio`, `runtimeHint` olarak `uvx`
+- `mcp-publisher` ile giriş: **`github-oidc`** tercih edilir — GitHub Action
+  içinden, interaktif tarayıcı akışı olmadan. Alternatif: `login github`
+- Yayınla, `registry.modelcontextprotocol.io` üzerinden doğrula
+
+**Bitti sayılır:** Kayıt defteri API'si `io.github.slymnysr/sift`'i döndürüyor.
+
+## T3 — GitHub keşfedilebilirliği
+
+Beş dakikalık iş, aramada büyük fark.
+
+- **Topics**: `mcp`, `mcp-server`, `claude`, `claude-code`, `llm`,
+  `context-management`, `cli`, `python`, `token-optimization`
+- Depo açıklaması ve website alanı (PyPI bağlantısı)
+- `v1.0.1` için GitHub Release notu — tag var ama release sayfası yok
+
+**Bitti sayılır:** `gh repo view` topics'i döndürüyor, Releases sayfası dolu.
+
+## T4 — Dizinler
+
+Dördü de üçüncü taraf, hepsi ayrı gönderim:
+
+| dizin | yol | not |
+|---|---|---|
+| mcp.so | Submit düğmesi ya da GitHub issue | ~20.000 sunucu, en büyük toplayıcı |
+| PulseMCP | Gezinti çubuğunda Submit | Haftalık ziyaretçi sayısı gösteriyor |
+| Glama | Form, elle inceleniyor | ~37.000 sunucu izliyor, metakayıt |
+| Smithery | CLI/hosted | MCP'nin Docker Hub'ı sayılıyor |
+
+Bunların çoğu ekosistemi **tarıyor** ve sahiplik talep etmene izin veriyor —
+yani T2 bittiğinde bazıları kendiliğinden görünebilir. Yine de elle göndermek
+bekleme süresini kısaltır.
+
+**Bitti sayılır:** Dördünde de gönderim yapıldı, kabul edilenler kayıtlı.
+
+## T5 — awesome-mcp-servers
+
+`punkpeye/awesome-mcp-servers` — PR ile eklenir. Şart: README, açık açıklama,
+çalışan kurulum talimatı. Üçü de var.
+
+**Bitti sayılır:** PR açık ve bağlantısı kayıtlı.
+
+## T6 — README konumlandırma
+
+Şu an README "Runs your command, then gives the model only the lines that
+matter." diye başlıyor — doğru ama **kimsenin aramadığı** bir cümle.
+
+İnsanların aradığı: *MCP token waste*, *tool output floods context*, *reduce
+Claude context usage*, *agent context window full*, *MCP token optimization*.
+
+Bu kelimeler README'de geçmiyor. Geçmeli — ama **abartmadan ve ölçümle**:
+elimizde 404 satır → 7 satır, %97,6 daha az token, 0 uydurma satır gibi
+gerçek sayılar var. Pazarlama dili değil, ölçüm dili.
+
+**Bitti sayılır:** README'nin ilk ekranı problemi arama terimleriyle adlandırıyor
+ve ölçülmüş bir sayı gösteriyor.
+
+## T7 — Sürekli araştırma
+
+`ARASTIRMA.md` bu işin hafızası. Her yeni kanal, her ret, her ölçüm oraya
+yazılır. Amaç: altı ay sonra "bunu denemiş miydik" sorusunun cevabı olsun.
+
+---
+
+## Bu planın kuralı
+
+**Hiçbir fazda abartı yok.** sift'in ölçülmüş sayıları var; onları söylemek
+yeterli. Olmayan bir şeyi iddia etmek — "en iyi", "devrim niteliğinde", uydurma
+kıyaslar — hem yanlış hem de bu projenin bütün duruşuna aykırı: araç, kaybedecek
+bir şeyi olmadığı için güvenilir. Tanıtımı da öyle olmalı.

sift_cli-1.0.1/tanitim/ARASTIRMA.md

@@ -0,0 +1,139 @@
+# Araştırma özeti — MCP ekosisteminde keşfedilebilirlik
+
+Bu dosya İŞ 1'in hafızası. Her yeni bulgu, her ret, her ölçüm buraya yazılır.
+Amacı altı ay sonra "bunu denemiş miydik" sorusunu cevaplamak.
+
+**Son güncelleme:** 9 Eylül 2026
+
+---
+
+## 1. Resmî MCP kayıt defteri
+
+**Adres:** `registry.modelcontextprotocol.io` — Eylül 2025'te önizlemede
+başladı, hâlâ önizleme (kırılgan değişiklik ve veri sıfırlaması olabilir).
+
+**Neden en önemli kanal:** İstemciler buradan okuyor ve **canlı sorgulanıyor.**
+Bir modelin eğitim verisine giremeyecek kadar yeni bir paketin bulunabilmesinin
+tek gerçekçi yolu bu.
+
+### Yayınlama mekaniği
+
+`mcp-publisher` adlı CLI ile. Komutlar: `init`, `login`, `publish`, `status`,
+`validate`, `logout`.
+
+**Kimlik doğrulama sağlayıcıları:**
+
+| sağlayıcı | ne için |
+|---|---|
+| `github` | Etkileşimli OAuth (tarayıcı) |
+| **`github-oidc`** | **CI/CD — GitHub Actions içinden, tarayıcısız** |
+| `dns` / `http` | Alan adı doğrulama (kendi alan adın varsa) |
+| `none` | Yalnız yerel test |
+
+`github-oidc` bizim için doğru olan: yayın CI'dan yapılabilir, elle adım kalmaz.
+
+### İsim alanı
+
+`io.github.<kullanıcı>/<ad>` — GitHub hesabıyla kanıtlanıyor. Bizimki:
+**`io.github.slymnysr/sift`**
+
+Alan adı isim alanı (`com.example/...`) DNS TXT kaydı ya da HTTPS uç noktası
+istiyor; bizim alan adımız yok, GitHub isim alanı yeterli.
+
+### PyPI sahiplik doğrulaması — kritik
+
+Kayıt defteri, PyPI paketinin **README'sinde** (PyPI'da açıklama olarak
+görünen metin) şu dizeyi arıyor:
+
+```
+mcp-name: io.github.slymnysr/sift
+```
+
+HTML yorumu içinde gizlenebilir:
+
+```markdown
+<!-- mcp-name: io.github.slymnysr/sift -->
+```
+
+**Sonucu:** README paketin içinde yayınlandığı için, bu işaret olmadan
+yayınlanmış bir sürüm doğrulanamaz. **1.0.0'da yok → yeni sürüm şart.**
+
+> Not: crates.io HTML yorumlarını siliyor, orada görünür metin gerekiyor.
+> PyPI ve NuGet yorumu koruyor. Bizde sorun yok.
+
+### Diğer kısıtlar
+
+- Yalnız güvenilen kayıtlar: PyPI için **yalnız `pypi.org`**
+- `_meta` içinde yalnız `io.modelcontextprotocol.registry/publisher-provided`
+  anahtarı korunuyor, 4 KB sınırı
+- Şema: `https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json`
+
+---
+
+## 2. Üçüncü taraf dizinler
+
+Dördü de ayrı gönderim ister; çoğu ekosistemi **tarıyor** ve sonradan sahiplik
+talep etmene izin veriyor.
+
+| dizin | ölçek | gönderim |
+|---|---|---|
+| **Glama** (`glama.ai/mcp`) | ~37.000 sunucu (2026 ortası) | Form, elle inceleme. Metakayıt — Anthropic, GitHub, PulseMCP, Microsoft besliyor |
+| **mcp.so** | ~20.000 sunucu | Sitedeki Submit ya da GitHub issue |
+| **Smithery** (`smithery.ai`) | 7.000+ | "MCP'nin Docker Hub'ı"; yerel CLI kurulumu ya da barındırılan uzak sunucu |
+| **PulseMCP** | — | Gezinti çubuğunda Submit. **Haftalık ziyaretçi sayısı gösteriyor** — tek yerde bulunan bir veri |
+
+PulseMCP'nin ziyaretçi sayacı bizim için ayrıca değerli: tanıtımın işe yarayıp
+yaramadığını ölçebileceğimiz nadir bir dış gösterge.
+
+---
+
+## 3. awesome-mcp-servers
+
+`punkpeye/awesome-mcp-servers` — GitHub'da PR ile eklenir.
+
+**Şartlar:** README, açık bir açıklama, çalışan kurulum talimatı. Üçü de bizde
+var (kurulum talimatı 28. fazda düzeltildi).
+
+---
+
+## 4. Henüz araştırılmamış / açık sorular
+
+- **Reddit `r/ClaudeAI`, `r/mcp`** — norm ne, kendi projesini paylaşmak hoş
+  karşılanıyor mu, hangi biçimde
+- **Hacker News** — "Show HN" eşiği; erken paylaşım bir kez yakılan bir kart
+- **dev.to / Medium yazısı** — ölçüm tablosu iyi bir yazı konusu olabilir:
+  "aynı işi sift'li ve sift'siz ölçtük"
+- **MCP istemcileri** — Claude Code dışında hangi istemciler kayıt defterinden
+  okuyor (Cursor, Windsurf, Zed, Cline?) ve ayrı gönderim istiyorlar mı
+- **GitHub Release** sayfasının keşfedilebilirliğe etkisi
+- **PyPI sayfasının okunamaması** — `pypi.org/project/sift-cli/` JavaScript
+  hatası veriyor, bir asistan çekmeye çalışınca boş dönüyor. README ham hâli
+  çalışıyor. Bu, PyPI açıklamasının bir asistan için işe yaramadığı anlamına
+  gelebilir — doğrulanmalı
+
+---
+
+## 5. Ölçüm — bugünün taban çizgisi
+
+| gösterge | 9 Eylül 2026 |
+|---|---|
+| GitHub yıldız | 0 |
+| GitHub topics | 0 |
+| PyPI sürüm | 1.0.0 |
+| PyPI indirme | (ölçülmedi) |
+| Kayıt defteri | kayıtlı değil |
+| Dizin | 0/4 |
+
+Sonraki ölçümler buraya eklenecek.
+
+---
+
+## Kaynaklar
+
+- [Introducing the MCP Registry — MCP Blog](https://blog.modelcontextprotocol.io/posts/2025-09-08-mcp-registry-preview/)
+- [modelcontextprotocol/registry (GitHub)](https://github.com/modelcontextprotocol/registry)
+- [MCP Registry — Package Types](https://modelcontextprotocol.io/registry/package-types)
+- [Official Registry server.json Requirements](https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/server-json/official-registry-requirements.md)
+- [How to list your MCP server — Tallyfy](https://tallyfy.com/how-to-list-mcp-server-registry-smithery-glama-pulsemcp/)
+- [Best MCP Registries in 2026 — TrueFoundry](https://www.truefoundry.com/blog/best-mcp-registries)
+- [MCP Server Directories — DYNO Mapper](https://dynomapper.com/blog/ai/mcp-server-directories/)

sift_cli-1.0.1/tanitim/T1-SURUM-1-0-1.md

@@ -0,0 +1,50 @@
+# T1 — Sürüm 1.0.1
+
+**Tarih:** 9 Eylül 2026
+**Durum:** bitti
+
+## Neden bir sürüm daha
+
+İki ayrı iş aynı yayına bindi.
+
+**Birincisi kayıt defteri.** `registry.modelcontextprotocol.io`, PyPI
+sahipliğini paketin **açıklamasından** doğruluyor: yayınlanmış sürümün
+`long_description`'ında `mcp-name: io.github.slymnysr/sift` dizesi geçmek
+zorunda. 1.0.0'da geçmiyordu. README GitHub'da anında değişir ama PyPI'daki
+açıklama sürümün içinde donmuştur — yani T2 yeni bir sürüm olmadan yapılamazdı.
+
+**İkincisi 28. fazdan kalan borç.** `sift-mcp`, `mcp` eklentisi olmadan
+çalıştırıldığında kullanıcıya `pip install "sift-cli[mcp]"` diyordu. O komut
+Debian, Ubuntu ve WSL'de PEP 668 gereği reddediliyor. README düzeltilmişti;
+mesaj paketin içinde ships ettiği için kodda bekliyordu.
+
+## Yapılan
+
+| dosya | değişiklik |
+|---|---|
+| `README.md` | Başlığın altına `<!-- mcp-name: io.github.slymnysr/sift -->` |
+| `src/sift/server.py` | `pip install` → `uv tool install`, altına `pip`in neden reddedildiği |
+| `test/test_server.py` | Aynı dizgeyi arayan iddia; ayrıca "çalışmayan komut verilmemeli" kontrolü |
+| `test/mutations.py` | Aynı dizgeyi çapa olarak kullanan mutasyon |
+| `pyproject.toml`, `src/sift/__init__.py` | 1.0.0 → 1.0.1 |
+
+Beşi de aynı cümleye bağlıydı; `test_package.py` zaten sürümün iki yerde
+uyuşmasını istiyor, o yüzden `__init__.py`'yi unutmak testte anında yakalandı.
+
+## İşaret gerçekten pakete girdi mi
+
+Yorum satırı olduğu için gözle görünmüyor; bu yüzden yayından önce paketin
+kendisinden okundu:
+
+```
+sdist  PKG-INFO  Description-Content-Type: text/markdown
+sdist  isaret var mi: True        version: 1.0.1
+wheel  isaret var mi: True        version: 1.0.1
+```
+
+PyPI açıklaması bu `Description` alanından üretiliyor. crates.io HTML yorumlarını
+siliyor, PyPI korumuyor — bizde sorun yok.
+
+## Bitti sayılır
+
+Plandaki ölçüt: *PyPI'daki 1.0.1 açıklamasında `mcp-name` dizesi görünüyor.*

{sift_cli-1.0.0 → sift_cli-1.0.1}/test/mutations.py

@@ -813,7 +813,7 @@ MUTATIONS = [
     Mutation(
         "server.py",
         "a missing extra is answered with the command that fixes it",
-        '        \'    pip install "sift-cli[mcp]"\\n\'',
+        '        \'    uv tool install "sift-cli[mcp]"\\n\'',
         '        "\\n"',
     ),
     Mutation(

{sift_cli-1.0.0 → sift_cli-1.0.1}/test/test_server.py

@@ -262,7 +262,8 @@ def test_and_the_test_above_would_have_noticed():
     finished = _without_mcp("import sift.server\n")
 
     assert finished.returncode != 0
-    assert 'pip install "sift-cli[mcp]"' in finished.stderr
+    assert 'uv tool install "sift-cli[mcp]"' in finished.stderr
+    assert "Plain `pip` is refused" in finished.stderr, "calismayan komut verilmemeli"
     assert "Traceback" not in finished.stderr
     assert "`sift`) is already installed" in finished.stderr