@kody-ade/kody-engine 0.4.20 → 0.4.21

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.20",
+  version: "0.4.21",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",

package/dist/executables/goal-tick/tick.sh

@@ -335,6 +335,16 @@ ensure_label "$failed_label" "b60205" "kody goal-runner: task failed; needs huma
 # counting child tasks, so list_goal_issues can filter it out cleanly.
 ensure_goal_issue
 
+# Open the draft goal PR if the goal branch already exists. Must run BEFORE
+# any of the early exits below (in_flight check, no-undispatched-task idle,
+# etc.) — otherwise active goals that always have a task in flight would
+# never get past the in_flight gate to reach the late call site, leaving
+# the umbrella row without its branch + preview anchor in the dashboard.
+# `ensure_goal_pr` is a safe no-op when the branch hasn't been created yet
+# (the lazy-branch-creation block at the dispatch site handles that case;
+# the next tick picks up the PR creation here).
+ensure_goal_pr
+
 # Merge ready goal-task PRs into the goal branch. We own the merge here
 # instead of relying on GitHub's `--auto` flag (which requires the repo's
 # "Allow auto-merge" setting and silently no-ops when disabled). Only merge
@@ -543,11 +553,8 @@ else
     fi
   fi
 fi
-
-# Open the draft goal PR now that the branch exists. The PR is the dashboard's
-# single anchor for the goal's branch + preview + CI; finalize promotes it
-# from draft to ready-for-review when every task has closed.
-ensure_goal_pr
+# (`ensure_goal_pr` runs at the top of the active path so it's reached even
+# when this tick exits early via the in_flight gate; not duplicated here.)
 
 echo "[goal-tick] dispatching @kody on task #$next_issue (--base $goal_branch)"
 gh issue comment "$next_issue" --body "@kody --base ${goal_branch}"

package/dist/jobs/watch-stale-prs.md

@@ -1,8 +1,16 @@
+---
+every: 7d
+---
+
 # watch-stale-prs
 
 > Weekly digest of open PRs that haven't been touched in a while. Writes a
 > markdown report at `.kody/reports/watch-stale-prs.md` (surfaced by the
 > dashboard's `/reports` page).
+>
+> Cadence is enforced by the engine via the `every: 7d` frontmatter — this
+> file only fires once per 7 days regardless of how often `job-scheduler`
+> wakes. No prose cadence guard needed.
 
 ## Job
 
@@ -10,10 +18,6 @@ Find every open PR untouched for **≥ 7 days** and write a report listing
 them, sorted by staleness (oldest first). When there are no stale PRs,
 write a short "all clear" report so operators know the check ran.
 
-**Cadence guard.** Skip this tick unless `data.lastRunAt` is null or older
-than 7 days from now. When skipping, emit the same state back unchanged
-with no `gh` calls.
-
 ### What "stale" means
 
 A PR is stale if:
@@ -71,16 +75,15 @@ Truncate to the 50 oldest if the list is longer; append a final line
 
 ## State
 
-`cursor`:
-
-- `"idle"` — between runs (cadence guard skipped this tick or the run
-  finished cleanly).
+`cursor`: always `"idle"` — this job has no phases; each fire is a
+one-shot report write.
 
 `data`:
 
-- `lastRunAt` (string, ISO) — when the report was last written. Used by
-  the cadence guard.
 - `lastStaleCount` (number) — how many stale PRs were in the most recent
-  report. Diagnostic only.
+  report. Diagnostic only; the engine ignores it.
+
+(Engine-managed fields like `lastFiredAt` live under `data` automatically;
+do not write or rely on them from the prompt.)
 
 `done`: always `false` — this job is evergreen.

package/package.json

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