@kody-ade/kody-engine 0.3.64 → 0.3.67

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.3.64",
+  version: "0.3.67",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -858,7 +858,14 @@ function autoDispatch(opts) {
   if (!executable) {
     executable = isPr ? opts?.config?.defaultPrExecutable ?? "fix" : opts?.config?.defaultExecutable ?? null;
   }
-  if (!executable) return null;
+  if (!executable) {
+    const profileMissing = aliased ? getProfileInputs(aliased) === null : true;
+    process.stderr.write(
+      `[kody] dispatch: no executable resolved for issue_comment (firstToken=${firstToken ?? "<none>"}, aliased=${aliased ?? "<none>"}, profileFound=${!profileMissing}, defaultExecutable=${opts?.config?.defaultExecutable ?? "<unset>"})
+`
+    );
+    return null;
+  }
   const inputs = getProfileInputs(executable);
   const effectiveInputs = inputs ?? [];
   const unknownProfile = inputs === null;
@@ -5891,10 +5898,7 @@ function tryPostPr3(prNumber, body, cwd) {
 function findPreviewDeploymentUrl(prNumber, cwd) {
   const sha = getPrHeadSha(prNumber, cwd);
   if (!sha) return null;
-  const raw = safeGh2(
-    ["api", `repos/{owner}/{repo}/deployments?sha=${sha}&environment=Preview&per_page=10`],
-    cwd
-  );
+  const raw = safeGh2(["api", `repos/{owner}/{repo}/deployments?sha=${sha}&environment=Preview&per_page=10`], cwd);
   if (!raw) return null;
   let deployments;
   try {
@@ -5916,10 +5920,7 @@ function getPrHeadSha(prNumber, cwd) {
   return trimmed.length > 0 ? trimmed : null;
 }
 function latestSuccessUrl(deploymentId, cwd) {
-  const raw = safeGh2(
-    ["api", `repos/{owner}/{repo}/deployments/${deploymentId}/statuses?per_page=10`],
-    cwd
-  );
+  const raw = safeGh2(["api", `repos/{owner}/{repo}/deployments/${deploymentId}/statuses?per_page=10`], cwd);
   if (!raw) return null;
   let statuses;
   try {

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

@@ -54,6 +54,61 @@ read_version() {
 version=$(read_version "$default_branch")
 echo "→ release deploy: v${version}"
 
+# Read the CHANGELOG section for $version from the integration branch
+# (where release-prepare just committed it). Handles both header shapes
+# observed in the wild: `## [0.25.0] - 2026-04-15` and `## 0.22.0 (...)`.
+# Prints the body lines (without the matched header). Empty stdout =
+# fall back to the minimal PR body — never break the release.
+read_changelog_section() {
+  local branch="$1" ver="$2" raw=""
+  if ! raw=$(git show "origin/${branch}:CHANGELOG.md" 2>/dev/null); then
+    return 0
+  fi
+  printf '%s' "$raw" | awk -v ver="$ver" '
+    BEGIN { capture = 0 }
+    # Match all observed header shapes:
+    #   "## [0.25.0] - 2026-04-15"   (bracketed, dash separator)
+    #   "## 0.22.0 (2026-03-25)"     (bare, parenthesized date)
+    #   "## v0.25.5 — 2026-05-05"    (v-prefixed, em-dash, kody release-prepare style)
+    /^##[[:space:]]/ {
+      if (capture) { exit }
+      header = $0
+      sub(/^##[[:space:]]+/, "", header)
+      sub(/^\[/, "", header); sub(/\].*/, "", header)
+      sub(/[[:space:]].*/, "", header)
+      sub(/[(].*/, "", header)
+      sub(/^v/, "", header)
+      if (header == ver) { capture = 1; next }
+    }
+    capture { print }
+  ' | awk '
+    # Trim leading and trailing blank lines from the captured block.
+    NF { if (!started) started = 1; out[++n] = $0; last = n; next }
+    started { out[++n] = $0 }
+    END { for (i = 1; i <= last; i++) print out[i] }
+  '
+}
+
+changelog_section=$(read_changelog_section "$default_branch" "$version" || true)
+if [[ -z "$changelog_section" ]]; then
+  echo "  no CHANGELOG section for v${version} on origin/${default_branch} — using minimal PR body"
+fi
+
+# Build the kody-managed body block. A marker pair lets us update the
+# section idempotently on re-runs without clobbering anything a human
+# pasted outside the markers.
+build_pr_body() {
+  local tracking_line="$1"
+  printf 'Automated deploy PR opened by kody — promotes `%s` to `%s` for release **v%s**.\n\n' \
+    "$default_branch" "$release_branch" "$version"
+  if [[ -n "$changelog_section" ]]; then
+    printf '<!-- kody-changelog-start -->\n## What'\''s changing in v%s\n\n%s\n<!-- kody-changelog-end -->\n\n' \
+      "$version" "$changelog_section"
+  fi
+  printf 'Merge this PR to deploy v%s to `%s`.%s\n' \
+    "$version" "$release_branch" "$tracking_line"
+}
+
 # Single-branch repos: nothing to deploy.
 if [[ -z "$release_branch" || "$release_branch" == "$default_branch" ]]; then
   echo "KODY_REASON=no releaseBranch configured (or equals defaultBranch) — nothing to deploy"
@@ -78,20 +133,25 @@ existing=$(gh pr list --head "$default_branch" --base "$release_branch" --state
 # reuse-existing-PR path.
 issue_arg="${KODY_ARG_ISSUE:-}"
 
+# 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=$(build_pr_body "$tracking_line")
+
 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}"
+  # Refresh the body so re-runs converge on the current changelog. Best-
+  # effort: a failed edit (e.g. permission-denied) shouldn't fail the
+  # release — the PR already exists and its title/branch are unchanged.
+  if ! printf '%s' "$body" | gh pr edit "$pr_url" --body-file - >/dev/null 2>&1; then
+    echo "[kody release-deploy] WARN: failed to refresh deploy PR body" >&2
   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}\`.${tracking_line}"
+else
   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"
@@ -127,9 +187,16 @@ echo "RELEASE_DEPLOY_PR=${pr_url}"
 echo "KODY_PR_URL=${pr_url}"
 
 # Optional post-deploy notification (e.g. Slack ping that a deploy PR is up).
+# Substituted placeholders in the configured command:
+#   $VERSION         — release version (e.g. 0.25.4)
+#   $DEPLOY_PR_URL   — URL of the deploy PR just opened/reused
+# The notifyCommand can use $DEPLOY_PR_URL to pull real content (e.g.
+# `gh pr view $DEPLOY_PR_URL --json body --jq .body`) instead of
+# rendering a hardcoded one-liner.
 notify_status="skipped"
 if [[ -n "$notify_cmd" ]]; then
   cmd="${notify_cmd//\$VERSION/$version}"
+  cmd="${cmd//\$DEPLOY_PR_URL/$pr_url}"
   echo "  notify: ${cmd}"
   if timeout "${timeout_s}" bash -c "$cmd"; then
     notify_status="ok"

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

@@ -106,11 +106,22 @@ PY
 
 generate_changelog() {
   local new_version="$1"
-  local last_tag
-  if last_tag=$(git describe --tags --abbrev=0 --match 'v*' 2>/dev/null); then
-    range="${last_tag}..HEAD"
-    git log "$range" --pretty=format:'%s||%h' --no-merges 2>/dev/null || true
+  local last_tag count
+  # actions/checkout@v4 with fetch-depth: 0 still does NOT fetch tags by
+  # default — operators have to opt in via `fetch-tags: true`. When tags
+  # are absent, `git describe` returns empty and the else-branch's
+  # 100-commit window can over- or under-shoot. Try once to backfill
+  # tags before describing, ignoring failures (offline/sandbox runs).
+  if ! last_tag=$(git describe --tags --abbrev=0 --match 'v*' 2>/dev/null); then
+    git fetch --tags --quiet 2>/dev/null || true
+    last_tag=$(git describe --tags --abbrev=0 --match 'v*' 2>/dev/null || true)
+  fi
+  if [[ -n "$last_tag" ]]; then
+    count=$(git rev-list --count "${last_tag}..HEAD" --no-merges 2>/dev/null || echo "?")
+    echo "  changelog: ${count} commits since ${last_tag}" >&2
+    git log "${last_tag}..HEAD" --pretty=format:'%s||%h' --no-merges 2>/dev/null || true
   else
+    echo "  changelog: no previous v* tag found — using last 100 commits" >&2
     git log -n100 HEAD --pretty=format:'%s||%h' --no-merges 2>/dev/null || true
   fi
 }

package/dist/executables/run/prompt.md

@@ -27,6 +27,7 @@ If a prior-art block is present above, READ THE DIFFS — those are failed or su
    - Read the tests for each of those files, if tests exist for the module.
    - Read at least one sibling module that already implements the same pattern you're about to follow — your edits should mirror an existing convention unless you can name why a new one is needed.
    - If your change requires writing or modifying a test, also check for repo-level testing guidance: `tests/README.md`, `TESTING.md`, or a "Testing"/"Tests" section in `AGENTS.md`/`CLAUDE.md`. If one exists, treat its patterns (auth setup, fixture creation, what NOT to do) as authoritative — they override anything you might infer from grepping individual files.
+   - **Removal/rename refactors** (deleting a call like `console.error`, renaming a function, dropping a method, replacing one API with another): before editing, grep the test directories for assertions tied to the OLD symbol — spies (`vi.spyOn(console`, `jest.spyOn(console`, `consoleErrorSpy`, `mockFn.mock.calls`), the literal function name, and any string the call produced. Enumerate every hit in your plan (step 2) and update those tests in step 4 in the same session. Skipping this grep is a hard failure even if your local test runs pass — the wrapper runs the full suite and you cannot fix breakages after DONE.
    - If a file you need to read does not exist, say so explicitly in your plan (step 2). Do not guess at its contents.
 2. **Plan** — before any Edit/Write, output a short plan (5–10 lines): what files you'll change, the approach, what could go wrong. No fluff.
 3. **Build** — Edit/Write to implement the change. Stay within the plan; if you discover the plan was wrong, briefly say so and adjust.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.3.64",
+  "version": "0.3.67",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,6 +12,18 @@
     "templates",
     "kody.config.schema.json"
   ],
+  "scripts": {
+    "kody": "tsx bin/kody.ts",
+    "build": "tsup && node scripts/copy-assets.cjs",
+    "test": "vitest run tests/unit tests/int --no-coverage",
+    "test:e2e": "vitest run tests/e2e --no-coverage",
+    "test:all": "vitest run tests --no-coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "format": "biome format --write",
+    "prepublishOnly": "pnpm build"
+  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119"
@@ -32,16 +44,5 @@
     "url": "git+https://github.com/aharonyaircohen/kody-engine.git"
   },
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
-  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues",
-  "scripts": {
-    "kody": "tsx bin/kody.ts",
-    "build": "tsup && node scripts/copy-assets.cjs",
-    "test": "vitest run tests/unit tests/int --no-coverage",
-    "test:e2e": "vitest run tests/e2e --no-coverage",
-    "test:all": "vitest run tests --no-coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check",
-    "lint:fix": "biome check --write",
-    "format": "biome format --write"
-  }
-}
+  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
+}