@kahinmcp/kahin 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,85 @@
+# Changelog
+
+Tüm önemli değişiklikler bu dosyada tutulur. Format: [Keep a Changelog](https://keepachangelog.com/tr/1.1.0/) — [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.3.0] — 2026-08-03
+
+### Eklenen
+- **7 yeni tool (toplam 104)**:
+  - **Iframe erişimi**: 12 DOM tool'una opsiyonel `frame_id` parametresi — `Runtime.callFunction` ile hedef frame'in `executionContextId`'si üstünde evaluate; `Runtime.executionContextCreated/Destroyed/Cleared` event'lerinden frame→context map (Mirage reader loop'ta)
+  - **Dosya yükleme (2)**: `kahin_mirage_set_file_chooser_intercept`, `kahin_mirage_upload_files` — `Page.setInterceptFileChooserDialog` + `fileChooserOpened` bekleme + `Page.setFileInputFiles` (absolute path zorunlu, multi-file, timeout)
+  - **Canlı screencast (4)**: `kahin_mirage_screencast_start/frame/stop/pending` — `Page.startScreencast` (base64-JPEG frame'ler), her frame için zorunlu `screencastFrameAck` (kMaxFramesInFlight=1), FIFO frame queue, stop'ta temizlik
+  - **Erişilebilirlik (1)**: `kahin_mirage_accessibility_tree` — `Accessibility.getFullAXTree` (Camoufox-only; upstream Playwright'da yok, CDP'de de yok)
+- **Gerçek HTTP e2e** (`tests/test_e2e_network.py`): network_requests, get_response_body, interception continue/abort — localhost stdlib server ile, dış ağ yok
+- **Iframe e2e** (`tests/test_e2e_iframe.py`): frame tree, iframe içi query/click/type — 4 PASS
+- **Upload e2e** (`tests/test_e2e_upload.py`): single/multi dosya byte-exact, timeout, absolute path zorunluluğu — 4 PASS
+- **Screencast e2e** (`tests/test_e2e_screencast.py`): start/clamp, JPEG magic + ack stream, pending queue, stop temizliği — 4 PASS
+- **A11y e2e** (`tests/test_e2e_accessibility.py`): role/name/placeholder yansıması, nodeCount/truncated — 4 PASS
+
+### Değişen
+- Sidecar router: `Accessibility.*` page session kuralına eklendi (önceden root'a düşüyordu → `-32000 "Handler for ... does not implement"`); 196 Zig test
+- `Network.enable`'in Juggler'da OLMADIĞI doğrulandı (event'ler default) — network tool'ları gerçek HTTP'te as-is çalışıyor, bug yok
+- data: URL network skip testi kaldırıldı (yerini gerçek HTTP e2e aldı)
+
+### Düzeltilen
+- `Accessibility.getFullAXTree` route bug'ı (page session'a yönlendirme)
+
+## [0.2.0] — 2026-08-03
+
+### Eklenen
+- **65 yeni Juggler-native MCP tool** (toplam 97) — motor ayırımlı kategori dosyaları (`kahin/tools/`):
+  - DOM (12): `kahin_mirage_query`, `kahin_mirage_query_all`, `kahin_mirage_click`, `kahin_mirage_type`, `kahin_mirage_get_text`, `kahin_mirage_get_attribute`, `kahin_mirage_set_attribute`, `kahin_mirage_focus`, `kahin_mirage_hover`, `kahin_mirage_get_html`, `kahin_mirage_wait_selector`, `kahin_mirage_get_value`
+  - Input (7): mouse_click, mouse_move, mouse_down, mouse_up, key_press, key_text, scroll
+  - PageEx (6): reload, go_back, go_forward, stop, frame_tree, page_content
+  - Tab/Session (6): tab_new, tab_switch, tab_close, tab_list, tab_bring_front, context_new
+  - Network/Console (10): network_requests, get_response_body, intercept_requests, unintercept_requests, network_continue, network_abort, cache_disable, clear_cache, console_log, errors_list
+  - Storage (6): cookie_get, cookie_set, cookie_clear, storage_local_get, storage_local_set, storage_session_get
+  - Emulation (10): set_user_agent, set_viewport, set_device_scale_factor, set_media, set_touch, set_color_scheme, set_reduced_motion, set_locale, set_timezone, set_geolocation
+  - Dialog/Download/Worker/WS (7): dialog_list, dialog_accept, dialog_dismiss, download_list, download_save, worker_list, websocket_list
+  - Engine (1): `kahin_engine_health`
+- **Phantom liveness sistemi**: `is_alive`/`on_death`, boot'ta `Browser.health` doğrulaması, ölü engine otomatik eviction + state temizliği
+- `Mirage.call(method, params, session_id)` API'si — session yönetimi (`create_page/close_page/switch_page/list_pages`)
+- `tests/test_phantom.py`, `tests/test_e2e_mirage.py` (gerçek Camoufox e2e: DOM, tab, cookie, dialog, kill, localStorage, emulation)
+- pytest-asyncio dev-dep
+
+### Değişen
+- Sidecar wire Juggler-native: `{"id","method","params","sessionId?"}` — CDP-şekilli `domain/command` katmanı kaldırıldı
+- No-op `Network.enable`/`Console.enable` handler'ları silindi; event adları verbatim forward
+- `Network.getResponseBody` → `{base64body, evicted?}`; `Page.dispatchKeyEvent` zorunlu `repeat:bool`
+- Screenshot: gerçek viewport ölçümü + `full_page` full-content clip
+- Result-less Juggler reply'ları (`{"id":N}`) artık boş `result` olarak kabul ediliyor
+- `Page.reload` frameId ile gönderiliyor; frame tree `d.getFrameTree` (gerçek iç içe hiyerarşi)
+- oracle.py bootstrap-only — tool tanımları `kahin/tools/` kategori modüllerinde
+- Versiyonlar senkronize: package.json / pyproject.toml / `kahin.__version__`
+
+### Düzeltilen
+- `@intCast(id)` trap riski (negatif/oversize id → `-32600`)
+- `newPage`/`screenshot` hata yutma — artık gerçek hata yanıtı
+- devicePixelRatio override: `Page.setViewportSize` yerine `Browser.setDefaultViewport`
+- `engine._proc` → `_process` (shadow health pid artık gerçek)
+- Sidecar process HUP'ta temiz exit
+
+## [0.1.8] — 2026-08-02
+
+### Değişen
+- npm paketi GitLab'a taşındı + GitLab CI publish eklendi (`scripts/npm-publish.sh`, `.gitlab-ci.yml`)
+- Versiyon farkı kontrolüyle otomatik yayın
+
+## [0.1.7] — 2026-08-01
+
+### Eklenen
+- GitHub auto-publish workflow (`.github/workflows/publish.yml`)
+- One-command install: 22 AI CLI istemcisini otomatik tespit + MCP kaydı
+
+## [0.1.0–0.1.6] — 2026-08-01
+
+### Eklenen
+- Global npm launcher + auto-setup
+- Shadow engine: gerçek Obscura binary (auto-install cascade)
+- Mirage engine: gerçek Camoufox via Zig sidecar IPC (Faz 5)
+- Zig Juggler harness: pipe transport, Browser/Page/Runtime/Network/Input/Emulation adapters, interception, process manager, perf + crash-recovery
+- CDP ansiklopedisi: 56 domain, 667 komut, 237 event, 609 type (Chrome 148)
+
+[0.2.0]: https://gitlab.com/void0x14/kahin-mcp/-/compare/v0.1.8...v0.2.0
+[0.1.8]: https://gitlab.com/void0x14/kahin-mcp/-/compare/v0.1.7...v0.1.8
+[0.1.7]: https://gitlab.com/void0x14/kahin-mcp/-/compare/v0.1.6...v0.1.7

package/README.md

@@ -16,16 +16,23 @@ AI modeller Chrome'un içine girip sayfa gezip kod çalıştırabilir ama CDP'yi
 
 56 domain, 667 komut, 237 event, 609 type — Chrome 148 protokolü gömülü.
 
-## 32 Tool · 6 Kategori
+## 104 Tool · 4 Kategori Ailesi · 2 Engine
+
+Tool'lar engine-ayrımlı kategori dosyalarında (`kahin/tools/`): paylaşılan çekirdek + Obscura + Camoufox aileleri.
 
 | Kategori | Ne işe yarar | Tool sayısı |
 |----------|-------------|-------------|
-| 🧠 CDP Bilgi | Domain/komut/event/type sorgulama, semantik arama | 7 |
-| ✅ Doğrulama | Komut doğrulama, typo tespiti, hata çözümleme | 3 |
-| 🚀 Browser Kontrol | Chrome başlat/durdur, gezin, tıkla, kod çalıştır, ekran görüntüsü | 9 |
-| 🔗 Session | Yeni sayfa aç/kapat, session listele | 4 |
-| 🔍 Debug | CDP event geçmişi, network istekleri, console mesajları | 4 |
-| 📈 Pattern DB | Kullanım desenlerini öğren, sorgula, öner | 5 |
+|  GRIMOIRE — CDP Bilgi | Domain/komut/event/type sorgulama, semantik arama | 7 |
+|  SERAPH — Doğrulama | Komut doğrulama, typo tespiti, hata çözümleme | 3 |
+|  PILOT — Browser Kontrol | Chrome başlat/durdur, gezin, tıkla, kod çalıştır, ekran görüntüsü | 8 |
+|  TRAINMAN — Session | Yeni sayfa aç/kapat, session listele | 4 |
+|  DEJA_VU — Debug | CDP event geçmişi, network istekleri, console mesajları | 4 |
+|  PROPHECY — Pattern DB | Kullanım desenlerini öğren, sorgula, öner | 5 |
+|  HEALER | Hata istatistikleri | 1 |
+|  MIRAGE — Camoufox Native (72) | Juggler protokolü üstünde DOM, Input, PageEx, Tab, Network, Storage, Emulation, Dialog/Download/Worker/WS, Upload, Screencast, Accessibility, Engine sağlığı | 72 |
+|  OBSCURA — Ayrı kategori | Obscura'ya özel tool'lar (hazırlanıyor) | 0 |
+
+**Toplam: 104 tool.**
 
 ## Bir satırda özet
 
@@ -38,7 +45,7 @@ Zorunlu: Python 3.12+ · Chrome/Chromium · Node.js 18+ (npm launcher için)
 ### Otomatik kurulum — tek komut
 
 ```bash
-pnpm add -g kahin
+pnpm add -g @kahinmcp/kahin
 ```
 
 Bu kadar. Kurulum sonrası Kahin, sistemindeki AI CLI araçlarını otomatik tespit eder ve kendini kaydeder:
@@ -80,6 +87,20 @@ Gerisini AI halleder. Ama dilersen tool'ları direkt de çağırabilirsin:
 → kahin_error_decode(error_code=-32601) → hatayı çözümler
 ```
 
+Camoufox (Juggler native) ile, engine `mirage` seçilince:
+
+```
+→ kahin_browser_start(engine="mirage")
+→ kahin_mirage_query("#input") → kahin_mirage_type("merhaba")
+→ kahin_mirage_click("#btn") → kahin_mirage_get_text("#result")
+→ kahin_mirage_query("#btn", frame_id="subframe-...")   # iframe içi erişim
+→ kahin_mirage_cookie_set/get/clear → kahin_mirage_storage_local_get
+→ kahin_mirage_set_user_agent / set_viewport / set_geolocation
+→ kahin_mirage_set_file_chooser_intercept(true) → kahin_mirage_upload_files(["/abs/path"])
+→ kahin_mirage_screencast_start → kahin_mirage_screencast_frame (base64 JPEG)
+→ kahin_mirage_accessibility_tree → kahin_engine_health
+```
+
 Tam liste için: [AGENTS.md](AGENTS.md)
 
 ## Proje Felsefesi
@@ -91,7 +112,7 @@ Tam liste için: [AGENTS.md](AGENTS.md)
 
 ## Bağımlılıklar
 
-mcp · orjson · Levenshtein · websockets · httpx · camoufox · Pillow
+mcp · orjson · Levenshtein · websockets · httpx · camoufox · Pillow · pydantic
 
 ## Port Uyarısı
 
@@ -113,13 +134,22 @@ Kahin'de hata loglama ve kendini onarma sistemi gömülüdür:
 ## Mimari
 
 ```
-oracle.py               → MCP server (32 tool, giriş kapısı)
-  _healer.py             → Hata yönetimi, loglama, kendini onarma
-  the_source/architect   → CDP şema motoru (56 domain, 667 komut)
-  the_twins/shadow       → Obscura engine (gerçek Obscura binary, WebSocket CDP)
-  the_twins/mirage       → Mirage engine (stealth, anti-detection)
-  the_twins/chassis      → Ortak engine arayüzü (abstract)
-  residual_self/fate     → Pattern DB (öğrenme, sorgulama, önerme)
+oracle.py               → MCP server (bootstrap: mcp instance + engine lifecycle + main)
+  tools/                → 104 tool, engine-ayrımlı kategori dosyaları
+    _common.py          → _safe_cdp, _require_engine, _auto_learn
+    grimoire/seraph/prophecy/healer → CDP bilgi + doğrulama + pattern (paylaşılan)
+    pilot/trainman/dejavu           → browser/session/debug (paylaşılan)
+    pilot_mirage/trainman_mirage/dejavu_mirage → Camoufox DOM+Input+PageEx / Tab / Network+Console
+    storage_mirage/emulation_mirage/dialog_mirage → Storage / Emulation / Dialog+Download+Worker+WS
+    pilot_obscura/trainman_obscura/dejavu_obscura → Obscura ayrı kategoriler (hazırlanıyor)
+    engine.py           → engine_health
+  _healer.py            → Hata yönetimi, loglama, kendini onarma
+  the_source/architect  → CDP şema motoru (56 domain, 667 komut)
+  the_twins/shadow      → Obscura engine (gerçek Obscura binary, WebSocket CDP)
+  the_twins/mirage      → Mirage engine (Zig sidecar, Juggler native pipe, stealth)
+  the_twins/chassis     → Ortak engine arayüzü (abstract: call/is_alive/on_death)
+  residual_self/fate    → Pattern DB (öğrenme, sorgulama, önerme)
+camoufox-harness/       → Zig sidecar (Juggler protocol, vendor binary gömülü)
 ```
 
 ---
@@ -130,15 +160,16 @@ oracle.py               → MCP server (32 tool, giriş kapısı)
 - [x] **Camoufox entegrasyonu tamamlandı** — gerçek Camoufox (Zig sidecar + Juggler pipe) ile native çalışıyor; engine seçimi ajan tarafından `shadow`/`mirage` parametresiyle yapılıyor
 - [x] **Obscura entegrasyonu tamamlandı** — gerçek Obscura binary'si (WebSocket CDP) ile çalışıyor, startup problemleri giderildi
 - [ ] **SKILLS** destekleri ve konfigre edilebilir kişsiel hazır skills oluşturma özelliği
-- [x] **Tek tık kurulum** — `pnpm add -g kahin`, sonra `kahin` (ilk çalıştırmada Python ortamını otomatik kurar)
+- [x] **Tek tık kurulum** — `pnpm add -g @kahinmcp/kahin`, sonra `kahin` (ilk çalıştırmada Python ortamını otomatik kurar)
 - [ ] **Zero-dependency** hedefi (Go/Rust portu)
 - [ ] **LSP modu** — kod içinde hata yakalama, AI'a yanlışını yüzüne vurma
-- [ ] **Tool sayısı 50+** — eksik CDP domain tool'ları
+- [x] **Tool sayısı 104** — Camoufox Juggler-native 72 tool (DOM, Input, Network, Storage, Emulation, Dialog, Tab, Worker/WS, Upload, Screencast, Accessibility) + paylaşılan 32 çekirdek
+- [ ] **Obscura ayrı tool'ları** — CDP-yeteneklerine özel pilot_obscura/trainman_obscura/dejavu_obscura kategorilerini doldur
 
 - [ ] **Gerçek zamanlı izleme** — AI'ın Kahin'i nasıl kullandığını canlı gör
 - [ ] **Web dashboard** — tool çağrıları, hata oranları, trendler
 - [ ] **MCP Ekosistemi** — üçüncü taraf MCP'lere proxy/entegrasyon
-- [x] **CLI aracı** — `kahin` komutu ile hızlı sorgulama (npm launcher, `pnpm add -g kahin`)
+- [x] **CLI aracı** — `kahin` komutu ile hızlı sorgulama (npm launcher, `pnpm add -g @kahinmcp/kahin`)
 - [ ] **Pasif tarama** — arka planda CDP event'lerini izle, değişiklik olunca bildir
 - [ ] **Dokümantasyon sitesi** — kapsamlı kullanım kılavuzu
 
@@ -154,7 +185,7 @@ oracle.py               → MCP server (32 tool, giriş kapısı)
 ## Geliştirme
 
 ```bash
-.venv/bin/pytest tests/          # 66 test, 0 failed
-.venv/bin/ruff check kahin/      # lint
-.venv/bin/python -m kahin.oracle # manuel başlatma
+uv run pytest tests/          # 84 test (83 pass, 1 skip)
+uv run ruff check kahin/      # lint
+uv run python -m kahin.oracle # manuel başlatma
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kahinmcp/kahin",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Kahin — CDP ansiklopedisi + anti-detect browser otomasyon MCP sunucusu. Kurulumda 22 AI CLI aracını otomatik tespit edip kendini kaydeder. Obscura ve Camoufox motorlarını kullanır, motor seçimini ajana bırakır.",
   "bin": {
     "kahin": "bin/kahin.mjs"
@@ -11,7 +11,8 @@
   },
   "files": [
     "bin",
-    "LICENSE"
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=18"