@kody-ade/kody-engine 0.4.342 → 0.4.344

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.342",
+      version: "0.4.344",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
       license: "MIT",
       type: "module",
@@ -4951,11 +4951,11 @@ function emptyState() {
     core: {
       phase: "idle",
       status: "pending",
-      currentExecutable: null,
+      currentImplementation: null,
       lastOutcome: null,
       attempts: {}
     },
-    executables: {},
+    implementations: {},
     artifacts: {},
     jobs: {},
     history: []
@@ -4972,27 +4972,33 @@ 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;
   return {
     schemaVersion: 1,
-    core: { ...emptyState().core, ...parsed.core },
-    executables: parsed.executables ?? {},
+    core: { ...emptyState().core, ...coreWithoutLegacy, currentImplementation },
+    implementations,
     artifacts: parsed.artifacts && typeof parsed.artifacts === "object" ? parsed.artifacts : {},
     jobs: normalizeJobs(parsed.jobs),
-    history: Array.isArray(parsed.history) ? parsed.history : [],
+    history: normalizeHistory(parsed.history),
     flow: parsed.flow
   };
 }
-function reduce(state, executable, action, phase, agent, job) {
+function reduce(state, implementation, action, phase, agent, job) {
   if (!action) return state;
-  const newAttempts = { ...state.core.attempts, [executable]: (state.core.attempts[executable] ?? 0) + 1 };
-  const newExecutables = {
-    ...state.executables,
-    [executable]: { ...state.executables[executable] ?? { lastAction: null }, lastAction: action }
+  const newAttempts = { ...state.core.attempts, [implementation]: (state.core.attempts[implementation] ?? 0) + 1 };
+  const newImplementations = {
+    ...state.implementations,
+    [implementation]: { ...state.implementations[implementation] ?? { lastAction: null }, lastAction: action }
   };
   const ranAsAgent = typeof agent === "string" && agent.length > 0 ? agent : void 0;
   const entry = {
     timestamp: action.timestamp,
-    executable,
+    implementation,
     action: action.type,
     note: noteFromAction(action),
     agent: ranAsAgent,
@@ -5003,19 +5009,19 @@ function reduce(state, executable, action, phase, agent, job) {
     ...job?.runUrl ? { runUrl: job.runUrl } : {}
   };
   const newHistory = [...state.history, entry].slice(-HISTORY_MAX_ENTRIES);
-  const newJobs = reduceJobs(state.jobs ?? {}, executable, action, agent, job);
+  const newJobs = reduceJobs(state.jobs ?? {}, implementation, action, agent, job);
   return {
     schemaVersion: 1,
     core: {
       ...state.core,
       attempts: newAttempts,
       lastOutcome: action,
-      currentExecutable: executable,
+      currentImplementation: implementation,
       ranAsAgent: ranAsAgent ?? null,
       status: statusFromAction(action),
       phase: phaseFromAction(action, phase)
     },
-    executables: newExecutables,
+    implementations: newImplementations,
     artifacts: { ...state.artifacts ?? {} },
     jobs: newJobs,
     history: newHistory,
@@ -5029,7 +5035,7 @@ function upsertTaskJobs(state, planned, timestamp) {
     const prior = jobs[plan.id];
     jobs[plan.id] = {
       id: plan.id,
-      executable: plan.executable,
+      implementation: plan.implementation,
       ...plan.capability ?? prior?.capability ? { capability: plan.capability ?? prior?.capability } : {},
       ...plan.agent ?? prior?.agent ? { agent: plan.agent ?? prior?.agent } : {},
       ...plan.flavor ?? prior?.flavor ? { flavor: plan.flavor ?? prior?.flavor } : {},
@@ -5056,9 +5062,9 @@ function nextPendingTaskJob(state, ids) {
   }
   return null;
 }
-function reduceJobs(jobs, executable, action, agent, job) {
+function reduceJobs(jobs, implementation, action, agent, job) {
   const status = statusFromAction(action);
-  const id = job?.jobKey || job?.jobId || `legacy:${executable}`;
+  const id = job?.jobKey || job?.jobId || `legacy:${implementation}`;
   const prior = jobs[id];
   const note = noteFromAction(action);
   const prUrl = job?.prUrl ?? prUrlFromAction(action);
@@ -5075,7 +5081,7 @@ function reduceJobs(jobs, executable, action, agent, job) {
   const ranAsAgent = typeof agent === "string" && agent.length > 0 ? agent : job?.agent;
   const next = {
     id,
-    executable: job?.executable ?? prior?.executable ?? executable,
+    implementation: job?.implementation ?? prior?.implementation ?? implementation,
     ...job?.capability ?? prior?.capability ? { capability: job?.capability ?? prior?.capability } : {},
     ...ranAsAgent ?? prior?.agent ? { agent: ranAsAgent ?? prior?.agent } : {},
     ...job?.flavor ?? prior?.flavor ? { flavor: job?.flavor ?? prior?.flavor } : {},
@@ -5118,11 +5124,12 @@ function normalizeJobs(input) {
   for (const [key, value] of Object.entries(input)) {
     if (!value || typeof value !== "object" || Array.isArray(value)) continue;
     const raw = value;
-    if (typeof raw.id !== "string" || typeof raw.executable !== "string") continue;
+    const implementation = typeof raw.implementation === "string" ? raw.implementation : typeof raw.executable === "string" ? raw.executable : void 0;
+    if (typeof raw.id !== "string" || typeof implementation !== "string") continue;
     if (!isStatus(raw.status)) continue;
     out[key] = {
       id: raw.id,
-      executable: raw.executable,
+      implementation,
       ...typeof raw.capability === "string" ? { capability: raw.capability } : {},
       ...typeof raw.agent === "string" ? { agent: raw.agent } : {},
       ...raw.flavor === "instant" || raw.flavor === "scheduled" ? { flavor: raw.flavor } : {},
@@ -5140,6 +5147,31 @@ function normalizeJobs(input) {
   }
   return out;
 }
+function normalizeHistory(input) {
+  if (!Array.isArray(input)) return [];
+  const out = [];
+  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;
+    if (typeof raw.timestamp !== "string" || typeof implementation !== "string" || typeof raw.action !== "string") {
+      continue;
+    }
+    out.push({
+      timestamp: raw.timestamp,
+      implementation,
+      action: raw.action,
+      ...typeof raw.note === "string" ? { note: raw.note } : {},
+      ...typeof raw.agent === "string" ? { agent: raw.agent } : {},
+      ...typeof raw.jobId === "string" ? { jobId: raw.jobId } : {},
+      ...raw.flavor === "instant" || raw.flavor === "scheduled" ? { flavor: raw.flavor } : {},
+      ...typeof raw.schedule === "string" ? { schedule: raw.schedule } : {},
+      ...isStatus(raw.status) ? { status: raw.status } : {},
+      ...typeof raw.runUrl === "string" ? { runUrl: raw.runUrl } : {}
+    });
+  }
+  return out;
+}
 function isTaskJobRun(input) {
   if (!input || typeof input !== "object" || Array.isArray(input)) return false;
   const run = input;
@@ -5156,8 +5188,8 @@ function renderStateComment(state) {
     lines.push(`- **Flow:** \`${state.flow.name}\` (step: \`${state.flow.step}\`)`);
   }
   lines.push(`- **Phase:** \`${state.core.phase}\`  **Status:** \`${state.core.status}\``);
-  if (state.core.currentExecutable) {
-    lines.push(`- **Last executable:** \`${state.core.currentExecutable}\``);
+  if (state.core.currentImplementation) {
+    lines.push(`- **Last implementation:** \`${state.core.currentImplementation}\``);
   }
   if (state.core.ranAsAgent) {
     lines.push(`- **Ran as:** \`${state.core.ranAsAgent}\``);
@@ -5185,7 +5217,7 @@ function renderStateComment(state) {
     const recent = state.history.slice(-10).reverse();
     for (const h of recent) {
       const note = h.note ? ` \u2014 ${h.note}` : "";
-      lines.push(`- \`${h.timestamp}\` **${h.executable}** \u2192 \`${h.action}\`${note}`);
+      lines.push(`- \`${h.timestamp}\` **${h.implementation}** \u2192 \`${h.action}\`${note}`);
     }
     lines.push("");
   }
@@ -5193,7 +5225,7 @@ function renderStateComment(state) {
     lines.push("### Jobs");
     lines.push("");
     for (const job of jobEntries) {
-      lines.push(`- \`${job.id}\` **${job.executable}** \u2192 \`${job.status}\` (${job.agentRuns.length} runs)`);
+      lines.push(`- \`${job.id}\` **${job.implementation}** \u2192 \`${job.status}\` (${job.agentRuns.length} runs)`);
     }
     lines.push("");
   }
@@ -5210,7 +5242,7 @@ function renderStateComment(state) {
         core: state.core,
         artifacts: state.artifacts ?? {},
         jobs: state.jobs ?? {},
-        executables: state.executables,
+        implementations: state.implementations,
         history: state.history,
         ...state.flow ? { flow: state.flow } : {}
       },
@@ -5758,7 +5790,7 @@ async function runContainerLoop(profile, ctx, input) {
     }
     const priorState = readContainerState(ctx, child, reader);
     if (priorState.core?.prUrl) knownPrUrl = priorState.core.prUrl;
-    const priorAction = priorState.executables?.[child.exec]?.lastAction;
+    const priorAction = priorState.implementations?.[child.exec]?.lastAction;
     let actionType2;
     if (priorAction && /_COMPLETED$/i.test(priorAction.type)) {
       process.stderr.write(`[kody container] skipping ${child.exec}: already completed (${priorAction.type})
@@ -5851,7 +5883,7 @@ async function runContainerLoop(profile, ctx, input) {
       const next = readContainerState(ctx, child, reader);
       if (next.core?.prUrl) knownPrUrl = next.core.prUrl;
       const nextAttempts = next.core?.attempts?.[child.exec] ?? 0;
-      const nextChildAction = next.executables?.[child.exec]?.lastAction;
+      const nextChildAction = next.implementations?.[child.exec]?.lastAction;
       const childWrote = nextAttempts > priorAttempts && nextChildAction != null;
       if (childWrote && nextChildAction) {
         actionType2 = nextChildAction.type;
@@ -5872,7 +5904,7 @@ async function runContainerLoop(profile, ctx, input) {
           next.core = {
             phase: "idle",
             status: "pending",
-            currentExecutable: null,
+            currentImplementation: null,
             lastOutcome: synthetic,
             // Bump attempts here too — a synthesized action is, semantically,
             // a saveTaskState write that just didn't happen mechanically.
@@ -6689,7 +6721,7 @@ var init_evaluateAgencyBoundaries = __esm({
     init_agencyBoundaryEval();
     init_capabilityResult();
     evaluateAgencyBoundariesScript = async (ctx, profile, agentResult) => {
-      const results = collectResults(ctx.data.capabilityResults ?? ctx.data.dutyResults, agentResult);
+      const results = collectResults(ctx.data.capabilityResults, agentResult);
       const capabilityKind = agencyBoundaryCapabilityKind(ctx.data, profile);
       const capability = agencyBoundaryCapability(ctx.data, profile);
       const evalResult = evaluateAgencyBoundaries({
@@ -7033,7 +7065,7 @@ function jobMetaFromData(data) {
     schedule: typeof data.jobSchedule === "string" ? data.jobSchedule : void 0,
     runUrl: typeof data.runUrl === "string" ? data.runUrl : void 0,
     capability: typeof data.jobCapability === "string" ? data.jobCapability : void 0,
-    executable: typeof data.jobExecutable === "string" ? data.jobExecutable : void 0,
+    implementation: typeof data.jobImplementation === "string" ? data.jobImplementation : typeof data.jobExecutable === "string" ? data.jobExecutable : void 0,
     target: typeof data.jobTarget === "number" ? data.jobTarget : void 0,
     agent: typeof data.jobAgent === "string" ? data.jobAgent : void 0,
     why: typeof data.jobWhy === "string" ? data.jobWhy : void 0
@@ -7046,7 +7078,7 @@ function applyStandaloneFinalState(state, ctx, profile) {
   const succeeded = ctx.output.exitCode === 0 && (hasPr || noDeliveryNeeded);
   state.core.phase = succeeded ? hasPr ? "reviewing" : "shipped" : "failed";
   state.core.status = succeeded ? "succeeded" : "failed";
-  state.core.currentExecutable = null;
+  state.core.currentImplementation = null;
 }
 function synthesizeAction(ctx) {
   const ok = ctx.output.exitCode === 0;
@@ -7071,9 +7103,9 @@ var init_saveTaskState = __esm({
       const number = ctx.data.commentTargetNumber;
       const state = ctx.data.taskState;
       if (!target || !number || !state) return;
-      const executable = profile.name;
+      const implementation = profile.name;
       const action = ctx.data.action ?? synthesizeAction(ctx);
-      const next = reduce(state, executable, action, profile.phase, profile.agent, {
+      const next = reduce(state, implementation, action, profile.phase, profile.agent, {
         ...jobMetaFromData(ctx.data),
         ...ctx.output.prUrl ? { prUrl: ctx.output.prUrl } : {}
       });
@@ -10886,7 +10918,7 @@ var init_applyCapabilityReports = __esm({
     init_issue();
     applyCapabilityReports = async (ctx, _profile, agentResult) => {
       const reports = collectReports(ctx.data.capabilityReports, agentResult);
-      const results = collectResults2(ctx.data.capabilityResults ?? ctx.data.dutyResults, agentResult);
+      const results = collectResults2(ctx.data.capabilityResults, 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);
@@ -12831,8 +12863,9 @@ var init_jobIdentity = __esm({
 function taskJobToJob(job, issueArg) {
   const target = typeof job.target === "number" ? job.target : typeof issueArg === "number" ? issueArg : void 0;
   return {
-    capability: job.capability ?? job.executable,
-    executable: job.executable,
+    capability: job.capability ?? job.implementation,
+    implementation: job.implementation,
+    executable: job.implementation,
     ...job.reason ? { why: job.reason } : {},
     ...job.agent ? { agent: job.agent } : {},
     ...job.schedule ? { schedule: job.schedule } : {},
@@ -13268,7 +13301,7 @@ var init_finalizeTerminal = __esm({
         }
       }
       if (!state) return;
-      const alreadyTerminal = state.core.phase === phase && state.core.status === status && state.core.currentExecutable === null;
+      const alreadyTerminal = state.core.phase === phase && state.core.status === status && state.core.currentImplementation === null;
       if (alreadyTerminal) return;
       const next = {
         ...state,
@@ -13276,7 +13309,7 @@ var init_finalizeTerminal = __esm({
           ...state.core,
           phase,
           status,
-          currentExecutable: null
+          currentImplementation: null
         }
       };
       ctx.data.taskState = next;
@@ -13355,7 +13388,7 @@ var init_finishFlow = __esm({
       if (terminal && state) {
         state.core.phase = terminal.phase;
         state.core.status = terminal.status;
-        state.core.currentExecutable = null;
+        state.core.currentImplementation = null;
         const target = ctx.data.commentTargetType ?? "issue";
         const targetNumber = ctx.data.commentTargetNumber ?? issueNumber;
         try {
@@ -16112,8 +16145,9 @@ function taskJobSpecToJob(spec, issueNumber) {
   const cliArgs = spec.cliArgs ?? { issue: issueNumber };
   const target = typeof spec.target === "number" ? spec.target : targetFromCliArgs(cliArgs) ?? issueNumber;
   return {
-    capability: spec.capability ?? spec.executable,
-    executable: spec.executable,
+    capability: spec.capability ?? spec.implementation,
+    implementation: spec.implementation,
+    executable: spec.implementation,
     why: spec.reason,
     agent: spec.agent,
     schedule: spec.schedule,
@@ -16127,9 +16161,9 @@ function normalizeSpec(input, index) {
     throw new Error(`task job plan entry ${index} must be an object`);
   }
   const raw = input;
-  const executable = typeof raw.executable === "string" ? raw.executable.trim() : "";
-  if (!/^[a-z][a-z0-9-]*$/.test(executable)) {
-    throw new Error(`task job plan entry ${index} must have a valid executable`);
+  const implementation = typeof raw.implementation === "string" ? raw.implementation.trim() : typeof raw.executable === "string" ? raw.executable.trim() : "";
+  if (!/^[a-z][a-z0-9-]*$/.test(implementation)) {
+    throw new Error(`task job plan entry ${index} must have a valid implementation`);
   }
   const cliArgs = raw.cliArgs;
   if (cliArgs !== void 0 && (!cliArgs || typeof cliArgs !== "object" || Array.isArray(cliArgs))) {
@@ -16140,7 +16174,7 @@ function normalizeSpec(input, index) {
     throw new Error(`task job plan entry ${index} flavor must be "instant" or "scheduled"`);
   }
   return {
-    executable,
+    implementation,
     ...typeof raw.capability === "string" && raw.capability.trim() ? { capability: raw.capability.trim() } : {},
     ...typeof raw.reason === "string" && raw.reason.trim() ? { reason: raw.reason.trim() } : {},
     ...typeof raw.agent === "string" && raw.agent.trim() ? { agent: raw.agent.trim() } : {},
@@ -16152,9 +16186,10 @@ function normalizeSpec(input, index) {
   };
 }
 function jobToPlannedTaskJob(job) {
+  const implementation = job.implementation ?? job.executable ?? job.capability ?? "unknown";
   return {
     id: stableJobKey(job),
-    executable: job.executable ?? job.capability ?? "unknown",
+    implementation,
     capability: job.capability ?? job.action ?? job.executable ?? "unknown",
     ...job.agent ? { agent: job.agent } : {},
     ...job.flavor ? { flavor: job.flavor } : {},
@@ -19713,9 +19748,8 @@ function collectShellSideChannels(ctx, stdout) {
   }
   const capabilityResults = parseCapabilityResultsFromText(stdout);
   if (capabilityResults.length > 0) {
-    const prior = Array.isArray(ctx.data.capabilityResults) ? ctx.data.capabilityResults : Array.isArray(ctx.data.dutyResults) ? ctx.data.dutyResults : [];
+    const prior = Array.isArray(ctx.data.capabilityResults) ? ctx.data.capabilityResults : [];
     ctx.data.capabilityResults = [...prior, ...capabilityResults];
-    ctx.data.dutyResults = ctx.data.capabilityResults;
   }
 }
 function operatorRequestBlock(why) {
@@ -20310,8 +20344,8 @@ async function runExecutableChain(profileName, input) {
   return result;
 }
 function handoffToJob(handoff) {
-  const dutyOrAction = handoff.workflow ?? handoff.action ?? handoff.capability;
-  if (!dutyOrAction) return null;
+  const capabilityOrAction = handoff.workflow ?? handoff.action ?? handoff.capability;
+  if (!capabilityOrAction) return null;
   return {
     action: handoff.action ?? handoff.capability,
     capability: handoff.capability,

package/package.json

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