@kody-ade/kody-engine 0.4.345 → 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.345",
+      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",
@@ -6534,8 +6528,8 @@ function runIndexRowFromJobContext(input) {
     action: stringValue2(input.data.jobAction) ?? void 0,
     capability: stringValue2(input.data.jobCapability) ?? void 0,
     workflow: workflow ?? void 0,
-    implementation: stringValue2(input.data.jobImplementation) ?? stringValue2(input.data.jobExecutable) ?? input.profileName,
-    executable: stringValue2(input.data.jobExecutable) ?? stringValue2(input.data.jobImplementation) ?? input.profileName,
+    implementation: stringValue2(input.data.jobImplementation) ?? input.profileName,
+    executable: stringValue2(input.data.jobImplementation) ?? input.profileName,
     agent: stringValue2(input.data.jobAgent) ?? input.profile.agent ?? void 0,
     model: stringValue2(input.data.jobModel) ?? void 0,
     modelProvider: stringValue2(input.data.jobModelProvider) ?? void 0,
@@ -6584,8 +6578,8 @@ function runIndexRowFromGoalEvents(goalId, logPath, events) {
     actor: stringValue2(trigger?.githubActor) ?? stringValue2(trigger?.actor) ?? void 0,
     action: stringValue2(job?.action) ?? void 0,
     capability: stringValue2(job?.capability) ?? void 0,
-    implementation: stringValue2(job?.implementation) ?? stringValue2(job?.executable) ?? void 0,
-    executable: stringValue2(job?.executable) ?? stringValue2(job?.implementation) ?? void 0,
+    implementation: stringValue2(job?.implementation) ?? void 0,
+    executable: stringValue2(job?.implementation) ?? void 0,
     agent: stringValue2(job?.agent) ?? void 0,
     model: stringValue2(job?.model) ?? void 0,
     modelProvider: stringValue2(job?.modelProvider) ?? void 0,
@@ -7065,7 +7059,7 @@ function jobMetaFromData(data) {
     schedule: typeof data.jobSchedule === "string" ? data.jobSchedule : void 0,
     runUrl: typeof data.runUrl === "string" ? data.runUrl : void 0,
     capability: typeof data.jobCapability === "string" ? data.jobCapability : void 0,
-    implementation: typeof data.jobImplementation === "string" ? data.jobImplementation : typeof data.jobExecutable === "string" ? data.jobExecutable : void 0,
+    implementation: typeof data.jobImplementation === "string" ? data.jobImplementation : void 0,
     target: typeof data.jobTarget === "number" ? data.jobTarget : void 0,
     agent: typeof data.jobAgent === "string" ? data.jobAgent : void 0,
     why: typeof data.jobWhy === "string" ? data.jobWhy : void 0
@@ -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),
@@ -7905,8 +7897,8 @@ function jobContext(data) {
     flavor: stringValue3(data.jobFlavor) ?? void 0,
     action: stringValue3(data.jobAction) ?? void 0,
     capability: stringValue3(data.jobCapability) ?? void 0,
-    implementation: stringValue3(data.jobImplementation) ?? stringValue3(data.jobExecutable) ?? void 0,
-    executable: stringValue3(data.jobExecutable) ?? void 0,
+    implementation: stringValue3(data.jobImplementation) ?? void 0,
+    executable: stringValue3(data.jobImplementation) ?? void 0,
     agent: stringValue3(data.jobAgent) ?? void 0,
     schedule: stringValue3(data.jobSchedule) ?? void 0,
     target: data.jobTarget ?? void 0,
@@ -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 }
       };
@@ -12782,7 +12765,7 @@ var init_dispatchCapabilityTicks = __esm({
           const out = await runJob(
             mintScheduledJob({
               capability: targetExecutable,
-              executable: targetExecutable,
+              implementation: targetExecutable,
               cliArgs: { [issueArg]: issue.number }
             }),
             { cwd: ctx.cwd, config: ctx.config, verbose: ctx.verbose, quiet: ctx.quiet, chain: false }
@@ -12839,10 +12822,10 @@ var init_dispatchClassified = __esm({
 // src/jobIdentity.ts
 function stableJobKey(job) {
   const capability = job.workflow ?? job.capability ?? job.action;
-  const executable = job.executable ?? capability ?? "unknown";
-  if (job.flavor === "scheduled" && job.capability) return `scheduled:${job.capability}:${executable}`;
+  const implementation = job.implementation ?? capability ?? "unknown";
+  if (job.flavor === "scheduled" && job.capability) return `scheduled:${job.capability}:${implementation}`;
   const target = typeof job.target === "number" ? job.target : targetFromCliArgs(job.cliArgs);
-  const work = capability && executable && executable !== capability ? `${capability}:${executable}` : capability ?? executable;
+  const work = capability && implementation && implementation !== capability ? `${capability}:${implementation}` : capability ?? implementation;
   return target === void 0 ? `${job.flavor}:${work}` : `${job.flavor}:${work}:${target}`;
 }
 function targetFromCliArgs(cliArgs) {
@@ -12865,7 +12848,6 @@ function taskJobToJob(job, issueArg) {
   return {
     capability: job.capability ?? job.implementation,
     implementation: job.implementation,
-    executable: job.implementation,
     ...job.reason ? { why: job.reason } : {},
     ...job.agent ? { agent: job.agent } : {},
     ...job.schedule ? { schedule: job.schedule } : {},
@@ -13231,7 +13213,7 @@ var init_failOnceTaskJob = __esm({
       const issue = typeof ctx.args.issue === "number" ? ctx.args.issue : void 0;
       const fallbackJob = {
         capability: profile.action ?? profile.name,
-        executable: profile.name,
+        implementation: profile.name,
         flavor: "instant",
         ...typeof issue === "number" ? { target: issue, cliArgs: { issue } } : { cliArgs: {} }
       };
@@ -14179,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 ?? "");
@@ -15485,9 +15467,8 @@ function requireString2(value, label) {
 function creatorSourceLabel(ctx, profileName) {
   const capability = typeof ctx.data.jobCapability === "string" ? ctx.data.jobCapability.trim() : "";
   const implementation = typeof ctx.data.jobImplementation === "string" ? ctx.data.jobImplementation.trim() : "";
-  const executable = typeof ctx.data.jobExecutable === "string" ? ctx.data.jobExecutable.trim() : "";
   const profile = typeof profileName === "string" ? profileName.trim() : "";
-  return capability || implementation || executable || profile || "agent-factory";
+  return capability || implementation || profile || "agent-factory";
 }
 function ghJson(args, cwd, input) {
   const raw = gh(args, input === void 0 ? { cwd } : { cwd, input: JSON.stringify(input) });
@@ -16147,7 +16128,6 @@ function taskJobSpecToJob(spec, issueNumber) {
   return {
     capability: spec.capability ?? spec.implementation,
     implementation: spec.implementation,
-    executable: spec.implementation,
     why: spec.reason,
     agent: spec.agent,
     schedule: spec.schedule,
@@ -16161,7 +16141,7 @@ function normalizeSpec(input, index) {
     throw new Error(`task job plan entry ${index} must be an object`);
   }
   const raw = input;
-  const implementation = typeof raw.implementation === "string" ? raw.implementation.trim() : typeof raw.executable === "string" ? raw.executable.trim() : "";
+  const implementation = typeof raw.implementation === "string" ? raw.implementation.trim() : "";
   if (!/^[a-z][a-z0-9-]*$/.test(implementation)) {
     throw new Error(`task job plan entry ${index} must have a valid implementation`);
   }
@@ -16186,11 +16166,11 @@ function normalizeSpec(input, index) {
   };
 }
 function jobToPlannedTaskJob(job) {
-  const implementation = job.implementation ?? job.executable ?? job.capability ?? "unknown";
+  const implementation = job.implementation ?? job.capability ?? "unknown";
   return {
     id: stableJobKey(job),
     implementation,
-    capability: job.capability ?? job.action ?? job.executable ?? "unknown",
+    capability: job.capability ?? job.action ?? "unknown",
     ...job.agent ? { agent: job.agent } : {},
     ...job.flavor ? { flavor: job.flavor } : {},
     ...job.schedule ? { schedule: job.schedule } : {},
@@ -19771,11 +19751,11 @@ function jobReferenceBlock(profileName, profile, data) {
   const flavor = typeof data.jobFlavor === "string" && data.jobFlavor.length > 0 ? data.jobFlavor : null;
   const schedule = typeof data.jobSchedule === "string" && data.jobSchedule.length > 0 ? data.jobSchedule : null;
   const isJob2 = Boolean(
-    jobId || flavor || schedule || data.jobCapability || data.jobImplementation || data.jobExecutable || data.jobWhy
+    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 : typeof data.jobExecutable === "string" && data.jobExecutable.length > 0 ? data.jobExecutable : 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;
@@ -20260,7 +20240,7 @@ async function runExecutableChain(profileName, input) {
     if (result.nextJob) {
       const next2 = result.nextJob;
       const after = result.afterNextJob;
-      const label = next2.executable ?? next2.capability ?? "unknown";
+      const label = next2.implementation ?? next2.capability ?? "unknown";
       process.stdout.write(`\u2192 kody: in-process job hand-off \u2192 ${label} (hop ${hops}/${MAX_CHAIN_HOPS})
 
 `);
@@ -20337,7 +20317,7 @@ async function runExecutableChain(profileName, input) {
     };
   }
   if (result.nextDispatch || result.nextJob) {
-    const pending = result.nextDispatch?.executable ?? result.nextDispatch?.workflow ?? result.nextJob?.executable ?? result.nextJob?.workflow ?? result.nextJob?.capability ?? "unknown";
+    const pending = result.nextDispatch?.executable ?? result.nextDispatch?.workflow ?? result.nextJob?.implementation ?? result.nextJob?.workflow ?? result.nextJob?.capability ?? "unknown";
     process.stderr.write(`[kody] in-process hand-off cap (${MAX_CHAIN_HOPS}) reached; not running ${pending}
 `);
   }
@@ -20351,7 +20331,6 @@ function handoffToJob(handoff) {
     capability: handoff.capability,
     workflow: handoff.workflow,
     implementation: handoff.implementation ?? handoff.executable,
-    executable: handoff.executable,
     cliArgs: handoff.cliArgs,
     flavor: "instant",
     saveReport: handoff.saveReport === true,
@@ -20781,8 +20760,7 @@ function validateJob(input) {
   }
   return {
     action: typeof j.action === "string" ? j.action : void 0,
-    implementation: typeof j.implementation === "string" ? j.implementation : typeof j.executable === "string" ? j.executable : void 0,
-    executable: typeof j.executable === "string" ? j.executable : typeof j.implementation === "string" ? j.implementation : void 0,
+    implementation: typeof j.implementation === "string" ? j.implementation : void 0,
     capability: typeof j.capability === "string" ? j.capability : void 0,
     workflow: typeof j.workflow === "string" ? j.workflow : void 0,
     why: typeof j.why === "string" ? j.why : void 0,
@@ -20816,7 +20794,7 @@ async function runJob(job, base) {
   const capabilityIdentity = valid.capability ?? resolvedCapability?.capability;
   const capabilityContext = valid.workflow ? null : loadCapabilityContext(capabilityIdentity, base.cwd);
   const workflowContext = valid.workflow ? loadWorkflowContext(valid.workflow, base) : !capabilityContext && !resolvedCapability ? loadWorkflowContext(capabilityIdentity ?? action, base) : null;
-  const explicitImplementation = valid.implementation ?? valid.executable;
+  const explicitImplementation = valid.implementation;
   const explicitImplementationOnly = explicitImplementation !== void 0 && (valid.action === void 0 || valid.action === explicitImplementation) && (valid.capability === void 0 || valid.capability === explicitImplementation);
   if (!resolvedCapability && !capabilityContext && !workflowContext && !explicitImplementationOnly) {
     throw new InvalidJobError(
@@ -20825,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;
@@ -20833,7 +20811,7 @@ async function runJob(job, base) {
     return runCapabilityWorkflow(workflowJob, workflow, workflowCapability, base);
   }
   if (!profileName) {
-    throw new InvalidJobError(`job capability resolves to no executable: ${capabilityIdentity ?? action}`);
+    throw new InvalidJobError(`job capability resolves to no implementation: ${capabilityIdentity ?? action}`);
   }
   return runDefaultCapabilityWorkflow(
     valid,
@@ -20864,7 +20842,6 @@ async function runCapabilityImplementationStep(valid, profileName, capabilityIde
   if (capabilityIdentity !== void 0 && capabilityIdentity.length > 0)
     preloadedData.jobCapability = capabilityIdentity;
   preloadedData.jobImplementation = profileName;
-  preloadedData.jobExecutable = profileName;
   if (valid.schedule !== void 0 && valid.schedule.length > 0) preloadedData.jobSchedule = valid.schedule;
   if (valid.saveReport === true) preloadedData.jobSaveReport = true;
   if (valid.resultTarget) preloadedData.capabilityResultTarget = valid.resultTarget;
@@ -20894,19 +20871,19 @@ async function runCapabilityImplementationStep(valid, profileName, capabilityIde
     quiet: base.quiet,
     preloadedData: Object.keys(preloadedData).length > 0 ? preloadedData : void 0
   };
-  const shouldApplyResolvedCapabilityArgs = valid.implementation === void 0 && valid.executable === void 0 && resolvedCapability && profileName === resolvedCapability.implementation;
+  const shouldApplyResolvedCapabilityArgs = valid.implementation === void 0 && resolvedCapability && profileName === resolvedCapability.implementation;
   input.cliArgs = shouldApplyResolvedCapabilityArgs ? { ...resolvedCapability.cliArgs, ...input.cliArgs } : input.cliArgs;
   const run = base.chain === false ? runExecutable : runExecutableChain;
   return run(profileName, input);
 }
-function shouldRunCapabilityWorkflow(job, workflow, capabilityIdentity, selectedExecutable, base) {
+function shouldRunCapabilityWorkflow(job, workflow, capabilityIdentity, selectedImplementation, base) {
   if (workflow.steps.length === 0) return false;
   if (!capabilityIdentity) return false;
   const stack = Array.isArray(base.preloadedData?.workflowStack) ? base.preloadedData.workflowStack.filter((entry) => typeof entry === "string") : [];
   if (stack.includes(capabilityIdentity)) return false;
-  const requestedImplementation = job.implementation ?? job.executable;
+  const requestedImplementation = job.implementation;
   if (!requestedImplementation) return true;
-  return requestedImplementation === selectedExecutable || requestedImplementation === capabilityIdentity || requestedImplementation === job.action;
+  return requestedImplementation === selectedImplementation || requestedImplementation === capabilityIdentity || requestedImplementation === job.action;
 }
 async function runCapabilityWorkflow(parent, workflow, capability, base) {
   let chainData = {
@@ -21009,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 } : {},
@@ -21105,7 +21081,6 @@ function mintInstantJob(dispatch2, opts) {
   return {
     action: dispatch2.action,
     implementation: dispatch2.implementation ?? dispatch2.executable,
-    executable: dispatch2.executable,
     capability: dispatch2.capability,
     why: opts?.why ?? dispatch2.why,
     agent: opts?.agent ?? DEFAULT_INSTANT_AGENT,
@@ -21118,8 +21093,7 @@ function mintScheduledJob(input) {
   return {
     action: input.action,
     capability: input.capability,
-    implementation: input.implementation ?? input.executable,
-    executable: input.executable,
+    implementation: input.implementation,
     schedule: input.schedule,
     agent: input.agent,
     cliArgs: input.cliArgs ?? {},
@@ -22950,8 +22924,7 @@ async function runCi(argv) {
         action: route.action,
         capability: route.capability,
         workflow: route.workflow,
-        implementation: route.implementation ?? route.executable,
-        executable: route.executable,
+        implementation: route.implementation,
         cliArgs: { ...route.cliArgs, ...forceRunCliArgs },
         flavor: "instant",
         force: true
@@ -23190,8 +23163,7 @@ async function runScheduledFanOut(cwd, args, opts) {
         mintScheduledJob({
           action: match.action,
           capability: match.capability,
-          implementation: match.implementation,
-          executable: match.executable,
+          implementation: match.implementation ?? match.executable,
           cliArgs: match.cliArgs
         }),
         {
@@ -26444,7 +26416,6 @@ ${HELP_TEXT}`);
           action: route.action,
           capability: route.capability,
           implementation: route.implementation,
-          executable: route.executable,
           cliArgs,
           target: numericTarget(cliArgs),
           flavor: "instant"
@@ -26482,7 +26453,6 @@ ${HELP_TEXT}`);
           action: executable,
           capability: executable,
           implementation: executable,
-          executable,
           cliArgs,
           target: numericTarget(cliArgs),
           flavor: "instant"

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.
    */
@@ -489,9 +486,8 @@ export type AnyScript = PreflightScript | PostflightScript
 // Job — the unified work request (task-state jobs collect run attempts).
 //
 // A Job is the required work the engine tries to execute, regardless of how it
-// was triggered. It must reference an capability/action capability
-// contract. The executable is only the selected implementation detail, never a
-// standalone request.
+// was triggered. It must reference a capability/action capability contract.
+// The implementation is selected under that contract, never requested by itself.
 // Task state stores this durable job separately from individual run attempts.
 // Two flavors:
 //   - "instant"   — run once now (an `@kody <verb>` comment or a manual dispatch)
@@ -508,8 +504,6 @@ export interface Job {
   action?: string
   /** How: implementation profile selected by the capability. Not valid by itself. */
   implementation?: string
-  /** Legacy compatibility copy of `implementation`. */
-  executable?: string
   /** Why (referenced): a capability slug whose intent drives the run. */
   capability?: string
   /** Why (referenced): a stored workflow definition to run as an ordered capability chain. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.345",
+  "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",