@kody-ade/kody-engine 0.3.28 → 0.3.31

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.3.28",
+  version: "0.3.31",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -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 {
@@ -3625,6 +3642,7 @@ jobs:
       issues: write
       pull-requests: write
       contents: write
+      actions: read
     steps:
       - uses: actions/checkout@v4
         with:

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

@@ -78,9 +78,17 @@ 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.
+  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 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"

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
 

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.28",
+  "version": "0.3.31",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",

package/templates/kody.yml

@@ -60,6 +60,7 @@ jobs:
       issues: write
       pull-requests: write
       contents: write
+      actions: read
     steps:
       - uses: actions/checkout@v4
         with: