@kody-ade/kody-engine 0.4.156 → 0.4.157

package/dist/bin/kody.js

@@ -1061,7 +1061,7 @@ var init_loadPriorArt = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.156",
+  version: "0.4.157",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -2935,7 +2935,7 @@ function autoDispatch(opts) {
   const authorLogin = String(event.comment?.user?.login ?? "");
   const authorType = String(event.comment?.user?.type ?? "");
   if (!rawBody.toLowerCase().includes("@kody")) return null;
-  if (authorLogin === "kody-bot" || authorType === "Bot") return null;
+  const isBotAuthor = authorLogin === "kody-bot" || authorType === "Bot";
   if (!associationAllowed(event, opts?.config)) return null;
   const body = rawBody.toLowerCase();
   const targetNum = Number(event.issue?.number ?? 0);
@@ -2962,6 +2962,13 @@ function autoDispatch(opts) {
   if (!executable && !firstToken) {
     executable = isPr ? opts?.config?.defaultPrExecutable ?? "fix" : opts?.config?.defaultExecutable ?? null;
   }
+  if (isBotAuthor && !consumedFirstToken) {
+    process.stderr.write(
+      `[kody] dispatch: ignoring bot comment without an explicit command (author=${authorLogin || authorType}, firstToken=${firstToken ?? "<none>"})
+`
+    );
+    return null;
+  }
   if (!executable) {
     const profileMissing = aliased ? getProfileInputs(aliased) === null : true;
     process.stderr.write(
@@ -4562,40 +4569,73 @@ function writeTaskState(target, number, state, cwd) {
 
 // src/scripts/advanceFlow.ts
 var API_TIMEOUT_MS3 = 3e4;
+var FLOW_HOP_CAP = 25;
+function ghComment(issueNumber, body, cwd, label) {
+  try {
+    execFileSync8("gh", ["issue", "comment", String(issueNumber), "--body", body], {
+      timeout: API_TIMEOUT_MS3,
+      cwd,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+  } catch (err) {
+    process.stderr.write(
+      `[kody advanceFlow] ${label} on issue #${issueNumber} failed: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+}
 var advanceFlow = async (ctx, profile) => {
   const state = ctx.data.taskState;
   const flow = state?.flow;
   if (!flow?.issueNumber) return;
+  const curState = state;
+  let issueState;
+  try {
+    issueState = readTaskState("issue", flow.issueNumber, ctx.cwd);
+  } catch {
+    issueState = curState;
+  }
   const targetType = ctx.data.commentTargetType;
   const action = ctx.data.action;
+  let nextIssueState = issueState;
   if (targetType === "pr" && action) {
+    nextIssueState = reduce(issueState, profile.name, action, profile.phase);
+    if (state?.core.prUrl && !nextIssueState.core.prUrl) nextIssueState.core.prUrl = state.core.prUrl;
+  }
+  const prevHops = issueState.flow?.hops ?? flow.hops ?? 0;
+  const hops = prevHops + 1;
+  if (hops > FLOW_HOP_CAP) {
+    nextIssueState.flow = void 0;
     try {
-      const issueState = readTaskState("issue", flow.issueNumber, ctx.cwd);
-      issueState.flow = flow;
-      const next = reduce(issueState, profile.name, action, profile.phase);
-      if (state?.core.prUrl && !next.core.prUrl) next.core.prUrl = state.core.prUrl;
-      next.flow = flow;
-      writeTaskState("issue", flow.issueNumber, next, ctx.cwd);
+      writeTaskState("issue", flow.issueNumber, nextIssueState, ctx.cwd);
     } catch (err) {
       process.stderr.write(
-        `[kody advanceFlow] failed to mirror action to issue #${flow.issueNumber}: ${err instanceof Error ? err.message : String(err)}
+        `[kody advanceFlow] failed to clear looping flow on issue #${flow.issueNumber}: ${err instanceof Error ? err.message : String(err)}
 `
       );
     }
+    ghComment(
+      flow.issueNumber,
+      `\u26A0\uFE0F kody: flow \`${flow.name}\` stopped after ${FLOW_HOP_CAP} steps without completing (loop guard). Re-trigger manually if this was intended.`,
+      ctx.cwd,
+      "loop-guard notice"
+    );
+    process.stderr.write(
+      `[kody advanceFlow] flow '${flow.name}' on issue #${flow.issueNumber} hit hop cap ${FLOW_HOP_CAP}; stopping
+`
+    );
+    return;
   }
-  const body = `@kody ${flow.name}`;
+  nextIssueState.flow = { ...flow, hops };
   try {
-    execFileSync8("gh", ["issue", "comment", String(flow.issueNumber), "--body", body], {
-      timeout: API_TIMEOUT_MS3,
-      cwd: ctx.cwd,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
+    writeTaskState("issue", flow.issueNumber, nextIssueState, ctx.cwd);
   } catch (err) {
     process.stderr.write(
-      `[kody advanceFlow] failed to re-trigger orchestrator on issue #${flow.issueNumber}: ${err instanceof Error ? err.message : String(err)}
+      `[kody advanceFlow] failed to persist hop count on issue #${flow.issueNumber}: ${err instanceof Error ? err.message : String(err)}
 `
     );
   }
+  ghComment(flow.issueNumber, `@kody ${flow.name}`, ctx.cwd, "re-trigger orchestrator");
 };
 
 // src/scripts/brainServe.ts
@@ -12124,7 +12164,8 @@ var startFlow = async (ctx, profile, _agentResult, args) => {
       name: flowName,
       step: entry,
       issueNumber,
-      startedAt: (/* @__PURE__ */ new Date()).toISOString()
+      startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      hops: 0
     };
   }
   postKodyComment(target, issueNumber, state, entry, ctx.cwd);

package/package.json

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