@kody-ade/kody-engine 0.3.20 → 0.3.22

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.3.20",
+  version: "0.3.22",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -51,8 +51,8 @@ var package_default = {
 
 // src/chat-cli.ts
 import { execFileSync as execFileSync22 } from "child_process";
-import * as fs23 from "fs";
-import * as path20 from "path";
+import * as fs22 from "fs";
+import * as path19 from "path";
 
 // src/chat/events.ts
 import * as fs from "fs";
@@ -154,7 +154,7 @@ function loadConfig(projectDir = process.cwd()) {
     throw new Error(`kody.config.json is invalid JSON: ${msg}`);
   }
   const quality = raw.quality ?? {};
-  const git4 = raw.git ?? {};
+  const git3 = raw.git ?? {};
   const github = raw.github ?? {};
   const agent = raw.agent ?? {};
   if (!agent.model || typeof agent.model !== "string") {
@@ -170,7 +170,7 @@ function loadConfig(projectDir = process.cwd()) {
       testUnit: typeof quality.testUnit === "string" ? quality.testUnit : ""
     },
     git: {
-      defaultBranch: typeof git4.defaultBranch === "string" ? git4.defaultBranch : "main"
+      defaultBranch: typeof git3.defaultBranch === "string" ? git3.defaultBranch : "main"
     },
     github: {
       owner: String(github.owner),
@@ -223,6 +223,7 @@ function parseReleaseConfig(raw) {
   if (Array.isArray(r.versionFiles)) out.versionFiles = r.versionFiles.filter((f) => typeof f === "string");
   if (typeof r.publishCommand === "string") out.publishCommand = r.publishCommand;
   if (typeof r.notifyCommand === "string") out.notifyCommand = r.notifyCommand;
+  if (typeof r.deployCommand === "string") out.deployCommand = r.deployCommand;
   if (typeof r.e2eCommand === "string") out.e2eCommand = r.e2eCommand;
   if (typeof r.draftRelease === "boolean") out.draftRelease = r.draftRelease;
   if (typeof r.releaseBranch === "string") out.releaseBranch = r.releaseBranch;
@@ -577,8 +578,8 @@ async function emit(sink, type, sessionId, suffix, payload) {
 
 // src/kody-cli.ts
 import { execFileSync as execFileSync21 } from "child_process";
-import * as fs22 from "fs";
-import * as path19 from "path";
+import * as fs21 from "fs";
+import * as path18 from "path";
 
 // src/dispatch.ts
 import * as fs6 from "fs";
@@ -680,19 +681,7 @@ function autoDispatch(opts) {
   if (eventName === "schedule") {
     return { executable: "mission-scheduler", cliArgs: {}, target: 0 };
   }
-  if (eventName === "pull_request") {
-    const merged = event.pull_request?.merged === true;
-    const headRef = String(event.pull_request?.head?.ref ?? "");
-    const prNumber = Number(event.pull_request?.number ?? 0);
-    if (merged && /^release\/v\d+\.\d+\.\d+/.test(headRef) && prNumber > 0) {
-      return {
-        executable: "release",
-        cliArgs: { mode: "finalize", issue: prNumber },
-        target: prNumber
-      };
-    }
-    return null;
-  }
+  if (eventName === "pull_request") return null;
   if (eventName !== "issue_comment") return null;
   const rawBody = String(event.comment?.body ?? "");
   const authorLogin = String(event.comment?.user?.login ?? "");
@@ -816,9 +805,9 @@ function coerceBare(spec, value) {
 }
 
 // src/executor.ts
-import { spawnSync as spawnSync2 } from "child_process";
-import * as fs21 from "fs";
-import * as path18 from "path";
+import { spawnSync } from "child_process";
+import * as fs20 from "fs";
+import * as path17 from "path";
 
 // src/litellm.ts
 import { execFileSync, spawn } from "child_process";
@@ -2671,6 +2660,12 @@ function truncate2(s, maxBytes) {
   if (s.length <= maxBytes) return s;
   return `${s.slice(0, maxBytes)}\u2026 (+${s.length - maxBytes} chars)`;
 }
+function parsePrNumber(url) {
+  const m = url.match(/\/pull\/(\d+)(?:[/?#]|$)/);
+  if (!m) return null;
+  const n = parseInt(m[1], 10);
+  return Number.isFinite(n) ? n : null;
+}
 function getPr(prNumber, cwd) {
   const output = gh2(["pr", "view", String(prNumber), "--json", "number,title,body,headRefName,baseRefName,state"], {
     cwd
@@ -3138,15 +3133,16 @@ var finishFlow = async (ctx, _profile, _agentResult, args) => {
   if (!issueNumber) return;
   const label = typeof args?.label === "string" ? args.label : void 0;
   if (label && label.startsWith(KODY_NAMESPACE)) {
-    setKodyLabel(
-      issueNumber,
-      {
-        label,
-        color: typeof args?.color === "string" ? args.color : void 0,
-        description: typeof args?.description === "string" ? args.description : void 0
-      },
-      ctx.cwd
-    );
+    const spec = {
+      label,
+      color: typeof args?.color === "string" ? args.color : void 0,
+      description: typeof args?.description === "string" ? args.description : void 0
+    };
+    setKodyLabel(issueNumber, spec, ctx.cwd);
+    const prNumber = state?.core.prUrl ? parsePrNumber(state.core.prUrl) : null;
+    if (prNumber && prNumber !== issueNumber) {
+      setKodyLabel(prNumber, spec, ctx.cwd);
+    }
   }
   const icon = STATUS_ICON[reason] ?? "\u2139\uFE0F";
   const prSuffix = state?.core.prUrl ? `
@@ -4037,6 +4033,53 @@ var loadTaskState = async (ctx) => {
   ctx.data.taskState = readTaskState(target, number, ctx.cwd);
 };
 
+// src/scripts/mergeReleasePr.ts
+import { execFileSync as execFileSync14 } from "child_process";
+var API_TIMEOUT_MS6 = 6e4;
+var mergeReleasePr = async (ctx) => {
+  const state = ctx.data.taskState;
+  const prUrl = state?.core.prUrl;
+  if (!prUrl) {
+    ctx.data.action = makeAction("RELEASE_MERGE_FAILED", { reason: "no prUrl on task state" });
+    if (state) state.core.lastOutcome = ctx.data.action;
+    return;
+  }
+  const prNumber = parsePrNumber2(prUrl);
+  if (!prNumber) {
+    ctx.data.action = makeAction("RELEASE_MERGE_FAILED", { reason: `cannot parse PR number from ${prUrl}` });
+    if (state) state.core.lastOutcome = ctx.data.action;
+    return;
+  }
+  try {
+    execFileSync14("gh", ["pr", "merge", String(prNumber), "--merge"], {
+      timeout: API_TIMEOUT_MS6,
+      cwd: ctx.cwd,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (/already merged/i.test(msg)) {
+      ctx.data.action = makeAction("RELEASE_MERGE_COMPLETED", { prUrl, alreadyMerged: true });
+      if (state) state.core.lastOutcome = ctx.data.action;
+      return;
+    }
+    ctx.data.action = makeAction("RELEASE_MERGE_FAILED", { reason: msg, prUrl });
+    if (state) state.core.lastOutcome = ctx.data.action;
+    return;
+  }
+  ctx.data.action = makeAction("RELEASE_MERGE_COMPLETED", { prUrl });
+  if (state) state.core.lastOutcome = ctx.data.action;
+};
+function makeAction(type, payload) {
+  return { type, payload, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
+}
+function parsePrNumber2(prUrl) {
+  const m = prUrl.match(/\/pull\/(\d+)(?:[/?#]|$)/);
+  if (!m) return null;
+  const n = parseInt(m[1], 10);
+  return Number.isFinite(n) ? n : null;
+}
+
 // src/scripts/mirrorStateToPr.ts
 var mirrorStateToPr = async (ctx) => {
   const issueNumber = ctx.data.commentTargetNumber;
@@ -4044,7 +4087,7 @@ var mirrorStateToPr = async (ctx) => {
   if (!issueNumber || issueTarget !== "issue") return;
   const prUrl = ctx.output.prUrl ?? ctx.data.prResult?.url;
   if (!prUrl) return;
-  const prNumber = parsePrNumber(prUrl);
+  const prNumber = parsePrNumber3(prUrl);
   if (!prNumber) return;
   let state;
   try {
@@ -4062,18 +4105,49 @@ var mirrorStateToPr = async (ctx) => {
     );
   }
 };
-function parsePrNumber(prUrl) {
+function parsePrNumber3(prUrl) {
   const m = prUrl.match(/\/pull\/(\d+)(?:[/?#]|$)/);
   if (!m) return null;
   const n = parseInt(m[1], 10);
   return Number.isFinite(n) ? n : null;
 }
 
+// src/scripts/notifyTerminal.ts
+var notifyTerminal = async (ctx, _profile, _agentResult, args) => {
+  const issueNumber = ctx.args.issue;
+  if (!issueNumber || issueNumber <= 0) return;
+  const label = args?.label ?? "kody run";
+  const dryRun = ctx.args["dry-run"] === true || ctx.args.dryRun === true;
+  const exit = ctx.output.exitCode ?? 0;
+  const reason = ctx.output.reason;
+  const prUrl = ctx.output.prUrl;
+  const body = composeBody({ label, exit, prUrl, reason, dryRun });
+  try {
+    postIssueComment(issueNumber, body, ctx.cwd);
+  } catch (err) {
+    process.stderr.write(
+      `[kody notifyTerminal] failed to post comment on #${issueNumber}: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+};
+function composeBody({ label, exit, prUrl, reason, dryRun }) {
+  if (exit !== 0) {
+    const suffix = prUrl ? ` \u2014 ${prUrl}` : "";
+    return `\u26A0\uFE0F kody ${label} failed: ${truncate2(reason ?? "unknown error", 1500)}${suffix}`;
+  }
+  if (dryRun) {
+    return `\u2139\uFE0F kody ${label} (dry-run): ${reason ?? "plan printed, no changes applied"}`;
+  }
+  if (prUrl) return `\u2705 kody ${label}: ${prUrl}`;
+  return `\u2705 kody ${label} complete`;
+}
+
 // src/scripts/parseAgentResult.ts
 var parseAgentResult2 = async (ctx, profile, agentResult) => {
   if (!agentResult) {
     ctx.data.agentDone = false;
-    ctx.data.action = makeAction("AGENT_NOT_RUN", { reason: "no agent result" });
+    ctx.data.action = makeAction2("AGENT_NOT_RUN", { reason: "no agent result" });
     return;
   }
   const parsed = parseAgentResult(agentResult.finalText);
@@ -4088,17 +4162,17 @@ var parseAgentResult2 = async (ctx, profile, agentResult) => {
   ctx.data.agentError = agentResult.error;
   const modeSeg = (ctx.args.mode ?? profile.name).replace(/-/g, "_").toUpperCase();
   if (parsed.done) {
-    ctx.data.action = makeAction(`${modeSeg}_COMPLETED`, {
+    ctx.data.action = makeAction2(`${modeSeg}_COMPLETED`, {
       commitMessage: parsed.commitMessage,
       prSummary: parsed.prSummary
     });
   } else {
-    ctx.data.action = makeAction(`${modeSeg}_FAILED`, {
+    ctx.data.action = makeAction2(`${modeSeg}_FAILED`, {
       reason: parsed.failureReason || agentResult.error || "unknown failure"
     });
   }
 };
-function makeAction(type, payload) {
+function makeAction2(type, payload) {
   return { type, payload, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
 }
 
@@ -4195,8 +4269,8 @@ var persistFlowState = async (ctx) => {
 };
 
 // src/scripts/postClassification.ts
-import { execFileSync as execFileSync14 } from "child_process";
-var API_TIMEOUT_MS6 = 3e4;
+import { execFileSync as execFileSync15 } from "child_process";
+var API_TIMEOUT_MS7 = 3e4;
 var VALID_CLASSES2 = /* @__PURE__ */ new Set(["feature", "bug", "spec", "chore"]);
 var postClassification = async (ctx) => {
   const issueNumber = ctx.args.issue;
@@ -4225,9 +4299,9 @@ var postClassification = async (ctx) => {
     ctx.cwd
   );
   try {
-    execFileSync14("gh", ["issue", "comment", String(issueNumber), "--body", `@kody ${classification}`], {
+    execFileSync15("gh", ["issue", "comment", String(issueNumber), "--body", `@kody ${classification}`], {
       cwd: ctx.cwd,
-      timeout: API_TIMEOUT_MS6,
+      timeout: API_TIMEOUT_MS7,
       stdio: ["ignore", "pipe", "pipe"]
     });
   } catch (err) {
@@ -4240,7 +4314,7 @@ var postClassification = async (ctx) => {
     ctx.output.reason = "classify: dispatch failed";
     return;
   }
-  ctx.data.action = makeAction2(`CLASSIFIED_AS_${classification.toUpperCase()}`, {
+  ctx.data.action = makeAction3(`CLASSIFIED_AS_${classification.toUpperCase()}`, {
     classification,
     reason: reason ?? "",
     source: ctx.data.classificationSource ?? "agent"
@@ -4259,15 +4333,15 @@ function parseClassification(prSummary) {
 }
 function tryAuditComment(issueNumber, body, cwd) {
   try {
-    execFileSync14("gh", ["issue", "comment", String(issueNumber), "--body", body], {
+    execFileSync15("gh", ["issue", "comment", String(issueNumber), "--body", body], {
       cwd,
-      timeout: API_TIMEOUT_MS6,
+      timeout: API_TIMEOUT_MS7,
       stdio: ["ignore", "pipe", "pipe"]
     });
   } catch {
   }
 }
-function makeAction2(type, payload) {
+function makeAction3(type, payload) {
   return { type, payload, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
 }
 function failedAction(reason) {
@@ -4442,385 +4516,21 @@ REVIEW_POSTED=https://github.com/${ctx.config.github.owner}/${ctx.config.github.
   );
 };
 
-// src/scripts/releaseFlow.ts
-import { execFileSync as execFileSync15, spawnSync } from "child_process";
-import * as fs19 from "fs";
-import * as path17 from "path";
-function notifyIssue(issueNumber, body, cwd) {
-  if (!issueNumber || issueNumber <= 0) return;
-  try {
-    postIssueComment(issueNumber, body, cwd);
-  } catch {
-  }
-}
-function bumpVersion(current, bump) {
-  const m = current.match(/^(\d+)\.(\d+)\.(\d+)(.*)$/);
-  if (!m) throw new Error(`cannot parse version '${current}' (expected x.y.z[-suffix])`);
-  let [major, minor, patch] = [parseInt(m[1], 10), parseInt(m[2], 10), parseInt(m[3], 10)];
-  if (bump === "major") {
-    major++;
-    minor = 0;
-    patch = 0;
-  } else if (bump === "minor") {
-    minor++;
-    patch = 0;
-  } else patch++;
-  return `${major}.${minor}.${patch}`;
-}
-function updateVersionInFile(file, newVersion, cwd) {
-  const abs = path17.join(cwd, file);
-  if (!fs19.existsSync(abs)) return false;
-  const content = fs19.readFileSync(abs, "utf-8");
-  const updated = content.replace(/"version"\s*:\s*"[^"]+"/, `"version": "${newVersion}"`);
-  if (updated === content) return false;
-  fs19.writeFileSync(abs, updated);
-  return true;
-}
-var FIRST_RELEASE_COMMIT_CAP = 100;
-function generateChangelog(cwd, newVersion, lastTag) {
-  const logArgs = ["log", "--pretty=format:%s||%h", "--no-merges"];
-  if (lastTag) logArgs.splice(1, 0, `${lastTag}..HEAD`);
-  else logArgs.splice(1, 0, `-n${FIRST_RELEASE_COMMIT_CAP}`, "HEAD");
-  let log = "";
-  try {
-    log = execFileSync15("git", logArgs, {
-      cwd,
-      encoding: "utf-8",
-      stdio: ["ignore", "pipe", "pipe"]
-    }).trim();
-  } catch {
-  }
-  const commits = log.split("\n").filter((l) => l.length > 0).map((line) => {
-    const [subject, sha] = line.split("||");
-    return { subject: subject ?? "", sha: sha ?? "" };
-  }).filter((c) => !/^chore:\s*release\s+v\d/i.test(c.subject));
-  const groups = { feat: [], fix: [], perf: [], refactor: [], docs: [], chore: [], other: [] };
-  for (const c of commits) {
-    const m = c.subject.match(/^(\w+)(?:\(.*?\))?\s*:\s*(.+)$/);
-    const type = m?.[1]?.toLowerCase() ?? "other";
-    const msg = m?.[2] ?? c.subject;
-    const bucket = groups[type] ?? groups.other;
-    bucket.push(`- ${msg} (${c.sha})`);
-  }
-  const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  const parts = [`## v${newVersion} \u2014 ${date}`, ""];
-  const labels = [
-    ["feat", "Features"],
-    ["fix", "Fixes"],
-    ["perf", "Performance"],
-    ["refactor", "Refactoring"],
-    ["docs", "Docs"],
-    ["chore", "Chores"],
-    ["other", "Other"]
-  ];
-  for (const [key, label] of labels) {
-    const items = groups[key];
-    if (!items || items.length === 0) continue;
-    parts.push(`### ${label}`);
-    parts.push(...items);
-    parts.push("");
-  }
-  if (parts.length === 2) parts.push("_No notable commits since the last release._", "");
-  return parts.join("\n");
-}
-function prependChangelog(cwd, entry) {
-  const p = path17.join(cwd, "CHANGELOG.md");
-  const header = "# Changelog\n\nAll notable changes to this project will be documented in this file.\n\n";
-  if (fs19.existsSync(p)) {
-    const prior = fs19.readFileSync(p, "utf-8");
-    if (/^#\s*Changelog\b/m.test(prior)) {
-      const idx = prior.indexOf("\n", prior.indexOf("# Changelog"));
-      fs19.writeFileSync(p, `${prior.slice(0, idx + 1)}
-${entry}${prior.slice(idx + 1)}`);
-    } else {
-      fs19.writeFileSync(p, `${header}${entry}${prior}`);
-    }
-  } else {
-    fs19.writeFileSync(p, `${header}${entry}`);
-  }
-}
-function git3(args, cwd, timeout = 6e4) {
-  return execFileSync15("git", args, {
-    encoding: "utf-8",
-    timeout,
-    cwd,
-    env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1" },
-    stdio: ["pipe", "pipe", "pipe"]
-  }).trim();
-}
-function lastReleaseTag(cwd) {
-  try {
-    return git3(["describe", "--tags", "--abbrev=0", "--match", "v*"], cwd);
-  } catch {
-    return null;
-  }
-}
-function remoteBranchExists(branch, cwd) {
-  try {
-    const out = git3(["ls-remote", "--heads", "origin", branch], cwd, 3e4);
-    return out.length > 0;
-  } catch {
-    return false;
-  }
-}
-function findOpenPrForBranch(branch, cwd) {
-  try {
-    const out = gh2(["pr", "list", "--head", branch, "--state", "open", "--json", "url", "--limit", "1"], { cwd });
-    const parsed = JSON.parse(out || "[]");
-    const first = parsed[0];
-    return first?.url ?? null;
-  } catch {
-    return null;
-  }
-}
-function runShell(cmd, cwd, timeoutMs) {
-  const r = spawnSync(cmd, {
-    cwd,
-    shell: true,
-    env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1", CI: process.env.CI ?? "1" },
-    encoding: "utf-8",
-    timeout: timeoutMs
-  });
-  return { exitCode: r.status ?? -1, stdout: r.stdout ?? "", stderr: r.stderr ?? "" };
-}
-var releaseFlow = async (ctx) => {
-  const mode = ctx.args.mode ?? "prepare";
-  const bump = ctx.args.bump ?? "patch";
-  const dryRun = ctx.args["dry-run"] === true || ctx.args.dryRun === true;
-  const prefer = ctx.args.prefer ?? void 0;
-  const issueNumber = typeof ctx.args.issue === "number" ? ctx.args.issue : void 0;
-  const cwd = ctx.cwd;
-  const releaseCfg = ctx.config.release ?? {};
-  const versionFiles = releaseCfg.versionFiles && releaseCfg.versionFiles.length > 0 ? releaseCfg.versionFiles : ["package.json"];
-  const timeoutMs = releaseCfg.timeoutMs ?? 6e5;
-  ctx.skipAgent = true;
-  if (mode === "prepare") {
-    await runPrepare({ cwd, bump, dryRun, prefer, versionFiles, ctx });
-  } else if (mode === "finalize") {
-    await runFinalize({ cwd, dryRun, timeoutMs, releaseCfg, ctx });
-  } else {
-    ctx.output.exitCode = 64;
-    ctx.output.reason = `release: unknown mode '${mode}'`;
-  }
-  notifyIssue(issueNumber, buildIssueNotice(mode, dryRun, ctx), cwd);
+// src/scripts/recordOutcome.ts
+var recordOutcome = async (ctx, profile) => {
+  const seg = profile.name.replace(/-/g, "_").toUpperCase();
+  const ok = (ctx.output.exitCode ?? 0) === 0;
+  const action = {
+    type: ok ? `${seg}_COMPLETED` : `${seg}_FAILED`,
+    payload: {
+      exitCode: ctx.output.exitCode ?? 0,
+      reason: ctx.output.reason,
+      prUrl: ctx.output.prUrl
+    },
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  ctx.data.action = action;
 };
-function buildIssueNotice(mode, dryRun, ctx) {
-  const exit = ctx.output.exitCode ?? 0;
-  const url = ctx.output.prUrl;
-  const reason = ctx.output.reason;
-  const label = mode === "finalize" ? "release finalize" : mode === "prepare" ? "release prepare" : `release ${mode}`;
-  if (exit !== 0) {
-    const suffix = url ? ` \u2014 ${url}` : "";
-    return `\u26A0\uFE0F kody ${label} failed: ${truncate2(reason ?? "unknown error", 1500)}${suffix}`;
-  }
-  if (dryRun) {
-    return `\u2139\uFE0F kody ${label} (dry-run): ${reason ?? "plan printed, no changes applied"}`;
-  }
-  if (mode === "prepare") {
-    return url ? `\u2705 kody release PR opened: ${url}` : "\u2705 kody release prepared";
-  }
-  if (mode === "finalize") {
-    return url ? `\u2705 kody release published: ${url}` : "\u2705 kody release finalized (tag pushed)";
-  }
-  return `\u2705 kody ${label} complete`;
-}
-async function runPrepare(args) {
-  const { cwd, bump, dryRun, prefer, versionFiles, ctx } = args;
-  const pkgPath = path17.join(cwd, "package.json");
-  if (!fs19.existsSync(pkgPath)) {
-    ctx.output.exitCode = 99;
-    ctx.output.reason = "release prepare: package.json not found";
-    return;
-  }
-  const pkg = JSON.parse(fs19.readFileSync(pkgPath, "utf-8"));
-  if (typeof pkg.version !== "string") {
-    ctx.output.exitCode = 99;
-    ctx.output.reason = "release prepare: package.json has no version";
-    return;
-  }
-  const oldVersion = pkg.version;
-  const newVersion = bumpVersion(oldVersion, bump);
-  const tag = `v${newVersion}`;
-  process.stdout.write(`\u2192 release prepare: ${oldVersion} \u2192 ${newVersion} (${bump})
-`);
-  if (dryRun) {
-    ctx.output.exitCode = 0;
-    ctx.output.reason = `dry-run \u2014 would bump to ${newVersion}${prefer ? ` (--prefer ${prefer})` : ""}`;
-    process.stdout.write(`RELEASE_PLAN=bump=${newVersion} tag=${tag}
-`);
-    return;
-  }
-  const releaseBranch = `release/${tag}`;
-  const collides = remoteBranchExists(releaseBranch, cwd);
-  if (collides) {
-    if (prefer === "theirs") {
-      const existingPr = findOpenPrForBranch(releaseBranch, cwd);
-      if (existingPr) {
-        process.stdout.write(`  reusing existing PR (--prefer theirs): ${existingPr}
-`);
-        ctx.output.prUrl = existingPr;
-        ctx.output.exitCode = 0;
-        return;
-      }
-      ctx.output.exitCode = 4;
-      ctx.output.reason = `release prepare --prefer theirs: ${releaseBranch} exists on remote but has no open PR \u2014 nothing to reuse`;
-      return;
-    }
-    if (prefer !== "ours") {
-      ctx.output.exitCode = 4;
-      ctx.output.reason = `release prepare: branch ${releaseBranch} already exists on remote. Use --prefer ours to force-push, or --prefer theirs to reuse the existing PR.`;
-      return;
-    }
-    process.stdout.write(`  branch ${releaseBranch} exists on remote \u2014 will force-push (--prefer ours)
-`);
-  }
-  const touched = [];
-  for (const f of versionFiles) {
-    if (updateVersionInFile(f, newVersion, cwd)) touched.push(f);
-  }
-  if (touched.length === 0) {
-    ctx.output.exitCode = 1;
-    ctx.output.reason = `release prepare: no version strings updated (files: ${versionFiles.join(", ")})`;
-    return;
-  }
-  process.stdout.write(`  wrote    ${touched.join(", ")}
-`);
-  const entry = generateChangelog(cwd, newVersion, lastReleaseTag(cwd));
-  prependChangelog(cwd, entry);
-  process.stdout.write(`  wrote    CHANGELOG.md
-`);
-  try {
-    git3(["checkout", "-b", releaseBranch], cwd);
-    for (const f of [...touched, "CHANGELOG.md"]) git3(["add", "--", f], cwd);
-    git3(["commit", "--no-gpg-sign", "-m", `chore: release ${tag}`], cwd);
-    const pushArgs = collides && prefer === "ours" ? ["push", "-u", "--force-with-lease", "origin", releaseBranch] : ["push", "-u", "origin", releaseBranch];
-    git3(pushArgs, cwd, 12e4);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    ctx.output.exitCode = 4;
-    ctx.output.reason = `release prepare: git commit/push failed: ${msg}`;
-    return;
-  }
-  const base = ctx.config.git.defaultBranch;
-  const title = `chore: release ${tag}`;
-  const bodyMax = 6e4;
-  const rawEntry = entry.length > bodyMax ? `${entry.slice(0, bodyMax)}
-
-_\u2026 truncated; see CHANGELOG.md_` : entry;
-  const body = `Automated release PR opened by kody.
-
-${rawEntry}
-
-Merge this and then run \`kody release --mode finalize\`.`;
-  let prUrl = "";
-  const preexistingPr = collides && prefer === "ours" ? findOpenPrForBranch(releaseBranch, cwd) : null;
-  if (preexistingPr) {
-    process.stdout.write(`  PR already open for ${releaseBranch}: ${preexistingPr}
-`);
-    prUrl = preexistingPr;
-  } else {
-    try {
-      prUrl = gh2(["pr", "create", "--head", releaseBranch, "--base", base, "--title", title, "--body-file", "-"], {
-        input: body,
-        cwd
-      }).trim();
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      ctx.output.exitCode = 4;
-      ctx.output.reason = `release prepare: gh pr create failed: ${msg}`;
-      return;
-    }
-  }
-  ctx.output.prUrl = prUrl;
-  ctx.output.exitCode = 0;
-  process.stdout.write(`RELEASE_PR=${prUrl}
-`);
-}
-async function runFinalize(args) {
-  const { cwd, dryRun, timeoutMs, releaseCfg, ctx } = args;
-  const pkgPath = path17.join(cwd, "package.json");
-  const pkg = JSON.parse(fs19.readFileSync(pkgPath, "utf-8"));
-  if (typeof pkg.version !== "string") {
-    ctx.output.exitCode = 99;
-    ctx.output.reason = "release finalize: package.json has no version";
-    return;
-  }
-  const version = pkg.version;
-  const tag = `v${version}`;
-  process.stdout.write(`\u2192 release finalize: ${tag}
-`);
-  try {
-    git3(["rev-parse", "--verify", tag], cwd);
-    ctx.output.exitCode = 1;
-    ctx.output.reason = `release finalize: tag ${tag} already exists`;
-    return;
-  } catch {
-  }
-  if (dryRun) {
-    ctx.output.exitCode = 0;
-    ctx.output.reason = `dry-run \u2014 would tag + publish ${tag}`;
-    return;
-  }
-  if (releaseCfg.e2eCommand && releaseCfg.e2eCommand.trim().length > 0) {
-    const cmd = releaseCfg.e2eCommand.replace(/\$VERSION/g, version);
-    process.stdout.write(`  E2E gate: ${cmd}
-`);
-    const r = runShell(cmd, cwd, timeoutMs);
-    if (r.exitCode !== 0) {
-      ctx.output.exitCode = 2;
-      ctx.output.reason = `release finalize: E2E gate failed (exit ${r.exitCode}): ${truncate2(r.stderr, 600)}`;
-      return;
-    }
-  }
-  try {
-    git3(["tag", "-a", tag, "-m", `Release ${tag}`], cwd);
-    git3(["push", "origin", tag], cwd, 12e4);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    ctx.output.exitCode = 4;
-    ctx.output.reason = `release finalize: tag/push failed: ${msg}`;
-    return;
-  }
-  let publishStatus = "skipped";
-  if (releaseCfg.publishCommand && releaseCfg.publishCommand.trim().length > 0) {
-    const cmd = releaseCfg.publishCommand.replace(/\$VERSION/g, version);
-    process.stdout.write(`  publish: ${cmd}
-`);
-    const r = runShell(cmd, cwd, timeoutMs);
-    publishStatus = r.exitCode === 0 ? "ok" : "failed";
-    if (r.exitCode !== 0) {
-      process.stderr.write(`[kody release] publishCommand exit ${r.exitCode}
-${truncate2(r.stderr, 2e3)}
-`);
-    }
-  }
-  let releaseUrl = "";
-  try {
-    const releaseArgs = ["release", "create", tag, "--title", tag, "--notes", `Release ${tag} \u2014 automated by kody.`];
-    if (releaseCfg.draftRelease) releaseArgs.push("--draft");
-    releaseUrl = gh2(releaseArgs, { cwd }).trim();
-  } catch (err) {
-    process.stderr.write(
-      `[kody release] gh release create failed: ${err instanceof Error ? err.message : String(err)}
-`
-    );
-  }
-  if (releaseCfg.notifyCommand && releaseCfg.notifyCommand.trim().length > 0) {
-    const cmd = releaseCfg.notifyCommand.replace(/\$VERSION/g, version);
-    runShell(cmd, cwd, timeoutMs);
-  }
-  if (releaseUrl) ctx.output.prUrl = releaseUrl;
-  if (publishStatus === "failed") {
-    ctx.output.exitCode = 1;
-    ctx.output.reason = `release finalize: tag + gh release created, but publishCommand failed`;
-    return;
-  }
-  ctx.output.exitCode = 0;
-  process.stdout.write(`RELEASE_TAG=${tag}
-`);
-  if (releaseUrl) process.stdout.write(`RELEASE_URL=${releaseUrl}
-`);
-}
 
 // src/scripts/requireFeedbackActions.ts
 var MIN_ITEMS = 1;
@@ -5130,6 +4840,16 @@ function synthesizeAction(ctx) {
   };
 }
 
+// src/scripts/setCommentTarget.ts
+var setCommentTarget = async (ctx, _profile, args) => {
+  const type = args?.type ?? "issue";
+  const argName = type === "pr" ? "pr" : "issue";
+  const num = ctx.args[argName];
+  if (typeof num !== "number" || num <= 0) return;
+  ctx.data.commentTargetType = type;
+  ctx.data.commentTargetNumber = num;
+};
+
 // src/scripts/setLifecycleLabel.ts
 var setLifecycleLabel = async (ctx, _profile, args) => {
   const label = args?.label;
@@ -5181,7 +4901,7 @@ var stageMergeConflicts = async (ctx) => {
 
 // src/scripts/startFlow.ts
 import { execFileSync as execFileSync18 } from "child_process";
-var API_TIMEOUT_MS7 = 3e4;
+var API_TIMEOUT_MS8 = 3e4;
 var startFlow = async (ctx, profile, _agentResult, args) => {
   const entry = args?.entry;
   if (!entry) {
@@ -5210,12 +4930,12 @@ var startFlow = async (ctx, profile, _agentResult, args) => {
   postKodyComment(target, issueNumber, state, entry, ctx.cwd);
 };
 function postKodyComment(target, issueNumber, state, next, cwd) {
-  const targetNumber = target === "pr" && state?.core.prUrl ? parsePr2(state.core.prUrl) ?? issueNumber : issueNumber;
+  const targetNumber = target === "pr" && state?.core.prUrl ? parsePrNumber(state.core.prUrl) ?? issueNumber : issueNumber;
   const sub = target === "pr" && state?.core.prUrl ? "pr" : "issue";
   const body = `@kody ${next}`;
   try {
     execFileSync18("gh", [sub, "comment", String(targetNumber), "--body", body], {
-      timeout: API_TIMEOUT_MS7,
+      timeout: API_TIMEOUT_MS8,
       cwd,
       stdio: ["ignore", "pipe", "pipe"]
     });
@@ -5226,12 +4946,6 @@ function postKodyComment(target, issueNumber, state, next, cwd) {
     );
   }
 }
-function parsePr2(url) {
-  const m = url.match(/\/pull\/(\d+)(?:[/?#]|$)/);
-  if (!m) return null;
-  const n = parseInt(m[1], 10);
-  return Number.isFinite(n) ? n : null;
-}
 
 // src/scripts/syncFlow.ts
 import { execFileSync as execFileSync19 } from "child_process";
@@ -5507,7 +5221,7 @@ var writeIssueStateComment = async (ctx, _profile, _agentResult, args) => {
 };
 
 // src/scripts/writeRunSummary.ts
-import * as fs20 from "fs";
+import * as fs19 from "fs";
 var writeRunSummary = async (ctx, profile) => {
   const summaryPath = process.env.GITHUB_STEP_SUMMARY;
   if (!summaryPath) return;
@@ -5529,7 +5243,7 @@ var writeRunSummary = async (ctx, profile) => {
   if (reason) lines.push(`- **Reason:** ${reason}`);
   lines.push("");
   try {
-    fs20.appendFileSync(summaryPath, `${lines.join("\n")}
+    fs19.appendFileSync(summaryPath, `${lines.join("\n")}
 `);
   } catch {
   }
@@ -5544,7 +5258,6 @@ var preflightScripts = {
   reviewFlow,
   syncFlow,
   initFlow,
-  releaseFlow,
   watchStalePrsFlow,
   loadTaskState,
   loadIssueContext,
@@ -5558,6 +5271,7 @@ var preflightScripts = {
   discoverQaContext,
   resolvePreviewUrl,
   composePrompt,
+  setCommentTarget,
   setLifecycleLabel,
   skipAgent,
   classifyByLabel,
@@ -5589,7 +5303,10 @@ var postflightScripts = {
   finishFlow,
   advanceFlow,
   persistFlowState,
-  postClassification
+  postClassification,
+  notifyTerminal,
+  recordOutcome,
+  mergeReleasePr
 };
 var allScriptNames = /* @__PURE__ */ new Set([
   ...Object.keys(preflightScripts),
@@ -5613,22 +5330,22 @@ function firstRequiredFailure(results, tools) {
 }
 function verifyOne(tool, cwd) {
   const result = { name: tool.name, present: false, verified: false };
-  let present = runShell2(tool.install.checkCommand, cwd);
+  let present = runShell(tool.install.checkCommand, cwd);
   if (!present && tool.install.installCommand) {
-    runShell2(tool.install.installCommand, cwd, 12e4);
-    present = runShell2(tool.install.checkCommand, cwd);
+    runShell(tool.install.installCommand, cwd, 12e4);
+    present = runShell(tool.install.checkCommand, cwd);
   }
   result.present = present;
   if (!present) {
     result.error = `tool "${tool.name}" not on PATH (check: ${tool.install.checkCommand})`;
     return result;
   }
-  const verified = runShell2(tool.verify, cwd);
+  const verified = runShell(tool.verify, cwd);
   result.verified = verified;
   if (!verified) result.error = `tool "${tool.name}" failed verify: ${tool.verify}`;
   return result;
 }
-function runShell2(cmd, cwd, timeoutMs = 3e4) {
+function runShell(cmd, cwd, timeoutMs = 3e4) {
   try {
     execFileSync20("sh", ["-c", cmd], { cwd, stdio: "pipe", timeout: timeoutMs });
     return true;
@@ -5698,9 +5415,9 @@ async function runExecutable(profileName, input) {
     data: {},
     output: { exitCode: 0 }
   };
-  const ndjsonDir = path18.join(input.cwd, ".kody");
+  const ndjsonDir = path17.join(input.cwd, ".kody");
   const invokeAgent = async (prompt) => {
-    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path18.isAbsolute(p) ? p : path18.resolve(profile.dir, p)).filter((p) => p.length > 0);
+    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path17.isAbsolute(p) ? p : path17.resolve(profile.dir, p)).filter((p) => p.length > 0);
     const syntheticPath = ctx.data.syntheticPluginPath;
     const pluginPaths = [...externalPlugins, ...syntheticPath ? [syntheticPath] : []];
     return runAgent({
@@ -5776,17 +5493,17 @@ async function runExecutable(profileName, input) {
   }
 }
 function resolveProfilePath(profileName) {
-  const here = path18.dirname(new URL(import.meta.url).pathname);
+  const here = path17.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path18.join(here, "executables", profileName, "profile.json"),
+    path17.join(here, "executables", profileName, "profile.json"),
     // same-dir sibling (dev)
-    path18.join(here, "..", "executables", profileName, "profile.json"),
+    path17.join(here, "..", "executables", profileName, "profile.json"),
     // up one (prod: dist/bin → dist/executables)
-    path18.join(here, "..", "src", "executables", profileName, "profile.json")
+    path17.join(here, "..", "src", "executables", profileName, "profile.json")
     // fallback
   ];
   for (const c of candidates) {
-    if (fs21.existsSync(c)) return c;
+    if (fs20.existsSync(c)) return c;
   }
   return candidates[0];
 }
@@ -5879,8 +5596,8 @@ function finish(out) {
 var SHELL_TIMEOUT_MS = 3e5;
 function runShellEntry(entry, ctx, profile) {
   const shellName = entry.shell;
-  const shellPath = path18.join(profile.dir, shellName);
-  if (!fs21.existsSync(shellPath)) {
+  const shellPath = path17.join(profile.dir, shellName);
+  if (!fs20.existsSync(shellPath)) {
     ctx.skipAgent = true;
     ctx.output.exitCode = 99;
     ctx.output.reason = `shell script not found: ${shellName} (looked in ${profile.dir})`;
@@ -5890,9 +5607,12 @@ function runShellEntry(entry, ctx, profile) {
   const env = { ...process.env, HUSKY: "0", SKIP_HOOKS: "1" };
   for (const [k, v] of Object.entries(ctx.args)) {
     if (v === void 0 || v === null) continue;
-    env[`KODY_ARG_${k.toUpperCase().replace(/-/g, "_")}`] = String(v);
+    env[`KODY_ARG_${envKey(k)}`] = String(v);
+  }
+  for (const [k, v] of flattenConfig(ctx.config)) {
+    env[`KODY_CFG_${k}`] = v;
   }
-  const r = spawnSync2("bash", [shellPath, ...positional], {
+  const r = spawnSync("bash", [shellPath, ...positional], {
     cwd: ctx.cwd,
     encoding: "utf-8",
     env,
@@ -5907,6 +5627,10 @@ function runShellEntry(entry, ctx, profile) {
     ctx.skipAgent = true;
     if (ctx.output.exitCode === void 0) ctx.output.exitCode = 0;
   }
+  const prUrlMatch = stdout.match(/^KODY_PR_URL=(.+)$/m);
+  if (prUrlMatch?.[1]) ctx.output.prUrl = prUrlMatch[1].trim();
+  const reasonMatch = stdout.match(/^KODY_REASON=(.+)$/m);
+  if (reasonMatch?.[1]) ctx.output.reason = reasonMatch[1].trim();
   const exit = r.status ?? -1;
   if (exit !== 0) {
     ctx.skipAgent = true;
@@ -5919,6 +5643,24 @@ function runShellEntry(entry, ctx, profile) {
     }
   }
 }
+function envKey(name) {
+  return name.toUpperCase().replace(/-/g, "_");
+}
+function flattenConfig(obj, prefix = "") {
+  const out = [];
+  for (const [k, v] of Object.entries(obj)) {
+    if (v === null || v === void 0) continue;
+    const key = prefix ? `${prefix}_${envKey(k)}` : envKey(k);
+    if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
+      out.push([key, String(v)]);
+    } else if (Array.isArray(v)) {
+      out.push([key, JSON.stringify(v)]);
+    } else if (typeof v === "object") {
+      out.push(...flattenConfig(v, key));
+    }
+  }
+  return out;
+}
 
 // src/kody-cli.ts
 var CI_HELP = `kody ci \u2014 minimal-YAML autonomous engineer (CI preflight + run)
@@ -6005,9 +5747,9 @@ function resolveAuthToken(env = process.env) {
   return token;
 }
 function detectPackageManager2(cwd) {
-  if (fs22.existsSync(path19.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs22.existsSync(path19.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs22.existsSync(path19.join(cwd, "bun.lockb"))) return "bun";
+  if (fs21.existsSync(path18.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs21.existsSync(path18.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs21.existsSync(path18.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function shellOut(cmd, args, cwd, stream = true) {
@@ -6087,11 +5829,11 @@ function configureGitIdentity(cwd) {
 }
 function postFailureTail(issueNumber, cwd, reason) {
   if (!issueNumber) return;
-  const logPath = path19.join(cwd, ".kody", "last-run.jsonl");
+  const logPath = path18.join(cwd, ".kody", "last-run.jsonl");
   let tail = "";
   try {
-    if (fs22.existsSync(logPath)) {
-      const content = fs22.readFileSync(logPath, "utf-8");
+    if (fs21.existsSync(logPath)) {
+      const content = fs21.readFileSync(logPath, "utf-8");
       tail = content.slice(-3e3);
     }
   } catch {
@@ -6116,7 +5858,7 @@ async function runCi(argv) {
     return 0;
   }
   const args = parseCiArgs(argv);
-  const cwd = args.cwd ? path19.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path18.resolve(args.cwd) : process.cwd();
   let earlyConfig;
   try {
     earlyConfig = loadConfig(cwd);
@@ -6254,9 +5996,9 @@ function parseChatArgs(argv, env = process.env) {
   return result;
 }
 function commitChatFiles(cwd, sessionId, verbose) {
-  const sessionFile = path20.relative(cwd, sessionFilePath(cwd, sessionId));
-  const eventsFile = path20.relative(cwd, eventsFilePath(cwd, sessionId));
-  const paths = [sessionFile, eventsFile].filter((p) => fs23.existsSync(path20.join(cwd, p)));
+  const sessionFile = path19.relative(cwd, sessionFilePath(cwd, sessionId));
+  const eventsFile = path19.relative(cwd, eventsFilePath(cwd, sessionId));
+  const paths = [sessionFile, eventsFile].filter((p) => fs22.existsSync(path19.join(cwd, p)));
   if (paths.length === 0) return;
   const opts = { cwd, stdio: verbose ? "inherit" : "pipe" };
   try {
@@ -6294,7 +6036,7 @@ async function runChat(argv) {
 ${CHAT_HELP}`);
     return 64;
   }
-  const cwd = args.cwd ? path20.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path19.resolve(args.cwd) : process.cwd();
   const sessionId = args.sessionId;
   const unpackedSecrets = unpackAllSecrets();
   if (unpackedSecrets > 0) {