@abelxiaoxing/cadence 1.8.3 → 2.0.0

package/src/delivery-compiler.ts

@@ -1,1805 +0,0 @@
-import { createHash } from "node:crypto";
-import { readFileSync } from "node:fs";
-import path from "node:path";
-import { compareCanonicalStrings } from "./canonical.ts";
-import {
-  assertPlanWithinChangeContract,
-  normalizeChangeContract,
-} from "./change-contract.ts";
-import {
-  type AgentsImpact,
-  type ImplementGraphBoundary,
-  type ImplementGraphOutput,
-  isAgentsPath,
-  isValidRelativePath,
-  type PhaseBoundary,
-  type StructuredVerificationContract,
-  validateImplementGraphBoundary,
-  validateVerificationContract,
-  verificationInputPaths,
-  verificationSteps,
-} from "./contracts.ts";
-import {
-  type DesignPlanDiagnostic,
-  DesignPlanValidationError,
-} from "./design-diagnostics.ts";
-import {
-  assessImplementGraphReadiness,
-  canonicalJson,
-  hashCanonicalValue,
-  type ImplementGraphReadiness,
-} from "./implement-graph.ts";
-import type {
-  ImplementPlan,
-  PlanAgentsCheckpointOperation,
-  PlanTaskDraft,
-  PlanTracking,
-  PlanVerification,
-} from "./implement-plan.ts";
-import { expandPlanDraft, preparePlanDraft } from "./plan-draft.ts";
-import { isSafeRegularFile, observeSafePath } from "./safe-path.ts";
-import { expandSingleTaskDraft } from "./single-task-draft.ts";
-import {
-  bindDraftVerificationInputs,
-  validateVerificationAdapterCapability,
-} from "./verification-capability.ts";
-
-export const IMPLEMENT_PLAN_PATH = "implement-plan.json" as const;
-export const GATE_A_RECEIPT_PATH = "gate-a.yaml" as const;
-export const READY_RECEIPT_PATH = "ready.yaml" as const;
-
-const SHA256 = /^[a-f0-9]{64}$/u;
-const CHANGE_NAME = /^[a-z0-9](?:[a-z0-9-]{0,126}[a-z0-9])?$/u;
-const AGENTS_START = "<!-- ABEL:AGENTS-INDEX:START -->";
-const AGENTS_END = "<!-- ABEL:AGENTS-INDEX:END -->";
-
-export interface DeliveryArtifactBinding {
-  path: string;
-  rawSha256: string;
-}
-
-export interface GateApprovalProof {
-  revision: number;
-  contractHash: string;
-  recordHash: string;
-}
-
-export interface GateAReceipt {
-  change: string;
-  schema: string;
-  approval: GateApprovalProof;
-  artifacts: DeliveryArtifactBinding[];
-}
-
-export interface DeliveryTraceability {
-  taskPath: "tasks.md";
-  referenceCount: number;
-  taskCount: number;
-  verificationCount: number;
-  canonicalHash: string;
-}
-
-export interface ReadyReceipt {
-  change: string;
-  schema: string;
-  deliveryRevision: number;
-  approvals: {
-    gateA: {
-      path: typeof GATE_A_RECEIPT_PATH;
-      rawSha256: string;
-    };
-    gateB: {
-      revision: number;
-      contractHash: string;
-      recordHash: string;
-    };
-  };
-  artifacts: DeliveryArtifactBinding[];
-  plan: CompiledDelivery["receipt"]["plan"];
-  verificationClosure: ImplementGraphReadiness["closure"];
-  traceability: DeliveryTraceability;
-  openspec: {
-    strict: true;
-    planningComplete: true;
-  };
-}
-
-export type DeliveryTraceabilityAssessment =
-  | { ok: true; value: DeliveryTraceability }
-  | { ok: false; diagnostics: string[] };
-
-export class DeliveryValidationError extends Error {
-  readonly diagnostics: readonly string[];
-
-  constructor(diagnostics: readonly string[]) {
-    const normalized = [...new Set(diagnostics)].sort();
-    super("delivery-invalid");
-    this.name = "DeliveryValidationError";
-    this.diagnostics = Object.freeze(normalized);
-  }
-}
-
-const SAFE_PLAN_ERROR_CODE = /^[a-z0-9](?:[a-z0-9._-]{0,126}[a-z0-9])?$/u;
-
-function planErrorCode(error: unknown): string {
-  const message = error instanceof Error ? error.message : "";
-  return SAFE_PLAN_ERROR_CODE.test(message) ? message : "delivery-plan-invalid";
-}
-
-function planDiagnosticField(code: string): string | undefined {
-  const fields: Record<string, string> = {
-    "delivery-plan-invalid-task": "task",
-    "delivery-plan-invalid-task-phases": "phases",
-    "delivery-plan-invalid-phase": "phases",
-    "delivery-plan-empty-phase-boundary": "phases",
-    "delivery-plan-write-delete-overlap": "phases",
-    "delivery-verification-invalid": "verification",
-    "delivery-task-verification-invalid": "affectedVerification",
-    "delivery-agents-checkpoint-mismatch": "verification.agentsCheckpoint",
-  };
-  return fields[code];
-}
-
-function asPlanValidationError(
-  error: unknown,
-  context: Omit<DesignPlanDiagnostic, "code"> = {},
-): DesignPlanValidationError {
-  if (error instanceof DesignPlanValidationError) {
-    const diagnostics = error.diagnostics.map((diagnostic) => ({
-      ...context,
-      ...diagnostic,
-    }));
-    return new DesignPlanValidationError(error.message, diagnostics);
-  }
-  const code = planErrorCode(error);
-  const field = planDiagnosticField(code);
-  return new DesignPlanValidationError(code, [
-    { code, ...context, ...(field ? { field } : {}) },
-  ]);
-}
-
-export function assessDeliveryTraceability(input: {
-  tasksMarkdown: string;
-  specs: readonly { path: string; text: string }[];
-  plan: ImplementPlan;
-}): DeliveryTraceabilityAssessment {
-  const diagnostics = new Set<string>();
-  let authorMarkdown = input.tasksMarkdown;
-  let bindings: string | undefined;
-  try {
-    const region = taskVerificationRegion(input.tasksMarkdown);
-    if (region) {
-      authorMarkdown =
-        input.tasksMarkdown.slice(0, region.start) +
-        input.tasksMarkdown.slice(region.end);
-      bindings = region.text;
-      if (bindings !== renderTasks(input.plan)) {
-        diagnostics.add("traceability-managed-region-stale");
-      }
-    }
-  } catch {
-    return { ok: false, diagnostics: ["traceability-managed-region-invalid"] };
-  }
-  const headings = new Set<string>();
-  for (const spec of input.specs) {
-    if (!isValidRelativePath(spec.path) || !spec.path.endsWith("/spec.md")) {
-      diagnostics.add("traceability-spec-path-invalid");
-      continue;
-    }
-    let requirement = "";
-    for (const line of spec.text.split(/\r?\n/u)) {
-      const requirementMatch = /^### Requirement: (.+)$/u.exec(line);
-      if (requirementMatch?.[1]) {
-        requirement = requirementMatch[1].trim();
-        continue;
-      }
-      const scenarioMatch = /^#### Scenario: (.+)$/u.exec(line);
-      if (scenarioMatch?.[1] && requirement) {
-        const heading = `${spec.path}#${requirement}/${scenarioMatch[1].trim()}`;
-        if (headings.has(heading)) {
-          diagnostics.add("traceability-heading-duplicate");
-        }
-        headings.add(heading);
-      }
-    }
-  }
-  const references = [
-    ...authorMarkdown.matchAll(/`(specs\/[^`\n]+\/spec\.md#[^`\n]+)`/gu),
-  ].flatMap((match) => (match[1] ? [match[1].trim()] : []));
-  if (references.length === 0) diagnostics.add("traceability-reference-empty");
-  const referenceSet = new Set(references);
-  if (referenceSet.size !== references.length) {
-    diagnostics.add("traceability-reference-duplicate");
-  }
-  if (references.some((reference) => !headings.has(reference))) {
-    diagnostics.add("traceability-reference-unresolved");
-  }
-  if ([...headings].some((heading) => !referenceSet.has(heading))) {
-    diagnostics.add("traceability-scenario-unowned");
-  }
-  const taskIds = input.plan.tasks.map((task) => task.taskId).sort();
-  if (taskIds.some((taskId) => !authorMarkdown.includes(`\`${taskId}\``))) {
-    diagnostics.add("traceability-task-unmapped");
-  }
-  const verificationIds = input.plan.tasks
-    .flatMap((task) => [
-      ...(task.verificationMode && task.verificationMode !== "behavior"
-        ? []
-        : [task.phases.red.verification.id]),
-      task.phases.green.verification.id,
-      ...(task.phases.refactor ? [task.phases.refactor.verification.id] : []),
-    ])
-    .sort();
-  if (
-    verificationIds.some(
-      (verificationId) =>
-        !(bindings ?? authorMarkdown).includes(verificationId),
-    )
-  ) {
-    diagnostics.add("traceability-verification-unmapped");
-  }
-  if (diagnostics.size > 0) {
-    return { ok: false, diagnostics: [...diagnostics].sort() };
-  }
-  return {
-    ok: true,
-    value: {
-      taskPath: "tasks.md",
-      referenceCount: references.length,
-      taskCount: taskIds.length,
-      verificationCount: verificationIds.length,
-      canonicalHash: hashCanonicalValue({
-        references: [...referenceSet].sort(),
-        taskIds,
-        verificationIds,
-      }),
-    },
-  };
-}
-
-export type { DesignPlanDiagnostic } from "./design-diagnostics.ts";
-export { DesignPlanValidationError } from "./design-diagnostics.ts";
-export type {
-  ImplementPlan,
-  PlanAgentsCheckpointOperation,
-  PlanTaskDraft,
-  PlanTracking,
-  PlanVerification,
-} from "./implement-plan.ts";
-export type { PlanDraft, PlanPhaseDraft, PlanTaskInput } from "./plan-draft.ts";
-
-export interface CompiledDelivery {
-  /** Static checks only: neither compilation nor preflight seals a delivery. */
-  checks: {
-    structure: "passed";
-    verificationCapability: "passed";
-    contractCoverage: "passed" | "not-checked";
-    sealing: "not-performed";
-  };
-  plan: ImplementPlan;
-  bytes: Uint8Array;
-  rawSha256: string;
-  planHash: string;
-  closure: ImplementGraphReadiness["closure"];
-  receipt: {
-    plan: {
-      path: typeof IMPLEMENT_PLAN_PATH;
-      rawSha256: string;
-      canonicalHash: string;
-    };
-    verificationClosure: ImplementGraphReadiness["closure"];
-  };
-  tasksMarkdown: string;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-
-function exactKeys(
-  value: Record<string, unknown>,
-  keys: readonly string[],
-): boolean {
-  const actual = Object.keys(value);
-  return (
-    actual.length === keys.length && actual.every((key) => keys.includes(key))
-  );
-}
-
-function canonicalBytes(value: unknown): Uint8Array {
-  return new TextEncoder().encode(`${canonicalJson(value)}\n`);
-}
-
-function normalizeArtifactBindings(
-  value: readonly DeliveryArtifactBinding[],
-): DeliveryArtifactBinding[] {
-  if (!Array.isArray(value) || value.length === 0) {
-    throw new Error("delivery-artifacts-invalid");
-  }
-  const paths = new Set<string>();
-  const normalized = value.map((binding) => {
-    if (
-      !isRecord(binding) ||
-      !exactKeys(binding, ["path", "rawSha256"]) ||
-      typeof binding.path !== "string" ||
-      !isValidRelativePath(binding.path) ||
-      binding.path === READY_RECEIPT_PATH ||
-      typeof binding.rawSha256 !== "string" ||
-      !SHA256.test(binding.rawSha256) ||
-      paths.has(binding.path)
-    ) {
-      throw new Error("delivery-artifacts-invalid");
-    }
-    paths.add(binding.path);
-    return { path: binding.path, rawSha256: binding.rawSha256 };
-  });
-  return normalized.sort((left, right) =>
-    compareCanonicalStrings(left.path, right.path),
-  );
-}
-
-function requireReceiptIdentity(
-  change: unknown,
-  schema: unknown,
-): asserts change is string {
-  if (
-    typeof change !== "string" ||
-    !CHANGE_NAME.test(change) ||
-    typeof schema !== "string" ||
-    schema.length === 0 ||
-    schema.length > 128
-  ) {
-    throw new Error("delivery-receipt-identity-invalid");
-  }
-}
-
-function normalizeGateProof(value: GateApprovalProof): GateApprovalProof {
-  if (
-    !isRecord(value) ||
-    !exactKeys(value, ["revision", "contractHash", "recordHash"]) ||
-    !Number.isSafeInteger(value.revision) ||
-    value.revision < 1 ||
-    typeof value.contractHash !== "string" ||
-    !SHA256.test(value.contractHash) ||
-    typeof value.recordHash !== "string" ||
-    !SHA256.test(value.recordHash)
-  ) {
-    throw new Error("delivery-gate-proof-invalid");
-  }
-  return structuredClone(value);
-}
-
-export interface DeliveryReadOptions {
-  /** Only the proof-bound delivery loader may admit historical collection ordering. */
-  allowLegacyOrder?: boolean;
-}
-
-const legacyPlans = new WeakMap<object, string>();
-
-function unorderedIdentity(value: unknown): string {
-  if (Array.isArray(value))
-    return `[${value.map(unorderedIdentity).sort().join(",")}]`;
-  if (isRecord(value))
-    return `{${Object.entries(value)
-      .sort(([a], [b]) => compareCanonicalStrings(a, b))
-      .map(
-        ([key, entry]) => `${JSON.stringify(key)}:${unorderedIdentity(entry)}`,
-      )
-      .join(",")}}`;
-  return JSON.stringify(value) ?? "null";
-}
-
-function sameNormalized(
-  left: unknown,
-  right: unknown,
-  options: DeliveryReadOptions,
-): boolean {
-  return options.allowLegacyOrder
-    ? unorderedIdentity(left) === unorderedIdentity(right)
-    : canonicalJson(left) === canonicalJson(right);
-}
-
-function parseCanonicalReceipt<T>(
-  bytes: Uint8Array,
-  code: string,
-  options: DeliveryReadOptions = {},
-): T {
-  const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(text);
-  } catch {
-    throw new Error(code);
-  }
-  if (
-    `${canonicalJson(parsed)}\n` !== text &&
-    (!options.allowLegacyOrder || `${JSON.stringify(parsed)}\n` !== text)
-  )
-    throw new Error(code);
-  return parsed as T;
-}
-
-export function compileGateAReceipt(input: {
-  change: string;
-  schema: string;
-  approval: GateApprovalProof;
-  artifacts: readonly DeliveryArtifactBinding[];
-}): { receipt: GateAReceipt; bytes: Uint8Array; rawSha256: string } {
-  requireReceiptIdentity(input.change, input.schema);
-  const receipt: GateAReceipt = {
-    change: input.change,
-    schema: input.schema,
-    approval: normalizeGateProof(input.approval),
-    artifacts: normalizeArtifactBindings(input.artifacts),
-  };
-  const bytes = canonicalBytes(receipt);
-  return {
-    receipt,
-    bytes,
-    rawSha256: createHash("sha256").update(bytes).digest("hex"),
-  };
-}
-
-export function parseGateAReceipt(
-  bytes: Uint8Array,
-  options: DeliveryReadOptions = {},
-): GateAReceipt {
-  const receipt = parseCanonicalReceipt<GateAReceipt>(
-    bytes,
-    "gate-a-receipt-invalid",
-    options,
-  );
-  if (
-    !isRecord(receipt) ||
-    !exactKeys(receipt, ["change", "schema", "approval", "artifacts"]) ||
-    !isRecord(receipt.approval) ||
-    !exactKeys(receipt.approval, ["revision", "contractHash", "recordHash"])
-  ) {
-    throw new Error("gate-a-receipt-invalid");
-  }
-  requireReceiptIdentity(receipt.change, receipt.schema);
-  const approval = normalizeGateProof(receipt.approval);
-  const artifacts = normalizeArtifactBindings(receipt.artifacts);
-  if (
-    !sameNormalized(approval, receipt.approval, options) ||
-    !sameNormalized(artifacts, receipt.artifacts, options)
-  ) {
-    throw new Error("gate-a-receipt-invalid");
-  }
-  return structuredClone(receipt);
-}
-
-function normalizeTraceability(
-  value: DeliveryTraceability,
-): DeliveryTraceability {
-  if (
-    !isRecord(value) ||
-    !exactKeys(value, [
-      "taskPath",
-      "referenceCount",
-      "taskCount",
-      "verificationCount",
-      "canonicalHash",
-    ]) ||
-    value.taskPath !== "tasks.md" ||
-    !Number.isSafeInteger(value.referenceCount) ||
-    value.referenceCount < 1 ||
-    !Number.isSafeInteger(value.taskCount) ||
-    value.taskCount < 1 ||
-    !Number.isSafeInteger(value.verificationCount) ||
-    value.verificationCount < 1 ||
-    typeof value.canonicalHash !== "string" ||
-    !SHA256.test(value.canonicalHash)
-  ) {
-    throw new Error("delivery-traceability-invalid");
-  }
-  return structuredClone(value);
-}
-
-export function compileReadyReceipt(input: {
-  change: string;
-  schema: string;
-  deliveryRevision: number;
-  gateA: { rawSha256: string };
-  gateB: GateApprovalProof;
-  artifacts: readonly DeliveryArtifactBinding[];
-  compiledPlan: CompiledDelivery;
-  traceability: DeliveryTraceability;
-}): { receipt: ReadyReceipt; bytes: Uint8Array; rawSha256: string } {
-  requireReceiptIdentity(input.change, input.schema);
-  if (
-    !Number.isSafeInteger(input.deliveryRevision) ||
-    input.deliveryRevision < 1 ||
-    !SHA256.test(input.gateA.rawSha256) ||
-    input.compiledPlan.plan.changeId !== input.change ||
-    input.gateB.contractHash !== input.compiledPlan.planHash
-  ) {
-    throw new Error("delivery-receipt-invalid");
-  }
-  const receipt: ReadyReceipt = {
-    change: input.change,
-    schema: input.schema,
-    deliveryRevision: input.deliveryRevision,
-    approvals: {
-      gateA: {
-        path: GATE_A_RECEIPT_PATH,
-        rawSha256: input.gateA.rawSha256,
-      },
-      gateB: normalizeGateProof(input.gateB),
-    },
-    artifacts: normalizeArtifactBindings(input.artifacts),
-    plan: structuredClone(input.compiledPlan.receipt.plan),
-    verificationClosure: structuredClone(
-      input.compiledPlan.receipt.verificationClosure,
-    ),
-    traceability: normalizeTraceability(input.traceability),
-    openspec: { strict: true, planningComplete: true },
-  };
-  const bytes = canonicalBytes(receipt);
-  return {
-    receipt,
-    bytes,
-    rawSha256: createHash("sha256").update(bytes).digest("hex"),
-  };
-}
-
-export function parseReadyReceipt(
-  bytes: Uint8Array,
-  options: DeliveryReadOptions = {},
-): ReadyReceipt {
-  const receipt = parseCanonicalReceipt<ReadyReceipt>(
-    bytes,
-    "delivery-receipt-invalid",
-    options,
-  );
-  if (
-    !isRecord(receipt) ||
-    !exactKeys(receipt, [
-      "change",
-      "schema",
-      "deliveryRevision",
-      "approvals",
-      "artifacts",
-      "plan",
-      "verificationClosure",
-      "traceability",
-      "openspec",
-    ]) ||
-    !Number.isSafeInteger(receipt.deliveryRevision) ||
-    receipt.deliveryRevision < 1 ||
-    !isRecord(receipt.approvals) ||
-    !exactKeys(receipt.approvals, ["gateA", "gateB"]) ||
-    !isRecord(receipt.approvals.gateA) ||
-    !exactKeys(receipt.approvals.gateA, ["path", "rawSha256"]) ||
-    receipt.approvals.gateA.path !== GATE_A_RECEIPT_PATH ||
-    !SHA256.test(receipt.approvals.gateA.rawSha256) ||
-    !isRecord(receipt.approvals.gateB) ||
-    !exactKeys(receipt.approvals.gateB, [
-      "revision",
-      "contractHash",
-      "recordHash",
-    ]) ||
-    !isRecord(receipt.plan) ||
-    !exactKeys(receipt.plan, ["path", "rawSha256", "canonicalHash"]) ||
-    receipt.plan.path !== IMPLEMENT_PLAN_PATH ||
-    !SHA256.test(receipt.plan.rawSha256) ||
-    !SHA256.test(receipt.plan.canonicalHash) ||
-    !isRecord(receipt.verificationClosure) ||
-    !exactKeys(receipt.verificationClosure, ["executable", "diagnostics"]) ||
-    receipt.verificationClosure.executable !== true ||
-    !Array.isArray(receipt.verificationClosure.diagnostics) ||
-    receipt.verificationClosure.diagnostics.length !== 0 ||
-    !isRecord(receipt.openspec) ||
-    !exactKeys(receipt.openspec, ["strict", "planningComplete"]) ||
-    receipt.openspec.strict !== true ||
-    receipt.openspec.planningComplete !== true
-  ) {
-    throw new Error("delivery-receipt-invalid");
-  }
-  requireReceiptIdentity(receipt.change, receipt.schema);
-  const artifacts = normalizeArtifactBindings(receipt.artifacts);
-  const gateB = normalizeGateProof(receipt.approvals.gateB);
-  const traceability = normalizeTraceability(receipt.traceability);
-  if (
-    gateB.contractHash !== receipt.plan.canonicalHash ||
-    !sameNormalized(gateB, receipt.approvals.gateB, options) ||
-    !sameNormalized(artifacts, receipt.artifacts, options) ||
-    !sameNormalized(traceability, receipt.traceability, options)
-  ) {
-    throw new Error("delivery-receipt-invalid");
-  }
-  return structuredClone(receipt);
-}
-
-function sortStrings(values: readonly string[]): string[] {
-  return [...values].sort((left, right) =>
-    compareCanonicalStrings(left, right),
-  );
-}
-
-function sortCanonical<T>(values: readonly T[]): T[] {
-  return [...values].sort((left, right) =>
-    compareCanonicalStrings(canonicalJson(left), canonicalJson(right)),
-  );
-}
-
-function normalizeVerification(
-  verification: unknown,
-): StructuredVerificationContract {
-  const validation = validateVerificationContract(verification);
-  if (!validation.ok) throw new Error("delivery-verification-invalid");
-  const cloned = validation.value;
-  if (cloned.kind === "vitest") {
-    cloned.testFiles = sortStrings(cloned.testFiles);
-  } else if (cloned.kind === "steps") {
-    cloned.steps = cloned.steps.map((step) => {
-      if (step.kind !== "vitest") return step;
-      return { ...step, testFiles: sortStrings(step.testFiles) };
-    });
-  }
-  return cloned;
-}
-
-function normalizePhase(value: unknown, readOnly = false): PhaseBoundary {
-  if (
-    !isRecord(value) ||
-    !exactKeys(value, [
-      "read",
-      "write",
-      "delete",
-      "verification",
-      "verificationInputs",
-      ...(Object.hasOwn(value, "verificationLock") ? ["verificationLock"] : []),
-    ]) ||
-    !Array.isArray(value.read) ||
-    !Array.isArray(value.write) ||
-    !Array.isArray(value.delete) ||
-    !Array.isArray(value.verificationInputs) ||
-    !value.read.every(isValidRelativePath) ||
-    !value.write.every(isValidRelativePath) ||
-    !value.delete.every(isValidRelativePath)
-  ) {
-    throw new Error("delivery-plan-invalid-phase");
-  }
-  const write = sortStrings(value.write as string[]);
-  const deletions = sortStrings(value.delete as string[]);
-  if (!readOnly && write.length + deletions.length === 0) {
-    throw new Error("delivery-plan-empty-phase-boundary");
-  }
-  if (write.some((candidate) => deletions.includes(candidate))) {
-    throw new Error("delivery-plan-write-delete-overlap");
-  }
-  return {
-    read: sortStrings(value.read as string[]),
-    write,
-    delete: deletions,
-    verification: normalizeVerification(
-      value.verification as StructuredVerificationContract,
-    ),
-    verificationInputs: sortCanonical(
-      structuredClone(
-        value.verificationInputs,
-      ) as PhaseBoundary["verificationInputs"],
-    ),
-    ...(typeof value.verificationLock === "string"
-      ? { verificationLock: value.verificationLock }
-      : {}),
-  };
-}
-
-function normalizeTask(
-  value: unknown,
-  options: {
-    consumerRoot?: string;
-    preserveMissingBaseline?: boolean;
-  } = {},
-): PlanTaskDraft {
-  const taskId =
-    isRecord(value) && typeof value.taskId === "string"
-      ? value.taskId
-      : undefined;
-  const context = taskId ? { taskId } : {};
-  try {
-    if (
-      !isRecord(value) ||
-      !isRecord(value.phases) ||
-      !isRecord(value.affectedVerification) ||
-      !isRecord(value.repairVerification)
-    ) {
-      throw new Error("delivery-plan-invalid-task");
-    }
-    const phases = value.phases;
-    if (!Object.hasOwn(phases, "red") || !Object.hasOwn(phases, "green")) {
-      throw new Error("delivery-plan-invalid-task-phases");
-    }
-    const cloned = structuredClone(value) as unknown as PlanTaskDraft;
-    let affectedVerification: StructuredVerificationContract;
-    try {
-      affectedVerification = normalizeVerification(value.affectedVerification);
-    } catch (error) {
-      throw asPlanValidationError(error, {
-        ...context,
-        field: "affectedVerification",
-      });
-    }
-    let repairVerification: StructuredVerificationContract;
-    try {
-      repairVerification = normalizeVerification(value.repairVerification);
-    } catch (error) {
-      throw asPlanValidationError(error, {
-        ...context,
-        field: "repairVerification",
-      });
-    }
-    let baselineVerification: StructuredVerificationContract | undefined;
-    if (value.baselineVerification !== undefined) {
-      try {
-        baselineVerification = normalizeVerification(
-          value.baselineVerification,
-        );
-      } catch (error) {
-        throw asPlanValidationError(error, {
-          ...context,
-          field: "baselineVerification",
-        });
-      }
-    } else if (!options.preserveMissingBaseline) {
-      const unavailable = verificationInputPaths(affectedVerification).filter(
-        (input) =>
-          !options.consumerRoot ||
-          !isSafeRegularFile(options.consumerRoot, input),
-      );
-      if (unavailable.length > 0) {
-        throw new DesignPlanValidationError(
-          "delivery-task-baseline-unavailable",
-          unavailable.map((input) => ({
-            code: "workspace-input-unavailable",
-            ...context,
-            field: "baselineVerification",
-            verificationId: affectedVerification.id,
-            path: input,
-          })),
-        );
-      }
-      baselineVerification = structuredClone(affectedVerification);
-    }
-    if (
-      (baselineVerification &&
-        baselineVerification.classification !== "expected-green") ||
-      affectedVerification.classification !== "expected-green" ||
-      repairVerification.classification !== "expected-green"
-    ) {
-      throw new Error("delivery-task-verification-invalid");
-    }
-    const normalizeTaskPhase = (
-      phase: "red" | "green" | "refactor",
-      candidate: unknown,
-    ) => {
-      try {
-        return normalizePhase(
-          candidate,
-          phase === "red" &&
-            value.verificationMode !== undefined &&
-            value.verificationMode !== "behavior",
-        );
-      } catch (error) {
-        throw asPlanValidationError(error, {
-          ...context,
-          phase,
-          field: `phases.${phase}`,
-        });
-      }
-    };
-    return {
-      ...cloned,
-      dependsOn: sortStrings(cloned.dependsOn),
-      roots: sortStrings(cloned.roots),
-      phases: {
-        red: normalizeTaskPhase("red", phases.red),
-        green: normalizeTaskPhase("green", phases.green),
-        ...(phases.refactor !== undefined
-          ? { refactor: normalizeTaskPhase("refactor", phases.refactor) }
-          : {}),
-      },
-      scheduling: {
-        conflicts: sortStrings(cloned.scheduling.conflicts),
-        resources: sortStrings(cloned.scheduling.resources),
-      },
-      approvedDependencies: sortStrings(cloned.approvedDependencies),
-      ...(baselineVerification ? { baselineVerification } : {}),
-      affectedVerification,
-      repairVerification,
-      impactClosure: {
-        changedSurfaces: sortStrings(
-          cloned.impactClosure.changedSurfaces,
-        ) as PlanTaskDraft["impactClosure"]["changedSurfaces"],
-        searchEvidence: sortStrings(cloned.impactClosure.searchEvidence),
-        relatedTests: [...cloned.impactClosure.relatedTests].sort(
-          (left, right) =>
-            compareCanonicalStrings(left.path, right.path) ||
-            compareCanonicalStrings(left.disposition, right.disposition),
-        ),
-        affectedSuite: sortStrings(cloned.impactClosure.affectedSuite),
-      },
-    };
-  } catch (error) {
-    throw asPlanValidationError(error, context);
-  }
-}
-
-function graphFromPlan(plan: ImplementPlan): ImplementGraphBoundary {
-  const stripPhase = (phase: PhaseBoundary): PhaseBoundary => ({
-    read: phase.read,
-    write: phase.write,
-    delete: phase.delete,
-    verification: phase.verification,
-    verificationInputs: phase.verificationInputs,
-    ...(phase.verificationLock
-      ? { verificationLock: phase.verificationLock }
-      : {}),
-  });
-  return {
-    changeId: plan.changeId,
-    tasks: plan.tasks.map((task) => {
-      const {
-        baselineVerification: _baselineVerification,
-        affectedVerification: _affectedVerification,
-        repairVerification: _repairVerification,
-        ...boundary
-      } = task;
-      return {
-        ...boundary,
-        phases: {
-          red: stripPhase(task.phases.red),
-          green: stripPhase(task.phases.green),
-          ...(task.phases.refactor
-            ? { refactor: stripPhase(task.phases.refactor) }
-            : {}),
-        },
-      };
-    }),
-    outputs: structuredClone(plan.outputs),
-  };
-}
-
-type PathOperation = {
-  taskId: string;
-  phase: "red" | "green" | "refactor";
-  kind: "write" | "delete";
-};
-
-const PLAN_PHASE_INDEX = { red: 0, green: 1, refactor: 2 } as const;
-
-function taskAncestors(
-  taskId: string,
-  tasks: ReadonlyMap<string, PlanTaskDraft>,
-): Set<string> {
-  const ancestors = new Set<string>();
-  const pending = [...(tasks.get(taskId)?.dependsOn ?? [])];
-  while (pending.length > 0) {
-    const dependency = pending.pop() as string;
-    if (ancestors.has(dependency)) continue;
-    ancestors.add(dependency);
-    pending.push(...(tasks.get(dependency)?.dependsOn ?? []));
-  }
-  return ancestors;
-}
-
-function pathOperations(plan: ImplementPlan, input: string): PathOperation[] {
-  return plan.tasks.flatMap((task) =>
-    (["red", "green", "refactor"] as const).flatMap((phase) => {
-      const boundary = task.phases[phase];
-      if (!boundary) return [];
-      return [
-        ...(boundary.write.includes(input)
-          ? [{ taskId: task.taskId, phase, kind: "write" as const }]
-          : []),
-        ...(boundary.delete.includes(input)
-          ? [{ taskId: task.taskId, phase, kind: "delete" as const }]
-          : []),
-      ];
-    }),
-  );
-}
-
-function operationBefore(
-  left: PathOperation,
-  right: PathOperation,
-  ancestors: ReadonlyMap<string, ReadonlySet<string>>,
-): boolean {
-  return left.taskId === right.taskId
-    ? PLAN_PHASE_INDEX[left.phase] < PLAN_PHASE_INDEX[right.phase]
-    : (ancestors.get(right.taskId)?.has(left.taskId) ?? false);
-}
-
-function pathSurvives(
-  operations: readonly PathOperation[],
-  ancestors: ReadonlyMap<string, ReadonlySet<string>>,
-): boolean {
-  return operations
-    .filter((operation) => operation.kind === "delete")
-    .every((deletion) =>
-      operations.some(
-        (operation) =>
-          operation.kind === "write" &&
-          operationBefore(deletion, operation, ancestors),
-      ),
-    );
-}
-
-/**
- * File-level acceptance entrypoints named directly by a verification contract.
- * Vitest identifies its test files and a Node static check identifies its
- * executable script. Package scripts do not expose selected files, and an
- * unrelated helper or data output is not promoted merely because of its path.
- */
-function verificationAcceptanceEntrypoints(
-  verification: StructuredVerificationContract,
-): string[] {
-  return verificationSteps(verification).flatMap((step) => {
-    if (step.kind === "vitest") return step.testFiles;
-    if (step.kind === "static-check" && step.runner.kind === "node") {
-      return [step.runner.script];
-    }
-    return [];
-  });
-}
-
-function agentsTargetAvailable(
-  root: string,
-  operation: PlanAgentsCheckpointOperation,
-): boolean {
-  if (operation.impact === "create-index") {
-    return ["absent", "file"].includes(
-      observeSafePath(root, operation.target).kind,
-    );
-  }
-  if (!isSafeRegularFile(root, operation.target)) return false;
-  if (operation.impact === "update-existing") return true;
-  try {
-    const text = new TextDecoder("utf-8", { fatal: true }).decode(
-      readFileSync(path.join(root, operation.target)),
-    );
-    const start = text.indexOf(AGENTS_START);
-    const end = text.indexOf(AGENTS_END);
-    if (
-      start < 0 ||
-      end <= start ||
-      text.indexOf(AGENTS_START, start + AGENTS_START.length) >= 0 ||
-      text.indexOf(AGENTS_END, end + AGENTS_END.length) >= 0
-    ) {
-      return false;
-    }
-    return (
-      `${text.slice(0, start)}${text.slice(end + AGENTS_END.length)}`.trim()
-        .length > 0
-    );
-  } catch {
-    return false;
-  }
-}
-
-function inputTimingDiagnostics(
-  plan: ImplementPlan,
-  consumerRoot: string,
-): DesignPlanDiagnostic[] {
-  const diagnostics: DesignPlanDiagnostic[] = [];
-  const tasks = new Map(plan.tasks.map((task) => [task.taskId, task]));
-  const ancestors = new Map(
-    plan.tasks.map((task) => [task.taskId, taskAncestors(task.taskId, tasks)]),
-  );
-  const outputByPath = new Map(
-    plan.outputs.map((output) => [output.path, output]),
-  );
-  const agentsOperations = new Map(
-    plan.verification.agentsCheckpoint.operations.map((operation) => [
-      operation.target,
-      operation,
-    ]),
-  );
-  const unavailable = (input: {
-    field: string;
-    verification: StructuredVerificationContract;
-    path: string;
-    task?: PlanTaskDraft;
-    code: "workspace-input-unavailable" | "producer-output-unavailable";
-  }) => {
-    const output = outputByPath.get(input.path);
-    diagnostics.push({
-      code: input.code,
-      ...(input.task ? { taskId: input.task.taskId } : {}),
-      field: input.field,
-      verificationId: input.verification.id,
-      path: input.path,
-      ...(output
-        ? {
-            outputId: output.id,
-            producerTaskId: output.producer.taskId,
-            producerPhase: output.producer.phase,
-          }
-        : {}),
-    });
-  };
-
-  const requireOriginalInputs = (
-    field: string,
-    verification: StructuredVerificationContract,
-    task?: PlanTaskDraft,
-  ) => {
-    for (const input of verificationInputPaths(verification)) {
-      if (!isSafeRegularFile(consumerRoot, input)) {
-        unavailable({
-          field,
-          verification,
-          path: input,
-          task,
-          code: "workspace-input-unavailable",
-        });
-      }
-    }
-  };
-  const requireInput = (
-    field: string,
-    verification: StructuredVerificationContract,
-    input: string,
-    task?: PlanTaskDraft,
-  ) => {
-    const actualPaths = verificationInputPaths(verification).sort(
-      compareCanonicalStrings,
-    );
-    if (actualPaths.includes(input)) return;
-    diagnostics.push({
-      code: "verification-input-binding-mismatch",
-      ...(task ? { taskId: task.taskId } : {}),
-      field,
-      verificationId: verification.id,
-      path: input,
-      expectedPaths: [...new Set([...actualPaths, input])].sort(
-        compareCanonicalStrings,
-      ),
-      actualPaths,
-    });
-  };
-
-  for (const task of plan.tasks) {
-    if (task.baselineVerification) {
-      requireOriginalInputs(
-        "baselineVerification",
-        task.baselineVerification,
-        task,
-      );
-    }
-    const permittedTasks = new Set([
-      task.taskId,
-      ...(ancestors.get(task.taskId) ?? []),
-    ]);
-    for (const [field, verification] of [
-      ["affectedVerification", task.affectedVerification],
-      ["repairVerification", task.repairVerification],
-    ] as const) {
-      for (const input of verificationInputPaths(verification)) {
-        const output = outputByPath.get(input);
-        if (output && !permittedTasks.has(output.producer.taskId)) {
-          diagnostics.push({
-            code: "producer-not-dependency",
-            taskId: task.taskId,
-            field,
-            verificationId: verification.id,
-            path: input,
-            outputId: output.id,
-            producerTaskId: output.producer.taskId,
-            producerPhase: output.producer.phase,
-          });
-          continue;
-        }
-        const operations = pathOperations(plan, input).filter((operation) =>
-          permittedTasks.has(operation.taskId),
-        );
-        if (
-          (!output && !isSafeRegularFile(consumerRoot, input)) ||
-          !pathSurvives(operations, ancestors)
-        ) {
-          unavailable({
-            field,
-            verification,
-            path: input,
-            task,
-            code: output
-              ? "producer-output-unavailable"
-              : "workspace-input-unavailable",
-          });
-        }
-      }
-    }
-  }
-
-  requireOriginalInputs(
-    "verification.baseline.fullSuite",
-    plan.verification.baseline.fullSuite,
-  );
-  const deliveryAcceptanceEntrypoints = new Set([
-    ...verificationAcceptanceEntrypoints(plan.verification.change.fullSuite),
-    ...verificationAcceptanceEntrypoints(plan.verification.change.postApply),
-    ...(plan.verification.agentsCheckpoint.verification
-      ? verificationAcceptanceEntrypoints(
-          plan.verification.agentsCheckpoint.verification,
-        )
-      : []),
-  ]);
-  for (const output of plan.outputs) {
-    const producer = tasks.get(output.producer.taskId);
-    const target = producer?.phases[output.producer.phase];
-    if (
-      !producer ||
-      !target ||
-      observeSafePath(consumerRoot, output.path).kind !== "absent"
-    ) {
-      continue;
-    }
-    const declaredTests = new Set([
-      ...producer.impactClosure.relatedTests.map((test) => test.path),
-      ...producer.impactClosure.affectedSuite,
-      ...(["red", "green", "refactor"] as const).flatMap((phase) => {
-        const boundary = producer.phases[phase];
-        return boundary
-          ? verificationAcceptanceEntrypoints(boundary.verification)
-          : [];
-      }),
-      ...verificationAcceptanceEntrypoints(producer.affectedVerification),
-      ...verificationAcceptanceEntrypoints(producer.repairVerification),
-      ...deliveryAcceptanceEntrypoints,
-    ]);
-    if (!declaredTests.has(output.path)) continue;
-    for (const phase of ["red", "green", "refactor"] as const) {
-      const boundary = producer.phases[phase];
-      if (
-        !boundary ||
-        PLAN_PHASE_INDEX[phase] < PLAN_PHASE_INDEX[output.producer.phase]
-      ) {
-        continue;
-      }
-      requireInput(
-        `phases.${phase}.verification`,
-        boundary.verification,
-        output.path,
-        producer,
-      );
-    }
-    requireInput(
-      "affectedVerification",
-      producer.affectedVerification,
-      output.path,
-      producer,
-    );
-    requireInput(
-      "repairVerification",
-      producer.repairVerification,
-      output.path,
-      producer,
-    );
-    requireInput(
-      "verification.change.fullSuite",
-      plan.verification.change.fullSuite,
-      output.path,
-    );
-    requireInput(
-      "verification.change.postApply",
-      plan.verification.change.postApply,
-      output.path,
-    );
-  }
-  for (const [field, verification, afterAgents] of [
-    [
-      "verification.change.fullSuite",
-      plan.verification.change.fullSuite,
-      false,
-    ],
-    ["verification.change.postApply", plan.verification.change.postApply, true],
-    ...(plan.verification.agentsCheckpoint.verification
-      ? ([
-          [
-            "verification.agentsCheckpoint.verification",
-            plan.verification.agentsCheckpoint.verification,
-            true,
-          ],
-        ] as const)
-      : []),
-  ] as const) {
-    for (const input of verificationInputPaths(verification)) {
-      const output = outputByPath.get(input);
-      const operations = pathOperations(plan, input);
-      const agentsOperation = afterAgents
-        ? agentsOperations.get(input)
-        : undefined;
-      if (
-        agentsOperation
-          ? !agentsTargetAvailable(consumerRoot, agentsOperation)
-          : (!output && !isSafeRegularFile(consumerRoot, input)) ||
-            !pathSurvives(operations, ancestors)
-      ) {
-        unavailable({
-          field,
-          verification,
-          path: input,
-          code: output
-            ? "producer-output-unavailable"
-            : "workspace-input-unavailable",
-        });
-      }
-    }
-  }
-  return diagnostics;
-}
-
-function deliveryVerificationDiagnostics(
-  plan: ImplementPlan,
-  consumerRoot: string,
-): Array<Record<string, unknown>> {
-  const contracts: Array<{
-    owner: string;
-    verification: StructuredVerificationContract;
-  }> = plan.tasks.flatMap((task) => [
-    ...(task.baselineVerification
-      ? [
-          {
-            owner: `task:${task.taskId}:baseline`,
-            verification: task.baselineVerification,
-          },
-        ]
-      : []),
-    {
-      owner: `task:${task.taskId}:affected`,
-      verification: task.affectedVerification,
-    },
-    {
-      owner: `task:${task.taskId}:repair`,
-      verification: task.repairVerification,
-    },
-  ]);
-  contracts.push(
-    {
-      owner: "baseline:full-suite",
-      verification: plan.verification.baseline.fullSuite,
-    },
-    {
-      owner: "change:full-suite",
-      verification: plan.verification.change.fullSuite,
-    },
-    {
-      owner: "change:post-apply",
-      verification: plan.verification.change.postApply,
-    },
-  );
-  if (plan.verification.agentsCheckpoint.verification) {
-    contracts.push({
-      owner: "agents-checkpoint",
-      verification: plan.verification.agentsCheckpoint.verification,
-    });
-  }
-  return contracts.flatMap(({ owner, verification }) => {
-    const capability = validateVerificationAdapterCapability(
-      consumerRoot,
-      verification,
-      { dependencyOwner: consumerRoot },
-    );
-    if (capability.ok) return [];
-    const { message: _message, ...diagnostic } = capability.diagnostic;
-    return [{ owner, ...diagnostic }];
-  });
-}
-
-function normalizeExpectedGreenVerification(
-  value: unknown,
-): StructuredVerificationContract {
-  const verification = normalizeVerification(value);
-  if (verification.classification !== "expected-green") {
-    throw new Error("delivery-verification-classification-invalid");
-  }
-  return verification;
-}
-
-function normalizeAgentsManagedBlock(value: unknown): string {
-  if (
-    typeof value !== "string" ||
-    value.length === 0 ||
-    Buffer.byteLength(value) > 64 * 1024 ||
-    value.includes("\0") ||
-    value.includes("\r")
-  ) {
-    throw new Error("delivery-agents-checkpoint-invalid");
-  }
-  const lines = value.endsWith("\n")
-    ? value.slice(0, -1).split("\n")
-    : value.split("\n");
-  if (
-    lines[0] !== AGENTS_START ||
-    lines.at(-1) !== AGENTS_END ||
-    lines.filter((line) => line === AGENTS_START).length !== 1 ||
-    lines.filter((line) => line === AGENTS_END).length !== 1
-  ) {
-    throw new Error("delivery-agents-checkpoint-invalid");
-  }
-  return lines.join("\n");
-}
-
-function normalizeAgentsCheckpointOperations(
-  value: unknown,
-): PlanAgentsCheckpointOperation[] {
-  if (!Array.isArray(value) || value.length > 64) {
-    throw new Error("delivery-agents-checkpoint-invalid");
-  }
-  const targets = new Set<string>();
-  return value
-    .map((operation): PlanAgentsCheckpointOperation => {
-      if (
-        !isRecord(operation) ||
-        !exactKeys(operation, [
-          "target",
-          "impact",
-          "taskIds",
-          "managedBlock",
-        ]) ||
-        !isAgentsPath(operation.target) ||
-        !["update-existing", "create-index", "remove-index"].includes(
-          String(operation.impact),
-        ) ||
-        targets.has(operation.target) ||
-        !Array.isArray(operation.taskIds) ||
-        operation.taskIds.length === 0 ||
-        operation.taskIds.some(
-          (taskId) => typeof taskId !== "string" || taskId.length === 0,
-        ) ||
-        new Set(operation.taskIds).size !== operation.taskIds.length
-      ) {
-        throw new Error("delivery-agents-checkpoint-invalid");
-      }
-      targets.add(operation.target);
-      const impact = operation.impact as Exclude<AgentsImpact, "none">;
-      if (
-        (impact === "remove-index" && operation.managedBlock !== null) ||
-        (impact !== "remove-index" &&
-          typeof operation.managedBlock !== "string")
-      ) {
-        throw new Error("delivery-agents-checkpoint-invalid");
-      }
-      return {
-        target: operation.target,
-        impact,
-        taskIds: sortStrings(operation.taskIds as string[]),
-        managedBlock:
-          impact === "remove-index"
-            ? null
-            : normalizeAgentsManagedBlock(operation.managedBlock),
-      };
-    })
-    .sort((left, right) => compareCanonicalStrings(left.target, right.target));
-}
-
-function normalizeVerificationPlan(value: unknown): PlanVerification {
-  if (
-    isRecord(value) &&
-    isRecord(value.change) &&
-    value.change.affected !== "task-affected-contracts"
-  ) {
-    throw new DesignPlanValidationError("delivery-verification-plan-invalid", [
-      {
-        code: "delivery-verification-plan-invalid",
-        field: "verification.change.affected",
-        category: "enum",
-        allowedValues: ["task-affected-contracts"],
-      },
-    ]);
-  }
-  if (
-    !isRecord(value) ||
-    !exactKeys(value, [
-      "baseline",
-      "change",
-      "artifactCorrection",
-      "repair",
-      "agentsCheckpoint",
-    ]) ||
-    !isRecord(value.baseline) ||
-    !exactKeys(value.baseline, [
-      "target",
-      "affected",
-      "fullSuite",
-      "failureIdentity",
-    ]) ||
-    value.baseline.target !== "task-red-contracts" ||
-    value.baseline.affected !== "task-affected-contracts" ||
-    value.baseline.failureIdentity !== "normalized" ||
-    !isRecord(value.change) ||
-    !exactKeys(value.change, ["affected", "fullSuite", "postApply"]) ||
-    value.change.affected !== "task-affected-contracts" ||
-    !isRecord(value.artifactCorrection) ||
-    !exactKeys(value.artifactCorrection, ["maxAttempts"]) ||
-    !Number.isSafeInteger(value.artifactCorrection.maxAttempts) ||
-    (value.artifactCorrection.maxAttempts as number) < 2 ||
-    (value.artifactCorrection.maxAttempts as number) > 3 ||
-    !isRecord(value.repair) ||
-    !exactKeys(value.repair, [
-      "maxAttempts",
-      "inBoundaryOnly",
-      "approvalOnBoundaryExpansion",
-      "attribution",
-    ]) ||
-    typeof value.repair.maxAttempts !== "number" ||
-    !Number.isSafeInteger(value.repair.maxAttempts) ||
-    value.repair.maxAttempts < 1 ||
-    value.repair.maxAttempts > 3 ||
-    value.repair.inBoundaryOnly !== true ||
-    value.repair.approvalOnBoundaryExpansion !== true ||
-    canonicalJson(value.repair.attribution) !==
-      canonicalJson([
-        "pre-existing",
-        "introduced",
-        "unresolved",
-        "environment",
-      ]) ||
-    !isRecord(value.agentsCheckpoint) ||
-    !exactKeys(value.agentsCheckpoint, [
-      "required",
-      "verification",
-      "operations",
-    ]) ||
-    typeof value.agentsCheckpoint.required !== "boolean" ||
-    (value.agentsCheckpoint.required &&
-      !isRecord(value.agentsCheckpoint.verification)) ||
-    (!value.agentsCheckpoint.required &&
-      value.agentsCheckpoint.verification !== null) ||
-    !Array.isArray(value.agentsCheckpoint.operations)
-  ) {
-    throw new Error("delivery-verification-plan-invalid");
-  }
-  return {
-    baseline: {
-      target: "task-red-contracts",
-      affected: "task-affected-contracts",
-      fullSuite: normalizeExpectedGreenVerification(value.baseline.fullSuite),
-      failureIdentity: "normalized",
-    },
-    change: {
-      affected: "task-affected-contracts",
-      fullSuite: normalizeExpectedGreenVerification(value.change.fullSuite),
-      postApply: normalizeExpectedGreenVerification(value.change.postApply),
-    },
-    artifactCorrection: {
-      maxAttempts: value.artifactCorrection.maxAttempts as number,
-    },
-    repair: {
-      maxAttempts: value.repair.maxAttempts as number,
-      inBoundaryOnly: true,
-      approvalOnBoundaryExpansion: true,
-      attribution: ["pre-existing", "introduced", "unresolved", "environment"],
-    },
-    agentsCheckpoint: {
-      required: value.agentsCheckpoint.required,
-      verification: value.agentsCheckpoint.required
-        ? normalizeExpectedGreenVerification(
-            value.agentsCheckpoint.verification,
-          )
-        : null,
-      operations: normalizeAgentsCheckpointOperations(
-        value.agentsCheckpoint.operations,
-      ),
-    },
-  };
-}
-
-function normalizeTracking(value: unknown): PlanTracking {
-  if (
-    !isRecord(value) ||
-    !exactKeys(value, ["path", "format", "taskIds", "completionOwner"]) ||
-    value.path !== "tasks.md" ||
-    value.format !== "markdown-checkbox" ||
-    !Array.isArray(value.taskIds) ||
-    !value.taskIds.every((taskId) => typeof taskId === "string") ||
-    new Set(value.taskIds).size !== value.taskIds.length ||
-    value.completionOwner !== "parent"
-  ) {
-    throw new Error("delivery-tracking-invalid");
-  }
-  return {
-    path: "tasks.md",
-    format: "markdown-checkbox",
-    taskIds: sortStrings(value.taskIds as string[]),
-    completionOwner: "parent",
-  };
-}
-
-function normalizeDraft(
-  value: unknown,
-  options: {
-    consumerRoot?: string;
-    preserveMissingTaskBaselines?: boolean;
-  } = {},
-): ImplementPlan {
-  value = structuredClone(value);
-  if (
-    !isRecord(value) ||
-    !exactKeys(value, [
-      "changeId",
-      "tasks",
-      "outputs",
-      "verification",
-      "tracking",
-      ...(value.changeContract === undefined ? [] : ["changeContract"]),
-    ]) ||
-    typeof value.changeId !== "string" ||
-    !CHANGE_NAME.test(value.changeId) ||
-    !Array.isArray(value.tasks) ||
-    !Array.isArray(value.outputs)
-  ) {
-    throw new Error("delivery-plan-invalid");
-  }
-  const source = value;
-  const taskDrafts = value.tasks.map((task: unknown) => {
-    if (
-      !isRecord(task) ||
-      !["mechanical", "refactor"].includes(String(task.verificationMode))
-    )
-      return task;
-    if (!isRecord(task.phases) || !isRecord(task.phases.green))
-      throw new Error("delivery-plan-invalid-task-phases");
-    if (!source.changeContract)
-      throw new Error("change-contract-verification-mode-required");
-    const green = task.phases.green;
-    return {
-      ...task,
-      phases: { ...task.phases, red: { ...green, write: [], delete: [] } },
-    };
-  });
-  const draftGraph = validateImplementGraphBoundary({
-    changeId: value.changeId,
-    tasks: taskDrafts.map((candidate) => {
-      if (!isRecord(candidate)) return candidate;
-      const {
-        baselineVerification: _baselineVerification,
-        affectedVerification: _affectedVerification,
-        repairVerification: _repairVerification,
-        ...boundary
-      } = candidate;
-      return boundary;
-    }),
-    outputs: value.outputs,
-  });
-  if (!draftGraph.ok) {
-    throw new DesignPlanValidationError(
-      `delivery-plan-invalid:${draftGraph.reason}`,
-      draftGraph.diagnostics ?? [draftGraph.diagnostic],
-    );
-  }
-  const plan: ImplementPlan = {
-    ...(value.changeContract === undefined
-      ? {}
-      : { changeContract: normalizeChangeContract(value.changeContract) }),
-    changeId: value.changeId,
-    tasks: taskDrafts
-      .map((task) =>
-        normalizeTask(task, {
-          consumerRoot: options.consumerRoot,
-          preserveMissingBaseline: options.preserveMissingTaskBaselines,
-        }),
-      )
-      .sort((left, right) =>
-        compareCanonicalStrings(left.taskId, right.taskId),
-      ),
-    outputs: (structuredClone(value.outputs) as ImplementGraphOutput[]).sort(
-      (left, right) => compareCanonicalStrings(left.id, right.id),
-    ),
-    verification: normalizeVerificationPlan(value.verification),
-    tracking: normalizeTracking(value.tracking),
-  };
-  if (
-    canonicalJson(plan.tracking.taskIds) !==
-    canonicalJson(plan.tasks.map((task) => task.taskId).sort())
-  ) {
-    throw new Error("delivery-tracking-task-mismatch");
-  }
-  const agentsTasks = plan.tasks.filter(
-    (task) => task.agents.impact !== "none" && task.agents.target,
-  );
-  const agentsByTarget = new Map<string, PlanTaskDraft[]>();
-  for (const task of agentsTasks) {
-    const target = task.agents.target as string;
-    const existing = agentsByTarget.get(target) ?? [];
-    existing.push(task);
-    agentsByTarget.set(target, existing);
-  }
-  const operations = plan.verification.agentsCheckpoint.operations;
-  const operationsByTarget = new Map(
-    operations.map((operation) => [operation.target, operation]),
-  );
-  const agentsRequired = agentsTasks.length > 0;
-  if (
-    plan.verification.agentsCheckpoint.required !== agentsRequired ||
-    operations.length !== agentsByTarget.size ||
-    [...agentsByTarget].some(([target, tasks]) => {
-      const operation = operationsByTarget.get(target);
-      return (
-        !operation ||
-        tasks.some((task) => task.agents.impact !== operation.impact) ||
-        canonicalJson(operation.taskIds) !==
-          canonicalJson(tasks.map((task) => task.taskId).sort())
-      );
-    })
-  ) {
-    throw new Error("delivery-agents-checkpoint-mismatch");
-  }
-  if (plan.changeContract)
-    assertPlanWithinChangeContract(plan.changeContract, plan.tasks, [
-      plan.verification.change.fullSuite,
-      plan.verification.change.postApply,
-    ]);
-  const graphValidation = validateImplementGraphBoundary(graphFromPlan(plan));
-  if (!graphValidation.ok) {
-    throw new DesignPlanValidationError(
-      `delivery-plan-invalid:${graphValidation.reason}`,
-      [graphValidation.diagnostic],
-    );
-  }
-  return plan;
-}
-
-const TASK_BINDINGS_START = "<!-- ABEL:VERIFICATION-BINDINGS:START -->";
-const TASK_BINDINGS_END = "<!-- ABEL:VERIFICATION-BINDINGS:END -->";
-
-function taskVerificationRegion(markdown: string) {
-  const markers = markdown.match(/<!-- ABEL:VERIFICATION-BINDINGS/gu) ?? [];
-  if (markers.length === 0) return undefined;
-  const match =
-    /^<!-- ABEL:VERIFICATION-BINDINGS:START -->\r?\n[\s\S]*?^<!-- ABEL:VERIFICATION-BINDINGS:END -->(?=\r?$)/mu.exec(
-      markdown,
-    );
-  if (markers.length !== 2 || !match) {
-    throw new DesignPlanValidationError("traceability-managed-region-invalid", [
-      { code: "traceability-managed-region-invalid", path: "tasks.md" },
-    ]);
-  }
-  return {
-    start: match.index,
-    end: match.index + match[0].length,
-    text: match[0],
-  };
-}
-
-// Only identity bindings are generated. Author task checkboxes and Scenario
-// ownership remain outside this region and are validated independently.
-function renderTasks(plan: ImplementPlan): string {
-  const lines = [TASK_BINDINGS_START, "## Compiled verification bindings", ""];
-  for (const task of [...plan.tasks].sort((a, b) =>
-    compareCanonicalStrings(a.taskId, b.taskId),
-  )) {
-    lines.push(
-      `- Task \`${task.taskId}\` (${task.verificationMode ?? "behavior"})`,
-    );
-    if (!task.verificationMode || task.verificationMode === "behavior") {
-      lines.push(`  - Red: \`${task.phases.red.verification.id}\``);
-    }
-    lines.push(`  - Green: \`${task.phases.green.verification.id}\``);
-    if (task.phases.refactor) {
-      lines.push(`  - Refactor: \`${task.phases.refactor.verification.id}\``);
-    }
-  }
-  lines.push(TASK_BINDINGS_END);
-  return lines.join("\n");
-}
-
-export function bindTaskVerifications(
-  markdown: string,
-  plan: ImplementPlan,
-): string {
-  const region = taskVerificationRegion(markdown);
-  const bindings = renderTasks(plan);
-  if (region) {
-    return (
-      markdown.slice(0, region.start) + bindings + markdown.slice(region.end)
-    );
-  }
-  return `${markdown}${markdown.endsWith("\n") ? "\n" : "\n\n"}${bindings}\n`;
-}
-
-export function compileImplementPlan(
-  draft: unknown,
-  options: { consumerRoot: string; bindExecutionInputs?: boolean },
-): CompiledDelivery {
-  try {
-    draft = expandSingleTaskDraft(draft);
-    // Resolve omitted manifest command bytes before named definitions are
-    // validated and purpose identities are hashed. The second pass below
-    // binds execution inputs on the expanded contracts with their final IDs.
-    if (options.bindExecutionInputs)
-      draft = bindDraftVerificationInputs(options.consumerRoot, draft);
-    draft = expandPlanDraft(draft);
-    if (options.bindExecutionInputs)
-      draft = bindDraftVerificationInputs(options.consumerRoot, draft);
-    draft = preparePlanDraft(draft);
-    const retainedLegacy =
-      isRecord(draft) && legacyPlans.get(draft) === JSON.stringify(draft);
-    const normalized = normalizeDraft(draft, {
-      consumerRoot: options.consumerRoot,
-      preserveMissingTaskBaselines: retainedLegacy,
-    });
-    const plan = retainedLegacy
-      ? (draft as unknown as ImplementPlan)
-      : normalized;
-    const graph = graphFromPlan(plan);
-    const readiness = assessImplementGraphReadiness(
-      options.consumerRoot,
-      graph,
-      {
-        completedTasks: [],
-        blockedTasks: [],
-        appliedPhases: [],
-      },
-    );
-    const diagnostics = [
-      ...readiness.closure.diagnostics,
-      ...inputTimingDiagnostics(plan, options.consumerRoot),
-      ...deliveryVerificationDiagnostics(plan, options.consumerRoot),
-    ] as DesignPlanDiagnostic[];
-    if (diagnostics.length > 0) {
-      throw new DesignPlanValidationError(
-        `delivery-plan-not-executable:${canonicalJson(diagnostics)}`,
-        diagnostics,
-      );
-    }
-    const canonical = canonicalJson(plan);
-    const bytes = new TextEncoder().encode(`${canonical}\n`);
-    const rawSha256 = createHash("sha256").update(bytes).digest("hex");
-    const planHash = hashCanonicalValue(plan);
-    const closure = structuredClone(readiness.closure);
-    return {
-      checks: {
-        structure: "passed",
-        verificationCapability: "passed",
-        contractCoverage: plan.changeContract ? "passed" : "not-checked",
-        sealing: "not-performed",
-      },
-      plan,
-      bytes,
-      rawSha256,
-      planHash,
-      closure,
-      receipt: {
-        plan: {
-          path: IMPLEMENT_PLAN_PATH,
-          rawSha256,
-          canonicalHash: planHash,
-        },
-        verificationClosure: structuredClone(closure),
-      },
-      tasksMarkdown: renderTasks(plan),
-    };
-  } catch (error) {
-    throw asPlanValidationError(error);
-  }
-}
-
-export function parseImplementPlan(
-  bytes: Uint8Array,
-  options: DeliveryReadOptions = {},
-): ImplementPlan {
-  const text = new TextDecoder().decode(bytes);
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(text);
-  } catch {
-    throw new Error("delivery-plan-json-invalid");
-  }
-  const normalized = normalizeDraft(parsed, {
-    preserveMissingTaskBaselines: true,
-  });
-  if (`${canonicalJson(normalized)}\n` === text) return normalized;
-  if (
-    !options.allowLegacyOrder ||
-    `${canonicalJson(parsed)}\n` !== text ||
-    !sameNormalized(normalized, parsed, options)
-  ) {
-    throw new Error("delivery-plan-not-canonical");
-  }
-  // Keep proof-bound historical bytes unchanged; a mutation invalidates this association.
-  legacyPlans.set(parsed as object, JSON.stringify(parsed));
-  return parsed as ImplementPlan;
-}