@kody-ade/kody-engine 0.4.335 → 0.4.336

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.335",
+      version: "0.4.336",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
       license: "MIT",
       type: "module",
@@ -1221,10 +1221,12 @@ function emitEvent(cwd, ev) {
   if (process.env.KODY_EVENTS === "0") return;
   try {
     const runId = resolveRunId();
+    const implementation = typeof ev.implementation === "string" ? ev.implementation : ev.executable;
     const fullEvent = {
       ts: (/* @__PURE__ */ new Date()).toISOString(),
       runId,
-      ...ev
+      ...ev,
+      implementation
     };
     const file = eventsPath(cwd, runId);
     fs3.mkdirSync(path5.dirname(file), { recursive: true });
@@ -1983,7 +1985,7 @@ function parseWorkflowStep(value) {
   const raw = value;
   const capability = stringField(raw.capability ?? raw.action);
   if (!capability || !isSafeSlug(capability)) return null;
-  const executable = stringField(raw.executable ?? raw.implementation);
+  const implementation = stringField(raw.implementation ?? raw.executable);
   const action = stringField(raw.action);
   const agent = stringField(raw.agent);
   const reason = stringField(raw.reason);
@@ -1992,7 +1994,7 @@ function parseWorkflowStep(value) {
   return {
     capability,
     ...action && isSafeSlug(action) ? { action } : {},
-    ...executable && isSafeSlug(executable) ? { executable } : {},
+    ...implementation && isSafeSlug(implementation) ? { implementation, executable: implementation } : {},
     ...target === "issue" || target === "pr" ? { target } : {},
     ...agent && isSafeSlug(agent) ? { agent } : {},
     ...reason ? { reason } : {},
@@ -2289,16 +2291,17 @@ function resolveCapabilityFolder(slug2, projectCapabilitiesRoot = getProjectCapa
 function getCapabilityActionInputs(action) {
   const resolved = resolveCapabilityAction(action);
   if (!resolved) return null;
-  return getProfileInputs(resolved.executable);
+  return getProfileInputs(resolved.implementation);
 }
 function resolveCapabilityExecution(capability) {
   const firstWorkflowStep = capability.config.workflow?.steps[0];
   if (firstWorkflowStep) {
-    return { executable: firstWorkflowStep.executable ?? firstWorkflowStep.capability, cliArgs: {} };
+    const implementation2 = firstWorkflowStep.implementation ?? firstWorkflowStep.executable ?? firstWorkflowStep.capability;
+    return { implementation: implementation2, executable: implementation2, cliArgs: {} };
   }
-  const executable = 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 cliArgs = executableDeclaresInput(executable, "capability") ? { capability: capability.slug } : {};
-  return { executable, 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 cliArgs = executableDeclaresInput(implementation, "capability") ? { capability: capability.slug } : {};
+  return { implementation, executable: implementation, cliArgs };
 }
 function executableDeclaresInput(executable, inputName) {
   const profilePath = resolveExecutable(executable);
@@ -2342,11 +2345,12 @@ function listFolderCapabilityActions(root, source) {
     if (!capability) continue;
     if (capability.config.internal === true || capability.config.public === false) continue;
     const action = capability.config.action ?? slug2;
-    const { executable, cliArgs } = resolveCapabilityExecution(capability);
-    if (hasUnresolvedExplicitImplementation(capability, executable)) continue;
+    const { implementation, executable, cliArgs } = resolveCapabilityExecution(capability);
+    if (hasUnresolvedExplicitImplementation(capability, implementation)) continue;
     out.push({
       action,
       capability: slug2,
+      implementation,
       executable,
       cliArgs,
       source,
@@ -2373,11 +2377,12 @@ function listBuiltinCapabilityActions(root = getBuiltinCapabilitiesRoot()) {
     const capability = readCapabilityFolder(root, slug2);
     if (!capability) continue;
     const action = capability.config.action ?? slug2;
-    const executable = capability.config.implementation ?? capability.config.executable ?? slug2;
+    const implementation = capability.config.implementation ?? capability.config.executable ?? slug2;
     out.push({
       action,
       capability: slug2,
-      executable,
+      implementation,
+      executable: implementation,
       cliArgs: {},
       source: "builtin",
       describe: capability.config.describe ?? capability.title,
@@ -2702,7 +2707,7 @@ function startCapability(workflowFile, name, issue, repoSlug) {
 function expectedDispatchTarget(capability) {
   const route = resolveCapabilityAction(capability);
   if (!route) return null;
-  const inputs = getProfileInputs(route.executable);
+  const inputs = getProfileInputs(route.implementation);
   const numeric = inputs?.find((input) => input.type === "int" && input.required);
   if (numeric?.name === "issue") return "issue";
   if (numeric?.name === "pr") return "pr";
@@ -6497,7 +6502,8 @@ function runIndexRowFromJobContext(input) {
     action: stringValue2(input.data.jobAction) ?? void 0,
     capability: stringValue2(input.data.jobCapability) ?? void 0,
     workflow: workflow ?? void 0,
-    executable: stringValue2(input.data.jobExecutable) ?? input.profileName,
+    implementation: stringValue2(input.data.jobImplementation) ?? stringValue2(input.data.jobExecutable) ?? input.profileName,
+    executable: stringValue2(input.data.jobExecutable) ?? 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,
@@ -6546,7 +6552,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,
-    executable: stringValue2(job?.executable) ?? void 0,
+    implementation: stringValue2(job?.implementation) ?? stringValue2(job?.executable) ?? void 0,
+    executable: stringValue2(job?.executable) ?? stringValue2(job?.implementation) ?? void 0,
     agent: stringValue2(job?.agent) ?? void 0,
     model: stringValue2(job?.model) ?? void 0,
     modelProvider: stringValue2(job?.modelProvider) ?? void 0,
@@ -6650,6 +6657,58 @@ var init_runIndex = __esm({
   }
 });
 
+// src/scripts/evaluateAgencyBoundaries.ts
+function shouldEvaluateAgencyBoundaries(data, profile) {
+  return Boolean(agencyBoundaryCapabilityKind(data, profile));
+}
+function agencyBoundaryCapability(data, profile) {
+  if (typeof data.jobCapability === "string" && data.jobCapability.length > 0) return data.jobCapability;
+  if (typeof data.capabilitySlug === "string" && data.capabilitySlug.length > 0) return data.capabilitySlug;
+  return profile.name;
+}
+function agencyBoundaryCapabilityKind(data, profile) {
+  const fromJob = data.jobCapabilityKind;
+  if (fromJob === "observe" || fromJob === "act" || fromJob === "verify") return fromJob;
+  return profile.capabilityKind;
+}
+function collectResults(raw, agentResult) {
+  const out = [];
+  if (Array.isArray(raw)) {
+    for (const item of raw) {
+      const parsed = parseCapabilityResult(item);
+      if (parsed) out.push(parsed);
+    }
+  }
+  if (agentResult?.finalText) out.push(...parseCapabilityResultsFromText(agentResult.finalText));
+  return out;
+}
+var evaluateAgencyBoundariesScript;
+var init_evaluateAgencyBoundaries = __esm({
+  "src/scripts/evaluateAgencyBoundaries.ts"() {
+    "use strict";
+    init_agencyBoundaryEval();
+    init_capabilityResult();
+    evaluateAgencyBoundariesScript = async (ctx, profile, agentResult) => {
+      const results = collectResults(ctx.data.capabilityResults ?? ctx.data.dutyResults, agentResult);
+      const capabilityKind = agencyBoundaryCapabilityKind(ctx.data, profile);
+      const capability = agencyBoundaryCapability(ctx.data, profile);
+      const evalResult = evaluateAgencyBoundaries({
+        capability,
+        capabilityKind,
+        results
+      });
+      ctx.data.agencyBoundaryEval = evalResult;
+      process.stdout.write(`KODY_AGENCY_BOUNDARY_EVAL=${JSON.stringify(evalResult)}
+`);
+      if (evalResult.status === "fail") {
+        const failed = evalResult.findings.filter((finding) => finding.status === "fail").map((finding) => finding.rule);
+        ctx.output.exitCode = ctx.output.exitCode === 0 ? 99 : ctx.output.exitCode;
+        ctx.output.reason = ctx.output.reason ? `${ctx.output.reason}; agency boundary eval failed: ${failed.join(", ")}` : `agency boundary eval failed: ${failed.join(", ")}`;
+      }
+    };
+  }
+});
+
 // src/pushWithRetry.ts
 import { execFileSync as execFileSync6 } from "child_process";
 function sleepSync2(ms) {
@@ -7238,6 +7297,7 @@ function planManagedGoalTick(goal) {
     evidence: missing,
     stage: step.stage,
     capability: step.capability,
+    implementation: step.implementation ?? step.executable,
     executable: step.executable,
     cliArgs: resolved.cliArgs,
     ...step.saveReport === true ? { saveReport: true } : {}
@@ -7348,6 +7408,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,
       args: args ?? void 0,
       saveReport: raw.saveReport === true,
@@ -7705,6 +7766,7 @@ function capabilityDispatchFromOutput(output) {
   if (!output) return void 0;
   const dispatch2 = pruneUndefined2({
     capability: stringValue3(output.capability) ?? void 0,
+    implementation: stringValue3(output.implementation) ?? stringValue3(output.executable) ?? void 0,
     executable: stringValue3(output.executable) ?? void 0,
     action: stringValue3(output.action) ?? void 0
   });
@@ -7778,7 +7840,17 @@ function triggerContext() {
     pullRequest: numberValue(recordValue3(event?.pull_request)?.number),
     comment: numberValue(recordValue3(event?.comment)?.id),
     schedule: stringValue3(event?.schedule),
-    inputs: inputs ? pickRecord(inputs, ["issue_number", "sessionId", "message", "model", "title", "executable", "base"]) : void 0
+    inputs: inputs ? pickRecord(inputs, [
+      "issue_number",
+      "sessionId",
+      "message",
+      "model",
+      "title",
+      "capability",
+      "implementation",
+      "executable",
+      "base"
+    ]) : void 0
   });
   return Object.keys(trigger).length > 0 ? trigger : void 0;
 }
@@ -7801,6 +7873,7 @@ 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,
     agent: stringValue3(data.jobAgent) ?? void 0,
     schedule: stringValue3(data.jobSchedule) ?? void 0,
@@ -7828,6 +7901,7 @@ function dispatchContext(event, trigger, job) {
     target: event.target,
     action: dispatch2.action ?? stringValue3(job?.action),
     capability: dispatch2.capability ?? stringValue3(job?.capability),
+    implementation: dispatch2.implementation ?? stringValue3(job?.implementation),
     reason: event.reason
   });
   return Object.keys(context).length > 0 ? context : void 0;
@@ -7875,6 +7949,7 @@ function routeStepForLog(step) {
     evidence: step.evidence,
     stage: step.stage,
     capability: step.capability,
+    implementation: step.implementation ?? step.executable,
     executable: step.executable,
     args: step.args,
     saveReport: step.saveReport === true ? true : void 0
@@ -7948,8 +8023,8 @@ var LOGS_KEY, LOG_RUN_KEY, LOG_STARTED_KEY;
 var init_runLog = __esm({
   "src/goal/runLog.ts"() {
     "use strict";
-    init_stateRepo();
     init_runIndex();
+    init_stateRepo();
     init_state2();
     LOGS_KEY = "__goalRunLogs";
     LOG_RUN_KEY = "__goalRunLogRunId";
@@ -8392,6 +8467,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.args ? { args: structuredClone(step.args) } : {}
   }));
@@ -8411,6 +8487,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,
       args: raw.args && typeof raw.args === "object" && !Array.isArray(raw.args) ? { ...raw.args } : void 0
     });
@@ -8458,9 +8535,21 @@ var init_typeDefinitions = __esm({
         evidence: ["planReady", "changeImplemented", "changeVerified"],
         capabilities: ["plan", "fix", "review"],
         route: [
-          { stage: "plan", evidence: "planReady", capability: "plan", executable: "plan" },
-          { stage: "implement", evidence: "changeImplemented", capability: "fix", executable: "fix" },
-          { stage: "review", evidence: "changeVerified", capability: "review", executable: "review" }
+          { stage: "plan", evidence: "planReady", capability: "plan", implementation: "plan", executable: "plan" },
+          {
+            stage: "implement",
+            evidence: "changeImplemented",
+            capability: "fix",
+            implementation: "fix",
+            executable: "fix"
+          },
+          {
+            stage: "review",
+            evidence: "changeVerified",
+            capability: "review",
+            implementation: "review",
+            executable: "review"
+          }
         ]
       },
       maintain: {
@@ -8492,6 +8581,7 @@ var init_typeDefinitions = __esm({
             stage: "release",
             evidence: "releasePrExists",
             capability: "release",
+            implementation: "release-prepare",
             executable: "release-prepare",
             args: { issue: { fact: "issue" }, goal: { fact: "goalId" } }
           },
@@ -8499,6 +8589,7 @@ var init_typeDefinitions = __esm({
             stage: "merge",
             evidence: "mainMerged",
             capability: "release-merge",
+            implementation: "release-merge",
             executable: "release-merge",
             args: { pr: { fact: "releasePr" }, issue: { fact: "issue" }, goal: { fact: "goalId" } }
           },
@@ -8506,6 +8597,7 @@ var init_typeDefinitions = __esm({
             stage: "publish",
             evidence: "productionDeployed",
             capability: "vercel-production-deploy",
+            implementation: "vercel-production-deploy",
             executable: "vercel-production-deploy"
           }
         ]
@@ -8519,6 +8611,7 @@ var init_typeDefinitions = __esm({
             stage: "verify",
             evidence: "checklistComplete",
             capability: "task-verifier",
+            implementation: "task-verifier",
             executable: "task-verifier"
           }
         ]
@@ -10668,7 +10761,7 @@ function collectReports(raw, agentResult) {
   if (agentResult?.finalText) out.push(...parseCapabilityReportsFromText(agentResult.finalText));
   return out;
 }
-function collectResults(raw, agentResult) {
+function collectResults2(raw, agentResult) {
   const out = [];
   if (Array.isArray(raw)) {
     for (const item of raw) {
@@ -10793,7 +10886,7 @@ var init_applyCapabilityReports = __esm({
     init_issue();
     applyCapabilityReports = async (ctx, _profile, agentResult) => {
       const reports = collectReports(ctx.data.capabilityReports, agentResult);
-      const results = collectResults(ctx.data.capabilityResults ?? ctx.data.dutyResults, agentResult);
+      const results = collectResults2(ctx.data.capabilityResults ?? ctx.data.dutyResults, agentResult);
       const resultTarget = parseResultTarget(ctx.data.capabilityResultTarget);
       const resultGoalId = resultTarget?.id ?? (typeof ctx.args.goal === "string" && ctx.args.goal.length > 0 ? ctx.args.goal : null);
       const explicitEvidence = resultTarget?.evidence ?? (typeof ctx.args.evidence === "string" && ctx.args.evidence.length > 0 ? ctx.args.evidence : void 0);
@@ -13094,58 +13187,6 @@ var init_ensurePr = __esm({
   }
 });
 
-// src/scripts/evaluateAgencyBoundaries.ts
-function shouldEvaluateAgencyBoundaries(data, profile) {
-  return Boolean(agencyBoundaryCapabilityKind(data, profile));
-}
-function agencyBoundaryCapability(data, profile) {
-  if (typeof data.jobCapability === "string" && data.jobCapability.length > 0) return data.jobCapability;
-  if (typeof data.capabilitySlug === "string" && data.capabilitySlug.length > 0) return data.capabilitySlug;
-  return profile.name;
-}
-function agencyBoundaryCapabilityKind(data, profile) {
-  const fromJob = data.jobCapabilityKind;
-  if (fromJob === "observe" || fromJob === "act" || fromJob === "verify") return fromJob;
-  return profile.capabilityKind;
-}
-function collectResults2(raw, agentResult) {
-  const out = [];
-  if (Array.isArray(raw)) {
-    for (const item of raw) {
-      const parsed = parseCapabilityResult(item);
-      if (parsed) out.push(parsed);
-    }
-  }
-  if (agentResult?.finalText) out.push(...parseCapabilityResultsFromText(agentResult.finalText));
-  return out;
-}
-var evaluateAgencyBoundariesScript;
-var init_evaluateAgencyBoundaries = __esm({
-  "src/scripts/evaluateAgencyBoundaries.ts"() {
-    "use strict";
-    init_agencyBoundaryEval();
-    init_capabilityResult();
-    evaluateAgencyBoundariesScript = async (ctx, profile, agentResult) => {
-      const results = collectResults2(ctx.data.capabilityResults ?? ctx.data.dutyResults, agentResult);
-      const capabilityKind = agencyBoundaryCapabilityKind(ctx.data, profile);
-      const capability = agencyBoundaryCapability(ctx.data, profile);
-      const evalResult = evaluateAgencyBoundaries({
-        capability,
-        capabilityKind,
-        results
-      });
-      ctx.data.agencyBoundaryEval = evalResult;
-      process.stdout.write(`KODY_AGENCY_BOUNDARY_EVAL=${JSON.stringify(evalResult)}
-`);
-      if (evalResult.status === "fail") {
-        const failed = evalResult.findings.filter((finding) => finding.status === "fail").map((finding) => finding.rule);
-        ctx.output.exitCode = ctx.output.exitCode === 0 ? 99 : ctx.output.exitCode;
-        ctx.output.reason = ctx.output.reason ? `${ctx.output.reason}; agency boundary eval failed: ${failed.join(", ")}` : `agency boundary eval failed: ${failed.join(", ")}`;
-      }
-    };
-  }
-});
-
 // src/scripts/failOnceTaskJob.ts
 var failOnceTaskJob;
 var init_failOnceTaskJob = __esm({
@@ -19681,10 +19722,12 @@ function jobReferenceBlock(profileName, profile, data) {
   const jobId = typeof data.jobId === "string" && data.jobId.length > 0 ? data.jobId : null;
   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.jobExecutable || data.jobWhy);
+  const isJob2 = Boolean(
+    jobId || flavor || schedule || data.jobCapability || data.jobImplementation || data.jobExecutable || data.jobWhy
+  );
   if (!isJob2) return null;
   const capability = typeof data.jobCapability === "string" && data.jobCapability.length > 0 ? data.jobCapability : profile.executable ? profile.name : null;
-  const executable = typeof profile.executable === "string" && profile.executable.length > 0 ? profile.executable : 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 : typeof data.jobExecutable === "string" && data.jobExecutable.length > 0 ? data.jobExecutable : 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;
@@ -19700,7 +19743,7 @@ function jobReferenceBlock(profileName, profile, data) {
     `- Flavor: ${flavor ?? "(unavailable)"}`,
     ...schedule ? [`- Schedule: ${schedule}`] : [],
     `- Capability: ${capability ?? "(none)"}`,
-    `- Executable: ${executable}`,
+    `- Implementation: ${implementation}`,
     `- Agent: ${agent ?? "(none)"}`,
     `- Description: ${description || "(none)"}`,
     ...workflow ? [`- Workflow: ${workflow}`] : [],
@@ -20259,6 +20302,7 @@ function handoffToJob(handoff) {
     action: handoff.action ?? handoff.capability,
     capability: handoff.capability,
     workflow: handoff.workflow,
+    implementation: handoff.implementation ?? handoff.executable,
     executable: handoff.executable,
     cliArgs: handoff.cliArgs,
     flavor: "instant",
@@ -20541,10 +20585,10 @@ var init_executor = __esm({
     init_registry();
     init_runIndex();
     init_runtimePaths();
+    init_evaluateAgencyBoundaries();
     init_scripts();
     init_stateWorkspace();
     init_subagents();
-    init_evaluateAgencyBoundaries();
     init_task_artifacts();
     init_tools();
     MUTATING_POSTFLIGHTS = /* @__PURE__ */ new Set([
@@ -20689,7 +20733,8 @@ function validateJob(input) {
   }
   return {
     action: typeof j.action === "string" ? j.action : void 0,
-    executable: typeof j.executable === "string" ? j.executable : 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,
     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,
@@ -20723,17 +20768,18 @@ 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 explicitExecutableOnly = valid.executable !== void 0 && (valid.action === void 0 || valid.action === valid.executable) && (valid.capability === void 0 || valid.capability === valid.executable);
-  if (!resolvedCapability && !capabilityContext && !workflowContext && !explicitExecutableOnly) {
+  const explicitImplementation = valid.implementation ?? valid.executable;
+  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(
       `job capability/workflow not found: ${valid.workflow ?? action ?? valid.capability ?? "<none>"}`
     );
   }
   const workflow = capabilityContext?.config.workflow ?? workflowContext?.config.workflow;
   const workflowIdentity = valid.workflow ?? capabilityIdentity ?? workflowContext?.slug;
-  const capabilitySelectedExecutable = resolvedCapability?.executable ?? capabilityContext?.config.implementation ?? capabilityContext?.config.executable ?? capabilityContext?.config.executables?.[0] ?? (capabilityContext?.config.role ? capabilityContext.slug : void 0) ?? (capabilityContext?.config.tickScript ? "capability-tick-scripted" : void 0);
-  const profileName = valid.executable ?? capabilitySelectedExecutable;
-  if (workflow && shouldRunCapabilityWorkflow(valid, workflow, workflowIdentity, capabilitySelectedExecutable, base)) {
+  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 profileName = explicitImplementation ?? capabilitySelectedImplementation;
+  if (workflow && shouldRunCapabilityWorkflow(valid, workflow, workflowIdentity, capabilitySelectedImplementation, base)) {
     const workflowCapability = capabilityContext ?? workflowContext;
     const workflowJob = workflowContext && !valid.why ? { ...valid, why: workflowContext.body } : valid;
     return runCapabilityWorkflow(workflowJob, workflow, workflowCapability, base);
@@ -20769,6 +20815,7 @@ async function runCapabilityImplementationStep(valid, profileName, capabilityIde
   if (valid.action !== void 0 && valid.action.length > 0) preloadedData.jobAction = valid.action;
   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;
@@ -20776,7 +20823,8 @@ async function runCapabilityImplementationStep(valid, profileName, capabilityIde
   if (capabilityContext) {
     preloadedData.capabilitySlug = capabilityContext.slug;
     preloadedData.capabilityTitle = capabilityContext.title;
-    if (capabilityContext.config.capabilityKind) preloadedData.jobCapabilityKind = capabilityContext.config.capabilityKind;
+    if (capabilityContext.config.capabilityKind)
+      preloadedData.jobCapabilityKind = capabilityContext.config.capabilityKind;
     preloadedData.capabilityIntent = capabilityContext.body;
     preloadedData.dutyIntent = capabilityContext.body;
     preloadedData.jobIntent = capabilityContext.body;
@@ -20799,7 +20847,7 @@ async function runCapabilityImplementationStep(valid, profileName, capabilityIde
     quiet: base.quiet,
     preloadedData: Object.keys(preloadedData).length > 0 ? preloadedData : void 0
   };
-  const shouldApplyResolvedCapabilityArgs = valid.executable === void 0 && resolvedCapability && profileName === resolvedCapability.executable;
+  const shouldApplyResolvedCapabilityArgs = valid.implementation === void 0 && valid.executable === 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);
@@ -20809,8 +20857,9 @@ function shouldRunCapabilityWorkflow(job, workflow, capabilityIdentity, selected
   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;
-  if (!job.executable) return true;
-  return job.executable === selectedExecutable || job.executable === capabilityIdentity || job.executable === job.action;
+  const requestedImplementation = job.implementation ?? job.executable;
+  if (!requestedImplementation) return true;
+  return requestedImplementation === selectedExecutable || requestedImplementation === capabilityIdentity || requestedImplementation === job.action;
 }
 async function runCapabilityWorkflow(parent, workflow, capability, base) {
   let chainData = {
@@ -20912,6 +20961,7 @@ function workflowStepToJob(step, parent, chainData) {
   return {
     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 } : {},
@@ -21007,6 +21057,7 @@ function loadWorkflowContext(slug2, base) {
 function mintInstantJob(dispatch2, opts) {
   return {
     action: dispatch2.action,
+    implementation: dispatch2.implementation ?? dispatch2.executable,
     executable: dispatch2.executable,
     capability: dispatch2.capability,
     why: opts?.why ?? dispatch2.why,
@@ -21020,6 +21071,7 @@ function mintScheduledJob(input) {
   return {
     action: input.action,
     capability: input.capability,
+    implementation: input.implementation ?? input.executable,
     executable: input.executable,
     schedule: input.schedule,
     agent: input.agent,
@@ -22001,6 +22053,7 @@ function routeResult(route, cliArgs, target, why) {
   const result = {
     action: route.action,
     capability: route.capability,
+    implementation: route.implementation,
     executable: route.executable,
     cliArgs: { ...route.cliArgs, ...cliArgs },
     target
@@ -22030,7 +22083,7 @@ function autoDispatch(opts) {
       const route2 = resolveConfiguredAction(actionName);
       if (!route2) return null;
       const base = String(inputs2?.base ?? "").trim();
-      const targetKey = primaryNumericInputName(route2.executable) ?? "issue";
+      const targetKey = primaryNumericInputName(route2.implementation) ?? "issue";
       const cliArgs = { [targetKey]: n };
       if (base) cliArgs.base = base;
       return routeResult(route2, cliArgs, n);
@@ -22048,7 +22101,7 @@ function autoDispatch(opts) {
       if (!route2) return null;
       const prNum = Number(pullRequest?.number ?? event.number ?? 0);
       if (prNum > 0) {
-        const targetKey = primaryNumericInputName(route2.executable) ?? "pr";
+        const targetKey = primaryNumericInputName(route2.implementation) ?? "pr";
         return routeResult(route2, { [targetKey]: prNum }, prNum);
       }
     }
@@ -22113,7 +22166,7 @@ function autoDispatch(opts) {
     );
     return null;
   }
-  const inputs = getProfileInputs(route.executable);
+  const inputs = getProfileInputs(route.implementation);
   const effectiveInputs = inputs ?? [];
   const unknownProfile = inputs === null;
   const rest = extractCommentRest(afterTag, consumedFirstToken ? firstToken : null);
@@ -22230,6 +22283,7 @@ function dispatchScheduledWatches(opts) {
       route ? { ...route, cliArgs: route.cliArgs, target: 0 } : {
         action: exe.name,
         capability: exe.name,
+        implementation: exe.name,
         executable: exe.name,
         cliArgs: {},
         target: 0
@@ -22585,7 +22639,7 @@ function detectPackageManager2(cwd) {
   return "npm";
 }
 function shouldChainScheduledWatch(match) {
-  return match.action === "goal-scheduler" || match.capability === "goal-scheduler" || match.executable === "goal-scheduler";
+  return match.action === "goal-scheduler" || match.capability === "goal-scheduler" || match.implementation === "goal-scheduler" || match.executable === "goal-scheduler";
 }
 function shellOut(cmd, args, cwd, stream = true) {
   try {
@@ -22793,11 +22847,12 @@ async function runCi(argv) {
       cliArgs: {}
     };
     const scheduledWatchRoute = manualGoalManager || capabilityRoute || workflowRoute ? void 0 : dispatchScheduledWatches({ force: true }).find(
-      (match) => match.action === forceRunAction || match.executable === forceRunAction
+      (match) => match.action === forceRunAction || match.capability === forceRunAction || match.implementation === forceRunAction || match.executable === forceRunAction
     );
     const route = manualGoalManager ? {
       action: "goal-manager",
       capability: "goal-manager",
+      implementation: "goal-manager",
       executable: "goal-manager",
       cliArgs: forceRunCliArgs
     } : capabilityRoute ?? workflowRoute ?? scheduledWatchRoute;
@@ -22848,6 +22903,7 @@ async function runCi(argv) {
         action: route.action,
         capability: route.capability,
         workflow: route.workflow,
+        implementation: route.implementation ?? route.executable,
         executable: route.executable,
         cliArgs: { ...route.cliArgs, ...forceRunCliArgs },
         flavor: "instant",
@@ -22965,7 +23021,7 @@ ${CI_HELP}`);
   };
   const issueNumber = dispatch2.target;
   process.stdout.write(
-    `\u2192 kody preflight (cwd=${cwd}, action=${dispatch2.action}, capability=${dispatch2.capability}, executable=${dispatch2.executable}, target=${issueNumber})
+    `\u2192 kody preflight (cwd=${cwd}, action=${dispatch2.action}, capability=${dispatch2.capability}, implementation=${dispatch2.implementation}, target=${issueNumber})
 `
   );
   try {
@@ -22977,7 +23033,7 @@ ${CI_HELP}`);
     const pm = args.packageManager ?? detectPackageManager2(cwd);
     process.stdout.write(`\u2192 kody: package manager = ${pm}
 `);
-    const buildOnly = dispatch2.executable === "preview-build";
+    const buildOnly = dispatch2.implementation === "preview-build" || dispatch2.executable === "preview-build";
     if (args.skipInstall || buildOnly) {
       process.stdout.write(`\u2192 kody: skipping dep install (${buildOnly ? "build-only executable" : "--skip-install"})
 `);
@@ -23008,7 +23064,7 @@ ${CI_HELP}`);
     postFailureTail(issueNumber, cwd, `preflight crashed: ${msg}`);
     return 99;
   }
-  process.stdout.write(`\u2192 kody: preflight done, handing off to kody ${dispatch2.executable}
+  process.stdout.write(`\u2192 kody: preflight done, handing off to kody ${dispatch2.implementation}
 
 `);
   try {
@@ -23042,7 +23098,7 @@ async function runScheduledFanOut(cwd, args, opts) {
     );
     return 0;
   }
-  const names = matches.map((m) => `${m.capability}\u2192${m.executable}`).join(", ");
+  const names = matches.map((m) => `${m.capability}\u2192${m.implementation}`).join(", ");
   process.stdout.write(`\u2192 kody: scheduled wake \u2014 firing ${matches.length} watch capability/ies: ${names}
 `);
   try {
@@ -23080,13 +23136,14 @@ async function runScheduledFanOut(cwd, args, opts) {
   const serial = process.env.KODY_SERIAL_WATCHES === "1";
   const runWatch = async (match) => {
     process.stdout.write(`
-\u2192 kody: running watch capability \`${match.capability}\` (${match.executable})
+\u2192 kody: running watch capability \`${match.capability}\` (${match.implementation})
 `);
     try {
       const result = await runJob(
         mintScheduledJob({
           action: match.action,
           capability: match.capability,
+          implementation: match.implementation,
           executable: match.executable,
           cliArgs: match.cliArgs
         }),
@@ -26333,12 +26390,13 @@ ${HELP_TEXT}`);
       return 64;
     }
     const cliArgs = { ...route.cliArgs, ...args.cliArgs ?? {} };
-    const skipConfig = configlessCommands.has(route.executable);
+    const skipConfig = configlessCommands.has(route.implementation);
     try {
       const result = await runJob(
         {
           action: route.action,
           capability: route.capability,
+          implementation: route.implementation,
           executable: route.executable,
           cliArgs,
           target: numericTarget(cliArgs),
@@ -26376,6 +26434,7 @@ ${HELP_TEXT}`);
         {
           action: executable,
           capability: executable,
+          implementation: executable,
           executable,
           cliArgs,
           target: numericTarget(cliArgs),

package/dist/executables/types.ts

@@ -439,6 +439,7 @@ export interface Context {
       action?: string
       capability?: string
       workflow?: string
+      implementation?: string
       executable?: string
       cliArgs: Record<string, unknown>
       saveReport?: boolean
@@ -451,6 +452,7 @@ export interface Context {
       action?: string
       capability?: string
       workflow?: string
+      implementation?: string
       executable?: string
       cliArgs: Record<string, unknown>
       saveReport?: boolean
@@ -505,6 +507,8 @@ export interface Job {
   /** Public action the user/operator invoked. Mirrors the capability action. */
   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

package/package.json

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