@kody-ade/kody-engine 0.4.153 → 0.4.155

package/dist/bin/kody.js

@@ -1061,7 +1061,7 @@ var init_loadPriorArt = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.153",
+  version: "0.4.155",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -1117,7 +1117,7 @@ var package_default = {
 };
 
 // src/chat-cli.ts
-import { execFileSync as execFileSync30 } from "child_process";
+import { execFileSync as execFileSync31 } from "child_process";
 import * as fs42 from "fs";
 import * as path38 from "path";
 
@@ -1376,7 +1376,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 git5 = raw.git ?? {};
   const github = raw.github ?? {};
   const agent = raw.agent ?? {};
   if (!agent.model || typeof agent.model !== "string") {
@@ -1393,7 +1393,7 @@ function loadConfig(projectDir = process.cwd()) {
       testUnit: typeof quality.testUnit === "string" ? quality.testUnit : ""
     },
     git: {
-      defaultBranch: typeof git4.defaultBranch === "string" ? git4.defaultBranch : "main"
+      defaultBranch: typeof git5.defaultBranch === "string" ? git5.defaultBranch : "main"
     },
     github: {
       owner: String(github.owner),
@@ -2755,7 +2755,7 @@ async function emit2(sink, type, sessionId, suffix, payload) {
 }
 
 // src/kody-cli.ts
-import { execFileSync as execFileSync29 } from "child_process";
+import { execFileSync as execFileSync30 } from "child_process";
 import * as fs41 from "fs";
 import * as path37 from "path";
 
@@ -3156,7 +3156,7 @@ function coerceBare(spec, value) {
 }
 
 // src/executor.ts
-import { execFileSync as execFileSync28, spawn as spawn9 } from "child_process";
+import { execFileSync as execFileSync29, spawn as spawn9 } from "child_process";
 import * as fs40 from "fs";
 import * as path36 from "path";
 
@@ -7529,6 +7529,7 @@ var dispatchNextTask = async (ctx) => {
 
 // src/pr.ts
 init_issue();
+import { execFileSync as execFileSync13 } from "child_process";
 function prMergeStatus(prNumber, cwd) {
   try {
     const out = gh(
@@ -7648,6 +7649,51 @@ function recoverSourceIssueNumber(existingBody, branch, prNumber) {
   }
   return null;
 }
+var ALREADY_EXISTS_RE = /pull request .*already exists|already exists for/i;
+function isAlreadyExistsError(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  return ALREADY_EXISTS_RE.test(msg);
+}
+function git2(args, cwd) {
+  return execFileSync13("git", args, {
+    encoding: "utf-8",
+    timeout: 3e4,
+    cwd,
+    env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1" },
+    stdio: ["pipe", "pipe", "pipe"]
+  }).trim();
+}
+function updateExistingPr(existing, body, draft, cwd) {
+  const stripped = existing.url.replace(/^https:\/\/github\.com\//, "");
+  const [owner, repo] = stripped.split("/");
+  try {
+    gh(["api", "--method", "PATCH", `repos/${owner}/${repo}/pulls/${existing.number}`, "-f", `body=${body}`], { cwd });
+  } catch (err) {
+    throw new Error(`gh api PATCH #${existing.number} failed: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  return { url: existing.url, number: existing.number, draft, action: "updated" };
+}
+function createPr(branch, base, title, body, draft, cwd) {
+  const args = ["pr", "create", "--head", branch, "--base", base, "--title", title, "--body-file", "-"];
+  if (draft) args.push("--draft");
+  const url = gh(args, { input: body, cwd }).trim();
+  const match = url.match(/\/pull\/(\d+)$/);
+  const number = match ? parseInt(match[1], 10) : 0;
+  return { url, number, draft, action: "created" };
+}
+function recoverFromExistingPr(branch, base, title, body, draft, cwd) {
+  const raced = findExistingPr(branch, cwd);
+  if (raced) return updateExistingPr(raced, body, draft, cwd);
+  try {
+    git2(["push", "origin", "--delete", branch], cwd);
+  } catch {
+  }
+  const push = pushWithRetry({ cwd, branch, setUpstream: true });
+  if (!push.ok) {
+    throw new Error(`re-push after deleting orphaned branch '${branch}' failed: ${push.reason}`);
+  }
+  return createPr(branch, base, title, body, draft, cwd);
+}
 function ensurePr(opts) {
   const existing = findExistingPr(opts.branch, opts.cwd);
   const effectiveIssueNumber = existing ? recoverSourceIssueNumber(existing.body, opts.branch, existing.number) ?? opts.issueNumber : opts.issueNumber;
@@ -7655,36 +7701,15 @@ function ensurePr(opts) {
   const title = buildPrTitle(effectiveOpts.issueNumber, effectiveOpts.issueTitle, effectiveOpts.draft);
   const body = buildPrBody(effectiveOpts);
   if (existing) {
-    const stripped = existing.url.replace(/^https:\/\/github\.com\//, "");
-    const [owner, repo] = stripped.split("/");
-    try {
-      gh(["api", "--method", "PATCH", `repos/${owner}/${repo}/pulls/${existing.number}`, "-f", `body=${body}`], {
-        cwd: opts.cwd
-      });
-    } catch (err) {
-      throw new Error(`gh api PATCH #${existing.number} failed: ${err instanceof Error ? err.message : String(err)}`);
-    }
-    return { url: existing.url, number: existing.number, draft: opts.draft, action: "updated" };
+    return updateExistingPr(existing, body, opts.draft, opts.cwd);
   }
   const base = opts.baseBranch && opts.baseBranch.length > 0 ? opts.baseBranch : opts.defaultBranch;
-  const args = [
-    "pr",
-    "create",
-    "--head",
-    opts.branch,
-    "--base",
-    base,
-    "--title",
-    title,
-    "--body-file",
-    "-"
-  ];
-  if (opts.draft) args.push("--draft");
-  const output = gh(args, { input: body, cwd: opts.cwd });
-  const url = output.trim();
-  const match = url.match(/\/pull\/(\d+)$/);
-  const number = match ? parseInt(match[1], 10) : 0;
-  return { url, number, draft: opts.draft, action: "created" };
+  try {
+    return createPr(opts.branch, base, title, body, opts.draft, opts.cwd);
+  } catch (err) {
+    if (!isAlreadyExistsError(err)) throw err;
+    return recoverFromExistingPr(opts.branch, base, title, body, opts.draft, opts.cwd);
+  }
 }
 
 // src/scripts/ensurePr.ts
@@ -7961,7 +7986,7 @@ var finalizeTerminal = async (ctx) => {
 
 // src/scripts/finishFlow.ts
 init_issue();
-import { execFileSync as execFileSync13 } from "child_process";
+import { execFileSync as execFileSync14 } from "child_process";
 var TERMINAL_PHASE = {
   "review-passed": { phase: "shipped", status: "succeeded" },
   "fix-applied": { phase: "shipped", status: "succeeded" },
@@ -8001,7 +8026,7 @@ var finishFlow = async (ctx, profile, _agentResult, args) => {
 **PR:** ${state.core.prUrl}` : "";
   const body = `${icon} kody flow \`${flowName}\` finished \u2014 \`${reason}\`${prSuffix}`;
   try {
-    execFileSync13("gh", ["issue", "comment", String(issueNumber), "--body", body], {
+    execFileSync14("gh", ["issue", "comment", String(issueNumber), "--body", body], {
       timeout: API_TIMEOUT_MS6,
       cwd: ctx.cwd,
       stdio: ["ignore", "pipe", "pipe"]
@@ -8031,9 +8056,9 @@ var finishFlow = async (ctx, profile, _agentResult, args) => {
 };
 
 // src/branch.ts
-import { execFileSync as execFileSync14 } from "child_process";
-function git2(args, cwd) {
-  return execFileSync14("git", args, {
+import { execFileSync as execFileSync15 } from "child_process";
+function git3(args, cwd) {
+  return execFileSync15("git", args, {
     encoding: "utf-8",
     timeout: 3e4,
     cwd,
@@ -8046,15 +8071,15 @@ function deriveBranchName(issueNumber, title) {
   return slug ? `${issueNumber}-${slug}` : `${issueNumber}-task`;
 }
 function getCurrentBranch(cwd) {
-  return git2(["branch", "--show-current"], cwd);
+  return git3(["branch", "--show-current"], cwd);
 }
 function resetWorkingTree(cwd) {
   try {
-    execFileSync14("git", ["reset", "--hard", "HEAD"], { cwd, stdio: ["ignore", "pipe", "pipe"], timeout: 3e4 });
+    execFileSync15("git", ["reset", "--hard", "HEAD"], { cwd, stdio: ["ignore", "pipe", "pipe"], timeout: 3e4 });
   } catch {
   }
   try {
-    execFileSync14("git", ["clean", "-fd"], { cwd, stdio: ["ignore", "pipe", "pipe"], timeout: 3e4 });
+    execFileSync15("git", ["clean", "-fd"], { cwd, stdio: ["ignore", "pipe", "pipe"], timeout: 3e4 });
   } catch {
   }
 }
@@ -8066,14 +8091,14 @@ function checkoutPrBranch(prNumber, cwd) {
     GH_TOKEN: process.env.GH_PAT?.trim() || process.env.GH_TOKEN || ""
   };
   try {
-    execFileSync14("git", ["reset", "--hard", "HEAD"], { cwd, env, stdio: ["ignore", "pipe", "pipe"], timeout: 3e4 });
+    execFileSync15("git", ["reset", "--hard", "HEAD"], { cwd, env, stdio: ["ignore", "pipe", "pipe"], timeout: 3e4 });
   } catch {
   }
   try {
-    execFileSync14("git", ["clean", "-fd"], { cwd, env, stdio: ["ignore", "pipe", "pipe"], timeout: 3e4 });
+    execFileSync15("git", ["clean", "-fd"], { cwd, env, stdio: ["ignore", "pipe", "pipe"], timeout: 3e4 });
   } catch {
   }
-  execFileSync14("gh", ["pr", "checkout", String(prNumber)], {
+  execFileSync15("gh", ["pr", "checkout", String(prNumber)], {
     cwd,
     env,
     stdio: ["ignore", "pipe", "pipe"],
@@ -8083,21 +8108,21 @@ function checkoutPrBranch(prNumber, cwd) {
 }
 function mergeBase(baseBranch, cwd) {
   try {
-    git2(["fetch", "origin", baseBranch], cwd);
+    git3(["fetch", "origin", baseBranch], cwd);
   } catch {
     return "error";
   }
   try {
-    git2(["merge", `origin/${baseBranch}`, "--no-edit", "--no-ff"], cwd);
+    git3(["merge", `origin/${baseBranch}`, "--no-edit", "--no-ff"], cwd);
     return "clean";
   } catch {
     try {
-      const unmerged = git2(["diff", "--name-only", "--diff-filter=U"], cwd);
+      const unmerged = git3(["diff", "--name-only", "--diff-filter=U"], cwd);
       if (unmerged.length > 0) return "conflict";
     } catch {
     }
     try {
-      git2(["merge", "--abort"], cwd);
+      git3(["merge", "--abort"], cwd);
     } catch {
     }
     return "error";
@@ -8111,26 +8136,26 @@ function ensureFeatureBranch(issueNumber, title, defaultBranch2, cwd, baseBranch
     return { branch: branchName, created: false };
   }
   try {
-    git2(["fetch", "origin"], cwd);
+    git3(["fetch", "origin"], cwd);
   } catch {
   }
   let originBranchExists = false;
   try {
-    git2(["rev-parse", "--verify", "--quiet", `refs/remotes/origin/${branchName}`], cwd);
+    git3(["rev-parse", "--verify", "--quiet", `refs/remotes/origin/${branchName}`], cwd);
     originBranchExists = true;
   } catch {
   }
   if (originBranchExists && baseBranch && baseBranch !== defaultBranch2) {
     let baseExists = false;
     try {
-      git2(["rev-parse", "--verify", `origin/${baseBranch}`], cwd);
+      git3(["rev-parse", "--verify", `origin/${baseBranch}`], cwd);
       baseExists = true;
     } catch {
     }
     if (baseExists) {
       let descendsFromBase = false;
       try {
-        git2(["merge-base", "--is-ancestor", `origin/${baseBranch}`, `origin/${branchName}`], cwd);
+        git3(["merge-base", "--is-ancestor", `origin/${baseBranch}`, `origin/${branchName}`], cwd);
         descendsFromBase = true;
       } catch {
       }
@@ -8140,15 +8165,15 @@ function ensureFeatureBranch(issueNumber, title, defaultBranch2, cwd, baseBranch
 `
         );
         try {
-          git2(["push", "origin", "--delete", branchName], cwd);
+          git3(["push", "origin", "--delete", branchName], cwd);
         } catch {
         }
         try {
-          git2(["update-ref", "-d", `refs/remotes/origin/${branchName}`], cwd);
+          git3(["update-ref", "-d", `refs/remotes/origin/${branchName}`], cwd);
         } catch {
         }
         try {
-          git2(["branch", "-D", branchName], cwd);
+          git3(["branch", "-D", branchName], cwd);
         } catch {
         }
         originBranchExists = false;
@@ -8156,17 +8181,17 @@ function ensureFeatureBranch(issueNumber, title, defaultBranch2, cwd, baseBranch
     }
   }
   if (originBranchExists) {
-    git2(["checkout", branchName], cwd);
+    git3(["checkout", branchName], cwd);
     try {
-      git2(["pull", "origin", branchName], cwd);
+      git3(["pull", "origin", branchName], cwd);
     } catch {
     }
     if (!baseBranch || baseBranch === defaultBranch2) {
       try {
-        git2(["merge", "--no-edit", `origin/${defaultBranch2}`], cwd);
+        git3(["merge", "--no-edit", `origin/${defaultBranch2}`], cwd);
       } catch {
         try {
-          git2(["merge", "--abort"], cwd);
+          git3(["merge", "--abort"], cwd);
         } catch {
         }
         throw new Error(
@@ -8177,29 +8202,29 @@ function ensureFeatureBranch(issueNumber, title, defaultBranch2, cwd, baseBranch
     return { branch: branchName, created: false };
   }
   try {
-    git2(["rev-parse", "--verify", "--quiet", `refs/heads/${branchName}`], cwd);
-    git2(["checkout", branchName], cwd);
+    git3(["rev-parse", "--verify", "--quiet", `refs/heads/${branchName}`], cwd);
+    git3(["checkout", branchName], cwd);
     return { branch: branchName, created: false };
   } catch {
   }
   let forkPoint = defaultBranch2;
   if (baseBranch && baseBranch !== defaultBranch2) {
     try {
-      git2(["rev-parse", "--verify", `origin/${baseBranch}`], cwd);
+      git3(["rev-parse", "--verify", `origin/${baseBranch}`], cwd);
       forkPoint = baseBranch;
     } catch {
     }
   }
   try {
-    git2(["checkout", "-b", branchName, `origin/${forkPoint}`], cwd);
+    git3(["checkout", "-b", branchName, `origin/${forkPoint}`], cwd);
   } catch {
-    git2(["checkout", "-b", branchName], cwd);
+    git3(["checkout", "-b", branchName], cwd);
   }
   return { branch: branchName, created: true };
 }
 
 // src/gha.ts
-import { execFileSync as execFileSync15 } from "child_process";
+import { execFileSync as execFileSync16 } from "child_process";
 import * as fs29 from "fs";
 function getRunUrl() {
   const server = process.env.GITHUB_SERVER_URL;
@@ -8242,7 +8267,7 @@ function reactToTriggerComment(cwd) {
   for (let attempt = 0; attempt < 3; attempt++) {
     if (attempt > 0) sleepMs(attempt === 1 ? 500 : 1500);
     try {
-      execFileSync15("gh", args, opts);
+      execFileSync16("gh", args, opts);
       return;
     } catch (err) {
       lastErr = err;
@@ -8255,7 +8280,7 @@ function reactToTriggerComment(cwd) {
 }
 function sleepMs(ms) {
   try {
-    execFileSync15("sleep", [(ms / 1e3).toString()], { stdio: "ignore", timeout: ms + 1e3 });
+    execFileSync16("sleep", [(ms / 1e3).toString()], { stdio: "ignore", timeout: ms + 1e3 });
   } catch {
   }
 }
@@ -8264,7 +8289,7 @@ function sleepMs(ms) {
 init_issue();
 
 // src/workflow.ts
-import { execFileSync as execFileSync16 } from "child_process";
+import { execFileSync as execFileSync17 } from "child_process";
 var GH_TIMEOUT_MS = 3e4;
 function ghToken3() {
   return process.env.GH_PAT?.trim() || process.env.GH_TOKEN;
@@ -8272,7 +8297,7 @@ function ghToken3() {
 function gh3(args, cwd) {
   const token = ghToken3();
   const env = token ? { ...process.env, GH_TOKEN: token } : { ...process.env };
-  return execFileSync16("gh", args, {
+  return execFileSync17("gh", args, {
     encoding: "utf-8",
     timeout: GH_TIMEOUT_MS,
     cwd,
@@ -8507,7 +8532,7 @@ var handleAbandonedGoal = async (ctx) => {
 };
 
 // src/scripts/initFlow.ts
-import { execFileSync as execFileSync17 } from "child_process";
+import { execFileSync as execFileSync18 } from "child_process";
 import * as fs30 from "fs";
 import * as path28 from "path";
 function detectPackageManager(cwd) {
@@ -8533,7 +8558,7 @@ function schemaUrlFromPkg() {
 function detectOwnerRepo(cwd) {
   let url;
   try {
-    url = execFileSync17("git", ["remote", "get-url", "origin"], {
+    url = execFileSync18("git", ["remote", "get-url", "origin"], {
       cwd,
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "pipe"]
@@ -8618,7 +8643,7 @@ jobs:
 `;
 function defaultBranchFromGit(cwd) {
   try {
-    const ref = execFileSync17("git", ["symbolic-ref", "refs/remotes/origin/HEAD"], {
+    const ref = execFileSync18("git", ["symbolic-ref", "refs/remotes/origin/HEAD"], {
       cwd,
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "pipe"]
@@ -8626,7 +8651,7 @@ function defaultBranchFromGit(cwd) {
     return ref.replace("refs/remotes/origin/", "");
   } catch {
     try {
-      return execFileSync17("git", ["branch", "--show-current"], {
+      return execFileSync18("git", ["branch", "--show-current"], {
         cwd,
         encoding: "utf-8",
         stdio: ["ignore", "pipe", "pipe"]
@@ -9316,7 +9341,7 @@ var mergeFlow = async (ctx) => {
 };
 
 // src/scripts/mergeReleasePr.ts
-import { execFileSync as execFileSync18 } from "child_process";
+import { execFileSync as execFileSync19 } from "child_process";
 var API_TIMEOUT_MS7 = 6e4;
 var mergeReleasePr = async (ctx) => {
   const state = ctx.data.taskState;
@@ -9335,7 +9360,7 @@ var mergeReleasePr = async (ctx) => {
   process.stderr.write(`[kody mergeReleasePr] merging PR #${prNumber} (${prUrl})
 `);
   try {
-    const out = execFileSync18("gh", ["pr", "merge", String(prNumber), "--merge"], {
+    const out = execFileSync19("gh", ["pr", "merge", String(prNumber), "--merge"], {
       timeout: API_TIMEOUT_MS7,
       cwd: ctx.cwd,
       stdio: ["ignore", "pipe", "pipe"]
@@ -10817,7 +10842,7 @@ ${body}`;
 }
 
 // src/scripts/recordClassification.ts
-import { execFileSync as execFileSync19 } from "child_process";
+import { execFileSync as execFileSync20 } from "child_process";
 var API_TIMEOUT_MS8 = 3e4;
 var VALID_CLASSES3 = /* @__PURE__ */ new Set(["feature", "bug", "spec", "chore"]);
 var recordClassification = async (ctx) => {
@@ -10865,7 +10890,7 @@ function parseClassification(prSummary) {
 }
 function tryAuditComment(issueNumber, body, cwd) {
   try {
-    execFileSync19("gh", ["issue", "comment", String(issueNumber), "--body", body], {
+    execFileSync20("gh", ["issue", "comment", String(issueNumber), "--body", body], {
       cwd,
       timeout: API_TIMEOUT_MS8,
       stdio: ["ignore", "pipe", "pipe"]
@@ -10979,7 +11004,7 @@ var resolveArtifacts = async (ctx, profile) => {
 };
 
 // src/scripts/resolveFlow.ts
-import { execFileSync as execFileSync20 } from "child_process";
+import { execFileSync as execFileSync21 } from "child_process";
 init_issue();
 var CONFLICT_DIFF_MAX_BYTES = 4e4;
 var resolveFlow = async (ctx) => {
@@ -11073,7 +11098,7 @@ function buildPreferBlock(prefer, baseBranch) {
 }
 function getConflictedFiles(cwd) {
   try {
-    const out = execFileSync20("git", ["diff", "--name-only", "--diff-filter=U"], {
+    const out = execFileSync21("git", ["diff", "--name-only", "--diff-filter=U"], {
       encoding: "utf-8",
       cwd,
       env: { ...process.env, HUSKY: "0" }
@@ -11088,7 +11113,7 @@ function getConflictMarkersPreview(files, cwd, maxBytes = CONFLICT_DIFF_MAX_BYTE
   let total = 0;
   for (const f of files) {
     try {
-      const content = execFileSync20("cat", [f], { encoding: "utf-8", cwd }).toString();
+      const content = execFileSync21("cat", [f], { encoding: "utf-8", cwd }).toString();
       const snippet = `### ${f}
 
 \`\`\`
@@ -11112,12 +11137,12 @@ function tryPostPr3(prNumber, body, cwd) {
 function pushEmptyCommit(branch, cwd) {
   const env = { ...process.env, HUSKY: "0", SKIP_HOOKS: "1" };
   try {
-    execFileSync20(
+    execFileSync21(
       "git",
       ["commit", "--allow-empty", "-m", "chore: kody resolve refresh \u2014 empty commit to recompute mergeable status"],
       { cwd, env, stdio: ["ignore", "pipe", "pipe"] }
     );
-    execFileSync20("git", ["push", "-u", "origin", branch], {
+    execFileSync21("git", ["push", "-u", "origin", branch], {
       cwd,
       env,
       stdio: ["ignore", "pipe", "pipe"]
@@ -11248,10 +11273,10 @@ var resolvePreviewUrl = async (ctx) => {
 };
 
 // src/scripts/resolveQaUrl.ts
-import { execFileSync as execFileSync21 } from "child_process";
+import { execFileSync as execFileSync22 } from "child_process";
 function ghQuery(args, cwd) {
   try {
-    const out = execFileSync21("gh", args, {
+    const out = execFileSync22("gh", args, {
       cwd,
       stdio: ["ignore", "pipe", "pipe"],
       encoding: "utf-8",
@@ -11321,7 +11346,7 @@ var resolveQaUrl = async (ctx) => {
 };
 
 // src/scripts/revertFlow.ts
-import { execFileSync as execFileSync22 } from "child_process";
+import { execFileSync as execFileSync23 } from "child_process";
 init_issue();
 var SHA_RE = /^[0-9a-f]{4,40}$/i;
 var revertFlow = async (ctx) => {
@@ -11360,7 +11385,7 @@ var revertFlow = async (ctx) => {
   for (const s of requested) {
     let full;
     try {
-      full = git3(["rev-parse", "--verify", `${s}^{commit}`], ctx.cwd);
+      full = git4(["rev-parse", "--verify", `${s}^{commit}`], ctx.cwd);
     } catch {
       unreachable.push(s);
       continue;
@@ -11371,7 +11396,7 @@ var revertFlow = async (ctx) => {
     }
     let subject = "";
     try {
-      subject = git3(["log", "-1", "--format=%s", full], ctx.cwd);
+      subject = git4(["log", "-1", "--format=%s", full], ctx.cwd);
     } catch {
     }
     resolved.push({ input: s, full, subject });
@@ -11403,8 +11428,8 @@ function buildCommitMessage(resolved) {
 function buildPrSummary(resolved) {
   return resolved.map((r) => `- Reverted \`${r.full.slice(0, 7)}\`${r.subject ? ` \u2014 ${r.subject}` : ""}`).join("\n");
 }
-function git3(args, cwd) {
-  return execFileSync22("git", args, {
+function git4(args, cwd) {
+  return execFileSync23("git", args, {
     encoding: "utf-8",
     timeout: 3e4,
     cwd,
@@ -11414,7 +11439,7 @@ function git3(args, cwd) {
 }
 function isAncestorOfHead(sha, cwd) {
   try {
-    execFileSync22("git", ["merge-base", "--is-ancestor", sha, "HEAD"], {
+    execFileSync23("git", ["merge-base", "--is-ancestor", sha, "HEAD"], {
       cwd,
       env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1" },
       stdio: ["ignore", "ignore", "ignore"]
@@ -12060,11 +12085,11 @@ var skipAgent = async (ctx) => {
 };
 
 // src/scripts/stageMergeConflicts.ts
-import { execFileSync as execFileSync23 } from "child_process";
+import { execFileSync as execFileSync24 } from "child_process";
 var stageMergeConflicts = async (ctx) => {
   if (ctx.data.agentDone === false) return;
   try {
-    execFileSync23("git", ["add", "-A"], {
+    execFileSync24("git", ["add", "-A"], {
       cwd: ctx.cwd,
       env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1" },
       stdio: "pipe"
@@ -12075,7 +12100,7 @@ var stageMergeConflicts = async (ctx) => {
 
 // src/scripts/startFlow.ts
 init_issue();
-import { execFileSync as execFileSync24 } from "child_process";
+import { execFileSync as execFileSync25 } from "child_process";
 var API_TIMEOUT_MS9 = 3e4;
 var startFlow = async (ctx, profile, _agentResult, args) => {
   const entry = args?.entry;
@@ -12109,7 +12134,7 @@ function postKodyComment(target, issueNumber, state, next, cwd) {
   const sub = target === "pr" && state?.core.prUrl ? "pr" : "issue";
   const body = `@kody ${next}`;
   try {
-    execFileSync24("gh", [sub, "comment", String(targetNumber), "--body", body], {
+    execFileSync25("gh", [sub, "comment", String(targetNumber), "--body", body], {
       timeout: API_TIMEOUT_MS9,
       cwd,
       stdio: ["ignore", "pipe", "pipe"]
@@ -12123,7 +12148,7 @@ function postKodyComment(target, issueNumber, state, next, cwd) {
 }
 
 // src/scripts/syncFlow.ts
-import { execFileSync as execFileSync25 } from "child_process";
+import { execFileSync as execFileSync26 } from "child_process";
 init_issue();
 var DONE2 = {
   label: "kody:done",
@@ -12201,7 +12226,7 @@ function bail2(ctx, prNumber, reason) {
 }
 function revParseHead(cwd) {
   try {
-    return execFileSync25("git", ["rev-parse", "HEAD"], { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).toString().trim();
+    return execFileSync26("git", ["rev-parse", "HEAD"], { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).toString().trim();
   } catch {
     return "";
   }
@@ -12458,7 +12483,7 @@ var verifyWithRetry = async (ctx) => {
 
 // src/scripts/waitForCi.ts
 init_issue();
-import { execFileSync as execFileSync26 } from "child_process";
+import { execFileSync as execFileSync27 } from "child_process";
 var API_TIMEOUT_MS10 = 3e4;
 var waitForCi = async (ctx, _profile, _agentResult, args) => {
   const timeoutMinutes = numArg(args, "timeoutMinutes", 30);
@@ -12536,7 +12561,7 @@ var waitForCi = async (ctx, _profile, _agentResult, args) => {
 };
 function fetchChecks(prNumber, cwd) {
   try {
-    const raw = execFileSync26("gh", ["pr", "checks", String(prNumber), "--json", "bucket,state,name,workflow,link"], {
+    const raw = execFileSync27("gh", ["pr", "checks", String(prNumber), "--json", "bucket,state,name,workflow,link"], {
       encoding: "utf-8",
       timeout: API_TIMEOUT_MS10,
       cwd,
@@ -13012,7 +13037,7 @@ var allScriptNames = /* @__PURE__ */ new Set([
 ]);
 
 // src/tools.ts
-import { execFileSync as execFileSync27 } from "child_process";
+import { execFileSync as execFileSync28 } from "child_process";
 function verifyCliTools(tools, cwd) {
   const out = [];
   for (const t of tools) out.push(verifyOne(t, cwd));
@@ -13049,7 +13074,7 @@ function verifyOne(tool4, cwd) {
 }
 function runShell(cmd, cwd, timeoutMs = 3e4) {
   try {
-    const stdout = execFileSync27("sh", ["-c", cmd], {
+    const stdout = execFileSync28("sh", ["-c", cmd], {
       cwd,
       stdio: ["ignore", "pipe", "pipe"],
       timeout: timeoutMs,
@@ -13838,7 +13863,7 @@ async function runContainerLoop(profile, ctx, input) {
 }
 function resetWorkingTree2(cwd) {
   try {
-    execFileSync28("git", ["reset", "--hard", "HEAD"], {
+    execFileSync29("git", ["reset", "--hard", "HEAD"], {
       cwd,
       stdio: ["ignore", "pipe", "pipe"],
       timeout: 3e4
@@ -14024,7 +14049,7 @@ function detectPackageManager2(cwd) {
 }
 function shellOut(cmd, args, cwd, stream = true) {
   try {
-    execFileSync29(cmd, args, {
+    execFileSync30(cmd, args, {
       cwd,
       stdio: stream ? "inherit" : "pipe",
       env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1", CI: process.env.CI ?? "1" }
@@ -14037,7 +14062,7 @@ function shellOut(cmd, args, cwd, stream = true) {
 }
 function isOnPath(bin) {
   try {
-    execFileSync29("which", [bin], { stdio: "pipe" });
+    execFileSync30("which", [bin], { stdio: "pipe" });
     return true;
   } catch {
     return false;
@@ -14078,7 +14103,7 @@ function installLitellmIfNeeded(cwd) {
   } catch {
   }
   try {
-    execFileSync29("python3", ["-c", "import litellm"], { stdio: "pipe" });
+    execFileSync30("python3", ["-c", "import litellm"], { stdio: "pipe" });
     process.stdout.write("\u2192 kody: litellm already installed\n");
     return 0;
   } catch {
@@ -14088,16 +14113,16 @@ function installLitellmIfNeeded(cwd) {
 }
 function configureGitIdentity(cwd) {
   try {
-    const name = execFileSync29("git", ["config", "user.name"], { cwd, stdio: "pipe", encoding: "utf-8" }).trim();
+    const name = execFileSync30("git", ["config", "user.name"], { cwd, stdio: "pipe", encoding: "utf-8" }).trim();
     if (name) return;
   } catch {
   }
   try {
-    execFileSync29("git", ["config", "user.name", "github-actions[bot]"], { cwd, stdio: "pipe" });
+    execFileSync30("git", ["config", "user.name", "github-actions[bot]"], { cwd, stdio: "pipe" });
   } catch {
   }
   try {
-    execFileSync29("git", ["config", "user.email", "41898282+github-actions[bot]@users.noreply.github.com"], {
+    execFileSync30("git", ["config", "user.email", "41898282+github-actions[bot]@users.noreply.github.com"], {
       cwd,
       stdio: "pipe"
     });
@@ -14417,8 +14442,8 @@ function commitChatFiles(cwd, sessionId, verbose) {
   if (paths.length === 0) return;
   const opts = { cwd, stdio: verbose ? "inherit" : "pipe" };
   try {
-    execFileSync30("git", ["add", "-f", ...paths], opts);
-    execFileSync30("git", ["commit", "--quiet", "-m", `chat: reply for ${sessionId}`], opts);
+    execFileSync31("git", ["add", "-f", ...paths], opts);
+    execFileSync31("git", ["commit", "--quiet", "-m", `chat: reply for ${sessionId}`], opts);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     process.stderr.write(`[kody:chat] commit skipped: ${msg}

package/dist/executables/release-publish/publish.sh

@@ -56,44 +56,70 @@ tag="v${version}"
 
 echo "→ release publish: ${tag}"
 
-# Refuse if the tag already exists locally (left over from a prior failed run).
-if git rev-parse --verify "$tag" >/dev/null 2>&1; then
-  fail "release publish: tag ${tag} already exists" 1
+# Recovery is resume-not-overwrite: a release is three steps (push tag, run
+# publishCommand, create GH release) and any of them may already be done from
+# a prior partial run. We probe each step's state and perform only the missing
+# parts. An already-fully-released version is therefore a no-op success, and we
+# never re-point or force an existing tag (that would rewrite a shipped version).
+tag_local=false
+tag_remote=false
+release_exists=false
+if git rev-parse --verify "$tag" >/dev/null 2>&1; then tag_local=true; fi
+if git ls-remote --exit-code --tags origin "refs/tags/$tag" >/dev/null 2>&1; then tag_remote=true; fi
+if gh release view "$tag" >/dev/null 2>&1; then release_exists=true; fi
+
+if [[ "$tag_local" == "true" || "$tag_remote" == "true" || "$release_exists" == "true" ]]; then
+  echo "  resuming: tag exists (local=${tag_local} remote=${tag_remote}), gh-release=${release_exists}"
 fi
 
 if [[ "$dry_run" == "true" ]]; then
-  echo "KODY_REASON=dry-run — would tag + publish ${tag}"
+  echo "KODY_REASON=dry-run — would tag + publish ${tag} (tag_remote=${tag_remote}, gh-release=${release_exists})"
   echo "KODY_SKIP_AGENT=true"
   exit 0
 fi
 
-# Tag + push.
-git tag -a "$tag" -m "Release ${tag}"
-git push origin "$tag"
+# Tag + push (skip whichever half already exists).
+if [[ "$tag_local" == "false" && "$tag_remote" == "false" ]]; then
+  git tag -a "$tag" -m "Release ${tag}"
+fi
+if [[ "$tag_remote" == "false" ]]; then
+  git push origin "$tag"
+fi
 
-# publishCommand (optional). Failure here is recorded but does not abort —
-# we still want the GH release entry so the tag is discoverable.
+# publishCommand (optional). A version that's already on the registry is the
+# expected recovery case, not an error: treat "already published" as done.
+# Any other non-zero is a real failure (recorded, but we still create the GH
+# release so the tag is discoverable).
 publish_status="skipped"
 if [[ -n "$publish_cmd" ]]; then
   cmd="${publish_cmd//\$VERSION/$version}"
   echo "  publish: ${cmd}"
-  if timeout "${timeout_s}" bash -c "$cmd"; then
+  publish_out=""
+  if publish_out=$(timeout "${timeout_s}" bash -c "$cmd" 2>&1); then
     publish_status="ok"
+  elif echo "$publish_out" | grep -qiE "already exists|cannot publish over|previously published|403 Forbidden"; then
+    publish_status="already-published"
+    echo "[kody release-publish] version ${version} already on registry — treating as published"
   else
     publish_status="failed"
     echo "[kody release-publish] publishCommand failed (continuing to create GH release)" >&2
   fi
+  echo "$publish_out"
 fi
 
-# GitHub release.
+# GitHub release (create only if missing).
 release_url=""
-draft_flag=""
-[[ "$draft" == "true" ]] && draft_flag="--draft"
-if release_url=$(gh release create "$tag" --title "$tag" --notes "Release ${tag} — automated by kody." $draft_flag 2>&1); then
-  :
+if [[ "$release_exists" == "true" ]]; then
+  release_url=$(gh release view "$tag" --json url --jq .url 2>/dev/null || echo "")
 else
-  echo "[kody release-publish] gh release create failed: $release_url" >&2
-  release_url=""
+  draft_flag=""
+  [[ "$draft" == "true" ]] && draft_flag="--draft"
+  if release_url=$(gh release create "$tag" --title "$tag" --notes "Release ${tag} — automated by kody." $draft_flag 2>&1); then
+    :
+  else
+    echo "[kody release-publish] gh release create failed: $release_url" >&2
+    release_url=""
+  fi
 fi
 
 echo "RELEASE_TAG=${tag}"
@@ -108,3 +134,4 @@ fi
 [[ -n "$release_url" ]] && echo "KODY_PR_URL=${release_url}"
 echo "KODY_REASON=tagged ${tag}, published${publish_status:+ ($publish_status)}"
 echo "KODY_SKIP_AGENT=true"
+exit 0

package/package.json

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