@kody-ade/kody-engine 0.4.100 → 0.4.102

package/dist/bin/kody.js

@@ -470,11 +470,11 @@ var init_issue = __esm({
 
 // src/prompt.ts
 import * as fs18 from "fs";
-import * as path16 from "path";
+import * as path17 from "path";
 function loadProjectConventions(projectDir) {
   const out = [];
   for (const rel of CONVENTION_FILES) {
-    const abs = path16.join(projectDir, rel);
+    const abs = path17.join(projectDir, rel);
     if (!fs18.existsSync(abs)) continue;
     let content;
     try {
@@ -627,7 +627,7 @@ __export(loadMemoryContext_exports, {
   loadMemoryContext: () => loadMemoryContext
 });
 import * as fs33 from "fs";
-import * as path31 from "path";
+import * as path32 from "path";
 function collectPages(memoryAbs) {
   const out = [];
   walkMd(memoryAbs, (file) => {
@@ -644,10 +644,10 @@ function collectPages(memoryAbs) {
       return;
     }
     const fm = raw.match(/^---\s*\n([\s\S]*?)\n---/);
-    const title = fm?.[1]?.match(/^title:\s*(.+)$/m)?.[1]?.trim() ?? path31.basename(file, ".md");
+    const title = fm?.[1]?.match(/^title:\s*(.+)$/m)?.[1]?.trim() ?? path32.basename(file, ".md");
     const updated = fm?.[1]?.match(/^updated:\s*([0-9T:.+\-Z]+)/m)?.[1]?.trim() ?? "";
     out.push({
-      relPath: path31.relative(memoryAbs, file),
+      relPath: path32.relative(memoryAbs, file),
       title,
       updated,
       content: raw.length > PER_PAGE_MAX_BYTES ? raw.slice(0, PER_PAGE_MAX_BYTES) + TRUNCATED_SUFFIX : raw,
@@ -721,7 +721,7 @@ function walkMd(root, visit) {
     }
     for (const name of names) {
       if (name.startsWith(".")) continue;
-      const full = path31.join(dir, name);
+      const full = path32.join(dir, name);
       let stat;
       try {
         stat = fs33.statSync(full);
@@ -747,7 +747,7 @@ var init_loadMemoryContext = __esm({
     TRUNCATED_SUFFIX = "\n\n\u2026 (truncated)";
     loadMemoryContext = async (ctx) => {
       if (typeof ctx.data.memoryContext === "string") return;
-      const memoryAbs = path31.join(ctx.cwd, MEMORY_DIR_RELATIVE);
+      const memoryAbs = path32.join(ctx.cwd, MEMORY_DIR_RELATIVE);
       if (!fs33.existsSync(memoryAbs)) {
         ctx.data.memoryContext = "";
         return;
@@ -765,7 +765,10 @@ var init_loadMemoryContext = __esm({
       }
       const queryTerms = extractQueryTerms(ctx);
       const ranked = queryTerms.length > 0 ? scorePages(pages, queryTerms) : sortByRecency(pages);
-      const top = ranked.slice(0, MAX_PAGES);
+      const indexPage = pages.find((p) => p.relPath === "INDEX.md");
+      const withoutIndex = ranked.filter((p) => p.relPath !== "INDEX.md");
+      const ordered = indexPage ? [indexPage, ...withoutIndex] : withoutIndex;
+      const top = ordered.slice(0, MAX_PAGES);
       ctx.data.memoryContext = formatBlock(top);
     };
   }
@@ -877,7 +880,7 @@ var init_loadPriorArt = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.100",
+  version: "0.4.102",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -933,7 +936,7 @@ var package_default = {
 // src/chat-cli.ts
 import { execFileSync as execFileSync32 } from "child_process";
 import * as fs39 from "fs";
-import * as path36 from "path";
+import * as path37 from "path";
 
 // src/chat/events.ts
 import * as fs from "fs";
@@ -1000,6 +1003,7 @@ function makeRunId(sessionId, suffix) {
 
 // src/chat/loop.ts
 import * as fs9 from "fs";
+import * as path9 from "path";
 
 // src/task-artifacts.ts
 import fs2 from "fs";
@@ -1996,7 +2000,8 @@ async function runChatTurn(opts) {
     taskType: "chat",
     relDir: taskArtifactsPaths.relDir
   });
-  const systemPrompt = [basePrompt, catalog, artifactAddendum].filter((s) => typeof s === "string" && s.length > 0).join("\n\n");
+  const memoryBlock = readMemoryIndexBlock(opts.cwd);
+  const systemPrompt = [basePrompt, memoryBlock, catalog, artifactAddendum].filter((s) => typeof s === "string" && s.length > 0).join("\n\n");
   const prompt = buildPrompt(turns);
   let progressSeq = 0;
   const invoke = opts.invokeAgent ?? ((p) => runAgent({
@@ -2088,12 +2093,33 @@ async function emit(sink, type, sessionId, suffix, payload) {
     emittedAt: (/* @__PURE__ */ new Date()).toISOString()
   });
 }
+var MEMORY_INDEX_REL = ".kody/memory/INDEX.md";
+var MAX_INDEX_BYTES = 8e3;
+function readMemoryIndexBlock(cwd) {
+  const indexPath = path9.join(cwd, MEMORY_INDEX_REL);
+  let raw;
+  try {
+    raw = fs9.readFileSync(indexPath, "utf-8");
+  } catch {
+    return "";
+  }
+  const trimmed = raw.trim();
+  if (!trimmed) return "";
+  const body = trimmed.length > MAX_INDEX_BYTES ? trimmed.slice(0, MAX_INDEX_BYTES) + "\n\n_\u2026 (memory index truncated; open individual files under `.kody/memory/` to read more)_" : trimmed;
+  return [
+    "# Project memory index (`.kody/memory/INDEX.md`)",
+    "",
+    "These are the lessons, decisions, and preferences already captured for this repo. Skim before acting; read individual files only if a line looks relevant to the current task.",
+    "",
+    body
+  ].join("\n");
+}
 
 // src/chat/modes/interactive.ts
 init_issue();
 import { execFileSync as execFileSync3 } from "child_process";
 import * as fs10 from "fs";
-import * as path9 from "path";
+import * as path10 from "path";
 
 // src/chat/inbox.ts
 import { execFileSync as execFileSync2 } from "child_process";
@@ -2252,9 +2278,9 @@ function findNextUserTurn(turns, fromIdx) {
   return -1;
 }
 function commitTurn(cwd, sessionId, _verbose) {
-  const sessionRel = path9.relative(cwd, sessionFilePath(cwd, sessionId));
-  const eventsRel = path9.relative(cwd, eventsFilePath(cwd, sessionId));
-  const rels = [sessionRel, eventsRel].filter((p) => fs10.existsSync(path9.join(cwd, p)));
+  const sessionRel = path10.relative(cwd, sessionFilePath(cwd, sessionId));
+  const eventsRel = path10.relative(cwd, eventsFilePath(cwd, sessionId));
+  const rels = [sessionRel, eventsRel].filter((p) => fs10.existsSync(path10.join(cwd, p)));
   if (rels.length === 0) return;
   const repository = process.env.GITHUB_REPOSITORY;
   if (!repository) {
@@ -2266,8 +2292,8 @@ function commitTurn(cwd, sessionId, _verbose) {
   }
   const branch = defaultBranch(cwd) ?? "main";
   for (const rel of rels) {
-    const repoPath = rel.split(path9.sep).join("/");
-    const localText = fs10.readFileSync(path9.join(cwd, rel), "utf-8");
+    const repoPath = rel.split(path10.sep).join("/");
+    const localText = fs10.readFileSync(path10.join(cwd, rel), "utf-8");
     putJsonlViaContents(repository, branch, repoPath, localText, sessionId, cwd);
   }
 }
@@ -2358,7 +2384,7 @@ async function emit2(sink, type, sessionId, suffix, payload) {
 // src/kody-cli.ts
 import { execFileSync as execFileSync31 } from "child_process";
 import * as fs38 from "fs";
-import * as path35 from "path";
+import * as path36 from "path";
 
 // src/dispatch.ts
 import * as fs11 from "fs";
@@ -2681,7 +2707,7 @@ init_issue();
 // src/executor.ts
 import { execFileSync as execFileSync30, spawn as spawn6 } from "child_process";
 import * as fs37 from "fs";
-import * as path34 from "path";
+import * as path35 from "path";
 init_events();
 
 // src/lifecycleLabels.ts
@@ -2689,7 +2715,7 @@ init_issue();
 
 // src/profile.ts
 import * as fs12 from "fs";
-import * as path10 from "path";
+import * as path11 from "path";
 
 // src/profile-error.ts
 var ProfileError = class extends Error {
@@ -2873,7 +2899,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] ${path10.basename(path10.dirname(profilePath))}: unknown top-level keys ignored: ${unknownKeys.join(", ")}
+      `[kody profile] ${path11.basename(path11.dirname(profilePath))}: unknown top-level keys ignored: ${unknownKeys.join(", ")}
 `
     );
   }
@@ -2934,7 +2960,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: path10.dirname(profilePath)
+    dir: path11.dirname(profilePath)
   };
   if (lifecycle) {
     applyLifecycle(profile, profilePath);
@@ -3306,7 +3332,7 @@ function errMsg(err) {
 import { execFileSync as execFileSync4, spawn as spawn2 } from "child_process";
 import * as fs13 from "fs";
 import * as os2 from "os";
-import * as path11 from "path";
+import * as path12 from "path";
 async function checkLitellmHealth(url) {
   try {
     const response = await fetch(`${url}/health`, { signal: AbortSignal.timeout(3e3) });
@@ -3353,13 +3379,13 @@ async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL
       throw new Error("litellm not installed \u2014 run: pip install 'litellm[proxy]'");
     }
   }
-  const configPath = path11.join(os2.tmpdir(), `kody-litellm-${Date.now()}.yaml`);
+  const configPath = path12.join(os2.tmpdir(), `kody-litellm-${Date.now()}.yaml`);
   fs13.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 = path11.join(os2.tmpdir(), `kody-litellm-${Date.now()}.log`);
+  const logPath = path12.join(os2.tmpdir(), `kody-litellm-${Date.now()}.log`);
   const outFd = fs13.openSync(logPath, "w");
   const child = spawn2(cmd, args, {
     stdio: ["ignore", outFd, outFd],
@@ -3397,7 +3423,7 @@ async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL
 ${logTail}`);
 }
 function readDotenvApiKeys(projectDir) {
-  const dotenvPath = path11.join(projectDir, ".env");
+  const dotenvPath = path12.join(projectDir, ".env");
   if (!fs13.existsSync(dotenvPath)) return {};
   const result = {};
   for (const rawLine of fs13.readFileSync(dotenvPath, "utf-8").split("\n")) {
@@ -3503,7 +3529,7 @@ function pushWithRetry(opts = {}) {
 
 // src/commit.ts
 import * as fs14 from "fs";
-import * as path12 from "path";
+import * as path13 from "path";
 var FORBIDDEN_PATH_PREFIXES = [
   ".kody/",
   ".kody-engine/",
@@ -3514,7 +3540,7 @@ var FORBIDDEN_PATH_PREFIXES = [
   "dist/",
   "build/"
 ];
-var ALLOWED_PATH_PREFIXES = [".kody/memory/"];
+var ALLOWED_PATH_PREFIXES = [".kody/memory/", ".kody/tasks/"];
 var FORBIDDEN_PATH_EXACT = /* @__PURE__ */ new Set([".env", ".kody-pip-requirements.txt"]);
 var FORBIDDEN_PATH_SUFFIXES = [".log"];
 var CONVENTIONAL_PREFIXES = [
@@ -3559,18 +3585,18 @@ function tryGit(args, cwd) {
 }
 function abortUnfinishedGitOps(cwd) {
   const aborted = [];
-  const gitDir = path12.join(cwd ?? process.cwd(), ".git");
+  const gitDir = path13.join(cwd ?? process.cwd(), ".git");
   if (!fs14.existsSync(gitDir)) return aborted;
-  if (fs14.existsSync(path12.join(gitDir, "MERGE_HEAD"))) {
+  if (fs14.existsSync(path13.join(gitDir, "MERGE_HEAD"))) {
     if (tryGit(["merge", "--abort"], cwd)) aborted.push("merge");
   }
-  if (fs14.existsSync(path12.join(gitDir, "CHERRY_PICK_HEAD"))) {
+  if (fs14.existsSync(path13.join(gitDir, "CHERRY_PICK_HEAD"))) {
     if (tryGit(["cherry-pick", "--abort"], cwd)) aborted.push("cherry-pick");
   }
-  if (fs14.existsSync(path12.join(gitDir, "REVERT_HEAD"))) {
+  if (fs14.existsSync(path13.join(gitDir, "REVERT_HEAD"))) {
     if (tryGit(["revert", "--abort"], cwd)) aborted.push("revert");
   }
-  if (fs14.existsSync(path12.join(gitDir, "rebase-merge")) || fs14.existsSync(path12.join(gitDir, "rebase-apply"))) {
+  if (fs14.existsSync(path13.join(gitDir, "rebase-merge")) || fs14.existsSync(path13.join(gitDir, "rebase-apply"))) {
     if (tryGit(["rebase", "--abort"], cwd)) aborted.push("rebase");
   }
   try {
@@ -3626,7 +3652,7 @@ function normalizeCommitMessage(raw) {
 function commitAndPush(branch, agentMessage, cwd) {
   const allChanged = listChangedFiles(cwd);
   const allowedFiles = allChanged.filter((f) => !isForbiddenPath(f));
-  const mergeHeadExists = fs14.existsSync(path12.join(cwd ?? process.cwd(), ".git", "MERGE_HEAD"));
+  const mergeHeadExists = fs14.existsSync(path13.join(cwd ?? process.cwd(), ".git", "MERGE_HEAD"));
   if (allowedFiles.length === 0 && !mergeHeadExists) {
     return { committed: false, pushed: false, sha: "", message: "" };
   }
@@ -3926,14 +3952,14 @@ var advanceFlow = async (ctx, profile) => {
 // src/scripts/brainServe.ts
 import { createServer } from "http";
 import * as fs16 from "fs";
-import * as path14 from "path";
+import * as path15 from "path";
 
 // src/scripts/brainTurnLog.ts
 import * as fs15 from "fs";
-import * as path13 from "path";
+import * as path14 from "path";
 var live = /* @__PURE__ */ new Map();
 function eventsPath(dir, chatId) {
-  return path13.join(dir, ".kody", "brain-events", `${chatId}.jsonl`);
+  return path14.join(dir, ".kody", "brain-events", `${chatId}.jsonl`);
 }
 function lastPersistedSeq(dir, chatId) {
   const p = eventsPath(dir, chatId);
@@ -3976,7 +4002,7 @@ function beginTurn(dir, chatId) {
   };
   live.set(chatId, state);
   const p = eventsPath(dir, chatId);
-  fs15.mkdirSync(path13.dirname(p), { recursive: true });
+  fs15.mkdirSync(path14.dirname(p), { recursive: true });
   return (event) => {
     state.seq += 1;
     const rec = { seq: state.seq, turn, ts: Date.now(), event };
@@ -4236,7 +4262,7 @@ async function handleChatTurn(req, res, chatId, opts) {
     return;
   }
   const sessionFile = sessionFilePath(opts.cwd, chatId);
-  fs16.mkdirSync(path14.dirname(sessionFile), { recursive: true });
+  fs16.mkdirSync(path15.dirname(sessionFile), { recursive: true });
   appendTurn(sessionFile, {
     role: "user",
     content: message,
@@ -4378,15 +4404,15 @@ var brainServe = async (ctx) => {
 // src/scripts/buildSyntheticPlugin.ts
 import * as fs17 from "fs";
 import * as os3 from "os";
-import * as path15 from "path";
+import * as path16 from "path";
 function getPluginsCatalogRoot() {
-  const here = path15.dirname(new URL(import.meta.url).pathname);
+  const here = path16.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path15.join(here, "..", "plugins"),
+    path16.join(here, "..", "plugins"),
     // dev: src/scripts → src/plugins
-    path15.join(here, "..", "..", "plugins"),
+    path16.join(here, "..", "..", "plugins"),
     // built: dist/scripts → dist/plugins
-    path15.join(here, "..", "..", "src", "plugins")
+    path16.join(here, "..", "..", "src", "plugins")
     // fallback
   ];
   for (const c of candidates) {
@@ -4400,40 +4426,40 @@ 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 = path15.join(os3.tmpdir(), `kody-synth-${runId}`);
-  fs17.mkdirSync(path15.join(root, ".claude-plugin"), { recursive: true });
+  const root = path16.join(os3.tmpdir(), `kody-synth-${runId}`);
+  fs17.mkdirSync(path16.join(root, ".claude-plugin"), { recursive: true });
   const resolvePart = (bucket, entry) => {
-    const local = path15.join(profile.dir, bucket, entry);
+    const local = path16.join(profile.dir, bucket, entry);
     if (fs17.existsSync(local)) return local;
-    const central = path15.join(catalog, bucket, entry);
+    const central = path16.join(catalog, bucket, entry);
     if (fs17.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 = path15.join(root, "skills");
+    const dst = path16.join(root, "skills");
     fs17.mkdirSync(dst, { recursive: true });
     for (const name of cc.skills) {
-      copyDir(resolvePart("skills", name), path15.join(dst, name));
+      copyDir(resolvePart("skills", name), path16.join(dst, name));
     }
   }
   if (cc.commands.length > 0) {
-    const dst = path15.join(root, "commands");
+    const dst = path16.join(root, "commands");
     fs17.mkdirSync(dst, { recursive: true });
     for (const name of cc.commands) {
-      fs17.copyFileSync(resolvePart("commands", `${name}.md`), path15.join(dst, `${name}.md`));
+      fs17.copyFileSync(resolvePart("commands", `${name}.md`), path16.join(dst, `${name}.md`));
     }
   }
   if (cc.subagents.length > 0) {
-    const dst = path15.join(root, "agents");
+    const dst = path16.join(root, "agents");
     fs17.mkdirSync(dst, { recursive: true });
     for (const name of cc.subagents) {
-      fs17.copyFileSync(resolvePart("agents", `${name}.md`), path15.join(dst, `${name}.md`));
+      fs17.copyFileSync(resolvePart("agents", `${name}.md`), path16.join(dst, `${name}.md`));
     }
   }
   if (cc.hooks.length > 0) {
-    const dst = path15.join(root, "hooks");
+    const dst = path16.join(root, "hooks");
     fs17.mkdirSync(dst, { recursive: true });
     const merged = { hooks: {} };
     for (const name of cc.hooks) {
@@ -4445,7 +4471,7 @@ var buildSyntheticPlugin = async (ctx, profile) => {
         merged.hooks[event].push(...entries);
       }
     }
-    fs17.writeFileSync(path15.join(dst, "hooks.json"), `${JSON.stringify(merged, null, 2)}
+    fs17.writeFileSync(path16.join(dst, "hooks.json"), `${JSON.stringify(merged, null, 2)}
 `);
   }
   const manifest = {
@@ -4456,15 +4482,15 @@ 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`);
-  fs17.writeFileSync(path15.join(root, ".claude-plugin", "plugin.json"), `${JSON.stringify(manifest, null, 2)}
+  fs17.writeFileSync(path16.join(root, ".claude-plugin", "plugin.json"), `${JSON.stringify(manifest, null, 2)}
 `);
   ctx.data.syntheticPluginPath = root;
 };
 function copyDir(src, dst) {
   fs17.mkdirSync(dst, { recursive: true });
   for (const ent of fs17.readdirSync(src, { withFileTypes: true })) {
-    const s = path15.join(src, ent.name);
-    const d = path15.join(dst, ent.name);
+    const s = path16.join(src, ent.name);
+    const d = path16.join(dst, ent.name);
     if (ent.isDirectory()) copyDir(s, d);
     else if (ent.isFile()) fs17.copyFileSync(s, d);
   }
@@ -4608,12 +4634,12 @@ function defaultLabelMap() {
 
 // src/scripts/commitAndPush.ts
 import * as fs19 from "fs";
-import * as path17 from "path";
+import * as path18 from "path";
 init_events();
 var DEFAULT_COMMIT_MESSAGE = "chore: kody changes";
 function sentinelPathForStage(cwd, profileName) {
   const runId = resolveRunId();
-  return path17.join(cwd, ".kody", "runs", runId, `commit-${profileName}.lock`);
+  return path18.join(cwd, ".kody", "runs", runId, `commit-${profileName}.lock`);
 }
 var commitAndPush2 = async (ctx, profile) => {
   const branch = ctx.data.branch;
@@ -4678,7 +4704,7 @@ var commitAndPush2 = async (ctx, profile) => {
   const result = ctx.data.commitResult;
   if (sentinel && result?.committed) {
     try {
-      fs19.mkdirSync(path17.dirname(sentinel), { recursive: true });
+      fs19.mkdirSync(path18.dirname(sentinel), { recursive: true });
       fs19.writeFileSync(
         sentinel,
         JSON.stringify(
@@ -4700,11 +4726,11 @@ var commitAndPush2 = async (ctx, profile) => {
 
 // src/scripts/commitGoalState.ts
 import { execFileSync as execFileSync10 } from "child_process";
-import * as path18 from "path";
+import * as path19 from "path";
 var commitGoalState = async (ctx) => {
   const goal = ctx.data.goal;
   if (!goal) return;
-  const stateRel = path18.posix.join(".kody", "goals", goal.id, "state.json");
+  const stateRel = path19.posix.join(".kody", "goals", goal.id, "state.json");
   try {
     execFileSync10("git", ["add", stateRel], { cwd: ctx.cwd, stdio: "pipe" });
   } catch (err) {
@@ -4750,15 +4776,15 @@ function describeCommitMessage(goal) {
 
 // src/scripts/composePrompt.ts
 import * as fs20 from "fs";
-import * as path19 from "path";
+import * as path20 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 ? path19.join(profile.dir, explicit) : null,
-    mode ? path19.join(profile.dir, "prompts", `${mode}.md`) : null,
-    path19.join(profile.dir, "prompt.md")
+    explicit ? path20.join(profile.dir, explicit) : null,
+    mode ? path20.join(profile.dir, "prompts", `${mode}.md`) : null,
+    path20.join(profile.dir, "prompt.md")
   ].filter(Boolean);
   let templatePath = "";
   for (const c of candidates) {
@@ -4850,7 +4876,7 @@ function formatToolsUsage(profile) {
 init_issue();
 import { execFileSync as execFileSync11 } from "child_process";
 import * as fs21 from "fs";
-import * as path20 from "path";
+import * as path21 from "path";
 
 // src/scripts/postReviewResult.ts
 init_issue();
@@ -5103,7 +5129,7 @@ function createOrUpdateManifestIssue(number, manifest, cwd) {
   return { number: Number(m[1]), created: true };
 }
 function writeStateFile(cwd, goalId, lastDispatchedIssue) {
-  const dir = path20.join(cwd, ".kody", "goals", goalId);
+  const dir = path21.join(cwd, ".kody", "goals", goalId);
   fs21.mkdirSync(dir, { recursive: true });
   const state = {
     version: 1,
@@ -5112,7 +5138,7 @@ function writeStateFile(cwd, goalId, lastDispatchedIssue) {
     updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     ...typeof lastDispatchedIssue === "number" ? { lastDispatchedIssue } : {}
   };
-  const filePath = path20.join(dir, "state.json");
+  const filePath = path21.join(dir, "state.json");
   fs21.writeFileSync(filePath, `${JSON.stringify(state, null, 2)}
 `);
   return filePath;
@@ -5624,10 +5650,10 @@ function filterGoalTaskPrs(prs, taskIssueNumbers) {
 import { execFileSync as execFileSync12 } from "child_process";
 import * as fs22 from "fs";
 import * as os4 from "os";
-import * as path21 from "path";
+import * as path22 from "path";
 var diagMcp = async (_ctx) => {
   const home = os4.homedir();
-  const cacheDir = path21.join(home, ".cache", "ms-playwright");
+  const cacheDir = path22.join(home, ".cache", "ms-playwright");
   let entries = [];
   try {
     entries = fs22.readdirSync(cacheDir);
@@ -5657,16 +5683,16 @@ var diagMcp = async (_ctx) => {
 
 // src/scripts/discoverQaContext.ts
 import * as fs24 from "fs";
-import * as path23 from "path";
+import * as path24 from "path";
 
 // src/scripts/frameworkDetectors.ts
 import * as fs23 from "fs";
-import * as path22 from "path";
+import * as path23 from "path";
 function detectFrameworks(cwd) {
   const out = [];
   let deps = {};
   try {
-    const pkg = JSON.parse(fs23.readFileSync(path22.join(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs23.readFileSync(path23.join(cwd, "package.json"), "utf-8"));
     deps = { ...pkg.dependencies, ...pkg.devDependencies };
   } catch {
     return out;
@@ -5703,7 +5729,7 @@ function detectFrameworks(cwd) {
 }
 function findFile(cwd, candidates) {
   for (const c of candidates) {
-    if (fs23.existsSync(path22.join(cwd, c))) return c;
+    if (fs23.existsSync(path23.join(cwd, c))) return c;
   }
   return null;
 }
@@ -5716,7 +5742,7 @@ var COLLECTION_DIRS = [
 function discoverPayloadCollections(cwd) {
   const out = [];
   for (const dir of COLLECTION_DIRS) {
-    const full = path22.join(cwd, dir);
+    const full = path23.join(cwd, dir);
     if (!fs23.existsSync(full)) continue;
     let files;
     try {
@@ -5726,7 +5752,7 @@ function discoverPayloadCollections(cwd) {
     }
     for (const file of files) {
       try {
-        const filePath = path22.join(full, file);
+        const filePath = path23.join(full, file);
         const content = fs23.readFileSync(filePath, "utf-8").slice(0, 1e4);
         const slugMatch = content.match(/slug:\s*['"]([a-z0-9-]+)['"]/);
         if (!slugMatch) continue;
@@ -5741,7 +5767,7 @@ function discoverPayloadCollections(cwd) {
         out.push({
           name,
           slug,
-          filePath: path22.relative(cwd, filePath),
+          filePath: path23.relative(cwd, filePath),
           fields: fields.slice(0, 20),
           hasAdmin
         });
@@ -5755,7 +5781,7 @@ 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 = path22.join(cwd, dir);
+    const full = path23.join(cwd, dir);
     if (!fs23.existsSync(full)) continue;
     let entries;
     try {
@@ -5764,19 +5790,19 @@ function discoverAdminComponents(cwd, collections) {
       continue;
     }
     for (const entry of entries) {
-      const entryPath = path22.join(full, entry.name);
+      const entryPath = path23.join(full, entry.name);
       let name;
       let filePath;
       if (entry.isDirectory()) {
         const indexFile = ["index.tsx", "index.ts", "index.jsx", "index.js"].find(
-          (f) => fs23.existsSync(path22.join(entryPath, f))
+          (f) => fs23.existsSync(path23.join(entryPath, f))
         );
         if (!indexFile) continue;
         name = entry.name;
-        filePath = path22.relative(cwd, path22.join(entryPath, indexFile));
+        filePath = path23.relative(cwd, path23.join(entryPath, indexFile));
       } else if (/\.(tsx?|jsx?)$/.test(entry.name)) {
         name = entry.name.replace(/\.(tsx?|jsx?)$/, "");
-        filePath = path22.relative(cwd, entryPath);
+        filePath = path23.relative(cwd, entryPath);
       } else {
         continue;
       }
@@ -5784,7 +5810,7 @@ function discoverAdminComponents(cwd, collections) {
       if (collections) {
         for (const col of collections) {
           try {
-            const colContent = fs23.readFileSync(path22.join(cwd, col.filePath), "utf-8");
+            const colContent = fs23.readFileSync(path23.join(cwd, col.filePath), "utf-8");
             if (colContent.includes(name)) {
               usedInCollection = col.slug;
               break;
@@ -5803,7 +5829,7 @@ function scanApiRoutes(cwd) {
   const out = [];
   const appDirs = ["src/app", "app"];
   for (const appDir of appDirs) {
-    const apiDir = path22.join(cwd, appDir, "api");
+    const apiDir = path23.join(cwd, appDir, "api");
     if (!fs23.existsSync(apiDir)) continue;
     walkApiRoutes(apiDir, "/api", cwd, out);
     break;
@@ -5820,7 +5846,7 @@ function walkApiRoutes(dir, prefix, cwd, out) {
   const routeFile = entries.find((e) => e.isFile() && /^route\.(ts|js|tsx|jsx)$/.test(e.name));
   if (routeFile) {
     try {
-      const content = fs23.readFileSync(path22.join(dir, routeFile.name), "utf-8").slice(0, 5e3);
+      const content = fs23.readFileSync(path23.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)
       );
@@ -5828,7 +5854,7 @@ function walkApiRoutes(dir, prefix, cwd, out) {
         out.push({
           path: prefix,
           methods,
-          filePath: path22.relative(cwd, path22.join(dir, routeFile.name))
+          filePath: path23.relative(cwd, path23.join(dir, routeFile.name))
         });
       }
     } catch {
@@ -5839,7 +5865,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(path22.join(dir, entry.name), prefix, cwd, out);
+      walkApiRoutes(path23.join(dir, entry.name), prefix, cwd, out);
       continue;
     }
     if (segment.startsWith("[[") && segment.endsWith("]]")) {
@@ -5847,7 +5873,7 @@ function walkApiRoutes(dir, prefix, cwd, out) {
     } else if (segment.startsWith("[") && segment.endsWith("]")) {
       segment = `:${segment.slice(1, -1)}`;
     }
-    walkApiRoutes(path22.join(dir, entry.name), `${prefix}/${segment}`, cwd, out);
+    walkApiRoutes(path23.join(dir, entry.name), `${prefix}/${segment}`, cwd, out);
   }
 }
 var BUILTIN_ENV_VARS = /* @__PURE__ */ new Set([
@@ -5867,7 +5893,7 @@ 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 = path22.join(cwd, envFile);
+    const envPath = path23.join(cwd, envFile);
     if (!fs23.existsSync(envPath)) continue;
     try {
       const content = fs23.readFileSync(envPath, "utf-8");
@@ -5918,9 +5944,9 @@ function runQaDiscovery(cwd) {
 }
 function detectDevServer(cwd, out) {
   try {
-    const pkg = JSON.parse(fs24.readFileSync(path23.join(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs24.readFileSync(path24.join(cwd, "package.json"), "utf-8"));
     const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
-    const pm = fs24.existsSync(path23.join(cwd, "pnpm-lock.yaml")) ? "pnpm" : fs24.existsSync(path23.join(cwd, "yarn.lock")) ? "yarn" : fs24.existsSync(path23.join(cwd, "bun.lockb")) ? "bun" : "npm";
+    const pm = fs24.existsSync(path24.join(cwd, "pnpm-lock.yaml")) ? "pnpm" : fs24.existsSync(path24.join(cwd, "yarn.lock")) ? "yarn" : fs24.existsSync(path24.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;
@@ -5930,7 +5956,7 @@ function detectDevServer(cwd, out) {
 function scanFrontendRoutes(cwd, out) {
   const appDirs = ["src/app", "app"];
   for (const appDir of appDirs) {
-    const full = path23.join(cwd, appDir);
+    const full = path24.join(cwd, appDir);
     if (!fs24.existsSync(full)) continue;
     walkFrontendRoutes(full, "", out);
     break;
@@ -5956,7 +5982,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(path23.join(dir, entry.name), prefix, out);
+      walkFrontendRoutes(path24.join(dir, entry.name), prefix, out);
       continue;
     }
     if (segment.startsWith("[[") && segment.endsWith("]]")) {
@@ -5964,7 +5990,7 @@ function walkFrontendRoutes(dir, prefix, out) {
     } else if (segment.startsWith("[") && segment.endsWith("]")) {
       segment = `:${segment.slice(1, -1)}`;
     }
-    walkFrontendRoutes(path23.join(dir, entry.name), `${prefix}/${segment}`, out);
+    walkFrontendRoutes(path24.join(dir, entry.name), `${prefix}/${segment}`, out);
   }
 }
 function detectAuthFiles(cwd, out) {
@@ -5981,13 +6007,13 @@ function detectAuthFiles(cwd, out) {
     "src/app/api/oauth"
   ];
   for (const c of candidates) {
-    if (fs24.existsSync(path23.join(cwd, c))) out.authFiles.push(c);
+    if (fs24.existsSync(path24.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 = path23.join(cwd, rp);
+    const dir = path24.join(cwd, rp);
     if (!fs24.existsSync(dir)) continue;
     let files;
     try {
@@ -5997,7 +6023,7 @@ function detectRoles(cwd, out) {
     }
     for (const f of files) {
       try {
-        const content = fs24.readFileSync(path23.join(dir, f), "utf-8").slice(0, 5e3);
+        const content = fs24.readFileSync(path24.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) {
@@ -6244,7 +6270,7 @@ function failedAction3(reason) {
 
 // src/scripts/dispatchJobFileTicks.ts
 import * as fs26 from "fs";
-import * as path25 from "path";
+import * as path26 from "path";
 
 // src/scripts/jobFrontmatter.ts
 var SCHEDULE_EVERY_VALUES = [
@@ -6506,7 +6532,7 @@ var ContentsApiBackend = class {
 
 // src/scripts/jobState/localFileBackend.ts
 import * as fs25 from "fs";
-import * as path24 from "path";
+import * as path25 from "path";
 var LocalFileBackend = class {
   name = "local-file";
   cwd;
@@ -6521,7 +6547,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 = path24.join(opts.cwd, opts.jobsDir);
+    this.absDir = path25.join(opts.cwd, opts.jobsDir);
     this.owner = opts.owner;
     this.repo = opts.repo;
     this.cache = opts.cache ?? defaultCacheAdapter();
@@ -6581,7 +6607,7 @@ var LocalFileBackend = class {
   }
   load(slug) {
     const relPath = stateFilePath(this.jobsDir, slug);
-    const absPath = path24.join(this.cwd, relPath);
+    const absPath = path25.join(this.cwd, relPath);
     if (!fs25.existsSync(absPath)) {
       return { path: relPath, handle: null, state: initialStateEnvelope("seed"), created: true };
     }
@@ -6602,8 +6628,8 @@ var LocalFileBackend = class {
     if (!loaded.created && isStateUnchanged(loaded.state, next)) {
       return false;
     }
-    const absPath = path24.join(this.cwd, loaded.path);
-    fs25.mkdirSync(path24.dirname(absPath), { recursive: true });
+    const absPath = path25.join(this.cwd, loaded.path);
+    fs25.mkdirSync(path25.dirname(absPath), { recursive: true });
     const body = JSON.stringify(next, null, 2) + "\n";
     fs25.writeFileSync(absPath, body, "utf-8");
     return true;
@@ -6683,7 +6709,7 @@ var dispatchJobFileTicks = async (ctx, _profile, args) => {
     await backend.hydrate();
   }
   try {
-    const slugs = listJobSlugs(path25.join(ctx.cwd, jobsDir));
+    const slugs = listJobSlugs(path26.join(ctx.cwd, jobsDir));
     ctx.data.jobSlugCount = slugs.length;
     if (slugs.length === 0) {
       process.stdout.write(`[jobs] no job files in ${jobsDir}
@@ -6796,7 +6822,7 @@ function formatAgo(ms) {
 }
 function readJobFrontmatter(cwd, jobsDir, slug) {
   try {
-    const raw = fs26.readFileSync(path25.join(cwd, jobsDir, `${slug}.md`), "utf-8");
+    const raw = fs26.readFileSync(path26.join(cwd, jobsDir, `${slug}.md`), "utf-8");
     return splitFrontmatter(raw).frontmatter;
   } catch {
     return {};
@@ -7867,14 +7893,14 @@ var handleAbandonedGoal = async (ctx) => {
 // src/scripts/initFlow.ts
 import { execFileSync as execFileSync19 } from "child_process";
 import * as fs29 from "fs";
-import * as path27 from "path";
+import * as path28 from "path";
 
 // src/scripts/loadQaGuide.ts
 import * as fs28 from "fs";
-import * as path26 from "path";
+import * as path27 from "path";
 var QA_GUIDE_REL_PATH = ".kody/qa-guide.md";
 var loadQaGuide = async (ctx) => {
-  const full = path26.join(ctx.cwd, QA_GUIDE_REL_PATH);
+  const full = path27.join(ctx.cwd, QA_GUIDE_REL_PATH);
   if (!fs28.existsSync(full)) {
     ctx.data.qaGuide = "";
     ctx.data.qaGuidePath = "";
@@ -7891,9 +7917,9 @@ var loadQaGuide = async (ctx) => {
 
 // src/scripts/initFlow.ts
 function detectPackageManager(cwd) {
-  if (fs29.existsSync(path27.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs29.existsSync(path27.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs29.existsSync(path27.join(cwd, "bun.lockb"))) return "bun";
+  if (fs29.existsSync(path28.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs29.existsSync(path28.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs29.existsSync(path28.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function qualityCommandsFor(pm) {
@@ -8015,7 +8041,7 @@ function performInit(cwd, force) {
   const pm = detectPackageManager(cwd);
   const ownerRepo = detectOwnerRepo(cwd);
   const defaultBranch2 = defaultBranchFromGit(cwd);
-  const configPath = path27.join(cwd, "kody.config.json");
+  const configPath = path28.join(cwd, "kody.config.json");
   if (fs29.existsSync(configPath) && !force) {
     skipped.push("kody.config.json");
   } else {
@@ -8024,8 +8050,8 @@ function performInit(cwd, force) {
 `);
     wrote.push("kody.config.json");
   }
-  const workflowDir = path27.join(cwd, ".github", "workflows");
-  const workflowPath = path27.join(workflowDir, "kody.yml");
+  const workflowDir = path28.join(cwd, ".github", "workflows");
+  const workflowPath = path28.join(workflowDir, "kody.yml");
   if (fs29.existsSync(workflowPath) && !force) {
     skipped.push(".github/workflows/kody.yml");
   } else {
@@ -8033,13 +8059,13 @@ function performInit(cwd, force) {
     fs29.writeFileSync(workflowPath, WORKFLOW_TEMPLATE);
     wrote.push(".github/workflows/kody.yml");
   }
-  const hasUi = fs29.existsSync(path27.join(cwd, "src/app")) || fs29.existsSync(path27.join(cwd, "app")) || fs29.existsSync(path27.join(cwd, "pages"));
+  const hasUi = fs29.existsSync(path28.join(cwd, "src/app")) || fs29.existsSync(path28.join(cwd, "app")) || fs29.existsSync(path28.join(cwd, "pages"));
   if (hasUi) {
-    const qaGuidePath = path27.join(cwd, QA_GUIDE_REL_PATH);
+    const qaGuidePath = path28.join(cwd, QA_GUIDE_REL_PATH);
     if (fs29.existsSync(qaGuidePath) && !force) {
       skipped.push(QA_GUIDE_REL_PATH);
     } else {
-      fs29.mkdirSync(path27.dirname(qaGuidePath), { recursive: true });
+      fs29.mkdirSync(path28.dirname(qaGuidePath), { recursive: true });
       const discovery = runQaDiscovery(cwd);
       fs29.writeFileSync(qaGuidePath, generateQaGuideTemplate(discovery));
       wrote.push(QA_GUIDE_REL_PATH);
@@ -8047,11 +8073,11 @@ function performInit(cwd, force) {
   }
   const builtinJobs = listBuiltinJobs();
   if (builtinJobs.length > 0) {
-    const jobsDir = path27.join(cwd, ".kody", "jobs");
+    const jobsDir = path28.join(cwd, ".kody", "jobs");
     fs29.mkdirSync(jobsDir, { recursive: true });
     for (const job of builtinJobs) {
-      const rel = path27.join(".kody", "jobs", `${job.slug}.md`);
-      const target = path27.join(cwd, rel);
+      const rel = path28.join(".kody", "jobs", `${job.slug}.md`);
+      const target = path28.join(cwd, rel);
       if (fs29.existsSync(target) && !force) {
         skipped.push(rel);
         continue;
@@ -8068,7 +8094,7 @@ function performInit(cwd, force) {
       continue;
     }
     if (profile.kind !== "scheduled" || !profile.schedule) continue;
-    const target = path27.join(workflowDir, `kody-${exe.name}.yml`);
+    const target = path28.join(workflowDir, `kody-${exe.name}.yml`);
     if (fs29.existsSync(target) && !force) {
       skipped.push(`.github/workflows/kody-${exe.name}.yml`);
       continue;
@@ -8152,13 +8178,13 @@ init_loadCoverageRules();
 
 // src/goal/state.ts
 import * as fs30 from "fs";
-import * as path28 from "path";
+import * as path29 from "path";
 var VALID_STATES = /* @__PURE__ */ new Set(["active", "abandoned", "closed", "awaiting-merge", "done"]);
 var GoalStateError = class extends Error {
-  constructor(path37, message) {
-    super(`Invalid goal state at ${path37}:
+  constructor(path38, message) {
+    super(`Invalid goal state at ${path38}:
   ${message}`);
-    this.path = path37;
+    this.path = path38;
     this.name = "GoalStateError";
   }
   path;
@@ -8206,7 +8232,7 @@ function serializeGoalState(s) {
 `;
 }
 function goalStatePath(cwd, goalId) {
-  return path28.join(cwd, ".kody", "goals", goalId, "state.json");
+  return path29.join(cwd, ".kody", "goals", goalId, "state.json");
 }
 function readGoalState(cwd, goalId) {
   const file = goalStatePath(cwd, goalId);
@@ -8223,7 +8249,7 @@ function readGoalState(cwd, goalId) {
 }
 function writeGoalState(cwd, goalId, state) {
   const file = goalStatePath(cwd, goalId);
-  fs30.mkdirSync(path28.dirname(file), { recursive: true });
+  fs30.mkdirSync(path29.dirname(file), { recursive: true });
   fs30.writeFileSync(file, serializeGoalState(state), "utf-8");
 }
 function nowIso() {
@@ -8322,7 +8348,7 @@ var loadIssueStateComment = async (ctx, _profile, args) => {
 
 // src/scripts/loadJobFromFile.ts
 import * as fs31 from "fs";
-import * as path29 from "path";
+import * as path30 from "path";
 var loadJobFromFile = async (ctx, _profile, args) => {
   const jobsDir = String(args?.jobsDir ?? ".kody/jobs");
   const workersDir = String(args?.workersDir ?? ".kody/workers");
@@ -8331,7 +8357,7 @@ 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`);
+  const absPath = path30.join(ctx.cwd, jobsDir, `${slug}.md`);
   if (!fs31.existsSync(absPath)) {
     throw new Error(`loadJobFromFile: job file not found: ${absPath}`);
   }
@@ -8341,7 +8367,7 @@ var loadJobFromFile = async (ctx, _profile, args) => {
   let workerTitle = "";
   let workerPersona = "";
   if (workerSlug) {
-    const workerPath = path29.join(ctx.cwd, workersDir, `${workerSlug}.md`);
+    const workerPath = path30.join(ctx.cwd, workersDir, `${workerSlug}.md`);
     if (!fs31.existsSync(workerPath)) {
       throw new Error(
         `loadJobFromFile: job '${slug}' declares worker '${workerSlug}' but ${workerPath} does not exist`
@@ -8386,14 +8412,14 @@ function humanizeSlug(slug) {
 
 // src/scripts/loadWorkerAdhoc.ts
 import * as fs32 from "fs";
-import * as path30 from "path";
+import * as path31 from "path";
 var loadWorkerAdhoc = async (ctx, _profile, args) => {
   const workersDir = String(args?.workersDir ?? ".kody/workers");
   const workerSlug = String(ctx.args.worker ?? "").trim();
   if (!workerSlug) {
     throw new Error("loadWorkerAdhoc: ctx.args.worker must be a non-empty slug");
   }
-  const workerPath = path30.join(ctx.cwd, workersDir, `${workerSlug}.md`);
+  const workerPath = path31.join(ctx.cwd, workersDir, `${workerSlug}.md`);
   if (!fs32.existsSync(workerPath)) {
     throw new Error(`loadWorkerAdhoc: worker persona not found: ${workerPath}`);
   }
@@ -8466,7 +8492,7 @@ init_events();
 
 // src/taskContext.ts
 import * as fs34 from "fs";
-import * as path32 from "path";
+import * as path33 from "path";
 var TASK_CONTEXT_SCHEMA_VERSION = 1;
 function buildTaskContext(args) {
   return {
@@ -8482,9 +8508,9 @@ function buildTaskContext(args) {
 }
 function persistTaskContext(cwd, ctx) {
   try {
-    const dir = path32.join(cwd, ".kody", "runs", ctx.runId);
+    const dir = path33.join(cwd, ".kody", "runs", ctx.runId);
     fs34.mkdirSync(dir, { recursive: true });
-    const file = path32.join(dir, "task-context.json");
+    const file = path33.join(dir, "task-context.json");
     fs34.writeFileSync(file, `${JSON.stringify(ctx, null, 2)}
 `);
     return file;
@@ -9849,7 +9875,7 @@ function resolveBaseOverride(value) {
 // src/scripts/runTickScript.ts
 import { spawnSync } from "child_process";
 import * as fs35 from "fs";
-import * as path33 from "path";
+import * as path34 from "path";
 var runTickScript = async (ctx, _profile, args) => {
   ctx.skipAgent = true;
   const jobsDir = String(args?.jobsDir ?? ".kody/jobs");
@@ -9861,7 +9887,7 @@ var runTickScript = async (ctx, _profile, args) => {
     ctx.output.reason = `runTickScript: ctx.args.${slugArg} must be a non-empty slug`;
     return;
   }
-  const jobPath = path33.join(ctx.cwd, jobsDir, `${slug}.md`);
+  const jobPath = path34.join(ctx.cwd, jobsDir, `${slug}.md`);
   if (!fs35.existsSync(jobPath)) {
     ctx.output.exitCode = 99;
     ctx.output.reason = `runTickScript: job file not found: ${jobPath}`;
@@ -9875,7 +9901,7 @@ 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 = path33.isAbsolute(tickScript) ? tickScript : path33.join(ctx.cwd, tickScript);
+  const scriptPath = path34.isAbsolute(tickScript) ? tickScript : path34.join(ctx.cwd, tickScript);
   if (!fs35.existsSync(scriptPath)) {
     ctx.output.exitCode = 99;
     ctx.output.reason = `runTickScript: tickScript not found: ${scriptPath}`;
@@ -11154,9 +11180,9 @@ async function runExecutable(profileName, input) {
       })
     };
   })() : null;
-  const ndjsonDir = path34.join(input.cwd, ".kody");
+  const ndjsonDir = path35.join(input.cwd, ".kody");
   const invokeAgent = async (prompt) => {
-    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path34.isAbsolute(p) ? p : path34.resolve(profile.dir, p)).filter((p) => p.length > 0);
+    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path35.isAbsolute(p) ? p : path35.resolve(profile.dir, p)).filter((p) => p.length > 0);
     const syntheticPath = ctx.data.syntheticPluginPath;
     const pluginPaths = [...externalPlugins, ...syntheticPath ? [syntheticPath] : []];
     return runAgent({
@@ -11372,13 +11398,13 @@ function getProfileInputsForChild(profileName, _cwd) {
 function resolveProfilePath(profileName) {
   const found = resolveExecutable(profileName);
   if (found) return found;
-  const here = path34.dirname(new URL(import.meta.url).pathname);
+  const here = path35.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path34.join(here, "executables", profileName, "profile.json"),
+    path35.join(here, "executables", profileName, "profile.json"),
     // same-dir sibling (dev)
-    path34.join(here, "..", "executables", profileName, "profile.json"),
+    path35.join(here, "..", "executables", profileName, "profile.json"),
     // up one (prod: dist/bin → dist/executables)
-    path34.join(here, "..", "src", "executables", profileName, "profile.json")
+    path35.join(here, "..", "src", "executables", profileName, "profile.json")
     // fallback
   ];
   for (const c of candidates) {
@@ -11482,7 +11508,7 @@ function resolveShellTimeoutMs(entry) {
 var SIGKILL_GRACE_MS = 5e3;
 async function runShellEntry(entry, ctx, profile) {
   const shellName = entry.shell;
-  const shellPath = path34.join(profile.dir, shellName);
+  const shellPath = path35.join(profile.dir, shellName);
   if (!fs37.existsSync(shellPath)) {
     ctx.skipAgent = true;
     ctx.output.exitCode = 99;
@@ -11962,9 +11988,9 @@ function resolveAuthToken(env = process.env) {
   return token;
 }
 function detectPackageManager2(cwd) {
-  if (fs38.existsSync(path35.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs38.existsSync(path35.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs38.existsSync(path35.join(cwd, "bun.lockb"))) return "bun";
+  if (fs38.existsSync(path36.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs38.existsSync(path36.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs38.existsSync(path36.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function shellOut(cmd, args, cwd, stream = true) {
@@ -12051,7 +12077,7 @@ function configureGitIdentity(cwd) {
 }
 function postFailureTail(issueNumber, cwd, reason) {
   if (!issueNumber) return;
-  const logPath = path35.join(cwd, ".kody", "last-run.jsonl");
+  const logPath = path36.join(cwd, ".kody", "last-run.jsonl");
   let tail = "";
   try {
     if (fs38.existsSync(logPath)) {
@@ -12080,7 +12106,7 @@ async function runCi(argv) {
     return 0;
   }
   const args = parseCiArgs(argv);
-  const cwd = args.cwd ? path35.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path36.resolve(args.cwd) : process.cwd();
   let earlyConfig;
   try {
     earlyConfig = loadConfig(cwd);
@@ -12351,12 +12377,12 @@ function parseChatArgs(argv, env = process.env) {
   return result;
 }
 function commitChatFiles(cwd, sessionId, verbose) {
-  const sessionFile = path36.relative(cwd, sessionFilePath(cwd, sessionId));
-  const eventsFile = path36.relative(cwd, eventsFilePath(cwd, sessionId));
+  const sessionFile = path37.relative(cwd, sessionFilePath(cwd, sessionId));
+  const eventsFile = path37.relative(cwd, eventsFilePath(cwd, sessionId));
   const safeSession = sessionId.replace(/[^a-zA-Z0-9._-]/g, "_");
-  const tasksDir = path36.join(".kody", "tasks", safeSession);
+  const tasksDir = path37.join(".kody", "tasks", safeSession);
   const candidatePaths = [sessionFile, eventsFile, tasksDir];
-  const paths = candidatePaths.filter((p) => fs39.existsSync(path36.join(cwd, p)));
+  const paths = candidatePaths.filter((p) => fs39.existsSync(path37.join(cwd, p)));
   if (paths.length === 0) return;
   const opts = { cwd, stdio: verbose ? "inherit" : "pipe" };
   try {
@@ -12400,7 +12426,7 @@ async function runChat(argv) {
 ${CHAT_HELP}`);
     return 64;
   }
-  const cwd = args.cwd ? path36.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path37.resolve(args.cwd) : process.cwd();
   const sessionId = args.sessionId;
   const unpackedSecrets = unpackAllSecrets();
   if (unpackedSecrets > 0) {

package/dist/executables/review-parallel/agents/review-correctness.md

@@ -0,0 +1,26 @@
+---
+name: review-correctness
+description: Correctness-focused PR reviewer. Inspects a diff and surrounding code for logic bugs, regressions, broken callers, missing edge cases, and test gaps. Returns findings only; never edits files.
+tools: Read, Grep, Glob, Bash
+---
+
+You are a correctness reviewer examining one pull request. You are read-only: never edit files, never run `git`/`gh` write commands. Use Read / Grep / Glob and read-only `git diff` / `git show` to inspect.
+
+Scope yourself to correctness and regression risk. Ignore security (another reviewer owns it) and pure style.
+
+Method:
+- Read the FULL changed files. A bug introduced 30 lines above a hunk won't show in the diff.
+- For every modified function, grep the repo for its callers and existing tests. A signature or behavior change is only safe if callers and tests changed too.
+- Check edge cases the diff may have dropped: empty input, null/undefined, boundary values, error paths. If a test was deleted, find what case it covered.
+- Cite real `file:line` from files you actually read. Never invent citations.
+
+Return ONLY this block — no preamble:
+
+```
+CORRECTNESS
+- severity: BLOCK | WARN | NONE
+- findings:
+  - <file:line — concrete bug/regression and how it manifests at runtime, or "None">
+```
+
+Use `BLOCK` only for a clear correctness or regression risk (wrong output, broken caller, dropped tested case). Test-coverage gaps that aren't outright bugs are `WARN`.

package/dist/executables/review-parallel/agents/review-security.md

@@ -0,0 +1,25 @@
+---
+name: review-security
+description: Security-focused PR reviewer. Inspects a diff and surrounding code for vulnerabilities — injection, authz/authn gaps, secret leakage, SSRF, unsafe deserialization, missing input validation. Returns findings only; never edits files.
+tools: Read, Grep, Glob, Bash
+---
+
+You are a security reviewer examining one pull request. You are read-only: never edit files, never run `git`/`gh` write commands. Use Read / Grep / Glob and read-only `git diff` / `git show` to inspect.
+
+Scope yourself strictly to security. Ignore style, naming, and general correctness unless it creates a security risk.
+
+Method:
+- Read the FULL changed files, not just the hunks — a vulnerability often lives outside the diff window.
+- For every request handler, query, or external call in the diff, check: is user input validated? Is it parameterized? Is authorization checked before the sensitive action? Are secrets read from env, not hardcoded?
+- Cite real `file:line` from files you actually read. Never invent citations.
+
+Return ONLY this block — no preamble:
+
+```
+SECURITY
+- severity: BLOCK | WARN | NONE
+- findings:
+  - <file:line — concrete issue and the exploit it enables, or "None">
+```
+
+Use `BLOCK` only for a real, exploitable vulnerability introduced by this diff. Pre-existing issues the diff didn't touch are out of scope.

package/dist/executables/review-parallel/agents/review-style.md

@@ -0,0 +1,25 @@
+---
+name: review-style
+description: Structure and convention reviewer. Inspects a diff for adherence to repo conventions, module organization, duplication, and documentation gaps. Returns findings only; never edits files.
+tools: Read, Grep, Glob, Bash
+---
+
+You are a structure/convention reviewer examining one pull request. You are read-only: never edit files, never run `git`/`gh` write commands. Use Read / Grep / Glob and read-only `git diff` / `git show` to inspect.
+
+Scope yourself to structure, conventions, duplication, and docs. Do NOT flag things a linter/formatter would catch — that is not a reviewer's job. Ignore security and runtime correctness (other reviewers own those).
+
+Method:
+- When the PR adds a new module, find a sibling implementing the same pattern and check the new code follows it. If it diverges, name the sibling and why the divergence is or isn't justified.
+- Flag genuine duplication (logic that already exists elsewhere) and missing docs the repo conventions clearly require (README/CHANGELOG for a public API).
+- Cite real `file:line` from files you actually read. Never invent citations.
+
+Return ONLY this block — no preamble:
+
+```
+STRUCTURE
+- severity: WARN | NONE
+- findings:
+  - <file:line — concrete structural/convention/doc gap and the existing pattern it should follow, or "None">
+```
+
+Structure findings never `BLOCK` — they are advisory. Use `WARN` for real gaps, `NONE` otherwise.

package/dist/executables/review-parallel/profile.json

@@ -0,0 +1,56 @@
+{
+  "name": "review-parallel",
+  "role": "primitive",
+  "phase": "reviewing",
+  "describe": "A/B variant of `review`: fans out to parallel read-only reviewer subagents (security, correctness, style) via the Task tool, then synthesizes ONE structured comment. Side-effect-light — posts a comment, never drives the pipeline. Used to benchmark swarm review against single-agent `review`.",
+  "inputs": [
+    {
+      "name": "pr",
+      "flag": "--pr",
+      "type": "int",
+      "required": true,
+      "describe": "GitHub PR number to review."
+    }
+  ],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "default",
+    "maxTurns": null,
+    "systemPromptAppend": null,
+    "tools": [
+      "Read",
+      "Grep",
+      "Glob",
+      "Bash",
+      "Task"
+    ],
+    "hooks": ["block-write"],
+    "skills": [],
+    "commands": [],
+    "subagents": ["review-security", "review-correctness", "review-style"],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [],
+  "scripts": {
+    "preflight": [
+      {
+        "script": "reviewFlow"
+      },
+      {
+        "script": "loadTaskState"
+      },
+      {
+        "script": "loadConventions"
+      },
+      {
+        "script": "composePrompt"
+      }
+    ],
+    "postflight": [
+      {
+        "script": "postReviewResult"
+      }
+    ]
+  }
+}

package/dist/executables/review-parallel/prompt.md

@@ -0,0 +1,63 @@
+You are Kody, a senior code reviewer leading a review of PR #{{pr.number}}. You coordinate three specialist reviewers, then write ONE structured review comment. Do NOT edit any files. Do NOT run `git`/`gh` write commands. Read-only inspection only.
+
+# PR #{{pr.number}}: {{pr.title}}
+
+Base: {{pr.baseRefName}} ← Head: {{pr.headRefName}}
+
+{{pr.body}}
+
+{{conventionsBlock}}
+
+# Diff
+
+```diff
+{{prDiff}}
+```
+
+# How to run this review
+
+1. **Fan out in parallel.** In a SINGLE message, issue three `Task` calls — one to each subagent — so they run concurrently:
+   - `review-security` — security vulnerabilities.
+   - `review-correctness` — logic bugs, regressions, test gaps.
+   - `review-style` — structure, conventions, duplication, docs.
+
+   Give each subagent the same context: PR #{{pr.number}}, the base/head refs above, and the diff. Instruct each to read the full changed files (not just hunks) and return only its structured block.
+
+2. **Synthesize.** Once all three return, merge their findings into the single comment below. Resolve the verdict from the worst severity reported:
+   - any `BLOCK` (security or correctness) → **FAIL**
+   - no BLOCK but any `WARN` → **CONCERNS**
+   - all `NONE` → **PASS**
+
+3. Drop duplicate findings, keep every distinct `file:line` citation. Do not invent citations — only pass through what the subagents reported.
+
+# Required output
+
+Your FINAL message must be exactly this markdown — no preamble, no DONE/COMMIT_MSG markers. The entire final message IS the review comment, posted verbatim:
+
+```
+## Verdict: PASS | CONCERNS | FAIL
+
+> Reviewed in parallel by 3 subagents (security · correctness · structure).
+
+### Summary
+<2-3 sentences: what this PR does, is the approach sound>
+
+### Strengths
+- <bullet>
+
+### Concerns
+- <bullet with file:line, or "None">
+
+### Suggestions
+- <bullet with file:line where possible, or "None">
+
+### Bottom line
+<one sentence>
+```
+
+# Rules
+
+- No file edits. No `git`/`gh` writes. Read-only.
+- Every citation must come from a file a subagent actually read — no citations from memory.
+- **FAIL** only for clear correctness/security/regression risk. **CONCERNS** for test-coverage/doc/structural gaps that shouldn't block. **PASS** when the PR meets spec with no blocking issues.
+- Pre-existing issues the diff didn't touch are out of scope.

package/package.json

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