@kody-ade/kody-engine 0.4.346 → 0.4.348

package/dist/bin/kody.js

@@ -15,7 +15,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@kody-ade/kody-engine",
-      version: "0.4.346",
+      version: "0.4.348",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
       license: "MIT",
       type: "module",
@@ -1221,12 +1221,10 @@ 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,
-      implementation
+      ...ev
     };
     const file = eventsPath(cwd, runId);
     fs3.mkdirSync(path5.dirname(file), { recursive: true });
@@ -1405,7 +1403,7 @@ function verifyToolDefinition(opts) {
       const attempt = state.attempts;
       if (attempt > state.maxAttempts) {
         emitEvent(opts.cwd, {
-          executable: opts.executable,
+          implementation: opts.implementation,
           kind: "error",
           name: "verify_tool",
           outcome: "failed",
@@ -1428,7 +1426,7 @@ function verifyToolDefinition(opts) {
       const result = await runVerify2(opts.config, opts.cwd);
       const durationMs = Date.now() - startedAt;
       emitEvent(opts.cwd, {
-        executable: opts.executable,
+        implementation: opts.implementation,
         kind: "postflight",
         name: `verify_attempt_${attempt}`,
         durationMs,
@@ -1905,11 +1903,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 +1918,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 +1981,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 +1990,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 } : {},
@@ -2260,7 +2256,7 @@ function listCapabilityActions(projectCapabilitiesRoot = getProjectCapabilitiesR
   const seen = /* @__PURE__ */ new Set();
   const out = [];
   const add = (action) => {
-    if (!isSafeName(action.action) || !isSafeName(action.capability) || !isSafeName(action.executable)) return;
+    if (!isSafeName(action.action) || !isSafeName(action.capability) || !isSafeName(action.implementation)) return;
     if (seen.has(action.action)) return;
     seen.add(action.action);
     out.push(action);
@@ -2296,15 +2292,15 @@ function getCapabilityActionInputs(action) {
 function resolveCapabilityExecution(capability) {
   const firstWorkflowStep = capability.config.workflow?.steps[0];
   if (firstWorkflowStep) {
-    const implementation2 = firstWorkflowStep.implementation ?? firstWorkflowStep.executable ?? firstWorkflowStep.capability;
-    return { implementation: implementation2, executable: implementation2, cliArgs: {} };
+    const implementation2 = firstWorkflowStep.implementation ?? firstWorkflowStep.capability;
+    return { implementation: 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 cliArgs = executableDeclaresInput(implementation, "capability") ? { capability: capability.slug } : {};
-  return { implementation, executable: implementation, cliArgs };
+  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 = implementationDeclaresInput(implementation, "capability") ? { capability: capability.slug } : {};
+  return { implementation, cliArgs };
 }
-function executableDeclaresInput(executable, inputName) {
-  const profilePath = resolveExecutable(executable);
+function implementationDeclaresInput(implementation, inputName) {
+  const profilePath = resolveExecutable(implementation);
   if (!profilePath) return false;
   try {
     const raw = JSON.parse(fs6.readFileSync(profilePath, "utf-8"));
@@ -2345,13 +2341,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 { implementation, executable, cliArgs } = resolveCapabilityExecution(capability);
+    const { implementation, cliArgs } = resolveCapabilityExecution(capability);
     if (hasUnresolvedExplicitImplementation(capability, implementation)) continue;
     out.push({
       action,
       capability: slug2,
       implementation,
-      executable,
       cliArgs,
       source,
       describe: capability.config.describe ?? capability.title,
@@ -2361,13 +2356,13 @@ function listFolderCapabilityActions(root, source) {
   }
   return out.sort((a, b) => a.action.localeCompare(b.action));
 }
-function hasUnresolvedExplicitImplementation(capability, executable) {
+function hasUnresolvedExplicitImplementation(capability, implementation) {
   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;
-  return resolveExecutable(executable) === null;
+  return resolveExecutable(implementation) === null;
 }
 function listBuiltinCapabilityActions(root = getBuiltinCapabilitiesRoot()) {
   if (!fs6.existsSync(root) || !fs6.statSync(root).isDirectory()) return [];
@@ -2377,12 +2372,11 @@ 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,
       implementation,
-      executable: implementation,
       cliArgs: {},
       source: "builtin",
       describe: capability.config.describe ?? capability.title,
@@ -2898,25 +2892,6 @@ function capabilityToolDefinitions(opts) {
       return { content: [{ type: "text", text }] };
     }
   };
-  const dispatchTool = {
-    name: "dispatch_workflow",
-    description: "Legacy alias for start_capability. Dispatches a kody.yml workflow_dispatch run for a capability action against an issue. Prefer start_capability({name:'run', issue:<n>}). Returns {ok} or {ok:false,error}.",
-    inputSchema: {
-      capability: z3.string().min(1).optional().describe("Capability action to run (e.g. 'run')."),
-      executable: z3.string().min(1).optional().describe("Deprecated alias for capability."),
-      issueNumber: z3.number().int().positive().describe("Issue (or PR) number forwarded as issue_number.")
-    },
-    handler: async (args) => {
-      const capability = String(args.capability ?? args.executable ?? "");
-      const issueNumber = Number(args.issueNumber);
-      if (isDispatchGated(capability, readCapabilityTrustMode(opts.state, opts.repoSlug, opts.capabilitySlug))) {
-        return { content: [{ type: "text", text: trustRefusal(opts.capabilitySlug) }] };
-      }
-      const result = startCapability(workflowFile, capability, issueNumber, opts.repoSlug);
-      const text = result.ok ? `Dispatched capability \`${capability}\` on #${issueNumber} via workflow_dispatch.` : `Dispatch failed for capability \`${capability}\` on #${issueNumber}: ${result.error}`;
-      return { content: [{ type: "text", text }] };
-    }
-  };
   const cmsTools = dashboardCmsToolDefinitions({
     repoSlug: opts.repoSlug,
     assertWriteAllowed: () => assertCmsWriteAllowed(opts)
@@ -2933,7 +2908,6 @@ function capabilityToolDefinitions(opts) {
     ensureIssueTool,
     ensureCommentTool,
     startCapabilityTool,
-    dispatchTool,
     ...cmsTools
   ];
 }
@@ -2983,7 +2957,6 @@ var init_capabilityMcp = __esm({
       "ensure_issue",
       "ensure_comment",
       "start_capability",
-      "dispatch_workflow",
       ...DASHBOARD_CMS_MCP_TOOL_NAMES
     ];
   }
@@ -3246,7 +3219,7 @@ async function runAgent(opts) {
         const verifyServer = buildVerifyMcpServer2({
           config: opts.verifyConfig,
           cwd: opts.cwd,
-          executable: opts.executableName ?? "agent",
+          implementation: opts.implementationName ?? "agent",
           maxAttempts: typeof opts.verifyToolMaxAttempts === "number" && opts.verifyToolMaxAttempts > 0 ? opts.verifyToolMaxAttempts : void 0
         });
         mcpEntries.push(["kody-verify", verifyServer]);
@@ -4455,11 +4428,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 +4442,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 +4495,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 +4869,6 @@ var init_profile = __esm({
       "action",
       "implementation",
       "implementations",
-      "executable",
-      "executables",
       "internal",
       "public",
       "capabilityKind",
@@ -4972,15 +4941,21 @@ function normalizeTaskState(parsed) {
   if (parsed?.schemaVersion !== 1) {
     throw new CorruptStateError(`unexpected schemaVersion: ${JSON.stringify(parsed?.schemaVersion)}`);
   }
-  const raw = parsed;
-  const legacyCurrent = typeof raw.core?.currentExecutable === "string" ? raw.core.currentExecutable : void 0;
-  const currentImplementation = typeof parsed.core?.currentImplementation === "string" ? parsed.core.currentImplementation : legacyCurrent ?? null;
-  const implementations = parsed.implementations && typeof parsed.implementations === "object" ? parsed.implementations : raw.executables && typeof raw.executables === "object" && !Array.isArray(raw.executables) ? raw.executables : {};
-  const coreWithoutLegacy = { ...parsed.core ?? {} };
-  delete coreWithoutLegacy.currentExecutable;
+  const currentImplementation = typeof parsed.core?.currentImplementation === "string" ? parsed.core.currentImplementation : null;
+  const implementations = parsed.implementations && typeof parsed.implementations === "object" ? parsed.implementations : {};
+  const parsedCore = parsed.core ?? emptyState().core;
+  const core = {
+    phase: parsedCore.phase,
+    status: parsedCore.status,
+    lastOutcome: parsedCore.lastOutcome,
+    attempts: parsedCore.attempts,
+    ...parsedCore.prUrl ? { prUrl: parsedCore.prUrl } : {},
+    ...parsedCore.runUrl ? { runUrl: parsedCore.runUrl } : {},
+    ...parsedCore.ranAsAgent !== void 0 ? { ranAsAgent: parsedCore.ranAsAgent } : {}
+  };
   return {
     schemaVersion: 1,
-    core: { ...emptyState().core, ...coreWithoutLegacy, currentImplementation },
+    core: { ...emptyState().core, ...core, currentImplementation },
     implementations,
     artifacts: parsed.artifacts && typeof parsed.artifacts === "object" ? parsed.artifacts : {},
     jobs: normalizeJobs(parsed.jobs),
@@ -5124,7 +5099,7 @@ function normalizeJobs(input) {
   for (const [key, value] of Object.entries(input)) {
     if (!value || typeof value !== "object" || Array.isArray(value)) continue;
     const raw = value;
-    const implementation = typeof raw.implementation === "string" ? raw.implementation : typeof raw.executable === "string" ? raw.executable : void 0;
+    const implementation = typeof raw.implementation === "string" ? raw.implementation : void 0;
     if (typeof raw.id !== "string" || typeof implementation !== "string") continue;
     if (!isStatus(raw.status)) continue;
     out[key] = {
@@ -5153,7 +5128,7 @@ function normalizeHistory(input) {
   for (const value of input) {
     if (!value || typeof value !== "object" || Array.isArray(value)) continue;
     const raw = value;
-    const implementation = typeof raw.implementation === "string" ? raw.implementation : typeof raw.executable === "string" ? raw.executable : void 0;
+    const implementation = typeof raw.implementation === "string" ? raw.implementation : void 0;
     if (typeof raw.timestamp !== "string" || typeof implementation !== "string" || typeof raw.action !== "string") {
       continue;
     }
@@ -5853,7 +5828,7 @@ async function runContainerLoop(profile, ctx, input) {
           preloadedData: preloadedSnapshot
         });
         emitEvent(input.cwd, {
-          executable: profile.name,
+          implementation: profile.name,
           kind: "container_child",
           name: child.exec,
           durationMs: Date.now() - childStartedAt,
@@ -5862,7 +5837,7 @@ async function runContainerLoop(profile, ctx, input) {
         });
       } catch (err) {
         emitEvent(input.cwd, {
-          executable: profile.name,
+          implementation: profile.name,
           kind: "container_child",
           name: child.exec,
           durationMs: Date.now() - childStartedAt,
@@ -6535,7 +6510,6 @@ function runIndexRowFromJobContext(input) {
     capability: stringValue2(input.data.jobCapability) ?? void 0,
     workflow: workflow ?? void 0,
     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,
@@ -6585,7 +6559,6 @@ function runIndexRowFromGoalEvents(goalId, logPath, events) {
     action: stringValue2(job?.action) ?? void 0,
     capability: stringValue2(job?.capability) ?? 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,
@@ -7329,8 +7302,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 +7412,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),
@@ -7798,8 +7769,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,
+    implementation: stringValue3(output.implementation) ?? void 0,
     action: stringValue3(output.action) ?? void 0
   });
   return Object.keys(dispatch2).length > 0 ? dispatch2 : void 0;
@@ -7880,7 +7850,6 @@ function triggerContext() {
       "title",
       "capability",
       "implementation",
-      "executable",
       "base"
     ]) : void 0
   });
@@ -7906,7 +7875,6 @@ function jobContext(data) {
     action: stringValue3(data.jobAction) ?? void 0,
     capability: stringValue3(data.jobCapability) ?? 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 +7949,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 +8466,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 +8485,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 +8532,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 +8577,6 @@ var init_typeDefinitions = __esm({
             evidence: "releasePrExists",
             capability: "release",
             implementation: "release-prepare",
-            executable: "release-prepare",
             args: { issue: { fact: "issue" }, goal: { fact: "goalId" } }
           },
           {
@@ -8622,15 +8584,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 +8603,7 @@ var init_typeDefinitions = __esm({
             stage: "verify",
             evidence: "checklistComplete",
             capability: "task-verifier",
-            implementation: "task-verifier",
-            executable: "task-verifier"
+            implementation: "task-verifier"
           }
         ]
       }
@@ -9051,7 +9010,7 @@ function planTargetLoopSchedule(opts) {
     if (!gate.ok) return targetLoopDecision("idle", gate.reason, at);
   }
   const dispatchTargetId = target.type === "goal" && opts.resolvedGoalTargetId?.trim() ? opts.resolvedGoalTargetId.trim() : targetId;
-  const dispatch2 = target.type === "goal" ? { action: "goal-manager", executable: "goal-manager", cliArgs: { goal: dispatchTargetId } } : { workflow: targetId, cliArgs: {} };
+  const dispatch2 = target.type === "goal" ? { action: "goal-manager", implementation: "goal-manager", cliArgs: { goal: dispatchTargetId } } : { workflow: targetId, cliArgs: {} };
   return {
     kind: "dispatch",
     reason: `dispatch ${target.type} ${target.type === "goal" ? dispatchTargetId : targetId}`,
@@ -9066,7 +9025,7 @@ function planTargetLoopSchedule(opts) {
         ...dispatch2.action ? { action: dispatch2.action } : {},
         ...dispatch2.capability ? { capability: dispatch2.capability } : {},
         ...dispatch2.workflow ? { workflow: dispatch2.workflow } : {},
-        ...dispatch2.executable ? { executable: dispatch2.executable } : {},
+        ...dispatch2.implementation ? { implementation: dispatch2.implementation } : {},
         reason: preferred ? `preferred time ${preferred.time} ${preferred.timezone}` : "ready target loop tick",
         at
       },
@@ -9136,7 +9095,7 @@ async function planGoalCapabilitySchedule(opts) {
       lastDecision: {
         kind: "dispatch",
         capability: due.slug,
-        executable: dispatch2.executable,
+        implementation: dispatch2.implementation,
         reason: due.reason,
         at
       },
@@ -9153,12 +9112,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;
@@ -9185,8 +9144,8 @@ async function describeCapabilitySchedule(capability, slug2, backend, previous)
   };
 }
 function capabilityDispatch(capability) {
-  const { executable, cliArgs } = resolveCapabilityExecution(capability);
-  return { capability: capability.slug, executable, cliArgs };
+  const { implementation, cliArgs } = resolveCapabilityExecution(capability);
+  return { capability: capability.slug, implementation, cliArgs };
 }
 function compareOldestLastFired(a, b) {
   const aTime = validIso(a.lastFiredAt) ? Date.parse(a.lastFiredAt) : Number.NEGATIVE_INFINITY;
@@ -9282,7 +9241,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 +9257,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
     });
@@ -9542,7 +9501,7 @@ var init_advanceManagedGoal = __esm({
             ...decision2.dispatch.action ? { action: decision2.dispatch.action } : {},
             ...decision2.dispatch.capability ? { capability: decision2.dispatch.capability } : {},
             ...decision2.dispatch.workflow ? { workflow: decision2.dispatch.workflow } : {},
-            ...decision2.dispatch.executable ? { executable: decision2.dispatch.executable } : {},
+            ...decision2.dispatch.implementation ? { implementation: decision2.dispatch.implementation } : {},
             cliArgs: decision2.dispatch.cliArgs
           };
         }
@@ -9596,7 +9555,7 @@ var init_advanceManagedGoal = __esm({
         if (decision2.kind === "dispatch" && decision2.dispatch) {
           ctx.output.nextDispatch = {
             capability: decision2.dispatch.capability,
-            executable: decision2.dispatch.executable,
+            implementation: decision2.dispatch.implementation,
             cliArgs: decision2.dispatch.cliArgs,
             ...goal.raw.extra.saveReport === true ? { saveReport: true } : {}
           };
@@ -9675,7 +9634,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 }
       };
@@ -9868,7 +9827,7 @@ function parseRouteStep(value) {
     stage: requiredString(input.stage, "route.stage"),
     evidence: requiredString(input.evidence, "route.evidence"),
     capability: slug(input.capability, "route.capability"),
-    ...typeof input.executable === "string" && input.executable.trim() ? { executable: input.executable.trim() } : {},
+    ...typeof input.implementation === "string" && input.implementation.trim() ? { implementation: input.implementation.trim() } : {},
     ...record(input.args) ? { args: record(input.args) } : {}
   };
 }
@@ -11007,7 +10966,7 @@ var init_applyCapabilityReports = __esm({
           if (changed && ctx.output.exitCode === 0 && !ctx.output.nextDispatch && shouldResumeManagedGoal(goalId, nextForOutput)) {
             ctx.output.nextDispatch = {
               action: "goal-manager",
-              executable: "goal-manager",
+              implementation: "goal-manager",
               cliArgs: { goal: goalId }
             };
           }
@@ -14178,7 +14137,7 @@ var init_loadCapabilityState = __esm({
       ctx.data.jobStateJson = JSON.stringify(loaded.state, null, 2);
       ctx.data.capabilitySlug = slug2;
       ctx.data.capabilityTitle = profile.describe;
-      ctx.data.executableSlug = profile.implementation ?? profile.executable ?? profile.name;
+      ctx.data.executableSlug = profile.implementation ?? profile.name;
       ctx.data.agentSlug = profile.agent ?? "";
       ctx.data.agentTitle = "";
       ctx.data.capabilitySchedule = String(ctx.data.jobSchedule ?? "");
@@ -19771,8 +19730,8 @@ function jobReferenceBlock(profileName, profile, data) {
     jobId || flavor || schedule || data.jobCapability || data.jobImplementation || data.jobWhy
   );
   if (!isJob2) return null;
-  const capability = typeof data.jobCapability === "string" && data.jobCapability.length > 0 ? data.jobCapability : profile.executable ? profile.name : null;
-  const implementation = typeof profile.implementation === "string" && profile.implementation.length > 0 ? profile.implementation : typeof profile.executable === "string" && profile.executable.length > 0 ? profile.executable : typeof data.jobImplementation === "string" && data.jobImplementation.length > 0 ? data.jobImplementation : profileName;
+  const capability = typeof data.jobCapability === "string" && data.jobCapability.length > 0 ? data.jobCapability : profile.implementation ? profile.name : null;
+  const implementation = typeof profile.implementation === "string" && profile.implementation.length > 0 ? profile.implementation : typeof data.jobImplementation === "string" && data.jobImplementation.length > 0 ? data.jobImplementation : profileName;
   const agent = typeof profile.agent === "string" && profile.agent.length > 0 ? profile.agent : typeof data.jobAgent === "string" && data.jobAgent.length > 0 ? data.jobAgent : null;
   const description = profile.describe.trim();
   const workflow = typeof data.workflowCapability === "string" && data.workflowCapability.length > 0 ? data.workflowCapability : null;
@@ -19799,11 +19758,11 @@ function jobReferenceBlock(profileName, profile, data) {
 async function runExecutable(profileName, input) {
   const stageStartedAt = Date.now();
   let finishRunIndex = null;
-  emitEvent(input.cwd, { executable: profileName, kind: "stage_start" });
+  emitEvent(input.cwd, { implementation: profileName, kind: "stage_start" });
   const finishAndEnd = (out) => {
     finishRunIndex?.(out);
     emitEvent(input.cwd, {
-      executable: profileName,
+      implementation: profileName,
       kind: "stage_end",
       durationMs: Date.now() - stageStartedAt,
       outcome: out.exitCode === 0 ? "ok" : "failed",
@@ -20012,7 +19971,7 @@ async function runExecutable(profileName, input) {
       capabilityRepoSlug: config.github?.owner && config.github?.repo ? `${config.github.owner}/${config.github.repo}` : process.env.GITHUB_REPOSITORY?.trim() || void 0,
       verifyToolMaxAttempts: profile.claudeCode.verifyAttempts ?? null,
       verifyConfig: profile.claudeCode.enableVerifyTool ? config : void 0,
-      executableName: profileName,
+      implementationName: profileName,
       settingSources: profile.claudeCode.settingSources
     });
   };
@@ -20022,7 +19981,7 @@ async function runExecutable(profileName, input) {
       const preLabel = entry.script ?? entry.shell ?? "<unknown>";
       if (!shouldRun(entry, ctx)) {
         emitEvent(input.cwd, {
-          executable: profileName,
+          implementation: profileName,
           kind: "preflight",
           name: preLabel,
           outcome: "skipped"
@@ -20033,7 +19992,7 @@ async function runExecutable(profileName, input) {
       if (entry.shell) {
         await runShellEntry(entry, ctx, profile);
         emitEvent(input.cwd, {
-          executable: profileName,
+          implementation: profileName,
           kind: "preflight",
           name: preLabel,
           durationMs: Date.now() - t0,
@@ -20044,7 +20003,7 @@ async function runExecutable(profileName, input) {
         if (!fn) return finishAndEnd({ exitCode: 99, reason: `preflight script not registered: ${entry.script}` });
         await fn(ctx, profile, entry.with);
         emitEvent(input.cwd, {
-          executable: profileName,
+          implementation: profileName,
           kind: "preflight",
           name: preLabel,
           durationMs: Date.now() - t0,
@@ -20067,7 +20026,7 @@ async function runExecutable(profileName, input) {
           reason: "composePrompt did not produce a prompt (ctx.data.prompt missing)"
         });
       }
-      emitEvent(input.cwd, { executable: profileName, kind: "agent_start" });
+      emitEvent(input.cwd, { implementation: profileName, kind: "agent_start" });
       try {
         agentResult = await invokeAgent(prompt);
       } catch (err) {
@@ -20077,7 +20036,7 @@ async function runExecutable(profileName, input) {
         });
       }
       emitEvent(input.cwd, {
-        executable: profileName,
+        implementation: profileName,
         kind: "agent_end",
         durationMs: agentResult.durationMs,
         outcome: agentResult.outcome === "completed" ? "ok" : "failed",
@@ -20104,7 +20063,7 @@ async function runExecutable(profileName, input) {
 `
         );
         emitEvent(input.cwd, {
-          executable: profileName,
+          implementation: profileName,
           kind: "postflight",
           name: entryLabel,
           outcome: "skipped"
@@ -20123,7 +20082,7 @@ async function runExecutable(profileName, input) {
 `);
         }
         emitEvent(input.cwd, {
-          executable: profileName,
+          implementation: profileName,
           kind: "postflight",
           name: entryLabel,
           outcome: "skipped"
@@ -20159,7 +20118,7 @@ async function runExecutable(profileName, input) {
             file,
             JSON.stringify(
               {
-                executable: profileName,
+                implementation: profileName,
                 postflight: label,
                 message: msg,
                 stack: err instanceof Error ? err.stack : void 0,
@@ -20176,7 +20135,7 @@ async function runExecutable(profileName, input) {
         if (ctx.output.exitCode === 0) ctx.output.exitCode = 99;
       }
       emitEvent(input.cwd, {
-        executable: profileName,
+        implementation: profileName,
         kind: "postflight",
         name: label,
         durationMs: Date.now() - t0,
@@ -20278,7 +20237,7 @@ async function runExecutableChain(profileName, input) {
         if (!afterJob) {
           return {
             exitCode: 99,
-            reason: `in-process return missing capability/action for ${after.executable ?? "unknown"}`
+            reason: `in-process return missing capability/action for ${handoffLabel(after)}`
           };
         }
         process.stdout.write(
@@ -20312,7 +20271,7 @@ async function runExecutableChain(profileName, input) {
     if (!nextJob) {
       return {
         exitCode: 99,
-        reason: `in-process hand-off missing capability/action for ${next.executable ?? "unknown"}`
+        reason: `in-process hand-off missing capability/action for ${handoffLabel(next)}`
       };
     }
     process.stdout.write(
@@ -20334,7 +20293,7 @@ async function runExecutableChain(profileName, input) {
     };
   }
   if (result.nextDispatch || result.nextJob) {
-    const pending = result.nextDispatch?.executable ?? result.nextDispatch?.workflow ?? result.nextJob?.implementation ?? result.nextJob?.workflow ?? result.nextJob?.capability ?? "unknown";
+    const pending = result.nextDispatch?.implementation ?? result.nextDispatch?.workflow ?? result.nextDispatch?.action ?? result.nextDispatch?.capability ?? 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}
 `);
   }
@@ -20347,13 +20306,16 @@ function handoffToJob(handoff) {
     action: handoff.action ?? handoff.capability,
     capability: handoff.capability,
     workflow: handoff.workflow,
-    implementation: handoff.implementation ?? handoff.executable,
+    implementation: handoff.implementation,
     cliArgs: handoff.cliArgs,
     flavor: "instant",
     saveReport: handoff.saveReport === true,
     resultTarget: handoff.resultTarget
   };
 }
+function handoffLabel(handoff) {
+  return handoff.implementation ?? handoff.workflow ?? handoff.action ?? handoff.capability ?? "unknown";
+}
 function clearStampedLifecycleLabels(profile, ctx) {
   const target = ctx.args.issue ?? ctx.args.pr;
   if (typeof target !== "number" || !Number.isFinite(target)) return;
@@ -20820,7 +20782,7 @@ async function runJob(job, base) {
   }
   const workflow = capabilityContext?.config.workflow ?? workflowContext?.config.workflow;
   const workflowIdentity = valid.workflow ?? capabilityIdentity ?? workflowContext?.slug;
-  const capabilitySelectedImplementation = resolvedCapability?.implementation ?? capabilityContext?.config.implementation ?? capabilityContext?.config.executable ?? capabilityContext?.config.implementations?.[0] ?? capabilityContext?.config.executables?.[0] ?? (capabilityContext?.config.role ? capabilityContext.slug : void 0) ?? (capabilityContext?.config.tickScript ? "capability-tick-scripted" : void 0);
+  const capabilitySelectedImplementation = resolvedCapability?.implementation ?? capabilityContext?.config.implementation ?? capabilityContext?.config.implementations?.[0] ?? (capabilityContext?.config.role ? capabilityContext.slug : void 0) ?? (capabilityContext?.config.tickScript ? "capability-tick-scripted" : void 0);
   const profileName = explicitImplementation ?? capabilitySelectedImplementation;
   if (workflow && shouldRunCapabilityWorkflow(valid, workflow, workflowIdentity, capabilitySelectedImplementation, base)) {
     const workflowCapability = capabilityContext ?? workflowContext;
@@ -21003,7 +20965,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 } : {},
@@ -21098,7 +21059,7 @@ function loadWorkflowContext(slug2, base) {
 function mintInstantJob(dispatch2, opts) {
   return {
     action: dispatch2.action,
-    implementation: dispatch2.implementation ?? dispatch2.executable,
+    implementation: dispatch2.implementation,
     capability: dispatch2.capability,
     why: opts?.why ?? dispatch2.why,
     agent: opts?.agent ?? DEFAULT_INSTANT_AGENT,
@@ -22071,8 +22032,8 @@ function cronMatchesInWindow(spec, end, windowSec) {
 // src/dispatch.ts
 init_registry();
 var POLITE_WORDS = /* @__PURE__ */ new Set(["please", "kindly", "hi", "hey", "hello", "thanks", "thank", "plz", "pls", "yo"]);
-function primaryNumericInputName(executable) {
-  const inputs = getProfileInputs(executable);
+function primaryNumericInputName(implementation) {
+  const inputs = getProfileInputs(implementation);
   if (!inputs) return null;
   const intInput = inputs.find((i) => i.type === "int" && i.required);
   return intInput?.name ?? null;
@@ -22093,7 +22054,6 @@ function routeResult(route, cliArgs, target, why) {
     action: route.action,
     capability: route.capability,
     implementation: route.implementation,
-    executable: route.executable,
     cliArgs: { ...route.cliArgs, ...cliArgs },
     target
   };
@@ -22323,7 +22283,6 @@ function dispatchScheduledWatches(opts) {
         action: exe.name,
         capability: exe.name,
         implementation: exe.name,
-        executable: exe.name,
         cliArgs: {},
         target: 0
       }
@@ -22678,7 +22637,7 @@ function detectPackageManager2(cwd) {
   return "npm";
 }
 function shouldChainScheduledWatch(match) {
-  return match.action === "goal-scheduler" || match.capability === "goal-scheduler" || match.implementation === "goal-scheduler" || match.executable === "goal-scheduler";
+  return match.action === "goal-scheduler" || match.capability === "goal-scheduler" || match.implementation === "goal-scheduler";
 }
 function shellOut(cmd, args, cwd, stream = true) {
   try {
@@ -22862,7 +22821,7 @@ async function runCi(argv) {
       applyCompanyStoreRuntimeConfig(inputs);
       const issueInput = parseInt(String(inputs?.issue_number ?? ""), 10);
       const sessionInput = String(inputs?.sessionId ?? "");
-      const capabilityInput = String(inputs?.capability ?? inputs?.executable ?? "").trim();
+      const capabilityInput = String(inputs?.capability ?? "").trim();
       const messageInput = String(inputs?.message ?? "").trim();
       const noTarget = !sessionInput && !(Number.isFinite(issueInput) && issueInput > 0);
       if (noTarget && capabilityInput) {
@@ -22886,13 +22845,12 @@ async function runCi(argv) {
       cliArgs: {}
     };
     const scheduledWatchRoute = manualGoalManager || capabilityRoute || workflowRoute ? void 0 : dispatchScheduledWatches({ force: true }).find(
-      (match) => match.action === forceRunAction || match.capability === forceRunAction || match.implementation === forceRunAction || match.executable === forceRunAction
+      (match) => match.action === forceRunAction || match.capability === forceRunAction || match.implementation === forceRunAction
     );
     const route = manualGoalManager ? {
       action: "goal-manager",
       capability: "goal-manager",
       implementation: "goal-manager",
-      executable: "goal-manager",
       cliArgs: forceRunCliArgs
     } : capabilityRoute ?? workflowRoute ?? scheduledWatchRoute;
     if (!route) {
@@ -22900,7 +22858,7 @@ async function runCi(argv) {
 `);
       return 64;
     }
-    if (route.executable === "goal-manager" && typeof forceRunCliArgs.goal !== "string") {
+    if (route.implementation === "goal-manager" && typeof forceRunCliArgs.goal !== "string") {
       process.stderr.write("[kody] manual goal-manager run requires message goal id\n");
       return 64;
     }
@@ -22942,7 +22900,7 @@ async function runCi(argv) {
         action: route.action,
         capability: route.capability,
         workflow: route.workflow,
-        implementation: route.implementation ?? route.executable,
+        implementation: route.implementation,
         cliArgs: { ...route.cliArgs, ...forceRunCliArgs },
         flavor: "instant",
         force: true
@@ -23071,7 +23029,7 @@ ${CI_HELP}`);
     const pm = args.packageManager ?? detectPackageManager2(cwd);
     process.stdout.write(`\u2192 kody: package manager = ${pm}
 `);
-    const buildOnly = dispatch2.implementation === "preview-build" || dispatch2.executable === "preview-build";
+    const buildOnly = dispatch2.implementation === "preview-build";
     if (args.skipInstall || buildOnly) {
       process.stdout.write(`\u2192 kody: skipping dep install (${buildOnly ? "build-only executable" : "--skip-install"})
 `);
@@ -23181,7 +23139,7 @@ async function runScheduledFanOut(cwd, args, opts) {
         mintScheduledJob({
           action: match.action,
           capability: match.capability,
-          implementation: match.implementation ?? match.executable,
+          implementation: match.implementation,
           cliArgs: match.cliArgs
         }),
         {
@@ -24282,7 +24240,7 @@ async function mcpHttpServer() {
         verifyToolDefinition({
           config,
           cwd: process.cwd(),
-          executable: "mcp-http"
+          implementation: "mcp-http"
         })
       ]
     },
@@ -26039,7 +25997,7 @@ function summarizeRun(events) {
   const durationMs = new Date(endedAt).getTime() - new Date(startedAt).getTime();
   const exitCodeRaw = lastEnd?.meta?.exitCode;
   const exitCode = typeof exitCodeRaw === "number" ? exitCodeRaw : null;
-  const executables = Array.from(new Set(sorted.map((e) => e.executable)));
+  const implementations = Array.from(new Set(sorted.map((e) => e.implementation)));
   let tIn = 0;
   let tOut = 0;
   let tCacheR = 0;
@@ -26057,7 +26015,7 @@ function summarizeRun(events) {
     startedAt,
     endedAt,
     durationMs,
-    executables,
+    implementations,
     exitCode,
     ok: exitCode === 0,
     totalInputTokens: tIn,
@@ -26065,15 +26023,15 @@ function summarizeRun(events) {
     totalCacheReadTokens: tCacheR
   };
 }
-function rollupByExecutable(events) {
-  const byExec = /* @__PURE__ */ new Map();
+function rollupByImplementation(events) {
+  const byImplementation = /* @__PURE__ */ new Map();
   for (const ev of events) {
     if (ev.kind !== "stage_end") continue;
-    if (!byExec.has(ev.executable)) byExec.set(ev.executable, []);
-    byExec.get(ev.executable).push(ev);
+    if (!byImplementation.has(ev.implementation)) byImplementation.set(ev.implementation, []);
+    byImplementation.get(ev.implementation).push(ev);
   }
   const rollups = [];
-  for (const [executable, stageEnds] of byExec) {
+  for (const [implementation, stageEnds] of byImplementation) {
     const durations = stageEnds.map((e) => e.durationMs ?? 0).filter((d) => d > 0).sort((a, b) => a - b);
     const ok = stageEnds.filter((e) => e.outcome === "ok").length;
     const failed = stageEnds.filter((e) => e.outcome === "failed").length;
@@ -26083,7 +26041,7 @@ function rollupByExecutable(events) {
     let tCacheC = 0;
     for (const ev of events) {
       if (ev.kind !== "agent_end") continue;
-      if (ev.executable !== executable) continue;
+      if (ev.implementation !== implementation) continue;
       const tokens = ev.meta?.tokens;
       if (tokens) {
         tIn += Number(tokens.input ?? 0);
@@ -26094,7 +26052,7 @@ function rollupByExecutable(events) {
     }
     const mean = durations.length > 0 ? durations.reduce((s, n) => s + n, 0) / durations.length : 0;
     rollups.push({
-      executable,
+      implementation,
       agentRuns: stageEnds.length,
       ok,
       failed,
@@ -26134,13 +26092,13 @@ async function runStats(argv) {
     process.stdout.write("no runs in the requested window\n");
     return 0;
   }
-  const byExec = rollupByExecutable(allEvents);
+  const byImplementation = rollupByImplementation(allEvents);
   if (opts.asJson) {
-    process.stdout.write(`${JSON.stringify({ agentRuns: runSummaries, byExecutable: byExec }, null, 2)}
+    process.stdout.write(`${JSON.stringify({ agentRuns: runSummaries, byImplementation }, null, 2)}
 `);
     return 0;
   }
-  printReport(runSummaries, byExec);
+  printReport(runSummaries, byImplementation);
   return 0;
 }
 function printReport(agentRuns, rollups) {
@@ -26168,9 +26126,9 @@ Kody run statistics \u2014 ${totalRuns} runs
 `
   );
   process.stdout.write(`
-Per-executable (stage_end events)
+Per-implementation (stage_end events)
 `);
-  const headers = ["executable", "runs", "ok", "failed", "p50", "p95", "mean", "tok-in", "tok-out", "cache-r"];
+  const headers = ["implementation", "runs", "ok", "failed", "p50", "p95", "mean", "tok-in", "tok-out", "cache-r"];
   const widths = [22, 6, 6, 7, 9, 9, 9, 10, 10, 10];
   process.stdout.write(`${headers.map((h, i) => h.padEnd(widths[i])).join("")}
 `);
@@ -26178,7 +26136,7 @@ Per-executable (stage_end events)
 `);
   for (const r of rollups) {
     const row = [
-      r.executable,
+      r.implementation,
       String(r.agentRuns),
       String(r.ok),
       String(r.failed),

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.
    */
@@ -440,7 +437,6 @@ export interface Context {
       capability?: string
       workflow?: string
       implementation?: string
-      executable?: string
       cliArgs: Record<string, unknown>
       saveReport?: boolean
       resultTarget?: CapabilityResultTarget
@@ -453,7 +449,6 @@ export interface Context {
       capability?: string
       workflow?: string
       implementation?: string
-      executable?: string
       cliArgs: Record<string, unknown>
       saveReport?: boolean
       resultTarget?: CapabilityResultTarget

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.346",
+  "version": "0.4.348",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,28 +12,6 @@
     "templates",
     "kody.config.schema.json"
   ],
-  "scripts": {
-    "kody:run": "tsx bin/kody.ts",
-    "serve": "tsx bin/kody.ts serve",
-    "serve:vscode": "tsx bin/kody.ts serve vscode",
-    "serve:claude": "tsx bin/kody.ts serve claude",
-    "clean:dist": "node scripts/clean-dist.cjs",
-    "build": "pnpm clean:dist && tsup && node scripts/copy-assets.cjs",
-    "check:modularity": "tsx scripts/check-script-modularity.ts",
-    "pretest": "pnpm check:modularity",
-    "test": "vitest run tests/unit tests/int --coverage",
-    "posttest": "tsx scripts/check-coverage-floor.ts",
-    "test:smoke": "vitest run tests/smoke --no-coverage",
-    "test:e2e": "vitest run tests/e2e --no-coverage",
-    "test:all": "vitest run tests --no-coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check",
-    "lint:fix": "biome check --write",
-    "format": "biome format --write",
-    "verify:package": "node scripts/verify-package-tarball.cjs",
-    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner",
-    "prepublishOnly": "pnpm typecheck && vitest run tests/unit tests/int --no-coverage && pnpm build && pnpm verify:package"
-  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
@@ -57,5 +35,26 @@
     "url": "git+https://github.com/aharonyaircohen/kody-engine.git"
   },
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
-  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
-}
+  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues",
+  "scripts": {
+    "kody:run": "tsx bin/kody.ts",
+    "serve": "tsx bin/kody.ts serve",
+    "serve:vscode": "tsx bin/kody.ts serve vscode",
+    "serve:claude": "tsx bin/kody.ts serve claude",
+    "clean:dist": "node scripts/clean-dist.cjs",
+    "build": "pnpm clean:dist && tsup && node scripts/copy-assets.cjs",
+    "check:modularity": "tsx scripts/check-script-modularity.ts",
+    "pretest": "pnpm check:modularity",
+    "test": "vitest run tests/unit tests/int --coverage",
+    "posttest": "tsx scripts/check-coverage-floor.ts",
+    "test:smoke": "vitest run tests/smoke --no-coverage",
+    "test:e2e": "vitest run tests/e2e --no-coverage",
+    "test:all": "vitest run tests --no-coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "format": "biome format --write",
+    "verify:package": "node scripts/verify-package-tarball.cjs",
+    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner"
+  }
+}