opendevbrowser 0.0.19 → 0.0.21

package/dist/cli/index.js

@@ -21,6 +21,7 @@ import {
   formatErrorPayload,
   generateSecureToken,
   getChromeUserDataRoots,
+  getCurrentDaemonFingerprint,
   getExtensionPath,
   getProfileDirs,
   loadGlobalConfig,
@@ -30,22 +31,24 @@ import {
   resolveExitCode,
   startDaemon,
   toCliError
-} from "../chunk-W4IHGDXV.js";
+} from "../chunk-4KVXCXV3.js";
 import {
   getBundledSkillsDir,
   listBundledSkillDirectories
-} from "../chunk-YBQECXZX.js";
-import "../chunk-Y2KL55OG.js";
+} from "../chunk-3VA6XR25.js";
 import {
   writeFileAtomic
 } from "../chunk-TBUCZX4A.js";
+import "../chunk-Y2KL55OG.js";
 import {
+  INSPIREDESIGN_HANDOFF_COMMANDS,
+  INSPIREDESIGN_HANDOFF_GUIDANCE,
   cleanupExpiredArtifacts,
   isChallengeAutomationMode,
   setDefaultLogSink,
   stderrSink,
   summarizePrimaryProviderIssue
-} from "../chunk-5FZQJRBQ.js";
+} from "../chunk-ZE2E7ZGH.js";
 import "../chunk-FUSXMW3G.js";
 
 // src/cli/args.ts
@@ -245,25 +248,18 @@ function detectOutputFormat(argv) {
   }
 }
 
-// src/cli/commands/registry.ts
-var registry = /* @__PURE__ */ new Map();
-function registerCommand(definition) {
-  registry.set(definition.name, definition);
-}
-function getCommand(name) {
-  return registry.get(name);
-}
-function listCommands() {
-  return Array.from(registry.values());
-}
-
 // src/cli/help.ts
 var LABEL_WIDTH = 42;
 var DETAIL_LABEL_WIDTH = 9;
 var COMMAND_SET = new Set(CLI_COMMANDS);
 var FLAG_SET = new Set(VALID_FLAGS);
 var TOOL_COUNT = TOOL_SURFACE_ENTRIES.length;
+var CLI_EQUIVALENT_SET = new Set(
+  TOOL_SURFACE_ENTRIES.flatMap((entry) => entry.cliEquivalent ? [entry.cliEquivalent] : [])
+);
 var formatFlags = (flags) => flags.length > 0 ? flags.join(", ") : "none";
+var getCliOnlyCommands = () => CLI_COMMANDS.filter((command) => !CLI_EQUIVALENT_SET.has(command));
+var getToolOnlyHelperNames = () => TOOL_SURFACE_ENTRIES.filter((entry) => !entry.cliEquivalent).map((entry) => entry.name);
 var HELP_COMMAND_GROUPS = PUBLIC_CLI_COMMAND_GROUPS.map((group) => ({
   title: group.title,
   summary: group.summary,
@@ -330,7 +326,7 @@ var HELP_FLAG_GROUPS = [
     title: "Navigation / Interaction / Diagnostics Flags",
     summary: "Command-specific flags for page actions, reads, and diagnostics.",
     flags: [
-      { flag: "--url", description: "Target URL for navigation, connect, or workflow commands.", example: "opendevbrowser goto --session-id s1 --url https://example.com" },
+      { flag: "--url", description: "Target URL for navigation, connect, or workflow commands; repeat for multi-reference inspiredesign runs.", example: "opendevbrowser goto --session-id s1 --url https://example.com" },
       { flag: "--wait-until", description: "Navigation wait strategy such as load or domcontentloaded." },
       { flag: "--timeout-ms", description: "Operation timeout in milliseconds.", example: "opendevbrowser canvas --timeout-ms 120000 --command canvas.session.open ..." },
       { flag: "--ref", description: "Snapshot ref id for element-targeted commands.", example: "opendevbrowser click --session-id s1 --ref r12" },
@@ -409,6 +405,9 @@ var HELP_FLAG_GROUPS = [
       { flag: "--budget", description: "Budget filter for shopping workflows." },
       { flag: "--region", description: "Region or country hint for provider selection. Treat it as advisory unless output metadata reports `region_authoritative=true`." },
       { flag: "--sort", description: "Sort mode for shopping results." },
+      { flag: "--brief", description: "Inspiredesign brief describing the target design direction." },
+      { flag: "--capture-mode", description: "Inspiredesign capture mode: off (default) or deep." },
+      { flag: "--include-prototype-guidance", description: "Include inspiredesign prototype guidance in workflow output." },
       { flag: "--product-url", description: "Target product URL for product-video workflows." },
       { flag: "--product-name", description: "Product name override for product-video workflows." },
       { flag: "--provider-hint", description: "Provider hint override for product workflows." },
@@ -438,7 +437,7 @@ var HELP_CAPABILITY_ENTRIES = [
   },
   {
     label: "desktop observation",
-    description: "Use the public read-only desktop observation plane for sibling desktop evidence on macOS; window inventory and accessibility probes use the local swift command, while screenshots use screencapture outside extension relay.",
+    description: "Use the public read-only desktop observation plane for sibling desktop evidence on macOS; availability, window inventory, and accessibility probes use the local swift command, while screenshots use macOS screencapture outside extension relay.",
     details: [
       {
         label: "cli:",
@@ -452,7 +451,7 @@ var HELP_CAPABILITY_ENTRIES = [
     description: "Control the bounded browser-scoped computer-use challenge lane with --challenge-automation-mode; the optional helper is not a desktop agent.",
     details: [
       { label: "flag:", value: "--challenge-automation-mode off|browser|browser_with_helper" },
-      { label: "works:", value: "research run, shopping run, product-video run, macro-resolve --execute" },
+      { label: "works:", value: "research run, shopping run, product-video run, inspiredesign run, macro-resolve --execute" },
       { label: "entry:", value: onboarding_metadata_default.quickStartCommands.computerUseEntry },
       { label: "proof:", value: "review, session-inspector, workflow fallback metadata" }
     ]
@@ -489,6 +488,16 @@ var HELP_ONBOARDING_ENTRIES = [
     description: "Start deal hunting with explicit providers in managed mode and only trust regional comparisons when the result reports `region_authoritative=true`.",
     details: [{ label: "cli:", value: onboarding_metadata_default.quickStartCommands.validatedShopping }]
   },
+  {
+    label: "inspiredesign_followthrough",
+    description: "After inspiredesign finishes, continue in Canvas with the emitted request template and load the canvas-contract design-agent lane before patching.",
+    details: [
+      { label: "quick:", value: INSPIREDESIGN_HANDOFF_COMMANDS.loadBestPractices },
+      { label: "design:", value: INSPIREDESIGN_HANDOFF_COMMANDS.loadDesignAgent },
+      { label: "prep:", value: INSPIREDESIGN_HANDOFF_GUIDANCE.prepareCanvasPlanRequest },
+      { label: "run:", value: INSPIREDESIGN_HANDOFF_COMMANDS.continueInCanvas }
+    ]
+  },
   {
     label: "computer_use_entry",
     description: "Enter browser-scoped computer use from a workflow run, not from a separate desktop command family.",
@@ -499,6 +508,14 @@ var HELP_ONBOARDING_ENTRIES = [
     description: "After guidance, verify a minimal managed happy path before widening into multi-step automation.",
     details: [{ label: "cli:", value: onboarding_metadata_default.quickStartCommands.happyPath }]
   },
+  {
+    label: "surface_split",
+    description: "Use the existing public-surface split when a workflow or helper only exists on one side of the CLI or tool surface.",
+    details: [
+      { label: "cli-only:", value: getCliOnlyCommands().join(", ") },
+      { label: "tool-only:", value: getToolOnlyHelperNames().join(", ") }
+    ]
+  },
   {
     label: "docs",
     description: "Use the first-run checklist and canonical skill runbook for proof and deeper operating details.",
@@ -510,6 +527,7 @@ var HELP_ONBOARDING_ENTRIES = [
 ];
 var HELP_REFERENCE_ENTRIES = [
   { label: "src/cli/onboarding-metadata.json", description: "Canonical first-contact onboarding metadata shared by help, nudges, and proof lanes." },
+  { label: "src/inspiredesign/handoff.ts", description: "Shared inspiredesign follow-through commands, artifact names, and Canvas continuation guidance." },
   { label: "src/public-surface/source.ts", description: "Authoritative command, usage, flag, and tool surface metadata." },
   { label: "src/public-surface/generated-manifest.ts", description: "Checked-in generated public-surface snapshot consumed by help and parity tests." },
   { label: "src/public-surface/generated-manifest.json", description: "Checked-in generated public-surface snapshot consumed by inventory scripts." },
@@ -519,6 +537,7 @@ var HELP_REFERENCE_ENTRIES = [
   { label: "docs/CLI.md", description: "Detailed CLI guide and release-gate runbooks." },
   { label: onboarding_metadata_default.referencePaths.onboardingDoc, description: "First-run checklist for help-led onboarding and happy-path proof." },
   { label: onboarding_metadata_default.referencePaths.skillDoc, description: "Canonical bundled best-practices runbook and quick-start guidance." },
+  { label: "docs/WORKFLOW_SURFACE_MAP.md", description: "Code-derived workflow and validation inventory, including CLI-only and tool-only surface splits." },
   { label: "docs/SURFACE_REFERENCE.md", description: "Canonical CLI, tool, and relay channel inventory." },
   { label: "opendevbrowser --help", description: "Primary full help invocation for quick discovery." },
   { label: "opendevbrowser help", description: "Alias that prints the same full help inventory." }
@@ -532,14 +551,7 @@ function formatRows(rows) {
     return lines.join("\n");
   }).join("\n");
 }
-function getCommandDescriptions() {
-  const descriptions = /* @__PURE__ */ new Map();
-  for (const definition of listCommands()) {
-    descriptions.set(definition.name, definition.description);
-  }
-  return descriptions;
-}
-function assertCommandCoverage(commandDescriptions) {
+function assertCommandCoverage() {
   const seen = /* @__PURE__ */ new Set();
   for (const group of HELP_COMMAND_GROUPS) {
     for (const command of group.commands) {
@@ -547,13 +559,10 @@ function assertCommandCoverage(commandDescriptions) {
       if (!COMMAND_SET.has(command)) {
         throw new Error(`Help references unknown CLI command: ${command}`);
       }
-      if (!commandDescriptions.has(command)) {
-        throw new Error(`Help references unregistered CLI command: ${command}`);
-      }
       if (seen.has(command)) {
         throw new Error(`Help command appears multiple times: ${command}`);
       }
-      if (!detail || !detail.usage.trim()) {
+      if (!detail || !detail.description.trim() || !detail.usage.trim()) {
         throw new Error(`Missing command help metadata: ${command}`);
       }
       for (const flag of detail.flags) {
@@ -608,13 +617,13 @@ function assertToolCoverage() {
     throw new Error(`Help tool inventory must list ${TOOL_COUNT} tools; got ${HELP_TOOL_ENTRIES.length}`);
   }
 }
-function formatCommandGroups(commandDescriptions) {
+function formatCommandGroups() {
   return HELP_COMMAND_GROUPS.map((group) => {
     const rows = group.commands.map((command) => {
       const detail = COMMAND_HELP_DETAILS[command];
       return {
         label: command,
-        description: commandDescriptions.get(command) ?? "Missing command description.",
+        description: detail.description,
         details: [
           { label: "usage:", value: detail.usage },
           { label: "flags:", value: formatFlags(detail.flags) }
@@ -656,8 +665,7 @@ function formatReferenceEntries() {
   })));
 }
 function getHelpText() {
-  const commandDescriptions = getCommandDescriptions();
-  assertCommandCoverage(commandDescriptions);
+  assertCommandCoverage();
   assertFlagCoverage();
   assertToolCoverage();
   return [
@@ -675,7 +683,7 @@ function getHelpText() {
     formatOnboardingEntries(),
     "",
     `Command Inventory (all ${CLI_COMMANDS.length} commands):`,
-    formatCommandGroups(commandDescriptions),
+    formatCommandGroups(),
     "",
     "Flag Inventory (all supported flags):",
     formatFlagGroups(),
@@ -688,6 +696,15 @@ function getHelpText() {
   ].join("\n");
 }
 
+// src/cli/commands/registry.ts
+var registry = /* @__PURE__ */ new Map();
+function registerCommand(definition) {
+  registry.set(definition.name, definition);
+}
+function getCommand(name) {
+  return registry.get(name);
+}
+
 // src/cli/installers/global.ts
 import * as fs3 from "fs";
 
@@ -964,10 +981,10 @@ function getCodexHomeDir() {
   return process.env.CODEX_HOME || path3.join(os3.homedir(), ".codex");
 }
 function getClaudeCodeHomeDir() {
-  return process.env.CLAUDECODE_HOME || process.env.CLAUDE_HOME || path3.join(os3.homedir(), ".claude");
+  return process.env.CLAUDECODE_HOME || path3.join(os3.homedir(), ".claude");
 }
 function getAmpHomeDir() {
-  return process.env.AMPCLI_HOME || process.env.AMP_CLI_HOME || process.env.AMP_HOME || path3.join(os3.homedir(), ".amp");
+  return process.env.AMP_CLI_HOME || path3.join(os3.homedir(), ".amp");
 }
 function dedupeTargets(targets) {
   const deduped = /* @__PURE__ */ new Map();
@@ -991,9 +1008,7 @@ function getGlobalSkillTargets() {
     { agent: "opencode", dir: getGlobalSkillDir() },
     { agent: "codex", dir: path3.join(getCodexHomeDir(), SKILLS_DIR_NAME) },
     { agent: "claudecode", dir: claudeSkillsDir },
-    { agent: "claude", dir: claudeSkillsDir },
-    { agent: "ampcli", dir: ampSkillsDir },
-    { agent: "amp", dir: ampSkillsDir }
+    { agent: "ampcli", dir: ampSkillsDir }
   ]);
 }
 function getLocalSkillTargets() {
@@ -1003,9 +1018,7 @@ function getLocalSkillTargets() {
     { agent: "opencode", dir: getLocalSkillDir() },
     { agent: "codex", dir: path3.join(process.cwd(), ".codex", SKILLS_DIR_NAME) },
     { agent: "claudecode", dir: localClaudeSkillsDir },
-    { agent: "claude", dir: localClaudeSkillsDir },
-    { agent: "ampcli", dir: localAmpSkillsDir },
-    { agent: "amp", dir: localAmpSkillsDir }
+    { agent: "ampcli", dir: localAmpSkillsDir }
   ]);
 }
 
@@ -1511,6 +1524,29 @@ function parseStringArrayFlag(rawArgs, flag) {
   }
   return items;
 }
+function parseRepeatedStringFlag(rawArgs, flag) {
+  const values = [];
+  for (let index = 0; index < rawArgs.length; index += 1) {
+    const arg = rawArgs[index];
+    if (arg === flag) {
+      const value = rawArgs[index + 1];
+      if (!value) {
+        throw createUsageError(`Missing value for ${flag}`);
+      }
+      values.push(value);
+      index += 1;
+      continue;
+    }
+    if (arg?.startsWith(`${flag}=`)) {
+      const value = arg.split("=", 2)[1];
+      if (!value) {
+        throw createUsageError(`Missing value for ${flag}`);
+      }
+      values.push(value);
+    }
+  }
+  return values.length > 0 ? values : void 0;
+}
 
 // src/cli/commands/native.ts
 import * as fs8 from "fs";
@@ -1919,6 +1955,32 @@ async function resolveExistingDaemon(port, tokens) {
   }
   return null;
 }
+function isPositivePid(value) {
+  return typeof value === "number" && Number.isInteger(value) && value > 0;
+}
+function rememberStalePid(staleDaemonPids, pid) {
+  if (isPositivePid(pid)) {
+    staleDaemonPids.add(pid);
+  }
+}
+async function stopDaemonOnPort(port, token) {
+  try {
+    const response = await fetchWithTimeout(`http://127.0.0.1:${port}/stop`, {
+      method: "POST",
+      headers: { Authorization: `Bearer ${token}` }
+    });
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+async function stopStaleDaemon(port, daemon, staleDaemonPids) {
+  rememberStalePid(staleDaemonPids, daemon.status.pid);
+  const stopped = await stopDaemonOnPort(port, daemon.token);
+  if (!stopped && isPositivePid(daemon.status.pid)) {
+    terminateProcess(daemon.status.pid);
+  }
+}
 function parseServeArgs(rawArgs) {
   const parsed = { stop: false };
   for (let i = 0; i < rawArgs.length; i += 1) {
@@ -2081,27 +2143,34 @@ async function runServe(args) {
   const metadata = readDaemonMetadata();
   const metadataToken = metadata?.port === requestedPort ? metadata.token : void 0;
   const tokenCandidates = resolveTokenCandidates(serveArgs.token, metadataToken, config.daemonToken);
+  const currentFingerprint = getCurrentDaemonFingerprint();
   const existingDaemon = await resolveExistingDaemon(requestedPort, tokenCandidates);
   const staleDaemonPids = new Set(cleanupCompetingServeProcesses(existingDaemon?.status.pid));
   const staleCleared = () => staleDaemonPids.size;
+  let replacedStaleFingerprint = false;
   if (existingDaemon) {
-    const relayPort = existingDaemon.status.relay.port ?? config.relayPort;
-    const clearedCount2 = staleCleared();
-    const staleNote2 = clearedCount2 > 0 ? `
+    const fingerprintMatches = existingDaemon.status.fingerprint === currentFingerprint;
+    if (fingerprintMatches) {
+      const relayPort = existingDaemon.status.relay.port ?? config.relayPort;
+      const clearedCount2 = staleCleared();
+      const staleNote2 = clearedCount2 > 0 ? `
 Cleared ${clearedCount2} stale daemon process${clearedCount2 === 1 ? "" : "es"}.` : "";
-    return {
-      success: true,
-      message: `Daemon already running on 127.0.0.1:${requestedPort} (pid=${existingDaemon.status.pid}, relay ${relayPort}).${staleNote2}`,
-      data: {
-        port: requestedPort,
-        pid: existingDaemon.status.pid,
-        relayPort,
-        alreadyRunning: true,
-        staleDaemonsCleared: clearedCount2,
-        relay: existingDaemon.status.relay
-      },
-      exitCode: null
-    };
+      return {
+        success: true,
+        message: `Daemon already running on 127.0.0.1:${requestedPort} (pid=${existingDaemon.status.pid}, relay ${relayPort}).${staleNote2}`,
+        data: {
+          port: requestedPort,
+          pid: existingDaemon.status.pid,
+          relayPort,
+          alreadyRunning: true,
+          staleDaemonsCleared: clearedCount2,
+          relay: existingDaemon.status.relay
+        },
+        exitCode: null
+      };
+    }
+    await stopStaleDaemon(requestedPort, existingDaemon, staleDaemonPids);
+    replacedStaleFingerprint = true;
   }
   let nativeStatus = getNativeStatusSnapshot();
   let nativeMessage = null;
@@ -2144,23 +2213,31 @@ Cleared ${clearedCount2} stale daemon process${clearedCount2 === 1 ? "" : "es"}.
       }
       const runningDaemon = await resolveExistingDaemon(requestedPort, tokenCandidates);
       if (runningDaemon) {
-        const relayPort = runningDaemon.status.relay.port ?? config.relayPort;
-        const clearedCount2 = staleCleared();
-        const staleNote2 = clearedCount2 > 0 ? `
+        const fingerprintMatches = runningDaemon.status.fingerprint === currentFingerprint;
+        if (fingerprintMatches) {
+          const relayPort = runningDaemon.status.relay.port ?? config.relayPort;
+          const clearedCount2 = staleCleared();
+          const staleNote2 = clearedCount2 > 0 ? `
 Cleared ${clearedCount2} stale daemon process${clearedCount2 === 1 ? "" : "es"}.` : "";
-        return {
-          success: true,
-          message: `Daemon already running on 127.0.0.1:${requestedPort} (pid=${runningDaemon.status.pid}, relay ${relayPort}).${staleNote2}`,
-          data: {
-            port: requestedPort,
-            pid: runningDaemon.status.pid,
-            relayPort,
-            alreadyRunning: true,
-            staleDaemonsCleared: clearedCount2,
-            relay: runningDaemon.status.relay
-          },
-          exitCode: null
-        };
+          return {
+            success: true,
+            message: `Daemon already running on 127.0.0.1:${requestedPort} (pid=${runningDaemon.status.pid}, relay ${relayPort}).${staleNote2}`,
+            data: {
+              port: requestedPort,
+              pid: runningDaemon.status.pid,
+              relayPort,
+              alreadyRunning: true,
+              staleDaemonsCleared: clearedCount2,
+              relay: runningDaemon.status.relay
+            },
+            exitCode: null
+          };
+        }
+        await stopStaleDaemon(requestedPort, runningDaemon, staleDaemonPids);
+        replacedStaleFingerprint = true;
+        if (attempt === 0) {
+          continue;
+        }
       }
       if (attempt === 0) {
         let clearedNewPid = false;
@@ -2199,8 +2276,9 @@ Cleared ${clearedCount2} stale daemon process${clearedCount2 === 1 ? "" : "es"}.
   const clearedCount = staleCleared();
   const staleNote = clearedCount > 0 ? `
 Cleared ${clearedCount} stale daemon process${clearedCount === 1 ? "" : "es"}.` : "";
+  const fingerprintNote = replacedStaleFingerprint ? "\nReplaced stale daemon fingerprint." : "";
   const message = nativeMessage ? `${baseMessage}
-${nativeMessage}${staleNote}` : `${baseMessage}${staleNote}`;
+${nativeMessage}${fingerprintNote}${staleNote}` : `${baseMessage}${fingerprintNote}${staleNote}`;
   return {
     success: true,
     message,
@@ -3600,94 +3678,149 @@ async function runSessionDisconnect(args) {
   return { success: true, message: `Session disconnected: ${sessionId}` };
 }
 
-// src/cli/commands/session/inspector.ts
+// src/cli/utils/workflow-message.ts
+var asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
+var readNonEmptyString = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+var readMeta = (data) => {
+  return asRecord(asRecord(data)?.meta);
+};
+var readPrimaryConstraint = (data) => {
+  const meta = readMeta(data);
+  if (!meta) return null;
+  return asRecord(meta.primaryConstraint);
+};
+var readPrimarySummary = (data) => {
+  const meta = readMeta(data);
+  return readNonEmptyString(meta?.primaryConstraintSummary);
+};
+var readPrimaryNextStep = (data) => {
+  const constraint = readPrimaryConstraint(data);
+  if (!constraint) return null;
+  const guidance = asRecord(constraint.guidance);
+  if (!guidance) return null;
+  const commands = guidance.recommendedNextCommands;
+  if (!Array.isArray(commands)) return null;
+  const nextStep = commands.find((entry) => typeof entry === "string" && entry.trim().length > 0);
+  return nextStep?.trim() ?? null;
+};
+var readFailures = (data) => {
+  const meta = readMeta(data);
+  if (!meta) return [];
+  const failures = meta.failures;
+  return Array.isArray(failures) ? failures.filter((entry) => Boolean(entry) && typeof entry === "object") : [];
+};
+var readFollowthroughSummary = (data) => {
+  const record = asRecord(data);
+  return readNonEmptyString(record?.followthroughSummary) ?? readNonEmptyString(readMeta(data)?.followthroughSummary);
+};
+var readSuggestedSteps = (data) => {
+  const steps = asRecord(data)?.suggestedSteps;
+  return Array.isArray(steps) ? steps.flatMap((step) => {
+    const record = asRecord(step);
+    return record ? [record] : [];
+  }) : [];
+};
+var buildNextStepMessage = (message, nextStep) => {
+  return nextStep ? `${message} Next step: ${nextStep}` : message;
+};
+var readSuggestedNextAction = (data) => {
+  const record = asRecord(data);
+  if (!record) return null;
+  return readNonEmptyString(record.suggestedNextAction) ?? readNonEmptyString(asRecord(record.sessionInspector)?.suggestedNextAction);
+};
+var readSuggestedStepReason = (data) => {
+  let current = asRecord(data);
+  while (current) {
+    const [firstStep] = readSuggestedSteps(current);
+    if (firstStep) {
+      return readNonEmptyString(firstStep.reason);
+    }
+    current = asRecord(current.challengePlan);
+  }
+  return null;
+};
+var buildWorkflowCompletionMessage = (workflowLabel, data) => {
+  const explicitSummary = readPrimarySummary(data);
+  if (explicitSummary) {
+    return buildNextStepMessage(
+      `${workflowLabel} completed with provider follow-up required: ${explicitSummary}`,
+      readPrimaryNextStep(data)
+    );
+  }
+  const inferred = summarizePrimaryProviderIssue(readFailures(data));
+  if (inferred) {
+    return buildNextStepMessage(
+      `${workflowLabel} completed with provider follow-up required: ${inferred.summary}`,
+      inferred.guidance?.recommendedNextCommands[0] ?? null
+    );
+  }
+  const followthroughSummary = readFollowthroughSummary(data);
+  if (followthroughSummary) {
+    return buildNextStepMessage(
+      `${workflowLabel} completed. ${followthroughSummary}`,
+      readSuggestedNextAction(data) ?? readSuggestedStepReason(data)
+    );
+  }
+  return `${workflowLabel} completed.`;
+};
+
+// src/cli/commands/session/inspector-shared.ts
 function parseSessionInspectorArgs(rawArgs) {
   const parsed = {};
   for (let index = 0; index < rawArgs.length; index += 1) {
     const arg = rawArgs[index];
-    if (arg === "--session-id") {
-      const value = rawArgs[index + 1];
-      if (!value) throw createUsageError("Missing value for --session-id");
-      parsed.sessionId = value;
-      index += 1;
-      continue;
-    }
-    if (arg?.startsWith("--session-id=")) {
-      parsed.sessionId = arg.split("=", 2)[1];
-      continue;
-    }
     if (arg === "--include-urls") {
       parsed.includeUrls = true;
       continue;
     }
-    if (arg === "--since-console-seq") {
-      const value = rawArgs[index + 1];
-      if (!value) throw createUsageError("Missing value for --since-console-seq");
-      parsed.sinceConsoleSeq = parseNumberFlag(value, "--since-console-seq", { min: 0 });
-      index += 1;
+    if (arg === "--session-id" || arg?.startsWith("--session-id=")) {
+      parsed.sessionId = readStringFlag(rawArgs, index, "--session-id");
+      index += stepForValue(arg);
       continue;
     }
-    if (arg?.startsWith("--since-console-seq=")) {
-      const value = arg.split("=", 2)[1];
-      if (!value) throw createUsageError("Missing value for --since-console-seq");
-      parsed.sinceConsoleSeq = parseNumberFlag(value, "--since-console-seq", { min: 0 });
+    if (arg === "--since-console-seq" || arg?.startsWith("--since-console-seq=")) {
+      parsed.sinceConsoleSeq = readNumberFlag(rawArgs, index, "--since-console-seq", { min: 0 });
+      index += stepForValue(arg);
       continue;
     }
-    if (arg === "--since-network-seq") {
-      const value = rawArgs[index + 1];
-      if (!value) throw createUsageError("Missing value for --since-network-seq");
-      parsed.sinceNetworkSeq = parseNumberFlag(value, "--since-network-seq", { min: 0 });
-      index += 1;
+    if (arg === "--since-network-seq" || arg?.startsWith("--since-network-seq=")) {
+      parsed.sinceNetworkSeq = readNumberFlag(rawArgs, index, "--since-network-seq", { min: 0 });
+      index += stepForValue(arg);
       continue;
     }
-    if (arg?.startsWith("--since-network-seq=")) {
-      const value = arg.split("=", 2)[1];
-      if (!value) throw createUsageError("Missing value for --since-network-seq");
-      parsed.sinceNetworkSeq = parseNumberFlag(value, "--since-network-seq", { min: 0 });
+    if (arg === "--since-exception-seq" || arg?.startsWith("--since-exception-seq=")) {
+      parsed.sinceExceptionSeq = readNumberFlag(rawArgs, index, "--since-exception-seq", { min: 0 });
+      index += stepForValue(arg);
       continue;
     }
-    if (arg === "--since-exception-seq") {
-      const value = rawArgs[index + 1];
-      if (!value) throw createUsageError("Missing value for --since-exception-seq");
-      parsed.sinceExceptionSeq = parseNumberFlag(value, "--since-exception-seq", { min: 0 });
-      index += 1;
+    if (arg === "--max" || arg?.startsWith("--max=")) {
+      parsed.max = readNumberFlag(rawArgs, index, "--max", { min: 1 });
+      index += stepForValue(arg);
       continue;
     }
-    if (arg?.startsWith("--since-exception-seq=")) {
-      const value = arg.split("=", 2)[1];
-      if (!value) throw createUsageError("Missing value for --since-exception-seq");
-      parsed.sinceExceptionSeq = parseNumberFlag(value, "--since-exception-seq", { min: 0 });
-      continue;
-    }
-    if (arg === "--max") {
-      const value = rawArgs[index + 1];
-      if (!value) throw createUsageError("Missing value for --max");
-      parsed.max = parseNumberFlag(value, "--max", { min: 1 });
-      index += 1;
-      continue;
-    }
-    if (arg?.startsWith("--max=")) {
-      const value = arg.split("=", 2)[1];
-      if (!value) throw createUsageError("Missing value for --max");
-      parsed.max = parseNumberFlag(value, "--max", { min: 1 });
-      continue;
-    }
-    if (arg === "--request-id") {
-      const value = rawArgs[index + 1];
-      if (!value) throw createUsageError("Missing value for --request-id");
-      parsed.requestId = value;
-      index += 1;
-      continue;
-    }
-    if (arg?.startsWith("--request-id=")) {
-      const value = arg.split("=", 2)[1];
-      if (!value) throw createUsageError("Missing value for --request-id");
-      parsed.requestId = value;
-      continue;
+    if (arg === "--request-id" || arg?.startsWith("--request-id=")) {
+      parsed.requestId = readStringFlag(rawArgs, index, "--request-id");
+      index += stepForValue(arg);
     }
   }
   return parsed;
 }
+function stepForValue(flag) {
+  return flag.includes("=") ? 0 : 1;
+}
+function readNumberFlag(rawArgs, index, flag, options) {
+  return parseNumberFlag(readStringFlag(rawArgs, index, flag), flag, options);
+}
+function readStringFlag(rawArgs, index, flag) {
+  const arg = rawArgs[index];
+  const value = arg?.includes("=") ? arg.split("=", 2)[1] : rawArgs[index + 1];
+  if (!value) {
+    throw createUsageError(`Missing value for ${flag}`);
+  }
+  return value;
+}
+
+// src/cli/commands/session/inspector.ts
 async function runSessionInspector(args) {
   const parsed = parseSessionInspectorArgs(args.rawArgs);
   if (!parsed.sessionId) {
@@ -3704,7 +3837,115 @@ async function runSessionInspector(args) {
   });
   return {
     success: true,
-    message: "Session inspector snapshot captured.",
+    message: buildNextStepMessage(
+      "Session inspector snapshot captured.",
+      readSuggestedNextAction(result)
+    ),
+    data: result
+  };
+}
+
+// src/cli/transport-timeouts.ts
+var DEFAULT_CLICK_TRANSPORT_TIMEOUT_MS = 6e4;
+var DEFAULT_DIALOG_TRANSPORT_TIMEOUT_MS = 3e4;
+var DEFAULT_TARGET_CREATION_TRANSPORT_TIMEOUT_MS = 3e4;
+var DEFAULT_SNAPSHOT_TRANSPORT_TIMEOUT_MS = 3e4;
+var DEFAULT_REVIEW_TRANSPORT_TIMEOUT_MS = 3e4;
+var DEFAULT_SCREENSHOT_TRANSPORT_TIMEOUT_MS = 3e4;
+var DEFAULT_WORKFLOW_TRANSPORT_TIMEOUT_MS = 12e4;
+
+// src/cli/commands/challenge-automation-mode.ts
+function parseOptionalChallengeAutomationMode(rawArgs) {
+  const value = parseOptionalStringFlag(rawArgs, "--challenge-automation-mode");
+  if (typeof value === "undefined") {
+    return void 0;
+  }
+  if (!isChallengeAutomationMode(value)) {
+    throw createUsageError(`Invalid --challenge-automation-mode: ${value}`);
+  }
+  return value;
+}
+
+// src/cli/commands/nav/review-shared.ts
+function parseOptionalNumberFlag(rawArgs, flag, options) {
+  const value = parseOptionalStringFlag(rawArgs, flag);
+  return typeof value === "string" ? parseNumberFlag(value, flag, options) : void 0;
+}
+function parseReviewCommandArgs(rawArgs) {
+  return {
+    sessionId: parseOptionalStringFlag(rawArgs, "--session-id"),
+    targetId: parseOptionalStringFlag(rawArgs, "--target-id"),
+    reason: parseOptionalStringFlag(rawArgs, "--reason"),
+    maxChars: parseOptionalNumberFlag(rawArgs, "--max-chars", { min: 1 }),
+    cursor: parseOptionalStringFlag(rawArgs, "--cursor"),
+    timeoutMs: parseOptionalNumberFlag(rawArgs, "--timeout-ms", { min: 1 })
+  };
+}
+
+// src/cli/commands/session/inspector-audit.ts
+function parseOptionalTimeoutMs(rawArgs) {
+  const value = parseOptionalStringFlag(rawArgs, "--timeout-ms");
+  return typeof value === "string" ? parseNumberFlag(value, "--timeout-ms", { min: 1 }) : void 0;
+}
+async function runSessionInspectorAudit(args) {
+  const reviewArgs = parseReviewCommandArgs(args.rawArgs);
+  const inspectorArgs = parseSessionInspectorArgs(args.rawArgs);
+  const challengeAutomationMode = parseOptionalChallengeAutomationMode(args.rawArgs);
+  const timeoutMs = parseOptionalTimeoutMs(args.rawArgs);
+  const sessionId = reviewArgs.sessionId ?? inspectorArgs.sessionId;
+  if (!sessionId) {
+    throw createUsageError("Missing --session-id");
+  }
+  const result = await callDaemon("session.inspectAudit", {
+    sessionId,
+    ...typeof reviewArgs.targetId === "string" ? { targetId: reviewArgs.targetId } : {},
+    ...typeof reviewArgs.reason === "string" ? { reason: reviewArgs.reason } : {},
+    ...typeof reviewArgs.maxChars === "number" ? { maxChars: reviewArgs.maxChars } : {},
+    ...typeof reviewArgs.cursor === "string" ? { cursor: reviewArgs.cursor } : {},
+    ...typeof inspectorArgs.includeUrls === "boolean" ? { includeUrls: inspectorArgs.includeUrls } : {},
+    ...typeof inspectorArgs.sinceConsoleSeq === "number" ? { sinceConsoleSeq: inspectorArgs.sinceConsoleSeq } : {},
+    ...typeof inspectorArgs.sinceNetworkSeq === "number" ? { sinceNetworkSeq: inspectorArgs.sinceNetworkSeq } : {},
+    ...typeof inspectorArgs.sinceExceptionSeq === "number" ? { sinceExceptionSeq: inspectorArgs.sinceExceptionSeq } : {},
+    ...typeof inspectorArgs.max === "number" ? { max: inspectorArgs.max } : {},
+    ...typeof inspectorArgs.requestId === "string" ? { requestId: inspectorArgs.requestId } : {},
+    ...challengeAutomationMode ? { challengeAutomationMode } : {}
+  }, {
+    timeoutMs: timeoutMs ?? DEFAULT_REVIEW_TRANSPORT_TIMEOUT_MS
+  });
+  const nextStep = readSuggestedNextAction(result) ?? readSuggestedStepReason(result);
+  return {
+    success: true,
+    message: buildNextStepMessage("Correlated audit bundle captured.", nextStep),
+    data: result
+  };
+}
+
+// src/cli/commands/session/inspector-plan.ts
+function parseOptionalTimeoutMs2(rawArgs) {
+  const value = parseOptionalStringFlag(rawArgs, "--timeout-ms");
+  return typeof value === "string" ? parseNumberFlag(value, "--timeout-ms", { min: 1 }) : void 0;
+}
+async function runSessionInspectorPlan(args) {
+  const sessionId = parseOptionalStringFlag(args.rawArgs, "--session-id");
+  const targetId = parseOptionalStringFlag(args.rawArgs, "--target-id");
+  const challengeAutomationMode = parseOptionalChallengeAutomationMode(args.rawArgs);
+  const timeoutMs = parseOptionalTimeoutMs2(args.rawArgs);
+  if (!sessionId) {
+    throw createUsageError("Missing --session-id");
+  }
+  const result = await callDaemon("session.inspectPlan", {
+    sessionId,
+    ...typeof targetId === "string" ? { targetId } : {},
+    ...challengeAutomationMode ? { challengeAutomationMode } : {}
+  }, {
+    timeoutMs: timeoutMs ?? DEFAULT_REVIEW_TRANSPORT_TIMEOUT_MS
+  });
+  return {
+    success: true,
+    message: buildNextStepMessage(
+      "Challenge inspect plan captured.",
+      readSuggestedStepReason(result)
+    ),
     data: result
   };
 }
@@ -3811,6 +4052,30 @@ async function runStatus(args) {
   };
 }
 
+// src/cli/commands/status-capabilities.ts
+function parseOptionalTimeoutMs3(rawArgs) {
+  const value = parseOptionalStringFlag(rawArgs, "--timeout-ms");
+  return typeof value === "string" ? parseNumberFlag(value, "--timeout-ms", { min: 1 }) : void 0;
+}
+async function runStatusCapabilities(args) {
+  const sessionId = parseOptionalStringFlag(args.rawArgs, "--session-id");
+  const targetId = parseOptionalStringFlag(args.rawArgs, "--target-id");
+  const challengeAutomationMode = parseOptionalChallengeAutomationMode(args.rawArgs);
+  const timeoutMs = parseOptionalTimeoutMs3(args.rawArgs);
+  const result = await callDaemon("status.capabilities", {
+    ...typeof sessionId === "string" ? { sessionId } : {},
+    ...typeof targetId === "string" ? { targetId } : {},
+    ...challengeAutomationMode ? { challengeAutomationMode } : {}
+  }, {
+    timeoutMs: timeoutMs ?? DEFAULT_REVIEW_TRANSPORT_TIMEOUT_MS
+  });
+  return {
+    success: true,
+    message: "Capability discovery captured.",
+    data: result
+  };
+}
+
 // src/cli/commands/nav/goto.ts
 function parseGotoArgs(rawArgs) {
   const parsed = {};
@@ -3960,15 +4225,6 @@ async function runWait(args) {
   return { success: true, message: "Wait complete.", data: result };
 }
 
-// src/cli/transport-timeouts.ts
-var DEFAULT_CLICK_TRANSPORT_TIMEOUT_MS = 6e4;
-var DEFAULT_DIALOG_TRANSPORT_TIMEOUT_MS = 3e4;
-var DEFAULT_TARGET_CREATION_TRANSPORT_TIMEOUT_MS = 3e4;
-var DEFAULT_SNAPSHOT_TRANSPORT_TIMEOUT_MS = 3e4;
-var DEFAULT_REVIEW_TRANSPORT_TIMEOUT_MS = 3e4;
-var DEFAULT_SCREENSHOT_TRANSPORT_TIMEOUT_MS = 3e4;
-var DEFAULT_WORKFLOW_TRANSPORT_TIMEOUT_MS = 12e4;
-
 // src/cli/commands/nav/snapshot.ts
 function parseSnapshotArgs(rawArgs) {
   const parsed = {};
@@ -4051,61 +4307,8 @@ async function runSnapshot(args) {
 }
 
 // src/cli/commands/nav/review.ts
-function parseReviewArgs(rawArgs) {
-  const parsed = {};
-  for (let i = 0; i < rawArgs.length; i += 1) {
-    const arg = rawArgs[i];
-    if (arg === "--session-id") {
-      const value = rawArgs[i + 1];
-      if (!value) throw createUsageError("Missing value for --session-id");
-      parsed.sessionId = value;
-      i += 1;
-      continue;
-    }
-    if (arg?.startsWith("--session-id=")) {
-      parsed.sessionId = arg.split("=", 2)[1];
-      continue;
-    }
-    if (arg === "--max-chars") {
-      const value = rawArgs[i + 1];
-      if (!value) throw createUsageError("Missing value for --max-chars");
-      parsed.maxChars = Number(value);
-      i += 1;
-      continue;
-    }
-    if (arg?.startsWith("--max-chars=")) {
-      parsed.maxChars = Number(arg.split("=", 2)[1]);
-      continue;
-    }
-    if (arg === "--cursor") {
-      const value = rawArgs[i + 1];
-      if (!value) throw createUsageError("Missing value for --cursor");
-      parsed.cursor = value;
-      i += 1;
-      continue;
-    }
-    if (arg?.startsWith("--cursor=")) {
-      parsed.cursor = arg.split("=", 2)[1];
-      continue;
-    }
-    if (arg === "--timeout-ms") {
-      const value = rawArgs[i + 1];
-      if (!value) throw createUsageError("Missing value for --timeout-ms");
-      parsed.timeoutMs = parseNumberFlag(value, "--timeout-ms", { min: 1 });
-      i += 1;
-      continue;
-    }
-    if (arg?.startsWith("--timeout-ms=")) {
-      const value = arg.split("=", 2)[1];
-      if (!value) throw createUsageError("Missing value for --timeout-ms");
-      parsed.timeoutMs = parseNumberFlag(value, "--timeout-ms", { min: 1 });
-    }
-  }
-  return parsed;
-}
 async function runReview(args) {
-  const { sessionId, maxChars, cursor, timeoutMs } = parseReviewArgs(args.rawArgs);
-  const targetId = parseOptionalStringFlag(args.rawArgs, "--target-id");
+  const { sessionId, targetId, maxChars, cursor, timeoutMs } = parseReviewCommandArgs(args.rawArgs);
   if (!sessionId) throw createUsageError("Missing --session-id");
   const payload = {
     sessionId,
@@ -4119,6 +4322,28 @@ async function runReview(args) {
   return { success: true, message: "Review captured.", data: result };
 }
 
+// src/cli/commands/nav/review-desktop.ts
+async function runReviewDesktop(args) {
+  const { sessionId, targetId, reason, maxChars, cursor, timeoutMs } = parseReviewCommandArgs(args.rawArgs);
+  if (!sessionId) {
+    throw createUsageError("Missing --session-id");
+  }
+  const result = await callDaemon("nav.reviewDesktop", {
+    sessionId,
+    ...typeof targetId === "string" ? { targetId } : {},
+    ...typeof reason === "string" ? { reason } : {},
+    ...typeof maxChars === "number" ? { maxChars } : {},
+    ...typeof cursor === "string" ? { cursor } : {}
+  }, {
+    timeoutMs: timeoutMs ?? DEFAULT_REVIEW_TRANSPORT_TIMEOUT_MS
+  });
+  return {
+    success: true,
+    message: "Desktop-assisted review captured.",
+    data: result
+  };
+}
+
 // src/cli/commands/annotate.ts
 var requireValue2 = (value, flag) => {
   if (!value) throw createUsageError(`Missing value for ${flag}`);
@@ -6660,12 +6885,39 @@ async function runCookieList(args) {
 }
 
 // src/cli/commands/macro-resolve.ts
+var MACRO_TRANSPORT_TIMEOUT_BUFFER_MS = 6e4;
+var deriveMacroTransportTimeoutMs = (timeoutMs) => {
+  return Math.max(
+    DEFAULT_WORKFLOW_TRANSPORT_TIMEOUT_MS,
+    timeoutMs + MACRO_TRANSPORT_TIMEOUT_BUFFER_MS
+  );
+};
 var requireValue7 = (value, flag) => {
   if (!value) {
     throw createUsageError(`Missing value for ${flag}`);
   }
   return value;
 };
+var asRecord2 = (value) => {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  return value;
+};
+var hasExecutionBlocker = (result) => {
+  const execution = asRecord2(asRecord2(result)?.execution);
+  const meta = asRecord2(execution?.meta);
+  return asRecord2(meta?.blocker) !== null;
+};
+var buildMacroResolveMessage = (execute, result) => {
+  if (!execute) {
+    return "Macro resolved.";
+  }
+  if (hasExecutionBlocker(result)) {
+    return "Macro resolved, but execution is blocked and needs follow-up.";
+  }
+  return "Macro resolved and executed.";
+};
 var parseMacroResolveArgs = (rawArgs) => {
   const parsed = {};
   for (let index = 0; index < rawArgs.length; index += 1) {
@@ -6739,44 +6991,16 @@ async function runMacroResolve(args) {
     ...typeof parsed.timeoutMs === "number" ? { timeoutMs: parsed.timeoutMs } : {},
     ...parsed.challengeAutomationMode ? { challengeAutomationMode: parsed.challengeAutomationMode } : {}
   };
-  const result = typeof parsed.timeoutMs === "number" ? await callDaemon("macro.resolve", params, { timeoutMs: parsed.timeoutMs }) : await callDaemon("macro.resolve", params);
+  const result = typeof parsed.timeoutMs === "number" ? await callDaemon("macro.resolve", params, {
+    timeoutMs: deriveMacroTransportTimeoutMs(parsed.timeoutMs)
+  }) : await callDaemon("macro.resolve", params);
   return {
     success: true,
-    message: parsed.execute ? "Macro resolved and executed." : "Macro resolved.",
+    message: buildMacroResolveMessage(parsed.execute ?? false, result),
     data: result
   };
 }
 
-// src/cli/utils/workflow-message.ts
-var readMeta = (data) => {
-  if (!data || typeof data !== "object" || Array.isArray(data)) return null;
-  const meta = data.meta;
-  return meta && typeof meta === "object" && !Array.isArray(meta) ? meta : null;
-};
-var readPrimarySummary = (data) => {
-  const meta = readMeta(data);
-  if (!meta) return null;
-  const summary = meta.primaryConstraintSummary;
-  return typeof summary === "string" && summary.trim().length > 0 ? summary.trim() : null;
-};
-var readFailures = (data) => {
-  const meta = readMeta(data);
-  if (!meta) return [];
-  const failures = meta.failures;
-  return Array.isArray(failures) ? failures.filter((entry) => Boolean(entry) && typeof entry === "object") : [];
-};
-var buildWorkflowCompletionMessage = (workflowLabel, data) => {
-  const explicitSummary = readPrimarySummary(data);
-  if (explicitSummary) {
-    return `${workflowLabel} completed with provider follow-up required: ${explicitSummary}`;
-  }
-  const inferred = summarizePrimaryProviderIssue(readFailures(data));
-  if (inferred) {
-    return `${workflowLabel} completed with provider follow-up required: ${inferred.summary}`;
-  }
-  return `${workflowLabel} completed.`;
-};
-
 // src/cli/commands/research.ts
 var SOURCE_VALUES = /* @__PURE__ */ new Set(["web", "community", "social", "shopping"]);
 var SOURCE_SELECTION_VALUES = /* @__PURE__ */ new Set(["auto", "web", "community", "social", "shopping", "all"]);
@@ -7409,10 +7633,177 @@ async function runProductVideoCommand(args) {
   };
 }
 
+// src/cli/commands/inspiredesign.ts
+var MODE_VALUES3 = /* @__PURE__ */ new Set(["compact", "json", "md", "context", "path"]);
+var CAPTURE_MODE_VALUES = /* @__PURE__ */ new Set(["off", "deep"]);
+var COOKIE_POLICY_VALUES4 = /* @__PURE__ */ new Set(["off", "auto", "required"]);
+var requireValue11 = (rawArgs, index, flag) => {
+  const value = rawArgs[index + 1];
+  if (!value) {
+    throw createUsageError(`Missing value for ${flag}`);
+  }
+  return value;
+};
+var parseInspiredesignRunArgs = (rawArgs) => {
+  const parsed = {
+    brief: parseOptionalStringFlag(rawArgs, "--brief"),
+    urls: parseRepeatedStringFlag(rawArgs, "--url")
+  };
+  for (let index = 0; index < rawArgs.length; index += 1) {
+    const arg = rawArgs[index];
+    if (arg === "--brief" || arg === "--url") {
+      index += 1;
+      continue;
+    }
+    if (arg?.startsWith("--brief=") || arg?.startsWith("--url=")) {
+      continue;
+    }
+    if (arg === "--capture-mode") {
+      const value = requireValue11(rawArgs, index, "--capture-mode").toLowerCase();
+      if (!CAPTURE_MODE_VALUES.has(value)) {
+        throw createUsageError(`Invalid --capture-mode: ${value}`);
+      }
+      parsed.captureMode = value;
+      index += 1;
+      continue;
+    }
+    if (arg?.startsWith("--capture-mode=")) {
+      const value = (arg.split("=", 2)[1] ?? "").toLowerCase();
+      if (!CAPTURE_MODE_VALUES.has(value)) {
+        throw createUsageError(`Invalid --capture-mode: ${value}`);
+      }
+      parsed.captureMode = value;
+      continue;
+    }
+    if (arg === "--include-prototype-guidance") {
+      parsed.includePrototypeGuidance = true;
+      continue;
+    }
+    if (arg?.startsWith("--include-prototype-guidance=")) {
+      parsed.includePrototypeGuidance = parseBooleanFlag(arg.split("=", 2)[1] ?? "", "--include-prototype-guidance");
+      continue;
+    }
+    if (arg === "--mode") {
+      const value = requireValue11(rawArgs, index, "--mode").toLowerCase();
+      if (!MODE_VALUES3.has(value)) {
+        throw createUsageError(`Invalid --mode: ${value}`);
+      }
+      parsed.mode = value;
+      index += 1;
+      continue;
+    }
+    if (arg?.startsWith("--mode=")) {
+      const value = (arg.split("=", 2)[1] ?? "").toLowerCase();
+      if (!MODE_VALUES3.has(value)) {
+        throw createUsageError(`Invalid --mode: ${value}`);
+      }
+      parsed.mode = value;
+      continue;
+    }
+    if (arg === "--timeout-ms") {
+      parsed.timeoutMs = parseNumberFlag(requireValue11(rawArgs, index, "--timeout-ms"), "--timeout-ms", { min: 1 });
+      index += 1;
+      continue;
+    }
+    if (arg?.startsWith("--timeout-ms=")) {
+      parsed.timeoutMs = parseNumberFlag(arg.split("=", 2)[1] ?? "", "--timeout-ms", { min: 1 });
+      continue;
+    }
+    if (arg === "--output-dir") {
+      parsed.outputDir = requireValue11(rawArgs, index, "--output-dir");
+      index += 1;
+      continue;
+    }
+    if (arg?.startsWith("--output-dir=")) {
+      parsed.outputDir = arg.split("=", 2)[1];
+      continue;
+    }
+    if (arg === "--ttl-hours") {
+      parsed.ttlHours = parseNumberFlag(requireValue11(rawArgs, index, "--ttl-hours"), "--ttl-hours", { min: 1, max: 168 });
+      index += 1;
+      continue;
+    }
+    if (arg?.startsWith("--ttl-hours=")) {
+      parsed.ttlHours = parseNumberFlag(arg.split("=", 2)[1] ?? "", "--ttl-hours", { min: 1, max: 168 });
+      continue;
+    }
+    if (arg === "--use-cookies") {
+      parsed.useCookies = true;
+      continue;
+    }
+    if (arg?.startsWith("--use-cookies=")) {
+      parsed.useCookies = parseBooleanFlag(arg.split("=", 2)[1] ?? "", "--use-cookies");
+      continue;
+    }
+    if (arg === "--challenge-automation-mode") {
+      const value = requireValue11(rawArgs, index, "--challenge-automation-mode");
+      if (!isChallengeAutomationMode(value)) {
+        throw createUsageError(`Invalid --challenge-automation-mode: ${value}`);
+      }
+      parsed.challengeAutomationMode = value;
+      index += 1;
+      continue;
+    }
+    if (arg?.startsWith("--challenge-automation-mode=")) {
+      const value = arg.split("=", 2)[1] ?? "";
+      if (!isChallengeAutomationMode(value)) {
+        throw createUsageError(`Invalid --challenge-automation-mode: ${value}`);
+      }
+      parsed.challengeAutomationMode = value;
+      continue;
+    }
+    if (arg === "--cookie-policy-override" || arg === "--cookie-policy") {
+      const value = requireValue11(rawArgs, index, arg).toLowerCase();
+      if (!COOKIE_POLICY_VALUES4.has(value)) {
+        throw createUsageError(`Invalid ${arg}: ${value}`);
+      }
+      parsed.cookiePolicyOverride = value;
+      index += 1;
+      continue;
+    }
+    if (arg?.startsWith("--cookie-policy-override=") || arg?.startsWith("--cookie-policy=")) {
+      const value = (arg.split("=", 2)[1] ?? "").toLowerCase();
+      if (!COOKIE_POLICY_VALUES4.has(value)) {
+        throw createUsageError(`Invalid --cookie-policy-override: ${value}`);
+      }
+      parsed.cookiePolicyOverride = value;
+    }
+  }
+  return parsed;
+};
+async function runInspiredesignCommand(args) {
+  const [subcommand, ...rest] = args.rawArgs;
+  if (subcommand !== "run") {
+    throw createUsageError("Usage: opendevbrowser inspiredesign run --brief <value> [--url <url>] [options]");
+  }
+  const parsed = parseInspiredesignRunArgs(rest);
+  if (!parsed.brief?.trim()) {
+    throw createUsageError("Missing --brief");
+  }
+  const data = await callDaemon("inspiredesign.run", {
+    brief: parsed.brief,
+    urls: parsed.urls,
+    captureMode: parsed.captureMode ?? "off",
+    includePrototypeGuidance: parsed.includePrototypeGuidance,
+    mode: parsed.mode ?? "compact",
+    timeoutMs: parsed.timeoutMs ?? DEFAULT_WORKFLOW_TRANSPORT_TIMEOUT_MS,
+    outputDir: parsed.outputDir,
+    ttlHours: parsed.ttlHours,
+    useCookies: parsed.useCookies,
+    challengeAutomationMode: parsed.challengeAutomationMode,
+    cookiePolicyOverride: parsed.cookiePolicyOverride
+  });
+  return {
+    success: true,
+    message: buildWorkflowCompletionMessage("Inspiredesign workflow", data),
+    data
+  };
+}
+
 // package.json
 var package_default = {
   name: "opendevbrowser",
-  version: "0.0.19",
+  version: "0.0.21",
   description: "Browser automation runtime with snapshot-refs-actions, browser replay screencasts, public read-only desktop observation, and browser-scoped computer-use orchestration",
   type: "module",
   main: "dist/index.js",
@@ -7457,10 +7848,10 @@ var package_default = {
     node: ">=18"
   },
   scripts: {
-    build: "tsup src/index.ts src/cli/index.ts src/skills/skill-loader.ts --format esm --clean --sourcemap && tsc --emitDeclarationOnly --declaration --declarationMap -p tsconfig.json && node scripts/postbuild-dist.mjs",
+    build: "node scripts/run-package-tool.mjs tsup src/index.ts src/cli/index.ts src/skills/skill-loader.ts --format esm --clean --sourcemap && node scripts/run-package-tool.mjs tsc --emitDeclarationOnly --declaration --declarationMap -p tsconfig.json && node scripts/postbuild-dist.mjs",
     dev: "tsup src/index.ts src/cli/index.ts src/skills/skill-loader.ts --format esm --dts --watch",
-    lint: 'eslint "src/**/*.ts" "tests/**/*.ts"',
-    typecheck: "tsc --noEmit -p tsconfig.json",
+    lint: 'node scripts/run-package-tool.mjs eslint "src/**/*.ts" "tests/**/*.ts"',
+    typecheck: "node scripts/run-package-tool.mjs tsc --noEmit -p tsconfig.json",
     test: "node scripts/run-vitest-coverage.mjs",
     "test:release-gate": "node scripts/release-gate-test-groups.mjs",
     "test:release-gate:g1": "node scripts/release-gate-test-groups.mjs --group 1",
@@ -7469,7 +7860,7 @@ var package_default = {
     "test:release-gate:g4": "node scripts/release-gate-test-groups.mjs --group 4",
     "test:release-gate:g5": "node scripts/release-gate-test-groups.mjs --group 5",
     "extension:sync": "node scripts/sync-extension-version.mjs",
-    "extension:build": "npm run extension:sync && tsc -p extension/tsconfig.json && node scripts/copy-extension-assets.mjs",
+    "extension:build": "npm run extension:sync && node scripts/run-package-tool.mjs tsc -p extension/tsconfig.json && node scripts/copy-extension-assets.mjs",
     "extension:pack": "cd extension && zip -r ../opendevbrowser-extension.zip manifest.json popup.html canvas.html dist/ icons/",
     "extension:store": "node scripts/chrome-store-publish.mjs",
     "version:check": "node scripts/verify-versions.mjs",
@@ -7833,11 +8224,26 @@ async function main() {
       description: "Get daemon or session status",
       run: async () => runStatus(args)
     });
+    registerCommand({
+      name: "status-capabilities",
+      description: "Inspect runtime capability discovery for the host and an optional session",
+      run: async () => runStatusCapabilities(args)
+    });
     registerCommand({
       name: "session-inspector",
       description: "Capture a session-first diagnostic summary with relay health and trace proof",
       run: async () => runSessionInspector(args)
     });
+    registerCommand({
+      name: "session-inspector-plan",
+      description: "Inspect browser-scoped computer-use policy and safe suggested steps",
+      run: async () => runSessionInspectorPlan(args)
+    });
+    registerCommand({
+      name: "session-inspector-audit",
+      description: "Capture a correlated audit bundle across desktop evidence, browser review, and policy state",
+      run: async () => runSessionInspectorAudit(args)
+    });
     registerCommand({
       name: "goto",
       description: "Navigate current session to a URL",
@@ -7858,6 +8264,11 @@ async function main() {
       description: "Capture a first-class review payload for the active page",
       run: async () => runReview(args)
     });
+    registerCommand({
+      name: "review-desktop",
+      description: "Capture desktop-assisted browser review with read-only desktop evidence",
+      run: async () => runReviewDesktop(args)
+    });
     registerCommand({
       name: "annotate",
       description: "Request interactive annotations via direct or relay transport",
@@ -8123,6 +8534,11 @@ async function main() {
       description: "Run product presentation asset workflows",
       run: async () => runProductVideoCommand(args)
     });
+    registerCommand({
+      name: "inspiredesign",
+      description: "Run inspiredesign workflows",
+      run: async () => runInspiredesignCommand(args)
+    });
     registerCommand({
       name: "artifacts",
       description: "Manage workflow artifact lifecycle",