@kody-ade/kody-engine 0.4.572 → 0.4.574

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.572",
+      version: "0.4.574",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -54,7 +54,7 @@ var init_package = __esm({
       dependencies: {
         "@actions/cache": "^6.0.0",
         "@anthropic-ai/claude-agent-sdk": "0.2.119",
-        "@kody-ade/engine-contracts": "0.1.0",
+        "@kody-ade/engine-contracts": "^0.2.0",
         "@modelcontextprotocol/sdk": "^1.29.0",
         ajv: "^8.18.0",
         convex: "^1.17.0",
@@ -2187,6 +2187,7 @@ function readCapabilityFolder(root, slug) {
       },
       rawProfile: contract ? {
         ...contract.execution ? { execution: contract.execution } : {},
+        ...contract.deliveryPolicy ? { deliveryPolicy: contract.deliveryPolicy } : {},
         input: contract.input,
         output: contract.output
       } : {},
@@ -2227,13 +2228,20 @@ function parseCapabilityContract(raw) {
     throw new Error('contract.json requiredSubagents are supported only when execution is "agent"');
   }
   const unsupported = Object.keys(parsed).filter(
-    (key) => key !== "execution" && key !== "requirements" && key !== "secrets" && key !== "timeoutMs" && key !== "requiredSubagents" && key !== "input" && key !== "output"
+    (key) => key !== "execution" && key !== "deliveryPolicy" && key !== "requirements" && key !== "secrets" && key !== "timeoutMs" && key !== "requiredSubagents" && key !== "input" && key !== "output"
   );
   if (unsupported.length > 0) {
     throw new Error(`contract.json contains unsupported fields: ${unsupported.join(", ")}`);
   }
+  if (parsed.deliveryPolicy !== void 0 && parsed.deliveryPolicy !== "checkpoint") {
+    throw new Error('contract.json deliveryPolicy must be "checkpoint"');
+  }
+  if (parsed.deliveryPolicy === "checkpoint" && parsed.execution !== "agent") {
+    throw new Error('contract.json deliveryPolicy "checkpoint" is supported only when execution is "agent"');
+  }
   return {
     ...parsed.execution ? { execution: parsed.execution } : {},
+    ...parsed.deliveryPolicy === "checkpoint" ? { deliveryPolicy: "checkpoint" } : {},
     ...requirements ? { requirements } : {},
     ...secrets ? { secrets } : {},
     ...timeoutMs !== void 0 ? { timeoutMs } : {},
@@ -4736,6 +4744,7 @@ var init_task_artifacts = __esm({
 });
 
 // src/workflowValidation.ts
+import { validateExecutableWorkflow } from "@kody-ade/engine-contracts";
 function validateWorkflow(value, options = {}) {
   const issues = [];
   const workflow = asRecord(value);
@@ -4754,6 +4763,7 @@ function validateWorkflow(value, options = {}) {
     const step = asRecord(entry);
     return Boolean(step && (step.id !== void 0 || step.next !== void 0));
   });
+  const sharedIssues = graphMode ? validateExecutableWorkflow(value, options) : [];
   const steps = rawSteps.map(
     (entry) => typeof entry === "string" ? { capability: entry } : asRecord(entry)
   );
@@ -4814,7 +4824,7 @@ function validateWorkflow(value, options = {}) {
       capability ? options.capabilityInputs?.get(capability) : void 0
     );
   });
-  if (!graphMode) return issues;
+  if (!graphMode) return uniqueIssues([...issues, ...sharedIssues]);
   const seen = /* @__PURE__ */ new Set();
   ids.forEach((id, index) => {
     if (seen.has(id)) issue(issues, "duplicate_step_id", `steps[${index}].id`, `workflow step id ${id} is duplicated`);
@@ -4957,7 +4967,16 @@ function validateWorkflow(value, options = {}) {
       issue(issues, "missing_terminal_step", "steps", "workflow has no reachable final step");
     }
   }
-  return issues;
+  return uniqueIssues([...issues, ...sharedIssues]);
+}
+function uniqueIssues(issues) {
+  const seen = /* @__PURE__ */ new Set();
+  return issues.filter((entry) => {
+    const key = `${entry.code}\0${entry.path}`;
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
 }
 function validateInputBindings(value, path59, issues, declaredInputs) {
   if (value === void 0) return;
@@ -12186,6 +12205,11 @@ var init_checkCoverageWithRetry = __esm({
     init_coverage();
     init_prompt();
     checkCoverageWithRetry = async (ctx) => {
+      if (ctx.data.capabilityDeliveryPolicy === "checkpoint") {
+        ctx.data.verificationDeferred = true;
+        ctx.data.coverageMisses = [];
+        return;
+      }
       const reqs = ctx.data.coverageRules ?? [];
       if (reqs.length === 0) {
         ctx.data.coverageMisses = [];
@@ -14628,6 +14652,9 @@ function setOutcome(ctx, outcome) {
     ctx.output.prUrl = outcome.url;
   }
 }
+function deliveryCheckpointReason(data) {
+  return data.capabilityDeliveryPolicy === "checkpoint" ? "Repository-wide verification is deferred to pull request CI." : "";
+}
 function computeFailureReason(ctx) {
   const expectedTests = collectExpectedTests(ctx.data.coverageMisses);
   if (expectedTests.length > 0) return `missing tests: ${expectedTests.join(", ")}`;
@@ -14697,7 +14724,8 @@ var init_ensurePr = __esm({
         setOutcome(ctx, { kind: "skipped", reason: "no branch context (ctx.data.branch missing)" });
         return;
       }
-      const failureReason = computeFailureReason(ctx);
+      const checkpointReason = deliveryCheckpointReason(ctx.data);
+      const failureReason = computeFailureReason(ctx) || checkpointReason;
       const isFailure = failureReason.length > 0;
       const changedFiles = ctx.data.changedFiles ?? [];
       const issue2 = ctx.data.issue;
@@ -16295,6 +16323,9 @@ var init_loadSimpleCapability = __esm({
       ctx.data.jobCapability = slug;
       ctx.data.capabilityInput = input;
       ctx.data.capabilityExecution = capability.contract?.execution ?? "agent";
+      if (capability.contract?.deliveryPolicy) {
+        ctx.data.capabilityDeliveryPolicy = capability.contract.deliveryPolicy;
+      }
       if (capability.contract?.requirements) {
         ctx.data.capabilityRequirements = capability.contract.requirements;
       }
@@ -17881,7 +17912,8 @@ var init_postIssueComment = __esm({
         githubRepo: ctx.config.github?.repo
       });
       postWith(targetType, targetNumber, msg, ctx.cwd);
-      if (!isFailure) {
+      const prIsDraft = (prResult?.kind === "created" || prResult?.kind === "updated") && prResult.draft === true;
+      if (!isFailure && !prIsDraft) {
         markPrReadyForReview(ctx, prResult);
       }
       let exitCode = 0;
@@ -21006,6 +21038,12 @@ var init_verifyWithRetry = __esm({
     init_prompt();
     init_verify();
     verifyWithRetry = async (ctx) => {
+      if (ctx.data.capabilityDeliveryPolicy === "checkpoint") {
+        ctx.data.verificationDeferred = true;
+        delete ctx.data.verifyOk;
+        delete ctx.data.verifyReason;
+        return;
+      }
       await runVerify(ctx);
       if (ctx.data.verifyOk !== false) return;
       if (ctx.abortSignal?.aborted) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.572",
+  "version": "0.4.574",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,10 +12,34 @@
     "templates",
     "kody.config.schema.json"
   ],
+  "scripts": {
+    "kody:run": "tsx bin/kody.ts",
+    "serve": "tsx bin/kody.ts serve",
+    "serve:vscode": "tsx bin/kody.ts serve vscode",
+    "serve:claude": "tsx bin/kody.ts serve claude",
+    "clean:dist": "node scripts/clean-dist.cjs",
+    "build": "pnpm clean:dist && tsup && node scripts/copy-assets.cjs",
+    "check:modularity": "tsx scripts/check-script-modularity.ts",
+    "pretest": "pnpm check:modularity",
+    "test": "vitest run tests/unit tests/int --coverage",
+    "posttest": "tsx scripts/check-coverage-floor.ts",
+    "test:smoke": "vitest run tests/smoke --no-coverage",
+    "test:e2e": "vitest run tests/e2e --no-coverage",
+    "verify:live-release": "tsx scripts/live-release-gate.ts",
+    "test:runtime-services": "node --test \"tests/runtime-services/*.test.mjs\"",
+    "test:all": "vitest run tests --no-coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "format": "biome format --write",
+    "verify:package": "node scripts/verify-package-tarball.cjs",
+    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain --build-arg KODY_ENGINE_REF=$(git rev-parse HEAD) -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner",
+    "prepublishOnly": "pnpm typecheck && pnpm test:runtime-services && pnpm build && pnpm verify:package"
+  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
-    "@kody-ade/engine-contracts": "0.1.0",
+    "@kody-ade/engine-contracts": "^0.2.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "ajv": "^8.18.0",
     "convex": "^1.17.0",
@@ -38,28 +62,5 @@
     "url": "git+https://github.com/aharonyaircohen/kody-engine.git"
   },
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
-  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues",
-  "scripts": {
-    "kody:run": "tsx bin/kody.ts",
-    "serve": "tsx bin/kody.ts serve",
-    "serve:vscode": "tsx bin/kody.ts serve vscode",
-    "serve:claude": "tsx bin/kody.ts serve claude",
-    "clean:dist": "node scripts/clean-dist.cjs",
-    "build": "pnpm clean:dist && tsup && node scripts/copy-assets.cjs",
-    "check:modularity": "tsx scripts/check-script-modularity.ts",
-    "pretest": "pnpm check:modularity",
-    "test": "vitest run tests/unit tests/int --coverage",
-    "posttest": "tsx scripts/check-coverage-floor.ts",
-    "test:smoke": "vitest run tests/smoke --no-coverage",
-    "test:e2e": "vitest run tests/e2e --no-coverage",
-    "verify:live-release": "tsx scripts/live-release-gate.ts",
-    "test:runtime-services": "node --test \"tests/runtime-services/*.test.mjs\"",
-    "test:all": "vitest run tests --no-coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check",
-    "lint:fix": "biome check --write",
-    "format": "biome format --write",
-    "verify:package": "node scripts/verify-package-tarball.cjs",
-    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain --build-arg KODY_ENGINE_REF=$(git rev-parse HEAD) -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner"
-  }
-}
+  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
+}