@kody-ade/kody-engine 0.4.64 → 0.4.66

package/dist/executables/bug/profile.json

@@ -1,6 +1,7 @@
 {
   "name": "bug",
   "role": "container",
+  "preloadContext": true,
   "describe": "Bug / enhancement flow — reproduce → plan → run → review (→ fix on concerns/fail). Children run sequentially in one process via the container loop.",
   "inputs": [
     {

package/dist/executables/chore/profile.json

@@ -1,6 +1,7 @@
 {
   "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.",
   "inputs": [
     {

package/dist/executables/feature/profile.json

@@ -1,6 +1,7 @@
 {
   "name": "feature",
   "role": "container",
+  "preloadContext": true,
   "describe": "Feature / refactor flow — research → plan → run → review (→ fix on concerns/fail). Children run sequentially in one process via the container loop.",
   "inputs": [
     {

package/dist/executables/fix/profile.json

@@ -63,37 +63,21 @@
       "usage": ""
     }
   ],
+  "lifecycle": "pr-branch",
+  "lifecycleConfig": {
+    "label": {
+      "name": "kody:fixing",
+      "color": "e99695",
+      "description": "kody: applying review feedback"
+    },
+    "context": "task"
+  },
   "scripts": {
     "preflight": [
-      { "script": "syncFlow" },
-      {
-        "script": "setLifecycleLabel",
-        "with": {
-          "label": "kody:fixing",
-          "color": "e99695",
-          "description": "kody: applying review feedback"
-        }
-      },
-      { "script": "fixFlow" },
-      { "script": "loadTaskState" },
-      { "script": "loadConventions" },
-      { "script": "loadPriorArt" },
-      { "script": "loadMemoryContext" },
-      { "script": "loadCoverageRules" },
-      { "script": "composePrompt" }
+      { "script": "fixFlow" }
     ],
     "postflight": [
-      { "script": "parseAgentResult" },
-      { "script": "requireFeedbackActions" },
-      { "script": "verify" },
-      { "script": "checkCoverageWithRetry" },
-      { "script": "abortUnfinishedGitOps" },
-      { "script": "commitAndPush" },
-      { "script": "ensurePr" },
-      { "script": "postIssueComment" },
-      { "script": "writeRunSummary" },
-      { "script": "saveTaskState" },
-      { "script": "advanceFlow" }
+      { "script": "requireFeedbackActions" }
     ]
   },
   "output": {

package/dist/executables/fix-ci/profile.json

@@ -44,62 +44,21 @@
     "mcpServers": []
   },
   "cliTools": [],
+  "lifecycle": "pr-branch",
+  "lifecycleConfig": {
+    "label": {
+      "name": "kody:fixing",
+      "color": "e99695",
+      "description": "kody: applying review feedback"
+    },
+    "context": "ci-fix",
+    "advance": false
+  },
   "scripts": {
     "preflight": [
-      { "script": "syncFlow" },
-      {
-        "script": "setLifecycleLabel",
-        "with": {
-          "label": "kody:fixing",
-          "color": "e99695",
-          "description": "kody: applying review feedback"
-        }
-      },
-      {
-        "script": "fixCiFlow"
-      },
-      {
-        "script": "loadTaskState"
-      },
-      {
-        "script": "loadConventions"
-      },
-      {
-        "script": "loadCoverageRules"
-      },
-      {
-        "script": "composePrompt"
-      }
+      { "script": "fixCiFlow" }
     ],
-    "postflight": [
-      {
-        "script": "parseAgentResult"
-      },
-      {
-        "script": "verify"
-      },
-      {
-        "script": "checkCoverageWithRetry"
-      },
-      {
-        "script": "abortUnfinishedGitOps"
-      },
-      {
-        "script": "commitAndPush"
-      },
-      {
-        "script": "ensurePr"
-      },
-      {
-        "script": "postIssueComment"
-      },
-      {
-        "script": "writeRunSummary"
-      },
-      {
-        "script": "saveTaskState"
-      }
-    ]
+    "postflight": []
   },
   "output": {
     "actionTypes": [

package/dist/executables/run/profile.json

@@ -44,38 +44,24 @@
     "mcpServers": []
   },
   "cliTools": [],
+  "lifecycle": "pr-branch",
+  "lifecycleConfig": {
+    "label": {
+      "name": "kody:running",
+      "color": "fbca04",
+      "description": "kody: implementing the change"
+    },
+    "context": "task",
+    "contextExtras": ["resolveArtifacts"],
+    "sync": false,
+    "mirrorState": true
+  },
   "scripts": {
     "preflight": [
-      {
-        "script": "setLifecycleLabel",
-        "with": {
-          "label": "kody:running",
-          "color": "fbca04",
-          "description": "kody: implementing the change"
-        }
-      },
-      { "script": "runFlow" },
-      { "script": "loadTaskState" },
-      { "script": "resolveArtifacts" },
-      { "script": "loadPriorArt" },
-      { "script": "loadMemoryContext" },
-      { "script": "loadConventions" },
-      { "script": "loadCoverageRules" },
-      { "script": "composePrompt" }
+      { "script": "runFlow" }
     ],
     "postflight": [
-      { "script": "parseAgentResult" },
-      { "script": "requirePlanDeviations" },
-      { "script": "verify" },
-      { "script": "checkCoverageWithRetry" },
-      { "script": "abortUnfinishedGitOps" },
-      { "script": "commitAndPush" },
-      { "script": "ensurePr" },
-      { "script": "postIssueComment" },
-      { "script": "writeRunSummary" },
-      { "script": "saveTaskState" },
-      { "script": "mirrorStateToPr" },
-      { "script": "advanceFlow" }
+      { "script": "requirePlanDeviations" }
     ]
   },
   "input": {

package/dist/executables/types.ts

@@ -51,6 +51,24 @@ export interface Profile {
   inputs: InputSpec[]
   claudeCode: ClaudeCodeSpec
   cliTools: CliToolSpec[]
+  /**
+   * Optional lifecycle macro. When set, the profile loader applies a
+   * predefined preflight/postflight wrapper around `scripts.preflight` and
+   * `scripts.postflight` before returning the profile. Registry of lifecycles
+   * lives in src/lifecycles/. Unknown values are rejected at load time.
+   *
+   * Lifecycles exist to consolidate orchestration boilerplate (label,
+   * context loading, verify, commit, comment) that recurs across many
+   * executables. Per-executable specifics still go in `scripts.preflight`
+   * and `scripts.postflight` — the lifecycle wraps them, it doesn't
+   * replace them.
+   */
+  lifecycle?: string
+  /**
+   * Lifecycle-specific configuration. Shape depends on `lifecycle`. Validated
+   * by each lifecycle expander, not by the generic profile parser.
+   */
+  lifecycleConfig?: Record<string, unknown>
   scripts: {
     preflight: ScriptEntry[]
     postflight: ScriptEntry[]
@@ -84,6 +102,20 @@ export interface Profile {
    * then makes pass). Only honoured when `role === "container"`.
    */
   resetBetweenChildren?: boolean
+  /**
+   * Phase 5 in-process handoff: when true, the container's loop runs
+   * the shared context loaders (loadConventions, loadPriorArt,
+   * loadMemoryContext, loadCoverageRules) ONCE after its own preflight
+   * completes, then passes the resulting `ctx.data` snapshot to every
+   * child via `ExecutorInput.preloadedData`. Each child's loaders take
+   * their fast path (added in 0.4.63) and skip the redundant
+   * GitHub/filesystem round-trips.
+   *
+   * Default `false` (opt-in) so the change is gated to containers
+   * that have been verified end-to-end. Only honoured when
+   * `role === "container"`.
+   */
+  preloadContext?: boolean
   /** Absolute directory the profile was loaded from. Used to resolve prompt.md. */
   dir: string
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.64",
+  "version": "0.4.66",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,18 +12,6 @@
     "templates",
     "kody.config.schema.json"
   ],
-  "scripts": {
-    "kody": "tsx bin/kody.ts",
-    "build": "tsup && node scripts/copy-assets.cjs",
-    "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",
-    "prepublishOnly": "pnpm build"
-  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
@@ -45,5 +33,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": {
+    "kody": "tsx bin/kody.ts",
+    "build": "tsup && node scripts/copy-assets.cjs",
+    "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"
+  }
+}