@kody-ade/kody-engine 0.4.381 → 0.4.383

package/dist/bin/kody.js

@@ -15,7 +15,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@kody-ade/kody-engine",
-      version: "0.4.381",
+      version: "0.4.383",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -1271,13 +1271,32 @@ var init_events = __esm({
 
 // src/verify.ts
 import { spawn } from "child_process";
+function buildVerifyEnv(source = process.env) {
+  const env = { ...source };
+  const rawSecrets = env.ALL_SECRETS;
+  delete env.ALL_SECRETS;
+  if (rawSecrets) {
+    try {
+      const parsed = JSON.parse(rawSecrets);
+      for (const key of Object.keys(parsed)) delete env[key];
+    } catch {
+    }
+  }
+  for (const key of Object.keys(env)) {
+    if (SENSITIVE_ENV_NAME.test(key)) delete env[key];
+  }
+  env.HUSKY = "0";
+  env.SKIP_HOOKS = "1";
+  env.CI = source.CI ?? "1";
+  return env;
+}
 function runCommand(command, cwd) {
   return new Promise((resolve10) => {
     const start = Date.now();
     const child = spawn(command, {
       cwd,
       shell: true,
-      env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1", CI: process.env.CI ?? "1" },
+      env: buildVerifyEnv(),
       stdio: ["ignore", "pipe", "pipe"]
     });
     const buffers = [];
@@ -1369,13 +1388,14 @@ function summarizeFailure(result) {
   }
   return lines.join("\n");
 }
-var TAIL_CHARS, COMMAND_TIMEOUT_MS, DEFAULT_TEST_RETRIES, ANSI_RE;
+var TAIL_CHARS, COMMAND_TIMEOUT_MS, DEFAULT_TEST_RETRIES, SENSITIVE_ENV_NAME, ANSI_RE;
 var init_verify = __esm({
   "src/verify.ts"() {
     "use strict";
     TAIL_CHARS = 4e3;
     COMMAND_TIMEOUT_MS = 10 * 60 * 1e3;
     DEFAULT_TEST_RETRIES = 2;
+    SENSITIVE_ENV_NAME = /(?:^|_)(?:TOKEN|SECRET|PASSWORD|PASSWD|API_KEY|PRIVATE_KEY|SERVICE_KEY|MASTER_KEY|CREDENTIALS?)(?:_|$)/i;
     ANSI_RE = /\x1B\[[0-?]*[ -/]*[@-~]/g;
   }
 });
@@ -3757,6 +3777,108 @@ var init_agents = __esm({
   }
 });
 
+// src/chat/convex-client.ts
+import { ConvexHttpClient } from "convex/browser";
+function isPlainObject2(value) {
+  if (value === null || typeof value !== "object") return false;
+  const proto = Object.getPrototypeOf(value);
+  return proto === Object.prototype || proto === null;
+}
+function deepMapKeys(value, mapKey) {
+  if (Array.isArray(value)) return value.map((item) => deepMapKeys(item, mapKey));
+  if (isPlainObject2(value)) {
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [mapKey(key), deepMapKeys(item, mapKey)]));
+  }
+  return value;
+}
+function deepEscapeKeys(value) {
+  return deepMapKeys(value, (k) => NEEDS_ESCAPE.test(k) ? `${ESCAPE_CHAR}${k}` : k);
+}
+function deepUnescapeKeys(value) {
+  return deepMapKeys(value, (k) => k.startsWith(ESCAPE_CHAR) ? k.slice(1) : k);
+}
+function injectServiceKey(args, serviceKey = process.env.KODY_SERVICE_KEY) {
+  if (!serviceKey) return args;
+  if (args === void 0) return { serviceKey };
+  if (typeof args !== "object" || args === null || Array.isArray(args)) return args;
+  return { ...args, serviceKey };
+}
+function withEscapedKeys(client, serviceKey = process.env.KODY_SERVICE_KEY) {
+  return new Proxy(client, {
+    get(target, prop, receiver) {
+      if (CALL_METHODS.includes(prop)) {
+        const method = Reflect.get(target, prop, target);
+        return async (fn, args) => {
+          const authed = injectServiceKey(args, serviceKey);
+          const result = await method.call(target, fn, authed === void 0 ? void 0 : deepEscapeKeys(authed));
+          return deepUnescapeKeys(result);
+        };
+      }
+      const value = Reflect.get(target, prop, receiver);
+      return typeof value === "function" ? value.bind(target) : value;
+    }
+  });
+}
+function createConvexClientFromEnv(env = process.env) {
+  const url = env.CONVEX_URL?.trim();
+  if (!url) return null;
+  return withEscapedKeys(new ConvexHttpClient(url), env.KODY_SERVICE_KEY);
+}
+var ESCAPE_CHAR, NEEDS_ESCAPE, CALL_METHODS;
+var init_convex_client = __esm({
+  "src/chat/convex-client.ts"() {
+    "use strict";
+    ESCAPE_CHAR = "~";
+    NEEDS_ESCAPE = /^[$_~]/;
+    CALL_METHODS = ["query", "mutation", "action"];
+  }
+});
+
+// src/state-backend.ts
+import { anyApi } from "convex/server";
+function requireTenant(tenantId) {
+  const value = tenantId.trim();
+  if (!/^[^/\s]+\/[^/\s]+$/.test(value)) throw new Error("tenantId must be an owner/repository pair");
+  return value;
+}
+function requireNonEmpty(value, name) {
+  const normalized = value.trim();
+  if (!normalized) throw new Error(`${name} must not be empty`);
+  return normalized;
+}
+function createStateBackendFromEnv(env = process.env, client) {
+  const url = env.CONVEX_URL?.trim();
+  const serviceKey = env.KODY_SERVICE_KEY?.trim();
+  if (!url || !serviceKey) throw new Error("CONVEX_URL and KODY_SERVICE_KEY are required");
+  const transport = client ?? createConvexClientFromEnv(env);
+  return {
+    async get(tenantId, taskKey, kind) {
+      const result = await transport.query(anyApi.taskState.get, {
+        tenantId: requireTenant(tenantId),
+        taskKey: requireNonEmpty(taskKey, "taskKey"),
+        kind: requireNonEmpty(kind, "kind")
+      });
+      return result ?? null;
+    },
+    async save(tenantId, taskKey, kind, doc, expectedUpdatedAt) {
+      await transport.mutation(anyApi.taskState.save, {
+        tenantId: requireTenant(tenantId),
+        taskKey: requireNonEmpty(taskKey, "taskKey"),
+        kind: requireNonEmpty(kind, "kind"),
+        doc,
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        ...expectedUpdatedAt ? { expectedUpdatedAt } : {}
+      });
+    }
+  };
+}
+var init_state_backend = __esm({
+  "src/state-backend.ts"() {
+    "use strict";
+    init_convex_client();
+  }
+});
+
 // src/task-artifacts.ts
 import fs10 from "fs";
 import path12 from "path";
@@ -3784,7 +3906,29 @@ function verifyTaskArtifacts(absDir) {
 function taskArtifactStatePath(taskId, file) {
   return posixPath.join("tasks", taskId, file);
 }
-function persistTaskArtifactsToState(config, cwd, artifacts) {
+async function persistTaskArtifactsToState(config, cwd, artifacts) {
+  const tenantId = config.github?.owner && config.github.repo ? `${config.github.owner}/${config.github.repo}` : process.env.GITHUB_REPOSITORY?.trim();
+  if (process.env.CONVEX_URL && process.env.KODY_SERVICE_KEY && tenantId) {
+    const backend = createStateBackendFromEnv();
+    for (const file of TASK_ARTIFACT_FILES) {
+      const full = path12.join(artifacts.absDir, file);
+      if (!fs10.existsSync(full)) continue;
+      const stat = fs10.statSync(full);
+      if (!stat.isFile() || stat.size === 0) continue;
+      const content = fs10.readFileSync(full, "utf-8");
+      const kind = file.replace(/\.(json|md)$/, "");
+      let doc = content;
+      if (file.endsWith(".json")) {
+        try {
+          doc = JSON.parse(content);
+        } catch (err) {
+          throw new Error(`task artifact ${file} is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+        }
+      }
+      await backend.save(tenantId, artifacts.taskId, kind, doc);
+    }
+    return;
+  }
   for (const file of TASK_ARTIFACT_FILES) {
     const full = path12.join(artifacts.absDir, file);
     if (!fs10.existsSync(full)) continue;
@@ -3863,6 +4007,7 @@ var init_task_artifacts = __esm({
   "src/task-artifacts.ts"() {
     "use strict";
     init_runtimePaths();
+    init_state_backend();
     init_stateRepo();
     TASK_ARTIFACT_FILES = ["context.json", "memory-recs.json", "followups.json", "handoff-notes.md"];
   }
@@ -4290,6 +4435,7 @@ function prBranchLifecycle(profile, profilePath) {
   const tail = [
     ...verifyChain,
     { script: "commitAndPush" },
+    { script: "requireDeliveryArtifacts" },
     { script: "ensurePr" },
     { script: "postIssueComment" },
     { script: "writeAgentRunSummary" },
@@ -5477,7 +5623,7 @@ function renderStateComment(state) {
   lines.push("</details>");
   return lines.join("\n");
 }
-function readTaskState(target, number, cwd, config) {
+function readTaskStateLegacy(target, number, cwd, config) {
   const stateConfig = taskStateConfig(cwd, config);
   const loaded = readStateText(stateConfig, cwd, taskStatePath(target, number));
   if (!loaded) return emptyState();
@@ -5491,13 +5637,34 @@ function readTaskState(target, number, cwd, config) {
   }
   return normalizeTaskState(parsed);
 }
+function backendScope(config) {
+  const tenantId = config?.github?.owner && config.github.repo ? `${config.github.owner}/${config.github.repo}` : process.env.GITHUB_REPOSITORY?.trim();
+  if (!process.env.CONVEX_URL || !process.env.KODY_SERVICE_KEY || !tenantId) return null;
+  return { tenantId };
+}
+async function readTaskState(target, number, cwd, config) {
+  const scope = backendScope(config);
+  if (!scope) return readTaskStateLegacy(target, number, cwd, config);
+  const backend = createStateBackendFromEnv();
+  const kind = "state";
+  const taskKey = `${target === "issue" ? "issues" : "prs"}/${number}`;
+  const record = await backend.get(scope.tenantId, taskKey, kind);
+  if (!record) return emptyState();
+  try {
+    return normalizeTaskState(record.doc);
+  } catch (err) {
+    throw new CorruptStateError(
+      `backend task state unparseable for ${taskKey}: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+}
 function setArtifact(state, name, artifact) {
   return {
     ...state,
     artifacts: { ...state.artifacts ?? {}, [name]: artifact }
   };
 }
-function writeTaskState(target, number, state, cwd, config) {
+function writeTaskStateLegacy(target, number, state, cwd, config) {
   const stateConfig = taskStateConfig(cwd, config);
   upsertStateText(
     stateConfig,
@@ -5508,11 +5675,21 @@ function writeTaskState(target, number, state, cwd, config) {
     `chore(tasks): update ${target} ${number} state`
   );
 }
-var STATE_BEGIN, STATE_END, HISTORY_MAX_ENTRIES, JOB_RUNS_MAX_ENTRIES, CorruptStateError;
+async function writeTaskState(target, number, state, cwd, config) {
+  const scope = backendScope(config);
+  if (!scope) {
+    writeTaskStateLegacy(target, number, state, cwd, config);
+    return;
+  }
+  const backend = createStateBackendFromEnv();
+  await backend.save(scope.tenantId, `${target === "issue" ? "issues" : "prs"}/${number}`, "state", state);
+}
+var STATE_BEGIN, STATE_END, HISTORY_MAX_ENTRIES, JOB_RUNS_MAX_ENTRIES, CorruptStateError, readTaskStateAsync;
 var init_state = __esm({
   "src/state.ts"() {
     "use strict";
     init_config();
+    init_state_backend();
     init_stateRepo();
     STATE_BEGIN = "<!-- kody:state:v1:begin -->";
     STATE_END = "<!-- kody:state:v1:end -->";
@@ -5524,6 +5701,7 @@ var init_state = __esm({
         this.name = "CorruptStateError";
       }
     };
+    readTaskStateAsync = readTaskState;
   }
 });
 
@@ -5958,7 +6136,7 @@ async function runContainerLoop(profile, ctx, input) {
     return;
   }
   const runChild = input.__runChild ?? ((name, opts) => runImplementation(name, opts));
-  const reader = input.__readTaskState ?? readTaskState;
+  const reader = input.__readTaskState ?? readTaskStateAsync;
   const issueNumber = ctx.args.issue;
   let preloadedSnapshot;
   if (profile.preloadContext) {
@@ -6008,7 +6186,7 @@ async function runContainerLoop(profile, ctx, input) {
       process.stderr.write(`[kody container] resetBetweenChildren=false; preserving tracked tree
 `);
     }
-    const priorState = readContainerState(ctx, child, reader);
+    const priorState = await readContainerState(ctx, child, reader);
     if (priorState.core?.prUrl) knownPrUrl = priorState.core.prUrl;
     const priorAction = priorState.implementations?.[child.implementation]?.lastAction;
     let actionType2;
@@ -6102,7 +6280,7 @@ async function runContainerLoop(profile, ctx, input) {
         else process.env.KODY_CONTAINER_PARENT = priorParent;
       }
       const priorAttempts = priorState.core?.attempts?.[child.implementation] ?? 0;
-      const next = readContainerState(ctx, child, reader);
+      const next = await readContainerState(ctx, child, reader);
       if (next.core?.prUrl) knownPrUrl = next.core.prUrl;
       const nextAttempts = next.core?.attempts?.[child.implementation] ?? 0;
       const nextChildAction = next.implementations?.[child.implementation]?.lastAction;
@@ -6189,20 +6367,20 @@ function resetWorkingTree(cwd) {
 `);
   }
 }
-function readContainerState(ctx, child, reader) {
+async function readContainerState(ctx, child, reader) {
   const issueNumber = ctx.args.issue;
   const cached2 = ctx.data.taskState;
   const prUrl = cached2?.core?.prUrl;
   const prNumber = prUrl ? parsePrNumber2(prUrl) : null;
   if (child.target === "pr" && prNumber) {
     try {
-      return reader("pr", prNumber, ctx.cwd);
+      return await reader("pr", prNumber, ctx.cwd);
     } catch {
     }
   }
   if (issueNumber !== void 0) {
     try {
-      return reader("issue", issueNumber, ctx.cwd);
+      return await reader("issue", issueNumber, ctx.cwd);
     } catch {
     }
   }
@@ -7360,7 +7538,7 @@ var init_saveTaskState = __esm({
       if (ctx.output.prUrl) next.core.prUrl = ctx.output.prUrl;
       if (typeof ctx.data.runUrl === "string") next.core.runUrl = ctx.data.runUrl;
       applyStandaloneFinalState(next, ctx, profile);
-      writeTaskState(target, number, next, ctx.cwd, ctx.config);
+      await writeTaskState(target, number, next, ctx.cwd, ctx.config);
       ctx.data.taskState = next;
       ctx.data.taskStateRendered = renderStateComment(next);
     };
@@ -7398,7 +7576,7 @@ var init_advanceFlow = __esm({
       const curState = state;
       let issueState;
       try {
-        issueState = readTaskState("issue", flow.issueNumber, ctx.cwd, ctx.config);
+        issueState = await readTaskState("issue", flow.issueNumber, ctx.cwd, ctx.config);
       } catch {
         issueState = curState;
       }
@@ -7414,7 +7592,7 @@ var init_advanceFlow = __esm({
       if (hops > FLOW_HOP_CAP) {
         nextIssueState.flow = void 0;
         try {
-          writeTaskState("issue", flow.issueNumber, nextIssueState, ctx.cwd, ctx.config);
+          await writeTaskState("issue", flow.issueNumber, nextIssueState, ctx.cwd, ctx.config);
         } catch (err) {
           process.stderr.write(
             `[kody advanceFlow] failed to clear looping flow on issue #${flow.issueNumber}: ${err instanceof Error ? err.message : String(err)}
@@ -7435,7 +7613,7 @@ var init_advanceFlow = __esm({
       }
       nextIssueState.flow = { ...flow, hops };
       try {
-        writeTaskState("issue", flow.issueNumber, nextIssueState, ctx.cwd, ctx.config);
+        await writeTaskState("issue", flow.issueNumber, nextIssueState, ctx.cwd, ctx.config);
       } catch (err) {
         process.stderr.write(
           `[kody advanceFlow] failed to persist hop count on issue #${flow.issueNumber}: ${err instanceof Error ? err.message : String(err)}
@@ -13147,7 +13325,7 @@ var init_dispatchClassified = __esm({
       const nextState = reduce(state, "classify", action, void 0, profile.agent, jobMetaFromData(ctx.data));
       ctx.data.taskState = nextState;
       ctx.data.taskStateRendered = renderStateComment(nextState);
-      writeTaskState("issue", issueNumber, nextState, ctx.cwd, ctx.config);
+      await writeTaskState("issue", issueNumber, nextState, ctx.cwd, ctx.config);
       const cliArgs = { issue: issueNumber };
       if (base && getProfileInputs(classification)?.some((i) => i.name === "base")) {
         cliArgs.base = base;
@@ -13553,7 +13731,7 @@ var init_ensurePr = __esm({
           draft: isFailure,
           failureReason: isFailure ? failureReason : void 0,
           changedFiles,
-          agentSummary: ctx.data.prSummary,
+          agentSummary: ctx.data.prSummary || ctx.data.agentFallbackSummary,
           baseBranch,
           // No fresh commit this run → don't rebuild the body of an existing PR;
           // it would replace the original agent summary with the empty fallback.
@@ -13660,7 +13838,7 @@ var init_finalizeTerminal = __esm({
       if (prNumber && prNumber !== issueNumber) setKodyLabel(prNumber, spec, ctx.cwd);
       if (!state) {
         try {
-          state = readTaskState(target, targetNumber, ctx.cwd, ctx.config);
+          state = await readTaskState(target, targetNumber, ctx.cwd, ctx.config);
         } catch {
           state = void 0;
         }
@@ -13679,7 +13857,7 @@ var init_finalizeTerminal = __esm({
       };
       ctx.data.taskState = next;
       try {
-        writeTaskState(target, targetNumber, next, ctx.cwd, ctx.config);
+        await writeTaskState(target, targetNumber, next, ctx.cwd, ctx.config);
       } catch (err) {
         process.stderr.write(
           `[kody finalizeTerminal] failed to write terminal state on ${target} #${targetNumber}: ${err instanceof Error ? err.message : String(err)}
@@ -13757,7 +13935,7 @@ var init_finishFlow = __esm({
         const target = ctx.data.commentTargetType ?? "issue";
         const targetNumber = ctx.data.commentTargetNumber ?? issueNumber;
         try {
-          writeTaskState(target, targetNumber, state, ctx.cwd, ctx.config);
+          await writeTaskState(target, targetNumber, state, ctx.cwd, ctx.config);
         } catch (err) {
           process.stderr.write(
             `[kody finishFlow] failed to update state mirror: ${err instanceof Error ? err.message : String(err)}
@@ -15561,7 +15739,7 @@ var init_loadTaskState = __esm({
         return;
       }
       try {
-        ctx.data.taskState = readTaskState(target, number, ctx.cwd, ctx.config);
+        ctx.data.taskState = await readTaskState(target, number, ctx.cwd, ctx.config);
       } catch (err) {
         if (err instanceof CorruptStateError) {
           process.stderr.write(
@@ -15569,7 +15747,7 @@ var init_loadTaskState = __esm({
 `
           );
           try {
-            writeTaskState(target, number, emptyState(), ctx.cwd, ctx.config);
+            await writeTaskState(target, number, emptyState(), ctx.cwd, ctx.config);
           } catch {
           }
           ctx.skipAgent = true;
@@ -15826,7 +16004,7 @@ var init_mirrorStateToPr = __esm({
       if (!prNumber) return;
       if (!state) {
         try {
-          state = readTaskState("issue", issueNumber, ctx.cwd, ctx.config);
+          state = await readTaskState("issue", issueNumber, ctx.cwd, ctx.config);
         } catch {
           return;
         }
@@ -15836,7 +16014,7 @@ var init_mirrorStateToPr = __esm({
         ctx.data.taskState = state;
       }
       try {
-        writeTaskState("pr", prNumber, state, ctx.cwd, ctx.config);
+        await writeTaskState("pr", prNumber, state, ctx.cwd, ctx.config);
       } catch (err) {
         process.stderr.write(
           `[kody mirrorStateToPr] failed to mirror state to PR #${prNumber}: ${err instanceof Error ? err.message : String(err)}
@@ -16285,6 +16463,7 @@ var init_parseAgentResult = __esm({
         return;
       }
       const parsed = parseAgentResult(agentResult.finalText);
+      ctx.data.agentFinalText = agentResult.finalText;
       ctx.data.agentDone = parsed.done;
       ctx.data.commitMessage = parsed.commitMessage;
       ctx.data.prSummary = parsed.prSummary;
@@ -16598,7 +16777,7 @@ var init_persistFlowState = __esm({
       const issueNumber = ctx.args.issue ?? state.flow?.issueNumber;
       if (!issueNumber) return;
       try {
-        writeTaskState("issue", issueNumber, state, ctx.cwd, ctx.config);
+        await writeTaskState("issue", issueNumber, state, ctx.cwd, ctx.config);
       } catch (err) {
         process.stderr.write(
           `[kody persistFlowState] failed to write state on issue #${issueNumber}: ${err instanceof Error ? err.message : String(err)}
@@ -16718,7 +16897,7 @@ var init_planTaskJobs = __esm({
       ctx.data.plannedTaskJobIds = planned.map((job) => job.id);
       const target = ctx.data.commentTargetType;
       const number = ctx.data.commentTargetNumber;
-      if (target && number) writeTaskState(target, number, next, ctx.cwd, ctx.config);
+      if (target && number) await writeTaskState(target, number, next, ctx.cwd, ctx.config);
     };
   }
 });
@@ -17430,6 +17609,52 @@ var init_recordOutcome = __esm({
   }
 });
 
+// src/scripts/requireDeliveryArtifacts.ts
+function fallbackSummary(finalText) {
+  const prose = finalText.split("\n").filter(
+    (line) => !/^[\s>*_#`~-]*(?:DONE\b|COMMIT_MSG\s*:|PR_SUMMARY\s*:|PLAN_DEVIATIONS\s*:|FEEDBACK_ACTIONS\s*:)/i.test(line)
+  ).join("\n").trim();
+  if (!prose) return "";
+  if (prose.length <= FALLBACK_SUMMARY_MAX) return prose;
+  return `${prose.slice(0, FALLBACK_SUMMARY_MAX - 1)}\u2026`;
+}
+var FALLBACK_SUMMARY_MAX, requireDeliveryArtifacts;
+var init_requireDeliveryArtifacts = __esm({
+  "src/scripts/requireDeliveryArtifacts.ts"() {
+    "use strict";
+    FALLBACK_SUMMARY_MAX = 6e3;
+    requireDeliveryArtifacts = async (ctx) => {
+      if (ctx.data.agentDone !== true) return;
+      const commitResult = ctx.data.commitResult;
+      const hasCommits = ctx.data.hasCommitsAhead === true;
+      if (!commitResult?.committed && !hasCommits) return;
+      const commitMessage = String(ctx.data.commitMessage ?? "").trim();
+      const prSummary = String(ctx.data.prSummary ?? "").trim();
+      const missing = [];
+      if (!commitMessage) missing.push("COMMIT_MSG");
+      if (!prSummary) missing.push("PR_SUMMARY");
+      if (missing.length === 0) return;
+      const reason = `agent omitted required delivery artifacts: ${missing.join(", ")}`;
+      ctx.data.agentDone = false;
+      ctx.data.agentResultIncomplete = true;
+      ctx.data.agentMissingArtifacts = missing;
+      ctx.data.agentFailureReason = reason;
+      if (!prSummary) {
+        const fallback = fallbackSummary(String(ctx.data.agentFinalText ?? ""));
+        if (fallback) ctx.data.agentFallbackSummary = fallback;
+      }
+      const action = ctx.data.action;
+      if (action?.type.endsWith("_COMPLETED")) {
+        ctx.data.action = {
+          type: action.type.replace(/_COMPLETED$/, "_FAILED"),
+          payload: { reason, downgradedFrom: action.type },
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        };
+      }
+    };
+  }
+});
+
 // src/scripts/requireFeedbackActions.ts
 function countActionItems(block) {
   if (!block.trim()) return 0;
@@ -20174,6 +20399,7 @@ var init_scripts = __esm({
     init_publishReport();
     init_recordClassification();
     init_recordOutcome();
+    init_requireDeliveryArtifacts();
     init_requireFeedbackActions();
     init_requirePlanDeviations();
     init_resolveArtifacts();
@@ -20265,6 +20491,7 @@ var init_scripts = __esm({
       writeJobStateFile,
       appendCompanyActivity,
       requireFeedbackActions,
+      requireDeliveryArtifacts,
       requirePlanDeviations,
       verify,
       verifyWithRetry,
@@ -20993,7 +21220,7 @@ async function runImplementation(profileName, input) {
 `);
         }
         if (!input.skipConfig && (config.state || config.github.owner && config.github.repo)) {
-          persistTaskArtifactsToState(config, input.cwd, taskArtifacts);
+          await persistTaskArtifactsToState(config, input.cwd, taskArtifacts);
         }
       } catch (err) {
         process.stderr.write(
@@ -22465,59 +22692,8 @@ function makeRunId(sessionId, suffix) {
 }
 
 // src/chat/session-store.ts
-import { anyApi } from "convex/server";
-
-// src/chat/convex-client.ts
-import { ConvexHttpClient } from "convex/browser";
-var ESCAPE_CHAR = "~";
-var NEEDS_ESCAPE = /^[$_~]/;
-function isPlainObject2(value) {
-  if (value === null || typeof value !== "object") return false;
-  const proto = Object.getPrototypeOf(value);
-  return proto === Object.prototype || proto === null;
-}
-function deepMapKeys(value, mapKey) {
-  if (Array.isArray(value)) return value.map((item) => deepMapKeys(item, mapKey));
-  if (isPlainObject2(value)) {
-    return Object.fromEntries(Object.entries(value).map(([key, item]) => [mapKey(key), deepMapKeys(item, mapKey)]));
-  }
-  return value;
-}
-function deepEscapeKeys(value) {
-  return deepMapKeys(value, (k) => NEEDS_ESCAPE.test(k) ? `${ESCAPE_CHAR}${k}` : k);
-}
-function deepUnescapeKeys(value) {
-  return deepMapKeys(value, (k) => k.startsWith(ESCAPE_CHAR) ? k.slice(1) : k);
-}
-var CALL_METHODS = ["query", "mutation", "action"];
-function injectServiceKey(args) {
-  const serviceKey = process.env.KODY_SERVICE_KEY;
-  if (!serviceKey) return args;
-  if (args === void 0) return { serviceKey };
-  if (typeof args !== "object" || args === null || Array.isArray(args)) return args;
-  return { ...args, serviceKey };
-}
-function withEscapedKeys(client) {
-  return new Proxy(client, {
-    get(target, prop, receiver) {
-      if (CALL_METHODS.includes(prop)) {
-        const method = Reflect.get(target, prop, target);
-        return async (fn, args) => {
-          const authed = injectServiceKey(args);
-          const result = await method.call(target, fn, authed === void 0 ? void 0 : deepEscapeKeys(authed));
-          return deepUnescapeKeys(result);
-        };
-      }
-      const value = Reflect.get(target, prop, receiver);
-      return typeof value === "function" ? value.bind(target) : value;
-    }
-  });
-}
-function createConvexClientFromEnv(env = process.env) {
-  const url = env.CONVEX_URL?.trim();
-  if (!url) return null;
-  return withEscapedKeys(new ConvexHttpClient(url));
-}
+init_convex_client();
+import { anyApi as anyApi2 } from "convex/server";
 
 // src/chat/session.ts
 import * as fs13 from "fs";
@@ -22640,7 +22816,7 @@ function createConvexStore(args) {
     if (!sessionUpserted) {
       try {
         const meta = readMeta(sessionFile) ?? { type: "meta", mode: "one-shot" };
-        await client.mutation(anyApi.chatSessions.upsert, {
+        await client.mutation(anyApi2.chatSessions.upsert, {
           tenantId,
           sessionId,
           meta,
@@ -22651,12 +22827,12 @@ function createConvexStore(args) {
         logger.warn(`session ${sessionId}: chatSessions.upsert failed: ${err instanceof Error ? err.message : String(err)}`);
       }
     }
-    await client.mutation(anyApi.chatTurns.append, { tenantId, sessionId, turn });
+    await client.mutation(anyApi2.chatTurns.append, { tenantId, sessionId, turn });
   };
   return {
     backend: "convex",
     readTurns: async () => {
-      const docs = await client.query(anyApi.chatTurns.list, { tenantId, sessionId });
+      const docs = await client.query(anyApi2.chatTurns.list, { tenantId, sessionId });
       const convexTurns = [...docs].sort((a, b) => a.seq - b.seq).map((doc) => doc.turn).filter(isChatTurn);
       const localTurns = readSession(sessionFile);
       if (localTurns.length <= convexTurns.length) return convexTurns;
@@ -22975,7 +23151,7 @@ async function runChatTurn(opts) {
 `
       );
     }
-    if (opts.stateConfig) persistTaskArtifactsToState(opts.stateConfig, opts.cwd, taskArtifactsPaths);
+    if (opts.stateConfig) await persistTaskArtifactsToState(opts.stateConfig, opts.cwd, taskArtifactsPaths);
   } catch (err) {
     process.stderr.write(
       `[task-artifacts] chat session ${taskArtifactsPaths.taskId} persist failed: ${err instanceof Error ? err.message : String(err)}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.381",
+  "version": "0.4.383",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,28 +12,6 @@
     "templates",
     "kody.config.schema.json"
   ],
-  "scripts": {
-    "kody:run": "tsx bin/kody.ts",
-    "serve": "tsx bin/kody.ts serve",
-    "serve:vscode": "tsx bin/kody.ts serve vscode",
-    "serve:claude": "tsx bin/kody.ts serve claude",
-    "clean:dist": "node scripts/clean-dist.cjs",
-    "build": "pnpm clean:dist && tsup && node scripts/copy-assets.cjs",
-    "check:modularity": "tsx scripts/check-script-modularity.ts",
-    "pretest": "pnpm check:modularity",
-    "test": "vitest run tests/unit tests/int --coverage",
-    "posttest": "tsx scripts/check-coverage-floor.ts",
-    "test:smoke": "vitest run tests/smoke --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",
-    "verify:package": "node scripts/verify-package-tarball.cjs",
-    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner",
-    "prepublishOnly": "pnpm typecheck && vitest run tests/unit tests/int --no-coverage && pnpm build && pnpm verify:package"
-  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
@@ -58,5 +36,26 @@
     "url": "git+https://github.com/aharonyaircohen/kody-engine.git"
   },
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
-  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
-}
+  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues",
+  "scripts": {
+    "kody:run": "tsx bin/kody.ts",
+    "serve": "tsx bin/kody.ts serve",
+    "serve:vscode": "tsx bin/kody.ts serve vscode",
+    "serve:claude": "tsx bin/kody.ts serve claude",
+    "clean:dist": "node scripts/clean-dist.cjs",
+    "build": "pnpm clean:dist && tsup && node scripts/copy-assets.cjs",
+    "check:modularity": "tsx scripts/check-script-modularity.ts",
+    "pretest": "pnpm check:modularity",
+    "test": "vitest run tests/unit tests/int --coverage",
+    "posttest": "tsx scripts/check-coverage-floor.ts",
+    "test:smoke": "vitest run tests/smoke --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",
+    "verify:package": "node scripts/verify-package-tarball.cjs",
+    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner"
+  }
+}