@kody-ade/kody-engine 0.4.27 → 0.4.29

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.27",
+  version: "0.4.29",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -52,8 +52,8 @@ var package_default = {
 
 // src/chat-cli.ts
 import { execFileSync as execFileSync30 } from "child_process";
-import * as fs28 from "fs";
-import * as path25 from "path";
+import * as fs29 from "fs";
+import * as path26 from "path";
 
 // src/chat/events.ts
 import * as fs from "fs";
@@ -913,8 +913,8 @@ async function emit2(sink, type, sessionId, suffix, payload) {
 
 // src/kody-cli.ts
 import { execFileSync as execFileSync29 } from "child_process";
-import * as fs27 from "fs";
-import * as path24 from "path";
+import * as fs28 from "fs";
+import * as path25 from "path";
 
 // src/dispatch.ts
 import * as fs7 from "fs";
@@ -1300,8 +1300,8 @@ function coerceBare(spec, value) {
 
 // src/executor.ts
 import { execFileSync as execFileSync28, spawn as spawn5 } from "child_process";
-import * as fs26 from "fs";
-import * as path23 from "path";
+import * as fs27 from "fs";
+import * as path24 from "path";
 
 // src/issue.ts
 import { execFileSync as execFileSync3 } from "child_process";
@@ -1977,10 +1977,153 @@ function stripBlockingEnv(env) {
   return out;
 }
 
-// src/commit.ts
-import { execFileSync as execFileSync5 } from "child_process";
+// src/prompt.ts
 import * as fs10 from "fs";
 import * as path9 from "path";
+var CONVENTIONS_PER_FILE_MAX_BYTES = 3e4;
+var CONVENTION_FILES = ["CLAUDE.md", "AGENTS.md"];
+function loadProjectConventions(projectDir) {
+  const out = [];
+  for (const rel of CONVENTION_FILES) {
+    const abs = path9.join(projectDir, rel);
+    if (!fs10.existsSync(abs)) continue;
+    let content;
+    try {
+      content = fs10.readFileSync(abs, "utf-8");
+    } catch {
+      continue;
+    }
+    const truncated = content.length > CONVENTIONS_PER_FILE_MAX_BYTES;
+    if (truncated) content = `${content.slice(0, CONVENTIONS_PER_FILE_MAX_BYTES)}
+
+\u2026 (truncated)`;
+    out.push({ path: rel, content, truncated });
+  }
+  return out;
+}
+function parseAgentResult(finalText) {
+  const text = (finalText || "").trim();
+  if (!text)
+    return {
+      done: false,
+      commitMessage: "",
+      prSummary: "",
+      feedbackActions: "",
+      planDeviations: "",
+      priorArt: "",
+      failureReason: "agent produced no final message",
+      markerMissing: false
+    };
+  const MARKDOWN_PREFIX = "[\\s>*_#`~\\-]*";
+  const FAILED_RE = new RegExp(`(?:^|\\n)${MARKDOWN_PREFIX}FAILED${MARKDOWN_PREFIX}\\s*:\\s*(.+?)\\s*$`, "is");
+  const DONE_RE = new RegExp(`(?:^|\\n)${MARKDOWN_PREFIX}DONE\\b`, "i");
+  const failedMatch = text.match(FAILED_RE);
+  if (failedMatch) {
+    return {
+      done: false,
+      commitMessage: "",
+      prSummary: "",
+      feedbackActions: "",
+      planDeviations: "",
+      priorArt: "",
+      failureReason: stripMarkdownEmphasis(failedMatch[1]),
+      markerMissing: false
+    };
+  }
+  const hasDoneMarker = DONE_RE.test(text);
+  const hasCommitMsg = /^[\s>*_#`~-]*COMMIT_MSG\s*:/im.test(text);
+  const hasPrSummary = /^[\s>*_#`~-]*PR_SUMMARY\s*:/im.test(text);
+  if (!hasDoneMarker && !hasCommitMsg && !hasPrSummary) {
+    const tail = text.length > 400 ? `\u2026${text.slice(-400)}` : text;
+    return {
+      done: false,
+      commitMessage: "",
+      prSummary: "",
+      feedbackActions: "",
+      planDeviations: "",
+      priorArt: "",
+      failureReason: `no DONE or FAILED marker in agent output \u2014 agent tail: ${tail}`,
+      markerMissing: true
+    };
+  }
+  const commitMatch = text.match(/^[\s>*_#`~-]*COMMIT_MSG[\s>*_#`~-]*\s*:\s*(.+)$/im);
+  const commitMessage = commitMatch ? stripMarkdownEmphasis(commitMatch[1]) : "";
+  const feedbackActions = extractBlock(
+    text,
+    /(?:^|\n)[ \t]*FEEDBACK_ACTIONS\s*:[ \t]*\n/i,
+    /(?:^|\n)[ \t]*(?:PLAN_DEVIATIONS|COMMIT_MSG|PR_SUMMARY|PRIOR_ART)\s*:/i
+  );
+  let planDeviations = extractBlock(
+    text,
+    /(?:^|\n)[ \t]*PLAN_DEVIATIONS\s*:[ \t]*\n/i,
+    /(?:^|\n)[ \t]*(?:COMMIT_MSG|PR_SUMMARY|FEEDBACK_ACTIONS|PRIOR_ART)\s*:/i
+  );
+  if (!planDeviations) {
+    const inline = text.match(/(?:^|\n)[ \t]*PLAN_DEVIATIONS\s*:[ \t]*(.+?)[ \t]*(?:\n|$)/i);
+    if (inline) planDeviations = inline[1].trim();
+  }
+  let priorArt = "";
+  const priorArtInline = text.match(/(?:^|\n)[ \t]*PRIOR_ART\s*:[ \t]*(.+?)[ \t]*(?:\n|$)/i);
+  if (priorArtInline) priorArt = priorArtInline[1].trim();
+  const summaryStart = text.search(/(^|\n)[ \t]*PR_SUMMARY\s*:[ \t]*\n/i);
+  let prSummary = "";
+  if (summaryStart !== -1) {
+    const afterMarker = text.slice(summaryStart).replace(/^[\s\S]*?PR_SUMMARY\s*:[ \t]*\n/i, "");
+    prSummary = afterMarker.replace(/\n\s*```\s*$/g, "").replace(/```\s*$/g, "").trim();
+  }
+  return {
+    done: true,
+    commitMessage,
+    prSummary,
+    feedbackActions,
+    planDeviations,
+    priorArt,
+    failureReason: "",
+    markerMissing: false
+  };
+}
+function stripMarkdownEmphasis(s) {
+  return s.trim().replace(/^[*_`~]+|[*_`~]+$/g, "").trim();
+}
+function extractBlock(text, startMarker, endMarker) {
+  const startIdx = text.search(startMarker);
+  if (startIdx === -1) return "";
+  const afterStart = text.slice(startIdx).replace(startMarker, "");
+  const endIdx = afterStart.search(endMarker);
+  const body = endIdx === -1 ? afterStart : afterStart.slice(0, endIdx);
+  return body.replace(/\n\s*```\s*$/g, "").trim();
+}
+
+// src/rescueMissingMarker.ts
+var NUDGE_PROMPT = "Your previous message did not contain the required terminator. Reply with EXACTLY one of:\n  DONE\n  COMMIT_MSG: <one-line commit message>\nor, if the work failed:\n  FAILED: <one-line reason>\nDo not repeat any earlier content \u2014 emit only the marker line(s).";
+async function rescueMissingMarker(result, invoke) {
+  if (result.outcome !== "completed") return result;
+  const parsed = parseAgentResult(result.finalText);
+  if (!parsed.markerMissing) return result;
+  try {
+    const rescue = await invoke(NUDGE_PROMPT);
+    if (!rescue.finalText || !rescue.finalText.trim()) return result;
+    return {
+      ...result,
+      finalText: `${result.finalText}
+
+---
+
+${rescue.finalText}`,
+      outcome: rescue.outcome === "failed" ? result.outcome : rescue.outcome
+    };
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`[kody] marker-rescue turn failed: ${msg}
+`);
+    return result;
+  }
+}
+
+// src/commit.ts
+import { execFileSync as execFileSync5 } from "child_process";
+import * as fs11 from "fs";
+import * as path10 from "path";
 var FORBIDDEN_PATH_PREFIXES = [
   ".kody/",
   ".kody-engine/",
@@ -2036,18 +2179,18 @@ function tryGit(args, cwd) {
 }
 function abortUnfinishedGitOps(cwd) {
   const aborted = [];
-  const gitDir = path9.join(cwd ?? process.cwd(), ".git");
-  if (!fs10.existsSync(gitDir)) return aborted;
-  if (fs10.existsSync(path9.join(gitDir, "MERGE_HEAD"))) {
+  const gitDir = path10.join(cwd ?? process.cwd(), ".git");
+  if (!fs11.existsSync(gitDir)) return aborted;
+  if (fs11.existsSync(path10.join(gitDir, "MERGE_HEAD"))) {
     if (tryGit(["merge", "--abort"], cwd)) aborted.push("merge");
   }
-  if (fs10.existsSync(path9.join(gitDir, "CHERRY_PICK_HEAD"))) {
+  if (fs11.existsSync(path10.join(gitDir, "CHERRY_PICK_HEAD"))) {
     if (tryGit(["cherry-pick", "--abort"], cwd)) aborted.push("cherry-pick");
   }
-  if (fs10.existsSync(path9.join(gitDir, "REVERT_HEAD"))) {
+  if (fs11.existsSync(path10.join(gitDir, "REVERT_HEAD"))) {
     if (tryGit(["revert", "--abort"], cwd)) aborted.push("revert");
   }
-  if (fs10.existsSync(path9.join(gitDir, "rebase-merge")) || fs10.existsSync(path9.join(gitDir, "rebase-apply"))) {
+  if (fs11.existsSync(path10.join(gitDir, "rebase-merge")) || fs11.existsSync(path10.join(gitDir, "rebase-apply"))) {
     if (tryGit(["rebase", "--abort"], cwd)) aborted.push("rebase");
   }
   try {
@@ -2103,7 +2246,7 @@ function normalizeCommitMessage(raw) {
 function commitAndPush(branch, agentMessage, cwd) {
   const allChanged = listChangedFiles(cwd);
   const allowedFiles = allChanged.filter((f) => !isForbiddenPath(f));
-  const mergeHeadExists = fs10.existsSync(path9.join(cwd ?? process.cwd(), ".git", "MERGE_HEAD"));
+  const mergeHeadExists = fs11.existsSync(path10.join(cwd ?? process.cwd(), ".git", "MERGE_HEAD"));
   if (allowedFiles.length === 0 && !mergeHeadExists) {
     return { committed: false, pushed: false, sha: "", message: "" };
   }
@@ -2415,21 +2558,21 @@ var advanceFlow = async (ctx, profile) => {
 };
 
 // src/scripts/buildSyntheticPlugin.ts
-import * as fs11 from "fs";
+import * as fs12 from "fs";
 import * as os2 from "os";
-import * as path10 from "path";
+import * as path11 from "path";
 function getPluginsCatalogRoot() {
-  const here = path10.dirname(new URL(import.meta.url).pathname);
+  const here = path11.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path10.join(here, "..", "plugins"),
+    path11.join(here, "..", "plugins"),
     // dev: src/scripts → src/plugins
-    path10.join(here, "..", "..", "plugins"),
+    path11.join(here, "..", "..", "plugins"),
     // built: dist/scripts → dist/plugins
-    path10.join(here, "..", "..", "src", "plugins")
+    path11.join(here, "..", "..", "src", "plugins")
     // fallback
   ];
   for (const c of candidates) {
-    if (fs11.existsSync(c) && fs11.statSync(c).isDirectory()) return c;
+    if (fs12.existsSync(c) && fs12.statSync(c).isDirectory()) return c;
   }
   return candidates[0];
 }
@@ -2439,52 +2582,52 @@ var buildSyntheticPlugin = async (ctx, profile) => {
   if (!needsSynthetic) return;
   const catalog = getPluginsCatalogRoot();
   const runId = `${profile.name}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-  const root = path10.join(os2.tmpdir(), `kody-synth-${runId}`);
-  fs11.mkdirSync(path10.join(root, ".claude-plugin"), { recursive: true });
+  const root = path11.join(os2.tmpdir(), `kody-synth-${runId}`);
+  fs12.mkdirSync(path11.join(root, ".claude-plugin"), { recursive: true });
   const resolvePart = (bucket, entry) => {
-    const local = path10.join(profile.dir, bucket, entry);
-    if (fs11.existsSync(local)) return local;
-    const central = path10.join(catalog, bucket, entry);
-    if (fs11.existsSync(central)) return central;
+    const local = path11.join(profile.dir, bucket, entry);
+    if (fs12.existsSync(local)) return local;
+    const central = path11.join(catalog, bucket, entry);
+    if (fs12.existsSync(central)) return central;
     throw new Error(
       `buildSyntheticPlugin: ${bucket} entry '${entry}' not found in executable dir (${profile.dir}/${bucket}/) or catalog (${catalog}/${bucket}/)`
     );
   };
   if (cc.skills.length > 0) {
-    const dst = path10.join(root, "skills");
-    fs11.mkdirSync(dst, { recursive: true });
+    const dst = path11.join(root, "skills");
+    fs12.mkdirSync(dst, { recursive: true });
     for (const name of cc.skills) {
-      copyDir(resolvePart("skills", name), path10.join(dst, name));
+      copyDir(resolvePart("skills", name), path11.join(dst, name));
     }
   }
   if (cc.commands.length > 0) {
-    const dst = path10.join(root, "commands");
-    fs11.mkdirSync(dst, { recursive: true });
+    const dst = path11.join(root, "commands");
+    fs12.mkdirSync(dst, { recursive: true });
     for (const name of cc.commands) {
-      fs11.copyFileSync(resolvePart("commands", `${name}.md`), path10.join(dst, `${name}.md`));
+      fs12.copyFileSync(resolvePart("commands", `${name}.md`), path11.join(dst, `${name}.md`));
     }
   }
   if (cc.subagents.length > 0) {
-    const dst = path10.join(root, "agents");
-    fs11.mkdirSync(dst, { recursive: true });
+    const dst = path11.join(root, "agents");
+    fs12.mkdirSync(dst, { recursive: true });
     for (const name of cc.subagents) {
-      fs11.copyFileSync(resolvePart("agents", `${name}.md`), path10.join(dst, `${name}.md`));
+      fs12.copyFileSync(resolvePart("agents", `${name}.md`), path11.join(dst, `${name}.md`));
     }
   }
   if (cc.hooks.length > 0) {
-    const dst = path10.join(root, "hooks");
-    fs11.mkdirSync(dst, { recursive: true });
+    const dst = path11.join(root, "hooks");
+    fs12.mkdirSync(dst, { recursive: true });
     const merged = { hooks: {} };
     for (const name of cc.hooks) {
       const src = resolvePart("hooks", `${name}.json`);
-      const parsed = JSON.parse(fs11.readFileSync(src, "utf-8"));
+      const parsed = JSON.parse(fs12.readFileSync(src, "utf-8"));
       for (const [event, entries] of Object.entries(parsed.hooks ?? {})) {
         if (!Array.isArray(entries)) continue;
         if (!merged.hooks[event]) merged.hooks[event] = [];
         merged.hooks[event].push(...entries);
       }
     }
-    fs11.writeFileSync(path10.join(dst, "hooks.json"), `${JSON.stringify(merged, null, 2)}
+    fs12.writeFileSync(path11.join(dst, "hooks.json"), `${JSON.stringify(merged, null, 2)}
 `);
   }
   const manifest = {
@@ -2495,17 +2638,17 @@ var buildSyntheticPlugin = async (ctx, profile) => {
   if (cc.skills.length > 0) manifest.skills = ["./skills/"];
   if (cc.commands.length > 0) manifest.commands = ["./commands/"];
   if (cc.subagents.length > 0) manifest.agents = cc.subagents.map((n) => `./agents/${n}.md`);
-  fs11.writeFileSync(path10.join(root, ".claude-plugin", "plugin.json"), `${JSON.stringify(manifest, null, 2)}
+  fs12.writeFileSync(path11.join(root, ".claude-plugin", "plugin.json"), `${JSON.stringify(manifest, null, 2)}
 `);
   ctx.data.syntheticPluginPath = root;
 };
 function copyDir(src, dst) {
-  fs11.mkdirSync(dst, { recursive: true });
-  for (const ent of fs11.readdirSync(src, { withFileTypes: true })) {
-    const s = path10.join(src, ent.name);
-    const d = path10.join(dst, ent.name);
+  fs12.mkdirSync(dst, { recursive: true });
+  for (const ent of fs12.readdirSync(src, { withFileTypes: true })) {
+    const s = path11.join(src, ent.name);
+    const d = path11.join(dst, ent.name);
     if (ent.isDirectory()) copyDir(s, d);
-    else if (ent.isFile()) fs11.copyFileSync(s, d);
+    else if (ent.isFile()) fs12.copyFileSync(s, d);
   }
 }
 
@@ -2570,123 +2713,6 @@ function formatMissesForFeedback(misses) {
   return lines.join("\n");
 }
 
-// src/prompt.ts
-import * as fs12 from "fs";
-import * as path11 from "path";
-var CONVENTIONS_PER_FILE_MAX_BYTES = 3e4;
-var CONVENTION_FILES = ["CLAUDE.md", "AGENTS.md"];
-function loadProjectConventions(projectDir) {
-  const out = [];
-  for (const rel of CONVENTION_FILES) {
-    const abs = path11.join(projectDir, rel);
-    if (!fs12.existsSync(abs)) continue;
-    let content;
-    try {
-      content = fs12.readFileSync(abs, "utf-8");
-    } catch {
-      continue;
-    }
-    const truncated = content.length > CONVENTIONS_PER_FILE_MAX_BYTES;
-    if (truncated) content = `${content.slice(0, CONVENTIONS_PER_FILE_MAX_BYTES)}
-
-\u2026 (truncated)`;
-    out.push({ path: rel, content, truncated });
-  }
-  return out;
-}
-function parseAgentResult(finalText) {
-  const text = (finalText || "").trim();
-  if (!text)
-    return {
-      done: false,
-      commitMessage: "",
-      prSummary: "",
-      feedbackActions: "",
-      planDeviations: "",
-      priorArt: "",
-      failureReason: "agent produced no final message",
-      markerMissing: false
-    };
-  const MARKDOWN_PREFIX = "[\\s>*_#`~\\-]*";
-  const FAILED_RE = new RegExp(`(?:^|\\n)${MARKDOWN_PREFIX}FAILED${MARKDOWN_PREFIX}\\s*:\\s*(.+?)\\s*$`, "is");
-  const DONE_RE = new RegExp(`(?:^|\\n)${MARKDOWN_PREFIX}DONE\\b`, "i");
-  const failedMatch = text.match(FAILED_RE);
-  if (failedMatch) {
-    return {
-      done: false,
-      commitMessage: "",
-      prSummary: "",
-      feedbackActions: "",
-      planDeviations: "",
-      priorArt: "",
-      failureReason: stripMarkdownEmphasis(failedMatch[1]),
-      markerMissing: false
-    };
-  }
-  const hasDoneMarker = DONE_RE.test(text);
-  const hasCommitMsg = /^[\s>*_#`~-]*COMMIT_MSG\s*:/im.test(text);
-  const hasPrSummary = /^[\s>*_#`~-]*PR_SUMMARY\s*:/im.test(text);
-  if (!hasDoneMarker && !hasCommitMsg && !hasPrSummary) {
-    const tail = text.length > 400 ? `\u2026${text.slice(-400)}` : text;
-    return {
-      done: false,
-      commitMessage: "",
-      prSummary: "",
-      feedbackActions: "",
-      planDeviations: "",
-      priorArt: "",
-      failureReason: `no DONE or FAILED marker in agent output \u2014 agent tail: ${tail}`,
-      markerMissing: true
-    };
-  }
-  const commitMatch = text.match(/^[\s>*_#`~-]*COMMIT_MSG[\s>*_#`~-]*\s*:\s*(.+)$/im);
-  const commitMessage = commitMatch ? stripMarkdownEmphasis(commitMatch[1]) : "";
-  const feedbackActions = extractBlock(
-    text,
-    /(?:^|\n)[ \t]*FEEDBACK_ACTIONS\s*:[ \t]*\n/i,
-    /(?:^|\n)[ \t]*(?:PLAN_DEVIATIONS|COMMIT_MSG|PR_SUMMARY|PRIOR_ART)\s*:/i
-  );
-  let planDeviations = extractBlock(
-    text,
-    /(?:^|\n)[ \t]*PLAN_DEVIATIONS\s*:[ \t]*\n/i,
-    /(?:^|\n)[ \t]*(?:COMMIT_MSG|PR_SUMMARY|FEEDBACK_ACTIONS|PRIOR_ART)\s*:/i
-  );
-  if (!planDeviations) {
-    const inline = text.match(/(?:^|\n)[ \t]*PLAN_DEVIATIONS\s*:[ \t]*(.+?)[ \t]*(?:\n|$)/i);
-    if (inline) planDeviations = inline[1].trim();
-  }
-  let priorArt = "";
-  const priorArtInline = text.match(/(?:^|\n)[ \t]*PRIOR_ART\s*:[ \t]*(.+?)[ \t]*(?:\n|$)/i);
-  if (priorArtInline) priorArt = priorArtInline[1].trim();
-  const summaryStart = text.search(/(^|\n)[ \t]*PR_SUMMARY\s*:[ \t]*\n/i);
-  let prSummary = "";
-  if (summaryStart !== -1) {
-    const afterMarker = text.slice(summaryStart).replace(/^[\s\S]*?PR_SUMMARY\s*:[ \t]*\n/i, "");
-    prSummary = afterMarker.replace(/\n\s*```\s*$/g, "").replace(/```\s*$/g, "").trim();
-  }
-  return {
-    done: true,
-    commitMessage,
-    prSummary,
-    feedbackActions,
-    planDeviations,
-    priorArt,
-    failureReason: "",
-    markerMissing: false
-  };
-}
-function stripMarkdownEmphasis(s) {
-  return s.trim().replace(/^[*_`~]+|[*_`~]+$/g, "").trim();
-}
-function extractBlock(text, startMarker, endMarker) {
-  const startIdx = text.search(startMarker);
-  if (startIdx === -1) return "";
-  const afterStart = text.slice(startIdx).replace(startMarker, "");
-  const endIdx = afterStart.search(endMarker);
-  const body = endIdx === -1 ? afterStart : afterStart.slice(0, endIdx);
-  return body.replace(/\n\s*```\s*$/g, "").trim();
-}
-
 // src/scripts/checkCoverageWithRetry.ts
 var checkCoverageWithRetry = async (ctx) => {
   const reqs = ctx.data.coverageRules ?? [];
@@ -4119,6 +4145,8 @@ function parseFlatYaml(text) {
     const value = stripQuotes(line.slice(colon + 1).trim());
     if (key === "every" && isScheduleEvery(value)) {
       out.every = value;
+    } else if (key === "tickScript" && value.length > 0) {
+      out.tickScript = value;
     }
   }
   return out;
@@ -4493,17 +4521,19 @@ var dispatchJobFileTicks = async (ctx, _profile, args) => {
     const results = [];
     const now = Date.now();
     for (const slug of slugs) {
-      const decision = await decideShouldFire(ctx.cwd, jobsDir, slug, backend, now);
+      const frontmatter = readJobFrontmatter(ctx.cwd, jobsDir, slug);
+      const decision = await decideShouldFire(frontmatter.every, slug, backend, now);
       if (decision.skip) {
         process.stdout.write(`[jobs] \u23ED  skip ${slug}: ${decision.reason}
 `);
         results.push({ slug, exitCode: 0, skipped: true, reason: decision.reason });
         continue;
       }
-      process.stdout.write(`[jobs] \u2192 tick ${slug}
+      const slugTarget = frontmatter.tickScript ? "job-tick-scripted" : targetExecutable;
+      process.stdout.write(`[jobs] \u2192 tick ${slug} (${slugTarget})
 `);
       try {
-        const out = await runExecutable(targetExecutable, {
+        const out = await runExecutable(slugTarget, {
           cliArgs: { [slugArg]: slug },
           cwd: ctx.cwd,
           config: ctx.config,
@@ -4536,14 +4566,7 @@ var dispatchJobFileTicks = async (ctx, _profile, args) => {
     }
   }
 };
-async function decideShouldFire(cwd, jobsDir, slug, backend, now) {
-  let every;
-  try {
-    const raw = fs19.readFileSync(path18.join(cwd, jobsDir, `${slug}.md`), "utf-8");
-    every = splitFrontmatter(raw).frontmatter.every;
-  } catch {
-    return { skip: false, reason: "frontmatter unreadable" };
-  }
+async function decideShouldFire(every, slug, backend, now) {
   if (!every) return { skip: false, reason: "no schedule (every cron tick)" };
   if (every === "manual") {
     return { skip: true, reason: "manual-only (no auto-fire; trigger via dashboard Run now)" };
@@ -4583,6 +4606,14 @@ function formatAgo(ms) {
   const day = Math.round(hr / 24);
   return `${day}d`;
 }
+function readJobFrontmatter(cwd, jobsDir, slug) {
+  try {
+    const raw = fs19.readFileSync(path18.join(cwd, jobsDir, `${slug}.md`), "utf-8");
+    return splitFrontmatter(raw).frontmatter;
+  } catch {
+    return {};
+  }
+}
 function listJobSlugs(absDir) {
   if (!fs19.existsSync(absDir)) return [];
   let entries;
@@ -6268,42 +6299,47 @@ function isPartialEnvelope2(x) {
   const o = x;
   return typeof o.cursor === "string" && o.cursor.length > 0 && typeof o.done === "boolean" && o.data !== null && typeof o.data === "object" && !Array.isArray(o.data);
 }
-var parseJobStateFromAgentResult = async (ctx, _profile, agentResult, args) => {
-  const fenceLabel = String(args?.fenceLabel ?? "");
-  if (!fenceLabel) {
-    throw new Error("parseJobStateFromAgentResult: `with.fenceLabel` is required");
-  }
-  if (!agentResult) {
-    ctx.data.nextStateParseError = "agent did not run";
-    return;
-  }
+function extractNextStateFromText(text, fenceLabel, prevRev) {
   const fenceRegex = new RegExp(`\`\`\`${escapeRegex2(fenceLabel)}\\s*\\n([\\s\\S]*?)\\n\`\`\``, "m");
-  const match = fenceRegex.exec(agentResult.finalText);
+  const match = fenceRegex.exec(text);
   if (!match) {
-    ctx.data.nextStateParseError = `agent did not emit a \`${fenceLabel}\` fenced block`;
-    return;
+    return { error: `missing \`${fenceLabel}\` fenced block` };
   }
   let parsed;
   try {
     parsed = JSON.parse(match[1].trim());
   } catch (err) {
-    ctx.data.nextStateParseError = `state JSON parse error: ${err instanceof Error ? err.message : String(err)}`;
-    return;
+    return { error: `state JSON parse error: ${err instanceof Error ? err.message : String(err)}` };
   }
   if (!isPartialEnvelope2(parsed)) {
-    ctx.data.nextStateParseError = "state must be an object with string `cursor`, object `data`, and boolean `done`";
-    return;
+    return { error: "state must be an object with string `cursor`, object `data`, and boolean `done`" };
   }
-  const loaded = ctx.data.jobState;
-  const prevRev = loaded?.state.rev ?? 0;
-  const next = {
+  const envelope = {
     version: 1,
     rev: prevRev + 1,
     cursor: parsed.cursor,
     data: parsed.data,
     done: parsed.done
   };
-  ctx.data.nextJobState = next;
+  return { envelope };
+}
+var parseJobStateFromAgentResult = async (ctx, _profile, agentResult, args) => {
+  const fenceLabel = String(args?.fenceLabel ?? "");
+  if (!fenceLabel) {
+    throw new Error("parseJobStateFromAgentResult: `with.fenceLabel` is required");
+  }
+  if (!agentResult) {
+    ctx.data.nextStateParseError = "agent did not run";
+    return;
+  }
+  const loaded = ctx.data.jobState;
+  const prevRev = loaded?.state.rev ?? 0;
+  const result = extractNextStateFromText(agentResult.finalText, fenceLabel, prevRev);
+  if (result.error) {
+    ctx.data.nextStateParseError = result.error.startsWith("missing `") ? `agent did not emit a \`${fenceLabel}\` fenced block` : result.error;
+    return;
+  }
+  ctx.data.nextJobState = result.envelope;
 };
 function escapeRegex2(s) {
   return s.replace(/[-/\\^$*+?.()|[\]{}]/g, "\\$&");
@@ -7189,6 +7225,137 @@ function resolveBaseFromLabels(labels) {
   return `goal-${goalId}`;
 }
 
+// src/scripts/runTickScript.ts
+import { spawnSync } from "child_process";
+import * as fs25 from "fs";
+import * as path23 from "path";
+var runTickScript = async (ctx, _profile, args) => {
+  ctx.skipAgent = true;
+  const jobsDir = String(args?.jobsDir ?? ".kody/jobs");
+  const slugArg = String(args?.slugArg ?? "job");
+  const fenceLabel = String(args?.fenceLabel ?? "kody-job-next-state");
+  const slug = String(ctx.args[slugArg] ?? "").trim();
+  if (!slug) {
+    ctx.output.exitCode = 99;
+    ctx.output.reason = `runTickScript: ctx.args.${slugArg} must be a non-empty slug`;
+    return;
+  }
+  const jobPath = path23.join(ctx.cwd, jobsDir, `${slug}.md`);
+  if (!fs25.existsSync(jobPath)) {
+    ctx.output.exitCode = 99;
+    ctx.output.reason = `runTickScript: job file not found: ${jobPath}`;
+    return;
+  }
+  const raw = fs25.readFileSync(jobPath, "utf-8");
+  const { frontmatter } = splitFrontmatter(raw);
+  const tickScript = frontmatter.tickScript;
+  if (!tickScript) {
+    ctx.output.exitCode = 99;
+    ctx.output.reason = `runTickScript: job ${slug} has no \`tickScript:\` frontmatter \u2014 route via job-tick instead`;
+    return;
+  }
+  const scriptPath = path23.isAbsolute(tickScript) ? tickScript : path23.join(ctx.cwd, tickScript);
+  if (!fs25.existsSync(scriptPath)) {
+    ctx.output.exitCode = 99;
+    ctx.output.reason = `runTickScript: tickScript not found: ${scriptPath}`;
+    return;
+  }
+  const backend = resolveBackend({ config: ctx.config, cwd: ctx.cwd, jobsDir });
+  let loaded;
+  try {
+    loaded = await backend.load(slug);
+  } catch (err) {
+    ctx.output.exitCode = 99;
+    ctx.output.reason = `runTickScript: state load failed: ${err instanceof Error ? err.message : String(err)}`;
+    return;
+  }
+  ctx.data.jobSlug = slug;
+  ctx.data.jobState = loaded;
+  const childEnv = buildChildEnv(process.env, Boolean(ctx.args.force));
+  const result = spawnSync("bash", [scriptPath], {
+    cwd: ctx.cwd,
+    env: childEnv,
+    stdio: ["ignore", "pipe", "pipe"],
+    encoding: "utf-8",
+    timeout: 5 * 60 * 1e3,
+    // Default maxBuffer is 1MB — a chatty `gh pr list --json …` over a
+    // busy repo (or an accidental `set -x`) can blow that and silently
+    // truncate stdout, which is the exact "silent state drop" failure
+    // mode this whole executable was written to prevent. 16MB is well
+    // above any realistic tick output.
+    maxBuffer: 16 * 1024 * 1024
+  });
+  if (result.stdout) process.stdout.write(result.stdout);
+  if (result.stderr) process.stderr.write(result.stderr);
+  if (result.error) {
+    ctx.output.exitCode = 99;
+    ctx.output.reason = `runTickScript: spawn error: ${result.error.message}`;
+    return;
+  }
+  if (result.signal) {
+    ctx.output.exitCode = 124;
+    ctx.output.reason = `runTickScript: ${tickScript} killed by ${result.signal} (likely 5min timeout)`;
+    return;
+  }
+  if (result.status !== 0) {
+    ctx.output.exitCode = result.status ?? 99;
+    ctx.output.reason = `runTickScript: ${tickScript} exited ${result.status}`;
+    return;
+  }
+  const prevRev = loaded.state.rev ?? 0;
+  const parsed = extractNextStateFromText(result.stdout ?? "", fenceLabel, prevRev);
+  if (parsed.error) {
+    ctx.data.nextStateParseError = parsed.error;
+    ctx.output.exitCode = 1;
+    ctx.output.reason = `runTickScript: ${parsed.error}`;
+    return;
+  }
+  ctx.data.nextJobState = parsed.envelope;
+};
+function buildChildEnv(parent, force) {
+  const allow = /* @__PURE__ */ new Set([
+    "PATH",
+    "HOME",
+    "USER",
+    "LOGNAME",
+    "SHELL",
+    "TMPDIR",
+    "LANG",
+    "LC_ALL",
+    "TERM",
+    // GitHub auth — `gh` reads these.
+    "GH_TOKEN",
+    "GH_PAT",
+    "GITHUB_TOKEN",
+    // CI metadata commonly read by tick scripts (`gh repo view`,
+    // workflow run links, etc.). All public values from GitHub Actions.
+    "GITHUB_ACTIONS",
+    "GITHUB_ACTOR",
+    "GITHUB_REPOSITORY",
+    "GITHUB_REPOSITORY_OWNER",
+    "GITHUB_REF",
+    "GITHUB_SHA",
+    "GITHUB_RUN_ID",
+    "GITHUB_RUN_NUMBER",
+    "GITHUB_WORKFLOW",
+    "GITHUB_JOB",
+    "GITHUB_SERVER_URL",
+    "GITHUB_API_URL",
+    "GITHUB_EVENT_NAME",
+    "RUNNER_OS",
+    "RUNNER_ARCH"
+  ]);
+  const out = {};
+  for (const [key, value] of Object.entries(parent)) {
+    if (value === void 0) continue;
+    if (allow.has(key) || key.startsWith("KODY_PUBLIC_")) {
+      out[key] = value;
+    }
+  }
+  if (force) out.KODY_FORCE = "1";
+  return out;
+}
+
 // src/scripts/saveTaskState.ts
 var saveTaskState = async (ctx, profile) => {
   const target = ctx.data.commentTargetType;
@@ -7971,7 +8138,7 @@ var writeJobStateFile = async (ctx, _profile, _agentResult, args) => {
 };
 
 // src/scripts/writeRunSummary.ts
-import * as fs25 from "fs";
+import * as fs26 from "fs";
 var writeRunSummary = async (ctx, profile) => {
   const summaryPath = process.env.GITHUB_STEP_SUMMARY;
   if (!summaryPath) return;
@@ -7993,7 +8160,7 @@ var writeRunSummary = async (ctx, profile) => {
   if (reason) lines.push(`- **Reason:** ${reason}`);
   lines.push("");
   try {
-    fs25.appendFileSync(summaryPath, `${lines.join("\n")}
+    fs26.appendFileSync(summaryPath, `${lines.join("\n")}
 `);
   } catch {
   }
@@ -8031,7 +8198,8 @@ var preflightScripts = {
   diagMcp,
   warmupMcp,
   dispatchJobTicks,
-  dispatchJobFileTicks
+  dispatchJobFileTicks,
+  runTickScript
 };
 var postflightScripts = {
   parseAgentResult: parseAgentResult2,
@@ -8180,9 +8348,9 @@ async function runExecutable(profileName, input) {
     data: {},
     output: { exitCode: 0 }
   };
-  const ndjsonDir = path23.join(input.cwd, ".kody");
+  const ndjsonDir = path24.join(input.cwd, ".kody");
   const invokeAgent = async (prompt) => {
-    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path23.isAbsolute(p) ? p : path23.resolve(profile.dir, p)).filter((p) => p.length > 0);
+    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path24.isAbsolute(p) ? p : path24.resolve(profile.dir, p)).filter((p) => p.length > 0);
     const syntheticPath = ctx.data.syntheticPluginPath;
     const pluginPaths = [...externalPlugins, ...syntheticPath ? [syntheticPath] : []];
     return runAgent({
@@ -8228,6 +8396,7 @@ async function runExecutable(profileName, input) {
         return finish({ exitCode: 99, reason: "composePrompt did not produce a prompt (ctx.data.prompt missing)" });
       }
       agentResult = await invokeAgent(prompt);
+      agentResult = await rescueMissingMarker(agentResult, invokeAgent);
     }
     for (const entry of profile.scripts.postflight) {
       const entryLabel = entry.script ?? entry.shell ?? "<unknown>";
@@ -8291,17 +8460,17 @@ function clearStampedLifecycleLabels(profile, ctx) {
 function resolveProfilePath(profileName) {
   const found = resolveExecutable(profileName);
   if (found) return found;
-  const here = path23.dirname(new URL(import.meta.url).pathname);
+  const here = path24.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path23.join(here, "executables", profileName, "profile.json"),
+    path24.join(here, "executables", profileName, "profile.json"),
     // same-dir sibling (dev)
-    path23.join(here, "..", "executables", profileName, "profile.json"),
+    path24.join(here, "..", "executables", profileName, "profile.json"),
     // up one (prod: dist/bin → dist/executables)
-    path23.join(here, "..", "src", "executables", profileName, "profile.json")
+    path24.join(here, "..", "src", "executables", profileName, "profile.json")
     // fallback
   ];
   for (const c of candidates) {
-    if (fs26.existsSync(c)) return c;
+    if (fs27.existsSync(c)) return c;
   }
   return candidates[0];
 }
@@ -8405,8 +8574,8 @@ function resolveShellTimeoutMs(entry) {
 var SIGKILL_GRACE_MS = 5e3;
 async function runShellEntry(entry, ctx, profile) {
   const shellName = entry.shell;
-  const shellPath = path23.join(profile.dir, shellName);
-  if (!fs26.existsSync(shellPath)) {
+  const shellPath = path24.join(profile.dir, shellName);
+  if (!fs27.existsSync(shellPath)) {
     ctx.skipAgent = true;
     ctx.output.exitCode = 99;
     ctx.output.reason = `shell script not found: ${shellName} (looked in ${profile.dir})`;
@@ -8819,9 +8988,9 @@ function resolveAuthToken(env = process.env) {
   return token;
 }
 function detectPackageManager2(cwd) {
-  if (fs27.existsSync(path24.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs27.existsSync(path24.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs27.existsSync(path24.join(cwd, "bun.lockb"))) return "bun";
+  if (fs28.existsSync(path25.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs28.existsSync(path25.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs28.existsSync(path25.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function shellOut(cmd, args, cwd, stream = true) {
@@ -8908,11 +9077,11 @@ function configureGitIdentity(cwd) {
 }
 function postFailureTail(issueNumber, cwd, reason) {
   if (!issueNumber) return;
-  const logPath = path24.join(cwd, ".kody", "last-run.jsonl");
+  const logPath = path25.join(cwd, ".kody", "last-run.jsonl");
   let tail = "";
   try {
-    if (fs27.existsSync(logPath)) {
-      const content = fs27.readFileSync(logPath, "utf-8");
+    if (fs28.existsSync(logPath)) {
+      const content = fs28.readFileSync(logPath, "utf-8");
       tail = content.slice(-3e3);
     }
   } catch {
@@ -8937,7 +9106,7 @@ async function runCi(argv) {
     return 0;
   }
   const args = parseCiArgs(argv);
-  const cwd = args.cwd ? path24.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path25.resolve(args.cwd) : process.cwd();
   let earlyConfig;
   try {
     earlyConfig = loadConfig(cwd);
@@ -8947,9 +9116,9 @@ async function runCi(argv) {
   const eventName = process.env.GITHUB_EVENT_NAME;
   const dispatchEventPath = process.env.GITHUB_EVENT_PATH;
   let manualWorkflowDispatch = false;
-  if (!args.issueNumber && !autoFallback && eventName === "workflow_dispatch" && dispatchEventPath && fs27.existsSync(dispatchEventPath)) {
+  if (!args.issueNumber && !autoFallback && eventName === "workflow_dispatch" && dispatchEventPath && fs28.existsSync(dispatchEventPath)) {
     try {
-      const evt = JSON.parse(fs27.readFileSync(dispatchEventPath, "utf-8"));
+      const evt = JSON.parse(fs28.readFileSync(dispatchEventPath, "utf-8"));
       const issueInput = parseInt(String(evt?.inputs?.issue_number ?? ""), 10);
       const sessionInput = String(evt?.inputs?.sessionId ?? "");
       manualWorkflowDispatch = !sessionInput && !(Number.isFinite(issueInput) && issueInput > 0);
@@ -9164,9 +9333,9 @@ function parseChatArgs(argv, env = process.env) {
   return result;
 }
 function commitChatFiles(cwd, sessionId, verbose) {
-  const sessionFile = path25.relative(cwd, sessionFilePath(cwd, sessionId));
-  const eventsFile = path25.relative(cwd, eventsFilePath(cwd, sessionId));
-  const paths = [sessionFile, eventsFile].filter((p) => fs28.existsSync(path25.join(cwd, p)));
+  const sessionFile = path26.relative(cwd, sessionFilePath(cwd, sessionId));
+  const eventsFile = path26.relative(cwd, eventsFilePath(cwd, sessionId));
+  const paths = [sessionFile, eventsFile].filter((p) => fs29.existsSync(path26.join(cwd, p)));
   if (paths.length === 0) return;
   const opts = { cwd, stdio: verbose ? "inherit" : "pipe" };
   try {
@@ -9204,7 +9373,7 @@ async function runChat(argv) {
 ${CHAT_HELP}`);
     return 64;
   }
-  const cwd = args.cwd ? path25.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path26.resolve(args.cwd) : process.cwd();
   const sessionId = args.sessionId;
   const unpackedSecrets = unpackAllSecrets();
   if (unpackedSecrets > 0) {
@@ -9256,7 +9425,7 @@ ${CHAT_HELP}`);
   const sink = buildSink(cwd, sessionId, args.dashboardUrl);
   const meta = readMeta(sessionFile);
   process.stdout.write(
-    `\u2192 kody:chat: session file=${sessionFile} exists=${fs28.existsSync(sessionFile)} meta=${meta ? meta.mode : "none"}
+    `\u2192 kody:chat: session file=${sessionFile} exists=${fs29.existsSync(sessionFile)} meta=${meta ? meta.mode : "none"}
 `
   );
   try {

package/dist/executables/job-tick-scripted/profile.json

@@ -0,0 +1,69 @@
+{
+  "name": "job-tick-scripted",
+  "role": "utility",
+  "describe": "Deterministic job tick: runs the slug's `tickScript:` (declared in job frontmatter), parses next-state from its stdout, persists. No agent.",
+  "kind": "oneshot",
+  "inputs": [
+    {
+      "name": "job",
+      "flag": "--job",
+      "type": "string",
+      "required": true,
+      "describe": "Job slug — basename (without .md) of the file under .kody/jobs/."
+    },
+    {
+      "name": "force",
+      "flag": "--force",
+      "type": "bool",
+      "describe": "Accepted for parity with `job-tick`. Scripted ticks have no agent cadence guard to bypass — the dispatcher already gated on frontmatter `every:`. Forwarded to the script via env if it cares."
+    }
+  ],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "default",
+    "maxTurns": null,
+    "maxThinkingTokens": null,
+    "systemPromptAppend": null,
+    "tools": [],
+    "hooks": [],
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [
+    {
+      "name": "gh",
+      "install": {
+        "required": true,
+        "checkCommand": "command -v gh"
+      },
+      "verify": "gh auth status",
+      "usage": "Available to the tickScript via PATH; this executable shells out to `bash <tickScript>`. Scripts use `gh pr list`, `gh pr comment`, etc.",
+      "allowedUses": ["pr", "api", "issue"]
+    }
+  ],
+  "inputArtifacts": [],
+  "outputArtifacts": [],
+  "scripts": {
+    "preflight": [
+      {
+        "script": "runTickScript",
+        "with": {
+          "jobsDir": ".kody/jobs",
+          "slugArg": "job",
+          "fenceLabel": "kody-job-next-state"
+        }
+      }
+    ],
+    "postflight": [
+      {
+        "script": "writeJobStateFile",
+        "with": {
+          "jobsDir": ".kody/jobs"
+        }
+      }
+    ]
+  }
+}

package/package.json

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