@bcelep/capint 0.6.5 → 0.7.0

package/src/lib/stack/index.js

@@ -0,0 +1,259 @@
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+const { runProvidersDoctor } = require("../providers/doctor");
+
+const STACK_DOC = "docs/capint-stack.md";
+const STACK_MANIFEST = ".capint/stack.json";
+const WORKFLOW_ANCHORS = [
+  { path: "workflows/forge.md", label: "forge gate (zero-regression)" },
+  { path: "workflows/challenge.md", label: "challenge gate" },
+  { path: "workflows/genesis.md", label: "genesis / design-first" },
+  { path: "workflows/blueprint.md", label: "blueprint / tasks" }
+];
+
+const GRAPH_PATH_CANDIDATES = ["src", "app", "lib", "components", "packages"];
+
+function fileExists(rootDir, rel) {
+  return fs.existsSync(path.join(rootDir, rel));
+}
+
+function countMarkdown(dir) {
+  if (!fs.existsSync(dir)) return 0;
+  return fs.readdirSync(dir).filter((f) => f.endsWith(".md")).length;
+}
+
+function tierWorkflows(rootDir) {
+  const wfDir = path.join(rootDir, "workflows");
+  const count = countMarkdown(wfDir);
+  const anchors = WORKFLOW_ANCHORS.map((a) => ({
+    ...a,
+    exists: fileExists(rootDir, a.path)
+  }));
+  const coreOk = anchors.filter((a) =>
+    ["workflows/forge.md", "workflows/challenge.md"].includes(a.path)
+  ).every((a) => a.exists);
+
+  let status = "missing";
+  if (count >= 4 && coreOk) status = "ok";
+  else if (count > 0) status = "partial";
+
+  return {
+    id: "layer_workflows",
+    label: "ANWS-style workflows (decisions, forge gate, drift)",
+    status,
+    workflow_count: count,
+    anchors,
+    chat: "Use /genesis /blueprint /challenge /forge in chat — not capint CLI"
+  };
+}
+
+function tierRouting(rootDir) {
+  const files = ["GUNLUK.md", "AGENT.md", "HANDOFF.md", "design.md", "skill-routing-matrix.json"];
+  const paths = files.map((p) => ({ path: p, exists: fileExists(rootDir, p) }));
+  const hasCore = paths.filter((p) => ["GUNLUK.md", "AGENT.md", "skill-routing-matrix.json"].includes(p.path)).every(
+    (p) => p.exists
+  );
+  return {
+    id: "layer_routing",
+    label: "CapInt routing + HANDOFF contract",
+    status: hasCore ? "ok" : fileExists(rootDir, "AGENT.md") ? "partial" : "missing",
+    paths,
+    enable: "capint init — daily chat via GUNLUK.md"
+  };
+}
+
+function detectGraphPaths(rootDir) {
+  const existing = GRAPH_PATH_CANDIDATES.filter((name) => {
+    const p = path.join(rootDir, name);
+    return fs.existsSync(p) && fs.statSync(p).isDirectory();
+  });
+
+  let suggested = [];
+  if (existing.includes("src")) {
+    suggested = ["./src"];
+  } else if (existing.includes("app") && existing.includes("lib")) {
+    suggested = ["./app", "./lib", "./components"].filter((rel) => fileExists(rootDir, rel.replace(/^\.\//, "")));
+  } else if (existing.length) {
+    suggested = existing.slice(0, 3).map((d) => `./${d}`);
+  } else {
+    suggested = ["."];
+  }
+
+  const cursorCmd = `/graphify ${suggested.join(" ")}`;
+  return { existing_dirs: existing, suggested, cursor_command: cursorCmd };
+}
+
+function syncGraphArtifacts(rootDir) {
+  const outDir = path.join(rootDir, "graphify-out");
+  const reportSrc = path.join(outDir, "GRAPH_REPORT.md");
+  const jsonSrc = path.join(outDir, "graph.json");
+  const actions = [];
+
+  if (!fs.existsSync(reportSrc) && !fs.existsSync(jsonSrc)) {
+    return { ok: false, error: "graphify-out/ not found — run /graphify in Cursor first", actions };
+  }
+
+  if (fs.existsSync(reportSrc)) {
+    fs.copyFileSync(reportSrc, path.join(rootDir, "GRAPH_REPORT.md"));
+    actions.push("GRAPH_REPORT.md");
+  }
+  if (fs.existsSync(jsonSrc)) {
+    const destDir = path.join(rootDir, ".capint", "graph");
+    fs.mkdirSync(destDir, { recursive: true });
+    fs.copyFileSync(jsonSrc, path.join(destDir, "graph.json"));
+    actions.push(".capint/graph/graph.json");
+  }
+
+  return { ok: actions.length > 0, actions };
+}
+
+function tryGraphifyCursorInstall(rootDir) {
+  try {
+    execSync("graphify install cursor --project", {
+      cwd: rootDir,
+      stdio: "pipe",
+      encoding: "utf-8"
+    });
+    return { ok: true, path: path.join(rootDir, ".cursor", "rules", "graphify.mdc") };
+  } catch (e) {
+    return { ok: false, error: (e.stderr || e.message || "graphify install failed").trim() };
+  }
+}
+
+function writeStackManifest(rootDir, report) {
+  const manifest = {
+    version: 1,
+    updated_at: new Date().toISOString(),
+    doc: STACK_DOC,
+    layers: {
+      workflows: report.layers.layer_workflows.status,
+      routing: report.layers.layer_routing.status,
+      graph: report.providers.tiers.tier1_graphify.status,
+      memory: report.providers.tiers.tier2_agentmemory.status
+    },
+    graph_paths: report.graph_paths
+  };
+  fs.mkdirSync(path.join(rootDir, ".capint"), { recursive: true });
+  fs.writeFileSync(path.join(rootDir, STACK_MANIFEST), `${JSON.stringify(manifest, null, 2)}\n`, "utf-8");
+  return manifest;
+}
+
+async function runStackDoctor(rootDir) {
+  const providers = await runProvidersDoctor(rootDir);
+  providers.recipe = STACK_DOC;
+
+  const layers = {
+    layer_workflows: tierWorkflows(rootDir),
+    layer_routing: tierRouting(rootDir)
+  };
+
+  const graph_paths = detectGraphPaths(rootDir);
+
+  const stackReady =
+    layers.layer_routing.status === "ok" &&
+    layers.layer_workflows.status !== "missing" &&
+    providers.tiers.tier1_graphify.status === "ok" &&
+    providers.tiers.tier2_agentmemory.status === "ok";
+
+  const recommendations = [];
+  if (layers.layer_routing.status !== "ok") recommendations.push("Run: capint init");
+  if (layers.layer_workflows.status === "missing") {
+    recommendations.push("Init with --bundle full (workflows/) or copy workflows from CapInt package.");
+  }
+  if (providers.tiers.tier1_graphify.status !== "ok") {
+    recommendations.push(`Cursor: ${graph_paths.cursor_command} then capint stack graph sync`);
+  }
+  if (providers.tiers.tier2_agentmemory.status !== "ok") {
+    recommendations.push("Machine: agentmemory (background) + Cursor MCP — see capint stack setup");
+  }
+  if (!providers.env.local_context_enabled) {
+    recommendations.push("Optional: CAPINT_LOCAL_CONTEXT=1 on route for file + graph excerpts.");
+  }
+
+  return {
+    mode: "read_only",
+    doc: STACK_DOC,
+    stack_ready: stackReady,
+    layers,
+    graph_paths,
+    providers,
+    env: providers.env,
+    recommendations,
+    daily_use: {
+      chat: "GUNLUK.md — natural language tasks",
+      heavy: "/blueprint then /forge (challenge gate before forge)",
+      memory: "agentmemory MCP + HANDOFF/DONE at session end",
+      graph: graph_paths.cursor_command
+    }
+  };
+}
+
+async function runStackSetup(rootDir, { installGraphifyRule = true } = {}) {
+  const doctorBefore = await runStackDoctor(rootDir);
+  const steps = [];
+
+  if (doctorBefore.layers.layer_routing.status !== "ok") {
+    steps.push({ id: "init", status: "required", action: "capint init [--bundle full]" });
+  } else {
+    steps.push({ id: "init", status: "ok", action: "CapInt scaffold present" });
+  }
+
+  if (installGraphifyRule && !fileExists(rootDir, ".cursor/rules/graphify.mdc")) {
+    const inst = tryGraphifyCursorInstall(rootDir);
+    steps.push({
+      id: "graphify_cursor",
+      status: inst.ok ? "ok" : "manual",
+      action: inst.ok ? "graphify install cursor --project" : "uv tool install graphifyy && graphify install cursor --project",
+      detail: inst.ok ? inst.path : inst.error
+    });
+  } else {
+    steps.push({ id: "graphify_cursor", status: "ok", action: ".cursor/rules/graphify.mdc" });
+  }
+
+  steps.push({
+    id: "graph_build",
+    status: doctorBefore.providers.tiers.tier1_graphify.status === "ok" ? "ok" : "manual",
+    action: doctorBefore.graph_paths.cursor_command,
+    then: "capint stack graph sync"
+  });
+
+  steps.push({
+    id: "agentmemory",
+    status: doctorBefore.providers.tiers.tier2_agentmemory.status === "ok" ? "ok" : "manual",
+    action: "agentmemory (separate terminal) + ~/.cursor/mcp.json agentmemory block",
+    doc: "https://github.com/rohitg00/agentmemory#other-agents"
+  });
+
+  const manifest = writeStackManifest(rootDir, doctorBefore);
+
+  return {
+    doc: STACK_DOC,
+    manifest,
+    steps,
+    doctor: await runStackDoctor(rootDir)
+  };
+}
+
+function formatStackSummary(report) {
+  const lines = [];
+  lines.push("CapInt stack (4 layers):");
+  lines.push(`  1. Workflows  ${report.layers.layer_workflows.status}  — ANWS-style gates (/forge, /challenge)`);
+  lines.push(`  2. Routing    ${report.layers.layer_routing.status}  — capint route + HANDOFF/GUNLUK`);
+  lines.push(`  3. Graph      ${report.providers.tiers.tier1_graphify.status}  — graphify → CapInt reads artifacts`);
+  lines.push(`  4. Memory     ${report.providers.tiers.tier2_agentmemory.status}  — agentmemory sidecar + MCP`);
+  lines.push(`  Stack ready: ${report.stack_ready ? "yes" : "no"} — doc: ${report.doc}`);
+  return lines.join("\n");
+}
+
+module.exports = {
+  STACK_DOC,
+  STACK_MANIFEST,
+  detectGraphPaths,
+  syncGraphArtifacts,
+  runStackDoctor,
+  runStackSetup,
+  formatStackSummary,
+  tierWorkflows,
+  tierRouting
+};

package/src/lib/ui-server.js

@@ -4,6 +4,10 @@ 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",
@@ -42,8 +46,14 @@ function json(res, status, data) {
   res.end(body);
 }
 
-function projectHealth(rootDir) {
-  const doctor = runDoctor(rootDir);
+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,
@@ -72,6 +82,9 @@ function buildChatCopy(result) {
     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}`);
@@ -79,13 +92,34 @@ function buildChatCopy(result) {
   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));
+      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") {
@@ -93,7 +127,16 @@ function createUiServer({ rootDir, uiDir = pkgUiDir(), port = 3721, host = "127.
         const body = await readBody(req);
         const task = String(body.task || "").trim();
         if (!task) return json(res, 400, { error: "task required" });
-        const result = routeTask(task, rootDir);
+        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,
@@ -105,6 +148,44 @@ function createUiServer({ rootDir, uiDir = pkgUiDir(), port = 3721, host = "127.
       }
     }
 
+    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);
@@ -136,4 +217,10 @@ function createUiServer({ rootDir, uiDir = pkgUiDir(), port = 3721, host = "127.
   };
 }
 
-module.exports = { createUiServer, projectHealth, buildChatCopy, pkgUiDir };
+module.exports = {
+  createUiServer,
+  projectHealth,
+  buildChatCopy,
+  applyDoctorAction,
+  pkgUiDir
+};

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

@@ -2,11 +2,25 @@
 
 > **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`), **sorun** (`doctor`), **IDE kuralı** (`ide sync`).
+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

@@ -16,7 +16,9 @@ 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; `DONE.md` + `HANDOFF.md` günceller |
+
+**Kapanış:** `kapan` veya `HANDOFF + DONE güncelle`
 
 **Yazmana gerek yok:** Skill adları, `capint route` çıktısı, matrix jargonu.
 

package/ui/app.js

@@ -1,4 +1,6 @@
 let routePayload = null;
+let healthPayload = null;
+let selectedRating = null;
 
 function showStep(n) {
   document.querySelectorAll(".step-tab").forEach((el) => {
@@ -28,15 +30,32 @@ async function fetchHealth() {
   return res.json();
 }
 
+function renderRecoverCard(data) {
+  const card = document.getElementById("recover-card");
+  const summary = document.getElementById("recover-summary");
+  const btn = document.getElementById("btn-recover");
+  const actions = data.doctor?.actions || [];
+  if (data.ok || !actions.length) {
+    card.hidden = true;
+    btn.dataset.actionId = "";
+    return;
+  }
+  card.hidden = false;
+  summary.textContent = data.doctor.summary_plain || data.doctor.hint;
+  btn.dataset.actionId = actions[0].id;
+  btn.textContent = actions[0].label || "Düzelt";
+}
+
 function formatHealth(data) {
   const d = data.doctor;
   const s = data.status;
   const lines = [
-    data.ok ? "✓ Doctor: OK" : "✗ Doctor: issues found",
+    data.ok ? "✓ Doctor: OK" : "✗ Doctor: sorun var",
     `Skills on disk: ${s.skills_on_disk}`,
     `Matrix: ${s.matrix_version || "—"}`,
     `CapInt pkg: ${s.capint_package || "—"}`
   ];
+  if (d.summary_plain) lines.push("", d.summary_plain);
   if (d.warnings?.length) {
     lines.push("", "Warnings:");
     for (const w of d.warnings.slice(0, 5)) lines.push(`  • ${w}`);
@@ -49,20 +68,33 @@ function formatHealth(data) {
   return lines.join("\n");
 }
 
+function escapeHtml(s) {
+  return String(s)
+    .replace(/&/g, "&")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+}
+
 function renderPlan(payload) {
   const ei = payload.result.execution_intent;
   const ex = ei.explanation || {};
   const card = document.getElementById("plan-card");
-  const files = (ex.files_to_read || []).map((f) => `<li><code>${f}</code></li>`).join("");
+  const files = (ex.files_to_read || []).map((f) => `<li><code>${escapeHtml(f)}</code></li>`).join("");
+  const plain = ex.reason_plain ? `<p class="plain">${escapeHtml(ex.reason_plain)}</p>` : "";
+  const tip = ex.tooltip ? `<p class="hint"><span class="tip" title="${escapeHtml(ex.tooltip)}">ⓘ</span> ${escapeHtml(ex.tooltip)}</p>` : "";
+  const technical = ex.reason_summary
+    ? `<details><summary>Teknik detay</summary><p>${escapeHtml(ex.reason_summary)}</p></details>`
+    : "";
   const boundary = ei.workspace_boundary?.violated
-    ? `<p class="error">Workspace sınırı: ${ei.workspace_boundary.override_hint}</p>`
+    ? `<p class="error">Workspace sınırı: ${escapeHtml(ei.workspace_boundary.override_hint || "")}</p>`
     : "";
   card.innerHTML = `
     <dl>
-      <dt>Capability</dt><dd>${ei.capability}</dd>
-      <dt>Resolution</dt><dd>${ei.resolution} (${ei.resolution_status || "installed"})</dd>
-      <dt>Neden</dt><dd>${ex.reason_summary || "—"}</dd>
-      <dt>Keywords</dt><dd>${(ex.matched_keywords || []).join(", ") || "—"}</dd>
+      <dt>Capability</dt><dd>${escapeHtml(ei.capability)}</dd>
+      <dt>Resolution</dt><dd>${escapeHtml(ei.resolution)} (${escapeHtml(ei.resolution_status || "installed")})</dd>
+      <dt>Neden</dt><dd>${plain}${tip}${technical}</dd>
+      <dt>Keywords</dt><dd>${escapeHtml((ex.matched_keywords || []).join(", ") || "—")}</dd>
       <dt>Okunacak dosyalar</dt><dd><ul>${files || "<li>—</li>"}</ul></dd>
     </dl>
     ${boundary}
@@ -86,14 +118,40 @@ document.getElementById("btn-health").addEventListener("click", async () => {
   out.textContent = "Kontrol ediliyor…";
   try {
     const data = await fetchHealth();
+    healthPayload = data;
     out.textContent = formatHealth(data);
-    next.disabled = false;
+    renderRecoverCard(data);
+    next.disabled = !data.ok && (data.doctor?.actions || []).length > 0 ? false : !data.ok;
+    if (data.ok) next.disabled = false;
   } catch (e) {
     out.textContent = `Hata: ${e.message}`;
     next.disabled = true;
   }
 });
 
+document.getElementById("btn-recover").addEventListener("click", async () => {
+  const actionId = document.getElementById("btn-recover").dataset.actionId;
+  if (!actionId) return;
+  if (!window.confirm("Önerilen düzeltmeyi uygulamak istiyor musun?")) return;
+  const out = document.getElementById("health-out");
+  out.textContent = "Düzeltiliyor…";
+  try {
+    const res = await fetch("/api/recover", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ apply: true, action_id: actionId })
+    });
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.error || "Recover failed");
+    healthPayload = data.health;
+    out.textContent = formatHealth(data.health);
+    renderRecoverCard(data.health);
+    document.getElementById("to-step-2").disabled = !data.health.ok;
+  } catch (e) {
+    out.textContent = `Hata: ${e.message}`;
+  }
+});
+
 document.getElementById("to-step-2").addEventListener("click", () => showStep(2));
 
 document.getElementById("btn-route").addEventListener("click", async () => {
@@ -111,8 +169,8 @@ document.getElementById("btn-route").addEventListener("click", async () => {
   try {
     const res = await fetch("/api/route", {
       method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ task })
+      headers: { "Content-Type": "application/json", "Accept-Language": "tr" },
+      body: JSON.stringify({ task, locale: "tr" })
     });
     const data = await res.json();
     if (!res.ok) throw new Error(data.error || "Route failed");
@@ -158,10 +216,42 @@ document.getElementById("btn-copy").addEventListener("click", async () => {
 
 document.getElementById("btn-restart").addEventListener("click", () => {
   routePayload = null;
+  selectedRating = null;
   document.getElementById("task-input").value = "";
   document.getElementById("chat-copy").value = "";
   document.getElementById("copy-status").textContent = "";
+  document.getElementById("feedback-status").textContent = "";
+  document.getElementById("feedback-comment").value = "";
+  document.querySelectorAll("#feedback-stars button").forEach((b) => b.classList.remove("active"));
   showStep(2);
 });
 
+document.querySelectorAll("#feedback-stars button").forEach((btn) => {
+  btn.addEventListener("click", () => {
+    selectedRating = Number(btn.dataset.rating);
+    document.querySelectorAll("#feedback-stars button").forEach((b) => b.classList.remove("active"));
+    btn.classList.add("active");
+  });
+});
+
+document.getElementById("btn-feedback").addEventListener("click", async () => {
+  const status = document.getElementById("feedback-status");
+  try {
+    const res = await fetch("/api/feedback", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        rating: selectedRating,
+        comment: document.getElementById("feedback-comment").value,
+        source: "ui"
+      })
+    });
+    const data = await res.json();
+    if (!res.ok) throw new Error(data.error || "Feedback failed");
+    status.textContent = "Teşekkürler — geri bildirim kaydedildi (yerel).";
+  } catch (e) {
+    status.textContent = e.message;
+  }
+});
+
 showStep(1);

package/ui/index.html

@@ -11,6 +11,9 @@
       <header class="header">
         <h1>CapInt</h1>
         <p class="subtitle">Terminal yok — görevini yaz, planı gör, chat'e kopyala.</p>
+        <p class="hint">
+          <a href="https://github.com/bcelep/capint/blob/main/docs/kullanim-kilavuzu.md" target="_blank" rel="noopener">SSS / kullanım kılavuzu</a>
+        </p>
       </header>
 
       <nav class="steps" aria-label="Adımlar">
@@ -23,11 +26,16 @@
       <section class="panel active" data-panel="1">
         <h2>Proje hazır mı?</h2>
         <p class="hint">
-          <span class="tip" title="installed = skills/ klasöründe SKILL.md var. Cursor skill listesinde görünmesi gerekmez.">ⓘ</span>
+          <span class="tip" id="tip-installed" title="installed = skills/ klasöründe SKILL.md var. Cursor skill listesinde görünmesi gerekmez.">ⓘ</span>
           Skill'ler diskte yüklü mü? Doctor kontrol eder.
         </p>
         <button type="button" class="btn primary" id="btn-health">Kontrol et</button>
         <pre class="output" id="health-out" aria-live="polite"></pre>
+        <div id="recover-card" class="card recover-card" hidden>
+          <h3>Önerilen düzeltme</h3>
+          <p id="recover-summary"></p>
+          <button type="button" class="btn primary" id="btn-recover">Düzelt</button>
+        </div>
         <div class="actions">
           <button type="button" class="btn" id="to-step-2" disabled>Devam →</button>
         </div>
@@ -68,6 +76,19 @@
           <button type="button" class="btn" id="btn-restart">Yeni görev</button>
         </div>
         <p class="copy-status" id="copy-status" aria-live="polite"></p>
+        <fieldset class="feedback-field">
+          <legend>Bu akış işine yaradı mı?</legend>
+          <div class="stars" id="feedback-stars">
+            <button type="button" data-rating="1">1</button>
+            <button type="button" data-rating="2">2</button>
+            <button type="button" data-rating="3">3</button>
+            <button type="button" data-rating="4">4</button>
+            <button type="button" data-rating="5">5</button>
+          </div>
+          <textarea id="feedback-comment" rows="2" placeholder="İsteğe bağlı yorum"></textarea>
+          <button type="button" class="btn" id="btn-feedback">Geri bildirim gönder</button>
+          <p id="feedback-status" class="copy-status" aria-live="polite"></p>
+        </fieldset>
       </section>
     </main>
     <script src="/app.js"></script>