@kody-ade/kody-engine 0.3.1 → 0.3.2

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.3.1",
+  version: "0.3.2",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -182,10 +182,26 @@ function loadConfig(projectDir = process.cwd()) {
     issueContext: parseIssueContext(raw.issueContext),
     testRequirements: parseTestRequirements(raw.testRequirements),
     defaultExecutable: typeof raw.defaultExecutable === "string" && raw.defaultExecutable.length > 0 ? raw.defaultExecutable : "classify",
+    defaultPrExecutable: typeof raw.defaultPrExecutable === "string" && raw.defaultPrExecutable.length > 0 ? raw.defaultPrExecutable : "fix",
+    aliases: mergeAliases(raw.aliases),
     classify: parseClassifyConfig(raw.classify),
     release: parseReleaseConfig(raw.release)
   };
 }
+var BUILTIN_ALIASES = {
+  build: "run",
+  orchestrate: "bug",
+  orchestrator: "bug"
+};
+function mergeAliases(raw) {
+  const out = { ...BUILTIN_ALIASES };
+  if (raw && typeof raw === "object") {
+    for (const [k, v] of Object.entries(raw)) {
+      if (typeof v === "string" && v.length > 0) out[k.toLowerCase()] = v;
+    }
+  }
+  return out;
+}
 function parseClassifyConfig(raw) {
   if (!raw || typeof raw !== "object") return void 0;
   const r = raw;
@@ -557,22 +573,92 @@ import * as fs21 from "fs";
 import * as path18 from "path";
 
 // src/dispatch.ts
+import * as fs6 from "fs";
+
+// src/registry.ts
 import * as fs5 from "fs";
+import * as path5 from "path";
+function getExecutablesRoot() {
+  const here = path5.dirname(new URL(import.meta.url).pathname);
+  const candidates = [
+    path5.join(here, "executables"),
+    // dev: src/
+    path5.join(here, "..", "executables"),
+    // built: dist/bin → dist/executables
+    path5.join(here, "..", "src", "executables")
+    // fallback
+  ];
+  for (const c of candidates) {
+    if (fs5.existsSync(c) && fs5.statSync(c).isDirectory()) return c;
+  }
+  return candidates[0];
+}
+function listExecutables(root = getExecutablesRoot()) {
+  if (!fs5.existsSync(root)) return [];
+  const entries = fs5.readdirSync(root, { withFileTypes: true });
+  const out = [];
+  for (const ent of entries) {
+    if (!ent.isDirectory()) continue;
+    const profilePath = path5.join(root, ent.name, "profile.json");
+    if (fs5.existsSync(profilePath) && fs5.statSync(profilePath).isFile()) {
+      out.push({ name: ent.name, profilePath });
+    }
+  }
+  return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+function hasExecutable(name, root = getExecutablesRoot()) {
+  if (!isSafeName(name)) return false;
+  const profilePath = path5.join(root, name, "profile.json");
+  return fs5.existsSync(profilePath) && fs5.statSync(profilePath).isFile();
+}
+function isSafeName(name) {
+  return /^[a-z][a-z0-9-]*$/.test(name) && !name.includes("..");
+}
+function getProfileInputs(name, root = getExecutablesRoot()) {
+  if (!hasExecutable(name, root)) return null;
+  const profilePath = path5.join(root, name, "profile.json");
+  try {
+    const raw = JSON.parse(fs5.readFileSync(profilePath, "utf-8"));
+    if (!raw || typeof raw !== "object" || !Array.isArray(raw.inputs)) return [];
+    return raw.inputs;
+  } catch {
+    return null;
+  }
+}
+function parseGenericFlags(argv) {
+  const args = {};
+  const positional = [];
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (!arg.startsWith("--")) {
+      positional.push(arg);
+      continue;
+    }
+    const key = arg.slice(2);
+    const next = argv[i + 1];
+    const value = next !== void 0 && !next.startsWith("--") ? (i++, next) : true;
+    args[key] = value;
+    if (key.includes("-")) {
+      const camel = key.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
+      if (camel !== key && args[camel] === void 0) args[camel] = value;
+    }
+  }
+  if (positional.length > 0) args._ = positional;
+  return args;
+}
+
+// src/dispatch.ts
 function autoDispatch(opts) {
   const explicit = opts?.explicit;
   if (explicit?.issueNumber && explicit.issueNumber > 0) {
-    return {
-      executable: "run",
-      cliArgs: { issue: explicit.issueNumber },
-      target: explicit.issueNumber
-    };
+    return { executable: "run", cliArgs: { issue: explicit.issueNumber }, target: explicit.issueNumber };
   }
   const eventName = process.env.GITHUB_EVENT_NAME;
   const eventPath = process.env.GITHUB_EVENT_PATH;
-  if (!eventName || !eventPath || !fs5.existsSync(eventPath)) return null;
+  if (!eventName || !eventPath || !fs6.existsSync(eventPath)) return null;
   let event = {};
   try {
-    event = JSON.parse(fs5.readFileSync(eventPath, "utf-8"));
+    event = JSON.parse(fs6.readFileSync(eventPath, "utf-8"));
   } catch {
     return null;
   }
@@ -589,45 +675,34 @@ function autoDispatch(opts) {
   const isPr = !!event.issue?.pull_request;
   if (!targetNum) return null;
   const afterTag = extractAfterTag(body);
-  if (isPr) {
-    if (/\bfix-ci\b/.test(afterTag)) {
-      return { executable: "fix-ci", cliArgs: { pr: targetNum }, target: targetNum };
-    }
-    if (/\bresolve\b/.test(afterTag)) {
-      return { executable: "resolve", cliArgs: { pr: targetNum }, target: targetNum };
-    }
-    if (/\bui-review\b/.test(afterTag)) {
-      return { executable: "ui-review", cliArgs: { pr: targetNum }, target: targetNum };
-    }
-    if (/\breview\b/.test(afterTag)) {
-      return { executable: "review", cliArgs: { pr: targetNum }, target: targetNum };
-    }
-    if (/\bsync\b/.test(afterTag)) {
-      return { executable: "sync", cliArgs: { pr: targetNum }, target: targetNum };
-    }
-    const feedback = extractFeedback(afterTag);
-    return {
-      executable: "fix",
-      cliArgs: { pr: targetNum, ...feedback ? { feedback } : {} },
-      target: targetNum
-    };
-  }
-  const sub = extractSubcommand(afterTag);
-  if (!sub) {
-    const defaultExec = opts?.config?.defaultExecutable;
-    if (!defaultExec) return null;
-    return asDispatch(defaultExec, targetNum);
-  }
-  if (sub === "build") {
-    return { executable: "run", cliArgs: { issue: targetNum }, target: targetNum };
-  }
-  if (sub === "orchestrate" || sub === "orchestrator") {
-    return { executable: "bug", cliArgs: { issue: targetNum }, target: targetNum };
-  }
-  return asDispatch(sub, targetNum);
-}
-function asDispatch(executable, target) {
-  return { executable, cliArgs: { issue: target }, target };
+  const firstToken = extractSubcommand(afterTag);
+  const aliases = opts?.config?.aliases ?? BUILTIN_ALIASES;
+  const aliased = firstToken ? aliases[firstToken] ?? firstToken : null;
+  let executable = null;
+  let consumedFirstToken = false;
+  if (aliased && getProfileInputs(aliased) !== null) {
+    executable = aliased;
+    consumedFirstToken = true;
+  }
+  if (!executable) {
+    executable = isPr ? opts?.config?.defaultPrExecutable ?? "fix" : opts?.config?.defaultExecutable ?? null;
+  }
+  if (!executable) return null;
+  const inputs = getProfileInputs(executable);
+  const effectiveInputs = inputs ?? [];
+  const unknownProfile = inputs === null;
+  const rest = extractCommentRest(afterTag, consumedFirstToken ? firstToken : null);
+  const { args, leftover } = parseCommentArgs(rest, effectiveInputs);
+  if (isPr && (unknownProfile || effectiveInputs.some((s) => s.name === "pr"))) {
+    args.pr = targetNum;
+  } else if (!isPr && (unknownProfile || effectiveInputs.some((s) => s.name === "issue"))) {
+    args.issue = targetNum;
+  }
+  const restInput = effectiveInputs.find((s) => s.bindsCommentRest === true);
+  if (restInput && leftover.length > 0 && args[restInput.name] === void 0) {
+    args[restInput.name] = leftover;
+  }
+  return { executable, cliArgs: args, target: targetNum };
 }
 function extractAfterTag(body) {
   const idx = body.indexOf("@kody");
@@ -636,12 +711,79 @@ function extractAfterTag(body) {
 }
 function extractSubcommand(afterTag) {
   const match = afterTag.match(/^([a-z][a-z0-9-]{1,40})\b/);
-  if (!match) return null;
-  return match[1];
+  return match ? match[1] : null;
+}
+function extractCommentRest(afterTag, consumedToken) {
+  let rest = afterTag;
+  if (consumedToken) {
+    const re = new RegExp(`^${consumedToken.replace(/[-/\\^$*+?.()|[\]{}]/g, "\\$&")}\\b`, "i");
+    rest = rest.replace(re, "");
+  }
+  rest = rest.replace(/^(please|kindly)(?:[\s:,.-]+|$)/i, "");
+  return rest.replace(/^[\s:,.-]+/, "").trim();
+}
+function parseCommentArgs(rest, inputs) {
+  const tokens = rest.length === 0 ? [] : rest.split(/\s+/).filter((t) => t.length > 0);
+  const args = {};
+  const unmatched = [];
+  for (let i = 0; i < tokens.length; i++) {
+    const t = tokens[i];
+    if (t.startsWith("--")) {
+      const eq = t.indexOf("=");
+      const key = eq >= 0 ? t.slice(2, eq) : t.slice(2);
+      const inlineValue = eq >= 0 ? t.slice(eq + 1) : void 0;
+      const spec = findInputByFlag(inputs, key);
+      if (!spec) {
+        unmatched.push(t);
+        continue;
+      }
+      if (spec.type === "bool") {
+        args[spec.name] = true;
+        continue;
+      }
+      const value = inlineValue ?? tokens[i + 1];
+      if (value === void 0 || value.startsWith("--")) {
+        unmatched.push(t);
+        continue;
+      }
+      args[spec.name] = coerceBare(spec, value);
+      if (inlineValue === void 0) i++;
+      continue;
+    }
+    const enumHit = inputs.find((s) => s.type === "enum" && s.values?.includes(t) && args[s.name] === void 0);
+    if (enumHit) {
+      args[enumHit.name] = t;
+      continue;
+    }
+    if (/^-?\d+$/.test(t)) {
+      const intHit = inputs.find((s) => s.type === "int" && args[s.name] === void 0);
+      if (intHit) {
+        args[intHit.name] = parseInt(t, 10);
+        continue;
+      }
+    }
+    const boolHit = inputs.find((s) => s.type === "bool" && s.flag === `--${t}` && args[s.name] === void 0);
+    if (boolHit) {
+      args[boolHit.name] = true;
+      continue;
+    }
+    unmatched.push(t);
+  }
+  return { args, leftover: unmatched.join(" ") };
+}
+function findInputByFlag(inputs, key) {
+  return inputs.find((s) => s.name === key || s.flag === `--${key}`);
 }
-function extractFeedback(afterTag) {
-  const cleaned = afterTag.replace(/^(fix|please|kindly)(?:[\s:,.-]+|$)/i, "").trim();
-  return cleaned.length > 0 ? cleaned : void 0;
+function coerceBare(spec, value) {
+  if (spec.type === "int") {
+    const n = parseInt(value, 10);
+    return Number.isNaN(n) ? value : n;
+  }
+  if (spec.type === "bool") {
+    const v = value.toLowerCase();
+    return v === "true" || v === "1" || v === "yes";
+  }
+  return value;
 }
 
 // src/executor.ts
@@ -650,9 +792,9 @@ import * as path17 from "path";
 
 // src/litellm.ts
 import { execFileSync, spawn } from "child_process";
-import * as fs6 from "fs";
+import * as fs7 from "fs";
 import * as os from "os";
-import * as path5 from "path";
+import * as path6 from "path";
 async function checkLitellmHealth(url) {
   try {
     const response = await fetch(`${url}/health`, { signal: AbortSignal.timeout(3e3) });
@@ -692,20 +834,20 @@ async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL
       throw new Error("litellm not installed \u2014 run: pip install 'litellm[proxy]'");
     }
   }
-  const configPath = path5.join(os.tmpdir(), `kody-litellm-${Date.now()}.yaml`);
-  fs6.writeFileSync(configPath, generateLitellmConfigYaml(model));
+  const configPath = path6.join(os.tmpdir(), `kody-litellm-${Date.now()}.yaml`);
+  fs7.writeFileSync(configPath, generateLitellmConfigYaml(model));
   const portMatch = url.match(/:(\d+)/);
   const port = portMatch ? portMatch[1] : "4000";
   const args = cmd === "litellm" ? ["--config", configPath, "--port", port] : ["-m", "litellm", "--config", configPath, "--port", port];
   const dotenvVars = readDotenvApiKeys(projectDir);
-  const logPath = path5.join(os.tmpdir(), `kody-litellm-${Date.now()}.log`);
-  const outFd = fs6.openSync(logPath, "w");
+  const logPath = path6.join(os.tmpdir(), `kody-litellm-${Date.now()}.log`);
+  const outFd = fs7.openSync(logPath, "w");
   const child = spawn(cmd, args, {
     stdio: ["ignore", outFd, outFd],
     detached: true,
     env: stripBlockingEnv({ ...process.env, ...dotenvVars })
   });
-  fs6.closeSync(outFd);
+  fs7.closeSync(outFd);
   for (let i = 0; i < 30; i++) {
     await new Promise((r) => setTimeout(r, 2e3));
     if (await checkLitellmHealth(url)) {
@@ -722,7 +864,7 @@ async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL
   }
   let logTail = "";
   try {
-    logTail = fs6.readFileSync(logPath, "utf-8").slice(-2e3);
+    logTail = fs7.readFileSync(logPath, "utf-8").slice(-2e3);
   } catch {
   }
   try {
@@ -733,10 +875,10 @@ async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL
 ${logTail}`);
 }
 function readDotenvApiKeys(projectDir) {
-  const dotenvPath = path5.join(projectDir, ".env");
-  if (!fs6.existsSync(dotenvPath)) return {};
+  const dotenvPath = path6.join(projectDir, ".env");
+  if (!fs7.existsSync(dotenvPath)) return {};
   const result = {};
-  for (const rawLine of fs6.readFileSync(dotenvPath, "utf-8").split("\n")) {
+  for (const rawLine of fs7.readFileSync(dotenvPath, "utf-8").split("\n")) {
     const line = rawLine.trim();
     if (!line || line.startsWith("#")) continue;
     const match = line.match(/^([A-Z_][A-Z0-9_]*_API_KEY)=(.*)$/);
@@ -759,8 +901,8 @@ function stripBlockingEnv(env) {
 }
 
 // src/profile.ts
-import * as fs7 from "fs";
-import * as path6 from "path";
+import * as fs8 from "fs";
+import * as path7 from "path";
 var VALID_INPUT_TYPES = /* @__PURE__ */ new Set(["int", "string", "bool", "enum"]);
 var VALID_PERMISSION_MODES = /* @__PURE__ */ new Set(["default", "acceptEdits", "plan", "bypassPermissions"]);
 var VALID_ROLES = /* @__PURE__ */ new Set(["primitive", "orchestrator", "watch", "utility"]);
@@ -775,12 +917,12 @@ var ProfileError = class extends Error {
   profilePath;
 };
 function loadProfile(profilePath) {
-  if (!fs7.existsSync(profilePath)) {
+  if (!fs8.existsSync(profilePath)) {
     throw new ProfileError(profilePath, "file not found");
   }
   let raw;
   try {
-    raw = JSON.parse(fs7.readFileSync(profilePath, "utf-8"));
+    raw = JSON.parse(fs8.readFileSync(profilePath, "utf-8"));
   } catch (err) {
     throw new ProfileError(profilePath, `invalid JSON: ${err instanceof Error ? err.message : String(err)}`);
   }
@@ -820,7 +962,7 @@ function loadProfile(profilePath) {
     outputContract: r.outputContract,
     inputArtifacts: parseInputArtifacts(profilePath, r.input),
     outputArtifacts: parseOutputArtifacts(profilePath, r.output),
-    dir: path6.dirname(profilePath)
+    dir: path7.dirname(profilePath)
   };
   return profile;
 }
@@ -868,6 +1010,7 @@ function parseInputs(p, raw) {
     if (r.requiredWhen && typeof r.requiredWhen === "object") {
       spec.requiredWhen = r.requiredWhen;
     }
+    if (r.bindsCommentRest === true) spec.bindsCommentRest = true;
     out.push(spec);
   }
   return out;
@@ -1249,21 +1392,21 @@ var advanceFlow = async (ctx, profile) => {
 };
 
 // src/scripts/buildSyntheticPlugin.ts
-import * as fs8 from "fs";
+import * as fs9 from "fs";
 import * as os2 from "os";
-import * as path7 from "path";
+import * as path8 from "path";
 function getPluginsCatalogRoot() {
-  const here = path7.dirname(new URL(import.meta.url).pathname);
+  const here = path8.dirname(new URL(import.meta.url).pathname);
   const candidates = [
-    path7.join(here, "..", "plugins"),
+    path8.join(here, "..", "plugins"),
     // dev: src/scripts → src/plugins
-    path7.join(here, "..", "..", "plugins"),
+    path8.join(here, "..", "..", "plugins"),
     // built: dist/scripts → dist/plugins
-    path7.join(here, "..", "..", "src", "plugins")
+    path8.join(here, "..", "..", "src", "plugins")
     // fallback
   ];
   for (const c of candidates) {
-    if (fs8.existsSync(c) && fs8.statSync(c).isDirectory()) return c;
+    if (fs9.existsSync(c) && fs9.statSync(c).isDirectory()) return c;
   }
   return candidates[0];
 }
@@ -1273,50 +1416,50 @@ var buildSyntheticPlugin = async (ctx, profile) => {
   if (!needsSynthetic) return;
   const catalog = getPluginsCatalogRoot();
   const runId = `${profile.name}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-  const root = path7.join(os2.tmpdir(), `kody-synth-${runId}`);
-  fs8.mkdirSync(path7.join(root, ".claude-plugin"), { recursive: true });
+  const root = path8.join(os2.tmpdir(), `kody-synth-${runId}`);
+  fs9.mkdirSync(path8.join(root, ".claude-plugin"), { recursive: true });
   if (cc.skills.length > 0) {
-    const dst = path7.join(root, "skills");
-    fs8.mkdirSync(dst, { recursive: true });
+    const dst = path8.join(root, "skills");
+    fs9.mkdirSync(dst, { recursive: true });
     for (const name of cc.skills) {
-      const src = path7.join(catalog, "skills", name);
-      if (!fs8.existsSync(src)) throw new Error(`buildSyntheticPlugin: skill not found in catalog: ${name}`);
-      copyDir(src, path7.join(dst, name));
+      const src = path8.join(catalog, "skills", name);
+      if (!fs9.existsSync(src)) throw new Error(`buildSyntheticPlugin: skill not found in catalog: ${name}`);
+      copyDir(src, path8.join(dst, name));
     }
   }
   if (cc.commands.length > 0) {
-    const dst = path7.join(root, "commands");
-    fs8.mkdirSync(dst, { recursive: true });
+    const dst = path8.join(root, "commands");
+    fs9.mkdirSync(dst, { recursive: true });
     for (const name of cc.commands) {
-      const src = path7.join(catalog, "commands", `${name}.md`);
-      if (!fs8.existsSync(src)) throw new Error(`buildSyntheticPlugin: command not found in catalog: ${name}`);
-      fs8.copyFileSync(src, path7.join(dst, `${name}.md`));
+      const src = path8.join(catalog, "commands", `${name}.md`);
+      if (!fs9.existsSync(src)) throw new Error(`buildSyntheticPlugin: command not found in catalog: ${name}`);
+      fs9.copyFileSync(src, path8.join(dst, `${name}.md`));
     }
   }
   if (cc.subagents.length > 0) {
-    const dst = path7.join(root, "agents");
-    fs8.mkdirSync(dst, { recursive: true });
+    const dst = path8.join(root, "agents");
+    fs9.mkdirSync(dst, { recursive: true });
     for (const name of cc.subagents) {
-      const src = path7.join(catalog, "agents", `${name}.md`);
-      if (!fs8.existsSync(src)) throw new Error(`buildSyntheticPlugin: subagent not found in catalog: ${name}`);
-      fs8.copyFileSync(src, path7.join(dst, `${name}.md`));
+      const src = path8.join(catalog, "agents", `${name}.md`);
+      if (!fs9.existsSync(src)) throw new Error(`buildSyntheticPlugin: subagent not found in catalog: ${name}`);
+      fs9.copyFileSync(src, path8.join(dst, `${name}.md`));
     }
   }
   if (cc.hooks.length > 0) {
-    const dst = path7.join(root, "hooks");
-    fs8.mkdirSync(dst, { recursive: true });
+    const dst = path8.join(root, "hooks");
+    fs9.mkdirSync(dst, { recursive: true });
     const merged = { hooks: {} };
     for (const name of cc.hooks) {
-      const src = path7.join(catalog, "hooks", `${name}.json`);
-      if (!fs8.existsSync(src)) throw new Error(`buildSyntheticPlugin: hook not found in catalog: ${name}`);
-      const parsed = JSON.parse(fs8.readFileSync(src, "utf-8"));
+      const src = path8.join(catalog, "hooks", `${name}.json`);
+      if (!fs9.existsSync(src)) throw new Error(`buildSyntheticPlugin: hook not found in catalog: ${name}`);
+      const parsed = JSON.parse(fs9.readFileSync(src, "utf-8"));
       for (const [event, entries] of Object.entries(parsed.hooks ?? {})) {
         if (!Array.isArray(entries)) continue;
         if (!merged.hooks[event]) merged.hooks[event] = [];
         merged.hooks[event].push(...entries);
       }
     }
-    fs8.writeFileSync(path7.join(dst, "hooks.json"), `${JSON.stringify(merged, null, 2)}
+    fs9.writeFileSync(path8.join(dst, "hooks.json"), `${JSON.stringify(merged, null, 2)}
 `);
   }
   const manifest = {
@@ -1327,17 +1470,17 @@ var buildSyntheticPlugin = async (ctx, profile) => {
   if (cc.skills.length > 0) manifest.skills = ["./skills/"];
   if (cc.commands.length > 0) manifest.commands = ["./commands/"];
   if (cc.subagents.length > 0) manifest.agents = cc.subagents.map((n) => `./agents/${n}.md`);
-  fs8.writeFileSync(path7.join(root, ".claude-plugin", "plugin.json"), `${JSON.stringify(manifest, null, 2)}
+  fs9.writeFileSync(path8.join(root, ".claude-plugin", "plugin.json"), `${JSON.stringify(manifest, null, 2)}
 `);
   ctx.data.syntheticPluginPath = root;
 };
 function copyDir(src, dst) {
-  fs8.mkdirSync(dst, { recursive: true });
-  for (const ent of fs8.readdirSync(src, { withFileTypes: true })) {
-    const s = path7.join(src, ent.name);
-    const d = path7.join(dst, ent.name);
+  fs9.mkdirSync(dst, { recursive: true });
+  for (const ent of fs9.readdirSync(src, { withFileTypes: true })) {
+    const s = path8.join(src, ent.name);
+    const d = path8.join(dst, ent.name);
     if (ent.isDirectory()) copyDir(s, d);
-    else if (ent.isFile()) fs8.copyFileSync(s, d);
+    else if (ent.isFile()) fs9.copyFileSync(s, d);
   }
 }
 
@@ -1403,18 +1546,18 @@ function formatMissesForFeedback(misses) {
 }
 
 // src/prompt.ts
-import * as fs9 from "fs";
-import * as path8 from "path";
+import * as fs10 from "fs";
+import * as path9 from "path";
 var CONVENTIONS_PER_FILE_MAX_BYTES = 3e4;
 var CONVENTION_FILES = ["CLAUDE.md", "AGENTS.md"];
 function loadProjectConventions(projectDir) {
   const out = [];
   for (const rel of CONVENTION_FILES) {
-    const abs = path8.join(projectDir, rel);
-    if (!fs9.existsSync(abs)) continue;
+    const abs = path9.join(projectDir, rel);
+    if (!fs10.existsSync(abs)) continue;
     let content;
     try {
-      content = fs9.readFileSync(abs, "utf-8");
+      content = fs10.readFileSync(abs, "utf-8");
     } catch {
       continue;
     }
@@ -1578,8 +1721,8 @@ import { execFileSync as execFileSync6 } from "child_process";
 
 // src/commit.ts
 import { execFileSync as execFileSync5 } from "child_process";
-import * as fs10 from "fs";
-import * as path9 from "path";
+import * as fs11 from "fs";
+import * as path10 from "path";
 var FORBIDDEN_PATH_PREFIXES = [
   ".kody/",
   ".kody-engine/",
@@ -1634,18 +1777,18 @@ function tryGit(args, cwd) {
 }
 function abortUnfinishedGitOps(cwd) {
   const aborted = [];
-  const gitDir = path9.join(cwd ?? process.cwd(), ".git");
-  if (!fs10.existsSync(gitDir)) return aborted;
-  if (fs10.existsSync(path9.join(gitDir, "MERGE_HEAD"))) {
+  const gitDir = path10.join(cwd ?? process.cwd(), ".git");
+  if (!fs11.existsSync(gitDir)) return aborted;
+  if (fs11.existsSync(path10.join(gitDir, "MERGE_HEAD"))) {
     if (tryGit(["merge", "--abort"], cwd)) aborted.push("merge");
   }
-  if (fs10.existsSync(path9.join(gitDir, "CHERRY_PICK_HEAD"))) {
+  if (fs11.existsSync(path10.join(gitDir, "CHERRY_PICK_HEAD"))) {
     if (tryGit(["cherry-pick", "--abort"], cwd)) aborted.push("cherry-pick");
   }
-  if (fs10.existsSync(path9.join(gitDir, "REVERT_HEAD"))) {
+  if (fs11.existsSync(path10.join(gitDir, "REVERT_HEAD"))) {
     if (tryGit(["revert", "--abort"], cwd)) aborted.push("revert");
   }
-  if (fs10.existsSync(path9.join(gitDir, "rebase-merge")) || fs10.existsSync(path9.join(gitDir, "rebase-apply"))) {
+  if (fs11.existsSync(path10.join(gitDir, "rebase-merge")) || fs11.existsSync(path10.join(gitDir, "rebase-apply"))) {
     if (tryGit(["rebase", "--abort"], cwd)) aborted.push("rebase");
   }
   try {
@@ -1700,7 +1843,7 @@ function normalizeCommitMessage(raw) {
 function commitAndPush(branch, agentMessage, cwd) {
   const allChanged = listChangedFiles(cwd);
   const allowedFiles = allChanged.filter((f) => !isForbiddenPath(f));
-  const mergeHeadExists = fs10.existsSync(path9.join(cwd ?? process.cwd(), ".git", "MERGE_HEAD"));
+  const mergeHeadExists = fs11.existsSync(path10.join(cwd ?? process.cwd(), ".git", "MERGE_HEAD"));
   if (allowedFiles.length === 0 && !mergeHeadExists) {
     return { committed: false, pushed: false, sha: "", message: "" };
   }
@@ -1796,20 +1939,20 @@ function defaultCommitMessage(mode, data) {
 }
 
 // src/scripts/composePrompt.ts
-import * as fs11 from "fs";
-import * as path10 from "path";
+import * as fs12 from "fs";
+import * as path11 from "path";
 var MUSTACHE = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
 var composePrompt = async (ctx, profile) => {
   const explicit = ctx.data.promptTemplate;
   const mode = ctx.args.mode;
   const candidates = [
-    explicit ? path10.join(profile.dir, explicit) : null,
-    mode ? path10.join(profile.dir, "prompts", `${mode}.md`) : null,
-    path10.join(profile.dir, "prompt.md")
+    explicit ? path11.join(profile.dir, explicit) : null,
+    mode ? path11.join(profile.dir, "prompts", `${mode}.md`) : null,
+    path11.join(profile.dir, "prompt.md")
   ].filter(Boolean);
   let templatePath = "";
   for (const c of candidates) {
-    if (fs11.existsSync(c)) {
+    if (fs12.existsSync(c)) {
       templatePath = c;
       break;
     }
@@ -1817,7 +1960,7 @@ var composePrompt = async (ctx, profile) => {
   if (!templatePath) {
     throw new Error(`profile at ${profile.dir}: no prompt template found (tried ${candidates.join(", ")})`);
   }
-  const template = fs11.readFileSync(templatePath, "utf-8");
+  const template = fs12.readFileSync(templatePath, "utf-8");
   const tokens = {
     ...stringifyAll(ctx.args, "args."),
     ...stringifyAll(ctx.data, ""),
@@ -1894,17 +2037,17 @@ function formatToolsUsage(profile) {
 }
 
 // src/scripts/discoverQaContext.ts
-import * as fs13 from "fs";
-import * as path12 from "path";
+import * as fs14 from "fs";
+import * as path13 from "path";
 
 // src/scripts/frameworkDetectors.ts
-import * as fs12 from "fs";
-import * as path11 from "path";
+import * as fs13 from "fs";
+import * as path12 from "path";
 function detectFrameworks(cwd) {
   const out = [];
   let deps = {};
   try {
-    const pkg = JSON.parse(fs12.readFileSync(path11.join(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs13.readFileSync(path12.join(cwd, "package.json"), "utf-8"));
     deps = { ...pkg.dependencies, ...pkg.devDependencies };
   } catch {
     return out;
@@ -1941,7 +2084,7 @@ function detectFrameworks(cwd) {
 }
 function findFile(cwd, candidates) {
   for (const c of candidates) {
-    if (fs12.existsSync(path11.join(cwd, c))) return c;
+    if (fs13.existsSync(path12.join(cwd, c))) return c;
   }
   return null;
 }
@@ -1954,18 +2097,18 @@ var COLLECTION_DIRS = [
 function discoverPayloadCollections(cwd) {
   const out = [];
   for (const dir of COLLECTION_DIRS) {
-    const full = path11.join(cwd, dir);
-    if (!fs12.existsSync(full)) continue;
+    const full = path12.join(cwd, dir);
+    if (!fs13.existsSync(full)) continue;
     let files;
     try {
-      files = fs12.readdirSync(full).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
+      files = fs13.readdirSync(full).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
     } catch {
       continue;
     }
     for (const file of files) {
       try {
-        const filePath = path11.join(full, file);
-        const content = fs12.readFileSync(filePath, "utf-8").slice(0, 1e4);
+        const filePath = path12.join(full, file);
+        const content = fs13.readFileSync(filePath, "utf-8").slice(0, 1e4);
         const slugMatch = content.match(/slug:\s*['"]([a-z0-9-]+)['"]/);
         if (!slugMatch) continue;
         const slug = slugMatch[1];
@@ -1979,7 +2122,7 @@ function discoverPayloadCollections(cwd) {
         out.push({
           name,
           slug,
-          filePath: path11.relative(cwd, filePath),
+          filePath: path12.relative(cwd, filePath),
           fields: fields.slice(0, 20),
           hasAdmin
         });
@@ -1993,28 +2136,28 @@ var ADMIN_COMPONENT_DIRS = ["src/ui/admin", "src/admin/components", "src/compone
 function discoverAdminComponents(cwd, collections) {
   const out = [];
   for (const dir of ADMIN_COMPONENT_DIRS) {
-    const full = path11.join(cwd, dir);
-    if (!fs12.existsSync(full)) continue;
+    const full = path12.join(cwd, dir);
+    if (!fs13.existsSync(full)) continue;
     let entries;
     try {
-      entries = fs12.readdirSync(full, { withFileTypes: true });
+      entries = fs13.readdirSync(full, { withFileTypes: true });
     } catch {
       continue;
     }
     for (const entry of entries) {
-      const entryPath = path11.join(full, entry.name);
+      const entryPath = path12.join(full, entry.name);
       let name;
       let filePath;
       if (entry.isDirectory()) {
         const indexFile = ["index.tsx", "index.ts", "index.jsx", "index.js"].find(
-          (f) => fs12.existsSync(path11.join(entryPath, f))
+          (f) => fs13.existsSync(path12.join(entryPath, f))
         );
         if (!indexFile) continue;
         name = entry.name;
-        filePath = path11.relative(cwd, path11.join(entryPath, indexFile));
+        filePath = path12.relative(cwd, path12.join(entryPath, indexFile));
       } else if (/\.(tsx?|jsx?)$/.test(entry.name)) {
         name = entry.name.replace(/\.(tsx?|jsx?)$/, "");
-        filePath = path11.relative(cwd, entryPath);
+        filePath = path12.relative(cwd, entryPath);
       } else {
         continue;
       }
@@ -2022,7 +2165,7 @@ function discoverAdminComponents(cwd, collections) {
       if (collections) {
         for (const col of collections) {
           try {
-            const colContent = fs12.readFileSync(path11.join(cwd, col.filePath), "utf-8");
+            const colContent = fs13.readFileSync(path12.join(cwd, col.filePath), "utf-8");
             if (colContent.includes(name)) {
               usedInCollection = col.slug;
               break;
@@ -2041,8 +2184,8 @@ function scanApiRoutes(cwd) {
   const out = [];
   const appDirs = ["src/app", "app"];
   for (const appDir of appDirs) {
-    const apiDir = path11.join(cwd, appDir, "api");
-    if (!fs12.existsSync(apiDir)) continue;
+    const apiDir = path12.join(cwd, appDir, "api");
+    if (!fs13.existsSync(apiDir)) continue;
     walkApiRoutes(apiDir, "/api", cwd, out);
     break;
   }
@@ -2051,20 +2194,20 @@ function scanApiRoutes(cwd) {
 function walkApiRoutes(dir, prefix, cwd, out) {
   let entries;
   try {
-    entries = fs12.readdirSync(dir, { withFileTypes: true });
+    entries = fs13.readdirSync(dir, { withFileTypes: true });
   } catch {
     return;
   }
   const routeFile = entries.find((e) => e.isFile() && /^route\.(ts|js|tsx|jsx)$/.test(e.name));
   if (routeFile) {
     try {
-      const content = fs12.readFileSync(path11.join(dir, routeFile.name), "utf-8").slice(0, 5e3);
+      const content = fs13.readFileSync(path12.join(dir, routeFile.name), "utf-8").slice(0, 5e3);
       const methods = HTTP_METHODS.filter((m) => new RegExp(`export\\s+(?:async\\s+)?function\\s+${m}\\b`).test(content));
       if (methods.length > 0) {
         out.push({
           path: prefix,
           methods,
-          filePath: path11.relative(cwd, path11.join(dir, routeFile.name))
+          filePath: path12.relative(cwd, path12.join(dir, routeFile.name))
         });
       }
     } catch {
@@ -2075,7 +2218,7 @@ function walkApiRoutes(dir, prefix, cwd, out) {
     if (entry.name === "node_modules" || entry.name === ".next") continue;
     let segment = entry.name;
     if (segment.startsWith("(") && segment.endsWith(")")) {
-      walkApiRoutes(path11.join(dir, entry.name), prefix, cwd, out);
+      walkApiRoutes(path12.join(dir, entry.name), prefix, cwd, out);
       continue;
     }
     if (segment.startsWith("[[") && segment.endsWith("]]")) {
@@ -2083,7 +2226,7 @@ function walkApiRoutes(dir, prefix, cwd, out) {
     } else if (segment.startsWith("[") && segment.endsWith("]")) {
       segment = `:${segment.slice(1, -1)}`;
     }
-    walkApiRoutes(path11.join(dir, entry.name), `${prefix}/${segment}`, cwd, out);
+    walkApiRoutes(path12.join(dir, entry.name), `${prefix}/${segment}`, cwd, out);
   }
 }
 var BUILTIN_ENV_VARS = /* @__PURE__ */ new Set([
@@ -2103,10 +2246,10 @@ var BUILTIN_ENV_VARS = /* @__PURE__ */ new Set([
 function scanEnvVars(cwd) {
   const candidates = [".env.example", ".env.local.example", ".env.template"];
   for (const envFile of candidates) {
-    const envPath = path11.join(cwd, envFile);
-    if (!fs12.existsSync(envPath)) continue;
+    const envPath = path12.join(cwd, envFile);
+    if (!fs13.existsSync(envPath)) continue;
     try {
-      const content = fs12.readFileSync(envPath, "utf-8");
+      const content = fs13.readFileSync(envPath, "utf-8");
       const vars = [];
       for (const line of content.split("\n")) {
         const trimmed = line.trim();
@@ -2154,9 +2297,9 @@ function runQaDiscovery(cwd) {
 }
 function detectDevServer(cwd, out) {
   try {
-    const pkg = JSON.parse(fs13.readFileSync(path12.join(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs14.readFileSync(path13.join(cwd, "package.json"), "utf-8"));
     const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
-    const pm = fs13.existsSync(path12.join(cwd, "pnpm-lock.yaml")) ? "pnpm" : fs13.existsSync(path12.join(cwd, "yarn.lock")) ? "yarn" : fs13.existsSync(path12.join(cwd, "bun.lockb")) ? "bun" : "npm";
+    const pm = fs14.existsSync(path13.join(cwd, "pnpm-lock.yaml")) ? "pnpm" : fs14.existsSync(path13.join(cwd, "yarn.lock")) ? "yarn" : fs14.existsSync(path13.join(cwd, "bun.lockb")) ? "bun" : "npm";
     if (pkg.scripts?.dev) out.devCommand = `${pm} dev`;
     if (allDeps.next || allDeps.nuxt) out.devPort = 3e3;
     else if (allDeps.vite) out.devPort = 5173;
@@ -2166,8 +2309,8 @@ function detectDevServer(cwd, out) {
 function scanFrontendRoutes(cwd, out) {
   const appDirs = ["src/app", "app"];
   for (const appDir of appDirs) {
-    const full = path12.join(cwd, appDir);
-    if (!fs13.existsSync(full)) continue;
+    const full = path13.join(cwd, appDir);
+    if (!fs14.existsSync(full)) continue;
     walkFrontendRoutes(full, "", out);
     break;
   }
@@ -2175,7 +2318,7 @@ function scanFrontendRoutes(cwd, out) {
 function walkFrontendRoutes(dir, prefix, out) {
   let entries;
   try {
-    entries = fs13.readdirSync(dir, { withFileTypes: true });
+    entries = fs14.readdirSync(dir, { withFileTypes: true });
   } catch {
     return;
   }
@@ -2192,7 +2335,7 @@ function walkFrontendRoutes(dir, prefix, out) {
     if (entry.name === "node_modules" || entry.name === ".next") continue;
     let segment = entry.name;
     if (segment.startsWith("(") && segment.endsWith(")")) {
-      walkFrontendRoutes(path12.join(dir, entry.name), prefix, out);
+      walkFrontendRoutes(path13.join(dir, entry.name), prefix, out);
       continue;
     }
     if (segment.startsWith("[[") && segment.endsWith("]]")) {
@@ -2200,7 +2343,7 @@ function walkFrontendRoutes(dir, prefix, out) {
     } else if (segment.startsWith("[") && segment.endsWith("]")) {
       segment = `:${segment.slice(1, -1)}`;
     }
-    walkFrontendRoutes(path12.join(dir, entry.name), `${prefix}/${segment}`, out);
+    walkFrontendRoutes(path13.join(dir, entry.name), `${prefix}/${segment}`, out);
   }
 }
 function detectAuthFiles(cwd, out) {
@@ -2217,23 +2360,23 @@ function detectAuthFiles(cwd, out) {
     "src/app/api/oauth"
   ];
   for (const c of candidates) {
-    if (fs13.existsSync(path12.join(cwd, c))) out.authFiles.push(c);
+    if (fs14.existsSync(path13.join(cwd, c))) out.authFiles.push(c);
   }
 }
 function detectRoles(cwd, out) {
   const rolePaths = ["src/types", "src/lib", "src/utils", "src/constants", "src/access", "src/collections"];
   for (const rp of rolePaths) {
-    const dir = path12.join(cwd, rp);
-    if (!fs13.existsSync(dir)) continue;
+    const dir = path13.join(cwd, rp);
+    if (!fs14.existsSync(dir)) continue;
     let files;
     try {
-      files = fs13.readdirSync(dir).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
+      files = fs14.readdirSync(dir).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
     } catch {
       continue;
     }
     for (const f of files) {
       try {
-        const content = fs13.readFileSync(path12.join(dir, f), "utf-8").slice(0, 5e3);
+        const content = fs14.readFileSync(path13.join(dir, f), "utf-8").slice(0, 5e3);
         const roleMatches = content.match(/(?:role|Role|ROLE)\s*[=:]\s*['"](\w+)['"]/g);
         if (roleMatches) {
           for (const m of roleMatches) {
@@ -2720,67 +2863,6 @@ function computeFailureReason(ctx) {
 // src/scripts/finishFlow.ts
 import { execFileSync as execFileSync9 } from "child_process";
 
-// src/registry.ts
-import * as fs14 from "fs";
-import * as path13 from "path";
-function getExecutablesRoot() {
-  const here = path13.dirname(new URL(import.meta.url).pathname);
-  const candidates = [
-    path13.join(here, "executables"),
-    // dev: src/
-    path13.join(here, "..", "executables"),
-    // built: dist/bin → dist/executables
-    path13.join(here, "..", "src", "executables")
-    // fallback
-  ];
-  for (const c of candidates) {
-    if (fs14.existsSync(c) && fs14.statSync(c).isDirectory()) return c;
-  }
-  return candidates[0];
-}
-function listExecutables(root = getExecutablesRoot()) {
-  if (!fs14.existsSync(root)) return [];
-  const entries = fs14.readdirSync(root, { withFileTypes: true });
-  const out = [];
-  for (const ent of entries) {
-    if (!ent.isDirectory()) continue;
-    const profilePath = path13.join(root, ent.name, "profile.json");
-    if (fs14.existsSync(profilePath) && fs14.statSync(profilePath).isFile()) {
-      out.push({ name: ent.name, profilePath });
-    }
-  }
-  return out.sort((a, b) => a.name.localeCompare(b.name));
-}
-function hasExecutable(name, root = getExecutablesRoot()) {
-  if (!isSafeName(name)) return false;
-  const profilePath = path13.join(root, name, "profile.json");
-  return fs14.existsSync(profilePath) && fs14.statSync(profilePath).isFile();
-}
-function isSafeName(name) {
-  return /^[a-z][a-z0-9-]*$/.test(name) && !name.includes("..");
-}
-function parseGenericFlags(argv) {
-  const args = {};
-  const positional = [];
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    if (!arg.startsWith("--")) {
-      positional.push(arg);
-      continue;
-    }
-    const key = arg.slice(2);
-    const next = argv[i + 1];
-    const value = next !== void 0 && !next.startsWith("--") ? (i++, next) : true;
-    args[key] = value;
-    if (key.includes("-")) {
-      const camel = key.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
-      if (camel !== key && args[camel] === void 0) args[camel] = value;
-    }
-  }
-  if (positional.length > 0) args._ = positional;
-  return args;
-}
-
 // src/lifecycleLabels.ts
 var KODY_NAMESPACE = "kody";
 function groupOf(label) {

package/dist/executables/fix/profile.json

@@ -15,6 +15,7 @@
       "flag": "--feedback",
       "type": "string",
       "required": false,
+      "bindsCommentRest": true,
       "describe": "Inline override. If absent, the flow reads the latest PR review comment."
     }
   ],
@@ -49,10 +50,10 @@
       "name": "playwright",
       "install": {
         "required": false,
-        "checkCommand": "npx --no-install playwright --version",
+        "checkCommand": "ls \"$HOME/.cache/ms-playwright\" 2>/dev/null | grep -q '^chromium'",
         "installCommand": "npx --yes playwright install --with-deps chromium"
       },
-      "verify": "npx --no-install playwright --version",
+      "verify": "ls \"$HOME/.cache/ms-playwright\" 2>/dev/null | grep -q '^chromium'",
       "usage": ""
     }
   ],

package/dist/executables/types.ts

@@ -97,6 +97,13 @@ export interface InputSpec {
    * e.g. `{ mode: "run" }` or `{ mode: ["fix", "fix-ci", "resolve"] }`.
    */
   requiredWhen?: Record<string, string | string[]>
+  /**
+   * When true, this input collects any free-text left over from comment
+   * dispatch after flag/enum/bool parsing. Only one input per profile may
+   * set this. Used by e.g. `fix.feedback` so `@kody please change X` lands
+   * "please change X" in `feedback` without hardcoding that in the router.
+   */
+  bindsCommentRest?: boolean
   describe: string
 }
 

package/package.json

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