@bcelep/capint 0.4.2 → 0.7.0

package/src/lib/ui-server.js

@@ -0,0 +1,226 @@
+const http = require("http");
+const fs = require("fs");
+const path = require("path");
+const { URL } = require("url");
+const { routeTask, formatTextReport } = require("./route-engine");
+const { runDoctor, runStatus } = require("./doctor");
+const { planRecover, applyRecover } = require("./recover");
+const { enableSkill } = require("./disabled-skills");
+const { appendFeedback } = require("./feedback");
+const { resolveLocale, parseAcceptLanguage } = require("./i18n");
+
+const MIME = {
+  ".html": "text/html; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".svg": "image/svg+xml"
+};
+
+function pkgUiDir() {
+  return path.join(__dirname, "..", "..", "ui");
+}
+
+function readBody(req) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    req.on("data", (c) => chunks.push(c));
+    req.on("end", () => {
+      try {
+        const raw = Buffer.concat(chunks).toString("utf-8");
+        resolve(raw ? JSON.parse(raw) : {});
+      } catch (e) {
+        reject(e);
+      }
+    });
+    req.on("error", reject);
+  });
+}
+
+function json(res, status, data) {
+  const body = JSON.stringify(data);
+  res.writeHead(status, {
+    "Content-Type": "application/json; charset=utf-8",
+    "Content-Length": Buffer.byteLength(body)
+  });
+  res.end(body);
+}
+
+function resolveRequestLocale(req, body = {}) {
+  if (body.locale) return resolveLocale(body.locale);
+  return resolveLocale(parseAcceptLanguage(req.headers["accept-language"]));
+}
+
+function projectHealth(rootDir, locale) {
+  const loc = resolveLocale(locale);
+  const doctor = runDoctor(rootDir, { locale: loc });
+  const status = runStatus(rootDir);
+  return {
+    ok: doctor.pass,
+    doctor,
+    status: {
+      skills_on_disk: status.skills_on_disk,
+      core_skills: status.core_skills,
+      matrix_version: status.matrix_version,
+      capint_package: status.capint_package
+    }
+  };
+}
+
+function buildChatCopy(result) {
+  if (result.error) return result.error;
+  const ei = result.execution_intent;
+  const lines = [
+    `Intent: ${ei.intent}`,
+    `Capability: ${ei.capability}`,
+    `Resolution: ${ei.resolution}`,
+    `Resolution status: ${ei.resolution_status || "installed"}`,
+    `Memory: ${ei.memory}`,
+    `Plan: ${ei.plan}`
+  ];
+  if (ei.confirm?.enabled) {
+    const opts = (ei.confirm_options || []).map((o) => o.id).join(" | ");
+    lines.push(`Confirm: ${opts} (default: ${ei.confirm_default_option})`);
+  }
+  if (ei.explanation?.reason_plain) {
+    lines.push(`Why: ${ei.explanation.reason_plain}`);
+  }
+  if (ei.explanation?.files_to_read?.length) {
+    lines.push("Read first:");
+    for (const f of ei.explanation.files_to_read) lines.push(`- ${f}`);
+  }
+  return lines.join("\n");
+}
+
+function applyDoctorAction(rootDir, actionId, doctor) {
+  const action = (doctor.actions || []).find((a) => a.id === actionId);
+  if (!action) return { error: `Unknown action: ${actionId}` };
+
+  if (action.id === "recover_latest") {
+    const plan = planRecover(rootDir, { latest: true });
+    if (plan.error) return plan;
+    return applyRecover(rootDir, plan);
+  }
+  if (action.id === "enable_core" && action.skill) {
+    return enableSkill(rootDir, action.skill);
+  }
+  return { error: "Action not supported via UI" };
+}
+
+function createUiServer({ rootDir, uiDir = pkgUiDir(), port = 3721, host = "127.0.0.1" }) {
+  const server = http.createServer(async (req, res) => {
+    const url = new URL(req.url, `http://${host}:${port}`);
+    const pathname = url.pathname;
+    const locale = resolveRequestLocale(req);
+
+    if (req.method === "GET" && pathname === "/api/health") {
+      return json(res, 200, projectHealth(rootDir, locale));
+    }
+
+    if (req.method === "GET" && pathname === "/api/locale") {
+      const { loadLocale } = require("./i18n");
+      return json(res, 200, { locale, strings: loadLocale(locale) });
+    }
+
+    if (req.method === "POST" && pathname === "/api/route") {
+      try {
+        const body = await readBody(req);
+        const task = String(body.task || "").trim();
+        if (!task) return json(res, 400, { error: "task required" });
+        const prevLocale = process.env.CAPINT_LOCALE;
+        const reqLocale = resolveRequestLocale(req, body);
+        process.env.CAPINT_LOCALE = reqLocale;
+        let result;
+        try {
+          result = routeTask(task, rootDir);
+        } finally {
+          if (prevLocale === undefined) delete process.env.CAPINT_LOCALE;
+          else process.env.CAPINT_LOCALE = prevLocale;
+        }
+        if (result.error) return json(res, 400, { error: result.error });
+        return json(res, 200, {
+          result,
+          text_report: formatTextReport(result),
+          chat_copy: buildChatCopy(result)
+        });
+      } catch (e) {
+        return json(res, 400, { error: e.message });
+      }
+    }
+
+    if (req.method === "POST" && pathname === "/api/recover") {
+      try {
+        const body = await readBody(req);
+        const apply = Boolean(body.apply);
+        const actionId = body.action_id;
+
+        if (actionId) {
+          const doctor = runDoctor(rootDir, { locale: resolveRequestLocale(req, body) });
+          if (!apply) {
+            const action = (doctor.actions || []).find((a) => a.id === actionId);
+            return json(res, 200, { dry_run: true, action });
+          }
+          const result = applyDoctorAction(rootDir, actionId, doctor);
+          if (result.error) return json(res, 400, result);
+          return json(res, 200, { ok: true, applied: actionId, result, health: projectHealth(rootDir) });
+        }
+
+        const plan = planRecover(rootDir, { latest: body.latest !== false });
+        if (plan.error) return json(res, 400, plan);
+        if (!apply) return json(res, 200, { dry_run: true, ...plan });
+        const result = applyRecover(rootDir, plan);
+        return json(res, 200, { ok: true, result, health: projectHealth(rootDir) });
+      } catch (e) {
+        return json(res, 400, { error: e.message });
+      }
+    }
+
+    if (req.method === "POST" && pathname === "/api/feedback") {
+      try {
+        const body = await readBody(req);
+        const result = appendFeedback(rootDir, body);
+        if (result.error) return json(res, 400, result);
+        return json(res, 200, result);
+      } catch (e) {
+        return json(res, 400, { error: e.message });
+      }
+    }
+
+    let filePath = pathname === "/" ? "/index.html" : pathname;
+    filePath = path.normalize(filePath).replace(/^(\.\.[/\\])+/, "");
+    const abs = path.join(uiDir, filePath);
+    if (!abs.startsWith(path.resolve(uiDir))) {
+      res.writeHead(403);
+      return res.end("Forbidden");
+    }
+    if (!fs.existsSync(abs) || fs.statSync(abs).isDirectory()) {
+      res.writeHead(404);
+      return res.end("Not found");
+    }
+    const ext = path.extname(abs);
+    const data = fs.readFileSync(abs);
+    res.writeHead(200, { "Content-Type": MIME[ext] || "application/octet-stream" });
+    res.end(data);
+  });
+
+  return {
+    server,
+    listen: () =>
+      new Promise((resolve, reject) => {
+        server.listen(port, host, () => resolve({ host, port, url: `http://${host}:${port}/` }));
+        server.on("error", reject);
+      }),
+    close: () =>
+      new Promise((resolve) => {
+        server.close(() => resolve());
+      })
+  };
+}
+
+module.exports = {
+  createUiServer,
+  projectHealth,
+  buildChatCopy,
+  applyDoctorAction,
+  pkgUiDir
+};

package/src/lib/upgrade-matrix.js

@@ -1,5 +1,6 @@
 const fs = require("fs");
 const path = require("path");
+const { deriveRegistryFromMatrix, copyBundle, listPackageSkillNames, pkgRoot } = require("./scaffold/presets");
 
 function loadJson(filePath) {
   return JSON.parse(fs.readFileSync(filePath, "utf-8"));
@@ -106,7 +107,7 @@ function planUpgrade(rootDir, packageRoot) {
   };
 }
 
-function applyUpgrade(rootDir, merged) {
+function applyUpgrade(rootDir, merged, packageRoot = pkgRoot()) {
   const projectPath = path.join(rootDir, "skill-routing-matrix.json");
   const backupDir = path.join(rootDir, ".capint", "backups");
   fs.mkdirSync(backupDir, { recursive: true });
@@ -114,6 +115,20 @@ function applyUpgrade(rootDir, merged) {
   const backupPath = path.join(backupDir, `skill-routing-matrix.${stamp}.json`);
   fs.copyFileSync(projectPath, backupPath);
   fs.writeFileSync(projectPath, `${JSON.stringify(merged, null, 2)}\n`, "utf-8");
+
+  const registryPath = path.join(rootDir, "registry.json");
+  if (fs.existsSync(registryPath)) {
+    const registryBackup = path.join(backupDir, `registry.${stamp}.json`);
+    fs.copyFileSync(registryPath, registryBackup);
+  }
+  fs.writeFileSync(
+    registryPath,
+    `${JSON.stringify(deriveRegistryFromMatrix(merged, packageRoot), null, 2)}\n`,
+    "utf-8"
+  );
+
+  copyBundle({ rootDir, force: false });
+
   return backupPath;
 }
 

package/src/lib/workspace-boundary.js

@@ -0,0 +1,60 @@
+function normalize(text) {
+  return text.toLowerCase().normalize("NFD").replace(/\p{M}/gu, "");
+}
+
+const OVERRIDE_PHRASES = [
+  "cross-repo override",
+  "capint:cross-repo",
+  "capint cross repo",
+  "başka repo override",
+  "workspace override"
+];
+
+const SIBLING_REPO_NAMES = ["prismx", "prismx-cli", "efesusstone"];
+
+const PATH_PATTERNS = [
+  /\.\.[\\/][^\s,;'"`]*/g,
+  /(?:^|[\s'"`])([a-z]:[\\/][^\s'"`,]+)/gi,
+  /(?:^|[\s'"`])\/(?:home|Users|var)\/[^\s'"`,]+/gi,
+  new RegExp(
+    `(?:^|[\\s'"\\\`])((?:${SIBLING_REPO_NAMES.join("|")})[\\\\/][^\\s'"\\\`,]+)`,
+    "gi"
+  )
+];
+
+function extractSuspiciousPaths(text) {
+  const found = [];
+  for (const re of PATH_PATTERNS) {
+    for (const m of text.matchAll(re)) {
+      const p = (m[1] || m[0]).trim().replace(/^[\s'"`]+|[\s'"`,]+$/g, "");
+      if (p && !found.includes(p)) found.push(p);
+    }
+  }
+  return found;
+}
+
+function hasCrossRepoOverride(text) {
+  const n = normalize(text);
+  return OVERRIDE_PHRASES.some((p) => n.includes(normalize(p)));
+}
+
+function detectWorkspaceBoundary(text) {
+  const suspicious_paths = extractSuspiciousPaths(text);
+  const has_override = hasCrossRepoOverride(text);
+  const violated = suspicious_paths.length > 0 && !has_override;
+  return {
+    violated,
+    has_override,
+    suspicious_paths,
+    override_hint: violated
+      ? 'Add explicit phrase "cross-repo override" to edit files outside this workspace'
+      : null
+  };
+}
+
+module.exports = {
+  detectWorkspaceBoundary,
+  extractSuspiciousPaths,
+  hasCrossRepoOverride,
+  OVERRIDE_PHRASES
+};

package/templates/minimal/AGENT.md

@@ -2,14 +2,23 @@
 
 CapInt capability-first orchestration contract for this project.
 
+> **Günlük kullanım:** [GUNLUK.md](GUNLUK.md) — chat yeterli, terminal zorunlu değil.
+
 <!-- capint:managed:start -->
 ## Task contract
 
 For every task:
 1. Build Execution Intent
-2. Ask confirm options (`apply_now | plan_first | analyze_only`)
+2. Adaptive confirm: light → apply after Intent; medium/heavy → short Turkish question (devam/plan/analiz — no token required)
 3. Route via capability + provider resolution
 
+## Activation model
+
+- **`installed`** = `skills/<name>/SKILL.md` exists on disk **and** skill is not disabled (`capint skill list`).
+- **Installed ≠ Cursor skill picker** — CapInt does not register 115 skills in IDE UI; the agent reads files per task.
+- Before medium+ code edits: read `skills/prismx-skill-gateway/SKILL.md`, then the routed skill from `explanation.files_to_read`.
+- Preview routing: `capint route "<task>"` — check **Explanation** block.
+
 ## Runtime chain
 
 `parseIntent -> routeCapability -> resolveMemoryStrategy -> buildExecutionPolicy -> formatOutput`

package/templates/minimal/DONE.md

@@ -0,0 +1,10 @@
+# DONE — {{project_name}}
+
+> **Append-only** tamamlanan işler. Agent geniş kapsam önermeden önce buraya bakar.  
+> Aktif oturum: [HANDOFF.md](HANDOFF.md) (varsa)
+
+## Log
+
+| Date | Summary | Verification |
+|------|---------|--------------|
+| {{date}} | CapInt init — proje hazır | `capint doctor` |

package/templates/minimal/GUNLUK.md

@@ -0,0 +1,26 @@
+# CapInt — Günlük kullanım
+
+> **Terminal zorunlu değil.** Kurulumdan sonra her şey chat’te.
+
+## CapInt stack (4 katman)
+
+| Katman | Günlük |
+|--------|--------|
+| Workflows | `/forge` `/blueprint` — drift/regresyon kapısı |
+| Routing | Bu dosya + chat (Execution Intent) |
+| Graph | Cursor `/graphify …` (proje değişince `--update`) |
+| Memory | agentmemory MCP + oturum kapanışında HANDOFF/DONE |
+
+Kurulum: `capint init --stack` → `capint stack doctor` · [docs/capint-stack.md](docs/capint-stack.md)
+
+---
+
+1. Chat'e görevi doğal dille yaz (+ screenshot varsa ekle).
+2. Agent kısa **Execution Intent** gösterir (`Intent` / `Capability` / `Resolution` / `Plan`).
+3. **Hafif iş:** soru yok, doğrudan uygular. **Orta/ağır:** `devam` / `plan` / `analiz` yeterli.
+4. Skill veya workflow adı **ezberlemezsin**; seçimi agent yapar.
+5. `/workflow` veya `/skill` sadece override içindir (nadiren gerekir).
+6. Terminal yalnızca: **ilk kurulum** (`init --stack`), **stack doctor**, sorun (`doctor`).
+7. **Oturum kapanışı:** `kapan` veya `HANDOFF + DONE güncelle` — tamamlanan iş `DONE.md`, sıradaki iş `HANDOFF.md`.
+
+**Tam kılavuz:** [docs/kullanim-kilavuzu.md](docs/kullanim-kilavuzu.md) · **Chat şablonları:** [docs/conventions/daily-use.md](docs/conventions/daily-use.md)

package/templates/minimal/docs/conventions/daily-use.md

@@ -0,0 +1,132 @@
+---
+description: "CapInt daily use — chat-first, no ceremony."
+---
+
+# Günlük kullanım — chat yeterli
+
+CapInt arka planda **kurallar + capability router + skill bundle** sağlar.  
+Günlük iş **Cursor (veya IDE) chat’i** — terminal prosedürü değil.
+
+---
+
+## Kim ne yapar?
+
+| Sen | Agent |
+|-----|--------|
+| 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; `DONE.md` + `HANDOFF.md` günceller |
+
+**Kapanış:** `kapan` veya `HANDOFF + DONE güncelle`
+
+**Yazmana gerek yok:** Skill adları, `capint route` çıktısı, matrix jargonu.
+
+---
+
+## Mesaj şablonu (kopyala-yapıştır)
+
+```
+[Sorun / istek — 2–4 cümle]
+
+[Varsa: ekte screenshot = hedef görünüm]
+
+Kısıt: Sadece [modül/sayfa]. Başka yere dokunma.
+
+Önce kısa Execution Intent göster; hafif işte doğrudan uygula, orta/ağırda kısa soru sor (devam/plan/analiz).
+```
+
+---
+
+## Senaryolar
+
+### Bug fix
+
+```
+Ödeme callback 500 veriyor. Log: [varsa yapıştır].
+Kök neden + regression test. Sadece ilgili service ve test.
+Önce plan.
+```
+
+Agent muhtemelen: `Capability: systematic-debugging` · mesajında “önce plan” varsa plan modu
+
+### Çeviri / i18n
+
+```
+Lang dosyaları uyumsuz. Tek kaynak lang/*.php olsun.
+Önce hangi key'ler drift etmiş listele, onaylayınca düzelt.
+```
+
+Agent muhtemelen: `Capability: localization-hub`
+
+### Refactor
+
+```
+Auth modülünde code smell var. Davranış değişmesin.
+Mevcut testler geçmeli. Önce kısa plan.
+```
+
+### “Olmuş gibi değil” (UI)
+
+```
+Ekteki görsel doğru örnek. Şu anki sayfa uymuyor.
+Farkları listele → onay → düzelt.
+```
+
+### Mimari / karar
+
+```
+İki yaklaşım var: [A] ve [B]. Tek kaynak [A] olsun.
+Önce mimari plan — kod yok.
+```
+
+Confirm’de **`analiz`** veya “kod yazma” diyebilirsin.
+
+---
+
+## Confirm (adaptive)
+
+Confirm, agent’ın kontrolsüz kod yazmasını önlemek içindi. Günlük kullanımda:
+
+| Ağırlık | Sen |
+|---------|-----|
+| 🟢 Light | Ek adım yok — agent Intent sonrası uygular |
+| 🟡🔴 Medium/heavy | `devam` / `plan` / `analiz` yeterli — `apply_now` yazmana gerek yok |
+
+| Doğal dil | Anlam |
+|-----------|--------|
+| devam, yap, evet, tamam | Hemen uygula |
+| plan, planla, önce plan | Önce kısa plan |
+| analiz, incele, kod yazma | Sadece analiz |
+
+---
+
+## Terminal — sadece gerekirse
+
+| Ne zaman | Komut |
+|----------|--------|
+| Projeye **ilk kez** CapInt | `npx @bcelep/capint init` |
+| Agent kuralları gelmiyor | `capint ide sync` |
+| Bir şey eksik mi? | `capint doctor` |
+| Route kararını **görmek** istiyorsan (opsiyonel) | `capint route --verbose "..."` |
+
+Global kurulum varsa: `capint` (`npx` olmadan).
+
+---
+
+## Sık karışanlar
+
+| Yanlış algı | Gerçek |
+|-------------|--------|
+| Her görevde `capint route` | Hayır — chat yeterli |
+| Skill adını bilmem lazım | Hayır — agent seçer |
+| CapInt = terminal aracı | Hayır — IDE agent davranışı |
+| Init sonrası hâlâ zor | Yeni sohbet aç; IDE sync kontrol et |
+
+---
+
+## İlgili
+
+- [GUNLUK.md](../../GUNLUK.md) — tek sayfa özet
+- [kullanim-kilavuzu.md](../kullanim-kilavuzu.md) — tam kılavuz
+- [task-to-capability-cheatsheet.md](task-to-capability-cheatsheet.md) — görev → capability

package/templates/minimal/docs/conventions/task-to-capability-cheatsheet.md

@@ -0,0 +1,29 @@
+# Görev → Capability cheatsheet
+
+Agent chat’te capability seçer; sen ezberlemezsin. Referans / maintainer içindir.
+
+| Sen dersen (örnek) | Capability | Skill | Workflow |
+|--------------------|------------|-------|----------|
+| bug, hata, fix, çalışmıyor | systematic-debugging | systematic-debugging | /forge |
+| i18n, çeviri, lang file | localization-hub | localization-hub | — |
+| refactor, simplify, code smell | refactor-simplify | refactor | /forge |
+| memory lookup, geçen karar | memory-retrieval | context-memory-bridge | — |
+| Belirsiz / genel | request-clarification | capability-router | — |
+| `/workflow`, `/skill` | workflow-override | capability-router | — |
+
+**Ağırlık (agent içsel):**
+
+| Emoji | Anlam | Tipik davranış |
+|-------|-------|----------------|
+| 🟢 light | Tek dosya, küçük fix | `apply_now` uygun olabilir |
+| 🟡 medium | Birkaç dosya, test | Confirm zorunlu |
+| 🔴 heavy | Mimari, yeni modül | `plan_first` önerilir |
+
+Auth, payment, secret kelimeleri → minimum 🟡.
+
+CLI önizleme (opsiyonel):
+
+```bash
+capint route --list
+capint route --verbose "i18n çeviri"
+```