@kody-ade/kody-engine 0.4.637 → 0.4.639

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.637",
+      version: "0.4.639",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       repository: {
@@ -181,6 +181,19 @@ var init_completionGuard = __esm({
 });
 
 // src/submitStateGuard.ts
+function createSubmitStateActivityGuard() {
+  let hasActivity = false;
+  return {
+    recordToolUse: async (input) => {
+      if (input?.tool_name !== SUBMIT_STATE_TOOL) hasActivity = true;
+      return {};
+    },
+    requireActivity: async () => hasActivity ? {} : {
+      decision: "block",
+      reason: ACTIVITY_REQUIRED_REASON
+    }
+  };
+}
 function createPostSubmitToolGuard(getSubmitted) {
   return async () => getSubmitted() ? {
     decision: "block",
@@ -199,12 +212,14 @@ function createSubmitStateStopHook(getSubmitted) {
     };
   };
 }
-var FINAL_STATE_CHANCE_REASON, STATE_ALREADY_SUBMITTED_REASON;
+var FINAL_STATE_CHANCE_REASON, STATE_ALREADY_SUBMITTED_REASON, ACTIVITY_REQUIRED_REASON, SUBMIT_STATE_TOOL;
 var init_submitStateGuard = __esm({
   "src/submitStateGuard.ts"() {
     "use strict";
     FINAL_STATE_CHANCE_REASON = "Before finishing, call `submit_state` exactly once with the next non-empty `cursor`, compact durable `data`, and the correct `done` value. Do not perform more work; submit only the continuation state now.";
     STATE_ALREADY_SUBMITTED_REASON = "Continuation state is already submitted for this cycle. Do not call more tools or perform more work; return your final response now.";
+    ACTIVITY_REQUIRED_REASON = "Do not submit continuation state yet. First use a tool to observe current evidence or perform the next responsibility action for this cycle.";
+    SUBMIT_STATE_TOOL = "mcp__kody-submit__submit_state";
   }
 });
 
@@ -4084,46 +4099,71 @@ function capabilityToolDefinitions(opts) {
       const reportRunId = typeof args.reportRunId === "string" ? args.reportRunId : void 0;
       const evidence = typeof args.evidence === "string" ? args.evidence.trim() : "";
       const backend = createStateBackendFromEnv();
-      const existing = await backend.getRepoDoc(opts.repoSlug, `todo:${slug}`);
       const now = (/* @__PURE__ */ new Date()).toISOString();
-      const current = existing?.doc && typeof existing.doc === "object" && !Array.isArray(existing.doc) ? existing.doc : {};
-      const currentItems = Array.isArray(current.items) ? current.items.filter((item) => Boolean(item && typeof item === "object" && !Array.isArray(item))) : [];
-      const previous = currentItems.find((item) => item.id === itemId);
       const completed = status === "resolved";
-      const previousMeta = previous?.meta && typeof previous.meta === "object" && !Array.isArray(previous.meta) ? previous.meta : {};
-      const unchanged = Boolean(
-        previous && previous.completed === completed && previous.title === title && String(previous.body ?? "") === evidence && previousMeta.reportSlug === reportSlug
-      );
-      if (unchanged) {
-        return { content: [{ type: "text", text: JSON.stringify({ changed: false, slug, status }) }] };
-      }
-      const nextItem = {
-        id: itemId,
-        title,
-        body: evidence,
-        assignee: null,
-        completed,
-        createdAt: typeof previous?.createdAt === "string" ? previous.createdAt : now,
-        completedAt: completed ? now : null,
-        meta: {
-          ...previousMeta,
-          source: "live-agent",
-          reportSlug,
-          ...reportRunId ? { reportRunId } : {},
-          status
+      let lastError = new Error(`Todo ${slug}/${itemId} was not visible after reconciliation`);
+      for (let attempt = 0; attempt < 3; attempt += 1) {
+        try {
+          const existing = await backend.getRepoDoc(opts.repoSlug, `todo:${slug}`);
+          const current = existing?.doc && typeof existing.doc === "object" && !Array.isArray(existing.doc) ? existing.doc : {};
+          const currentItems = Array.isArray(current.items) ? current.items.filter(
+            (item) => Boolean(item && typeof item === "object" && !Array.isArray(item))
+          ) : [];
+          const previous = currentItems.find((item) => item.id === itemId);
+          const previousMeta = previous?.meta && typeof previous.meta === "object" && !Array.isArray(previous.meta) ? previous.meta : {};
+          const unchanged = Boolean(
+            previous && previous.completed === completed && previous.title === title && String(previous.body ?? "") === evidence && previousMeta.reportSlug === reportSlug
+          );
+          if (unchanged) {
+            return {
+              content: [{ type: "text", text: JSON.stringify({ changed: false, verified: true, slug, status }) }]
+            };
+          }
+          const nextItem = {
+            id: itemId,
+            title,
+            body: evidence,
+            assignee: null,
+            completed,
+            createdAt: typeof previous?.createdAt === "string" ? previous.createdAt : now,
+            completedAt: completed ? now : null,
+            meta: {
+              ...previousMeta,
+              source: "live-agent",
+              reportSlug,
+              ...reportRunId ? { reportRunId } : {},
+              status
+            }
+          };
+          const items = previous ? currentItems.map((item) => item.id === itemId ? nextItem : item) : [...currentItems, nextItem];
+          const doc = {
+            ...current,
+            version: 1,
+            title,
+            description,
+            createdAt: typeof current.createdAt === "string" ? current.createdAt : now,
+            items
+          };
+          await backend.saveRepoDoc(opts.repoSlug, `todo:${slug}`, doc, existing?.updatedAt);
+          const saved = await backend.getRepoDoc(opts.repoSlug, `todo:${slug}`);
+          const savedItems = saved?.doc && typeof saved.doc === "object" && !Array.isArray(saved.doc) && Array.isArray(saved.doc.items) ? saved.doc.items : [];
+          const savedItem = savedItems.find(
+            (item) => Boolean(
+              item && typeof item === "object" && !Array.isArray(item) && item.id === itemId
+            )
+          );
+          const savedMeta = savedItem?.meta && typeof savedItem.meta === "object" && !Array.isArray(savedItem.meta) ? savedItem.meta : {};
+          if (savedItem && savedItem.completed === completed && savedItem.title === title && String(savedItem.body ?? "") === evidence && savedMeta.reportSlug === reportSlug) {
+            return {
+              content: [{ type: "text", text: JSON.stringify({ changed: true, verified: true, slug, status }) }]
+            };
+          }
+          lastError = new Error(`Todo ${slug}/${itemId} was not visible after reconciliation attempt ${attempt + 1}`);
+        } catch (error) {
+          lastError = error;
         }
-      };
-      const items = previous ? currentItems.map((item) => item.id === itemId ? nextItem : item) : [...currentItems, nextItem];
-      const doc = {
-        ...current,
-        version: 1,
-        title,
-        description,
-        createdAt: typeof current.createdAt === "string" ? current.createdAt : now,
-        items
-      };
-      await backend.saveRepoDoc(opts.repoSlug, `todo:${slug}`, doc, existing?.updatedAt);
-      return { content: [{ type: "text", text: JSON.stringify({ changed: true, slug, status }) }] };
+      }
+      throw lastError;
     }
   };
   const cmsTools = dashboardCmsToolDefinitions({
@@ -4171,8 +4211,8 @@ var init_capabilityMcp = __esm({
     init_dashboardCmsMcp();
     init_issue();
     init_registry();
-    init_trustPolicy();
     init_state_backend();
+    init_trustPolicy();
     FAIL_CONCLUSIONS = /* @__PURE__ */ new Set(["FAILURE", "TIMED_OUT", "ACTION_REQUIRED", "STARTUP_FAILURE", "CANCELLED"]);
     RUNNING_STATUSES = /* @__PURE__ */ new Set(["IN_PROGRESS", "QUEUED", "PENDING", "WAITING", "REQUESTED"]);
     THREAD_BODY_MAX = 4e3;
@@ -4445,6 +4485,7 @@ async function runAgent(opts) {
   const outputContractStopHook = opts.outputContract ? createOutputContractStopHook(opts.outputContract) : null;
   const submitStateStopHook = opts.enableSubmitTool ? createSubmitStateStopHook(() => getSubmitted?.()) : null;
   const postSubmitToolGuard = opts.enableSubmitTool ? createPostSubmitToolGuard(() => getSubmitted?.()) : null;
+  const submitStateActivityGuard = opts.enableSubmitTool ? createSubmitStateActivityGuard() : null;
   let finalSafeToReplay = true;
   for (let attempt = 0; ; attempt++) {
     let ndjsonWriteFailed = false;
@@ -4493,6 +4534,12 @@ async function runAgent(opts) {
                 hooks: [completionGuard]
               }
             ] : [],
+            ...submitStateActivityGuard ? [
+              {
+                matcher: "mcp__kody-submit__submit_state",
+                hooks: [submitStateActivityGuard.requireActivity]
+              }
+            ] : [],
             {
               matcher: "Agent",
               hooks: [enforceSubagentModelInheritance]
@@ -4503,6 +4550,11 @@ async function runAgent(opts) {
             }
           ],
           PostToolUse: [
+            ...submitStateActivityGuard ? [
+              {
+                hooks: [submitStateActivityGuard.recordToolUse]
+              }
+            ] : [],
             {
               matcher: "Agent",
               hooks: [subagentInvocationHook]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.637",
+  "version": "0.4.639",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
   "license": "MIT",
   "repository": {
@@ -17,6 +17,30 @@
     "docs/delivery-boundary.md",
     "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",
+    "verify:live-release": "tsx scripts/live-release-gate.ts",
+    "test:runtime-services": "node --test \"tests/runtime-services/*.test.mjs\"",
+    "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 --build-arg KODY_ENGINE_REF=$(git rev-parse HEAD) -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner",
+    "prepublishOnly": "pnpm typecheck && pnpm test:runtime-services && pnpm build && pnpm verify:package"
+  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
@@ -39,28 +63,5 @@
     "node": ">=22"
   },
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
-  "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",
-    "verify:live-release": "tsx scripts/live-release-gate.ts",
-    "test:runtime-services": "node --test \"tests/runtime-services/*.test.mjs\"",
-    "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 --build-arg KODY_ENGINE_REF=$(git rev-parse HEAD) -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner"
-  }
-}
+  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
+}