@bcelep/capint 0.6.5 → 0.7.0

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/daily-use.md

@@ -16,7 +16,21 @@ Günlük iş **Cursor (veya IDE) chat’i** — terminal prosedürü değil.
 | Görevi normal dille yaz | `AGENT.md` + IDE kurallarını okur |
 | Screenshot / “beklenen vs mevcut” ekle | Kısa Execution Intent; orta/ağırda kısa soru |
 | “Önce plan, onaylayınca kod” de | Seçimine göre plan veya kod |
-| İstersen oturum sonu özet onayla | Değişiklik özeti sunar |
+| İstersen oturum sonu özet onayla | Değişiklik özeti sunar; `DONE.md` + `HANDOFF.md` günceller |
+
+### Oturum kapanışı
+
+Agent'a şunlardan biri yeterli:
+
+```
+kapan
+```
+
+```
+HANDOFF + DONE güncelle — bugün X yaptık, npm test yeşil
+```
+
+Agent: `DONE.md`'ye **append** (tarih, özet, doğrulama) · `HANDOFF.md`'yi **yeniden yaz** (aktif context, sıradaki 3 adım).
 
 **Yazmana gerek yok:** Skill adları, `capint route` çıktısı, matrix jargonu.
 

package/docs/eval/beginner-test-protocol.md

@@ -0,0 +1,39 @@
+# Beginner moderated test (n=3)
+
+**KPI (PRD §1):** ≤5 min time-to-first-task, ≥80% wizard completion, no terminal required.
+
+## Setup
+
+- Fresh machine or temp folder
+- `npx @bcelep/capint init --bundle minimal --name Demo`
+- `capint ui --open`
+- Observer only — no CLI hints unless participant stuck >2 min
+
+## Scenario
+
+1. Step 1: Run health check; proceed when green (or use suggested fix).
+2. Step 2: Task text: **「PRD hazırla — mobil uygulama onboarding」**
+3. Step 3: Read plain-language plan; choose `plan_first`.
+4. Step 4: Copy chat block into IDE; confirm participant understands capability name is optional.
+
+## Metrics
+
+| Metric | Pass |
+|--------|------|
+| Wall time start → copy | ≤ 5 min |
+| Wizard steps completed | 4/4 |
+| Terminal opened | No |
+| Can explain "why this capability" | Yes (uses plain summary) |
+
+## Log template
+
+```
+Date:
+Participant ID:
+Duration (min):
+Wizard completed: Y/N
+Rating (1-5):
+Notes:
+```
+
+Append summary row to `DONE.md` after each session.

package/docs/eval/survey-template.md

@@ -0,0 +1,16 @@
+# Post-wizard micro-survey (5 questions)
+
+Target: ≥ 4/5 average on Q1–Q3 (PRD KPI).
+
+1. **Anlaşılırlık:** Plan özeti (Neden / plain text) ne kadar anlaşılırdı? (1–5)
+2. **Güven:** Seçilen capability mantıklı mıydı? (1–5)
+3. **Hız:** Terminal kullanmadan görevi başlatmak ne kadar kolaydı? (1–5)
+4. **Doctor:** Proje kontrolü yeterli miydi? (1–5)
+5. **Serbest:** Bir cümleyle ne iyileştirilmeli?
+
+## Collection (v0.7.0)
+
+- UI wizard step 4 → optional stars + comment → `.capint/feedback/entries.jsonl`
+- Maintainer aggregate: `capint feedback --summary --json`
+
+No external telemetry in 0.7.0.

package/docs/generated/README.md

@@ -0,0 +1,6 @@
+# CapInt generated schema docs
+
+- [execution-intent.v1](./execution-intent.v1.md)
+- [explanation.v2](./explanation.v2.md)
+- [ui-api.v1](./ui-api.v1.md)
+- [explanation.v1](./explanation.v1.md)

package/docs/generated/execution-intent.v1.md

@@ -0,0 +1,211 @@
+# CapInt Execution Intent
+
+> Auto-generated from `schemas/execution-intent.v1.json`. Do not edit by hand.
+
+**$id:** `https://capint.dev/schemas/execution-intent.v1.json`
+
+## Properties
+
+| Field | Type | Required |
+|-------|------|----------|
+| `intent` | string | yes |
+| `capability` | string | yes |
+| `resolution` | string | yes |
+| `memory` | none \| optional \| required | yes |
+| `plan` | auto \| confirm \| override | yes |
+| `confirm` | object | yes |
+| `confirm_question` | string,null | yes |
+| `confirm_options` | array | yes |
+| `confirm_default_option` | string,null | yes |
+| `fallback` | object,null | yes |
+| `verification_required` | boolean | no |
+| `verification_hints` | array | no |
+| `verification_profile` | string | no |
+| `route_explain` | object | no |
+| `explanation` | explanation.v2.json | no |
+| `provider_activation` | object,null | no |
+| `context_pack` | object,null | no |
+| `orchestration` | object,null | no |
+| `resolution_status` | string | no |
+| `resolution_hint` | string | no |
+| `workspace_boundary` | object | no |
+| `overlay_error` | string | no |
+| `local_adapters` | object | no |
+
+## Raw schema
+
+```json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://capint.dev/schemas/execution-intent.v1.json",
+  "title": "CapInt Execution Intent",
+  "type": "object",
+  "required": [
+    "intent",
+    "capability",
+    "resolution",
+    "memory",
+    "plan",
+    "confirm",
+    "confirm_question",
+    "confirm_options",
+    "confirm_default_option",
+    "fallback"
+  ],
+  "properties": {
+    "intent": {
+      "type": "string"
+    },
+    "capability": {
+      "type": "string"
+    },
+    "resolution": {
+      "type": "string"
+    },
+    "memory": {
+      "enum": [
+        "none",
+        "optional",
+        "required"
+      ]
+    },
+    "plan": {
+      "enum": [
+        "auto",
+        "confirm",
+        "override"
+      ]
+    },
+    "confirm": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "mode": {
+          "type": "string"
+        },
+        "prompt": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "options": {
+          "type": "array"
+        },
+        "default_option": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      }
+    },
+    "confirm_question": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "confirm_options": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "label"
+        ],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "confirm_default_option": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "fallback": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "verification_required": {
+      "type": "boolean"
+    },
+    "verification_hints": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "verification_profile": {
+      "type": "string"
+    },
+    "route_explain": {
+      "type": "object"
+    },
+    "explanation": {
+      "$ref": "explanation.v2.json"
+    },
+    "provider_activation": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "context_pack": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "orchestration": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "resolution_status": {
+      "type": "string"
+    },
+    "resolution_hint": {
+      "type": "string"
+    },
+    "workspace_boundary": {
+      "type": "object",
+      "properties": {
+        "violated": {
+          "type": "boolean"
+        },
+        "suspicious_paths": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "override_hint": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      }
+    },
+    "overlay_error": {
+      "type": "string"
+    },
+    "local_adapters": {
+      "type": "object"
+    }
+  }
+}
+```

package/docs/generated/explanation.v1.md

@@ -0,0 +1,127 @@
+# CapInt Route Explanation
+
+> Auto-generated from `schemas/explanation.v1.json`. Do not edit by hand.
+
+**$id:** `https://capint.dev/schemas/explanation.v1.json`
+
+## Properties
+
+| Field | Type | Required |
+|-------|------|----------|
+| `task_type_id` | string,null | yes |
+| `matched_keywords` | array | yes |
+| `winner` | object,null | yes |
+| `files_to_read` | array | yes |
+| `reason_summary` | string | yes |
+| `alternatives_considered` | array | yes |
+| `resolver_order` | array | no |
+| `files_intended` | array | no |
+| `workspace_boundary` | object | no |
+
+## Raw schema
+
+```json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://capint.dev/schemas/explanation.v1.json",
+  "title": "CapInt Route Explanation",
+  "type": "object",
+  "required": [
+    "task_type_id",
+    "matched_keywords",
+    "winner",
+    "files_to_read",
+    "reason_summary",
+    "alternatives_considered"
+  ],
+  "properties": {
+    "task_type_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "matched_keywords": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "winner": {
+      "type": [
+        "object",
+        "null"
+      ],
+      "properties": {
+        "type": {
+          "type": "string"
+        },
+        "resource": {
+          "type": "string"
+        }
+      }
+    },
+    "files_to_read": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "reason_summary": {
+      "type": "string"
+    },
+    "alternatives_considered": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "resource": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          },
+          "confidence": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        }
+      }
+    },
+    "resolver_order": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "files_intended": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "workspace_boundary": {
+      "type": "object",
+      "properties": {
+        "violated": {
+          "type": "boolean"
+        },
+        "suspicious_paths": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "override_hint": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      }
+    }
+  }
+}
+```

package/docs/generated/explanation.v2.md

@@ -0,0 +1,142 @@
+# CapInt Route Explanation v2
+
+> Auto-generated from `schemas/explanation.v2.json`. Do not edit by hand.
+
+**$id:** `https://capint.dev/schemas/explanation.v2.json`
+
+## Properties
+
+| Field | Type | Required |
+|-------|------|----------|
+| `task_type_id` | string,null | yes |
+| `matched_keywords` | array | yes |
+| `winner` | object,null | yes |
+| `files_to_read` | array | yes |
+| `reason_summary` | string | yes |
+| `reason_plain` | string | no |
+| `tooltip` | string | no |
+| `locale` | tr \| en | no |
+| `alternatives_considered` | array | yes |
+| `resolver_order` | array | no |
+| `files_intended` | array | no |
+| `workspace_boundary` | object | no |
+
+## Raw schema
+
+```json
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://capint.dev/schemas/explanation.v2.json",
+  "title": "CapInt Route Explanation v2",
+  "type": "object",
+  "required": [
+    "task_type_id",
+    "matched_keywords",
+    "winner",
+    "files_to_read",
+    "reason_summary",
+    "alternatives_considered"
+  ],
+  "properties": {
+    "task_type_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "matched_keywords": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "winner": {
+      "type": [
+        "object",
+        "null"
+      ],
+      "properties": {
+        "type": {
+          "type": "string"
+        },
+        "resource": {
+          "type": "string"
+        }
+      }
+    },
+    "files_to_read": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "reason_summary": {
+      "type": "string"
+    },
+    "reason_plain": {
+      "type": "string"
+    },
+    "tooltip": {
+      "type": "string"
+    },
+    "locale": {
+      "enum": [
+        "tr",
+        "en"
+      ]
+    },
+    "alternatives_considered": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "resource": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          },
+          "confidence": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        }
+      }
+    },
+    "resolver_order": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "files_intended": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "workspace_boundary": {
+      "type": "object",
+      "properties": {
+        "violated": {
+          "type": "boolean"
+        },
+        "suspicious_paths": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "override_hint": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      }
+    }
+  }
+}
+```