@kody-ade/kody-engine 0.4.469 → 0.4.470

package/dist/bin/kody.js

@@ -15,7 +15,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@kody-ade/kody-engine",
-      version: "0.4.469",
+      version: "0.4.470",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -1730,9 +1730,7 @@ function parseCapabilityContract(raw) {
   if (parsed.execution !== void 0 && parsed.execution !== "agent" && parsed.execution !== "script") {
     throw new Error('contract.json execution must be "agent" or "script"');
   }
-  const unsupported = Object.keys(parsed).filter(
-    (key) => key !== "execution" && key !== "input" && key !== "output"
-  );
+  const unsupported = Object.keys(parsed).filter((key) => key !== "execution" && key !== "input" && key !== "output");
   if (unsupported.length > 0) {
     throw new Error(`contract.json contains unsupported fields: ${unsupported.join(", ")}`);
   }
@@ -13141,11 +13139,14 @@ function emptyCatalog() {
 function addDefinition(catalog, document) {
   if (document.schemaVersion !== 1) throw new Error(`Unsupported Agency Definition schema: ${document.schemaVersion}`);
   if (document.kind === "intent") add(catalog.intents, createIntentDefinition(document.data), document.recordId);
-  else if (document.kind === "operation") add(catalog.operations, createOperationDefinition(document.data), document.recordId);
+  else if (document.kind === "operation")
+    add(catalog.operations, createOperationDefinition(document.data), document.recordId);
   else if (document.kind === "goal") add(catalog.goals, createGoalDefinition(document.data), document.recordId);
   else if (document.kind === "loop") add(catalog.loops, createLoopDefinition(document.data), document.recordId);
-  else if (document.kind === "workflow") add(catalog.workflows, createWorkflowDefinition(document.data), document.recordId);
-  else if (document.kind === "capability") add(catalog.capabilities, createCapabilityDefinition(document.data), document.recordId);
+  else if (document.kind === "workflow")
+    add(catalog.workflows, createWorkflowDefinition(document.data), document.recordId);
+  else if (document.kind === "capability")
+    add(catalog.capabilities, createCapabilityDefinition(document.data), document.recordId);
   else add(catalog.agents, createAgentDefinition(document.data), document.recordId);
 }
 function add(collection, definition, revision) {
@@ -13191,19 +13192,23 @@ var init_agencyModelRepository = __esm({
       async listManagedWork(catalog) {
         const definitions = catalog ?? await this.loadCatalog();
         const managed = [
-          ...Array.from(definitions.goals.values(), ({ definition, revision }) => ({ definition, revision, kind: "goal" })),
-          ...Array.from(definitions.loops.values(), ({ definition, revision }) => ({ definition, revision, kind: "loop" }))
+          ...Array.from(definitions.goals.values(), ({ definition, revision }) => ({
+            definition,
+            revision,
+            kind: "goal"
+          })),
+          ...Array.from(definitions.loops.values(), ({ definition, revision }) => ({
+            definition,
+            revision,
+            kind: "loop"
+          }))
         ];
         return Promise.all(
           managed.map(async (record2) => ({
             definition: record2.definition,
             revision: record2.revision,
             state: parseState(
-              await this.backend.getAgencyState(
-                this.tenantId,
-                record2.kind,
-                record2.definition.id
-              ),
+              await this.backend.getAgencyState(this.tenantId, record2.kind, record2.definition.id),
               record2.definition,
               record2.kind
             )
@@ -13249,11 +13254,7 @@ var init_agencyModelRepository = __esm({
         const state = createGoalState({
           definitionId: record2.definition.id,
           lifecycle: previous?.lifecycle ?? "draft",
-          progress: goalProgressFromOutputs(
-            record2.definition,
-            record2.revision,
-            await this.listOutputs()
-          ),
+          progress: goalProgressFromOutputs(record2.definition, record2.revision, await this.listOutputs()),
           blockers: previous?.blockers ?? [],
           updatedAt
         });
@@ -13264,56 +13265,6 @@ var init_agencyModelRepository = __esm({
   }
 });
 
-// src/goal/triggerDispatcher.ts
-function decideTrigger(input) {
-  if (!input.state) return { kind: "skip", reason: "loop has no runtime state" };
-  if (input.state.lifecycle !== "active") {
-    return { kind: "skip", reason: `loop is ${input.state.lifecycle}` };
-  }
-  const trigger = input.definition.trigger;
-  if (input.manualRequestId?.trim()) {
-    return {
-      kind: "fire",
-      reason: "manual trigger was requested",
-      scheduledAt: input.now.toISOString(),
-      idempotencyKey: `${input.definition.id}:manual:${input.manualRequestId.trim()}`
-    };
-  }
-  if (trigger.type === "manual") {
-    return { kind: "skip", reason: "manual trigger was not requested" };
-  }
-  if (trigger.type !== "schedule") {
-    return { kind: "skip", reason: `${trigger.type} trigger is not enabled yet` };
-  }
-  const interval = parseInterval(trigger.every);
-  const anchor = input.state.lastFiredAt ? Date.parse(input.state.lastFiredAt) : input.now.getTime() - interval;
-  const dueAt = anchor + interval;
-  if (input.now.getTime() < dueAt) {
-    return { kind: "skip", reason: "scheduled trigger is not due", nextEligibleAt: new Date(dueAt).toISOString() };
-  }
-  const elapsedIntervals = Math.max(1, Math.floor((input.now.getTime() - anchor) / interval));
-  const scheduledAt = new Date(anchor + elapsedIntervals * interval).toISOString();
-  return {
-    kind: "fire",
-    reason: "scheduled trigger is due",
-    scheduledAt,
-    idempotencyKey: `${input.definition.id}:schedule:${scheduledAt}`
-  };
-}
-function parseInterval(value) {
-  const match = value.trim().match(/^(\d+)(m|h|d)$/);
-  if (!match) throw new Error(`Unsupported schedule interval: ${value}`);
-  const amount = Number(match[1]);
-  if (!Number.isSafeInteger(amount) || amount < 1) throw new Error(`Unsupported schedule interval: ${value}`);
-  const unit = match[2] === "m" ? 6e4 : match[2] === "h" ? 36e5 : 864e5;
-  return amount * unit;
-}
-var init_triggerDispatcher = __esm({
-  "src/goal/triggerDispatcher.ts"() {
-    "use strict";
-  }
-});
-
 // src/goal/policyResolver.ts
 import { createHash as createHash5 } from "crypto";
 function resolveDispatchPolicy(input) {
@@ -13338,10 +13289,7 @@ function resolveDispatchPolicy(input) {
     },
     operation,
     intents,
-    trace: [
-      pinned("trigger" in input.owner.definition ? "loop" : "goal", input.owner),
-      input.target
-    ],
+    trace: [pinned("trigger" in input.owner.definition ? "loop" : "goal", input.owner), input.target],
     requiresApproval
   };
 }
@@ -13402,6 +13350,56 @@ var init_policyResolver = __esm({
   }
 });
 
+// src/goal/triggerDispatcher.ts
+function decideTrigger(input) {
+  if (!input.state) return { kind: "skip", reason: "loop has no runtime state" };
+  if (input.state.lifecycle !== "active") {
+    return { kind: "skip", reason: `loop is ${input.state.lifecycle}` };
+  }
+  const trigger = input.definition.trigger;
+  if (input.manualRequestId?.trim()) {
+    return {
+      kind: "fire",
+      reason: "manual trigger was requested",
+      scheduledAt: input.now.toISOString(),
+      idempotencyKey: `${input.definition.id}:manual:${input.manualRequestId.trim()}`
+    };
+  }
+  if (trigger.type === "manual") {
+    return { kind: "skip", reason: "manual trigger was not requested" };
+  }
+  if (trigger.type !== "schedule") {
+    return { kind: "skip", reason: `${trigger.type} trigger is not enabled yet` };
+  }
+  const interval = parseInterval(trigger.every);
+  const anchor = input.state.lastFiredAt ? Date.parse(input.state.lastFiredAt) : input.now.getTime() - interval;
+  const dueAt = anchor + interval;
+  if (input.now.getTime() < dueAt) {
+    return { kind: "skip", reason: "scheduled trigger is not due", nextEligibleAt: new Date(dueAt).toISOString() };
+  }
+  const elapsedIntervals = Math.max(1, Math.floor((input.now.getTime() - anchor) / interval));
+  const scheduledAt = new Date(anchor + elapsedIntervals * interval).toISOString();
+  return {
+    kind: "fire",
+    reason: "scheduled trigger is due",
+    scheduledAt,
+    idempotencyKey: `${input.definition.id}:schedule:${scheduledAt}`
+  };
+}
+function parseInterval(value) {
+  const match = value.trim().match(/^(\d+)(m|h|d)$/);
+  if (!match) throw new Error(`Unsupported schedule interval: ${value}`);
+  const amount = Number(match[1]);
+  if (!Number.isSafeInteger(amount) || amount < 1) throw new Error(`Unsupported schedule interval: ${value}`);
+  const unit = match[2] === "m" ? 6e4 : match[2] === "h" ? 36e5 : 864e5;
+  return amount * unit;
+}
+var init_triggerDispatcher = __esm({
+  "src/goal/triggerDispatcher.ts"() {
+    "use strict";
+  }
+});
+
 // src/scripts/dispatchAgencyLoops.ts
 import { randomUUID } from "crypto";
 import {
@@ -13469,10 +13467,7 @@ async function dispatchAgencyLoopsWith(input) {
       { length: Math.max(0, maxAttempts - 1) },
       (_, index) => failurePolicy.backoffSeconds * 2 ** index
     ).reduce((sum, seconds) => sum + seconds, 0);
-    const leaseSeconds = Math.min(
-      budget.maxDurationSeconds,
-      maxAttempts * timeoutSeconds + backoffBudgetSeconds
-    );
+    const leaseSeconds = Math.min(budget.maxDurationSeconds, maxAttempts * timeoutSeconds + backoffBudgetSeconds);
     const leaseUntil = new Date(input.now.getTime() + leaseSeconds * 1e3).toISOString();
     const reservationId = `reservation-${randomUUID()}`;
     const correlationId = `corr-${randomUUID()}`;
@@ -13730,8 +13725,8 @@ var init_dispatchAgencyLoops = __esm({
   "src/scripts/dispatchAgencyLoops.ts"() {
     "use strict";
     init_agencyModelRepository();
-    init_triggerDispatcher();
     init_policyResolver();
+    init_triggerDispatcher();
     init_job();
     init_state_backend();
     dispatchAgencyLoops = async (ctx) => {
@@ -14108,8 +14103,8 @@ var dispatchSimpleLoops;
 var init_dispatchSimpleLoops = __esm({
   "src/scripts/dispatchSimpleLoops.ts"() {
     "use strict";
-    init_loopDefinitions();
     init_job();
+    init_loopDefinitions();
     init_state_backend();
     dispatchSimpleLoops = async (ctx) => {
       const tenantId2 = repositoryTenant2(ctx.config);
@@ -14121,10 +14116,8 @@ var init_dispatchSimpleLoops = __esm({
         force,
         ...requestedLoopId ? { loopId: requestedLoopId } : {}
       });
-      process.stdout.write(
-        `\u2192 kody: Loop scheduler found ${due.length} runnable Loop(s)${force ? " (manual)" : ""}
-`
-      );
+      process.stdout.write(`\u2192 kody: Loop scheduler found ${due.length} runnable Loop(s)${force ? " (manual)" : ""}
+`);
       const backend = createStateBackendFromEnv();
       const results = [];
       for (const loop of due) {
@@ -14169,10 +14162,8 @@ var init_dispatchSimpleLoops = __esm({
         results.push({ loopId: loop.id, status, reason: result.reason ?? status });
       }
       for (const result of results) {
-        process.stdout.write(
-          `\u2192 kody: Loop ${result.loopId} ${result.status}: ${result.reason}
-`
-        );
+        process.stdout.write(`\u2192 kody: Loop ${result.loopId} ${result.status}: ${result.reason}
+`);
       }
       ctx.data.simpleLoopDispatchResults = results;
     };
@@ -19741,76 +19732,12 @@ var init_runScheduledImplementationTick = __esm({
   }
 });
 
-// src/scripts/runTickScript.ts
-import * as fs47 from "fs";
-import * as path45 from "path";
-var runTickScript;
-var init_runTickScript = __esm({
-  "src/scripts/runTickScript.ts"() {
-    "use strict";
-    init_capabilityFolders();
-    init_definition_paths();
-    init_jobState();
-    init_tickShellRunner();
-    runTickScript = async (ctx, _profile, args) => {
-      ctx.skipAgent = true;
-      const jobsDir = String(args?.jobsDir ?? capabilitiesRoot(ctx.cwd));
-      const slugArg = String(args?.slugArg ?? "job");
-      const fenceLabel = String(args?.fenceLabel ?? "kody-job-next-state");
-      const slug = String(ctx.args[slugArg] ?? "").trim();
-      if (!slug) {
-        ctx.output.exitCode = 99;
-        ctx.output.reason = `runTickScript: ctx.args.${slugArg} must be a non-empty slug`;
-        return;
-      }
-      const capability = readCapabilityFolder(path45.resolve(ctx.cwd, jobsDir), slug);
-      if (!capability) {
-        ctx.output.exitCode = 99;
-        ctx.output.reason = `runTickScript: capability folder not found or incomplete: ${path45.resolve(ctx.cwd, jobsDir, slug)}`;
-        return;
-      }
-      const tickScript = capability.config.tickScript;
-      if (!tickScript) {
-        ctx.output.exitCode = 99;
-        ctx.output.reason = `runTickScript: capability ${slug} has no \`tickScript\` in profile.json \u2014 route via capability-tick instead`;
-        return;
-      }
-      const scriptPath = path45.isAbsolute(tickScript) ? tickScript : path45.join(ctx.cwd, tickScript);
-      if (!fs47.existsSync(scriptPath)) {
-        ctx.output.exitCode = 99;
-        ctx.output.reason = `runTickScript: tickScript not found: ${scriptPath}`;
-        return;
-      }
-      const backend = resolveBackend({ config: ctx.config, cwd: ctx.cwd, jobsDir });
-      let loaded;
-      try {
-        loaded = await backend.load(slug);
-      } catch (err) {
-        ctx.output.exitCode = 99;
-        ctx.output.reason = `runTickScript: state load failed: ${err instanceof Error ? err.message : String(err)}`;
-        return;
-      }
-      ctx.data.jobSlug = slug;
-      ctx.data.jobState = loaded;
-      runTickShellAndParse({
-        ctx,
-        loaded,
-        scriptPath,
-        displayName: "runTickScript",
-        reasonSubject: tickScript,
-        fenceLabel,
-        force: Boolean(ctx.args.force)
-      });
-    };
-  }
-});
-
 // src/scripts/runSimpleCapabilityScript.ts
 import { spawnSync as spawnSync3 } from "child_process";
-import * as fs48 from "fs";
+import * as fs47 from "fs";
 function isRegularFile2(filePath) {
   try {
-    const stat = fs48.lstatSync(filePath);
+    const stat = fs47.lstatSync(filePath);
     return stat.isFile() && !stat.isSymbolicLink();
   } catch {
     return false;
@@ -19873,6 +19800,70 @@ var init_runSimpleCapabilityScript = __esm({
   }
 });
 
+// src/scripts/runTickScript.ts
+import * as fs48 from "fs";
+import * as path45 from "path";
+var runTickScript;
+var init_runTickScript = __esm({
+  "src/scripts/runTickScript.ts"() {
+    "use strict";
+    init_capabilityFolders();
+    init_definition_paths();
+    init_jobState();
+    init_tickShellRunner();
+    runTickScript = async (ctx, _profile, args) => {
+      ctx.skipAgent = true;
+      const jobsDir = String(args?.jobsDir ?? capabilitiesRoot(ctx.cwd));
+      const slugArg = String(args?.slugArg ?? "job");
+      const fenceLabel = String(args?.fenceLabel ?? "kody-job-next-state");
+      const slug = String(ctx.args[slugArg] ?? "").trim();
+      if (!slug) {
+        ctx.output.exitCode = 99;
+        ctx.output.reason = `runTickScript: ctx.args.${slugArg} must be a non-empty slug`;
+        return;
+      }
+      const capability = readCapabilityFolder(path45.resolve(ctx.cwd, jobsDir), slug);
+      if (!capability) {
+        ctx.output.exitCode = 99;
+        ctx.output.reason = `runTickScript: capability folder not found or incomplete: ${path45.resolve(ctx.cwd, jobsDir, slug)}`;
+        return;
+      }
+      const tickScript = capability.config.tickScript;
+      if (!tickScript) {
+        ctx.output.exitCode = 99;
+        ctx.output.reason = `runTickScript: capability ${slug} has no \`tickScript\` in profile.json \u2014 route via capability-tick instead`;
+        return;
+      }
+      const scriptPath = path45.isAbsolute(tickScript) ? tickScript : path45.join(ctx.cwd, tickScript);
+      if (!fs48.existsSync(scriptPath)) {
+        ctx.output.exitCode = 99;
+        ctx.output.reason = `runTickScript: tickScript not found: ${scriptPath}`;
+        return;
+      }
+      const backend = resolveBackend({ config: ctx.config, cwd: ctx.cwd, jobsDir });
+      let loaded;
+      try {
+        loaded = await backend.load(slug);
+      } catch (err) {
+        ctx.output.exitCode = 99;
+        ctx.output.reason = `runTickScript: state load failed: ${err instanceof Error ? err.message : String(err)}`;
+        return;
+      }
+      ctx.data.jobSlug = slug;
+      ctx.data.jobState = loaded;
+      runTickShellAndParse({
+        ctx,
+        loaded,
+        scriptPath,
+        displayName: "runTickScript",
+        reasonSubject: tickScript,
+        fenceLabel,
+        force: Boolean(ctx.args.force)
+      });
+    };
+  }
+});
+
 // src/scripts/saveManagedGoalState.ts
 var saveManagedGoalState;
 var init_saveManagedGoalState = __esm({
@@ -21116,8 +21107,8 @@ var init_scripts = __esm({
     init_runFlow();
     init_runPreviewBuild();
     init_runScheduledImplementationTick();
-    init_runTickScript();
     init_runSimpleCapabilityScript();
+    init_runTickScript();
     init_saveManagedGoalState();
     init_saveTaskState();
     init_setCommentTarget();
@@ -25463,10 +25454,8 @@ function installLitellmIfNeeded(cwd) {
   if (installCode === 0) return 0;
   try {
     execFileSync24("python3", ["-c", "import litellm"], { stdio: "pipe" });
-    process.stderr.write(
-      `\u2192 kody: pip exited ${installCode}, but litellm is importable; continuing
-`
-    );
+    process.stderr.write(`\u2192 kody: pip exited ${installCode}, but litellm is importable; continuing
+`);
     return 0;
   } catch {
     return installCode;

package/dist/capabilities/init/instructions.md

@@ -0,0 +1,3 @@
+# Initialize Kody
+
+Scaffold the consumer repository configuration and generated GitHub Actions launcher.

package/dist/implementations/init/profile.json

@@ -0,0 +1,36 @@
+{
+  "name": "init",
+  "role": "utility",
+  "describe": "Scaffold a consumer repository with Kody configuration and its generated launcher.",
+  "inputs": [
+    {
+      "name": "force",
+      "flag": "--force",
+      "type": "bool",
+      "required": false,
+      "describe": "Overwrite existing generated files instead of skipping them."
+    }
+  ],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "acceptEdits",
+    "maxTurns": null,
+    "systemPromptAppend": null,
+    "tools": [],
+    "hooks": [],
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [],
+  "scripts": {
+    "preflight": [
+      {
+        "script": "initFlow"
+      }
+    ],
+    "postflight": []
+  }
+}

package/package.json

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

package/templates/kody.yml

@@ -76,8 +76,6 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: "3.12"
-          cache: pip
-          cache-dependency-path: .kody-pip-requirements.txt
 
       - uses: astral-sh/setup-uv@v6