@kody-ade/kody-engine 0.4.385 → 0.4.387

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.385",
+      version: "0.4.387",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -3892,6 +3892,26 @@ function createStateBackendFromEnv(env = process.env, client) {
         updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
         ...expectedUpdatedAt ? { expectedUpdatedAt } : {}
       });
+    },
+    async getGoal(tenantId, goalId) {
+      const result = await transport.query(anyApi.goals.get, {
+        tenantId: requireTenant(tenantId),
+        goalId: requireNonEmpty(goalId, "goalId")
+      });
+      return result ?? null;
+    },
+    async listGoals(tenantId) {
+      const result = await transport.query(anyApi.goals.list, { tenantId: requireTenant(tenantId) });
+      return Array.isArray(result) ? result : [];
+    },
+    async saveGoal(tenantId, goalId, state, updatedAt, expectedUpdatedAt) {
+      await transport.mutation(anyApi.goals.save, {
+        tenantId: requireTenant(tenantId),
+        goalId: requireNonEmpty(goalId, "goalId"),
+        state,
+        updatedAt,
+        ...expectedUpdatedAt ? { expectedUpdatedAt } : {}
+      });
     }
   };
 }
@@ -3931,6 +3951,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) {
@@ -5662,7 +5685,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) {
@@ -8707,7 +8734,7 @@ import * as path24 from "path";
 function goalStatePath(goalId) {
   return `todos/${goalId}.json`;
 }
-function fetchGoalState(config, goalId, cwd) {
+function fetchGoalStateLegacy(config, goalId, cwd) {
   const filePath = goalStatePath(goalId);
   const loaded = readStateText(config, cwd, filePath);
   if (!loaded) return null;
@@ -8762,14 +8789,14 @@ function readStoreGoalTemplate(templateId) {
 function recordField2(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
-function putGoalState(config, goalId, state, message = `chore(goals): update ${goalId}`, cwd) {
+function putGoalStateLegacy(config, goalId, state, message = `chore(goals): update ${goalId}`, cwd) {
   const previous = readStateText(config, cwd, goalStatePath(goalId));
   if (previous && !isManagedTodoRaw(previous.content)) {
     throw new Error(`Cannot overwrite regular todo list ${goalId} as managed goal`);
   }
   upsertStateText(config, cwd, goalStatePath(goalId), serializeTodoGoalState(goalId, state, previous?.content), message);
 }
-function listGoalStateIds(config, cwd) {
+function listGoalStateIdsLegacy(config, cwd) {
   const ids = /* @__PURE__ */ new Set();
   const todoEntries = listStateDirectory(config, cwd, "todos");
   for (const entry of todoEntries) {
@@ -8780,11 +8807,46 @@ function listGoalStateIds(config, cwd) {
   }
   return [...ids].sort();
 }
+function backendTenant(config) {
+  const owner = config.github?.owner?.trim() || process.env.GITHUB_REPOSITORY?.split("/")[0]?.trim();
+  const repo = config.github?.repo?.trim() || process.env.GITHUB_REPOSITORY?.split("/")[1]?.trim();
+  return owner && repo ? `${owner}/${repo}` : null;
+}
+function backendEnabled(config) {
+  return Boolean(process.env.CONVEX_URL?.trim() && process.env.KODY_SERVICE_KEY?.trim() && backendTenant(config));
+}
+function backendRequired() {
+  return process.env.GITHUB_ACTIONS === "true";
+}
+function decodeGoal(doc) {
+  if (!doc || !doc.state || typeof doc.state !== "object" || Array.isArray(doc.state)) return null;
+  const state = doc.state;
+  if (typeof state.state !== "string" || !state.extra || typeof state.extra !== "object") return null;
+  return resolveStoreBackedGoalState(state);
+}
+async function fetchGoalStateAsync(config, goalId, cwd) {
+  const tenantId = backendTenant(config);
+  if (backendEnabled(config) && tenantId) {
+    return decodeGoal(await createStateBackendFromEnv().getGoal(tenantId, goalId));
+  }
+  if (backendRequired()) throw new Error("Convex backend is required for goal state in GitHub Actions");
+  return fetchGoalStateLegacy(config, goalId, cwd);
+}
+function fetchGoalState(config, goalId, cwd) {
+  return fetchGoalStateLegacy(config, goalId, cwd);
+}
+function putGoalState(config, goalId, state, message = `chore(goals): update ${goalId}`, cwd) {
+  putGoalStateLegacy(config, goalId, state, message, cwd);
+}
+function listGoalStateIds(config, cwd) {
+  return listGoalStateIdsLegacy(config, cwd);
+}
 var init_stateStore = __esm({
   "src/goal/stateStore.ts"() {
     "use strict";
     init_companyStore();
     init_stateRepo();
+    init_state_backend();
     init_managedTodoState();
   }
 });
@@ -14987,11 +15049,11 @@ function sleep(ms) {
   return new Promise((resolve10) => setTimeout(resolve10, ms));
 }
 async function fetchGoalStateWithRetry(config, goalId, cwd) {
-  let state = fetchGoalState(config, goalId, cwd);
+  let state = await fetchGoalStateAsync(config, goalId, cwd);
   if (state) return state;
   for (const delay of retryDelaysMs()) {
     await sleep(delay);
-    state = fetchGoalState(config, goalId, cwd);
+    state = await fetchGoalStateAsync(config, goalId, cwd);
     if (state) {
       process.stdout.write(`[goal-manager] loaded goal state for ${goalId} after retry
 `);
@@ -22837,8 +22899,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.385",
+  "version": "0.4.387",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
   "license": "MIT",
   "type": "module",