@kody-ade/kody-engine 0.4.315 → 0.4.317

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.315",
+      version: "0.4.317",
       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;
@@ -2633,82 +2637,13 @@ function readCheckRuns(repoSlug, ref, ignoreNames) {
   const state = failing.length > 0 ? "RED" : pending.length > 0 ? "PENDING" : "GREEN";
   return { sha, state, failing, pending };
 }
-function cleanLogins(values) {
-  return [
-    ...new Set(
-      (values ?? []).map((value) => value.trim().replace(/^@/, "")).filter(Boolean)
-    )
-  ];
-}
-function cleanLabels(values) {
-  return [
-    ...new Set(
-      (values ?? []).map((value) => value.trim()).filter(Boolean)
-    )
-  ];
-}
-function ensureKodyLabel(repoSlug, label) {
-  if (!label.toLowerCase().startsWith("kody:")) return;
-  gh([
-    "label",
-    "create",
-    label,
-    "-R",
-    repoSlug,
-    "--color",
-    "8b5cf6",
-    "--description",
-    "Kody-owned tracking issue",
-    "--force"
-  ]);
-}
-function applyIssueUpdates(repoSlug, number, opts) {
-  const labels = cleanLabels(opts?.labels);
-  const assignees = cleanLogins(opts?.assignees);
-  if (labels.length === 0 && assignees.length === 0) return null;
-  const labelsApplied = [];
-  const assigneesApplied = [];
-  const warnings = [];
-  for (const label of labels) {
-    try {
-      gh(["issue", "edit", String(number), "-R", repoSlug, "--add-label", label]);
-      labelsApplied.push(label);
-    } catch (firstErr) {
-      try {
-        ensureKodyLabel(repoSlug, label);
-        gh(["issue", "edit", String(number), "-R", repoSlug, "--add-label", label]);
-        labelsApplied.push(label);
-      } catch (err) {
-        warnings.push(
-          `label ${label}: ${err instanceof Error ? err.message : firstErr instanceof Error ? firstErr.message : String(err)}`
-        );
-      }
-    }
-  }
-  for (const assignee of assignees) {
-    try {
-      gh(["issue", "edit", String(number), "-R", repoSlug, "--add-assignee", assignee]);
-      assigneesApplied.push(assignee);
-    } catch (err) {
-      warnings.push(`assignee ${assignee}: ${err instanceof Error ? err.message : String(err)}`);
-    }
-  }
-  return {
-    ...labelsApplied.length > 0 ? { labelsApplied } : {},
-    ...assigneesApplied.length > 0 ? { assigneesApplied } : {},
-    ...warnings.length > 0 ? { warnings } : {}
-  };
-}
-function ensureIssue(repoSlug, key, title, body, opts) {
+function ensureIssue(repoSlug, key, title, body) {
   const marker = trackMarker(key);
   try {
     const raw = gh(["issue", "list", "-R", repoSlug, "--state", "open", "--limit", "100", "--json", "number,body"]);
     const issues = JSON.parse(raw);
     const existing = issues.find((i) => (i.body ?? "").includes(marker));
-    if (existing) {
-      const updates2 = applyIssueUpdates(repoSlug, existing.number, opts);
-      return updates2 ? { created: false, number: existing.number, ...updates2 } : { created: false, number: existing.number };
-    }
+    if (existing) return { created: false, number: existing.number };
     const url = gh(["issue", "create", "-R", repoSlug, "--title", title, "--body-file", "-"], {
       input: `${body}
 
@@ -2716,9 +2651,7 @@ ${marker}`
     });
     const m = url.trim().match(/\/(\d+)\s*$/);
     if (!m) return { error: `issue created but could not parse its number from: ${url}` };
-    const number = Number(m[1]);
-    const updates = applyIssueUpdates(repoSlug, number, opts);
-    return updates ? { created: true, number, ...updates } : { created: true, number };
+    return { created: true, number: Number(m[1]) };
   } catch (err) {
     return { error: err instanceof Error ? err.message : String(err) };
   }
@@ -2912,19 +2845,13 @@ function capabilityToolDefinitions(opts) {
       title: z3.string().min(1).describe("Issue title (used only on first creation)."),
       body: z3.string().min(1).describe(
         "Issue body markdown (used only on first creation). Include the operator mention verbatim if the capability body has one."
-      ),
-      labels: z3.array(z3.string().min(1)).optional().describe(
-        "Optional labels to apply to the tracking issue every time, including reused issues. Use for dashboard visibility, e.g. ['kody:backlog']."
-      ),
-      assignees: z3.array(z3.string().min(1)).optional().describe("Optional GitHub logins to assign to the tracking issue every time, including reused issues.")
+      )
     },
     handler: async (args) => {
       const key = String(args.key ?? "");
       const title = String(args.title ?? "");
       const body = String(args.body ?? "");
-      const labels = Array.isArray(args.labels) ? args.labels.map((label) => String(label)) : void 0;
-      const assignees = Array.isArray(args.assignees) ? args.assignees.map((assignee) => String(assignee)) : void 0;
-      const result = ensureIssue(opts.repoSlug, key, title, body, { labels, assignees });
+      const result = ensureIssue(opts.repoSlug, key, title, body);
       return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     }
   };
@@ -3869,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 = [];
@@ -4388,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,
@@ -4442,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),
@@ -4549,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) {
@@ -9965,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;
 }
@@ -12408,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)) {
@@ -12511,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;
@@ -19016,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) {
@@ -19144,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 = {
@@ -19528,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([
@@ -19759,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;
@@ -19844,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;
@@ -19992,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();
@@ -21363,6 +21350,7 @@ function readRunRequestFromEnv(env = process.env) {
 // src/kody-cli.ts
 init_runtimePaths();
 init_stateWorkspace();
+init_workflowDefinitions();
 var FAILED_DISPATCH_LABEL = {
   label: "kody:failed",
   color: "e11d21",
@@ -21728,7 +21716,11 @@ async function runCi(argv) {
     const config = earlyConfig ?? loadConfig(cwd);
     const manualGoalManager = forceRunAction === "goal-manager";
     const capabilityRoute = manualGoalManager ? null : resolveCapabilityAction(forceRunAction);
-    const scheduledWatchRoute = manualGoalManager || capabilityRoute ? void 0 : dispatchScheduledWatches({ force: true }).find(
+    const workflowRoute = manualGoalManager || capabilityRoute || !readWorkflowDefinition(config, cwd, forceRunAction) ? void 0 : {
+      workflow: forceRunAction,
+      cliArgs: {}
+    };
+    const scheduledWatchRoute = manualGoalManager || capabilityRoute || workflowRoute ? void 0 : dispatchScheduledWatches({ force: true }).find(
       (match) => match.action === forceRunAction || match.executable === forceRunAction
     );
     const route = manualGoalManager ? {
@@ -21736,9 +21728,9 @@ async function runCi(argv) {
       capability: "goal-manager",
       executable: "goal-manager",
       cliArgs: forceRunCliArgs
-    } : capabilityRoute ?? scheduledWatchRoute;
+    } : capabilityRoute ?? workflowRoute ?? scheduledWatchRoute;
     if (!route) {
-      process.stderr.write(`[kody] manual one-shot action '${forceRunAction}' has no capability action
+      process.stderr.write(`[kody] manual one-shot action '${forceRunAction}' has no capability action or workflow
 `);
       return 64;
     }
@@ -21746,9 +21738,11 @@ async function runCi(argv) {
       process.stderr.write("[kody] manual goal-manager run requires message goal id\n");
       return 64;
     }
-    process.stdout.write(`\u2192 kody: manual one-shot run action ${route.action} (${route.capability})
+    process.stdout.write(
+      `\u2192 kody: manual one-shot run ${route.workflow ? `workflow ${route.workflow}` : `action ${route.action} (${route.capability})`}
 
-`);
+`
+    );
     try {
       const n = unpackAllSecrets();
       if (n > 0) process.stdout.write(`\u2192 kody: unpacked ${n} secret(s)
@@ -21781,6 +21775,7 @@ async function runCi(argv) {
       {
         action: route.action,
         capability: route.capability,
+        workflow: route.workflow,
         executable: route.executable,
         cliArgs: { ...route.cliArgs, ...forceRunCliArgs },
         flavor: "instant",

package/package.json

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