@kody-ade/kody-engine 0.4.88 → 0.4.90

package/dist/bin/kody.js

@@ -19,8 +19,8 @@ __export(events_exports, {
   resolveRunId: () => resolveRunId
 });
 import * as crypto from "crypto";
-import * as fs3 from "fs";
-import * as path3 from "path";
+import * as fs4 from "fs";
+import * as path4 from "path";
 function resolveRunId() {
   if (cachedRunId) return cachedRunId;
   if (process.env.KODY_RUN_ID) {
@@ -49,17 +49,17 @@ function emitEvent(cwd, ev) {
       runId,
       ...ev
     };
-    const eventsPath2 = path3.join(cwd, ".kody", "runs", runId, "events.jsonl");
-    fs3.mkdirSync(path3.dirname(eventsPath2), { recursive: true });
-    fs3.appendFileSync(eventsPath2, `${JSON.stringify(fullEvent)}
+    const eventsPath2 = path4.join(cwd, ".kody", "runs", runId, "events.jsonl");
+    fs4.mkdirSync(path4.dirname(eventsPath2), { recursive: true });
+    fs4.appendFileSync(eventsPath2, `${JSON.stringify(fullEvent)}
 `);
   } catch {
   }
 }
 function readEvents(cwd, runId) {
-  const eventsPath2 = path3.join(cwd, ".kody", "runs", runId, "events.jsonl");
-  if (!fs3.existsSync(eventsPath2)) return [];
-  const lines = fs3.readFileSync(eventsPath2, "utf-8").split("\n");
+  const eventsPath2 = path4.join(cwd, ".kody", "runs", runId, "events.jsonl");
+  if (!fs4.existsSync(eventsPath2)) return [];
+  const lines = fs4.readFileSync(eventsPath2, "utf-8").split("\n");
   const out = [];
   for (const line of lines) {
     const trimmed = line.trim();
@@ -72,11 +72,11 @@ function readEvents(cwd, runId) {
   return out;
 }
 function listRuns(cwd) {
-  const runsDir = path3.join(cwd, ".kody", "runs");
-  if (!fs3.existsSync(runsDir)) return [];
-  return fs3.readdirSync(runsDir).filter((name) => {
+  const runsDir = path4.join(cwd, ".kody", "runs");
+  if (!fs4.existsSync(runsDir)) return [];
+  return fs4.readdirSync(runsDir).filter((name) => {
     try {
-      return fs3.statSync(path3.join(runsDir, name)).isDirectory();
+      return fs4.statSync(path4.join(runsDir, name)).isDirectory();
     } catch {
       return false;
     }
@@ -469,16 +469,16 @@ var init_issue = __esm({
 });
 
 // src/prompt.ts
-import * as fs16 from "fs";
-import * as path14 from "path";
+import * as fs17 from "fs";
+import * as path15 from "path";
 function loadProjectConventions(projectDir) {
   const out = [];
   for (const rel of CONVENTION_FILES) {
-    const abs = path14.join(projectDir, rel);
-    if (!fs16.existsSync(abs)) continue;
+    const abs = path15.join(projectDir, rel);
+    if (!fs17.existsSync(abs)) continue;
     let content;
     try {
-      content = fs16.readFileSync(abs, "utf-8");
+      content = fs17.readFileSync(abs, "utf-8");
     } catch {
       continue;
     }
@@ -626,28 +626,28 @@ var loadMemoryContext_exports = {};
 __export(loadMemoryContext_exports, {
   loadMemoryContext: () => loadMemoryContext
 });
-import * as fs30 from "fs";
-import * as path28 from "path";
+import * as fs31 from "fs";
+import * as path29 from "path";
 function collectPages(memoryAbs) {
   const out = [];
   walkMd(memoryAbs, (file) => {
     let stat;
     try {
-      stat = fs30.statSync(file);
+      stat = fs31.statSync(file);
     } catch {
       return;
     }
     let raw;
     try {
-      raw = fs30.readFileSync(file, "utf-8");
+      raw = fs31.readFileSync(file, "utf-8");
     } catch {
       return;
     }
     const fm = raw.match(/^---\s*\n([\s\S]*?)\n---/);
-    const title = fm?.[1]?.match(/^title:\s*(.+)$/m)?.[1]?.trim() ?? path28.basename(file, ".md");
+    const title = fm?.[1]?.match(/^title:\s*(.+)$/m)?.[1]?.trim() ?? path29.basename(file, ".md");
     const updated = fm?.[1]?.match(/^updated:\s*([0-9T:.+\-Z]+)/m)?.[1]?.trim() ?? "";
     out.push({
-      relPath: path28.relative(memoryAbs, file),
+      relPath: path29.relative(memoryAbs, file),
       title,
       updated,
       content: raw.length > PER_PAGE_MAX_BYTES ? raw.slice(0, PER_PAGE_MAX_BYTES) + TRUNCATED_SUFFIX : raw,
@@ -715,16 +715,16 @@ function walkMd(root, visit) {
     const dir = stack.pop();
     let names;
     try {
-      names = fs30.readdirSync(dir);
+      names = fs31.readdirSync(dir);
     } catch {
       continue;
     }
     for (const name of names) {
       if (name.startsWith(".")) continue;
-      const full = path28.join(dir, name);
+      const full = path29.join(dir, name);
       let stat;
       try {
-        stat = fs30.statSync(full);
+        stat = fs31.statSync(full);
       } catch {
         continue;
       }
@@ -747,8 +747,8 @@ var init_loadMemoryContext = __esm({
     TRUNCATED_SUFFIX = "\n\n\u2026 (truncated)";
     loadMemoryContext = async (ctx) => {
       if (typeof ctx.data.memoryContext === "string") return;
-      const memoryAbs = path28.join(ctx.cwd, MEMORY_DIR_RELATIVE);
-      if (!fs30.existsSync(memoryAbs)) {
+      const memoryAbs = path29.join(ctx.cwd, MEMORY_DIR_RELATIVE);
+      if (!fs31.existsSync(memoryAbs)) {
         ctx.data.memoryContext = "";
         return;
       }
@@ -877,7 +877,7 @@ var init_loadPriorArt = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.88",
+  version: "0.4.90",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -932,8 +932,8 @@ var package_default = {
 
 // src/chat-cli.ts
 import { execFileSync as execFileSync31 } from "child_process";
-import * as fs36 from "fs";
-import * as path33 from "path";
+import * as fs37 from "fs";
+import * as path34 from "path";
 
 // src/chat/events.ts
 import * as fs from "fs";
@@ -999,16 +999,79 @@ function makeRunId(sessionId, suffix) {
 }
 
 // src/chat/loop.ts
-import * as fs7 from "fs";
+import * as fs8 from "fs";
 
 // src/agent.ts
-import * as fs4 from "fs";
-import * as path4 from "path";
+import * as fs5 from "fs";
+import * as path5 from "path";
 import { query } from "@anthropic-ai/claude-agent-sdk";
 
-// src/config.ts
+// src/claudeBinary.ts
 import * as fs2 from "fs";
+import { createRequire } from "module";
+import * as os from "os";
 import * as path2 from "path";
+var SDK_PKG = "@anthropic-ai/claude-agent-sdk";
+function candidateSpecs(platform, arch) {
+  const ext = platform === "win32" ? ".exe" : "";
+  const pkgs = platform === "linux" ? [`${SDK_PKG}-linux-${arch}-musl`, `${SDK_PKG}-linux-${arch}`] : [`${SDK_PKG}-${platform}-${arch}`];
+  return pkgs.map((p) => `${p}/claude${ext}`);
+}
+function readSdkVersion(req) {
+  try {
+    const entry = req.resolve(SDK_PKG);
+    const pkgDir = path2.dirname(entry);
+    const raw = fs2.readFileSync(path2.join(pkgDir, "package.json"), "utf8");
+    const v = JSON.parse(raw)?.version;
+    return typeof v === "string" && v.length > 0 ? v : "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+var cached;
+function ensureStableClaudeBinary() {
+  if (cached !== void 0) return cached;
+  try {
+    const req = createRequire(import.meta.url);
+    const sdkEntry = req.resolve(SDK_PKG);
+    const sdkReq = createRequire(sdkEntry);
+    let source = null;
+    for (const spec of candidateSpecs(process.platform, process.arch)) {
+      try {
+        source = sdkReq.resolve(spec);
+        break;
+      } catch {
+      }
+    }
+    if (!source || !fs2.existsSync(source)) {
+      cached = null;
+      return cached;
+    }
+    const ext = process.platform === "win32" ? ".exe" : "";
+    const version = readSdkVersion(req);
+    const destDir = path2.join(os.tmpdir(), "kody-claude-sdk", version);
+    const dest = path2.join(destDir, `claude${ext}`);
+    const srcSize = fs2.statSync(source).size;
+    if (fs2.existsSync(dest) && fs2.statSync(dest).size === srcSize) {
+      cached = dest;
+      return cached;
+    }
+    fs2.mkdirSync(destDir, { recursive: true });
+    const tmp = path2.join(destDir, `.claude.${process.pid}.${Date.now()}.tmp`);
+    fs2.copyFileSync(source, tmp);
+    fs2.chmodSync(tmp, 493);
+    fs2.renameSync(tmp, dest);
+    cached = dest;
+    return cached;
+  } catch {
+    cached = null;
+    return cached;
+  }
+}
+
+// src/config.ts
+import * as fs3 from "fs";
+import * as path3 from "path";
 var LITELLM_DEFAULT_PORT = 4e3;
 var LITELLM_DEFAULT_URL = `http://localhost:${LITELLM_DEFAULT_PORT}`;
 function parseProviderModel(s) {
@@ -1026,13 +1089,13 @@ function needsLitellmProxy(model) {
   return model.provider !== "claude" && model.provider !== "anthropic";
 }
 function loadConfig(projectDir = process.cwd()) {
-  const configPath = path2.join(projectDir, "kody.config.json");
-  if (!fs2.existsSync(configPath)) {
+  const configPath = path3.join(projectDir, "kody.config.json");
+  if (!fs3.existsSync(configPath)) {
     throw new Error(`kody.config.json not found at ${configPath}`);
   }
   let raw;
   try {
-    raw = JSON.parse(fs2.readFileSync(configPath, "utf-8"));
+    raw = JSON.parse(fs3.readFileSync(configPath, "utf-8"));
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     throw new Error(`kody.config.json is invalid JSON: ${msg}`);
@@ -1295,10 +1358,10 @@ function resolveTurnTimeoutMs(opts) {
   return DEFAULT_TURN_TIMEOUT_MS;
 }
 async function runAgent(opts) {
-  const ndjsonDir = opts.ndjsonDir ?? path4.join(opts.cwd, ".kody");
-  fs4.mkdirSync(ndjsonDir, { recursive: true });
-  const ndjsonPath = path4.join(ndjsonDir, "last-run.jsonl");
-  const fullLog = fs4.createWriteStream(ndjsonPath, { flags: "w" });
+  const ndjsonDir = opts.ndjsonDir ?? path5.join(opts.cwd, ".kody");
+  fs5.mkdirSync(ndjsonDir, { recursive: true });
+  const ndjsonPath = path5.join(ndjsonDir, "last-run.jsonl");
+  const fullLog = fs5.createWriteStream(ndjsonPath, { flags: "w" });
   const env = {
     ...process.env,
     SKIP_HOOKS: "1",
@@ -1382,6 +1445,10 @@ async function runAgent(opts) {
       };
     }
     queryOptions.settingSources = opts.settingSources ?? ["project", "local"];
+    const stableBinary = ensureStableClaudeBinary();
+    if (stableBinary) {
+      queryOptions.pathToClaudeCodeExecutable = stableBinary;
+    }
     const result = query({
       prompt: opts.prompt,
       // biome-ignore lint/suspicious/noExplicitAny: SDK options type is narrow; mcpServers is runtime-passthrough.
@@ -1525,48 +1592,48 @@ async function runAgent(opts) {
 }
 
 // src/registry.ts
-import * as fs5 from "fs";
-import * as path5 from "path";
+import * as fs6 from "fs";
+import * as path6 from "path";
 function getExecutablesRoot() {
-  const here = path5.dirname(new URL(import.meta.url).pathname);
+  const here = path6.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path5.join(here, "executables"),
+    path6.join(here, "executables"),
     // dev: src/
-    path5.join(here, "..", "executables"),
+    path6.join(here, "..", "executables"),
     // built: dist/bin → dist/executables
-    path5.join(here, "..", "src", "executables")
+    path6.join(here, "..", "src", "executables")
     // fallback
   ];
   for (const c of candidates) {
-    if (fs5.existsSync(c) && fs5.statSync(c).isDirectory()) return c;
+    if (fs6.existsSync(c) && fs6.statSync(c).isDirectory()) return c;
   }
   return candidates[0];
 }
 function getProjectExecutablesRoot() {
-  return path5.join(process.cwd(), ".kody", "executables");
+  return path6.join(process.cwd(), ".kody", "executables");
 }
 function getBuiltinJobsRoot() {
-  const here = path5.dirname(new URL(import.meta.url).pathname);
+  const here = path6.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path5.join(here, "jobs"),
+    path6.join(here, "jobs"),
     // dev: src/
-    path5.join(here, "..", "jobs"),
+    path6.join(here, "..", "jobs"),
     // built: dist/bin → dist/jobs
-    path5.join(here, "..", "src", "jobs")
+    path6.join(here, "..", "src", "jobs")
     // fallback
   ];
   for (const c of candidates) {
-    if (fs5.existsSync(c) && fs5.statSync(c).isDirectory()) return c;
+    if (fs6.existsSync(c) && fs6.statSync(c).isDirectory()) return c;
   }
   return candidates[0];
 }
 function listBuiltinJobs(root = getBuiltinJobsRoot()) {
-  if (!fs5.existsSync(root) || !fs5.statSync(root).isDirectory()) return [];
+  if (!fs6.existsSync(root) || !fs6.statSync(root).isDirectory()) return [];
   const out = [];
-  for (const ent of fs5.readdirSync(root, { withFileTypes: true })) {
+  for (const ent of fs6.readdirSync(root, { withFileTypes: true })) {
     if (!ent.isFile() || !ent.name.endsWith(".md")) continue;
     const slug = ent.name.slice(0, -3);
-    out.push({ slug, filePath: path5.join(root, ent.name) });
+    out.push({ slug, filePath: path6.join(root, ent.name) });
   }
   out.sort((a, b) => a.slug.localeCompare(b.slug));
   return out;
@@ -1579,13 +1646,13 @@ function listExecutables(roots = getExecutableRoots()) {
   const seen = /* @__PURE__ */ new Set();
   const out = [];
   for (const root of rootList) {
-    if (!fs5.existsSync(root)) continue;
-    const entries = fs5.readdirSync(root, { withFileTypes: true });
+    if (!fs6.existsSync(root)) continue;
+    const entries = fs6.readdirSync(root, { withFileTypes: true });
     for (const ent of entries) {
       if (!ent.isDirectory()) continue;
       if (seen.has(ent.name)) continue;
-      const profilePath = path5.join(root, ent.name, "profile.json");
-      if (fs5.existsSync(profilePath) && fs5.statSync(profilePath).isFile()) {
+      const profilePath = path6.join(root, ent.name, "profile.json");
+      if (fs6.existsSync(profilePath) && fs6.statSync(profilePath).isFile()) {
         out.push({ name: ent.name, profilePath });
         seen.add(ent.name);
       }
@@ -1597,8 +1664,8 @@ function resolveExecutable(name, roots = getExecutableRoots()) {
   if (!isSafeName(name)) return null;
   const rootList = typeof roots === "string" ? [roots] : roots;
   for (const root of rootList) {
-    const profilePath = path5.join(root, name, "profile.json");
-    if (fs5.existsSync(profilePath) && fs5.statSync(profilePath).isFile()) {
+    const profilePath = path6.join(root, name, "profile.json");
+    if (fs6.existsSync(profilePath) && fs6.statSync(profilePath).isFile()) {
       return profilePath;
     }
   }
@@ -1614,7 +1681,7 @@ function getProfileInputs(name, roots = getExecutableRoots()) {
   const profilePath = resolveExecutable(name, roots);
   if (!profilePath) return null;
   try {
-    const raw = JSON.parse(fs5.readFileSync(profilePath, "utf-8"));
+    const raw = JSON.parse(fs6.readFileSync(profilePath, "utf-8"));
     if (!raw || typeof raw !== "object" || !Array.isArray(raw.inputs)) return [];
     return raw.inputs;
   } catch {
@@ -1644,14 +1711,14 @@ function parseGenericFlags(argv) {
 }
 
 // src/chat/session.ts
-import * as fs6 from "fs";
-import * as path6 from "path";
+import * as fs7 from "fs";
+import * as path7 from "path";
 function sessionFilePath(cwd, sessionId) {
-  return path6.join(cwd, ".kody", "sessions", `${sessionId}.jsonl`);
+  return path7.join(cwd, ".kody", "sessions", `${sessionId}.jsonl`);
 }
 function readMeta(file) {
-  if (!fs6.existsSync(file)) return null;
-  const raw = fs6.readFileSync(file, "utf-8");
+  if (!fs7.existsSync(file)) return null;
+  const raw = fs7.readFileSync(file, "utf-8");
   const firstLine2 = raw.split("\n", 1)[0]?.trim();
   if (!firstLine2) return null;
   try {
@@ -1664,8 +1731,8 @@ function readMeta(file) {
   }
 }
 function readSession(file) {
-  if (!fs6.existsSync(file)) return [];
-  const raw = fs6.readFileSync(file, "utf-8").trim();
+  if (!fs7.existsSync(file)) return [];
+  const raw = fs7.readFileSync(file, "utf-8").trim();
   if (!raw) return [];
   const turns = [];
   for (const line of raw.split("\n")) {
@@ -1681,14 +1748,14 @@ function readSession(file) {
   return turns;
 }
 function appendTurn(file, turn) {
-  fs6.mkdirSync(path6.dirname(file), { recursive: true });
+  fs7.mkdirSync(path7.dirname(file), { recursive: true });
   const line = JSON.stringify({
     role: turn.role,
     content: turn.content,
     timestamp: turn.timestamp,
     toolCalls: turn.toolCalls ?? []
   });
-  fs6.appendFileSync(file, `${line}
+  fs7.appendFileSync(file, `${line}
 `);
 }
 function seedInitialMessage(file, message) {
@@ -1798,7 +1865,7 @@ function buildExecutableCatalog() {
   const entries = [];
   for (const { name, profilePath } of discovered) {
     try {
-      const raw = JSON.parse(fs7.readFileSync(profilePath, "utf-8"));
+      const raw = JSON.parse(fs8.readFileSync(profilePath, "utf-8"));
       const describe = typeof raw.describe === "string" ? raw.describe : "";
       const firstSentence = describe.split(/(?<=[.!?])\s+/, 1)[0] ?? "";
       entries.push({ name, describe: firstSentence.trim() });
@@ -1922,9 +1989,9 @@ async function emit(sink, type, sessionId, suffix, payload) {
 
 // src/chat/modes/interactive.ts
 import { execFileSync as execFileSync2 } from "child_process";
-import * as fs8 from "fs";
-import * as os from "os";
-import * as path7 from "path";
+import * as fs9 from "fs";
+import * as os2 from "os";
+import * as path8 from "path";
 
 // src/chat/inbox.ts
 import { execFileSync } from "child_process";
@@ -2081,9 +2148,9 @@ function findNextUserTurn(turns, fromIdx) {
   return -1;
 }
 function commitTurn(cwd, sessionId, verbose) {
-  const sessionRel = path7.relative(cwd, sessionFilePath(cwd, sessionId));
-  const eventsRel = path7.relative(cwd, eventsFilePath(cwd, sessionId));
-  const paths = [sessionRel, eventsRel].filter((p) => fs8.existsSync(path7.join(cwd, p)));
+  const sessionRel = path8.relative(cwd, sessionFilePath(cwd, sessionId));
+  const eventsRel = path8.relative(cwd, eventsFilePath(cwd, sessionId));
+  const paths = [sessionRel, eventsRel].filter((p) => fs9.existsSync(path8.join(cwd, p)));
   if (paths.length === 0) return;
   const startBranch = currentBranch2(cwd);
   const eventsBranch = defaultBranch(cwd) ?? "main";
@@ -2093,17 +2160,17 @@ function commitTurn(cwd, sessionId, verbose) {
   }
   const stdio = verbose ? "inherit" : "pipe";
   const exec = (args) => execFileSync2("git", args, { cwd, stdio });
-  const worktreeDir = fs8.mkdtempSync(path7.join(os.tmpdir(), "kody-events-"));
+  const worktreeDir = fs9.mkdtempSync(path8.join(os2.tmpdir(), "kody-events-"));
   let worktreeAdded = false;
   try {
     exec(["fetch", "--quiet", "origin", eventsBranch]);
     exec(["worktree", "add", "--detach", "--quiet", worktreeDir, `origin/${eventsBranch}`]);
     worktreeAdded = true;
     for (const rel of paths) {
-      const src = path7.join(cwd, rel);
-      const dst = path7.join(worktreeDir, rel);
-      fs8.mkdirSync(path7.dirname(dst), { recursive: true });
-      fs8.copyFileSync(src, dst);
+      const src = path8.join(cwd, rel);
+      const dst = path8.join(worktreeDir, rel);
+      fs9.mkdirSync(path8.dirname(dst), { recursive: true });
+      fs9.copyFileSync(src, dst);
     }
     commitPathsAndPush(worktreeDir, paths, sessionId, verbose, `HEAD:${eventsBranch}`);
   } catch (err) {
@@ -2118,7 +2185,7 @@ function commitTurn(cwd, sessionId, verbose) {
       }
     }
     try {
-      fs8.rmSync(worktreeDir, { recursive: true, force: true });
+      fs9.rmSync(worktreeDir, { recursive: true, force: true });
     } catch {
     }
   }
@@ -2214,11 +2281,11 @@ async function emit2(sink, type, sessionId, suffix, payload) {
 
 // src/kody-cli.ts
 import { execFileSync as execFileSync30 } from "child_process";
-import * as fs35 from "fs";
-import * as path32 from "path";
+import * as fs36 from "fs";
+import * as path33 from "path";
 
 // src/dispatch.ts
-import * as fs9 from "fs";
+import * as fs10 from "fs";
 
 // src/cron-match.ts
 var FIELD_BOUNDS = [
@@ -2302,10 +2369,10 @@ function autoDispatch(opts) {
   }
   const eventName = process.env.GITHUB_EVENT_NAME;
   const eventPath = process.env.GITHUB_EVENT_PATH;
-  if (!eventName || !eventPath || !fs9.existsSync(eventPath)) return null;
+  if (!eventName || !eventPath || !fs10.existsSync(eventPath)) return null;
   let event = {};
   try {
-    event = JSON.parse(fs9.readFileSync(eventPath, "utf-8"));
+    event = JSON.parse(fs10.readFileSync(eventPath, "utf-8"));
   } catch {
     return null;
   }
@@ -2378,7 +2445,7 @@ function autoDispatchTyped(opts) {
   if (legacy) return { kind: "route", ...legacy };
   const eventName = process.env.GITHUB_EVENT_NAME;
   const eventPath = process.env.GITHUB_EVENT_PATH;
-  if (!eventName || !eventPath || !fs9.existsSync(eventPath)) {
+  if (!eventName || !eventPath || !fs10.existsSync(eventPath)) {
     return { kind: "silent", reason: "no GHA event context" };
   }
   if (eventName !== "issue_comment") {
@@ -2386,7 +2453,7 @@ function autoDispatchTyped(opts) {
   }
   let event = {};
   try {
-    event = JSON.parse(fs9.readFileSync(eventPath, "utf-8"));
+    event = JSON.parse(fs10.readFileSync(eventPath, "utf-8"));
   } catch {
     return { kind: "silent", reason: "GHA event payload unreadable" };
   }
@@ -2420,7 +2487,7 @@ function dispatchScheduledWatches(opts) {
   for (const exe of listExecutables()) {
     let raw;
     try {
-      raw = fs9.readFileSync(exe.profilePath, "utf-8");
+      raw = fs10.readFileSync(exe.profilePath, "utf-8");
     } catch {
       continue;
     }
@@ -2537,16 +2604,16 @@ init_issue();
 
 // src/executor.ts
 import { execFileSync as execFileSync29, spawn as spawn6 } from "child_process";
-import * as fs34 from "fs";
-import * as path31 from "path";
+import * as fs35 from "fs";
+import * as path32 from "path";
 init_events();
 
 // src/lifecycleLabels.ts
 init_issue();
 
 // src/profile.ts
-import * as fs10 from "fs";
-import * as path8 from "path";
+import * as fs11 from "fs";
+import * as path9 from "path";
 
 // src/profile-error.ts
 var ProfileError = class extends Error {
@@ -2593,6 +2660,7 @@ function prBranchLifecycle(profile, profilePath) {
   ];
   if (cfg.mirrorState) tail.push({ script: "mirrorStateToPr" });
   if (cfg.advance) tail.push({ script: "advanceFlow" });
+  if (cfg.finalize) tail.push({ script: "finalizeTerminal" });
   profile.scripts.postflight = [...beforePostflight, ...profile.scripts.postflight, ...tail];
 }
 function buildContextBundle(context, extras) {
@@ -2654,7 +2722,8 @@ function validateConfig(raw, profilePath) {
     sync: parseBool(raw, profilePath, "sync", true),
     verify: parseBool(raw, profilePath, "verify", true),
     advance: parseBool(raw, profilePath, "advance", true),
-    mirrorState: parseBool(raw, profilePath, "mirrorState", false)
+    mirrorState: parseBool(raw, profilePath, "mirrorState", false),
+    finalize: parseBool(raw, profilePath, "finalize", false)
   };
 }
 function parseBool(raw, profilePath, key, def) {
@@ -2712,12 +2781,12 @@ var KNOWN_PROFILE_KEYS = /* @__PURE__ */ new Set([
   "preloadContext"
 ]);
 function loadProfile(profilePath) {
-  if (!fs10.existsSync(profilePath)) {
+  if (!fs11.existsSync(profilePath)) {
     throw new ProfileError(profilePath, "file not found");
   }
   let raw;
   try {
-    raw = JSON.parse(fs10.readFileSync(profilePath, "utf-8"));
+    raw = JSON.parse(fs11.readFileSync(profilePath, "utf-8"));
   } catch (err) {
     throw new ProfileError(profilePath, `invalid JSON: ${err instanceof Error ? err.message : String(err)}`);
   }
@@ -2728,7 +2797,7 @@ function loadProfile(profilePath) {
   const unknownKeys = Object.keys(r).filter((k) => !KNOWN_PROFILE_KEYS.has(k));
   if (unknownKeys.length > 0) {
     process.stderr.write(
-      `[kody profile] ${path8.basename(path8.dirname(profilePath))}: unknown top-level keys ignored: ${unknownKeys.join(", ")}
+      `[kody profile] ${path9.basename(path9.dirname(profilePath))}: unknown top-level keys ignored: ${unknownKeys.join(", ")}
 `
     );
   }
@@ -2789,7 +2858,7 @@ function loadProfile(profilePath) {
     // Phase 5 in-process handoff opt-in. Default false; containers
     // flip to true after end-to-end verification.
     preloadContext: r.preloadContext === true,
-    dir: path8.dirname(profilePath)
+    dir: path9.dirname(profilePath)
   };
   if (lifecycle) {
     applyLifecycle(profile, profilePath);
@@ -3159,9 +3228,9 @@ function errMsg(err) {
 
 // src/litellm.ts
 import { execFileSync as execFileSync4, spawn as spawn2 } from "child_process";
-import * as fs11 from "fs";
-import * as os2 from "os";
-import * as path9 from "path";
+import * as fs12 from "fs";
+import * as os3 from "os";
+import * as path10 from "path";
 async function checkLitellmHealth(url) {
   try {
     const response = await fetch(`${url}/health`, { signal: AbortSignal.timeout(3e3) });
@@ -3208,20 +3277,20 @@ async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL
       throw new Error("litellm not installed \u2014 run: pip install 'litellm[proxy]'");
     }
   }
-  const configPath = path9.join(os2.tmpdir(), `kody-litellm-${Date.now()}.yaml`);
-  fs11.writeFileSync(configPath, generateLitellmConfigYaml(model));
+  const configPath = path10.join(os3.tmpdir(), `kody-litellm-${Date.now()}.yaml`);
+  fs12.writeFileSync(configPath, generateLitellmConfigYaml(model));
   const portMatch = url.match(/:(\d+)/);
   const port = portMatch ? portMatch[1] : "4000";
   const args = cmd === "litellm" ? ["--config", configPath, "--port", port] : ["-m", "litellm", "--config", configPath, "--port", port];
   const dotenvVars = readDotenvApiKeys(projectDir);
-  const logPath = path9.join(os2.tmpdir(), `kody-litellm-${Date.now()}.log`);
-  const outFd = fs11.openSync(logPath, "w");
+  const logPath = path10.join(os3.tmpdir(), `kody-litellm-${Date.now()}.log`);
+  const outFd = fs12.openSync(logPath, "w");
   const child = spawn2(cmd, args, {
     stdio: ["ignore", outFd, outFd],
     detached: true,
     env: stripBlockingEnv({ ...process.env, ...dotenvVars })
   });
-  fs11.closeSync(outFd);
+  fs12.closeSync(outFd);
   const timeoutMs = resolveLitellmTimeoutMs();
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
@@ -3240,7 +3309,7 @@ async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL
   }
   let logTail = "";
   try {
-    logTail = fs11.readFileSync(logPath, "utf-8").slice(-2e3);
+    logTail = fs12.readFileSync(logPath, "utf-8").slice(-2e3);
   } catch {
   }
   try {
@@ -3252,10 +3321,10 @@ async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL
 ${logTail}`);
 }
 function readDotenvApiKeys(projectDir) {
-  const dotenvPath = path9.join(projectDir, ".env");
-  if (!fs11.existsSync(dotenvPath)) return {};
+  const dotenvPath = path10.join(projectDir, ".env");
+  if (!fs12.existsSync(dotenvPath)) return {};
   const result = {};
-  for (const rawLine of fs11.readFileSync(dotenvPath, "utf-8").split("\n")) {
+  for (const rawLine of fs12.readFileSync(dotenvPath, "utf-8").split("\n")) {
     const line = rawLine.trim();
     if (!line || line.startsWith("#")) continue;
     const match = line.match(/^([A-Z_][A-Z0-9_]*_API_KEY)=(.*)$/);
@@ -3279,8 +3348,8 @@ function stripBlockingEnv(env) {
 
 // src/commit.ts
 import { execFileSync as execFileSync5 } from "child_process";
-import * as fs12 from "fs";
-import * as path10 from "path";
+import * as fs13 from "fs";
+import * as path11 from "path";
 var FORBIDDEN_PATH_PREFIXES = [
   ".kody/",
   ".kody-engine/",
@@ -3340,18 +3409,18 @@ function tryGit(args, cwd) {
 }
 function abortUnfinishedGitOps(cwd) {
   const aborted = [];
-  const gitDir = path10.join(cwd ?? process.cwd(), ".git");
-  if (!fs12.existsSync(gitDir)) return aborted;
-  if (fs12.existsSync(path10.join(gitDir, "MERGE_HEAD"))) {
+  const gitDir = path11.join(cwd ?? process.cwd(), ".git");
+  if (!fs13.existsSync(gitDir)) return aborted;
+  if (fs13.existsSync(path11.join(gitDir, "MERGE_HEAD"))) {
     if (tryGit(["merge", "--abort"], cwd)) aborted.push("merge");
   }
-  if (fs12.existsSync(path10.join(gitDir, "CHERRY_PICK_HEAD"))) {
+  if (fs13.existsSync(path11.join(gitDir, "CHERRY_PICK_HEAD"))) {
     if (tryGit(["cherry-pick", "--abort"], cwd)) aborted.push("cherry-pick");
   }
-  if (fs12.existsSync(path10.join(gitDir, "REVERT_HEAD"))) {
+  if (fs13.existsSync(path11.join(gitDir, "REVERT_HEAD"))) {
     if (tryGit(["revert", "--abort"], cwd)) aborted.push("revert");
   }
-  if (fs12.existsSync(path10.join(gitDir, "rebase-merge")) || fs12.existsSync(path10.join(gitDir, "rebase-apply"))) {
+  if (fs13.existsSync(path11.join(gitDir, "rebase-merge")) || fs13.existsSync(path11.join(gitDir, "rebase-apply"))) {
     if (tryGit(["rebase", "--abort"], cwd)) aborted.push("rebase");
   }
   try {
@@ -3407,7 +3476,7 @@ function normalizeCommitMessage(raw) {
 function commitAndPush(branch, agentMessage, cwd) {
   const allChanged = listChangedFiles(cwd);
   const allowedFiles = allChanged.filter((f) => !isForbiddenPath(f));
-  const mergeHeadExists = fs12.existsSync(path10.join(cwd ?? process.cwd(), ".git", "MERGE_HEAD"));
+  const mergeHeadExists = fs13.existsSync(path11.join(cwd ?? process.cwd(), ".git", "MERGE_HEAD"));
   if (allowedFiles.length === 0 && !mergeHeadExists) {
     return { committed: false, pushed: false, sha: "", message: "" };
   }
@@ -3723,20 +3792,20 @@ var advanceFlow = async (ctx, profile) => {
 
 // src/scripts/brainServe.ts
 import { createServer } from "http";
-import * as fs14 from "fs";
-import * as path12 from "path";
+import * as fs15 from "fs";
+import * as path13 from "path";
 
 // src/scripts/brainTurnLog.ts
-import * as fs13 from "fs";
-import * as path11 from "path";
+import * as fs14 from "fs";
+import * as path12 from "path";
 var live = /* @__PURE__ */ new Map();
 function eventsPath(dir, chatId) {
-  return path11.join(dir, ".kody", "brain-events", `${chatId}.jsonl`);
+  return path12.join(dir, ".kody", "brain-events", `${chatId}.jsonl`);
 }
 function lastPersistedSeq(dir, chatId) {
   const p = eventsPath(dir, chatId);
-  if (!fs13.existsSync(p)) return 0;
-  const lines = fs13.readFileSync(p, "utf-8").split("\n").filter(Boolean);
+  if (!fs14.existsSync(p)) return 0;
+  const lines = fs14.readFileSync(p, "utf-8").split("\n").filter(Boolean);
   if (lines.length === 0) return 0;
   try {
     return JSON.parse(lines[lines.length - 1]).seq || 0;
@@ -3746,9 +3815,9 @@ function lastPersistedSeq(dir, chatId) {
 }
 function readSince(dir, chatId, since) {
   const p = eventsPath(dir, chatId);
-  if (!fs13.existsSync(p)) return [];
+  if (!fs14.existsSync(p)) return [];
   const out = [];
-  for (const line of fs13.readFileSync(p, "utf-8").split("\n")) {
+  for (const line of fs14.readFileSync(p, "utf-8").split("\n")) {
     if (!line) continue;
     try {
       const rec = JSON.parse(line);
@@ -3774,12 +3843,12 @@ function beginTurn(dir, chatId) {
   };
   live.set(chatId, state);
   const p = eventsPath(dir, chatId);
-  fs13.mkdirSync(path11.dirname(p), { recursive: true });
+  fs14.mkdirSync(path12.dirname(p), { recursive: true });
   return (event) => {
     state.seq += 1;
     const rec = { seq: state.seq, turn, ts: Date.now(), event };
     try {
-      fs13.appendFileSync(p, JSON.stringify(rec) + "\n");
+      fs14.appendFileSync(p, JSON.stringify(rec) + "\n");
     } catch (err) {
       process.stderr.write(
         `[brain-turn-log] append failed for ${chatId}: ${err instanceof Error ? err.message : String(err)}
@@ -3817,7 +3886,7 @@ function endTurnIfUnterminated(dir, chatId, errMessage) {
     event: { type: "error", error: errMessage || "turn ended unexpectedly", chatId }
   };
   try {
-    fs13.appendFileSync(eventsPath(dir, chatId), JSON.stringify(rec) + "\n");
+    fs14.appendFileSync(eventsPath(dir, chatId), JSON.stringify(rec) + "\n");
   } catch {
   }
   state.status = "ended";
@@ -4034,7 +4103,7 @@ async function handleChatTurn(req, res, chatId, opts) {
     return;
   }
   const sessionFile = sessionFilePath(opts.cwd, chatId);
-  fs14.mkdirSync(path12.dirname(sessionFile), { recursive: true });
+  fs15.mkdirSync(path13.dirname(sessionFile), { recursive: true });
   appendTurn(sessionFile, {
     role: "user",
     content: message,
@@ -4174,21 +4243,21 @@ var brainServe = async (ctx) => {
 };
 
 // src/scripts/buildSyntheticPlugin.ts
-import * as fs15 from "fs";
-import * as os3 from "os";
-import * as path13 from "path";
+import * as fs16 from "fs";
+import * as os4 from "os";
+import * as path14 from "path";
 function getPluginsCatalogRoot() {
-  const here = path13.dirname(new URL(import.meta.url).pathname);
+  const here = path14.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path13.join(here, "..", "plugins"),
+    path14.join(here, "..", "plugins"),
     // dev: src/scripts → src/plugins
-    path13.join(here, "..", "..", "plugins"),
+    path14.join(here, "..", "..", "plugins"),
     // built: dist/scripts → dist/plugins
-    path13.join(here, "..", "..", "src", "plugins")
+    path14.join(here, "..", "..", "src", "plugins")
     // fallback
   ];
   for (const c of candidates) {
-    if (fs15.existsSync(c) && fs15.statSync(c).isDirectory()) return c;
+    if (fs16.existsSync(c) && fs16.statSync(c).isDirectory()) return c;
   }
   return candidates[0];
 }
@@ -4198,52 +4267,52 @@ var buildSyntheticPlugin = async (ctx, profile) => {
   if (!needsSynthetic) return;
   const catalog = getPluginsCatalogRoot();
   const runId = `${profile.name}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-  const root = path13.join(os3.tmpdir(), `kody-synth-${runId}`);
-  fs15.mkdirSync(path13.join(root, ".claude-plugin"), { recursive: true });
+  const root = path14.join(os4.tmpdir(), `kody-synth-${runId}`);
+  fs16.mkdirSync(path14.join(root, ".claude-plugin"), { recursive: true });
   const resolvePart = (bucket, entry) => {
-    const local = path13.join(profile.dir, bucket, entry);
-    if (fs15.existsSync(local)) return local;
-    const central = path13.join(catalog, bucket, entry);
-    if (fs15.existsSync(central)) return central;
+    const local = path14.join(profile.dir, bucket, entry);
+    if (fs16.existsSync(local)) return local;
+    const central = path14.join(catalog, bucket, entry);
+    if (fs16.existsSync(central)) return central;
     throw new Error(
       `buildSyntheticPlugin: ${bucket} entry '${entry}' not found in executable dir (${profile.dir}/${bucket}/) or catalog (${catalog}/${bucket}/)`
     );
   };
   if (cc.skills.length > 0) {
-    const dst = path13.join(root, "skills");
-    fs15.mkdirSync(dst, { recursive: true });
+    const dst = path14.join(root, "skills");
+    fs16.mkdirSync(dst, { recursive: true });
     for (const name of cc.skills) {
-      copyDir(resolvePart("skills", name), path13.join(dst, name));
+      copyDir(resolvePart("skills", name), path14.join(dst, name));
     }
   }
   if (cc.commands.length > 0) {
-    const dst = path13.join(root, "commands");
-    fs15.mkdirSync(dst, { recursive: true });
+    const dst = path14.join(root, "commands");
+    fs16.mkdirSync(dst, { recursive: true });
     for (const name of cc.commands) {
-      fs15.copyFileSync(resolvePart("commands", `${name}.md`), path13.join(dst, `${name}.md`));
+      fs16.copyFileSync(resolvePart("commands", `${name}.md`), path14.join(dst, `${name}.md`));
     }
   }
   if (cc.subagents.length > 0) {
-    const dst = path13.join(root, "agents");
-    fs15.mkdirSync(dst, { recursive: true });
+    const dst = path14.join(root, "agents");
+    fs16.mkdirSync(dst, { recursive: true });
     for (const name of cc.subagents) {
-      fs15.copyFileSync(resolvePart("agents", `${name}.md`), path13.join(dst, `${name}.md`));
+      fs16.copyFileSync(resolvePart("agents", `${name}.md`), path14.join(dst, `${name}.md`));
     }
   }
   if (cc.hooks.length > 0) {
-    const dst = path13.join(root, "hooks");
-    fs15.mkdirSync(dst, { recursive: true });
+    const dst = path14.join(root, "hooks");
+    fs16.mkdirSync(dst, { recursive: true });
     const merged = { hooks: {} };
     for (const name of cc.hooks) {
       const src = resolvePart("hooks", `${name}.json`);
-      const parsed = JSON.parse(fs15.readFileSync(src, "utf-8"));
+      const parsed = JSON.parse(fs16.readFileSync(src, "utf-8"));
       for (const [event, entries] of Object.entries(parsed.hooks ?? {})) {
         if (!Array.isArray(entries)) continue;
         if (!merged.hooks[event]) merged.hooks[event] = [];
         merged.hooks[event].push(...entries);
       }
     }
-    fs15.writeFileSync(path13.join(dst, "hooks.json"), `${JSON.stringify(merged, null, 2)}
+    fs16.writeFileSync(path14.join(dst, "hooks.json"), `${JSON.stringify(merged, null, 2)}
 `);
   }
   const manifest = {
@@ -4254,17 +4323,17 @@ var buildSyntheticPlugin = async (ctx, profile) => {
   if (cc.skills.length > 0) manifest.skills = ["./skills/"];
   if (cc.commands.length > 0) manifest.commands = ["./commands/"];
   if (cc.subagents.length > 0) manifest.agents = cc.subagents.map((n) => `./agents/${n}.md`);
-  fs15.writeFileSync(path13.join(root, ".claude-plugin", "plugin.json"), `${JSON.stringify(manifest, null, 2)}
+  fs16.writeFileSync(path14.join(root, ".claude-plugin", "plugin.json"), `${JSON.stringify(manifest, null, 2)}
 `);
   ctx.data.syntheticPluginPath = root;
 };
 function copyDir(src, dst) {
-  fs15.mkdirSync(dst, { recursive: true });
-  for (const ent of fs15.readdirSync(src, { withFileTypes: true })) {
-    const s = path13.join(src, ent.name);
-    const d = path13.join(dst, ent.name);
+  fs16.mkdirSync(dst, { recursive: true });
+  for (const ent of fs16.readdirSync(src, { withFileTypes: true })) {
+    const s = path14.join(src, ent.name);
+    const d = path14.join(dst, ent.name);
     if (ent.isDirectory()) copyDir(s, d);
-    else if (ent.isFile()) fs15.copyFileSync(s, d);
+    else if (ent.isFile()) fs16.copyFileSync(s, d);
   }
 }
 
@@ -4405,13 +4474,13 @@ function defaultLabelMap() {
 }
 
 // src/scripts/commitAndPush.ts
-import * as fs17 from "fs";
-import * as path15 from "path";
+import * as fs18 from "fs";
+import * as path16 from "path";
 init_events();
 var DEFAULT_COMMIT_MESSAGE = "chore: kody changes";
 function sentinelPathForStage(cwd, profileName) {
   const runId = resolveRunId();
-  return path15.join(cwd, ".kody", "runs", runId, `commit-${profileName}.lock`);
+  return path16.join(cwd, ".kody", "runs", runId, `commit-${profileName}.lock`);
 }
 var commitAndPush2 = async (ctx, profile) => {
   const branch = ctx.data.branch;
@@ -4421,9 +4490,9 @@ var commitAndPush2 = async (ctx, profile) => {
   }
   const idempotencyEnabled = process.env.KODY_COMMIT_IDEMPOTENCY !== "0";
   const sentinel = idempotencyEnabled ? sentinelPathForStage(ctx.cwd, profile.name) : null;
-  if (sentinel && fs17.existsSync(sentinel)) {
+  if (sentinel && fs18.existsSync(sentinel)) {
     try {
-      const replay = JSON.parse(fs17.readFileSync(sentinel, "utf-8"));
+      const replay = JSON.parse(fs18.readFileSync(sentinel, "utf-8"));
       ctx.data.commitResult = replay.commitResult ?? { committed: false, pushed: false };
       if (Array.isArray(replay.changedFiles)) ctx.data.changedFiles = replay.changedFiles;
       if (typeof replay.hasCommitsAhead === "boolean") ctx.data.hasCommitsAhead = replay.hasCommitsAhead;
@@ -4476,8 +4545,8 @@ var commitAndPush2 = async (ctx, profile) => {
   const result = ctx.data.commitResult;
   if (sentinel && result?.committed) {
     try {
-      fs17.mkdirSync(path15.dirname(sentinel), { recursive: true });
-      fs17.writeFileSync(
+      fs18.mkdirSync(path16.dirname(sentinel), { recursive: true });
+      fs18.writeFileSync(
         sentinel,
         JSON.stringify(
           {
@@ -4498,11 +4567,11 @@ var commitAndPush2 = async (ctx, profile) => {
 
 // src/scripts/commitGoalState.ts
 import { execFileSync as execFileSync9 } from "child_process";
-import * as path16 from "path";
+import * as path17 from "path";
 var commitGoalState = async (ctx) => {
   const goal = ctx.data.goal;
   if (!goal) return;
-  const stateRel = path16.posix.join(".kody", "goals", goal.id, "state.json");
+  const stateRel = path17.posix.join(".kody", "goals", goal.id, "state.json");
   try {
     execFileSync9("git", ["add", stateRel], { cwd: ctx.cwd, stdio: "pipe" });
   } catch (err) {
@@ -4547,20 +4616,20 @@ function describeCommitMessage(goal) {
 }
 
 // src/scripts/composePrompt.ts
-import * as fs18 from "fs";
-import * as path17 from "path";
+import * as fs19 from "fs";
+import * as path18 from "path";
 var MUSTACHE = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
 var composePrompt = async (ctx, profile) => {
   const explicit = ctx.data.promptTemplate;
   const mode = ctx.args.mode;
   const candidates = [
-    explicit ? path17.join(profile.dir, explicit) : null,
-    mode ? path17.join(profile.dir, "prompts", `${mode}.md`) : null,
-    path17.join(profile.dir, "prompt.md")
+    explicit ? path18.join(profile.dir, explicit) : null,
+    mode ? path18.join(profile.dir, "prompts", `${mode}.md`) : null,
+    path18.join(profile.dir, "prompt.md")
   ].filter(Boolean);
   let templatePath = "";
   for (const c of candidates) {
-    if (fs18.existsSync(c)) {
+    if (fs19.existsSync(c)) {
       templatePath = c;
       break;
     }
@@ -4568,7 +4637,7 @@ var composePrompt = async (ctx, profile) => {
   if (!templatePath) {
     throw new Error(`profile at ${profile.dir}: no prompt template found (tried ${candidates.join(", ")})`);
   }
-  const template = fs18.readFileSync(templatePath, "utf-8");
+  const template = fs19.readFileSync(templatePath, "utf-8");
   const tokens = {
     ...stringifyAll(ctx.args, "args."),
     ...stringifyAll(ctx.data, ""),
@@ -4647,8 +4716,8 @@ function formatToolsUsage(profile) {
 // src/scripts/createQaGoal.ts
 init_issue();
 import { execFileSync as execFileSync10 } from "child_process";
-import * as fs19 from "fs";
-import * as path18 from "path";
+import * as fs20 from "fs";
+import * as path19 from "path";
 
 // src/scripts/postReviewResult.ts
 init_issue();
@@ -4901,8 +4970,8 @@ function createOrUpdateManifestIssue(number, manifest, cwd) {
   return { number: Number(m[1]), created: true };
 }
 function writeStateFile(cwd, goalId, lastDispatchedIssue) {
-  const dir = path18.join(cwd, ".kody", "goals", goalId);
-  fs19.mkdirSync(dir, { recursive: true });
+  const dir = path19.join(cwd, ".kody", "goals", goalId);
+  fs20.mkdirSync(dir, { recursive: true });
   const state = {
     version: 1,
     state: "active",
@@ -4910,8 +4979,8 @@ function writeStateFile(cwd, goalId, lastDispatchedIssue) {
     updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     ...typeof lastDispatchedIssue === "number" ? { lastDispatchedIssue } : {}
   };
-  const filePath = path18.join(dir, "state.json");
-  fs19.writeFileSync(filePath, `${JSON.stringify(state, null, 2)}
+  const filePath = path19.join(dir, "state.json");
+  fs20.writeFileSync(filePath, `${JSON.stringify(state, null, 2)}
 `);
   return filePath;
 }
@@ -5420,15 +5489,15 @@ function filterGoalTaskPrs(prs, taskIssueNumbers) {
 
 // src/scripts/diagMcp.ts
 import { execFileSync as execFileSync11 } from "child_process";
-import * as fs20 from "fs";
-import * as os4 from "os";
-import * as path19 from "path";
+import * as fs21 from "fs";
+import * as os5 from "os";
+import * as path20 from "path";
 var diagMcp = async (_ctx) => {
-  const home = os4.homedir();
-  const cacheDir = path19.join(home, ".cache", "ms-playwright");
+  const home = os5.homedir();
+  const cacheDir = path20.join(home, ".cache", "ms-playwright");
   let entries = [];
   try {
-    entries = fs20.readdirSync(cacheDir);
+    entries = fs21.readdirSync(cacheDir);
   } catch {
   }
   const hasChromium = entries.some((e) => e.startsWith("chromium"));
@@ -5454,17 +5523,17 @@ var diagMcp = async (_ctx) => {
 };
 
 // src/scripts/discoverQaContext.ts
-import * as fs22 from "fs";
-import * as path21 from "path";
+import * as fs23 from "fs";
+import * as path22 from "path";
 
 // src/scripts/frameworkDetectors.ts
-import * as fs21 from "fs";
-import * as path20 from "path";
+import * as fs22 from "fs";
+import * as path21 from "path";
 function detectFrameworks(cwd) {
   const out = [];
   let deps = {};
   try {
-    const pkg = JSON.parse(fs21.readFileSync(path20.join(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs22.readFileSync(path21.join(cwd, "package.json"), "utf-8"));
     deps = { ...pkg.dependencies, ...pkg.devDependencies };
   } catch {
     return out;
@@ -5501,7 +5570,7 @@ function detectFrameworks(cwd) {
 }
 function findFile(cwd, candidates) {
   for (const c of candidates) {
-    if (fs21.existsSync(path20.join(cwd, c))) return c;
+    if (fs22.existsSync(path21.join(cwd, c))) return c;
   }
   return null;
 }
@@ -5514,18 +5583,18 @@ var COLLECTION_DIRS = [
 function discoverPayloadCollections(cwd) {
   const out = [];
   for (const dir of COLLECTION_DIRS) {
-    const full = path20.join(cwd, dir);
-    if (!fs21.existsSync(full)) continue;
+    const full = path21.join(cwd, dir);
+    if (!fs22.existsSync(full)) continue;
     let files;
     try {
-      files = fs21.readdirSync(full).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
+      files = fs22.readdirSync(full).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
     } catch {
       continue;
     }
     for (const file of files) {
       try {
-        const filePath = path20.join(full, file);
-        const content = fs21.readFileSync(filePath, "utf-8").slice(0, 1e4);
+        const filePath = path21.join(full, file);
+        const content = fs22.readFileSync(filePath, "utf-8").slice(0, 1e4);
         const slugMatch = content.match(/slug:\s*['"]([a-z0-9-]+)['"]/);
         if (!slugMatch) continue;
         const slug = slugMatch[1];
@@ -5539,7 +5608,7 @@ function discoverPayloadCollections(cwd) {
         out.push({
           name,
           slug,
-          filePath: path20.relative(cwd, filePath),
+          filePath: path21.relative(cwd, filePath),
           fields: fields.slice(0, 20),
           hasAdmin
         });
@@ -5553,28 +5622,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 = path20.join(cwd, dir);
-    if (!fs21.existsSync(full)) continue;
+    const full = path21.join(cwd, dir);
+    if (!fs22.existsSync(full)) continue;
     let entries;
     try {
-      entries = fs21.readdirSync(full, { withFileTypes: true });
+      entries = fs22.readdirSync(full, { withFileTypes: true });
     } catch {
       continue;
     }
     for (const entry of entries) {
-      const entryPath = path20.join(full, entry.name);
+      const entryPath = path21.join(full, entry.name);
       let name;
       let filePath;
       if (entry.isDirectory()) {
         const indexFile = ["index.tsx", "index.ts", "index.jsx", "index.js"].find(
-          (f) => fs21.existsSync(path20.join(entryPath, f))
+          (f) => fs22.existsSync(path21.join(entryPath, f))
         );
         if (!indexFile) continue;
         name = entry.name;
-        filePath = path20.relative(cwd, path20.join(entryPath, indexFile));
+        filePath = path21.relative(cwd, path21.join(entryPath, indexFile));
       } else if (/\.(tsx?|jsx?)$/.test(entry.name)) {
         name = entry.name.replace(/\.(tsx?|jsx?)$/, "");
-        filePath = path20.relative(cwd, entryPath);
+        filePath = path21.relative(cwd, entryPath);
       } else {
         continue;
       }
@@ -5582,7 +5651,7 @@ function discoverAdminComponents(cwd, collections) {
       if (collections) {
         for (const col of collections) {
           try {
-            const colContent = fs21.readFileSync(path20.join(cwd, col.filePath), "utf-8");
+            const colContent = fs22.readFileSync(path21.join(cwd, col.filePath), "utf-8");
             if (colContent.includes(name)) {
               usedInCollection = col.slug;
               break;
@@ -5601,8 +5670,8 @@ function scanApiRoutes(cwd) {
   const out = [];
   const appDirs = ["src/app", "app"];
   for (const appDir of appDirs) {
-    const apiDir = path20.join(cwd, appDir, "api");
-    if (!fs21.existsSync(apiDir)) continue;
+    const apiDir = path21.join(cwd, appDir, "api");
+    if (!fs22.existsSync(apiDir)) continue;
     walkApiRoutes(apiDir, "/api", cwd, out);
     break;
   }
@@ -5611,14 +5680,14 @@ function scanApiRoutes(cwd) {
 function walkApiRoutes(dir, prefix, cwd, out) {
   let entries;
   try {
-    entries = fs21.readdirSync(dir, { withFileTypes: true });
+    entries = fs22.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 = fs21.readFileSync(path20.join(dir, routeFile.name), "utf-8").slice(0, 5e3);
+      const content = fs22.readFileSync(path21.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)
       );
@@ -5626,7 +5695,7 @@ function walkApiRoutes(dir, prefix, cwd, out) {
         out.push({
           path: prefix,
           methods,
-          filePath: path20.relative(cwd, path20.join(dir, routeFile.name))
+          filePath: path21.relative(cwd, path21.join(dir, routeFile.name))
         });
       }
     } catch {
@@ -5637,7 +5706,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(path20.join(dir, entry.name), prefix, cwd, out);
+      walkApiRoutes(path21.join(dir, entry.name), prefix, cwd, out);
       continue;
     }
     if (segment.startsWith("[[") && segment.endsWith("]]")) {
@@ -5645,7 +5714,7 @@ function walkApiRoutes(dir, prefix, cwd, out) {
     } else if (segment.startsWith("[") && segment.endsWith("]")) {
       segment = `:${segment.slice(1, -1)}`;
     }
-    walkApiRoutes(path20.join(dir, entry.name), `${prefix}/${segment}`, cwd, out);
+    walkApiRoutes(path21.join(dir, entry.name), `${prefix}/${segment}`, cwd, out);
   }
 }
 var BUILTIN_ENV_VARS = /* @__PURE__ */ new Set([
@@ -5665,10 +5734,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 = path20.join(cwd, envFile);
-    if (!fs21.existsSync(envPath)) continue;
+    const envPath = path21.join(cwd, envFile);
+    if (!fs22.existsSync(envPath)) continue;
     try {
-      const content = fs21.readFileSync(envPath, "utf-8");
+      const content = fs22.readFileSync(envPath, "utf-8");
       const vars = [];
       for (const line of content.split("\n")) {
         const trimmed = line.trim();
@@ -5716,9 +5785,9 @@ function runQaDiscovery(cwd) {
 }
 function detectDevServer(cwd, out) {
   try {
-    const pkg = JSON.parse(fs22.readFileSync(path21.join(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs23.readFileSync(path22.join(cwd, "package.json"), "utf-8"));
     const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
-    const pm = fs22.existsSync(path21.join(cwd, "pnpm-lock.yaml")) ? "pnpm" : fs22.existsSync(path21.join(cwd, "yarn.lock")) ? "yarn" : fs22.existsSync(path21.join(cwd, "bun.lockb")) ? "bun" : "npm";
+    const pm = fs23.existsSync(path22.join(cwd, "pnpm-lock.yaml")) ? "pnpm" : fs23.existsSync(path22.join(cwd, "yarn.lock")) ? "yarn" : fs23.existsSync(path22.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;
@@ -5728,8 +5797,8 @@ function detectDevServer(cwd, out) {
 function scanFrontendRoutes(cwd, out) {
   const appDirs = ["src/app", "app"];
   for (const appDir of appDirs) {
-    const full = path21.join(cwd, appDir);
-    if (!fs22.existsSync(full)) continue;
+    const full = path22.join(cwd, appDir);
+    if (!fs23.existsSync(full)) continue;
     walkFrontendRoutes(full, "", out);
     break;
   }
@@ -5737,7 +5806,7 @@ function scanFrontendRoutes(cwd, out) {
 function walkFrontendRoutes(dir, prefix, out) {
   let entries;
   try {
-    entries = fs22.readdirSync(dir, { withFileTypes: true });
+    entries = fs23.readdirSync(dir, { withFileTypes: true });
   } catch {
     return;
   }
@@ -5754,7 +5823,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(path21.join(dir, entry.name), prefix, out);
+      walkFrontendRoutes(path22.join(dir, entry.name), prefix, out);
       continue;
     }
     if (segment.startsWith("[[") && segment.endsWith("]]")) {
@@ -5762,7 +5831,7 @@ function walkFrontendRoutes(dir, prefix, out) {
     } else if (segment.startsWith("[") && segment.endsWith("]")) {
       segment = `:${segment.slice(1, -1)}`;
     }
-    walkFrontendRoutes(path21.join(dir, entry.name), `${prefix}/${segment}`, out);
+    walkFrontendRoutes(path22.join(dir, entry.name), `${prefix}/${segment}`, out);
   }
 }
 function detectAuthFiles(cwd, out) {
@@ -5779,23 +5848,23 @@ function detectAuthFiles(cwd, out) {
     "src/app/api/oauth"
   ];
   for (const c of candidates) {
-    if (fs22.existsSync(path21.join(cwd, c))) out.authFiles.push(c);
+    if (fs23.existsSync(path22.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 = path21.join(cwd, rp);
-    if (!fs22.existsSync(dir)) continue;
+    const dir = path22.join(cwd, rp);
+    if (!fs23.existsSync(dir)) continue;
     let files;
     try {
-      files = fs22.readdirSync(dir).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
+      files = fs23.readdirSync(dir).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
     } catch {
       continue;
     }
     for (const f of files) {
       try {
-        const content = fs22.readFileSync(path21.join(dir, f), "utf-8").slice(0, 5e3);
+        const content = fs23.readFileSync(path22.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) {
@@ -6028,8 +6097,8 @@ function failedAction3(reason) {
 }
 
 // src/scripts/dispatchJobFileTicks.ts
-import * as fs24 from "fs";
-import * as path23 from "path";
+import * as fs25 from "fs";
+import * as path24 from "path";
 
 // src/scripts/jobFrontmatter.ts
 var SCHEDULE_EVERY_VALUES = [
@@ -6288,8 +6357,8 @@ var ContentsApiBackend = class {
 };
 
 // src/scripts/jobState/localFileBackend.ts
-import * as fs23 from "fs";
-import * as path22 from "path";
+import * as fs24 from "fs";
+import * as path23 from "path";
 var LocalFileBackend = class {
   name = "local-file";
   cwd;
@@ -6304,7 +6373,7 @@ var LocalFileBackend = class {
     if (!opts.owner || !opts.repo) throw new Error("LocalFileBackend: owner and repo are required");
     this.cwd = opts.cwd;
     this.jobsDir = opts.jobsDir;
-    this.absDir = path22.join(opts.cwd, opts.jobsDir);
+    this.absDir = path23.join(opts.cwd, opts.jobsDir);
     this.owner = opts.owner;
     this.repo = opts.repo;
     this.cache = opts.cache ?? defaultCacheAdapter();
@@ -6319,7 +6388,7 @@ var LocalFileBackend = class {
 `);
       return;
     }
-    fs23.mkdirSync(this.absDir, { recursive: true });
+    fs24.mkdirSync(this.absDir, { recursive: true });
     const prefix = this.cacheKeyPrefix();
     const probeKey = `${prefix}probe-${Date.now()}`;
     try {
@@ -6348,7 +6417,7 @@ var LocalFileBackend = class {
 `);
       return;
     }
-    if (!fs23.existsSync(this.absDir)) {
+    if (!fs24.existsSync(this.absDir)) {
       return;
     }
     const key = `${this.cacheKeyPrefix()}${process.env.GITHUB_RUN_ID ?? "norunid"}-${Date.now()}`;
@@ -6364,11 +6433,11 @@ var LocalFileBackend = class {
   }
   load(slug) {
     const relPath = stateFilePath(this.jobsDir, slug);
-    const absPath = path22.join(this.cwd, relPath);
-    if (!fs23.existsSync(absPath)) {
+    const absPath = path23.join(this.cwd, relPath);
+    if (!fs24.existsSync(absPath)) {
       return { path: relPath, handle: null, state: initialStateEnvelope("seed"), created: true };
     }
-    const raw = fs23.readFileSync(absPath, "utf-8");
+    const raw = fs24.readFileSync(absPath, "utf-8");
     let parsed;
     try {
       parsed = JSON.parse(raw);
@@ -6385,10 +6454,10 @@ var LocalFileBackend = class {
     if (!loaded.created && isStateUnchanged(loaded.state, next)) {
       return false;
     }
-    const absPath = path22.join(this.cwd, loaded.path);
-    fs23.mkdirSync(path22.dirname(absPath), { recursive: true });
+    const absPath = path23.join(this.cwd, loaded.path);
+    fs24.mkdirSync(path23.dirname(absPath), { recursive: true });
     const body = JSON.stringify(next, null, 2) + "\n";
-    fs23.writeFileSync(absPath, body, "utf-8");
+    fs24.writeFileSync(absPath, body, "utf-8");
     return true;
   }
   cacheKeyPrefix() {
@@ -6466,7 +6535,7 @@ var dispatchJobFileTicks = async (ctx, _profile, args) => {
     await backend.hydrate();
   }
   try {
-    const slugs = listJobSlugs(path23.join(ctx.cwd, jobsDir));
+    const slugs = listJobSlugs(path24.join(ctx.cwd, jobsDir));
     ctx.data.jobSlugCount = slugs.length;
     if (slugs.length === 0) {
       process.stdout.write(`[jobs] no job files in ${jobsDir}
@@ -6571,17 +6640,17 @@ function formatAgo(ms) {
 }
 function readJobFrontmatter(cwd, jobsDir, slug) {
   try {
-    const raw = fs24.readFileSync(path23.join(cwd, jobsDir, `${slug}.md`), "utf-8");
+    const raw = fs25.readFileSync(path24.join(cwd, jobsDir, `${slug}.md`), "utf-8");
     return splitFrontmatter(raw).frontmatter;
   } catch {
     return {};
   }
 }
 function listJobSlugs(absDir) {
-  if (!fs24.existsSync(absDir)) return [];
+  if (!fs25.existsSync(absDir)) return [];
   let entries;
   try {
-    entries = fs24.readdirSync(absDir, { withFileTypes: true });
+    entries = fs25.readdirSync(absDir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -7049,6 +7118,50 @@ var finalizeGoal = async (ctx) => {
   goal.state = "done";
 };
 
+// src/scripts/finalizeTerminal.ts
+init_issue();
+var DONE = {
+  label: "kody:done",
+  color: "0e8a16",
+  description: "kody: PR ready for human review/merge"
+};
+var FAILED = {
+  label: "kody:failed",
+  color: "e11d21",
+  description: "kody: flow failed"
+};
+var finalizeTerminal = async (ctx) => {
+  const target = ctx.data.commentTargetType ?? "issue";
+  const issueNumber = ctx.args.issue;
+  const targetNumber = ctx.data.commentTargetNumber ?? issueNumber;
+  if (!targetNumber) return;
+  let prUrl;
+  try {
+    prUrl = readTaskState(target, targetNumber, ctx.cwd).core.prUrl;
+  } catch {
+    prUrl = void 0;
+  }
+  const delivered = ctx.output.exitCode === 0 && !!prUrl;
+  const spec = delivered ? DONE : FAILED;
+  const phase = delivered ? "shipped" : "failed";
+  const status = delivered ? "succeeded" : "failed";
+  if (issueNumber) setKodyLabel(issueNumber, spec, ctx.cwd);
+  const prNumber = prUrl ? parsePrNumber(prUrl) : null;
+  if (prNumber && prNumber !== issueNumber) setKodyLabel(prNumber, spec, ctx.cwd);
+  try {
+    const state = readTaskState(target, targetNumber, ctx.cwd);
+    state.core.phase = phase;
+    state.core.status = status;
+    state.core.currentExecutable = null;
+    writeTaskState(target, targetNumber, state, ctx.cwd);
+  } catch (err) {
+    process.stderr.write(
+      `[kody finalizeTerminal] failed to write terminal state on ${target} #${targetNumber}: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+};
+
 // src/scripts/finishFlow.ts
 init_issue();
 import { execFileSync as execFileSync14 } from "child_process";
@@ -7290,7 +7403,7 @@ function ensureFeatureBranch(issueNumber, title, defaultBranch2, cwd, baseBranch
 
 // src/gha.ts
 import { execFileSync as execFileSync16 } from "child_process";
-import * as fs25 from "fs";
+import * as fs26 from "fs";
 function getRunUrl() {
   const server = process.env.GITHUB_SERVER_URL;
   const repo = process.env.GITHUB_REPOSITORY;
@@ -7301,10 +7414,10 @@ function getRunUrl() {
 function reactToTriggerComment(cwd) {
   if (process.env.GITHUB_EVENT_NAME !== "issue_comment") return;
   const eventPath = process.env.GITHUB_EVENT_PATH;
-  if (!eventPath || !fs25.existsSync(eventPath)) return;
+  if (!eventPath || !fs26.existsSync(eventPath)) return;
   let event = null;
   try {
-    event = JSON.parse(fs25.readFileSync(eventPath, "utf-8"));
+    event = JSON.parse(fs26.readFileSync(eventPath, "utf-8"));
   } catch {
     return;
   }
@@ -7597,22 +7710,22 @@ var handleAbandonedGoal = async (ctx) => {
 
 // src/scripts/initFlow.ts
 import { execFileSync as execFileSync18 } from "child_process";
-import * as fs27 from "fs";
-import * as path25 from "path";
+import * as fs28 from "fs";
+import * as path26 from "path";
 
 // src/scripts/loadQaGuide.ts
-import * as fs26 from "fs";
-import * as path24 from "path";
+import * as fs27 from "fs";
+import * as path25 from "path";
 var QA_GUIDE_REL_PATH = ".kody/qa-guide.md";
 var loadQaGuide = async (ctx) => {
-  const full = path24.join(ctx.cwd, QA_GUIDE_REL_PATH);
-  if (!fs26.existsSync(full)) {
+  const full = path25.join(ctx.cwd, QA_GUIDE_REL_PATH);
+  if (!fs27.existsSync(full)) {
     ctx.data.qaGuide = "";
     ctx.data.qaGuidePath = "";
     return;
   }
   try {
-    ctx.data.qaGuide = fs26.readFileSync(full, "utf-8");
+    ctx.data.qaGuide = fs27.readFileSync(full, "utf-8");
     ctx.data.qaGuidePath = QA_GUIDE_REL_PATH;
   } catch {
     ctx.data.qaGuide = "";
@@ -7622,9 +7735,9 @@ var loadQaGuide = async (ctx) => {
 
 // src/scripts/initFlow.ts
 function detectPackageManager(cwd) {
-  if (fs27.existsSync(path25.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs27.existsSync(path25.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs27.existsSync(path25.join(cwd, "bun.lockb"))) return "bun";
+  if (fs28.existsSync(path26.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs28.existsSync(path26.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs28.existsSync(path26.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function qualityCommandsFor(pm) {
@@ -7746,48 +7859,48 @@ function performInit(cwd, force) {
   const pm = detectPackageManager(cwd);
   const ownerRepo = detectOwnerRepo(cwd);
   const defaultBranch2 = defaultBranchFromGit(cwd);
-  const configPath = path25.join(cwd, "kody.config.json");
-  if (fs27.existsSync(configPath) && !force) {
+  const configPath = path26.join(cwd, "kody.config.json");
+  if (fs28.existsSync(configPath) && !force) {
     skipped.push("kody.config.json");
   } else {
     const cfg = makeConfig(pm, ownerRepo, defaultBranch2);
-    fs27.writeFileSync(configPath, `${JSON.stringify(cfg, null, 2)}
+    fs28.writeFileSync(configPath, `${JSON.stringify(cfg, null, 2)}
 `);
     wrote.push("kody.config.json");
   }
-  const workflowDir = path25.join(cwd, ".github", "workflows");
-  const workflowPath = path25.join(workflowDir, "kody.yml");
-  if (fs27.existsSync(workflowPath) && !force) {
+  const workflowDir = path26.join(cwd, ".github", "workflows");
+  const workflowPath = path26.join(workflowDir, "kody.yml");
+  if (fs28.existsSync(workflowPath) && !force) {
     skipped.push(".github/workflows/kody.yml");
   } else {
-    fs27.mkdirSync(workflowDir, { recursive: true });
-    fs27.writeFileSync(workflowPath, WORKFLOW_TEMPLATE);
+    fs28.mkdirSync(workflowDir, { recursive: true });
+    fs28.writeFileSync(workflowPath, WORKFLOW_TEMPLATE);
     wrote.push(".github/workflows/kody.yml");
   }
-  const hasUi = fs27.existsSync(path25.join(cwd, "src/app")) || fs27.existsSync(path25.join(cwd, "app")) || fs27.existsSync(path25.join(cwd, "pages"));
+  const hasUi = fs28.existsSync(path26.join(cwd, "src/app")) || fs28.existsSync(path26.join(cwd, "app")) || fs28.existsSync(path26.join(cwd, "pages"));
   if (hasUi) {
-    const qaGuidePath = path25.join(cwd, QA_GUIDE_REL_PATH);
-    if (fs27.existsSync(qaGuidePath) && !force) {
+    const qaGuidePath = path26.join(cwd, QA_GUIDE_REL_PATH);
+    if (fs28.existsSync(qaGuidePath) && !force) {
       skipped.push(QA_GUIDE_REL_PATH);
     } else {
-      fs27.mkdirSync(path25.dirname(qaGuidePath), { recursive: true });
+      fs28.mkdirSync(path26.dirname(qaGuidePath), { recursive: true });
       const discovery = runQaDiscovery(cwd);
-      fs27.writeFileSync(qaGuidePath, generateQaGuideTemplate(discovery));
+      fs28.writeFileSync(qaGuidePath, generateQaGuideTemplate(discovery));
       wrote.push(QA_GUIDE_REL_PATH);
     }
   }
   const builtinJobs = listBuiltinJobs();
   if (builtinJobs.length > 0) {
-    const jobsDir = path25.join(cwd, ".kody", "jobs");
-    fs27.mkdirSync(jobsDir, { recursive: true });
+    const jobsDir = path26.join(cwd, ".kody", "jobs");
+    fs28.mkdirSync(jobsDir, { recursive: true });
     for (const job of builtinJobs) {
-      const rel = path25.join(".kody", "jobs", `${job.slug}.md`);
-      const target = path25.join(cwd, rel);
-      if (fs27.existsSync(target) && !force) {
+      const rel = path26.join(".kody", "jobs", `${job.slug}.md`);
+      const target = path26.join(cwd, rel);
+      if (fs28.existsSync(target) && !force) {
         skipped.push(rel);
         continue;
       }
-      fs27.writeFileSync(target, fs27.readFileSync(job.filePath, "utf-8"));
+      fs28.writeFileSync(target, fs28.readFileSync(job.filePath, "utf-8"));
       wrote.push(rel);
     }
   }
@@ -7799,12 +7912,12 @@ function performInit(cwd, force) {
       continue;
     }
     if (profile.kind !== "scheduled" || !profile.schedule) continue;
-    const target = path25.join(workflowDir, `kody-${exe.name}.yml`);
-    if (fs27.existsSync(target) && !force) {
+    const target = path26.join(workflowDir, `kody-${exe.name}.yml`);
+    if (fs28.existsSync(target) && !force) {
       skipped.push(`.github/workflows/kody-${exe.name}.yml`);
       continue;
     }
-    fs27.writeFileSync(target, renderScheduledWorkflow(exe.name, profile.schedule));
+    fs28.writeFileSync(target, renderScheduledWorkflow(exe.name, profile.schedule));
     wrote.push(`.github/workflows/kody-${exe.name}.yml`);
   }
   let labels;
@@ -7882,14 +7995,14 @@ init_loadConventions();
 init_loadCoverageRules();
 
 // src/goal/state.ts
-import * as fs28 from "fs";
-import * as path26 from "path";
+import * as fs29 from "fs";
+import * as path27 from "path";
 var VALID_STATES = /* @__PURE__ */ new Set(["active", "abandoned", "closed", "awaiting-merge", "done"]);
 var GoalStateError = class extends Error {
-  constructor(path34, message) {
-    super(`Invalid goal state at ${path34}:
+  constructor(path35, message) {
+    super(`Invalid goal state at ${path35}:
   ${message}`);
-    this.path = path34;
+    this.path = path35;
     this.name = "GoalStateError";
   }
   path;
@@ -7937,16 +8050,16 @@ function serializeGoalState(s) {
 `;
 }
 function goalStatePath(cwd, goalId) {
-  return path26.join(cwd, ".kody", "goals", goalId, "state.json");
+  return path27.join(cwd, ".kody", "goals", goalId, "state.json");
 }
 function readGoalState(cwd, goalId) {
   const file = goalStatePath(cwd, goalId);
-  if (!fs28.existsSync(file)) {
+  if (!fs29.existsSync(file)) {
     throw new GoalStateError(file, "file not found");
   }
   let raw;
   try {
-    raw = JSON.parse(fs28.readFileSync(file, "utf-8"));
+    raw = JSON.parse(fs29.readFileSync(file, "utf-8"));
   } catch (err) {
     throw new GoalStateError(file, `invalid JSON: ${err instanceof Error ? err.message : String(err)}`);
   }
@@ -7954,8 +8067,8 @@ function readGoalState(cwd, goalId) {
 }
 function writeGoalState(cwd, goalId, state) {
   const file = goalStatePath(cwd, goalId);
-  fs28.mkdirSync(path26.dirname(file), { recursive: true });
-  fs28.writeFileSync(file, serializeGoalState(state), "utf-8");
+  fs29.mkdirSync(path27.dirname(file), { recursive: true });
+  fs29.writeFileSync(file, serializeGoalState(state), "utf-8");
 }
 function nowIso() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z");
@@ -8052,8 +8165,8 @@ var loadIssueStateComment = async (ctx, _profile, args) => {
 };
 
 // src/scripts/loadJobFromFile.ts
-import * as fs29 from "fs";
-import * as path27 from "path";
+import * as fs30 from "fs";
+import * as path28 from "path";
 var loadJobFromFile = async (ctx, _profile, args) => {
   const jobsDir = String(args?.jobsDir ?? ".kody/jobs");
   const slugArg = String(args?.slugArg ?? "job");
@@ -8061,11 +8174,11 @@ var loadJobFromFile = async (ctx, _profile, args) => {
   if (!slug) {
     throw new Error(`loadJobFromFile: ctx.args.${slugArg} must be a non-empty slug`);
   }
-  const absPath = path27.join(ctx.cwd, jobsDir, `${slug}.md`);
-  if (!fs29.existsSync(absPath)) {
+  const absPath = path28.join(ctx.cwd, jobsDir, `${slug}.md`);
+  if (!fs30.existsSync(absPath)) {
     throw new Error(`loadJobFromFile: job file not found: ${absPath}`);
   }
-  const raw = fs29.readFileSync(absPath, "utf-8");
+  const raw = fs30.readFileSync(absPath, "utf-8");
   const { title, body } = parseJobFile(raw, slug);
   const backend = resolveBackend({ config: ctx.config, cwd: ctx.cwd, jobsDir });
   const loaded = await backend.load(slug);
@@ -8104,8 +8217,8 @@ init_loadPriorArt();
 init_events();
 
 // src/taskContext.ts
-import * as fs31 from "fs";
-import * as path29 from "path";
+import * as fs32 from "fs";
+import * as path30 from "path";
 var TASK_CONTEXT_SCHEMA_VERSION = 1;
 function buildTaskContext(args) {
   return {
@@ -8121,10 +8234,10 @@ function buildTaskContext(args) {
 }
 function persistTaskContext(cwd, ctx) {
   try {
-    const dir = path29.join(cwd, ".kody", "runs", ctx.runId);
-    fs31.mkdirSync(dir, { recursive: true });
-    const file = path29.join(dir, "task-context.json");
-    fs31.writeFileSync(file, `${JSON.stringify(ctx, null, 2)}
+    const dir = path30.join(cwd, ".kody", "runs", ctx.runId);
+    fs32.mkdirSync(dir, { recursive: true });
+    const file = path30.join(dir, "task-context.json");
+    fs32.writeFileSync(file, `${JSON.stringify(ctx, null, 2)}
 `);
     return file;
   } catch (err) {
@@ -9487,8 +9600,8 @@ function resolveBaseOverride(value) {
 
 // src/scripts/runTickScript.ts
 import { spawnSync } from "child_process";
-import * as fs32 from "fs";
-import * as path30 from "path";
+import * as fs33 from "fs";
+import * as path31 from "path";
 var runTickScript = async (ctx, _profile, args) => {
   ctx.skipAgent = true;
   const jobsDir = String(args?.jobsDir ?? ".kody/jobs");
@@ -9500,13 +9613,13 @@ var runTickScript = async (ctx, _profile, args) => {
     ctx.output.reason = `runTickScript: ctx.args.${slugArg} must be a non-empty slug`;
     return;
   }
-  const jobPath = path30.join(ctx.cwd, jobsDir, `${slug}.md`);
-  if (!fs32.existsSync(jobPath)) {
+  const jobPath = path31.join(ctx.cwd, jobsDir, `${slug}.md`);
+  if (!fs33.existsSync(jobPath)) {
     ctx.output.exitCode = 99;
     ctx.output.reason = `runTickScript: job file not found: ${jobPath}`;
     return;
   }
-  const raw = fs32.readFileSync(jobPath, "utf-8");
+  const raw = fs33.readFileSync(jobPath, "utf-8");
   const { frontmatter } = splitFrontmatter(raw);
   const tickScript = frontmatter.tickScript;
   if (!tickScript) {
@@ -9514,8 +9627,8 @@ var runTickScript = async (ctx, _profile, args) => {
     ctx.output.reason = `runTickScript: job ${slug} has no \`tickScript:\` frontmatter \u2014 route via job-tick instead`;
     return;
   }
-  const scriptPath = path30.isAbsolute(tickScript) ? tickScript : path30.join(ctx.cwd, tickScript);
-  if (!fs32.existsSync(scriptPath)) {
+  const scriptPath = path31.isAbsolute(tickScript) ? tickScript : path31.join(ctx.cwd, tickScript);
+  if (!fs33.existsSync(scriptPath)) {
     ctx.output.exitCode = 99;
     ctx.output.reason = `runTickScript: tickScript not found: ${scriptPath}`;
     return;
@@ -10537,7 +10650,7 @@ var writeJobStateFile = async (ctx, _profile, _agentResult, args) => {
 };
 
 // src/scripts/writeRunSummary.ts
-import * as fs33 from "fs";
+import * as fs34 from "fs";
 var writeRunSummary = async (ctx, profile) => {
   const summaryPath = process.env.GITHUB_STEP_SUMMARY;
   if (!summaryPath) return;
@@ -10559,7 +10672,7 @@ var writeRunSummary = async (ctx, profile) => {
   if (reason) lines.push(`- **Reason:** ${reason}`);
   lines.push("");
   try {
-    fs33.appendFileSync(summaryPath, `${lines.join("\n")}
+    fs34.appendFileSync(summaryPath, `${lines.join("\n")}
 `);
   } catch {
   }
@@ -10637,6 +10750,7 @@ var postflightScripts = {
   startFlow,
   dispatch,
   finishFlow,
+  finalizeTerminal,
   advanceFlow,
   persistFlowState,
   recordClassification,
@@ -10783,9 +10897,9 @@ async function runExecutable(profileName, input) {
     data: { ...input.preloadedData ?? {} },
     output: { exitCode: 0 }
   };
-  const ndjsonDir = path31.join(input.cwd, ".kody");
+  const ndjsonDir = path32.join(input.cwd, ".kody");
   const invokeAgent = async (prompt) => {
-    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path31.isAbsolute(p) ? p : path31.resolve(profile.dir, p)).filter((p) => p.length > 0);
+    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path32.isAbsolute(p) ? p : path32.resolve(profile.dir, p)).filter((p) => p.length > 0);
     const syntheticPath = ctx.data.syntheticPluginPath;
     const pluginPaths = [...externalPlugins, ...syntheticPath ? [syntheticPath] : []];
     return runAgent({
@@ -10980,7 +11094,7 @@ function clearStampedLifecycleLabels(profile, ctx) {
 function getProfileInputsForChild(profileName, _cwd) {
   try {
     const profilePath = resolveProfilePath(profileName);
-    if (!fs34.existsSync(profilePath)) return null;
+    if (!fs35.existsSync(profilePath)) return null;
     return loadProfile(profilePath).inputs;
   } catch {
     return null;
@@ -10989,17 +11103,17 @@ function getProfileInputsForChild(profileName, _cwd) {
 function resolveProfilePath(profileName) {
   const found = resolveExecutable(profileName);
   if (found) return found;
-  const here = path31.dirname(new URL(import.meta.url).pathname);
+  const here = path32.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path31.join(here, "executables", profileName, "profile.json"),
+    path32.join(here, "executables", profileName, "profile.json"),
     // same-dir sibling (dev)
-    path31.join(here, "..", "executables", profileName, "profile.json"),
+    path32.join(here, "..", "executables", profileName, "profile.json"),
     // up one (prod: dist/bin → dist/executables)
-    path31.join(here, "..", "src", "executables", profileName, "profile.json")
+    path32.join(here, "..", "src", "executables", profileName, "profile.json")
     // fallback
   ];
   for (const c of candidates) {
-    if (fs34.existsSync(c)) return c;
+    if (fs35.existsSync(c)) return c;
   }
   return candidates[0];
 }
@@ -11099,8 +11213,8 @@ function resolveShellTimeoutMs(entry) {
 var SIGKILL_GRACE_MS = 5e3;
 async function runShellEntry(entry, ctx, profile) {
   const shellName = entry.shell;
-  const shellPath = path31.join(profile.dir, shellName);
-  if (!fs34.existsSync(shellPath)) {
+  const shellPath = path32.join(profile.dir, shellName);
+  if (!fs35.existsSync(shellPath)) {
     ctx.skipAgent = true;
     ctx.output.exitCode = 99;
     ctx.output.reason = `shell script not found: ${shellName} (looked in ${profile.dir})`;
@@ -11440,8 +11554,8 @@ function resetWorkingTree2(cwd) {
 }
 function readContainerState(ctx, child, reader) {
   const issueNumber = ctx.args.issue;
-  const cached = ctx.data.taskState;
-  const prUrl = cached?.core?.prUrl;
+  const cached2 = ctx.data.taskState;
+  const prUrl = cached2?.core?.prUrl;
   const prNumber = prUrl ? parsePrNumber4(prUrl) : null;
   if (child.target === "pr" && prNumber) {
     try {
@@ -11455,8 +11569,8 @@ function readContainerState(ctx, child, reader) {
     } catch {
     }
   }
-  if (cached && typeof cached === "object") {
-    return cached;
+  if (cached2 && typeof cached2 === "object") {
+    return cached2;
   }
   return {
     schemaVersion: 1,
@@ -11579,9 +11693,9 @@ function resolveAuthToken(env = process.env) {
   return token;
 }
 function detectPackageManager2(cwd) {
-  if (fs35.existsSync(path32.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs35.existsSync(path32.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs35.existsSync(path32.join(cwd, "bun.lockb"))) return "bun";
+  if (fs36.existsSync(path33.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs36.existsSync(path33.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs36.existsSync(path33.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function shellOut(cmd, args, cwd, stream = true) {
@@ -11668,11 +11782,11 @@ function configureGitIdentity(cwd) {
 }
 function postFailureTail(issueNumber, cwd, reason) {
   if (!issueNumber) return;
-  const logPath = path32.join(cwd, ".kody", "last-run.jsonl");
+  const logPath = path33.join(cwd, ".kody", "last-run.jsonl");
   let tail = "";
   try {
-    if (fs35.existsSync(logPath)) {
-      const content = fs35.readFileSync(logPath, "utf-8");
+    if (fs36.existsSync(logPath)) {
+      const content = fs36.readFileSync(logPath, "utf-8");
       tail = content.slice(-3e3);
     }
   } catch {
@@ -11697,7 +11811,7 @@ async function runCi(argv) {
     return 0;
   }
   const args = parseCiArgs(argv);
-  const cwd = args.cwd ? path32.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path33.resolve(args.cwd) : process.cwd();
   let earlyConfig;
   try {
     earlyConfig = loadConfig(cwd);
@@ -11707,9 +11821,9 @@ async function runCi(argv) {
   const eventName = process.env.GITHUB_EVENT_NAME;
   const dispatchEventPath = process.env.GITHUB_EVENT_PATH;
   let manualWorkflowDispatch = false;
-  if (!args.issueNumber && !autoFallback && eventName === "workflow_dispatch" && dispatchEventPath && fs35.existsSync(dispatchEventPath)) {
+  if (!args.issueNumber && !autoFallback && eventName === "workflow_dispatch" && dispatchEventPath && fs36.existsSync(dispatchEventPath)) {
     try {
-      const evt = JSON.parse(fs35.readFileSync(dispatchEventPath, "utf-8"));
+      const evt = JSON.parse(fs36.readFileSync(dispatchEventPath, "utf-8"));
       const issueInput = parseInt(String(evt?.inputs?.issue_number ?? ""), 10);
       const sessionInput = String(evt?.inputs?.sessionId ?? "");
       manualWorkflowDispatch = !sessionInput && !(Number.isFinite(issueInput) && issueInput > 0);
@@ -11968,9 +12082,9 @@ function parseChatArgs(argv, env = process.env) {
   return result;
 }
 function commitChatFiles(cwd, sessionId, verbose) {
-  const sessionFile = path33.relative(cwd, sessionFilePath(cwd, sessionId));
-  const eventsFile = path33.relative(cwd, eventsFilePath(cwd, sessionId));
-  const paths = [sessionFile, eventsFile].filter((p) => fs36.existsSync(path33.join(cwd, p)));
+  const sessionFile = path34.relative(cwd, sessionFilePath(cwd, sessionId));
+  const eventsFile = path34.relative(cwd, eventsFilePath(cwd, sessionId));
+  const paths = [sessionFile, eventsFile].filter((p) => fs37.existsSync(path34.join(cwd, p)));
   if (paths.length === 0) return;
   const opts = { cwd, stdio: verbose ? "inherit" : "pipe" };
   try {
@@ -12008,7 +12122,7 @@ async function runChat(argv) {
 ${CHAT_HELP}`);
     return 64;
   }
-  const cwd = args.cwd ? path33.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path34.resolve(args.cwd) : process.cwd();
   const sessionId = args.sessionId;
   const unpackedSecrets = unpackAllSecrets();
   if (unpackedSecrets > 0) {
@@ -12060,7 +12174,7 @@ ${CHAT_HELP}`);
   const sink = buildSink(cwd, sessionId, args.dashboardUrl);
   const meta = readMeta(sessionFile);
   process.stdout.write(
-    `\u2192 kody:chat: session file=${sessionFile} exists=${fs36.existsSync(sessionFile)} meta=${meta ? meta.mode : "none"}
+    `\u2192 kody:chat: session file=${sessionFile} exists=${fs37.existsSync(sessionFile)} meta=${meta ? meta.mode : "none"}
 `
   );
   try {