npm - opendevbrowser - Versions diffs - 0.0.33 → 0.0.35 - Mend

opendevbrowser 0.0.33 → 0.0.35

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (301) hide show

package/dist/{help-SUI4H77K.js.map → help-QOLCIB3P.js.map} RENAMED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/cli/help.ts"],"sourcesContent":["import onboardingMetadata from \"./onboarding-metadata.json\";\nimport {\n INSPIREDESIGN_HANDOFF_COMMANDS,\n INSPIREDESIGN_HANDOFF_GUIDANCE\n} from \"../inspiredesign/handoff\";\nimport type { CliCommand } from \"./args\";\nimport { CLI_COMMANDS, VALID_FLAGS } from \"./args\";\nimport {\n CLI_COMMAND_HELP_DETAILS,\n PUBLIC_CLI_COMMAND_GROUPS,\n TOOL_SURFACE_ENTRIES\n} from \"../public-surface/generated-manifest\";\n\ntype HelpFlag = (typeof VALID_FLAGS)[number];\n\ninterface CommandGroup {\n title: string;\n summary: string;\n commands: readonly CliCommand[];\n}\n\nexport type CommandHelpDetail = typeof CLI_COMMAND_HELP_DETAILS[CliCommand];\n\ninterface FlagEntry {\n flag: HelpFlag;\n alias?: string;\n description: string;\n example?: string;\n}\n\ninterface FlagGroup {\n title: string;\n summary: string;\n flags: readonly FlagEntry[];\n}\n\ninterface ReferenceEntry {\n label: string;\n description: string;\n}\n\ninterface DetailRow {\n label: string;\n value: string;\n}\n\ninterface FormattableRow {\n label: string;\n description: string;\n details?: readonly DetailRow[];\n}\n\nconst LABEL_WIDTH = 42;\nconst DETAIL_LABEL_WIDTH = 9;\nconst COMMAND_SET = new Set<string>(CLI_COMMANDS);\nconst FLAG_SET = new Set<string>(VALID_FLAGS);\nconst TOOL_COUNT = TOOL_SURFACE_ENTRIES.length;\nconst CLI_EQUIVALENT_SET = new Set(\n TOOL_SURFACE_ENTRIES.flatMap((entry) => (entry.cliEquivalent ? [entry.cliEquivalent] : []))\n);\n\nconst formatFlags = (flags: readonly HelpFlag[]): string => (flags.length > 0 ? flags.join(\", \") : \"none\");\n\nexport const getCliOnlyCommands = (): CliCommand[] => (\n CLI_COMMANDS.filter((command) => !CLI_EQUIVALENT_SET.has(command))\n);\n\nexport const getToolOnlyHelperNames = (): string[] => (\n TOOL_SURFACE_ENTRIES\n .filter((entry) => !entry.cliEquivalent)\n .map((entry) => entry.name)\n);\n\nexport const HELP_COMMAND_GROUPS: readonly CommandGroup[] = PUBLIC_CLI_COMMAND_GROUPS.map((group) => ({\n title: group.title,\n summary: group.summary,\n commands: group.commands.map((command) => command.name) as CliCommand[]\n}));\n\nexport const COMMAND_HELP_DETAILS: Record<CliCommand, CommandHelpDetail> = CLI_COMMAND_HELP_DETAILS as Record<CliCommand, CommandHelpDetail>;\n\nexport const HELP_FLAG_GROUPS: readonly FlagGroup[] = [\n {\n title: \"Install / Global Flags\",\n summary: \"Control install scope, prompting, and bundled skill setup.\",\n flags: [\n { flag: \"--global\", alias: \"-g\", description: \"Install into ~/.config/opencode/opencode.json.\", example: \"npx opendevbrowser --global --with-config\" },\n { flag: \"--local\", alias: \"-l\", description: \"Install into ./opencode.json for this project.\", example: \"npx opendevbrowser --local --skills-local\" },\n { flag: \"--update\", alias: \"-u\", description: \"Repair OpenCode package caches, plugin pins, and managed skill packs.\" },\n { flag: \"--uninstall\", description: \"Alias for the uninstall command.\" },\n { flag: \"--with-config\", description: \"Also create opendevbrowser.jsonc defaults.\", example: \"npx opendevbrowser --global --with-config\" },\n { flag: \"--full\", alias: \"-f\", description: \"Install config and pre-extract extension assets.\", example: \"npx opendevbrowser --full\" },\n { flag: \"--no-prompt\", description: \"Run non-interactively using defaults.\" },\n { flag: \"--no-interactive\", description: \"Alias of --no-prompt.\" },\n { flag: \"--quiet\", description: \"Suppress non-error text output.\" },\n { flag: \"--skills-global\", description: \"Install bundled skills into global agent directories.\" },\n { flag: \"--skills-local\", description: \"Install bundled skills into local project agent directories.\" },\n { flag: \"--no-skills\", description: \"Skip bundled skill installation.\" }\n ]\n },\n {\n title: \"Help / Output Flags\",\n summary: \"Inspect help or version and control output transport.\",\n flags: [\n { flag: \"--help\", alias: \"-h\", description: \"Show CLI help output.\", example: \"npx opendevbrowser --help\" },\n { flag: \"--version\", alias: \"-v\", description: \"Show CLI version.\", example: \"npx opendevbrowser --version\" },\n { flag: \"--output-format\", description: \"Output mode: text, json, or stream-json.\", example: \"opendevbrowser status --daemon --output-format json\" },\n { flag: \"--transport\", description: \"Transport selector for transport-aware commands. `status` uses relay/native; `annotate` uses auto/direct/relay.\", example: \"opendevbrowser status --session-id s1 --transport native\" }\n ]\n },\n {\n title: \"Daemon / Session / Launch Flags\",\n summary: \"Control daemon binding, browser connect, and launch behavior. If ext=on but handshake=off, reopen the extension popup and click Connect again to re-establish a clean daemon-extension handshake.\",\n flags: [\n { flag: \"--port\", description: \"Daemon or relay port override.\", example: \"opendevbrowser serve --port 8788\" },\n { flag: \"--token\", description: \"Relay or daemon auth token override.\", example: \"opendevbrowser serve --token local-dev-token\" },\n { flag: \"--stop\", description: \"Stop a running daemon.\", example: \"opendevbrowser serve --stop\" },\n { flag: \"--daemon\", description: \"Target daemon status mode where supported.\", example: \"opendevbrowser status --daemon --output-format json\" },\n { flag: \"--script\", description: \"Path to a run-script JSON file.\", example: \"opendevbrowser run --script ./workflow.json\" },\n { flag: \"--session-id\", description: \"Target an existing browser or daemon session.\", example: \"opendevbrowser snapshot --session-id s1\" },\n { flag: \"--close-browser\", description: \"Close the managed browser on disconnect.\" },\n { flag: \"--ws-endpoint\", description: \"Connect using an explicit CDP WebSocket endpoint.\", example: \"opendevbrowser connect --ws-endpoint ws://127.0.0.1:9222/devtools/browser/...\" },\n { flag: \"--host\", description: \"CDP host for host/port connect mode.\", example: \"opendevbrowser connect --host 127.0.0.1 --cdp-port 9222\" },\n { flag: \"--cdp-port\", description: \"CDP port for host/port connect mode.\" },\n { flag: \"--headless\", description: \"Launch a managed browser in headless mode.\", example: \"opendevbrowser launch --no-extension --headless\" },\n { flag: \"--profile\", description: \"Use a named browser profile directory.\" },\n { flag: \"--persist-profile\", description: \"Keep the generated profile directory after exit. `run` uses a temporary profile by default unless this flag is enabled.\" },\n { flag: \"--chrome-path\", description: \"Use a specific Chrome, Chromium, or CfT binary.\" },\n { flag: \"--start-url\", description: \"Open this URL immediately after launch or connect.\" },\n { flag: \"--flag\", description: \"Pass one or more extra Chrome CLI flags.\" },\n { flag: \"--no-extension\", description: \"Force managed mode without extension relay.\" },\n { flag: \"--extension-only\", description: \"Fail unless the extension relay websocket is connected and the daemon-extension handshake is complete.\" },\n { flag: \"--extension-legacy\", description: \"Use the legacy /cdp relay mode instead of /ops.\" },\n { flag: \"--wait-for-extension\", description: \"Wait for a clean daemon-extension handshake before returning.\" },\n { flag: \"--wait-timeout-ms\", description: \"Handshake wait timeout in milliseconds.\" }\n ]\n },\n {\n title: \"Navigation / Interaction / Diagnostics Flags\",\n summary: \"Command-specific flags for page actions, reads, and diagnostics.\",\n flags: [\n { flag: \"--url\", description: \"Target URL for navigation, connect, or workflow commands; repeat for multi-reference inspiredesign run or harvest inputs.\", example: \"opendevbrowser goto --session-id s1 --url https://example.com\" },\n { flag: \"--wait-until\", description: \"Navigation wait strategy such as load or domcontentloaded.\" },\n { flag: \"--timeout-ms\", description: \"Operation timeout in milliseconds.\", example: \"opendevbrowser canvas --timeout-ms 120000 --command canvas.session.open ...\" },\n { flag: \"--ref\", description: \"Snapshot ref id for element-targeted commands.\", example: \"opendevbrowser click --session-id s1 --ref r12\" },\n { flag: \"--state\", description: \"Wait state selector for wait-style commands.\" },\n { flag: \"--until\", description: \"Wait condition selector for wait-style commands.\" },\n { flag: \"--mode\", description: \"Mode selector for commands that accept variants.\" },\n { flag: \"--max-chars\", description: \"Maximum text characters to return for DOM reads.\" },\n { flag: \"--cursor\", description: \"Cursor token for paginated list commands.\" },\n { flag: \"--text\", description: \"Text payload for type and related commands.\" },\n { flag: \"--clear\", description: \"Clear the existing input value before typing.\" },\n { flag: \"--submit\", description: \"Submit the form or input after typing.\" },\n { flag: \"--values\", description: \"CSV values for select commands.\" },\n { flag: \"--files\", description: \"CSV file paths for upload commands.\" },\n { flag: \"--dy\", description: \"Vertical scroll delta for scroll commands.\" },\n { flag: \"--key\", description: \"Keyboard key for the press command.\" },\n { flag: \"--attr\", description: \"DOM attribute name for dom-attr.\" },\n { flag: \"--x\", description: \"Viewport x coordinate for pointer commands.\" },\n { flag: \"--y\", description: \"Viewport y coordinate for pointer commands.\" },\n { flag: \"--from-x\", description: \"Pointer drag start x coordinate.\" },\n { flag: \"--from-y\", description: \"Pointer drag start y coordinate.\" },\n { flag: \"--to-x\", description: \"Pointer drag end x coordinate.\" },\n { flag: \"--to-y\", description: \"Pointer drag end y coordinate.\" },\n { flag: \"--steps\", description: \"Interpolation step count for pointer move or drag commands.\" },\n { flag: \"--button\", description: \"Pointer button selector for pointer down or up.\" },\n { flag: \"--click-count\", description: \"Associated click count for pointer down or up.\" },\n { flag: \"--name\", description: \"Named page identifier for page commands.\" },\n { flag: \"--target-id\", description: \"Browser target id for target commands.\", example: \"opendevbrowser target-use --session-id s1 --target-id page-2\" },\n { flag: \"--window-id\", description: \"Desktop window id for direct window capture commands.\" },\n { flag: \"--tab-id\", description: \"Browser tab id override for extension and annotation commands.\" },\n { flag: \"--include-urls\", description: \"Include page URLs in list output where supported.\" },\n { flag: \"--path\", description: \"Filesystem path for command output or artifacts.\", example: \"opendevbrowser screenshot --session-id s1 --path ./shot.png\" },\n { flag: \"--screencast-id\", description: \"Recorded screencast id returned by screencast-start for the same session.\" },\n { flag: \"--reason\", description: \"Audit reason for desktop observation commands.\" },\n { flag: \"--full-page\", description: \"Capture the full scrollable page instead of the current viewport.\" },\n { flag: \"--action\", description: \"Dialog action: status, accept, or dismiss.\" },\n { flag: \"--prompt-text\", description: \"Prompt text to submit when accepting a prompt dialog.\" },\n { flag: \"--since-seq\", description: \"Poll from a sequence id across diagnostics streams.\" },\n { flag: \"--max\", description: \"Maximum number of records or items to return.\" },\n { flag: \"--interval-ms\", description: \"Frame capture interval for screencast recording.\" },\n { flag: \"--max-frames\", description: \"Maximum screencast frame count before auto-stop.\" },\n { flag: \"--since-console-seq\", description: \"Console sequence cursor for debug-trace snapshots.\" },\n { flag: \"--since-network-seq\", description: \"Network sequence cursor for debug-trace snapshots.\" },\n { flag: \"--since-exception-seq\", description: \"Exception sequence cursor for debug-trace snapshots.\" },\n { flag: \"--request-id\", description: \"Attach or lookup a request id for correlated output.\" },\n { flag: \"--cookies\", description: \"Inline cookie payload for cookie-import.\" },\n { flag: \"--cookies-file\", description: \"File path containing cookies for cookie-import.\" },\n { flag: \"--strict\", description: \"Fail cookie import on invalid entries.\" },\n { flag: \"--screenshot-mode\", description: \"Annotation screenshot mode: visible, full, or none.\" },\n { flag: \"--debug\", description: \"Enable debug-level annotation capture extras.\" },\n { flag: \"--context\", description: \"Free-form annotation context for reviewers or agents.\" },\n { flag: \"--stored\", description: \"Return the last stored annotation payload instead of starting a new capture.\" }\n ]\n },\n {\n title: \"Macro / Provider / Power Flags\",\n summary: \"Workflow filters, provider selectors, and unsafe RPC or /canvas options.\",\n flags: [\n { flag: \"--expression\", description: \"Macro expression to resolve or execute.\", example: \"opendevbrowser macro-resolve --expression '@web.search(\\\"openai\\\")'\" },\n { flag: \"--default-provider\", description: \"Provider fallback for shorthand macro expressions.\" },\n { flag: \"--include-catalog\", description: \"Include macro catalog metadata in the response.\" },\n { flag: \"--command\", description: \"Canvas command name for the canvas CLI command.\", example: \"opendevbrowser canvas --command canvas.session.open --params '{...}'\" },\n { flag: \"--execute\", description: \"Execute a resolved macro action after planning.\" },\n { flag: \"--params\", description: \"Inline JSON params for canvas or rpc commands.\" },\n { flag: \"--params-file\", description: \"Path to a JSON params file for canvas or rpc commands.\", example: \"opendevbrowser canvas --command canvas.plan.set --params-file ./plan.json\" },\n { flag: \"--unsafe-internal\", description: \"Required safety gate for the rpc command.\" },\n { flag: \"--topic\", description: \"Research topic input.\" },\n { flag: \"--days\", description: \"Lookback window in days for research commands.\" },\n { flag: \"--from\", description: \"Start date boundary for research commands.\" },\n { flag: \"--to\", description: \"End date boundary for research commands.\" },\n { flag: \"--source-selection\", description: \"Research source-family selector: auto, web, community, social, shopping, or all. This selects families only and is not a reliability guarantee.\" },\n { flag: \"--sources\", description: \"Explicit source-family selectors such as web,community. Use shopping only when commercial intent is explicit.\" },\n { flag: \"--include-engagement\", description: \"Include engagement metrics in research output.\" },\n { flag: \"--limit-per-source\", description: \"Per-source result cap for research runs.\" },\n { flag: \"--query\", description: \"Shopping query input or inspiredesign harvest discovery query.\" },\n { flag: \"--providers\", description: \"Comma-separated provider ids for shopping or artifact commands.\" },\n { flag: \"--provider\", description: \"Repeatable provider id for inspiredesign harvest discovery.\" },\n { flag: \"--max-references\", description: \"Maximum inspiredesign harvest references to keep after explicit URL and query discovery merge.\" },\n { flag: \"--visual-evidence\", description: \"Inspiredesign visual evidence mode: off, auto, or required. Harvest defaults to required.\" },\n { flag: \"--budget\", description: \"Budget filter for shopping workflows.\" },\n { flag: \"--region\", description: \"Region or country hint for provider selection. Treat it as advisory unless output metadata reports `region_authoritative=true`.\" },\n { flag: \"--sort\", description: \"Sort mode for shopping results.\" },\n { flag: \"--brief\", description: \"Inspiredesign brief describing the target design direction.\" },\n { flag: \"--capture-mode\", description: \"Inspiredesign capture mode: off or deep. Any --url forces deep.\" },\n { flag: \"--include-prototype-guidance\", description: \"Include inspiredesign prototype guidance in workflow output.\" },\n { flag: \"--product-url\", description: \"Target product URL for product-video workflows.\" },\n { flag: \"--product-name\", description: \"Product name override for product-video workflows.\" },\n { flag: \"--provider-hint\", description: \"Provider hint override for product workflows.\" },\n { flag: \"--include-screenshots\", description: \"Include screenshots in product presentation output, or prefer screenshots when fetching stored annotations.\" },\n { flag: \"--include-all-images\", description: \"Include all discovered product images.\" },\n { flag: \"--include-copy\", description: \"Include product marketing copy metadata.\" },\n { flag: \"--use-cookies\", description: \"Enable or disable provider cookie injection for workflow runs and macro-resolve execute; a bare flag means true.\", example: \"opendevbrowser macro-resolve --expression '@media.search(\\\"browser automation x\\\", \\\"x\\\", 5)' --execute --browser-mode extension --use-cookies\" },\n { flag: \"--browser-mode\", description: \"Provider browser transport mode: auto, extension, or managed. extension reuses relay-backed browser state; managed runs a deterministic managed browser.\", example: \"opendevbrowser research run --topic 'browser automation on X' --source-selection social --browser-mode extension --use-cookies --challenge-automation-mode browser_with_helper\" },\n { flag: \"--challenge-automation-mode\", description: \"Per-run challenge automation mode for workflow runs and macro-resolve execute: off, browser, or browser_with_helper. Precedence is run > session > config, and the helper remains browser-scoped only.\", example: \"opendevbrowser macro-resolve --expression '@community.search(\\\"openai\\\")' --execute --challenge-automation-mode browser_with_helper\" },\n { flag: \"--cookie-policy-override\", description: \"Per-run workflow and macro-resolve execute cookie policy override: off, auto, or required.\", example: \"opendevbrowser macro-resolve --expression '@community.search(\\\"browser automation failures\\\", 4)' --execute --browser-mode extension --use-cookies --cookie-policy required\" },\n { flag: \"--cookie-policy\", description: \"Alias of --cookie-policy-override.\" },\n { flag: \"--output-dir\", description: \"Directory where generated artifacts are written, including screencast replay output.\" },\n { flag: \"--ttl-hours\", description: \"Artifact cache time-to-live in hours.\" },\n { flag: \"--expired-only\", description: \"List only expired artifacts in artifacts commands.\" }\n ]\n }\n];\n\nexport const HELP_TOOL_ENTRIES = TOOL_SURFACE_ENTRIES;\n\nexport const HELP_CAPABILITY_ENTRIES: readonly FormattableRow[] = [\n {\n label: \"screencast / browser replay\",\n description: \"Use the public browser replay lane when you need temporal browser evidence before or after a fragile flow.\",\n details: [\n { label: \"cli:\", value: \"screencast-start, screencast-stop\" },\n { label: \"example:\", value: \"npx opendevbrowser screencast-start --session-id <id> --output-dir ./artifacts/replay\" }\n ]\n },\n {\n label: \"desktop observation\",\n 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.\",\n details: [\n {\n label: \"cli:\",\n value: \"desktop-status, desktop-windows, desktop-active-window, desktop-capture-desktop, desktop-capture-window, desktop-accessibility-snapshot\"\n },\n { label: \"example:\", value: \"npx opendevbrowser desktop-status --output-format json\" }\n ]\n },\n {\n label: \"computer use / browser-scoped computer use\",\n description: \"Control the bounded browser-scoped computer-use challenge lane with --challenge-automation-mode; the optional helper is not a desktop agent.\",\n details: [\n { label: \"flag:\", value: \"--challenge-automation-mode off\|browser\|browser_with_helper\" },\n { label: \"works:\", value: \"research run, shopping run, product-video run, inspiredesign run, inspiredesign harvest, macro-resolve --execute\" },\n { label: \"entry:\", value: onboardingMetadata.quickStartCommands.computerUseEntry },\n { label: \"proof:\", value: \"review, session-inspector, workflow fallback metadata\" }\n ]\n }\n];\n\nexport const HELP_ONBOARDING_ENTRIES: readonly FormattableRow[] = [\n {\n label: \"prompting_guide\",\n description: \"Load local best-practice guidance before low-level browser commands.\",\n details: [{ label: \"tool:\", value: onboardingMetadata.quickStartCommands.promptingGuide }]\n },\n {\n label: \"skill_load\",\n description: `Load ${onboardingMetadata.skillName} ${onboardingMetadata.skillTopic} directly when you want the canonical quick-start section.`,\n details: [{ label: \"tool:\", value: onboardingMetadata.quickStartCommands.skillLoad }]\n },\n {\n label: \"validated_lanes\",\n description: `Load ${onboardingMetadata.skillName} ${onboardingMetadata.validatedSkillTopic} when you need the current proven transcript, evidence-gated research, and shopping runbook.`,\n details: [{ label: \"tool:\", value: onboardingMetadata.quickStartCommands.validatedLanes }]\n },\n {\n label: \"skill_list\",\n description: \"Inspect bundled and discovered skill packs when you need a different local lane.\",\n details: [{ label: \"tool:\", value: onboardingMetadata.quickStartCommands.skillList }]\n },\n {\n label: \"research_evidence_gated\",\n description: \"Load opendevbrowser-research first, run explicit source-family research, and inspect artifacts before final claims.\",\n details: [{ label: \"cli:\", value: onboardingMetadata.quickStartCommands.validatedResearch }]\n },\n {\n label: \"shopping_reliable\",\n description: \"Start deal hunting with explicit providers in managed mode and only trust regional comparisons when the result reports `region_authoritative=true`.\",\n details: [{ label: \"cli:\", value: onboardingMetadata.quickStartCommands.validatedShopping }]\n },\n {\n label: \"inspiredesign_followthrough\",\n description: \"After inspiredesign finishes, inspect nextStepGuidance.readiness, read required artifacts, and continue in Canvas only when guidance is ready.\",\n details: [\n { label: \"quick:\", value: INSPIREDESIGN_HANDOFF_COMMANDS.loadBestPractices },\n { label: \"design:\", value: INSPIREDESIGN_HANDOFF_COMMANDS.loadDesignAgent },\n { label: \"motion:\", value: INSPIREDESIGN_HANDOFF_COMMANDS.loadMotionDesign },\n { label: \"brief:\", value: INSPIREDESIGN_HANDOFF_GUIDANCE.reviewAdvancedBrief },\n { label: \"gate:\", value: \"Require nextStepGuidance.readiness=ready and no matching doNotProceedIf blockers before Canvas continuation.\" },\n { label: \"prep:\", value: INSPIREDESIGN_HANDOFF_GUIDANCE.prepareCanvasPlanRequest },\n { label: \"run:\", value: INSPIREDESIGN_HANDOFF_COMMANDS.continueInCanvas }\n ]\n },\n {\n label: \"computer_use_entry\",\n description: \"Enter browser-scoped computer use from a workflow run, not from a separate desktop command family.\",\n details: [{ label: \"cli:\", value: onboardingMetadata.quickStartCommands.computerUseEntry }]\n },\n {\n label: \"happy_path\",\n description: \"After guidance, verify a minimal managed happy path before widening into multi-step automation.\",\n details: [{ label: \"cli:\", value: onboardingMetadata.quickStartCommands.happyPath }]\n },\n {\n label: \"surface_split\",\n description: \"Use the existing public-surface split when a workflow or helper only exists on one side of the CLI or tool surface.\",\n details: [\n { label: \"cli-only:\", value: getCliOnlyCommands().join(\", \") },\n { label: \"tool-only:\", value: getToolOnlyHelperNames().join(\", \") }\n ]\n },\n {\n label: \"docs\",\n description: \"Use the first-run checklist and canonical skill runbook for proof and deeper operating details.\",\n details: [{\n label: \"paths:\",\n value: `${onboardingMetadata.referencePaths.onboardingDoc}, ${onboardingMetadata.referencePaths.skillDoc}`\n }]\n }\n];\n\nexport const HELP_REFERENCE_ENTRIES: readonly ReferenceEntry[] = [\n { label: \"src/cli/onboarding-metadata.json\", description: \"Canonical first-contact onboarding metadata shared by help, nudges, and proof lanes.\" },\n { label: \"src/providers/workflow-handoff.ts\", description: \"Central next-step advisory builders for workflow follow-through.\" },\n { label: \"src/inspiredesign/handoff.ts\", description: \"Shared inspiredesign follow-through commands, artifact names, and Canvas continuation guidance.\" },\n { label: \"src/public-surface/source.ts\", description: \"Authoritative command, usage, flag, and tool surface metadata.\" },\n { label: \"src/public-surface/generated-manifest.ts\", description: \"Checked-in generated public-surface snapshot consumed by help and parity tests.\" },\n { label: \"src/public-surface/generated-manifest.json\", description: \"Checked-in generated public-surface snapshot consumed by inventory scripts.\" },\n { label: \"src/cli/args.ts\", description: \"CLI argument parsing backed by the public-surface source.\" },\n { label: \"src/cli/help.ts\", description: \"Human-facing CLI formatting layered on the public-surface source, including the first-contact Find It Fast lookup block.\" },\n { label: \"src/tools/index.ts\", description: \"Code-level tool registry.\" },\n { label: \"docs/CLI.md\", description: \"Detailed CLI guide and release-gate runbooks.\" },\n { label: onboardingMetadata.referencePaths.onboardingDoc, description: \"First-run checklist for help-led onboarding and happy-path proof.\" },\n { label: onboardingMetadata.referencePaths.skillDoc, description: \"Canonical bundled best-practices runbook and quick-start guidance.\" },\n { label: \"docs/WORKFLOW_SURFACE_MAP.md\", description: \"Code-derived workflow and validation inventory, including CLI-only and tool-only surface splits.\" },\n { label: \"docs/SURFACE_REFERENCE.md\", description: \"Canonical CLI, tool, and relay channel inventory.\" },\n { label: \"opendevbrowser --help\", description: \"Primary full help invocation for quick discovery.\" },\n { label: \"opendevbrowser help\", description: \"Alias that prints the same full help inventory.\" }\n];\n\nfunction formatRows(rows: readonly FormattableRow[]): string {\n return rows\n .map((row) => {\n const lines = [` ${row.label.padEnd(LABEL_WIDTH)} ${row.description}`];\n for (const detail of row.details ?? []) {\n lines.push(` ${detail.label.padEnd(DETAIL_LABEL_WIDTH)} ${detail.value}`);\n }\n return lines.join(\"\\n\");\n })\n .join(\"\\n\");\n}\n\nfunction assertCommandCoverage(): void {\n const seen = new Set<string>();\n\n for (const group of HELP_COMMAND_GROUPS) {\n for (const command of group.commands) {\n const detail = COMMAND_HELP_DETAILS[command];\n if (!COMMAND_SET.has(command)) {\n throw new Error(`Help references unknown CLI command: ${command}`);\n }\n if (seen.has(command)) {\n throw new Error(`Help command appears multiple times: ${command}`);\n }\n if (!detail \|\| !detail.description.trim() \|\| !detail.usage.trim()) {\n throw new Error(`Missing command help metadata: ${command}`);\n }\n if (detail.examples.length === 0) {\n throw new Error(`Missing command example metadata: ${command}`);\n }\n for (const flag of detail.flags) {\n if (!FLAG_SET.has(flag)) {\n throw new Error(`Command help metadata references unknown flag ${flag} for ${command}`);\n }\n }\n seen.add(command);\n }\n }\n\n if (seen.size !== CLI_COMMANDS.length) {\n const missing = CLI_COMMANDS.filter((command) => !seen.has(command));\n throw new Error(`Help command coverage mismatch; missing: ${missing.join(\", \")}`);\n }\n}\n\nfunction assertFlagCoverage(): void {\n const seen = new Set<string>();\n\n for (const group of HELP_FLAG_GROUPS) {\n for (const entry of group.flags) {\n if (!FLAG_SET.has(entry.flag)) {\n throw new Error(`Help references unknown CLI flag: ${entry.flag}`);\n }\n if (seen.has(entry.flag)) {\n throw new Error(`Help flag appears multiple times: ${entry.flag}`);\n }\n seen.add(entry.flag);\n }\n }\n\n if (seen.size !== VALID_FLAGS.length) {\n const missing = VALID_FLAGS.filter((flag) => !seen.has(flag));\n throw new Error(`Help flag coverage mismatch; missing: ${missing.join(\", \")}`);\n }\n}\n\nfunction assertToolCoverage(): void {\n const seen = new Set<string>();\n\n for (const entry of HELP_TOOL_ENTRIES) {\n if (!entry.name.startsWith(\"opendevbrowser_\")) {\n throw new Error(`Invalid tool name in help inventory: ${entry.name}`);\n }\n if (!entry.description.trim()) {\n throw new Error(`Help tool is missing a description: ${entry.name}`);\n }\n if (!entry.example?.trim()) {\n throw new Error(`Help tool is missing an example: ${entry.name}`);\n }\n if (seen.has(entry.name)) {\n throw new Error(`Help tool appears multiple times: ${entry.name}`);\n }\n if (entry.cliEquivalent && !COMMAND_SET.has(entry.cliEquivalent)) {\n throw new Error(`Tool metadata references unknown CLI command: ${entry.cliEquivalent}`);\n }\n seen.add(entry.name);\n }\n\n if (HELP_TOOL_ENTRIES.length !== TOOL_COUNT) {\n throw new Error(`Help tool inventory must list ${TOOL_COUNT} tools; got ${HELP_TOOL_ENTRIES.length}`);\n }\n}\n\nfunction formatCommandGroups(): string {\n return HELP_COMMAND_GROUPS\n .map((group) => {\n const rows: FormattableRow[] = group.commands.map((command) => {\n const detail = COMMAND_HELP_DETAILS[command];\n return {\n label: command,\n description: detail.description,\n details: [\n { label: \"usage:\", value: detail.usage },\n { label: \"flags:\", value: formatFlags(detail.flags) },\n ...detail.examples.map((example) => ({ label: \"example:\", value: example })),\n ...detail.notes.map((note) => ({ label: \"note:\", value: note }))\n ]\n };\n });\n return `${group.title}: ${group.summary}\\n${formatRows(rows)}`;\n })\n .join(\"\\n\\n\");\n}\n\nfunction formatFlagGroups(): string {\n return HELP_FLAG_GROUPS\n .map((group) => {\n const rows: FormattableRow[] = group.flags.map((entry) => ({\n label: entry.alias ? `${entry.flag} (${entry.alias})` : entry.flag,\n description: entry.description,\n details: entry.example ? [{ label: \"example:\", value: entry.example }] : []\n }));\n return `${group.title}: ${group.summary}\\n${formatRows(rows)}`;\n })\n .join(\"\\n\\n\");\n}\n\nfunction formatToolEntries(): string {\n return formatRows(HELP_TOOL_ENTRIES.map((entry) => ({\n label: entry.name,\n description: entry.description,\n details: [\n ...(entry.cliEquivalent\n ? [{ label: \"cli:\", value: entry.cliEquivalent }]\n : [{ label: \"scope:\", value: \"tool-only\" }]),\n ...(entry.example ? [{ label: \"example:\", value: entry.example }] : []),\n ...((entry.notes ?? []).map((note) => ({ label: \"note:\", value: note })))\n ]\n })));\n}\n\nfunction formatOnboardingEntries(): string {\n return formatRows(HELP_ONBOARDING_ENTRIES);\n}\n\nfunction formatCapabilityEntries(): string {\n return formatRows(HELP_CAPABILITY_ENTRIES);\n}\n\nfunction formatReferenceEntries(): string {\n return formatRows(HELP_REFERENCE_ENTRIES.map((entry) => ({\n label: entry.label,\n description: entry.description\n })));\n}\n\nexport function getHelpText(): string {\n assertCommandCoverage();\n assertFlagCoverage();\n assertToolCoverage();\n\n return [\n \"OpenDevBrowser CLI\",\n \"\",\n \"Usage:\",\n \" npx opendevbrowser <command> [options]\",\n \"\",\n \"Find It Fast:\",\n \" Use these exact lookup terms when you need replay, desktop evidence, or browser-scoped computer use.\",\n formatCapabilityEntries(),\n \"\",\n `${onboardingMetadata.sectionTitle}:`,\n ` ${onboardingMetadata.sectionSummary}`,\n formatOnboardingEntries(),\n \"\",\n `Command Inventory (all ${CLI_COMMANDS.length} commands):`,\n formatCommandGroups(),\n \"\",\n \"Flag Inventory (all supported flags):\",\n formatFlagGroups(),\n \"\",\n `Tool Inventory (all ${TOOL_COUNT} opendevbrowser_* tools):`,\n formatToolEntries(),\n \"\",\n \"Reference Pointers:\",\n formatReferenceEntries()\n ].join(\"\\n\");\n}\n"],"mappings":"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","names":[]}
1	+ {"version":3,"sources":["../src/cli/help.ts"],"sourcesContent":["import onboardingMetadata from \"./onboarding-metadata.json\";\nimport {\n INSPIREDESIGN_HANDOFF_COMMANDS,\n INSPIREDESIGN_HANDOFF_GUIDANCE\n} from \"../inspiredesign/handoff\";\nimport type { CliCommand } from \"./args\";\nimport { CLI_COMMANDS, VALID_FLAGS } from \"./args\";\nimport {\n CLI_COMMAND_HELP_DETAILS,\n PUBLIC_CLI_COMMAND_GROUPS,\n TOOL_SURFACE_ENTRIES\n} from \"../public-surface/generated-manifest\";\n\ntype HelpFlag = (typeof VALID_FLAGS)[number];\n\ninterface CommandGroup {\n title: string;\n summary: string;\n commands: readonly CliCommand[];\n}\n\nexport type CommandHelpDetail = typeof CLI_COMMAND_HELP_DETAILS[CliCommand];\n\ninterface FlagEntry {\n flag: HelpFlag;\n alias?: string;\n description: string;\n example?: string;\n}\n\ninterface FlagGroup {\n title: string;\n summary: string;\n flags: readonly FlagEntry[];\n}\n\ninterface ReferenceEntry {\n label: string;\n description: string;\n}\n\ninterface DetailRow {\n label: string;\n value: string;\n}\n\ninterface FormattableRow {\n label: string;\n description: string;\n details?: readonly DetailRow[];\n}\n\nconst LABEL_WIDTH = 42;\nconst DETAIL_LABEL_WIDTH = 9;\nconst COMMAND_SET = new Set<string>(CLI_COMMANDS);\nconst FLAG_SET = new Set<string>(VALID_FLAGS);\nconst TOOL_COUNT = TOOL_SURFACE_ENTRIES.length;\nconst CLI_EQUIVALENT_SET = new Set(\n TOOL_SURFACE_ENTRIES.flatMap((entry) => (entry.cliEquivalent ? [entry.cliEquivalent] : []))\n);\n\nconst formatFlags = (flags: readonly HelpFlag[]): string => (flags.length > 0 ? flags.join(\", \") : \"none\");\n\nexport const getCliOnlyCommands = (): CliCommand[] => (\n CLI_COMMANDS.filter((command) => !CLI_EQUIVALENT_SET.has(command))\n);\n\nexport const getToolOnlyHelperNames = (): string[] => (\n TOOL_SURFACE_ENTRIES\n .filter((entry) => !entry.cliEquivalent)\n .map((entry) => entry.name)\n);\n\nexport const HELP_COMMAND_GROUPS: readonly CommandGroup[] = PUBLIC_CLI_COMMAND_GROUPS.map((group) => ({\n title: group.title,\n summary: group.summary,\n commands: group.commands.map((command) => command.name) as CliCommand[]\n}));\n\nexport const COMMAND_HELP_DETAILS: Record<CliCommand, CommandHelpDetail> = CLI_COMMAND_HELP_DETAILS as Record<CliCommand, CommandHelpDetail>;\n\nexport const HELP_FLAG_GROUPS: readonly FlagGroup[] = [\n {\n title: \"Install / Global Flags\",\n summary: \"Control install scope, prompting, and bundled skill setup.\",\n flags: [\n { flag: \"--global\", alias: \"-g\", description: \"Install into ~/.config/opencode/opencode.json.\", example: \"npx opendevbrowser --global --with-config\" },\n { flag: \"--local\", alias: \"-l\", description: \"Install into ./opencode.json for this project.\", example: \"npx opendevbrowser --local --skills-local\" },\n { flag: \"--update\", alias: \"-u\", description: \"Repair OpenCode package caches, plugin pins, and managed skill packs.\" },\n { flag: \"--uninstall\", description: \"Alias for the uninstall command.\" },\n { flag: \"--with-config\", description: \"Also create opendevbrowser.jsonc defaults.\", example: \"npx opendevbrowser --global --with-config\" },\n { flag: \"--full\", alias: \"-f\", description: \"Install config and pre-extract extension assets.\", example: \"npx opendevbrowser --full\" },\n { flag: \"--no-prompt\", description: \"Run non-interactively using defaults.\" },\n { flag: \"--no-interactive\", description: \"Alias of --no-prompt.\" },\n { flag: \"--quiet\", description: \"Suppress non-error text output.\" },\n { flag: \"--skills-global\", description: \"Install bundled skills into global agent directories.\" },\n { flag: \"--skills-local\", description: \"Install bundled skills into local project agent directories.\" },\n { flag: \"--no-skills\", description: \"Skip bundled skill installation.\" }\n ]\n },\n {\n title: \"Help / Output Flags\",\n summary: \"Inspect help or version and control output transport.\",\n flags: [\n { flag: \"--help\", alias: \"-h\", description: \"Show CLI help output.\", example: \"npx opendevbrowser --help\" },\n { flag: \"--version\", alias: \"-v\", description: \"Show CLI version.\", example: \"npx opendevbrowser --version\" },\n { flag: \"--output-format\", description: \"Output mode: text, json, or stream-json.\", example: \"opendevbrowser status --daemon --output-format json\" },\n { flag: \"--transport\", description: \"Transport selector for transport-aware commands. `status` uses relay/native; `annotate` uses auto/direct/relay.\", example: \"opendevbrowser status --session-id s1 --transport native\" }\n ]\n },\n {\n title: \"Daemon / Session / Launch Flags\",\n summary: \"Control daemon binding, browser connect, and launch behavior. If ext=on but handshake=off, reopen the extension popup and click Connect again to re-establish a clean daemon-extension handshake.\",\n flags: [\n { flag: \"--port\", description: \"Daemon or relay port override.\", example: \"opendevbrowser serve --port 8788\" },\n { flag: \"--token\", description: \"Relay or daemon auth token override.\", example: \"opendevbrowser serve --token local-dev-token\" },\n { flag: \"--stop\", description: \"Stop a running daemon.\", example: \"opendevbrowser serve --stop\" },\n { flag: \"--daemon\", description: \"Target daemon status mode where supported.\", example: \"opendevbrowser status --daemon --output-format json\" },\n { flag: \"--script\", description: \"Path to a run-script JSON file.\", example: \"opendevbrowser run --script ./workflow.json\" },\n { flag: \"--session-id\", description: \"Target an existing browser or daemon session.\", example: \"opendevbrowser snapshot --session-id s1\" },\n { flag: \"--close-browser\", description: \"Close the managed browser on disconnect.\" },\n { flag: \"--ws-endpoint\", description: \"Connect using an explicit CDP WebSocket endpoint.\", example: \"opendevbrowser connect --ws-endpoint ws://127.0.0.1:9222/devtools/browser/...\" },\n { flag: \"--host\", description: \"CDP host for host/port connect mode.\", example: \"opendevbrowser connect --host 127.0.0.1 --cdp-port 9222\" },\n { flag: \"--cdp-port\", description: \"CDP port for host/port connect mode.\" },\n { flag: \"--headless\", description: \"Launch a managed browser in headless mode.\", example: \"opendevbrowser launch --no-extension --headless\" },\n { flag: \"--profile\", description: \"Use a named browser profile directory.\" },\n { flag: \"--persist-profile\", description: \"Keep the generated profile directory after exit. `run` uses a temporary profile by default unless this flag is enabled.\" },\n { flag: \"--chrome-path\", description: \"Use a specific Chrome, Chromium, or CfT binary.\" },\n { flag: \"--start-url\", description: \"Open this URL immediately after launch or connect.\" },\n { flag: \"--flag\", description: \"Pass one or more extra Chrome CLI flags.\" },\n { flag: \"--no-extension\", description: \"Force managed mode without extension relay.\" },\n { flag: \"--extension-only\", description: \"Fail unless the extension relay websocket is connected and the daemon-extension handshake is complete.\" },\n { flag: \"--extension-legacy\", description: \"Use the legacy /cdp relay mode instead of /ops.\" },\n { flag: \"--wait-for-extension\", description: \"Wait for a clean daemon-extension handshake before returning.\" },\n { flag: \"--wait-timeout-ms\", description: \"Handshake wait timeout in milliseconds.\" }\n ]\n },\n {\n title: \"Navigation / Interaction / Diagnostics Flags\",\n summary: \"Command-specific flags for page actions, reads, and diagnostics.\",\n flags: [\n { flag: \"--url\", description: \"Target URL for navigation, connect, or workflow commands; repeat for multi-reference inspiredesign run or harvest inputs.\", example: \"opendevbrowser goto --session-id s1 --url https://example.com\" },\n { flag: \"--wait-until\", description: \"Navigation wait strategy such as load or domcontentloaded.\" },\n { flag: \"--timeout-ms\", description: \"Operation timeout in milliseconds.\", example: \"opendevbrowser canvas --timeout-ms 120000 --command canvas.session.open ...\" },\n { flag: \"--ref\", description: \"Snapshot ref id for element-targeted commands.\", example: \"opendevbrowser click --session-id s1 --ref r12\" },\n { flag: \"--state\", description: \"Wait state selector for wait-style commands.\" },\n { flag: \"--until\", description: \"Wait condition selector for wait-style commands.\" },\n { flag: \"--mode\", description: \"Mode selector for commands that accept variants.\" },\n { flag: \"--max-chars\", description: \"Maximum text characters to return for DOM reads.\" },\n { flag: \"--cursor\", description: \"Cursor token for paginated list commands.\" },\n { flag: \"--text\", description: \"Text payload for type and related commands.\" },\n { flag: \"--clear\", description: \"Clear the existing input value before typing.\" },\n { flag: \"--submit\", description: \"Submit the form or input after typing.\" },\n { flag: \"--values\", description: \"CSV values for select commands.\" },\n { flag: \"--files\", description: \"CSV file paths for upload commands.\" },\n { flag: \"--dy\", description: \"Vertical scroll delta for scroll commands.\" },\n { flag: \"--key\", description: \"Keyboard key for the press command.\" },\n { flag: \"--attr\", description: \"DOM attribute name for dom-attr.\" },\n { flag: \"--x\", description: \"Viewport x coordinate for pointer commands.\" },\n { flag: \"--y\", description: \"Viewport y coordinate for pointer commands.\" },\n { flag: \"--from-x\", description: \"Pointer drag start x coordinate.\" },\n { flag: \"--from-y\", description: \"Pointer drag start y coordinate.\" },\n { flag: \"--to-x\", description: \"Pointer drag end x coordinate.\" },\n { flag: \"--to-y\", description: \"Pointer drag end y coordinate.\" },\n { flag: \"--steps\", description: \"Interpolation step count for pointer move or drag commands.\" },\n { flag: \"--button\", description: \"Pointer button selector for pointer down or up.\" },\n { flag: \"--click-count\", description: \"Associated click count for pointer down or up.\" },\n { flag: \"--name\", description: \"Named page identifier for page commands.\" },\n { flag: \"--target-id\", description: \"Browser target id for target commands.\", example: \"opendevbrowser target-use --session-id s1 --target-id page-2\" },\n { flag: \"--window-id\", description: \"Desktop window id for direct window capture commands.\" },\n { flag: \"--tab-id\", description: \"Browser tab id override for extension and annotation commands.\" },\n { flag: \"--include-urls\", description: \"Include page URLs in list output where supported.\" },\n { flag: \"--path\", description: \"Filesystem path for command output or artifacts.\", example: \"opendevbrowser screenshot --session-id s1 --path ./shot.png\" },\n { flag: \"--screencast-id\", description: \"Recorded screencast id returned by screencast-start for the same session.\" },\n { flag: \"--reason\", description: \"Audit reason for desktop observation commands.\" },\n { flag: \"--full-page\", description: \"Capture the full scrollable page instead of the current viewport.\" },\n { flag: \"--action\", description: \"Dialog action: status, accept, or dismiss.\" },\n { flag: \"--prompt-text\", description: \"Prompt text to submit when accepting a prompt dialog.\" },\n { flag: \"--since-seq\", description: \"Poll from a sequence id across diagnostics streams.\" },\n { flag: \"--max\", description: \"Maximum number of records or items to return.\" },\n { flag: \"--interval-ms\", description: \"Frame capture interval for screencast recording.\" },\n { flag: \"--max-frames\", description: \"Maximum screencast frame count before auto-stop.\" },\n { flag: \"--since-console-seq\", description: \"Console sequence cursor for debug-trace snapshots.\" },\n { flag: \"--since-network-seq\", description: \"Network sequence cursor for debug-trace snapshots.\" },\n { flag: \"--since-exception-seq\", description: \"Exception sequence cursor for debug-trace snapshots.\" },\n { flag: \"--request-id\", description: \"Attach or lookup a request id for correlated output.\" },\n { flag: \"--cookies\", description: \"Inline cookie payload for cookie-import.\" },\n { flag: \"--cookies-file\", description: \"File path containing cookies for cookie-import.\" },\n { flag: \"--strict\", description: \"Fail cookie import on invalid entries.\" },\n { flag: \"--screenshot-mode\", description: \"Annotation screenshot mode: visible, full, or none.\" },\n { flag: \"--debug\", description: \"Enable debug-level annotation capture extras.\" },\n { flag: \"--context\", description: \"Free-form annotation context for reviewers or agents.\" },\n { flag: \"--stored\", description: \"Return the last stored annotation payload instead of starting a new capture.\" }\n ]\n },\n {\n title: \"Macro / Provider / Power Flags\",\n summary: \"Workflow filters, provider selectors, and unsafe RPC or /canvas options.\",\n flags: [\n { flag: \"--expression\", description: \"Macro expression to resolve or execute.\", example: \"opendevbrowser macro-resolve --expression '@web.search(\\\"openai\\\")'\" },\n { flag: \"--default-provider\", description: \"Provider fallback for shorthand macro expressions.\" },\n { flag: \"--include-catalog\", description: \"Include macro catalog metadata in the response.\" },\n { flag: \"--command\", description: \"Canvas command name for the canvas CLI command.\", example: \"opendevbrowser canvas --command canvas.session.open --params '{...}'\" },\n { flag: \"--execute\", description: \"Execute a resolved macro action after planning.\" },\n { flag: \"--params\", description: \"Inline JSON params for canvas or rpc commands.\" },\n { flag: \"--params-file\", description: \"Path to a JSON params file for canvas or rpc commands.\", example: \"opendevbrowser canvas --command canvas.plan.set --params-file ./plan.json\" },\n { flag: \"--unsafe-internal\", description: \"Required safety gate for the rpc command.\" },\n { flag: \"--topic\", description: \"Research topic input.\" },\n { flag: \"--days\", description: \"Lookback window in days for research commands.\" },\n { flag: \"--from\", description: \"Start date boundary for research commands.\" },\n { flag: \"--to\", description: \"End date boundary for research commands.\" },\n { flag: \"--source-selection\", description: \"Research source-family selector: auto, web, community, social, shopping, or all. This selects families only and is not a reliability guarantee.\" },\n { flag: \"--sources\", description: \"Explicit source-family selectors such as web,community. Use shopping only when commercial intent is explicit.\" },\n { flag: \"--include-engagement\", description: \"Include engagement metrics in research output.\" },\n { flag: \"--limit-per-source\", description: \"Per-source result cap for research runs.\" },\n { flag: \"--query\", description: \"Shopping query input or inspiredesign harvest discovery query.\" },\n { flag: \"--providers\", description: \"Comma-separated provider ids for shopping or artifact commands.\" },\n { flag: \"--provider\", description: \"Repeatable provider id for inspiredesign harvest discovery.\" },\n { flag: \"--max-references\", description: \"Maximum inspiredesign harvest references to keep after explicit URL and query discovery merge.\" },\n { flag: \"--visual-evidence\", description: \"Inspiredesign visual evidence mode: off, auto, or required. Harvest defaults to required.\" },\n { flag: \"--budget\", description: \"Budget filter for shopping workflows.\" },\n { flag: \"--region\", description: \"Region or country hint for provider selection. Treat it as advisory unless output metadata reports `region_authoritative=true`.\" },\n { flag: \"--sort\", description: \"Sort mode for shopping results.\" },\n { flag: \"--brief\", description: \"Inspiredesign brief describing the target design direction.\" },\n { flag: \"--capture-mode\", description: \"Inspiredesign capture mode: off or deep. Run URLs force deep capture; harvest non-Pinterest URLs force deep capture; Pinterest harvest disables deep diagnostics and relies on extension preloading plus manifest-backed canonical pin-media evidence.\" },\n { flag: \"--include-prototype-guidance\", description: \"Include inspiredesign prototype guidance in workflow output.\" },\n { flag: \"--product-url\", description: \"Target product URL for product-video workflows.\" },\n { flag: \"--product-name\", description: \"Product name override for product-video workflows.\" },\n { flag: \"--provider-hint\", description: \"Provider hint override for product workflows.\" },\n { flag: \"--include-screenshots\", description: \"Include screenshots in product presentation output, or prefer screenshots when fetching stored annotations.\" },\n { flag: \"--include-all-images\", description: \"Include all discovered product images.\" },\n { flag: \"--include-copy\", description: \"Include product marketing copy metadata.\" },\n { flag: \"--use-cookies\", description: \"Enable or disable provider cookie injection for workflow runs and macro-resolve execute; a bare flag means true.\", example: \"opendevbrowser macro-resolve --expression '@media.search(\\\"browser automation x\\\", \\\"x\\\", 5)' --execute --browser-mode extension --use-cookies\" },\n { flag: \"--browser-mode\", description: \"Provider browser transport mode: auto, extension, or managed. extension reuses relay-backed browser state; managed runs a deterministic managed browser.\", example: \"opendevbrowser research run --topic 'browser automation on X' --source-selection social --browser-mode extension --use-cookies --challenge-automation-mode browser_with_helper\" },\n { flag: \"--challenge-automation-mode\", description: \"Per-run challenge automation mode for workflow runs and macro-resolve execute: off, browser, or browser_with_helper. Precedence is run > session > config, and the helper remains browser-scoped only.\", example: \"opendevbrowser macro-resolve --expression '@community.search(\\\"openai\\\")' --execute --challenge-automation-mode browser_with_helper\" },\n { flag: \"--cookie-policy-override\", description: \"Per-run workflow and macro-resolve execute cookie policy override: off, auto, or required.\", example: \"opendevbrowser macro-resolve --expression '@community.search(\\\"browser automation failures\\\", 4)' --execute --browser-mode extension --use-cookies --cookie-policy required\" },\n { flag: \"--cookie-policy\", description: \"Alias of --cookie-policy-override.\" },\n { flag: \"--output-dir\", description: \"Directory where generated artifacts are written, including screencast replay output.\" },\n { flag: \"--ttl-hours\", description: \"Artifact cache time-to-live in hours.\" },\n { flag: \"--expired-only\", description: \"List only expired artifacts in artifacts commands.\" }\n ]\n }\n];\n\nexport const HELP_TOOL_ENTRIES = TOOL_SURFACE_ENTRIES;\n\nexport const HELP_CAPABILITY_ENTRIES: readonly FormattableRow[] = [\n {\n label: \"screencast / browser replay\",\n description: \"Use the public browser replay lane when you need temporal browser evidence before or after a fragile flow.\",\n details: [\n { label: \"cli:\", value: \"screencast-start, screencast-stop\" },\n { label: \"example:\", value: \"npx opendevbrowser screencast-start --session-id <id> --output-dir ./artifacts/replay\" }\n ]\n },\n {\n label: \"desktop observation\",\n 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.\",\n details: [\n {\n label: \"cli:\",\n value: \"desktop-status, desktop-windows, desktop-active-window, desktop-capture-desktop, desktop-capture-window, desktop-accessibility-snapshot\"\n },\n { label: \"example:\", value: \"npx opendevbrowser desktop-status --output-format json\" }\n ]\n },\n {\n label: \"computer use / browser-scoped computer use\",\n description: \"Control the bounded browser-scoped computer-use challenge lane with --challenge-automation-mode; the optional helper is not a desktop agent.\",\n details: [\n { label: \"flag:\", value: \"--challenge-automation-mode off\|browser\|browser_with_helper\" },\n { label: \"works:\", value: \"research run, shopping run, product-video run, inspiredesign run, inspiredesign harvest, macro-resolve --execute\" },\n { label: \"entry:\", value: onboardingMetadata.quickStartCommands.computerUseEntry },\n { label: \"proof:\", value: \"review, session-inspector, workflow fallback metadata\" }\n ]\n }\n];\n\nexport const HELP_ONBOARDING_ENTRIES: readonly FormattableRow[] = [\n {\n label: \"prompting_guide\",\n description: \"Load local best-practice guidance before low-level browser commands.\",\n details: [{ label: \"tool:\", value: onboardingMetadata.quickStartCommands.promptingGuide }]\n },\n {\n label: \"skill_load\",\n description: `Load ${onboardingMetadata.skillName} ${onboardingMetadata.skillTopic} directly when you want the canonical quick-start section.`,\n details: [{ label: \"tool:\", value: onboardingMetadata.quickStartCommands.skillLoad }]\n },\n {\n label: \"validated_lanes\",\n description: `Load ${onboardingMetadata.skillName} ${onboardingMetadata.validatedSkillTopic} when you need the current proven transcript, evidence-gated research, and shopping runbook.`,\n details: [{ label: \"tool:\", value: onboardingMetadata.quickStartCommands.validatedLanes }]\n },\n {\n label: \"skill_list\",\n description: \"Inspect bundled and discovered skill packs when you need a different local lane.\",\n details: [{ label: \"tool:\", value: onboardingMetadata.quickStartCommands.skillList }]\n },\n {\n label: \"research_evidence_gated\",\n description: \"Load opendevbrowser-research first, run explicit source-family research, and inspect artifacts before final claims.\",\n details: [{ label: \"cli:\", value: onboardingMetadata.quickStartCommands.validatedResearch }]\n },\n {\n label: \"shopping_reliable\",\n description: \"Start deal hunting with explicit providers in managed mode and only trust regional comparisons when the result reports `region_authoritative=true`.\",\n details: [{ label: \"cli:\", value: onboardingMetadata.quickStartCommands.validatedShopping }]\n },\n {\n label: \"inspiredesign_followthrough\",\n description: \"After inspiredesign finishes, inspect nextStepGuidance.readiness, ranked references, and screenshot, screencast, or pin-media readiness evidence before Canvas.\",\n details: [\n { label: \"quick:\", value: INSPIREDESIGN_HANDOFF_COMMANDS.loadBestPractices },\n { label: \"design:\", value: INSPIREDESIGN_HANDOFF_COMMANDS.loadDesignAgent },\n { label: \"motion:\", value: INSPIREDESIGN_HANDOFF_COMMANDS.loadMotionDesign },\n { label: \"brief:\", value: INSPIREDESIGN_HANDOFF_GUIDANCE.reviewAdvancedBrief },\n { label: \"gate:\", value: \"Require nextStepGuidance.readiness=ready, non-empty ranked references, no matching doNotProceedIf blockers, and Pinterest snapshot_ready, motion_ready, or pin_media_ready manifest-backed evidence before Canvas continuation.\" },\n { label: \"media:\", value: \"Treat media-analysis.json as design facts only; it never grants readiness authority and raw media-analysis fields must not enter canvas-plan.request.json.\" },\n { label: \"prep:\", value: INSPIREDESIGN_HANDOFF_GUIDANCE.prepareCanvasPlanRequest },\n { label: \"run:\", value: INSPIREDESIGN_HANDOFF_COMMANDS.continueInCanvas }\n ]\n },\n {\n label: \"computer_use_entry\",\n description: \"Enter browser-scoped computer use from a workflow run, not from a separate desktop command family.\",\n details: [{ label: \"cli:\", value: onboardingMetadata.quickStartCommands.computerUseEntry }]\n },\n {\n label: \"happy_path\",\n description: \"After guidance, verify a minimal managed happy path before widening into multi-step automation.\",\n details: [{ label: \"cli:\", value: onboardingMetadata.quickStartCommands.happyPath }]\n },\n {\n label: \"surface_split\",\n description: \"Use the existing public-surface split when a workflow or helper only exists on one side of the CLI or tool surface.\",\n details: [\n { label: \"cli-only:\", value: getCliOnlyCommands().join(\", \") },\n { label: \"tool-only:\", value: getToolOnlyHelperNames().join(\", \") }\n ]\n },\n {\n label: \"docs\",\n description: \"Use the first-run checklist and canonical skill runbook for proof and deeper operating details.\",\n details: [{\n label: \"paths:\",\n value: `${onboardingMetadata.referencePaths.onboardingDoc}, ${onboardingMetadata.referencePaths.skillDoc}`\n }]\n }\n];\n\nexport const HELP_REFERENCE_ENTRIES: readonly ReferenceEntry[] = [\n { label: \"src/cli/onboarding-metadata.json\", description: \"Canonical first-contact onboarding metadata shared by help, nudges, and proof lanes.\" },\n { label: \"src/providers/workflow-handoff.ts\", description: \"Central next-step advisory builders for workflow follow-through.\" },\n { label: \"src/inspiredesign/handoff.ts\", description: \"Shared inspiredesign follow-through commands, artifact names, and Canvas continuation guidance.\" },\n { label: \"src/public-surface/source.ts\", description: \"Authoritative command, usage, flag, and tool surface metadata.\" },\n { label: \"src/public-surface/generated-manifest.ts\", description: \"Checked-in generated public-surface snapshot consumed by help and parity tests.\" },\n { label: \"src/public-surface/generated-manifest.json\", description: \"Checked-in generated public-surface snapshot consumed by inventory scripts.\" },\n { label: \"src/cli/args.ts\", description: \"CLI argument parsing backed by the public-surface source.\" },\n { label: \"src/cli/help.ts\", description: \"Human-facing CLI formatting layered on the public-surface source, including the first-contact Find It Fast lookup block.\" },\n { label: \"src/tools/index.ts\", description: \"Code-level tool registry.\" },\n { label: \"docs/CLI.md\", description: \"Detailed CLI guide and release-gate runbooks.\" },\n { label: onboardingMetadata.referencePaths.onboardingDoc, description: \"First-run checklist for help-led onboarding and happy-path proof.\" },\n { label: onboardingMetadata.referencePaths.skillDoc, description: \"Canonical bundled best-practices runbook and quick-start guidance.\" },\n { label: \"docs/WORKFLOW_SURFACE_MAP.md\", description: \"Code-derived workflow and validation inventory, including CLI-only and tool-only surface splits.\" },\n { label: \"docs/SURFACE_REFERENCE.md\", description: \"Canonical CLI, tool, and relay channel inventory.\" },\n { label: \"opendevbrowser --help\", description: \"Primary full help invocation for quick discovery.\" },\n { label: \"opendevbrowser help\", description: \"Alias that prints the same full help inventory.\" }\n];\n\nfunction formatRows(rows: readonly FormattableRow[]): string {\n return rows\n .map((row) => {\n const lines = [` ${row.label.padEnd(LABEL_WIDTH)} ${row.description}`];\n for (const detail of row.details ?? []) {\n lines.push(` ${detail.label.padEnd(DETAIL_LABEL_WIDTH)} ${detail.value}`);\n }\n return lines.join(\"\\n\");\n })\n .join(\"\\n\");\n}\n\nfunction assertCommandCoverage(): void {\n const seen = new Set<string>();\n\n for (const group of HELP_COMMAND_GROUPS) {\n for (const command of group.commands) {\n const detail = COMMAND_HELP_DETAILS[command];\n if (!COMMAND_SET.has(command)) {\n throw new Error(`Help references unknown CLI command: ${command}`);\n }\n if (seen.has(command)) {\n throw new Error(`Help command appears multiple times: ${command}`);\n }\n if (!detail \|\| !detail.description.trim() \|\| !detail.usage.trim()) {\n throw new Error(`Missing command help metadata: ${command}`);\n }\n if (detail.examples.length === 0) {\n throw new Error(`Missing command example metadata: ${command}`);\n }\n for (const flag of detail.flags) {\n if (!FLAG_SET.has(flag)) {\n throw new Error(`Command help metadata references unknown flag ${flag} for ${command}`);\n }\n }\n seen.add(command);\n }\n }\n\n if (seen.size !== CLI_COMMANDS.length) {\n const missing = CLI_COMMANDS.filter((command) => !seen.has(command));\n throw new Error(`Help command coverage mismatch; missing: ${missing.join(\", \")}`);\n }\n}\n\nfunction assertFlagCoverage(): void {\n const seen = new Set<string>();\n\n for (const group of HELP_FLAG_GROUPS) {\n for (const entry of group.flags) {\n if (!FLAG_SET.has(entry.flag)) {\n throw new Error(`Help references unknown CLI flag: ${entry.flag}`);\n }\n if (seen.has(entry.flag)) {\n throw new Error(`Help flag appears multiple times: ${entry.flag}`);\n }\n seen.add(entry.flag);\n }\n }\n\n if (seen.size !== VALID_FLAGS.length) {\n const missing = VALID_FLAGS.filter((flag) => !seen.has(flag));\n throw new Error(`Help flag coverage mismatch; missing: ${missing.join(\", \")}`);\n }\n}\n\nfunction assertToolCoverage(): void {\n const seen = new Set<string>();\n\n for (const entry of HELP_TOOL_ENTRIES) {\n if (!entry.name.startsWith(\"opendevbrowser_\")) {\n throw new Error(`Invalid tool name in help inventory: ${entry.name}`);\n }\n if (!entry.description.trim()) {\n throw new Error(`Help tool is missing a description: ${entry.name}`);\n }\n if (!entry.example?.trim()) {\n throw new Error(`Help tool is missing an example: ${entry.name}`);\n }\n if (seen.has(entry.name)) {\n throw new Error(`Help tool appears multiple times: ${entry.name}`);\n }\n if (entry.cliEquivalent && !COMMAND_SET.has(entry.cliEquivalent)) {\n throw new Error(`Tool metadata references unknown CLI command: ${entry.cliEquivalent}`);\n }\n seen.add(entry.name);\n }\n\n if (HELP_TOOL_ENTRIES.length !== TOOL_COUNT) {\n throw new Error(`Help tool inventory must list ${TOOL_COUNT} tools; got ${HELP_TOOL_ENTRIES.length}`);\n }\n}\n\nfunction formatCommandGroups(): string {\n return HELP_COMMAND_GROUPS\n .map((group) => {\n const rows: FormattableRow[] = group.commands.map((command) => {\n const detail = COMMAND_HELP_DETAILS[command];\n return {\n label: command,\n description: detail.description,\n details: [\n { label: \"usage:\", value: detail.usage },\n { label: \"flags:\", value: formatFlags(detail.flags) },\n ...detail.examples.map((example) => ({ label: \"example:\", value: example })),\n ...detail.notes.map((note) => ({ label: \"note:\", value: note }))\n ]\n };\n });\n return `${group.title}: ${group.summary}\\n${formatRows(rows)}`;\n })\n .join(\"\\n\\n\");\n}\n\nfunction formatFlagGroups(): string {\n return HELP_FLAG_GROUPS\n .map((group) => {\n const rows: FormattableRow[] = group.flags.map((entry) => ({\n label: entry.alias ? `${entry.flag} (${entry.alias})` : entry.flag,\n description: entry.description,\n details: entry.example ? [{ label: \"example:\", value: entry.example }] : []\n }));\n return `${group.title}: ${group.summary}\\n${formatRows(rows)}`;\n })\n .join(\"\\n\\n\");\n}\n\nfunction formatToolEntries(): string {\n return formatRows(HELP_TOOL_ENTRIES.map((entry) => ({\n label: entry.name,\n description: entry.description,\n details: [\n ...(entry.cliEquivalent\n ? [{ label: \"cli:\", value: entry.cliEquivalent }]\n : [{ label: \"scope:\", value: \"tool-only\" }]),\n ...(entry.example ? [{ label: \"example:\", value: entry.example }] : []),\n ...((entry.notes ?? []).map((note) => ({ label: \"note:\", value: note })))\n ]\n })));\n}\n\nfunction formatOnboardingEntries(): string {\n return formatRows(HELP_ONBOARDING_ENTRIES);\n}\n\nfunction formatCapabilityEntries(): string {\n return formatRows(HELP_CAPABILITY_ENTRIES);\n}\n\nfunction formatReferenceEntries(): string {\n return formatRows(HELP_REFERENCE_ENTRIES.map((entry) => ({\n label: entry.label,\n description: entry.description\n })));\n}\n\nexport function getHelpText(): string {\n assertCommandCoverage();\n assertFlagCoverage();\n assertToolCoverage();\n\n return [\n \"OpenDevBrowser CLI\",\n \"\",\n \"Usage:\",\n \" npx opendevbrowser <command> [options]\",\n \"\",\n \"Find It Fast:\",\n \" Use these exact lookup terms when you need replay, desktop evidence, or browser-scoped computer use.\",\n formatCapabilityEntries(),\n \"\",\n `${onboardingMetadata.sectionTitle}:`,\n ` ${onboardingMetadata.sectionSummary}`,\n formatOnboardingEntries(),\n \"\",\n `Command Inventory (all ${CLI_COMMANDS.length} commands):`,\n formatCommandGroups(),\n \"\",\n \"Flag Inventory (all supported flags):\",\n formatFlagGroups(),\n \"\",\n `Tool Inventory (all ${TOOL_COUNT} opendevbrowser_* tools):`,\n formatToolEntries(),\n \"\",\n \"Reference Pointers:\",\n formatReferenceEntries()\n ].join(\"\\n\");\n}\n"],"mappings":"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","names":[]}

package/dist/{hover-476ZNQZE.js → hover-ZWY4YOM4.js} RENAMED Viewed

@@ -1,25 +1,25 @@
 import "./chunk-RJNI3BHT.js";
 import {
   parseOptionalStringFlag
-} from "./chunk-SKFB5ICF.js";
+} from "./chunk-TI5I6UWY.js";
 import {
   callDaemon
-} from "./chunk-MJF67OTH.js";
-import "./chunk-HMRANSDX.js";
-import "./chunk-EOX6U6Q4.js";
+} from "./chunk-XSSPNVMS.js";
+import "./chunk-Z3ADLR7I.js";
+import "./chunk-AHQC4A6P.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
+import "./chunk-QMHKAFYX.js";
 import {
   createUsageError
 } from "./chunk-7BNU6DFI.js";
-import "./chunk-QMHKAFYX.js";
 import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-FBKPDILE.js";
+import "./chunk-WTWSBEBW.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-IBIHDGTZ.js";
+import "./chunk-B5XIJQXO.js";
 import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
@@ -68,4 +68,4 @@ async function runHover(args) {
 export {
   runHover
 };
-//# sourceMappingURL=hover-476ZNQZE.js.map
+//# sourceMappingURL=hover-ZWY4YOM4.js.map

package/dist/{html-5C4TXOV3.js → html-M46YBFT3.js} RENAMED Viewed

@@ -2,25 +2,25 @@ import "./chunk-RJNI3BHT.js";
 import {
   parseNumberFlag,
   parseOptionalStringFlag
-} from "./chunk-SKFB5ICF.js";
+} from "./chunk-TI5I6UWY.js";
 import {
   callDaemon
-} from "./chunk-MJF67OTH.js";
-import "./chunk-HMRANSDX.js";
-import "./chunk-EOX6U6Q4.js";
+} from "./chunk-XSSPNVMS.js";
+import "./chunk-Z3ADLR7I.js";
+import "./chunk-AHQC4A6P.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
+import "./chunk-QMHKAFYX.js";
 import {
   createUsageError
 } from "./chunk-7BNU6DFI.js";
-import "./chunk-QMHKAFYX.js";
 import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-FBKPDILE.js";
+import "./chunk-WTWSBEBW.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-IBIHDGTZ.js";
+import "./chunk-B5XIJQXO.js";
 import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
@@ -81,4 +81,4 @@ async function runDomHtml(args) {
 export {
   runDomHtml
 };
-//# sourceMappingURL=html-5C4TXOV3.js.map
+//# sourceMappingURL=html-M46YBFT3.js.map

package/dist/index.js CHANGED Viewed

@@ -6,11 +6,14 @@ import {
 } from "./chunk-OW5HMYMI.js";
 import {
   DaemonClient
-} from "./chunk-MJF67OTH.js";
+} from "./chunk-XSSPNVMS.js";
 import {
   DEFAULT_DAEMON_STATUS_FETCH_OPTIONS,
   buildCorrelatedAuditBundle,
   buildDaemonFingerprintMismatchMessage,
+  captureInspiredesignPrimaryMotionEvidenceFromManager,
+  captureInspiredesignPrimaryPinMediaEvidenceFromManager,
+  captureInspiredesignPrimaryVisualEvidenceFromManager,
   captureInspiredesignReferenceFromManager,
   createDaemonStopHeaders,
   executeMacroWithRuntime,
@@ -21,7 +24,7 @@ import {
   isCurrentDaemonFingerprint,
   readDaemonMetadata,
   startDaemon
-} from "./chunk-HMRANSDX.js";
+} from "./chunk-Z3ADLR7I.js";
 import {
   AGENT_INBOX_SYSTEM_MARKER,
   ScriptRunner,
@@ -33,7 +36,7 @@ import {
   createOpenDevBrowserCore,
   resolveBundledProviderRuntime,
   resolveSessionRelayRoute
-} from "./chunk-EOX6U6Q4.js";
+} from "./chunk-AHQC4A6P.js";
 import {
   requireChallengeOrchestrationConfig
 } from "./chunk-MX3NFLCE.js";
@@ -41,9 +44,9 @@ import "./chunk-ASMHEEKY.js";
 import {
   onboarding_metadata_default
 } from "./chunk-DW4TX7MU.js";
-import "./chunk-27W46IKI.js";
-import "./chunk-7BNU6DFI.js";
 import "./chunk-QMHKAFYX.js";
+import "./chunk-HM4CO3EW.js";
+import "./chunk-7BNU6DFI.js";
 import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
@@ -53,11 +56,15 @@ import {
 import {
   CHALLENGE_AUTOMATION_MODES,
   buildMacroResolveSuccessHandoff,
-  resolveInspiredesignCaptureMode,
-  resolveWorkflowArtifactRoot
-} from "./chunk-FBKPDILE.js";
+  requiresProviderUrlSiteRecipeCompatibility,
+  resolveInspiredesignHarvestCaptureMode,
+  resolveInspiredesignUserFacingProductReadinessFields,
+  resolveWorkflowArtifactRoot,
+  validateProviderScopedUrlCanonicality,
+  validateProviderUrlSiteRecipeCompatibility
+} from "./chunk-WTWSBEBW.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-IBIHDGTZ.js";
+import "./chunk-B5XIJQXO.js";
 import {
   buildBlockerArtifacts,
   classifyBlockerSignal,
@@ -628,7 +635,7 @@ import { tool } from "@opencode-ai/plugin";
 // src/tools/response.ts
 function ok(data) {
-  return JSON.stringify({ ok: true, ...data });
+  return JSON.stringify({ ...data, ok: true });
 }
 function failure(message, code, details) {
   return JSON.stringify({
@@ -3255,7 +3262,7 @@ function createResearchRunTool(deps) {
     async execute(args) {
       try {
         const runtime = await resolveProviderRuntime(deps);
-        const { runResearchWorkflow } = await import("./providers-KKNPJSQK.js");
+        const { runResearchWorkflow } = await import("./providers-AERTX6X4.js");
         const result = await runResearchWorkflow(runtime, {
           topic: args.topic,
           days: args.days,
@@ -3309,7 +3316,7 @@ function createShoppingRunTool(deps) {
     async execute(args) {
       try {
         const runtime = await resolveProviderRuntime(deps);
-        const { runShoppingWorkflow } = await import("./providers-KKNPJSQK.js");
+        const { runShoppingWorkflow } = await import("./providers-AERTX6X4.js");
         const result = await runShoppingWorkflow(runtime, {
           query: args.query,
           providers: args.providers,
@@ -3333,6 +3340,9 @@ function createShoppingRunTool(deps) {
 }
 // src/tools/product_video_run.ts
+import { mkdtemp, readFile, rm } from "fs/promises";
+import { tmpdir } from "os";
+import { join as join2 } from "path";
 import { tool as tool66 } from "@opencode-ai/plugin";
 var z65 = tool66.schema;
 var browserModeSchema4 = z65.enum(["auto", "extension", "managed"]);
@@ -3340,13 +3350,19 @@ var cookiePolicySchema4 = z65.enum(["off", "auto", "required"]);
 var challengeAutomationModeSchema7 = z65.enum(CHALLENGE_AUTOMATION_MODES);
 async function captureScreenshotBuffer(deps, url) {
   let sessionId = null;
+  let captureDir = null;
   try {
     const launched = await deps.manager.launch({
       headless: true,
       startUrl: url
     });
     sessionId = launched.sessionId;
-    const screenshot = await deps.manager.screenshot(sessionId);
+    captureDir = await mkdtemp(join2(tmpdir(), "odb-product-video-shot-"));
+    const capturePath = join2(captureDir, "capture.png");
+    const screenshot = await deps.manager.screenshot(sessionId, { path: capturePath });
+    if (typeof screenshot.path === "string" && screenshot.path.length > 0) {
+      return await readFile(screenshot.path);
+    }
     if (typeof screenshot.base64 === "string" && screenshot.base64.length > 0) {
       return Buffer.from(screenshot.base64, "base64");
     }
@@ -3358,6 +3374,10 @@ async function captureScreenshotBuffer(deps, url) {
       await deps.manager.disconnect(sessionId, true).catch(() => {
       });
     }
+    if (captureDir) {
+      await rm(captureDir, { recursive: true, force: true }).catch(() => {
+      });
+    }
   }
 }
 function createProductVideoRunTool(deps) {
@@ -3381,7 +3401,7 @@ function createProductVideoRunTool(deps) {
     async execute(args) {
       try {
         const runtime = await resolveProviderRuntime(deps);
-        const { runProductVideoWorkflow } = await import("./providers-KKNPJSQK.js");
+        const { runProductVideoWorkflow } = await import("./providers-AERTX6X4.js");
         const includeScreenshots = args.include_screenshots ?? true;
         const result = await runProductVideoWorkflow(runtime, {
           product_url: args.product_url,
@@ -3421,7 +3441,7 @@ var HARVEST_DEFAULT_MAX_REFERENCES = 5;
 var MAX_HARVEST_REFERENCES = 10;
 function createInspiredesignRunTool(deps) {
   return tool67({
-    description: "Run the inspiredesign workflow directly, including harvest query discovery and visual evidence capture.",
+    description: "Run the inspiredesign workflow directly, including harvest query discovery and authoritative visual, motion, or pin-media evidence capture.",
     args: {
       brief: z66.string().min(1).describe("Inspiredesign brief"),
       harvest: z66.boolean().optional().describe("Enable visual harvest defaults for query-backed discovery"),
@@ -3430,7 +3450,7 @@ function createInspiredesignRunTool(deps) {
       maxReferences: z66.number().int().min(1).max(MAX_HARVEST_REFERENCES).optional().describe("Maximum references to analyze"),
       visualEvidence: visualEvidenceSchema.optional().describe("Visual evidence mode: off|auto|required"),
       urls: z66.array(z66.string()).optional().describe("Inspiration URLs to analyze"),
-      captureMode: captureModeSchema.optional().describe("Capture mode: off|deep. Any URLs force deep."),
+      captureMode: captureModeSchema.optional().describe("Capture mode: off|deep. Pinterest harvest disables deep diagnostics and uses canonical pin media evidence."),
       includePrototypeGuidance: z66.boolean().optional().describe("Include prototype guidance output"),
       mode: modeSchema3.optional().describe("compact|json|md|context|path"),
       timeoutMs: z66.number().int().positive().optional().describe("Workflow timeout in milliseconds"),
@@ -3444,16 +3464,40 @@ function createInspiredesignRunTool(deps) {
     async execute(args) {
       try {
         const runtime = await resolveProviderRuntime(deps);
-        const { runInspiredesignWorkflow } = await import("./providers-KKNPJSQK.js");
-        const captureMode = resolveInspiredesignCaptureMode(args.captureMode, args.urls);
+        const { runInspiredesignWorkflow } = await import("./providers-AERTX6X4.js");
         if (args.query && args.harvest !== true) {
           throw new Error("query is only supported when harvest is true.");
         }
-        if (args.providers && args.providers.length > 0 && !args.query) {
-          throw new Error("providers require query.");
+        const isHarvest = args.harvest === true;
+        const providers = args.providers ?? [];
+        const urls = args.urls ?? [];
+        const captureMode = resolveInspiredesignHarvestCaptureMode({
+          requested: args.captureMode,
+          urls,
+          harvest: isHarvest,
+          providers
+        });
+        const canonicality = validateProviderScopedUrlCanonicality({ providers, urls });
+        if (!canonicality.ok) {
+          throw new Error(canonicality.message);
+        }
+        if (requiresProviderUrlSiteRecipeCompatibility({
+          providers,
+          urls,
+          query: args.query
+        })) {
+          if (!isHarvest) {
+            throw new Error("providers require query unless harvest uses compatible URL recovery.");
+          }
+          const compatibility = validateProviderUrlSiteRecipeCompatibility({
+            providers,
+            urls
+          });
+          if (!compatibility.ok) {
+            throw new Error(compatibility.message);
+          }
         }
         const cookieSource = deps.config.get().providers?.cookieSource;
-        const isHarvest = args.harvest === true;
         if (isHarvest && !args.query && (!args.urls || args.urls.length === 0)) {
           throw new Error("inspiredesign harvest requires query or URLs.");
         }
@@ -3480,9 +3524,25 @@ function createInspiredesignRunTool(deps) {
           captureReference: shouldProvideCaptureReference ? async (url, options) => captureInspiredesignReferenceFromManager(deps.manager, url, {
             ...options,
             cookieSource
-          }) : void 0
+          }) : void 0,
+          captureVisualEvidence: async (url, options) => captureInspiredesignPrimaryVisualEvidenceFromManager(deps.manager, url, {
+            ...options,
+            cookieSource
+          }),
+          captureMotionEvidence: async (url, options) => captureInspiredesignPrimaryMotionEvidenceFromManager(deps.manager, url, {
+            ...options,
+            cookieSource
+          }),
+          capturePinMediaEvidence: async (url, options) => captureInspiredesignPrimaryPinMediaEvidenceFromManager(deps.manager, url, {
+            ...options,
+            cookieSource
+          })
+        });
+        const productReadiness = resolveInspiredesignUserFacingProductReadinessFields(result);
+        return ok({
+          ...result,
+          ...productReadiness
         });
-        return ok(result);
       } catch (error) {
         return failure(serializeError(error).message, "inspiredesign_run_failed");
       }