@kody-ade/kody-engine 0.4.92 → 0.4.93

package/dist/bin/kody.js

@@ -877,7 +877,7 @@ var init_loadPriorArt = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.92",
+  version: "0.4.93",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",

package/dist/executables/chore/profile.json

@@ -1,32 +1,42 @@
 {
   "name": "chore",
-  "role": "container",
-  "preloadContext": true,
-  "describe": "Chore / docs / dep-bump flow — run → review (→ fix on concerns/fail). Skips planning entirely. Children run sequentially in one process via the container loop.",
+  "role": "primitive",
+  "describe": "Make a chore / docs / dep-bump change end-to-end in ONE session: minimal investigation → change → verify, then branch, commit, open PR. Low-ceremony (no heavy planning) — single-session, no multi-stage orchestration.",
   "inputs": [
     {
       "name": "issue",
       "flag": "--issue",
       "type": "int",
       "required": true,
-      "describe": "GitHub issue number to drive the flow on."
+      "describe": "GitHub issue number to implement."
     },
     {
       "name": "base",
       "flag": "--base",
       "type": "string",
       "required": false,
-      "describe": "Optional base branch override (stacked-PR). Forwarded to the `run` child by the container loop."
+      "describe": "Optional base branch override (stacked-PR). Used by goal-tick so each task PR forks from the previous task's head ref."
     }
   ],
   "claudeCode": {
     "model": "inherit",
-    "permissionMode": "default",
-    "maxTurns": 0,
-    "maxThinkingTokens": null,
+    "permissionMode": "acceptEdits",
+    "maxTurns": null,
+    "maxTurnTimeoutSec": 1200,
     "systemPromptAppend": null,
-    "tools": [],
-    "hooks": [],
+    "cacheable": true,
+    "enableVerifyTool": true,
+    "verifyAttempts": 4,
+    "tools": [
+      "Read",
+      "Write",
+      "Edit",
+      "Bash",
+      "Grep",
+      "Glob",
+      "mcp__kody-verify"
+    ],
+    "hooks": ["block-git"],
     "skills": [],
     "commands": [],
     "subagents": [],
@@ -34,79 +44,31 @@
     "mcpServers": []
   },
   "cliTools": [],
+  "lifecycle": "pr-branch",
+  "lifecycleConfig": {
+    "label": {
+      "name": "kody:running",
+      "color": "fbca04",
+      "description": "kody: implementing the change"
+    },
+    "context": "task",
+    "sync": false,
+    "verify": true,
+    "advance": false,
+    "mirrorState": true,
+    "finalize": true
+  },
   "scripts": {
     "preflight": [
-      {
-        "script": "setLifecycleLabel",
-        "with": {
-          "label": "kody-flow:chore",
-          "color": "c5def5",
-          "description": "kody flow: chore / docs / dep-bump"
-        }
-      },
-      {
-        "script": "setLifecycleLabel",
-        "with": {
-          "label": "kody:orchestrating",
-          "color": "1d76db",
-          "description": "kody: orchestrating a multi-stage flow"
-        }
-      },
-      { "script": "loadIssueContext" },
-      { "script": "loadTaskState" }
+      { "script": "runFlow" }
     ],
-    "postflight": [
-      { "script": "finishFlow",
-        "with": { "reason": "review-passed", "label": "kody:done", "color": "0e8a16", "description": "kody: PR ready for human review/merge" },
-        "runWhen": { "data.taskState.core.lastOutcome.type": "REVIEW_PASS" } },
-
-      { "script": "finishFlow",
-        "with": { "reason": "fix-applied", "label": "kody:done", "color": "0e8a16", "description": "kody: PR ready for human review/merge" },
-        "runWhen": { "data.taskState.core.lastOutcome.type": "FIX_COMPLETED" } },
-
-      { "script": "finishFlow",
-        "with": { "reason": "review-failed", "label": "kody:failed", "color": "e11d21", "description": "kody: flow failed" },
-        "runWhen": { "data.taskState.core.lastOutcome.type": "REVIEW_FAILED" } },
-
-      { "script": "finishFlow",
-        "with": { "reason": "aborted", "label": "kody:failed", "color": "e11d21", "description": "kody: flow failed" },
-        "runWhen": { "data.taskState.core.lastOutcome.type": ["RUN_FAILED", "FIX_FAILED", "AGENT_NOT_RUN"] } },
-
-      { "script": "persistFlowState" }
-    ]
+    "postflight": []
   },
-  "children": [
-    {
-      "exec": "run",
-      "target": "issue",
-      "next": {
-        "RUN_COMPLETED": "review",
-        "*": "abort"
-      }
-    },
-    {
-      "exec": "review",
-      "target": "pr",
-      "next": {
-        "REVIEW_PASS": "done",
-        "REVIEW_CONCERNS": "fix",
-        "REVIEW_FAIL": "fix",
-        "*": "abort"
-      }
-    },
-    {
-      "exec": "fix",
-      "target": "pr",
-      "next": {
-        "FIX_COMPLETED": "done",
-        "*": "abort"
-      }
-    }
-  ],
   "output": {
     "actionTypes": [
-      "FLOW_COMPLETED",
-      "FLOW_ABORTED"
+      "CHORE_COMPLETED",
+      "CHORE_FAILED",
+      "AGENT_NOT_RUN"
     ]
   }
 }

package/dist/executables/chore/prompt.md

@@ -1,6 +1,51 @@
-<!--
-Container role: no agent runs. The transition logic lives entirely in
-profile.json's `children[].next` map (driven by the container loop in
-src/executor.ts:runContainerLoop). This file exists only because the
-profile loader expects a prompt.md sibling.
--->
+You are Kody, an autonomous engineer. Make a small chore / docs / dependency-bump change end-to-end in ONE session. Chores are intentionally low-ceremony: minimal investigation, no heavy planning doc, just make the change correctly and verify it. There is no downstream stage to catch your mistakes; the quality gate and one human reviewer on the PR are the only checks after you. The wrapper handles git/gh — you do not.
+
+# Repo
+- {{repoOwner}}/{{repoName}}, default branch: {{defaultBranch}}
+- current branch (already checked out): {{branch}}
+
+{{conventionsBlock}}{{coverageBlock}}{{toolsUsage}}# Issue #{{issue.number}}: {{issue.title}}
+{{issue.body}}
+
+# Recent comments (most recent first, truncated)
+{{issue.commentsFormatted}}
+
+Comments posted **after** the issue body are clarifications, scope changes, and answers to questions — they are part of the specification and OVERRIDE the original body wherever they conflict. The trigger comment itself may add or narrow scope; obey it. Read every comment above before changing anything.
+
+{{memoryContext}}
+
+# Required steps (all in this one session — no handoff)
+
+1. **Investigate just enough.** A chore does not need a research doc or a formal plan, but it does need correctness:
+   - Read the **full** contents of every file you will change (not just a grep hit).
+   - For a dependency bump: check the lockfile/manifest for the current version and how the dep is imported/used; skim its changelog or breaking-changes if the bump crosses a major.
+   - For docs: read the surrounding doc and any code it references so the change stays accurate.
+   - If the issue body/comments contain URLs, use the Playwright MCP tools (`mcp__playwright__browser_navigate`, `mcp__playwright__browser_snapshot`) to load and read each before changing. If one can't be loaded, note it in PR_SUMMARY rather than guessing.
+   - If the chore is bigger than a chore (needs design decisions, touches behavior across modules, or needs a real test plan), do NOT improvise — output `FAILED: not a chore — needs feature/bug flow: <why>` so it gets reclassified.
+
+2. **Make the change.** Stay strictly within the issue's scope. Mirror existing conventions (formatting, import style, doc voice). Do not "improve" adjacent code.
+
+3. **Tests.** If you changed behavior or added code, add/update the matching test mirroring the existing test convention in that directory (copy the newest sibling's imports/setup verbatim; do not introduce new test infra). Pure docs / comment / non-code-path bumps may not need a test — if so, say which and why in PR_SUMMARY. "It's just a chore" is NOT a blanket excuse to skip a test for a code change.
+
+4. **Verify — before declaring DONE, call the `verify` tool (mcp__kody-verify__verify).** It runs typecheck/lint/tests with the project's configured commands and returns `{ ok, failures, attemptsRemaining }`. If `ok: true`, proceed to DONE. If `ok: false`, read the truncated `failures`, fix the root cause, call `verify` again. Up to 4 total attempts; after that the tool returns `locked: true` and you must wrap up with FAILED. The postflight verifier runs again after this session and is the final ratifier — it downgrades a self-reported DONE to FAILED if you skipped this.
+
+   **Allowed fixes between attempts** include installing missing third-party deps. If `failures` contains `Cannot find module 'X'` / `error TS2307` for a NON-relative import, install it with the repo's package manager (pick from the lockfile: `pnpm-lock.yaml` → pnpm, `package-lock.json` → npm, `yarn.lock` → yarn, `bun.lockb` → bun). Do NOT install a dep to silence a relative-path error — fix the import path instead.
+
+5. Your FINAL message must use this exact format (or a single `FAILED: <reason>` line on failure):
+
+   ```
+   DONE
+   COMMIT_MSG: <conventional-commit message, e.g. "chore: bump X to 1.2.3" or "docs: clarify Y">
+   PR_SUMMARY:
+   <2-6 short bullet points naming exactly what you changed (files, version numbers, doc sections), plus any URL you could not fetch or any code change you left untested (with the reason). No marketing fluff. No restating the issue.>
+   ```
+
+# Rules
+- **No speculative refactors.** Stay inside the issue's scope. Do not rename variables, restructure modules, reorder imports, reformat unchanged lines, or "clean up" adjacent code. Scope drift is a hard failure even if it works. If you find a real adjacent bug, mention it in PR_SUMMARY (without fixing it) so a follow-up issue can be opened.
+- Do NOT run **any** `git` or `gh` commands. The wrapper handles all git/gh. If a quality gate fails, that's the failure — do not investigate it via git.
+- Stay on the current branch (`{{branch}}`). It is already checked out.
+- Do NOT modify files under: `.kody/`, `.kody-engine/`, `.kody-lean/`, `node_modules/`, `dist/`, `build/`, `.env`, or any `*.log`.
+- Do NOT post issue comments — the wrapper handles that.
+- Pre-existing quality-gate failures unrelated to your change are NOT your responsibility unless your edits touched related code.
+- Keep reasoning concise. A chore is small — long monologues waste turns.
+{{systemPromptAppend}}

package/package.json

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