@kody-ade/kody-engine 0.4.20 → 0.4.23

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.23",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -1002,32 +1002,6 @@ function getExecutablesRoot() {
 function getProjectExecutablesRoot() {
   return path6.join(process.cwd(), ".kody", "executables");
 }
-function getBuiltinJobsRoot() {
-  const here = path6.dirname(new URL(import.meta.url).pathname);
-  const candidates = [
-    path6.join(here, "jobs"),
-    // dev: src/
-    path6.join(here, "..", "jobs"),
-    // built: dist/bin → dist/jobs
-    path6.join(here, "..", "src", "jobs")
-    // fallback
-  ];
-  for (const c of candidates) {
-    if (fs6.existsSync(c) && fs6.statSync(c).isDirectory()) return c;
-  }
-  return candidates[0];
-}
-function listBuiltinJobs(root = getBuiltinJobsRoot()) {
-  if (!fs6.existsSync(root) || !fs6.statSync(root).isDirectory()) return [];
-  const out = [];
-  for (const ent of fs6.readdirSync(root, { withFileTypes: true })) {
-    if (!ent.isFile() || !ent.name.endsWith(".md")) continue;
-    const slug = ent.name.slice(0, -3);
-    out.push({ slug, filePath: path6.join(root, ent.name) });
-  }
-  out.sort((a, b) => a.slug.localeCompare(b.slug));
-  return out;
-}
 function getExecutableRoots() {
   return [getProjectExecutablesRoot(), getExecutablesRoot()];
 }
@@ -1585,11 +1559,17 @@ function parseScripts(p, raw) {
     throw new ProfileError(p, `"scripts" must be an object with preflight and postflight arrays`);
   }
   const r = raw;
+  const preflight = parseScriptList(p, "preflight", r.preflight);
+  const postflight = parseScriptList(p, "postflight", r.postflight);
   return {
-    preflight: parseScriptList(p, "preflight", r.preflight),
-    postflight: parseScriptList(p, "postflight", r.postflight)
+    preflight,
+    postflight: pairLifecycleClears(preflight, postflight)
   };
 }
+function pairLifecycleClears(preflight, postflight) {
+  const clears = preflight.filter((e) => e.script === "setLifecycleLabel" && typeof e.with?.label === "string").map((e) => ({ script: "clearLifecycleLabel", with: { label: e.with.label } }));
+  return [...postflight, ...clears];
+}
 function parseInputArtifacts(p, raw) {
   if (raw === void 0 || raw === null) return [];
   if (typeof raw !== "object" || Array.isArray(raw)) {
@@ -2490,148 +2470,6 @@ function defaultLabelMap() {
   };
 }
 
-// src/scripts/commitAndPush.ts
-var DEFAULT_COMMIT_MESSAGE = "chore: kody changes";
-var commitAndPush2 = async (ctx) => {
-  const branch = ctx.data.branch;
-  if (!branch) {
-    ctx.data.commitResult = { committed: false, pushed: false };
-    return;
-  }
-  if (ctx.data.agentDone === false) {
-    ctx.data.commitResult = { committed: false, pushed: false, skippedReason: "agentDone=false" };
-    ctx.data.hasCommitsAhead = hasCommitsAhead(branch, ctx.config.git.defaultBranch, ctx.cwd);
-    return;
-  }
-  const message = ctx.data.commitMessage || DEFAULT_COMMIT_MESSAGE;
-  try {
-    const result = commitAndPush(branch, message, ctx.cwd);
-    ctx.data.commitResult = result;
-    const postCommitFiles = result.committed ? listFilesInCommit("HEAD", ctx.cwd) : listChangedFiles(ctx.cwd);
-    ctx.data.changedFiles = postCommitFiles.filter((f) => !isForbiddenPath(f));
-    if (result.committed && !result.pushed) {
-      const reason = result.pushError ?? "push failed (no error detail)";
-      ctx.data.commitCrash = reason;
-      if (ctx.output.exitCode === void 0 || ctx.output.exitCode === 0) {
-        ctx.output.exitCode = 4;
-      }
-      if (!ctx.output.reason) ctx.output.reason = reason;
-      process.stderr.write(`[kody commitAndPush] ${reason}
-`);
-    }
-  } catch (err) {
-    const reason = err instanceof Error ? err.message : String(err);
-    ctx.data.commitCrash = reason;
-    ctx.data.commitResult = { committed: false, pushed: false };
-    process.stderr.write(`[kody commitAndPush] failed: ${reason}
-`);
-  }
-  ctx.data.hasCommitsAhead = hasCommitsAhead(branch, ctx.config.git.defaultBranch, ctx.cwd);
-};
-
-// src/scripts/composePrompt.ts
-import * as fs13 from "fs";
-import * as path12 from "path";
-var MUSTACHE = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
-var composePrompt = async (ctx, profile) => {
-  const explicit = ctx.data.promptTemplate;
-  const mode = ctx.args.mode;
-  const candidates = [
-    explicit ? path12.join(profile.dir, explicit) : null,
-    mode ? path12.join(profile.dir, "prompts", `${mode}.md`) : null,
-    path12.join(profile.dir, "prompt.md")
-  ].filter(Boolean);
-  let templatePath = "";
-  for (const c of candidates) {
-    if (fs13.existsSync(c)) {
-      templatePath = c;
-      break;
-    }
-  }
-  if (!templatePath) {
-    throw new Error(`profile at ${profile.dir}: no prompt template found (tried ${candidates.join(", ")})`);
-  }
-  const template = fs13.readFileSync(templatePath, "utf-8");
-  const tokens = {
-    ...stringifyAll(ctx.args, "args."),
-    ...stringifyAll(ctx.data, ""),
-    conventionsBlock: formatConventions(ctx.data.conventions),
-    coverageBlock: formatCoverageBlock(
-      ctx.data.coverageRules
-    ),
-    toolsUsage: formatToolsUsage(profile),
-    systemPromptAppend: profile.claudeCode.systemPromptAppend ?? "",
-    repoOwner: ctx.config.github.owner,
-    repoName: ctx.config.github.repo,
-    defaultBranch: ctx.config.git.defaultBranch,
-    branch: ctx.data.branch ?? ""
-  };
-  ctx.data.prompt = template.replace(MUSTACHE, (_, key) => tokens[key] ?? "");
-};
-function stringifyAll(source, prefix) {
-  const out = {};
-  for (const [k, v] of Object.entries(source)) {
-    const key = prefix + k;
-    if (v === null || v === void 0) continue;
-    if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
-      out[key] = String(v);
-    } else if (Array.isArray(v)) {
-      out[key] = v.map((x) => typeof x === "string" ? x : JSON.stringify(x)).join("\n");
-    } else if (typeof v === "object") {
-      for (const [k2, v2] of Object.entries(v)) {
-        if (typeof v2 === "string" || typeof v2 === "number" || typeof v2 === "boolean") {
-          out[`${key}.${k2}`] = String(v2);
-        }
-      }
-    }
-  }
-  return out;
-}
-function formatConventions(conventions) {
-  if (!conventions || conventions.length === 0) return "";
-  const lines = ["# Project conventions (AUTHORITATIVE \u2014 follow these over patterns you infer from code)", ""];
-  for (const c of conventions) {
-    lines.push(`## ${c.path}${c.truncated ? " (truncated)" : ""}`);
-    lines.push("");
-    lines.push("```");
-    lines.push(c.content);
-    lines.push("```");
-    lines.push("");
-  }
-  return lines.join("\n");
-}
-function formatCoverageBlock(reqs) {
-  if (!reqs || reqs.length === 0) return "";
-  const lines = [
-    "# Test coverage requirements (ENFORCED)",
-    "",
-    "Every newly added file matching one of these patterns MUST be accompanied by a sibling test file in the same commit. The wrapper checks this after you finish; if any sibling test is missing, the run will fail and the issue will be re-invoked with the gap as feedback.",
-    ""
-  ];
-  for (const r of reqs) lines.push(`- new \`${r.pattern}\` \u2192 must include sibling \`${r.requireSibling}\``);
-  lines.push("");
-  return lines.join("\n");
-}
-function formatToolsUsage(profile) {
-  const entries = (profile.cliTools ?? []).filter((t) => t.usage.trim().length > 0);
-  if (entries.length === 0) return "";
-  const lines = ["# Available CLI tools", ""];
-  for (const t of entries) {
-    lines.push(`## \`${t.name}\``);
-    lines.push(t.usage);
-    if (t.allowedUses.length > 0) {
-      lines.push(`Allowed sub-commands: ${t.allowedUses.map((u) => `\`${u}\``).join(", ")}`);
-    }
-    lines.push("");
-  }
-  return lines.join("\n");
-}
-
-// src/scripts/createQaGoal.ts
-import { execFileSync as execFileSync9 } from "child_process";
-import * as fs14 from "fs";
-import * as path13 from "path";
-
 // src/issue.ts
 import { execFileSync as execFileSync8 } from "child_process";
 var API_TIMEOUT_MS3 = 3e4;
@@ -2718,61 +2556,330 @@ function getPrDiff(prNumber, cwd) {
     );
     return "";
   }
-}
-function getPrReviews(prNumber, cwd) {
-  try {
-    const output = gh2(["pr", "view", String(prNumber), "--json", "reviews"], { cwd });
-    const parsed = JSON.parse(output);
-    if (!Array.isArray(parsed?.reviews)) return [];
-    return parsed.reviews.map(
-      (r) => ({
-        body: r.body ?? "",
-        state: r.state ?? "",
-        author: r.author?.login ?? "unknown",
-        submittedAt: r.submittedAt ?? ""
-      })
-    );
-  } catch {
-    return [];
+}
+function getPrReviews(prNumber, cwd) {
+  try {
+    const output = gh2(["pr", "view", String(prNumber), "--json", "reviews"], { cwd });
+    const parsed = JSON.parse(output);
+    if (!Array.isArray(parsed?.reviews)) return [];
+    return parsed.reviews.map(
+      (r) => ({
+        body: r.body ?? "",
+        state: r.state ?? "",
+        author: r.author?.login ?? "unknown",
+        submittedAt: r.submittedAt ?? ""
+      })
+    );
+  } catch {
+    return [];
+  }
+}
+function getPrComments(prNumber, cwd) {
+  try {
+    const output = gh2(["pr", "view", String(prNumber), "--json", "comments"], { cwd });
+    const parsed = JSON.parse(output);
+    if (!Array.isArray(parsed?.comments)) return [];
+    return parsed.comments.map((c) => ({
+      body: c.body ?? "",
+      author: c.author?.login ?? "unknown",
+      createdAt: c.createdAt ?? ""
+    })).filter((c) => c.body.trim().length > 0);
+  } catch {
+    return [];
+  }
+}
+var VERDICT_HEADING = /(^|\n)\s*#{1,6}\s*Verdict\s*:/i;
+function isReviewShaped(body) {
+  return VERDICT_HEADING.test(body);
+}
+function getPrLatestReviewBody(prNumber, cwd) {
+  const reviews = getPrReviews(prNumber, cwd).filter((r) => r.body.trim().length > 0).map((r) => ({ body: r.body, at: r.submittedAt }));
+  const comments = getPrComments(prNumber, cwd).filter((c) => isReviewShaped(c.body)).map((c) => ({ body: c.body, at: c.createdAt }));
+  const all = [...reviews, ...comments].sort((a, b) => (b.at || "").localeCompare(a.at || ""));
+  if (all.length > 0) return all[0].body;
+  const pr = getPr(prNumber, cwd);
+  return pr.body;
+}
+function postPrReviewComment(prNumber, body, cwd) {
+  try {
+    gh2(["pr", "comment", String(prNumber), "--body-file", "-"], { input: stripKodyMentions(body), cwd });
+  } catch (err) {
+    process.stderr.write(
+      `[kody] failed to post review comment on PR #${prNumber}: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+}
+
+// src/lifecycleLabels.ts
+var KODY_NAMESPACE = "kody";
+function groupOf(label) {
+  const idx = label.indexOf(":");
+  return idx === -1 ? label : label.slice(0, idx + 1);
+}
+function collectProfileLabels() {
+  const byLabel = /* @__PURE__ */ new Map();
+  for (const exe of listExecutables()) {
+    let profile;
+    try {
+      profile = loadProfile(exe.profilePath);
+    } catch {
+      continue;
+    }
+    for (const entry of [...profile.scripts.preflight, ...profile.scripts.postflight]) {
+      const spec = extractLabelSpec(entry);
+      if (spec) byLabel.set(spec.label, spec);
+    }
+  }
+  return [...byLabel.values()];
+}
+function extractLabelSpec(entry) {
+  if (entry.script !== "setLifecycleLabel") return null;
+  const w = entry.with;
+  if (!w) return null;
+  const label = typeof w.label === "string" ? w.label : null;
+  if (!label || !label.startsWith(KODY_NAMESPACE)) return null;
+  return {
+    label,
+    color: typeof w.color === "string" ? w.color : void 0,
+    description: typeof w.description === "string" ? w.description : void 0
+  };
+}
+function ensureLabels(cwd) {
+  const result = { created: [], failed: [] };
+  for (const spec of collectProfileLabels()) {
+    try {
+      createLabelInRepo(spec, cwd);
+      result.created.push(spec.label);
+    } catch (err) {
+      result.failed.push({ label: spec.label, reason: errMsg(err) });
+    }
+  }
+  return result;
+}
+function getIssueLabels(issueNumber, cwd) {
+  try {
+    const output = gh2(["issue", "view", String(issueNumber), "--json", "labels", "--jq", ".labels[].name"], { cwd });
+    return output.split("\n").filter(Boolean);
+  } catch {
+    return [];
+  }
+}
+function addLabel(issueNumber, label, cwd) {
+  gh2(["issue", "edit", String(issueNumber), "--add-label", label], { cwd });
+}
+function removeLabel(issueNumber, label, cwd) {
+  try {
+    gh2(["issue", "edit", String(issueNumber), "--remove-label", label], { cwd });
+  } catch {
+  }
+}
+function createLabelInRepo(spec, cwd) {
+  const args = ["label", "create", spec.label, "--force"];
+  if (spec.color) args.push("--color", spec.color);
+  if (spec.description) args.push("--description", spec.description);
+  gh2(args, { cwd });
+}
+function setKodyLabel(issueNumber, spec, cwd) {
+  const target = spec.label;
+  if (!target.startsWith(KODY_NAMESPACE)) {
+    process.stderr.write(`[kody] setKodyLabel: refusing to set non-kody label "${target}"
+`);
+    return;
+  }
+  const targetGroup = groupOf(target);
+  const present = getIssueLabels(issueNumber, cwd);
+  for (const label of present) {
+    if (label !== target && label.startsWith(KODY_NAMESPACE) && groupOf(label) === targetGroup) {
+      removeLabel(issueNumber, label, cwd);
+    }
+  }
+  try {
+    addLabel(issueNumber, target, cwd);
+  } catch (err) {
+    if (looksLikeMissingLabel(err)) {
+      try {
+        createLabelInRepo(spec, cwd);
+        addLabel(issueNumber, target, cwd);
+        return;
+      } catch (retryErr) {
+        process.stderr.write(
+          `[kody] setKodyLabel: create+retry failed for ${target} on #${issueNumber}: ${errMsg(retryErr)}
+`
+        );
+        return;
+      }
+    }
+    process.stderr.write(`[kody] setKodyLabel: failed to add ${target} on #${issueNumber}: ${errMsg(err)}
+`);
+  }
+}
+function looksLikeMissingLabel(err) {
+  const msg = errMsg(err).toLowerCase();
+  return msg.includes("not found") || msg.includes("could not add label") || msg.includes("could not resolve to a label");
+}
+function errMsg(err) {
+  if (err instanceof Error) return err.message;
+  if (typeof err === "object" && err !== null) {
+    const e = err;
+    const stderr = e.stderr?.toString().trim();
+    if (stderr) return stderr;
+    if (e.message) return e.message;
+  }
+  return String(err);
+}
+
+// src/scripts/clearLifecycleLabel.ts
+var clearLifecycleLabel = async (ctx, _profile, _agentResult, args) => {
+  const label = args?.label;
+  if (typeof label !== "string" || !label.startsWith(KODY_NAMESPACE)) return;
+  const target = ctx.args.issue ?? ctx.args.pr;
+  if (typeof target !== "number" || !Number.isFinite(target)) return;
+  removeLabel(target, label, ctx.cwd);
+};
+
+// src/scripts/commitAndPush.ts
+var DEFAULT_COMMIT_MESSAGE = "chore: kody changes";
+var commitAndPush2 = async (ctx) => {
+  const branch = ctx.data.branch;
+  if (!branch) {
+    ctx.data.commitResult = { committed: false, pushed: false };
+    return;
+  }
+  if (ctx.data.agentDone === false) {
+    ctx.data.commitResult = { committed: false, pushed: false, skippedReason: "agentDone=false" };
+    ctx.data.hasCommitsAhead = hasCommitsAhead(branch, ctx.config.git.defaultBranch, ctx.cwd);
+    return;
+  }
+  const message = ctx.data.commitMessage || DEFAULT_COMMIT_MESSAGE;
+  try {
+    const result = commitAndPush(branch, message, ctx.cwd);
+    ctx.data.commitResult = result;
+    const postCommitFiles = result.committed ? listFilesInCommit("HEAD", ctx.cwd) : listChangedFiles(ctx.cwd);
+    ctx.data.changedFiles = postCommitFiles.filter((f) => !isForbiddenPath(f));
+    if (result.committed && !result.pushed) {
+      const reason = result.pushError ?? "push failed (no error detail)";
+      ctx.data.commitCrash = reason;
+      if (ctx.output.exitCode === void 0 || ctx.output.exitCode === 0) {
+        ctx.output.exitCode = 4;
+      }
+      if (!ctx.output.reason) ctx.output.reason = reason;
+      process.stderr.write(`[kody commitAndPush] ${reason}
+`);
+    }
+  } catch (err) {
+    const reason = err instanceof Error ? err.message : String(err);
+    ctx.data.commitCrash = reason;
+    ctx.data.commitResult = { committed: false, pushed: false };
+    process.stderr.write(`[kody commitAndPush] failed: ${reason}
+`);
+  }
+  ctx.data.hasCommitsAhead = hasCommitsAhead(branch, ctx.config.git.defaultBranch, ctx.cwd);
+};
+
+// src/scripts/composePrompt.ts
+import * as fs13 from "fs";
+import * as path12 from "path";
+var MUSTACHE = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
+var composePrompt = async (ctx, profile) => {
+  const explicit = ctx.data.promptTemplate;
+  const mode = ctx.args.mode;
+  const candidates = [
+    explicit ? path12.join(profile.dir, explicit) : null,
+    mode ? path12.join(profile.dir, "prompts", `${mode}.md`) : null,
+    path12.join(profile.dir, "prompt.md")
+  ].filter(Boolean);
+  let templatePath = "";
+  for (const c of candidates) {
+    if (fs13.existsSync(c)) {
+      templatePath = c;
+      break;
+    }
+  }
+  if (!templatePath) {
+    throw new Error(`profile at ${profile.dir}: no prompt template found (tried ${candidates.join(", ")})`);
   }
-}
-function getPrComments(prNumber, cwd) {
-  try {
-    const output = gh2(["pr", "view", String(prNumber), "--json", "comments"], { cwd });
-    const parsed = JSON.parse(output);
-    if (!Array.isArray(parsed?.comments)) return [];
-    return parsed.comments.map((c) => ({
-      body: c.body ?? "",
-      author: c.author?.login ?? "unknown",
-      createdAt: c.createdAt ?? ""
-    })).filter((c) => c.body.trim().length > 0);
-  } catch {
-    return [];
+  const template = fs13.readFileSync(templatePath, "utf-8");
+  const tokens = {
+    ...stringifyAll(ctx.args, "args."),
+    ...stringifyAll(ctx.data, ""),
+    conventionsBlock: formatConventions(ctx.data.conventions),
+    coverageBlock: formatCoverageBlock(
+      ctx.data.coverageRules
+    ),
+    toolsUsage: formatToolsUsage(profile),
+    systemPromptAppend: profile.claudeCode.systemPromptAppend ?? "",
+    repoOwner: ctx.config.github.owner,
+    repoName: ctx.config.github.repo,
+    defaultBranch: ctx.config.git.defaultBranch,
+    branch: ctx.data.branch ?? ""
+  };
+  ctx.data.prompt = template.replace(MUSTACHE, (_, key) => tokens[key] ?? "");
+};
+function stringifyAll(source, prefix) {
+  const out = {};
+  for (const [k, v] of Object.entries(source)) {
+    const key = prefix + k;
+    if (v === null || v === void 0) continue;
+    if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") {
+      out[key] = String(v);
+    } else if (Array.isArray(v)) {
+      out[key] = v.map((x) => typeof x === "string" ? x : JSON.stringify(x)).join("\n");
+    } else if (typeof v === "object") {
+      for (const [k2, v2] of Object.entries(v)) {
+        if (typeof v2 === "string" || typeof v2 === "number" || typeof v2 === "boolean") {
+          out[`${key}.${k2}`] = String(v2);
+        }
+      }
+    }
   }
+  return out;
 }
-var VERDICT_HEADING = /(^|\n)\s*#{1,6}\s*Verdict\s*:/i;
-function isReviewShaped(body) {
-  return VERDICT_HEADING.test(body);
+function formatConventions(conventions) {
+  if (!conventions || conventions.length === 0) return "";
+  const lines = ["# Project conventions (AUTHORITATIVE \u2014 follow these over patterns you infer from code)", ""];
+  for (const c of conventions) {
+    lines.push(`## ${c.path}${c.truncated ? " (truncated)" : ""}`);
+    lines.push("");
+    lines.push("```");
+    lines.push(c.content);
+    lines.push("```");
+    lines.push("");
+  }
+  return lines.join("\n");
 }
-function getPrLatestReviewBody(prNumber, cwd) {
-  const reviews = getPrReviews(prNumber, cwd).filter((r) => r.body.trim().length > 0).map((r) => ({ body: r.body, at: r.submittedAt }));
-  const comments = getPrComments(prNumber, cwd).filter((c) => isReviewShaped(c.body)).map((c) => ({ body: c.body, at: c.createdAt }));
-  const all = [...reviews, ...comments].sort((a, b) => (b.at || "").localeCompare(a.at || ""));
-  if (all.length > 0) return all[0].body;
-  const pr = getPr(prNumber, cwd);
-  return pr.body;
+function formatCoverageBlock(reqs) {
+  if (!reqs || reqs.length === 0) return "";
+  const lines = [
+    "# Test coverage requirements (ENFORCED)",
+    "",
+    "Every newly added file matching one of these patterns MUST be accompanied by a sibling test file in the same commit. The wrapper checks this after you finish; if any sibling test is missing, the run will fail and the issue will be re-invoked with the gap as feedback.",
+    ""
+  ];
+  for (const r of reqs) lines.push(`- new \`${r.pattern}\` \u2192 must include sibling \`${r.requireSibling}\``);
+  lines.push("");
+  return lines.join("\n");
 }
-function postPrReviewComment(prNumber, body, cwd) {
-  try {
-    gh2(["pr", "comment", String(prNumber), "--body-file", "-"], { input: stripKodyMentions(body), cwd });
-  } catch (err) {
-    process.stderr.write(
-      `[kody] failed to post review comment on PR #${prNumber}: ${err instanceof Error ? err.message : String(err)}
-`
-    );
+function formatToolsUsage(profile) {
+  const entries = (profile.cliTools ?? []).filter((t) => t.usage.trim().length > 0);
+  if (entries.length === 0) return "";
+  const lines = ["# Available CLI tools", ""];
+  for (const t of entries) {
+    lines.push(`## \`${t.name}\``);
+    lines.push(t.usage);
+    if (t.allowedUses.length > 0) {
+      lines.push(`Allowed sub-commands: ${t.allowedUses.map((u) => `\`${u}\``).join(", ")}`);
+    }
+    lines.push("");
   }
+  return lines.join("\n");
 }
 
+// src/scripts/createQaGoal.ts
+import { execFileSync as execFileSync9 } from "child_process";
+import * as fs14 from "fs";
+import * as path13 from "path";
+
 // src/scripts/postReviewResult.ts
 function detectVerdict(body) {
   const m = body.match(/##\s*Verdict\s*:\s*(PASS|CONCERNS|FAIL)\b/i);
@@ -4738,125 +4845,6 @@ function collectExpectedTests(raw) {
 
 // src/scripts/finishFlow.ts
 import { execFileSync as execFileSync13 } from "child_process";
-
-// src/lifecycleLabels.ts
-var KODY_NAMESPACE = "kody";
-function groupOf(label) {
-  const idx = label.indexOf(":");
-  return idx === -1 ? label : label.slice(0, idx + 1);
-}
-function collectProfileLabels() {
-  const byLabel = /* @__PURE__ */ new Map();
-  for (const exe of listExecutables()) {
-    let profile;
-    try {
-      profile = loadProfile(exe.profilePath);
-    } catch {
-      continue;
-    }
-    for (const entry of [...profile.scripts.preflight, ...profile.scripts.postflight]) {
-      const spec = extractLabelSpec(entry);
-      if (spec) byLabel.set(spec.label, spec);
-    }
-  }
-  return [...byLabel.values()];
-}
-function extractLabelSpec(entry) {
-  const w = entry.with;
-  if (!w) return null;
-  const label = typeof w.label === "string" ? w.label : null;
-  if (!label || !label.startsWith(KODY_NAMESPACE)) return null;
-  return {
-    label,
-    color: typeof w.color === "string" ? w.color : void 0,
-    description: typeof w.description === "string" ? w.description : void 0
-  };
-}
-function ensureLabels(cwd) {
-  const result = { created: [], failed: [] };
-  for (const spec of collectProfileLabels()) {
-    try {
-      createLabelInRepo(spec, cwd);
-      result.created.push(spec.label);
-    } catch (err) {
-      result.failed.push({ label: spec.label, reason: errMsg(err) });
-    }
-  }
-  return result;
-}
-function getIssueLabels(issueNumber, cwd) {
-  try {
-    const output = gh2(["issue", "view", String(issueNumber), "--json", "labels", "--jq", ".labels[].name"], { cwd });
-    return output.split("\n").filter(Boolean);
-  } catch {
-    return [];
-  }
-}
-function addLabel(issueNumber, label, cwd) {
-  gh2(["issue", "edit", String(issueNumber), "--add-label", label], { cwd });
-}
-function removeLabel(issueNumber, label, cwd) {
-  try {
-    gh2(["issue", "edit", String(issueNumber), "--remove-label", label], { cwd });
-  } catch {
-  }
-}
-function createLabelInRepo(spec, cwd) {
-  const args = ["label", "create", spec.label, "--force"];
-  if (spec.color) args.push("--color", spec.color);
-  if (spec.description) args.push("--description", spec.description);
-  gh2(args, { cwd });
-}
-function setKodyLabel(issueNumber, spec, cwd) {
-  const target = spec.label;
-  if (!target.startsWith(KODY_NAMESPACE)) {
-    process.stderr.write(`[kody] setKodyLabel: refusing to set non-kody label "${target}"
-`);
-    return;
-  }
-  const targetGroup = groupOf(target);
-  const present = getIssueLabels(issueNumber, cwd);
-  for (const label of present) {
-    if (label !== target && label.startsWith(KODY_NAMESPACE) && groupOf(label) === targetGroup) {
-      removeLabel(issueNumber, label, cwd);
-    }
-  }
-  try {
-    addLabel(issueNumber, target, cwd);
-  } catch (err) {
-    if (looksLikeMissingLabel(err)) {
-      try {
-        createLabelInRepo(spec, cwd);
-        addLabel(issueNumber, target, cwd);
-        return;
-      } catch (retryErr) {
-        process.stderr.write(
-          `[kody] setKodyLabel: create+retry failed for ${target} on #${issueNumber}: ${errMsg(retryErr)}
-`
-        );
-        return;
-      }
-    }
-    process.stderr.write(`[kody] setKodyLabel: failed to add ${target} on #${issueNumber}: ${errMsg(err)}
-`);
-  }
-}
-function looksLikeMissingLabel(err) {
-  const msg = errMsg(err).toLowerCase();
-  return msg.includes("not found") || msg.includes("could not add label") || msg.includes("could not resolve to a label");
-}
-function errMsg(err) {
-  if (err instanceof Error) return err.message;
-  if (typeof err === "object" && err !== null) {
-    const e = err;
-    const stderr = e.stderr?.toString().trim();
-    if (stderr) return stderr;
-    if (e.message) return e.message;
-  }
-  return String(err);
-}
-
-// src/scripts/finishFlow.ts
 var API_TIMEOUT_MS6 = 3e4;
 var STATUS_ICON = {
   "review-passed": "\u2705",
@@ -5487,21 +5475,6 @@ function performInit(cwd, force) {
       wrote.push(QA_GUIDE_REL_PATH);
     }
   }
-  const builtinJobs = listBuiltinJobs();
-  if (builtinJobs.length > 0) {
-    const jobsDir = path20.join(cwd, ".kody", "jobs");
-    fs22.mkdirSync(jobsDir, { recursive: true });
-    for (const job of builtinJobs) {
-      const rel = path20.join(".kody", "jobs", `${job.slug}.md`);
-      const target = path20.join(cwd, rel);
-      if (fs22.existsSync(target) && !force) {
-        skipped.push(rel);
-        continue;
-      }
-      fs22.writeFileSync(target, fs22.readFileSync(job.filePath, "utf-8"));
-      wrote.push(rel);
-    }
-  }
   for (const exe of listExecutables()) {
     let profile;
     try {
@@ -8053,7 +8026,8 @@ var postflightScripts = {
   recordOutcome,
   mergeReleasePr,
   waitForCi,
-  markFlowSuccess
+  markFlowSuccess,
+  clearLifecycleLabel
 };
 var allScriptNames = /* @__PURE__ */ new Set([
   ...Object.keys(preflightScripts),

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

@@ -31,7 +31,17 @@
 set -euo pipefail
 
 goal_id="${KODY_ARG_GOAL:-}"
-default_branch="${KODY_CFG_GIT_DEFAULTBRANCH:-main}"
+# Default branch: prefer KODY_CFG_GIT_DEFAULTBRANCH (config), then ask the
+# repo via the GitHub API, finally fall back to "main". Past regression: a
+# hardcoded "main" fallback opened goal PRs against `main` for repos whose
+# real default is `dev`, which then needed manual retargeting.
+default_branch="${KODY_CFG_GIT_DEFAULTBRANCH:-}"
+if [ -z "$default_branch" ]; then
+  default_branch=$(gh api "repos/{owner}/{repo}" --jq .default_branch 2>/dev/null || echo "")
+fi
+if [ -z "$default_branch" ]; then
+  default_branch="main"
+fi
 
 if [ -z "$goal_id" ]; then
   echo "KODY_REASON=missing --goal"
@@ -335,6 +345,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 +563,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/executables/watch-stale-prs/profile.json

@@ -0,0 +1,30 @@
+{
+  "name": "watch-stale-prs",
+  "role": "watch",
+  "describe": "Scheduled: list open PRs untouched for N days and report. No agent invocation.",
+  "kind": "scheduled",
+  "schedule": "0 8 * * MON",
+  "inputs": [],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "default",
+    "maxTurns": null,
+    "systemPromptAppend": null,
+    "tools": [],
+    "hooks": [],
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [],
+  "scripts": {
+    "preflight": [
+      {
+        "script": "watchStalePrsFlow"
+      }
+    ],
+    "postflight": []
+  }
+}

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