@kody-ade/kody-engine 0.4.34 → 0.4.36

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.34",
+  version: "0.4.36",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -1101,6 +1101,18 @@ function parseGenericFlags(argv) {
 }
 
 // src/dispatch.ts
+var POLITE_WORDS = /* @__PURE__ */ new Set([
+  "please",
+  "kindly",
+  "hi",
+  "hey",
+  "hello",
+  "thanks",
+  "thank",
+  "plz",
+  "pls",
+  "yo"
+]);
 function autoDispatch(opts) {
   const explicit = opts?.explicit;
   if (explicit?.issueNumber && explicit.issueNumber > 0) {
@@ -1135,7 +1147,8 @@ function autoDispatch(opts) {
   const isPr = !!event.issue?.pull_request;
   if (!targetNum) return null;
   const afterTag = extractAfterTag(body);
-  const firstToken = extractSubcommand(afterTag);
+  const firstTokenRaw = extractSubcommand(afterTag);
+  const firstToken = firstTokenRaw && POLITE_WORDS.has(firstTokenRaw) ? null : firstTokenRaw;
   const aliases = opts?.config?.aliases ?? BUILTIN_ALIASES;
   const aliased = firstToken ? aliases[firstToken] ?? firstToken : null;
   let executable = null;
@@ -1151,7 +1164,7 @@ function autoDispatch(opts) {
       );
     }
   }
-  if (!executable) {
+  if (!executable && !firstToken) {
     executable = isPr ? opts?.config?.defaultPrExecutable ?? "fix" : opts?.config?.defaultExecutable ?? null;
   }
   if (!executable) {
@@ -1178,6 +1191,45 @@ function autoDispatch(opts) {
   }
   return { executable, cliArgs: args, target: targetNum };
 }
+function autoDispatchTyped(opts) {
+  const legacy = autoDispatch(opts);
+  if (legacy) return { kind: "route", ...legacy };
+  const eventName = process.env.GITHUB_EVENT_NAME;
+  const eventPath = process.env.GITHUB_EVENT_PATH;
+  if (!eventName || !eventPath || !fs7.existsSync(eventPath)) {
+    return { kind: "silent", reason: "no GHA event context" };
+  }
+  if (eventName !== "issue_comment") {
+    return { kind: "silent", reason: `event ${eventName} has no comment to inspect` };
+  }
+  let event = {};
+  try {
+    event = JSON.parse(fs7.readFileSync(eventPath, "utf-8"));
+  } catch {
+    return { kind: "silent", reason: "GHA event payload unreadable" };
+  }
+  const rawBody = String(event.comment?.body ?? "");
+  const authorLogin = String(event.comment?.user?.login ?? "");
+  const authorType = String(event.comment?.user?.type ?? "");
+  if (!rawBody.toLowerCase().includes("@kody")) {
+    return { kind: "silent", reason: "comment does not mention @kody" };
+  }
+  if (authorLogin === "kody-bot" || authorType === "Bot") {
+    return { kind: "silent", reason: `bot-authored comment (${authorLogin || authorType})` };
+  }
+  const targetNum = Number(event.issue?.number ?? 0);
+  const isPr = !!event.issue?.pull_request;
+  if (!targetNum) {
+    return { kind: "silent", reason: "comment has no associated issue/PR number" };
+  }
+  const afterTag = extractAfterTag(rawBody.toLowerCase());
+  const tokenRaw = extractSubcommand(afterTag) ?? "";
+  if (!tokenRaw || POLITE_WORDS.has(tokenRaw)) {
+    return { kind: "silent", reason: tokenRaw ? `polite-word lead-in '${tokenRaw}', no default executable configured` : "no subcommand token, no default executable configured" };
+  }
+  const available = listExecutables().map((e) => e.name).filter((n) => !n.startsWith("goal-") && !n.startsWith("job-")).sort();
+  return { kind: "unrecognized", token: tokenRaw, target: targetNum, isPr, available };
+}
 function dispatchScheduledWatches(opts) {
   const now = opts?.now ?? /* @__PURE__ */ new Date();
   const envWindow = Number(process.env.KODY_SCHEDULE_WINDOW_SEC);
@@ -1298,11 +1350,6 @@ function coerceBare(spec, value) {
   return value;
 }
 
-// src/executor.ts
-import { execFileSync as execFileSync30, spawn as spawn5 } from "child_process";
-import * as fs28 from "fs";
-import * as path26 from "path";
-
 // src/issue.ts
 import { execFileSync as execFileSync3 } from "child_process";
 var API_TIMEOUT_MS = 3e4;
@@ -1444,6 +1491,11 @@ function postPrReviewComment(prNumber, body, cwd) {
   }
 }
 
+// src/executor.ts
+import { execFileSync as execFileSync30, spawn as spawn5 } from "child_process";
+import * as fs28 from "fs";
+import * as path26 from "path";
+
 // src/profile.ts
 import * as fs8 from "fs";
 import * as path7 from "path";
@@ -10100,6 +10152,31 @@ async function runCi(argv) {
     return runScheduledFanOut(cwd, args, { force: manualWorkflowDispatch });
   }
   if (!args.issueNumber && !autoFallback && process.env.GITHUB_EVENT_NAME) {
+    const outcome = autoDispatchTyped({ config: earlyConfig });
+    if (outcome.kind === "unrecognized") {
+      const tokenLabel = outcome.token ? `\`${outcome.token}\`` : "an empty subcommand";
+      const top = outcome.available.slice(0, 12).join(", ");
+      const more = outcome.available.length > 12 ? `, \u2026 (${outcome.available.length - 12} more)` : "";
+      const body = [
+        `\u26A0\uFE0F kody: I don't recognize ${tokenLabel}.`,
+        "",
+        `Available subcommands: ${top}${more}`,
+        "",
+        "Examples: `@kody`, `@kody fix`, `@kody plan`, `@kody review`."
+      ].join("\n");
+      try {
+        if (outcome.isPr) postPrReviewComment(outcome.target, body, cwd);
+        else postIssueComment(outcome.target, body, cwd);
+      } catch (err) {
+        process.stderr.write(`[kody] dispatch: failed to post unrecognized-token feedback: ${err instanceof Error ? err.message : String(err)}
+`);
+      }
+      process.stdout.write(
+        `\u2192 kody: unrecognized subcommand "${outcome.token}" on #${outcome.target} \u2014 feedback comment posted, exiting cleanly
+`
+      );
+      return 0;
+    }
     process.stdout.write(`\u2192 kody: no action for event ${process.env.GITHUB_EVENT_NAME} \u2014 exiting cleanly
 `);
     return 0;

package/package.json

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