@kody-ade/kody-engine 0.3.31 → 0.3.33

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.3.31",
+  version: "0.3.33",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -50,7 +50,7 @@ var package_default = {
 };
 
 // src/chat-cli.ts
-import { execFileSync as execFileSync22 } from "child_process";
+import { execFileSync as execFileSync23 } from "child_process";
 import * as fs22 from "fs";
 import * as path19 from "path";
 
@@ -577,7 +577,7 @@ async function emit(sink, type, sessionId, suffix, payload) {
 }
 
 // src/kody-cli.ts
-import { execFileSync as execFileSync21 } from "child_process";
+import { execFileSync as execFileSync22 } from "child_process";
 import * as fs21 from "fs";
 import * as path18 from "path";
 
@@ -4967,8 +4967,8 @@ function postKodyComment(target, issueNumber, state, next, cwd) {
 
 // src/scripts/syncFlow.ts
 import { execFileSync as execFileSync19 } from "child_process";
-var syncFlow = async (ctx) => {
-  ctx.skipAgent = true;
+var syncFlow = async (ctx, _profile, args) => {
+  const announceOnSuccess = Boolean(args?.announceOnSuccess);
   const prNumber = ctx.args.pr;
   const pr = getPr(prNumber, ctx.cwd);
   if (pr.state !== "OPEN") {
@@ -4976,8 +4976,10 @@ var syncFlow = async (ctx) => {
     return;
   }
   ctx.data.pr = pr;
-  ctx.data.commentTargetType = "pr";
-  ctx.data.commentTargetNumber = prNumber;
+  if (announceOnSuccess) {
+    ctx.data.commentTargetType = "pr";
+    ctx.data.commentTargetNumber = prNumber;
+  }
   checkoutPrBranch(prNumber, ctx.cwd);
   ctx.data.branch = getCurrentBranch(ctx.cwd);
   const baseBranch = pr.baseRefName || ctx.config.git.defaultBranch;
@@ -4998,9 +5000,12 @@ var syncFlow = async (ctx) => {
   }
   const headAfter = revParseHead(ctx.cwd);
   if (headAfter === headBefore) {
-    ctx.output.exitCode = 0;
-    ctx.output.reason = `already up to date with origin/${baseBranch}`;
-    tryPostPr5(prNumber, `\u2139\uFE0F kody sync: already up to date with origin/${baseBranch}`, ctx.cwd);
+    ctx.data.syncResult = "noop";
+    if (announceOnSuccess) {
+      ctx.output.exitCode = 0;
+      ctx.output.reason = `already up to date with origin/${baseBranch}`;
+      tryPostPr5(prNumber, `\u2139\uFE0F kody sync: already up to date with origin/${baseBranch}`, ctx.cwd);
+    }
     return;
   }
   try {
@@ -5010,13 +5015,21 @@ var syncFlow = async (ctx) => {
     bail2(ctx, prNumber, `merge succeeded but push failed: ${msg}`);
     return;
   }
-  ctx.output.exitCode = 0;
-  ctx.output.reason = `merged origin/${baseBranch} into ${ctx.data.branch}`;
-  const runUrl = getRunUrl();
-  const runSuffix = runUrl ? ` ([logs](${runUrl}))` : "";
-  tryPostPr5(prNumber, `\u2705 kody sync: merged \`origin/${baseBranch}\` into \`${ctx.data.branch}\`${runSuffix}`, ctx.cwd);
+  ctx.data.syncResult = "merged";
+  if (announceOnSuccess) {
+    ctx.output.exitCode = 0;
+    ctx.output.reason = `merged origin/${baseBranch} into ${ctx.data.branch}`;
+    const runUrl = getRunUrl();
+    const runSuffix = runUrl ? ` ([logs](${runUrl}))` : "";
+    tryPostPr5(
+      prNumber,
+      `\u2705 kody sync: merged \`origin/${baseBranch}\` into \`${ctx.data.branch}\`${runSuffix}`,
+      ctx.cwd
+    );
+  }
 };
 function bail2(ctx, prNumber, reason) {
+  ctx.skipAgent = true;
   ctx.output.exitCode = 1;
   ctx.output.reason = reason;
   const runUrl = getRunUrl();
@@ -5145,6 +5158,135 @@ var verify = async (ctx) => {
   }
 };
 
+// src/scripts/waitForCi.ts
+import { execFileSync as execFileSync20 } from "child_process";
+var API_TIMEOUT_MS9 = 3e4;
+var waitForCi = async (ctx, _profile, _agentResult, args) => {
+  const timeoutMinutes = numArg(args, "timeoutMinutes", 30);
+  const pollSeconds = numArg(args, "pollSeconds", 30);
+  const initialWaitSeconds = numArg(args, "initialWaitSeconds", 15);
+  const maxFixCiAttempts = numArg(args, "maxFixCiAttempts", 3);
+  const state = ctx.data.taskState;
+  const prUrl = state?.core.prUrl;
+  const prNumber = prUrl ? parsePrNumber(prUrl) : null;
+  if (!prNumber) {
+    ctx.data.action = mkAction("CI_GIVEUP", { reason: "no PR url in state \u2014 nothing to wait for" });
+    return;
+  }
+  const fixCiAttempts = state?.core.attempts?.["fix-ci"] ?? 0;
+  await sleep(initialWaitSeconds * 1e3);
+  const deadline = Date.now() + timeoutMinutes * 6e4;
+  let lastSummary = "";
+  while (Date.now() < deadline) {
+    const rows = fetchChecks(prNumber, ctx.cwd);
+    if (rows === null) {
+      await sleep(pollSeconds * 1e3);
+      continue;
+    }
+    if (rows.length === 0) {
+      await sleep(pollSeconds * 1e3);
+      continue;
+    }
+    const summary = summarize(rows);
+    if (summary !== lastSummary) {
+      lastSummary = summary;
+      tryPostPr6(prNumber, `\u23F3 kody waitForCi: ${summary}`, ctx.cwd);
+    }
+    const failed = rows.filter((r) => r.bucket === "fail" || r.bucket === "cancel");
+    const pending = rows.filter((r) => r.bucket === "pending");
+    if (failed.length > 0) {
+      const detail = failed.slice(0, 5).map((r) => `${r.workflow ?? "?"} / ${r.name ?? "?"}${r.link ? ` (${r.link})` : ""}`).join("; ");
+      if (fixCiAttempts >= maxFixCiAttempts) {
+        ctx.data.action = mkAction("CI_GIVEUP", {
+          reason: `fix-ci attempts (${fixCiAttempts}) hit cap (${maxFixCiAttempts})`,
+          failedChecks: detail,
+          prUrl
+        });
+        tryPostPr6(
+          prNumber,
+          `\u{1F6D1} kody waitForCi: giving up after ${fixCiAttempts} fix-ci attempts. Failed: ${detail}`,
+          ctx.cwd
+        );
+      } else {
+        ctx.data.action = mkAction("CI_FAILED", {
+          failedChecks: detail,
+          attempt: fixCiAttempts + 1,
+          maxAttempts: maxFixCiAttempts,
+          prUrl
+        });
+        tryPostPr6(
+          prNumber,
+          `\u274C kody waitForCi: CI failed (attempt ${fixCiAttempts + 1}/${maxFixCiAttempts}). Dispatching fix-ci. Failed: ${detail}`,
+          ctx.cwd
+        );
+      }
+      return;
+    }
+    if (pending.length === 0) {
+      ctx.data.action = mkAction("CI_PASSED", { checks: rows.length, prUrl });
+      tryPostPr6(prNumber, `\u2705 kody waitForCi: all ${rows.length} checks green on PR #${prNumber}`, ctx.cwd);
+      return;
+    }
+    await sleep(pollSeconds * 1e3);
+  }
+  ctx.data.action = mkAction("CI_TIMEOUT", {
+    reason: `CI did not complete within ${timeoutMinutes} minutes`,
+    prUrl
+  });
+  tryPostPr6(prNumber, `\u231B kody waitForCi: timed out after ${timeoutMinutes} minutes`, ctx.cwd);
+};
+function fetchChecks(prNumber, cwd) {
+  try {
+    const raw = execFileSync20(
+      "gh",
+      ["pr", "checks", String(prNumber), "--json", "bucket,state,name,workflow,link"],
+      {
+        encoding: "utf-8",
+        timeout: API_TIMEOUT_MS9,
+        cwd,
+        stdio: ["ignore", "pipe", "pipe"]
+      }
+    );
+    const parsed = JSON.parse(raw);
+    return Array.isArray(parsed) ? parsed : [];
+  } catch (err) {
+    process.stderr.write(
+      `[kody waitForCi] gh pr checks #${prNumber} failed: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+    return null;
+  }
+}
+function summarize(rows) {
+  const counts = {};
+  for (const r of rows) {
+    const k = r.bucket ?? "unknown";
+    counts[k] = (counts[k] ?? 0) + 1;
+  }
+  return Object.entries(counts).map(([k, v]) => `${k}:${v}`).join(" ");
+}
+function mkAction(type, payload) {
+  return { type, payload, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
+}
+function numArg(args, key, fallback) {
+  const v = args?.[key];
+  if (typeof v === "number" && Number.isFinite(v) && v >= 0) return v;
+  if (typeof v === "string") {
+    const n = Number(v);
+    if (Number.isFinite(n) && n >= 0) return n;
+  }
+  return fallback;
+}
+function tryPostPr6(prNumber, body, cwd) {
+  try {
+    postPrReviewComment(prNumber, body, cwd);
+  } catch {
+  }
+}
+function sleep(ms) {
+  return new Promise((res) => setTimeout(res, ms));
+}
+
 // src/scripts/watchStalePrsFlow.ts
 function readWatchConfig(ctx) {
   const cfg = ctx.config.watch;
@@ -5336,7 +5478,8 @@ var postflightScripts = {
   postClassification,
   notifyTerminal,
   recordOutcome,
-  mergeReleasePr
+  mergeReleasePr,
+  waitForCi
 };
 var allScriptNames = /* @__PURE__ */ new Set([
   ...Object.keys(preflightScripts),
@@ -5344,7 +5487,7 @@ var allScriptNames = /* @__PURE__ */ new Set([
 ]);
 
 // src/tools.ts
-import { execFileSync as execFileSync20 } from "child_process";
+import { execFileSync as execFileSync21 } from "child_process";
 function verifyCliTools(tools, cwd) {
   const out = [];
   for (const t of tools) out.push(verifyOne(t, cwd));
@@ -5377,7 +5520,7 @@ function verifyOne(tool, cwd) {
 }
 function runShell(cmd, cwd, timeoutMs = 3e4) {
   try {
-    execFileSync20("sh", ["-c", cmd], { cwd, stdio: "pipe", timeout: timeoutMs });
+    execFileSync21("sh", ["-c", cmd], { cwd, stdio: "pipe", timeout: timeoutMs });
     return true;
   } catch {
     return false;
@@ -5784,7 +5927,7 @@ function detectPackageManager2(cwd) {
 }
 function shellOut(cmd, args, cwd, stream = true) {
   try {
-    execFileSync21(cmd, args, {
+    execFileSync22(cmd, args, {
       cwd,
       stdio: stream ? "inherit" : "pipe",
       env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1", CI: process.env.CI ?? "1" }
@@ -5797,7 +5940,7 @@ function shellOut(cmd, args, cwd, stream = true) {
 }
 function isOnPath(bin) {
   try {
-    execFileSync21("which", [bin], { stdio: "pipe" });
+    execFileSync22("which", [bin], { stdio: "pipe" });
     return true;
   } catch {
     return false;
@@ -5831,7 +5974,7 @@ function installLitellmIfNeeded(cwd) {
   } catch {
   }
   try {
-    execFileSync21("python3", ["-c", "import litellm"], { stdio: "pipe" });
+    execFileSync22("python3", ["-c", "import litellm"], { stdio: "pipe" });
     process.stdout.write("\u2192 kody: litellm already installed\n");
     return 0;
   } catch {
@@ -5841,16 +5984,16 @@ function installLitellmIfNeeded(cwd) {
 }
 function configureGitIdentity(cwd) {
   try {
-    const name = execFileSync21("git", ["config", "user.name"], { cwd, stdio: "pipe", encoding: "utf-8" }).trim();
+    const name = execFileSync22("git", ["config", "user.name"], { cwd, stdio: "pipe", encoding: "utf-8" }).trim();
     if (name) return;
   } catch {
   }
   try {
-    execFileSync21("git", ["config", "user.name", "github-actions[bot]"], { cwd, stdio: "pipe" });
+    execFileSync22("git", ["config", "user.name", "github-actions[bot]"], { cwd, stdio: "pipe" });
   } catch {
   }
   try {
-    execFileSync21("git", ["config", "user.email", "41898282+github-actions[bot]@users.noreply.github.com"], {
+    execFileSync22("git", ["config", "user.email", "41898282+github-actions[bot]@users.noreply.github.com"], {
       cwd,
       stdio: "pipe"
     });
@@ -6032,9 +6175,9 @@ function commitChatFiles(cwd, sessionId, verbose) {
   if (paths.length === 0) return;
   const opts = { cwd, stdio: verbose ? "inherit" : "pipe" };
   try {
-    execFileSync22("git", ["add", ...paths], opts);
-    execFileSync22("git", ["commit", "--quiet", "-m", `chat: reply for ${sessionId}`], opts);
-    execFileSync22("git", ["push", "--quiet", "origin", "HEAD"], opts);
+    execFileSync23("git", ["add", ...paths], opts);
+    execFileSync23("git", ["commit", "--quiet", "-m", `chat: reply for ${sessionId}`], opts);
+    execFileSync23("git", ["push", "--quiet", "origin", "HEAD"], opts);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     process.stderr.write(`[kody:chat] commit/push skipped: ${msg}

package/dist/executables/fix/profile.json

@@ -60,6 +60,7 @@
   ],
   "scripts": {
     "preflight": [
+      { "script": "syncFlow" },
       {
         "script": "setLifecycleLabel",
         "with": {

package/dist/executables/fix-ci/profile.json

@@ -41,6 +41,7 @@
   "cliTools": [],
   "scripts": {
     "preflight": [
+      { "script": "syncFlow" },
       {
         "script": "setLifecycleLabel",
         "with": {

package/dist/executables/release/profile.json

@@ -62,13 +62,24 @@
       { "script": "dispatch", "with": { "next": "release-deploy", "target": "issue" },
         "runWhen": { "data.taskState.core.lastOutcome.type": "RELEASE_PUBLISH_COMPLETED" } },
 
+      { "script": "waitForCi",
+        "with": { "timeoutMinutes": 30, "pollSeconds": 30, "initialWaitSeconds": 15, "maxFixCiAttempts": 3 },
+        "runWhen": { "data.taskState.core.lastOutcome.type": ["RELEASE_DEPLOY_COMPLETED", "FIX_CI_COMPLETED"] } },
+
+      { "script": "dispatch", "with": { "next": "fix-ci", "target": "pr" },
+        "runWhen": { "data.action.type": "CI_FAILED" } },
+
       { "script": "finishFlow",
         "with": { "reason": "release-completed", "label": "kody:done", "color": "0e8a16", "description": "kody: release complete" },
-        "runWhen": { "data.taskState.core.lastOutcome.type": "RELEASE_DEPLOY_COMPLETED" } },
+        "runWhen": { "data.action.type": "CI_PASSED" } },
+
+      { "script": "finishFlow",
+        "with": { "reason": "release-failed", "label": "kody:failed", "color": "e11d21", "description": "kody: release flow failed" },
+        "runWhen": { "data.action.type": ["CI_GIVEUP", "CI_TIMEOUT"] } },
 
       { "script": "finishFlow",
         "with": { "reason": "release-failed", "label": "kody:failed", "color": "e11d21", "description": "kody: release flow failed" },
-        "runWhen": { "data.taskState.core.lastOutcome.type": ["RELEASE_PREPARE_FAILED", "RELEASE_MERGE_FAILED", "RELEASE_PUBLISH_FAILED", "RELEASE_DEPLOY_FAILED"] } },
+        "runWhen": { "data.taskState.core.lastOutcome.type": ["RELEASE_PREPARE_FAILED", "RELEASE_MERGE_FAILED", "RELEASE_PUBLISH_FAILED", "RELEASE_DEPLOY_FAILED", "FIX_CI_FAILED"] } },
 
       { "script": "persistFlowState" }
     ]

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

@@ -74,6 +74,10 @@ existing=$(gh pr list --head "$default_branch" --base "$release_branch" --state
   | python3 -c 'import json,sys; data=json.load(sys.stdin); print(data[0]["url"] if data else "")' 2>/dev/null \
   || echo "")
 
+# Hoisted so the kody-release-pr marker write below also runs in the
+# reuse-existing-PR path.
+issue_arg="${KODY_ARG_ISSUE:-}"
+
 if [[ -n "$existing" ]]; then
   echo "  reusing existing deploy PR: ${existing}"
   pr_url="$existing"
@@ -81,7 +85,6 @@ else
   # Same Tracking-Issue marker as release-prepare — non-closing reference
   # so the originating release issue stays open through the deploy step
   # while the Kody Dashboard can still link this PR to the task for preview.
-  issue_arg="${KODY_ARG_ISSUE:-}"
   tracking_line=""
   if [[ "$issue_arg" =~ ^[0-9]+$ && "$issue_arg" != "0" ]]; then
     tracking_line=$'\n\nTracking-Issue: #'"${issue_arg}"
@@ -102,6 +105,24 @@ if [[ -z "$pr_url" ]]; then
   exit 1
 fi
 
+# Persist the deploy-PR marker on the originating issue body. Mirrors the
+# release-prepare path — the issue body is owned by the orchestrator, so
+# this signal survives any @kody fix that overwrites the PR body. The
+# marker replaces the prepare-PR ref so the dashboard pivots to the deploy
+# PR (the now-current task) automatically.
+if [[ "${issue_arg:-}" =~ ^[0-9]+$ && "${issue_arg:-0}" != "0" ]]; then
+  pr_number="${pr_url##*/}"
+  if [[ "$pr_number" =~ ^[0-9]+$ ]]; then
+    cur_body=$(gh issue view "$issue_arg" --json body -q .body 2>/dev/null || echo "")
+    cleaned_body=$(printf '%s' "$cur_body" | sed -E '/<!-- kody-release-pr:[^>]*-->/d')
+    {
+      printf '%s' "$cleaned_body"
+      printf '\n\n<!-- kody-release-pr: #%s -->\n' "$pr_number"
+    } | gh issue edit "$issue_arg" --body-file - >/dev/null 2>&1 || \
+      echo "[kody release-deploy] WARN: failed to write kody-release-pr marker to issue #${issue_arg}"
+  fi
+fi
+
 echo "RELEASE_DEPLOY_PR=${pr_url}"
 echo "KODY_PR_URL=${pr_url}"
 

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

@@ -333,6 +333,24 @@ if [[ -z "$pr_url" ]]; then
   fail "release prepare: gh pr create returned empty URL" 4
 fi
 
+# Persist a release-PR marker on the originating issue body so the Kody
+# Dashboard can link the issue → PR even if @kody fix later overwrites the
+# PR body. Idempotent: any existing marker line is stripped before append,
+# so re-runs replace the previous PR ref. The issue body is owned by the
+# orchestrator (no @kody fix touches it), so this signal is durable.
+if [[ "${issue_arg:-}" =~ ^[0-9]+$ && "${issue_arg:-0}" != "0" ]]; then
+  pr_number="${pr_url##*/}"
+  if [[ "$pr_number" =~ ^[0-9]+$ ]]; then
+    cur_body=$(gh issue view "$issue_arg" --json body -q .body 2>/dev/null || echo "")
+    cleaned_body=$(printf '%s' "$cur_body" | sed -E '/<!-- kody-release-pr:[^>]*-->/d')
+    {
+      printf '%s' "$cleaned_body"
+      printf '\n\n<!-- kody-release-pr: #%s -->\n' "$pr_number"
+    } | gh issue edit "$issue_arg" --body-file - >/dev/null 2>&1 || \
+      echo "[kody release-prepare] WARN: failed to write kody-release-pr marker to issue #${issue_arg}"
+  fi
+fi
+
 echo "RELEASE_PR=${pr_url}"
 echo "KODY_PR_URL=${pr_url}"
 echo "KODY_REASON=opened release PR for ${tag}"

package/dist/executables/sync/profile.json

@@ -36,7 +36,11 @@
         }
       },
       {
-        "script": "syncFlow"
+        "script": "syncFlow",
+        "with": { "announceOnSuccess": true }
+      },
+      {
+        "script": "skipAgent"
       }
     ],
     "postflight": []

package/package.json

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