@kody-ade/kody-engine 0.2.52 → 0.2.53

package/dist/bin/kody2.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.2.52",
+  version: "0.2.53",
   description: "kody2 \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -4434,14 +4434,14 @@ var skipAgent = async (ctx) => {
 // src/scripts/startFlow.ts
 import { execFileSync as execFileSync16 } from "child_process";
 var API_TIMEOUT_MS6 = 3e4;
-var startFlow = async (ctx, _profile, _agentResult, args) => {
+var startFlow = async (ctx, profile, _agentResult, args) => {
   const entry = args?.entry;
   if (!entry) {
     process.stderr.write("[kody2 startFlow] missing `with.entry` \u2014 skipping\n");
     return;
   }
   const target = args?.target ?? "issue";
-  const flowName = ctx.args.flow ?? "default";
+  const flowName = profile.name;
   const issueNumber = ctx.args.issue;
   if (!issueNumber) {
     process.stderr.write("[kody2 startFlow] no --issue arg \u2014 skipping\n");

package/dist/executables/chore/profile.json

@@ -0,0 +1,78 @@
+{
+  "name": "chore",
+  "describe": "Sub-orchestrator for chore / docs / dep-bump issues — run → review (→ fix on concerns/fail). Skips planning entirely. No agent.",
+  "inputs": [
+    {
+      "name": "issue",
+      "flag": "--issue",
+      "type": "int",
+      "required": true,
+      "describe": "GitHub issue number to drive the flow on."
+    }
+  ],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "default",
+    "maxTurns": 0,
+    "maxThinkingTokens": null,
+    "systemPromptAppend": null,
+    "tools": [],
+    "hooks": [],
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [],
+  "scripts": {
+    "preflight": [
+      {
+        "script": "setLifecycleLabel",
+        "with": {
+          "label": "kody:orchestrating",
+          "color": "1d76db",
+          "description": "kody2: orchestrating a multi-stage flow"
+        }
+      },
+      { "script": "loadIssueContext" },
+      { "script": "loadTaskState" },
+      { "script": "skipAgent" }
+    ],
+    "postflight": [
+      { "script": "startFlow", "with": { "entry": "run", "target": "issue" },
+        "runWhen": { "data.taskState.core.lastOutcome": null } },
+
+      { "script": "dispatch", "with": { "next": "review", "target": "pr" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": "RUN_COMPLETED" } },
+
+      { "script": "finishFlow",
+        "with": { "reason": "review-passed", "label": "kody:done", "color": "0e8a16", "description": "kody2: PR ready for human review/merge" },
+        "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", "label": "kody:failed", "color": "e11d21", "description": "kody2: flow failed" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": "REVIEW_FAILED" } },
+
+      { "script": "finishFlow",
+        "with": { "reason": "fix-applied", "label": "kody:done", "color": "0e8a16", "description": "kody2: PR ready for human review/merge" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": "FIX_COMPLETED" } },
+
+      { "script": "finishFlow",
+        "with": { "reason": "aborted", "label": "kody:failed", "color": "e11d21", "description": "kody2: flow failed" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": ["RUN_FAILED", "FIX_FAILED", "AGENT_NOT_RUN"] } },
+
+      { "script": "persistFlowState" }
+    ]
+  },
+  "output": {
+    "actionTypes": [
+      "FLOW_STARTED",
+      "FLOW_COMPLETED",
+      "FLOW_ABORTED"
+    ]
+  }
+}

package/dist/executables/chore/prompt.md

@@ -0,0 +1,5 @@
+<!--
+Placeholder. The chore sub-orchestrator runs with maxTurns: 0 and a
+`skipAgent` preflight, so this prompt is never sent to Claude. The
+transition logic lives entirely in profile.json's postflight entries.
+-->

package/dist/executables/feature/profile.json

@@ -0,0 +1,84 @@
+{
+  "name": "feature",
+  "describe": "Sub-orchestrator for feature / refactor issues — research → plan → run → review (→ fix on concerns/fail). 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."
+    }
+  ],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "default",
+    "maxTurns": 0,
+    "maxThinkingTokens": null,
+    "systemPromptAppend": null,
+    "tools": [],
+    "hooks": [],
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [],
+  "scripts": {
+    "preflight": [
+      {
+        "script": "setLifecycleLabel",
+        "with": {
+          "label": "kody:orchestrating",
+          "color": "1d76db",
+          "description": "kody2: orchestrating a multi-stage flow"
+        }
+      },
+      { "script": "loadIssueContext" },
+      { "script": "loadTaskState" },
+      { "script": "skipAgent" }
+    ],
+    "postflight": [
+      { "script": "startFlow", "with": { "entry": "research", "target": "issue" },
+        "runWhen": { "data.taskState.core.lastOutcome": null } },
+
+      { "script": "dispatch", "with": { "next": "plan", "target": "issue" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": "RESEARCH_COMPLETED" } },
+
+      { "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", "label": "kody:done", "color": "0e8a16", "description": "kody2: PR ready for human review/merge" },
+        "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", "label": "kody:failed", "color": "e11d21", "description": "kody2: flow failed" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": "REVIEW_FAILED" } },
+
+      { "script": "finishFlow",
+        "with": { "reason": "fix-applied", "label": "kody:done", "color": "0e8a16", "description": "kody2: PR ready for human review/merge" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": "FIX_COMPLETED" } },
+
+      { "script": "finishFlow",
+        "with": { "reason": "aborted", "label": "kody:failed", "color": "e11d21", "description": "kody2: flow failed" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": ["RESEARCH_FAILED", "PLAN_FAILED", "RUN_FAILED", "FIX_FAILED", "AGENT_NOT_RUN"] } },
+
+      { "script": "persistFlowState" }
+    ]
+  },
+  "output": {
+    "actionTypes": [
+      "FLOW_STARTED",
+      "FLOW_COMPLETED",
+      "FLOW_ABORTED"
+    ]
+  }
+}

package/dist/executables/feature/prompt.md

@@ -0,0 +1,5 @@
+<!--
+Placeholder. The feature sub-orchestrator runs with maxTurns: 0 and a
+`skipAgent` preflight, so this prompt is never sent to Claude. The
+transition logic lives entirely in profile.json's postflight entries.
+-->

package/dist/executables/spec/profile.json

@@ -0,0 +1,67 @@
+{
+  "name": "spec",
+  "describe": "Sub-orchestrator for spec / RFC / design-doc issues — research → plan (stop). Terminates at the plan artifact; no run, no PR. No agent.",
+  "inputs": [
+    {
+      "name": "issue",
+      "flag": "--issue",
+      "type": "int",
+      "required": true,
+      "describe": "GitHub issue number to drive the flow on."
+    }
+  ],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "default",
+    "maxTurns": 0,
+    "maxThinkingTokens": null,
+    "systemPromptAppend": null,
+    "tools": [],
+    "hooks": [],
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [],
+  "scripts": {
+    "preflight": [
+      {
+        "script": "setLifecycleLabel",
+        "with": {
+          "label": "kody:orchestrating",
+          "color": "1d76db",
+          "description": "kody2: orchestrating a multi-stage flow"
+        }
+      },
+      { "script": "loadIssueContext" },
+      { "script": "loadTaskState" },
+      { "script": "skipAgent" }
+    ],
+    "postflight": [
+      { "script": "startFlow", "with": { "entry": "research", "target": "issue" },
+        "runWhen": { "data.taskState.core.lastOutcome": null } },
+
+      { "script": "dispatch", "with": { "next": "plan", "target": "issue" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": "RESEARCH_COMPLETED" } },
+
+      { "script": "finishFlow",
+        "with": { "reason": "spec-ready", "label": "kody:done", "color": "0e8a16", "description": "kody2: spec/plan artifact ready" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": "PLAN_COMPLETED" } },
+
+      { "script": "finishFlow",
+        "with": { "reason": "aborted", "label": "kody:failed", "color": "e11d21", "description": "kody2: flow failed" },
+        "runWhen": { "data.taskState.core.lastOutcome.type": ["RESEARCH_FAILED", "PLAN_FAILED", "AGENT_NOT_RUN"] } },
+
+      { "script": "persistFlowState" }
+    ]
+  },
+  "output": {
+    "actionTypes": [
+      "FLOW_STARTED",
+      "FLOW_COMPLETED",
+      "FLOW_ABORTED"
+    ]
+  }
+}

package/dist/executables/spec/prompt.md

@@ -0,0 +1,5 @@
+<!--
+Placeholder. The spec sub-orchestrator runs with maxTurns: 0 and a
+`skipAgent` preflight, so this prompt is never sent 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.52",
+  "version": "0.2.53",
   "description": "kody2 — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",