@kody-ade/kody-engine 0.2.1 → 0.2.3

package/dist/executables/build/profile.json

@@ -73,11 +73,12 @@
     ],
     "postflight": [
       { "script": "parseAgentResult" },
-      { "script": "verify" },
-      { "script": "checkCoverageWithRetry" },
+      { "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": "postIssueComment" },
+      { "script": "writeRunSummary" }
     ]
   }
 }

package/dist/executables/types.ts

@@ -7,8 +7,8 @@
  * (build, review, plan, etc.) — it only executes what the profile declares.
  */
 
-import type { Kody2Config } from "../config.js"
 import type { AgentResult } from "../agent.js"
+import type { Kody2Config } from "../config.js"
 
 // ────────────────────────────────────────────────────────────────────────────
 // Profile shape (mirrors the JSON on disk).
@@ -144,11 +144,7 @@ export interface Context {
 
 export type PreflightScript = (ctx: Context, profile: Profile) => Promise<void>
 
-export type PostflightScript = (
-  ctx: Context,
-  profile: Profile,
-  agentResult: AgentResult | null,
-) => Promise<void>
+export type PostflightScript = (ctx: Context, profile: Profile, agentResult: AgentResult | null) => Promise<void>
 
 /** A registered script may be either phase; registry looks it up by name. */
 export type AnyScript = PreflightScript | PostflightScript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "kody2 — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,19 +12,11 @@
     "templates",
     "kody.config.schema.json"
   ],
-  "scripts": {
-    "kody2": "tsx bin/kody2.ts",
-    "build": "tsup && node -e \"require('fs').cpSync('src/executables', 'dist/executables', { recursive: true })\"",
-    "test": "vitest run tests --no-coverage",
-    "test:e2e": "vitest run e2e --no-coverage",
-    "test:all": "vitest run tests e2e --no-coverage",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "pnpm build"
-  },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "0.2.92"
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.4.12",
     "@types/node": "^22.5.4",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
@@ -39,5 +31,16 @@
     "url": "git+https://github.com/aharonyaircohen/kody-engine.git"
   },
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
-  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
-}
+  "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 })\"",
+    "test": "vitest run tests/unit tests/int --no-coverage",
+    "test:e2e": "vitest run tests/e2e --no-coverage",
+    "test:all": "vitest run tests --no-coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "format": "biome format --write"
+  }
+}

package/templates/kody2.yml

@@ -1,17 +1,22 @@
 # Drop this file at .github/workflows/kody2.yml in your repo.
 #
-# Triggers: @kody2 comment on an issue, or manual workflow_dispatch.
+# Triggers: @kody2 comment on an issue or PR, or manual workflow_dispatch.
 # Everything else (install deps, set up LiteLLM, run the agent, open the PR)
-# is handled inside the @kody-ade/engine package. This template should
+# is handled inside the @kody-ade/kody-engine package. This template should
 # rarely need editing — future kody2 capabilities ship via npm publish.
 #
 # Required repo secrets: at least one model provider key (e.g. MINIMAX_API_KEY,
 # ANTHROPIC_API_KEY). kody2 reads any *_API_KEY secret automatically via
 # toJSON(secrets) — no need to list them here.
 #
-# Optional: KODY_TOKEN secret — a PAT or GitHub App token. Needed only if
-# you want kody2's pushes to trigger downstream workflows. Without it,
-# github.token works fine for the PR/commit itself but won't fire other CI.
+# Recommended: KODY_TOKEN secret — a fine-grained PAT or GitHub App token
+# with `repo` + `read:org` scopes. Without it, kody2's commits/PR-creation
+# still work via github.token, but two things degrade:
+#   1. PR body updates fail with "token lacks read:org scope" (cosmetic,
+#      surfaces as warnings in logs; the PR itself is still created/updated).
+#   2. Pushes from kody2 won't trigger downstream workflows (github.token
+#      pushes are deliberately blocked from re-triggering CI).
+# Set KODY_TOKEN in repo Settings → Secrets → Actions.
 
 name: kody2
 
@@ -27,10 +32,14 @@ on:
 
 jobs:
   run:
+    # Skip bot-authored comments (e.g. kody2-bot's own status posts) so we
+    # don't loop the workflow on our own output.
     if: >-
       ${{ github.event_name == 'workflow_dispatch' ||
           (github.event_name == 'issue_comment' &&
-            contains(github.event.comment.body, '@kody2')) }}
+            contains(github.event.comment.body, '@kody2') &&
+            github.event.comment.user.login != 'kody2-bot' &&
+            github.event.comment.user.type != 'Bot') }}
     runs-on: ubuntu-latest
     timeout-minutes: 60
     permissions: