@kody-ade/kody-engine 0.3.29 → 0.3.32

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.3.29",
+  version: "0.3.32",
   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";
 
@@ -2580,6 +2580,19 @@ var dispatch = async (ctx, _profile, _agentResult, args) => {
     return;
   }
   const state = ctx.data.taskState;
+  if (target === "pr" && !state?.core.prUrl) {
+    const reason = `cannot dispatch @kody ${next}: target=pr but state.core.prUrl is not set`;
+    process.stderr.write(`[kody dispatch] ${reason}
+`);
+    const action = {
+      type: "AGENT_NOT_RUN",
+      payload: { reason, dispatchTarget: "pr", next },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    ctx.data.action = action;
+    if (state) state.core.lastOutcome = action;
+    return;
+  }
   if (state?.flow) {
     state.flow.step = next;
   }
@@ -2880,11 +2893,15 @@ function firstLine(s) {
 }
 function findExistingPr(branch, cwd) {
   try {
-    const output = gh2(["pr", "view", branch, "--json", "number,url,body"], { cwd });
-    const parsed = JSON.parse(output);
-    if (typeof parsed?.number === "number" && typeof parsed?.url === "string") {
-      const body = typeof parsed.body === "string" ? parsed.body : "";
-      return { number: parsed.number, url: parsed.url, body };
+    const output = gh2(
+      ["pr", "list", "--head", branch, "--state", "open", "--json", "number,url,body", "--limit", "1"],
+      { cwd }
+    );
+    const arr = JSON.parse(output);
+    const first = Array.isArray(arr) ? arr[0] : null;
+    if (first && typeof first.number === "number" && typeof first.url === "string") {
+      const body = typeof first.body === "string" ? first.body : "";
+      return { number: first.number, url: first.url, body };
     }
     return null;
   } catch {
@@ -5128,6 +5145,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;
@@ -5319,7 +5465,8 @@ var postflightScripts = {
   postClassification,
   notifyTerminal,
   recordOutcome,
-  mergeReleasePr
+  mergeReleasePr,
+  waitForCi
 };
 var allScriptNames = /* @__PURE__ */ new Set([
   ...Object.keys(preflightScripts),
@@ -5327,7 +5474,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));
@@ -5360,7 +5507,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;
@@ -5767,7 +5914,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" }
@@ -5780,7 +5927,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;
@@ -5814,7 +5961,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 {
@@ -5824,16 +5971,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"
     });
@@ -6015,9 +6162,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/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,13 +74,24 @@ 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"
 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.
+  tracking_line=""
+  if [[ "$issue_arg" =~ ^[0-9]+$ && "$issue_arg" != "0" ]]; then
+    tracking_line=$'\n\nTracking-Issue: #'"${issue_arg}"
+  fi
   body="Automated deploy PR opened by kody — promotes \`${default_branch}\` to \`${release_branch}\` for release **v${version}**.
 
-Merge this PR to deploy v${version} to \`${release_branch}\`."
+Merge this PR to deploy v${version} to \`${release_branch}\`.${tracking_line}"
   if ! pr_url=$(printf '%s' "$body" | gh pr create --head "$default_branch" --base "$release_branch" --title "deploy: ${default_branch} → ${release_branch} (v${version})" --body-file -); then
     echo "KODY_REASON=release deploy: gh pr create failed"
     echo "KODY_SKIP_AGENT=true"
@@ -94,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

@@ -313,7 +313,19 @@ _… truncated; see CHANGELOG.md_"
   else
     body_entry="$entry"
   fi
-  body=$'Automated release PR opened by kody.\n\n'"$body_entry"$'\n\nThe release orchestrator will merge this into `'"${default_branch}"$'` and continue to publish + deploy.'
+  # Link the PR back to the originating release issue WITHOUT auto-closing
+  # it. The orchestrator continues to publish + deploy after merge using the
+  # issue as the dispatch target, so the issue must stay open for the
+  # dashboard to keep showing the task as in-progress until finishFlow
+  # applies kody:done. We use `Tracking-Issue: #N` (not `Closes #N`) — GitHub
+  # treats this as plain text, the dashboard parses it as a fallback link
+  # signal, and no auto-close fires on PR merge.
+  issue_arg="${KODY_ARG_ISSUE:-}"
+  tracking_line=""
+  if [[ "$issue_arg" =~ ^[0-9]+$ && "$issue_arg" != "0" ]]; then
+    tracking_line=$'\n\nTracking-Issue: #'"${issue_arg}"
+  fi
+  body=$'Automated release PR opened by kody.\n\n'"$body_entry"$'\n\nThe release orchestrator will merge this into `'"${default_branch}"$'` and continue to publish + deploy.'"${tracking_line}"
   pr_url=$(printf '%s' "$body" | gh pr create --head "$release_branch" --base "$default_branch" --title "chore: release ${tag}" --body-file -)
 fi
 
@@ -321,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/research/prompt.md

@@ -57,17 +57,8 @@ documented in `AGENTS.md` / `CLAUDE.md` — reference those files by path
 cite it; don't copy it.
 
 ## Clarifying questions
-Numbered list. Each question must include a one-line "Why:" naming the
-concrete implementation decision the answer would unblock — not "why it
-matters" in general, but which fork in the road it picks.
-
-Default to asking. Only skip this section when every entry in
-"Gaps & assumptions" is genuinely safe to proceed on without confirmation;
-if you skip, justify it in one line under the heading. Prefer a few sharp
-questions over many soft ones — a question that wouldn't change the
-implementation is noise. Address the questions to the issue author / a
-human reviewer; they'll be answered in a follow-up comment and picked up
-on the next research run via delta mode.
+Numbered list. Each question must include a one-line "Why:" explaining why
+the answer changes the implementation. Skip if there are genuinely none.
 
 ## Gaps & assumptions
 What is unknown, and — for each gap — what assumption the implementer would

package/package.json

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