@kody-ade/kody-engine 0.4.346 → 0.4.347

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.346",
+      version: "0.4.347",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
       license: "MIT",
       type: "module",
@@ -1905,11 +1905,10 @@ function readCapabilityFolder(root, slug2) {
 }
 function parseCapabilityConfig(raw) {
   const tools = stringList(raw.tools ?? raw.capabilityTools ?? raw.capabilityTools);
-  const implementations = stringList(raw.implementations ?? raw.executables);
+  const implementations = stringList(raw.implementations);
   return {
     action: stringField(raw.action),
-    implementation: stringField(raw.implementation ?? raw.executable),
-    executable: stringField(raw.executable),
+    implementation: stringField(raw.implementation),
     tickScript: stringField(raw.tickScript),
     capabilityKind: parseCapabilityKind(raw.capabilityKind),
     disabled: typeof raw.disabled === "boolean" ? raw.disabled : void 0,
@@ -1921,7 +1920,6 @@ function parseCapabilityConfig(raw) {
     capabilityTools: tools,
     capabilityToolMode: parseCapabilityToolMode(raw.capabilityToolMode),
     implementations,
-    executables: stringList(raw.executables),
     role: stringField(raw.role),
     describe: stringField(raw.describe),
     stage: stringField(raw.stage),
@@ -1985,7 +1983,7 @@ function parseWorkflowStep(value) {
   const raw = value;
   const capability = stringField(raw.capability ?? raw.action);
   if (!capability || !isSafeSlug(capability)) return null;
-  const implementation = stringField(raw.implementation ?? raw.executable);
+  const implementation = stringField(raw.implementation);
   const action = stringField(raw.action);
   const agent = stringField(raw.agent);
   const reason = stringField(raw.reason);
@@ -1994,7 +1992,7 @@ function parseWorkflowStep(value) {
   return {
     capability,
     ...action && isSafeSlug(action) ? { action } : {},
-    ...implementation && isSafeSlug(implementation) ? { implementation, executable: implementation } : {},
+    ...implementation && isSafeSlug(implementation) ? { implementation } : {},
     ...target === "issue" || target === "pr" ? { target } : {},
     ...agent && isSafeSlug(agent) ? { agent } : {},
     ...reason ? { reason } : {},
@@ -2296,10 +2294,10 @@ function getCapabilityActionInputs(action) {
 function resolveCapabilityExecution(capability) {
   const firstWorkflowStep = capability.config.workflow?.steps[0];
   if (firstWorkflowStep) {
-    const implementation2 = firstWorkflowStep.implementation ?? firstWorkflowStep.executable ?? firstWorkflowStep.capability;
+    const implementation2 = firstWorkflowStep.implementation ?? firstWorkflowStep.capability;
     return { implementation: implementation2, executable: implementation2, cliArgs: {} };
   }
-  const implementation = capability.config.implementation ?? capability.config.executable ?? capability.config.implementations?.[0] ?? capability.config.executables?.[0] ?? (capability.config.role ? capability.slug : void 0) ?? (capability.config.tickScript ? "capability-tick-scripted" : "capability-tick");
+  const implementation = capability.config.implementation ?? capability.config.implementations?.[0] ?? (capability.config.role ? capability.slug : void 0) ?? (capability.config.tickScript ? "capability-tick-scripted" : "capability-tick");
   const cliArgs = executableDeclaresInput(implementation, "capability") ? { capability: capability.slug } : {};
   return { implementation, executable: implementation, cliArgs };
 }
@@ -2363,7 +2361,7 @@ function listFolderCapabilityActions(root, source) {
 }
 function hasUnresolvedExplicitImplementation(capability, executable) {
   const config = capability.config;
-  const hasExplicitImplementation = Boolean(config.implementation || config.executable) || (config.implementations?.length ?? 0) > 0 || (config.executables?.length ?? 0) > 0;
+  const hasExplicitImplementation = Boolean(config.implementation) || (config.implementations?.length ?? 0) > 0;
   if (!hasExplicitImplementation) return false;
   if (config.workflow?.steps.length) return false;
   if (config.role && PUBLIC_EXECUTABLE_ROLES.has(config.role)) return false;
@@ -2377,7 +2375,7 @@ function listBuiltinCapabilityActions(root = getBuiltinCapabilitiesRoot()) {
     const capability = readCapabilityFolder(root, slug2);
     if (!capability) continue;
     const action = capability.config.action ?? slug2;
-    const implementation = capability.config.implementation ?? capability.config.executable ?? slug2;
+    const implementation = capability.config.implementation ?? slug2;
     out.push({
       action,
       capability: slug2,
@@ -4455,11 +4453,11 @@ function loadProfile(profilePath) {
 `
     );
   }
-  const execRef = typeof r.implementation === "string" && r.implementation.trim() ? r.implementation.trim() : typeof r.executable === "string" ? r.executable.trim() : "";
+  const execRef = typeof r.implementation === "string" && r.implementation.trim() ? r.implementation.trim() : "";
   if (execRef) {
     const refPath = resolveExecutable(execRef);
     if (!refPath) {
-      throw new ProfileError(profilePath, `capability references unknown executable '${execRef}'`);
+      throw new ProfileError(profilePath, `capability references unknown implementation '${execRef}'`);
     }
     if (path19.resolve(refPath) === path19.resolve(profilePath)) {
     } else {
@@ -4469,7 +4467,6 @@ function loadProfile(profilePath) {
         name: requireString(profilePath, r, "name"),
         action: typeof r.action === "string" && r.action.trim() ? r.action.trim() : void 0,
         implementation: execRef,
-        executable: execRef,
         internal: typeof r.internal === "boolean" ? r.internal : base.internal,
         public: typeof r.public === "boolean" ? r.public : base.public,
         capabilityKind: parseCapabilityKind2(r.capabilityKind) ?? base.capabilityKind,
@@ -4523,7 +4520,6 @@ function loadProfile(profilePath) {
     name: requireString(profilePath, r, "name"),
     action: typeof r.action === "string" && r.action.trim() ? r.action.trim() : void 0,
     implementation: void 0,
-    executable: void 0,
     internal: typeof r.internal === "boolean" ? r.internal : void 0,
     public: typeof r.public === "boolean" ? r.public : void 0,
     capabilityKind: parseCapabilityKind2(r.capabilityKind),
@@ -4898,8 +4894,6 @@ var init_profile = __esm({
       "action",
       "implementation",
       "implementations",
-      "executable",
-      "executables",
       "internal",
       "public",
       "capabilityKind",
@@ -7329,8 +7323,7 @@ function planManagedGoalTick(goal) {
     evidence: missing,
     stage: step.stage,
     capability: step.capability,
-    implementation: step.implementation ?? step.executable,
-    executable: step.executable,
+    implementation: step.implementation,
     cliArgs: resolved.cliArgs,
     ...step.saveReport === true ? { saveReport: true } : {}
   };
@@ -7440,8 +7433,7 @@ function asRoute(value) {
       evidence: raw.evidence,
       stage: raw.stage,
       capability: raw.capability,
-      implementation: typeof raw.implementation === "string" ? raw.implementation : typeof raw.executable === "string" ? raw.executable : void 0,
-      executable: typeof raw.executable === "string" ? raw.executable : void 0,
+      implementation: typeof raw.implementation === "string" ? raw.implementation : void 0,
       args: args ?? void 0,
       saveReport: raw.saveReport === true,
       onPending: asRoutePolicy(raw.onPending),
@@ -7981,8 +7973,7 @@ function routeStepForLog(step) {
     evidence: step.evidence,
     stage: step.stage,
     capability: step.capability,
-    implementation: step.implementation ?? step.executable,
-    executable: step.executable,
+    implementation: step.implementation,
     args: step.args,
     saveReport: step.saveReport === true ? true : void 0
   });
@@ -8499,8 +8490,7 @@ function cloneRoute(route) {
     stage: step.stage,
     evidence: step.evidence,
     capability: step.capability,
-    ...step.implementation ? { implementation: step.implementation } : step.executable ? { implementation: step.executable } : {},
-    ...step.executable ? { executable: step.executable } : {},
+    ...step.implementation ? { implementation: step.implementation } : {},
     ...step.args ? { args: structuredClone(step.args) } : {}
   }));
 }
@@ -8519,8 +8509,7 @@ function routeArray(value) {
       stage: raw.stage,
       evidence: raw.evidence,
       capability: raw.capability,
-      implementation: typeof raw.implementation === "string" ? raw.implementation : typeof raw.executable === "string" ? raw.executable : void 0,
-      executable: typeof raw.executable === "string" ? raw.executable : void 0,
+      implementation: typeof raw.implementation === "string" ? raw.implementation : void 0,
       args: raw.args && typeof raw.args === "object" && !Array.isArray(raw.args) ? { ...raw.args } : void 0
     });
   }
@@ -8567,20 +8556,18 @@ var init_typeDefinitions = __esm({
         evidence: ["planReady", "changeImplemented", "changeVerified"],
         capabilities: ["plan", "fix", "review"],
         route: [
-          { stage: "plan", evidence: "planReady", capability: "plan", implementation: "plan", executable: "plan" },
+          { stage: "plan", evidence: "planReady", capability: "plan", implementation: "plan" },
           {
             stage: "implement",
             evidence: "changeImplemented",
             capability: "fix",
-            implementation: "fix",
-            executable: "fix"
+            implementation: "fix"
           },
           {
             stage: "review",
             evidence: "changeVerified",
             capability: "review",
-            implementation: "review",
-            executable: "review"
+            implementation: "review"
           }
         ]
       },
@@ -8614,7 +8601,6 @@ var init_typeDefinitions = __esm({
             evidence: "releasePrExists",
             capability: "release",
             implementation: "release-prepare",
-            executable: "release-prepare",
             args: { issue: { fact: "issue" }, goal: { fact: "goalId" } }
           },
           {
@@ -8622,15 +8608,13 @@ var init_typeDefinitions = __esm({
             evidence: "mainMerged",
             capability: "release-merge",
             implementation: "release-merge",
-            executable: "release-merge",
             args: { pr: { fact: "releasePr" }, issue: { fact: "issue" }, goal: { fact: "goalId" } }
           },
           {
             stage: "publish",
             evidence: "productionDeployed",
             capability: "vercel-production-deploy",
-            implementation: "vercel-production-deploy",
-            executable: "vercel-production-deploy"
+            implementation: "vercel-production-deploy"
           }
         ]
       },
@@ -8643,8 +8627,7 @@ var init_typeDefinitions = __esm({
             stage: "verify",
             evidence: "checklistComplete",
             capability: "task-verifier",
-            implementation: "task-verifier",
-            executable: "task-verifier"
+            implementation: "task-verifier"
           }
         ]
       }
@@ -9153,12 +9136,12 @@ async function describeCapabilitySchedule(capability, slug2, backend, previous)
   if (!config.agent || config.agent.trim().length === 0) {
     return { slug: slug2, title: capability.title, state: "blocked", reason: "no agent assigned" };
   }
-  if (config.executables && config.executables.length > 1) {
+  if (config.implementations && config.implementations.length > 1) {
     return {
       slug: slug2,
       title: capability.title,
       state: "blocked",
-      reason: "multi-executable capability needs task-jobs route"
+      reason: "multi-implementation capability needs task-jobs route"
     };
   }
   let lastFiredAt = validIso(previous?.lastFiredAt) ? previous?.lastFiredAt : void 0;
@@ -9282,7 +9265,7 @@ function stageManagedGoalDecision(data, goalId, goal, goalState, decision, detai
       } : {
         capability: decision.capability,
         cliArgs: decision.cliArgs,
-        ...decision.executable ? { executable: decision.executable } : {}
+        ...decision.implementation ? { implementation: decision.implementation } : {}
       },
       goal: details.goalSnapshot,
       inspection: details.inspection,
@@ -9298,7 +9281,7 @@ function stageManagedGoalDecision(data, goalId, goal, goalState, decision, detai
         stage: decision.stage,
         capability: decision.capability,
         cliArgs: decision.cliArgs,
-        ...decision.executable ? { executable: decision.executable } : {}
+        ...decision.implementation ? { implementation: decision.implementation } : {}
       },
       change: details.change
     });
@@ -9675,7 +9658,7 @@ var init_advanceManagedGoal = __esm({
       ctx.output.nextDispatch = {
         capability: decision.capability,
         cliArgs: decision.cliArgs,
-        ...decision.executable ? { executable: decision.executable } : {},
+        ...decision.implementation ? { implementation: decision.implementation } : {},
         ...decision.saveReport === true ? { saveReport: true } : {},
         resultTarget: { type: "goal", id: goal.id, evidence: decision.evidence }
       };
@@ -14178,7 +14161,7 @@ var init_loadCapabilityState = __esm({
       ctx.data.jobStateJson = JSON.stringify(loaded.state, null, 2);
       ctx.data.capabilitySlug = slug2;
       ctx.data.capabilityTitle = profile.describe;
-      ctx.data.executableSlug = profile.implementation ?? profile.executable ?? profile.name;
+      ctx.data.executableSlug = profile.implementation ?? profile.name;
       ctx.data.agentSlug = profile.agent ?? "";
       ctx.data.agentTitle = "";
       ctx.data.capabilitySchedule = String(ctx.data.jobSchedule ?? "");
@@ -19771,8 +19754,8 @@ function jobReferenceBlock(profileName, profile, data) {
     jobId || flavor || schedule || data.jobCapability || data.jobImplementation || data.jobWhy
   );
   if (!isJob2) return null;
-  const capability = typeof data.jobCapability === "string" && data.jobCapability.length > 0 ? data.jobCapability : profile.executable ? profile.name : null;
-  const implementation = typeof profile.implementation === "string" && profile.implementation.length > 0 ? profile.implementation : typeof profile.executable === "string" && profile.executable.length > 0 ? profile.executable : typeof data.jobImplementation === "string" && data.jobImplementation.length > 0 ? data.jobImplementation : profileName;
+  const capability = typeof data.jobCapability === "string" && data.jobCapability.length > 0 ? data.jobCapability : profile.implementation ? profile.name : null;
+  const implementation = typeof profile.implementation === "string" && profile.implementation.length > 0 ? profile.implementation : typeof data.jobImplementation === "string" && data.jobImplementation.length > 0 ? data.jobImplementation : profileName;
   const agent = typeof profile.agent === "string" && profile.agent.length > 0 ? profile.agent : typeof data.jobAgent === "string" && data.jobAgent.length > 0 ? data.jobAgent : null;
   const description = profile.describe.trim();
   const workflow = typeof data.workflowCapability === "string" && data.workflowCapability.length > 0 ? data.workflowCapability : null;
@@ -20820,7 +20803,7 @@ async function runJob(job, base) {
   }
   const workflow = capabilityContext?.config.workflow ?? workflowContext?.config.workflow;
   const workflowIdentity = valid.workflow ?? capabilityIdentity ?? workflowContext?.slug;
-  const capabilitySelectedImplementation = resolvedCapability?.implementation ?? capabilityContext?.config.implementation ?? capabilityContext?.config.executable ?? capabilityContext?.config.implementations?.[0] ?? capabilityContext?.config.executables?.[0] ?? (capabilityContext?.config.role ? capabilityContext.slug : void 0) ?? (capabilityContext?.config.tickScript ? "capability-tick-scripted" : void 0);
+  const capabilitySelectedImplementation = resolvedCapability?.implementation ?? capabilityContext?.config.implementation ?? capabilityContext?.config.implementations?.[0] ?? (capabilityContext?.config.role ? capabilityContext.slug : void 0) ?? (capabilityContext?.config.tickScript ? "capability-tick-scripted" : void 0);
   const profileName = explicitImplementation ?? capabilitySelectedImplementation;
   if (workflow && shouldRunCapabilityWorkflow(valid, workflow, workflowIdentity, capabilitySelectedImplementation, base)) {
     const workflowCapability = capabilityContext ?? workflowContext;
@@ -21003,7 +20986,6 @@ function workflowStepToJob(step, parent, chainData) {
     action,
     capability: step.capability,
     ...step.implementation ? { implementation: step.implementation } : {},
-    ...step.executable ? { executable: step.executable } : {},
     ...composeStepWhy(parent.why, step) ? { why: composeStepWhy(parent.why, step) } : {},
     ...step.agent ?? parent.agent ? { agent: step.agent ?? parent.agent } : {},
     ...parent.schedule ? { schedule: parent.schedule } : {},
@@ -22942,7 +22924,7 @@ async function runCi(argv) {
         action: route.action,
         capability: route.capability,
         workflow: route.workflow,
-        implementation: route.implementation ?? route.executable,
+        implementation: route.implementation,
         cliArgs: { ...route.cliArgs, ...forceRunCliArgs },
         flavor: "instant",
         force: true

package/dist/executables/types.ts

@@ -1,5 +1,5 @@
 /**
- * Types shared by the generic executor and executables.
+ * Types shared by the generic executor and implementation profiles.
  *
  * The executor reads a Profile, validates the user's CLI args against
  * Profile.inputs, then runs the declared preflight scripts → agent →
@@ -20,42 +20,39 @@ export interface Profile {
   /**
    * Public action name owned by a capability. A user may type `@kody <action>`;
    * dispatch resolves that action to the capability, then the capability selects the
-   * implementation executable. Absent → the capability slug/name is the action.
+   * implementation profile. Absent → the capability slug/name is the action.
    */
   action?: string
   /**
-   * Optional agent this executable runs *as*. When set, the executor
+   * Optional agent this implementation runs *as*. When set, the executor
    * loads hydrated `.kody/agents/<agent>.md` and injects that agent (authoritative
-   * identity) ahead of the executable's own system-prompt append. This is the
-   * unification hook: a "capability" is just an executable + an agent. Absent →
+   * identity) ahead of the implementation's own system-prompt append. This is the
+   * unification hook: a capability can select an implementation + an agent. Absent →
    * runs with no agent (unchanged legacy behaviour). A declared-but-missing
    * agent file is fatal at run time (see src/agents.ts).
    */
   agent?: string
   describe: string
   /**
-   * Semantic role — what this executable IS, not when it runs.
+   * Semantic role — what this implementation IS, not when it runs.
    *   - primitive:    single-step agent executor (flow → agent → verify → commit → PR).
    *   - orchestrator: no-agent, drives primitives via a postflight transition table
    *                   (comment-based, one GHA run per step).
    *   - container:    no-agent, runs declared `children` sequentially in-process
    *                   (one GHA run for the whole flow). Routing is done by per-child
    *                   `next` maps over action types — no @kody comments dispatched.
-   *   - watch:        scheduled observer that inspects repo state and may trigger other executables.
+   *   - watch:        scheduled observer that inspects repo state and may trigger other implementations.
    *   - utility:      no-agent, one-off administrative work (scaffolding, release, etc.).
    *
    * Roles enforce shape at profile-load time and let help/dispatch treat
-   * executables differently by category.
+   * implementations differently by category.
    */
   role: "primitive" | "orchestrator" | "container" | "watch" | "utility"
   /**
    * Capability contract profiles can point at a separate implementation by name.
-   * `executable` remains a legacy alias while old assets migrate.
    */
   implementation?: string
-  executable?: string
   implementations?: string[]
-  executables?: string[]
   /** Hide a capability implementation profile from public action discovery. */
   internal?: boolean
   /** Explicit public-action flag for capability profiles. */
@@ -99,7 +96,7 @@ export interface Profile {
   /** Cron expression for scheduled profiles (e.g. "0 8 * * MON"). */
   schedule?: string
   /**
-   * Task-state phase label emitted when this executable completes successfully.
+   * Task-state phase label emitted when this implementation completes successfully.
    * Failing actions always set phase to "failed" regardless. Omitted → "idle".
    * Lets state.ts stay generic — phase semantics live on the profile.
    */
@@ -115,7 +112,7 @@ export interface Profile {
    *
    * 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`
+   * implementations. Per-implementation specifics still go in `scripts.preflight`
    * and `scripts.postflight` — the lifecycle wraps them, it doesn't
    * replace them.
    */
@@ -131,14 +128,14 @@ export interface Profile {
   }
   outputContract?: OutputContract
   /**
-   * Declared artifacts consumed by this executable. The resolveArtifacts
+   * Declared artifacts consumed by this implementation. The resolveArtifacts
    * preflight loads each into ctx.data.artifacts[name] from the task-state
-   * comment. If `required: true` and the artifact is absent, the executable
+   * comment. If `required: true` and the artifact is absent, the implementation
    * fails fast.
    */
   inputArtifacts: InputArtifactSpec[]
   /**
-   * Declared artifacts produced by this executable. The persistArtifacts
+   * Declared artifacts produced by this implementation. The persistArtifacts
    * postflight reads the named source field from ctx.data and writes an
    * Artifact entry into the task state's `artifacts` map.
    */

package/package.json

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