@kody-ade/kody-engine 0.4.630 → 0.4.632

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.630",
+      version: "0.4.632",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       repository: {
@@ -2563,6 +2563,7 @@ function parseReportPublication(value) {
   const slugFact = stringField(value.slugFact);
   const title = stringField(value.title);
   const titleFact = stringField(value.titleFact);
+  const bodyFact = stringField(value.bodyFact);
   const publishWhenFact = stringField(value.publishWhenFact);
   const reviewStatus = stringField(value.reviewStatus);
   const reviewArea = stringField(value.reviewArea);
@@ -2575,6 +2576,7 @@ function parseReportPublication(value) {
     ...slugFact ? { slugFact } : {},
     ...title ? { title } : {},
     ...titleFact ? { titleFact } : {},
+    ...bodyFact ? { bodyFact } : {},
     ...publishWhenFact ? { publishWhenFact } : {},
     ...reviewStatus ? { reviewStatus } : {},
     ...reviewArea ? { reviewArea } : {}
@@ -3388,6 +3390,12 @@ function createStateBackendFromEnv(env = process.env, client) {
         updatedAt
       });
     },
+    async listReports(tenantId2) {
+      const result = await transport.query(anyApi.reports.list, {
+        tenantId: requireTenant(tenantId2)
+      });
+      return Array.isArray(result) ? result : [];
+    },
     async listIntents(tenantId2) {
       const result = await transport.query(anyApi.intents.list, { tenantId: requireTenant(tenantId2) });
       return Array.isArray(result) ? result : [];
@@ -3989,6 +3997,105 @@ function capabilityToolDefinitions(opts) {
       return { content: [{ type: "text", text: text2 }] };
     }
   };
+  const readLatestReportTool = {
+    name: "read_latest_report",
+    description: "Read the newest persisted Kody Report for this repository. Optionally restrict to one stable report slug or reports newer than an ISO timestamp. Returns the Report body and metadata; use it as evidence before deciding whether work is needed.",
+    inputSchema: {
+      slug: z3.string().regex(/^[a-z0-9][a-z0-9_-]{0,79}$/).optional(),
+      since: z3.string().datetime().optional()
+    },
+    handler: async (args) => {
+      const slug = typeof args.slug === "string" ? args.slug : void 0;
+      const since = typeof args.since === "string" ? args.since : void 0;
+      const reports = await createStateBackendFromEnv().listReports(opts.repoSlug);
+      const report = reports.filter((candidate) => (!slug || candidate.slug === slug) && (!since || candidate.updatedAt > since)).sort((left, right) => right.updatedAt.localeCompare(left.updatedAt))[0];
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              report ? {
+                found: true,
+                slug: report.slug,
+                runId: report.runId,
+                title: report.title,
+                body: report.body,
+                meta: report.meta,
+                updatedAt: report.updatedAt
+              } : { found: false },
+              null,
+              2
+            )
+          }
+        ]
+      };
+    }
+  };
+  const reconcileTodoTool = {
+    name: "reconcile_todo",
+    description: "Idempotently create, update, close, or reopen one canonical repository Todo for a recurring problem. The stable slug and item id prevent duplicates. Repeating the same state is a no-op; unrelated items in an existing Todo are preserved.",
+    inputSchema: {
+      slug: z3.string().regex(/^[a-z0-9][a-z0-9_-]{0,63}$/),
+      itemId: z3.string().regex(/^[a-z0-9][a-z0-9_-]{0,79}$/).optional(),
+      title: z3.string().min(1).max(160),
+      description: z3.string().max(2e4).optional(),
+      status: z3.enum(["open", "resolved"]),
+      reportSlug: z3.string().regex(/^[a-z0-9][a-z0-9_-]{0,79}$/),
+      reportRunId: z3.string().max(160).optional(),
+      evidence: z3.string().max(2e4).optional()
+    },
+    handler: async (args) => {
+      const slug = String(args.slug);
+      const itemId = typeof args.itemId === "string" ? args.itemId : "finding";
+      const title = String(args.title).trim();
+      const description = typeof args.description === "string" ? args.description.trim() : "";
+      const status = args.status === "resolved" ? "resolved" : "open";
+      const reportSlug = String(args.reportSlug);
+      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
+        }
+      };
+      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 }) }] };
+    }
+  };
   const cmsTools = dashboardCmsToolDefinitions({
     repoSlug: opts.repoSlug,
     assertWriteAllowed: () => assertCmsWriteAllowed(opts)
@@ -4005,6 +4112,8 @@ function capabilityToolDefinitions(opts) {
     ensureIssueTool,
     ensureCommentTool,
     startCapabilityTool,
+    readLatestReportTool,
+    reconcileTodoTool,
     ...cmsTools
   ];
 }
@@ -4033,6 +4142,7 @@ var init_capabilityMcp = __esm({
     init_issue();
     init_registry();
     init_trustPolicy();
+    init_state_backend();
     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;
@@ -4052,6 +4162,8 @@ var init_capabilityMcp = __esm({
       "ensure_issue",
       "ensure_comment",
       "start_capability",
+      "read_latest_report",
+      "reconcile_todo",
       ...DASHBOARD_CMS_MCP_TOOL_NAMES
     ];
   }
@@ -16693,7 +16805,7 @@ var init_loadLiveAgent = __esm({
         }
       };
       ctx.data.jobStateJson = JSON.stringify(state, null, 2);
-      ctx.data.capabilityTools = ["start_capability"];
+      ctx.data.capabilityTools = ["start_capability", "read_latest_report", "reconcile_todo"];
       ctx.data.capabilityToolMode = "lock";
       profile.claudeCode.enableSubmitTool = true;
     };

package/dist/implementations/live-agent/profile.json

@@ -13,7 +13,12 @@
     "maxThinkingTokens": null,
     "systemPromptAppend": null,
     "enableSubmitTool": true,
-    "tools": ["mcp__kody-capability__start_capability", "mcp__kody-submit__submit_state"],
+    "tools": [
+      "mcp__kody-capability__start_capability",
+      "mcp__kody-capability__read_latest_report",
+      "mcp__kody-capability__reconcile_todo",
+      "mcp__kody-submit__submit_state"
+    ],
     "hooks": [], "skills": [], "commands": [], "subagents": [], "plugins": [], "mcpServers": []
   },
   "cliTools": [],

package/dist/implementations/live-agent/prompt.md

@@ -30,7 +30,9 @@ You are a persistent Kody Agent completing one scheduled cycle.
 {{jobStateJson}}
 ```
 
-Inspect current conditions, decide the best next action toward the Intent, and use only assigned capabilities. Do not create work merely to appear active. If waiting is correct, record what is being awaited.
+Inspect current conditions, decide the best next action toward the Intent, and use only assigned capabilities. A dispatched capability may finish after this cycle: record its run, then inspect its Report on a later cycle. Treat the Report as evidence; you make the decision.
+
+For an actionable recurring problem, reconcile one stable Todo whose slug identifies the problem. Reuse and update that Todo while the problem remains open, close it when a later Report proves recovery, and reopen the same Todo if the problem returns. Do not create work merely to appear active. If the newest Report was already handled or waiting is correct, make no change and record what is being awaited.
 
 As your final action, call `submit_state` exactly once with:
 - `cursor`: the next continuation cursor;

package/package.json

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