@kody-ade/kody-engine 0.4.628 → 0.4.630

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.628",
+      version: "0.4.630",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       repository: {
@@ -12739,6 +12739,7 @@ var init_commitAndPush = __esm({
           const replay = JSON.parse(fs33.readFileSync(sentinel, "utf-8"));
           ctx.data.commitResult = replay.commitResult ?? { committed: false, pushed: false };
           if (Array.isArray(replay.changedFiles)) ctx.data.changedFiles = replay.changedFiles;
+          if (Array.isArray(replay.deliveryOmissions)) ctx.data.deliveryOmissions = replay.deliveryOmissions;
           if (typeof replay.hasCommitsAhead === "boolean") ctx.data.hasCommitsAhead = replay.hasCommitsAhead;
           if (replay.salvagedFromMissingMarker) ctx.data.salvagedFromMissingMarker = true;
           if (typeof replay.commitCrash === "string") {
@@ -12806,6 +12807,7 @@ var init_commitAndPush = __esm({
               {
                 commitResult: ctx.data.commitResult,
                 changedFiles: ctx.data.changedFiles,
+                deliveryOmissions: ctx.data.deliveryOmissions,
                 hasCommitsAhead: ctx.data.hasCommitsAhead,
                 salvagedFromMissingMarker: ctx.data.salvagedFromMissingMarker === true,
                 commitCrash: typeof ctx.data.commitCrash === "string" ? ctx.data.commitCrash : void 0,
@@ -18388,6 +18390,11 @@ function computeFailureSuffix(input) {
 }
 function renderMessage(input) {
   const suffix = computeFailureSuffix(input);
+  if (input.isFailure && input.partialDelivery) {
+    const destination = renderDeliveryDestination(input);
+    const proof = input.partialDelivery.pushedSha ? ` (${input.partialDelivery.pushedSha.slice(0, 7)})` : "";
+    return `\u26A0\uFE0F kody PARTIAL: pushed allowed changes to ${destination}${proof}; omitted protected files: ${input.partialDelivery.omittedFiles.join(", ")}`;
+  }
   if (input.isFailure) {
     return `\u26A0\uFE0F kody FAILED: ${truncate2(input.failureReason, 1500)}${suffix}`;
   }
@@ -18404,6 +18411,15 @@ function renderMessage(input) {
       return `\u26A0\uFE0F kody finished but PR step did not run${suffix}`;
   }
 }
+function renderDeliveryDestination(input) {
+  if (input.prResult?.kind === "created" || input.prResult?.kind === "updated") {
+    return `PR ${input.prResult.url}`;
+  }
+  if (input.branch && input.githubOwner && input.githubRepo) {
+    return `branch https://github.com/${input.githubOwner}/${input.githubRepo}/tree/${input.branch}`;
+  }
+  return "the pushed branch";
+}
 function renderDeliveryProof(ctx) {
   const quality = ctx.config.quality;
   const gates = quality ? [
@@ -18420,7 +18436,7 @@ function renderDeliveryProof(ctx) {
 Proof: ${verification}; ${delivery}.`;
 }
 function computeFailureReason2(ctx) {
-  const omissions = Array.isArray(ctx.data.deliveryOmissions) ? ctx.data.deliveryOmissions.filter((file) => typeof file === "string") : [];
+  const omissions = readDeliveryOmissions(ctx.data);
   if (omissions.length > 0) {
     return `delivery blocked protected files: ${omissions.join(", ")}`;
   }
@@ -18433,6 +18449,9 @@ function computeFailureReason2(ctx) {
   if (ctx.data.verifyOk === false) return ctx.data.verifyReason || "verify failed";
   return "";
 }
+function readDeliveryOmissions(data) {
+  return Array.isArray(data.deliveryOmissions) ? data.deliveryOmissions.filter((file) => typeof file === "string") : [];
+}
 function actionFailureReason2(action) {
   if (!action || typeof action !== "object" || Array.isArray(action)) return "";
   const payload = action.payload;
@@ -18537,6 +18556,8 @@ var init_postIssueComment = __esm({
       }
       const failureReason = computeFailureReason2(ctx);
       const isFailure = failureReason.length > 0;
+      const deliveryOmissions = readDeliveryOmissions(ctx.data);
+      const isPartialDelivery = commitResult?.pushed === true && deliveryOmissions.length > 0;
       const branch = ctx.data.branch;
       const msg = renderMessage({
         prResult,
@@ -18547,7 +18568,8 @@ var init_postIssueComment = __esm({
         branchPushed: commitResult?.committed === true,
         githubOwner: ctx.config.github?.owner,
         githubRepo: ctx.config.github?.repo,
-        deliveryProof: renderDeliveryProof(ctx)
+        deliveryProof: renderDeliveryProof(ctx),
+        partialDelivery: isPartialDelivery ? { omittedFiles: deliveryOmissions, pushedSha: commitResult.sha } : void 0
       });
       postWith(targetType, targetNumber, msg, ctx.cwd);
       const prIsDraft = (prResult?.kind === "created" || prResult?.kind === "updated") && prResult.draft === true;
@@ -19461,7 +19483,9 @@ async function publishWorkflowReport(input) {
   const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
   const title = input.publication.title ?? input.workflowTitle;
   const summary = input.state.status === "done" ? `${input.workflowTitle} completed` : `${input.workflowTitle} ${input.state.status}${input.state.blocker ? `: ${input.state.blocker}` : ""}`;
-  const markdown = buildRuntimeReportMarkdown({
+  const body = stringValue5(resolveDotted(input.state.facts, input.publication.bodyFact));
+  const reportFacts = input.publication.bodyFact ? omitKeys(input.state.facts, [input.publication.bodyFact.split(".")[0]]) : input.state.facts;
+  const generatedMarkdown = buildRuntimeReportMarkdown({
     generatedAt,
     reportType: input.publication.type,
     reportTypeVersion: input.publication.version ?? 1,
@@ -19475,7 +19499,7 @@ async function publishWorkflowReport(input) {
         status: input.state.status,
         completedStepIds: input.state.completedStepIds,
         transitionCounts: input.state.transitionCounts,
-        facts: input.state.facts,
+        facts: reportFacts,
         evidence: input.state.evidence,
         artifacts: input.state.artifacts,
         ...input.state.blocker ? { blocker: input.state.blocker } : {}
@@ -19484,6 +19508,10 @@ async function publishWorkflowReport(input) {
     ...input.publication.reviewStatus ? { reviewStatus: input.publication.reviewStatus } : {},
     ...input.publication.reviewArea ? { reviewArea: input.publication.reviewArea } : {}
   });
+  const markdown = body ? `${generatedMarkdown.trimEnd()}
+
+${body}
+` : generatedMarkdown;
   const runId = generatedAt.replace(/\.\d{3}Z$/, "Z").replace(/:/g, "-");
   if (hasStateBackendConfig()) {
     await createStateBackendFromEnv().saveReport(
@@ -24415,20 +24443,17 @@ async function runCapabilityWorkflow(parent, workflow, capability, base, checkpo
     await checkpoint?.(state);
     return { exitCode: 64, reason: resumeBlocker, workflowState: state };
   }
-  if (isGraphWorkflow(workflow)) {
-    const result = await runGraphCapabilityWorkflow(parent, workflow, capability, base, checkpoint);
-    if (workflow.report && result.workflowState) {
-      await publishWorkflowReport({
-        config: base.config ?? loadConfig(base.cwd),
-        publication: workflow.report,
-        workflowId: capability.slug,
-        workflowTitle: capability.title,
-        state: result.workflowState
-      });
-    }
-    return result;
+  const result = isGraphWorkflow(workflow) ? await runGraphCapabilityWorkflow(parent, workflow, capability, base, checkpoint) : await runLinearCapabilityWorkflow(parent, workflow, capability, base, checkpoint);
+  if (workflow.report && result.workflowState) {
+    await publishWorkflowReport({
+      config: base.config ?? loadConfig(base.cwd),
+      publication: workflow.report,
+      workflowId: capability.slug,
+      workflowTitle: capability.title,
+      state: result.workflowState
+    });
   }
-  return runLinearCapabilityWorkflow(parent, workflow, capability, base, checkpoint);
+  return result;
 }
 async function runLinearCapabilityWorkflow(parent, workflow, capability, base, checkpoint) {
   const state = initialWorkflowState(parent, workflow);

package/dist/implementations/types.ts

@@ -550,6 +550,8 @@ export interface ReportPublicationConfig {
   slugFact?: string
   title?: string
   titleFact?: string
+  /** Dotted path in workflow facts containing a ready-to-render Markdown body. */
+  bodyFact?: string
   publishWhenFact?: string
   reviewStatus?: string
   reviewArea?: string

package/package.json

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