@kody-ade/kody-engine 0.4.314 → 0.4.316

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.314",
+      version: "0.4.316",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
       license: "MIT",
       type: "module",
@@ -1909,6 +1909,7 @@ function parseCapabilityConfig(raw) {
     implementation: stringField(raw.implementation ?? raw.executable),
     executable: stringField(raw.executable),
     tickScript: stringField(raw.tickScript),
+    capabilityKind: parseCapabilityKind(raw.capabilityKind),
     disabled: typeof raw.disabled === "boolean" ? raw.disabled : void 0,
     internal: typeof raw.internal === "boolean" ? raw.internal : void 0,
     public: typeof raw.public === "boolean" ? raw.public : void 0,
@@ -1927,6 +1928,9 @@ function parseCapabilityConfig(raw) {
     workflow: parseCapabilityWorkflow(raw.workflow)
   };
 }
+function parseCapabilityKind(raw) {
+  return raw === "observe" || raw === "act" || raw === "verify" ? raw : void 0;
+}
 function parseCapabilityToolMode(raw) {
   if (raw === void 0 || raw === null || raw === "") return void 0;
   if (raw === "lock" || raw === "append") return raw;
@@ -2154,7 +2158,7 @@ var init_companyStore = __esm({
   "src/companyStore.ts"() {
     "use strict";
     DEFAULT_COMPANY_STORE = "aharonyaircohen/kody-company-store";
-    DEFAULT_COMPANY_STORE_REF = "stable";
+    DEFAULT_COMPANY_STORE_REF = "main";
     STORE_ENV = "KODY_COMPANY_STORE";
     REF_ENV = "KODY_COMPANY_STORE_REF";
     CACHE_ENV = "KODY_COMPANY_STORE_CACHE";
@@ -3792,6 +3796,89 @@ var init_gha = __esm({
   }
 });
 
+// src/agencyBoundaryEval.ts
+function evaluateAgencyBoundaries(input) {
+  const findings = [];
+  const results = input.results ?? [];
+  findings.push(evaluateObserveBoundary(input.capabilityKind, results));
+  findings.push(evaluateVerifyBoundary(input.capabilityKind, results));
+  findings.push(evaluateGoalOwnershipBoundary(results));
+  return {
+    version: 1,
+    status: findings.some((finding) => finding.status === "fail") ? "fail" : "pass",
+    ...input.capability ? { capability: input.capability } : {},
+    ...input.capabilityKind ? { capabilityKind: input.capabilityKind } : {},
+    findings
+  };
+}
+function evaluateObserveBoundary(capabilityKind, results) {
+  if (capabilityKind !== "observe") {
+    return pass("observe-does-not-act", "capability is not observe", { capabilityKind });
+  }
+  const actionResults = results.filter(resultLooksLikeAction);
+  if (actionResults.length === 0) {
+    return pass("observe-does-not-act", "observe capability reported facts without action output", {
+      resultCount: results.length
+    });
+  }
+  return fail("observe-does-not-act", "observe capability returned action-shaped output", {
+    resultCount: results.length,
+    actionResults: actionResults.map(resultSummary)
+  });
+}
+function evaluateVerifyBoundary(capabilityKind, results) {
+  if (capabilityKind !== "verify") {
+    return pass("verify-does-not-fix", "capability is not verify", { capabilityKind });
+  }
+  const actionResults = results.filter(resultLooksLikeAction);
+  if (actionResults.length === 0) {
+    return pass("verify-does-not-fix", "verify capability returned verdict evidence without action output", {
+      resultCount: results.length
+    });
+  }
+  return fail("verify-does-not-fix", "verify capability returned fix/change output", {
+    resultCount: results.length,
+    actionResults: actionResults.map(resultSummary)
+  });
+}
+function evaluateGoalOwnershipBoundary(results) {
+  const targetBearing = results.filter((result) => result.target?.type === "goal");
+  if (targetBearing.length === 0) {
+    return pass("capability-does-not-own-goal-progress", "capability output is parent-neutral", {
+      resultCount: results.length
+    });
+  }
+  return fail("capability-does-not-own-goal-progress", "capability output names a goal target", {
+    resultCount: results.length,
+    targetBearingResults: targetBearing.map(resultSummary)
+  });
+}
+function resultLooksLikeAction(result) {
+  if (result.status === "changed") return true;
+  return Object.keys(result.facts).some((key) => ACTION_FACT_KEYS.has(key));
+}
+function resultSummary(result) {
+  return {
+    status: result.status,
+    summary: result.summary,
+    target: result.target,
+    actionFactKeys: Object.keys(result.facts).filter((key) => ACTION_FACT_KEYS.has(key))
+  };
+}
+function pass(rule, message, evidence) {
+  return { rule, status: "pass", message, evidence };
+}
+function fail(rule, message, evidence) {
+  return { rule, status: "fail", message, evidence };
+}
+var ACTION_FACT_KEYS;
+var init_agencyBoundaryEval = __esm({
+  "src/agencyBoundaryEval.ts"() {
+    "use strict";
+    ACTION_FACT_KEYS = /* @__PURE__ */ new Set(["changedResources", "createdResources", "actionResult"]);
+  }
+});
+
 // src/capabilityReport.ts
 function parseCapabilityReportsFromText(text) {
   const reports = [];
@@ -4311,7 +4398,7 @@ function loadProfile(profilePath) {
         executable: execRef,
         internal: typeof r.internal === "boolean" ? r.internal : base.internal,
         public: typeof r.public === "boolean" ? r.public : base.public,
-        capabilityKind: parseCapabilityKind(r.capabilityKind) ?? base.capabilityKind,
+        capabilityKind: parseCapabilityKind2(r.capabilityKind) ?? base.capabilityKind,
         slug: typeof r.slug === "string" && r.slug.trim() ? r.slug.trim() : base.slug,
         title: typeof r.title === "string" && r.title.trim() ? r.title.trim() : base.title,
         skills: parseStringArray2(r.skills) ?? base.skills,
@@ -4365,7 +4452,7 @@ function loadProfile(profilePath) {
     executable: void 0,
     internal: typeof r.internal === "boolean" ? r.internal : void 0,
     public: typeof r.public === "boolean" ? r.public : void 0,
-    capabilityKind: parseCapabilityKind(r.capabilityKind),
+    capabilityKind: parseCapabilityKind2(r.capabilityKind),
     slug: typeof r.slug === "string" && r.slug.trim() ? r.slug.trim() : void 0,
     title: typeof r.title === "string" && r.title.trim() ? r.title.trim() : void 0,
     skills: parseStringArray2(r.skills),
@@ -4472,7 +4559,7 @@ function parseStringArray2(raw) {
   const values = raw.map((t) => String(t).trim()).filter(Boolean);
   return values.length > 0 ? values : void 0;
 }
-function parseCapabilityKind(raw) {
+function parseCapabilityKind2(raw) {
   return raw === "observe" || raw === "act" || raw === "verify" ? raw : void 0;
 }
 function parseInputs(p, raw) {
@@ -9888,10 +9975,10 @@ function refreshReportOrFail(ctx, goalId, state, evidenceItems) {
       evidenceItems
     });
   } catch (err) {
-    fail(ctx, err instanceof Error ? err.message : String(err));
+    fail2(ctx, err instanceof Error ? err.message : String(err));
   }
 }
-function fail(ctx, reason) {
+function fail2(ctx, reason) {
   ctx.output.reason = ctx.output.reason ? `${ctx.output.reason}; ${reason}` : reason;
   if (ctx.output.exitCode === 0) ctx.output.exitCode = 99;
 }
@@ -12331,90 +12418,20 @@ var init_ensurePr = __esm({
   }
 });
 
-// src/agencyBoundaryEval.ts
-function evaluateAgencyBoundaries(input) {
-  const findings = [];
-  const results = input.results ?? [];
-  findings.push(evaluateObserveBoundary(input.capabilityKind, results));
-  findings.push(evaluateVerifyBoundary(input.capabilityKind, results));
-  findings.push(evaluateGoalOwnershipBoundary(results));
-  return {
-    version: 1,
-    status: findings.some((finding) => finding.status === "fail") ? "fail" : "pass",
-    ...input.capability ? { capability: input.capability } : {},
-    ...input.capabilityKind ? { capabilityKind: input.capabilityKind } : {},
-    findings
-  };
-}
-function evaluateObserveBoundary(capabilityKind, results) {
-  if (capabilityKind !== "observe") {
-    return pass("observe-does-not-act", "capability is not observe", { capabilityKind });
-  }
-  const actionResults = results.filter(resultLooksLikeAction);
-  if (actionResults.length === 0) {
-    return pass("observe-does-not-act", "observe capability reported facts without action output", {
-      resultCount: results.length
-    });
-  }
-  return fail2("observe-does-not-act", "observe capability returned action-shaped output", {
-    resultCount: results.length,
-    actionResults: actionResults.map(resultSummary)
-  });
-}
-function evaluateVerifyBoundary(capabilityKind, results) {
-  if (capabilityKind !== "verify") {
-    return pass("verify-does-not-fix", "capability is not verify", { capabilityKind });
-  }
-  const actionResults = results.filter(resultLooksLikeAction);
-  if (actionResults.length === 0) {
-    return pass("verify-does-not-fix", "verify capability returned verdict evidence without action output", {
-      resultCount: results.length
-    });
-  }
-  return fail2("verify-does-not-fix", "verify capability returned fix/change output", {
-    resultCount: results.length,
-    actionResults: actionResults.map(resultSummary)
-  });
-}
-function evaluateGoalOwnershipBoundary(results) {
-  const targetBearing = results.filter((result) => result.target?.type === "goal");
-  if (targetBearing.length === 0) {
-    return pass("capability-does-not-own-goal-progress", "capability output is parent-neutral", {
-      resultCount: results.length
-    });
-  }
-  return fail2("capability-does-not-own-goal-progress", "capability output names a goal target", {
-    resultCount: results.length,
-    targetBearingResults: targetBearing.map(resultSummary)
-  });
-}
-function resultLooksLikeAction(result) {
-  if (result.status === "changed") return true;
-  return Object.keys(result.facts).some((key) => ACTION_FACT_KEYS.has(key));
-}
-function resultSummary(result) {
-  return {
-    status: result.status,
-    summary: result.summary,
-    target: result.target,
-    actionFactKeys: Object.keys(result.facts).filter((key) => ACTION_FACT_KEYS.has(key))
-  };
+// src/scripts/evaluateAgencyBoundaries.ts
+function shouldEvaluateAgencyBoundaries(data, profile) {
+  return Boolean(agencyBoundaryCapabilityKind(data, profile));
 }
-function pass(rule, message, evidence) {
-  return { rule, status: "pass", message, evidence };
+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 fail2(rule, message, evidence) {
-  return { rule, status: "fail", message, evidence };
+function agencyBoundaryCapabilityKind(data, profile) {
+  const fromJob = data.jobCapabilityKind;
+  if (fromJob === "observe" || fromJob === "act" || fromJob === "verify") return fromJob;
+  return profile.capabilityKind;
 }
-var ACTION_FACT_KEYS;
-var init_agencyBoundaryEval = __esm({
-  "src/agencyBoundaryEval.ts"() {
-    "use strict";
-    ACTION_FACT_KEYS = /* @__PURE__ */ new Set(["changedResources", "createdResources", "actionResult"]);
-  }
-});
-
-// src/scripts/evaluateAgencyBoundaries.ts
 function collectResults2(raw, agentResult) {
   const out = [];
   if (Array.isArray(raw)) {
@@ -12434,9 +12451,11 @@ var init_evaluateAgencyBoundaries = __esm({
     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: profile.name,
-        capabilityKind: profile.capabilityKind,
+        capability,
+        capabilityKind,
         results
       });
       ctx.data.agencyBoundaryEval = evalResult;
@@ -18939,7 +18958,7 @@ async function runExecutable(profileName, input) {
         }
       });
     }
-    for (const entry of profile.scripts.postflight) {
+    for (const entry of postflightEntriesForRun(profile, ctx)) {
       const entryLabel = entry.script ?? entry.shell ?? "<unknown>";
       if (shouldBlockMutatingPostflight(entry.script, ctx.output.exitCode)) {
         if (entry.script === "commitAndPush" && ctx.data.commitResult === void 0) {
@@ -19067,6 +19086,30 @@ async function runExecutable(profileName, input) {
     }
   }
 }
+function postflightEntriesForRun(profile, ctx) {
+  const entries = profile.scripts.postflight;
+  if (!shouldEvaluateAgencyBoundaries(ctx.data, profile)) return entries;
+  if (entries.some((entry) => entry.script === "evaluateAgencyBoundaries")) return entries;
+  const evalEntry = { script: "evaluateAgencyBoundaries" };
+  const afterParser = lastIndexOfScript(entries, /* @__PURE__ */ new Set(["parseAgentResult", "parseJobStateFromAgentResult"]));
+  if (afterParser >= 0) {
+    return [...entries.slice(0, afterParser + 1), evalEntry, ...entries.slice(afterParser + 1)];
+  }
+  const beforeStateChange = entries.findIndex(
+    (entry) => isMutatingPostflight(entry.script) || entry.script === "writeJobStateFile" || entry.script === "saveTaskState"
+  );
+  if (beforeStateChange >= 0) {
+    return [...entries.slice(0, beforeStateChange), evalEntry, ...entries.slice(beforeStateChange)];
+  }
+  return [...entries, evalEntry];
+}
+function lastIndexOfScript(entries, names) {
+  for (let i = entries.length - 1; i >= 0; i--) {
+    const entry = entries[i];
+    if (entry?.script && names.has(entry.script)) return i;
+  }
+  return -1;
+}
 async function runExecutableChain(profileName, input) {
   let result = await runExecutable(profileName, input);
   let chainData = {
@@ -19451,6 +19494,7 @@ var init_executor = __esm({
     init_scripts();
     init_stateWorkspace();
     init_subagents();
+    init_evaluateAgencyBoundaries();
     init_task_artifacts();
     init_tools();
     MUTATING_POSTFLIGHTS = /* @__PURE__ */ new Set([
@@ -19682,6 +19726,7 @@ 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;
     preloadedData.capabilityIntent = capabilityContext.body;
     preloadedData.dutyIntent = capabilityContext.body;
     preloadedData.jobIntent = capabilityContext.body;
@@ -19767,13 +19812,31 @@ async function runCapabilityWorkflow(parent, workflow, capability, base) {
       ...parsePrNumber5(prUrl) ? { workflowPrNumber: parsePrNumber5(prUrl) } : {}
     };
     if (result.exitCode !== 0 && !canContinueWorkflow(step, outcome)) {
-      return {
+      return withWorkflowBoundaryEval(capability, {
         ...result,
         reason: result.reason ?? `workflow ${capability.slug} stopped at step ${index + 1}/${workflow.steps.length}: ${label}`
-      };
+      });
     }
   }
-  return result;
+  return withWorkflowBoundaryEval(capability, result);
+}
+function withWorkflowBoundaryEval(capability, result) {
+  const capabilityKind = capability.config.capabilityKind;
+  if (!capabilityKind) return result;
+  const evalResult = evaluateAgencyBoundaries({
+    capability: capability.slug,
+    capabilityKind,
+    results: []
+  });
+  process.stdout.write(`KODY_AGENCY_BOUNDARY_EVAL=${JSON.stringify(evalResult)}
+`);
+  if (evalResult.status !== "fail" || result.exitCode !== 0) return result;
+  const failed = evalResult.findings.filter((finding) => finding.status === "fail").map((finding) => finding.rule);
+  return {
+    ...result,
+    exitCode: 99,
+    reason: result.reason ? `${result.reason}; agency boundary eval failed: ${failed.join(", ")}` : `agency boundary eval failed: ${failed.join(", ")}`
+  };
 }
 function workflowStepToJob(step, parent, chainData) {
   const action = step.action ?? step.capability;
@@ -19915,6 +19978,7 @@ var DEFAULT_INSTANT_AGENT, localJobSeq, InvalidJobError;
 var init_job = __esm({
   "src/job.ts"() {
     "use strict";
+    init_agencyBoundaryEval();
     init_executor();
     init_registry();
     init_workflowDefinitions();

package/package.json

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