@bcelep/capint 0.4.2 → 0.7.0

package/docs/capint-rehber.md

@@ -0,0 +1,439 @@
+# CapInt ve Yan Eklentiler — Nedir, Ne İşe Yarar, Nasıl Kurulur
+
+> Bu rehber teknik olmayan bir geliştirici için yazıldı.  
+> Amaç: **CapInt**, **agentmemory** (hafıza) ve **graphify** (harita) ne, neden var, nasıl takılır — net cevap.
+
+**İlgili:** [capint-stack.md](capint-stack.md) · [kullanim-kilavuzu.md](kullanim-kilavuzu.md)
+
+---
+
+## İçindekiler
+
+1. [Büyük resim](#1-büyük-resim)
+2. [CapInt nedir?](#2-capint-nedir)
+3. [CapInt ne işe yarar?](#3-capint-ne-işe-yarar)
+4. [CapInt nasıl kurulur?](#4-capint-nasıl-kurulur)
+5. [CapInt günlük nasıl kullanılır?](#5-capint-günlük-nasıl-kullanılır)
+6. [agentmemory — hafıza eklentisi](#6-agentmemory--hafıza-eklentisi)
+7. [graphify — kod haritası eklentisi](#7-graphify--kod-haritası-eklentisi)
+8. [Üçü birlikte nasıl çalışır?](#8-üçü-birlikte-nasıl-çalışır)
+9. [Yeni proje kontrol listesi](#9-yeni-proje-kontrol-listesi)
+10. [Ne zaman neyi yenilersin?](#10-ne-zaman-neyi-yenilersin)
+11. [Sık sorulan sorular](#11-sık-sorulan-sorular)
+12. [Basit sorun giderme](#12-basit-sorun-giderme)
+
+---
+
+## 1. Büyük resim
+
+Cursor'daki yapay zekâ güçlü ama **her oturumda sıfırdan başlıyormuş gibi** davranabilir. CapInt bunu düzeltmeye çalışır.
+
+Üç parça var:
+
+| Parça | Tek cümle | Kurulum |
+|-------|-----------|---------|
+| **CapInt** | Projeye "AI nasıl çalışsın" kurallarını koyar | **Her proje** için bir kez |
+| **agentmemory** | Geçmiş konuşmaları hatırlatır | **Bilgisayarda** bir kez |
+| **graphify** | Projenin dosya haritasını çıkarır | Program bir kez, **harita her proje** için bir kez |
+
+**CapInt tek başına yeterli mi?**  
+Evet — günlük geliştirme için CapInt + proje notları (`HANDOFF`, `DONE`) çoğu işi görür.
+
+**agentmemory + graphify şart mı?**  
+Hayır. Ama eklediğinde AI daha az "unutkan" olur ve projeyi daha iyi tanır.
+
+---
+
+## 2. CapInt nedir?
+
+CapInt bir **uygulama değil**. npm paketi olarak gelen, projene kopyalanan **kural ve rehber seti**.
+
+Kurduğunda projene şunlar gelir:
+
+| Dosya / klasör | Ne işe yarar |
+|----------------|--------------|
+| `GUNLUK.md` | "Bugün chat'te nasıl konuşurum" — günlük giriş noktan |
+| `HANDOFF.md` | "Dün ne yapıyorduk, sırada ne var" |
+| `DONE.md` | "Ne bitti" — tekrar yapılmasın diye |
+| `design.md` | Projenin amacı, sınırları, kararlar |
+| `AGENT.md` | AI'ya genel davranış kuralları |
+| `workflows/` | Büyük işler için hazır sohbet akışları |
+| `skills/` | Belirli iş türleri için uzman modları |
+| `skill-routing-matrix.json` | "Bu iş hangi uzman moduna gitsin" tablosu |
+
+**CapInt kod yazmaz.** Cursor'daki AI'ya *nasıl davranacağını* söyler.
+
+---
+
+## 3. CapInt ne işe yarar?
+
+### 3.1 Oturumlar arası devamlılık
+
+AI her seferinde "projeyi ilk kez görüyorum" moduna girmesin diye `HANDOFF.md` ve `DONE.md` kullanırsın. Oturum kapanırken agent bunları günceller; yeni oturumda okur.
+
+### 3.2 İş büyüklüğüne göre davranış
+
+- Küçük iş (renk, typo, tek dosya) → direkt yap
+- Orta/büyük iş (yeni özellik, refactor) → önce kısa plan, onay, sonra kod
+
+Bunu her seferinde sen söylemek zorunda kalmazsın; CapInt kuralları bunu AI'ya öğretir.
+
+### 3.3 Büyük işlerde dağılmama
+
+Büyük işler için chat'te kullanılan hazır akışlar:
+
+| Kısayol | Ne zaman | Ne yapar |
+|---------|----------|----------|
+| `/genesis` | Sıfırdan veya büyük yeniden tasarım | Önce ne istediğini netleştirir, doküman çıkarır |
+| `/blueprint` | Tasarım belli, iş listesi lazım | Görevleri parçalar |
+| `/challenge` | Kodlamadan önce | Planı sorgular, riskleri sorar |
+| `/forge` | Uygulama | Dikkatli kodlar; bozulan şeyleri geri almaya odaklanır |
+
+Bunlar terminal komutu değil — **Cursor chat'e yazdığın kelimeler**.
+
+### 3.4 Doğru "uzman modu" seçimi
+
+"SEO audit", "güvenlik", "PR yaz" gibi işler farklı beceriler ister. CapInt hangi skill'in devreye gireceğini seçer; sen isim ezberlemezsin.
+
+---
+
+## 4. CapInt nasıl kurulur?
+
+### 4.1 Gereksinim
+
+- Node.js 18+ (bilgisayarda bir kez)
+- Cursor IDE
+- Proje klasörün (ör. `efesusstone`)
+
+### 4.2 Proje klasöründe kurulum
+
+Terminali proje kökünde aç:
+
+```powershell
+cd C:\bc-proje\senin-projen
+npx @bcelep/capint init --bundle full --stack
+```
+
+**Ne olur?**
+
+- CapInt dosyaları projene kopyalanır
+- `--stack` ile graphify için proje kuralı da hazırlanmaya çalışılır
+- Mevcut dosyaların üzerine körlemesine yazılmaz (çakışma varsa atlar)
+
+### 4.3 Kurulumdan sonra
+
+1. `GUNLUK.md` dosyasını aç — günlük kullanım buradan
+2. Cursor chat'e geç — artık asıl iş chat'te
+3. İsteğe bağlı: `capint stack doctor` ile "her şey tamam mı" bak (tek satır özet)
+
+**CapInt'i her proje için ayrı kurarsın** — çünkü kurallar ve notlar o projeye özel.
+
+---
+
+## 5. CapInt günlük nasıl kullanılır?
+
+### 5.1 Tipik bir gün
+
+1. Cursor'u aç, projeyi aç
+2. Chat'e Türkçe yaz: *"Dünkü ödeme sayfasına devam edelim"* veya *"header'daki logoyu büyüt"*
+3. Agent kısa bir özet gösterir (Intent / ne yapacağı / onay gerekip gerekmediği)
+4. Hafif işse direkt yapar; büyük işse `devam` / `plan` / `analiz` dersin
+5. Bitince: *"kapan"* veya *"HANDOFF güncelle"* — agent `DONE.md` ve `HANDOFF.md` yazar
+
+### 5.2 Terminal ne zaman?
+
+| Durum | Terminal |
+|-------|----------|
+| Günlük geliştirme | **Gerek yok** — chat yeter |
+| Yeni proje | Bir kez `capint init` |
+| "Her şey tamam mı?" | `capint stack doctor` |
+| Sorun var | `capint doctor` |
+
+### 5.3 Senin yapman gereken alışkanlıklar
+
+- Oturum sonunda HANDOFF'u güncel tut (agent'a bırakabilirsin)
+- Büyük işe `/blueprint` veya `/forge` ile gir
+- Küçük işte gereksiz süreç açma — normal konuş
+
+---
+
+## 6. agentmemory — hafıza eklentisi
+
+### 6.1 Nedir?
+
+**agentmemory**, AI'nın **geçmiş konuşmaları** hatırlamasına yardım eden ayrı bir program. CapInt'in içinde değil; bilgisayarında arka planda çalışan bir **hafıza servisi**.
+
+### 6.2 Ne işe yarar?
+
+| CapInt notları (`HANDOFF`) | agentmemory |
+|----------------------------|-------------|
+| Senin yazdığın / agent'ın özetlediği **proje notları** | **Chat geçmişi** ve oturumlar arası bağlam |
+| "Sırada ne var?" | "Geçen hafta ne konuştuk?" |
+
+İkisi birbirinin yerine geçmez; **birlikte** daha iyi olur.
+
+### 6.3 Nasıl eklenir? (bilgisayarda bir kez)
+
+**Adım 1 — Programı kur**
+
+```powershell
+npm install -g @agentmemory/agentmemory
+```
+
+Windows'ta ayrıca `iii-engine` gerekir (agentmemory'nin arka plan motoru). Kurulu değilse [agentmemory dokümantasyonuna](https://github.com/rohitg00/agentmemory) bak.
+
+**Adım 2 — Cursor'a bağla**
+
+Cursor'un MCP ayarına agentmemory eklenir. Windows'ta bazen otomatik bağlantı çalışmaz; o zaman `~/.cursor/mcp.json` içine agentmemory bloğu elle eklenir.
+
+**Adım 3 — Çalıştır**
+
+Ayrı bir terminal penceresinde (bilgisayar açıkken):
+
+```powershell
+agentmemory
+```
+
+Bu pencere açık kalsın veya arka planda servis olarak çalışsın.
+
+### 6.4 Her proje için ayrı mı?
+
+**Hayır.**
+
+- Program: bilgisayarda **bir kez**
+- Cursor bağlantısı: **bir kez**
+- Her yeni proje: agentmemory'yi **tekrar kurmazsın**
+
+Tüm projeler aynı hafıza servisini kullanır.
+
+### 6.5 Kurduktan sonra proje başına ne yaparsın?
+
+**Pratikte hiçbir şey.**  
+Cursor açık + agentmemory çalışıyorsa hafıza devreye girer. CapInt init vs. tekrar gerekmez.
+
+### 6.6 Çalışıyor mu nasıl anlarsın?
+
+- Cursor'da agent geçmişe daha iyi atıf yapıyorsa
+- veya `capint stack doctor` içinde memory satırı `ok` ise
+
+Kapalıysa: `agentmemory` terminalini tekrar aç.
+
+---
+
+## 7. graphify — kod haritası eklentisi
+
+### 7.1 Nedir?
+
+**graphify**, projenin **kod haritasını** çıkaran ayrı bir araç. "Hangi klasör ne işe yarıyor, dosyalar nasıl bağlı" sorusuna cevap üretir. CapInt'in içinde değil.
+
+### 7.2 Ne işe yarar?
+
+AI büyük projede kaybolmasın diye:
+
+- `GRAPH_REPORT.md` — okunabilir özet rapor
+- `graph.json` — yapısal harita (CapInt `.capint/graph/` altında okur)
+
+Özellikle Next.js gibi `app/`, `lib/`, `components/` yapısında "`/src` yok" projelerde faydalı.
+
+### 7.3 Nasıl eklenir?
+
+#### Bilgisayarda bir kez (program)
+
+```powershell
+uv tool install graphifyy
+graphify install cursor
+```
+
+`uv` yoksa önce Python/uv kurulumu gerekir — graphify dokümantasyonuna bak.
+
+#### Her proje için bir kez (harita)
+
+**Adım 1 — CapInt zaten kurulu olsun**
+
+```powershell
+capint init --bundle full --stack
+```
+
+(`--stack` proje içinde graphify Cursor kuralını eklemeye çalışır.)
+
+**Adım 2 — Cursor chat'te haritayı çıkar**
+
+Proje yapına göre. Örnekler:
+
+- Klasik proje (`src/` var):
+
+  ```
+  /graphify ./src
+  ```
+
+- Next.js (src yok):
+
+  ```
+  /graphify ./app ./lib ./components
+  ```
+
+Hangi klasörler? Terminalde:
+
+```powershell
+capint stack graph paths
+```
+
+**Adım 3 — Haritayı CapInt yoluna kopyala**
+
+graphify çıktıyı `graphify-out/` klasörüne yazar. CapInt'in okuması için:
+
+```powershell
+capint stack graph sync
+```
+
+Bu komut şunları oluşturur/günceller:
+
+- `GRAPH_REPORT.md` (proje kökü)
+- `.capint/graph/graph.json`
+
+### 7.4 Her proje için ayrı mı?
+
+| Ne | Sıklık |
+|----|--------|
+| graphify programı | Bilgisayarda **bir kez** |
+| Cursor genel kuralı | **Bir kez** |
+| Proje içi graphify kuralı | **Her proje** (`init --stack` veya `graphify install cursor --project`) |
+| **Haritanın kendisi** | **Her proje bir kez** (+ büyük değişiklikte yenile) |
+
+### 7.5 Ne zaman haritayı yenilersin?
+
+- Yeni büyük modül ekledin
+- Klasör yapısını değiştirdin
+- AI sürekli yanlış dosyaya gidiyorsa
+
+Her gün değil — **proje şekli değişince**.
+
+Chat'te güncelleme:
+
+```
+/graphify ./app ./lib ./components --update
+```
+
+Sonra yine:
+
+```powershell
+capint stack graph sync
+```
+
+---
+
+## 8. Üçü birlikte nasıl çalışır?
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  SEN — Cursor chat (Türkçe, doğal dil)                  │
+└───────────────────────────┬─────────────────────────────┘
+                            │
+        ┌───────────────────┼───────────────────┐
+        ▼                   ▼                   ▼
+   ┌─────────┐        ┌───────────┐       ┌────────────┐
+   │ CapInt  │        │ graphify  │       │ agentmemory│
+   │ kurallar│        │ kod haritas│      │ chat hafızası│
+   │ HANDOFF │        │ graph.json │      │ (arka plan) │
+   │ workflows│       └───────────┘       └────────────┘
+   └─────────┘
+        │
+        ▼
+   AI: doğru mod, plan, devamlılık, proje bilgisi
+```
+
+| Soru | Cevap veren |
+|------|-------------|
+| Nasıl davranayım? | CapInt (`AGENT`, `GUNLUK`, workflows) |
+| Sırada ne var? | `HANDOFF.md`, `DONE.md` |
+| Proje dosyaları nerede? | graphify haritası |
+| Geçen konuşmada ne dedik? | agentmemory |
+
+---
+
+## 9. Yeni proje kontrol listesi
+
+### Bilgisayarda (bir kez — zaten yaptıysan atla)
+
+- [ ] Node.js kurulu
+- [ ] `npm install -g @agentmemory/agentmemory` + Cursor MCP
+- [ ] `uv tool install graphifyy` + `graphify install cursor`
+- [ ] agentmemory arka planda çalışıyor
+
+### Her yeni proje
+
+- [ ] `cd proje-klasörü`
+- [ ] `npx @bcelep/capint init --bundle full --stack`
+- [ ] `GUNLUK.md` oku
+- [ ] Cursor chat: `/graphify …` (doğru klasörlerle)
+- [ ] `capint stack graph sync`
+- [ ] `capint stack doctor` — dört katman yeşil mi bak
+- [ ] Normal geliştirmeye chat ile devam
+
+---
+
+## 10. Ne zaman neyi yenilersin?
+
+| Parça | Ne zaman |
+|-------|----------|
+| CapInt paketi | Yeni sürüm çıktığında (`capint upgrade` — nadiren) |
+| HANDOFF / DONE | **Her oturum sonu** |
+| agentmemory | Bilgisayar restart sonrası servisi tekrar aç |
+| graphify haritası | Proje yapısı ciddi değişince |
+| CapInt init | **Sadece yeni proje** — mevcut projede tekrar init genelde gerekmez |
+
+---
+
+## 11. Sık sorulan sorular
+
+### CapInt olmadan Cursor kullanamaz mıyım?
+
+Kullanırsın. CapInt sadece **düzen ve devamlılık** ekler.
+
+### agentmemory olmadan CapInt işe yarar mı?
+
+Evet. HANDOFF/DONE ile devam edersin; agentmemory ekstra chat hafızası.
+
+### graphify olmadan?
+
+Evet. Küçük projelerde AI dosyaları kendisi bulur; büyük projede harita çok işe yarar.
+
+### Her gün terminal açmam gerekir mi?
+
+Hayır. Günlük iş **chat**. Terminal: init, harita sync, doctor.
+
+### efesusstone için ne durumda?
+
+CapInt init + harita daha önce yapıldıysa **ekstra kurulum yok**. agentmemory kapalıysa sadece servisi aç. Proje çok değiştiyse haritayı yenile.
+
+### `.prismx/` klasörü lazım mı?
+
+**Hayır.** CapInt kök dosyaları kullanır: `HANDOFF.md`, `design.md`, `.capint/graph/`. `.prismx/` senin akışında yok.
+
+---
+
+## 12. Basit sorun giderme
+
+| Belirti | Muhtemel sebep | Ne yap |
+|---------|----------------|--------|
+| AI her seferinde sıfırdan | HANDOFF güncel değil | Oturum sonu "HANDOFF güncelle" |
+| `/graphify` hiçbir şey yapmıyor | Yanlış klasör veya kural yok | `capint stack graph paths` · `init --stack` |
+| Harita var ama CapInt görmüyor | Sync yapılmamış | `capint stack graph sync` |
+| Hafıza yok gibi | agentmemory kapalı | `agentmemory` terminalini aç |
+| Büyük iş dağıldı | Direkt kod yazdırıldı | `/blueprint` → `/challenge` → `/forge` |
+
+---
+
+## Özet tablo
+
+| | CapInt | agentmemory | graphify |
+|---|--------|-------------|----------|
+| **Nedir** | AI kural seti | Chat hafıza servisi | Kod haritası aracı |
+| **Kurulum** | Her proje | Bilgisayar 1× | Program 1×, harita proje 1× |
+| **Günlük** | Chat + HANDOFF | Arka planda açık | Nadiren yenile |
+| **CapInt'e dahil mi?** | Evet | Hayır | Hayır |
+| **Şart mı?** | Ana sistem | İsteğe bağlı | İsteğe bağlı |
+
+---
+
+*CapInt paketi: `@bcelep/capint` · Stack özeti: [capint-stack.md](capint-stack.md)*

package/docs/capint-stack.md

@@ -0,0 +1,118 @@
+# CapInt stack — tek model (ANWS ilhamı + graphify + agentmemory)
+
+> **Başlangıç rehberi (sade dil):** [capint-rehber.md](capint-rehber.md)
+
+CapInt **dört katman** bir arada. Ayrı ayrı “recipe” ezberleme yok — bu dosya tek referans.
+
+| Katman | Ne sağlar | Nasıl |
+|--------|-----------|--------|
+| **1. Workflows** | Karar, görev, forge gate, drift | `/genesis` `/blueprint` `/challenge` `/forge` (chat) |
+| **2. Routing** | Capability seçimi, HANDOFF sözleşmesi | `capint init` → `GUNLUK.md` + chat |
+| **3. Graph** | Kod yapısı, kalıcı `graph.json` | Cursor `/graphify …` → `capint stack graph sync` |
+| **4. Memory** | Oturumlar arası hafıza | `agentmemory` (makine) + Cursor MCP |
+
+CapInt motor gömmüyor — **tek komutla kontrol ediyorsun:** `capint stack doctor`
+
+---
+
+## Yeni proje (5 adım)
+
+```powershell
+cd C:\path\to\project
+npx @bcelep/capint init --bundle full --stack
+```
+
+1. **Init** — skills, workflows, AGENT, GUNLUK, matrix  
+2. **Stack setup** — `.capint/stack.json`, graphify Cursor kuralı (proje)  
+3. **Graph** — Cursor chat:
+
+   ```
+   /graphify ./src
+   ```
+
+   Next.js ise önce yol öner:
+
+   ```powershell
+   capint stack graph paths
+   ```
+
+   Sonra sync:
+
+   ```powershell
+   capint stack graph sync
+   ```
+
+4. **Memory (makine, bir kez)** — ayrı terminal:
+
+   ```powershell
+   agentmemory
+   ```
+
+   Cursor `~/.cursor/mcp.json` içinde `agentmemory` MCP (bkz. [agentmemory](https://github.com/rohitg00/agentmemory)).
+
+5. **Doğrula:**
+
+   ```powershell
+   capint stack doctor
+   ```
+
+Günlük: **GUNLUK.md** + chat. Ağır iş: `/blueprint` → `/challenge` → `/forge`.
+
+---
+
+## Makine kurulumu (bir kez, tüm projeler)
+
+```powershell
+uv tool install graphifyy
+graphify install cursor
+
+npm install -g @agentmemory/agentmemory
+# Windows: iii-engine → %USERPROFILE%\.local\bin\iii.exe (agentmemory gereksinimi)
+```
+
+Her proje: sadece `capint init --stack` + `/graphify` + `stack graph sync`.
+
+---
+
+## Komutlar
+
+| Komut | Amaç |
+|-------|------|
+| `capint stack doctor` | 4 katman özeti |
+| `capint stack setup` | Init sonrası wiring + manifest |
+| `capint stack graph paths` | Bu repo için `/graphify` klasörleri |
+| `capint stack graph sync` | `graphify-out/` → `GRAPH_REPORT.md` + `.capint/graph/graph.json` |
+| `capint providers doctor` | Katman 3–4 detay (tier JSON) |
+
+Opsiyonel env:
+
+```powershell
+$env:CAPINT_LOCAL_CONTEXT="1"   # route'ta dosya + graph excerpt
+$env:CAPINT_MEMORY="1"          # memory provider kapısı (0.8 adapter)
+```
+
+---
+
+## ANWS ile ilişki
+
+CapInt, [ANWS](https://github.com/Haaaiawd/ANWS) ilhamıyla **workflow + dosya hafızası** taşır (`workflows/`, HANDOFF, design, forge gate). ANWS’in `.anws/v{N}/` sürümlemesi yerine CapInt **matrix + scaffold + Execution Intent** kullanır.
+
+Kalıcı hafıza + bozulmayı önleme hedefi:
+
+- **Drift / regresyon** → katman 1 (`/challenge`, `/forge`)
+- **Karar dosyaları** → katman 2 (HANDOFF, design, DONE)
+- **Kod haritası** → katman 3 (graphify)
+- **Chat geçmişi** → katman 4 (agentmemory)
+
+---
+
+## Sorun giderme
+
+| Belirti | Çözüm |
+|---------|--------|
+| `/graphify` hiçbir şey yapmıyor | `graphify install cursor --project` · yanlış klasör (`/src` yoksa `capint stack graph paths`) |
+| Graph tier missing | Cursor’da `/graphify …` · `capint stack graph sync` |
+| agentmemory offline | `agentmemory` terminal · health: `:3111/agentmemory/health` |
+| Workflows missing | `capint init --bundle full` |
+
+Detay tier recipe: [memory-graph-pairing.md](recipes/memory-graph-pairing.md)

package/docs/community.md

@@ -0,0 +1,19 @@
+# Community & feedback
+
+## Local feedback (shipped 0.7.0)
+
+Wizard optional rating → `.capint/feedback/` (gitignored). Summary:
+
+```bash
+capint feedback --summary
+```
+
+## GitHub
+
+- **Issues:** bug reports and feature requests on the package repository
+- **Discussions:** usage questions, skill routing ideas (when enabled)
+- Use issue templates for reproducible `capint doctor --json` output
+
+## Not in 0.7.0
+
+Hosted surveys, Discord bot, or automatic telemetry — see PRD backlog.

package/docs/conventions/cli-scripting.md

@@ -0,0 +1,60 @@
+# CLI scripting — CapInt power user
+
+## Environment flags
+
+| Variable | Values | Effect |
+|----------|--------|--------|
+| `CAPINT_DEBUG` | `1`, `true` | stderr debug JSON on `route` / `pipeline` |
+| `CAPINT_DEFAULT_CONFIRM` | `apply_now`, `plan_first`, `analyze_only` | Overrides matrix default confirm option |
+| `CAPINT_LOCAL_CONTEXT` | `1` | Enables local context pack on route (v0.4.2+) |
+
+Examples:
+
+```bash
+export CAPINT_DEFAULT_CONFIRM=plan_first
+capint route "refactor auth module"
+```
+
+```powershell
+$env:CAPINT_DEBUG = "1"
+capint pipeline "prd hazırla"
+```
+
+## capint pipeline
+
+Health + optional route in one command:
+
+```bash
+capint pipeline                    # doctor + status + ide check
+capint pipeline "debug login"      # + route
+capint pipeline --json "i18n"      # machine output
+capint pipeline --skip-ide         # skip IDE projection check
+capint pipeline --force            # exit 0 even on FAIL (CI advisory)
+```
+
+## Shell helpers
+
+Shipped in package `scripts/`:
+
+- **`capint-task.sh`** — bash: pipeline preflight + compact route JSON
+- **`capint-task.ps1`** — PowerShell equivalent
+
+```bash
+./scripts/capint-task.sh "lang files inconsistent"
+```
+
+## CI advisory pattern
+
+```bash
+capint pipeline "$TASK" --json --force | jq '.pass'
+capint route --json "$TASK" | jq '.execution_intent.resolution_status'
+```
+
+Fail closed when `resolution_status` is `not_installed`.
+
+## jq one-liners
+
+```bash
+capint route --json "prd hazırla" | jq '.execution_intent | {capability, resolution_status, confirm_default_option}'
+capint route --json "prd hazırla" | jq '.execution_intent.explanation.files_to_read[]'
+```