@kody-ade/kody-engine 0.4.454 → 0.4.456

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.454",
+      version: "0.4.456",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -1770,6 +1770,7 @@ function parseWorkflowStep(value) {
   const evidence = stringField(raw.evidence);
   const reason = stringField(raw.reason);
   const target = stringField(raw.target);
+  const delivery = stringField(raw.delivery);
   const targetFact = stringField(raw.targetFact ?? raw.target_fact);
   const hasInput = Object.hasOwn(raw, "input");
   const next = parseWorkflowTransitions(raw.next);
@@ -1781,6 +1782,7 @@ function parseWorkflowStep(value) {
     ...action && isSafeSlug(action) ? { action } : {},
     ...evidence ? { evidence } : {},
     ...target === "issue" || target === "pr" ? { target } : {},
+    ...delivery === "pull-request" ? { delivery } : {},
     ...targetFact ? { targetFact } : {},
     ...reason ? { reason } : {},
     ...next ? { next } : {},
@@ -4212,6 +4214,24 @@ var init_agencyBoundaryEval = __esm({
   }
 });
 
+// src/capabilityDelivery.ts
+function capabilityDeliveryTarget(input) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) return null;
+  const value = input;
+  const issue2 = positiveInteger(value.issue);
+  const pr = positiveInteger(value.pr);
+  if (issue2 === null === (pr === null)) return null;
+  return issue2 === null ? { kind: "pr", number: pr } : { kind: "issue", number: issue2 };
+}
+function positiveInteger(value) {
+  return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : null;
+}
+var init_capabilityDelivery = __esm({
+  "src/capabilityDelivery.ts"() {
+    "use strict";
+  }
+});
+
 // src/agency/capability-contract-validation.ts
 import Ajv from "ajv";
 function validateCapabilityContractValue(boundary, schema, value) {
@@ -4350,7 +4370,7 @@ function parseGoalEvidenceProgress(value) {
     ...stringField2(raw.reason) ? { reason: stringField2(raw.reason) } : {},
     ...stringField2(raw.nextAction) ? { nextAction: stringField2(raw.nextAction) } : {},
     ...stringField2(raw.nextRetryAt) ? { nextRetryAt: stringField2(raw.nextRetryAt) } : {},
-    ...positiveInteger(raw.issue) ? { issue: positiveInteger(raw.issue) } : {},
+    ...positiveInteger2(raw.issue) ? { issue: positiveInteger2(raw.issue) } : {},
     ...stringField2(raw.updatedAt) ? { updatedAt: stringField2(raw.updatedAt) } : {}
   };
 }
@@ -4366,7 +4386,7 @@ function definedProgressFields(update) {
 function stringField2(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
-function positiveInteger(value) {
+function positiveInteger2(value) {
   if (typeof value === "number" && Number.isInteger(value) && value > 0) return value;
   return void 0;
 }
@@ -8904,6 +8924,14 @@ function validateWorkflow(value, options = {}) {
       }
     }
     validateDataMatch(step.runWhen, `${base}.runWhen`, issues);
+    if (step.delivery !== void 0 && step.delivery !== "pull-request") {
+      issue(
+        issues,
+        "invalid_delivery",
+        `${base}.delivery`,
+        "workflow step delivery must be pull-request"
+      );
+    }
     if (step.input !== void 0 && !isJsonValue(step.input)) {
       issue(issues, "invalid_input", `${base}.input`, "workflow step input must be one JSON value");
     }
@@ -8919,6 +8947,7 @@ function validateWorkflow(value, options = {}) {
     issue(issues, "missing_start_step", "startAt", `workflow startAt references missing step ${startAt ?? "<none>"}`);
   }
   const adjacency = /* @__PURE__ */ new Map();
+  const explicitEndSources = /* @__PURE__ */ new Set();
   steps.forEach((step, index) => {
     if (!step) return;
     const id = text(step.id);
@@ -8987,6 +9016,7 @@ function validateWorkflow(value, options = {}) {
         return;
       }
       if (target === "$end") {
+        explicitEndSources.add(id);
         return;
       }
       if (!seen.has(target)) {
@@ -9041,7 +9071,7 @@ function validateWorkflow(value, options = {}) {
     ids.forEach((id, index) => {
       if (!reachable.has(id)) issue(issues, "unreachable_step", `steps[${index}]`, `workflow step ${id} is unreachable`);
     });
-    if (![...reachable].some((id) => (adjacency.get(id) ?? []).length === 0)) {
+    if (![...reachable].some((id) => (adjacency.get(id) ?? []).length === 0 || explicitEndSources.has(id))) {
       issue(issues, "missing_terminal_step", "steps", "workflow has no reachable final step");
     }
   }
@@ -9116,6 +9146,7 @@ var init_workflowValidation = __esm({
       "action",
       "evidence",
       "target",
+      "delivery",
       "targetFact",
       "reason",
       "next",
@@ -15502,6 +15533,7 @@ var init_loadSimpleCapability = __esm({
       const toolFiles = listFiles(toolRoot);
       const skillFiles = listFiles(skillRoot);
       const input = parseInput(ctx.args.input);
+      const delivery = ctx.data.jobDelivery === "pull-request";
       ctx.data.jobCapability = slug;
       ctx.data.capabilityInput = input;
       ctx.data.capabilityEnvironment = capabilityEnvironment(input);
@@ -15514,7 +15546,21 @@ var init_loadSimpleCapability = __esm({
         JSON.stringify(input ?? null, null, 2),
         "```",
         "",
-        "Return one JSON value.",
+        ...delivery ? [
+          "## Delivery",
+          "",
+          "The wrapper owns git commits, pushes, and pull requests. Do not run git or gh write commands.",
+          "Finish with exactly this structure:",
+          "",
+          "DONE",
+          "PLAN_DEVIATIONS: none",
+          "COMMIT_MSG: <conventional commit message>",
+          "PR_SUMMARY:",
+          "- <what changed>",
+          "```json",
+          '{"summary":"<result>","status":"changed"}',
+          "```"
+        ] : ["Return one JSON value."],
         ...skillFiles.length ? [
           "",
           "## Skills",
@@ -17924,6 +17970,208 @@ var init_prepareBrowserAuth = __esm({
   }
 });
 
+// src/scripts/runFlow.ts
+function tryPost(issueNumber, body, cwd) {
+  try {
+    postIssueComment(issueNumber, body, cwd);
+  } catch {
+  }
+}
+function resolveBaseOverride(value) {
+  if (!value) return null;
+  if (value.length > 200) return null;
+  if (value.includes("..")) return null;
+  if (!/^[a-z0-9][a-z0-9/._-]*$/.test(value)) return null;
+  return value;
+}
+var runFlow;
+var init_runFlow = __esm({
+  "src/scripts/runFlow.ts"() {
+    "use strict";
+    init_branch();
+    init_gha();
+    init_issue();
+    runFlow = async (ctx) => {
+      const issueNumber = ctx.args.issue;
+      const issue2 = getIssue(issueNumber, ctx.cwd);
+      const cfgCtx = ctx.config.issueContext ?? {};
+      const commentsFormatted = formatIssueComments(
+        issue2.comments,
+        cfgCtx.commentLimit ?? DEFAULT_COMMENT_LIMIT,
+        cfgCtx.commentMaxBytes ?? DEFAULT_COMMENT_MAX_BYTES
+      );
+      ctx.data.issue = { ...issue2, commentsFormatted };
+      if (issue2.isPullRequest) {
+        ctx.data.commentTargetType = "pr";
+        ctx.data.commentTargetNumber = issueNumber;
+        ctx.skipAgent = true;
+        ctx.output.exitCode = 1;
+        ctx.output.reason = `run target #${issueNumber} is a pull request; dispatch a PR action or the source issue instead`;
+        return;
+      }
+      ctx.data.commentTargetType = "issue";
+      ctx.data.commentTargetNumber = issueNumber;
+      const argBase = resolveBaseOverride(ctx.args.base);
+      const baseRaw = ctx.args.base;
+      if (baseRaw && !argBase) {
+        process.stderr.write(`[kody runFlow] ignoring --base "${baseRaw}" (must match kody-task or goal-branch pattern)
+`);
+      }
+      const base = argBase;
+      if (base) {
+        ctx.data.baseBranch = base;
+        process.stderr.write(`[kody runFlow] resolved base branch: ${base} (from --base)
+`);
+      }
+      const branchInfo = ensureFeatureBranch(
+        issueNumber,
+        issue2.title,
+        ctx.config.git.defaultBranch,
+        ctx.cwd,
+        base ?? void 0
+      );
+      ctx.data.branch = branchInfo.branch;
+      const runUrl = getRunUrl();
+      const startMsg = runUrl ? `\u2699\uFE0F kody started \u2014 branch \`${ctx.data.branch}\`, run ${runUrl}` : `\u2699\uFE0F kody started \u2014 branch \`${ctx.data.branch}\``;
+      tryPost(issueNumber, startMsg, ctx.cwd);
+    };
+  }
+});
+
+// src/scripts/syncFlow.ts
+import { execFileSync as execFileSync16 } from "child_process";
+function restoreDone(prNumber, cwd) {
+  try {
+    setKodyLabel(prNumber, DONE2, cwd);
+  } catch {
+  }
+}
+function bail2(ctx, prNumber, reason) {
+  ctx.skipAgent = true;
+  ctx.output.exitCode = 1;
+  ctx.output.reason = reason;
+  const runUrl = getRunUrl();
+  const runSuffix = runUrl ? ` ([logs](${runUrl}))` : "";
+  tryPostPr3(prNumber, `\u274C kody sync could not complete${runSuffix}: ${reason}`, ctx.cwd);
+}
+function revParseHead(cwd) {
+  try {
+    return execFileSync16("git", ["rev-parse", "HEAD"], { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).toString().trim();
+  } catch {
+    return "";
+  }
+}
+function pushBranch(branch, cwd) {
+  const result = pushWithRetry({ cwd: cwd ?? process.cwd(), branch, setUpstream: true });
+  if (!result.ok) {
+    throw new Error(result.reason);
+  }
+}
+function tryPostPr3(prNumber, body, cwd) {
+  try {
+    postPrReviewComment(prNumber, body, cwd);
+  } catch {
+  }
+}
+var DONE2, syncFlow;
+var init_syncFlow = __esm({
+  "src/scripts/syncFlow.ts"() {
+    "use strict";
+    init_branch();
+    init_gha();
+    init_issue();
+    init_lifecycleLabels();
+    init_pushWithRetry();
+    DONE2 = {
+      label: "kody:done",
+      color: "0e8a16",
+      description: "kody: PR ready for human review/merge"
+    };
+    syncFlow = async (ctx, _profile, args) => {
+      const announceOnSuccess = Boolean(args?.announceOnSuccess);
+      const prNumber = ctx.args.pr;
+      const pr = getPr(prNumber, ctx.cwd);
+      if (pr.state !== "OPEN") {
+        bail2(ctx, prNumber, `PR #${prNumber} is not OPEN (state: ${pr.state})`);
+        return;
+      }
+      ctx.data.pr = pr;
+      if (announceOnSuccess) {
+        ctx.data.commentTargetType = "pr";
+        ctx.data.commentTargetNumber = prNumber;
+      }
+      checkoutPrBranch(prNumber, ctx.cwd);
+      ctx.data.branch = getCurrentBranch(ctx.cwd);
+      const baseBranch = pr.baseRefName || ctx.config.git.defaultBranch;
+      ctx.data.baseBranch = baseBranch;
+      const headBefore = revParseHead(ctx.cwd);
+      const mergeStatus = mergeBase(baseBranch, ctx.cwd);
+      if (mergeStatus === "error") {
+        bail2(ctx, prNumber, `failed to merge origin/${baseBranch} (non-conflict error); see runner log`);
+        return;
+      }
+      if (mergeStatus === "conflict") {
+        bail2(
+          ctx,
+          prNumber,
+          `merge from origin/${baseBranch} produced conflicts \u2014 run \`@kody resolve\` to let kody resolve them`
+        );
+        return;
+      }
+      const headAfter = revParseHead(ctx.cwd);
+      if (headAfter === headBefore) {
+        ctx.data.syncResult = "noop";
+        if (announceOnSuccess) {
+          ctx.output.exitCode = 0;
+          ctx.output.reason = `already up to date with origin/${baseBranch}`;
+          restoreDone(prNumber, ctx.cwd);
+        }
+        return;
+      }
+      try {
+        pushBranch(ctx.data.branch, ctx.cwd);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        bail2(ctx, prNumber, `merge succeeded but push failed: ${msg}`);
+        return;
+      }
+      ctx.data.syncResult = "merged";
+      if (announceOnSuccess) {
+        ctx.output.exitCode = 0;
+        ctx.output.reason = `merged origin/${baseBranch} into ${ctx.data.branch}`;
+        restoreDone(prNumber, ctx.cwd);
+      }
+    };
+  }
+});
+
+// src/scripts/prepareCapabilityDelivery.ts
+var prepareCapabilityDelivery;
+var init_prepareCapabilityDelivery = __esm({
+  "src/scripts/prepareCapabilityDelivery.ts"() {
+    "use strict";
+    init_capabilityDelivery();
+    init_runFlow();
+    init_syncFlow();
+    prepareCapabilityDelivery = async (ctx, profile) => {
+      const target = capabilityDeliveryTarget(ctx.data.capabilityInput);
+      if (!target) {
+        throw new Error(
+          "pull-request delivery requires exactly one positive issue or pr input"
+        );
+      }
+      ctx.args[target.kind] = target.number;
+      if (target.kind === "issue") {
+        await runFlow(ctx, profile);
+        return;
+      }
+      ctx.data.commentTargetType = "pr";
+      ctx.data.commentTargetNumber = target.number;
+      await syncFlow(ctx, profile);
+    };
+  }
+});
+
 // src/scripts/promoteQaGoal.ts
 var REPORT_JSON_OPEN2, promoteQaGoal;
 var init_promoteQaGoal = __esm({
@@ -18079,7 +18327,7 @@ var init_publishReport = __esm({
 });
 
 // src/scripts/recordClassification.ts
-import { execFileSync as execFileSync16 } from "child_process";
+import { execFileSync as execFileSync17 } from "child_process";
 function parseClassification(prSummary) {
   if (!prSummary) return null;
   const classMatch = prSummary.match(/classification:\s*(feature|bug|spec|chore)\b/i);
@@ -18091,7 +18339,7 @@ function parseClassification(prSummary) {
 }
 function tryAuditComment(issueNumber, body, cwd) {
   try {
-    execFileSync16("gh", ["issue", "comment", String(issueNumber), "--body", body], {
+    execFileSync17("gh", ["issue", "comment", String(issueNumber), "--body", body], {
       cwd,
       timeout: API_TIMEOUT_MS5,
       stdio: ["ignore", "pipe", "pipe"]
@@ -18311,7 +18559,7 @@ var init_resolveArtifacts = __esm({
 });
 
 // src/scripts/resolveFlow.ts
-import { execFileSync as execFileSync17 } from "child_process";
+import { execFileSync as execFileSync18 } from "child_process";
 function buildPreferBlock(prefer, baseBranch) {
   if (prefer !== "ours" && prefer !== "theirs") return "";
   const keepSide = prefer === "ours" ? "HEAD (this PR branch)" : `origin/${baseBranch} (base branch)`;
@@ -18331,7 +18579,7 @@ function buildPreferBlock(prefer, baseBranch) {
 }
 function getConflictedFiles(cwd) {
   try {
-    const out = execFileSync17("git", ["diff", "--name-only", "--diff-filter=U"], {
+    const out = execFileSync18("git", ["diff", "--name-only", "--diff-filter=U"], {
       encoding: "utf-8",
       cwd,
       env: { ...process.env, HUSKY: "0" }
@@ -18346,7 +18594,7 @@ function getConflictMarkersPreview(files, cwd, maxBytes = CONFLICT_DIFF_MAX_BYTE
   let total = 0;
   for (const f of files) {
     try {
-      const content = execFileSync17("cat", [f], { encoding: "utf-8", cwd }).toString();
+      const content = execFileSync18("cat", [f], { encoding: "utf-8", cwd }).toString();
       const snippet = `### ${f}
 
 \`\`\`
@@ -18361,7 +18609,7 @@ ${content.slice(0, 6e3)}
   }
   return chunks.join("\n");
 }
-function tryPostPr3(prNumber, body, cwd) {
+function tryPostPr4(prNumber, body, cwd) {
   try {
     postPrReviewComment(prNumber, body, cwd);
   } catch {
@@ -18370,12 +18618,12 @@ function tryPostPr3(prNumber, body, cwd) {
 function pushEmptyCommit(branch, cwd) {
   const env = { ...process.env, HUSKY: "0", SKIP_HOOKS: "1" };
   try {
-    execFileSync17(
+    execFileSync18(
       "git",
       ["commit", "--allow-empty", "-m", "chore: kody resolve refresh \u2014 empty commit to recompute mergeable status"],
       { cwd, env, stdio: ["ignore", "pipe", "pipe"] }
     );
-    execFileSync17("git", ["push", "-u", "origin", branch], {
+    execFileSync18("git", ["push", "-u", "origin", branch], {
       cwd,
       env,
       stdio: ["ignore", "pipe", "pipe"]
@@ -18413,14 +18661,14 @@ var init_resolveFlow = __esm({
         ctx.output.exitCode = 0;
         ctx.output.reason = `PR #${prNumber} is mergeable (no conflicts) \u2014 nothing to resolve`;
         ctx.skipAgent = true;
-        tryPostPr3(prNumber, `\u2139\uFE0F kody resolve: ${ctx.output.reason}`, ctx.cwd);
+        tryPostPr4(prNumber, `\u2139\uFE0F kody resolve: ${ctx.output.reason}`, ctx.cwd);
         return;
       }
       if (ghStatus.status === "BLOCKED") {
         ctx.output.exitCode = 0;
         ctx.output.reason = `PR #${prNumber} is mergeable but blocked by checks/reviews (mergeStateStatus=${ghStatus.mergeStateStatus}) \u2014 nothing for resolve to do`;
         ctx.skipAgent = true;
-        tryPostPr3(prNumber, `\u2139\uFE0F kody resolve: ${ctx.output.reason}`, ctx.cwd);
+        tryPostPr4(prNumber, `\u2139\uFE0F kody resolve: ${ctx.output.reason}`, ctx.cwd);
         return;
       }
       checkoutPrBranch(prNumber, ctx.cwd);
@@ -18432,20 +18680,20 @@ var init_resolveFlow = __esm({
           ctx.output.exitCode = 0;
           ctx.output.reason = pushed ? `local merge clean despite GitHub reporting CONFLICTING \u2014 pushed empty commit to force re-evaluation` : `local merge clean despite GitHub reporting CONFLICTING \u2014 couldn't refresh GitHub cache (push failed)`;
           ctx.skipAgent = true;
-          tryPostPr3(prNumber, `\u2139\uFE0F kody resolve: ${ctx.output.reason}`, ctx.cwd);
+          tryPostPr4(prNumber, `\u2139\uFE0F kody resolve: ${ctx.output.reason}`, ctx.cwd);
           return;
         }
         ctx.output.exitCode = 0;
         ctx.output.reason = `already up to date with origin/${baseBranch} \u2014 nothing to resolve`;
         ctx.skipAgent = true;
-        tryPostPr3(prNumber, `\u2139\uFE0F kody resolve: ${ctx.output.reason}`, ctx.cwd);
+        tryPostPr4(prNumber, `\u2139\uFE0F kody resolve: ${ctx.output.reason}`, ctx.cwd);
         return;
       }
       if (mergeStatus === "error") {
         ctx.output.exitCode = 99;
         ctx.output.reason = `failed to merge origin/${baseBranch} (non-conflict error); see runner log`;
         ctx.skipAgent = true;
-        tryPostPr3(prNumber, `\u26A0\uFE0F kody resolve FAILED: ${ctx.output.reason}`, ctx.cwd);
+        tryPostPr4(prNumber, `\u26A0\uFE0F kody resolve FAILED: ${ctx.output.reason}`, ctx.cwd);
         return;
       }
       const conflictedFiles = getConflictedFiles(ctx.cwd);
@@ -18460,7 +18708,7 @@ var init_resolveFlow = __esm({
       ctx.data.preferBlock = buildPreferBlock(ctx.args.prefer, baseBranch);
       const runUrl = getRunUrl();
       const runSuffix = runUrl ? `, run ${runUrl}` : "";
-      tryPostPr3(
+      tryPostPr4(
         prNumber,
         `\u2699\uFE0F kody resolve started on \`${ctx.data.branch}\`${runSuffix} \u2014 ${conflictedFiles.length} conflicted file(s)`,
         ctx.cwd
@@ -18561,10 +18809,10 @@ var init_resolvePreviewUrl = __esm({
 });
 
 // src/scripts/resolveQaUrl.ts
-import { execFileSync as execFileSync18 } from "child_process";
+import { execFileSync as execFileSync19 } from "child_process";
 function ghQuery(args, cwd) {
   try {
-    const out = execFileSync18("gh", args, {
+    const out = execFileSync19("gh", args, {
       cwd,
       stdio: ["ignore", "pipe", "pipe"],
       encoding: "utf-8",
@@ -18641,7 +18889,7 @@ var init_resolveQaUrl = __esm({
 });
 
 // src/scripts/revertFlow.ts
-import { execFileSync as execFileSync19 } from "child_process";
+import { execFileSync as execFileSync20 } from "child_process";
 function buildCommitMessage(resolved) {
   if (resolved.length === 1) {
     const { full, subject } = resolved[0];
@@ -18654,7 +18902,7 @@ function buildPrSummary(resolved) {
   return resolved.map((r) => `- Reverted \`${r.full.slice(0, 7)}\`${r.subject ? ` \u2014 ${r.subject}` : ""}`).join("\n");
 }
 function git4(args, cwd) {
-  return execFileSync19("git", args, {
+  return execFileSync20("git", args, {
     encoding: "utf-8",
     timeout: 3e4,
     cwd,
@@ -18664,7 +18912,7 @@ function git4(args, cwd) {
 }
 function isAncestorOfHead(sha, cwd) {
   try {
-    execFileSync19("git", ["merge-base", "--is-ancestor", sha, "HEAD"], {
+    execFileSync20("git", ["merge-base", "--is-ancestor", sha, "HEAD"], {
       cwd,
       env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1" },
       stdio: ["ignore", "ignore", "ignore"]
@@ -18674,7 +18922,7 @@ function isAncestorOfHead(sha, cwd) {
     return false;
   }
 }
-function tryPostPr4(prNumber, body, cwd) {
+function tryPostPr5(prNumber, body, cwd) {
   try {
     postPrReviewComment(prNumber, body, cwd);
   } catch (err) {
@@ -18710,7 +18958,7 @@ var init_revertFlow = __esm({
         ctx.output.exitCode = 64;
         ctx.output.reason = "no commit SHAs provided \u2014 usage: @kody revert <sha> [<sha> \u2026]";
         ctx.skipAgent = true;
-        tryPostPr4(prNumber, `\u26A0\uFE0F kody revert FAILED: ${ctx.output.reason}`, ctx.cwd);
+        tryPostPr5(prNumber, `\u26A0\uFE0F kody revert FAILED: ${ctx.output.reason}`, ctx.cwd);
         return;
       }
       const requested = shasArg.split(/\s+/).filter((s) => s.length > 0);
@@ -18719,7 +18967,7 @@ var init_revertFlow = __esm({
         ctx.output.exitCode = 64;
         ctx.output.reason = `not valid SHA-shaped tokens: ${bad.join(", ")}`;
         ctx.skipAgent = true;
-        tryPostPr4(prNumber, `\u26A0\uFE0F kody revert FAILED: ${ctx.output.reason}`, ctx.cwd);
+        tryPostPr5(prNumber, `\u26A0\uFE0F kody revert FAILED: ${ctx.output.reason}`, ctx.cwd);
         return;
       }
       const resolved = [];
@@ -18747,7 +18995,7 @@ var init_revertFlow = __esm({
         ctx.output.exitCode = 64;
         ctx.output.reason = `commit(s) not found in this PR branch: ${unreachable.join(", ")}`;
         ctx.skipAgent = true;
-        tryPostPr4(prNumber, `\u26A0\uFE0F kody revert FAILED: ${ctx.output.reason}`, ctx.cwd);
+        tryPostPr5(prNumber, `\u26A0\uFE0F kody revert FAILED: ${ctx.output.reason}`, ctx.cwd);
         return;
       }
       ctx.args.shas = resolved.map((r) => r.full).join(" ");
@@ -18757,13 +19005,13 @@ var init_revertFlow = __esm({
       const runUrl = getRunUrl();
       const runSuffix = runUrl ? `, run ${runUrl}` : "";
       const shaList = resolved.map((r) => `\`${r.full.slice(0, 7)}\``).join(", ");
-      tryPostPr4(prNumber, `\u2699\uFE0F kody revert started on \`${ctx.data.branch}\`${runSuffix} \u2014 reverting ${shaList}`, ctx.cwd);
+      tryPostPr5(prNumber, `\u2699\uFE0F kody revert started on \`${ctx.data.branch}\`${runSuffix} \u2014 reverting ${shaList}`, ctx.cwd);
     };
   }
 });
 
 // src/scripts/reviewFlow.ts
-function tryPostPr5(prNumber, body, cwd) {
+function tryPostPr6(prNumber, body, cwd) {
   try {
     postPrReviewComment(prNumber, body, cwd);
   } catch {
@@ -18793,75 +19041,7 @@ var init_reviewFlow = __esm({
       ctx.data.prDiff = getPrDiff(prNumber, ctx.cwd);
       const runUrl = getRunUrl();
       const runSuffix = runUrl ? `, run ${runUrl}` : "";
-      tryPostPr5(prNumber, `\u{1F440} kody review started on PR #${prNumber}${runSuffix}`, ctx.cwd);
-    };
-  }
-});
-
-// src/scripts/runFlow.ts
-function tryPost(issueNumber, body, cwd) {
-  try {
-    postIssueComment(issueNumber, body, cwd);
-  } catch {
-  }
-}
-function resolveBaseOverride(value) {
-  if (!value) return null;
-  if (value.length > 200) return null;
-  if (value.includes("..")) return null;
-  if (!/^[a-z0-9][a-z0-9/._-]*$/.test(value)) return null;
-  return value;
-}
-var runFlow;
-var init_runFlow = __esm({
-  "src/scripts/runFlow.ts"() {
-    "use strict";
-    init_branch();
-    init_gha();
-    init_issue();
-    runFlow = async (ctx) => {
-      const issueNumber = ctx.args.issue;
-      const issue2 = getIssue(issueNumber, ctx.cwd);
-      const cfgCtx = ctx.config.issueContext ?? {};
-      const commentsFormatted = formatIssueComments(
-        issue2.comments,
-        cfgCtx.commentLimit ?? DEFAULT_COMMENT_LIMIT,
-        cfgCtx.commentMaxBytes ?? DEFAULT_COMMENT_MAX_BYTES
-      );
-      ctx.data.issue = { ...issue2, commentsFormatted };
-      if (issue2.isPullRequest) {
-        ctx.data.commentTargetType = "pr";
-        ctx.data.commentTargetNumber = issueNumber;
-        ctx.skipAgent = true;
-        ctx.output.exitCode = 1;
-        ctx.output.reason = `run target #${issueNumber} is a pull request; dispatch a PR action or the source issue instead`;
-        return;
-      }
-      ctx.data.commentTargetType = "issue";
-      ctx.data.commentTargetNumber = issueNumber;
-      const argBase = resolveBaseOverride(ctx.args.base);
-      const baseRaw = ctx.args.base;
-      if (baseRaw && !argBase) {
-        process.stderr.write(`[kody runFlow] ignoring --base "${baseRaw}" (must match kody-task or goal-branch pattern)
-`);
-      }
-      const base = argBase;
-      if (base) {
-        ctx.data.baseBranch = base;
-        process.stderr.write(`[kody runFlow] resolved base branch: ${base} (from --base)
-`);
-      }
-      const branchInfo = ensureFeatureBranch(
-        issueNumber,
-        issue2.title,
-        ctx.config.git.defaultBranch,
-        ctx.cwd,
-        base ?? void 0
-      );
-      ctx.data.branch = branchInfo.branch;
-      const runUrl = getRunUrl();
-      const startMsg = runUrl ? `\u2699\uFE0F kody started \u2014 branch \`${ctx.data.branch}\`, run ${runUrl}` : `\u2699\uFE0F kody started \u2014 branch \`${ctx.data.branch}\``;
-      tryPost(issueNumber, startMsg, ctx.cwd);
+      tryPostPr6(prNumber, `\u{1F440} kody review started on PR #${prNumber}${runSuffix}`, ctx.cwd);
     };
   }
 });
@@ -19631,7 +19811,7 @@ var init_skipAgent = __esm({
 });
 
 // src/scripts/stageMergeConflicts.ts
-import { execFileSync as execFileSync20 } from "child_process";
+import { execFileSync as execFileSync21 } from "child_process";
 var stageMergeConflicts;
 var init_stageMergeConflicts = __esm({
   "src/scripts/stageMergeConflicts.ts"() {
@@ -19639,7 +19819,7 @@ var init_stageMergeConflicts = __esm({
     stageMergeConflicts = async (ctx) => {
       if (ctx.data.agentDone === false) return;
       try {
-        execFileSync20("git", ["add", "-A"], {
+        execFileSync21("git", ["add", "-A"], {
           cwd: ctx.cwd,
           env: { ...process.env, HUSKY: "0", SKIP_HOOKS: "1" },
           stdio: "pipe"
@@ -19692,113 +19872,6 @@ var init_startFlow = __esm({
   }
 });
 
-// src/scripts/syncFlow.ts
-import { execFileSync as execFileSync21 } from "child_process";
-function restoreDone(prNumber, cwd) {
-  try {
-    setKodyLabel(prNumber, DONE2, cwd);
-  } catch {
-  }
-}
-function bail2(ctx, prNumber, reason) {
-  ctx.skipAgent = true;
-  ctx.output.exitCode = 1;
-  ctx.output.reason = reason;
-  const runUrl = getRunUrl();
-  const runSuffix = runUrl ? ` ([logs](${runUrl}))` : "";
-  tryPostPr6(prNumber, `\u274C kody sync could not complete${runSuffix}: ${reason}`, ctx.cwd);
-}
-function revParseHead(cwd) {
-  try {
-    return execFileSync21("git", ["rev-parse", "HEAD"], { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).toString().trim();
-  } catch {
-    return "";
-  }
-}
-function pushBranch(branch, cwd) {
-  const result = pushWithRetry({ cwd: cwd ?? process.cwd(), branch, setUpstream: true });
-  if (!result.ok) {
-    throw new Error(result.reason);
-  }
-}
-function tryPostPr6(prNumber, body, cwd) {
-  try {
-    postPrReviewComment(prNumber, body, cwd);
-  } catch {
-  }
-}
-var DONE2, syncFlow;
-var init_syncFlow = __esm({
-  "src/scripts/syncFlow.ts"() {
-    "use strict";
-    init_branch();
-    init_gha();
-    init_issue();
-    init_lifecycleLabels();
-    init_pushWithRetry();
-    DONE2 = {
-      label: "kody:done",
-      color: "0e8a16",
-      description: "kody: PR ready for human review/merge"
-    };
-    syncFlow = async (ctx, _profile, args) => {
-      const announceOnSuccess = Boolean(args?.announceOnSuccess);
-      const prNumber = ctx.args.pr;
-      const pr = getPr(prNumber, ctx.cwd);
-      if (pr.state !== "OPEN") {
-        bail2(ctx, prNumber, `PR #${prNumber} is not OPEN (state: ${pr.state})`);
-        return;
-      }
-      ctx.data.pr = pr;
-      if (announceOnSuccess) {
-        ctx.data.commentTargetType = "pr";
-        ctx.data.commentTargetNumber = prNumber;
-      }
-      checkoutPrBranch(prNumber, ctx.cwd);
-      ctx.data.branch = getCurrentBranch(ctx.cwd);
-      const baseBranch = pr.baseRefName || ctx.config.git.defaultBranch;
-      ctx.data.baseBranch = baseBranch;
-      const headBefore = revParseHead(ctx.cwd);
-      const mergeStatus = mergeBase(baseBranch, ctx.cwd);
-      if (mergeStatus === "error") {
-        bail2(ctx, prNumber, `failed to merge origin/${baseBranch} (non-conflict error); see runner log`);
-        return;
-      }
-      if (mergeStatus === "conflict") {
-        bail2(
-          ctx,
-          prNumber,
-          `merge from origin/${baseBranch} produced conflicts \u2014 run \`@kody resolve\` to let kody resolve them`
-        );
-        return;
-      }
-      const headAfter = revParseHead(ctx.cwd);
-      if (headAfter === headBefore) {
-        ctx.data.syncResult = "noop";
-        if (announceOnSuccess) {
-          ctx.output.exitCode = 0;
-          ctx.output.reason = `already up to date with origin/${baseBranch}`;
-          restoreDone(prNumber, ctx.cwd);
-        }
-        return;
-      }
-      try {
-        pushBranch(ctx.data.branch, ctx.cwd);
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        bail2(ctx, prNumber, `merge succeeded but push failed: ${msg}`);
-        return;
-      }
-      ctx.data.syncResult = "merged";
-      if (announceOnSuccess) {
-        ctx.output.exitCode = 0;
-        ctx.output.reason = `merged origin/${baseBranch} into ${ctx.data.branch}`;
-        restoreDone(prNumber, ctx.cwd);
-      }
-    };
-  }
-});
-
 // src/scripts/validateAgencyModelProposal.ts
 import * as path46 from "path";
 function validateModelBundle(bundle, expectedKind, options = {}) {
@@ -20880,6 +20953,7 @@ var init_scripts = __esm({
     init_postResearchComment();
     init_postReviewResult();
     init_prepareBrowserAuth();
+    init_prepareCapabilityDelivery();
     init_promoteQaGoal();
     init_publishReport();
     init_recordClassification();
@@ -20941,6 +21015,7 @@ var init_scripts = __esm({
       loadPriorArt,
       loadQaContext,
       prepareBrowserAuth,
+      prepareCapabilityDelivery,
       buildSyntheticPlugin,
       resolveArtifacts,
       discoverQaContext,
@@ -22301,6 +22376,9 @@ function validateJob(input) {
   if (j.cliArgs !== void 0 && (typeof j.cliArgs !== "object" || j.cliArgs === null)) {
     throw new InvalidJobError("job.cliArgs must be an object when present");
   }
+  if (j.delivery !== void 0 && j.delivery !== "pull-request") {
+    throw new InvalidJobError(`job.delivery must be "pull-request" (got ${String(j.delivery)})`);
+  }
   return {
     action: typeof j.action === "string" ? j.action : void 0,
     implementation: typeof j.implementation === "string" ? j.implementation : void 0,
@@ -22310,6 +22388,7 @@ function validateJob(input) {
     agent: typeof j.agent === "string" ? j.agent : void 0,
     schedule: typeof j.schedule === "string" ? j.schedule : void 0,
     target: typeof j.target === "number" ? j.target : void 0,
+    delivery: j.delivery === "pull-request" ? j.delivery : void 0,
     cliArgs: j.cliArgs ?? {},
     workflowFacts: j.workflowFacts && typeof j.workflowFacts === "object" && !Array.isArray(j.workflowFacts) ? j.workflowFacts : void 0,
     workflowState: parseWorkflowRunState(j.workflowState) ?? void 0,
@@ -22362,7 +22441,7 @@ async function runJob(job, base) {
   }
   const workflow = capabilityContext?.config.workflow ?? workflowContext?.config.workflow;
   const workflowIdentity = valid.workflow ?? capabilityIdentity ?? workflowContext?.slug;
-  const capabilitySelectedImplementation = resolvedCapability?.implementation ?? capabilityContext?.config.implementation ?? capabilityContext?.config.implementations?.[0] ?? (capabilityContext?.config.role ? capabilityContext.slug : void 0) ?? (capabilityContext?.config.tickScript ? "capability-tick-scripted" : void 0);
+  const capabilitySelectedImplementation = valid.delivery === "pull-request" && resolvedCapability?.implementation === "capability-run" ? "capability-delivery" : resolvedCapability?.implementation ?? capabilityContext?.config.implementation ?? capabilityContext?.config.implementations?.[0] ?? (capabilityContext?.config.role ? capabilityContext.slug : void 0) ?? (capabilityContext?.config.tickScript ? "capability-tick-scripted" : void 0);
   const profileName = explicitImplementation ?? capabilitySelectedImplementation;
   if (workflow && shouldRunCapabilityWorkflow(valid, workflow, workflowIdentity, capabilitySelectedImplementation, base)) {
     const workflowCapability = capabilityContext ?? workflowContext;
@@ -22452,6 +22531,7 @@ async function runCapabilityImplementationStep(valid, profileName, capabilityIde
   preloadedData.jobKey = stableJobKey(valid);
   preloadedData.jobFlavor = valid.flavor;
   if (valid.target !== void 0) preloadedData.jobTarget = valid.target;
+  if (valid.delivery !== void 0) preloadedData.jobDelivery = valid.delivery;
   if (valid.action !== void 0 && valid.action.length > 0) preloadedData.jobAction = valid.action;
   if (capabilityIdentity !== void 0 && capabilityIdentity.length > 0)
     preloadedData.jobCapability = capabilityIdentity;
@@ -22491,11 +22571,13 @@ async function runCapabilityImplementationStep(valid, profileName, capabilityIde
   };
   const shouldApplyResolvedCapabilityArgs = valid.implementation === void 0 && resolvedCapability && profileName === resolvedCapability.implementation;
   input.cliArgs = shouldApplyResolvedCapabilityArgs ? { ...resolvedCapability.cliArgs, ...input.cliArgs } : input.cliArgs;
-  if (profileName === "capability-run" && capabilityIdentity) {
+  if ((profileName === "capability-run" || profileName === "capability-delivery") && capabilityIdentity) {
     const capabilityInput = Object.keys(valid.cliArgs).length > 0 ? genericInputFromArgs(valid.cliArgs) : void 0;
+    const deliveryTarget = profileName === "capability-delivery" && capabilityInput && typeof capabilityInput === "object" ? capabilityDeliveryArgs(capabilityInput) : {};
     input.cliArgs = {
       capability: capabilityIdentity,
-      ...capabilityInput !== void 0 ? { input: JSON.stringify(capabilityInput) } : {}
+      ...capabilityInput !== void 0 ? { input: JSON.stringify(capabilityInput) } : {},
+      ...deliveryTarget
     };
   }
   const run = base.chain === false ? runImplementation : runImplementationChain;
@@ -22852,6 +22934,7 @@ function workflowStepToJob(step, parent, chainData, cwd) {
     ...parent.agent ? { agent: parent.agent } : {},
     ...parent.schedule ? { schedule: parent.schedule } : {},
     ...typeof target === "number" ? { target } : {},
+    ...step.delivery ? { delivery: step.delivery } : {},
     cliArgs,
     ...step.evidence ? { evidence: step.evidence } : parent.evidence ? { evidence: parent.evidence } : {},
     flavor: parent.flavor,
@@ -22861,6 +22944,10 @@ function workflowStepToJob(step, parent, chainData, cwd) {
     ...parent.resultTarget ? { resultTarget: parent.resultTarget } : {}
   };
 }
+function capabilityDeliveryArgs(input) {
+  const target = capabilityDeliveryTarget(input);
+  return target ? { [target.kind]: target.number } : {};
+}
 function usesGenericCapabilityInput(action, cwd) {
   const inputs = getCapabilityActionInputs(action, hydratedCapabilitiesRoot(cwd));
   return Boolean(inputs?.length === 1 && inputs[0]?.name === "input" && inputs[0]?.flag === "--input");
@@ -23025,6 +23112,7 @@ var init_job = __esm({
   "src/job.ts"() {
     "use strict";
     init_agencyBoundaryEval();
+    init_capabilityDelivery();
     init_capabilityFolders();
     init_definition_paths();
     init_executor();

package/dist/implementations/types.ts

@@ -569,6 +569,8 @@ export interface Job {
   schedule?: string
   /** The issue/PR number this job acts on, when applicable. */
   target?: number
+  /** Workflow-owned delivery policy applied by a generic runtime adapter. */
+  delivery?: "pull-request"
   /** Args passed through to the implementation (mirrors DispatchResult.cliArgs). */
   cliArgs: Record<string, unknown>
   /** Internal workflow resume context. Not passed to capability CLI args. */

package/dist/runtime-services/capability-delivery/profile.json

@@ -0,0 +1,85 @@
+{
+  "name": "capability-delivery",
+  "internal": true,
+  "role": "primitive",
+  "kind": "oneshot",
+  "inputs": [
+    {
+      "name": "capability",
+      "flag": "--capability",
+      "type": "string",
+      "required": true,
+      "describe": "Capability folder slug."
+    },
+    {
+      "name": "input",
+      "flag": "--input",
+      "type": "string",
+      "required": false,
+      "describe": "The capability's one JSON input."
+    },
+    {
+      "name": "issue",
+      "flag": "--issue",
+      "type": "int",
+      "required": false,
+      "describe": "Issue receiving a new pull request."
+    },
+    {
+      "name": "pr",
+      "flag": "--pr",
+      "type": "int",
+      "required": false,
+      "describe": "Existing pull request receiving changes."
+    }
+  ],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "acceptEdits",
+    "maxTurns": 60,
+    "maxThinkingTokens": null,
+    "systemPromptAppend": null,
+    "enableVerifyTool": true,
+    "verifyAttempts": 4,
+    "tools": [
+      "Read",
+      "Write",
+      "Edit",
+      "Bash",
+      "Grep",
+      "Glob",
+      "mcp__kody-verify"
+    ],
+    "hooks": ["block-git"],
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [],
+  "lifecycle": "pr-branch",
+  "lifecycleConfig": {
+    "label": {
+      "name": "kody:working",
+      "color": "fbca04",
+      "description": "kody: delivering capability work"
+    },
+    "context": "task",
+    "sync": false,
+    "advance": false,
+    "mirrorState": false,
+    "finalize": false
+  },
+  "scripts": {
+    "preflight": [
+      { "script": "loadSimpleCapability" },
+      { "script": "prepareCapabilityDelivery" }
+    ],
+    "postflight": [
+      { "script": "parseSimpleCapabilityOutput" }
+    ]
+  },
+  "inputArtifacts": [],
+  "outputArtifacts": []
+}

package/package.json

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