@kody-ade/kody-engine 0.2.11 → 0.2.12

package/README.md

@@ -13,12 +13,12 @@
 │ kody2 CLI (@kody-ade/kody-engine)           │
 │   bin/kody2.ts — parses argv                │
 │   src/executor.ts — runs one profile        │
-│   src/executables/build/profile.json        │
+│   src/executables/<name>/profile.json       │
 │   src/scripts/*.ts — named hook catalog     │
 └─────────────────────────────────────────────┘
 ```
 
-`run`/`fix`/`fix-ci`/`resolve` are four modes of the same `build` executable, selected by `args.mode` via `runWhen` on preflight script entries. Executor knows nothing about any specific mode.
+Every top-level command is its own auto-discovered executable (`run`, `fix`, `fix-ci`, `resolve`, `review`, `plan`, `orchestrator`, `release`, `watch-*`, `init`). The router has no hardcoded command switch beyond `ci`/`help`/`version` — drop a new `src/executables/<name>/` directory with a `profile.json` + `prompt.md` and `kody2 <name>` starts working. The executor knows nothing about any specific command.
 
 ## Install in a consumer repo
 
@@ -31,13 +31,14 @@
 ## Commands
 
 ```
-kody2 run     --issue <N>                  # implement an issue
+kody2 run     --issue <N>                   # implement an issue
 kody2 fix     --pr    <N> [--feedback ...]  # apply PR review feedback
 kody2 fix-ci  --pr    <N> [--run-id <ID>]   # fix failing CI
 kody2 resolve --pr    <N>                   # merge default branch in, resolve conflicts
+kody2 review  --pr    <N>                   # read-only structured PR review
 kody2 ci      --issue <N>                   # CI preflight + run
 ```
 
 ## Profiles
 
-A profile is declarative JSON + an adjacent prompt. See `src/executables/build/profile.json`. Adding a new role = new profile + new prompt + registering any new scripts under `src/scripts/`. No executor changes.
+A profile is declarative JSON + an adjacent `prompt.md`. See any directory under `src/executables/` for examples. Adding a new command = new directory + profile + prompt + registering any new scripts under `src/scripts/`. No executor, entry, or dispatch changes.

package/dist/bin/kody2.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.2.11",
+  version: "0.2.12",
   description: "kody2 \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -17,7 +17,7 @@ var package_default = {
   ],
   scripts: {
     kody2: "tsx bin/kody2.ts",
-    build: `tsup && node -e "require('fs').cpSync('src/executables', 'dist/executables', { recursive: true })"`,
+    build: `tsup && node -e "const fs=require('fs');fs.rmSync('dist/executables',{recursive:true,force:true});fs.cpSync('src/executables','dist/executables',{recursive:true})"`,
     test: "vitest run tests/unit tests/int --no-coverage",
     "test:e2e": "vitest run tests/e2e --no-coverage",
     "test:all": "vitest run tests --no-coverage",
@@ -49,6 +49,15 @@ var package_default = {
   bugs: "https://github.com/aharonyaircohen/kody-engine/issues"
 };
 
+// src/executor.ts
+import * as fs13 from "fs";
+import * as path11 from "path";
+
+// src/agent.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
+import { query } from "@anthropic-ai/claude-agent-sdk";
+
 // src/config.ts
 import * as fs from "fs";
 import * as path from "path";
@@ -151,15 +160,6 @@ function getAnthropicApiKeyOrDummy() {
   return process.env.ANTHROPIC_API_KEY || `sk-ant-api03-${"0".repeat(64)}`;
 }
 
-// src/executor.ts
-import * as fs13 from "fs";
-import * as path11 from "path";
-
-// src/agent.ts
-import * as fs2 from "fs";
-import * as path2 from "path";
-import { query } from "@anthropic-ai/claude-agent-sdk";
-
 // src/format.ts
 function renderEvent(msg, opts = {}) {
   if (opts.quiet) {
@@ -919,13 +919,14 @@ function hasCommitsAhead(branch, defaultBranch, cwd) {
 }
 
 // src/scripts/commitAndPush.ts
-var commitAndPush2 = async (ctx) => {
+var commitAndPush2 = async (ctx, profile) => {
   const branch = ctx.data.branch;
   if (!branch) {
     ctx.data.commitResult = { committed: false, pushed: false };
     return;
   }
-  if (ctx.args.mode === "resolve") {
+  const kind = profile.name;
+  if (kind === "resolve") {
     try {
       execFileSync4("git", ["add", "-A"], { cwd: ctx.cwd, env: { ...process.env, HUSKY: "0" }, stdio: "pipe" });
     } catch {
@@ -937,7 +938,7 @@ var commitAndPush2 = async (ctx) => {
 `);
     }
   }
-  const fallbackMsg = defaultCommitMessage(ctx.args.mode, ctx.data);
+  const fallbackMsg = defaultCommitMessage(kind, ctx.data);
   const message = ctx.data.commitMessage || fallbackMsg;
   try {
     const result = commitAndPush(branch, message, ctx.cwd);
@@ -1724,11 +1725,11 @@ function parseGenericFlags(argv) {
     }
     const key = arg.slice(2);
     const next = argv[i + 1];
-    if (next !== void 0 && !next.startsWith("--")) {
-      args[key] = next;
-      i++;
-    } else {
-      args[key] = true;
+    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;
@@ -2949,10 +2950,10 @@ var watchStalePrsFlow = async (ctx) => {
 
 // src/scripts/writeRunSummary.ts
 import * as fs12 from "fs";
-var writeRunSummary = async (ctx) => {
+var writeRunSummary = async (ctx, profile) => {
   const summaryPath = process.env.GITHUB_STEP_SUMMARY;
   if (!summaryPath) return;
-  const mode = ctx.args.mode;
+  const executable = profile.name;
   const issue = ctx.args.issue;
   const pr = ctx.args.pr;
   const target = issue ? `issue #${issue}` : pr ? `PR #${pr}` : "(unknown)";
@@ -2961,9 +2962,9 @@ var writeRunSummary = async (ctx) => {
   const reason = ctx.output.reason;
   const status = exitCode === 0 ? "\u2705 success" : exitCode === 3 ? "\u23ED\uFE0F no-op" : "\u26A0\uFE0F failed";
   const lines = [];
-  lines.push(`## kody2 run \u2014 ${status}`);
+  lines.push(`## kody2 ${executable} \u2014 ${status}`);
   lines.push("");
-  lines.push(`- **Mode:** \`${mode ?? "?"}\``);
+  lines.push(`- **Executable:** \`${executable}\``);
   lines.push(`- **Target:** ${target}`);
   if (prUrl) lines.push(`- **PR:** ${prUrl}`);
   lines.push(`- **Exit code:** ${exitCode}`);
@@ -3068,7 +3069,24 @@ async function runExecutable(profileName, input) {
   if (firstFail) {
     return finish({ exitCode: 99, reason: `required CLI tool check failed: ${firstFail.error}` });
   }
-  const modelSpec = profile.claudeCode.model === "inherit" ? input.config.agent.model : profile.claudeCode.model;
+  let config;
+  if (input.config) {
+    config = input.config;
+  } else if (input.skipConfig) {
+    config = {
+      quality: { typecheck: "", lint: "", testUnit: "" },
+      git: { defaultBranch: "main" },
+      github: { owner: "", repo: "" },
+      agent: { model: "claude/claude-haiku-4-5-20251001" }
+    };
+  } else {
+    try {
+      config = loadConfig(input.cwd);
+    } catch (err) {
+      return finish({ exitCode: 99, reason: `config error: ${err instanceof Error ? err.message : String(err)}` });
+    }
+  }
+  const modelSpec = profile.claudeCode.model === "inherit" ? config.agent.model : profile.claudeCode.model;
   let model;
   try {
     model = parseProviderModel(modelSpec);
@@ -3087,7 +3105,7 @@ async function runExecutable(profileName, input) {
   const ctx = {
     args,
     cwd: input.cwd,
-    config: input.config,
+    config,
     verbose: input.verbose,
     quiet: input.quiet,
     data: {},
@@ -3168,6 +3186,20 @@ function resolveProfilePath(profileName) {
 }
 function validateInputs(specs, raw) {
   const out = {};
+  const allowedKeys = /* @__PURE__ */ new Set(["_", "cwd", "verbose", "quiet"]);
+  for (const spec of specs) {
+    const flagKey = spec.flag.replace(/^--/, "");
+    allowedKeys.add(spec.name);
+    allowedKeys.add(flagKey);
+    if (flagKey.includes("-")) {
+      allowedKeys.add(flagKey.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase()));
+    }
+  }
+  for (const key of Object.keys(raw)) {
+    if (!allowedKeys.has(key)) {
+      throw new Error(`unknown arg: --${key}`);
+    }
+  }
   for (const spec of specs) {
     const v = raw[spec.name];
     if (v === void 0 || v === null) continue;
@@ -3250,8 +3282,8 @@ function autoDispatch(opts) {
   const explicit = opts?.explicit;
   if (explicit?.issueNumber && explicit.issueNumber > 0) {
     return {
-      executable: "build",
-      cliArgs: { mode: "run", issue: explicit.issueNumber },
+      executable: "run",
+      cliArgs: { issue: explicit.issueNumber },
       target: explicit.issueNumber
     };
   }
@@ -3267,7 +3299,7 @@ function autoDispatch(opts) {
   if (eventName === "workflow_dispatch") {
     const n = parseInt(String(event.inputs?.issue_number ?? ""), 10);
     if (!Number.isNaN(n) && n > 0) {
-      return { executable: "build", cliArgs: { mode: "run", issue: n }, target: n };
+      return { executable: "run", cliArgs: { issue: n }, target: n };
     }
     return null;
   }
@@ -3279,35 +3311,35 @@ function autoDispatch(opts) {
   const afterTag = extractAfterTag(body);
   if (isPr) {
     if (/\bfix-ci\b/.test(afterTag)) {
-      return { executable: "build", cliArgs: { mode: "fix-ci", pr: targetNum }, target: targetNum };
+      return { executable: "fix-ci", cliArgs: { pr: targetNum }, target: targetNum };
     }
     if (/\bresolve\b/.test(afterTag)) {
-      return { executable: "build", cliArgs: { mode: "resolve", pr: targetNum }, target: targetNum };
+      return { executable: "resolve", cliArgs: { pr: targetNum }, target: targetNum };
+    }
+    if (/\breview\b/.test(afterTag)) {
+      return { executable: "review", cliArgs: { pr: targetNum }, target: targetNum };
     }
     const feedback = extractFeedback(afterTag);
     return {
-      executable: "build",
-      cliArgs: { mode: "fix", pr: targetNum, ...feedback ? { feedback } : {} },
+      executable: "fix",
+      cliArgs: { pr: targetNum, ...feedback ? { feedback } : {} },
       target: targetNum
     };
   }
   const sub = extractSubcommand(afterTag);
-  const defaultExec = opts?.config?.defaultExecutable ?? "build";
+  const defaultExec = opts?.config?.defaultExecutable ?? "run";
   if (!sub) {
     return asDispatch(defaultExec, targetNum);
   }
-  if (sub === "build") {
-    return { executable: "build", cliArgs: { mode: "run", issue: targetNum }, target: targetNum };
-  }
   if (sub === "orchestrate" || sub === "orchestrator") {
     return { executable: "orchestrator", cliArgs: { issue: targetNum }, target: targetNum };
   }
+  if (sub === "build") {
+    return { executable: "run", cliArgs: { issue: targetNum }, target: targetNum };
+  }
   return asDispatch(sub, targetNum);
 }
 function asDispatch(executable, target) {
-  if (executable === "build") {
-    return { executable, cliArgs: { mode: "run", issue: target }, target };
-  }
   return { executable, cliArgs: { issue: target }, target };
 }
 function extractAfterTag(body) {
@@ -3537,8 +3569,8 @@ ${CI_HELP}`);
     return 64;
   }
   const dispatch = autoFallback ?? {
-    executable: "build",
-    cliArgs: { mode: "run", issue: args.issueNumber },
+    executable: "run",
+    cliArgs: { issue: args.issueNumber },
     target: args.issueNumber
   };
   const issueNumber = dispatch.target;
@@ -3610,16 +3642,19 @@ ${CI_HELP}`);
 var HELP_TEXT = `kody2 \u2014 single-session autonomous engineer
 
 Usage:
-  kody2 run     --issue <N> [--cwd <path>] [--verbose|--quiet] [--dry-run]
-  kody2 ci      --issue <N> [preflight flags \u2014 see: kody2 ci --help]
+  kody2 run     --issue <N> [--cwd <path>] [--verbose|--quiet]
   kody2 fix     --pr    <N> [--feedback "..."] [--cwd <path>] [--verbose|--quiet]
   kody2 fix-ci  --pr    <N> [--run-id <ID>]    [--cwd <path>] [--verbose|--quiet]
   kody2 resolve --pr    <N>                    [--cwd <path>] [--verbose|--quiet]
+  kody2 review  --pr    <N>                    [--cwd <path>] [--verbose|--quiet]
+  kody2 <other>                                [--cwd <path>] [--verbose|--quiet]
+  kody2 ci      --issue <N> [preflight flags \u2014 see: kody2 ci --help]
   kody2 help
   kody2 version
 
-All commands dispatch to the Build executable with a specific mode. The
-executable is defined by \`src/executables/build/profile.json\`.
+Each top-level command (run, fix, fix-ci, resolve, review, \u2026) is a discovered
+executable under \`src/executables/<name>/profile.json\`. Drop in a new
+directory to add a new command.
 
 Exit codes:
   0   success (PR opened, verify passed \u2014 or resolve produced a merge commit)
@@ -3640,11 +3675,6 @@ function parseArgs(argv) {
   if (cmd === "ci") {
     return { ...result, command: "ci", ciArgv: argv.slice(1) };
   }
-  if (cmd === "run" || cmd === "fix" || cmd === "fix-ci" || cmd === "resolve") {
-    result.command = cmd;
-    parseCommandArgs(cmd, argv.slice(1), result);
-    return result;
-  }
   if (hasExecutable(cmd)) {
     result.command = "__executable__";
     result.executableName = cmd;
@@ -3654,38 +3684,11 @@ function parseArgs(argv) {
     if (result.cliArgs.quiet === true) result.quiet = true;
     return result;
   }
-  const discovered = listExecutables().map((e) => e.name).filter((n) => n !== "build");
-  const available = ["run", "fix", "fix-ci", "resolve", "ci", "help", "version", ...discovered];
+  const discovered = listExecutables().map((e) => e.name);
+  const available = ["ci", "help", "version", ...discovered];
   result.errors.push(`unknown command: ${cmd} (available: ${available.join(", ")})`);
   return result;
 }
-function parseCommandArgs(cmd, rest, result) {
-  for (let i = 0; i < rest.length; i++) {
-    const arg = rest[i];
-    if (arg === "--issue") {
-      const n = parseInt(rest[++i] ?? "", 10);
-      if (Number.isNaN(n) || n <= 0) result.errors.push("--issue requires a positive integer");
-      else result.issueNumber = n;
-    } else if (arg === "--pr") {
-      const n = parseInt(rest[++i] ?? "", 10);
-      if (Number.isNaN(n) || n <= 0) result.errors.push("--pr requires a positive integer");
-      else result.prNumber = n;
-    } else if (arg === "--feedback") {
-      result.feedback = rest[++i];
-    } else if (arg === "--run-id") {
-      result.runId = rest[++i];
-    } else if (arg === "--cwd") {
-      result.cwd = rest[++i];
-    } else if (arg === "--verbose") result.verbose = true;
-    else if (arg === "--quiet") result.quiet = true;
-    else if (arg === "--dry-run") result.dryRun = true;
-    else result.errors.push(`unknown arg: ${arg}`);
-  }
-  if (cmd === "run" && !result.issueNumber) result.errors.push("--issue <N> is required for run");
-  if (cmd === "fix" && !result.prNumber) result.errors.push("--pr <N> is required for fix");
-  if (cmd === "fix-ci" && !result.prNumber) result.errors.push("--pr <N> is required for fix-ci");
-  if (cmd === "resolve" && !result.prNumber) result.errors.push("--pr <N> is required for resolve");
-}
 async function main(argv = process.argv.slice(2)) {
   const args = parseArgs(argv);
   if (args.errors.length > 0) {
@@ -3718,69 +3721,27 @@ ${HELP_TEXT}`);
   }
   const cwd = args.cwd ?? process.cwd();
   const configlessCommands = /* @__PURE__ */ new Set(["init"]);
-  const needsConfig = !(args.command === "__executable__" && configlessCommands.has(args.executableName ?? ""));
-  let config;
-  if (needsConfig) {
-    try {
-      config = loadConfig(cwd);
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      process.stderr.write(`[kody2] config error: ${msg}
-`);
-      process.stdout.write(`PR_URL=FAILED: config error: ${msg}
-`);
-      return 99;
-    }
-  } else {
-    config = {
-      quality: { typecheck: "", lint: "", testUnit: "" },
-      git: { defaultBranch: "main" },
-      github: { owner: "", repo: "" },
-      agent: { model: "claude/claude-haiku-4-5-20251001" }
-    };
-  }
-  if (args.command === "__executable__") {
-    try {
-      const result = await runExecutable(args.executableName, {
-        cliArgs: args.cliArgs ?? {},
-        cwd,
-        config,
-        verbose: args.verbose,
-        quiet: args.quiet
-      });
-      return result.exitCode;
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      process.stderr.write(`[kody2] ${args.executableName} crashed: ${msg}
-`);
-      if (err instanceof Error && err.stack) process.stderr.write(`${err.stack}
-`);
-      process.stdout.write(`PR_URL=FAILED: ${args.executableName} crashed: ${msg}
-`);
-      return 99;
-    }
-  }
-  const cliArgs = { mode: args.command };
-  if (args.issueNumber !== void 0) cliArgs.issue = args.issueNumber;
-  if (args.prNumber !== void 0) cliArgs.pr = args.prNumber;
-  if (args.feedback !== void 0) cliArgs.feedback = args.feedback;
-  if (args.runId !== void 0) cliArgs.runId = args.runId;
+  const skipConfig = configlessCommands.has(args.executableName ?? "");
   try {
-    const result = await runExecutable("build", {
-      cliArgs,
+    const result = await runExecutable(args.executableName, {
+      cliArgs: args.cliArgs ?? {},
       cwd,
-      config,
+      skipConfig,
       verbose: args.verbose,
       quiet: args.quiet
     });
+    if (result.exitCode !== 0 && result.reason) {
+      process.stderr.write(`error: ${result.reason}
+`);
+    }
     return result.exitCode;
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
-    process.stderr.write(`[kody2] wrapper crashed: ${msg}
+    process.stderr.write(`[kody2] ${args.executableName} crashed: ${msg}
 `);
     if (err instanceof Error && err.stack) process.stderr.write(`${err.stack}
 `);
-    process.stdout.write(`PR_URL=FAILED: wrapper crashed: ${msg}
+    process.stdout.write(`PR_URL=FAILED: ${args.executableName} crashed: ${msg}
 `);
     return 99;
   }

package/dist/executables/fix/profile.json

@@ -0,0 +1,68 @@
+{
+  "name": "fix",
+  "describe": "Apply review feedback to an existing PR branch.",
+
+  "inputs": [
+    {
+      "name": "pr",
+      "flag": "--pr",
+      "type": "int",
+      "required": true,
+      "describe": "GitHub PR number to apply feedback to."
+    },
+    {
+      "name": "feedback",
+      "flag": "--feedback",
+      "type": "string",
+      "required": false,
+      "describe": "Inline override. If absent, the flow reads the latest PR review comment."
+    }
+  ],
+
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "acceptEdits",
+    "maxTurns": null,
+    "systemPromptAppend": null,
+    "tools": ["Read", "Write", "Edit", "Bash", "Grep", "Glob"],
+    "hooks": {
+      "PreToolUse": [],
+      "PostToolUse": [],
+      "Stop": []
+    },
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+
+  "cliTools": [],
+
+  "scripts": {
+    "preflight": [
+      { "script": "fixFlow" },
+      { "script": "loadTaskState" },
+      { "script": "loadConventions" },
+      { "script": "loadCoverageRules" },
+      { "script": "composePrompt" }
+    ],
+    "postflight": [
+      { "script": "parseAgentResult" },
+      { "script": "verify" },
+      { "script": "checkCoverageWithRetry" },
+      { "script": "commitAndPush" },
+      { "script": "ensurePr" },
+      { "script": "postIssueComment" },
+      { "script": "writeRunSummary" },
+      { "script": "saveTaskState" }
+    ]
+  },
+  "output": {
+    "actionTypes": [
+      "FIX_COMPLETED",
+      "FIX_FAILED",
+      "AGENT_NOT_RUN"
+    ]
+  }
+}

package/dist/executables/fix-ci/profile.json

@@ -0,0 +1,68 @@
+{
+  "name": "fix-ci",
+  "describe": "Fix a failing CI workflow on an existing PR.",
+
+  "inputs": [
+    {
+      "name": "pr",
+      "flag": "--pr",
+      "type": "int",
+      "required": true,
+      "describe": "GitHub PR number whose CI is failing."
+    },
+    {
+      "name": "runId",
+      "flag": "--run-id",
+      "type": "string",
+      "required": false,
+      "describe": "Specific failed workflow run ID. Defaults to latest failed run on the PR branch."
+    }
+  ],
+
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "acceptEdits",
+    "maxTurns": null,
+    "systemPromptAppend": null,
+    "tools": ["Read", "Write", "Edit", "Bash", "Grep", "Glob"],
+    "hooks": {
+      "PreToolUse": [],
+      "PostToolUse": [],
+      "Stop": []
+    },
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+
+  "cliTools": [],
+
+  "scripts": {
+    "preflight": [
+      { "script": "fixCiFlow" },
+      { "script": "loadTaskState" },
+      { "script": "loadConventions" },
+      { "script": "loadCoverageRules" },
+      { "script": "composePrompt" }
+    ],
+    "postflight": [
+      { "script": "parseAgentResult" },
+      { "script": "verify" },
+      { "script": "checkCoverageWithRetry" },
+      { "script": "commitAndPush" },
+      { "script": "ensurePr" },
+      { "script": "postIssueComment" },
+      { "script": "writeRunSummary" },
+      { "script": "saveTaskState" }
+    ]
+  },
+  "output": {
+    "actionTypes": [
+      "FIX_CI_COMPLETED",
+      "FIX_CI_FAILED",
+      "AGENT_NOT_RUN"
+    ]
+  }
+}

package/dist/executables/resolve/profile.json

@@ -0,0 +1,59 @@
+{
+  "name": "resolve",
+  "describe": "Resolve merge conflicts between a PR branch and the default branch.",
+
+  "inputs": [
+    {
+      "name": "pr",
+      "flag": "--pr",
+      "type": "int",
+      "required": true,
+      "describe": "GitHub PR number whose branch has conflicts with the default branch."
+    }
+  ],
+
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "acceptEdits",
+    "maxTurns": null,
+    "systemPromptAppend": null,
+    "tools": ["Read", "Write", "Edit", "Bash", "Grep", "Glob"],
+    "hooks": {
+      "PreToolUse": [],
+      "PostToolUse": [],
+      "Stop": []
+    },
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+
+  "cliTools": [],
+
+  "scripts": {
+    "preflight": [
+      { "script": "resolveFlow" },
+      { "script": "loadTaskState" },
+      { "script": "loadConventions" },
+      { "script": "loadCoverageRules" },
+      { "script": "composePrompt" }
+    ],
+    "postflight": [
+      { "script": "parseAgentResult" },
+      { "script": "commitAndPush" },
+      { "script": "ensurePr" },
+      { "script": "postIssueComment" },
+      { "script": "writeRunSummary" },
+      { "script": "saveTaskState" }
+    ]
+  },
+  "output": {
+    "actionTypes": [
+      "RESOLVE_COMPLETED",
+      "RESOLVE_FAILED",
+      "AGENT_NOT_RUN"
+    ]
+  }
+}

package/dist/executables/run/profile.json

@@ -0,0 +1,61 @@
+{
+  "name": "run",
+  "describe": "Implement a GitHub issue end-to-end: branch, code, commit, open PR.",
+
+  "inputs": [
+    {
+      "name": "issue",
+      "flag": "--issue",
+      "type": "int",
+      "required": true,
+      "describe": "GitHub issue number to implement."
+    }
+  ],
+
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "acceptEdits",
+    "maxTurns": null,
+    "systemPromptAppend": null,
+    "tools": ["Read", "Write", "Edit", "Bash", "Grep", "Glob"],
+    "hooks": {
+      "PreToolUse": [],
+      "PostToolUse": [],
+      "Stop": []
+    },
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+
+  "cliTools": [],
+
+  "scripts": {
+    "preflight": [
+      { "script": "runFlow" },
+      { "script": "loadTaskState" },
+      { "script": "loadConventions" },
+      { "script": "loadCoverageRules" },
+      { "script": "composePrompt" }
+    ],
+    "postflight": [
+      { "script": "parseAgentResult" },
+      { "script": "verify" },
+      { "script": "checkCoverageWithRetry" },
+      { "script": "commitAndPush" },
+      { "script": "ensurePr" },
+      { "script": "postIssueComment" },
+      { "script": "writeRunSummary" },
+      { "script": "saveTaskState" }
+    ]
+  },
+  "output": {
+    "actionTypes": [
+      "RUN_COMPLETED",
+      "RUN_FAILED",
+      "AGENT_NOT_RUN"
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "description": "kody2 — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",
@@ -34,7 +34,7 @@
   "bugs": "https://github.com/aharonyaircohen/kody-engine/issues",
   "scripts": {
     "kody2": "tsx bin/kody2.ts",
-    "build": "tsup && node -e \"require('fs').cpSync('src/executables', 'dist/executables', { recursive: true })\"",
+    "build": "tsup && node -e \"const fs=require('fs');fs.rmSync('dist/executables',{recursive:true,force:true});fs.cpSync('src/executables','dist/executables',{recursive:true})\"",
     "test": "vitest run tests/unit tests/int --no-coverage",
     "test:e2e": "vitest run tests/e2e --no-coverage",
     "test:all": "vitest run tests --no-coverage",

package/dist/executables/build/profile.json

@@ -1,99 +0,0 @@
-{
-  "name": "build",
-  "describe": "Implement a GitHub issue or apply PR feedback end-to-end.",
-
-  "inputs": [
-    {
-      "name": "mode",
-      "flag": "--mode",
-      "type": "enum",
-      "values": ["run", "fix", "fix-ci", "resolve"],
-      "required": true,
-      "describe": "Which Build mode to run."
-    },
-    {
-      "name": "issue",
-      "flag": "--issue",
-      "type": "int",
-      "requiredWhen": { "mode": "run" },
-      "describe": "GitHub issue number to implement."
-    },
-    {
-      "name": "pr",
-      "flag": "--pr",
-      "type": "int",
-      "requiredWhen": { "mode": ["fix", "fix-ci", "resolve"] },
-      "describe": "GitHub PR number to operate on."
-    },
-    {
-      "name": "feedback",
-      "flag": "--feedback",
-      "type": "string",
-      "required": false,
-      "describe": "Inline override for fix mode. If absent, the executor reads the latest PR review comment."
-    },
-    {
-      "name": "runId",
-      "flag": "--run-id",
-      "type": "string",
-      "required": false,
-      "describe": "Specific failed workflow run ID for fix-ci. Defaults to latest failed run on the PR branch."
-    }
-  ],
-
-  "claudeCode": {
-    "model": "inherit",
-    "permissionMode": "acceptEdits",
-    "maxTurns": null,
-    "systemPromptAppend": null,
-    "tools": ["Read", "Write", "Edit", "Bash", "Grep", "Glob"],
-    "hooks": {
-      "PreToolUse": [],
-      "PostToolUse": [],
-      "Stop": []
-    },
-    "skills": [],
-    "commands": [],
-    "subagents": [],
-    "plugins": [],
-    "mcpServers": []
-  },
-
-  "cliTools": [],
-
-  "scripts": {
-    "preflight": [
-      { "script": "runFlow",     "runWhen": { "args.mode": "run" } },
-      { "script": "fixFlow",     "runWhen": { "args.mode": "fix" } },
-      { "script": "fixCiFlow",   "runWhen": { "args.mode": "fix-ci" } },
-      { "script": "resolveFlow", "runWhen": { "args.mode": "resolve" } },
-      { "script": "loadTaskState" },
-      { "script": "loadConventions" },
-      { "script": "loadCoverageRules" },
-      { "script": "composePrompt" }
-    ],
-    "postflight": [
-      { "script": "parseAgentResult" },
-      { "script": "verify",                 "runWhen": { "args.mode": ["run", "fix", "fix-ci"] } },
-      { "script": "checkCoverageWithRetry", "runWhen": { "args.mode": ["run", "fix", "fix-ci"] } },
-      { "script": "commitAndPush" },
-      { "script": "ensurePr" },
-      { "script": "postIssueComment" },
-      { "script": "writeRunSummary" },
-      { "script": "saveTaskState" }
-    ]
-  },
-  "output": {
-    "actionTypes": [
-      "RUN_COMPLETED",
-      "RUN_FAILED",
-      "FIX_COMPLETED",
-      "FIX_FAILED",
-      "FIX_CI_COMPLETED",
-      "FIX_CI_FAILED",
-      "RESOLVE_COMPLETED",
-      "RESOLVE_FAILED",
-      "AGENT_NOT_RUN"
-    ]
-  }
-}

package/dist/executables/orchestrator/prompts/orchestrator.md

@@ -1,56 +0,0 @@
-You are the **kody2 orchestrator** for issue #{{issue.number}} on {{repoOwner}}/{{repoName}}.
-
-Your job: drive a 2-step flow **plan → build** by posting `@kody2 <subcommand>` comments on the issue and watching the state-comment for completion signals. You do NOT edit files. You do NOT run git. You use `gh` (via Bash) only to post comments and read the state-comment.
-
----
-
-# Issue #{{issue.number}}: {{issue.title}}
-
-{{issue.body}}
-
-# Required flow (plan-then-build)
-
-1. **Kick off plan.** Post an issue comment with EXACTLY this body:
-   ```
-   @kody2 plan
-   ```
-   Use: `gh issue comment {{issue.number}} --body "@kody2 plan"` (in the cwd).
-2. **Wait for plan to complete.** Poll the issue's state-comment every ~30s. The state-comment is the one whose body starts with `<!-- kody2:state:v1:begin -->`. Fetch it with:
-   ```
-   gh api repos/{{repoOwner}}/{{repoName}}/issues/{{issue.number}}/comments --paginate --jq '.[] | select(.body | contains("kody2:state:v1:begin")) | .body'
-   ```
-   Parse the JSON block inside the sentinels. Look for `core.lastOutcome.type == "PLAN_COMPLETED"`.
-   If `core.lastOutcome.type == "PLAN_FAILED"` OR if 10 minutes pass without completion → abort with:
-   ```
-   FAILED: plan did not complete (<reason from state or "timeout">)
-   ```
-3. **Kick off build.** Post:
-   ```
-   @kody2 build
-   ```
-   Same `gh issue comment` command.
-4. **Wait for build to complete.** Same poll technique. Look for `core.lastOutcome.type == "RUN_COMPLETED"` (build's success marker) or `RUN_FAILED`. If `RUN_FAILED` or 30 minutes pass → abort with `FAILED: build did not complete (...)`.
-5. **Emit final summary.**
-
-# Required final output
-
-On success:
-
-```
-DONE
-COMMIT_MSG: chore(orchestrator): plan-then-build for #{{issue.number}}
-PR_SUMMARY:
-- Posted `@kody2 plan` and observed PLAN_COMPLETED.
-- Posted `@kody2 build` and observed RUN_COMPLETED.
-- Final PR: <prUrl from state>
-```
-
-On failure, a single line: `FAILED: <concrete reason>`.
-
-# Rules
-
-- NEVER edit files. Read-only flow.
-- NEVER run git. Only `gh` via Bash for comment posting and state polling.
-- Between polls, sleep ~30 seconds. Do NOT poll faster than once every 30 seconds.
-- Hard cap: 40 turns total across the whole flow. If you're approaching the cap, fail early with `FAILED: turn budget exhausted`.
-- If you post an `@kody2` comment and the state-comment does NOT update within the poll window, the child executable likely didn't run — check the GitHub Actions runs tab URL via `gh run list --limit 5 --json conclusion,status,url` to diagnose, then fail with a concrete reason.

package/dist/executables/plan/prompts/plan.md

@@ -1,42 +0,0 @@
-You are a senior engineer producing an **implementation plan** for the GitHub issue below. You will NOT write code. You will NOT run git or gh commands. You will NOT modify files. Your only outputs are:
-
-1. Use Read / Grep / Glob / Bash (read-only) to study the codebase as much as needed.
-2. Emit a final message with the plan wrapped in the required markers (see "Required output").
-
----
-
-# Repo
-- {{repoOwner}}/{{repoName}}, default branch: {{defaultBranch}}
-
-# Issue #{{issue.number}}: {{issue.title}}
-
-{{issue.body}}
-
-Recent comments (most recent first, truncated):
-{{issue.commentsFormatted}}
-
-{{conventionsBlock}}
-
----
-
-# Required output
-
-Your FINAL message must be exactly this shape (no extra text before or after):
-
-```
-DONE
-COMMIT_MSG: plan: <very short title>
-PR_SUMMARY:
-<A concrete implementation plan in markdown. Include:
- - Files to change (with paths), and the change in each.
- - New files to create, with their purpose and rough shape.
- - Any ambiguities that need the human to resolve first.
- - Verification checklist (typecheck / tests / lint expectations).
- Keep to ~60 lines or less. No filler. No marketing language.>
-```
-
-# Rules
-- Read-only. Do NOT modify any file.
-- Do NOT run git or gh commands.
-- No speculative scope — plan only what the issue asks for.
-- If the issue is ambiguous and you cannot make progress without input, output `FAILED: <what's unclear>` instead of a plan.