@kody-ade/kody-engine 0.4.77 → 0.4.79

package/dist/bin/kody.js

@@ -213,7 +213,7 @@ function buildVerifyMcpServer(opts) {
     attempts: 0,
     maxAttempts: opts.maxAttempts ?? DEFAULT_MAX_VERIFY_ATTEMPTS
   };
-  const runVerify = opts.__runVerify ?? verifyAllWithRetry;
+  const runVerify2 = opts.__runVerify ?? verifyAllWithRetry;
   const verifyTool = tool(
     "verify",
     "Run the project's quality gates (typecheck, lint, tests). Returns ok=true with empty failures when everything passes. Call this before declaring DONE. If ok=false, read the truncated failures, fix the code, commit, and call verify() again. You have a bounded number of attempts; after that the tool stops accepting calls and you must wrap up with whatever state is current.",
@@ -243,7 +243,7 @@ function buildVerifyMcpServer(opts) {
         };
       }
       const startedAt = Date.now();
-      const result = await runVerify(opts.config, opts.cwd);
+      const result = await runVerify2(opts.config, opts.cwd);
       const durationMs = Date.now() - startedAt;
       emitEvent(opts.cwd, {
         executable: opts.executable,
@@ -868,7 +868,7 @@ var init_loadPriorArt = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.77",
+  version: "0.4.79",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -2546,7 +2546,7 @@ function prBranchLifecycle(profile, profilePath) {
   const afterPreflight = cfg.context === "minimal" && cfg.contextExtras.length === 0 ? [{ script: "composePrompt" }] : [...contextBundle, { script: "composePrompt" }];
   profile.scripts.preflight = [...before, ...profile.scripts.preflight, ...afterPreflight];
   const beforePostflight = [{ script: "parseAgentResult" }];
-  const verifyChain = cfg.verify ? [{ script: "verify" }, { script: "checkCoverageWithRetry" }, { script: "abortUnfinishedGitOps" }] : [];
+  const verifyChain = cfg.verify ? [{ script: "verifyWithRetry" }, { script: "checkCoverageWithRetry" }, { script: "abortUnfinishedGitOps" }] : [];
   const tail = [
     ...verifyChain,
     { script: "commitAndPush" },
@@ -9796,6 +9796,96 @@ function downgrade2(ctx, reason) {
   ctx.data.agentDone = false;
 }
 
+// src/scripts/verifyWithRetry.ts
+init_prompt();
+init_verify();
+async function runVerify(ctx) {
+  try {
+    const result = await verifyAllWithRetry(ctx.config, ctx.cwd);
+    ctx.data.verifyOk = result.ok;
+    ctx.data.verifyReason = result.ok ? "" : summarizeFailure(result);
+    ctx.data.verifyRecovered = result.recovered ?? [];
+    if (result.recovered && result.recovered.length > 0) {
+      process.stderr.write(
+        `[kody verify] caught flake on: ${result.recovered.join(", ")} (passed on retry)
+`
+      );
+    }
+  } catch (err) {
+    ctx.data.verifyOk = false;
+    ctx.data.verifyReason = `verify crashed: ${err instanceof Error ? err.message : String(err)}`;
+  }
+}
+function downgradeActionOnFailure(ctx) {
+  if (ctx.data.verifyOk !== false) return;
+  const action = ctx.data.action;
+  if (!action || !action.type.endsWith("_COMPLETED")) return;
+  const reason = ctx.data.verifyReason || "verify failed";
+  ctx.data.action = {
+    type: action.type.replace(/_COMPLETED$/, "_FAILED"),
+    payload: { reason, downgradedFrom: action.type },
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function upgradeActionOnPass(ctx) {
+  if (ctx.data.verifyOk !== true) return;
+  const action = ctx.data.action;
+  if (!action || !action.type.endsWith("_FAILED")) return;
+  const downgradedFrom = action.payload?.downgradedFrom;
+  if (!downgradedFrom || !downgradedFrom.endsWith("_COMPLETED")) return;
+  ctx.data.action = {
+    type: downgradedFrom,
+    payload: {},
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+var verifyWithRetry = async (ctx) => {
+  await runVerify(ctx);
+  if (ctx.data.verifyOk !== false) return;
+  if (!ctx.data.agentDone) {
+    downgradeActionOnFailure(ctx);
+    return;
+  }
+  const invoker = ctx.data.__invokeAgent;
+  const basePrompt = ctx.data.prompt;
+  if (!invoker || !basePrompt) {
+    downgradeActionOnFailure(ctx);
+    return;
+  }
+  const reason = ctx.data.verifyReason || "verify failed";
+  process.stderr.write(`[kody] verify failed; retrying agent once with verify output as feedback
+`);
+  const retryPrompt = [
+    basePrompt,
+    "",
+    "# Verify failure (retry)",
+    "",
+    "The quality gate failed after your previous attempt. Read the output below,",
+    "fix the underlying issue (do NOT relax the gate or skip tests), then re-emit",
+    "your result. You have one retry \u2014 make it count.",
+    "",
+    reason
+  ].join("\n");
+  try {
+    const retry = await invoker(retryPrompt);
+    const parsed = parseAgentResult(retry.finalText);
+    if (retry.outcome === "completed" && parsed.done) {
+      ctx.data.agentDone = true;
+      ctx.data.commitMessage = parsed.commitMessage || ctx.data.commitMessage;
+      ctx.data.prSummary = parsed.prSummary || ctx.data.prSummary;
+    }
+  } catch (err) {
+    process.stderr.write(`[kody] verify retry crashed: ${err instanceof Error ? err.message : String(err)}
+`);
+  }
+  await runVerify(ctx);
+  if (ctx.data.verifyOk === true) {
+    upgradeActionOnPass(ctx);
+  } else {
+    downgradeActionOnFailure(ctx);
+  }
+};
+
 // src/scripts/waitForCi.ts
 init_issue();
 import { execFileSync as execFileSync27 } from "child_process";
@@ -10216,6 +10306,7 @@ var postflightScripts = {
   requireFeedbackActions,
   requirePlanDeviations,
   verify,
+  verifyWithRetry,
   verifyReproFails,
   checkCoverageWithRetry,
   abortUnfinishedGitOps: abortUnfinishedGitOps2,

package/package.json

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

package/templates/kody.yml

@@ -0,0 +1,93 @@
+# Drop this file at .github/workflows/kody.yml in your repo.
+#
+# Triggers forward every relevant event to `kody`; the engine decides what
+# (if anything) to do. The job runs `npx kody` — no shell branching, no
+# routing logic in YAML. All orchestration lives in the kody npm package;
+# future capabilities ship via `npm publish`, not by editing this file.
+#
+# Required repo secrets: at least one model provider key (e.g. MINIMAX_API_KEY,
+# ANTHROPIC_API_KEY). kody reads any *_API_KEY secret automatically via
+# toJSON(secrets) — no need to list them here.
+#
+# Recommended: KODY_TOKEN secret — a fine-grained PAT or GitHub App token
+# with `repo` + `read:org` + `workflow` scopes. Without it, kody's
+# commits/PR-creation still work via github.token, but three things degrade:
+#   1. PR body updates fail with "token lacks read:org scope" (cosmetic).
+#   2. Pushes from kody won't trigger downstream workflows.
+#   3. Any commit that modifies `.github/workflows/*` is REJECTED by
+#      GitHub — the default GITHUB_TOKEN can't touch workflow files.
+# Set KODY_TOKEN in repo Settings → Secrets → Actions.
+
+name: kody
+
+on:
+  workflow_dispatch:
+    inputs:
+      issue_number:
+        description: "GitHub issue number (agent mode)"
+        type: string
+        default: ""
+      sessionId:
+        description: "Chat session ID (chat mode, from Kody-Dashboard)"
+        type: string
+        default: ""
+      message:
+        description: "Initial chat message (optional)"
+        type: string
+        default: ""
+      model:
+        description: "Model override (optional, e.g. anthropic/claude-haiku-4-5-20251001)"
+        type: string
+        default: ""
+      dashboardUrl:
+        description: "Dashboard event ingest URL with inline ?token=... (chat mode)"
+        type: string
+        default: ""
+  issue_comment:
+    types: [created]
+  pull_request:
+    types: [closed]
+  schedule:
+    # Wakes every 30 minutes; kody fans out to whichever scheduled executables
+    # (job-scheduler, memorize, watch-stale-prs, …) match this tick.
+    #
+    # `memorize` writes to `.kody/vault/` and opens a daily PR. If your
+    # `.gitignore` ignores `.kody/*`, add `!.kody/vault/` and `!.kody/vault/**`
+    # so memorize's pages are tracked.
+    - cron: "*/15 * * * *"
+
+jobs:
+  run:
+    if: ${{ github.event_name != 'pull_request' || github.event.pull_request.merged == true }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 360
+    concurrency:
+      group: kody-${{ inputs.sessionId || inputs.issue_number || github.event.issue.number || github.sha }}
+      cancel-in-progress: false
+    permissions:
+      issues: write
+      pull-requests: write
+      contents: write
+      actions: read
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.pull_request.base.ref || github.ref }}
+          token: ${{ secrets.KODY_TOKEN || github.token }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - env:
+          ALL_SECRETS:   ${{ toJSON(secrets) }}
+          SESSION_ID:    ${{ inputs.sessionId }}
+          INIT_MESSAGE:  ${{ inputs.message }}
+          MODEL:         ${{ inputs.model }}
+          DASHBOARD_URL: ${{ inputs.dashboardUrl }}
+        run: npx -y -p @kody-ade/kody-engine@0.4.79 kody-engine