@kody-ade/kody-engine 0.4.345 → 0.4.346

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.346",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
       license: "MIT",
       type: "module",
@@ -6534,8 +6534,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 +6584,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 +7065,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
@@ -7905,8 +7905,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,
@@ -12782,7 +12782,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 +12839,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 +12865,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 +13230,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: {} }
       };
@@ -15485,9 +15484,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 +16145,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 +16158,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 +16183,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 +19768,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 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 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 +20257,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 +20334,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 +20348,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 +20777,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 +20811,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(
@@ -20833,7 +20828,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 +20859,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 +20888,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 = {
@@ -21105,7 +21099,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 +21111,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 ?? {},
@@ -22951,7 +22943,6 @@ async function runCi(argv) {
         capability: route.capability,
         workflow: route.workflow,
         implementation: route.implementation ?? route.executable,
-        executable: route.executable,
         cliArgs: { ...route.cliArgs, ...forceRunCliArgs },
         flavor: "instant",
         force: true
@@ -23190,8 +23181,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 +26434,6 @@ ${HELP_TEXT}`);
           action: route.action,
           capability: route.capability,
           implementation: route.implementation,
-          executable: route.executable,
           cliArgs,
           target: numericTarget(cliArgs),
           flavor: "instant"
@@ -26482,7 +26471,6 @@ ${HELP_TEXT}`);
           action: executable,
           capability: executable,
           implementation: executable,
-          executable,
           cliArgs,
           target: numericTarget(cliArgs),
           flavor: "instant"

package/dist/executables/types.ts

@@ -489,9 +489,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 +507,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.346",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",