@kody-ade/kody-engine 0.4.351 → 0.4.353

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.351",
+      version: "0.4.353",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -1983,15 +1983,19 @@ function parseWorkflowStep(value) {
   if (!capability || !isSafeSlug(capability)) return null;
   const implementation = stringField(raw.implementation);
   const action = stringField(raw.action);
+  const evidence = stringField(raw.evidence);
   const agent = stringField(raw.agent);
   const reason = stringField(raw.reason);
   const target = stringField(raw.target);
+  const targetFact = stringField(raw.targetFact ?? raw.target_fact);
   const cliArgs = raw.cliArgs;
   return {
     capability,
     ...action && isSafeSlug(action) ? { action } : {},
     ...implementation && isSafeSlug(implementation) ? { implementation } : {},
+    ...evidence ? { evidence } : {},
     ...target === "issue" || target === "pr" ? { target } : {},
+    ...targetFact ? { targetFact } : {},
     ...agent && isSafeSlug(agent) ? { agent } : {},
     ...reason ? { reason } : {},
     ...cliArgs && typeof cliArgs === "object" && !Array.isArray(cliArgs) ? { cliArgs } : {},
@@ -9324,6 +9328,13 @@ var init_goalCapabilityScheduling = __esm({
 });
 
 // src/scripts/advanceManagedGoal.ts
+function scalarFacts(facts) {
+  return Object.fromEntries(
+    Object.entries(facts).filter(
+      ([key, value]) => key !== "pendingEvidence" && (typeof value === "string" || typeof value === "number" || typeof value === "boolean")
+    )
+  );
+}
 function autonomyBlockReason(ctx, goalId, goal, dispatch2) {
   if (ctx.data.jobForce === true) return null;
   if (goal.runWithoutApproval !== true) {
@@ -9788,6 +9799,8 @@ var init_advanceManagedGoal = __esm({
         ctx.output.nextDispatch = {
           workflow: decision.workflow,
           cliArgs: decision.cliArgs,
+          workflowFacts: scalarFacts(managed.facts),
+          evidence: decision.evidence,
           ...decision.saveReport === true ? { saveReport: true } : {},
           resultTarget: { type: "goal", id: goal.id }
         };
@@ -9797,9 +9810,10 @@ var init_advanceManagedGoal = __esm({
       ctx.output.nextDispatch = {
         capability: decision.capability,
         cliArgs: decision.cliArgs,
+        evidence: decision.evidence,
         ...decision.implementation ? { implementation: decision.implementation } : {},
         ...decision.saveReport === true ? { saveReport: true } : {},
-        resultTarget: { type: "goal", id: goal.id, evidence: decision.evidence }
+        resultTarget: { type: "goal", id: goal.id }
       };
       ctx.output.reason = `dispatch ${decision.capability} for ${decision.evidence}`;
     };
@@ -10938,6 +10952,12 @@ function parseResultTarget(raw) {
     ...evidence ? { evidence } : {}
   };
 }
+function parseEvidenceContext(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null;
+  const context = raw;
+  const evidence = typeof context.evidence === "string" && context.evidence.trim().length > 0 ? context.evidence.trim() : void 0;
+  return evidence ? { evidence } : null;
+}
 function collectGoalCapabilityEvidence(reports, results, fallbackGoalId, explicitEvidence) {
   const items = [];
   for (const report of reports) {
@@ -11042,8 +11062,9 @@ var init_applyCapabilityReports = __esm({
       const reports = collectReports(ctx.data.capabilityReports, agentResult);
       const results = collectResults2(ctx.data.capabilityResults, agentResult);
       const resultTarget = parseResultTarget(ctx.data.capabilityResultTarget);
+      const evidenceContext = parseEvidenceContext(ctx.data.capabilityEvidence);
       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);
+      const explicitEvidence = evidenceContext?.evidence ?? resultTarget?.evidence ?? (typeof ctx.args.evidence === "string" && ctx.args.evidence.length > 0 ? ctx.args.evidence : void 0);
       const evidenceItems = collectGoalCapabilityEvidence(reports, results, resultGoalId, explicitEvidence);
       if (evidenceItems.length === 0) return;
       const evidenceByGoal = groupGoalEvidence(evidenceItems);
@@ -20470,6 +20491,8 @@ function handoffToJob(handoff) {
     workflow: handoff.workflow,
     implementation: handoff.implementation,
     cliArgs: handoff.cliArgs,
+    workflowFacts: handoff.workflowFacts,
+    evidence: handoff.evidence,
     flavor: "instant",
     saveReport: handoff.saveReport === true,
     resultTarget: handoff.resultTarget
@@ -20814,6 +20837,8 @@ function validateJob(input) {
     schedule: typeof j.schedule === "string" ? j.schedule : void 0,
     target: typeof j.target === "number" ? j.target : void 0,
     cliArgs: j.cliArgs ?? {},
+    workflowFacts: j.workflowFacts && typeof j.workflowFacts === "object" && !Array.isArray(j.workflowFacts) ? j.workflowFacts : void 0,
+    evidence: parseJobEvidence(j),
     flavor: j.flavor,
     force: j.force === true,
     saveReport: j.saveReport === true,
@@ -20825,13 +20850,18 @@ function parseCapabilityResultTarget(raw) {
   const target = raw;
   if (target.type !== "goal") return void 0;
   if (typeof target.id !== "string" || target.id.trim().length === 0) return void 0;
-  const evidence = typeof target.evidence === "string" && target.evidence.trim().length > 0 ? target.evidence.trim() : void 0;
   return {
     type: "goal",
-    id: target.id.trim(),
-    ...evidence ? { evidence } : {}
+    id: target.id.trim()
   };
 }
+function parseJobEvidence(job) {
+  if (typeof job.evidence === "string" && job.evidence.trim().length > 0) return job.evidence.trim();
+  const target = job.resultTarget;
+  if (!target || typeof target !== "object" || Array.isArray(target)) return void 0;
+  const evidence = target.evidence;
+  return typeof evidence === "string" && evidence.trim().length > 0 ? evidence.trim() : void 0;
+}
 async function runJob(job, base) {
   const valid = validateJob(job);
   const action = valid.action ?? valid.capability;
@@ -20891,6 +20921,7 @@ async function runCapabilityImplementationStep(valid, profileName, capabilityIde
   if (valid.schedule !== void 0 && valid.schedule.length > 0) preloadedData.jobSchedule = valid.schedule;
   if (valid.saveReport === true) preloadedData.jobSaveReport = true;
   if (valid.force === true) preloadedData.jobForce = true;
+  if (valid.evidence) preloadedData.capabilityEvidence = { evidence: valid.evidence };
   if (valid.resultTarget) preloadedData.capabilityResultTarget = valid.resultTarget;
   if (capabilityContext) {
     preloadedData.capabilitySlug = capabilityContext.slug;
@@ -20943,13 +20974,15 @@ async function runCapabilityWorkflow(parent, workflow, capability, base) {
     workflowTitle: capability.title,
     workflowStepCount: workflow.steps.length,
     workflowIssueNumber: workflowIssueNumber(parent),
+    workflowFacts: parent.workflowFacts ?? {},
     workflowStack: [
       ...Array.isArray(base.preloadedData?.workflowStack) ? base.preloadedData.workflowStack.filter((entry) => typeof entry === "string") : [],
       capability.slug
     ]
   };
   let result = { exitCode: 0 };
-  for (let index = 0; index < workflow.steps.length; index++) {
+  const startIndex = workflowResumeStartIndex(workflow.steps, parent.evidence);
+  for (let index = startIndex; index < workflow.steps.length; index++) {
     const step = workflow.steps[index];
     const label = step.action ?? step.capability;
     if (!shouldRunWorkflowStep(step, chainData)) {
@@ -21038,9 +21071,11 @@ function workflowStepToJob(step, parent, chainData) {
     ...parent.schedule ? { schedule: parent.schedule } : {},
     ...typeof target === "number" ? { target } : {},
     cliArgs,
+    ...step.evidence ? { evidence: step.evidence } : parent.evidence ? { evidence: parent.evidence } : {},
     flavor: parent.flavor,
     force: parent.force,
-    saveReport: step.saveReport === true || parent.saveReport === true
+    saveReport: step.saveReport === true || parent.saveReport === true,
+    ...parent.resultTarget ? { resultTarget: parent.resultTarget } : {}
   };
 }
 function shouldRunWorkflowStep(step, data) {
@@ -21081,10 +21116,23 @@ function valueMatches(actual, expected) {
   return actual === expected;
 }
 function workflowStepTargetNumber(step, parent, chainData) {
-  if (step.target === "pr") return workflowPrNumber(chainData) ?? targetFromCliArgs(step.cliArgs ?? {});
+  if (step.target === "pr")
+    return workflowPrNumber(chainData) ?? workflowTargetFactNumber(step, chainData) ?? targetFromCliArgs(step.cliArgs ?? {});
   if (step.target === "issue") return workflowIssueNumber(parent);
   return typeof parent.target === "number" ? parent.target : targetFromCliArgs({ ...parent.cliArgs, ...step.cliArgs ?? {} });
 }
+function workflowResumeStartIndex(steps, evidence) {
+  if (!evidence) return 0;
+  const index = steps.findIndex((step) => step.evidence === evidence);
+  return index >= 0 ? index : 0;
+}
+function workflowTargetFactNumber(step, data) {
+  if (!step.targetFact) return void 0;
+  const facts = data.workflowFacts;
+  if (!facts || typeof facts !== "object" || Array.isArray(facts)) return void 0;
+  const value = facts[step.targetFact];
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
 function workflowIssueNumber(parent) {
   return typeof parent.target === "number" ? parent.target : targetFromCliArgs(parent.cliArgs);
 }

package/dist/implementations/types.ts

@@ -401,7 +401,6 @@ export interface OutputContract {
 export interface CapabilityResultTarget {
   type: "goal"
   id: string
-  evidence?: string
 }
 
 // ────────────────────────────────────────────────────────────────────────────
@@ -438,6 +437,8 @@ export interface Context {
       workflow?: string
       implementation?: string
       cliArgs: Record<string, unknown>
+      workflowFacts?: Record<string, unknown>
+      evidence?: string
       saveReport?: boolean
       resultTarget?: CapabilityResultTarget
     }
@@ -450,6 +451,8 @@ export interface Context {
       workflow?: string
       implementation?: string
       cliArgs: Record<string, unknown>
+      workflowFacts?: Record<string, unknown>
+      evidence?: string
       saveReport?: boolean
       resultTarget?: CapabilityResultTarget
     }
@@ -517,6 +520,10 @@ export interface Job {
   target?: number
   /** Args passed through to the implementation (mirrors DispatchResult.cliArgs). */
   cliArgs: Record<string, unknown>
+  /** Internal workflow resume context. Not passed to capability CLI args. */
+  workflowFacts?: Record<string, unknown>
+  /** Evidence this capability run is expected to report, independent of who consumes it. */
+  evidence?: string
   /** Run once now ("instant") or on the schedule ("scheduled"). */
   flavor: JobFlavor
   /** Manual force-run (bypass cadence) for a scheduled job. */

package/package.json

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