@kody-ade/kody-engine 0.4.392 → 0.4.394

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.391",
+      version: "0.4.394",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -3931,6 +3931,32 @@ function createStateBackendFromEnv(env = process.env, client) {
         meta,
         updatedAt
       });
+    },
+    async listIntents(tenantId) {
+      const result = await transport.query(anyApi.intents.list, { tenantId: requireTenant(tenantId) });
+      return Array.isArray(result) ? result : [];
+    },
+    async getIntent(tenantId, intentId) {
+      const result = await transport.query(anyApi.intents.get, {
+        tenantId: requireTenant(tenantId),
+        intentId: requireNonEmpty(intentId, "intentId")
+      });
+      return result ?? null;
+    },
+    async saveIntent(tenantId, intentId, intent, updatedAt) {
+      await transport.mutation(anyApi.intents.save, {
+        tenantId: requireTenant(tenantId),
+        intentId: requireNonEmpty(intentId, "intentId"),
+        intent,
+        updatedAt
+      });
+    },
+    async appendIntentDecision(tenantId, intentId, decision) {
+      await transport.mutation(anyApi.intents.appendDecision, {
+        tenantId: requireTenant(tenantId),
+        intentId: requireNonEmpty(intentId, "intentId"),
+        decision
+      });
     }
   };
 }
@@ -8900,13 +8926,24 @@ async function fetchGoalStateAsync(config, goalId, cwd) {
   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) {
+async function putGoalStateAsync(config, goalId, state, message = `chore(goals): update ${goalId}`, cwd) {
+  const tenantId = backendTenant(config);
+  if (backendEnabled(config) && tenantId) {
+    const backend = createStateBackendFromEnv();
+    const previous = await backend.getGoal(tenantId, goalId);
+    await backend.saveGoal(tenantId, goalId, state, state.updatedAt ?? (/* @__PURE__ */ new Date()).toISOString(), previous?.updatedAt);
+    return;
+  }
+  if (backendRequired()) throw new Error("Convex backend is required for goal state in GitHub Actions");
   putGoalStateLegacy(config, goalId, state, message, cwd);
 }
-function listGoalStateIds(config, cwd) {
+async function listGoalStateIdsAsync(config, cwd) {
+  const tenantId = backendTenant(config);
+  if (backendEnabled(config) && tenantId) {
+    const docs = await createStateBackendFromEnv().listGoals(tenantId);
+    return docs.map((doc) => doc.goalId).filter(Boolean).sort();
+  }
+  if (backendRequired()) throw new Error("Convex backend is required for goal state in GitHub Actions");
   return listGoalStateIdsLegacy(config, cwd);
 }
 var init_stateStore = __esm({
@@ -8922,11 +8959,11 @@ var init_stateStore = __esm({
 // src/goal/targetLoopResolution.ts
 import * as fs27 from "fs";
 import * as path25 from "path";
-function resolveActiveGoalLoopTarget(config, cwd, loopGoalId, loopGoal) {
+async function resolveActiveGoalLoopTarget(config, cwd, loopGoalId, loopGoal) {
   const targetId = loopGoal.loopTarget?.id.trim() ?? "";
   assertSafeGoalId(targetId, "loop target");
   if (!hasExplicitStateRepo(config)) return null;
-  const activeInstance = findActiveTargetInstance(config, cwd, loopGoalId, targetId);
+  const activeInstance = await findActiveTargetInstance(config, cwd, loopGoalId, targetId);
   if (activeInstance) {
     return {
       targetId: activeInstance.id,
@@ -8934,21 +8971,21 @@ function resolveActiveGoalLoopTarget(config, cwd, loopGoalId, loopGoal) {
       reason: "active target instance"
     };
   }
-  const directTarget = fetchGoalState(config, targetId, cwd);
+  const directTarget = await fetchGoalStateAsync(config, targetId, cwd);
   if (directTarget?.state === "active") {
     return { targetId, templateId: targetId, reason: "active target goal" };
   }
   return null;
 }
-function resolveGoalLoopTarget(config, cwd, loopGoalId, loopGoal, now) {
+async function resolveGoalLoopTarget(config, cwd, loopGoalId, loopGoal, now) {
   const targetId = loopGoal.loopTarget?.id.trim() ?? "";
   assertSafeGoalId(targetId, "loop target");
   if (!hasExplicitStateRepo(config)) {
     return { targetId, templateId: targetId, reason: "literal target; state repo not configured" };
   }
-  const activeTarget = resolveActiveGoalLoopTarget(config, cwd, loopGoalId, loopGoal);
+  const activeTarget = await resolveActiveGoalLoopTarget(config, cwd, loopGoalId, loopGoal);
   if (activeTarget) return activeTarget;
-  const directTarget = fetchGoalState(config, targetId, cwd);
+  const directTarget = await fetchGoalStateAsync(config, targetId, cwd);
   const template = loadGoalTemplate(cwd, targetId);
   if (!template) {
     if (directTarget) {
@@ -8956,9 +8993,9 @@ function resolveGoalLoopTarget(config, cwd, loopGoalId, loopGoal, now) {
     }
     return { targetId, templateId: targetId, reason: "literal target; no target state or template found" };
   }
-  const instanceId = chooseTargetInstanceId(config, cwd, targetId, loopGoal.preferredRunTime?.timezone, now);
+  const instanceId = await chooseTargetInstanceId(config, cwd, targetId, loopGoal.preferredRunTime?.timezone, now);
   const instance = buildGoalTargetInstance(template, targetId, now);
-  putGoalState(config, instanceId, instance, `chore(goals): create ${instanceId}`, cwd);
+  await putGoalStateAsync(config, instanceId, instance, `chore(goals): create ${instanceId}`, cwd);
   return {
     targetId: instanceId,
     templateId: targetId,
@@ -8978,13 +9015,13 @@ function hasExplicitStateRepo(config) {
   const state = config.state;
   return !!state && typeof state.repo === "string" && state.repo.trim().length > 0 && typeof state.path === "string" && state.path.trim().length > 0;
 }
-function findActiveTargetInstance(config, cwd, loopGoalId, targetId) {
+async function findActiveTargetInstance(config, cwd, loopGoalId, targetId) {
   const candidates = [];
-  for (const entryId of listGoalStateIds(config, cwd)) {
+  for (const entryId of await listGoalStateIdsAsync(config, cwd)) {
     const id = entryId.trim();
     if (!id || id === loopGoalId || id === targetId || !id.startsWith(`${targetId}-`)) continue;
     assertSafeGoalId(id, "goal instance");
-    const state = fetchGoalState(config, id, cwd);
+    const state = await fetchGoalStateAsync(config, id, cwd);
     if (!state || state.state !== "active") continue;
     if (!isTargetInstanceState(id, state, targetId)) continue;
     candidates.push({ id, state });
@@ -9022,12 +9059,12 @@ function readJsonObject(filePath) {
   }
   return parsed;
 }
-function chooseTargetInstanceId(config, cwd, targetId, timezone, now) {
+async function chooseTargetInstanceId(config, cwd, targetId, timezone, now) {
   const base = `${targetId}-${zonedDate(now, timezone ?? "UTC")}`;
   for (let index = 1; index <= 20; index += 1) {
     const id = index === 1 ? base : `${base}-${index}`;
     assertSafeGoalId(id, "goal instance");
-    const existing = fetchGoalState(config, id, cwd);
+    const existing = await fetchGoalStateAsync(config, id, cwd);
     if (!existing || existing.state === "active") return id;
   }
   throw new Error(`could not allocate goal target instance id for ${targetId}`);
@@ -10266,7 +10303,7 @@ function scalarFacts(facts) {
     )
   );
 }
-function autonomyBlockReason(ctx, goalId, goal, goalState, dispatch2, options = {}) {
+async function autonomyBlockReason(ctx, goalId, goal, goalState, dispatch2, options = {}) {
   if (ctx.data.jobForce === true) return null;
   const selfKind = managedModelKind(goal);
   const selfMode = selfKind === "Goal" ? firstTrustOverride(ctx, subjectCandidates("goal", goalId, goalState)) : null;
@@ -10282,7 +10319,7 @@ function autonomyBlockReason(ctx, goalId, goal, goalState, dispatch2, options =
   }
   const targetGoal = dispatch2.action === "goal-manager" && typeof dispatch2.cliArgs.goal === "string" ? dispatch2.cliArgs.goal : null;
   if (targetGoal && targetGoal !== goalId && options.checkTargets !== false) {
-    const target = fetchGoalState(ctx.config, targetGoal, ctx.cwd);
+    const target = await fetchGoalStateAsync(ctx.config, targetGoal, ctx.cwd);
     const targetManaged = target ? managedGoalFromState(expandManagedGoalState(target)) : null;
     const targetIsGoal = targetManaged ? managedModelKind(targetManaged) === "Goal" : false;
     const targetMode = targetManaged && targetIsGoal ? firstTrustOverride(ctx, subjectCandidates("goal", targetGoal, target)) : null;
@@ -10616,7 +10653,7 @@ var init_advanceManagedGoal = __esm({
         const beforeSnapshot = goalRunLogSnapshot(goal.id, goal.state, managed);
         const previousScheduleState = goal.raw.extra.scheduleState && typeof goal.raw.extra.scheduleState === "object" ? goal.raw.extra.scheduleState : void 0;
         const now = goalLoopNow();
-        const activeTarget = isGoalTargetLoop(managed) ? resolveActiveGoalLoopTarget(ctx.config, ctx.cwd, goal.id, managed) : null;
+        const activeTarget = isGoalTargetLoop(managed) ? await resolveActiveGoalLoopTarget(ctx.config, ctx.cwd, goal.id, managed) : null;
         const allowSameDayTargetDispatch = isGoalTargetLoop(managed) && (!!activeTarget || previousDispatchWasTargetInstance(managed, previousScheduleState));
         let decision2 = planTargetLoopSchedule({
           goal: managed,
@@ -10625,7 +10662,7 @@ var init_advanceManagedGoal = __esm({
           allowSameDayTargetDispatch
         });
         let targetResolution;
-        const selfAutonomyBlock = decision2.kind === "dispatch" && decision2.dispatch ? autonomyBlockReason(ctx, goal.id, managed, goal.raw, decision2.dispatch, { checkTargets: false }) : null;
+        const selfAutonomyBlock = decision2.kind === "dispatch" && decision2.dispatch ? await autonomyBlockReason(ctx, goal.id, managed, goal.raw, decision2.dispatch, { checkTargets: false }) : null;
         if (selfAutonomyBlock) {
           restoreGoalIdFact();
           goal.raw = writeManagedGoalToState({ ...goal.raw, state: goal.state }, managed);
@@ -10637,7 +10674,7 @@ var init_advanceManagedGoal = __esm({
           return;
         }
         if (decision2.kind === "dispatch" && decision2.dispatch && isGoalTargetLoop(managed)) {
-          targetResolution = resolveGoalLoopTarget(ctx.config, ctx.cwd, goal.id, managed, now);
+          targetResolution = await resolveGoalLoopTarget(ctx.config, ctx.cwd, goal.id, managed, now);
           decision2 = planTargetLoopSchedule({
             goal: managed,
             previousScheduleState,
@@ -10648,7 +10685,7 @@ var init_advanceManagedGoal = __esm({
         }
         restoreGoalIdFact();
         goal.raw = writeManagedGoalToState({ ...goal.raw, state: goal.state }, managed);
-        const autonomyBlock = decision2.kind === "dispatch" && decision2.dispatch ? autonomyBlockReason(ctx, goal.id, managed, goal.raw, decision2.dispatch) : null;
+        const autonomyBlock = decision2.kind === "dispatch" && decision2.dispatch ? await autonomyBlockReason(ctx, goal.id, managed, goal.raw, decision2.dispatch) : null;
         if (autonomyBlock) {
           const waitDecision = scheduleWaitDecision(previousScheduleState, decision2, autonomyBlock);
           goal.raw.extra.scheduleState = waitDecision.scheduleState;
@@ -10713,7 +10750,7 @@ var init_advanceManagedGoal = __esm({
         });
         restoreGoalIdFact();
         goal.raw = writeManagedGoalToState({ ...goal.raw, state: goal.state }, managed);
-        const autonomyBlock = decision2.kind === "dispatch" && decision2.dispatch ? autonomyBlockReason(ctx, goal.id, managed, goal.raw, decision2.dispatch) : null;
+        const autonomyBlock = decision2.kind === "dispatch" && decision2.dispatch ? await autonomyBlockReason(ctx, goal.id, managed, goal.raw, decision2.dispatch) : null;
         if (autonomyBlock) {
           const waitDecision = scheduleWaitDecision(previousScheduleState, decision2, autonomyBlock);
           goal.raw.extra.scheduleState = waitDecision.scheduleState;
@@ -10783,7 +10820,7 @@ var init_advanceManagedGoal = __esm({
           ...decision.implementation ? { implementation: decision.implementation } : {},
           cliArgs: decision.cliArgs
         };
-        const autonomyBlock = autonomyBlockReason(ctx, goal.id, managed, goal.raw, planned);
+        const autonomyBlock = await autonomyBlockReason(ctx, goal.id, managed, goal.raw, planned);
         if (autonomyBlock) {
           stageAutonomyBlocked(ctx.data, goal.id, managed, goal.state, autonomyBlock);
           ctx.output.reason = autonomyBlock;
@@ -11592,7 +11629,7 @@ var init_applyCapabilityReports = __esm({
       if (evidenceItems.length === 0) return;
       const evidenceByGoal = groupGoalEvidence(evidenceItems);
       for (const [goalId, goalEvidence] of evidenceByGoal) {
-        const prior = fetchGoalState(ctx.config, goalId, ctx.cwd);
+        const prior = await fetchGoalStateAsync(ctx.config, goalId, ctx.cwd);
         if (!prior) {
           stageGoalRunLogEvent(ctx.data, goalId, {
             source: "goal-loop",
@@ -11667,7 +11704,7 @@ var init_applyCapabilityReports = __esm({
         const nextForOutput = changed ? { ...next, updatedAt: nowIso() } : next;
         try {
           if (changed) {
-            putGoalState(ctx.config, goalId, nextForOutput, describeMessage(goalId, goalEvidence), ctx.cwd);
+            await putGoalStateAsync(ctx.config, goalId, nextForOutput, describeMessage(goalId, goalEvidence), ctx.cwd);
           }
           refreshReportOrFail(ctx, goalId, nextForOutput, goalEvidence);
           if (changed && ctx.output.exitCode === 0 && !ctx.output.nextDispatch && shouldResumeManagedGoal(goalId, nextForOutput)) {
@@ -12015,7 +12052,7 @@ var init_commitGoalState = __esm({
         return;
       }
       try {
-        putGoalState(ctx.config, goal.id, updated, describeCommitMessage(goal), ctx.cwd);
+        await putGoalStateAsync(ctx.config, goal.id, updated, describeCommitMessage(goal), ctx.cwd);
         refreshReportOrFail2(ctx, goal.id, updated);
       } catch (err) {
         process.stderr.write(
@@ -12723,7 +12760,7 @@ ${markdown}`, ctx.cwd);
     extra: { version: 1, ...managedGoal }
   };
   try {
-    putGoalState(ctx.config, goalId, goalState, `chore(goals): activate ${goalId}`, ctx.cwd);
+    await putGoalStateAsync(ctx.config, goalId, goalState, `chore(goals): activate ${goalId}`, ctx.cwd);
   } catch (err) {
     process.stderr.write(
       `[createQaGoal] failed to persist goal state to state repo: ${err instanceof Error ? err.message : String(err)}
@@ -14999,11 +15036,35 @@ function listCompanyIntents(config, cwd) {
   }
   return records.sort((a, b) => a.intent.priority - b.intent.priority || a.id.localeCompare(b.id));
 }
-function listCompanyPortfolio(config, cwd) {
+function backendTenant2(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 backendEnabled2(config) {
+  return Boolean(process.env.CONVEX_URL?.trim() && process.env.KODY_SERVICE_KEY?.trim() && backendTenant2(config));
+}
+function backendRequired2() {
+  return process.env.GITHUB_ACTIONS === "true";
+}
+async function listCompanyIntentsAsync(config, cwd) {
+  const tenantId = backendTenant2(config);
+  if (backendEnabled2(config) && tenantId) {
+    const records = await createStateBackendFromEnv().listIntents(tenantId);
+    return records.filter((record) => isCompanyIntentId(record.intentId)).map((record) => ({
+      id: record.intentId,
+      path: `convex:intents/${record.intentId}`,
+      intent: normalizeCompanyIntent(`convex:intents/${record.intentId}`, record.intent)
+    })).sort((a, b) => a.intent.priority - b.intent.priority || a.id.localeCompare(b.id));
+  }
+  if (backendRequired2()) throw new Error("Convex backend is required for company intents in GitHub Actions");
+  return listCompanyIntents(config, cwd);
+}
+async function listCompanyPortfolio(config, cwd) {
   const goals = [];
-  for (const id of listGoalStateIds(config, cwd)) {
+  for (const id of await listGoalStateIdsAsync(config, cwd)) {
     if (!isCompanyIntentId(id)) continue;
-    const state = fetchGoalState(config, id, cwd);
+    const state = await fetchGoalStateAsync(config, id, cwd);
     if (!state) continue;
     const destination = recordField5(state.extra.destination);
     goals.push({
@@ -15064,6 +15125,7 @@ var init_companyIntent = __esm({
     "use strict";
     init_state2();
     init_stateStore();
+    init_state_backend();
     init_stateRepo();
     SLUG_RE = /^[a-z][a-z0-9-]{0,63}$/;
   }
@@ -15076,7 +15138,7 @@ var init_loadCompanyIntents = __esm({
     "use strict";
     init_companyIntent();
     loadCompanyIntents = async (ctx) => {
-      const intents = listCompanyIntents(ctx.config, ctx.cwd);
+      const intents = await listCompanyIntentsAsync(ctx.config, ctx.cwd);
       const active = intents.filter((record) => record.intent.status === "active");
       ctx.data.companyIntents = intents;
       ctx.data.companyActiveIntents = active;
@@ -15099,7 +15161,7 @@ var init_loadCompanyPortfolio = __esm({
     "use strict";
     init_companyIntent();
     loadCompanyPortfolio = async (ctx) => {
-      const portfolio = listCompanyPortfolio(ctx.config, ctx.cwd);
+      const portfolio = await listCompanyPortfolio(ctx.config, ctx.cwd);
       ctx.data.companyPortfolio = portfolio;
       ctx.data.companyPortfolioJson = JSON.stringify(portfolio, null, 2);
     };

package/package.json

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