@kody-ade/kody-engine 0.4.156 → 0.4.158

package/dist/bin/kody.js

@@ -650,16 +650,16 @@ var init_issue = __esm({
 });
 
 // src/prompt.ts
-import * as fs20 from "fs";
-import * as path19 from "path";
+import * as fs21 from "fs";
+import * as path20 from "path";
 function loadProjectConventions(projectDir) {
   const out = [];
   for (const rel of CONVENTION_FILES) {
-    const abs = path19.join(projectDir, rel);
-    if (!fs20.existsSync(abs)) continue;
+    const abs = path20.join(projectDir, rel);
+    if (!fs21.existsSync(abs)) continue;
     let content;
     try {
-      content = fs20.readFileSync(abs, "utf-8");
+      content = fs21.readFileSync(abs, "utf-8");
     } catch {
       continue;
     }
@@ -807,28 +807,28 @@ var loadMemoryContext_exports = {};
 __export(loadMemoryContext_exports, {
   loadMemoryContext: () => loadMemoryContext
 });
-import * as fs32 from "fs";
-import * as path30 from "path";
+import * as fs33 from "fs";
+import * as path31 from "path";
 function collectPages(memoryAbs) {
   const out = [];
   walkMd(memoryAbs, (file) => {
     let stat;
     try {
-      stat = fs32.statSync(file);
+      stat = fs33.statSync(file);
     } catch {
       return;
     }
     let raw;
     try {
-      raw = fs32.readFileSync(file, "utf-8");
+      raw = fs33.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() ?? path30.basename(file, ".md");
+    const title = fm?.[1]?.match(/^title:\s*(.+)$/m)?.[1]?.trim() ?? path31.basename(file, ".md");
     const updated = fm?.[1]?.match(/^updated:\s*([0-9T:.+\-Z]+)/m)?.[1]?.trim() ?? "";
     out.push({
-      relPath: path30.relative(memoryAbs, file),
+      relPath: path31.relative(memoryAbs, file),
       title,
       updated,
       content: raw.length > PER_PAGE_MAX_BYTES ? raw.slice(0, PER_PAGE_MAX_BYTES) + TRUNCATED_SUFFIX : raw,
@@ -896,16 +896,16 @@ function walkMd(root, visit) {
     const dir = stack.pop();
     let names;
     try {
-      names = fs32.readdirSync(dir);
+      names = fs33.readdirSync(dir);
     } catch {
       continue;
     }
     for (const name of names) {
       if (name.startsWith(".")) continue;
-      const full = path30.join(dir, name);
+      const full = path31.join(dir, name);
       let stat;
       try {
-        stat = fs32.statSync(full);
+        stat = fs33.statSync(full);
       } catch {
         continue;
       }
@@ -928,8 +928,8 @@ var init_loadMemoryContext = __esm({
     TRUNCATED_SUFFIX = "\n\n\u2026 (truncated)";
     loadMemoryContext = async (ctx) => {
       if (typeof ctx.data.memoryContext === "string") return;
-      const memoryAbs = path30.join(ctx.cwd, MEMORY_DIR_RELATIVE);
-      if (!fs32.existsSync(memoryAbs)) {
+      const memoryAbs = path31.join(ctx.cwd, MEMORY_DIR_RELATIVE);
+      if (!fs33.existsSync(memoryAbs)) {
         ctx.data.memoryContext = "";
         return;
       }
@@ -1061,7 +1061,7 @@ var init_loadPriorArt = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.156",
+  version: "0.4.158",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -1118,8 +1118,8 @@ var package_default = {
 
 // src/chat-cli.ts
 import { execFileSync as execFileSync31 } from "child_process";
-import * as fs42 from "fs";
-import * as path38 from "path";
+import * as fs43 from "fs";
+import * as path39 from "path";
 
 // src/chat/events.ts
 import * as fs from "fs";
@@ -1185,8 +1185,8 @@ function makeRunId(sessionId, suffix) {
 }
 
 // src/chat/loop.ts
-import * as fs10 from "fs";
-import * as path10 from "path";
+import * as fs11 from "fs";
+import * as path11 from "path";
 
 // src/task-artifacts.ts
 import fs2 from "fs";
@@ -2156,6 +2156,65 @@ function seedInitialMessage(file, message) {
   return true;
 }
 
+// src/chat/attachments.ts
+import * as fs10 from "fs";
+import * as path10 from "path";
+var INLINE_ATTACHMENT_RE = /(?:\[(?:Image|File): ([^\]]*)\]\n)?data:([\w.+-]+\/[\w.+-]+);base64,([A-Za-z0-9+/=]+)/g;
+var EXT_BY_MIME = {
+  "image/png": "png",
+  "image/jpeg": "jpg",
+  "image/jpg": "jpg",
+  "image/gif": "gif",
+  "image/webp": "webp",
+  "image/bmp": "bmp",
+  "image/svg+xml": "svg",
+  "image/avif": "avif"
+};
+function extFor(mime) {
+  return EXT_BY_MIME[mime.toLowerCase()] ?? mime.split("/")[1]?.replace(/[^\w]/g, "") ?? "bin";
+}
+function attachmentsDir(cwd, sessionId) {
+  return path10.join(cwd, ".kody", "tmp", "attachments", sessionId);
+}
+function prepareAttachments(turns, cwd, sessionId) {
+  const lastUserIdx = (() => {
+    for (let i = turns.length - 1; i >= 0; i--) {
+      if (turns[i].role === "user") return i;
+    }
+    return -1;
+  })();
+  const imagePaths = [];
+  let imageCounter = 0;
+  const rewritten = turns.map((turn, idx) => {
+    if (!turn.content.includes("base64,")) return turn;
+    const isLastUser = idx === lastUserIdx;
+    const newContent = turn.content.replace(
+      INLINE_ATTACHMENT_RE,
+      (_match, label, mime, data) => {
+        const name = (label ?? "").trim() || "attachment";
+        const isImage = mime.toLowerCase().startsWith("image/");
+        if (!isLastUser || !isImage) {
+          return `[${isImage ? "Image" : "File"}: ${name}${isLastUser ? "" : " \u2014 omitted from history"}]`;
+        }
+        try {
+          const dir = attachmentsDir(cwd, sessionId);
+          fs10.mkdirSync(dir, { recursive: true });
+          const filePath = path10.join(dir, `${imageCounter}.${extFor(mime)}`);
+          fs10.writeFileSync(filePath, Buffer.from(data, "base64"));
+          imageCounter += 1;
+          imagePaths.push(filePath);
+          return `[Image "${name}" is attached \u2014 saved to ${filePath}. Use the Read tool on that exact path to view it before answering.]`;
+        } catch {
+          return `[Image: ${name} (could not be materialised)]`;
+        }
+      }
+    );
+    if (newContent === turn.content) return turn;
+    return { ...turn, content: newContent };
+  });
+  return { turns: rewritten, imagePaths };
+}
+
 // src/chat/loop.ts
 var CHAT_SYSTEM_PROMPT = [
   "You are Kody, an AI assistant for the Kody Operations Dashboard. Reply to the",
@@ -2259,7 +2318,7 @@ function buildExecutableCatalog() {
   const entries = [];
   for (const { name, profilePath } of discovered) {
     try {
-      const raw = JSON.parse(fs10.readFileSync(profilePath, "utf-8"));
+      const raw = JSON.parse(fs11.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() });
@@ -2294,6 +2353,7 @@ async function runChatTurn(opts) {
     await emit(opts.sink, "chat.error", opts.sessionId, "error", { error });
     return { exitCode: 64, error };
   }
+  const { turns: promptTurns, imagePaths } = prepareAttachments(turns, opts.cwd, opts.sessionId);
   const basePrompt = opts.systemPrompt ?? CHAT_SYSTEM_PROMPT;
   const catalog = buildExecutableCatalog();
   const taskArtifactsPaths = prepareTaskArtifactsDir(opts.cwd, opts.sessionId);
@@ -2306,16 +2366,25 @@ async function runChatTurn(opts) {
   const memoryBlock = readMemoryIndexBlock(opts.cwd);
   const instructionsBlock = readInstructionsBlock(opts.cwd);
   const crossRepoBlock = opts.reposRoot ? CROSS_REPO_PROMPT : null;
+  const imageBlock = imagePaths.length > 0 ? [
+    "# Attached images",
+    "The user attached one or more images on this turn. They are saved as",
+    "files in this workspace and referenced inline in the conversation as",
+    '`[Image "\u2026" is attached \u2014 saved to <path>]`. You CAN view them: call',
+    "the Read tool on each of those exact paths BEFORE answering. Never tell",
+    "the user you cannot see images \u2014 Read the file and describe what you see."
+  ].join("\n") : null;
   const systemPrompt = [
     basePrompt,
     contextBlock,
     memoryBlock,
     instructionsBlock,
     crossRepoBlock,
+    imageBlock,
     catalog,
     artifactAddendum
   ].filter((s) => typeof s === "string" && s.length > 0).join("\n\n");
-  const prompt = buildPrompt(turns);
+  const prompt = buildPrompt(promptTurns);
   let progressSeq = 0;
   const invoke = opts.invokeAgent ?? ((p) => runAgent({
     prompt: p,
@@ -2417,10 +2486,10 @@ async function emit(sink, type, sessionId, suffix, payload) {
 var MEMORY_INDEX_REL = ".kody/memory/INDEX.md";
 var MAX_INDEX_BYTES = 8e3;
 function readMemoryIndexBlock(cwd) {
-  const indexPath = path10.join(cwd, MEMORY_INDEX_REL);
+  const indexPath = path11.join(cwd, MEMORY_INDEX_REL);
   let raw;
   try {
-    raw = fs10.readFileSync(indexPath, "utf-8");
+    raw = fs11.readFileSync(indexPath, "utf-8");
   } catch {
     return "";
   }
@@ -2438,17 +2507,17 @@ function readMemoryIndexBlock(cwd) {
 var CONTEXT_DIR_REL = ".kody/context";
 var MAX_CONTEXT_BYTES = 12e3;
 function readContextBlock(cwd) {
-  const dir = path10.join(cwd, CONTEXT_DIR_REL);
+  const dir = path11.join(cwd, CONTEXT_DIR_REL);
   let files;
   try {
-    files = fs10.readdirSync(dir).filter((f) => f.endsWith(".md")).sort();
+    files = fs11.readdirSync(dir).filter((f) => f.endsWith(".md")).sort();
   } catch {
     return "";
   }
   const sections = [];
   for (const file of files) {
     try {
-      const content = fs10.readFileSync(path10.join(dir, file), "utf-8").trim();
+      const content = fs11.readFileSync(path11.join(dir, file), "utf-8").trim();
       if (content) sections.push(`### ${file.replace(/\.md$/, "")}
 
 ${content}`);
@@ -2469,10 +2538,10 @@ ${content}`);
 var INSTRUCTIONS_REL = ".kody/instructions.md";
 var MAX_INSTRUCTIONS_BYTES = 8e3;
 function readInstructionsBlock(cwd) {
-  const instructionsPath = path10.join(cwd, INSTRUCTIONS_REL);
+  const instructionsPath = path11.join(cwd, INSTRUCTIONS_REL);
   let raw;
   try {
-    raw = fs10.readFileSync(instructionsPath, "utf-8");
+    raw = fs11.readFileSync(instructionsPath, "utf-8");
   } catch {
     return "";
   }
@@ -2491,8 +2560,8 @@ function readInstructionsBlock(cwd) {
 // src/chat/modes/interactive.ts
 init_issue();
 import { execFileSync as execFileSync3 } from "child_process";
-import * as fs11 from "fs";
-import * as path11 from "path";
+import * as fs12 from "fs";
+import * as path12 from "path";
 
 // src/chat/inbox.ts
 import { execFileSync as execFileSync2 } from "child_process";
@@ -2651,9 +2720,9 @@ function findNextUserTurn(turns, fromIdx) {
   return -1;
 }
 function commitTurn(cwd, sessionId, _verbose) {
-  const sessionRel = path11.relative(cwd, sessionFilePath(cwd, sessionId));
-  const eventsRel = path11.relative(cwd, eventsFilePath(cwd, sessionId));
-  const rels = [sessionRel, eventsRel].filter((p) => fs11.existsSync(path11.join(cwd, p)));
+  const sessionRel = path12.relative(cwd, sessionFilePath(cwd, sessionId));
+  const eventsRel = path12.relative(cwd, eventsFilePath(cwd, sessionId));
+  const rels = [sessionRel, eventsRel].filter((p) => fs12.existsSync(path12.join(cwd, p)));
   if (rels.length === 0) return;
   const repository = process.env.GITHUB_REPOSITORY;
   if (!repository) {
@@ -2665,8 +2734,8 @@ function commitTurn(cwd, sessionId, _verbose) {
   }
   const branch = defaultBranch(cwd) ?? "main";
   for (const rel of rels) {
-    const repoPath = rel.split(path11.sep).join("/");
-    const localText = fs11.readFileSync(path11.join(cwd, rel), "utf-8");
+    const repoPath = rel.split(path12.sep).join("/");
+    const localText = fs12.readFileSync(path12.join(cwd, rel), "utf-8");
     putJsonlViaContents(repository, branch, repoPath, localText, sessionId, cwd);
   }
 }
@@ -2756,8 +2825,8 @@ async function emit2(sink, type, sessionId, suffix, payload) {
 
 // src/kody-cli.ts
 import { execFileSync as execFileSync30 } from "child_process";
-import * as fs41 from "fs";
-import * as path37 from "path";
+import * as fs42 from "fs";
+import * as path38 from "path";
 
 // src/app-auth.ts
 import { createSign } from "crypto";
@@ -2830,7 +2899,7 @@ async function mintAppInstallationToken(creds) {
 }
 
 // src/dispatch.ts
-import * as fs12 from "fs";
+import * as fs13 from "fs";
 
 // src/cron-match.ts
 var FIELD_BOUNDS = [
@@ -2914,10 +2983,10 @@ function autoDispatch(opts) {
   }
   const eventName = process.env.GITHUB_EVENT_NAME;
   const eventPath = process.env.GITHUB_EVENT_PATH;
-  if (!eventName || !eventPath || !fs12.existsSync(eventPath)) return null;
+  if (!eventName || !eventPath || !fs13.existsSync(eventPath)) return null;
   let event = {};
   try {
-    event = JSON.parse(fs12.readFileSync(eventPath, "utf-8"));
+    event = JSON.parse(fs13.readFileSync(eventPath, "utf-8"));
   } catch {
     return null;
   }
@@ -2935,7 +3004,7 @@ function autoDispatch(opts) {
   const authorLogin = String(event.comment?.user?.login ?? "");
   const authorType = String(event.comment?.user?.type ?? "");
   if (!rawBody.toLowerCase().includes("@kody")) return null;
-  if (authorLogin === "kody-bot" || authorType === "Bot") return null;
+  const isBotAuthor = authorLogin === "kody-bot" || authorType === "Bot";
   if (!associationAllowed(event, opts?.config)) return null;
   const body = rawBody.toLowerCase();
   const targetNum = Number(event.issue?.number ?? 0);
@@ -2962,6 +3031,13 @@ function autoDispatch(opts) {
   if (!executable && !firstToken) {
     executable = isPr ? opts?.config?.defaultPrExecutable ?? "fix" : opts?.config?.defaultExecutable ?? null;
   }
+  if (isBotAuthor && !consumedFirstToken) {
+    process.stderr.write(
+      `[kody] dispatch: ignoring bot comment without an explicit command (author=${authorLogin || authorType}, firstToken=${firstToken ?? "<none>"})
+`
+    );
+    return null;
+  }
   if (!executable) {
     const profileMissing = aliased ? getProfileInputs(aliased) === null : true;
     process.stderr.write(
@@ -2991,7 +3067,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 || !fs12.existsSync(eventPath)) {
+  if (!eventName || !eventPath || !fs13.existsSync(eventPath)) {
     return { kind: "silent", reason: "no GHA event context" };
   }
   if (eventName !== "issue_comment") {
@@ -2999,7 +3075,7 @@ function autoDispatchTyped(opts) {
   }
   let event = {};
   try {
-    event = JSON.parse(fs12.readFileSync(eventPath, "utf-8"));
+    event = JSON.parse(fs13.readFileSync(eventPath, "utf-8"));
   } catch {
     return { kind: "silent", reason: "GHA event payload unreadable" };
   }
@@ -3037,7 +3113,7 @@ function dispatchScheduledWatches(opts) {
   for (const exe of listExecutables()) {
     let raw;
     try {
-      raw = fs12.readFileSync(exe.profilePath, "utf-8");
+      raw = fs13.readFileSync(exe.profilePath, "utf-8");
     } catch {
       continue;
     }
@@ -3157,8 +3233,8 @@ function coerceBare(spec, value) {
 
 // src/executor.ts
 import { execFileSync as execFileSync29, spawn as spawn9 } from "child_process";
-import * as fs40 from "fs";
-import * as path36 from "path";
+import * as fs41 from "fs";
+import * as path37 from "path";
 
 // src/discipline.ts
 var DISCIPLINE = `# Working discipline (applies to this entire task)
@@ -3209,8 +3285,8 @@ init_events();
 init_issue();
 
 // src/profile.ts
-import * as fs13 from "fs";
-import * as path12 from "path";
+import * as fs14 from "fs";
+import * as path13 from "path";
 
 // src/profile-error.ts
 var ProfileError = class extends Error {
@@ -3378,12 +3454,12 @@ var KNOWN_PROFILE_KEYS = /* @__PURE__ */ new Set([
   "preloadContext"
 ]);
 function loadProfile(profilePath) {
-  if (!fs13.existsSync(profilePath)) {
+  if (!fs14.existsSync(profilePath)) {
     throw new ProfileError(profilePath, "file not found");
   }
   let raw;
   try {
-    raw = JSON.parse(fs13.readFileSync(profilePath, "utf-8"));
+    raw = JSON.parse(fs14.readFileSync(profilePath, "utf-8"));
   } catch (err) {
     throw new ProfileError(profilePath, `invalid JSON: ${err instanceof Error ? err.message : String(err)}`);
   }
@@ -3394,7 +3470,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] ${path12.basename(path12.dirname(profilePath))}: unknown top-level keys ignored: ${unknownKeys.join(", ")}
+      `[kody profile] ${path13.basename(path13.dirname(profilePath))}: unknown top-level keys ignored: ${unknownKeys.join(", ")}
 `
     );
   }
@@ -3455,7 +3531,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: path12.dirname(profilePath)
+    dir: path13.dirname(profilePath)
   };
   if (lifecycle) {
     applyLifecycle(profile, profilePath);
@@ -3826,9 +3902,9 @@ function errMsg(err) {
 
 // src/litellm.ts
 import { execFileSync as execFileSync4, spawn as spawn3 } from "child_process";
-import * as fs14 from "fs";
+import * as fs15 from "fs";
 import * as os2 from "os";
-import * as path13 from "path";
+import * as path14 from "path";
 async function checkLitellmHealth(url) {
   try {
     const response = await fetch(`${url}/health`, { signal: AbortSignal.timeout(3e3) });
@@ -3880,13 +3956,13 @@ async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL
   let child;
   let logPath;
   const spawnProxy = () => {
-    const configPath = path13.join(os2.tmpdir(), `kody-litellm-${Date.now()}.yaml`);
-    fs14.writeFileSync(configPath, generateLitellmConfigYaml(model));
+    const configPath = path14.join(os2.tmpdir(), `kody-litellm-${Date.now()}.yaml`);
+    fs15.writeFileSync(configPath, generateLitellmConfigYaml(model));
     const args = cmd === "litellm" ? ["--config", configPath, "--port", port] : ["-m", "litellm", "--config", configPath, "--port", port];
-    const nextLogPath = path13.join(os2.tmpdir(), `kody-litellm-${Date.now()}.log`);
-    const outFd = fs14.openSync(nextLogPath, "w");
+    const nextLogPath = path14.join(os2.tmpdir(), `kody-litellm-${Date.now()}.log`);
+    const outFd = fs15.openSync(nextLogPath, "w");
     child = spawn3(cmd, args, { stdio: ["ignore", outFd, outFd], detached: true, env: childEnv });
-    fs14.closeSync(outFd);
+    fs15.closeSync(outFd);
     logPath = nextLogPath;
   };
   const waitForHealth = async () => {
@@ -3900,7 +3976,7 @@ async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL
   const readLogTail = () => {
     if (!logPath) return "";
     try {
-      return fs14.readFileSync(logPath, "utf-8").slice(-2e3);
+      return fs15.readFileSync(logPath, "utf-8").slice(-2e3);
     } catch {
       return "";
     }
@@ -3939,10 +4015,10 @@ ${tail}`
   return { url, kill: killChild, ensureHealthy };
 }
 function readDotenvApiKeys(projectDir) {
-  const dotenvPath = path13.join(projectDir, ".env");
-  if (!fs14.existsSync(dotenvPath)) return {};
+  const dotenvPath = path14.join(projectDir, ".env");
+  if (!fs15.existsSync(dotenvPath)) return {};
   const result = {};
-  for (const rawLine of fs14.readFileSync(dotenvPath, "utf-8").split("\n")) {
+  for (const rawLine of fs15.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)=(.*)$/);
@@ -3965,25 +4041,25 @@ function stripBlockingEnv(env) {
 }
 
 // src/subagents.ts
-import * as fs16 from "fs";
-import * as path15 from "path";
+import * as fs17 from "fs";
+import * as path16 from "path";
 
 // src/scripts/buildSyntheticPlugin.ts
-import * as fs15 from "fs";
+import * as fs16 from "fs";
 import * as os3 from "os";
-import * as path14 from "path";
+import * as path15 from "path";
 function getPluginsCatalogRoot() {
-  const here = path14.dirname(new URL(import.meta.url).pathname);
+  const here = path15.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path14.join(here, "..", "plugins"),
+    path15.join(here, "..", "plugins"),
     // dev: src/scripts → src/plugins
-    path14.join(here, "..", "..", "plugins"),
+    path15.join(here, "..", "..", "plugins"),
     // built: dist/scripts → dist/plugins
-    path14.join(here, "..", "..", "src", "plugins")
+    path15.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];
 }
@@ -3993,45 +4069,45 @@ 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 = path14.join(os3.tmpdir(), `kody-synth-${runId}`);
-  fs15.mkdirSync(path14.join(root, ".claude-plugin"), { recursive: true });
+  const root = path15.join(os3.tmpdir(), `kody-synth-${runId}`);
+  fs16.mkdirSync(path15.join(root, ".claude-plugin"), { recursive: true });
   const resolvePart = (bucket, entry) => {
-    const local = path14.join(profile.dir, bucket, entry);
-    if (fs15.existsSync(local)) return local;
-    const central = path14.join(catalog, bucket, entry);
-    if (fs15.existsSync(central)) return central;
+    const local = path15.join(profile.dir, bucket, entry);
+    if (fs16.existsSync(local)) return local;
+    const central = path15.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 = path14.join(root, "skills");
-    fs15.mkdirSync(dst, { recursive: true });
+    const dst = path15.join(root, "skills");
+    fs16.mkdirSync(dst, { recursive: true });
     for (const name of cc.skills) {
-      copyDir(resolvePart("skills", name), path14.join(dst, name));
+      copyDir(resolvePart("skills", name), path15.join(dst, name));
     }
   }
   if (cc.commands.length > 0) {
-    const dst = path14.join(root, "commands");
-    fs15.mkdirSync(dst, { recursive: true });
+    const dst = path15.join(root, "commands");
+    fs16.mkdirSync(dst, { recursive: true });
     for (const name of cc.commands) {
-      fs15.copyFileSync(resolvePart("commands", `${name}.md`), path14.join(dst, `${name}.md`));
+      fs16.copyFileSync(resolvePart("commands", `${name}.md`), path15.join(dst, `${name}.md`));
     }
   }
   if (cc.hooks.length > 0) {
-    const dst = path14.join(root, "hooks");
-    fs15.mkdirSync(dst, { recursive: true });
+    const dst = path15.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(path14.join(dst, "hooks.json"), `${JSON.stringify(merged, null, 2)}
+    fs16.writeFileSync(path15.join(dst, "hooks.json"), `${JSON.stringify(merged, null, 2)}
 `);
   }
   const manifest = {
@@ -4041,17 +4117,17 @@ var buildSyntheticPlugin = async (ctx, profile) => {
   };
   if (cc.skills.length > 0) manifest.skills = ["./skills/"];
   if (cc.commands.length > 0) manifest.commands = ["./commands/"];
-  fs15.writeFileSync(path14.join(root, ".claude-plugin", "plugin.json"), `${JSON.stringify(manifest, null, 2)}
+  fs16.writeFileSync(path15.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 = path14.join(src, ent.name);
-    const d = path14.join(dst, ent.name);
+  fs16.mkdirSync(dst, { recursive: true });
+  for (const ent of fs16.readdirSync(src, { withFileTypes: true })) {
+    const s = path15.join(src, ent.name);
+    const d = path15.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);
   }
 }
 
@@ -4068,10 +4144,10 @@ function splitFrontmatter(raw) {
   return { fm, body: (match[2] ?? "").trim() };
 }
 function resolveAgentFile(profileDir, name) {
-  const local = path15.join(profileDir, "agents", `${name}.md`);
-  if (fs16.existsSync(local)) return local;
-  const central = path15.join(getPluginsCatalogRoot(), "agents", `${name}.md`);
-  if (fs16.existsSync(central)) return central;
+  const local = path16.join(profileDir, "agents", `${name}.md`);
+  if (fs17.existsSync(local)) return local;
+  const central = path16.join(getPluginsCatalogRoot(), "agents", `${name}.md`);
+  if (fs17.existsSync(central)) return central;
   throw new Error(
     `loadSubagents: agent '${name}' not found in ${profileDir}/agents/ or shared catalog`
   );
@@ -4081,7 +4157,7 @@ function loadSubagents(profile) {
   if (!names || names.length === 0) return void 0;
   const agents = {};
   for (const name of names) {
-    const { fm, body } = splitFrontmatter(fs16.readFileSync(resolveAgentFile(profile.dir, name), "utf-8"));
+    const { fm, body } = splitFrontmatter(fs17.readFileSync(resolveAgentFile(profile.dir, name), "utf-8"));
     if (!body) throw new Error(`loadSubagents: agent '${name}' has an empty prompt body`);
     const def = {
       description: fm.description ?? `Subagent ${name}`,
@@ -4177,8 +4253,8 @@ function pushWithRetry(opts = {}) {
 }
 
 // src/commit.ts
-import * as fs17 from "fs";
-import * as path16 from "path";
+import * as fs18 from "fs";
+import * as path17 from "path";
 var FORBIDDEN_PATH_PREFIXES = [
   ".kody/",
   ".kody-engine/",
@@ -4234,18 +4310,18 @@ function tryGit(args, cwd) {
 }
 function abortUnfinishedGitOps(cwd) {
   const aborted = [];
-  const gitDir = path16.join(cwd ?? process.cwd(), ".git");
-  if (!fs17.existsSync(gitDir)) return aborted;
-  if (fs17.existsSync(path16.join(gitDir, "MERGE_HEAD"))) {
+  const gitDir = path17.join(cwd ?? process.cwd(), ".git");
+  if (!fs18.existsSync(gitDir)) return aborted;
+  if (fs18.existsSync(path17.join(gitDir, "MERGE_HEAD"))) {
     if (tryGit(["merge", "--abort"], cwd)) aborted.push("merge");
   }
-  if (fs17.existsSync(path16.join(gitDir, "CHERRY_PICK_HEAD"))) {
+  if (fs18.existsSync(path17.join(gitDir, "CHERRY_PICK_HEAD"))) {
     if (tryGit(["cherry-pick", "--abort"], cwd)) aborted.push("cherry-pick");
   }
-  if (fs17.existsSync(path16.join(gitDir, "REVERT_HEAD"))) {
+  if (fs18.existsSync(path17.join(gitDir, "REVERT_HEAD"))) {
     if (tryGit(["revert", "--abort"], cwd)) aborted.push("revert");
   }
-  if (fs17.existsSync(path16.join(gitDir, "rebase-merge")) || fs17.existsSync(path16.join(gitDir, "rebase-apply"))) {
+  if (fs18.existsSync(path17.join(gitDir, "rebase-merge")) || fs18.existsSync(path17.join(gitDir, "rebase-apply"))) {
     if (tryGit(["rebase", "--abort"], cwd)) aborted.push("rebase");
   }
   try {
@@ -4301,7 +4377,7 @@ function normalizeCommitMessage(raw) {
 function commitAndPush(branch, agentMessage, cwd) {
   const allChanged = listChangedFiles(cwd);
   const allowedFiles = allChanged.filter((f) => !isForbiddenPath(f));
-  const mergeHeadExists = fs17.existsSync(path16.join(cwd ?? process.cwd(), ".git", "MERGE_HEAD"));
+  const mergeHeadExists = fs18.existsSync(path17.join(cwd ?? process.cwd(), ".git", "MERGE_HEAD"));
   if (allowedFiles.length === 0 && !mergeHeadExists) {
     return { committed: false, pushed: false, sha: "", message: "" };
   }
@@ -4562,59 +4638,92 @@ function writeTaskState(target, number, state, cwd) {
 
 // src/scripts/advanceFlow.ts
 var API_TIMEOUT_MS3 = 3e4;
+var FLOW_HOP_CAP = 25;
+function ghComment(issueNumber, body, cwd, label) {
+  try {
+    execFileSync8("gh", ["issue", "comment", String(issueNumber), "--body", body], {
+      timeout: API_TIMEOUT_MS3,
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+  } catch (err) {
+    process.stderr.write(
+      `[kody advanceFlow] ${label} on issue #${issueNumber} failed: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+}
 var advanceFlow = async (ctx, profile) => {
   const state = ctx.data.taskState;
   const flow = state?.flow;
   if (!flow?.issueNumber) return;
+  const curState = state;
+  let issueState;
+  try {
+    issueState = readTaskState("issue", flow.issueNumber, ctx.cwd);
+  } catch {
+    issueState = curState;
+  }
   const targetType = ctx.data.commentTargetType;
   const action = ctx.data.action;
+  let nextIssueState = issueState;
   if (targetType === "pr" && action) {
+    nextIssueState = reduce(issueState, profile.name, action, profile.phase);
+    if (state?.core.prUrl && !nextIssueState.core.prUrl) nextIssueState.core.prUrl = state.core.prUrl;
+  }
+  const prevHops = issueState.flow?.hops ?? flow.hops ?? 0;
+  const hops = prevHops + 1;
+  if (hops > FLOW_HOP_CAP) {
+    nextIssueState.flow = void 0;
     try {
-      const issueState = readTaskState("issue", flow.issueNumber, ctx.cwd);
-      issueState.flow = flow;
-      const next = reduce(issueState, profile.name, action, profile.phase);
-      if (state?.core.prUrl && !next.core.prUrl) next.core.prUrl = state.core.prUrl;
-      next.flow = flow;
-      writeTaskState("issue", flow.issueNumber, next, ctx.cwd);
+      writeTaskState("issue", flow.issueNumber, nextIssueState, ctx.cwd);
     } catch (err) {
       process.stderr.write(
-        `[kody advanceFlow] failed to mirror action to issue #${flow.issueNumber}: ${err instanceof Error ? err.message : String(err)}
+        `[kody advanceFlow] failed to clear looping flow on issue #${flow.issueNumber}: ${err instanceof Error ? err.message : String(err)}
 `
       );
     }
+    ghComment(
+      flow.issueNumber,
+      `\u26A0\uFE0F kody: flow \`${flow.name}\` stopped after ${FLOW_HOP_CAP} steps without completing (loop guard). Re-trigger manually if this was intended.`,
+      ctx.cwd,
+      "loop-guard notice"
+    );
+    process.stderr.write(
+      `[kody advanceFlow] flow '${flow.name}' on issue #${flow.issueNumber} hit hop cap ${FLOW_HOP_CAP}; stopping
+`
+    );
+    return;
   }
-  const body = `@kody ${flow.name}`;
+  nextIssueState.flow = { ...flow, hops };
   try {
-    execFileSync8("gh", ["issue", "comment", String(flow.issueNumber), "--body", body], {
-      timeout: API_TIMEOUT_MS3,
-      cwd: ctx.cwd,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
+    writeTaskState("issue", flow.issueNumber, nextIssueState, ctx.cwd);
   } catch (err) {
     process.stderr.write(
-      `[kody advanceFlow] failed to re-trigger orchestrator on issue #${flow.issueNumber}: ${err instanceof Error ? err.message : String(err)}
+      `[kody advanceFlow] failed to persist hop count on issue #${flow.issueNumber}: ${err instanceof Error ? err.message : String(err)}
 `
     );
   }
+  ghComment(flow.issueNumber, `@kody ${flow.name}`, ctx.cwd, "re-trigger orchestrator");
 };
 
 // src/scripts/brainServe.ts
 init_repoWorkspace();
 import { createServer } from "http";
-import * as fs19 from "fs";
-import * as path18 from "path";
+import * as fs20 from "fs";
+import * as path19 from "path";
 
 // src/scripts/brainTurnLog.ts
-import * as fs18 from "fs";
-import * as path17 from "path";
+import * as fs19 from "fs";
+import * as path18 from "path";
 var live = /* @__PURE__ */ new Map();
 function eventsPath(dir, chatId) {
-  return path17.join(dir, ".kody", "brain-events", `${chatId}.jsonl`);
+  return path18.join(dir, ".kody", "brain-events", `${chatId}.jsonl`);
 }
 function lastPersistedSeq(dir, chatId) {
   const p = eventsPath(dir, chatId);
-  if (!fs18.existsSync(p)) return 0;
-  const lines = fs18.readFileSync(p, "utf-8").split("\n").filter(Boolean);
+  if (!fs19.existsSync(p)) return 0;
+  const lines = fs19.readFileSync(p, "utf-8").split("\n").filter(Boolean);
   if (lines.length === 0) return 0;
   try {
     return JSON.parse(lines[lines.length - 1]).seq || 0;
@@ -4624,9 +4733,9 @@ function lastPersistedSeq(dir, chatId) {
 }
 function readSince(dir, chatId, since) {
   const p = eventsPath(dir, chatId);
-  if (!fs18.existsSync(p)) return [];
+  if (!fs19.existsSync(p)) return [];
   const out = [];
-  for (const line of fs18.readFileSync(p, "utf-8").split("\n")) {
+  for (const line of fs19.readFileSync(p, "utf-8").split("\n")) {
     if (!line) continue;
     try {
       const rec = JSON.parse(line);
@@ -4652,12 +4761,12 @@ function beginTurn(dir, chatId) {
   };
   live.set(chatId, state);
   const p = eventsPath(dir, chatId);
-  fs18.mkdirSync(path17.dirname(p), { recursive: true });
+  fs19.mkdirSync(path18.dirname(p), { recursive: true });
   return (event) => {
     state.seq += 1;
     const rec = { seq: state.seq, turn, ts: Date.now(), event };
     try {
-      fs18.appendFileSync(p, JSON.stringify(rec) + "\n");
+      fs19.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)}
@@ -4695,7 +4804,7 @@ function endTurnIfUnterminated(dir, chatId, errMessage) {
     event: { type: "error", error: errMessage || "turn ended unexpectedly", chatId }
   };
   try {
-    fs18.appendFileSync(eventsPath(dir, chatId), JSON.stringify(rec) + "\n");
+    fs19.appendFileSync(eventsPath(dir, chatId), JSON.stringify(rec) + "\n");
   } catch {
   }
   state.status = "ended";
@@ -4921,7 +5030,7 @@ async function handleChatTurn(req, res, chatId, opts) {
   const repo = strField(body, "repo");
   const repoToken = strField(body, "repoToken");
   const sessionFile = sessionFilePath(opts.cwd, chatId);
-  fs19.mkdirSync(path18.dirname(sessionFile), { recursive: true });
+  fs20.mkdirSync(path19.dirname(sessionFile), { recursive: true });
   appendTurn(sessionFile, {
     role: "user",
     content: message,
@@ -4968,7 +5077,7 @@ async function handleChatTurn(req, res, chatId, opts) {
 function buildServer(opts) {
   const runTurn = opts.runTurn ?? runChatTurn;
   const cloneRepo = opts.cloneRepo ?? defaultCloneRepo;
-  const reposRoot = opts.reposRoot ?? path18.join(path18.dirname(path18.resolve(opts.cwd)), "repos");
+  const reposRoot = opts.reposRoot ?? path19.join(path19.dirname(path19.resolve(opts.cwd)), "repos");
   return createServer(async (req, res) => {
     if (!req.method || !req.url) {
       sendJson(res, 400, { error: "bad request" });
@@ -5223,13 +5332,13 @@ function defaultLabelMap() {
 }
 
 // src/scripts/commitAndPush.ts
-import * as fs21 from "fs";
-import * as path20 from "path";
+import * as fs22 from "fs";
+import * as path21 from "path";
 init_events();
 var DEFAULT_COMMIT_MESSAGE = "chore: kody changes";
 function sentinelPathForStage(cwd, profileName) {
   const runId = resolveRunId();
-  return path20.join(cwd, ".kody", "runs", runId, `commit-${profileName}.lock`);
+  return path21.join(cwd, ".kody", "runs", runId, `commit-${profileName}.lock`);
 }
 var commitAndPush2 = async (ctx, profile) => {
   const branch = ctx.data.branch;
@@ -5239,9 +5348,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 && fs21.existsSync(sentinel)) {
+  if (sentinel && fs22.existsSync(sentinel)) {
     try {
-      const replay = JSON.parse(fs21.readFileSync(sentinel, "utf-8"));
+      const replay = JSON.parse(fs22.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;
@@ -5294,8 +5403,8 @@ var commitAndPush2 = async (ctx, profile) => {
   const result = ctx.data.commitResult;
   if (sentinel && result?.committed) {
     try {
-      fs21.mkdirSync(path20.dirname(sentinel), { recursive: true });
-      fs21.writeFileSync(
+      fs22.mkdirSync(path21.dirname(sentinel), { recursive: true });
+      fs22.writeFileSync(
         sentinel,
         JSON.stringify(
           {
@@ -5356,14 +5465,14 @@ function ensureStateBranch(owner, repo, cwd) {
 }
 
 // src/goal/state.ts
-import * as fs22 from "fs";
-import * as path21 from "path";
+import * as fs23 from "fs";
+import * as path22 from "path";
 var VALID_STATES = /* @__PURE__ */ new Set(["active", "abandoned", "closed", "awaiting-merge", "done"]);
 var GoalStateError = class extends Error {
-  constructor(path39, message) {
-    super(`Invalid goal state at ${path39}:
+  constructor(path40, message) {
+    super(`Invalid goal state at ${path40}:
   ${message}`);
-    this.path = path39;
+    this.path = path40;
     this.name = "GoalStateError";
   }
   path;
@@ -5503,20 +5612,20 @@ function describeCommitMessage(goal) {
 }
 
 // src/scripts/composePrompt.ts
-import * as fs23 from "fs";
-import * as path22 from "path";
+import * as fs24 from "fs";
+import * as path23 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 ? path22.join(profile.dir, explicit) : null,
-    mode ? path22.join(profile.dir, "prompts", `${mode}.md`) : null,
-    path22.join(profile.dir, "prompt.md")
+    explicit ? path23.join(profile.dir, explicit) : null,
+    mode ? path23.join(profile.dir, "prompts", `${mode}.md`) : null,
+    path23.join(profile.dir, "prompt.md")
   ].filter(Boolean);
   let templatePath = "";
   for (const c of candidates) {
-    if (fs23.existsSync(c)) {
+    if (fs24.existsSync(c)) {
       templatePath = c;
       break;
     }
@@ -5524,7 +5633,7 @@ var composePrompt = async (ctx, profile) => {
   if (!templatePath) {
     throw new Error(`profile at ${profile.dir}: no prompt template found (tried ${candidates.join(", ")})`);
   }
-  const template = fs23.readFileSync(templatePath, "utf-8");
+  const template = fs24.readFileSync(templatePath, "utf-8");
   const tokens = {
     ...stringifyAll(ctx.args, "args."),
     ...stringifyAll(ctx.data, ""),
@@ -6302,15 +6411,15 @@ function filterGoalTaskPrs(prs, taskIssueNumbers) {
 
 // src/scripts/diagMcp.ts
 import { execFileSync as execFileSync10 } from "child_process";
-import * as fs24 from "fs";
+import * as fs25 from "fs";
 import * as os4 from "os";
-import * as path23 from "path";
+import * as path24 from "path";
 var diagMcp = async (_ctx) => {
   const home = os4.homedir();
-  const cacheDir = path23.join(home, ".cache", "ms-playwright");
+  const cacheDir = path24.join(home, ".cache", "ms-playwright");
   let entries = [];
   try {
-    entries = fs24.readdirSync(cacheDir);
+    entries = fs25.readdirSync(cacheDir);
   } catch {
   }
   const hasChromium = entries.some((e) => e.startsWith("chromium"));
@@ -6336,17 +6445,17 @@ var diagMcp = async (_ctx) => {
 };
 
 // src/scripts/discoverQaContext.ts
-import * as fs26 from "fs";
-import * as path25 from "path";
+import * as fs27 from "fs";
+import * as path26 from "path";
 
 // src/scripts/frameworkDetectors.ts
-import * as fs25 from "fs";
-import * as path24 from "path";
+import * as fs26 from "fs";
+import * as path25 from "path";
 function detectFrameworks(cwd) {
   const out = [];
   let deps = {};
   try {
-    const pkg = JSON.parse(fs25.readFileSync(path24.join(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs26.readFileSync(path25.join(cwd, "package.json"), "utf-8"));
     deps = { ...pkg.dependencies, ...pkg.devDependencies };
   } catch {
     return out;
@@ -6383,7 +6492,7 @@ function detectFrameworks(cwd) {
 }
 function findFile(cwd, candidates) {
   for (const c of candidates) {
-    if (fs25.existsSync(path24.join(cwd, c))) return c;
+    if (fs26.existsSync(path25.join(cwd, c))) return c;
   }
   return null;
 }
@@ -6396,18 +6505,18 @@ var COLLECTION_DIRS = [
 function discoverPayloadCollections(cwd) {
   const out = [];
   for (const dir of COLLECTION_DIRS) {
-    const full = path24.join(cwd, dir);
-    if (!fs25.existsSync(full)) continue;
+    const full = path25.join(cwd, dir);
+    if (!fs26.existsSync(full)) continue;
     let files;
     try {
-      files = fs25.readdirSync(full).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
+      files = fs26.readdirSync(full).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
     } catch {
       continue;
     }
     for (const file of files) {
       try {
-        const filePath = path24.join(full, file);
-        const content = fs25.readFileSync(filePath, "utf-8").slice(0, 1e4);
+        const filePath = path25.join(full, file);
+        const content = fs26.readFileSync(filePath, "utf-8").slice(0, 1e4);
         const slugMatch = content.match(/slug:\s*['"]([a-z0-9-]+)['"]/);
         if (!slugMatch) continue;
         const slug = slugMatch[1];
@@ -6421,7 +6530,7 @@ function discoverPayloadCollections(cwd) {
         out.push({
           name,
           slug,
-          filePath: path24.relative(cwd, filePath),
+          filePath: path25.relative(cwd, filePath),
           fields: fields.slice(0, 20),
           hasAdmin
         });
@@ -6435,28 +6544,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 = path24.join(cwd, dir);
-    if (!fs25.existsSync(full)) continue;
+    const full = path25.join(cwd, dir);
+    if (!fs26.existsSync(full)) continue;
     let entries;
     try {
-      entries = fs25.readdirSync(full, { withFileTypes: true });
+      entries = fs26.readdirSync(full, { withFileTypes: true });
     } catch {
       continue;
     }
     for (const entry of entries) {
-      const entryPath = path24.join(full, entry.name);
+      const entryPath = path25.join(full, entry.name);
       let name;
       let filePath;
       if (entry.isDirectory()) {
         const indexFile = ["index.tsx", "index.ts", "index.jsx", "index.js"].find(
-          (f) => fs25.existsSync(path24.join(entryPath, f))
+          (f) => fs26.existsSync(path25.join(entryPath, f))
         );
         if (!indexFile) continue;
         name = entry.name;
-        filePath = path24.relative(cwd, path24.join(entryPath, indexFile));
+        filePath = path25.relative(cwd, path25.join(entryPath, indexFile));
       } else if (/\.(tsx?|jsx?)$/.test(entry.name)) {
         name = entry.name.replace(/\.(tsx?|jsx?)$/, "");
-        filePath = path24.relative(cwd, entryPath);
+        filePath = path25.relative(cwd, entryPath);
       } else {
         continue;
       }
@@ -6464,7 +6573,7 @@ function discoverAdminComponents(cwd, collections) {
       if (collections) {
         for (const col of collections) {
           try {
-            const colContent = fs25.readFileSync(path24.join(cwd, col.filePath), "utf-8");
+            const colContent = fs26.readFileSync(path25.join(cwd, col.filePath), "utf-8");
             if (colContent.includes(name)) {
               usedInCollection = col.slug;
               break;
@@ -6483,8 +6592,8 @@ function scanApiRoutes(cwd) {
   const out = [];
   const appDirs = ["src/app", "app"];
   for (const appDir of appDirs) {
-    const apiDir = path24.join(cwd, appDir, "api");
-    if (!fs25.existsSync(apiDir)) continue;
+    const apiDir = path25.join(cwd, appDir, "api");
+    if (!fs26.existsSync(apiDir)) continue;
     walkApiRoutes(apiDir, "/api", cwd, out);
     break;
   }
@@ -6493,14 +6602,14 @@ function scanApiRoutes(cwd) {
 function walkApiRoutes(dir, prefix, cwd, out) {
   let entries;
   try {
-    entries = fs25.readdirSync(dir, { withFileTypes: true });
+    entries = fs26.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 = fs25.readFileSync(path24.join(dir, routeFile.name), "utf-8").slice(0, 5e3);
+      const content = fs26.readFileSync(path25.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)
       );
@@ -6508,7 +6617,7 @@ function walkApiRoutes(dir, prefix, cwd, out) {
         out.push({
           path: prefix,
           methods,
-          filePath: path24.relative(cwd, path24.join(dir, routeFile.name))
+          filePath: path25.relative(cwd, path25.join(dir, routeFile.name))
         });
       }
     } catch {
@@ -6519,7 +6628,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(path24.join(dir, entry.name), prefix, cwd, out);
+      walkApiRoutes(path25.join(dir, entry.name), prefix, cwd, out);
       continue;
     }
     if (segment.startsWith("[[") && segment.endsWith("]]")) {
@@ -6527,7 +6636,7 @@ function walkApiRoutes(dir, prefix, cwd, out) {
     } else if (segment.startsWith("[") && segment.endsWith("]")) {
       segment = `:${segment.slice(1, -1)}`;
     }
-    walkApiRoutes(path24.join(dir, entry.name), `${prefix}/${segment}`, cwd, out);
+    walkApiRoutes(path25.join(dir, entry.name), `${prefix}/${segment}`, cwd, out);
   }
 }
 var BUILTIN_ENV_VARS = /* @__PURE__ */ new Set([
@@ -6547,10 +6656,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 = path24.join(cwd, envFile);
-    if (!fs25.existsSync(envPath)) continue;
+    const envPath = path25.join(cwd, envFile);
+    if (!fs26.existsSync(envPath)) continue;
     try {
-      const content = fs25.readFileSync(envPath, "utf-8");
+      const content = fs26.readFileSync(envPath, "utf-8");
       const vars = [];
       for (const line of content.split("\n")) {
         const trimmed = line.trim();
@@ -6598,9 +6707,9 @@ function runQaDiscovery(cwd) {
 }
 function detectDevServer(cwd, out) {
   try {
-    const pkg = JSON.parse(fs26.readFileSync(path25.join(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs27.readFileSync(path26.join(cwd, "package.json"), "utf-8"));
     const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
-    const pm = fs26.existsSync(path25.join(cwd, "pnpm-lock.yaml")) ? "pnpm" : fs26.existsSync(path25.join(cwd, "yarn.lock")) ? "yarn" : fs26.existsSync(path25.join(cwd, "bun.lockb")) ? "bun" : "npm";
+    const pm = fs27.existsSync(path26.join(cwd, "pnpm-lock.yaml")) ? "pnpm" : fs27.existsSync(path26.join(cwd, "yarn.lock")) ? "yarn" : fs27.existsSync(path26.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;
@@ -6610,8 +6719,8 @@ function detectDevServer(cwd, out) {
 function scanFrontendRoutes(cwd, out) {
   const appDirs = ["src/app", "app"];
   for (const appDir of appDirs) {
-    const full = path25.join(cwd, appDir);
-    if (!fs26.existsSync(full)) continue;
+    const full = path26.join(cwd, appDir);
+    if (!fs27.existsSync(full)) continue;
     walkFrontendRoutes(full, "", out);
     break;
   }
@@ -6619,7 +6728,7 @@ function scanFrontendRoutes(cwd, out) {
 function walkFrontendRoutes(dir, prefix, out) {
   let entries;
   try {
-    entries = fs26.readdirSync(dir, { withFileTypes: true });
+    entries = fs27.readdirSync(dir, { withFileTypes: true });
   } catch {
     return;
   }
@@ -6636,7 +6745,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(path25.join(dir, entry.name), prefix, out);
+      walkFrontendRoutes(path26.join(dir, entry.name), prefix, out);
       continue;
     }
     if (segment.startsWith("[[") && segment.endsWith("]]")) {
@@ -6644,7 +6753,7 @@ function walkFrontendRoutes(dir, prefix, out) {
     } else if (segment.startsWith("[") && segment.endsWith("]")) {
       segment = `:${segment.slice(1, -1)}`;
     }
-    walkFrontendRoutes(path25.join(dir, entry.name), `${prefix}/${segment}`, out);
+    walkFrontendRoutes(path26.join(dir, entry.name), `${prefix}/${segment}`, out);
   }
 }
 function detectAuthFiles(cwd, out) {
@@ -6661,23 +6770,23 @@ function detectAuthFiles(cwd, out) {
     "src/app/api/oauth"
   ];
   for (const c of candidates) {
-    if (fs26.existsSync(path25.join(cwd, c))) out.authFiles.push(c);
+    if (fs27.existsSync(path26.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 = path25.join(cwd, rp);
-    if (!fs26.existsSync(dir)) continue;
+    const dir = path26.join(cwd, rp);
+    if (!fs27.existsSync(dir)) continue;
     let files;
     try {
-      files = fs26.readdirSync(dir).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
+      files = fs27.readdirSync(dir).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
     } catch {
       continue;
     }
     for (const f of files) {
       try {
-        const content = fs26.readFileSync(path25.join(dir, f), "utf-8").slice(0, 5e3);
+        const content = fs27.readFileSync(path26.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) {
@@ -6861,8 +6970,8 @@ function failedAction3(reason) {
 }
 
 // src/scripts/dispatchJobFileTicks.ts
-import * as fs28 from "fs";
-import * as path27 from "path";
+import * as fs29 from "fs";
+import * as path28 from "path";
 
 // src/scripts/jobFrontmatter.ts
 var SCHEDULE_EVERY_VALUES = [
@@ -7131,8 +7240,8 @@ var ContentsApiBackend = class {
 };
 
 // src/scripts/jobState/localFileBackend.ts
-import * as fs27 from "fs";
-import * as path26 from "path";
+import * as fs28 from "fs";
+import * as path27 from "path";
 var LocalFileBackend = class {
   name = "local-file";
   cwd;
@@ -7147,7 +7256,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 = path26.join(opts.cwd, opts.jobsDir);
+    this.absDir = path27.join(opts.cwd, opts.jobsDir);
     this.owner = opts.owner;
     this.repo = opts.repo;
     this.cache = opts.cache ?? defaultCacheAdapter();
@@ -7162,7 +7271,7 @@ var LocalFileBackend = class {
 `);
       return;
     }
-    fs27.mkdirSync(this.absDir, { recursive: true });
+    fs28.mkdirSync(this.absDir, { recursive: true });
     const prefix = this.cacheKeyPrefix();
     const probeKey = `${prefix}probe-${Date.now()}`;
     try {
@@ -7191,7 +7300,7 @@ var LocalFileBackend = class {
 `);
       return;
     }
-    if (!fs27.existsSync(this.absDir)) {
+    if (!fs28.existsSync(this.absDir)) {
       return;
     }
     const key = `${this.cacheKeyPrefix()}${process.env.GITHUB_RUN_ID ?? "norunid"}-${Date.now()}`;
@@ -7207,11 +7316,11 @@ var LocalFileBackend = class {
   }
   load(slug) {
     const relPath = stateFilePath(this.jobsDir, slug);
-    const absPath = path26.join(this.cwd, relPath);
-    if (!fs27.existsSync(absPath)) {
+    const absPath = path27.join(this.cwd, relPath);
+    if (!fs28.existsSync(absPath)) {
       return { path: relPath, handle: null, state: initialStateEnvelope("seed"), created: true };
     }
-    const raw = fs27.readFileSync(absPath, "utf-8");
+    const raw = fs28.readFileSync(absPath, "utf-8");
     let parsed;
     try {
       parsed = JSON.parse(raw);
@@ -7228,10 +7337,10 @@ var LocalFileBackend = class {
     if (!loaded.created && isStateUnchanged(loaded.state, next)) {
       return false;
     }
-    const absPath = path26.join(this.cwd, loaded.path);
-    fs27.mkdirSync(path26.dirname(absPath), { recursive: true });
+    const absPath = path27.join(this.cwd, loaded.path);
+    fs28.mkdirSync(path27.dirname(absPath), { recursive: true });
     const body = JSON.stringify(next, null, 2) + "\n";
-    fs27.writeFileSync(absPath, body, "utf-8");
+    fs28.writeFileSync(absPath, body, "utf-8");
     return true;
   }
   cacheKeyPrefix() {
@@ -7309,7 +7418,7 @@ var dispatchJobFileTicks = async (ctx, _profile, args) => {
     await backend.hydrate();
   }
   try {
-    const slugs = listJobSlugs(path27.join(ctx.cwd, jobsDir));
+    const slugs = listJobSlugs(path28.join(ctx.cwd, jobsDir));
     ctx.data.jobSlugCount = slugs.length;
     if (slugs.length === 0) {
       process.stdout.write(`[jobs] no job files in ${jobsDir}
@@ -7422,17 +7531,17 @@ function formatAgo(ms) {
 }
 function readJobFrontmatter(cwd, jobsDir, slug) {
   try {
-    const raw = fs28.readFileSync(path27.join(cwd, jobsDir, `${slug}.md`), "utf-8");
+    const raw = fs29.readFileSync(path28.join(cwd, jobsDir, `${slug}.md`), "utf-8");
     return splitFrontmatter2(raw).frontmatter;
   } catch {
     return {};
   }
 }
 function listJobSlugs(absDir) {
-  if (!fs28.existsSync(absDir)) return [];
+  if (!fs29.existsSync(absDir)) return [];
   let entries;
   try {
-    entries = fs28.readdirSync(absDir, { withFileTypes: true });
+    entries = fs29.readdirSync(absDir, { withFileTypes: true });
   } catch {
     return [];
   }
@@ -8225,7 +8334,7 @@ function ensureFeatureBranch(issueNumber, title, defaultBranch2, cwd, baseBranch
 
 // src/gha.ts
 import { execFileSync as execFileSync16 } from "child_process";
-import * as fs29 from "fs";
+import * as fs30 from "fs";
 function getRunUrl() {
   const server = process.env.GITHUB_SERVER_URL;
   const repo = process.env.GITHUB_REPOSITORY;
@@ -8236,10 +8345,10 @@ function getRunUrl() {
 function reactToTriggerComment(cwd) {
   if (process.env.GITHUB_EVENT_NAME !== "issue_comment") return;
   const eventPath = process.env.GITHUB_EVENT_PATH;
-  if (!eventPath || !fs29.existsSync(eventPath)) return;
+  if (!eventPath || !fs30.existsSync(eventPath)) return;
   let event = null;
   try {
-    event = JSON.parse(fs29.readFileSync(eventPath, "utf-8"));
+    event = JSON.parse(fs30.readFileSync(eventPath, "utf-8"));
   } catch {
     return;
   }
@@ -8533,12 +8642,12 @@ var handleAbandonedGoal = async (ctx) => {
 
 // src/scripts/initFlow.ts
 import { execFileSync as execFileSync18 } from "child_process";
-import * as fs30 from "fs";
-import * as path28 from "path";
+import * as fs31 from "fs";
+import * as path29 from "path";
 function detectPackageManager(cwd) {
-  if (fs30.existsSync(path28.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs30.existsSync(path28.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs30.existsSync(path28.join(cwd, "bun.lockb"))) return "bun";
+  if (fs31.existsSync(path29.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs31.existsSync(path29.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs31.existsSync(path29.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function qualityCommandsFor(pm) {
@@ -8667,36 +8776,36 @@ function performInit(cwd, force) {
   const pm = detectPackageManager(cwd);
   const ownerRepo = detectOwnerRepo(cwd);
   const defaultBranch2 = defaultBranchFromGit(cwd);
-  const configPath = path28.join(cwd, "kody.config.json");
-  if (fs30.existsSync(configPath) && !force) {
+  const configPath = path29.join(cwd, "kody.config.json");
+  if (fs31.existsSync(configPath) && !force) {
     skipped.push("kody.config.json");
   } else {
     const cfg = makeConfig(pm, ownerRepo, defaultBranch2);
-    fs30.writeFileSync(configPath, `${JSON.stringify(cfg, null, 2)}
+    fs31.writeFileSync(configPath, `${JSON.stringify(cfg, null, 2)}
 `);
     wrote.push("kody.config.json");
   }
-  const workflowDir = path28.join(cwd, ".github", "workflows");
-  const workflowPath = path28.join(workflowDir, "kody.yml");
-  if (fs30.existsSync(workflowPath) && !force) {
+  const workflowDir = path29.join(cwd, ".github", "workflows");
+  const workflowPath = path29.join(workflowDir, "kody.yml");
+  if (fs31.existsSync(workflowPath) && !force) {
     skipped.push(".github/workflows/kody.yml");
   } else {
-    fs30.mkdirSync(workflowDir, { recursive: true });
-    fs30.writeFileSync(workflowPath, WORKFLOW_TEMPLATE);
+    fs31.mkdirSync(workflowDir, { recursive: true });
+    fs31.writeFileSync(workflowPath, WORKFLOW_TEMPLATE);
     wrote.push(".github/workflows/kody.yml");
   }
   const builtinJobs = listBuiltinJobs();
   if (builtinJobs.length > 0) {
-    const jobsDir = path28.join(cwd, ".kody", "duties");
-    fs30.mkdirSync(jobsDir, { recursive: true });
+    const jobsDir = path29.join(cwd, ".kody", "duties");
+    fs31.mkdirSync(jobsDir, { recursive: true });
     for (const job of builtinJobs) {
-      const rel = path28.join(".kody", "duties", `${job.slug}.md`);
-      const target = path28.join(cwd, rel);
-      if (fs30.existsSync(target) && !force) {
+      const rel = path29.join(".kody", "duties", `${job.slug}.md`);
+      const target = path29.join(cwd, rel);
+      if (fs31.existsSync(target) && !force) {
         skipped.push(rel);
         continue;
       }
-      fs30.writeFileSync(target, fs30.readFileSync(job.filePath, "utf-8"));
+      fs31.writeFileSync(target, fs31.readFileSync(job.filePath, "utf-8"));
       wrote.push(rel);
     }
   }
@@ -8708,12 +8817,12 @@ function performInit(cwd, force) {
       continue;
     }
     if (profile.kind !== "scheduled" || !profile.schedule) continue;
-    const target = path28.join(workflowDir, `kody-${exe.name}.yml`);
-    if (fs30.existsSync(target) && !force) {
+    const target = path29.join(workflowDir, `kody-${exe.name}.yml`);
+    if (fs31.existsSync(target) && !force) {
       skipped.push(`.github/workflows/kody-${exe.name}.yml`);
       continue;
     }
-    fs30.writeFileSync(target, renderScheduledWorkflow(exe.name, profile.schedule));
+    fs31.writeFileSync(target, renderScheduledWorkflow(exe.name, profile.schedule));
     wrote.push(`.github/workflows/kody-${exe.name}.yml`);
   }
   let labels;
@@ -8897,8 +9006,8 @@ var loadIssueStateComment = async (ctx, _profile, args) => {
 };
 
 // src/scripts/loadJobFromFile.ts
-import * as fs31 from "fs";
-import * as path29 from "path";
+import * as fs32 from "fs";
+import * as path30 from "path";
 var loadJobFromFile = async (ctx, _profile, args) => {
   const jobsDir = String(args?.jobsDir ?? ".kody/duties");
   const workersDir = String(args?.workersDir ?? ".kody/staff");
@@ -8907,11 +9016,11 @@ var loadJobFromFile = async (ctx, _profile, args) => {
   if (!slug) {
     throw new Error(`loadJobFromFile: ctx.args.${slugArg} must be a non-empty slug`);
   }
-  const absPath = path29.join(ctx.cwd, jobsDir, `${slug}.md`);
-  if (!fs31.existsSync(absPath)) {
+  const absPath = path30.join(ctx.cwd, jobsDir, `${slug}.md`);
+  if (!fs32.existsSync(absPath)) {
     throw new Error(`loadJobFromFile: job file not found: ${absPath}`);
   }
-  const raw = fs31.readFileSync(absPath, "utf-8");
+  const raw = fs32.readFileSync(absPath, "utf-8");
   const { title, body } = parseJobFile(raw, slug);
   const frontmatter = splitFrontmatter2(raw).frontmatter;
   const mentions = (frontmatter.mentions ?? []).map((login) => `@${login}`).join(" ");
@@ -8919,13 +9028,13 @@ var loadJobFromFile = async (ctx, _profile, args) => {
   let workerTitle = "";
   let workerPersona = "";
   if (workerSlug) {
-    const workerPath = path29.join(ctx.cwd, workersDir, `${workerSlug}.md`);
-    if (!fs31.existsSync(workerPath)) {
+    const workerPath = path30.join(ctx.cwd, workersDir, `${workerSlug}.md`);
+    if (!fs32.existsSync(workerPath)) {
       throw new Error(
         `loadJobFromFile: duty '${slug}' declares staff '${workerSlug}' but ${workerPath} does not exist`
       );
     }
-    const workerRaw = fs31.readFileSync(workerPath, "utf-8");
+    const workerRaw = fs32.readFileSync(workerPath, "utf-8");
     const parsed = parseJobFile(workerRaw, workerSlug);
     workerTitle = parsed.title;
     workerPersona = parsed.body;
@@ -8968,18 +9077,18 @@ init_loadMemoryContext();
 init_loadPriorArt();
 
 // src/scripts/loadQaContext.ts
-import * as fs34 from "fs";
-import * as path32 from "path";
+import * as fs35 from "fs";
+import * as path33 from "path";
 
 // src/scripts/kodyVariables.ts
-import * as fs33 from "fs";
-import * as path31 from "path";
+import * as fs34 from "fs";
+import * as path32 from "path";
 var KODY_VARIABLES_REL_PATH = ".kody/variables.json";
 function readKodyVariables(cwd) {
-  const full = path31.join(cwd, KODY_VARIABLES_REL_PATH);
+  const full = path32.join(cwd, KODY_VARIABLES_REL_PATH);
   let raw;
   try {
-    raw = fs33.readFileSync(full, "utf-8");
+    raw = fs34.readFileSync(full, "utf-8");
   } catch {
     return {};
   }
@@ -9028,18 +9137,18 @@ function readProfileStaff(raw) {
   return { staff: staff ?? legacy ?? ["kody"], body };
 }
 function readProfile(cwd) {
-  const dir = path32.join(cwd, CONTEXT_DIR_REL_PATH);
-  if (!fs34.existsSync(dir)) return "";
+  const dir = path33.join(cwd, CONTEXT_DIR_REL_PATH);
+  if (!fs35.existsSync(dir)) return "";
   let entries;
   try {
-    entries = fs34.readdirSync(dir).filter((f) => f.endsWith(".md")).sort();
+    entries = fs35.readdirSync(dir).filter((f) => f.endsWith(".md")).sort();
   } catch {
     return "";
   }
   const blocks = [];
   for (const file of entries) {
     try {
-      const raw = fs34.readFileSync(path32.join(dir, file), "utf-8");
+      const raw = fs35.readFileSync(path33.join(dir, file), "utf-8");
       const { staff, body } = readProfileStaff(raw);
       if (!staff.includes(QA_STAFF) && !staff.includes(ALL_STAFF)) continue;
       blocks.push(`## ${file}
@@ -9076,8 +9185,8 @@ var loadQaContext = async (ctx) => {
 init_events();
 
 // src/taskContext.ts
-import * as fs35 from "fs";
-import * as path33 from "path";
+import * as fs36 from "fs";
+import * as path34 from "path";
 var TASK_CONTEXT_SCHEMA_VERSION = 1;
 function buildTaskContext(args) {
   return {
@@ -9093,10 +9202,10 @@ function buildTaskContext(args) {
 }
 function persistTaskContext(cwd, ctx) {
   try {
-    const dir = path33.join(cwd, ".kody", "runs", ctx.runId);
-    fs35.mkdirSync(dir, { recursive: true });
-    const file = path33.join(dir, "task-context.json");
-    fs35.writeFileSync(file, `${JSON.stringify(ctx, null, 2)}
+    const dir = path34.join(cwd, ".kody", "runs", ctx.runId);
+    fs36.mkdirSync(dir, { recursive: true });
+    const file = path34.join(dir, "task-context.json");
+    fs36.writeFileSync(file, `${JSON.stringify(ctx, null, 2)}
 `);
     return file;
   } catch (err) {
@@ -9144,19 +9253,19 @@ var loadTaskState = async (ctx) => {
 };
 
 // src/scripts/loadWorkerAdhoc.ts
-import * as fs36 from "fs";
-import * as path34 from "path";
+import * as fs37 from "fs";
+import * as path35 from "path";
 var loadWorkerAdhoc = async (ctx, _profile, args) => {
   const workersDir = String(args?.workersDir ?? ".kody/staff");
   const workerSlug = String(ctx.args.worker ?? "").trim();
   if (!workerSlug) {
     throw new Error("loadWorkerAdhoc: ctx.args.worker must be a non-empty slug");
   }
-  const workerPath = path34.join(ctx.cwd, workersDir, `${workerSlug}.md`);
-  if (!fs36.existsSync(workerPath)) {
+  const workerPath = path35.join(ctx.cwd, workersDir, `${workerSlug}.md`);
+  if (!fs37.existsSync(workerPath)) {
     throw new Error(`loadWorkerAdhoc: worker persona not found: ${workerPath}`);
   }
-  const { title, body } = parsePersona(fs36.readFileSync(workerPath, "utf-8"), workerSlug);
+  const { title, body } = parsePersona(fs37.readFileSync(workerPath, "utf-8"), workerSlug);
   const message = resolveMessage(ctx.args.message);
   if (!message) {
     throw new Error(
@@ -9176,9 +9285,9 @@ function resolveMessage(messageArg) {
 }
 function readCommentBody() {
   const eventPath = process.env.GITHUB_EVENT_PATH;
-  if (!eventPath || !fs36.existsSync(eventPath)) return "";
+  if (!eventPath || !fs37.existsSync(eventPath)) return "";
   try {
-    const event = JSON.parse(fs36.readFileSync(eventPath, "utf-8"));
+    const event = JSON.parse(fs37.readFileSync(eventPath, "utf-8"));
     return String(event.comment?.body ?? "");
   } catch {
     return "";
@@ -9848,8 +9957,8 @@ var FlyClient = class {
   get fetch() {
     return this.opts.fetchImpl ?? fetch;
   }
-  async call(path39, init = {}) {
-    const res = await this.fetch(`${FLY_API_BASE}${path39}`, {
+  async call(path40, init = {}) {
+    const res = await this.fetch(`${FLY_API_BASE}${path40}`, {
       method: init.method ?? "GET",
       headers: {
         Authorization: `Bearer ${this.opts.token}`,
@@ -9860,7 +9969,7 @@ var FlyClient = class {
     if (res.status === 404 && init.allow404) return null;
     if (!res.ok) {
       const text = await res.text().catch(() => "");
-      throw new Error(`Fly API ${res.status} on ${path39}: ${text.slice(0, 200) || res.statusText}`);
+      throw new Error(`Fly API ${res.status} on ${path40}: ${text.slice(0, 200) || res.statusText}`);
     }
     if (res.status === 204) return null;
     const raw = await res.text();
@@ -11536,7 +11645,7 @@ function resolveBaseOverride(value) {
 // src/scripts/runnerServe.ts
 import { spawn as spawn5 } from "child_process";
 import { createServer as createServer3 } from "http";
-import * as fs37 from "fs";
+import * as fs38 from "fs";
 var DEFAULT_PORT2 = 8080;
 var DEFAULT_WORKDIR = "/workspace/repo";
 function getApiKey2() {
@@ -11617,8 +11726,8 @@ async function defaultRunJob(job) {
   const workdir = process.env.RUNNER_WORKDIR ?? DEFAULT_WORKDIR;
   const branch = job.ref ?? "main";
   const authUrl = `https://x-access-token:${job.githubToken}@github.com/${job.repo}.git`;
-  fs37.rmSync(workdir, { recursive: true, force: true });
-  fs37.mkdirSync(workdir, { recursive: true });
+  fs38.rmSync(workdir, { recursive: true, force: true });
+  fs38.mkdirSync(workdir, { recursive: true });
   const allSecrets = typeof job.allSecrets === "string" ? job.allSecrets : JSON.stringify(job.allSecrets ?? {});
   const interactive = job.mode === "interactive";
   const scheduled = job.mode === "scheduled";
@@ -11759,8 +11868,8 @@ var runnerServe = async (ctx) => {
 
 // src/scripts/runTickScript.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import * as fs38 from "fs";
-import * as path35 from "path";
+import * as fs39 from "fs";
+import * as path36 from "path";
 var runTickScript = async (ctx, _profile, args) => {
   ctx.skipAgent = true;
   const jobsDir = String(args?.jobsDir ?? ".kody/duties");
@@ -11772,13 +11881,13 @@ var runTickScript = async (ctx, _profile, args) => {
     ctx.output.reason = `runTickScript: ctx.args.${slugArg} must be a non-empty slug`;
     return;
   }
-  const jobPath = path35.join(ctx.cwd, jobsDir, `${slug}.md`);
-  if (!fs38.existsSync(jobPath)) {
+  const jobPath = path36.join(ctx.cwd, jobsDir, `${slug}.md`);
+  if (!fs39.existsSync(jobPath)) {
     ctx.output.exitCode = 99;
     ctx.output.reason = `runTickScript: job file not found: ${jobPath}`;
     return;
   }
-  const raw = fs38.readFileSync(jobPath, "utf-8");
+  const raw = fs39.readFileSync(jobPath, "utf-8");
   const { frontmatter } = splitFrontmatter2(raw);
   const tickScript = frontmatter.tickScript;
   if (!tickScript) {
@@ -11786,8 +11895,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 = path35.isAbsolute(tickScript) ? tickScript : path35.join(ctx.cwd, tickScript);
-  if (!fs38.existsSync(scriptPath)) {
+  const scriptPath = path36.isAbsolute(tickScript) ? tickScript : path36.join(ctx.cwd, tickScript);
+  if (!fs39.existsSync(scriptPath)) {
     ctx.output.exitCode = 99;
     ctx.output.reason = `runTickScript: tickScript not found: ${scriptPath}`;
     return;
@@ -12124,7 +12233,8 @@ var startFlow = async (ctx, profile, _agentResult, args) => {
       name: flowName,
       step: entry,
       issueNumber,
-      startedAt: (/* @__PURE__ */ new Date()).toISOString()
+      startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      hops: 0
     };
   }
   postKodyComment(target, issueNumber, state, entry, ctx.cwd);
@@ -12910,7 +13020,7 @@ var writeJobStateFile = async (ctx, _profile, agentResult, args) => {
 };
 
 // src/scripts/writeRunSummary.ts
-import * as fs39 from "fs";
+import * as fs40 from "fs";
 var writeRunSummary = async (ctx, profile) => {
   const summaryPath = process.env.GITHUB_STEP_SUMMARY;
   if (!summaryPath) return;
@@ -12932,7 +13042,7 @@ var writeRunSummary = async (ctx, profile) => {
   if (reason) lines.push(`- **Reason:** ${reason}`);
   lines.push("");
   try {
-    fs39.appendFileSync(summaryPath, `${lines.join("\n")}
+    fs40.appendFileSync(summaryPath, `${lines.join("\n")}
 `);
   } catch {
   }
@@ -13200,9 +13310,9 @@ async function runExecutable(profileName, input) {
       })
     };
   })() : null;
-  const ndjsonDir = path36.join(input.cwd, ".kody");
+  const ndjsonDir = path37.join(input.cwd, ".kody");
   const invokeAgent = async (prompt) => {
-    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path36.isAbsolute(p) ? p : path36.resolve(profile.dir, p)).filter((p) => p.length > 0);
+    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path37.isAbsolute(p) ? p : path37.resolve(profile.dir, p)).filter((p) => p.length > 0);
     const syntheticPath = ctx.data.syntheticPluginPath;
     const pluginPaths = [...externalPlugins, ...syntheticPath ? [syntheticPath] : []];
     const agents = loadSubagents(profile);
@@ -13416,7 +13526,7 @@ function clearStampedLifecycleLabels(profile, ctx) {
 function getProfileInputsForChild(profileName, _cwd) {
   try {
     const profilePath = resolveProfilePath(profileName);
-    if (!fs40.existsSync(profilePath)) return null;
+    if (!fs41.existsSync(profilePath)) return null;
     return loadProfile(profilePath).inputs;
   } catch {
     return null;
@@ -13425,17 +13535,17 @@ function getProfileInputsForChild(profileName, _cwd) {
 function resolveProfilePath(profileName) {
   const found = resolveExecutable(profileName);
   if (found) return found;
-  const here = path36.dirname(new URL(import.meta.url).pathname);
+  const here = path37.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path36.join(here, "executables", profileName, "profile.json"),
+    path37.join(here, "executables", profileName, "profile.json"),
     // same-dir sibling (dev)
-    path36.join(here, "..", "executables", profileName, "profile.json"),
+    path37.join(here, "..", "executables", profileName, "profile.json"),
     // up one (prod: dist/bin → dist/executables)
-    path36.join(here, "..", "src", "executables", profileName, "profile.json")
+    path37.join(here, "..", "src", "executables", profileName, "profile.json")
     // fallback
   ];
   for (const c of candidates) {
-    if (fs40.existsSync(c)) return c;
+    if (fs41.existsSync(c)) return c;
   }
   return candidates[0];
 }
@@ -13535,8 +13645,8 @@ function resolveShellTimeoutMs(entry) {
 var SIGKILL_GRACE_MS = 5e3;
 async function runShellEntry(entry, ctx, profile) {
   const shellName = entry.shell;
-  const shellPath = path36.join(profile.dir, shellName);
-  if (!fs40.existsSync(shellPath)) {
+  const shellPath = path37.join(profile.dir, shellName);
+  if (!fs41.existsSync(shellPath)) {
     ctx.skipAgent = true;
     ctx.output.exitCode = 99;
     ctx.output.reason = `shell script not found: ${shellName} (looked in ${profile.dir})`;
@@ -14042,9 +14152,9 @@ async function resolveAuthToken(env = process.env) {
   return void 0;
 }
 function detectPackageManager2(cwd) {
-  if (fs41.existsSync(path37.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs41.existsSync(path37.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs41.existsSync(path37.join(cwd, "bun.lockb"))) return "bun";
+  if (fs42.existsSync(path38.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs42.existsSync(path38.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs42.existsSync(path38.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function shellOut(cmd, args, cwd, stream = true) {
@@ -14131,11 +14241,11 @@ function configureGitIdentity(cwd) {
 }
 function postFailureTail(issueNumber, cwd, reason) {
   if (!issueNumber) return;
-  const logPath = path37.join(cwd, ".kody", "last-run.jsonl");
+  const logPath = path38.join(cwd, ".kody", "last-run.jsonl");
   let tail = "";
   try {
-    if (fs41.existsSync(logPath)) {
-      const content = fs41.readFileSync(logPath, "utf-8");
+    if (fs42.existsSync(logPath)) {
+      const content = fs42.readFileSync(logPath, "utf-8");
       tail = content.slice(-3e3);
     }
   } catch {
@@ -14160,7 +14270,7 @@ async function runCi(argv) {
     return 0;
   }
   const args = parseCiArgs(argv);
-  const cwd = args.cwd ? path37.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path38.resolve(args.cwd) : process.cwd();
   let earlyConfig;
   try {
     earlyConfig = loadConfig(cwd);
@@ -14170,9 +14280,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 && fs41.existsSync(dispatchEventPath)) {
+  if (!args.issueNumber && !autoFallback && eventName === "workflow_dispatch" && dispatchEventPath && fs42.existsSync(dispatchEventPath)) {
     try {
-      const evt = JSON.parse(fs41.readFileSync(dispatchEventPath, "utf-8"));
+      const evt = JSON.parse(fs42.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);
@@ -14433,12 +14543,12 @@ function parseChatArgs(argv, env = process.env) {
   return result;
 }
 function commitChatFiles(cwd, sessionId, verbose) {
-  const sessionFile = path38.relative(cwd, sessionFilePath(cwd, sessionId));
-  const eventsFile = path38.relative(cwd, eventsFilePath(cwd, sessionId));
+  const sessionFile = path39.relative(cwd, sessionFilePath(cwd, sessionId));
+  const eventsFile = path39.relative(cwd, eventsFilePath(cwd, sessionId));
   const safeSession = sessionId.replace(/[^a-zA-Z0-9._-]/g, "_");
-  const tasksDir = path38.join(".kody", "tasks", safeSession);
+  const tasksDir = path39.join(".kody", "tasks", safeSession);
   const candidatePaths = [sessionFile, eventsFile, tasksDir];
-  const paths = candidatePaths.filter((p) => fs42.existsSync(path38.join(cwd, p)));
+  const paths = candidatePaths.filter((p) => fs43.existsSync(path39.join(cwd, p)));
   if (paths.length === 0) return;
   const opts = { cwd, stdio: verbose ? "inherit" : "pipe" };
   try {
@@ -14482,7 +14592,7 @@ async function runChat(argv) {
 ${CHAT_HELP}`);
     return 64;
   }
-  const cwd = args.cwd ? path38.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path39.resolve(args.cwd) : process.cwd();
   const sessionId = args.sessionId;
   const unpackedSecrets = unpackAllSecrets();
   if (unpackedSecrets > 0) {
@@ -14534,7 +14644,7 @@ ${CHAT_HELP}`);
   const sink = buildSink(cwd, sessionId, args.dashboardUrl);
   const meta = readMeta(sessionFile);
   process.stdout.write(
-    `\u2192 kody:chat: session file=${sessionFile} exists=${fs42.existsSync(sessionFile)} meta=${meta ? meta.mode : "none"}
+    `\u2192 kody:chat: session file=${sessionFile} exists=${fs43.existsSync(sessionFile)} meta=${meta ? meta.mode : "none"}
 `
   );
   try {