@kody-ade/kody-engine 0.2.7 → 0.2.8

package/dist/bin/kody2.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.2.7",
+  version: "0.2.8",
   description: "kody2 \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -1962,10 +1962,201 @@ var loadCoverageRules = async (ctx) => {
   ctx.data.coverageRules = ctx.config.testRequirements ?? [];
 };
 
+// src/state.ts
+import { execFileSync as execFileSync10 } from "child_process";
+var STATE_BEGIN = "<!-- kody2:state:v1:begin -->";
+var STATE_END = "<!-- kody2:state:v1:end -->";
+var HISTORY_MAX_ENTRIES = 20;
+var API_TIMEOUT_MS2 = 3e4;
+function emptyState() {
+  return {
+    schemaVersion: 1,
+    core: {
+      phase: "idle",
+      status: "pending",
+      currentExecutable: null,
+      lastOutcome: null,
+      attempts: {}
+    },
+    executables: {},
+    history: []
+  };
+}
+function ghToken3() {
+  return process.env.GH_PAT?.trim() || process.env.GH_TOKEN;
+}
+function gh3(args, input, cwd) {
+  const token = ghToken3();
+  const env = token ? { ...process.env, GH_TOKEN: token } : { ...process.env };
+  return execFileSync10("gh", args, {
+    encoding: "utf-8",
+    timeout: API_TIMEOUT_MS2,
+    cwd,
+    env,
+    input,
+    stdio: input ? ["pipe", "pipe", "pipe"] : ["ignore", "pipe", "pipe"]
+  }).trim();
+}
+function findStateComment(target, number, cwd) {
+  const apiPath = target === "issue" ? `repos/{owner}/{repo}/issues/${number}/comments` : `repos/{owner}/{repo}/issues/${number}/comments`;
+  try {
+    const raw = gh3(["api", "--paginate", apiPath], void 0, cwd);
+    const list = JSON.parse(raw);
+    for (const c of list) {
+      if (c.body?.includes(STATE_BEGIN)) {
+        return { id: String(c.id), body: c.body };
+      }
+    }
+  } catch {
+  }
+  return null;
+}
+function parseStateComment(body) {
+  const beginIdx = body.indexOf(STATE_BEGIN);
+  const endIdx = body.indexOf(STATE_END, beginIdx + 1);
+  if (beginIdx < 0 || endIdx < 0) return emptyState();
+  const between = body.slice(beginIdx + STATE_BEGIN.length, endIdx);
+  const fenceMatch = between.match(/```json\s*([\s\S]*?)\s*```/);
+  if (!fenceMatch) return emptyState();
+  try {
+    const parsed = JSON.parse(fenceMatch[1]);
+    if (parsed?.schemaVersion !== 1) return emptyState();
+    return {
+      schemaVersion: 1,
+      core: { ...emptyState().core, ...parsed.core },
+      executables: parsed.executables ?? {},
+      history: Array.isArray(parsed.history) ? parsed.history : []
+    };
+  } catch {
+    return emptyState();
+  }
+}
+function reduce(state, executable, action) {
+  if (!action) return state;
+  const newAttempts = { ...state.core.attempts, [executable]: (state.core.attempts[executable] ?? 0) + 1 };
+  const newExecutables = {
+    ...state.executables,
+    [executable]: { ...state.executables[executable] ?? { lastAction: null }, lastAction: action }
+  };
+  const newHistory = [
+    ...state.history,
+    { timestamp: action.timestamp, executable, action: action.type, note: noteFromAction(action) }
+  ].slice(-HISTORY_MAX_ENTRIES);
+  return {
+    schemaVersion: 1,
+    core: {
+      ...state.core,
+      attempts: newAttempts,
+      lastOutcome: action,
+      currentExecutable: executable,
+      status: statusFromAction(action),
+      phase: phaseFromAction(executable, action)
+    },
+    executables: newExecutables,
+    history: newHistory
+  };
+}
+function statusFromAction(action) {
+  if (/FAILED$|ERROR$|MISSING$|REJECTED$/i.test(action.type)) return "failed";
+  if (/COMPLETED$|SHIPPED$|MERGED$|SUCCESS$/i.test(action.type)) return "succeeded";
+  return "running";
+}
+function phaseFromAction(executable, action) {
+  if (/FAILED$|ERROR$|REJECTED$/i.test(action.type)) return "failed";
+  if (executable === "build") return statusFromAction(action) === "succeeded" ? "implementing" : "implementing";
+  if (executable === "review") return "reviewing";
+  if (executable === "release") return "shipped";
+  return "idle";
+}
+function noteFromAction(action) {
+  const p = action.payload;
+  if (typeof p?.prUrl === "string") return p.prUrl;
+  if (typeof p?.reason === "string") return p.reason.slice(0, 120);
+  if (typeof p?.commitMessage === "string") return p.commitMessage.slice(0, 120);
+  return void 0;
+}
+function renderStateComment(state) {
+  const lines = [];
+  lines.push(STATE_BEGIN);
+  lines.push("");
+  lines.push("```json");
+  lines.push(JSON.stringify(
+    { schemaVersion: state.schemaVersion, core: state.core, executables: state.executables, history: state.history },
+    null,
+    2
+  ));
+  lines.push("```");
+  lines.push("");
+  lines.push(STATE_END);
+  lines.push("");
+  lines.push("## kody2 task state");
+  lines.push("");
+  lines.push(`- **Phase:** \`${state.core.phase}\`  **Status:** \`${state.core.status}\``);
+  if (state.core.currentExecutable) {
+    lines.push(`- **Last executable:** \`${state.core.currentExecutable}\``);
+  }
+  if (state.core.lastOutcome) {
+    lines.push(`- **Last action:** \`${state.core.lastOutcome.type}\``);
+  }
+  const attempts = Object.entries(state.core.attempts).map(([k, v]) => `${k}:${v}`).join(", ");
+  if (attempts) lines.push(`- **Attempts:** ${attempts}`);
+  if (state.core.prUrl) lines.push(`- **PR:** ${state.core.prUrl}`);
+  if (state.core.runUrl) lines.push(`- **Run:** ${state.core.runUrl}`);
+  lines.push("");
+  if (state.history.length > 0) {
+    lines.push("### Recent history");
+    lines.push("");
+    const recent = state.history.slice(-10).reverse();
+    for (const h of recent) {
+      const note = h.note ? ` \u2014 ${h.note}` : "";
+      lines.push(`- \`${h.timestamp}\` **${h.executable}** \u2192 \`${h.action}\`${note}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function readTaskState(target, number, cwd) {
+  const existing = findStateComment(target, number, cwd);
+  return existing ? parseStateComment(existing.body) : emptyState();
+}
+function writeTaskState(target, number, state, cwd) {
+  const body = renderStateComment(state);
+  const existing = findStateComment(target, number, cwd);
+  try {
+    if (existing) {
+      gh3(
+        ["api", `repos/{owner}/{repo}/issues/comments/${existing.id}`, "-X", "PATCH", "-F", "body=@-"],
+        body,
+        cwd
+      );
+    } else {
+      const sub = target === "issue" ? "issue" : "pr";
+      gh3([sub, "comment", String(number), "--body-file", "-"], body, cwd);
+    }
+  } catch (err) {
+    process.stderr.write(
+      `[kody2 state] failed to write state on ${target} #${number}: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+}
+
+// src/scripts/loadTaskState.ts
+var loadTaskState = async (ctx) => {
+  const target = ctx.data.commentTargetType;
+  const number = ctx.data.commentTargetNumber;
+  if (!target || !number) {
+    ctx.data.taskState = emptyState();
+    return;
+  }
+  ctx.data.taskState = readTaskState(target, number, ctx.cwd);
+};
+
 // src/scripts/parseAgentResult.ts
-var parseAgentResult2 = async (ctx, _profile, agentResult) => {
+var parseAgentResult2 = async (ctx, profile, agentResult) => {
   if (!agentResult) {
     ctx.data.agentDone = false;
+    ctx.data.action = makeAction("AGENT_NOT_RUN", { reason: "no agent result" });
     return;
   }
   const parsed = parseAgentResult(agentResult.finalText);
@@ -1975,7 +2166,21 @@ var parseAgentResult2 = async (ctx, _profile, agentResult) => {
   ctx.data.agentFailureReason = parsed.failureReason;
   ctx.data.agentOutcome = agentResult.outcome;
   ctx.data.agentError = agentResult.error;
+  const modeSeg = (ctx.args.mode ?? profile.name).replace(/-/g, "_").toUpperCase();
+  if (parsed.done) {
+    ctx.data.action = makeAction(`${modeSeg}_COMPLETED`, {
+      commitMessage: parsed.commitMessage,
+      prSummary: parsed.prSummary
+    });
+  } else {
+    ctx.data.action = makeAction(`${modeSeg}_FAILED`, {
+      reason: parsed.failureReason || agentResult.error || "unknown failure"
+    });
+  }
 };
+function makeAction(type, payload) {
+  return { type, payload, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
+}
 
 // src/scripts/postIssueComment.ts
 var postIssueComment2 = async (ctx) => {
@@ -2079,7 +2284,7 @@ REVIEW_POSTED=https://github.com/${ctx.config.github.owner}/${ctx.config.github.
 };
 
 // src/scripts/releaseFlow.ts
-import { execFileSync as execFileSync10, spawnSync } from "child_process";
+import { execFileSync as execFileSync11, spawnSync } from "child_process";
 import * as fs11 from "fs";
 import * as path10 from "path";
 function bumpVersion(current, bump) {
@@ -2109,7 +2314,7 @@ function generateChangelog(cwd, newVersion, lastTag) {
   const range = lastTag ? `${lastTag}..HEAD` : "HEAD";
   let log = "";
   try {
-    log = execFileSync10("git", ["log", range, "--pretty=format:%s||%h", "--no-merges"], {
+    log = execFileSync11("git", ["log", range, "--pretty=format:%s||%h", "--no-merges"], {
       cwd,
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "pipe"]
@@ -2166,7 +2371,7 @@ ${entry}${prior.slice(idx + 1)}`);
   }
 }
 function git3(args, cwd, timeout = 6e4) {
-  return execFileSync10("git", args, {
+  return execFileSync11("git", args, {
     encoding: "utf-8",
     timeout,
     cwd,
@@ -2381,7 +2586,7 @@ ${truncate2(r.stderr, 2e3)}
 }
 
 // src/scripts/resolveFlow.ts
-import { execFileSync as execFileSync11 } from "child_process";
+import { execFileSync as execFileSync12 } from "child_process";
 var CONFLICT_DIFF_MAX_BYTES = 4e4;
 var resolveFlow = async (ctx) => {
   const prNumber = ctx.args.pr;
@@ -2433,7 +2638,7 @@ var resolveFlow = async (ctx) => {
 };
 function getConflictedFiles(cwd) {
   try {
-    const out = execFileSync11("git", ["diff", "--name-only", "--diff-filter=U"], {
+    const out = execFileSync12("git", ["diff", "--name-only", "--diff-filter=U"], {
       encoding: "utf-8",
       cwd,
       env: { ...process.env, HUSKY: "0" }
@@ -2448,7 +2653,7 @@ function getConflictMarkersPreview(files, cwd, maxBytes = CONFLICT_DIFF_MAX_BYTE
   let total = 0;
   for (const f of files) {
     try {
-      const content = execFileSync11("cat", [f], { encoding: "utf-8", cwd }).toString();
+      const content = execFileSync12("cat", [f], { encoding: "utf-8", cwd }).toString();
       const snippet = `### ${f}
 
 \`\`\`
@@ -2528,6 +2733,35 @@ function tryPost(issueNumber, body, cwd) {
   }
 }
 
+// src/scripts/saveTaskState.ts
+var saveTaskState = async (ctx, profile) => {
+  const target = ctx.data.commentTargetType;
+  const number = ctx.data.commentTargetNumber;
+  const state = ctx.data.taskState;
+  if (!target || !number || !state) return;
+  const executable = profile.name;
+  const action = ctx.data.action ?? synthesizeAction(ctx);
+  if (ctx.output.prUrl && !state.core.prUrl) state.core.prUrl = ctx.output.prUrl;
+  if (typeof ctx.data.runUrl === "string") state.core.runUrl = ctx.data.runUrl;
+  const next = reduce(state, executable, action);
+  if (ctx.output.prUrl) next.core.prUrl = ctx.output.prUrl;
+  if (typeof ctx.data.runUrl === "string") next.core.runUrl = ctx.data.runUrl;
+  writeTaskState(target, number, next, ctx.cwd);
+  ctx.data.taskStateRendered = renderStateComment(next);
+};
+function synthesizeAction(ctx) {
+  const ok = ctx.output.exitCode === 0;
+  return {
+    type: ok ? "RUN_COMPLETED" : "RUN_FAILED",
+    payload: {
+      exitCode: ctx.output.exitCode,
+      reason: ctx.output.reason,
+      prUrl: ctx.output.prUrl
+    },
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+
 // src/verify.ts
 import { spawn as spawn2 } from "child_process";
 var TAIL_CHARS = 4e3;
@@ -2730,6 +2964,7 @@ var preflightScripts = {
   initFlow,
   releaseFlow,
   watchStalePrsFlow,
+  loadTaskState,
   loadConventions,
   loadCoverageRules,
   composePrompt
@@ -2742,7 +2977,8 @@ var postflightScripts = {
   ensurePr: ensurePr2,
   postIssueComment: postIssueComment2,
   postReviewResult,
-  writeRunSummary
+  writeRunSummary,
+  saveTaskState
 };
 var allScriptNames = /* @__PURE__ */ new Set([
   ...Object.keys(preflightScripts),
@@ -2750,7 +2986,7 @@ var allScriptNames = /* @__PURE__ */ new Set([
 ]);
 
 // src/tools.ts
-import { execFileSync as execFileSync12 } from "child_process";
+import { execFileSync as execFileSync13 } from "child_process";
 function verifyCliTools(tools, cwd) {
   const out = [];
   for (const t of tools) out.push(verifyOne(t, cwd));
@@ -2783,7 +3019,7 @@ function verifyOne(tool, cwd) {
 }
 function runShell2(cmd, cwd, timeoutMs = 3e4) {
   try {
-    execFileSync12("sh", ["-c", cmd], { cwd, stdio: "pipe", timeout: timeoutMs });
+    execFileSync13("sh", ["-c", cmd], { cwd, stdio: "pipe", timeout: timeoutMs });
     return true;
   } catch {
     return false;
@@ -2981,7 +3217,7 @@ function finish(out) {
 }
 
 // src/kody2-cli.ts
-import { execFileSync as execFileSync13 } from "child_process";
+import { execFileSync as execFileSync14 } from "child_process";
 import * as fs15 from "fs";
 import * as path12 from "path";
 
@@ -3126,7 +3362,7 @@ function detectPackageManager2(cwd) {
 }
 function shellOut(cmd, args, cwd, stream = true) {
   try {
-    execFileSync13(cmd, args, {
+    execFileSync14(cmd, args, {
       cwd,
       stdio: stream ? "inherit" : "pipe",
       env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1", CI: process.env.CI ?? "1" }
@@ -3139,7 +3375,7 @@ function shellOut(cmd, args, cwd, stream = true) {
 }
 function isOnPath(bin) {
   try {
-    execFileSync13("which", [bin], { stdio: "pipe" });
+    execFileSync14("which", [bin], { stdio: "pipe" });
     return true;
   } catch {
     return false;
@@ -3173,7 +3409,7 @@ function installLitellmIfNeeded(cwd) {
   } catch {
   }
   try {
-    execFileSync13("python3", ["-c", "import litellm"], { stdio: "pipe" });
+    execFileSync14("python3", ["-c", "import litellm"], { stdio: "pipe" });
     process.stdout.write("\u2192 kody2: litellm already installed\n");
     return 0;
   } catch {
@@ -3183,16 +3419,16 @@ function installLitellmIfNeeded(cwd) {
 }
 function configureGitIdentity(cwd) {
   try {
-    const name = execFileSync13("git", ["config", "user.name"], { cwd, stdio: "pipe", encoding: "utf-8" }).trim();
+    const name = execFileSync14("git", ["config", "user.name"], { cwd, stdio: "pipe", encoding: "utf-8" }).trim();
     if (name) return;
   } catch {
   }
   try {
-    execFileSync13("git", ["config", "user.name", "kody2-bot"], { cwd, stdio: "pipe" });
+    execFileSync14("git", ["config", "user.name", "kody2-bot"], { cwd, stdio: "pipe" });
   } catch {
   }
   try {
-    execFileSync13("git", ["config", "user.email", "kody2-bot@users.noreply.github.com"], { cwd, stdio: "pipe" });
+    execFileSync14("git", ["config", "user.email", "kody2-bot@users.noreply.github.com"], { cwd, stdio: "pipe" });
   } catch {
   }
 }

package/dist/executables/build/profile.json

@@ -67,6 +67,7 @@
       { "script": "fixFlow",     "runWhen": { "args.mode": "fix" } },
       { "script": "fixCiFlow",   "runWhen": { "args.mode": "fix-ci" } },
       { "script": "resolveFlow", "runWhen": { "args.mode": "resolve" } },
+      { "script": "loadTaskState" },
       { "script": "loadConventions" },
       { "script": "loadCoverageRules" },
       { "script": "composePrompt" }
@@ -78,7 +79,21 @@
       { "script": "commitAndPush" },
       { "script": "ensurePr" },
       { "script": "postIssueComment" },
-      { "script": "writeRunSummary" }
+      { "script": "writeRunSummary" },
+      { "script": "saveTaskState" }
+    ]
+  },
+  "output": {
+    "actionTypes": [
+      "RUN_COMPLETED",
+      "RUN_FAILED",
+      "FIX_COMPLETED",
+      "FIX_FAILED",
+      "FIX_CI_COMPLETED",
+      "FIX_CI_FAILED",
+      "RESOLVE_COMPLETED",
+      "RESOLVE_FAILED",
+      "AGENT_NOT_RUN"
     ]
   }
 }

package/package.json

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