@kody-ade/kody-engine 0.4.384 → 0.4.386

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.384",
+      version: "0.4.386",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -3869,6 +3869,29 @@ function createStateBackendFromEnv(env = process.env, client) {
         updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
         ...expectedUpdatedAt ? { expectedUpdatedAt } : {}
       });
+    },
+    async getRepoDoc(tenantId, kind) {
+      const result = await transport.query(anyApi.repoDocs.get, {
+        tenantId: requireTenant(tenantId),
+        kind: requireNonEmpty(kind, "kind")
+      });
+      return result ?? null;
+    },
+    async listRepoDocs(tenantId, prefix) {
+      const result = await transport.query(anyApi.repoDocs.listByPrefix, {
+        tenantId: requireTenant(tenantId),
+        prefix: requireNonEmpty(prefix, "prefix")
+      });
+      return Array.isArray(result) ? result : [];
+    },
+    async saveRepoDoc(tenantId, kind, doc, expectedUpdatedAt) {
+      await transport.mutation(anyApi.repoDocs.save, {
+        tenantId: requireTenant(tenantId),
+        kind: requireNonEmpty(kind, "kind"),
+        doc,
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        ...expectedUpdatedAt ? { expectedUpdatedAt } : {}
+      });
     }
   };
 }
@@ -3908,6 +3931,9 @@ function taskArtifactStatePath(taskId, file) {
 }
 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.GITHUB_ACTIONS === "true" && (!process.env.CONVEX_URL || !process.env.KODY_SERVICE_KEY || !tenantId)) {
+    throw new Error("Convex artifact backend is required in GitHub Actions (CONVEX_URL, KODY_SERVICE_KEY, and repository identity)");
+  }
   if (process.env.CONVEX_URL && process.env.KODY_SERVICE_KEY && tenantId) {
     const backend = createStateBackendFromEnv();
     for (const file of TASK_ARTIFACT_FILES) {
@@ -5639,7 +5665,11 @@ function readTaskStateLegacy(target, number, cwd, config) {
 }
 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;
+  const configured = !!process.env.CONVEX_URL && !!process.env.KODY_SERVICE_KEY && !!tenantId;
+  if (!configured && process.env.GITHUB_ACTIONS === "true") {
+    throw new Error("Convex task-state backend is required in GitHub Actions (CONVEX_URL, KODY_SERVICE_KEY, and repository identity)");
+  }
+  if (!configured) return null;
   return { tenantId };
 }
 async function readTaskState(target, number, cwd, config) {
@@ -5952,6 +5982,21 @@ __export(loadMemoryContext_exports, {
 });
 import * as fs21 from "fs";
 import * as path21 from "path";
+function formatBlockFromBackend(docs) {
+  const pages = docs.flatMap((record) => {
+    if (!record.doc || typeof record.doc !== "object") return [];
+    const doc = record.doc;
+    if (typeof doc.content !== "string") return [];
+    return [{
+      relPath: typeof doc.relPath === "string" ? doc.relPath : record.kind,
+      title: typeof doc.title === "string" ? doc.title : record.kind,
+      updated: typeof doc.updated === "string" ? doc.updated : record.updatedAt,
+      content: doc.content.length > PER_PAGE_MAX_BYTES ? doc.content.slice(0, PER_PAGE_MAX_BYTES) + TRUNCATED_SUFFIX2 : doc.content,
+      mtime: Date.parse(record.updatedAt) || 0
+    }];
+  });
+  return formatBlock(sortByRecency(pages).slice(0, MAX_PAGES));
+}
 function collectPages(memoryAbs) {
   const out = [];
   walkMd(memoryAbs, (file) => {
@@ -6064,6 +6109,7 @@ var MEMORY_DIR_RELATIVE, MAX_PAGES, PER_PAGE_MAX_BYTES, TOTAL_MAX_BYTES2, TRUNCA
 var init_loadMemoryContext = __esm({
   "src/scripts/loadMemoryContext.ts"() {
     "use strict";
+    init_state_backend();
     MEMORY_DIR_RELATIVE = ".kody/memory";
     MAX_PAGES = 8;
     PER_PAGE_MAX_BYTES = 4e3;
@@ -6071,6 +6117,17 @@ var init_loadMemoryContext = __esm({
     TRUNCATED_SUFFIX2 = "\n\n\u2026 (truncated)";
     loadMemoryContext = async (ctx) => {
       if (typeof ctx.data.memoryContext === "string") return;
+      const tenantId = ctx.config.github?.owner && ctx.config.github.repo ? `${ctx.config.github.owner}/${ctx.config.github.repo}` : process.env.GITHUB_REPOSITORY?.trim();
+      if (process.env.CONVEX_URL && process.env.KODY_SERVICE_KEY && tenantId) {
+        try {
+          const backend = createStateBackendFromEnv();
+          const docs = await backend.listRepoDocs(tenantId, "memory:");
+          ctx.data.memoryContext = formatBlockFromBackend(docs);
+        } catch {
+          ctx.data.memoryContext = "";
+        }
+        return;
+      }
       const memoryAbs = path21.join(ctx.cwd, MEMORY_DIR_RELATIVE);
       if (!fs21.existsSync(memoryAbs)) {
         ctx.data.memoryContext = "";
@@ -22787,8 +22844,14 @@ function createSessionStore(opts) {
     });
   }
   if (client && !tenantId) {
+    if (process.env.GITHUB_ACTIONS === "true") {
+      throw new Error("Convex chat backend requires GITHUB_REPOSITORY in GitHub Actions");
+    }
     logger.warn(`session ${opts.sessionId}: CONVEX_URL set but no tenant (GITHUB_REPOSITORY unset) \u2014 using JSONL`);
   } else {
+    if (process.env.GITHUB_ACTIONS === "true") {
+      throw new Error("Convex chat backend is required in GitHub Actions (CONVEX_URL and KODY_SERVICE_KEY)");
+    }
     logger.info(`session ${opts.sessionId}: CONVEX_URL unset \u2014 using legacy state-repo JSONL store`);
   }
   return createJsonlStore(opts.sessionFile);

package/package.json

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