@danmoisan/drm-copilot-mcp 1.1.18 → 1.1.20

package/out/mcp-server.js

@@ -14078,6 +14078,9 @@ var Protocol = class {
       this.setRequestHandler(GetTaskPayloadRequestSchema, async (request, extra) => {
         const handleTaskResult = async () => {
           const taskId = request.params.taskId;
+          if (!await this._taskStore.getTask(taskId, extra.sessionId)) {
+            throw new McpError(ErrorCode.InvalidParams, `Task not found: ${taskId}`);
+          }
           if (this._taskMessageQueue) {
             let queuedMessage;
             while (queuedMessage = await this._taskMessageQueue.dequeue(taskId, extra.sessionId)) {
@@ -14108,12 +14111,12 @@ var Protocol = class {
             throw new McpError(ErrorCode.InvalidParams, `Task not found: ${taskId}`);
           }
           if (!isTerminal(task.status)) {
-            await this._waitForTaskUpdate(taskId, extra.signal);
+            await this._waitForTaskUpdate(taskId, extra.signal, extra.sessionId);
             return await handleTaskResult();
           }
           if (isTerminal(task.status)) {
             const result = await this._taskStore.getTaskResult(taskId, extra.sessionId);
-            this._clearTaskQueue(taskId);
+            this._clearTaskQueue(taskId, extra.sessionId);
             return {
               ...result,
               _meta: {
@@ -14150,7 +14153,7 @@ var Protocol = class {
             throw new McpError(ErrorCode.InvalidParams, `Cannot cancel task in terminal status: ${task.status}`);
           }
           await this._taskStore.updateTaskStatus(request.params.taskId, "cancelled", "Client cancelled task execution.", extra.sessionId);
-          this._clearTaskQueue(request.params.taskId);
+          this._clearTaskQueue(request.params.taskId, extra.sessionId);
           const cancelledTask = await this._taskStore.getTask(request.params.taskId, extra.sessionId);
           if (!cancelledTask) {
             throw new McpError(ErrorCode.InvalidParams, `Task not found after cancellation: ${request.params.taskId}`);
@@ -14278,6 +14281,19 @@ var Protocol = class {
     const handler = this._requestHandlers.get(request.method) ?? this.fallbackRequestHandler;
     const capturedTransport = this._transport;
     const relatedTaskId = request.params?._meta?.[RELATED_TASK_META_KEY]?.taskId;
+    const sessionId = capturedTransport?.sessionId;
+    const store = this._taskStore;
+    let relatedTaskFound = true;
+    let relatedTaskLookup;
+    if (relatedTaskId && store && this._taskMessageQueue && sessionId !== void 0) {
+      relatedTaskFound = false;
+      relatedTaskLookup = (async () => {
+        if (!await store.getTask(relatedTaskId, sessionId)) {
+          throw new McpError(ErrorCode.InvalidParams, `Task not found: ${relatedTaskId}`);
+        }
+        relatedTaskFound = true;
+      })();
+    }
     if (handler === void 0) {
       const errorResponse = {
         jsonrpc: "2.0",
@@ -14287,7 +14303,10 @@ var Protocol = class {
           message: "Method not found"
         }
       };
-      if (relatedTaskId && this._taskMessageQueue) {
+      if (relatedTaskId && relatedTaskLookup) {
+        const queuedError = { type: "error", message: errorResponse, timestamp: Date.now() };
+        relatedTaskLookup.then(() => this._enqueueTaskMessage(relatedTaskId, queuedError, sessionId), () => capturedTransport?.send(errorResponse)).catch((error2) => this._onerror(new Error(`Failed to send an error response: ${error2}`)));
+      } else if (relatedTaskId && this._taskMessageQueue) {
         this._enqueueTaskMessage(relatedTaskId, {
           type: "error",
           message: errorResponse,
@@ -14338,7 +14357,10 @@ var Protocol = class {
       closeSSEStream: extra?.closeSSEStream,
       closeStandaloneSSEStream: extra?.closeStandaloneSSEStream
     };
-    Promise.resolve().then(() => {
+    (relatedTaskLookup ?? Promise.resolve()).then(() => {
+      if (relatedTaskLookup && abortController.signal.aborted) {
+        throw new McpError(ErrorCode.ConnectionClosed, "Request was cancelled");
+      }
       if (taskCreationParams) {
         this.assertTaskHandlerCapability(request.method);
       }
@@ -14373,7 +14395,7 @@ var Protocol = class {
           ...error2["data"] !== void 0 && { data: error2["data"] }
         }
       };
-      if (relatedTaskId && this._taskMessageQueue) {
+      if (relatedTaskId && this._taskMessageQueue && relatedTaskFound) {
         await this._enqueueTaskMessage(relatedTaskId, {
           type: "error",
           message: errorResponse,
@@ -14853,7 +14875,7 @@ var Protocol = class {
       throw new Error("Cannot enqueue task message: taskStore and taskMessageQueue are not configured");
     }
     const maxQueueSize = this._options?.maxTaskQueueSize;
-    await this._taskMessageQueue.enqueue(taskId, message, sessionId, maxQueueSize);
+    await this._taskMessageQueue.enqueue(taskId, message, sessionId ?? this._transport?.sessionId, maxQueueSize);
   }
   /**
    * Clears the message queue for a task and rejects any pending request resolvers.
@@ -14882,12 +14904,13 @@ var Protocol = class {
    * Uses polling to check for updates at the task's configured poll interval.
    * @param taskId The task ID to wait for
    * @param signal Abort signal to cancel the wait
+   * @param sessionId Session of the request that waits, passed to the task store
    * @returns Promise that resolves when an update occurs or rejects if aborted
    */
-  async _waitForTaskUpdate(taskId, signal) {
+  async _waitForTaskUpdate(taskId, signal, sessionId) {
     let interval = this._options?.defaultTaskPollInterval ?? 1e3;
     try {
-      const task = await this._taskStore?.getTask(taskId);
+      const task = await this._taskStore?.getTask(taskId, sessionId);
       if (task?.pollInterval) {
         interval = task.pollInterval;
       }
@@ -17831,7 +17854,8 @@ function toAuthorityMcpResult(tool, workspaceRoot, result) {
     primary_failure_code: result.primaryFailureCode,
     affected_paths: result.affectedPaths,
     unsupported_capabilities: result.unsupportedCapabilities,
-    resolution: result.resolution
+    resolution: result.resolution,
+    ...result.failureCause === void 0 ? {} : { failure_cause: result.failureCause }
   };
 }
 function toTransitionMcpResult(workspaceRoot, result) {
@@ -17850,7 +17874,8 @@ function toTransitionMcpResult(workspaceRoot, result) {
     destination_checkpoint_sha256: result.destinationCheckpointSha256,
     primary_failure_code: result.primaryFailureCode,
     affected_paths: result.affectedPaths,
-    unsupported_capabilities: result.unsupportedCapabilities
+    unsupported_capabilities: result.unsupportedCapabilities,
+    ...result.failureCause === void 0 ? {} : { failure_cause: result.failureCause }
   };
 }
 async function handlePortableHandoffTool(tool, rawInput, service) {
@@ -18295,6 +18320,33 @@ function buildPoshQcWorkflowArguments(tool, input) {
 // ../../extensions/drm-copilot/src/lib/push-down/filesystem-adapter.ts
 var fs2 = __toESM(require("node:fs"));
 var nodePath2 = __toESM(require("node:path"));
+
+// ../../extensions/drm-copilot/src/lib/string-ordering.ts
+function rankCodeUnit(unit) {
+  if (unit >= 55296 && unit <= 57343) {
+    return unit + 8192;
+  }
+  if (unit >= 57344) {
+    return unit - 2048;
+  }
+  return unit;
+}
+function compareCodePoint(left, right) {
+  const sharedLength = Math.min(left.length, right.length);
+  for (let index = 0; index < sharedLength; index += 1) {
+    const leftUnit = left.charCodeAt(index);
+    const rightUnit = right.charCodeAt(index);
+    if (leftUnit !== rightUnit) {
+      return rankCodeUnit(leftUnit) < rankCodeUnit(rightUnit) ? -1 : 1;
+    }
+  }
+  if (left.length === right.length) {
+    return 0;
+  }
+  return left.length < right.length ? -1 : 1;
+}
+
+// ../../extensions/drm-copilot/src/lib/push-down/filesystem-adapter.ts
 function toPosixPath(value) {
   return value.replace(/\\/g, "/");
 }
@@ -18343,9 +18395,7 @@ var RealPushDownFileSystem = class {
       }
     };
     walk(normalizedRoot);
-    return files.sort(
-      (left, right) => left < right ? -1 : left > right ? 1 : 0
-    );
+    return files.sort(compareCodePoint);
   }
   /**
    * @param path Path to inspect.
@@ -18555,7 +18605,7 @@ function enumerateSourceFiles(fs12, sourceRoot, rootFolders) {
     const sorted = [...rootFiles].sort((left, right) => {
       const leftRel = relativeToPosix(left, rootPath) ?? left;
       const rightRel = relativeToPosix(right, rootPath) ?? right;
-      return leftRel < rightRel ? -1 : leftRel > rightRel ? 1 : 0;
+      return compareCodePoint(leftRel, rightRel);
     });
     orderedFiles.push(...sorted);
   }
@@ -18613,7 +18663,7 @@ function stringifySorted(value, indent) {
     }
     if (input !== null && typeof input === "object") {
       const entries = Object.entries(input).sort(
-        ([leftKey], [rightKey]) => leftKey < rightKey ? -1 : leftKey > rightKey ? 1 : 0
+        ([leftKey], [rightKey]) => compareCodePoint(leftKey, rightKey)
       );
       const result = {};
       for (const [key, val] of entries) {
@@ -18667,11 +18717,11 @@ function pushDownCustomizations(options) {
     effectiveSource,
     effectiveRoots
   )) {
-    const relativePath2 = relativeToPosix(sourcePath, effectiveSource);
-    if (relativePath2 === null) {
+    const relativePath = relativeToPosix(sourcePath, effectiveSource);
+    if (relativePath === null) {
       continue;
     }
-    const destinationPath = joinPosix2(destinationRoot, relativePath2);
+    const destinationPath = joinPosix2(destinationRoot, relativePath);
     const destinationStatus = fs12.isFile(
       destinationPath
     ) ? "overwritten" : "created";
@@ -18696,7 +18746,7 @@ function pushDownCustomizations(options) {
     fs12.ensureDir(destParent);
     fs12.writeTextFile(destinationPath, rewrittenText);
     fileResults.push({
-      relativePath: relativePath2,
+      relativePath,
       destinationStatus,
       rewrittenReferenceCount: rewrittenDelta,
       placeholderRewriteCount: placeholderDelta,
@@ -18787,12 +18837,14 @@ function loadPackManifests(manifestDir, selectedPackNames, fs12) {
     (name) => !MANIFEST_PACK_NAMES.has(name)
   );
   if (unknown2.length > 0) {
-    throw new ManifestError(`Unknown Codex pack name(s): ${unknown2.sort()}`);
+    throw new ManifestError(
+      `Unknown Codex pack name(s): ${unknown2.sort(compareCodePoint)}`
+    );
   }
   const namesToLoad = new Set(selectedPackNames);
   namesToLoad.add(CORE_PACK_NAME);
   const manifests = /* @__PURE__ */ new Map();
-  for (const name of [...namesToLoad].sort()) {
+  for (const name of [...namesToLoad].sort(compareCodePoint)) {
     const manifestPath = joinPosix3(manifestDir, `${name}.json`);
     if (!fs12.isFile(manifestPath)) {
       throw new ManifestError(
@@ -18815,14 +18867,16 @@ function resolveManifestPackNames(selectedPackNames, csharpVariant) {
   );
   if (variantSpecific.length > 0) {
     throw new ManifestError(
-      `Use public Codex pack 'csharp' with csharpVariant instead of variant-specific pack name(s): ${variantSpecific.sort().join(", ")}.`
+      `Use public Codex pack 'csharp' with csharpVariant instead of variant-specific pack name(s): ${variantSpecific.sort(compareCodePoint).join(", ")}.`
     );
   }
   const unknown2 = [...selectedPackNames].filter(
     (name) => !SUPPORTED_PACK_NAMES.has(name)
   );
   if (unknown2.length > 0) {
-    throw new ManifestError(`Unknown Codex pack name(s): ${unknown2.sort()}`);
+    throw new ManifestError(
+      `Unknown Codex pack name(s): ${unknown2.sort(compareCodePoint)}`
+    );
   }
   const manifestNames = new Set(selectedPackNames);
   if (manifestNames.has(PUBLIC_CSHARP_PACK_NAME)) {
@@ -18918,7 +18972,7 @@ function resolveVariantSourcePath(destinationRelativePath, csharpVariant) {
   return destinationRelativePath;
 }
 function assertSingleCsharpToolchain(publishedPaths, selectedPackNames) {
-  const selectedCsharp = [...selectedPackNames].filter((name) => CSHARP_PACK_NAMES.has(name)).sort();
+  const selectedCsharp = [...selectedPackNames].filter((name) => CSHARP_PACK_NAMES.has(name)).sort(compareCodePoint);
   if (selectedCsharp.length > 1) {
     throw new ManifestError(
       `C# mutual exclusion violated: both modern and legacy Codex C# packs were selected (${selectedCsharp.join(", ")}); select exactly one C# variant.`
@@ -19208,7 +19262,7 @@ function loadPackManifests2(manifestDir, selectedPackNames, fs12) {
   const namesToLoad = new Set(selectedPackNames);
   namesToLoad.add(CORE_PACK_NAME2);
   const manifests = /* @__PURE__ */ new Map();
-  for (const name of [...namesToLoad].sort()) {
+  for (const name of [...namesToLoad].sort(compareCodePoint)) {
     const manifestPath = joinPosix5(manifestDir, `${name}.json`);
     if (!fs12.isFile(manifestPath)) {
       throw new ManifestError2(
@@ -19303,7 +19357,7 @@ function resolveVariantSourcePath2(destinationRelativePath, csharpVariant) {
   return destinationRelativePath;
 }
 function assertSingleCsharpToolchain2(publishedPaths, selectedPackNames) {
-  const selectedCsharp = [...selectedPackNames].filter((name) => CSHARP_PACK_NAMES2.has(name)).sort();
+  const selectedCsharp = [...selectedPackNames].filter((name) => CSHARP_PACK_NAMES2.has(name)).sort(compareCodePoint);
   if (selectedCsharp.length > 1) {
     throw new ManifestError2(
       `C# mutual exclusion violated: both modern and legacy C# packs were selected ([${selectedCsharp.map((n) => `'${n}'`).join(", ")}]); select exactly one C# variant.`
@@ -19313,6 +19367,10 @@ function assertSingleCsharpToolchain2(publishedPaths, selectedPackNames) {
 }
 
 // ../../extensions/drm-copilot/src/lib/push-down/claude-filesystem-adapter.ts
+var LOCAL_RUNTIME_RELATIVE_DIRECTORIES = [
+  ".claude/state",
+  ".claude/worktrees"
+];
 function normalizePosix3(value) {
   return value.replace(/\\/g, "/").replace(/\/+$/, "");
 }
@@ -19378,6 +19436,21 @@ var ExcludingFileSystem = class {
   sourceRelativePosix(path16) {
     return relativeToPosix3(path16, this.sourceRoot);
   }
+  /**
+   * Return whether a path is a local runtime directory or lies below one.
+   *
+   * @param path An absolute candidate POSIX path from the inner adapter.
+   * @returns True when the source-relative path is in a runtime directory.
+   */
+  isLocalRuntimePath(path16) {
+    const relative2 = this.sourceRelativePosix(path16);
+    if (relative2 === null) {
+      return false;
+    }
+    return LOCAL_RUNTIME_RELATIVE_DIRECTORIES.some(
+      (directory) => relative2 === directory || relative2.startsWith(`${directory}/`)
+    );
+  }
   /**
    * Return whether a candidate path is in the active published set.
    *
@@ -19403,15 +19476,15 @@ var ExcludingFileSystem = class {
    * @returns True when the file is outside the memory subtree or general-scoped.
    */
   isScopeIncluded(path16) {
-    const relativePath2 = relativeToPosix3(path16, this.repoRoot);
-    if (relativePath2 === null) {
+    const relativePath = relativeToPosix3(path16, this.repoRoot);
+    if (relativePath === null) {
       return true;
     }
-    if (!isUnderAgentMemory(relativePath2)) {
+    if (!isUnderAgentMemory(relativePath)) {
       return true;
     }
     const content = this.readText(path16);
-    return isGeneralMemoryFile(relativePath2, content);
+    return isGeneralMemoryFile(relativePath, content);
   }
   /**
    * Return whether a candidate file passes the memory-mode filter.
@@ -19461,7 +19534,7 @@ var ExcludingFileSystem = class {
   }
   listFiles(root) {
     return this.inner.listFiles(root).filter(
-      (p) => !this.excluded.has(normalizePosix3(p)) && this.isPackIncluded(p) && this.isScopeIncluded(p) && this.isMemoryModeIncluded(p)
+      (p) => !this.isLocalRuntimePath(p) && !this.excluded.has(normalizePosix3(p)) && this.isPackIncluded(p) && this.isScopeIncluded(p) && this.isMemoryModeIncluded(p)
     );
   }
   isDir(path16) {
@@ -19678,9 +19751,6 @@ var EXCLUDED_DIR_NAMES = /* @__PURE__ */ new Set([
   "tests",
   "venv"
 ]);
-function compareOrdinal(left, right) {
-  return left < right ? -1 : left > right ? 1 : 0;
-}
 function isExcludedDirectoryName(name) {
   return name.startsWith(".") || EXCLUDED_DIR_NAMES.has(name);
 }
@@ -19709,7 +19779,7 @@ function classifyProjectDirectories(observations) {
       structureObserved = true;
     }
   }
-  return { modulePaths: modulePaths.sort(compareOrdinal), structureObserved };
+  return { modulePaths: modulePaths.sort(compareCodePoint), structureObserved };
 }
 
 // ../../extensions/drm-copilot/src/lib/push-down/claude-blast-radius-derive-core.ts
@@ -19777,12 +19847,12 @@ function pruneAncestors(paths) {
 function topLevelDirectories(observations) {
   const names = [];
   for (const observation of observations) {
-    const relativePath2 = observation.relativePath;
-    if (relativePath2 !== "" && !relativePath2.includes("/")) {
-      names.push(relativePath2);
+    const relativePath = observation.relativePath;
+    if (relativePath !== "" && !relativePath.includes("/")) {
+      names.push(relativePath);
     }
   }
-  return names.sort(compareOrdinal);
+  return names.sort(compareCodePoint);
 }
 function assembleModules(derivedPaths) {
   const combined = /* @__PURE__ */ new Map();
@@ -19793,7 +19863,7 @@ function assembleModules(derivedPaths) {
     combined.set(name, [...globs]);
   }
   const modules = {};
-  for (const name of [...combined.keys()].sort(compareOrdinal)) {
+  for (const name of [...combined.keys()].sort(compareCodePoint)) {
     const globs = combined.get(name);
     if (globs !== void 0) {
       modules[name] = globs;
@@ -19869,9 +19939,7 @@ var realDirectoryLister = (root) => {
   } catch {
     return [];
   }
-  return entries.map((entry) => ({ name: entry.name, isDir: entry.isDirectory() })).sort(
-    (left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0
-  );
+  return entries.map((entry) => ({ name: entry.name, isDir: entry.isDirectory() })).sort((left, right) => compareCodePoint(left.name, right.name));
 };
 function listTolerantly(lister, path16) {
   try {
@@ -20065,7 +20133,7 @@ function composeModules(base, overlay, overlayPath) {
     merged[name] = globs;
   }
   const composed = {};
-  for (const name of Object.keys(merged).sort(compareOrdinal)) {
+  for (const name of Object.keys(merged).sort(compareCodePoint)) {
     const globs = merged[name] ?? [];
     composed[name] = globs;
     for (const glob of Array.isArray(globs) ? globs : []) {
@@ -20393,19 +20461,19 @@ function matchesExclusionEntry(entry, candidate) {
 function planExclusions(payloadRelativePaths, manifest, destinationExists) {
   const kept = [];
   const skipped = [];
-  for (const relativePath2 of payloadRelativePaths) {
+  for (const relativePath of payloadRelativePaths) {
     const entry = manifest.entries.find(
-      (candidate) => matchesExclusionEntry(candidate, relativePath2)
+      (candidate) => matchesExclusionEntry(candidate, relativePath)
     );
     if (entry === void 0) {
-      kept.push(relativePath2);
+      kept.push(relativePath);
       continue;
     }
     skipped.push({
-      relativePath: relativePath2,
+      relativePath,
       entry: entry.normalized,
       line: entry.line,
-      destinationStatus: destinationExists(relativePath2) ? "present" : "absent"
+      destinationStatus: destinationExists(relativePath) ? "present" : "absent"
     });
   }
   const claimed = new Set(
@@ -20416,16 +20484,16 @@ function planExclusions(payloadRelativePaths, manifest, destinationExists) {
   );
   return { kept, skipped, unmatchedEntries };
 }
-function assertManifestPathIsRootLevel(relativePath2, rootFolders) {
-  if (relativePath2.includes("/")) {
+function assertManifestPathIsRootLevel(relativePath, rootFolders) {
+  if (relativePath.includes("/")) {
     throw new Error(
-      `Exclusion manifest path must be root-level: ${relativePath2}`
+      `Exclusion manifest path must be root-level: ${relativePath}`
     );
   }
-  const root = rootFolders.find((name) => relativePath2.startsWith(name));
+  const root = rootFolders.find((name) => relativePath.startsWith(name));
   if (root !== void 0) {
     throw new Error(
-      `Exclusion manifest path must not begin with published root ${root}: ${relativePath2}`
+      `Exclusion manifest path must not begin with published root ${root}: ${relativePath}`
     );
   }
 }
@@ -21020,12 +21088,12 @@ var RealFileSystem = class {
         return;
       }
       for (const entry of entries) {
-        const relativePath2 = relativePrefix === "" ? entry.name : `${relativePrefix}/${entry.name}`;
-        if (matcher.test(relativePath2)) {
-          matches.push(joinPosix8(normalizedRoot, relativePath2));
+        const relativePath = relativePrefix === "" ? entry.name : `${relativePrefix}/${entry.name}`;
+        if (matcher.test(relativePath)) {
+          matches.push(joinPosix8(normalizedRoot, relativePath));
         }
         if (entry.isDirectory()) {
-          walk(nodePath3.join(currentDir, entry.name), relativePath2);
+          walk(nodePath3.join(currentDir, entry.name), relativePath);
         }
       }
     };
@@ -21423,12 +21491,12 @@ function extractTemplateVariables(template) {
 }
 function replaceAllVariables(template, variables) {
   const referenced = extractTemplateVariables(template);
-  const missing = [...referenced].filter((name) => !(name in variables)).sort();
+  const missing = [...referenced].filter((name) => !(name in variables)).sort(compareCodePoint);
   if (missing.length > 0) {
     throw new Error(`Unresolved template variables: ${missing.join(", ")}`);
   }
   let resolved = template;
-  for (const key of [...referenced].sort()) {
+  for (const key of [...referenced].sort(compareCodePoint)) {
     resolved = resolved.split(`\${${key}}`).join(variables[key] ?? "");
   }
   if (extractTemplateVariables(resolved).size > 0) {
@@ -21877,9 +21945,7 @@ function validationFindingToJson(finding) {
 }
 function sourceArtifactToJson(artifact) {
   const sortedFrontmatter = {};
-  for (const key of Object.keys(artifact.frontmatter).sort(
-    (left, right) => left < right ? -1 : left > right ? 1 : 0
-  )) {
+  for (const key of Object.keys(artifact.frontmatter).sort(compareCodePoint)) {
     sortedFrontmatter[key] = artifact.frontmatter[key];
   }
   return {
@@ -22377,9 +22443,7 @@ function normalizeSelectedPaths(sourceRoot, selectedPaths) {
   for (const candidatePath of selectedPaths) {
     normalized.add(normalizeRelativePath(sourceRoot, candidatePath));
   }
-  return [...normalized].sort(
-    (left, right) => left < right ? -1 : left > right ? 1 : 0
-  );
+  return [...normalized].sort(compareCodePoint);
 }
 function collectFilesRecursive(fileSystem, absoluteDir, out) {
   for (const childName of fileSystem.listDirectory(absoluteDir)) {
@@ -22412,9 +22476,7 @@ function iterSupportedArtifacts(fileSystem, sourceRoot, sourceEcosystem) {
       discovered.add(filePath.slice(rootPrefix.length));
     }
   }
-  return [...discovered].sort(
-    (left, right) => left < right ? -1 : left > right ? 1 : 0
-  );
+  return [...discovered].sort(compareCodePoint);
 }
 function discoverSourceArtifacts(fileSystem, sourceRoot, sourceEcosystem, selectedPaths) {
   const allArtifacts = iterSupportedArtifacts(
@@ -22440,9 +22502,7 @@ function discoverSourceArtifacts(fileSystem, sourceRoot, sourceEcosystem, select
       matched.push(artifactPath);
     }
   }
-  return matched.sort(
-    (left, right) => left < right ? -1 : left > right ? 1 : 0
-  );
+  return matched.sort(compareCodePoint);
 }
 function isUnderSelectedDirectory(artifactPath, selectedSet) {
   const segments = artifactPath.split("/");
@@ -22853,7 +22913,7 @@ var BASE_REWRITE_RULES = [
   },
   {
     pattern: /Return the finalized plan for validation-only preflight through `atomic-executor` and preserve the same target file path across revision loops\. Do not claim nested worker delegation from within planner execution\./g,
-    replacement: 'Before reporting completion, explicitly spawn the `atomic-executor` subagent for validation-only preflight. The delegated prompt MUST include the exact directive `DIRECTIVE: PREFLIGHT VALIDATION ONLY`.\n\n- `atomic-executor` MUST return exactly one of:\n  - `PREFLIGHT: ALL CLEAR`\n  - `PREFLIGHT: REVISIONS REQUIRED`\n- Treat executor preflight findings as binding plan defects.\n- If preflight returns `PREFLIGHT: REVISIONS REQUIRED`, revise the same target plan file using the executor\'s precise plan delta and re-run preflight.\n- Reuse the same target plan file for every preflight revision iteration in the same planning cycle.\n- If the required `atomic-executor` handoff cannot be started or completed, stop and report blocked state; do not self-approve the plan.\n- Before reporting completion, the target plan MUST pass the `validate_orchestration_artifacts` MCP tool with `artifact_type: "plan"` and `artifact_path: <plan-path>`.\n\nDo not claim nested worker delegation from within planner execution.',
+    replacement: 'Before reporting completion, explicitly spawn the `atomic-executor` subagent for validation-only preflight. The delegated prompt MUST include the exact directive `DIRECTIVE: PREFLIGHT VALIDATION ONLY`.\n\n- `atomic-executor` MUST return exactly one of:\n  - `PREFLIGHT: ALL CLEAR`\n  - `PREFLIGHT: REVISIONS REQUIRED`\n- Treat executor preflight findings as binding plan defects.\n- If preflight returns `PREFLIGHT: REVISIONS REQUIRED`, revise the same target plan file once using the executor\'s precise plan delta and its full `PREFLIGHT-DEFECT:` list, and run one confirming preflight. Preflight is single-pass: trivial defects are fixed in place by the executor, and a plan returns to the planner at most once; a second substantive result halts with `blocked_reason: "validator_failed"`.\n- Reuse the same target plan file for the single permitted preflight revision in the same planning cycle.\n- If the required `atomic-executor` handoff cannot be started or completed, stop and report blocked state; do not self-approve the plan.\n- Before reporting completion, the target plan MUST pass the `validate_orchestration_artifacts` MCP tool with `artifact_type: "plan"` and `artifact_path: <plan-path>`.\n\nDo not claim nested worker delegation from within planner execution.',
     description: "Expand the Claude atomic-planner preflight shorthand into the strict Codex atomic-executor handoff contract."
   },
   {
@@ -23283,23 +23343,19 @@ function buildPromptTranslationTraces(fileSystem, runOptions, mappingRecord) {
     });
   }
   return [...translationTraces].sort((left, right) => {
-    if (left.sourcePath !== right.sourcePath) {
-      return left.sourcePath < right.sourcePath ? -1 : 1;
-    }
-    if (left.sectionId !== right.sectionId) {
-      return left.sectionId < right.sectionId ? -1 : 1;
+    const bySource = compareCodePoint(left.sourcePath, right.sourcePath);
+    if (bySource !== 0) {
+      return bySource;
     }
-    if (left.targetRole !== right.targetRole) {
-      return left.targetRole < right.targetRole ? -1 : 1;
+    const bySection = compareCodePoint(left.sectionId, right.sectionId);
+    if (bySection !== 0) {
+      return bySection;
     }
-    return 0;
+    return compareCodePoint(left.targetRole, right.targetRole);
   });
 }
 
 // ../../extensions/drm-copilot/src/lib/codex-native-converter/engine-pipeline.ts
-function compareStrings(left, right) {
-  return left < right ? -1 : left > right ? 1 : 0;
-}
 function planMappings(fileSystem, runOptions) {
   const discoveredPaths = discoverSourceArtifacts(
     fileSystem,
@@ -23321,7 +23377,7 @@ function planMappings(fileSystem, runOptions) {
     mappingRecords.push(mappedRecord);
   }
   return [...mappingRecords].sort(
-    (left, right) => compareStrings(left.sourcePath, right.sourcePath)
+    (left, right) => compareCodePoint(left.sourcePath, right.sourcePath)
   );
 }
 function renderGeneratedOutput(fileSystem, runOptions, mappingRecords, plannedEmissions) {
@@ -23348,7 +23404,7 @@ function renderGeneratedOutput(fileSystem, runOptions, mappingRecords, plannedEm
     sectionEmissionsByTarget.set(plannedEmission.targetPath, bucket);
   }
   for (const targetPath of [...mappingRecordsByTarget.keys()].sort(
-    compareStrings
+    compareCodePoint
   )) {
     const recordsForTarget = mappingRecordsByTarget.get(targetPath) ?? [];
     if (recordsForTarget.length === 0) {
@@ -23376,7 +23432,7 @@ function renderGeneratedOutput(fileSystem, runOptions, mappingRecords, plannedEm
     ...new Set(
       plannedEmissions.filter((emission) => emission.targetPath !== null).map((emission) => emission.sourcePath)
     )
-  ].sort(compareStrings);
+  ].sort(compareCodePoint);
   for (const sourcePath of parsedSourcePaths) {
     const sourceArtifact = parseSourceArtifact(
       fileSystem,
@@ -23390,7 +23446,7 @@ function renderGeneratedOutput(fileSystem, runOptions, mappingRecords, plannedEm
     }
   }
   for (const targetPath of [...sectionEmissionsByTarget.keys()].sort(
-    compareStrings
+    compareCodePoint
   )) {
     if (targetPath in generatedOutput) {
       continue;
@@ -23413,15 +23469,15 @@ function buildTranslationTraces(fileSystem, runOptions, mappingRecords) {
     );
   }
   return [...translationTraces].sort((left, right) => {
-    const bySource = compareStrings(left.sourcePath, right.sourcePath);
+    const bySource = compareCodePoint(left.sourcePath, right.sourcePath);
     if (bySource !== 0) {
       return bySource;
     }
-    const bySection = compareStrings(left.sectionId, right.sectionId);
+    const bySection = compareCodePoint(left.sectionId, right.sectionId);
     if (bySection !== 0) {
       return bySection;
     }
-    return compareStrings(left.targetRole, right.targetRole);
+    return compareCodePoint(left.targetRole, right.targetRole);
   });
 }
 function buildPlannedEmissions(translationTraces) {
@@ -23439,7 +23495,9 @@ function buildPlannedEmissions(translationTraces) {
 }
 function writeDestinationOutputs(fileSystem, destinationRoot, generatedOutput) {
   const normalizedRoot = destinationRoot.replace(/\/+$/, "");
-  for (const targetPath of Object.keys(generatedOutput).sort(compareStrings)) {
+  for (const targetPath of Object.keys(generatedOutput).sort(
+    compareCodePoint
+  )) {
     const fullPath = normalizedRoot === "" ? targetPath : `${normalizedRoot}/${targetPath}`;
     fileSystem.writeTextFile(fullPath, generatedOutput[targetPath] ?? "");
   }
@@ -23453,7 +23511,7 @@ function sortKeysDeep(value) {
   if (value !== null && typeof value === "object") {
     const sorted = {};
     for (const key of Object.keys(value).sort(
-      (left, right) => left < right ? -1 : left > right ? 1 : 0
+      compareCodePoint
     )) {
       sorted[key] = sortKeysDeep(value[key]);
     }
@@ -23529,7 +23587,7 @@ function extractTopologyDestinations(renderedText, knownDestinationPaths) {
     if (left[0] !== right[0]) {
       return left[0] - right[0];
     }
-    return left[1] < right[1] ? -1 : left[1] > right[1] ? 1 : 0;
+    return compareCodePoint(left[1], right[1]);
   });
   return destinationsByPosition.map(([, destinationPath]) => destinationPath);
 }
@@ -23541,7 +23599,7 @@ function buildTopologyEdges(fileSystem, runOptions, mappingRecords, translationT
     ...new Set(
       mappingRecords.filter((record3) => record3.targetPath !== null).map((record3) => record3.targetPath)
     )
-  ].sort((left, right) => left < right ? -1 : left > right ? 1 : 0);
+  ].sort(compareCodePoint);
   const topologyEdges = [];
   const translationTraceSourcePaths = new Set(
     translationTraces.map((trace) => trace.sourcePath)
@@ -23587,13 +23645,11 @@ function buildTopologyEdges(fileSystem, runOptions, mappingRecords, translationT
     }
   }
   return [...topologyEdges].sort((left, right) => {
-    if (left.sourcePath !== right.sourcePath) {
-      return left.sourcePath < right.sourcePath ? -1 : 1;
-    }
-    if (left.destinationPath !== right.destinationPath) {
-      return left.destinationPath < right.destinationPath ? -1 : 1;
+    const bySource = compareCodePoint(left.sourcePath, right.sourcePath);
+    if (bySource !== 0) {
+      return bySource;
     }
-    return 0;
+    return compareCodePoint(left.destinationPath, right.destinationPath);
   });
 }
 
@@ -23666,38 +23722,35 @@ function renderDestinationToRepeatedSourceChart(topologyEdges) {
 }
 
 // ../../extensions/drm-copilot/src/lib/codex-native-converter/reporting-render.ts
-function compareStrings2(left, right) {
-  return left < right ? -1 : left > right ? 1 : 0;
-}
 function renderConversionReport(runOptions, mappingRecords, topologyEdges, translationTraces, validationFindings) {
   const blockingCount = validationFindings.filter(
     (finding) => finding.blocking
   ).length;
   const destinationRootText = runOptions.destinationRoot !== null ? toPosixPath2(runOptions.destinationRoot) : "review-only";
   const sortedMappingRecords = [...mappingRecords].sort(
-    (left, right) => compareStrings2(left.sourcePath, right.sourcePath)
+    (left, right) => compareCodePoint(left.sourcePath, right.sourcePath)
   );
   const sortedTopologyEdges = [...topologyEdges].sort((left, right) => {
-    const bySource = compareStrings2(left.sourcePath, right.sourcePath);
+    const bySource = compareCodePoint(left.sourcePath, right.sourcePath);
     if (bySource !== 0) {
       return bySource;
     }
-    return compareStrings2(left.destinationPath, right.destinationPath);
+    return compareCodePoint(left.destinationPath, right.destinationPath);
   });
   const sortedTranslationTraces = [...translationTraces].sort((left, right) => {
-    const bySource = compareStrings2(left.sourcePath, right.sourcePath);
+    const bySource = compareCodePoint(left.sourcePath, right.sourcePath);
     if (bySource !== 0) {
       return bySource;
     }
-    const bySection = compareStrings2(left.sectionId, right.sectionId);
+    const bySection = compareCodePoint(left.sectionId, right.sectionId);
     if (bySection !== 0) {
       return bySection;
     }
-    const byRole = compareStrings2(left.targetRole, right.targetRole);
+    const byRole = compareCodePoint(left.targetRole, right.targetRole);
     if (byRole !== 0) {
       return byRole;
     }
-    return compareStrings2(left.targetPath ?? "", right.targetPath ?? "");
+    return compareCodePoint(left.targetPath ?? "", right.targetPath ?? "");
   });
   const lines = [
     "# Conversion Report",
@@ -23765,18 +23818,18 @@ function renderConversionReport(runOptions, mappingRecords, topologyEdges, trans
     lines.push("- None");
   } else {
     const sortedFindings = [...validationFindings].sort((left, right) => {
-      const byCode = compareStrings2(left.code, right.code);
+      const byCode = compareCodePoint(left.code, right.code);
       if (byCode !== 0) {
         return byCode;
       }
-      const bySource = compareStrings2(
+      const bySource = compareCodePoint(
         left.sourcePath ?? "",
         right.sourcePath ?? ""
       );
       if (bySource !== 0) {
         return bySource;
       }
-      return compareStrings2(left.targetPath ?? "", right.targetPath ?? "");
+      return compareCodePoint(left.targetPath ?? "", right.targetPath ?? "");
     });
     for (const validationFinding of sortedFindings) {
       lines.push(
@@ -23795,7 +23848,7 @@ function sortKeysDeep2(value) {
   if (value !== null && typeof value === "object") {
     const sorted = {};
     for (const key of Object.keys(value).sort(
-      (left, right) => left < right ? -1 : left > right ? 1 : 0
+      compareCodePoint
     )) {
       sorted[key] = sortKeysDeep2(value[key]);
     }
@@ -23837,21 +23890,23 @@ function joinPosix12(root, child) {
 }
 function sortBySourcePath(mappingRecords) {
   return [...mappingRecords].sort(
-    (left, right) => left.sourcePath < right.sourcePath ? -1 : left.sourcePath > right.sourcePath ? 1 : 0
+    (left, right) => compareCodePoint(left.sourcePath, right.sourcePath)
   );
 }
 function sortFindings(validationFindings) {
-  const compare = (left, right) => left < right ? -1 : left > right ? 1 : 0;
   return [...validationFindings].sort((left, right) => {
-    const byCode = compare(left.code, right.code);
+    const byCode = compareCodePoint(left.code, right.code);
     if (byCode !== 0) {
       return byCode;
     }
-    const bySource = compare(left.sourcePath ?? "", right.sourcePath ?? "");
+    const bySource = compareCodePoint(
+      left.sourcePath ?? "",
+      right.sourcePath ?? ""
+    );
     if (bySource !== 0) {
       return bySource;
     }
-    return compare(left.targetPath ?? "", right.targetPath ?? "");
+    return compareCodePoint(left.targetPath ?? "", right.targetPath ?? "");
   });
 }
 function writeConversionReportSet(fileSystem, runOptions, mappingRecords, topologyEdges, translationTraces, validationFindings, generatedOutput) {
@@ -23890,7 +23945,7 @@ function writeConversionReportSet(fileSystem, runOptions, mappingRecords, topolo
     dumpsSortedWithNewline(validationResultsPayload)
   );
   for (const targetPath of Object.keys(generatedOutput).sort(
-    (left, right) => left < right ? -1 : left > right ? 1 : 0
+    compareCodePoint
   )) {
     fileSystem.writeTextFile(
       joinPosix12(proposedTreeRoot, targetPath),
@@ -24056,9 +24111,7 @@ function validateDuplicateTargets(mappingRecords, plannedEmissions) {
       conflictingTargets.add(targetPath);
     }
   }
-  for (const targetPath of [...conflictingTargets].sort(
-    (left, right) => left < right ? -1 : left > right ? 1 : 0
-  )) {
+  for (const targetPath of [...conflictingTargets].sort(compareCodePoint)) {
     for (const plannedEmission of sectionEmissionsByTarget.get(targetPath) ?? []) {
       findings.push(
         buildFinding({
@@ -24101,17 +24154,19 @@ function validateConversionPlan(runOptions, mappingRecords, plannedEmissions, ge
     ...validateDuplicateTargets(mappingRecords, plannedEmissions),
     ...validateGeneratedOutput(generatedOutput)
   ];
-  const compare = (left, right) => left < right ? -1 : left > right ? 1 : 0;
   return [...findings].sort((left, right) => {
-    const byCode = compare(left.code, right.code);
+    const byCode = compareCodePoint(left.code, right.code);
     if (byCode !== 0) {
       return byCode;
     }
-    const bySource = compare(left.sourcePath ?? "", right.sourcePath ?? "");
+    const bySource = compareCodePoint(
+      left.sourcePath ?? "",
+      right.sourcePath ?? ""
+    );
     if (bySource !== 0) {
       return bySource;
     }
-    return compare(left.targetPath ?? "", right.targetPath ?? "");
+    return compareCodePoint(left.targetPath ?? "", right.targetPath ?? "");
   });
 }
 
@@ -24888,13 +24943,13 @@ function validateLaunchBindings(features, context) {
   });
   return errors;
 }
-function validateEpicPlannerChildLaunchBindings(features) {
+function validateEpicPlannerChildLaunchBindings(features, options = {}) {
   return validateLaunchBindings(features, {
     expectedExecutionContext: "epic_preparation_child",
     planner: true,
     requireGeneratedOrchestrator: true,
     skipNotStarted: false,
-    requireLaunchPaths: false
+    requireLaunchPaths: options.requireLaunchPaths === true
   });
 }
 function validateEpicChildLaunchBindings(state, options = {}) {
@@ -25261,7 +25316,7 @@ function validateCodexModelRoutingGate(state) {
       deploymentAgents.add(deployment);
     }
   }
-  for (const agent of [...delegated].sort()) {
+  for (const agent of [...delegated].sort(compareCodePoint)) {
     if (!logicalAgents.has(agent) && !deploymentAgents.has(agent)) {
       errors.push(
         `Checkpoint ${CODEX_MODEL_ROUTING_RECEIPTS_KEY} is missing a receipt for delegated agent: ${agent}.`
@@ -25355,7 +25410,7 @@ function normalizeLanguages(value) {
   const normalized = new Set(
     value.map((language) => language.trim().toLowerCase())
   );
-  return [...normalized].sort();
+  return [...normalized].sort(compareCodePoint);
 }
 function requireInteger(value, fieldName) {
   if (typeof value !== "number" || !Number.isInteger(value)) {
@@ -25691,7 +25746,7 @@ function validateCodexTopologyGate(state, options = {}) {
     allowedNames.add(receipt.logical_agent);
     if ([...delegated].every((agent) => !allowedNames.has(agent))) {
       errors.push(
-        `Checkpoint delegation_receipts is missing the exact resolved topology agent for ${receipt.logical_agent}: ${[...allowedNames].sort().join(", ")}.`
+        `Checkpoint delegation_receipts is missing the exact resolved topology agent for ${receipt.logical_agent}: ${[...allowedNames].sort(compareCodePoint).join(", ")}.`
       );
     }
   }
@@ -25801,7 +25856,7 @@ function validateFeatureFolderUniquenessAndDependencies(features) {
       }
     }
   }
-  for (const folder of [...duplicates].sort()) {
+  for (const folder of [...duplicates].sort(compareCodePoint)) {
     errors.push(
       `Epic checkpoint has duplicate features[].feature_folder: ${folder}`
     );
@@ -26139,6 +26194,53 @@ function validateCommittedFile(git, ref, path16, label) {
   }
   return [];
 }
+function repositoryRelativePath(value, field) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    return {
+      errors: [`${field} must be a non-empty repository-relative path.`]
+    };
+  }
+  if (value.includes("\\")) {
+    return { errors: [`${field} must use forward slashes.`] };
+  }
+  const parts = value.split("/").filter((part) => part.length > 0 && part !== ".");
+  if (value.startsWith("/") || /^[A-Za-z]:/.test(value) || parts.includes("..")) {
+    return { errors: [`${field} must stay within the workspace root.`] };
+  }
+  return { path: parts.length === 0 ? "." : parts.join("/"), errors: [] };
+}
+function derivedPlanPath(feature) {
+  return repositoryRelativePath(feature["plan_path"], "plan_path").path;
+}
+function pairPlansWithFeatures(features, plans) {
+  const entries = [];
+  if (Array.isArray(features)) {
+    features.forEach((item, index) => {
+      if (isRecord(item)) {
+        entries.push([index, item]);
+      }
+    });
+  }
+  const paired = [];
+  let position = 0;
+  for (const plan of plans) {
+    let entry = entries[position];
+    while (entry !== void 0 && derivedPlanPath(entry[1]) !== plan) {
+      position += 1;
+      entry = entries[position];
+    }
+    if (entry === void 0) {
+      return plans.map((fallbackPlan, slot) => [
+        slot,
+        entries[slot]?.[1] ?? {},
+        fallbackPlan
+      ]);
+    }
+    paired.push([entry[0], entry[1], plan]);
+    position += 1;
+  }
+  return paired;
+}
 function validatePlanningGitIntegrity(state, parsed, plans, git) {
   const branch = state["integration_branch"];
   if (typeof branch !== "string" || !git.refExists(branch)) {
@@ -26160,8 +26262,8 @@ function validatePlanningGitIntegrity(state, parsed, plans, git) {
       );
     }
   }
-  const features = Array.isArray(state["features"]) ? state["features"].filter(isRecord) : [];
-  plans.forEach((plan, index) => {
+  const pairs = pairPlansWithFeatures(state["features"], plans);
+  pairs.forEach(([index, feature, plan]) => {
     const derived = git.lastCommit(plan);
     if (derived === void 0) {
       errors.push(
@@ -26176,7 +26278,6 @@ function validatePlanningGitIntegrity(state, parsed, plans, git) {
       return;
     }
     const candidates = [derived];
-    const feature = features[index] ?? {};
     const featureCommit = feature["planning_commit"];
     if (featureCommit !== void 0) {
       if (typeof featureCommit !== "string" || !COMMIT_RE.test(featureCommit)) {
@@ -26234,7 +26335,7 @@ function validatePlanningGitIntegrity(state, parsed, plans, git) {
       }
     }
   });
-  for (const extra of Object.keys(integrity.planHashes).filter((path16) => !plans.includes(path16)).sort()) {
+  for (const extra of Object.keys(integrity.planHashes).filter((path16) => !plans.includes(path16)).sort(compareCodePoint)) {
     errors.push(
       `Optional plan_hashes contains unknown planner path: '${extra}'.`
     );
@@ -26520,7 +26621,7 @@ function validateStatus(feature, index, receipt, receiptPath, status, statusPath
   }
   return errors;
 }
-function validateEpicPlannerLaunchEvidence(state, context) {
+function validateEpicPlannerLaunchEvidence(state, context, options = {}) {
   const features = state["features"];
   if (!Array.isArray(features)) {
     return [];
@@ -26532,6 +26633,9 @@ function validateEpicPlannerLaunchEvidence(state, context) {
     if (!isRecord2(item)) {
       return;
     }
+    if (options.requireLaunchPaths === true && !featureCarriesLaunchPath(item)) {
+      return;
+    }
     const receipt = validateReceipt3(item, index, context);
     errors.push(...receipt.errors);
     const featureStatus = launchPath(
@@ -26578,21 +26682,6 @@ var SLUG_RE = /^[a-z0-9][a-z0-9-]*$/;
 function join9(root, relative2) {
   return `${toPosixPath2(root).replace(/\/+$/, "")}/${relative2.replace(/^\/+/, "")}`;
 }
-function relativePath(value, field) {
-  if (typeof value !== "string" || value.trim().length === 0) {
-    return {
-      errors: [`${field} must be a non-empty repository-relative path.`]
-    };
-  }
-  if (value.includes("\\")) {
-    return { errors: [`${field} must use forward slashes.`] };
-  }
-  const parts = value.split("/");
-  if (value.startsWith("/") || /^[A-Za-z]:/.test(value) || parts.includes("..") || parts.includes(".")) {
-    return { errors: [`${field} must stay within the workspace root.`] };
-  }
-  return { path: parts.join("/"), errors: [] };
-}
 function readRequired(context, relative2, label) {
   const path16 = join9(context.workspaceRoot, relative2);
   if (!context.fileSystem.isFile(path16)) {
@@ -26633,12 +26722,15 @@ function validateArtifactSource(stateText, context) {
 }
 function validateFeatureFiles(feature, index, context) {
   const prefix = `Epic planner checkpoint features[${index}]`;
-  const folderResult = relativePath(
+  const folderResult = repositoryRelativePath(
     feature["feature_folder"],
     `${prefix}.feature_folder`
   );
-  const planResult = relativePath(feature["plan_path"], `${prefix}.plan_path`);
-  const researchResult = relativePath(
+  const planResult = repositoryRelativePath(
+    feature["plan_path"],
+    `${prefix}.plan_path`
+  );
+  const researchResult = repositoryRelativePath(
     feature["research_path"],
     `${prefix}.research_path`
   );
@@ -26683,7 +26775,7 @@ function validateFeatureFiles(feature, index, context) {
   const evidenceValue = feature["preflight_evidence_path"];
   const evidencePaths = [];
   if (evidenceValue !== void 0) {
-    const evidence = relativePath(
+    const evidence = repositoryRelativePath(
       evidenceValue,
       `${prefix}.preflight_evidence_path`
     );
@@ -26764,7 +26856,7 @@ function validateKickoffAgainstState(parsed, state, label) {
   }
   return errors;
 }
-function validateEpicReadinessIntegrity(state, stateText, context) {
+function validateEpicReadinessIntegrity(state, stateText, context, options = {}) {
   const errors = validateArtifactSource(stateText, context);
   const slug = state["epic_feature_folder"];
   if (typeof slug !== "string" || !SLUG_RE.test(slug)) {
@@ -26785,7 +26877,7 @@ function validateEpicReadinessIntegrity(state, stateText, context) {
   }
   const manifest = readRequired(context, manifestPath, "the epic manifest");
   errors.push(...manifest.errors);
-  const ignoredResult = relativePath(
+  const ignoredResult = repositoryRelativePath(
     state["kickoff_prompt_path"],
     "Epic planner checkpoint kickoff_prompt_path"
   );
@@ -26833,7 +26925,7 @@ function validateEpicReadinessIntegrity(state, stateText, context) {
       }
     });
   }
-  errors.push(...validateEpicPlannerLaunchEvidence(state, context));
+  errors.push(...validateEpicPlannerLaunchEvidence(state, context, options));
   if (parsed !== void 0) {
     errors.push(
       ...validatePlanningGitIntegrity(state, parsed, plans, context.git),
@@ -26969,18 +27061,19 @@ function extractFeatures2(value) {
   if (!Array.isArray(value)) {
     return {
       errors: ["Epic planner checkpoint features must be a list."],
-      features: []
+      indexedFeatures: [],
+      entries: []
     };
   }
   const errors = [];
-  const features = [];
+  const indexedFeatures = [];
   value.forEach((item, index) => {
     const prefix = `Epic planner checkpoint features[${index}]`;
     if (!isObject7(item)) {
       errors.push(`${prefix} must be an object.`);
       return;
     }
-    features.push(item);
+    indexedFeatures.push([index, item]);
     const missing = REQUIRED_FEATURE_KEYS.filter((key) => !(key in item));
     if (missing.length > 0) {
       errors.push(`${prefix} missing required keys: ${missing.join(", ")}.`);
@@ -27000,13 +27093,14 @@ function extractFeatures2(value) {
       );
     }
   });
-  return { errors, features };
+  return { errors, indexedFeatures, entries: value };
 }
-function validateDependencyWaves(features) {
+function validateDependencyWaves(indexedFeatures) {
+  const features = indexedFeatures.map(([, feature]) => feature);
   const errors = [];
   const seenFolders = /* @__PURE__ */ new Set();
   const seenIssues = /* @__PURE__ */ new Set();
-  features.forEach((feature, index2) => {
+  indexedFeatures.forEach(([index2, feature]) => {
     const prefix = `Epic planner checkpoint features[${index2}]`;
     const folder = feature["feature_folder"];
     if (typeof folder === "string" && folder.length > 0) {
@@ -27029,7 +27123,7 @@ function validateDependencyWaves(features) {
   });
   const index = buildFeatureReferenceIndex(features);
   const manifest = /* @__PURE__ */ new Map();
-  features.forEach((feature, featureIndex) => {
+  indexedFeatures.forEach(([featureIndex, feature]) => {
     const folder = feature["feature_folder"];
     const dependencies = feature["depends_on"];
     if (typeof folder !== "string" || folder.length === 0 || !Array.isArray(dependencies)) {
@@ -27058,7 +27152,7 @@ function validateDependencyWaves(features) {
     }
     throw error2;
   }
-  features.forEach((feature, index2) => {
+  indexedFeatures.forEach(([index2, feature]) => {
     const folder = feature["feature_folder"];
     if (typeof folder !== "string" || !expectedWaves.has(folder)) {
       return;
@@ -27072,14 +27166,14 @@ function validateDependencyWaves(features) {
   });
   return errors;
 }
-function validateReadyFeatures(features) {
+function validateReadyFeatures(indexedFeatures, keyGated) {
   const errors = [];
-  if (features.length < 2) {
+  if (indexedFeatures.length < 2) {
     errors.push(
       "Execution-ready epic planning requires at least two features."
     );
   }
-  features.forEach((feature, index) => {
+  indexedFeatures.forEach(([index, feature]) => {
     const prefix = `Epic planner checkpoint features[${index}]`;
     const issueNum = feature["issue_num"];
     if (typeof issueNum !== "number" || !Number.isInteger(issueNum) || issueNum <= 0) {
@@ -27101,36 +27195,40 @@ function validateReadyFeatures(features) {
     if (feature["preflight_status"] !== "PREFLIGHT: ALL CLEAR") {
       errors.push(`${prefix}.preflight_status must be 'PREFLIGHT: ALL CLEAR'.`);
     }
-    const receipt = feature["model_routing_receipt"];
-    errors.push(
-      ...validateCodexModelRoutingReceipt(
-        receipt,
-        `${prefix}.model_routing_receipt`
-      )
-    );
-    if (isObject7(receipt) && receipt["logical_agent"] !== "orchestrator") {
+    if (!keyGated || "model_routing_receipt" in feature) {
+      const receipt = feature["model_routing_receipt"];
       errors.push(
-        `${prefix}.model_routing_receipt.logical_agent must be 'orchestrator'.`
+        ...validateCodexModelRoutingReceipt(
+          receipt,
+          `${prefix}.model_routing_receipt`
+        )
       );
-    }
-    if (isObject7(receipt)) {
-      if (receipt["complexity_band"] !== feature["complexity_band"]) {
+      if (isObject7(receipt) && receipt["logical_agent"] !== "orchestrator") {
         errors.push(
-          `${prefix}.model_routing_receipt.complexity_band must match feature complexity_band ${pythonRepr6(feature["complexity_band"])}.`
+          `${prefix}.model_routing_receipt.logical_agent must be 'orchestrator'.`
         );
       }
-      if (receipt["execution_context"] !== "epic_preparation_child") {
-        errors.push(
-          `${prefix}.model_routing_receipt.execution_context must be 'epic_preparation_child'.`
-        );
+      if (isObject7(receipt)) {
+        if (receipt["complexity_band"] !== feature["complexity_band"]) {
+          errors.push(
+            `${prefix}.model_routing_receipt.complexity_band must match feature complexity_band ${pythonRepr6(feature["complexity_band"])}.`
+          );
+        }
+        if (receipt["execution_context"] !== "epic_preparation_child") {
+          errors.push(
+            `${prefix}.model_routing_receipt.execution_context must be 'epic_preparation_child'.`
+          );
+        }
       }
     }
-    errors.push(
-      ...validateChildTopologyReceipt(
-        feature["topology_receipt"],
-        `${prefix}.topology_receipt`
-      )
-    );
+    if (!keyGated || "topology_receipt" in feature) {
+      errors.push(
+        ...validateChildTopologyReceipt(
+          feature["topology_receipt"],
+          `${prefix}.topology_receipt`
+        )
+      );
+    }
   });
   return errors;
 }
@@ -27153,7 +27251,7 @@ function validateEpicPlannerStateText(text2, options = {}) {
   errors.push(...worthiness.errors);
   const featureResult = extractFeatures2(value["features"]);
   errors.push(...featureResult.errors);
-  errors.push(...validateDependencyWaves(featureResult.features));
+  errors.push(...validateDependencyWaves(featureResult.indexedFeatures));
   const maxParallel = value["max_parallel_features"];
   if (typeof maxParallel !== "number" || !Number.isInteger(maxParallel) || maxParallel < 1 || maxParallel > 8) {
     errors.push(
@@ -27166,6 +27264,7 @@ function validateEpicPlannerStateText(text2, options = {}) {
     );
   }
   if (options.requireReadyForExecution === true) {
+    const requireLaunchPaths = options.requireCodexModelRouting !== true && options.requireCodexTopology !== true;
     if (worthiness.verdict !== "epic") {
       errors.push(
         "Execution readiness requires epic_worthiness.verdict 'epic'."
@@ -27176,11 +27275,20 @@ function validateEpicPlannerStateText(text2, options = {}) {
         `Execution-ready planner checkpoint next_step must be '${READY_NEXT_STEP}'.`
       );
     }
-    errors.push(...validateReadyFeatures(featureResult.features));
     errors.push(
-      ...validateEpicPlannerChildLaunchBindings(featureResult.features)
+      ...validateReadyFeatures(
+        featureResult.indexedFeatures,
+        requireLaunchPaths
+      )
+    );
+    errors.push(
+      ...validateEpicPlannerChildLaunchBindings(featureResult.entries, {
+        requireLaunchPaths
+      })
     );
-    errors.push(...validatePlannerTopologyReceipt(value["topology_receipt"]));
+    if (!requireLaunchPaths || "topology_receipt" in value) {
+      errors.push(...validatePlannerTopologyReceipt(value["topology_receipt"]));
+    }
     const expectedKickoff = `artifacts/orchestration/epic-kickoff-${String(
       value["epic_feature_folder"]
     )}.md`;
@@ -27198,7 +27306,8 @@ function validateEpicPlannerStateText(text2, options = {}) {
         ...validateEpicReadinessIntegrity(
           value,
           text2,
-          options.readinessContext
+          options.readinessContext,
+          { requireLaunchPaths }
         )
       );
     }
@@ -27266,6 +27375,10 @@ var PROMOTION_ENTRY_TOOLS = /* @__PURE__ */ new Set([
 ]);
 var POTENTIAL_RECORD_PREFIX = "docs/features/potential/";
 var POTENTIAL_RECORD_SUFFIX = ".md";
+var RECORD_OPTIONAL_ORIGINS = /* @__PURE__ */ new Set([
+  "transferred",
+  "filed_before_orchestration"
+]);
 var ISSUE_NUM_PATTERN = /^[1-9][0-9]*$/;
 var ERROR_NOT_OBJECT = "Checkpoint issue_adoption must be an object when present.";
 var ERROR_ISSUE_NUM_FORMAT = "Checkpoint issue_adoption.issue_num must be a string of decimal digits without a leading zero.";
@@ -27360,7 +27473,10 @@ function waivedToolErrors(waived, options) {
   }
   return errors;
 }
-function potentialRecordErrors(waived, potentialRecord) {
+function potentialRecordErrors(waived, potentialRecord, origin, recordPresent) {
+  if (!recordPresent && typeof origin === "string" && RECORD_OPTIONAL_ORIGINS.has(origin)) {
+    return [];
+  }
   if (typeof potentialRecord === "string" && potentialRecord.startsWith(POTENTIAL_RECORD_PREFIX) && potentialRecord.endsWith(POTENTIAL_RECORD_SUFFIX)) {
     return [];
   }
@@ -27394,7 +27510,14 @@ function resolveIssueAdoption(state, options) {
     return { errors, waivedTools: /* @__PURE__ */ new Set() };
   }
   errors.push(...waivedToolErrors(waived, options));
-  errors.push(...potentialRecordErrors(waived, adoption["potential_record"]));
+  errors.push(
+    ...potentialRecordErrors(
+      waived,
+      adoption["potential_record"],
+      adoption["origin"],
+      Object.prototype.hasOwnProperty.call(adoption, "potential_record")
+    )
+  );
   if (errors.length > 0) {
     return { errors, waivedTools: /* @__PURE__ */ new Set() };
   }
@@ -28121,7 +28244,7 @@ function validateModelRoutingExistence(state) {
       }
     }
   }
-  return [...delegated].filter((agent) => !receiptAgents2.has(agent)).sort().map(
+  return [...delegated].filter((agent) => !receiptAgents2.has(agent)).sort(compareCodePoint).map(
     (agent) => `Checkpoint model_routing_receipts is missing a receipt for delegated agent: ${agent}.`
   );
 }
@@ -28230,7 +28353,7 @@ function validateNamespacedDelegationReceipts(receipts) {
   const errors = [];
   const unsupportedKeys = Object.keys(receipts).filter(
     (key) => key !== AGENT_RECEIPT_NAMESPACE_KEY && key !== PROMOTION_RECEIPT_NAMESPACE_KEY
-  ).sort();
+  ).sort(compareCodePoint);
   for (const key of unsupportedKeys) {
     errors.push(
       `Checkpoint delegation_receipts object contains unsupported key: ${key}`
@@ -28256,7 +28379,7 @@ function validateNamespacedDelegationReceipts(receipts) {
   }
   const unsupportedPromotionKeys = Object.keys(promotionReceipts).filter(
     (key) => !PROMOTION_RECEIPT_KEYS.includes(key)
-  ).sort();
+  ).sort(compareCodePoint);
   for (const key of unsupportedPromotionKeys) {
     errors.push(
       "Checkpoint delegation_receipts.promotion contains unsupported key: " + key
@@ -28726,7 +28849,7 @@ function classifyKind(argv) {
   }
   return "other";
 }
-function splitLines2(text2) {
+function splitPlanLines(text2) {
   if (text2 === "") {
     return [];
   }
@@ -28736,6 +28859,11 @@ function splitLines2(text2) {
   }
   return lines;
 }
+var PLAN_WHITESPACE_CLASS = String.raw`[\t\n\v\f\r \u00a0\u1680\u2000-\u200a\u2028\u2029\u202f\u205f\u3000]`;
+var PLAN_WHITESPACE_RUN_RE = new RegExp(`${PLAN_WHITESPACE_CLASS}+`);
+function normalizePlanWhitespace(value) {
+  return value.split(PLAN_WHITESPACE_RUN_RE).filter((word) => word !== "").join(" ");
+}
 function inlineSpans(line) {
   const spans = [];
   for (const match of line.matchAll(INLINE_SPAN_RE)) {
@@ -28779,7 +28907,7 @@ function extractPlanCommands(text2) {
   let inFence = false;
   let windowLines = [];
   let windowStart = 0;
-  const lines = splitLines2(text2);
+  const lines = splitPlanLines(text2);
   for (let index = 0; index < lines.length; index += 1) {
     const line = lines[index] ?? "";
     const lineNumber = index + 1;
@@ -28829,6 +28957,166 @@ function extractPlanCommands(text2) {
   return commands;
 }
 
+// ../../extensions/drm-copilot/src/lib/validate/plan-gate-document.ts
+var G11_SEVERITY = "blocking";
+var G12_SEVERITY = "blocking";
+var G13_SEVERITY = "blocking";
+var PLAN_TASK_GUIDELINE = 40;
+var PLAN_LINE_GUIDELINE = 400;
+var G11_PROSE_PATTERN = String.raw`\b[Ll]ines?[ \t]+[0-9]+`;
+var G11_PATH_PATTERN = String.raw`[A-Za-z0-9_./-]+\.[A-Za-z][A-Za-z0-9]{0,5}:[0-9]+`;
+var G11_ANCHOR_PATTERN = String.raw`#L[0-9]+`;
+var G12_SHA_PATTERN = String.raw`\b[0-9a-f]{7,40}\b`;
+var G13_TASK_PATTERN = String.raw`^- \[[ xX]\] \[P[0-9]+-T[0-9]+\] `;
+var INLINE_CODE_PATTERN = "`[^`]*`";
+var FENCE_RE2 = /^\s*```/;
+var PROSE_RE = new RegExp(G11_PROSE_PATTERN, "g");
+var PATH_RE = new RegExp(G11_PATH_PATTERN, "g");
+var ANCHOR_RE = new RegExp(G11_ANCHOR_PATTERN, "g");
+var SHA_RE = new RegExp(G12_SHA_PATTERN, "g");
+var TASK_RE = new RegExp(G13_TASK_PATTERN);
+var INLINE_CODE_RE = new RegExp(INLINE_CODE_PATTERN, "g");
+var WHITESPACE_RE = new RegExp(`^${PLAN_WHITESPACE_CLASS}$`);
+var JUSTIFICATION_HEADING_RE = /^##[ \t]+Size Justification[ \t]*$/;
+var SECTION_END_RE = /^#{1,2}(?:[ \t]|$)/;
+var HEADING_RE = /^#{1,6}(?:[ \t]|$)/;
+var DIGITS = "0123456789";
+var HEX_LETTERS = "abcdef";
+var SHA_BEFORE_REJECT = "-_.";
+var SHA_AFTER_REJECT = "-_";
+function unfencedLines(text2) {
+  const result = [];
+  let inFence = false;
+  for (const [index, line] of splitPlanLines(text2).entries()) {
+    if (FENCE_RE2.test(line)) {
+      inFence = !inFence;
+      continue;
+    }
+    if (!inFence) {
+      result.push([index + 1, line]);
+    }
+  }
+  return result;
+}
+function maskInlineCode(line) {
+  return line.replace(INLINE_CODE_RE, (span) => " ".repeat(span.length));
+}
+function isWhitespace(character) {
+  return character !== void 0 && WHITESPACE_RE.test(character);
+}
+function enclosingToken(line, start, end) {
+  let left = start;
+  while (left > 0 && !isWhitespace(line[left - 1])) {
+    left -= 1;
+  }
+  let right = end;
+  while (right < line.length && !isWhitespace(line[right])) {
+    right += 1;
+  }
+  return line.slice(left, right);
+}
+function lineCitations(text2) {
+  const findings = [];
+  for (const [lineNumber, line] of unfencedLines(text2)) {
+    for (const match of maskInlineCode(line).matchAll(PROSE_RE)) {
+      findings.push([lineNumber, match[0]]);
+    }
+    for (const match of line.matchAll(PATH_RE)) {
+      const token = enclosingToken(
+        line,
+        match.index,
+        match.index + match[0].length
+      );
+      if (!token.includes("://")) {
+        findings.push([lineNumber, match[0]]);
+      }
+    }
+    for (const match of line.matchAll(ANCHOR_RE)) {
+      findings.push([lineNumber, match[0]]);
+    }
+  }
+  return findings;
+}
+function isShaCandidate(line, start, end) {
+  const token = line.slice(start, end);
+  if (![...token].some((character) => DIGITS.includes(character))) {
+    return false;
+  }
+  if (![...token].some((character) => HEX_LETTERS.includes(character))) {
+    return false;
+  }
+  const before = start > 0 ? line.charAt(start - 1) : "";
+  if (before !== "" && SHA_BEFORE_REJECT.includes(before)) {
+    return false;
+  }
+  const after = end < line.length ? line.charAt(end) : "";
+  return !(after !== "" && SHA_AFTER_REJECT.includes(after));
+}
+function shaCitations(text2) {
+  const findings = [];
+  for (const [lineNumber, line] of unfencedLines(text2)) {
+    for (const match of line.matchAll(SHA_RE)) {
+      if (isShaCandidate(line, match.index, match.index + match[0].length)) {
+        findings.push([lineNumber, match[0]]);
+      }
+    }
+  }
+  return findings;
+}
+function hasSizeJustification(text2) {
+  let inSection = false;
+  for (const [, line] of unfencedLines(text2)) {
+    if (JUSTIFICATION_HEADING_RE.test(line)) {
+      inSection = true;
+      continue;
+    }
+    if (!inSection) {
+      continue;
+    }
+    if (SECTION_END_RE.test(line)) {
+      inSection = false;
+      continue;
+    }
+    if (normalizePlanWhitespace(line) !== "" && !HEADING_RE.test(line)) {
+      return true;
+    }
+  }
+  return false;
+}
+function planSize(text2) {
+  const tasks = unfencedLines(text2).filter(
+    ([, line]) => TASK_RE.test(line)
+  ).length;
+  return [tasks, splitPlanLines(text2).length];
+}
+function lineCitationMessage(lineNumber, value) {
+  return `Line ${String(lineNumber)}: line-number citation \`${value}\` anchors on a position that moves when main moves; cite the symbol, heading, or test name instead.`;
+}
+function shaCitationMessage(lineNumber, value) {
+  return `Line ${String(lineNumber)}: commit-SHA citation \`${value}\` names a commit that goes stale when main moves; cite the branch, ref name, or merge base derivation instead.`;
+}
+function planSizeMessage(tasks, lines) {
+  return `Line 1: plan size \`${String(tasks)} tasks, ${String(lines)} lines\` exceeds the guideline of ${String(PLAN_TASK_GUIDELINE)} tasks or ${String(PLAN_LINE_GUIDELINE)} lines and carries no \`## Size Justification\` section; split the item or state why the size is necessary.`;
+}
+function channelFor(report, severity) {
+  return severity === "blocking" ? report.blocking : report.warnings;
+}
+function evaluateDocumentGates(report, text2) {
+  const g11 = channelFor(report, G11_SEVERITY);
+  for (const [lineNumber, value] of lineCitations(text2)) {
+    g11.push(lineCitationMessage(lineNumber, value));
+  }
+  const g12 = channelFor(report, G12_SEVERITY);
+  for (const [lineNumber, value] of shaCitations(text2)) {
+    g12.push(shaCitationMessage(lineNumber, value));
+  }
+  const [tasks, lines] = planSize(text2);
+  const overGuideline = tasks > PLAN_TASK_GUIDELINE || lines > PLAN_LINE_GUIDELINE;
+  if (overGuideline && !hasSizeJustification(text2)) {
+    channelFor(report, G13_SEVERITY).push(planSizeMessage(tasks, lines));
+  }
+}
+
 // ../../extensions/drm-copilot/src/lib/validate/plan-gate-rules.ts
 function emptyPlanGateReport() {
   return { blocking: [], warnings: [] };
@@ -28949,7 +29237,7 @@ function planQuotesLiteral(text2, literal2, excludeSpan) {
   return normalizeWhitespace(remainder).includes(needle);
 }
 function windowJoin(lines, size = WINDOW_SIZE) {
-  const dense = lines.filter((line) => line.trim() !== "").map((line) => normalizeWhitespace(line));
+  const dense = lines.map((line) => normalizePlanWhitespace(line)).filter((line) => line !== "");
   const windows = [];
   for (let index = 0; index < dense.length; index += 1) {
     windows.push(dense.slice(index, index + size).join(" "));
@@ -28957,15 +29245,15 @@ function windowJoin(lines, size = WINDOW_SIZE) {
   return windows;
 }
 function hasCrossLinePresence(context, literal2) {
-  const words2 = literal2.split(/\s+/).filter((word) => word !== "");
+  const needle = normalizePlanWhitespace(literal2);
+  const words2 = needle.split(" ");
   if (words2.length < 2) {
     return false;
   }
-  const needle = words2.join(" ");
   const firstWord = words2[0] ?? "";
   for (const path16 of context.git.filesContaining(firstWord)) {
     const lines = context.git.readTrackedText(path16).split(/\r\n|\n|\r/);
-    if (lines.some((line) => normalizeWhitespace(line).includes(needle))) {
+    if (lines.some((line) => normalizePlanWhitespace(line).includes(needle))) {
       continue;
     }
     if (windowJoin(lines).some((window2) => window2.includes(needle))) {
@@ -29211,6 +29499,71 @@ function evaluateObservabilityGates(report, commands, context) {
   }
 }
 
+// ../../extensions/drm-copilot/src/lib/validate/plan-gate-scratch.ts
+var G10_SEVERITY = "blocking";
+var BACKTICK = "`";
+var SCRATCH_DEFINITION_PATTERN = String.raw`(?:^|[^A-Za-z0-9_<>$/.-])${BACKTICK}?SCRATCH${BACKTICK}?(?:\*\*)?[ \t]*(?:means\b|:=|=|:|is (?:the|a|an)\b|resolves to\b|abbreviates\b|denotes\b|refers to\b|stands for\b)`;
+var SCRATCH_NAMESPACE_PATTERN = String.raw`issue-(?:<issue-num>|[0-9]+)`;
+var FENCE_RE3 = /^\s*```/;
+var DEFINITION_RE = new RegExp(SCRATCH_DEFINITION_PATTERN);
+var NAMESPACE_RE = new RegExp(SCRATCH_NAMESPACE_PATTERN);
+var LEADING_WHITESPACE_RE = new RegExp(`^${PLAN_WHITESPACE_CLASS}`);
+function continuesLogicalLine(line) {
+  if (normalizePlanWhitespace(line) === "" || !LEADING_WHITESPACE_RE.test(line)) {
+    return false;
+  }
+  return !FENCE_RE3.test(line);
+}
+function isBareDefinition(logical) {
+  const match = DEFINITION_RE.exec(logical);
+  if (match === null) {
+    return false;
+  }
+  return !NAMESPACE_RE.test(logical.slice(match.index + match[0].length));
+}
+function recordIfBare(findings, pending) {
+  const logical = normalizePlanWhitespace(pending.parts.join(" "));
+  if (isBareDefinition(logical)) {
+    findings.push([pending.start + 1, logical]);
+  }
+}
+function bareScratchDefinitions(text2) {
+  const findings = [];
+  let inFence = false;
+  let pending = null;
+  for (const [index, line] of splitPlanLines(text2).entries()) {
+    if (pending !== null && continuesLogicalLine(line)) {
+      pending.parts.push(line);
+      continue;
+    }
+    if (pending !== null) {
+      recordIfBare(findings, pending);
+      pending = null;
+    }
+    if (FENCE_RE3.test(line)) {
+      inFence = !inFence;
+      continue;
+    }
+    if (inFence || normalizePlanWhitespace(line) === "") {
+      continue;
+    }
+    pending = { start: index, parts: [line] };
+  }
+  if (pending !== null) {
+    recordIfBare(findings, pending);
+  }
+  return findings;
+}
+function scratchFindingMessage(lineNumber, logicalLine) {
+  return `Line ${String(lineNumber)}: SCRATCH definition \`${logicalLine}\` is not namespaced by issue number; define SCRATCH as \`<session scratchpad>/issue-<issue-num>/\`.`;
+}
+function evaluateScratchGate(report, text2, severity = G10_SEVERITY) {
+  const channel = severity === "blocking" ? report.blocking : report.warnings;
+  for (const [lineNumber, logicalLine] of bareScratchDefinitions(text2)) {
+    channel.push(scratchFindingMessage(lineNumber, logicalLine));
+  }
+}
+
 // ../../extensions/drm-copilot/src/lib/validate/plan-gate-discrimination.ts
 var G5_SEVERITY = "warning";
 var CommandRunnerPlanGateRepository = class {
@@ -29310,6 +29663,8 @@ function evaluatePlanGates(text2, context) {
   if (context !== void 0) {
     evaluateLiteralRules(report, text2, commands, context);
   }
+  evaluateScratchGate(report, text2);
+  evaluateDocumentGates(report, text2);
   return report;
 }
 
@@ -30245,45 +30600,149 @@ function validateParallelOrchestratorStateText(text2, options = {}) {
   return errors;
 }
 
-// ../../extensions/drm-copilot/src/lib/validate/parallel-planner-state-core.ts
-var CONTEXT2 = "Parallel planner checkpoint";
-var MIN_CONCURRENCY2 = 1;
-var MAX_CONCURRENCY2 = 32;
-var REQUIRED_KEYS5 = [
-  "objective",
-  "parallel_slug",
-  "parallel_manifest_path",
-  "mode",
-  "max_concurrency",
-  "items",
-  "cohorts",
-  "conflict_edges",
-  "recolor_generation",
-  "completed_steps",
-  "next_step",
-  "last_updated"
-];
-var REQUIRED_ITEM_KEYS = [
-  "issue_num",
-  "feature_folder",
-  "kind",
-  "state",
-  "blast_radius",
-  "preparation_status",
-  "research_path",
-  "plan_path",
-  "preflight_status"
-];
-var VALID_COMPLEXITY_BANDS = [
-  "C1",
-  "C2",
-  "C3",
-  "C4"
+// ../../extensions/drm-copilot/src/lib/validate/parallel-planner-state-routing.ts
+var BAND_ORDER2 = ["C1", "C2", "C3", "C4"];
+var VALID_FABLE_POLICIES = [
+  "disabled",
+  "available",
+  "preferred"
 ];
-var READY_NEXT_STEP2 = "PARALLEL_EXECUTION_READY";
-var READY_PREPARATION_STATUS = "prepared";
-var READY_PREFLIGHT_STATUS = "PREFLIGHT: ALL CLEAR";
-var READY_RADIUS_SOURCE = "declared";
+var ROUTING_AGENT = "orchestrator";
+function sameValue(left, right) {
+  return JSON.stringify(left ?? null) === JSON.stringify(right ?? null);
+}
+function isListOfStrings(value) {
+  return Array.isArray(value) && value.every((entry) => typeof entry === "string");
+}
+function validateAssessmentEntry(assessment, context) {
+  const errors = [];
+  const band = assessment["band"];
+  const floor = assessment["floor"];
+  if (!isEnumMember(BAND_ORDER2, band)) {
+    errors.push(
+      `${context} band must be one of C1, C2, C3, C4; got: ${pythonStr2(band)}.`
+    );
+  }
+  if (!isListOfStrings(assessment["signals_present"])) {
+    errors.push(`${context} signals_present must be a list of strings.`);
+  }
+  if (isEnumMember(BAND_ORDER2, band) && isEnumMember(BAND_ORDER2, floor) && BAND_ORDER2.indexOf(String(band)) < BAND_ORDER2.indexOf(String(floor))) {
+    errors.push(
+      `${context} band ${pythonStr2(band)} is below its floor ${pythonStr2(floor)}.`
+    );
+  }
+  if (!isNonEmptyString2(assessment["rationale"])) {
+    errors.push(`${context} rationale must be a non-empty string.`);
+  }
+  return errors;
+}
+function validateAssessment(assessment, band, entryContext) {
+  const context = `${entryContext} complexity_assessment`;
+  const errors = validateAssessmentEntry(assessment, context);
+  if (!isNonEmptyString2(assessment["assessed_at"])) {
+    errors.push(`${context}.assessed_at must be a non-empty string.`);
+  }
+  const assessedBand = assessment["band"];
+  if (!sameValue(assessedBand, band)) {
+    errors.push(
+      `${context}.band ${pythonRepr10(assessedBand)} does not equal complexity_band ${pythonRepr10(band)}.`
+    );
+  }
+  return errors;
+}
+function validateReceipt4(receipt, band, entryContext) {
+  const context = `${entryContext} model_routing_receipt`;
+  const errors = [];
+  const receiptBand = receipt["complexity_band"];
+  if (!isEnumMember(BAND_ORDER2, receiptBand)) {
+    errors.push(
+      `${context} complexity_band must be one of C1, C2, C3, C4; got: ${pythonStr2(receiptBand)}.`
+    );
+  }
+  const agent = receipt["agent"];
+  if (agent !== ROUTING_AGENT) {
+    errors.push(
+      `${context}.agent must be ${pythonRepr10(ROUTING_AGENT)}; found: ${pythonRepr10(agent)}.`
+    );
+  }
+  if (!sameValue(receiptBand, band)) {
+    errors.push(
+      `${context}.complexity_band ${pythonRepr10(receiptBand)} does not equal complexity_band ${pythonRepr10(band)}.`
+    );
+  }
+  const fablePolicy = receipt["fable_policy"];
+  if (!isEnumMember(VALID_FABLE_POLICIES, fablePolicy)) {
+    errors.push(
+      enumError(
+        entryContext,
+        "model_routing_receipt.fable_policy",
+        VALID_FABLE_POLICIES,
+        fablePolicy
+      )
+    );
+  }
+  return errors;
+}
+function validateReadyItemRouting(record3, entryContext) {
+  const errors = [];
+  const band = record3["complexity_band"];
+  if (!isEnumMember(BAND_ORDER2, band)) {
+    errors.push(enumError(entryContext, "complexity_band", BAND_ORDER2, band));
+  }
+  const assessment = record3["complexity_assessment"];
+  if (isObject15(assessment)) {
+    errors.push(...validateAssessment(assessment, band, entryContext));
+  } else {
+    errors.push(`${entryContext} complexity_assessment must be an object.`);
+  }
+  const receipt = record3["model_routing_receipt"];
+  if (isObject15(receipt)) {
+    errors.push(...validateReceipt4(receipt, band, entryContext));
+  } else {
+    errors.push(`${entryContext} model_routing_receipt must be an object.`);
+  }
+  return errors;
+}
+
+// ../../extensions/drm-copilot/src/lib/validate/parallel-planner-state-core.ts
+var CONTEXT2 = "Parallel planner checkpoint";
+var MIN_CONCURRENCY2 = 1;
+var MAX_CONCURRENCY2 = 32;
+var REQUIRED_KEYS5 = [
+  "objective",
+  "parallel_slug",
+  "parallel_manifest_path",
+  "mode",
+  "max_concurrency",
+  "items",
+  "cohorts",
+  "conflict_edges",
+  "recolor_generation",
+  "completed_steps",
+  "next_step",
+  "last_updated"
+];
+var REQUIRED_ITEM_KEYS = [
+  "issue_num",
+  "feature_folder",
+  "kind",
+  "state",
+  "blast_radius",
+  "preparation_status",
+  "research_path",
+  "plan_path",
+  "preflight_status"
+];
+var VALID_COMPLEXITY_BANDS = [
+  "C1",
+  "C2",
+  "C3",
+  "C4"
+];
+var READY_NEXT_STEP2 = "PARALLEL_EXECUTION_READY";
+var READY_PREPARATION_STATUS = "prepared";
+var READY_PREFLIGHT_STATUS = "PREFLIGHT: ALL CLEAR";
+var READY_RADIUS_SOURCE = "declared";
 var MINIMUM_READY_ITEMS = 2;
 var READY_ITEM_PATH_KEYS = ["research_path", "plan_path"];
 function kickoffPathFor(slug) {
@@ -30422,7 +30881,9 @@ function validateReadyGate(state) {
       );
     }
     for (const { index, record: record3 } of itemRecords(items)) {
-      errors.push(...validateReadyItem(record3, itemContext(CONTEXT2, index)));
+      const entryContext = itemContext(CONTEXT2, index);
+      errors.push(...validateReadyItem(record3, entryContext));
+      errors.push(...validateReadyItemRouting(record3, entryContext));
     }
   }
   const nextStep = state["next_step"];
@@ -31588,6 +32049,8 @@ function dispatchValidatorErrors(input) {
     case "epic-planner-state": {
       const options = {
         ...input.requireReadyForExecution === void 0 ? {} : { requireReadyForExecution: input.requireReadyForExecution },
+        ...input.requireCodexModelRouting === void 0 ? {} : { requireCodexModelRouting: input.requireCodexModelRouting },
+        ...input.requireCodexTopology === void 0 ? {} : { requireCodexTopology: input.requireCodexTopology },
         ...input.fs === void 0 || input.root === void 0 || input.artifactPath === void 0 || input.runner === void 0 ? {} : {
           readinessContext: {
             workspaceRoot: input.root,
@@ -31785,6 +32248,76 @@ function createGitCheckoutContext(runner) {
   return { observe, isHeadRelationshipSatisfied };
 }
 
+// ../../extensions/drm-copilot/src/lib/validate/orchestration-handoff-materializer-request.ts
+var HANDOFF_ERROR_CODE_PATTERN = /^[A-Z][A-Z0-9_]*$/;
+var HANDOFF_ERROR_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function describeHandoffFailureCause(stage, error2) {
+  if (typeof error2 === "object" && error2 !== null && "code" in error2) {
+    const code = error2.code;
+    if (typeof code === "string" && HANDOFF_ERROR_CODE_PATTERN.test(code)) {
+      return `${stage}: ${code}`;
+    }
+  }
+  if (error2 instanceof Error) {
+    return HANDOFF_ERROR_NAME_PATTERN.test(error2.name) ? `${stage}: ${error2.name}` : `${stage}: Error`;
+  }
+  return `${stage}: non-error value`;
+}
+function describeEnvelopeParseFailure(error2) {
+  return {
+    code: error2 instanceof HandoffContractError ? error2.code : "HANDOFF_UNSUPPORTED_VERSION",
+    failureCause: describeHandoffFailureCause("envelope-parse", error2)
+  };
+}
+function toReferenceRequest(request) {
+  return {
+    workspaceRoot: request.workspaceRoot,
+    handoffEnvelopePath: request.handoffEnvelopePath,
+    expectedHandoffEnvelopeSha256: request.expectedHandoffEnvelopeSha256,
+    destinationProvider: request.destinationProvider,
+    expectedRepositoryId: request.expectedRepositoryId,
+    expectedWorkspaceRoot: request.expectedWorkspaceRoot,
+    expectedBranch: request.expectedBranch,
+    expectedSourceHeadSha: request.expectedSourceHeadSha,
+    allowedHeadRelationship: request.allowedHeadRelationship,
+    expectedIssueNumber: request.expectedIssueNumber,
+    expectedFeatureFolder: request.expectedFeatureFolder,
+    expectedWorkMode: request.expectedWorkMode,
+    expectedPlanPath: request.expectedPlanPath,
+    expectedPlanSha256: request.expectedPlanSha256
+  };
+}
+function blockedResult(request, primaryFailureCode, options = {}) {
+  return {
+    status: "blocked",
+    handoffId: options.handoffId ?? null,
+    sourceCheckpointSha256: request.expectedSourceCheckpointSha256,
+    handoffEnvelopeSha256: request.expectedHandoffEnvelopeSha256,
+    handoffHistorySha256: options.handoffHistorySha256 ?? null,
+    requestedTransition: "prepared_to_atomic_execution",
+    destinationCheckpointPath: null,
+    destinationCheckpointSha256: null,
+    primaryFailureCode,
+    affectedPaths: options.affectedPaths ?? [],
+    unsupportedCapabilities: options.unsupportedCapabilities ?? [],
+    ...options.failureCause === void 0 ? {} : { failureCause: options.failureCause }
+  };
+}
+function authorityFailure(request, authority, handoffHistorySha256) {
+  if (authority.status === "validated") return null;
+  return blockedResult(
+    request,
+    authority.primaryFailureCode ?? "HANDOFF_VALIDATOR_UNAVAILABLE",
+    {
+      handoffId: authority.handoffId,
+      handoffHistorySha256,
+      affectedPaths: authority.affectedPaths,
+      unsupportedCapabilities: authority.unsupportedCapabilities,
+      ...authority.failureCause === void 0 ? {} : { failureCause: authority.failureCause }
+    }
+  );
+}
+
 // ../../extensions/drm-copilot/src/lib/validate/orchestration-handoff-path-boundary.ts
 var fs6 = __toESM(require("node:fs"));
 var path11 = __toESM(require("node:path"));
@@ -31813,6 +32346,13 @@ function normalizedRepositorySegments(repositoryPath2) {
 function missingPath(error2) {
   return typeof error2 === "object" && error2 !== null && "code" in error2 && error2.code === "ENOENT";
 }
+function guardedResolution(stage, operation) {
+  try {
+    return { ok: true, value: operation() };
+  } catch (error2) {
+    return { ok: false, cause: describeHandoffFailureCause(stage, error2) };
+  }
+}
 function lexicalCandidate(canonicalWorkspaceRoot, repositoryPath2, caseSensitive) {
   if (!path11.isAbsolute(canonicalWorkspaceRoot)) return null;
   const segments = normalizedRepositorySegments(repositoryPath2);
@@ -31823,14 +32363,13 @@ function lexicalCandidate(canonicalWorkspaceRoot, repositoryPath2, caseSensitive
 function createHandoffPathBoundary(fileSystem, caseSensitive = process.platform !== "win32") {
   const resolveWorkspaceRoot = (workspaceRoot) => {
     if (!path11.isAbsolute(workspaceRoot)) return null;
-    try {
+    const resolution = guardedResolution("workspace-root", () => {
       const canonicalRoot = normalizedAbsolutePath(
         fileSystem.realpath(path11.resolve(workspaceRoot))
       );
       return fileSystem.stat(canonicalRoot).isDirectory() ? canonicalRoot : null;
-    } catch {
-      return null;
-    }
+    });
+    return resolution.ok ? resolution.value : null;
   };
   const resolveExistingTarget = (canonicalWorkspaceRoot, repositoryPath2) => {
     const candidate = lexicalCandidate(
@@ -31839,14 +32378,12 @@ function createHandoffPathBoundary(fileSystem, caseSensitive = process.platform
       caseSensitive
     );
     if (candidate === null) return null;
-    try {
-      const canonicalTarget = normalizedAbsolutePath(
-        fileSystem.realpath(candidate)
-      );
-      return isContained(canonicalWorkspaceRoot, canonicalTarget, caseSensitive) ? canonicalTarget : null;
-    } catch {
-      return null;
-    }
+    const resolution = guardedResolution(
+      "target-path",
+      () => normalizedAbsolutePath(fileSystem.realpath(candidate))
+    );
+    if (!resolution.ok) return null;
+    return isContained(canonicalWorkspaceRoot, resolution.value, caseSensitive) ? resolution.value : null;
   };
   const resolveCreatableTarget = (canonicalWorkspaceRoot, repositoryPath2) => {
     const candidate = lexicalCandidate(
@@ -31949,7 +32486,8 @@ function blocked(request, code, options = {}) {
     primaryFailureCode: code,
     affectedPaths: options.affectedPaths ?? [],
     unsupportedCapabilities: options.unsupportedCapabilities ?? [],
-    resolution: null
+    resolution: null,
+    ...options.failureCause === void 0 ? {} : { failureCause: options.failureCause }
   };
 }
 function readEnvelope(fileSystem, request, pathBoundary, canonicalWorkspaceRoot) {
@@ -31958,13 +32496,17 @@ function readEnvelope(fileSystem, request, pathBoundary, canonicalWorkspaceRoot)
     request.handoffEnvelopePath
   );
   if (envelopePath === null) {
-    return blocked(request, "HANDOFF_PLAN_PATH_INVALID");
+    return blocked(request, "HANDOFF_PLAN_PATH_INVALID", {
+      failureCause: "target-path: unresolved"
+    });
   }
   let envelopeText;
   try {
     envelopeText = fileSystem.readTextFile(envelopePath);
-  } catch {
-    return blocked(request, "HANDOFF_VALIDATOR_UNAVAILABLE");
+  } catch (error2) {
+    return blocked(request, "HANDOFF_VALIDATOR_UNAVAILABLE", {
+      failureCause: describeHandoffFailureCause("envelope-read", error2)
+    });
   }
   if (sha256(envelopeText) !== request.expectedHandoffEnvelopeSha256) {
     return blocked(request, "HANDOFF_SOURCE_HASH_MISMATCH");
@@ -31972,10 +32514,10 @@ function readEnvelope(fileSystem, request, pathBoundary, canonicalWorkspaceRoot)
   try {
     return parseHandoffEnvelopeText(envelopeText);
   } catch (error2) {
-    return blocked(
-      request,
-      error2 instanceof HandoffContractError ? error2.code : "HANDOFF_UNSUPPORTED_VERSION"
-    );
+    const failure = describeEnvelopeParseFailure(error2);
+    return blocked(request, failure.code, {
+      failureCause: failure.failureCause
+    });
   }
 }
 function observedPlanSha256(fileSystem, expectedPlanPath, pathBoundary, canonicalWorkspaceRoot) {
@@ -31983,11 +32525,11 @@ function observedPlanSha256(fileSystem, expectedPlanPath, pathBoundary, canonica
     canonicalWorkspaceRoot,
     expectedPlanPath
   );
-  if (planPath === null) return null;
+  if (planPath === null) return { failureCause: "target-path: unresolved" };
   try {
-    return sha256(fileSystem.readTextFile(planPath));
-  } catch {
-    return null;
+    return { sha256: sha256(fileSystem.readTextFile(planPath)) };
+  } catch (error2) {
+    return { failureCause: describeHandoffFailureCause("plan-read", error2) };
   }
 }
 function canonicalizeObservedPath(value) {
@@ -32047,7 +32589,9 @@ function resolvePortableHandoffAuthority(fileSystem, request, kind, pathBoundary
     request.workspaceRoot
   );
   if (canonicalWorkspaceRoot === null) {
-    return blocked(request, "HANDOFF_PLAN_PATH_INVALID");
+    return blocked(request, "HANDOFF_PLAN_PATH_INVALID", {
+      failureCause: "workspace-root: unresolved"
+    });
   }
   const effectiveCheckoutContext = checkoutContext ?? createGitCheckoutContext(new SubprocessRunner());
   const observation = effectiveCheckoutContext.observe(
@@ -32085,17 +32629,19 @@ function resolvePortableHandoffAuthority(fileSystem, request, kind, pathBoundary
       handoffId: envelope.handoffId
     });
   }
-  const planSha256 = observedPlanSha256(
+  const planObservation = observedPlanSha256(
     fileSystem,
     request.expectedPlanPath,
     effectivePathBoundary,
     canonicalWorkspaceRoot
   );
-  if (planSha256 === null) {
+  if ("failureCause" in planObservation) {
     return blocked(request, "HANDOFF_PLAN_PATH_INVALID", {
-      handoffId: envelope.handoffId
+      handoffId: envelope.handoffId,
+      failureCause: planObservation.failureCause
     });
   }
+  const planSha256 = planObservation.sha256;
   const validation = collectHandoffValidationFailures(envelope, {
     repositoryId: request.expectedRepositoryId,
     workspaceRoot: request.expectedWorkspaceRoot,
@@ -32199,54 +32745,6 @@ function porcelainAffectedPaths(output) {
   return [...paths].sort((left, right) => left.localeCompare(right));
 }
 
-// ../../extensions/drm-copilot/src/lib/validate/orchestration-handoff-materializer-request.ts
-function toReferenceRequest(request) {
-  return {
-    workspaceRoot: request.workspaceRoot,
-    handoffEnvelopePath: request.handoffEnvelopePath,
-    expectedHandoffEnvelopeSha256: request.expectedHandoffEnvelopeSha256,
-    destinationProvider: request.destinationProvider,
-    expectedRepositoryId: request.expectedRepositoryId,
-    expectedWorkspaceRoot: request.expectedWorkspaceRoot,
-    expectedBranch: request.expectedBranch,
-    expectedSourceHeadSha: request.expectedSourceHeadSha,
-    allowedHeadRelationship: request.allowedHeadRelationship,
-    expectedIssueNumber: request.expectedIssueNumber,
-    expectedFeatureFolder: request.expectedFeatureFolder,
-    expectedWorkMode: request.expectedWorkMode,
-    expectedPlanPath: request.expectedPlanPath,
-    expectedPlanSha256: request.expectedPlanSha256
-  };
-}
-function blockedResult(request, primaryFailureCode, options = {}) {
-  return {
-    status: "blocked",
-    handoffId: options.handoffId ?? null,
-    sourceCheckpointSha256: request.expectedSourceCheckpointSha256,
-    handoffEnvelopeSha256: request.expectedHandoffEnvelopeSha256,
-    handoffHistorySha256: options.handoffHistorySha256 ?? null,
-    requestedTransition: "prepared_to_atomic_execution",
-    destinationCheckpointPath: null,
-    destinationCheckpointSha256: null,
-    primaryFailureCode,
-    affectedPaths: options.affectedPaths ?? [],
-    unsupportedCapabilities: options.unsupportedCapabilities ?? []
-  };
-}
-function authorityFailure(request, authority, handoffHistorySha256) {
-  if (authority.status === "validated") return null;
-  return blockedResult(
-    request,
-    authority.primaryFailureCode ?? "HANDOFF_VALIDATOR_UNAVAILABLE",
-    {
-      handoffId: authority.handoffId,
-      handoffHistorySha256,
-      affectedPaths: authority.affectedPaths,
-      unsupportedCapabilities: authority.unsupportedCapabilities
-    }
-  );
-}
-
 // ../../extensions/drm-copilot/src/lib/validate/orchestration-handoff-provider-adapters.ts
 var PROVIDER_ADAPTERS = {
   claude: {
@@ -32412,7 +32910,9 @@ var OrchestrationHandoffMaterializer = class {
       request.workspaceRoot
     );
     if (canonicalWorkspaceRoot === null) {
-      return blockedResult(request, "HANDOFF_PLAN_PATH_INVALID");
+      return blockedResult(request, "HANDOFF_PLAN_PATH_INVALID", {
+        failureCause: "workspace-root: unresolved"
+      });
     }
     const sourcePath = pathBoundary.resolveExistingTarget(
       canonicalWorkspaceRoot,
@@ -32423,15 +32923,19 @@ var OrchestrationHandoffMaterializer = class {
       request.handoffEnvelopePath
     );
     if (sourcePath === null || envelopePath === null) {
-      return blockedResult(request, "HANDOFF_PLAN_PATH_INVALID");
+      return blockedResult(request, "HANDOFF_PLAN_PATH_INVALID", {
+        failureCause: "target-path: unresolved"
+      });
     }
     let sourceBytes;
     let envelopeBytes;
     try {
       sourceBytes = this.dependencies.fileSystem.readFile(sourcePath);
       envelopeBytes = this.dependencies.fileSystem.readFile(envelopePath);
-    } catch {
-      return blockedResult(request, "HANDOFF_VALIDATOR_UNAVAILABLE");
+    } catch (error2) {
+      return blockedResult(request, "HANDOFF_VALIDATOR_UNAVAILABLE", {
+        failureCause: describeHandoffFailureCause("checkpoint-read", error2)
+      });
     }
     if (sha2562(sourceBytes) !== request.expectedSourceCheckpointSha256 || sha2562(envelopeBytes) !== request.expectedHandoffEnvelopeSha256) {
       return blockedResult(request, "HANDOFF_SOURCE_HASH_MISMATCH");
@@ -32439,8 +32943,10 @@ var OrchestrationHandoffMaterializer = class {
     let envelopeText;
     try {
       envelopeText = textDecoder.decode(envelopeBytes);
-    } catch {
-      return blockedResult(request, "HANDOFF_UNSUPPORTED_VERSION");
+    } catch (error2) {
+      return blockedResult(request, "HANDOFF_UNSUPPORTED_VERSION", {
+        failureCause: describeHandoffFailureCause("envelope-decode", error2)
+      });
     }
     const validation = this.dependencies.validator.validateEnvelope(envelopeText);
     if (validation.primaryFailureCode !== null || validation.envelope === null) {
@@ -32449,7 +32955,8 @@ var OrchestrationHandoffMaterializer = class {
         validation.primaryFailureCode ?? "HANDOFF_VALIDATOR_UNAVAILABLE",
         {
           affectedPaths: validation.affectedPaths,
-          unsupportedCapabilities: validation.unsupportedCapabilities
+          unsupportedCapabilities: validation.unsupportedCapabilities,
+          failureCause: validation.failureCause
         }
       );
     }
@@ -32496,7 +33003,8 @@ var OrchestrationHandoffMaterializer = class {
     if (archivePath === null || destinationPath === null || candidatePath === null) {
       return blockedResult(request, "HANDOFF_PLAN_PATH_INVALID", {
         handoffId: envelope.handoffId,
-        handoffHistorySha256: lastHistoryEntry.entrySha256
+        handoffHistorySha256: lastHistoryEntry.entrySha256,
+        failureCause: "target-path: unresolved"
       });
     }
     const referenceRequest = toReferenceRequest(request);
@@ -32529,7 +33037,11 @@ var OrchestrationHandoffMaterializer = class {
         error2 instanceof Error && "code" in error2 ? error2.code : "HANDOFF_VALIDATOR_UNAVAILABLE",
         {
           handoffId: envelope.handoffId,
-          handoffHistorySha256: lastHistoryEntry.entrySha256
+          handoffHistorySha256: lastHistoryEntry.entrySha256,
+          failureCause: describeHandoffFailureCause(
+            "destination-projection",
+            error2
+          )
         }
       );
     }
@@ -32538,7 +33050,8 @@ var OrchestrationHandoffMaterializer = class {
       return blockedResult(request, "HANDOFF_VALIDATOR_UNAVAILABLE", {
         handoffId: envelope.handoffId,
         handoffHistorySha256: lastHistoryEntry.entrySha256,
-        affectedPaths: [envelope.destinationCheckpointPath]
+        affectedPaths: [envelope.destinationCheckpointPath],
+        failureCause: "destination-projection: invalid"
       });
     }
     let porcelainStatus;
@@ -32546,10 +33059,11 @@ var OrchestrationHandoffMaterializer = class {
       porcelainStatus = await this.dependencies.git.readPorcelainStatus(
         canonicalWorkspaceRoot
       );
-    } catch {
+    } catch (error2) {
       return blockedResult(request, "HANDOFF_VALIDATOR_UNAVAILABLE", {
         handoffId: envelope.handoffId,
-        handoffHistorySha256: lastHistoryEntry.entrySha256
+        handoffHistorySha256: lastHistoryEntry.entrySha256,
+        failureCause: describeHandoffFailureCause("git-status", error2)
       });
     }
     const affectedPaths = porcelainAffectedPaths(porcelainStatus);
@@ -32595,24 +33109,30 @@ var OrchestrationHandoffMaterializer = class {
         preparation.sourceBytes,
         { exclusive: true }
       );
-    } catch {
+    } catch (writeError) {
+      const writeCause = describeHandoffFailureCause(
+        "archive-write",
+        writeError
+      );
       let archivedBytes;
       try {
         archivedBytes = this.dependencies.fileSystem.readFile(
           preparation.archivePath
         );
-      } catch {
+      } catch (readError) {
         return blockedResult(request, "HANDOFF_VALIDATOR_UNAVAILABLE", {
           handoffId: preparation.result.handoffId,
           handoffHistorySha256: preparation.result.handoffHistorySha256,
-          affectedPaths: [preparation.archivePath]
+          affectedPaths: [preparation.archivePath],
+          failureCause: `${writeCause}; ${describeHandoffFailureCause("archive-readback", readError)}`
         });
       }
       if (sha2562(archivedBytes) !== expectedSourceSha256) {
         return blockedResult(request, "HANDOFF_SOURCE_HASH_MISMATCH", {
           handoffId: preparation.result.handoffId,
           handoffHistorySha256: preparation.result.handoffHistorySha256,
-          affectedPaths: [preparation.archivePath]
+          affectedPaths: [preparation.archivePath],
+          failureCause: writeCause
         });
       }
     }
@@ -32622,24 +33142,30 @@ var OrchestrationHandoffMaterializer = class {
         preparation.projectionBytes,
         { exclusive: true }
       );
-    } catch {
+    } catch (writeError) {
+      const writeCause = describeHandoffFailureCause(
+        "candidate-write",
+        writeError
+      );
       let existingCandidate;
       try {
         existingCandidate = this.dependencies.fileSystem.readFile(
           preparation.candidatePath
         );
-      } catch {
+      } catch (readError) {
         return blockedResult(request, "HANDOFF_VALIDATOR_UNAVAILABLE", {
           handoffId: preparation.result.handoffId,
           handoffHistorySha256: preparation.result.handoffHistorySha256,
-          affectedPaths: [preparation.candidatePath]
+          affectedPaths: [preparation.candidatePath],
+          failureCause: `${writeCause}; ${describeHandoffFailureCause("candidate-readback", readError)}`
         });
       }
       if (sha2562(existingCandidate) !== sha2562(preparation.projectionBytes)) {
         return blockedResult(request, "HANDOFF_VALIDATOR_UNAVAILABLE", {
           handoffId: preparation.result.handoffId,
           handoffHistorySha256: preparation.result.handoffHistorySha256,
-          affectedPaths: [preparation.candidatePath]
+          affectedPaths: [preparation.candidatePath],
+          failureCause: writeCause
         });
       }
     }
@@ -32649,35 +33175,51 @@ var OrchestrationHandoffMaterializer = class {
       );
       const writtenText = textDecoder.decode(writtenCandidate);
       if (sha2562(writtenCandidate) !== sha2562(preparation.projectionBytes) || this.dependencies.validator.validateDestinationProjection(writtenText).length > 0) {
-        throw new Error("Candidate validation failed.");
+        throw Object.assign(new Error("Candidate validation failed."), {
+          code: "HANDOFF_CANDIDATE_MISMATCH"
+        });
       }
-    } catch {
-      this.discardCandidate(preparation.candidatePath);
-      return blockedResult(request, "HANDOFF_VALIDATOR_UNAVAILABLE", {
-        handoffId: preparation.result.handoffId,
-        handoffHistorySha256: preparation.result.handoffHistorySha256,
-        affectedPaths: [preparation.candidatePath]
-      });
+    } catch (error2) {
+      return this.discardedCandidateResult(
+        request,
+        preparation,
+        describeHandoffFailureCause("candidate-validate", error2)
+      );
     }
     try {
       this.dependencies.fileSystem.replaceFile(
         preparation.candidatePath,
         preparation.destinationPath
       );
-    } catch {
-      this.discardCandidate(preparation.candidatePath);
-      return blockedResult(request, "HANDOFF_VALIDATOR_UNAVAILABLE", {
-        handoffId: preparation.result.handoffId,
-        handoffHistorySha256: preparation.result.handoffHistorySha256,
-        affectedPaths: [preparation.candidatePath]
-      });
+    } catch (error2) {
+      return this.discardedCandidateResult(
+        request,
+        preparation,
+        describeHandoffFailureCause("candidate-replace", error2)
+      );
     }
     return { ...preparation.result, status: "materialized" };
   }
+  /** Discard the candidate and block, appending any cleanup failure cause. */
+  discardedCandidateResult(request, preparation, cause) {
+    const cleanupCause = this.discardCandidate(preparation.candidatePath);
+    return blockedResult(request, "HANDOFF_VALIDATOR_UNAVAILABLE", {
+      handoffId: preparation.result.handoffId,
+      handoffHistorySha256: preparation.result.handoffHistorySha256,
+      affectedPaths: [preparation.candidatePath],
+      failureCause: cleanupCause === null ? cause : `${cause}; ${cleanupCause}`
+    });
+  }
+  /**
+   * Remove the candidate. Returns `null` on success, otherwise the cleanup
+   * cause; the blocked result names the retained candidate for explicit cleanup.
+   */
   discardCandidate(candidatePath) {
     try {
       this.dependencies.fileSystem.removeFile(candidatePath);
-    } catch {
+      return null;
+    } catch (error2) {
+      return describeHandoffFailureCause("candidate-cleanup", error2);
     }
   }
 };
@@ -32695,11 +33237,13 @@ function validateEnvelope(text2) {
       unsupportedCapabilities: []
     };
   } catch (error2) {
+    const failure = describeEnvelopeParseFailure(error2);
     return {
       envelope: null,
-      primaryFailureCode: error2 instanceof HandoffContractError ? error2.code : "HANDOFF_UNSUPPORTED_VERSION",
+      primaryFailureCode: failure.code,
       affectedPaths: [],
-      unsupportedCapabilities: []
+      unsupportedCapabilities: [],
+      failureCause: failure.failureCause
     };
   }
 }
@@ -32707,8 +33251,10 @@ function validateDestinationProjection(text2) {
   let value;
   try {
     value = JSON.parse(text2);
-  } catch {
-    return ["destination checkpoint must be valid JSON"];
+  } catch (error2) {
+    return [
+      `destination checkpoint must be valid JSON (${describeHandoffFailureCause("destination-projection", error2)})`
+    ];
   }
   if (!isRecord4(value)) return ["destination checkpoint must be an object"];
   const provider = value["provider"];
@@ -33024,7 +33570,7 @@ function truncate(text2, limit = 800) {
   }
   return rstrip3(text2.slice(0, limit - 3)) + "...";
 }
-function splitLines3(value) {
+function splitLines2(value) {
   if (value === "") {
     return [];
   }
@@ -33035,7 +33581,7 @@ function splitLines3(value) {
   return lines;
 }
 function truncateLines(text2, limit) {
-  const lines = splitLines3(text2);
+  const lines = splitLines2(text2);
   if (lines.length <= limit) {
     return text2;
   }
@@ -33075,14 +33621,11 @@ function formatList(values, emptyText) {
   }
   return valuesList.map((item) => `- ${item}`).join("\n");
 }
-function compareCodePoint(left, right) {
-  if (left < right) {
-    return -1;
-  }
-  if (left > right) {
-    return 1;
-  }
-  return 0;
+function sortedSet(values) {
+  return [...new Set(values)].sort(compareCodePoint);
+}
+function escapeRegExp4(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
 }
 
 // ../../extensions/drm-copilot/src/lib/pr-context/git-client.ts
@@ -33275,9 +33818,6 @@ function extractClosingNumbers(raw) {
   }
   return numbers;
 }
-function sortedSet(values) {
-  return [...new Set(values)].sort(compareCodePoint);
-}
 function authorLogin(record3, key) {
   const raw = record3[key];
   if (isRecord5(raw)) {
@@ -33933,7 +34473,7 @@ function convertNumstat(numstatText) {
   let adds = 0;
   let dels = 0;
   const files = [];
-  for (const rawLine of splitLines4(numstatText)) {
+  for (const rawLine of splitLines2(numstatText)) {
     if (!rawLine.trim()) {
       continue;
     }
@@ -33996,70 +34536,199 @@ function summarizeConventionalCommits(subjects) {
   }
   counts.set("other", 0);
   const typePattern = /^(feat|fix|refactor|perf|docs|test|chore|build|ci|style)(\(|!|:)/u;
-  for (const rawLine of splitLines4(subjects)) {
+  for (const rawLine of splitLines2(subjects)) {
     const line = rawLine.trim();
     if (!line) {
       continue;
     }
-    const match = typePattern.exec(line);
-    const label = match ? match[1] : "other";
-    counts.set(label, (counts.get(label) ?? 0) + 1);
-  }
-  const nonZero = [...counts.entries()].filter(([, value]) => value > 0);
-  if (nonZero.length === 0) {
-    return "(no recognizable conventional commit types)";
+    const match = typePattern.exec(line);
+    const label = match ? match[1] : "other";
+    counts.set(label, (counts.get(label) ?? 0) + 1);
+  }
+  const nonZero = [...counts.entries()].filter(([, value]) => value > 0);
+  if (nonZero.length === 0) {
+    return "(no recognizable conventional commit types)";
+  }
+  return nonZero.map(([name, value]) => `${padName(name)} : ${value}`).join("\n");
+}
+function extractChangedPaths(contextText) {
+  const paths = [];
+  let capture = false;
+  for (const line of splitLines2(contextText)) {
+    if (line.startsWith("===== Changed files")) {
+      capture = true;
+      continue;
+    }
+    if (capture) {
+      if (line.startsWith("=====")) {
+        break;
+      }
+      if (line.trim() && line.includes("	")) {
+        const partsArr = line.split("	");
+        const pathPart = partsArr[partsArr.length - 1];
+        paths.push(formatDiffPath(pathPart.trim()));
+      } else if (line.trim()) {
+        paths.push(formatDiffPath(line.trim()));
+      }
+    }
+  }
+  return paths;
+}
+function pathSuffix(name) {
+  const segment = name.split(/[/\\]/u).pop() ?? "";
+  const dotIndex = segment.lastIndexOf(".");
+  if (dotIndex <= 0 || dotIndex === segment.length - 1) {
+    return "";
+  }
+  return segment.slice(dotIndex);
+}
+function padCount(count) {
+  return String(count).padStart(8, " ");
+}
+function padName(name) {
+  return name.padEnd(9, " ");
+}
+function isDigits(value) {
+  return value.length > 0 && /^\d+$/u.test(value);
+}
+
+// ../../extensions/drm-copilot/src/lib/pr-context/feature-docs-parsers.ts
+function parseSection(markdown, heading) {
+  const escaped = escapeRegExp4(heading);
+  const pattern = new RegExp(
+    `^##\\s+${escaped}\\s*\\r?\\n([\\s\\S]*?)(?=^##\\s+|$(?![\\s\\S]))`,
+    "m"
+  );
+  const match = pattern.exec(markdown);
+  if (!match) {
+    return "";
+  }
+  return match[1].trim();
+}
+function completedPlanTasks(markdown, limit = 10) {
+  const tasks = [];
+  for (const line of splitLines2(markdown)) {
+    if (/\[x\]/iu.test(line)) {
+      const cleaned = line.replace(/^[-*]\s*\[[xX]\]\s*/u, "").trim();
+      tasks.push(cleaned);
+    }
+    if (tasks.length >= limit) {
+      break;
+    }
+  }
+  return tasks;
+}
+function extractIssueReferences2(text2) {
+  if (!text2) {
+    return [];
+  }
+  const matches = text2.match(new RegExp(ISSUE_REFERENCE_PATTERN, "gu")) ?? [];
+  const seen = /* @__PURE__ */ new Set();
+  const ordered = [];
+  for (const item of matches) {
+    if (!seen.has(item)) {
+      seen.add(item);
+      ordered.push(item);
+    }
+  }
+  return ordered;
+}
+function resolveFeatureDir(fs12, baseDir, feature) {
+  const direct = `${baseDir}/${feature}`;
+  if (fs12.exists(direct)) {
+    return direct;
+  }
+  const pattern = new RegExp(
+    `(?:^|[-_])${escapeRegExp4(feature)}(?:[-_]|$)`,
+    "u"
+  );
+  const strongMatches = [];
+  const weakMatches = [];
+  for (const name of fs12.listDirectory(baseDir)) {
+    const candidate = `${baseDir}/${name}`;
+    if (!fs12.isDirectory(candidate)) {
+      continue;
+    }
+    if (pattern.test(name)) {
+      strongMatches.push(candidate);
+    } else if (name.includes(feature)) {
+      weakMatches.push(candidate);
+    }
+  }
+  if (strongMatches.length > 0) {
+    return strongMatches[0];
+  }
+  if (weakMatches.length > 0) {
+    return weakMatches[0];
+  }
+  return null;
+}
+function readText(fs12, path16) {
+  return fs12.exists(path16) ? fs12.readTextFile(path16) : "";
+}
+function latestGlobPath(fs12, directory, pattern) {
+  const matches = [...fs12.glob(directory, pattern)].sort(compareCodePoint);
+  return matches.length > 0 ? matches[matches.length - 1] : null;
+}
+function verificationText(planText) {
+  for (const heading of ["Verification", "Test Plan"]) {
+    const sectionText = parseSection(planText, heading);
+    if (sectionText) {
+      return sectionText;
+    }
   }
-  return nonZero.map(([name, value]) => `${padName(name)} : ${value}`).join("\n");
+  return "";
 }
-function extractChangedPaths(contextText) {
-  const paths = [];
-  let capture = false;
-  for (const line of splitLines4(contextText)) {
-    if (line.startsWith("===== Changed files")) {
-      capture = true;
-      continue;
-    }
-    if (capture) {
-      if (line.startsWith("=====")) {
-        break;
-      }
-      if (line.trim() && line.includes("	")) {
-        const partsArr = line.split("	");
-        const pathPart = partsArr[partsArr.length - 1];
-        paths.push(formatDiffPath(pathPart.trim()));
-      } else if (line.trim()) {
-        paths.push(formatDiffPath(line.trim()));
+function parsePrimaryIssueFromMetadata(params) {
+  const pattern = /^\s*[-*]?\s*Issue:\s*(#\d+)\s*$/iu;
+  for (const sourceText of [
+    params.specText,
+    params.storyText,
+    params.issueText
+  ]) {
+    for (const line of splitLines2(sourceText)) {
+      const match = pattern.exec(line);
+      if (match) {
+        return match[1];
       }
     }
   }
-  return paths;
+  return null;
 }
-function pathSuffix(name) {
-  const segment = name.split(/[/\\]/u).pop() ?? "";
-  const dotIndex = segment.lastIndexOf(".");
-  if (dotIndex <= 0 || dotIndex === segment.length - 1) {
-    return "";
+function parseReadinessValue(text2) {
+  const normalized = text2.replaceAll("**", "");
+  const match = /^\s*(?:Readiness|Overall feature readiness):\s*(.+?)\s*$/im.exec(
+    normalized
+  );
+  if (!match) {
+    return null;
   }
-  return segment.slice(dotIndex);
-}
-function padCount(count) {
-  return String(count).padStart(8, " ");
-}
-function padName(name) {
-  return name.padEnd(9, " ");
-}
-function isDigits(value) {
-  return value.length > 0 && /^\d+$/u.test(value);
+  const value = match[1].trim().toUpperCase();
+  if (value === "PASS" || value === "NEEDS REVISION" || value === "BLOCKED") {
+    return value;
+  }
+  return null;
 }
-function splitLines4(value) {
-  if (value === "") {
-    return [];
+function resolveReadinessSignal(fs12, featureDir) {
+  const auditFiles = [...fs12.glob(featureDir, "feature-audit.*.md")].sort(
+    compareCodePoint
+  );
+  for (let index = auditFiles.length - 1; index >= 0; index -= 1) {
+    const auditPath = auditFiles[index];
+    const readiness = parseReadinessValue(readText(fs12, auditPath));
+    if (readiness) {
+      return [readiness, auditPath];
+    }
   }
-  const lines = value.split(/\r\n|\r|\n/u);
-  if (lines.length > 0 && lines[lines.length - 1] === "" && /(\r\n|\r|\n)$/u.test(value)) {
-    lines.pop();
+  return [null, null];
+}
+function relativeToPosix8(root, path16) {
+  const normalizedRoot = toPosixPath2(root).replace(/\/+$/u, "");
+  const normalized = toPosixPath2(path16);
+  if (normalized.startsWith(`${normalizedRoot}/`)) {
+    return normalized.slice(normalizedRoot.length + 1);
   }
-  return lines;
+  return normalized.replace(/^\/+/u, "");
 }
 
 // ../../extensions/drm-copilot/src/lib/pr-context/render.ts
@@ -34120,8 +34789,8 @@ function buildPrContext(options) {
     const oneline = git.log("--pretty=format:%h %ad %an %s", revRange);
     const subjects = git.log("--pretty=%s", revRange);
     const authors = git.log("--format=%an <%ae>", revRange);
-    const authorsList = sortedSet2(
-      splitLines5(authors).map((line) => line.trim()).filter((line) => line)
+    const authorsList = sortedSet(
+      splitLines2(authors).map((line) => line.trim()).filter((line) => line)
     );
     const nameStatus = git.diffRange(["--name-status", mergeBase, headSha]);
     const numstat = git.diffRange(["--numstat", mergeBase, headSha]);
@@ -34129,7 +34798,7 @@ function buildPrContext(options) {
     const stat = git.diffRange(["--stat", mergeBase, headSha]);
     const [additions, deletions, files] = convertNumstat(numstat);
     const extSummary = extensionSummary(files);
-    const mergePrs = extractMergePrNumbers(splitLines5(oneline));
+    const mergePrs = extractMergePrNumbers(splitLines2(oneline));
     const issueCandidates = extractIssueReferences(
       oneline + "\n" + subjects
     ).filter((ref) => !mergePrs.includes(ref));
@@ -34149,9 +34818,9 @@ function buildPrContext(options) {
         issues.push(formattedRef);
       }
     }
-    referencedIssues = sortedSet2(issues);
-    referencedPrs = sortedSet2([...prs, ...mergePrs]);
-    let issuesDisplay = sortedSet2([
+    referencedIssues = sortedSet(issues);
+    referencedPrs = sortedSet([...prs, ...mergePrs]);
+    let issuesDisplay = sortedSet([
       ...referencedIssues,
       ...featureIssueList
     ]).join(", ");
@@ -34261,8 +34930,8 @@ Deletions: ${deletions}
     text: combinedText,
     referencedIssues,
     referencedPrs,
-    verifiedClosing: sortedSet2(verifiedClosing),
-    invalidReferences: sortedSet2(invalidReferences),
+    verifiedClosing: sortedSet(verifiedClosing),
+    invalidReferences: sortedSet(invalidReferences),
     baseRef,
     resolvedBase,
     baseSha,
@@ -34276,161 +34945,6 @@ Deletions: ${deletions}
 function errorMessage(exc) {
   return exc instanceof Error ? exc.message : String(exc);
 }
-function sortedSet2(values) {
-  return [...new Set(values)].sort(compareCodePoint);
-}
-function splitLines5(value) {
-  if (value === "") {
-    return [];
-  }
-  const lines = value.split(/\r\n|\r|\n/u);
-  if (lines.length > 0 && lines[lines.length - 1] === "" && /(\r\n|\r|\n)$/u.test(value)) {
-    lines.pop();
-  }
-  return lines;
-}
-
-// ../../extensions/drm-copilot/src/lib/pr-context/feature-docs-parsers.ts
-function parseSection2(markdown, heading) {
-  const escaped = escapeRegExp4(heading);
-  const pattern = new RegExp(
-    `^##\\s+${escaped}\\s*\\r?\\n([\\s\\S]*?)(?=^##\\s+|$(?![\\s\\S]))`,
-    "m"
-  );
-  const match = pattern.exec(markdown);
-  if (!match) {
-    return "";
-  }
-  return match[1].trim();
-}
-function completedPlanTasks2(markdown, limit = 10) {
-  const tasks = [];
-  for (const line of splitLines3(markdown)) {
-    if (/\[x\]/iu.test(line)) {
-      const cleaned = line.replace(/^[-*]\s*\[[xX]\]\s*/u, "").trim();
-      tasks.push(cleaned);
-    }
-    if (tasks.length >= limit) {
-      break;
-    }
-  }
-  return tasks;
-}
-function extractIssueReferences2(text2) {
-  if (!text2) {
-    return [];
-  }
-  const matches = text2.match(new RegExp(ISSUE_REFERENCE_PATTERN, "gu")) ?? [];
-  const seen = /* @__PURE__ */ new Set();
-  const ordered = [];
-  for (const item of matches) {
-    if (!seen.has(item)) {
-      seen.add(item);
-      ordered.push(item);
-    }
-  }
-  return ordered;
-}
-function resolveFeatureDir2(fs12, baseDir, feature) {
-  const direct = `${baseDir}/${feature}`;
-  if (fs12.exists(direct)) {
-    return direct;
-  }
-  const pattern = new RegExp(
-    `(?:^|[-_])${escapeRegExp4(feature)}(?:[-_]|$)`,
-    "u"
-  );
-  const strongMatches = [];
-  const weakMatches = [];
-  for (const name of fs12.listDirectory(baseDir)) {
-    const candidate = `${baseDir}/${name}`;
-    if (!fs12.isDirectory(candidate)) {
-      continue;
-    }
-    if (pattern.test(name)) {
-      strongMatches.push(candidate);
-    } else if (name.includes(feature)) {
-      weakMatches.push(candidate);
-    }
-  }
-  if (strongMatches.length > 0) {
-    return strongMatches[0];
-  }
-  if (weakMatches.length > 0) {
-    return weakMatches[0];
-  }
-  return null;
-}
-function readText(fs12, path16) {
-  return fs12.exists(path16) ? fs12.readTextFile(path16) : "";
-}
-function latestGlobPath(fs12, directory, pattern) {
-  const matches = [...fs12.glob(directory, pattern)].sort(compareCodePoint);
-  return matches.length > 0 ? matches[matches.length - 1] : null;
-}
-function verificationText(planText) {
-  for (const heading of ["Verification", "Test Plan"]) {
-    const sectionText = parseSection2(planText, heading);
-    if (sectionText) {
-      return sectionText;
-    }
-  }
-  return "";
-}
-function parsePrimaryIssueFromMetadata(params) {
-  const pattern = /^\s*[-*]?\s*Issue:\s*(#\d+)\s*$/iu;
-  for (const sourceText of [
-    params.specText,
-    params.storyText,
-    params.issueText
-  ]) {
-    for (const line of splitLines3(sourceText)) {
-      const match = pattern.exec(line);
-      if (match) {
-        return match[1];
-      }
-    }
-  }
-  return null;
-}
-function parseReadinessValue(text2) {
-  const normalized = text2.replaceAll("**", "");
-  const match = /^\s*(?:Readiness|Overall feature readiness):\s*(.+?)\s*$/im.exec(
-    normalized
-  );
-  if (!match) {
-    return null;
-  }
-  const value = match[1].trim().toUpperCase();
-  if (value === "PASS" || value === "NEEDS REVISION" || value === "BLOCKED") {
-    return value;
-  }
-  return null;
-}
-function resolveReadinessSignal(fs12, featureDir) {
-  const auditFiles = [...fs12.glob(featureDir, "feature-audit.*.md")].sort(
-    compareCodePoint
-  );
-  for (let index = auditFiles.length - 1; index >= 0; index -= 1) {
-    const auditPath = auditFiles[index];
-    const readiness = parseReadinessValue(readText(fs12, auditPath));
-    if (readiness) {
-      return [readiness, auditPath];
-    }
-  }
-  return [null, null];
-}
-function relativeToPosix8(root, path16) {
-  const normalizedRoot = toPosixPath2(root).replace(/\/+$/u, "");
-  const normalized = toPosixPath2(path16);
-  if (normalized.startsWith(`${normalizedRoot}/`)) {
-    return normalized.slice(normalizedRoot.length + 1);
-  }
-  return normalized.replace(/^\/+/u, "");
-}
-function escapeRegExp4(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
-}
 
 // ../../extensions/drm-copilot/src/lib/pr-context/verification-evidence.ts
 var REQUIRED_FIELDS = ["Timestamp", "Command", "EXIT_CODE"];
@@ -34453,7 +34967,7 @@ function discoverCanonicalEvidenceFiles(fs12, root, feature) {
   for (const pattern of CANONICAL_GLOBS) {
     for (const candidate of fs12.glob(featureRoot, pattern)) {
       if (fs12.isFile(candidate)) {
-        discovered.add(relativeToPosix9(normalizedRoot, candidate));
+        discovered.add(relativeToPosix8(normalizedRoot, candidate));
       }
     }
   }
@@ -34462,7 +34976,7 @@ function discoverCanonicalEvidenceFiles(fs12, root, feature) {
 function parseVerificationEvidenceMarkdown(params) {
   const { feature, sourceFile, markdown } = params;
   const parsed = /* @__PURE__ */ new Map();
-  for (const rawLine of splitLines6(markdown)) {
+  for (const rawLine of splitLines2(markdown)) {
     const colonIndex = rawLine.indexOf(":");
     if (colonIndex === -1) {
       continue;
@@ -34530,9 +35044,9 @@ function parseVerificationEvidenceMarkdown(params) {
   };
 }
 function parseVerificationEvidenceFile(params) {
-  const { fs: fs12, root, feature, relativePath: relativePath2 } = params;
+  const { fs: fs12, root, feature, relativePath } = params;
   const normalizedRoot = toPosixPath2(root).replace(/\/+$/u, "");
-  const relPosix = toPosixPath2(relativePath2).replace(/^\/+/u, "");
+  const relPosix = toPosixPath2(relativePath).replace(/^\/+/u, "");
   const markdown = fs12.readTextFile(`${normalizedRoot}/${relPosix}`);
   return parseVerificationEvidenceMarkdown({
     feature,
@@ -34546,23 +35060,6 @@ function parseIntegerStrict(value) {
   }
   return Number.parseInt(value, 10);
 }
-function relativeToPosix9(root, absolute) {
-  const normalized = toPosixPath2(absolute);
-  if (normalized.startsWith(`${root}/`)) {
-    return normalized.slice(root.length + 1);
-  }
-  return normalized.replace(/^\/+/u, "");
-}
-function splitLines6(value) {
-  if (value === "") {
-    return [];
-  }
-  const lines = value.split(/\r\n|\r|\n/u);
-  if (lines.length > 0 && lines[lines.length - 1] === "" && /(\r\n|\r|\n)$/u.test(value)) {
-    lines.pop();
-  }
-  return lines;
-}
 
 // ../../extensions/drm-copilot/src/lib/pr-context/feature-docs.ts
 var SPEC_HEADINGS = [
@@ -34593,8 +35090,8 @@ function gatherFeatureExcerpts2(fs12, root, changedFiles) {
   const baseDir = `${normalizedRoot}/docs/features/active`;
   const promotedDir = `${normalizedRoot}/docs/features/potential/promoted`;
   for (const feature of [...features].sort(compareCodePoint)) {
-    const featureDir = resolveFeatureDir2(fs12, baseDir, feature);
-    const promotedFeatureDir = resolveFeatureDir2(fs12, promotedDir, feature);
+    const featureDir = resolveFeatureDir(fs12, baseDir, feature);
+    const promotedFeatureDir = resolveFeatureDir(fs12, promotedDir, feature);
     if (featureDir === null && promotedFeatureDir === null) {
       continue;
     }
@@ -34669,7 +35166,7 @@ function gatherFeatureExcerpts2(fs12, root, changedFiles) {
 function buildSpecParts(specText) {
   const specParts = [];
   for (const heading of SPEC_HEADINGS) {
-    const sectionText = parseSection2(specText, heading);
+    const sectionText = parseSection(specText, heading);
     if (sectionText) {
       specParts.push(`${heading}: ${truncate(sectionText)}`);
     }
@@ -34677,7 +35174,7 @@ function buildSpecParts(specText) {
   return specParts;
 }
 function buildPlanSection(planText) {
-  const planTasks = completedPlanTasks2(planText);
+  const planTasks = completedPlanTasks(planText);
   return planTasks.length > 0 ? planTasks.map((task) => `- ${task}`).join("\n") : "";
 }
 function buildVerificationBlock(planText) {
@@ -34686,7 +35183,7 @@ function buildVerificationBlock(planText) {
 }
 function buildStoryParts(userStoryText, promotedStoryText) {
   const storyParts = [];
-  const storyStatements = parseSection2(userStoryText, "Story Statement");
+  const storyStatements = parseSection(userStoryText, "Story Statement");
   if (storyStatements) {
     const storyLines = storyStatements.split(/\r\n|\r|\n/u).filter((line) => line.trim()).map((line) => line.replace(/^[- ]+|[- ]+$/gu, ""));
     if (storyLines.length > 0) {
@@ -34695,14 +35192,14 @@ function buildStoryParts(userStoryText, promotedStoryText) {
       );
     }
   }
-  const problemSection = parseSection2(userStoryText, "Problem / Why");
+  const problemSection = parseSection(userStoryText, "Problem / Why");
   if (problemSection) {
     storyParts.push("Problem / Why:\n" + truncate(problemSection));
   }
   if (storyParts.length === 0 && promotedStoryText) {
-    let promotedProblem = parseSection2(promotedStoryText, "Problem / Why");
+    let promotedProblem = parseSection(promotedStoryText, "Problem / Why");
     if (!promotedProblem) {
-      promotedProblem = parseSection2(promotedStoryText, "Summary");
+      promotedProblem = parseSection(promotedStoryText, "Summary");
     }
     if (promotedProblem) {
       storyParts.push("Problem / Why:\n" + truncate(promotedProblem));
@@ -34775,7 +35272,7 @@ function extractDigestBullets(body, headings, limit) {
     if (!sectionText) {
       continue;
     }
-    for (const line of splitLines3(sectionText)) {
+    for (const line of splitLines2(sectionText)) {
       if (!line.trim()) {
         continue;
       }
@@ -34916,7 +35413,7 @@ function parseNumstatDetailed(numstatText) {
   let addsTotal = 0;
   let delsTotal = 0;
   const perFile = /* @__PURE__ */ new Map();
-  for (const rawLine of splitLines3(numstatText)) {
+  for (const rawLine of splitLines2(numstatText)) {
     if (!rawLine.trim()) {
       continue;
     }
@@ -34935,7 +35432,7 @@ function parseNumstatDetailed(numstatText) {
 }
 function parseNameStatusMap(nameStatusText) {
   const mapping = /* @__PURE__ */ new Map();
-  for (const rawLine of splitLines3(nameStatusText)) {
+  for (const rawLine of splitLines2(nameStatusText)) {
     if (!rawLine.trim()) {
       continue;
     }
@@ -34983,7 +35480,7 @@ function scopingDocChanges(options) {
       path16
     ]);
     let headingTouched = false;
-    for (const line of splitLines3(diffText)) {
+    for (const line of splitLines2(diffText)) {
       if (!line.startsWith("+") || line.startsWith("+++")) {
         continue;
       }
@@ -34999,7 +35496,7 @@ function scopingDocChanges(options) {
       material = true;
       reasons.push("key section touched");
     }
-    const addedLines = splitLines3(diffText).filter((line) => line.startsWith("+") && !line.startsWith("+++")).map((line) => line.replace(/^\++/u, "").trim());
+    const addedLines = splitLines2(diffText).filter((line) => line.startsWith("+") && !line.startsWith("+++")).map((line) => line.replace(/^\++/u, "").trim());
     if (addedLines.length > 0 && addedLines.every(
       (line) => !line || line.startsWith("[") || line.startsWith("http")
     )) {
@@ -35149,10 +35646,10 @@ function collectPrContext(options) {
   });
   const changedPaths = extractChangedPaths(contextResult.text);
   const featureDocs = gatherFeatureExcerpts2(fs12, resolvedRoot, changedPaths);
-  const additionalContextFiles = sortedSet3(
+  const additionalContextFiles = sortedSet(
     featureDocs.flatMap((doc) => doc.contextFiles).filter((path16) => path16)
   );
-  const featureIssueRefs = sortedSet3(
+  const featureIssueRefs = sortedSet(
     featureDocs.flatMap((doc) => doc.issueRefs).filter((ref) => ref.trim())
   );
   if (featureIssueRefs.length > 0) {
@@ -35210,7 +35707,7 @@ function collectPrContext(options) {
       pendingPrimary.push(featureDoc.primaryIssueRef);
     }
   }
-  const readinessSignals = sortedSet3(
+  const readinessSignals = sortedSet(
     featureDocs.map((doc) => doc.readinessSignal).filter((signal) => Boolean(signal))
   );
   const selection = selectPendingPrimary({ gh, ghAvailable, pendingPrimary });
@@ -35221,7 +35718,7 @@ function collectPrContext(options) {
     ghAvailable,
     pendingPrimaryExcluded: selection.excluded
   });
-  const issuesToFetch = sortedSet3([
+  const issuesToFetch = sortedSet([
     ...verified,
     ...referencedIssues,
     ...selection.kept
@@ -35309,7 +35806,7 @@ function collectPrContext(options) {
     verified,
     verifiedReason,
     authorReason,
-    authorAsserted: sortedSet3(authorAsserted),
+    authorAsserted: sortedSet(authorAsserted),
     issuesToAutocloseSection,
     issueDetails,
     prDetailsList,
@@ -35330,9 +35827,6 @@ function collectPrContext(options) {
 function errorMessage2(exc) {
   return exc instanceof Error ? exc.message : String(exc);
 }
-function sortedSet3(values) {
-  return [...new Set(values)].sort(compareCodePoint);
-}
 
 // ../../extensions/drm-copilot/src/lib/pr-context/collector-output.ts
 function renderVerificationEvidenceSection(fs12, resolvedRoot, featureDocs) {
@@ -35365,7 +35859,7 @@ function renderVerificationEvidenceSection(fs12, resolvedRoot, featureDocs) {
   }
   const lines = [];
   const sorted = [...parseableRecords].sort(
-    (left, right) => left.sourceFile < right.sourceFile ? -1 : left.sourceFile > right.sourceFile ? 1 : 0
+    (left, right) => compareCodePoint(left.sourceFile, right.sourceFile)
   );
   for (const record3 of sorted) {
     const expected = record3.expectedExitCode;
@@ -35898,7 +36392,7 @@ function getSection(content, heading) {
   }
   return match[1].trim();
 }
-function buildBody(workMode, problem, behavior, criteria, constraints, tests, relativePath2) {
+function buildBody(workMode, problem, behavior, criteria, constraints, tests, relativePath) {
   return `- Work Mode: ${workMode}
 ## Problem / Why
 ${problem}
@@ -35916,20 +36410,20 @@ ${constraints}
 ${tests}
 
 ## Source
-From: ${relativePath2}
+From: ${relativePath}
 `;
 }
-function buildBugBody(workMode, sections, relativePath2) {
+function buildBugBody(workMode, sections, relativePath) {
   const parts = [`- Work Mode: ${workMode}`];
   for (const heading of BUG_SECTION_HEADINGS) {
     parts.push(`## ${heading}
 ${sections[heading] ?? ""}`);
   }
   parts.push(`## Source
-From: ${relativePath2}`);
+From: ${relativePath}`);
   return parts.join("\n\n") + "\n";
 }
-function buildMinorAuditBody(workMode, problem, implementationIntent, acceptanceCriteria, dependenciesRisks, verificationSteps, evidenceChecklist, relativePath2) {
+function buildMinorAuditBody(workMode, problem, implementationIntent, acceptanceCriteria, dependenciesRisks, verificationSteps, evidenceChecklist, relativePath) {
   return `- Work Mode: ${workMode}
 ## Problem / Why
 ${problem}
@@ -35950,7 +36444,7 @@ ${verificationSteps}
 ${evidenceChecklist}
 
 ## Source
-From: ${relativePath2}
+From: ${relativePath}
 `;
 }
 function parseIssueReference(output) {
@@ -36115,13 +36609,13 @@ function posixBasename(pathStr) {
   const lastSlash = normalized.lastIndexOf("/");
   return lastSlash === -1 ? normalized : normalized.slice(lastSlash + 1);
 }
-function buildIssueBody(content, selectedMode, promotionType, relativePath2) {
+function buildIssueBody(content, selectedMode, promotionType, relativePath) {
   if (promotionType === "bug") {
     const bugSections = {};
     for (const heading of BUG_SECTION_HEADINGS) {
       bugSections[heading] = getSection(content, heading) || PLACEHOLDER;
     }
-    return buildBugBody(selectedMode, bugSections, relativePath2);
+    return buildBugBody(selectedMode, bugSections, relativePath);
   }
   if (selectedMode === "minor-audit") {
     const problem2 = getSection(content, "Problem / Why") || PLACEHOLDER;
@@ -36141,7 +36635,7 @@ function buildIssueBody(content, selectedMode, promotionType, relativePath2) {
       dependenciesRisks,
       verificationSteps,
       evidenceChecklist,
-      relativePath2
+      relativePath
     );
   }
   const problem = getSection(content, "Problem / Why") || PLACEHOLDER;
@@ -36156,7 +36650,7 @@ function buildIssueBody(content, selectedMode, promotionType, relativePath2) {
     criteria,
     constraints,
     tests,
-    relativePath2
+    relativePath
   );
 }
 function promotePotential(options) {
@@ -36191,7 +36685,7 @@ function promotePotential(options) {
   const featurePath = getFeaturePath(featureName);
   const prefix = TITLE_PREFIXES[promotionType] ?? "Feature";
   const issueTitle = normalizeSmartPunctuation(`${prefix}: ${featureName}`);
-  const relativePath2 = computeRelativePath(resolved, workspacePath);
+  const relativePath = computeRelativePath(resolved, workspacePath);
   let selectedMode;
   try {
     selectedMode = normalizeRequestedWorkMode(workMode, promotionType);
@@ -36200,7 +36694,7 @@ function promotePotential(options) {
     throw new PromotionError(message);
   }
   const fallbackReason = "";
-  let body = buildIssueBody(content, selectedMode, promotionType, relativePath2);
+  let body = buildIssueBody(content, selectedMode, promotionType, relativePath);
   body = normalizeSmartPunctuation(body);
   const messages = [];
   const emitLine = (message) => {
@@ -36582,12 +37076,12 @@ function validateFeatureName2(featureName) {
 function escapeRegExp6(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function splitLines7(text2) {
+function splitLines3(text2) {
   return text2.split(/\r\n|\r|\n/);
 }
 function formatChecklist(text2) {
   const lines = [];
-  for (const rawLine of splitLines7(text2)) {
+  for (const rawLine of splitLines3(text2)) {
     const trimmed = rawLine.trim();
     if (!trimmed) {
       continue;
@@ -36616,7 +37110,7 @@ function getSection2(content, name) {
 function upsertWorkModeMarker(content, mode) {
   const markerLine = `- Work Mode: ${mode}`;
   const markerPattern = /^- Work Mode:\s*(minor-audit|full-feature|full-bug|full)\s*$/;
-  const lines = splitLines7(content).filter((line) => !markerPattern.test(line));
+  const lines = splitLines3(content).filter((line) => !markerPattern.test(line));
   for (let idx = 0; idx < lines.length; idx += 1) {
     const line = lines[idx] ?? "";
     if (line.replace(/^\s+/, "").startsWith("## ")) {
@@ -37609,13 +38103,7 @@ function findParentKey(toolUseId, transcriptsByKey) {
   return void 0;
 }
 function compareByAgentId(a, b) {
-  if (a.meta.agentId < b.meta.agentId) {
-    return -1;
-  }
-  if (a.meta.agentId > b.meta.agentId) {
-    return 1;
-  }
-  return 0;
+  return compareCodePoint(a.meta.agentId, b.meta.agentId);
 }
 function sortBySpawnIndex(children, parentTranscript) {
   return [...children].sort((a, b) => {
@@ -37659,7 +38147,7 @@ function buildNode(input) {
     agentType,
     description,
     depth,
-    models: [...models].sort(),
+    models: [...models].sort(compareCodePoint),
     children
   };
 }
@@ -37789,7 +38277,7 @@ function formatTree(node) {
 }
 function renderLines(node) {
   const indent = "  ".repeat(node.depth);
-  const sortedModels = [...node.models].sort();
+  const sortedModels = [...node.models].sort(compareCodePoint);
   const line = `${indent}${node.agentType} \xB7 [${sortedModels.join(",")}] \xB7 ${node.depth} \xB7 ${node.description}`;
   const childLines = node.children.flatMap((child) => renderLines(child));
   return [line, ...childLines];