@kody-ade/kody-engine 0.2.46 → 0.2.47

package/dist/bin/kody2.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.2.46",
+  version: "0.2.47",
   description: "kody2 \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -591,7 +591,19 @@ function autoDispatch(opts) {
     return asDispatch(defaultExec, targetNum);
   }
   if (sub === "orchestrate" || sub === "orchestrator") {
-    return { executable: "orchestrator", cliArgs: { issue: targetNum }, target: targetNum };
+    const flow = extractFlowName(afterTag);
+    if (flow) {
+      return {
+        executable: `orchestrator-${flow}`,
+        cliArgs: { issue: targetNum, flow },
+        target: targetNum
+      };
+    }
+    return {
+      executable: "orchestrator-plan-build-review",
+      cliArgs: { issue: targetNum, flow: "plan-build-review" },
+      target: targetNum
+    };
   }
   if (sub === "build") {
     return { executable: "run", cliArgs: { issue: targetNum }, target: targetNum };
@@ -611,6 +623,10 @@ function extractSubcommand(afterTag) {
   if (!match) return null;
   return match[1];
 }
+function extractFlowName(afterTag) {
+  const match = afterTag.match(/--flow[=\s]+([a-z][a-z0-9-]{0,60})/);
+  return match ? match[1] : null;
+}
 function extractFeedback(afterTag) {
   const cleaned = afterTag.replace(/^(fix|please|kindly)(?:[\s:,.-]+|$)/i, "").trim();
   return cleaned.length > 0 ? cleaned : void 0;
@@ -948,6 +964,9 @@ function parseScriptList(p, key, raw) {
     if (r.runWhen && typeof r.runWhen === "object") {
       entry.runWhen = r.runWhen;
     }
+    if (r.with && typeof r.with === "object") {
+      entry.with = r.with;
+    }
     out.push(entry);
   }
   return out;
@@ -2931,6 +2950,22 @@ function readDottedString(source, dotted) {
   return String(cur);
 }
 
+// src/scripts/persistFlowState.ts
+var persistFlowState = async (ctx) => {
+  const state = ctx.data.taskState;
+  if (!state) return;
+  const issueNumber = ctx.args.issue ?? state.flow?.issueNumber;
+  if (!issueNumber) return;
+  try {
+    writeTaskState("issue", issueNumber, state, ctx.cwd);
+  } catch (err) {
+    process.stderr.write(
+      `[kody2 persistFlowState] failed to write state on issue #${issueNumber}: ${err instanceof Error ? err.message : String(err)}
+`
+    );
+  }
+};
+
 // src/scripts/postIssueComment.ts
 var postIssueComment2 = async (ctx) => {
   if (ctx.skipAgent && ctx.output.exitCode !== void 0) return;
@@ -4022,7 +4057,8 @@ var postflightScripts = {
   startFlow,
   dispatch,
   finishFlow,
-  advanceFlow
+  advanceFlow,
+  persistFlowState
 };
 var allScriptNames = /* @__PURE__ */ new Set([
   ...Object.keys(preflightScripts),

package/dist/executables/orchestrator-plan-build-review/profile.json

@@ -0,0 +1,76 @@
+{
+  "name": "orchestrator-plan-build-review",
+  "describe": "Deterministic orchestrator for the plan → build → review (→ fix on concerns/fail) flow. No agent — the postflight entries ARE the transition table, evaluated top-to-bottom via runWhen.",
+  "inputs": [
+    {
+      "name": "issue",
+      "flag": "--issue",
+      "type": "int",
+      "required": true,
+      "describe": "GitHub issue number to drive the flow on."
+    },
+    {
+      "name": "flow",
+      "flag": "--flow",
+      "type": "string",
+      "required": false,
+      "describe": "Flow name (cosmetic — recorded in state.flow.name)."
+    }
+  ],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "default",
+    "maxTurns": 0,
+    "maxThinkingTokens": null,
+    "systemPromptAppend": null,
+    "tools": [],
+    "hooks": [],
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [],
+  "scripts": {
+    "preflight": [
+      { "script": "loadIssueContext" },
+      { "script": "loadTaskState" },
+      { "script": "skipAgent" }
+    ],
+    "postflight": [
+      { "script": "startFlow", "with": { "entry": "plan", "target": "issue" },
+        "runWhen": { "data.taskState.core.lastOutcome": null } },
+
+      { "script": "dispatch", "with": { "next": "run", "target": "issue" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": "PLAN_COMPLETED" } },
+
+      { "script": "dispatch", "with": { "next": "review", "target": "pr" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": "RUN_COMPLETED" } },
+
+      { "script": "finishFlow", "with": { "reason": "review-passed" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": "REVIEW_PASS" } },
+
+      { "script": "dispatch", "with": { "next": "fix", "target": "pr" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": ["REVIEW_CONCERNS", "REVIEW_FAIL"] } },
+
+      { "script": "finishFlow", "with": { "reason": "review-failed" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": "REVIEW_FAILED" } },
+
+      { "script": "finishFlow", "with": { "reason": "fix-applied" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": "FIX_COMPLETED" } },
+
+      { "script": "finishFlow", "with": { "reason": "aborted" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": ["PLAN_FAILED", "RUN_FAILED", "FIX_FAILED", "AGENT_NOT_RUN"] } },
+
+      { "script": "persistFlowState" }
+    ]
+  },
+  "output": {
+    "actionTypes": [
+      "FLOW_STARTED",
+      "FLOW_COMPLETED",
+      "FLOW_ABORTED"
+    ]
+  }
+}

package/dist/executables/orchestrator-plan-build-review/prompt.md

@@ -0,0 +1,7 @@
+<!--
+This file exists only because the executor's profile loader expects a
+prompt.md sibling. The orchestrator-plan-build-review executable runs
+with maxTurns: 0 and a `skipAgent` preflight, so this prompt is never
+actually delivered to Claude. The transition logic lives entirely in
+profile.json's postflight entries.
+-->

package/package.json

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

package/dist/executables/orchestrator/profile.json

@@ -1,67 +0,0 @@
-{
-  "name": "orchestrator",
-  "describe": "Drive a chain of kody2 executables by posting @kody2 subcommand comments and polling the task-state comment. Atomic \u2014 one orchestrator run fires one flow.",
-  "inputs": [
-    {
-      "name": "issue",
-      "flag": "--issue",
-      "type": "int",
-      "required": true,
-      "describe": "GitHub issue number to drive."
-    },
-    {
-      "name": "flow",
-      "flag": "--flow",
-      "type": "string",
-      "required": false,
-      "describe": "Named flow to run (e.g. 'plan-then-build'). Defaults to plan-then-build."
-    }
-  ],
-  "claudeCode": {
-    "model": "inherit",
-    "permissionMode": "default",
-    "maxTurns": null,
-    "systemPromptAppend": null,
-    "tools": [
-      "Bash",
-      "Read"
-    ],
-    "hooks": [],
-    "skills": [],
-    "commands": [],
-    "subagents": [],
-    "plugins": [],
-    "mcpServers": []
-  },
-  "cliTools": [],
-  "scripts": {
-    "preflight": [
-      {
-        "script": "loadIssueContext"
-      },
-      {
-        "script": "loadTaskState"
-      },
-      {
-        "script": "composePrompt"
-      }
-    ],
-    "postflight": [
-      {
-        "script": "parseAgentResult"
-      },
-      {
-        "script": "writeRunSummary"
-      },
-      {
-        "script": "saveTaskState"
-      }
-    ]
-  },
-  "output": {
-    "actionTypes": [
-      "ORCHESTRATION_COMPLETED",
-      "ORCHESTRATION_FAILED"
-    ]
-  }
-}

package/dist/executables/orchestrator/prompt.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.