@kody-ade/kody-engine 0.3.5 → 0.3.7

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.3.5",
+  version: "0.3.7",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -50,9 +50,9 @@ var package_default = {
 };
 
 // src/chat-cli.ts
-import { execFileSync as execFileSync21 } from "child_process";
-import * as fs22 from "fs";
-import * as path19 from "path";
+import { execFileSync as execFileSync22 } from "child_process";
+import * as fs23 from "fs";
+import * as path20 from "path";
 
 // src/chat/events.ts
 import * as fs from "fs";
@@ -263,7 +263,7 @@ function renderEvent(msg, opts = {}) {
   }
   switch (msg.type) {
     case "system":
-      return null;
+      return formatSystemEvent(msg);
     case "assistant":
       return formatAssistant(msg, opts);
     case "user":
@@ -309,6 +309,14 @@ ${truncate(text, 4e3)}`);
   }
   return lines.length > 0 ? lines.join("\n") : null;
 }
+function formatSystemEvent(msg) {
+  if (msg.subtype !== "init") return null;
+  const servers = msg.mcp_servers ?? [];
+  if (servers.length === 0) return null;
+  const lines = servers.map((s) => `  - ${s.name}: ${s.status ?? "unknown"}`);
+  return `[mcp servers]
+${lines.join("\n")}`;
+}
 function formatResult(msg) {
   const ok = msg.subtype === "success";
   const tag = ok ? "SESSION ok" : `SESSION failed (${msg.subtype ?? "unknown"})`;
@@ -568,9 +576,9 @@ async function emit(sink, type, sessionId, suffix, payload) {
 }
 
 // src/kody-cli.ts
-import { execFileSync as execFileSync20 } from "child_process";
-import * as fs21 from "fs";
-import * as path18 from "path";
+import { execFileSync as execFileSync21 } from "child_process";
+import * as fs22 from "fs";
+import * as path19 from "path";
 
 // src/dispatch.ts
 import * as fs6 from "fs";
@@ -787,8 +795,8 @@ function coerceBare(spec, value) {
 }
 
 // src/executor.ts
-import * as fs20 from "fs";
-import * as path17 from "path";
+import * as fs21 from "fs";
+import * as path18 from "path";
 
 // src/litellm.ts
 import { execFileSync, spawn } from "child_process";
@@ -2036,18 +2044,53 @@ function formatToolsUsage(profile) {
   return lines.join("\n");
 }
 
+// src/scripts/diagMcp.ts
+import { execFileSync as execFileSync7 } from "child_process";
+import * as fs13 from "fs";
+import * as os3 from "os";
+import * as path12 from "path";
+var diagMcp = async (_ctx) => {
+  const home = os3.homedir();
+  const cacheDir = path12.join(home, ".cache", "ms-playwright");
+  let entries = [];
+  try {
+    entries = fs13.readdirSync(cacheDir);
+  } catch {
+  }
+  const hasChromium = entries.some((e) => e.startsWith("chromium"));
+  process.stderr.write(
+    `[kody diag] ms-playwright cache: ${entries.length === 0 ? "EMPTY (or missing)" : entries.join(", ")}
+`
+  );
+  process.stderr.write(`[kody diag] chromium present: ${hasChromium ? "yes" : "no"}
+`);
+  try {
+    const v = execFileSync7("npx", ["-y", "@playwright/mcp@latest", "--version"], {
+      stdio: "pipe",
+      timeout: 6e4,
+      encoding: "utf8"
+    }).trim();
+    process.stderr.write(`[kody diag] @playwright/mcp version: ${v}
+`);
+  } catch (e) {
+    const err = e instanceof Error ? e.message : String(e);
+    process.stderr.write(`[kody diag] @playwright/mcp spawn FAILED: ${err}
+`);
+  }
+};
+
 // src/scripts/discoverQaContext.ts
-import * as fs14 from "fs";
-import * as path13 from "path";
+import * as fs15 from "fs";
+import * as path14 from "path";
 
 // src/scripts/frameworkDetectors.ts
-import * as fs13 from "fs";
-import * as path12 from "path";
+import * as fs14 from "fs";
+import * as path13 from "path";
 function detectFrameworks(cwd) {
   const out = [];
   let deps = {};
   try {
-    const pkg = JSON.parse(fs13.readFileSync(path12.join(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs14.readFileSync(path13.join(cwd, "package.json"), "utf-8"));
     deps = { ...pkg.dependencies, ...pkg.devDependencies };
   } catch {
     return out;
@@ -2084,7 +2127,7 @@ function detectFrameworks(cwd) {
 }
 function findFile(cwd, candidates) {
   for (const c of candidates) {
-    if (fs13.existsSync(path12.join(cwd, c))) return c;
+    if (fs14.existsSync(path13.join(cwd, c))) return c;
   }
   return null;
 }
@@ -2097,18 +2140,18 @@ var COLLECTION_DIRS = [
 function discoverPayloadCollections(cwd) {
   const out = [];
   for (const dir of COLLECTION_DIRS) {
-    const full = path12.join(cwd, dir);
-    if (!fs13.existsSync(full)) continue;
+    const full = path13.join(cwd, dir);
+    if (!fs14.existsSync(full)) continue;
     let files;
     try {
-      files = fs13.readdirSync(full).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
+      files = fs14.readdirSync(full).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
     } catch {
       continue;
     }
     for (const file of files) {
       try {
-        const filePath = path12.join(full, file);
-        const content = fs13.readFileSync(filePath, "utf-8").slice(0, 1e4);
+        const filePath = path13.join(full, file);
+        const content = fs14.readFileSync(filePath, "utf-8").slice(0, 1e4);
         const slugMatch = content.match(/slug:\s*['"]([a-z0-9-]+)['"]/);
         if (!slugMatch) continue;
         const slug = slugMatch[1];
@@ -2122,7 +2165,7 @@ function discoverPayloadCollections(cwd) {
         out.push({
           name,
           slug,
-          filePath: path12.relative(cwd, filePath),
+          filePath: path13.relative(cwd, filePath),
           fields: fields.slice(0, 20),
           hasAdmin
         });
@@ -2136,28 +2179,28 @@ var ADMIN_COMPONENT_DIRS = ["src/ui/admin", "src/admin/components", "src/compone
 function discoverAdminComponents(cwd, collections) {
   const out = [];
   for (const dir of ADMIN_COMPONENT_DIRS) {
-    const full = path12.join(cwd, dir);
-    if (!fs13.existsSync(full)) continue;
+    const full = path13.join(cwd, dir);
+    if (!fs14.existsSync(full)) continue;
     let entries;
     try {
-      entries = fs13.readdirSync(full, { withFileTypes: true });
+      entries = fs14.readdirSync(full, { withFileTypes: true });
     } catch {
       continue;
     }
     for (const entry of entries) {
-      const entryPath = path12.join(full, entry.name);
+      const entryPath = path13.join(full, entry.name);
       let name;
       let filePath;
       if (entry.isDirectory()) {
         const indexFile = ["index.tsx", "index.ts", "index.jsx", "index.js"].find(
-          (f) => fs13.existsSync(path12.join(entryPath, f))
+          (f) => fs14.existsSync(path13.join(entryPath, f))
         );
         if (!indexFile) continue;
         name = entry.name;
-        filePath = path12.relative(cwd, path12.join(entryPath, indexFile));
+        filePath = path13.relative(cwd, path13.join(entryPath, indexFile));
       } else if (/\.(tsx?|jsx?)$/.test(entry.name)) {
         name = entry.name.replace(/\.(tsx?|jsx?)$/, "");
-        filePath = path12.relative(cwd, entryPath);
+        filePath = path13.relative(cwd, entryPath);
       } else {
         continue;
       }
@@ -2165,7 +2208,7 @@ function discoverAdminComponents(cwd, collections) {
       if (collections) {
         for (const col of collections) {
           try {
-            const colContent = fs13.readFileSync(path12.join(cwd, col.filePath), "utf-8");
+            const colContent = fs14.readFileSync(path13.join(cwd, col.filePath), "utf-8");
             if (colContent.includes(name)) {
               usedInCollection = col.slug;
               break;
@@ -2184,8 +2227,8 @@ function scanApiRoutes(cwd) {
   const out = [];
   const appDirs = ["src/app", "app"];
   for (const appDir of appDirs) {
-    const apiDir = path12.join(cwd, appDir, "api");
-    if (!fs13.existsSync(apiDir)) continue;
+    const apiDir = path13.join(cwd, appDir, "api");
+    if (!fs14.existsSync(apiDir)) continue;
     walkApiRoutes(apiDir, "/api", cwd, out);
     break;
   }
@@ -2194,20 +2237,20 @@ function scanApiRoutes(cwd) {
 function walkApiRoutes(dir, prefix, cwd, out) {
   let entries;
   try {
-    entries = fs13.readdirSync(dir, { withFileTypes: true });
+    entries = fs14.readdirSync(dir, { withFileTypes: true });
   } catch {
     return;
   }
   const routeFile = entries.find((e) => e.isFile() && /^route\.(ts|js|tsx|jsx)$/.test(e.name));
   if (routeFile) {
     try {
-      const content = fs13.readFileSync(path12.join(dir, routeFile.name), "utf-8").slice(0, 5e3);
+      const content = fs14.readFileSync(path13.join(dir, routeFile.name), "utf-8").slice(0, 5e3);
       const methods = HTTP_METHODS.filter((m) => new RegExp(`export\\s+(?:async\\s+)?function\\s+${m}\\b`).test(content));
       if (methods.length > 0) {
         out.push({
           path: prefix,
           methods,
-          filePath: path12.relative(cwd, path12.join(dir, routeFile.name))
+          filePath: path13.relative(cwd, path13.join(dir, routeFile.name))
         });
       }
     } catch {
@@ -2218,7 +2261,7 @@ function walkApiRoutes(dir, prefix, cwd, out) {
     if (entry.name === "node_modules" || entry.name === ".next") continue;
     let segment = entry.name;
     if (segment.startsWith("(") && segment.endsWith(")")) {
-      walkApiRoutes(path12.join(dir, entry.name), prefix, cwd, out);
+      walkApiRoutes(path13.join(dir, entry.name), prefix, cwd, out);
       continue;
     }
     if (segment.startsWith("[[") && segment.endsWith("]]")) {
@@ -2226,7 +2269,7 @@ function walkApiRoutes(dir, prefix, cwd, out) {
     } else if (segment.startsWith("[") && segment.endsWith("]")) {
       segment = `:${segment.slice(1, -1)}`;
     }
-    walkApiRoutes(path12.join(dir, entry.name), `${prefix}/${segment}`, cwd, out);
+    walkApiRoutes(path13.join(dir, entry.name), `${prefix}/${segment}`, cwd, out);
   }
 }
 var BUILTIN_ENV_VARS = /* @__PURE__ */ new Set([
@@ -2246,10 +2289,10 @@ var BUILTIN_ENV_VARS = /* @__PURE__ */ new Set([
 function scanEnvVars(cwd) {
   const candidates = [".env.example", ".env.local.example", ".env.template"];
   for (const envFile of candidates) {
-    const envPath = path12.join(cwd, envFile);
-    if (!fs13.existsSync(envPath)) continue;
+    const envPath = path13.join(cwd, envFile);
+    if (!fs14.existsSync(envPath)) continue;
     try {
-      const content = fs13.readFileSync(envPath, "utf-8");
+      const content = fs14.readFileSync(envPath, "utf-8");
       const vars = [];
       for (const line of content.split("\n")) {
         const trimmed = line.trim();
@@ -2297,9 +2340,9 @@ function runQaDiscovery(cwd) {
 }
 function detectDevServer(cwd, out) {
   try {
-    const pkg = JSON.parse(fs14.readFileSync(path13.join(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs15.readFileSync(path14.join(cwd, "package.json"), "utf-8"));
     const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
-    const pm = fs14.existsSync(path13.join(cwd, "pnpm-lock.yaml")) ? "pnpm" : fs14.existsSync(path13.join(cwd, "yarn.lock")) ? "yarn" : fs14.existsSync(path13.join(cwd, "bun.lockb")) ? "bun" : "npm";
+    const pm = fs15.existsSync(path14.join(cwd, "pnpm-lock.yaml")) ? "pnpm" : fs15.existsSync(path14.join(cwd, "yarn.lock")) ? "yarn" : fs15.existsSync(path14.join(cwd, "bun.lockb")) ? "bun" : "npm";
     if (pkg.scripts?.dev) out.devCommand = `${pm} dev`;
     if (allDeps.next || allDeps.nuxt) out.devPort = 3e3;
     else if (allDeps.vite) out.devPort = 5173;
@@ -2309,8 +2352,8 @@ function detectDevServer(cwd, out) {
 function scanFrontendRoutes(cwd, out) {
   const appDirs = ["src/app", "app"];
   for (const appDir of appDirs) {
-    const full = path13.join(cwd, appDir);
-    if (!fs14.existsSync(full)) continue;
+    const full = path14.join(cwd, appDir);
+    if (!fs15.existsSync(full)) continue;
     walkFrontendRoutes(full, "", out);
     break;
   }
@@ -2318,7 +2361,7 @@ function scanFrontendRoutes(cwd, out) {
 function walkFrontendRoutes(dir, prefix, out) {
   let entries;
   try {
-    entries = fs14.readdirSync(dir, { withFileTypes: true });
+    entries = fs15.readdirSync(dir, { withFileTypes: true });
   } catch {
     return;
   }
@@ -2335,7 +2378,7 @@ function walkFrontendRoutes(dir, prefix, out) {
     if (entry.name === "node_modules" || entry.name === ".next") continue;
     let segment = entry.name;
     if (segment.startsWith("(") && segment.endsWith(")")) {
-      walkFrontendRoutes(path13.join(dir, entry.name), prefix, out);
+      walkFrontendRoutes(path14.join(dir, entry.name), prefix, out);
       continue;
     }
     if (segment.startsWith("[[") && segment.endsWith("]]")) {
@@ -2343,7 +2386,7 @@ function walkFrontendRoutes(dir, prefix, out) {
     } else if (segment.startsWith("[") && segment.endsWith("]")) {
       segment = `:${segment.slice(1, -1)}`;
     }
-    walkFrontendRoutes(path13.join(dir, entry.name), `${prefix}/${segment}`, out);
+    walkFrontendRoutes(path14.join(dir, entry.name), `${prefix}/${segment}`, out);
   }
 }
 function detectAuthFiles(cwd, out) {
@@ -2360,23 +2403,23 @@ function detectAuthFiles(cwd, out) {
     "src/app/api/oauth"
   ];
   for (const c of candidates) {
-    if (fs14.existsSync(path13.join(cwd, c))) out.authFiles.push(c);
+    if (fs15.existsSync(path14.join(cwd, c))) out.authFiles.push(c);
   }
 }
 function detectRoles(cwd, out) {
   const rolePaths = ["src/types", "src/lib", "src/utils", "src/constants", "src/access", "src/collections"];
   for (const rp of rolePaths) {
-    const dir = path13.join(cwd, rp);
-    if (!fs14.existsSync(dir)) continue;
+    const dir = path14.join(cwd, rp);
+    if (!fs15.existsSync(dir)) continue;
     let files;
     try {
-      files = fs14.readdirSync(dir).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
+      files = fs15.readdirSync(dir).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
     } catch {
       continue;
     }
     for (const f of files) {
       try {
-        const content = fs14.readFileSync(path13.join(dir, f), "utf-8").slice(0, 5e3);
+        const content = fs15.readFileSync(path14.join(dir, f), "utf-8").slice(0, 5e3);
         const roleMatches = content.match(/(?:role|Role|ROLE)\s*[=:]\s*['"](\w+)['"]/g);
         if (roleMatches) {
           for (const m of roleMatches) {
@@ -2522,7 +2565,7 @@ var discoverQaContext = async (ctx) => {
 };
 
 // src/scripts/dispatch.ts
-import { execFileSync as execFileSync7 } from "child_process";
+import { execFileSync as execFileSync8 } from "child_process";
 var API_TIMEOUT_MS3 = 3e4;
 var dispatch = async (ctx, _profile, _agentResult, args) => {
   const next = args?.next;
@@ -2545,7 +2588,7 @@ var dispatch = async (ctx, _profile, _agentResult, args) => {
   const sub = usePr ? "pr" : "issue";
   const body = `@kody ${next}`;
   try {
-    execFileSync7("gh", [sub, "comment", String(targetNumber), "--body", body], {
+    execFileSync8("gh", [sub, "comment", String(targetNumber), "--body", body], {
       timeout: API_TIMEOUT_MS3,
       cwd: ctx.cwd,
       stdio: ["ignore", "pipe", "pipe"]
@@ -2565,7 +2608,7 @@ function parsePr(url) {
 }
 
 // src/issue.ts
-import { execFileSync as execFileSync8 } from "child_process";
+import { execFileSync as execFileSync9 } from "child_process";
 var API_TIMEOUT_MS4 = 3e4;
 function ghToken2() {
   return process.env.GH_PAT?.trim() || process.env.GH_TOKEN;
@@ -2573,7 +2616,7 @@ function ghToken2() {
 function gh2(args, options) {
   const token = ghToken2();
   const env = token ? { ...process.env, GH_TOKEN: token } : { ...process.env };
-  return execFileSync8("gh", args, {
+  return execFileSync9("gh", args, {
     encoding: "utf-8",
     timeout: API_TIMEOUT_MS4,
     cwd: options?.cwd,
@@ -2861,7 +2904,7 @@ function computeFailureReason(ctx) {
 }
 
 // src/scripts/finishFlow.ts
-import { execFileSync as execFileSync9 } from "child_process";
+import { execFileSync as execFileSync10 } from "child_process";
 
 // src/lifecycleLabels.ts
 var KODY_NAMESPACE = "kody";
@@ -3020,7 +3063,7 @@ var finishFlow = async (ctx, _profile, _agentResult, args) => {
 **PR:** ${state.core.prUrl}` : "";
   const body = `${icon} kody flow \`${flowName}\` finished \u2014 \`${reason}\`${prSuffix}`;
   try {
-    execFileSync9("gh", ["issue", "comment", String(issueNumber), "--body", body], {
+    execFileSync10("gh", ["issue", "comment", String(issueNumber), "--body", body], {
       timeout: API_TIMEOUT_MS5,
       cwd: ctx.cwd,
       stdio: ["ignore", "pipe", "pipe"]
@@ -3034,7 +3077,7 @@ var finishFlow = async (ctx, _profile, _agentResult, args) => {
 };
 
 // src/branch.ts
-import { execFileSync as execFileSync10 } from "child_process";
+import { execFileSync as execFileSync11 } from "child_process";
 var UncommittedChangesError = class extends Error {
   constructor(branch) {
     super(`Uncommitted changes on branch '${branch}' \u2014 refusing to run to protect work in progress`);
@@ -3044,7 +3087,7 @@ var UncommittedChangesError = class extends Error {
   branch;
 };
 function git2(args, cwd) {
-  return execFileSync10("git", args, {
+  return execFileSync11("git", args, {
     encoding: "utf-8",
     timeout: 3e4,
     cwd,
@@ -3069,7 +3112,7 @@ function checkoutPrBranch(prNumber, cwd) {
     SKIP_HOOKS: "1",
     GH_TOKEN: process.env.GH_PAT?.trim() || process.env.GH_TOKEN || ""
   };
-  execFileSync10("gh", ["pr", "checkout", String(prNumber)], {
+  execFileSync11("gh", ["pr", "checkout", String(prNumber)], {
     cwd,
     env,
     stdio: ["ignore", "pipe", "pipe"],
@@ -3136,8 +3179,8 @@ function ensureFeatureBranch(issueNumber, title, defaultBranch, cwd) {
 }
 
 // src/gha.ts
-import { execFileSync as execFileSync11 } from "child_process";
-import * as fs15 from "fs";
+import { execFileSync as execFileSync12 } from "child_process";
+import * as fs16 from "fs";
 function getRunUrl() {
   const server = process.env.GITHUB_SERVER_URL;
   const repo = process.env.GITHUB_REPOSITORY;
@@ -3148,10 +3191,10 @@ function getRunUrl() {
 function reactToTriggerComment(cwd) {
   if (process.env.GITHUB_EVENT_NAME !== "issue_comment") return;
   const eventPath = process.env.GITHUB_EVENT_PATH;
-  if (!eventPath || !fs15.existsSync(eventPath)) return;
+  if (!eventPath || !fs16.existsSync(eventPath)) return;
   let event = null;
   try {
-    event = JSON.parse(fs15.readFileSync(eventPath, "utf-8"));
+    event = JSON.parse(fs16.readFileSync(eventPath, "utf-8"));
   } catch {
     return;
   }
@@ -3179,7 +3222,7 @@ function reactToTriggerComment(cwd) {
   for (let attempt = 0; attempt < 3; attempt++) {
     if (attempt > 0) sleepMs(attempt === 1 ? 500 : 1500);
     try {
-      execFileSync11("gh", args, opts);
+      execFileSync12("gh", args, opts);
       return;
     } catch (err) {
       lastErr = err;
@@ -3192,13 +3235,13 @@ function reactToTriggerComment(cwd) {
 }
 function sleepMs(ms) {
   try {
-    execFileSync11("sleep", [(ms / 1e3).toString()], { stdio: "ignore", timeout: ms + 1e3 });
+    execFileSync12("sleep", [(ms / 1e3).toString()], { stdio: "ignore", timeout: ms + 1e3 });
   } catch {
   }
 }
 
 // src/workflow.ts
-import { execFileSync as execFileSync12 } from "child_process";
+import { execFileSync as execFileSync13 } from "child_process";
 var GH_TIMEOUT_MS = 3e4;
 function ghToken3() {
   return process.env.GH_PAT?.trim() || process.env.GH_TOKEN;
@@ -3206,7 +3249,7 @@ function ghToken3() {
 function gh3(args, cwd) {
   const token = ghToken3();
   const env = token ? { ...process.env, GH_TOKEN: token } : { ...process.env };
-  return execFileSync12("gh", args, {
+  return execFileSync13("gh", args, {
     encoding: "utf-8",
     timeout: GH_TIMEOUT_MS,
     cwd,
@@ -3390,23 +3433,23 @@ function tryPostPr2(prNumber, body, cwd) {
 }
 
 // src/scripts/initFlow.ts
-import { execFileSync as execFileSync13 } from "child_process";
-import * as fs17 from "fs";
-import * as path15 from "path";
+import { execFileSync as execFileSync14 } from "child_process";
+import * as fs18 from "fs";
+import * as path16 from "path";
 
 // src/scripts/loadQaGuide.ts
-import * as fs16 from "fs";
-import * as path14 from "path";
+import * as fs17 from "fs";
+import * as path15 from "path";
 var QA_GUIDE_REL_PATH = ".kody/qa-guide.md";
 var loadQaGuide = async (ctx) => {
-  const full = path14.join(ctx.cwd, QA_GUIDE_REL_PATH);
-  if (!fs16.existsSync(full)) {
+  const full = path15.join(ctx.cwd, QA_GUIDE_REL_PATH);
+  if (!fs17.existsSync(full)) {
     ctx.data.qaGuide = "";
     ctx.data.qaGuidePath = "";
     return;
   }
   try {
-    ctx.data.qaGuide = fs16.readFileSync(full, "utf-8");
+    ctx.data.qaGuide = fs17.readFileSync(full, "utf-8");
     ctx.data.qaGuidePath = QA_GUIDE_REL_PATH;
   } catch {
     ctx.data.qaGuide = "";
@@ -3416,9 +3459,9 @@ var loadQaGuide = async (ctx) => {
 
 // src/scripts/initFlow.ts
 function detectPackageManager(cwd) {
-  if (fs17.existsSync(path15.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs17.existsSync(path15.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs17.existsSync(path15.join(cwd, "bun.lockb"))) return "bun";
+  if (fs18.existsSync(path16.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs18.existsSync(path16.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs18.existsSync(path16.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function qualityCommandsFor(pm) {
@@ -3431,7 +3474,7 @@ function qualityCommandsFor(pm) {
 function detectOwnerRepo(cwd) {
   let url;
   try {
-    url = execFileSync13("git", ["remote", "get-url", "origin"], {
+    url = execFileSync14("git", ["remote", "get-url", "origin"], {
       cwd,
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "pipe"]
@@ -3515,7 +3558,7 @@ jobs:
 `;
 function defaultBranchFromGit(cwd) {
   try {
-    const ref = execFileSync13("git", ["symbolic-ref", "refs/remotes/origin/HEAD"], {
+    const ref = execFileSync14("git", ["symbolic-ref", "refs/remotes/origin/HEAD"], {
       cwd,
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "pipe"]
@@ -3523,7 +3566,7 @@ function defaultBranchFromGit(cwd) {
     return ref.replace("refs/remotes/origin/", "");
   } catch {
     try {
-      return execFileSync13("git", ["branch", "--show-current"], {
+      return execFileSync14("git", ["branch", "--show-current"], {
         cwd,
         encoding: "utf-8",
         stdio: ["ignore", "pipe", "pipe"]
@@ -3539,33 +3582,33 @@ function performInit(cwd, force) {
   const pm = detectPackageManager(cwd);
   const ownerRepo = detectOwnerRepo(cwd);
   const defaultBranch = defaultBranchFromGit(cwd);
-  const configPath = path15.join(cwd, "kody.config.json");
-  if (fs17.existsSync(configPath) && !force) {
+  const configPath = path16.join(cwd, "kody.config.json");
+  if (fs18.existsSync(configPath) && !force) {
     skipped.push("kody.config.json");
   } else {
     const cfg = makeConfig(pm, ownerRepo, defaultBranch);
-    fs17.writeFileSync(configPath, `${JSON.stringify(cfg, null, 2)}
+    fs18.writeFileSync(configPath, `${JSON.stringify(cfg, null, 2)}
 `);
     wrote.push("kody.config.json");
   }
-  const workflowDir = path15.join(cwd, ".github", "workflows");
-  const workflowPath = path15.join(workflowDir, "kody.yml");
-  if (fs17.existsSync(workflowPath) && !force) {
+  const workflowDir = path16.join(cwd, ".github", "workflows");
+  const workflowPath = path16.join(workflowDir, "kody.yml");
+  if (fs18.existsSync(workflowPath) && !force) {
     skipped.push(".github/workflows/kody.yml");
   } else {
-    fs17.mkdirSync(workflowDir, { recursive: true });
-    fs17.writeFileSync(workflowPath, WORKFLOW_TEMPLATE);
+    fs18.mkdirSync(workflowDir, { recursive: true });
+    fs18.writeFileSync(workflowPath, WORKFLOW_TEMPLATE);
     wrote.push(".github/workflows/kody.yml");
   }
-  const hasUi = fs17.existsSync(path15.join(cwd, "src/app")) || fs17.existsSync(path15.join(cwd, "app")) || fs17.existsSync(path15.join(cwd, "pages"));
+  const hasUi = fs18.existsSync(path16.join(cwd, "src/app")) || fs18.existsSync(path16.join(cwd, "app")) || fs18.existsSync(path16.join(cwd, "pages"));
   if (hasUi) {
-    const qaGuidePath = path15.join(cwd, QA_GUIDE_REL_PATH);
-    if (fs17.existsSync(qaGuidePath) && !force) {
+    const qaGuidePath = path16.join(cwd, QA_GUIDE_REL_PATH);
+    if (fs18.existsSync(qaGuidePath) && !force) {
       skipped.push(QA_GUIDE_REL_PATH);
     } else {
-      fs17.mkdirSync(path15.dirname(qaGuidePath), { recursive: true });
+      fs18.mkdirSync(path16.dirname(qaGuidePath), { recursive: true });
       const discovery = runQaDiscovery(cwd);
-      fs17.writeFileSync(qaGuidePath, generateQaGuideTemplate(discovery));
+      fs18.writeFileSync(qaGuidePath, generateQaGuideTemplate(discovery));
       wrote.push(QA_GUIDE_REL_PATH);
     }
   }
@@ -3577,12 +3620,12 @@ function performInit(cwd, force) {
       continue;
     }
     if (profile.kind !== "scheduled" || !profile.schedule) continue;
-    const target = path15.join(workflowDir, `kody-${exe.name}.yml`);
-    if (fs17.existsSync(target) && !force) {
+    const target = path16.join(workflowDir, `kody-${exe.name}.yml`);
+    if (fs18.existsSync(target) && !force) {
       skipped.push(`.github/workflows/kody-${exe.name}.yml`);
       continue;
     }
-    fs17.writeFileSync(target, renderScheduledWorkflow(exe.name, profile.schedule));
+    fs18.writeFileSync(target, renderScheduledWorkflow(exe.name, profile.schedule));
     wrote.push(`.github/workflows/kody-${exe.name}.yml`);
   }
   let labels;
@@ -3908,7 +3951,7 @@ var persistFlowState = async (ctx) => {
 };
 
 // src/scripts/postClassification.ts
-import { execFileSync as execFileSync14 } from "child_process";
+import { execFileSync as execFileSync15 } from "child_process";
 var API_TIMEOUT_MS6 = 3e4;
 var VALID_CLASSES2 = /* @__PURE__ */ new Set(["feature", "bug", "spec", "chore"]);
 var postClassification = async (ctx) => {
@@ -3938,7 +3981,7 @@ var postClassification = async (ctx) => {
     ctx.cwd
   );
   try {
-    execFileSync14("gh", ["issue", "comment", String(issueNumber), "--body", `@kody ${classification}`], {
+    execFileSync15("gh", ["issue", "comment", String(issueNumber), "--body", `@kody ${classification}`], {
       cwd: ctx.cwd,
       timeout: API_TIMEOUT_MS6,
       stdio: ["ignore", "pipe", "pipe"]
@@ -3972,7 +4015,7 @@ function parseClassification(prSummary) {
 }
 function tryAuditComment(issueNumber, body, cwd) {
   try {
-    execFileSync14("gh", ["issue", "comment", String(issueNumber), "--body", body], {
+    execFileSync15("gh", ["issue", "comment", String(issueNumber), "--body", body], {
       cwd,
       timeout: API_TIMEOUT_MS6,
       stdio: ["ignore", "pipe", "pipe"]
@@ -4156,9 +4199,16 @@ REVIEW_POSTED=https://github.com/${ctx.config.github.owner}/${ctx.config.github.
 };
 
 // src/scripts/releaseFlow.ts
-import { execFileSync as execFileSync15, spawnSync } from "child_process";
-import * as fs18 from "fs";
-import * as path16 from "path";
+import { execFileSync as execFileSync16, spawnSync } from "child_process";
+import * as fs19 from "fs";
+import * as path17 from "path";
+function notifyIssue(issueNumber, body, cwd) {
+  if (!issueNumber || issueNumber <= 0) return;
+  try {
+    postIssueComment(issueNumber, body, cwd);
+  } catch {
+  }
+}
 function bumpVersion(current, bump) {
   const m = current.match(/^(\d+)\.(\d+)\.(\d+)(.*)$/);
   if (!m) throw new Error(`cannot parse version '${current}' (expected x.y.z[-suffix])`);
@@ -4174,12 +4224,12 @@ function bumpVersion(current, bump) {
   return `${major}.${minor}.${patch}`;
 }
 function updateVersionInFile(file, newVersion, cwd) {
-  const abs = path16.join(cwd, file);
-  if (!fs18.existsSync(abs)) return false;
-  const content = fs18.readFileSync(abs, "utf-8");
+  const abs = path17.join(cwd, file);
+  if (!fs19.existsSync(abs)) return false;
+  const content = fs19.readFileSync(abs, "utf-8");
   const updated = content.replace(/"version"\s*:\s*"[^"]+"/, `"version": "${newVersion}"`);
   if (updated === content) return false;
-  fs18.writeFileSync(abs, updated);
+  fs19.writeFileSync(abs, updated);
   return true;
 }
 var FIRST_RELEASE_COMMIT_CAP = 100;
@@ -4189,7 +4239,7 @@ function generateChangelog(cwd, newVersion, lastTag) {
   else logArgs.splice(1, 0, `-n${FIRST_RELEASE_COMMIT_CAP}`, "HEAD");
   let log = "";
   try {
-    log = execFileSync15("git", logArgs, {
+    log = execFileSync16("git", logArgs, {
       cwd,
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "pipe"]
@@ -4230,23 +4280,23 @@ function generateChangelog(cwd, newVersion, lastTag) {
   return parts.join("\n");
 }
 function prependChangelog(cwd, entry) {
-  const p = path16.join(cwd, "CHANGELOG.md");
+  const p = path17.join(cwd, "CHANGELOG.md");
   const header = "# Changelog\n\nAll notable changes to this project will be documented in this file.\n\n";
-  if (fs18.existsSync(p)) {
-    const prior = fs18.readFileSync(p, "utf-8");
+  if (fs19.existsSync(p)) {
+    const prior = fs19.readFileSync(p, "utf-8");
     if (/^#\s*Changelog\b/m.test(prior)) {
       const idx = prior.indexOf("\n", prior.indexOf("# Changelog"));
-      fs18.writeFileSync(p, `${prior.slice(0, idx + 1)}
+      fs19.writeFileSync(p, `${prior.slice(0, idx + 1)}
 ${entry}${prior.slice(idx + 1)}`);
     } else {
-      fs18.writeFileSync(p, `${header}${entry}${prior}`);
+      fs19.writeFileSync(p, `${header}${entry}${prior}`);
     }
   } else {
-    fs18.writeFileSync(p, `${header}${entry}`);
+    fs19.writeFileSync(p, `${header}${entry}`);
   }
 }
 function git3(args, cwd, timeout = 6e4) {
-  return execFileSync15("git", args, {
+  return execFileSync16("git", args, {
     encoding: "utf-8",
     timeout,
     cwd,
@@ -4275,6 +4325,7 @@ var releaseFlow = async (ctx) => {
   const mode = ctx.args.mode ?? "prepare";
   const bump = ctx.args.bump ?? "patch";
   const dryRun = ctx.args["dry-run"] === true || ctx.args.dryRun === true;
+  const issueNumber = typeof ctx.args.issue === "number" ? ctx.args.issue : void 0;
   const cwd = ctx.cwd;
   const releaseCfg = ctx.config.release ?? {};
   const versionFiles = releaseCfg.versionFiles && releaseCfg.versionFiles.length > 0 ? releaseCfg.versionFiles : ["package.json"];
@@ -4282,24 +4333,43 @@ var releaseFlow = async (ctx) => {
   ctx.skipAgent = true;
   if (mode === "prepare") {
     await runPrepare({ cwd, bump, dryRun, versionFiles, ctx });
-    return;
-  }
-  if (mode === "finalize") {
+  } else if (mode === "finalize") {
     await runFinalize({ cwd, dryRun, timeoutMs, releaseCfg, ctx });
-    return;
+  } else {
+    ctx.output.exitCode = 64;
+    ctx.output.reason = `release: unknown mode '${mode}'`;
   }
-  ctx.output.exitCode = 64;
-  ctx.output.reason = `release: unknown mode '${mode}'`;
+  notifyIssue(issueNumber, buildIssueNotice(mode, dryRun, ctx), cwd);
 };
+function buildIssueNotice(mode, dryRun, ctx) {
+  const exit = ctx.output.exitCode ?? 0;
+  const url = ctx.output.prUrl;
+  const reason = ctx.output.reason;
+  const label = mode === "finalize" ? "release finalize" : mode === "prepare" ? "release prepare" : `release ${mode}`;
+  if (exit !== 0) {
+    const suffix = url ? ` \u2014 ${url}` : "";
+    return `\u26A0\uFE0F kody ${label} failed: ${truncate2(reason ?? "unknown error", 1500)}${suffix}`;
+  }
+  if (dryRun) {
+    return `\u2139\uFE0F kody ${label} (dry-run): ${reason ?? "plan printed, no changes applied"}`;
+  }
+  if (mode === "prepare") {
+    return url ? `\u2705 kody release PR opened: ${url}` : "\u2705 kody release prepared";
+  }
+  if (mode === "finalize") {
+    return url ? `\u2705 kody release published: ${url}` : "\u2705 kody release finalized (tag pushed)";
+  }
+  return `\u2705 kody ${label} complete`;
+}
 async function runPrepare(args) {
   const { cwd, bump, dryRun, versionFiles, ctx } = args;
-  const pkgPath = path16.join(cwd, "package.json");
-  if (!fs18.existsSync(pkgPath)) {
+  const pkgPath = path17.join(cwd, "package.json");
+  if (!fs19.existsSync(pkgPath)) {
     ctx.output.exitCode = 99;
     ctx.output.reason = "release prepare: package.json not found";
     return;
   }
-  const pkg = JSON.parse(fs18.readFileSync(pkgPath, "utf-8"));
+  const pkg = JSON.parse(fs19.readFileSync(pkgPath, "utf-8"));
   if (typeof pkg.version !== "string") {
     ctx.output.exitCode = 99;
     ctx.output.reason = "release prepare: package.json has no version";
@@ -4374,8 +4444,8 @@ Merge this and then run \`kody release --mode finalize\`.`;
 }
 async function runFinalize(args) {
   const { cwd, dryRun, timeoutMs, releaseCfg, ctx } = args;
-  const pkgPath = path16.join(cwd, "package.json");
-  const pkg = JSON.parse(fs18.readFileSync(pkgPath, "utf-8"));
+  const pkgPath = path17.join(cwd, "package.json");
+  const pkg = JSON.parse(fs19.readFileSync(pkgPath, "utf-8"));
   if (typeof pkg.version !== "string") {
     ctx.output.exitCode = 99;
     ctx.output.reason = "release finalize: package.json has no version";
@@ -4553,7 +4623,7 @@ var resolveArtifacts = async (ctx, profile) => {
 };
 
 // src/scripts/resolveFlow.ts
-import { execFileSync as execFileSync16 } from "child_process";
+import { execFileSync as execFileSync17 } from "child_process";
 var CONFLICT_DIFF_MAX_BYTES = 4e4;
 var resolveFlow = async (ctx) => {
   const prNumber = ctx.args.pr;
@@ -4605,7 +4675,7 @@ var resolveFlow = async (ctx) => {
 };
 function getConflictedFiles(cwd) {
   try {
-    const out = execFileSync16("git", ["diff", "--name-only", "--diff-filter=U"], {
+    const out = execFileSync17("git", ["diff", "--name-only", "--diff-filter=U"], {
       encoding: "utf-8",
       cwd,
       env: { ...process.env, HUSKY: "0" }
@@ -4620,7 +4690,7 @@ function getConflictMarkersPreview(files, cwd, maxBytes = CONFLICT_DIFF_MAX_BYTE
   let total = 0;
   for (const f of files) {
     try {
-      const content = execFileSync16("cat", [f], { encoding: "utf-8", cwd }).toString();
+      const content = execFileSync17("cat", [f], { encoding: "utf-8", cwd }).toString();
       const snippet = `### ${f}
 
 \`\`\`
@@ -4784,7 +4854,7 @@ var skipAgent = async (ctx) => {
 };
 
 // src/scripts/startFlow.ts
-import { execFileSync as execFileSync17 } from "child_process";
+import { execFileSync as execFileSync18 } from "child_process";
 var API_TIMEOUT_MS7 = 3e4;
 var startFlow = async (ctx, profile, _agentResult, args) => {
   const entry = args?.entry;
@@ -4818,7 +4888,7 @@ function postKodyComment(target, issueNumber, state, next, cwd) {
   const sub = target === "pr" && state?.core.prUrl ? "pr" : "issue";
   const body = `@kody ${next}`;
   try {
-    execFileSync17("gh", [sub, "comment", String(targetNumber), "--body", body], {
+    execFileSync18("gh", [sub, "comment", String(targetNumber), "--body", body], {
       timeout: API_TIMEOUT_MS7,
       cwd,
       stdio: ["ignore", "pipe", "pipe"]
@@ -4838,7 +4908,7 @@ function parsePr2(url) {
 }
 
 // src/scripts/syncFlow.ts
-import { execFileSync as execFileSync18 } from "child_process";
+import { execFileSync as execFileSync19 } from "child_process";
 var syncFlow = async (ctx) => {
   ctx.skipAgent = true;
   const prNumber = ctx.args.pr;
@@ -4897,7 +4967,7 @@ function bail2(ctx, prNumber, reason) {
 }
 function revParseHead(cwd) {
   try {
-    return execFileSync18("git", ["rev-parse", "HEAD"], { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).toString().trim();
+    return execFileSync19("git", ["rev-parse", "HEAD"], { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).toString().trim();
   } catch {
     return "";
   }
@@ -4905,9 +4975,9 @@ function revParseHead(cwd) {
 function pushBranch(branch, cwd) {
   const env = { ...process.env, HUSKY: "0", SKIP_HOOKS: "1" };
   try {
-    execFileSync18("git", ["push", "-u", "origin", branch], { cwd, env, stdio: ["ignore", "pipe", "pipe"] });
+    execFileSync19("git", ["push", "-u", "origin", branch], { cwd, env, stdio: ["ignore", "pipe", "pipe"] });
   } catch {
-    execFileSync18("git", ["push", "--force-with-lease", "-u", "origin", branch], {
+    execFileSync19("git", ["push", "--force-with-lease", "-u", "origin", branch], {
       cwd,
       env,
       stdio: ["ignore", "pipe", "pipe"]
@@ -5075,7 +5145,7 @@ var watchStalePrsFlow = async (ctx) => {
 };
 
 // src/scripts/writeRunSummary.ts
-import * as fs19 from "fs";
+import * as fs20 from "fs";
 var writeRunSummary = async (ctx, profile) => {
   const summaryPath = process.env.GITHUB_STEP_SUMMARY;
   if (!summaryPath) return;
@@ -5097,7 +5167,7 @@ var writeRunSummary = async (ctx, profile) => {
   if (reason) lines.push(`- **Reason:** ${reason}`);
   lines.push("");
   try {
-    fs19.appendFileSync(summaryPath, `${lines.join("\n")}
+    fs20.appendFileSync(summaryPath, `${lines.join("\n")}
 `);
   } catch {
   }
@@ -5127,7 +5197,8 @@ var preflightScripts = {
   composePrompt,
   setLifecycleLabel,
   skipAgent,
-  classifyByLabel
+  classifyByLabel,
+  diagMcp
 };
 var postflightScripts = {
   parseAgentResult: parseAgentResult2,
@@ -5158,7 +5229,7 @@ var allScriptNames = /* @__PURE__ */ new Set([
 ]);
 
 // src/tools.ts
-import { execFileSync as execFileSync19 } from "child_process";
+import { execFileSync as execFileSync20 } from "child_process";
 function verifyCliTools(tools, cwd) {
   const out = [];
   for (const t of tools) out.push(verifyOne(t, cwd));
@@ -5191,7 +5262,7 @@ function verifyOne(tool, cwd) {
 }
 function runShell2(cmd, cwd, timeoutMs = 3e4) {
   try {
-    execFileSync19("sh", ["-c", cmd], { cwd, stdio: "pipe", timeout: timeoutMs });
+    execFileSync20("sh", ["-c", cmd], { cwd, stdio: "pipe", timeout: timeoutMs });
     return true;
   } catch {
     return false;
@@ -5259,9 +5330,9 @@ async function runExecutable(profileName, input) {
     data: {},
     output: { exitCode: 0 }
   };
-  const ndjsonDir = path17.join(input.cwd, ".kody");
+  const ndjsonDir = path18.join(input.cwd, ".kody");
   const invokeAgent = async (prompt) => {
-    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path17.isAbsolute(p) ? p : path17.resolve(profile.dir, p)).filter((p) => p.length > 0);
+    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path18.isAbsolute(p) ? p : path18.resolve(profile.dir, p)).filter((p) => p.length > 0);
     const syntheticPath = ctx.data.syntheticPluginPath;
     const pluginPaths = [...externalPlugins, ...syntheticPath ? [syntheticPath] : []];
     return runAgent({
@@ -5328,17 +5399,17 @@ async function runExecutable(profileName, input) {
   }
 }
 function resolveProfilePath(profileName) {
-  const here = path17.dirname(new URL(import.meta.url).pathname);
+  const here = path18.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path17.join(here, "executables", profileName, "profile.json"),
+    path18.join(here, "executables", profileName, "profile.json"),
     // same-dir sibling (dev)
-    path17.join(here, "..", "executables", profileName, "profile.json"),
+    path18.join(here, "..", "executables", profileName, "profile.json"),
     // up one (prod: dist/bin → dist/executables)
-    path17.join(here, "..", "src", "executables", profileName, "profile.json")
+    path18.join(here, "..", "src", "executables", profileName, "profile.json")
     // fallback
   ];
   for (const c of candidates) {
-    if (fs20.existsSync(c)) return c;
+    if (fs21.existsSync(c)) return c;
   }
   return candidates[0];
 }
@@ -5514,14 +5585,14 @@ function resolveAuthToken(env = process.env) {
   return token;
 }
 function detectPackageManager2(cwd) {
-  if (fs21.existsSync(path18.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs21.existsSync(path18.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs21.existsSync(path18.join(cwd, "bun.lockb"))) return "bun";
+  if (fs22.existsSync(path19.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs22.existsSync(path19.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs22.existsSync(path19.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function shellOut(cmd, args, cwd, stream = true) {
   try {
-    execFileSync20(cmd, args, {
+    execFileSync21(cmd, args, {
       cwd,
       stdio: stream ? "inherit" : "pipe",
       env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1", CI: process.env.CI ?? "1" }
@@ -5534,7 +5605,7 @@ function shellOut(cmd, args, cwd, stream = true) {
 }
 function isOnPath(bin) {
   try {
-    execFileSync20("which", [bin], { stdio: "pipe" });
+    execFileSync21("which", [bin], { stdio: "pipe" });
     return true;
   } catch {
     return false;
@@ -5568,7 +5639,7 @@ function installLitellmIfNeeded(cwd) {
   } catch {
   }
   try {
-    execFileSync20("python3", ["-c", "import litellm"], { stdio: "pipe" });
+    execFileSync21("python3", ["-c", "import litellm"], { stdio: "pipe" });
     process.stdout.write("\u2192 kody: litellm already installed\n");
     return 0;
   } catch {
@@ -5578,16 +5649,16 @@ function installLitellmIfNeeded(cwd) {
 }
 function configureGitIdentity(cwd) {
   try {
-    const name = execFileSync20("git", ["config", "user.name"], { cwd, stdio: "pipe", encoding: "utf-8" }).trim();
+    const name = execFileSync21("git", ["config", "user.name"], { cwd, stdio: "pipe", encoding: "utf-8" }).trim();
     if (name) return;
   } catch {
   }
   try {
-    execFileSync20("git", ["config", "user.name", "github-actions[bot]"], { cwd, stdio: "pipe" });
+    execFileSync21("git", ["config", "user.name", "github-actions[bot]"], { cwd, stdio: "pipe" });
   } catch {
   }
   try {
-    execFileSync20("git", ["config", "user.email", "41898282+github-actions[bot]@users.noreply.github.com"], {
+    execFileSync21("git", ["config", "user.email", "41898282+github-actions[bot]@users.noreply.github.com"], {
       cwd,
       stdio: "pipe"
     });
@@ -5596,11 +5667,11 @@ function configureGitIdentity(cwd) {
 }
 function postFailureTail(issueNumber, cwd, reason) {
   if (!issueNumber) return;
-  const logPath = path18.join(cwd, ".kody", "last-run.jsonl");
+  const logPath = path19.join(cwd, ".kody", "last-run.jsonl");
   let tail = "";
   try {
-    if (fs21.existsSync(logPath)) {
-      const content = fs21.readFileSync(logPath, "utf-8");
+    if (fs22.existsSync(logPath)) {
+      const content = fs22.readFileSync(logPath, "utf-8");
       tail = content.slice(-3e3);
     }
   } catch {
@@ -5625,7 +5696,7 @@ async function runCi(argv) {
     return 0;
   }
   const args = parseCiArgs(argv);
-  const cwd = args.cwd ? path18.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path19.resolve(args.cwd) : process.cwd();
   let earlyConfig;
   try {
     earlyConfig = loadConfig(cwd);
@@ -5758,15 +5829,15 @@ function parseChatArgs(argv, env = process.env) {
   return result;
 }
 function commitChatFiles(cwd, sessionId, verbose) {
-  const sessionFile = path19.relative(cwd, sessionFilePath(cwd, sessionId));
-  const eventsFile = path19.relative(cwd, eventsFilePath(cwd, sessionId));
-  const paths = [sessionFile, eventsFile].filter((p) => fs22.existsSync(path19.join(cwd, p)));
+  const sessionFile = path20.relative(cwd, sessionFilePath(cwd, sessionId));
+  const eventsFile = path20.relative(cwd, eventsFilePath(cwd, sessionId));
+  const paths = [sessionFile, eventsFile].filter((p) => fs23.existsSync(path20.join(cwd, p)));
   if (paths.length === 0) return;
   const opts = { cwd, stdio: verbose ? "inherit" : "pipe" };
   try {
-    execFileSync21("git", ["add", ...paths], opts);
-    execFileSync21("git", ["commit", "--quiet", "-m", `chat: reply for ${sessionId}`], opts);
-    execFileSync21("git", ["push", "--quiet", "origin", "HEAD"], opts);
+    execFileSync22("git", ["add", ...paths], opts);
+    execFileSync22("git", ["commit", "--quiet", "-m", `chat: reply for ${sessionId}`], opts);
+    execFileSync22("git", ["push", "--quiet", "origin", "HEAD"], opts);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     process.stderr.write(`[kody:chat] commit/push skipped: ${msg}
@@ -5798,7 +5869,7 @@ async function runChat(argv) {
 ${CHAT_HELP}`);
     return 64;
   }
-  const cwd = args.cwd ? path19.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path20.resolve(args.cwd) : process.cwd();
   const sessionId = args.sessionId;
   const unpackedSecrets = unpackAllSecrets();
   if (unpackedSecrets > 0) {

package/dist/executables/release/profile.json

@@ -33,6 +33,13 @@
       "type": "bool",
       "required": false,
       "describe": "Print plan without writing files, creating PRs, tagging, or publishing."
+    },
+    {
+      "name": "issue",
+      "flag": "--issue",
+      "type": "int",
+      "required": false,
+      "describe": "Issue number to post success/failure follow-up on. Auto-populated by dispatch when triggered via @kody comment."
     }
   ],
   "claudeCode": {

package/dist/executables/research/profile.json

@@ -58,6 +58,9 @@
           "description": "kody: researching the issue"
         }
       },
+      {
+        "script": "diagMcp"
+      },
       {
         "script": "loadIssueContext"
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",