opendevbrowser 0.0.31 → 0.0.33

package/dist/guidance/types.d.ts

@@ -0,0 +1,139 @@
+import type { JsonValue } from "../providers/types";
+export type GuidanceWorkflow = "inspiredesign" | "canvas" | "provider" | "daemon" | "cli" | "research" | "shopping" | "product_video" | "macro";
+export type GuidanceRecipeType = "workflow_entry" | "site_navigation" | "schema_repair" | "evidence_recovery" | "artifact_handoff" | "quality_gate";
+export type GuidanceSeverity = "info" | "warning" | "blocked" | "fatal";
+export type GuidanceReadiness = "ready" | "needs_input" | "needs_recovery" | "blocked" | "diagnostic_only";
+export type GuidanceAction = {
+    id: string;
+    label: string;
+    summary: string;
+};
+export type GuidanceCommandExample = {
+    id: string;
+    label: string;
+    command: string;
+    placeholders?: Record<string, string>;
+};
+export type GuidanceParamsExample = {
+    id: string;
+    label: string;
+    command?: string;
+    params: JsonValue;
+};
+export type GuidanceFieldExample = {
+    path: string;
+    description: string;
+    example: JsonValue;
+    expected?: string;
+    received?: string;
+};
+export type GuidanceArtifactInput = {
+    path: string;
+    purpose: string;
+    required: boolean;
+};
+export type GuidanceValidationCheck = {
+    id: string;
+    description: string;
+    assertion?: string;
+    command?: string;
+};
+export type GuidanceFallbackPolicy = {
+    allowed: boolean;
+    requiresUserConfirmation: boolean;
+    reason: string;
+};
+export type GuidanceEvidenceContext = {
+    referenceCount?: number;
+    referenceEvidenceRequired?: boolean;
+    rankedReferenceCount?: number;
+    rejectedReferenceCount?: number;
+    topReferenceScore?: number;
+    topReferenceConfidence?: number;
+    topReferenceIntentMatched?: boolean;
+    failedCaptureCount?: number;
+    missingScreenshotCount?: number;
+    visualEvidenceRequired?: boolean;
+    diagnosticOnlyReasons?: string[];
+};
+export type GuidanceContext = {
+    workflow: GuidanceWorkflow;
+    reasonCode?: string;
+    requestedProviders?: string[];
+    siteRecipeId?: string;
+    query?: string;
+    browserMode?: string;
+    cookiePolicy?: string;
+    useCookies?: boolean;
+    providerUnavailable?: boolean;
+    evidence?: GuidanceEvidenceContext;
+    details?: Record<string, JsonValue>;
+};
+export type NextStepGuidance = {
+    id: string;
+    recipeType: GuidanceRecipeType;
+    workflow: GuidanceWorkflow;
+    severity: GuidanceSeverity;
+    readiness: GuidanceReadiness;
+    reasonCode: string;
+    primaryAction: GuidanceAction;
+    commands: GuidanceCommandExample[];
+    paramsExamples: GuidanceParamsExample[];
+    fieldExamples: GuidanceFieldExample[];
+    artifactInputs: GuidanceArtifactInput[];
+    validationChecks: GuidanceValidationCheck[];
+    fallbackPolicy: GuidanceFallbackPolicy;
+    doNotProceedIf: string[];
+};
+export type GuidanceRecipe = {
+    id: string;
+    recipeType: GuidanceRecipeType;
+    workflow: GuidanceWorkflow;
+    priority: number;
+    reasonCode: string;
+    matches: (context: GuidanceContext) => boolean;
+    build: (context: GuidanceContext, readiness: GuidanceReadiness) => NextStepGuidance;
+};
+export type SiteRecipeAuthMode = "public" | "authenticated" | "authenticated_preferred";
+export type SiteRecipeNavigationStep = {
+    id: string;
+    instruction: string;
+};
+export type SiteRecipeBadState = {
+    id: string;
+    markers: string[];
+    reasonCode: string;
+    recoveryAction: string;
+};
+export type SiteRecipeEvidenceRequirement = {
+    id: string;
+    description: string;
+    validation: string;
+};
+export type SiteRecipeRecoveryStep = {
+    id: string;
+    instruction: string;
+};
+export type SiteRecipeReferenceCandidate = {
+    url?: string;
+    content?: string;
+    html?: string;
+    links?: string[];
+};
+export type SiteRecipeBrowserNativeDiscovery = {
+    buildSearchUrl: (query: string) => string;
+    extractReferenceUrls?: (candidate: SiteRecipeReferenceCandidate) => string[];
+};
+export type SiteRecipe = {
+    id: string;
+    providerIds: string[];
+    hostnames: string[];
+    authMode: SiteRecipeAuthMode;
+    navigationSteps: SiteRecipeNavigationStep[];
+    badStates: SiteRecipeBadState[];
+    evidenceRequirements: SiteRecipeEvidenceRequirement[];
+    recoverySteps: SiteRecipeRecoveryStep[];
+    browserNativeDiscovery?: SiteRecipeBrowserNativeDiscovery;
+    guidance: NextStepGuidance;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/guidance/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/guidance/types.ts"],"names":[],"mappings":"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"}

package/dist/{help-U7KBQME6.js → help-SUI4H77K.js}

@@ -1,19 +1,19 @@
 import {
   onboarding_metadata_default
 } from "./chunk-DW4TX7MU.js";
-import "./chunk-2I3YS3DV.js";
+import "./chunk-FDBUB7BM.js";
 import {
   CLI_COMMANDS,
   CLI_COMMAND_HELP_DETAILS,
   PUBLIC_CLI_COMMAND_GROUPS,
   TOOL_SURFACE_ENTRIES,
   VALID_FLAGS
-} from "./chunk-6B5WAQV7.js";
-import "./chunk-IPE7TF2P.js";
+} from "./chunk-27W46IKI.js";
+import "./chunk-7BNU6DFI.js";
 import {
   INSPIREDESIGN_HANDOFF_COMMANDS,
   INSPIREDESIGN_HANDOFF_GUIDANCE
-} from "./chunk-KZ2IXVQT.js";
+} from "./chunk-IBIHDGTZ.js";
 
 // src/cli/help.ts
 var LABEL_WIDTH = 42;
@@ -93,7 +93,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; repeat for multi-reference inspiredesign runs.", 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 run or harvest inputs.", 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" },
@@ -167,8 +167,11 @@ var HELP_FLAG_GROUPS = [
       { flag: "--sources", description: "Explicit source-family selectors such as web,community. Use shopping only when commercial intent is explicit." },
       { flag: "--include-engagement", description: "Include engagement metrics in research output." },
       { flag: "--limit-per-source", description: "Per-source result cap for research runs." },
-      { flag: "--query", description: "Shopping query input." },
+      { flag: "--query", description: "Shopping query input or inspiredesign harvest discovery query." },
       { flag: "--providers", description: "Comma-separated provider ids for shopping or artifact commands." },
+      { flag: "--provider", description: "Repeatable provider id for inspiredesign harvest discovery." },
+      { flag: "--max-references", description: "Maximum inspiredesign harvest references to keep after explicit URL and query discovery merge." },
+      { flag: "--visual-evidence", description: "Inspiredesign visual evidence mode: off, auto, or required. Harvest defaults to required." },
       { 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." },
@@ -218,7 +221,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, inspiredesign run, macro-resolve --execute" },
+      { label: "works:", value: "research run, shopping run, product-video run, inspiredesign run, inspiredesign harvest, macro-resolve --execute" },
       { label: "entry:", value: onboarding_metadata_default.quickStartCommands.computerUseEntry },
       { label: "proof:", value: "review, session-inspector, workflow fallback metadata" }
     ]
@@ -257,11 +260,13 @@ var HELP_ONBOARDING_ENTRIES = [
   },
   {
     label: "inspiredesign_followthrough",
-    description: "After inspiredesign finishes, read advanced-brief.md first, then continue in Canvas with the emitted request template and load the canvas-contract design-agent lane before patching.",
+    description: "After inspiredesign finishes, inspect nextStepGuidance.readiness, read required artifacts, and continue in Canvas only when guidance is ready.",
     details: [
       { label: "quick:", value: INSPIREDESIGN_HANDOFF_COMMANDS.loadBestPractices },
       { label: "design:", value: INSPIREDESIGN_HANDOFF_COMMANDS.loadDesignAgent },
+      { label: "motion:", value: INSPIREDESIGN_HANDOFF_COMMANDS.loadMotionDesign },
       { label: "brief:", value: INSPIREDESIGN_HANDOFF_GUIDANCE.reviewAdvancedBrief },
+      { label: "gate:", value: "Require nextStepGuidance.readiness=ready and no matching doNotProceedIf blockers before Canvas continuation." },
       { label: "prep:", value: INSPIREDESIGN_HANDOFF_GUIDANCE.prepareCanvasPlanRequest },
       { label: "run:", value: INSPIREDESIGN_HANDOFF_COMMANDS.continueInCanvas }
     ]
@@ -488,4 +493,4 @@ export {
   getHelpText,
   getToolOnlyHelperNames
 };
-//# sourceMappingURL=help-U7KBQME6.js.map
+//# sourceMappingURL=help-SUI4H77K.js.map

package/dist/help-SUI4H77K.js.map

@@ -0,0 +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":[]}

package/dist/{hover-6JVJFGO7.js → hover-476ZNQZE.js}

@@ -1,26 +1,26 @@
 import "./chunk-RJNI3BHT.js";
 import {
   parseOptionalStringFlag
-} from "./chunk-RPXWUCQQ.js";
+} from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-MD655IPO.js";
-import "./chunk-COAOWH3G.js";
-import "./chunk-QOMWCRE3.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
   createUsageError
-} from "./chunk-IPE7TF2P.js";
-import "./chunk-STGGGVYT.js";
-import "./chunk-3ILXPKSJ.js";
+} 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-4BEJVZRK.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-KZ2IXVQT.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/interact/hover.ts
@@ -68,4 +68,4 @@ async function runHover(args) {
 export {
   runHover
 };
-//# sourceMappingURL=hover-6JVJFGO7.js.map
+//# sourceMappingURL=hover-476ZNQZE.js.map

package/dist/{html-EVOSPBIT.js → html-5C4TXOV3.js}

@@ -2,26 +2,26 @@ import "./chunk-RJNI3BHT.js";
 import {
   parseNumberFlag,
   parseOptionalStringFlag
-} from "./chunk-RPXWUCQQ.js";
+} from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-MD655IPO.js";
-import "./chunk-COAOWH3G.js";
-import "./chunk-QOMWCRE3.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
   createUsageError
-} from "./chunk-IPE7TF2P.js";
-import "./chunk-STGGGVYT.js";
-import "./chunk-3ILXPKSJ.js";
+} 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-4BEJVZRK.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-KZ2IXVQT.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/dom/html.ts
@@ -81,4 +81,4 @@ async function runDomHtml(args) {
 export {
   runDomHtml
 };
-//# sourceMappingURL=html-EVOSPBIT.js.map
+//# sourceMappingURL=html-5C4TXOV3.js.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA8ClD,QAAA,MAAM,oBAAoB,EAAE,MAoW3B,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA+ClD,QAAA,MAAM,oBAAoB,EAAE,MAwW3B,CAAC;AAEF,eAAe,oBAAoB,CAAC"}

package/dist/index.js

@@ -6,10 +6,11 @@ import {
 } from "./chunk-OW5HMYMI.js";
 import {
   DaemonClient
-} from "./chunk-MD655IPO.js";
+} from "./chunk-MJF67OTH.js";
 import {
   DEFAULT_DAEMON_STATUS_FETCH_OPTIONS,
   buildCorrelatedAuditBundle,
+  buildDaemonFingerprintMismatchMessage,
   captureInspiredesignReferenceFromManager,
   createDaemonStopHeaders,
   executeMacroWithRuntime,
@@ -20,7 +21,7 @@ import {
   isCurrentDaemonFingerprint,
   readDaemonMetadata,
   startDaemon
-} from "./chunk-COAOWH3G.js";
+} from "./chunk-HMRANSDX.js";
 import {
   AGENT_INBOX_SYSTEM_MARKER,
   ScriptRunner,
@@ -32,7 +33,7 @@ import {
   createOpenDevBrowserCore,
   resolveBundledProviderRuntime,
   resolveSessionRelayRoute
-} from "./chunk-QOMWCRE3.js";
+} from "./chunk-EOX6U6Q4.js";
 import {
   requireChallengeOrchestrationConfig
 } from "./chunk-MX3NFLCE.js";
@@ -40,10 +41,10 @@ import "./chunk-ASMHEEKY.js";
 import {
   onboarding_metadata_default
 } from "./chunk-DW4TX7MU.js";
-import "./chunk-6B5WAQV7.js";
-import "./chunk-IPE7TF2P.js";
-import "./chunk-STGGGVYT.js";
-import "./chunk-3ILXPKSJ.js";
+import "./chunk-27W46IKI.js";
+import "./chunk-7BNU6DFI.js";
+import "./chunk-QMHKAFYX.js";
+import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import {
@@ -54,14 +55,14 @@ import {
   buildMacroResolveSuccessHandoff,
   resolveInspiredesignCaptureMode,
   resolveWorkflowArtifactRoot
-} from "./chunk-4BEJVZRK.js";
+} from "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-KZ2IXVQT.js";
+import "./chunk-IBIHDGTZ.js";
 import {
   buildBlockerArtifacts,
   classifyBlockerSignal,
   createRequestId
-} from "./chunk-WHQZBUNY.js";
+} from "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/remote-manager.ts
@@ -3254,7 +3255,7 @@ function createResearchRunTool(deps) {
     async execute(args) {
       try {
         const runtime = await resolveProviderRuntime(deps);
-        const { runResearchWorkflow } = await import("./providers-IMFYMMHQ.js");
+        const { runResearchWorkflow } = await import("./providers-KKNPJSQK.js");
         const result = await runResearchWorkflow(runtime, {
           topic: args.topic,
           days: args.days,
@@ -3308,7 +3309,7 @@ function createShoppingRunTool(deps) {
     async execute(args) {
       try {
         const runtime = await resolveProviderRuntime(deps);
-        const { runShoppingWorkflow } = await import("./providers-IMFYMMHQ.js");
+        const { runShoppingWorkflow } = await import("./providers-KKNPJSQK.js");
         const result = await runShoppingWorkflow(runtime, {
           query: args.query,
           providers: args.providers,
@@ -3380,7 +3381,7 @@ function createProductVideoRunTool(deps) {
     async execute(args) {
       try {
         const runtime = await resolveProviderRuntime(deps);
-        const { runProductVideoWorkflow } = await import("./providers-IMFYMMHQ.js");
+        const { runProductVideoWorkflow } = await import("./providers-KKNPJSQK.js");
         const includeScreenshots = args.include_screenshots ?? true;
         const result = await runProductVideoWorkflow(runtime, {
           product_url: args.product_url,
@@ -3414,12 +3415,20 @@ var modeSchema3 = z66.enum(["compact", "json", "md", "context", "path"]);
 var captureModeSchema = z66.enum(["off", "deep"]);
 var browserModeSchema5 = z66.enum(["auto", "extension", "managed"]);
 var cookiePolicySchema5 = z66.enum(["off", "auto", "required"]);
+var visualEvidenceSchema = z66.enum(["off", "auto", "required"]);
 var challengeAutomationModeSchema8 = z66.enum(CHALLENGE_AUTOMATION_MODES);
+var HARVEST_DEFAULT_MAX_REFERENCES = 5;
+var MAX_HARVEST_REFERENCES = 10;
 function createInspiredesignRunTool(deps) {
   return tool67({
-    description: "Run the inspiredesign workflow directly.",
+    description: "Run the inspiredesign workflow directly, including harvest query discovery and visual evidence capture.",
     args: {
       brief: z66.string().min(1).describe("Inspiredesign brief"),
+      harvest: z66.boolean().optional().describe("Enable visual harvest defaults for query-backed discovery"),
+      query: z66.string().optional().describe("Reference discovery query for visual harvest"),
+      providers: z66.array(z66.string()).optional().describe("Optional provider ids for reference discovery"),
+      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."),
       includePrototypeGuidance: z66.boolean().optional().describe("Include prototype guidance output"),
@@ -3435,15 +3444,31 @@ function createInspiredesignRunTool(deps) {
     async execute(args) {
       try {
         const runtime = await resolveProviderRuntime(deps);
-        const { runInspiredesignWorkflow } = await import("./providers-IMFYMMHQ.js");
+        const { runInspiredesignWorkflow } = await import("./providers-KKNPJSQK.js");
         const captureMode = resolveInspiredesignCaptureMode(args.captureMode, args.urls);
+        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 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.");
+        }
+        const shouldProvideCaptureReference = captureMode === "deep" || isHarvest || Boolean(args.query);
         const result = await runInspiredesignWorkflow(runtime, {
           brief: args.brief,
+          harvest: args.harvest,
+          query: args.query,
+          providers: args.providers,
+          maxReferences: args.maxReferences ?? (isHarvest ? HARVEST_DEFAULT_MAX_REFERENCES : void 0),
+          visualEvidence: args.visualEvidence ?? (isHarvest ? "required" : "off"),
           urls: args.urls,
           captureMode,
           includePrototypeGuidance: args.includePrototypeGuidance,
-          mode: args.mode ?? "compact",
+          mode: args.mode ?? (isHarvest ? "path" : "compact"),
           timeoutMs: args.timeoutMs ?? DEFAULT_WORKFLOW_TRANSPORT_TIMEOUT_MS,
           outputDir: resolveWorkflowToolOutputDir(deps, args.outputDir),
           ttlHours: args.ttlHours,
@@ -3452,7 +3477,7 @@ function createInspiredesignRunTool(deps) {
           challengeAutomationMode: args.challengeAutomationMode,
           cookiePolicyOverride: args.cookiePolicyOverride
         }, {
-          captureReference: captureMode === "deep" ? async (url, options) => captureInspiredesignReferenceFromManager(deps.manager, url, {
+          captureReference: shouldProvideCaptureReference ? async (url, options) => captureInspiredesignReferenceFromManager(deps.manager, url, {
             ...options,
             cookieSource
           }) : void 0
@@ -3770,7 +3795,11 @@ var OpenDevBrowserPlugin = async ({ directory, worktree }) => {
       if (!configuredConnection) {
         return;
       }
-      throw new Error(`Hub daemon on 127.0.0.1:${connection.port} pid=${status.pid} is protected by a different opendevbrowser build.`);
+      throw new Error(buildDaemonFingerprintMismatchMessage({
+        label: "Hub daemon",
+        port: connection.port,
+        pid: status.pid
+      }));
     }
     if (!response.ok) {
       if (!configuredConnection) {