@pourkit/cli 0.0.0-next-20260707180736 → 0.0.0-next-20260708233839

package/dist/cli.js

@@ -1422,6 +1422,9 @@ function buildRunContextMarkdown(options) {
     sections = ALL_RUN_CONTEXT_SECTIONS
   } = options;
   const parts = ["# Pourkit Run Context", ""];
+  if (sections.includes("verification-commands")) {
+    parts.push(...renderCommandList(target, "Verification Commands", repoRoot2));
+  }
   if (sections.includes("issue")) {
     const issueBody = stripIssueSections(issue.body, [
       "Parent",
@@ -1467,9 +1470,6 @@ function buildRunContextMarkdown(options) {
       ""
     );
   }
-  if (sections.includes("verification-commands")) {
-    parts.push(...renderCommandList(target, "Verification Commands", repoRoot2));
-  }
   if (sections.includes("review-criteria")) {
     parts.push(...renderCriteria(reviewerCriteria));
   }
@@ -11049,6 +11049,7 @@ function persistStartingPrdRunRecord(repoRoot2, prdRef, existingRecord, start, c
     diagnostics: _diagnostics,
     offendingPaths: _offendingPaths,
     prdBranch: _prdBranch,
+    repairGuidance: _repairGuidance,
     start: _start,
     ...cleanRecord
   } = existingRecord.record ?? { prdRef };
@@ -11553,6 +11554,23 @@ var QUEUE_FAILURE_CODES_WITHOUT_SELECTED_ISSUE = /* @__PURE__ */ new Set([
   "prd-branch-mismatch",
   "missing-child-finalization-evidence"
 ]);
+var ISSUE_FINAL_REVIEW_HANDOFF_PREFIX = "Issue Final Review requires human handoff";
+function buildQueueIssueRunRepairMetadata(message, fallbackFailureCode, prdRef) {
+  if (!message.startsWith(ISSUE_FINAL_REVIEW_HANDOFF_PREFIX)) {
+    return {
+      failureCode: fallbackFailureCode,
+      repairability: "automatic-retry-safe",
+      nextAction: "rerun-prd-run-launch",
+      nextRecommendedCommand: "pourkit prd-run launch"
+    };
+  }
+  return {
+    failureCode: "issue-final-review-human-handoff",
+    repairability: "operator-action",
+    nextAction: "inspect-issue-final-review-handoff",
+    nextRecommendedCommand: `pourkit prd-run status ${prdRef}`
+  };
+}
 function canRetryQueueGuidanceWithoutIssue(options) {
   const { guidance, startReceipt } = options;
   if (guidance.blockedGate !== "queue") return false;
@@ -12269,17 +12287,22 @@ async function launchGithubQueueDrain(options, prdRef, startReceipt, targetName,
     const msg = error instanceof Error ? error.message : String(error);
     const diagnostics = [msg];
     const issue = extractIssueFromQueueError(error);
+    const repair = buildQueueIssueRunRepairMetadata(
+      msg,
+      "queue-exception",
+      prdRef
+    );
     const result = buildLaunchBlockedOutcome(
       options.repoRoot,
       prdRef,
       buildPrdRunRepairGuidance({
         blockedGate: "queue",
         blockedStage: "queue-drain",
-        failureCode: "queue-exception",
+        failureCode: repair.failureCode,
         humanReadableReason: msg,
-        repairability: "automatic-retry-safe",
-        nextAction: "rerun-prd-run-launch",
-        nextRecommendedCommand: "pourkit prd-run launch",
+        repairability: repair.repairability,
+        nextAction: repair.nextAction,
+        nextRecommendedCommand: repair.nextRecommendedCommand,
         diagnostics,
         issue
       }),
@@ -12481,17 +12504,22 @@ async function launchBeadsQueueDrain(options, prdRef, startReceipt, targetName,
       startReceipt.queueProcessedCount = processedResults.length;
     } catch (error) {
       const msg = error instanceof Error ? error.message : String(error);
+      const repair = buildQueueIssueRunRepairMetadata(
+        msg,
+        "resume-issue-failed",
+        prdRef
+      );
       return buildLaunchBlockedOutcome(
         options.repoRoot,
         prdRef,
         buildPrdRunRepairGuidance({
           blockedGate: "queue",
           blockedStage: "queue-drain",
-          failureCode: "resume-issue-failed",
+          failureCode: repair.failureCode,
           humanReadableReason: msg,
-          repairability: "automatic-retry-safe",
-          nextAction: "rerun-prd-run-launch",
-          nextRecommendedCommand: "pourkit prd-run launch",
+          repairability: repair.repairability,
+          nextAction: repair.nextAction,
+          nextRecommendedCommand: repair.nextRecommendedCommand,
           diagnostics: [msg],
           issue: resumeIssue ? {
             number: fetchedIssue.number,
@@ -12603,6 +12631,11 @@ async function launchBeadsQueueDrain(options, prdRef, startReceipt, targetName,
       });
     } catch (error) {
       const msg = error instanceof Error ? error.message : String(error);
+      const repair = buildQueueIssueRunRepairMetadata(
+        msg,
+        "beads-issue-run-failed",
+        prdRef
+      );
       const beadsChildClosed = msg.startsWith(
         "Projection failure after Beads close"
       );
@@ -12612,11 +12645,11 @@ async function launchBeadsQueueDrain(options, prdRef, startReceipt, targetName,
         buildPrdRunRepairGuidance({
           blockedGate: "queue",
           blockedStage: "queue-drain",
-          failureCode: "beads-issue-run-failed",
+          failureCode: repair.failureCode,
           humanReadableReason: msg,
-          repairability: "automatic-retry-safe",
-          nextAction: "rerun-prd-run-launch",
-          nextRecommendedCommand: "pourkit prd-run launch",
+          repairability: repair.repairability,
+          nextAction: repair.nextAction,
+          nextRecommendedCommand: repair.nextRecommendedCommand,
           diagnostics: [msg],
           issue: {
             number: contextResult.issue.number,
@@ -13454,6 +13487,8 @@ function buildManagedAgentInstructions(options) {
 
 Use \`fd\` for file discovery, \`rg\` for text search, and direct file reads for focused context.
 
+Use the \`explore-codebase\` skill when the user asks to explore or map a codebase, including an external package or repository, find feature/module ownership, identify entry points/tests/docs, or produce a Codebase Navigation Atlas.
+
 For multi-step exploration, prefer the dedicated subagents in \`.opencode/agents\`:
 
 - Use \`codebase-locator\` when you need to find relevant files, directories, or entry points.
@@ -13464,7 +13499,7 @@ For multi-step exploration, prefer the dedicated subagents in \`.opencode/agents
 
 Use direct \`fd\`/\`rg\`/reads for focused checks; use subagents when the search would otherwise require several discovery/read steps.
 
-Use \`opensrc path <package-or-repo>\` whenever implementation requires reading external source code, not only package dependencies. If you would otherwise clone a repository to inspect its source, use \`opensrc\` first, then search or read files under the returned source path with \`rg\` and direct file reads.
+Use the \`explore-codebase\` skill as the main route for broad external-source exploration. Inside that workflow, use \`opensrc path <package-or-repo>\` whenever implementation requires reading external source code, not only package dependencies. For focused external-source checks, use \`opensrc\` directly. If you would otherwise clone a repository to inspect its source, use \`opensrc\` first, then search or read files under the returned source path with \`rg\` and direct file reads.
 
 Follow the project's domain docs and workflow routes documented in the Pourkit managed block below.
 
@@ -19327,11 +19362,11 @@ function createCliProgram(version) {
   return program;
 }
 async function resolveCliVersion() {
-  if (isPackageVersion("0.0.0-next-20260707180736")) {
-    return "0.0.0-next-20260707180736";
+  if (isPackageVersion("0.0.0-next-20260708233839")) {
+    return "0.0.0-next-20260708233839";
   }
-  if (isReleaseVersion("0.0.0-next-20260707180736")) {
-    return "0.0.0-next-20260707180736";
+  if (isReleaseVersion("0.0.0-next-20260708233839")) {
+    return "0.0.0-next-20260708233839";
   }
   try {
     const root = repoRoot();