@youdie006/prodex 0.39.4 → 0.40.0

package/dist/blocker-report.js

@@ -0,0 +1,81 @@
+/**
+ * Rank what actually blocks consults, across every bridge root on the machine.
+ *
+ * Half of every consult here ends in a blocker, and until now asking WHICH
+ * failure dominates meant writing a throwaway script: `pro list` reads a single
+ * repo, and the registry that knows where the others are had no reader. Pure
+ * on purpose - the reading lives in the command, so the ranking can be tested
+ * without a filesystem.
+ */
+/**
+ * Codes that describe how a send died rather than why. Counting these whole
+ * reports "the catch-all is biggest" and names nothing to fix - measured, one
+ * of them held 165 of 267 blockers - so their message decides the group.
+ */
+const CATCH_ALL_CODES = new Set(["browser_send_failed", "consult_failed", "unknown_error"]);
+/**
+ * The part of a message that identifies the failure, with the varying parts
+ * removed: the same picker failure is written once with "Pro" and once with a
+ * model name, and those are one cause, not two.
+ */
+export function blockerCause(message) {
+    const firstSentence = /^(.*?)(?:\.\s|\.$|$)/.exec(message.trim())?.[1] ?? message.trim();
+    return firstSentence
+        .replace(/"[^"]*"/g, '"..."')
+        .replace(/\d+/g, "N")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function groupKey(code, message) {
+    if (!CATCH_ALL_CODES.has(code))
+        return code;
+    const cause = blockerCause(message);
+    return cause ? `${code}: ${cause}` : code;
+}
+export function buildBlockerReport(input) {
+    const cutoff = input.since ? Date.parse(input.since) : undefined;
+    const inWindow = input.consults.filter((c) => {
+        if (cutoff === undefined)
+            return true;
+        if (!c.createdAt)
+            return false;
+        const at = Date.parse(c.createdAt);
+        return Number.isFinite(at) && at >= cutoff;
+    });
+    const groups = new Map();
+    let blocked = 0;
+    for (const consult of inWindow) {
+        if (!consult.blocker)
+            continue;
+        blocked += 1;
+        const key = groupKey(consult.blocker.code, consult.blocker.message);
+        const at = consult.createdAt ?? "";
+        const existing = groups.get(key);
+        if (existing) {
+            existing.count += 1;
+            if (at > existing.lastSeen)
+                existing.lastSeen = at;
+            existing.repos.set(consult.repo, (existing.repos.get(consult.repo) ?? 0) + 1);
+        }
+        else {
+            groups.set(key, {
+                count: 1,
+                lastSeen: at,
+                example: consult.blocker.message,
+                repos: new Map([[consult.repo, 1]])
+            });
+        }
+    }
+    const ranked = [...groups.entries()]
+        .sort((a, b) => b[1].count - a[1].count || a[0].localeCompare(b[0]))
+        .slice(0, input.limit ?? Number.POSITIVE_INFINITY)
+        .map(([code, g]) => ({
+        code,
+        count: g.count,
+        share: blocked > 0 ? g.count / blocked : 0,
+        lastSeen: g.lastSeen,
+        example: g.example,
+        repos: [...g.repos.entries()].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).map(([repo]) => repo)
+    }));
+    return { totalConsults: inWindow.length, blocked, roots: input.roots, groups: ranked };
+}

package/dist/chatgpt-browser.js

@@ -613,14 +613,32 @@ export function hasChatGptPromptAcceptance(previous, state) {
  * they were getting Pro reasoning when they were not.
  */
 export function modelSelectionWarning(requestedModel, modelSlug) {
-    if (!requestedModel || !modelSlug)
-        return undefined;
-    const wantsPro = /\bpro\b/i.test(requestedModel);
-    if (!wantsPro)
+    return selectionMismatchWarning({
+        ...(requestedModel !== undefined ? { model: requestedModel } : {}),
+        ...(modelSlug !== undefined ? { modelSlug } : {})
+    });
+}
+/** Whether a requested label names ChatGPT's Pro step, in either locale. */
+export function namesPro(label) {
+    if (!label)
+        return false;
+    return /\bpro\b/i.test(label) || label.includes("프로");
+}
+/**
+ * Compare what was asked for against the model that actually answered.
+ *
+ * Pro can be asked for on either axis - `--model Pro` or `--effort Pro` - and
+ * this only ever looked at the model, so an effort-shaped Pro request answered
+ * by a lesser model passed without a word. Measured: a consult asking for Pro
+ * came back from gpt-5-6-thinking and was recorded as a clean success.
+ */
+export function selectionMismatchWarning(input) {
+    const asked = namesPro(input.model) ? input.model : namesPro(input.effort) ? input.effort : undefined;
+    if (!asked || !input.modelSlug)
         return undefined;
-    if (/pro/i.test(modelSlug))
+    if (/pro/i.test(input.modelSlug))
         return undefined;
-    return `model_mismatch: you asked for ${requestedModel}, but the answer came from "${modelSlug}". Check the model picker in the browser; the selection did not take.`;
+    return `model_mismatch: you asked for ${asked}, but the answer came from "${input.modelSlug}". Check the model picker in the browser; the selection did not take.`;
 }
 /**
  * The panel ChatGPT raises to ask which of two answers you prefer.
@@ -2248,6 +2266,14 @@ async function selectModelReasoning(cdp, options, selectionWarnings = []) {
                     const noSuchStep = /has no "[^"]*" step/.test(message);
                     if (!noSuchStep)
                         throw error;
+                    // Asking for a step is a contract. Sending at whatever the slider
+                    // happened to be on is not a lesser version of that contract, it is
+                    // a different answer that the caller cannot use: measured, a Pro
+                    // request came back from gpt-5-6-thinking after minutes of waiting
+                    // and was thrown away. A caller that would rather have any answer
+                    // says so with --allow-model-fallback.
+                    if (!options.allowSelectionFallback)
+                        throw error;
                     const offered = /It showed: (.*)$/.exec(message)?.[1]?.split(" / ").map((part) => part.trim()) ?? [];
                     selectionWarnings.push(stepSelectionUnavailableWarning(plan.sliderLabel, offered));
                 }
@@ -3108,7 +3134,7 @@ export async function sendChatGptPrompt(options) {
             answer: transcript.answer,
             modelHints: finalState?.modelHints ?? [],
             ...(transcript.modelSlug ? { modelSlug: transcript.modelSlug } : finalState?.modelSlug ? { modelSlug: finalState.modelSlug } : {}),
-            warnings: withDialogNote([...sendWarnings, modelSelectionWarning(options.model, transcript.modelSlug || finalState?.modelSlug)]).filter((warning) => Boolean(warning))
+            warnings: withDialogNote([...sendWarnings, selectionMismatchWarning({ ...(options.model !== undefined ? { model: options.model } : {}), ...(options.effort !== undefined ? { effort: options.effort } : {}), ...((transcript.modelSlug || finalState?.modelSlug) ? { modelSlug: (transcript.modelSlug || finalState?.modelSlug) } : {}) })]).filter((warning) => Boolean(warning))
         };
     };
     // Deep research never reaches the DOM answer wait below: the report is
@@ -3256,7 +3282,7 @@ export async function sendChatGptPrompt(options) {
             answer: completed.answer.trim(),
             modelHints: completed.modelHints,
             ...(completed.modelSlug ? { modelSlug: completed.modelSlug } : {}),
-            warnings: withDialogNote([...sendWarnings, modelSelectionWarning(options.model, completed.modelSlug)]).filter((warning) => Boolean(warning))
+            warnings: withDialogNote([...sendWarnings, selectionMismatchWarning({ ...(options.model !== undefined ? { model: options.model } : {}), ...(options.effort !== undefined ? { effort: options.effort } : {}), ...(completed.modelSlug !== undefined ? { modelSlug: completed.modelSlug } : {}) })]).filter((warning) => Boolean(warning))
         };
     }
     // Timed out while the answer was still streaming: salvage the partial text
@@ -3272,7 +3298,7 @@ export async function sendChatGptPrompt(options) {
             ...(completed.modelSlug ? { modelSlug: completed.modelSlug } : {}),
             warnings: withDialogNote([
                 ...sendWarnings,
-                ...(modelSelectionWarning(options.model, completed.modelSlug) ? [modelSelectionWarning(options.model, completed.modelSlug)] : []),
+                ...(selectionMismatchWarning({ ...(options.model !== undefined ? { model: options.model } : {}), ...(options.effort !== undefined ? { effort: options.effort } : {}), ...(completed.modelSlug !== undefined ? { modelSlug: completed.modelSlug } : {}) }) ? [selectionMismatchWarning({ ...(options.model !== undefined ? { model: options.model } : {}), ...(options.effort !== undefined ? { effort: options.effort } : {}), ...(completed.modelSlug !== undefined ? { modelSlug: completed.modelSlug } : {}) })] : []),
                 `answer_incomplete: ChatGPT was still generating after ${formatDurationMs(timeoutMs)} (${timeoutMs}ms), so the answer below may be truncated. Raise --timeout-ms and retry for the full response.`
             ])
         };

package/dist/cli-args.js

@@ -259,7 +259,11 @@ export const ASK_PRO_BOOLEAN_FLAGS = new Set([
     "--auto-login",
     "--no-auto-login",
     // Send outside any project for once, overriding a pinned default.
-    "--no-project"
+    "--no-project",
+    // Send even when the requested model/effort could not be applied, rather
+    // than stopping. Off by default: an answer from a step nobody asked for is
+    // usually thrown away.
+    "--allow-model-fallback"
 ]);
 export const ASK_PRO_SELECTION_VALUE_FLAGS = ["--project", "--project-new", "--model", "--pro-mode", "--effort"];
 export const ASK_PRO_VALUE_FLAGS = new Set([

package/dist/cli-help.js

@@ -26,8 +26,9 @@ Ask / consult commands:
   prodex pro browser models [--source-cli /absolute/path/to/dist/cli.js] [--port 9333] [--timeout-ms 15000]  # read-only list of model menu options
   prodex pro browser projects [--source-cli /absolute/path/to/dist/cli.js] [--port 9333] [--timeout-ms 15000]  # read-only list of sidebar project names (for --project)
   prodex pro browser recover [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] --target-url <thread-url> [--timeout-ms 60000]  # recover a finished answer from a thread whose send timed out
-  prodex pro browser ask [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 300000] [--busy-wait-ms 600000] [--target-url url --confirm-target] [--new-chat] [--temporary] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] [--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"|Max|Ultra|Pro] [--project "name" | --project-new "name"] "prompt"  # explicit visible-browser send
+  prodex pro browser ask [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 300000] [--busy-wait-ms 600000] [--target-url url --confirm-target] [--new-chat] [--temporary] [--allow-model-fallback] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] [--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"|Max|Ultra|Pro] [--project "name" | --project-new "name"] "prompt"  # explicit visible-browser send
   prodex pro latest [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--json]
+  prodex pro blockers [--cwd /absolute/path/to/repo] [--since 7d] [--limit 10] [--json]  # what actually blocks consults, ranked, across every bridge root on this machine
   prodex pro list [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--json]
   prodex pro show <task-id|latest> [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--json]
   prodex pro report-issue [--cwd /absolute/path/to/repo] [--task <task-id>] [--repo owner/name] [--confirm]  # bug report from a failed consult's receipt; previews unless --confirm, never carries the prompt or the answer
@@ -88,6 +89,7 @@ Optional visible-browser send defaults (applied by \`pro browser ask\` when the
   --model      Composer model by its exact menu label. Only Pro applies on the current picker: it is a slider step, and the model rows cannot be clicked
   --pro-mode   Pro sub-mode: 기본 (standard) or 확장 (extended)
   --effort     Reasoning effort: 즉시 / 중간 / 높음 / 매우 높음 / Max / Ultra / Pro. Max and Ultra are rungs of ChatGPT's Work surface and only apply when the browser is already on Work (prodex does not switch to Work for them); every other value is sent on Chat, whose top step is Pro
+  --allow-model-fallback  Send even when the requested model/effort could not be applied. Off by default: a send that could not reach what was asked for stops instead, because an answer from a step nobody asked for is usually unusable
   --project    Sidebar project to enter before sending
 Clear a saved default with --clear-model / --clear-pro-mode / --clear-effort / --clear-project.
 --pro-mode and --effort are different model axes and cannot be combined. View saved defaults with \`prodex status\`.`);
@@ -168,8 +170,9 @@ Commands:
   prodex pro browser check [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo]
   prodex pro browser smoke [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo]
   prodex pro browser models [--source-cli /absolute/path/to/dist/cli.js]
-  prodex pro browser ask [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--target-url url --confirm-target] [--new-chat] [--temporary] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] [--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"|Max|Ultra|Pro] [--project "name" | --project-new "name"] "prompt"
+  prodex pro browser ask [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--target-url url --confirm-target] [--new-chat] [--temporary] [--allow-model-fallback] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] [--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"|Max|Ultra|Pro] [--project "name" | --project-new "name"] "prompt"
   prodex pro latest [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--json]
+  prodex pro blockers [--cwd /absolute/path/to/repo] [--since 7d] [--limit 10] [--json]  # what actually blocks consults, ranked, across every bridge root on this machine
   prodex pro list [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--json]
   prodex pro show <task-id|latest> [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--json]
   prodex pro report-issue [--cwd /absolute/path/to/repo] [--task <task-id>] [--repo owner/name] [--confirm]  # bug report from a failed consult's receipt; previews unless --confirm, never carries the prompt or the answer
@@ -255,8 +258,8 @@ export function printProBrowserHelp(stdout, sourceCli) {
         : "prodex pro browser smoke [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 90000]";
     const selectionUsage = '[--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"|Max|Ultra|Pro] [--project "name" | --project-new "name"]';
     const askUsage = sourceCli
-        ? `${cli} pro browser ask${sourceCliOption} [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 300000] [--busy-wait-ms 600000] [--target-url url --confirm-target] [--new-chat] [--temporary] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] ${selectionUsage} "prompt"`
-        : `prodex pro browser ask [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 300000] [--busy-wait-ms 600000] [--target-url url --confirm-target] [--new-chat] [--temporary] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] ${selectionUsage} "prompt"`;
+        ? `${cli} pro browser ask${sourceCliOption} [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 300000] [--busy-wait-ms 600000] [--target-url url --confirm-target] [--new-chat] [--temporary] [--allow-model-fallback] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] ${selectionUsage} "prompt"`
+        : `prodex pro browser ask [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 300000] [--busy-wait-ms 600000] [--target-url url --confirm-target] [--new-chat] [--temporary] [--allow-model-fallback] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] ${selectionUsage} "prompt"`;
     const modelsUsage = sourceCli
         ? `${cli} pro browser models${sourceCliOption} [--port 9333] [--timeout-ms 15000]`
         : "prodex pro browser models [--source-cli /absolute/path/to/dist/cli.js] [--port 9333] [--timeout-ms 15000]";

package/dist/cli-pro.js

@@ -2,7 +2,7 @@ import { existsSync, statSync } from "node:fs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { buildDryRunBundle } from "./bundle.js";
-import { DEFAULT_CDP_PORT, resolveCdpPort, resolveConversationToDelete, resolveProjectToDelete, chatGptVisibilityBlocker, defaultChatGptProfileDir, formatDurationMs, getChatGptBrowserStatus, formatModelMenuOption, listChatGptModelOptions, deleteChatGptConversation, endWedgedBrowser, browserRecoveryPlan, findWedgedBrowser, wedgedBrowserBlocker, deleteChatGptProject, listChatGptProjectsWithIds, listRecentChatGptConversations, listChatGptSidebarProjects, normalizeChatGptTargetUrl, openChatGptBrowser, openChatGptTab, parseProMode, parseReasoningEffort, defaultTimeoutForTools, ensureVirtualDisplay, minimizeChatGptWindow, readLastBrowserLoginLaunch, resolveVirtualDisplayPreference, resolveBrowserWindowMode, resolveHeadlessPreference, recordBrowserLoginLaunch, recoverChatGptAnswerFromThread, sendChatGptPrompt, statusMeansBrowserDead } from "./chatgpt-browser.js";
+import { DEFAULT_CDP_PORT, resolveCdpPort, resolveConversationToDelete, resolveProjectToDelete, chatGptVisibilityBlocker, defaultChatGptProfileDir, formatDurationMs, getChatGptBrowserStatus, formatModelMenuOption, listChatGptModelOptions, deleteChatGptConversation, endWedgedBrowser, browserRecoveryPlan, findWedgedBrowser, wedgedBrowserBlocker, deleteChatGptProject, listChatGptProjectsWithIds, listRecentChatGptConversations, listChatGptSidebarProjects, normalizeChatGptTargetUrl, openChatGptBrowser, openChatGptTab, parseProMode, parseReasoningEffort, defaultTimeoutForTools, ensureVirtualDisplay, minimizeChatGptWindow, readLastBrowserLoginLaunch, resolveVirtualDisplayPreference, resolveBrowserWindowMode, resolveHeadlessPreference, recordBrowserLoginLaunch, recoverChatGptAnswerFromThread, sendChatGptPrompt, statusMeansBrowserDead, namesPro } from "./chatgpt-browser.js";
 import { ASK_PRO_BOOLEAN_FLAGS, ASK_PRO_PREVIEW_VALUE_FLAGS, ASK_PRO_VALUE_FLAGS, assertHelpRequestArgs, assertNoExtraArgs, assertOnlyOptions, findHelpFlagIndexBeforePromptDelimiter, formatCliCommand, hasAskProDryRunMode, hasAskProMode, hasAskProSendMode, isHelpSubcommand, parseAskProArgs, printHelpIfRequested, readFlag, readPortFlag, readPositionalsWithOptions, readNonNegativeIntegerFlag, readPositiveIntegerFlag, readRepeatedFlag, resolveCwdFlag, resolveOptionalFileFlag, unknownSubcommandError } from "./cli-args.js";
 import { printProBrowserHelp, printProHelp } from "./cli-help.js";
 import { listRawResultsForInspection, listTasksForInspection } from "./cli-ledger.js";
@@ -10,6 +10,8 @@ import { formatBrowserDefaults, redactServerUrl } from "./cli-server.js";
 import { errorMessage, firstLine, formatBlockedConsultRecordedMessage, formatProLatestCommand, formatBrowserCheckCommand, formatBrowserLoginCommand, formatBrowserSmokeCommand, formatBrowserTargetAskCommand, formatInitCommand, formatSetupCommand, isMissingFileError, computeSendPacingWaitMs, isUntrustedResultError, resolveMinSendIntervalMs, sourceAwareBrowserBlocker, sourceAwareBrowserNextStep, sourceAwareResultError, sourceAwareResultMessage, sourceAwareSetupMessage } from "./cli-shared.js";
 import { getTokenExpiryStatus, loadBrowserDefaults, loadLocalConfig } from "./config.js";
 import { withBrowserSendLock } from "./browser-send-lock.js";
+import { blockerCause, buildBlockerReport } from "./blocker-report.js";
+import { readBridgeRoots } from "./registry.js";
 import { BridgeStore, MAX_FETCHABLE_RESULT_ARTIFACT_BYTES } from "./store.js";
 import { CLI_VERSION } from "./cli-help.js";
 import { PRODEX_ISSUE_REPO, buildIssueReport, fileGitHubIssue } from "./issue-report.js";
@@ -732,6 +734,50 @@ export async function runProCommand(rest, io, runCliFn) {
         // a two-hop dead end that made an agent abandon the diagnosis.
         throw new Error(`Use \`prodex pro browser ${legacyBrowserSubcommandReplacement(subcommand)}\` for explicit browser automation.`);
     }
+    if (subcommand === "blockers") {
+        if (printHelpIfRequested(proArgs, "pro blockers", io.stdout, printProHelp, { valueFlags: ["--cwd", "--since", "--limit"] }))
+            return 0;
+        assertOnlyOptions(proArgs, "pro blockers", ["--cwd", "--since", "--limit"], ["--json"]);
+        const scopedToOneRepo = readFlag(proArgs, "--cwd") !== undefined;
+        // Default to every bridge root: the failures are spread across the repos
+        // consults were run from, and `pro list` already covers just this one.
+        const roots = scopedToOneRepo ? [resolveCwdFlag(io.cwd, proArgs)] : await readBridgeRoots();
+        const since = readSinceFlag(proArgs);
+        const limit = readPositiveIntegerFlag(proArgs, "--limit") ?? 10;
+        const consults = [];
+        let readable = 0;
+        for (const root of roots) {
+            try {
+                const results = await new BridgeStore(root).listResultsReadOnly();
+                readable += 1;
+                for (const result of results) {
+                    if (!result.task_id.includes("gpt-pro-consult"))
+                        continue;
+                    consults.push({
+                        repo: path.basename(root),
+                        createdAt: result.created_at,
+                        ...(result.blocker ? { blocker: { code: result.blocker.code, message: result.blocker.message } } : {})
+                    });
+                }
+            }
+            catch {
+                // A root that has been deleted or is unreadable is not a failure of
+                // the report; it just has nothing to contribute.
+            }
+        }
+        const report = buildBlockerReport({
+            consults,
+            roots: readable,
+            ...(since ? { since } : {}),
+            limit
+        });
+        if (proArgs.includes("--json")) {
+            io.stdout(JSON.stringify(report, null, 2));
+            return 0;
+        }
+        io.stdout(formatBlockerReport(report, { since, scopedToOneRepo }));
+        return 0;
+    }
     if (subcommand === "list") {
         if (printHelpIfRequested(proArgs, "pro list", io.stdout, printProHelp, { valueFlags: ["--cwd", "--source-cli"] }))
             return 0;
@@ -879,7 +925,7 @@ export async function runProCommand(rest, io, runCliFn) {
         io.stdout(formatDebatePrompt({ topic: readFlag(proArgs, "--topic"), rounds, sourceCli }));
         return 0;
     }
-    throw unknownSubcommandError("pro", subcommand, ["ask", "browser", "debate-prompt", "list", "latest", "show"]);
+    throw unknownSubcommandError("pro", subcommand, ["ask", "blockers", "browser", "debate-prompt", "list", "latest", "show"]);
 }
 export async function runConsultsCommand(rest, io) {
     throw new Error("The legacy `consults` alias is retired. Use `prodex pro list`, `prodex pro latest`, or `prodex pro show <task-id|latest>`.");
@@ -1110,13 +1156,22 @@ export async function runAskProCommand(rest, io) {
     };
     const browserPort = hasSendMode ? resolveCdpPort(readPortFlag(parsedAskPro.optionArgs, "--port")) : undefined;
     const busyWaitMs = readNonNegativeIntegerFlag(parsedAskPro.optionArgs, "--busy-wait-ms");
+    const allowSelectionFallback = parsedAskPro.optionArgs.includes("--allow-model-fallback");
     // Pro extended can legitimately think for minutes, so its default timeout is
     // higher; an explicit --timeout-ms always wins.
     // Pro reasoning routinely runs for many minutes (a real consult measured
     // ~13 minutes). The elevated default used to be keyed to the removed
     // --pro-mode, so --model Pro sends fell back to 90s and chronically timed
     // out. Any effective Pro selection now defaults to 15 minutes.
-    const effectiveProSelection = selectionProMode !== undefined || (selectionModel !== undefined && /pro/i.test(selectionModel));
+    // Pro can be asked for on either axis. Keying the raised budget to the
+    // model alone gave `--effort Pro` five minutes for reasoning this file's
+    // own comment calls 6-20 minutes, which manufactured send_timeout
+    // blockers - 55 of the 267 blockers measured on one machine.
+    const effectiveProSelection = isProSelection({
+        ...(selectionModel !== undefined ? { model: selectionModel } : {}),
+        ...(selectionProMode !== undefined ? { proMode: selectionProMode } : {}),
+        ...(selectionEffort !== undefined ? { effort: selectionEffort } : {})
+    });
     // Pro reasoning routinely runs 6-20 minutes; 15 min was still cutting long
     // answers off (field report), so a Pro selection defaults to 20 minutes.
     // With NO model selection at all (no flag, no saved default) the UI's
@@ -1202,6 +1257,7 @@ export async function runAskProCommand(rest, io) {
             model: selectionModel,
             proMode: selectionProMode,
             effort: selectionEffort,
+            ...(allowSelectionFallback ? { allowSelectionFallback: true } : {}),
             onProgress: createBrowserSendProgressPrinter(io.stderr)
         }));
         // One-command recovery: interactive terminals (or explicit --auto-login)
@@ -1303,6 +1359,16 @@ export async function runAskProCommand(rest, io) {
             io.stderr(warning);
         if (consult.modelSlug)
             io.stderr(`model_used: ${consult.modelSlug}`);
+        // "Can I count this as a Pro review?" - answered here rather than left
+        // for whoever reads the receipt to work out from two other fields.
+        const proVerified = proSelectionVerified({
+            ...(selectionModel !== undefined ? { model: selectionModel } : {}),
+            ...(selectionProMode !== undefined ? { proMode: selectionProMode } : {}),
+            ...(selectionEffort !== undefined ? { effort: selectionEffort } : {}),
+            ...(consult.modelSlug !== undefined ? { modelSlug: consult.modelSlug } : {})
+        });
+        if (proVerified !== undefined)
+            io.stderr(`pro_verified: ${proVerified ? "yes" : "no"}`);
         let answerArtifactPath;
         const answerArtifactBytes = Buffer.byteLength(answerArtifactText, "utf8");
         if (answerArtifactBytes > MAX_FETCHABLE_RESULT_ARTIFACT_BYTES) {
@@ -1333,6 +1399,7 @@ export async function runAskProCommand(rest, io) {
                     // What actually answered, straight from ChatGPT's own tag - the
                     // receipt used to record only what prodex asked for.
                     ...(consult.modelSlug ? { model_used: consult.modelSlug } : {}),
+                    ...(proVerified !== undefined ? { pro_verified: proVerified } : {}),
                     warnings: persistenceWarnings
                 }
             });
@@ -1498,6 +1565,7 @@ export async function performBrowserConsultForMcp(cwd, input, onProgress) {
         ...(input.attach ?? []).flatMap((file) => ["--attach", file]),
         ...(input.tools ?? []).flatMap((tool) => ["--tool", tool]),
         ...(input.new_chat ? ["--new-chat"] : []),
+        ...(input.allow_model_fallback ? ["--allow-model-fallback"] : []),
         "--",
         input.prompt
     ];
@@ -1705,6 +1773,29 @@ export async function assertBrowserLaunchStayedAlive(opened, timeoutMs) {
     }
     throw new Error(`Chrome/Chromium did not expose a reachable DevTools endpoint after launch. Check the visible browser environment, profile lock, display access, or PRODEX_CHROME, then retry.`);
 }
+/** Whether a send asked for ChatGPT's Pro step, on either axis that can name it. */
+export function isProSelection(selection) {
+    if (selection.proMode !== undefined)
+        return true;
+    return namesPro(selection.model) || namesPro(selection.effort);
+}
+/**
+ * Whether a Pro request was actually answered by Pro, per ChatGPT's own tag on
+ * the message. Undefined when Pro was not asked for, or when no tag came back
+ * to check against - there is nothing to certify in either case.
+ *
+ * The receipt already carried the request and the answering model separately,
+ * leaving the comparison to whoever read it later. The question a caller has
+ * is "can I count this as a Pro review?", and a consult that asked for Pro and
+ * was answered by gpt-5-6-thinking was recorded as a clean success.
+ */
+export function proSelectionVerified(selection) {
+    if (!isProSelection(selection))
+        return undefined;
+    if (!selection.modelSlug)
+        return undefined;
+    return /pro/i.test(selection.modelSlug);
+}
 export function browserSendBlockerFromError(error) {
     const blocker = typeof error === "object" && error !== null && "blocker" in error ? error.blocker : undefined;
     if (typeof blocker === "object" &&
@@ -1770,6 +1861,17 @@ export function browserSendBlockerFromError(error) {
             next_step: "Another prodex send holds the browser. Wait for it to finish and retry, or pass a longer --timeout-ms, which is also the queue budget."
         };
     }
+    // The picker could not provide the step that was asked for. Retrying asks
+    // the same picker the same question, so this is not retryable; the caller
+    // either picks a step it offers or opts into whatever the slider is on.
+    if (/has no "[^"]*" step/.test(message)) {
+        return {
+            code: "selection_not_applied",
+            message,
+            retryable: false,
+            next_step: "ChatGPT's picker could not provide the model or effort that was asked for, so nothing was sent. Run `prodex pro browser models` to see the steps this account offers and ask for one of those, or pass --allow-model-fallback to send at whatever the picker is currently set to."
+        };
+    }
     // The picker's slider took focus before its key handler was attached and
     // ignored every press. Retrying is the cure; nothing in the browser is
     // broken, so the generic "resolve it manually" pointed at nothing.
@@ -1878,6 +1980,63 @@ export function formatProConsultArtifact(consult) {
     lines.push("## Answer", "", consult.answer.trim(), "");
     return lines.join("\n");
 }
+/**
+ * `--since 7d`, `--since 24h`, or a plain date. A window is how you ask whether
+ * a fix landed, so it has to be quick to type.
+ */
+export function readSinceFlag(args) {
+    const raw = readFlag(args, "--since");
+    if (raw === undefined)
+        return undefined;
+    const relative = /^(\d+)\s*([dh])$/i.exec(raw.trim());
+    if (relative) {
+        const amount = Number(relative[1]);
+        const hours = relative[2]?.toLowerCase() === "d" ? amount * 24 : amount;
+        return new Date(Date.now() - hours * 3_600_000).toISOString();
+    }
+    const parsed = Date.parse(raw);
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`--since expects a date or an age like 7d or 24h, not "${raw}".`);
+    }
+    return new Date(parsed).toISOString();
+}
+/** The ranked report as a table, widest column first so the counts line up. */
+export function formatBlockerReport(report, options = {}) {
+    const scope = options.scopedToOneRepo ? "this repo" : `${report.roots} bridge root${report.roots === 1 ? "" : "s"}`;
+    const window = options.since ? ` since ${options.since.slice(0, 10)}` : "";
+    if (report.totalConsults === 0) {
+        return `No consults recorded in ${scope}${window}.`;
+    }
+    const share = report.totalConsults > 0 ? Math.round((report.blocked / report.totalConsults) * 100) : 0;
+    const head = `Consult blockers: ${report.blocked} of ${report.totalConsults} consults (${share}%) across ${scope}${window}`;
+    if (report.groups.length === 0)
+        return `${head}\n\nNothing was blocked.`;
+    // A split catch-all carries the first sentence in its own name, so the
+    // example would repeat it; only a bare code needs one.
+    const clip = (text, max) => (text.length > max ? `${text.slice(0, max - 1)}\u2026` : text);
+    const rows = report.groups.map((group) => {
+        const example = group.example.replace(/\s+/g, " ").trim();
+        // Compare through the same normalisation the cause went through: the code
+        // says `has no "..." step` where the message says `has no "Pro" step`.
+        const causePart = group.code.includes(": ") ? group.code.split(": ").slice(1).join(": ") : undefined;
+        const redundant = causePart !== undefined && blockerCause(example) === causePart;
+        return {
+            count: String(group.count),
+            share: `${Math.round(group.share * 100)}%`,
+            code: clip(group.code, 58),
+            lastSeen: group.lastSeen ? group.lastSeen.slice(0, 10) : "-",
+            example: redundant ? "" : clip(example, 58)
+        };
+    });
+    const width = (pick, header) => Math.max(header.length, ...rows.map((row) => pick(row).length));
+    const wCount = width((r) => r.count, "COUNT");
+    const wShare = width((r) => r.share, "SHARE");
+    const wCode = width((r) => r.code, "CAUSE");
+    const wLast = width((r) => r.lastSeen, "LAST SEEN");
+    const line = (count, sharePct, code, lastSeen, example) => `  ${count.padStart(wCount)}  ${sharePct.padStart(wShare)}  ${code.padEnd(wCode)}  ${lastSeen.padEnd(wLast)}  ${example}`;
+    const body = rows.map((row) => line(row.count, row.share, row.code, row.lastSeen, row.example).trimEnd());
+    return [head, "", line("COUNT", "SHARE", "CAUSE", "LAST SEEN", "EXAMPLE"), ...body].join("\n");
+}
 export function formatProListSummary(consult, sourceCli, options = {}) {
     const blocker = sourceAwareProAnswerBlocker(consult, sourceCli, options);
     return firstLine(sourceAwareProAnswerSummary(consult.result.summary, consult.result.blocker, blocker));

package/dist/mcp.js

@@ -187,7 +187,11 @@ export function createServer(cwd = process.cwd(), options = {}) {
                 new_chat: z
                     .boolean()
                     .optional()
-                    .describe("Start a fresh thread. Omit to continue the current thread (preferred for follow-ups).")
+                    .describe("Start a fresh thread. Omit to continue the current thread (preferred for follow-ups)."),
+                allow_model_fallback: z
+                    .boolean()
+                    .optional()
+                    .describe("Send even when the requested model or effort could not be applied. Off by default, because an answer from a step nobody asked for is usually unusable: a consult asking for Pro that comes back from a lesser model cannot be cited as a Pro review. Pass true only when any answer beats no answer.")
             }
         }, async (input, extra) => {
             // Bridge send progress to MCP progress notifications, but only when

package/dist/registry.js

@@ -44,6 +44,38 @@ async function directoryExists(dir) {
         return false;
     }
 }
+/**
+ * Every bridge root this machine knows about. The registry has only ever been
+ * written; reading it is what lets a report span the repos where the failures
+ * actually are, instead of the one the command happens to run in.
+ *
+ * Advisory like the rest of the registry: a missing or corrupt file is an
+ * empty list, not an error, and roots that have since been deleted are
+ * dropped rather than reported.
+ */
+export async function readBridgeRoots() {
+    let parsed;
+    try {
+        parsed = JSON.parse(await fs.readFile(bridgesRegistryPath(), "utf8"));
+    }
+    catch {
+        return [];
+    }
+    const raw = parsed?.roots;
+    if (!Array.isArray(raw))
+        return [];
+    const roots = [];
+    for (const entry of raw.slice(0, MAX_REGISTRY_ROOTS)) {
+        const value = typeof entry === "string" ? entry : entry?.path;
+        if (typeof value !== "string" || value.length === 0)
+            continue;
+        if (!(await directoryExists(path.join(value, ".bridge"))))
+            continue;
+        if (!roots.includes(value))
+            roots.push(value);
+    }
+    return roots;
+}
 export function registerBridgeRoot(root) {
     const next = registryQueue.then(() => registerBridgeRootInner(root));
     // Keep the chain alive even if an inner registration rejects.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdie006/prodex",
-  "version": "0.39.4",
+  "version": "0.40.0",
   "description": "Local receipt bus for coordinating Codex execution with ChatGPT Pro/Projects consultation.",
   "author": "youdie006",
   "license": "MIT",