@kody-ade/kody-engine 0.3.46 → 0.3.48

package/README.md

@@ -62,6 +62,7 @@ kody chore     --issue <N>                             # run → review (→ fix
 kody mission-scheduler                                 # fans out to per-issue mission-tick
 kody mission-tick      --issue <N>                     # one tick of a kody:mission issue
 kody watch-stale-prs                                   # weekly stale-PR report
+kody memorize                                          # daily vault wiki update from recent PRs
 
 # deterministic (no agent)
 kody sync      --pr    <N>                             # merge default into PR branch
@@ -91,6 +92,18 @@ Drives the running preview deployment via the Playwright MCP server alongside th
 - Credentials: `.kody/qa-guide.md` (committed, scaffolded by `kody init` with `CHANGE_ME` placeholders).
 - Auto-discovery: routes, roles, login/admin paths, Payload CMS collections, API routes, env vars — fed to the agent as context.
 
+### `memorize` — vault wiki
+
+A scheduled watch (cron `0 3 * * *`) that synthesizes recently merged PRs into a markdown knowledge base at `.kody/vault/` and opens a PR with the changes. Pages are entity-centric (`architecture/`, `conventions/`, `decisions/`, `components/`), not per-PR logs. Future kody runs see the relevant pages via the `loadVaultContext` preflight, which is wired into `run` / `fix` / `resolve` and exposes them as `{{vaultContext}}` in the prompt.
+
+To enable in a consumer repo: ensure `.gitignore` un-ignores the vault if `.kody/*` is otherwise ignored:
+
+```gitignore
+.kody/*
+!.kody/vault/
+!.kody/vault/**
+```
+
 ### `release`
 
 - `--mode prepare` — bumps `package.json`, updates `CHANGELOG.md`, opens a `release/vX.Y.Z` PR. `--bump patch|minor|major` (default `patch`).

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.3.46",
+  version: "0.3.48",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -50,7 +50,7 @@ var package_default = {
 };
 
 // src/chat-cli.ts
-import { execFileSync as execFileSync24 } from "child_process";
+import { execFileSync as execFileSync25 } from "child_process";
 import * as fs26 from "fs";
 import * as path23 from "path";
 
@@ -605,7 +605,7 @@ async function emit(sink, type, sessionId, suffix, payload) {
 }
 
 // src/kody-cli.ts
-import { execFileSync as execFileSync23 } from "child_process";
+import { execFileSync as execFileSync24 } from "child_process";
 import * as fs25 from "fs";
 import * as path22 from "path";
 
@@ -2774,6 +2774,35 @@ function parsePr(url) {
   return Number.isFinite(n) ? n : null;
 }
 
+// src/scripts/dispatchClassified.ts
+import { execFileSync as execFileSync8 } from "child_process";
+var API_TIMEOUT_MS4 = 3e4;
+var VALID_CLASSES2 = /* @__PURE__ */ new Set(["feature", "bug", "spec", "chore"]);
+var dispatchClassified = async (ctx) => {
+  const issueNumber = ctx.args.issue;
+  if (!issueNumber) return;
+  const classification = ctx.data.classification;
+  if (!classification || !VALID_CLASSES2.has(classification)) return;
+  try {
+    execFileSync8("gh", ["issue", "comment", String(issueNumber), "--body", `@kody ${classification}`], {
+      cwd: ctx.cwd,
+      timeout: API_TIMEOUT_MS4,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+  } catch (err) {
+    process.stderr.write(
+      `[kody dispatchClassified] failed to dispatch @kody ${classification}: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+    ctx.data.action = failedAction("dispatch post failed");
+    ctx.output.exitCode = 1;
+    ctx.output.reason = "classify: dispatch failed";
+  }
+};
+function failedAction(reason) {
+  return { type: "CLASSIFY_FAILED", payload: { reason }, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
+}
+
 // src/scripts/dispatchMissionFileTicks.ts
 import * as fs16 from "fs";
 import * as path15 from "path";
@@ -2833,17 +2862,17 @@ function listMissionSlugs(absDir) {
 }
 
 // src/issue.ts
-import { execFileSync as execFileSync8 } from "child_process";
-var API_TIMEOUT_MS4 = 3e4;
+import { execFileSync as execFileSync9 } from "child_process";
+var API_TIMEOUT_MS5 = 3e4;
 function ghToken2() {
   return process.env.GH_PAT?.trim() || process.env.GH_TOKEN;
 }
 function gh2(args, options) {
   const token = ghToken2();
   const env = token ? { ...process.env, GH_TOKEN: token } : { ...process.env };
-  return execFileSync8("gh", args, {
+  return execFileSync9("gh", args, {
     encoding: "utf-8",
-    timeout: API_TIMEOUT_MS4,
+    timeout: API_TIMEOUT_MS5,
     cwd: options?.cwd,
     env,
     input: options?.input,
@@ -3214,18 +3243,7 @@ var ensureMemorizePr = async (ctx) => {
   }
   try {
     const output = gh2(
-      [
-        "pr",
-        "create",
-        "--head",
-        branch,
-        "--base",
-        ctx.config.git.defaultBranch,
-        "--title",
-        title,
-        "--body-file",
-        "-"
-      ],
+      ["pr", "create", "--head", branch, "--base", ctx.config.git.defaultBranch, "--title", title, "--body-file", "-"],
       { input: body, cwd: ctx.cwd }
     );
     const url = output.trim();
@@ -3321,7 +3339,7 @@ function computeFailureReason(ctx) {
 }
 
 // src/scripts/finishFlow.ts
-import { execFileSync as execFileSync9 } from "child_process";
+import { execFileSync as execFileSync10 } from "child_process";
 
 // src/lifecycleLabels.ts
 var KODY_NAMESPACE = "kody";
@@ -3441,7 +3459,7 @@ function errMsg(err) {
 }
 
 // src/scripts/finishFlow.ts
-var API_TIMEOUT_MS5 = 3e4;
+var API_TIMEOUT_MS6 = 3e4;
 var STATUS_ICON = {
   "review-passed": "\u2705",
   "fix-applied": "\u2705",
@@ -3474,8 +3492,8 @@ var finishFlow = async (ctx, _profile, _agentResult, args) => {
 **PR:** ${state.core.prUrl}` : "";
   const body = `${icon} kody flow \`${flowName}\` finished \u2014 \`${reason}\`${prSuffix}`;
   try {
-    execFileSync9("gh", ["issue", "comment", String(issueNumber), "--body", body], {
-      timeout: API_TIMEOUT_MS5,
+    execFileSync10("gh", ["issue", "comment", String(issueNumber), "--body", body], {
+      timeout: API_TIMEOUT_MS6,
       cwd: ctx.cwd,
       stdio: ["ignore", "pipe", "pipe"]
     });
@@ -3488,7 +3506,7 @@ var finishFlow = async (ctx, _profile, _agentResult, args) => {
 };
 
 // src/branch.ts
-import { execFileSync as execFileSync10 } from "child_process";
+import { execFileSync as execFileSync11 } from "child_process";
 var UncommittedChangesError = class extends Error {
   constructor(branch) {
     super(`Uncommitted changes on branch '${branch}' \u2014 refusing to run to protect work in progress`);
@@ -3498,7 +3516,7 @@ var UncommittedChangesError = class extends Error {
   branch;
 };
 function git2(args, cwd) {
-  return execFileSync10("git", args, {
+  return execFileSync11("git", args, {
     encoding: "utf-8",
     timeout: 3e4,
     cwd,
@@ -3523,7 +3541,7 @@ function checkoutPrBranch(prNumber, cwd) {
     SKIP_HOOKS: "1",
     GH_TOKEN: process.env.GH_PAT?.trim() || process.env.GH_TOKEN || ""
   };
-  execFileSync10("gh", ["pr", "checkout", String(prNumber)], {
+  execFileSync11("gh", ["pr", "checkout", String(prNumber)], {
     cwd,
     env,
     stdio: ["ignore", "pipe", "pipe"],
@@ -3590,7 +3608,7 @@ function ensureFeatureBranch(issueNumber, title, defaultBranch, cwd) {
 }
 
 // src/gha.ts
-import { execFileSync as execFileSync11 } from "child_process";
+import { execFileSync as execFileSync12 } from "child_process";
 import * as fs17 from "fs";
 function getRunUrl() {
   const server = process.env.GITHUB_SERVER_URL;
@@ -3633,7 +3651,7 @@ function reactToTriggerComment(cwd) {
   for (let attempt = 0; attempt < 3; attempt++) {
     if (attempt > 0) sleepMs(attempt === 1 ? 500 : 1500);
     try {
-      execFileSync11("gh", args, opts);
+      execFileSync12("gh", args, opts);
       return;
     } catch (err) {
       lastErr = err;
@@ -3646,13 +3664,13 @@ function reactToTriggerComment(cwd) {
 }
 function sleepMs(ms) {
   try {
-    execFileSync11("sleep", [(ms / 1e3).toString()], { stdio: "ignore", timeout: ms + 1e3 });
+    execFileSync12("sleep", [(ms / 1e3).toString()], { stdio: "ignore", timeout: ms + 1e3 });
   } catch {
   }
 }
 
 // src/workflow.ts
-import { execFileSync as execFileSync12 } from "child_process";
+import { execFileSync as execFileSync13 } from "child_process";
 var GH_TIMEOUT_MS = 3e4;
 function ghToken3() {
   return process.env.GH_PAT?.trim() || process.env.GH_TOKEN;
@@ -3660,7 +3678,7 @@ function ghToken3() {
 function gh3(args, cwd) {
   const token = ghToken3();
   const env = token ? { ...process.env, GH_TOKEN: token } : { ...process.env };
-  return execFileSync12("gh", args, {
+  return execFileSync13("gh", args, {
     encoding: "utf-8",
     timeout: GH_TIMEOUT_MS,
     cwd,
@@ -3844,7 +3862,7 @@ function tryPostPr2(prNumber, body, cwd) {
 }
 
 // src/scripts/initFlow.ts
-import { execFileSync as execFileSync13 } from "child_process";
+import { execFileSync as execFileSync14 } from "child_process";
 import * as fs19 from "fs";
 import * as path17 from "path";
 
@@ -3885,7 +3903,7 @@ function qualityCommandsFor(pm) {
 function detectOwnerRepo(cwd) {
   let url;
   try {
-    url = execFileSync13("git", ["remote", "get-url", "origin"], {
+    url = execFileSync14("git", ["remote", "get-url", "origin"], {
       cwd,
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "pipe"]
@@ -3970,7 +3988,7 @@ jobs:
 `;
 function defaultBranchFromGit(cwd) {
   try {
-    const ref = execFileSync13("git", ["symbolic-ref", "refs/remotes/origin/HEAD"], {
+    const ref = execFileSync14("git", ["symbolic-ref", "refs/remotes/origin/HEAD"], {
       cwd,
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "pipe"]
@@ -3978,7 +3996,7 @@ function defaultBranchFromGit(cwd) {
     return ref.replace("refs/remotes/origin/", "");
   } catch {
     try {
-      return execFileSync13("git", ["branch", "--show-current"], {
+      return execFileSync14("git", ["branch", "--show-current"], {
         cwd,
         encoding: "utf-8",
         stdio: ["ignore", "pipe", "pipe"]
@@ -4567,7 +4585,12 @@ function sortByRecency(pages) {
 }
 function formatBlock(pages) {
   if (pages.length === 0) return "";
-  const lines = ["# Project memory (`.kody/vault/`)", "", "Pages from prior memorize ticks. Treat as advisory context \u2014 confirm against the codebase before acting.", ""];
+  const lines = [
+    "# Project memory (`.kody/vault/`)",
+    "",
+    "Pages from prior memorize ticks. Treat as advisory context \u2014 confirm against the codebase before acting.",
+    ""
+  ];
   let total = 0;
   for (const p of pages) {
     const block = [`## ${p.title} \u2014 \`${p.relPath}\``, "", p.content].join("\n");
@@ -4582,7 +4605,7 @@ function formatBlock(pages) {
   return lines.join("\n");
 }
 function walkMd(root, visit) {
-  let stack = [root];
+  const stack = [root];
   while (stack.length > 0) {
     const dir = stack.pop();
     let names;
@@ -4610,7 +4633,7 @@ function walkMd(root, visit) {
 }
 
 // src/scripts/memorizeFlow.ts
-import { execFileSync as execFileSync14 } from "child_process";
+import { execFileSync as execFileSync15 } from "child_process";
 import * as fs22 from "fs";
 import * as path20 from "path";
 var VAULT_DIR_RELATIVE2 = ".kody/vault";
@@ -4637,8 +4660,10 @@ var memorizeFlow = async (ctx) => {
     process.stdout.write(`[kody memorize] no merged PRs since ${sinceIso}; agent may emit no changes
 `);
   } else {
-    process.stdout.write(`[kody memorize] ${recent.length} merged PR(s) since ${sinceIso} \u2192 branch ${ctx.data.branch}
-`);
+    process.stdout.write(
+      `[kody memorize] ${recent.length} merged PR(s) since ${sinceIso} \u2192 branch ${ctx.data.branch}
+`
+    );
   }
 };
 function ensureBranch(ctx, vaultAbs) {
@@ -4764,7 +4789,7 @@ function formatVaultIndex(vaultAbs) {
 }
 function walkMd2(root, visit) {
   if (!fs22.existsSync(root)) return;
-  let stack = [root];
+  const stack = [root];
   while (stack.length > 0) {
     const dir = stack.pop();
     let names;
@@ -4791,7 +4816,7 @@ function walkMd2(root, visit) {
   }
 }
 function git3(args, cwd) {
-  return execFileSync14("git", args, {
+  return execFileSync15("git", args, {
     encoding: "utf-8",
     timeout: 3e4,
     cwd,
@@ -4801,8 +4826,8 @@ function git3(args, cwd) {
 }
 
 // src/scripts/mergeReleasePr.ts
-import { execFileSync as execFileSync15 } from "child_process";
-var API_TIMEOUT_MS6 = 6e4;
+import { execFileSync as execFileSync16 } from "child_process";
+var API_TIMEOUT_MS7 = 6e4;
 var mergeReleasePr = async (ctx) => {
   const state = ctx.data.taskState;
   const prUrl = state?.core.prUrl;
@@ -4818,8 +4843,8 @@ var mergeReleasePr = async (ctx) => {
     return;
   }
   try {
-    execFileSync15("gh", ["pr", "merge", String(prNumber), "--merge"], {
-      timeout: API_TIMEOUT_MS6,
+    execFileSync16("gh", ["pr", "merge", String(prNumber), "--merge"], {
+      timeout: API_TIMEOUT_MS7,
       cwd: ctx.cwd,
       stdio: ["ignore", "pipe", "pipe"]
     });
@@ -5082,86 +5107,6 @@ var persistFlowState = async (ctx) => {
   }
 };
 
-// src/scripts/postClassification.ts
-import { execFileSync as execFileSync16 } from "child_process";
-var API_TIMEOUT_MS7 = 3e4;
-var VALID_CLASSES2 = /* @__PURE__ */ new Set(["feature", "bug", "spec", "chore"]);
-var postClassification = async (ctx) => {
-  const issueNumber = ctx.args.issue;
-  if (!issueNumber) return;
-  const presetClassification = ctx.data.classification;
-  let classification = null;
-  let reason = null;
-  if (presetClassification && VALID_CLASSES2.has(presetClassification)) {
-    classification = presetClassification;
-    reason = ctx.data.classificationReason ?? "label-based match";
-  } else {
-    const parsed = parseClassification(ctx.data.prSummary ?? "");
-    classification = parsed?.classification ?? null;
-    reason = parsed?.reason ?? null;
-  }
-  if (!classification) {
-    ctx.data.action = failedAction("classification missing or invalid");
-    tryAuditComment(
-      issueNumber,
-      "\u26A0\uFE0F kody classifier could not decide \u2014 please re-run with an explicit `@kody <type>`.",
-      ctx.cwd
-    );
-    ctx.output.exitCode = 1;
-    ctx.output.reason = "classify: no decision";
-    return;
-  }
-  tryAuditComment(issueNumber, `\u{1F50E} kody classified as \`${classification}\`${reason ? ` \u2014 ${reason}` : ""}`, ctx.cwd);
-  try {
-    execFileSync16("gh", ["issue", "comment", String(issueNumber), "--body", `@kody ${classification}`], {
-      cwd: ctx.cwd,
-      timeout: API_TIMEOUT_MS7,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-  } catch (err) {
-    process.stderr.write(
-      `[kody postClassification] failed to dispatch @kody ${classification}: ${err instanceof Error ? err.message : String(err)}
-`
-    );
-    ctx.data.action = failedAction("dispatch post failed");
-    ctx.output.exitCode = 1;
-    ctx.output.reason = "classify: dispatch failed";
-    return;
-  }
-  ctx.data.action = makeAction3(`CLASSIFIED_AS_${classification.toUpperCase()}`, {
-    classification,
-    reason: reason ?? "",
-    source: ctx.data.classificationSource ?? "agent"
-  });
-  ctx.data.classification = classification;
-  ctx.data.classificationReason = reason ?? "";
-};
-function parseClassification(prSummary) {
-  if (!prSummary) return null;
-  const classMatch = prSummary.match(/classification:\s*(feature|bug|spec|chore)\b/i);
-  if (!classMatch) return null;
-  const classification = classMatch[1].toLowerCase();
-  const reasonMatch = prSummary.match(/reason:\s*(.+)$/im);
-  const reason = reasonMatch ? reasonMatch[1].trim() : "";
-  return { classification, reason };
-}
-function tryAuditComment(issueNumber, body, cwd) {
-  try {
-    execFileSync16("gh", ["issue", "comment", String(issueNumber), "--body", body], {
-      cwd,
-      timeout: API_TIMEOUT_MS7,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-  } catch {
-  }
-}
-function makeAction3(type, payload) {
-  return { type, payload, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
-}
-function failedAction(reason) {
-  return { type: "CLASSIFY_FAILED", payload: { reason }, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
-}
-
 // src/scripts/postIssueComment.ts
 var postIssueComment2 = async (ctx) => {
   if (ctx.skipAgent && ctx.output.exitCode !== void 0) return;
@@ -5330,6 +5275,70 @@ REVIEW_POSTED=https://github.com/${ctx.config.github.owner}/${ctx.config.github.
   );
 };
 
+// src/scripts/recordClassification.ts
+import { execFileSync as execFileSync17 } from "child_process";
+var API_TIMEOUT_MS8 = 3e4;
+var VALID_CLASSES3 = /* @__PURE__ */ new Set(["feature", "bug", "spec", "chore"]);
+var recordClassification = async (ctx) => {
+  const issueNumber = ctx.args.issue;
+  if (!issueNumber) return;
+  const presetClassification = ctx.data.classification;
+  let classification = null;
+  let reason = null;
+  if (presetClassification && VALID_CLASSES3.has(presetClassification)) {
+    classification = presetClassification;
+    reason = ctx.data.classificationReason ?? "label-based match";
+  } else {
+    const parsed = parseClassification(ctx.data.prSummary ?? "");
+    classification = parsed?.classification ?? null;
+    reason = parsed?.reason ?? null;
+  }
+  if (!classification) {
+    ctx.data.action = failedAction3("classification missing or invalid");
+    tryAuditComment(
+      issueNumber,
+      "\u26A0\uFE0F kody classifier could not decide \u2014 please re-run with an explicit `@kody <type>`.",
+      ctx.cwd
+    );
+    ctx.output.exitCode = 1;
+    ctx.output.reason = "classify: no decision";
+    return;
+  }
+  tryAuditComment(issueNumber, `\u{1F50E} kody classified as \`${classification}\`${reason ? ` \u2014 ${reason}` : ""}`, ctx.cwd);
+  ctx.data.action = makeAction3(`CLASSIFIED_AS_${classification.toUpperCase()}`, {
+    classification,
+    reason: reason ?? "",
+    source: ctx.data.classificationSource ?? "agent"
+  });
+  ctx.data.classification = classification;
+  ctx.data.classificationReason = reason ?? "";
+};
+function parseClassification(prSummary) {
+  if (!prSummary) return null;
+  const classMatch = prSummary.match(/classification:\s*(feature|bug|spec|chore)\b/i);
+  if (!classMatch) return null;
+  const classification = classMatch[1].toLowerCase();
+  const reasonMatch = prSummary.match(/reason:\s*(.+)$/im);
+  const reason = reasonMatch ? reasonMatch[1].trim() : "";
+  return { classification, reason };
+}
+function tryAuditComment(issueNumber, body, cwd) {
+  try {
+    execFileSync17("gh", ["issue", "comment", String(issueNumber), "--body", body], {
+      cwd,
+      timeout: API_TIMEOUT_MS8,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+  } catch {
+  }
+}
+function makeAction3(type, payload) {
+  return { type, payload, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
+}
+function failedAction3(reason) {
+  return { type: "CLASSIFY_FAILED", payload: { reason }, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
+}
+
 // src/scripts/recordOutcome.ts
 var recordOutcome = async (ctx, profile) => {
   const seg = profile.name.replace(/-/g, "_").toUpperCase();
@@ -5365,12 +5374,12 @@ function fail(ctx, profile, reason) {
   ctx.data.agentDone = false;
   ctx.data.agentFailureReason = reason;
   const modeSeg = profile.name.replace(/-/g, "_").toUpperCase();
-  const failedAction3 = {
+  const failedAction4 = {
     type: `${modeSeg}_FAILED`,
     payload: { reason },
     timestamp: (/* @__PURE__ */ new Date()).toISOString()
   };
-  ctx.data.action = failedAction3;
+  ctx.data.action = failedAction4;
 }
 function countActionItems(block) {
   if (!block.trim()) return 0;
@@ -5411,12 +5420,12 @@ function fail2(ctx, profile, reason) {
   ctx.data.agentDone = false;
   ctx.data.agentFailureReason = reason;
   const modeSeg = profile.name.replace(/-/g, "_").toUpperCase();
-  const failedAction3 = {
+  const failedAction4 = {
     type: `${modeSeg}_FAILED`,
     payload: { reason },
     timestamp: (/* @__PURE__ */ new Date()).toISOString()
   };
-  ctx.data.action = failedAction3;
+  ctx.data.action = failedAction4;
 }
 
 // src/scripts/resolveArtifacts.ts
@@ -5443,7 +5452,7 @@ var resolveArtifacts = async (ctx, profile) => {
 };
 
 // src/scripts/resolveFlow.ts
-import { execFileSync as execFileSync17 } from "child_process";
+import { execFileSync as execFileSync18 } from "child_process";
 var CONFLICT_DIFF_MAX_BYTES = 4e4;
 var resolveFlow = async (ctx) => {
   const prNumber = ctx.args.pr;
@@ -5513,7 +5522,7 @@ function buildPreferBlock(prefer, baseBranch) {
 }
 function getConflictedFiles(cwd) {
   try {
-    const out = execFileSync17("git", ["diff", "--name-only", "--diff-filter=U"], {
+    const out = execFileSync18("git", ["diff", "--name-only", "--diff-filter=U"], {
       encoding: "utf-8",
       cwd,
       env: { ...process.env, HUSKY: "0" }
@@ -5528,7 +5537,7 @@ function getConflictMarkersPreview(files, cwd, maxBytes = CONFLICT_DIFF_MAX_BYTE
   let total = 0;
   for (const f of files) {
     try {
-      const content = execFileSync17("cat", [f], { encoding: "utf-8", cwd }).toString();
+      const content = execFileSync18("cat", [f], { encoding: "utf-8", cwd }).toString();
       const snippet = `### ${f}
 
 \`\`\`
@@ -5702,11 +5711,11 @@ var skipAgent = async (ctx) => {
 };
 
 // src/scripts/stageMergeConflicts.ts
-import { execFileSync as execFileSync18 } from "child_process";
+import { execFileSync as execFileSync19 } from "child_process";
 var stageMergeConflicts = async (ctx) => {
   if (ctx.data.agentDone === false) return;
   try {
-    execFileSync18("git", ["add", "-A"], {
+    execFileSync19("git", ["add", "-A"], {
       cwd: ctx.cwd,
       env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1" },
       stdio: "pipe"
@@ -5716,8 +5725,8 @@ var stageMergeConflicts = async (ctx) => {
 };
 
 // src/scripts/startFlow.ts
-import { execFileSync as execFileSync19 } from "child_process";
-var API_TIMEOUT_MS8 = 3e4;
+import { execFileSync as execFileSync20 } from "child_process";
+var API_TIMEOUT_MS9 = 3e4;
 var startFlow = async (ctx, profile, _agentResult, args) => {
   const entry = args?.entry;
   if (!entry) {
@@ -5750,8 +5759,8 @@ function postKodyComment(target, issueNumber, state, next, cwd) {
   const sub = target === "pr" && state?.core.prUrl ? "pr" : "issue";
   const body = `@kody ${next}`;
   try {
-    execFileSync19("gh", [sub, "comment", String(targetNumber), "--body", body], {
-      timeout: API_TIMEOUT_MS8,
+    execFileSync20("gh", [sub, "comment", String(targetNumber), "--body", body], {
+      timeout: API_TIMEOUT_MS9,
       cwd,
       stdio: ["ignore", "pipe", "pipe"]
     });
@@ -5764,7 +5773,7 @@ function postKodyComment(target, issueNumber, state, next, cwd) {
 }
 
 // src/scripts/syncFlow.ts
-import { execFileSync as execFileSync20 } from "child_process";
+import { execFileSync as execFileSync21 } from "child_process";
 var syncFlow = async (ctx, _profile, args) => {
   const announceOnSuccess = Boolean(args?.announceOnSuccess);
   const prNumber = ctx.args.pr;
@@ -5836,7 +5845,7 @@ function bail2(ctx, prNumber, reason) {
 }
 function revParseHead(cwd) {
   try {
-    return execFileSync20("git", ["rev-parse", "HEAD"], { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).toString().trim();
+    return execFileSync21("git", ["rev-parse", "HEAD"], { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).toString().trim();
   } catch {
     return "";
   }
@@ -5844,9 +5853,9 @@ function revParseHead(cwd) {
 function pushBranch(branch, cwd) {
   const env = { ...process.env, HUSKY: "0", SKIP_HOOKS: "1" };
   try {
-    execFileSync20("git", ["push", "-u", "origin", branch], { cwd, env, stdio: ["ignore", "pipe", "pipe"] });
+    execFileSync21("git", ["push", "-u", "origin", branch], { cwd, env, stdio: ["ignore", "pipe", "pipe"] });
   } catch {
-    execFileSync20("git", ["push", "--force-with-lease", "-u", "origin", branch], {
+    execFileSync21("git", ["push", "--force-with-lease", "-u", "origin", branch], {
       cwd,
       env,
       stdio: ["ignore", "pipe", "pipe"]
@@ -5957,8 +5966,8 @@ var verify = async (ctx) => {
 };
 
 // src/scripts/waitForCi.ts
-import { execFileSync as execFileSync21 } from "child_process";
-var API_TIMEOUT_MS9 = 3e4;
+import { execFileSync as execFileSync22 } from "child_process";
+var API_TIMEOUT_MS10 = 3e4;
 var waitForCi = async (ctx, _profile, _agentResult, args) => {
   const timeoutMinutes = numArg(args, "timeoutMinutes", 30);
   const pollSeconds = numArg(args, "pollSeconds", 30);
@@ -6035,9 +6044,9 @@ var waitForCi = async (ctx, _profile, _agentResult, args) => {
 };
 function fetchChecks(prNumber, cwd) {
   try {
-    const raw = execFileSync21("gh", ["pr", "checks", String(prNumber), "--json", "bucket,state,name,workflow,link"], {
+    const raw = execFileSync22("gh", ["pr", "checks", String(prNumber), "--json", "bucket,state,name,workflow,link"], {
       encoding: "utf-8",
-      timeout: API_TIMEOUT_MS9,
+      timeout: API_TIMEOUT_MS10,
       cwd,
       stdio: ["ignore", "pipe", "pipe"]
     });
@@ -6299,7 +6308,8 @@ var postflightScripts = {
   finishFlow,
   advanceFlow,
   persistFlowState,
-  postClassification,
+  recordClassification,
+  dispatchClassified,
   notifyTerminal,
   recordOutcome,
   mergeReleasePr,
@@ -6311,7 +6321,7 @@ var allScriptNames = /* @__PURE__ */ new Set([
 ]);
 
 // src/tools.ts
-import { execFileSync as execFileSync22 } from "child_process";
+import { execFileSync as execFileSync23 } from "child_process";
 function verifyCliTools(tools, cwd) {
   const out = [];
   for (const t of tools) out.push(verifyOne(t, cwd));
@@ -6344,7 +6354,7 @@ function verifyOne(tool, cwd) {
 }
 function runShell(cmd, cwd, timeoutMs = 3e4) {
   try {
-    execFileSync22("sh", ["-c", cmd], { cwd, stdio: "pipe", timeout: timeoutMs });
+    execFileSync23("sh", ["-c", cmd], { cwd, stdio: "pipe", timeout: timeoutMs });
     return true;
   } catch {
     return false;
@@ -6753,7 +6763,7 @@ function detectPackageManager2(cwd) {
 }
 function shellOut(cmd, args, cwd, stream = true) {
   try {
-    execFileSync23(cmd, args, {
+    execFileSync24(cmd, args, {
       cwd,
       stdio: stream ? "inherit" : "pipe",
       env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1", CI: process.env.CI ?? "1" }
@@ -6766,7 +6776,7 @@ function shellOut(cmd, args, cwd, stream = true) {
 }
 function isOnPath(bin) {
   try {
-    execFileSync23("which", [bin], { stdio: "pipe" });
+    execFileSync24("which", [bin], { stdio: "pipe" });
     return true;
   } catch {
     return false;
@@ -6800,7 +6810,7 @@ function installLitellmIfNeeded(cwd) {
   } catch {
   }
   try {
-    execFileSync23("python3", ["-c", "import litellm"], { stdio: "pipe" });
+    execFileSync24("python3", ["-c", "import litellm"], { stdio: "pipe" });
     process.stdout.write("\u2192 kody: litellm already installed\n");
     return 0;
   } catch {
@@ -6810,16 +6820,16 @@ function installLitellmIfNeeded(cwd) {
 }
 function configureGitIdentity(cwd) {
   try {
-    const name = execFileSync23("git", ["config", "user.name"], { cwd, stdio: "pipe", encoding: "utf-8" }).trim();
+    const name = execFileSync24("git", ["config", "user.name"], { cwd, stdio: "pipe", encoding: "utf-8" }).trim();
     if (name) return;
   } catch {
   }
   try {
-    execFileSync23("git", ["config", "user.name", "github-actions[bot]"], { cwd, stdio: "pipe" });
+    execFileSync24("git", ["config", "user.name", "github-actions[bot]"], { cwd, stdio: "pipe" });
   } catch {
   }
   try {
-    execFileSync23("git", ["config", "user.email", "41898282+github-actions[bot]@users.noreply.github.com"], {
+    execFileSync24("git", ["config", "user.email", "41898282+github-actions[bot]@users.noreply.github.com"], {
       cwd,
       stdio: "pipe"
     });
@@ -7090,9 +7100,9 @@ function commitChatFiles(cwd, sessionId, verbose) {
   if (paths.length === 0) return;
   const opts = { cwd, stdio: verbose ? "inherit" : "pipe" };
   try {
-    execFileSync24("git", ["add", ...paths], opts);
-    execFileSync24("git", ["commit", "--quiet", "-m", `chat: reply for ${sessionId}`], opts);
-    execFileSync24("git", ["push", "--quiet", "origin", "HEAD"], opts);
+    execFileSync25("git", ["add", ...paths], opts);
+    execFileSync25("git", ["commit", "--quiet", "-m", `chat: reply for ${sessionId}`], opts);
+    execFileSync25("git", ["push", "--quiet", "origin", "HEAD"], opts);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     process.stderr.write(`[kody:chat] commit/push skipped: ${msg}

package/dist/executables/classify/profile.json

@@ -47,9 +47,10 @@
     ],
     "postflight": [
       { "script": "parseAgentResult" },
-      { "script": "postClassification" },
+      { "script": "recordClassification" },
       { "script": "writeRunSummary" },
-      { "script": "saveTaskState" }
+      { "script": "saveTaskState" },
+      { "script": "dispatchClassified" }
     ]
   },
   "output": {

package/dist/executables/run/prompt.md

@@ -26,10 +26,11 @@ If a prior-art block is present above, READ THE DIFFS — those are failed or su
    - Read the **full** contents of every file you intend to change (not just a grep hit).
    - Read the tests for each of those files, if tests exist for the module.
    - Read at least one sibling module that already implements the same pattern you're about to follow — your edits should mirror an existing convention unless you can name why a new one is needed.
+   - If your change requires writing or modifying a test, also check for repo-level testing guidance: `tests/README.md`, `TESTING.md`, or a "Testing"/"Tests" section in `AGENTS.md`/`CLAUDE.md`. If one exists, treat its patterns (auth setup, fixture creation, what NOT to do) as authoritative — they override anything you might infer from grepping individual files.
    - If a file you need to read does not exist, say so explicitly in your plan (step 2). Do not guess at its contents.
 2. **Plan** — before any Edit/Write, output a short plan (5–10 lines): what files you'll change, the approach, what could go wrong. No fluff.
 3. **Build** — Edit/Write to implement the change. Stay within the plan; if you discover the plan was wrong, briefly say so and adjust.
-4. **Test** — for every new module you added and every behavior you changed, write or update tests. If the plan above contains a "Test plan" section, treat it as authoritative: every item there must produce a corresponding test. Match the repo's existing test layout (look at `tests/` or sibling `*.test.ts` files in the codebase to see the convention). Cover at least one happy path and one failure path per change. Skipping tests is a hard failure. A change may only be declared untestable if you can name the specific blocker (e.g., "no fake exists for the X SDK and stubbing it would mock the entire call surface"); vague "this is just config" claims are rejected. Untestable changes go in `PLAN_DEVIATIONS:` with the named blocker.
+4. **Test** — for every new module you added and every behavior you changed, write or update tests. If the plan above contains a "Test plan" section, treat it as authoritative: every item there must produce a corresponding test. Before writing a test, open the newest existing file in the same test directory (`tests/int/`, `tests/unit/`, `tests/e2e/`, or sibling `*.test.ts`) and copy its imports, setup hooks, and auth pattern **verbatim**. Do NOT introduce a new test infrastructure (own testcontainers, `fetch` against relative URLs, alternate auth headers) when a working pattern already exists in that directory — divergence from the established pattern is a hard failure even if the test passes locally. Cover at least one happy path and one failure path per change. Skipping tests is a hard failure. A change may only be declared untestable if you can name the specific blocker (e.g., "no fake exists for the X SDK and stubbing it would mock the entire call surface"); vague "this is just config" claims are rejected. Untestable changes go in `PLAN_DEVIATIONS:` with the named blocker.
 5. **Verify** — run each quality command with Bash. On failure, fix the root cause and re-run. When reporting that a command passed, you MUST have just run it and seen exit code 0 in this session — do not paraphrase prior output.
 6. Your FINAL message must use this exact format (or a single `FAILED: <reason>` line on failure). The `PLAN_DEVIATIONS:` block is REQUIRED whenever a plan was provided.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.3.46",
+  "version": "0.3.48",
   "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": {
     "@anthropic-ai/claude-agent-sdk": "0.2.119"
   },
@@ -31,16 +43,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"
+}

package/templates/kody.yml

@@ -48,9 +48,13 @@ on:
   pull_request:
     types: [closed]
   schedule:
-    # Wakes every 5 minutes; kody fans out to whichever scheduled executables
-    # (mission-scheduler, memorize, watch-stale-prs, …) match this minute.
-    - cron: "*/5 * * * *"
+    # Wakes every 30 minutes; kody fans out to whichever scheduled executables
+    # (mission-scheduler, memorize, watch-stale-prs, …) match this tick.
+    #
+    # `memorize` writes to `.kody/vault/` and opens a daily PR. If your
+    # `.gitignore` ignores `.kody/*`, add `!.kody/vault/` and `!.kody/vault/**`
+    # so memorize's pages are tracked.
+    - cron: "*/30 * * * *"
 
 jobs:
   run: