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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sift-cli
-Version: 1.0.0
+Version: 1.0.2
 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
@@ -180,6 +182,7 @@ sift outline PATH         what a file declares, without its bodies
 sift digest PATH...       what is in files somebody else produced
 sift peek HANDLE|PATH [FIRST] [LAST]
 sift hook                 answer one shell-command event on stdin
+sift mcp                  speak the protocol on stdin, for a client
 sift tools                which dense tools this machine has
 sift tool NAME [ARGS...]  run one of them, distilled
 sift memory [TERM]        what has been run here before, and how it went
@@ -243,16 +246,25 @@ 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.
 
-Any client that speaks stdio will do — the command is `sift-mcp`. It offers
+Any client that speaks stdio will do. The command is `sift-mcp`, and `sift mcp`
+starts the same server — one word for a client that would rather run the package
+by its own name (`uvx --from "sift-cli[mcp]" sift-cli mcp`, which is what the MCP
+registry entry says). It offers
 `run`, `follow`, `outline`, `digest`, `digest_many`, `tool` and `peek`. `list`
 and `stats` are deliberately not offered: they would hand a model every command lately run on this machine,
 including the ones it never asked about, and the person at a terminal already
@@ -265,10 +277,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.2}/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
@@ -160,6 +162,7 @@ sift outline PATH         what a file declares, without its bodies
 sift digest PATH...       what is in files somebody else produced
 sift peek HANDLE|PATH [FIRST] [LAST]
 sift hook                 answer one shell-command event on stdin
+sift mcp                  speak the protocol on stdin, for a client
 sift tools                which dense tools this machine has
 sift tool NAME [ARGS...]  run one of them, distilled
 sift memory [TERM]        what has been run here before, and how it went
@@ -223,16 +226,25 @@ 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.
 
-Any client that speaks stdio will do — the command is `sift-mcp`. It offers
+Any client that speaks stdio will do. The command is `sift-mcp`, and `sift mcp`
+starts the same server — one word for a client that would rather run the package
+by its own name (`uvx --from "sift-cli[mcp]" sift-cli mcp`, which is what the MCP
+registry entry says). It offers
 `run`, `follow`, `outline`, `digest`, `digest_many`, `tool` and `peek`. `list`
 and `stats` are deliberately not offered: they would hand a model every command lately run on this machine,
 including the ones it never asked about, and the person at a terminal already
@@ -245,10 +257,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.2}/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.2/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.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sift-cli"
-version = "1.0.0"
+version = "1.0.2"
 description = "Runs your command, then gives the model only the lines that matter."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -30,6 +30,9 @@ mcp = ["mcp>=2"]
 [project.scripts]
 sift = "sift.cli:main"
 sift-mcp = "sift.server:main"
+# The package name, spelled as a command, because that is the only name a
+# registry entry can carry: `uvx <package>` is how a client starts one.
+sift-cli = "sift.cli:main"
 
 [project.urls]
 Homepage = "https://github.com/slymnysr/sift"

{sift_cli-1.0.0 → sift_cli-1.0.2}/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.2"

{sift_cli-1.0.0 → sift_cli-1.0.2}/src/sift/cli.py

@@ -73,6 +73,7 @@ USAGE = """sift -- run a command, keep every byte, show the lines that matter
   sift hook                           answer one shell-command event on stdin
   sift hook --install [--yes]         route the client's own shell here too
   sift hook --uninstall               and take it back out
+  sift mcp                            speak the protocol on stdin, for a client
   sift tools                          which dense tools this machine has
   sift tool NAME [ARGS...]            run one of them, distilled
   sift memory [TERM] [--here]
@@ -161,6 +162,8 @@ def main(argv: list[str] | None = None) -> int:
         return _list(rest)
     if word == "hook":
         return _hook(rest)
+    if word == "mcp":
+        return _mcp(rest)
     if word == "tools":
         return _tools()
     if word == "tool":
@@ -573,6 +576,29 @@ def _hook(args: list[str]) -> int:
     return 0
 
 
+def _mcp(args: list[str]) -> int:
+    """Speak the protocol on stdin -- the same server `sift-mcp` starts.
+
+    Two names for one server looks like waste until you try to write down how a
+    stranger's client should start it. What a registry entry can name is the
+    package, and the package is `sift-cli`; what `uvx` runs is a command of that
+    same name. So `uvx --from "sift-cli[mcp]" sift-cli mcp` is a line anyone can
+    build from the entry alone, and it needs this word to exist.
+
+    The import is here rather than at the top because the whole point of the
+    extra is that the command line works without it. Somebody who never
+    installed `mcp` gets the sentence `sift.server` raises, not a traceback.
+    """
+    if args:
+        print(f"sift: mcp takes no arguments\n\n{USAGE}", file=sys.stderr)
+        return 2
+
+    from sift.server import main as serve
+
+    serve()
+    return 0
+
+
 def _tools() -> int:
     """What each of them replaces, and whether this machine has it.
 

{sift_cli-1.0.0 → sift_cli-1.0.2}/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.2/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.2/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/)