@kody-ade/kody-engine 0.4.55 → 0.4.57

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.55",
+  version: "0.4.57",
   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 execFileSync31 } from "child_process";
-import * as fs31 from "fs";
-import * as path29 from "path";
+import * as fs32 from "fs";
+import * as path30 from "path";
 
 // src/chat/events.ts
 import * as fs from "fs";
@@ -472,7 +472,19 @@ async function runAgent(opts) {
       queryOptions.maxThinkingTokens = opts.maxThinkingTokens;
     }
     if (typeof opts.systemPromptAppend === "string" && opts.systemPromptAppend.length > 0) {
-      queryOptions.systemPrompt = { type: "preset", preset: "claude_code", append: opts.systemPromptAppend };
+      const systemPrompt = {
+        type: "preset",
+        preset: "claude_code",
+        append: opts.systemPromptAppend
+      };
+      if (opts.cacheable) systemPrompt.excludeDynamicSections = true;
+      queryOptions.systemPrompt = systemPrompt;
+    } else if (opts.cacheable) {
+      queryOptions.systemPrompt = {
+        type: "preset",
+        preset: "claude_code",
+        excludeDynamicSections: true
+      };
     }
     queryOptions.settingSources = opts.settingSources ?? ["project", "local"];
     const result = query({
@@ -1001,8 +1013,8 @@ async function emit2(sink, type, sessionId, suffix, payload) {
 
 // src/kody-cli.ts
 import { execFileSync as execFileSync30 } from "child_process";
-import * as fs30 from "fs";
-import * as path28 from "path";
+import * as fs31 from "fs";
+import * as path29 from "path";
 
 // src/dispatch.ts
 import * as fs7 from "fs";
@@ -1581,8 +1593,8 @@ function postPrReviewComment(prNumber, body, cwd) {
 
 // src/executor.ts
 import { execFileSync as execFileSync29, spawn as spawn5 } from "child_process";
-import * as fs29 from "fs";
-import * as path27 from "path";
+import * as fs30 from "fs";
+import * as path28 from "path";
 
 // src/events.ts
 import * as crypto from "crypto";
@@ -1779,6 +1791,7 @@ function parseClaudeCode(p, raw) {
     maxThinkingTokens: typeof r.maxThinkingTokens === "number" ? r.maxThinkingTokens : null,
     maxTurnTimeoutSec: typeof r.maxTurnTimeoutSec === "number" ? r.maxTurnTimeoutSec : null,
     systemPromptAppend: typeof r.systemPromptAppend === "string" ? r.systemPromptAppend : null,
+    cacheable: r.cacheable === true,
     tools,
     hooks: Array.isArray(r.hooks) ? r.hooks : [],
     skills: Array.isArray(r.skills) ? r.skills : [],
@@ -5429,6 +5442,19 @@ var finalizeGoal = async (ctx) => {
     return;
   }
   const ordered = [...taskPrs].sort((a, b) => extractIssueNumber(a) - extractIssueNumber(b));
+  for (const pr of ordered) {
+    if (pr.baseRefName === goal.defaultBranch) continue;
+    process.stdout.write(
+      `[goal-tick] retargeting PR #${pr.number} base ${pr.baseRefName} \u2192 ${goal.defaultBranch}
+`
+    );
+    const retarget = editPrBase(pr.number, goal.defaultBranch, ctx.cwd);
+    if (!retarget.ok) {
+      process.stderr.write(`[goal-tick] finalizeGoal: editPrBase #${pr.number} failed: ${retarget.error}
+`);
+      return;
+    }
+  }
   for (const pr of ordered) {
     if (pr.isDraft) {
       process.stdout.write(`[goal-tick] promoting draft PR #${pr.number} \u2192 ready
@@ -5436,18 +5462,6 @@ var finalizeGoal = async (ctx) => {
       const ready = markPrReady(pr.number, ctx.cwd);
       if (!ready.ok) {
         process.stderr.write(`[goal-tick] finalizeGoal: markPrReady #${pr.number} failed: ${ready.error}
-`);
-        return;
-      }
-    }
-    if (pr.baseRefName !== goal.defaultBranch) {
-      process.stdout.write(
-        `[goal-tick] retargeting PR #${pr.number} base ${pr.baseRefName} \u2192 ${goal.defaultBranch}
-`
-      );
-      const retarget = editPrBase(pr.number, goal.defaultBranch, ctx.cwd);
-      if (!retarget.ok) {
-        process.stderr.write(`[goal-tick] finalizeGoal: editPrBase #${pr.number} failed: ${retarget.error}
 `);
         return;
       }
@@ -6297,10 +6311,10 @@ import * as fs24 from "fs";
 import * as path23 from "path";
 var VALID_STATES = /* @__PURE__ */ new Set(["active", "abandoned", "closed", "done"]);
 var GoalStateError = class extends Error {
-  constructor(path30, message) {
-    super(`Invalid goal state at ${path30}:
+  constructor(path31, message) {
+    super(`Invalid goal state at ${path31}:
   ${message}`);
-    this.path = path30;
+    this.path = path31;
     this.name = "GoalStateError";
   }
   path;
@@ -6730,6 +6744,63 @@ function formatReviewComments(raw) {
   }
 }
 
+// src/taskContext.ts
+import * as fs27 from "fs";
+import * as path26 from "path";
+var TASK_CONTEXT_SCHEMA_VERSION = 1;
+function buildTaskContext(args) {
+  return {
+    schemaVersion: TASK_CONTEXT_SCHEMA_VERSION,
+    builtAt: (/* @__PURE__ */ new Date()).toISOString(),
+    runId: args.runId,
+    issue: args.issue,
+    conventions: args.conventions ?? [],
+    priorArt: args.priorArt ?? "",
+    memoryContext: args.memoryContext ?? "",
+    coverageRules: args.coverageRules ?? []
+  };
+}
+function persistTaskContext(cwd, ctx) {
+  try {
+    const dir = path26.join(cwd, ".kody", "runs", ctx.runId);
+    fs27.mkdirSync(dir, { recursive: true });
+    const file = path26.join(dir, "task-context.json");
+    fs27.writeFileSync(file, `${JSON.stringify(ctx, null, 2)}
+`);
+    return file;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`[kody taskContext] persist failed: ${msg}
+`);
+    return null;
+  }
+}
+
+// src/scripts/loadTaskContext.ts
+var loadTaskContext = async (ctx) => {
+  const runId = resolveRunId();
+  const rawIssue = ctx.data.issue;
+  const issue = rawIssue ? {
+    ...rawIssue,
+    commentsFormatted: rawIssue.commentsFormatted ?? "",
+    labelsFormatted: rawIssue.labelsFormatted ?? ""
+  } : void 0;
+  const taskContext = buildTaskContext({
+    runId,
+    issue,
+    conventions: ctx.data.conventions,
+    priorArt: typeof ctx.data.priorArt === "string" ? ctx.data.priorArt : "",
+    memoryContext: typeof ctx.data.memoryContext === "string" ? ctx.data.memoryContext : "",
+    coverageRules: ctx.data.coverageRules
+  });
+  ctx.data.taskContext = taskContext;
+  const persistedPath = persistTaskContext(ctx.cwd, taskContext);
+  if (persistedPath && ctx.verbose) {
+    process.stderr.write(`[kody taskContext] persisted ${persistedPath}
+`);
+  }
+};
+
 // src/scripts/loadTaskState.ts
 var loadTaskState = async (ctx) => {
   const target = ctx.data.commentTargetType;
@@ -8049,8 +8120,8 @@ function resolveBaseOverride(value) {
 
 // src/scripts/runTickScript.ts
 import { spawnSync } from "child_process";
-import * as fs27 from "fs";
-import * as path26 from "path";
+import * as fs28 from "fs";
+import * as path27 from "path";
 var runTickScript = async (ctx, _profile, args) => {
   ctx.skipAgent = true;
   const jobsDir = String(args?.jobsDir ?? ".kody/jobs");
@@ -8062,13 +8133,13 @@ var runTickScript = async (ctx, _profile, args) => {
     ctx.output.reason = `runTickScript: ctx.args.${slugArg} must be a non-empty slug`;
     return;
   }
-  const jobPath = path26.join(ctx.cwd, jobsDir, `${slug}.md`);
-  if (!fs27.existsSync(jobPath)) {
+  const jobPath = path27.join(ctx.cwd, jobsDir, `${slug}.md`);
+  if (!fs28.existsSync(jobPath)) {
     ctx.output.exitCode = 99;
     ctx.output.reason = `runTickScript: job file not found: ${jobPath}`;
     return;
   }
-  const raw = fs27.readFileSync(jobPath, "utf-8");
+  const raw = fs28.readFileSync(jobPath, "utf-8");
   const { frontmatter } = splitFrontmatter(raw);
   const tickScript = frontmatter.tickScript;
   if (!tickScript) {
@@ -8076,8 +8147,8 @@ var runTickScript = async (ctx, _profile, args) => {
     ctx.output.reason = `runTickScript: job ${slug} has no \`tickScript:\` frontmatter \u2014 route via job-tick instead`;
     return;
   }
-  const scriptPath = path26.isAbsolute(tickScript) ? tickScript : path26.join(ctx.cwd, tickScript);
-  if (!fs27.existsSync(scriptPath)) {
+  const scriptPath = path27.isAbsolute(tickScript) ? tickScript : path27.join(ctx.cwd, tickScript);
+  if (!fs28.existsSync(scriptPath)) {
     ctx.output.exitCode = 99;
     ctx.output.reason = `runTickScript: tickScript not found: ${scriptPath}`;
     return;
@@ -9014,7 +9085,7 @@ var writeJobStateFile = async (ctx, _profile, _agentResult, args) => {
 };
 
 // src/scripts/writeRunSummary.ts
-import * as fs28 from "fs";
+import * as fs29 from "fs";
 var writeRunSummary = async (ctx, profile) => {
   const summaryPath = process.env.GITHUB_STEP_SUMMARY;
   if (!summaryPath) return;
@@ -9036,7 +9107,7 @@ var writeRunSummary = async (ctx, profile) => {
   if (reason) lines.push(`- **Reason:** ${reason}`);
   lines.push("");
   try {
-    fs28.appendFileSync(summaryPath, `${lines.join("\n")}
+    fs29.appendFileSync(summaryPath, `${lines.join("\n")}
 `);
   } catch {
   }
@@ -9053,6 +9124,7 @@ var preflightScripts = {
   syncFlow,
   initFlow,
   loadTaskState,
+  loadTaskContext,
   loadIssueContext,
   loadIssueStateComment,
   loadJobFromFile,
@@ -9252,9 +9324,9 @@ async function runExecutable(profileName, input) {
     data: {},
     output: { exitCode: 0 }
   };
-  const ndjsonDir = path27.join(input.cwd, ".kody");
+  const ndjsonDir = path28.join(input.cwd, ".kody");
   const invokeAgent = async (prompt) => {
-    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path27.isAbsolute(p) ? p : path27.resolve(profile.dir, p)).filter((p) => p.length > 0);
+    const externalPlugins = (profile.claudeCode.plugins ?? []).map((p) => path28.isAbsolute(p) ? p : path28.resolve(profile.dir, p)).filter((p) => p.length > 0);
     const syntheticPath = ctx.data.syntheticPluginPath;
     const pluginPaths = [...externalPlugins, ...syntheticPath ? [syntheticPath] : []];
     return runAgent({
@@ -9273,6 +9345,7 @@ async function runExecutable(profileName, input) {
       maxThinkingTokens: profile.claudeCode.maxThinkingTokens,
       maxTurnTimeoutMs: typeof profile.claudeCode.maxTurnTimeoutSec === "number" ? Math.floor(profile.claudeCode.maxTurnTimeoutSec * 1e3) : void 0,
       systemPromptAppend: profile.claudeCode.systemPromptAppend,
+      cacheable: profile.claudeCode.cacheable,
       settingSources: profile.claudeCode.settingSources
     });
   };
@@ -9417,7 +9490,7 @@ function clearStampedLifecycleLabels(profile, ctx) {
 function getProfileInputsForChild(profileName, _cwd) {
   try {
     const profilePath = resolveProfilePath(profileName);
-    if (!fs29.existsSync(profilePath)) return null;
+    if (!fs30.existsSync(profilePath)) return null;
     return loadProfile(profilePath).inputs;
   } catch {
     return null;
@@ -9426,17 +9499,17 @@ function getProfileInputsForChild(profileName, _cwd) {
 function resolveProfilePath(profileName) {
   const found = resolveExecutable(profileName);
   if (found) return found;
-  const here = path27.dirname(new URL(import.meta.url).pathname);
+  const here = path28.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path27.join(here, "executables", profileName, "profile.json"),
+    path28.join(here, "executables", profileName, "profile.json"),
     // same-dir sibling (dev)
-    path27.join(here, "..", "executables", profileName, "profile.json"),
+    path28.join(here, "..", "executables", profileName, "profile.json"),
     // up one (prod: dist/bin → dist/executables)
-    path27.join(here, "..", "src", "executables", profileName, "profile.json")
+    path28.join(here, "..", "src", "executables", profileName, "profile.json")
     // fallback
   ];
   for (const c of candidates) {
-    if (fs29.existsSync(c)) return c;
+    if (fs30.existsSync(c)) return c;
   }
   return candidates[0];
 }
@@ -9533,8 +9606,8 @@ function resolveShellTimeoutMs(entry) {
 var SIGKILL_GRACE_MS = 5e3;
 async function runShellEntry(entry, ctx, profile) {
   const shellName = entry.shell;
-  const shellPath = path27.join(profile.dir, shellName);
-  if (!fs29.existsSync(shellPath)) {
+  const shellPath = path28.join(profile.dir, shellName);
+  if (!fs30.existsSync(shellPath)) {
     ctx.skipAgent = true;
     ctx.output.exitCode = 99;
     ctx.output.reason = `shell script not found: ${shellName} (looked in ${profile.dir})`;
@@ -9979,9 +10052,9 @@ function resolveAuthToken(env = process.env) {
   return token;
 }
 function detectPackageManager2(cwd) {
-  if (fs30.existsSync(path28.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs30.existsSync(path28.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs30.existsSync(path28.join(cwd, "bun.lockb"))) return "bun";
+  if (fs31.existsSync(path29.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs31.existsSync(path29.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs31.existsSync(path29.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function shellOut(cmd, args, cwd, stream = true) {
@@ -10068,11 +10141,11 @@ function configureGitIdentity(cwd) {
 }
 function postFailureTail(issueNumber, cwd, reason) {
   if (!issueNumber) return;
-  const logPath = path28.join(cwd, ".kody", "last-run.jsonl");
+  const logPath = path29.join(cwd, ".kody", "last-run.jsonl");
   let tail = "";
   try {
-    if (fs30.existsSync(logPath)) {
-      const content = fs30.readFileSync(logPath, "utf-8");
+    if (fs31.existsSync(logPath)) {
+      const content = fs31.readFileSync(logPath, "utf-8");
       tail = content.slice(-3e3);
     }
   } catch {
@@ -10097,7 +10170,7 @@ async function runCi(argv) {
     return 0;
   }
   const args = parseCiArgs(argv);
-  const cwd = args.cwd ? path28.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path29.resolve(args.cwd) : process.cwd();
   let earlyConfig;
   try {
     earlyConfig = loadConfig(cwd);
@@ -10107,9 +10180,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 && fs30.existsSync(dispatchEventPath)) {
+  if (!args.issueNumber && !autoFallback && eventName === "workflow_dispatch" && dispatchEventPath && fs31.existsSync(dispatchEventPath)) {
     try {
-      const evt = JSON.parse(fs30.readFileSync(dispatchEventPath, "utf-8"));
+      const evt = JSON.parse(fs31.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);
@@ -10368,9 +10441,9 @@ function parseChatArgs(argv, env = process.env) {
   return result;
 }
 function commitChatFiles(cwd, sessionId, verbose) {
-  const sessionFile = path29.relative(cwd, sessionFilePath(cwd, sessionId));
-  const eventsFile = path29.relative(cwd, eventsFilePath(cwd, sessionId));
-  const paths = [sessionFile, eventsFile].filter((p) => fs31.existsSync(path29.join(cwd, p)));
+  const sessionFile = path30.relative(cwd, sessionFilePath(cwd, sessionId));
+  const eventsFile = path30.relative(cwd, eventsFilePath(cwd, sessionId));
+  const paths = [sessionFile, eventsFile].filter((p) => fs32.existsSync(path30.join(cwd, p)));
   if (paths.length === 0) return;
   const opts = { cwd, stdio: verbose ? "inherit" : "pipe" };
   try {
@@ -10408,7 +10481,7 @@ async function runChat(argv) {
 ${CHAT_HELP}`);
     return 64;
   }
-  const cwd = args.cwd ? path29.resolve(args.cwd) : process.cwd();
+  const cwd = args.cwd ? path30.resolve(args.cwd) : process.cwd();
   const sessionId = args.sessionId;
   const unpackedSecrets = unpackAllSecrets();
   if (unpackedSecrets > 0) {
@@ -10460,7 +10533,7 @@ ${CHAT_HELP}`);
   const sink = buildSink(cwd, sessionId, args.dashboardUrl);
   const meta = readMeta(sessionFile);
   process.stdout.write(
-    `\u2192 kody:chat: session file=${sessionFile} exists=${fs31.existsSync(sessionFile)} meta=${meta ? meta.mode : "none"}
+    `\u2192 kody:chat: session file=${sessionFile} exists=${fs32.existsSync(sessionFile)} meta=${meta ? meta.mode : "none"}
 `
   );
   try {

package/dist/executables/classify/profile.json

@@ -24,6 +24,7 @@
     "maxTurns": null,
     "maxThinkingTokens": null,
     "systemPromptAppend": null,
+    "cacheable": true,
     "tools": [
       "Read",
       "Bash"

package/dist/executables/fix/profile.json

@@ -25,6 +25,7 @@
     "maxTurns": null,
     "maxTurnTimeoutSec": 1200,
     "systemPromptAppend": null,
+    "cacheable": true,
     "tools": [
       "Read",
       "Write",

package/dist/executables/fix-ci/profile.json

@@ -24,6 +24,7 @@
     "maxTurns": null,
     "maxTurnTimeoutSec": 1200,
     "systemPromptAppend": null,
+    "cacheable": true,
     "tools": [
       "Read",
       "Write",

package/dist/executables/run/profile.json

@@ -24,6 +24,7 @@
     "maxTurns": null,
     "maxTurnTimeoutSec": 1200,
     "systemPromptAppend": null,
+    "cacheable": true,
     "tools": [
       "Read",
       "Write",

package/dist/executables/types.ts

@@ -163,6 +163,20 @@ export interface ClaudeCodeSpec {
   maxTurnTimeoutSec?: number | null
   /** Text appended on top of Claude Code's baseline system prompt. */
   systemPromptAppend: string | null
+  /**
+   * Cross-process prompt caching opt-in. When true, the agent invocation
+   * sets `systemPrompt.excludeDynamicSections: true` so per-user dynamic
+   * content (cwd, git status, auto-memory) is stripped from the preset
+   * and re-injected as the first user message. The remaining preset
+   * becomes byte-identical across runs and benefits from Anthropic's
+   * 5-min server-side prompt cache. Recommended for hot-path stages
+   * (`run`, `fix`, `classify`) where the same workflow fires many
+   * times in a short window.
+   *
+   * Default: false (preserves legacy behaviour). No-op if the SDK does
+   * not support `excludeDynamicSections` (forward-compatible).
+   */
+  cacheable?: boolean
   /** SDK built-in tools this executable is allowed to use (capability pack). */
   tools: string[]
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.55",
+  "version": "0.4.57",
   "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"
+}