opendevbrowser 0.0.26 → 0.0.28

package/dist/{chunk-AVQL6WAS.js → chunk-T3VVHJTK.js}

@@ -3595,7 +3595,7 @@ var readFallbackRecord = (details, key) => {
 };
 var readFallbackString = (output, key) => {
   const value = output?.[key];
-  return typeof value === "string" && value.length > 0 ? value : void 0;
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 };
 var fallbackDispositionMessage = (fallback, url) => {
   if (typeof fallback.details?.message === "string" && fallback.details.message.trim().length > 0) {
@@ -3610,32 +3610,67 @@ var fallbackDispositionMessage = (fallback, url) => {
       return `Browser fallback failed for ${url}`;
   }
 };
+var fallbackErrorDetails = (args) => ({
+  url: args.url,
+  disposition: args.fallback.disposition,
+  ...args.fallback.mode ? { browserFallbackMode: args.fallback.mode } : {},
+  ...args.fallback.challenge ? { challenge: toJsonRecord(args.fallback.challenge) } : {},
+  ...args.fallback.preservedSessionId ? { preservedSessionId: args.fallback.preservedSessionId } : {},
+  ...args.fallback.preservedTargetId ? { preservedTargetId: args.fallback.preservedTargetId } : {},
+  ...toJsonRecord(args.fallback.details ?? {}),
+  ...args.extra ?? {}
+});
+var addProviderIssueGuidance = (args) => {
+  const hint = readProviderIssueHint({
+    reasonCode: args.reasonCode,
+    details: args.details
+  });
+  const guidanceDetails = args.includeCompleted ? { ...args.details, disposition: "failed" } : args.details;
+  const guidance = hint ? buildProviderIssueGuidance({ provider: args.provider, hint, details: guidanceDetails }) : void 0;
+  return guidance ? { ...args.details, guidance } : args.details;
+};
 var toProviderFallbackError = (args) => {
   const { fallback } = args;
   const reasonCode = fallback.reasonCode;
-  const details = {
+  const details = fallbackErrorDetails({ url: args.url, fallback });
+  return new ProviderRuntimeError(
+    providerErrorCodeFromReasonCode(reasonCode),
+    fallbackDispositionMessage(fallback, args.url),
+    {
+      provider: args.provider,
+      source: args.source,
+      retryable: reasonCode === "rate_limited",
+      reasonCode,
+      details: addProviderIssueGuidance({
+        provider: args.provider,
+        reasonCode,
+        details
+      })
+    }
+  );
+};
+var toCompletedFallbackOutputError = (args) => {
+  const { fallback } = args;
+  const reasonCode = fallback.reasonCode;
+  const details = fallbackErrorDetails({
     url: args.url,
-    disposition: fallback.disposition,
-    ...fallback.mode ? { browserFallbackMode: fallback.mode } : {},
-    ...fallback.challenge ? { challenge: toJsonRecord(fallback.challenge) } : {},
-    ...fallback.preservedSessionId ? { preservedSessionId: fallback.preservedSessionId } : {},
-    ...fallback.preservedTargetId ? { preservedTargetId: fallback.preservedTargetId } : {},
-    ...toJsonRecord(fallback.details ?? {})
-  };
-  const hint = readProviderIssueHint({
-    reasonCode,
-    details
+    fallback,
+    extra: { fallbackOutputReason: args.outputReason }
   });
-  const guidance = hint ? buildProviderIssueGuidance({ provider: args.provider, hint, details }) : void 0;
   return new ProviderRuntimeError(
     providerErrorCodeFromReasonCode(reasonCode),
-    fallbackDispositionMessage(fallback, args.url),
+    `Browser fallback completed for ${args.url} without usable HTML content.`,
     {
       provider: args.provider,
       source: args.source,
       retryable: reasonCode === "rate_limited",
       reasonCode,
-      details: guidance ? { ...details, guidance } : details
+      details: addProviderIssueGuidance({
+        provider: args.provider,
+        reasonCode,
+        details,
+        includeCompleted: true
+      })
     }
   );
 };
@@ -5070,6 +5105,10 @@ var toPositiveInt = (value, fallback) => {
   if (typeof value !== "number" || Number.isNaN(value)) return fallback;
   return Math.max(1, Math.floor(value));
 };
+var toNonNegativeInt = (value, fallback) => {
+  if (typeof value !== "number" || Number.isNaN(value)) return fallback;
+  return Math.max(0, Math.floor(value));
+};
 var isHttpUrl2 = (value) => {
   try {
     const protocol = new URL(value).protocol;
@@ -5115,11 +5154,11 @@ var mergedTraversal = (options, input) => {
       asNumber(filters.pageLimit) ?? options.defaultTraversal?.pageLimit,
       DEFAULT_TRAVERSAL.pageLimit
     ),
-    hopLimit: toPositiveInt(
+    hopLimit: toNonNegativeInt(
       asNumber(filters.hopLimit) ?? options.defaultTraversal?.hopLimit,
       DEFAULT_TRAVERSAL.hopLimit
     ),
-    expansionPerRecord: toPositiveInt(
+    expansionPerRecord: toNonNegativeInt(
       asNumber(filters.expansionPerRecord) ?? options.defaultTraversal?.expansionPerRecord,
       DEFAULT_TRAVERSAL.expansionPerRecord
     ),
@@ -5428,7 +5467,7 @@ var createCommunityProvider = (options = {}) => {
 };
 
 // src/providers/social/search-quality.ts
-var TARGETED_PLATFORMS = /* @__PURE__ */ new Set(["x", "bluesky", "reddit", "facebook"]);
+var TARGETED_PLATFORMS = /* @__PURE__ */ new Set(["x", "bluesky", "reddit", "facebook", "threads"]);
 var SOCIAL_JS_REQUIRED_RE = /\b(?:javascript (?:is not available|required|is disabled(?: in this browser)?)|you need to enable javascript|please enable javascript)\b/i;
 var BLUESKY_LOGGED_OUT_SEARCH_RE = /\bsearch is currently unavailable when logged out\b/i;
 var BLUESKY_EMPTY_SEARCH_SHELL_RE = /\b(?:follow 10 people to get started|find people to follow)\b/i;
@@ -5496,6 +5535,10 @@ var isPrimaryFacebookHost = (host) => {
   const normalized = host.toLowerCase();
   return normalized === "www.facebook.com" || normalized === "facebook.com" || normalized === "m.facebook.com";
 };
+var isPrimaryThreadsHost = (host) => {
+  const normalized = host.toLowerCase();
+  return normalized === "www.threads.net" || normalized === "threads.net";
+};
 var isFacebookSearchLikePath = (pathname) => pathname === "/watch/search" || pathname === "/watch/search/" || pathname.startsWith("/watch/explore/") || pathname.startsWith("/search/") || pathname.startsWith("/public/") || pathname.startsWith("/hashtag/");
 var isBlockedFacebookNonContentUrl = (parsed, options) => {
   if (!isPrimaryFacebookHost(parsed.hostname)) {
@@ -5522,7 +5565,7 @@ var isBlockedRedditNonContentUrl = (parsed, options) => {
     return false;
   }
   const pathname = parsed.pathname.toLowerCase();
-  if (pathname === "/" || pathname === "/login" || options.includeSearchRoute && pathname === "/search") {
+  if (pathname === "/" || pathname === "/login" || pathname === "/login/" || options.includeSearchRoute && (pathname === "/search" || pathname === "/search/")) {
     return true;
   }
   const pathSegment = firstPathSegment(pathname);
@@ -5540,6 +5583,8 @@ var isRootShellUrl = (platform, parsed) => {
       return isBlockedRedditNonContentUrl(parsed, { includeSearchRoute: false });
     case "facebook":
       return isBlockedFacebookNonContentUrl(parsed, { includeSearchRoute: false });
+    case "threads":
+      return isPrimaryThreadsHost(host) && (pathname === "/" || pathname === "/login" || pathname === "/login/");
     default:
       return false;
   }
@@ -5556,6 +5601,8 @@ var isBlockedExpansionPath = (platform, parsed) => {
       return isBlockedRedditNonContentUrl(parsed, { includeSearchRoute: true });
     case "facebook":
       return isBlockedFacebookNonContentUrl(parsed, { includeSearchRoute: true });
+    case "threads":
+      return isPrimaryThreadsHost(host) && (pathname === "/" || pathname === "/login" || pathname === "/search" || pathname === "/search/" || isStaticMetadataPath(pathname));
     default:
       return false;
   }
@@ -5569,9 +5616,11 @@ var isFirstPartySearchRoute = (platform, parsed) => {
     case "bluesky":
       return host === "bsky.app" && pathname === "/search";
     case "reddit":
-      return isPrimaryRedditHost(host) && pathname === "/search";
+      return isPrimaryRedditHost(host) && (pathname === "/search" || pathname === "/search/");
     case "facebook":
       return isPrimaryFacebookHost(host) && isFacebookSearchLikePath(pathname);
+    case "threads":
+      return isPrimaryThreadsHost(host) && (pathname === "/search" || pathname === "/search/");
     default:
       return false;
   }
@@ -5648,6 +5697,10 @@ var isUsableFacebookSearchEvidenceUrl = (url) => {
   }
   return /^\/reel\/[^/]+\/?$/.test(pathname) || /^\/groups\/[^/]+\/posts\/[^/]+\/?$/.test(pathname) || /^\/[^/]+\/videos\/[^/]+\/?$/.test(pathname) || /^\/share\/v\/[^/]+\/?$/.test(pathname) || (pathname === "/permalink.php" || pathname === "/story.php") && parsed.searchParams.has("story_fbid") || pathname === "/photo/" && parsed.searchParams.has("fbid");
 };
+var isUsableThreadsSearchEvidenceUrl = (url) => {
+  const parsed = parseUrl(url);
+  return parsed !== null && isPrimaryThreadsHost(parsed.hostname) && /^\/@[^/]+\/post\/[^/]+\/?$/.test(parsed.pathname.toLowerCase());
+};
 var isRetainableFacebookSearchSupportUrl = (url) => {
   const parsed = parseUrl(url);
   if (parsed === null || !isPrimaryFacebookHost(parsed.hostname)) {
@@ -5670,17 +5723,18 @@ var hasFacebookSearchResultSignals = (input) => {
   const hasSearchHeading = FACEBOOK_SEARCH_RESULTS_HEADING_RE.test(combined);
   const markerCount = FACEBOOK_SEARCH_RESULT_MARKERS.filter((pattern) => pattern.test(combined)).length;
   const evidence = collectSocialSearchLinkEvidence("facebook", parsed.toString(), Array.isArray(input.links) ? input.links : []);
+  const hasContentEvidence = evidence.usableContentLinks.length > 0;
   const supportLinkCount = evidence.usableLinks.filter(isRetainableFacebookSearchSupportUrl).length;
-  if (markerCount >= 2) {
+  if (markerCount >= 2 && hasContentEvidence) {
     return true;
   }
   if (!hasSearchHeading) {
     return false;
   }
-  if (markerCount >= 1) {
+  if (markerCount >= 1 && hasContentEvidence) {
     return true;
   }
-  return supportLinkCount >= 2;
+  return supportLinkCount >= 2 && hasContentEvidence;
 };
 var isUsableSocialSearchContentUrl = (platform, url) => {
   switch (platform) {
@@ -5692,6 +5746,8 @@ var isUsableSocialSearchContentUrl = (platform, url) => {
       return isUsableRedditSearchEvidenceUrl(url);
     case "facebook":
       return isUsableFacebookSearchEvidenceUrl(url);
+    case "threads":
+      return isUsableThreadsSearchEvidenceUrl(url);
     default:
       return false;
   }
@@ -5865,6 +5921,10 @@ var toPositiveInt2 = (value, fallback) => {
   if (typeof value !== "number" || Number.isNaN(value)) return fallback;
   return Math.max(1, Math.floor(value));
 };
+var toNonNegativeInt2 = (value, fallback) => {
+  if (typeof value !== "number" || Number.isNaN(value)) return fallback;
+  return Math.max(0, Math.floor(value));
+};
 var isHttpUrl3 = (value) => {
   try {
     const protocol = new URL(value).protocol;
@@ -5954,11 +6014,11 @@ var mergedTraversal2 = (input, options) => {
       asNumber2(filters.pageLimit) ?? options.defaultTraversal?.pageLimit,
       DEFAULT_TRAVERSAL2.pageLimit
     ),
-    hopLimit: toPositiveInt2(
+    hopLimit: toNonNegativeInt2(
       asNumber2(filters.hopLimit) ?? options.defaultTraversal?.hopLimit,
       DEFAULT_TRAVERSAL2.hopLimit
     ),
-    expansionPerRecord: toPositiveInt2(
+    expansionPerRecord: toNonNegativeInt2(
       asNumber2(filters.expansionPerRecord) ?? options.defaultTraversal?.expansionPerRecord,
       DEFAULT_TRAVERSAL2.expansionPerRecord
     ),
@@ -7412,6 +7472,47 @@ var normalizeYouTubeVideoLink = (url) => {
   }
 };
 var YOUTUBE_SEARCH_SHELL_RE = /\b(?:about press copyright contact us creators advertise developers terms privacy policy|google for developers skip to main content youtube)\b/i;
+var YOUTUBE_FALLBACK_MIN_TEXT_CHARS = 40;
+var YOUTUBE_CONTENT_MARKER_RE = /"videoId"\s*:|"captionTracks"\s*:|itemprop="author"|itemprop="datePublished"|"viewCount"\s*:/i;
+var hasYouTubeFallbackEvidence = (html, url) => {
+  if (YOUTUBE_CONTENT_MARKER_RE.test(html)) return true;
+  return extractStructuredContent(html, url).links.some((link) => normalizeYouTubeVideoLink(link) !== null);
+};
+var reviewedFallback = (fallback, reasonCode) => ({
+  ...fallback,
+  reasonCode: reasonCode ?? fallback.reasonCode
+});
+var assertUsableYouTubeFallbackPage = (url, fallback, html) => {
+  const extracted = extractStructuredContent(html, url);
+  const text = extracted.text.trim();
+  const blocker = classifyBlockerSignal({
+    source: "runtime_fetch",
+    url,
+    message: text,
+    status: 200,
+    providerErrorCode: "unavailable",
+    retryable: true
+  });
+  if (blocker && blocker.type !== "unknown") {
+    throw toCompletedFallbackOutputError({
+      provider: "social/youtube",
+      source: "social",
+      url,
+      fallback: reviewedFallback(fallback, blocker.reasonCode),
+      outputReason: blocker.type
+    });
+  }
+  if (hasYouTubeFallbackEvidence(html, url)) return;
+  if (text.length < YOUTUBE_FALLBACK_MIN_TEXT_CHARS || YOUTUBE_SEARCH_SHELL_RE.test(text)) {
+    throw toCompletedFallbackOutputError({
+      provider: "social/youtube",
+      source: "social",
+      url,
+      fallback,
+      outputReason: "youtube_shell_or_metadata"
+    });
+  }
+};
 var extractSearchResultSegment = (html, videoId) => {
   const marker = new RegExp(`"videoId"\\s*:\\s*"${escapeRegExp(videoId)}"`);
   const match = marker.exec(html);
@@ -7514,7 +7615,7 @@ var summarizeTranscript = (transcript) => {
   const lines = transcript.split(/\n+/).map((line) => line.trim()).filter(Boolean);
   return lines.slice(0, 8).join(" ").slice(0, 800);
 };
-var fetchPage = async (url, context) => {
+var fetchPageDirect = async (url, context) => {
   let response;
   try {
     response = await fetch(url, {
@@ -7567,6 +7668,108 @@ var fetchPage = async (url, context) => {
     html: await response.text()
   };
 };
+var forcedFallbackReasonCode = (context) => {
+  const policy = context.runtimePolicy;
+  if (policy?.cookies.policy === "required") return "auth_required";
+  return "env_limited";
+};
+var fallbackReasonCodeForPageError = (error, context) => {
+  if (!isProviderRuntimeError(error)) return "env_limited";
+  if (error.code === "auth") {
+    return context.runtimePolicy?.cookies.policy === "required" ? "auth_required" : "token_required";
+  }
+  if (error.code === "rate_limited") return "rate_limited";
+  if (error.code === "network" || error.code === "timeout") return "env_limited";
+  if (error.code === "upstream") return "ip_blocked";
+  if (error.reasonCode === "ip_blocked" || error.reasonCode === "challenge_detected") return error.reasonCode;
+  return null;
+};
+var fallbackDetailsForError = (error) => {
+  if (!isProviderRuntimeError(error)) return {};
+  return {
+    errorCode: error.code,
+    message: error.message,
+    ...error.details ?? {}
+  };
+};
+var pageFromFallback = (url, fallback) => {
+  const html = readFallbackString(fallback.output, "html");
+  if (!html) {
+    throw toCompletedFallbackOutputError({
+      provider: "social/youtube",
+      source: "social",
+      url,
+      fallback,
+      outputReason: "missing_or_empty_html"
+    });
+  }
+  assertUsableYouTubeFallbackPage(url, fallback, html);
+  return {
+    status: 200,
+    url: readFallbackString(fallback.output, "url") ?? url,
+    html,
+    browserFallback: toBrowserFallbackObservation(fallback)
+  };
+};
+var resolveFallbackPage = async (args) => {
+  const fallback = await resolveProviderBrowserFallback({
+    browserFallbackPort: args.context.browserFallbackPort ?? args.options.browserFallbackPort,
+    provider: "social/youtube",
+    source: "social",
+    operation: args.operation,
+    reasonCode: args.reasonCode,
+    url: args.url,
+    context: args.context,
+    details: args.details,
+    recoveryHints: args.options.recoveryHints?.()
+  });
+  if (!fallback) return null;
+  if (fallback.disposition !== "completed") {
+    throw toProviderFallbackError({
+      provider: "social/youtube",
+      source: "social",
+      url: args.url,
+      fallback
+    });
+  }
+  return pageFromFallback(args.url, fallback);
+};
+var fetchPage = async (url, context, options, operation) => {
+  if (context.runtimePolicy?.browser.forceTransport) {
+    const page = await resolveFallbackPage({
+      url,
+      context,
+      options,
+      operation,
+      reasonCode: forcedFallbackReasonCode(context),
+      details: { message: "Direct browser transport was selected for this YouTube provider run." }
+    });
+    if (page) return page;
+    throw new ProviderRuntimeError(providerErrorCodeFromReasonCode(forcedFallbackReasonCode(context)), "Direct browser transport is required for this YouTube provider run, but no browser transport is available.", {
+      provider: "social/youtube",
+      source: "social",
+      retryable: false,
+      reasonCode: forcedFallbackReasonCode(context),
+      details: { browserTransportRequired: true }
+    });
+  }
+  try {
+    return await fetchPageDirect(url, context);
+  } catch (error) {
+    const reasonCode = fallbackReasonCodeForPageError(error, context);
+    if (!reasonCode) throw error;
+    const page = await resolveFallbackPage({
+      url,
+      context,
+      options,
+      operation,
+      reasonCode,
+      details: fallbackDetailsForError(error)
+    });
+    if (page) return page;
+    throw error;
+  }
+};
 var parseBooleanFilter = (value, fallback = false) => {
   if (typeof value === "boolean") return value;
   if (typeof value === "string") {
@@ -7609,7 +7812,7 @@ var resolveTranscriptStrategyDetail = (transcript) => {
   return transcript.attemptChain.at(-1)?.strategy;
 };
 var buildSearch = (options) => {
-  if (options) return options;
+  if (options.search) return options.search;
   return async (input, context) => {
     assertYouTubeLegalReviewChecklist();
     const query = input.query.trim();
@@ -7622,7 +7825,7 @@ var buildSearch = (options) => {
     }
     const lookupUrl = isHttpUrl4(query) ? query : `https://www.youtube.com/results?search_query=${encodeURIComponent(query)}`;
     const directUrlQuery = isHttpUrl4(query);
-    const page = await fetchPage(lookupUrl, context);
+    const page = await fetchPage(lookupUrl, context, options, "search");
     const extracted = extractStructuredContent(page.html, page.url);
     const extractedVideoLinks = [...new Set(
       extracted.links.map((link) => normalizeYouTubeVideoLink(link)).filter((link) => typeof link === "string" && link.length > 0)
@@ -7668,7 +7871,8 @@ var buildSearch = (options) => {
         retrievalPath: isHttpUrl4(query) ? "social:youtube:search:url" : "social:youtube:search:index",
         video_id: resolvedVideoId,
         ...primaryResult?.channel ? { channel: primaryResult.channel } : {},
-        links: extractedVideoLinks.slice(0, 20)
+        links: extractedVideoLinks.slice(0, 20),
+        ...browserFallbackObservationAttributes(page.browserFallback)
       }
     }];
   };
@@ -7677,7 +7881,7 @@ var buildFetch = (options) => {
   if (options.fetch) return options.fetch;
   return async (input, context) => {
     assertYouTubeLegalReviewChecklist();
-    const page = await fetchPage(input.url, context);
+    const page = await fetchPage(input.url, context, options, "fetch");
     const extracted = extractStructuredContent(page.html, page.url);
     const includeFullTranscript = parseBooleanFilter(input.filters?.include_full_transcript, false);
     const requireTranscript = parseBooleanFilter(input.filters?.requireTranscript, false);
@@ -7692,7 +7896,7 @@ var buildFetch = (options) => {
       legalChecklist: YOUTUBE_LEGAL_REVIEW_CHECKLIST,
       config: transcriptConfig,
       mode: requestedMode,
-      browserFallbackPort: options.browserFallbackPort,
+      browserFallbackPort: context.browserFallbackPort ?? options.browserFallbackPort,
       recoveryHints,
       allowBrowserFallbackEscalation: options.antiBotPolicy?.allowBrowserEscalation ?? true,
       asrTranscribe: options.asrTranscribe
@@ -7747,6 +7951,7 @@ var buildFetch = (options) => {
         transcript_mode: transcript.mode,
         translation_applied: translationApplied,
         transcript_summary: transcriptSummary,
+        ...browserFallbackObservationAttributes(page.browserFallback),
         ...includeFullTranscript ? { transcript_full: transcriptContent } : {},
         ...transcriptStrategyDetail ? { transcript_strategy_detail: transcriptStrategyDetail } : {},
         ...transcript.ok ? {
@@ -7789,7 +7994,7 @@ var withDefaultYouTubeOptions = (options = {}) => {
   };
   return {
     ...resolvedOptions,
-    search: buildSearch(resolvedOptions.search),
+    search: buildSearch(resolvedOptions),
     fetch: buildFetch(resolvedOptions)
   };
 };
@@ -7989,6 +8194,73 @@ var getShoppingRegionSupportDiagnostics = (providerIds, region) => {
   });
 };
 var hasValues2 = (values) => values.some((value) => value.trim().length > 0);
+var FALLBACK_HEAD_RE = /<head\b[^>]*>[\s\S]*?<\/head>/i;
+var FALLBACK_BODY_RE = /<body\b[^>]*>([\s\S]*?)<\/body>/i;
+var SHOPPING_FALLBACK_EVIDENCE_LIMIT = 1;
+var extractShoppingFallbackBodyText = (html) => {
+  const body = FALLBACK_BODY_RE.exec(html)?.[1];
+  return extractText(body ?? html.replace(FALLBACK_HEAD_RE, " "));
+};
+var hasShoppingMetadataEvidence = (extracted) => {
+  return extracted.metadata.price !== void 0;
+};
+var hasShoppingOfferTextEvidence = (text) => {
+  const price = parsePrice(text);
+  if (price.amount <= 0) return false;
+  return parseRating(text) > 0 || parseReviews(text) > 0 || parseAvailability(text) !== "unknown" || /\b(?:add to cart|buy now|shipping|pickup|deal|save)\b/i.test(text);
+};
+var hasShoppingBlockingPageEvidence = (url, extracted) => {
+  const blocker = classifyBlockerSignal({
+    source: "runtime_fetch",
+    url,
+    finalUrl: url,
+    title: typeof extracted.metadata.title === "string" ? extracted.metadata.title : void 0,
+    message: extracted.text,
+    status: 200,
+    providerErrorCode: "unavailable",
+    retryable: true
+  });
+  return blocker?.type === "auth_required" || blocker?.type === "anti_bot_challenge";
+};
+var hasShoppingFallbackEvidence = (args) => {
+  return args.extracted.links.some((link) => isLikelyProductUrl(canonicalizeUrl(link), args.profile)) || extractSearchCandidates(args.html, args.url, args.profile, SHOPPING_FALLBACK_EVIDENCE_LIMIT).length > 0 || hasShoppingMetadataEvidence(args.extracted) || hasShoppingOfferTextEvidence(extractShoppingFallbackBodyText(args.html)) || hasShoppingBlockingPageEvidence(args.url, args.extracted);
+};
+var toFallbackShellIssueError = (args) => {
+  const issue = classifyProviderIssue({
+    url: args.url,
+    title: args.requirement.title,
+    message: args.requirement.message,
+    providerShell: args.requirement.reason,
+    browserRequired: true,
+    status: 200
+  });
+  const reasonCode = issue?.reasonCode ?? "env_limited";
+  const extracted = extractStructuredContent(args.html, args.url);
+  return new ProviderRuntimeError(
+    providerErrorCodeFromReasonCode(reasonCode),
+    reasonCode === "challenge_detected" ? `Detected anti-bot challenge while retrieving ${args.url}` : `Browser assistance required for ${args.url}`,
+    {
+      provider: args.provider,
+      source: SHOPPING_SOURCE,
+      retryable: reasonCode === "env_limited",
+      reasonCode,
+      details: {
+        ...applyProviderIssueHint({
+          status: 200,
+          url: args.url,
+          ...args.requirement.title ? { title: args.requirement.title } : {},
+          ...args.requirement.message ? { message: args.requirement.message } : {},
+          providerShell: args.requirement.reason,
+          browserRequired: true,
+          extractionFocus: args.profile.extractionFocus,
+          extractedTextLength: extracted.text.length,
+          extractedLinkCount: extracted.links.length
+        }, issue),
+        ...browserFallbackObservationDetails(toBrowserFallbackObservation(args.fallback))
+      }
+    }
+  );
+};
 var parseIsoDate2 = (value) => {
   const parsed = Date.parse(value);
   return Number.isNaN(parsed) ? NaN : parsed;
@@ -8120,11 +8392,47 @@ var resolveBrowserFallback = async (args) => {
     };
   }
   const resolvedUrl = canonicalizeUrl(readFallbackString(fallback.output, "url") ?? args.url);
+  const html = readFallbackString(fallback.output, "html");
+  if (!html) {
+    throw toCompletedFallbackOutputError({
+      provider: args.provider,
+      source: SHOPPING_SOURCE,
+      url: resolvedUrl,
+      fallback,
+      outputReason: "missing_or_empty_html"
+    });
+  }
+  const extracted = extractStructuredContent(html, resolvedUrl);
+  const browserRequirement = requiresBrowserAssistance(args.profile, resolvedUrl, html);
+  if (browserRequirement) {
+    throw toFallbackShellIssueError({
+      provider: args.provider,
+      url: resolvedUrl,
+      html,
+      fallback,
+      profile: args.profile,
+      requirement: browserRequirement
+    });
+  }
+  if (!hasShoppingFallbackEvidence({
+    html,
+    url: resolvedUrl,
+    extracted,
+    profile: args.profile
+  })) {
+    throw toCompletedFallbackOutputError({
+      provider: args.provider,
+      source: SHOPPING_SOURCE,
+      url: resolvedUrl,
+      fallback,
+      outputReason: "empty_extracted_content"
+    });
+  }
   return {
     record: {
       status: 200,
       url: resolvedUrl,
-      html: readFallbackString(fallback.output, "html") ?? "",
+      html,
       browserFallback: toBrowserFallbackObservation(fallback)
     }
   };
@@ -8237,6 +8545,7 @@ var defaultFetcher = async ({ url, signal, provider, operation, context }) => {
       error,
       url,
       provider: providerId,
+      profile,
       operation,
       recoveryHints,
       context
@@ -8644,8 +8953,7 @@ var requiresBrowserAssistance = (profile, responseUrl, html) => {
   }
   return null;
 };
-var classifySearchPageIssue = (profile, fetched, extracted, content) => {
-  const providerShell = requiresBrowserAssistance(profile, fetched.url, fetched.html);
+var classifySearchPageIssue = (profile, fetched, extracted, content, providerShell = requiresBrowserAssistance(profile, fetched.url, fetched.html)) => {
   return classifyProviderIssue({
     url: fetched.url,
     title: providerShell?.title ?? (typeof extracted.metadata.title === "string" ? extracted.metadata.title : void 0),
@@ -8657,6 +8965,51 @@ var classifySearchPageIssue = (profile, fetched, extracted, content) => {
     retryable: true
   });
 };
+var toExplicitProviderShellIssue = (providerShell, content) => ({
+  reasonCode: "env_limited",
+  blockerType: "env_limited",
+  constraint: {
+    kind: "render_required",
+    evidenceCode: providerShell.reason,
+    providerShell: providerShell.reason,
+    ...content ? { message: content } : {}
+  }
+});
+var ensureProviderShellIssue = (issue, providerShell, content) => {
+  if (!issue || issue.reasonCode === "env_limited" && !issue.constraint) {
+    return toExplicitProviderShellIssue(providerShell, content);
+  }
+  return issue;
+};
+var toShoppingPageIssueMessage = (reasonCode, url) => {
+  if (reasonCode === "token_required") return `Authentication required for ${url}`;
+  if (reasonCode === "env_limited") return `Browser assistance required for ${url}`;
+  return `Detected anti-bot challenge while retrieving ${url}`;
+};
+var throwShoppingPageIssue = (args) => {
+  const reasonCode = args.pageIssue.reasonCode;
+  throw new ProviderRuntimeError(
+    providerErrorCodeFromReasonCode(reasonCode),
+    toShoppingPageIssueMessage(reasonCode, args.fetched.url),
+    {
+      provider: args.providerId,
+      source: SHOPPING_SOURCE,
+      retryable: reasonCode === "env_limited",
+      reasonCode,
+      details: {
+        ...applyProviderIssueHint({
+          status: args.fetched.status,
+          url: args.fetched.url,
+          ...typeof args.extracted.metadata.title === "string" ? { title: args.extracted.metadata.title } : {},
+          ...args.content ? { message: args.content } : {},
+          ...args.providerShell?.reason ? { providerShell: args.providerShell.reason } : {}
+        }, args.pageIssue),
+        ...args.providerShell?.reason ? { browserRequired: true } : {},
+        ...browserFallbackObservationDetails(args.fetched.browserFallback)
+      }
+    }
+  );
+};
 var unwrapTrackingUrl = (url, profile) => {
   const normalizedUrl = decodeHrefValue(url);
   try {
@@ -9054,6 +9407,7 @@ var createDefaultSearch = (profile, providerId, fetcher) => async (input, contex
     context
   });
   const extracted = extractStructuredContent(fetched.html, fetched.url);
+  const providerShell = requiresBrowserAssistance(profile, fetched.url, fetched.html);
   const limit = Math.max(1, Math.min(input.limit ?? 10, 20));
   const links = dedupeLinks(
     extracted.links.filter((link) => isLikelyProductUrl(canonicalizeUrl(link), profile)),
@@ -9061,7 +9415,17 @@ var createDefaultSearch = (profile, providerId, fetcher) => async (input, contex
   );
   const content = toSnippet(extracted.text, 2e3);
   const candidates = extractSearchCandidates(fetched.html, fetched.url, profile, limit);
-  const pageIssue = candidates.length === 0 ? classifySearchPageIssue(profile, fetched, extracted, content) : null;
+  const pageIssue = providerShell ? classifySearchPageIssue(profile, fetched, extracted, content, providerShell) : candidates.length === 0 ? classifySearchPageIssue(profile, fetched, extracted, content, providerShell) : null;
+  if (providerShell) {
+    throwShoppingPageIssue({
+      providerId,
+      fetched,
+      extracted,
+      content,
+      pageIssue: ensureProviderShellIssue(pageIssue, providerShell, content),
+      providerShell
+    });
+  }
   if (candidates.length > 0) {
     return candidates.map((candidate, index) => ({
       url: candidate.url,
@@ -9096,28 +9460,7 @@ var createDefaultSearch = (profile, providerId, fetcher) => async (input, contex
     }));
   }
   if (pageIssue && (pageIssue.reasonCode !== "env_limited" || pageIssue.constraint)) {
-    const reasonCode = pageIssue.reasonCode;
-    const providerShell = requiresBrowserAssistance(profile, fetched.url, fetched.html);
-    throw new ProviderRuntimeError(
-      providerErrorCodeFromReasonCode(reasonCode),
-      reasonCode === "token_required" ? `Authentication required for ${fetched.url}` : `Detected anti-bot challenge while retrieving ${fetched.url}`,
-      {
-        provider: providerId,
-        source: SHOPPING_SOURCE,
-        retryable: reasonCode === "env_limited",
-        reasonCode,
-        details: {
-          ...applyProviderIssueHint({
-            status: fetched.status,
-            url: fetched.url,
-            ...typeof extracted.metadata.title === "string" ? { title: extracted.metadata.title } : {},
-            ...content ? { message: content } : {},
-            ...providerShell?.reason ? { providerShell: providerShell.reason } : {}
-          }, pageIssue),
-          ...browserFallbackObservationDetails(fetched.browserFallback)
-        }
-      }
-    );
+    throwShoppingPageIssue({ providerId, fetched, extracted, content, pageIssue, providerShell });
   }
   const rows = [
     {
@@ -9828,7 +10171,7 @@ var enrichResearchRecords = (records, timebox, now = /* @__PURE__ */ new Date())
   return records.map((record) => toResearchRecord(record, timebox, now));
 };
 
-// src/providers/inspiredesign-contract.ts
+// src/inspiredesign/contract.ts
 import { createHash as createHash3 } from "crypto";
 
 // skills/opendevbrowser-design-agent/assets/templates/canvas-generation-plan.design.v1.json
@@ -10023,7 +10366,13 @@ var design_contract_v1_default = {
       "section reveal",
       "primary CTA feedback"
     ],
-    parallaxPolicy: "off unless explicitly justified"
+    parallaxPolicy: "off unless explicitly justified",
+    advancedMotionAdvisory: [
+      "Advisory shader-like gradient depth: describe intent only; implement with approved runtime primitives unless a separate runtime change authorizes more.",
+      "Advisory WebGL-style spatial reveal: document depth and hierarchy without implying WebGL runtime support.",
+      "Advisory Spline-style product orbit: document scene posture and static fallback without approving custom 3D runtime dependencies.",
+      "Runtime boundary: libraryPolicy.motion and libraryPolicy.threeD stay empty unless separately approved."
+    ]
   },
   performanceModel: {
     renderHotspots: [
@@ -10116,6 +10465,14 @@ var design_contract_v1_default = {
         "spinner-stacking",
         "scan-surface-jank"
       ]
+    },
+    designVectors: {
+      advancedMotionAdvisory: [
+        "Advisory shader-like gradient depth",
+        "Advisory WebGL-style spatial reveal",
+        "Advisory Spline-style product orbit",
+        "Runtime support: none. Library policy authorization: none."
+      ]
     }
   }
 };
@@ -10155,10 +10512,176 @@ var INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS = [
   formatSkillReference(INSPIREDESIGN_HANDOFF_SKILLS.designAgent)
 ];
 var INSPIREDESIGN_HANDOFF_GUIDANCE = {
-  reviewAdvancedBrief: `${INSPIREDESIGN_HANDOFF_FILES.advancedBrief} is the authoritative prompt route for the selected format, profile defaults, layout posture, motion grammar, and anti-patterns. Read it before touching Canvas or implementation files.`,
+  reviewAdvancedBrief: `${INSPIREDESIGN_HANDOFF_FILES.advancedBrief} is the authoritative reference-first brief. When URL references exist, captured evidence leads the creative direction; selected format, profile defaults, layout posture, motion grammar, and anti-patterns are route guardrails only. Read it before touching Canvas or implementation files.`,
   prepareCanvasPlanRequest: `Fill canvasSessionId, leaseId, and documentId in ${INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest} before running ${INSPIREDESIGN_HANDOFF_COMMANDS.continueInCanvas}.`,
   deepCaptureRecommendation: "Any inspiredesign run with reference URLs already uses captureMode=deep. Rerun with the same URLs only when you need refreshed DOM/layout evidence, restored session state, or capture-specific debugging."
 };
+var INSPIREDESIGN_ARTIFACT_GUIDE = {
+  [INSPIREDESIGN_HANDOFF_FILES.advancedBrief]: {
+    purpose: "Authoritative reference-first brief for the downstream design agent.",
+    expectedContents: ["Selected prompt format", "reference pattern board", "route guardrails"],
+    howToUse: ["Read first", "treat captured evidence as creative priority", "use guardrails to avoid route drift"],
+    mustNot: ["Do not treat defaults as stronger than captured references"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.designMarkdown]: {
+    purpose: "Human-readable design specification and implementation narrative.",
+    expectedContents: ["inspiration analysis", "unified direction", "governance summary", "deliverables"],
+    howToUse: ["Use as the readable project brief", "cross-check implementation choices against its sections"],
+    mustNot: ["Do not use prose as a substitute for the JSON contract when patching Canvas"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.designContract]: {
+    purpose: "Narrowed Canvas governance contract for design decisions.",
+    expectedContents: ["emitted governance blocks", "motion system", "library policy", "runtime budgets"],
+    howToUse: ["Patch only emitted governance blocks", "compare implementation against this contract before shipping"],
+    mustNot: ["Do not add navigation, async, or performance context as Canvas governance patches"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest]: {
+    purpose: "Ready-to-fill request payload for `canvas.plan.set`.",
+    expectedContents: ["request ids", "Canvas session ids", "mutation-safe generationPlan"],
+    howToUse: ["Fill canvasSessionId, leaseId, and documentId", "submit with the provided canvas.plan.set command"],
+    mustNot: ["Do not add handoff-only fields or reference-only analysis to generationPlan"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.designAgentHandoff]: {
+    purpose: "Downstream index for artifact usage, skills, commands, and omitted implementation context.",
+    expectedContents: ["skills", "commands", "contract scope", "implementation context", "artifact and section guides"],
+    howToUse: ["Use as the navigation map for the bundle", "load recommended skills before implementation"],
+    mustNot: ["Do not treat handoff context as runtime Canvas schema"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.generationPlan]: {
+    purpose: "Full generated plan for reasoning about design intent.",
+    expectedContents: ["Canvas plan fields", "design vectors", "reference analysis when available"],
+    howToUse: ["Use for agent reasoning and audit traceability", "compare with canvas-plan.request.json for runtime subset"],
+    mustNot: ["Do not submit this file directly to Canvas when it contains non-request context"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.implementationPlanMarkdown]: {
+    purpose: "Human-readable engineering sequence for the first implementation pass.",
+    expectedContents: ["build sequence", "component plan", "token strategy", "QA and risk checks"],
+    howToUse: ["Convert sections into implementation tasks", "keep tests and browser validation aligned to the plan"],
+    mustNot: ["Do not implement sections unsupported by brief or reference evidence"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.implementationPlan]: {
+    purpose: "Machine-readable implementation plan matching the Markdown plan.",
+    expectedContents: ["architecture steps", "component inventory", "state and validation tasks"],
+    howToUse: ["Use for structured task extraction", "keep it synchronized with implementation-plan.md"],
+    mustNot: ["Do not treat it as a Canvas document patch payload"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.evidence]: {
+    purpose: "Evidence digest for brief, reference, capture, and design-vector provenance.",
+    expectedContents: ["brief expansion", "reference outcomes", "capture attempts", "design vectors"],
+    howToUse: ["Audit why choices were made", "prefer evidence over generic template defaults"],
+    mustNot: ["Do not ignore failed or skipped capture statuses when judging confidence"]
+  },
+  [INSPIREDESIGN_HANDOFF_FILES.prototypeGuidance]: {
+    purpose: "Optional first prototype guidance when the workflow requests prototype output.",
+    expectedContents: ["prototype structure", "design-vector guidance", "browser proof checklist"],
+    howToUse: ["Use only for the first prototype pass", "promote proven ideas back into contract-aligned work"],
+    mustNot: ["Do not treat prototype guidance as final implementation authority"]
+  }
+};
+var INSPIREDESIGN_CONTRACT_SECTION_GUIDE = {
+  intent: {
+    purpose: "Define why the design exists and what success means.",
+    expectedContents: ["audience", "task", "success criteria", "trust posture"],
+    howToUse: ["Validate the primary user job before styling", "reject sections that do not serve the task"],
+    mustNot: ["Do not start visual polish before the audience and task are clear"]
+  },
+  generationPlan: {
+    purpose: "Mutation-safe subset accepted by Canvas planning.",
+    expectedContents: ["target outcome", "visual, layout, content, component, motion, responsive, accessibility posture"],
+    howToUse: ["Submit only through canvas-plan.request.json", "repair generationPlanIssues before mutation"],
+    mustNot: ["Do not add handoff-only guide fields to the Canvas generation plan"]
+  },
+  designLanguage: {
+    purpose: "Name the coherent visual direction and token ownership.",
+    expectedContents: ["direction", "style axes", "semantic token source", "approved libraries"],
+    howToUse: ["Keep one design language per task", "align repeated components to semantic tokens"],
+    mustNot: ["Do not mix unrelated visual families inside one surface"]
+  },
+  contentModel: {
+    purpose: "Define real content, message hierarchy, and UI states.",
+    expectedContents: ["primary message", "supporting messages", "states", "loading, empty, and error behavior"],
+    howToUse: ["Use real content first", "plan non-happy-path states before polish"],
+    mustNot: ["Do not ship placeholder copy as product content"]
+  },
+  layoutSystem: {
+    purpose: "Describe page architecture and section rhythm.",
+    expectedContents: ["grid", "containers", "spacing rhythm", "alignment rules"],
+    howToUse: ["Use to place sections and scan units consistently", "verify desktop and mobile structure"],
+    mustNot: ["Do not invent one-off layout rules for repeated sections"]
+  },
+  typographySystem: {
+    purpose: "Define type families, scale, measure, and loading behavior.",
+    expectedContents: ["families", "scale", "measure", "fallback policy", "loading strategy"],
+    howToUse: ["Apply type hierarchy consistently", "avoid layout shift from font loading"],
+    mustNot: ["Do not default to unapproved system stacks for a distinctive design"]
+  },
+  colorSystem: {
+    purpose: "Define semantic color roles and theme behavior.",
+    expectedContents: ["primary roles", "surface roles", "text roles", "state colors"],
+    howToUse: ["Map repeated UI to semantic tokens", "validate contrast in every required theme"],
+    mustNot: ["Do not scatter raw color values across leaf components"]
+  },
+  surfaceSystem: {
+    purpose: "Define material, depth, borders, and background behavior.",
+    expectedContents: ["surface hierarchy", "border rules", "shadow rules", "material effects"],
+    howToUse: ["Use depth only to clarify hierarchy", "align material effects with design vectors"],
+    mustNot: ["Do not turn every content group into a card by default"]
+  },
+  iconSystem: {
+    purpose: "Define icon usage and decorative asset boundaries.",
+    expectedContents: ["icon family", "stroke policy", "labeling rules", "decorative rules"],
+    howToUse: ["Use icons to clarify actions", "keep accessible names on icon-only controls"],
+    mustNot: ["Do not rely on icons as the only explanation for critical actions"]
+  },
+  motionSystem: {
+    purpose: "Define motion that supports comprehension.",
+    expectedContents: ["timing", "interaction moments", "reduced-motion posture", "advanced motion advisory"],
+    howToUse: ["Keep shader, WebGL, and Spline cues advisory", "provide reduced-motion replacements"],
+    mustNot: ["Do not use motion cues to authorize new runtime libraries"]
+  },
+  responsiveSystem: {
+    purpose: "Define authored behavior across desktop, tablet, and mobile.",
+    expectedContents: ["breakpoints", "adaptation rules", "touch policy", "overflow policy"],
+    howToUse: ["Validate the primary action at every viewport", "collapse structure before copy becomes cramped"],
+    mustNot: ["Do not assume desktop layouts naturally scale down"]
+  },
+  accessibilityPolicy: {
+    purpose: "Set accessibility requirements before implementation.",
+    expectedContents: ["WCAG target", "keyboard requirements", "focus policy", "semantic requirements"],
+    howToUse: ["Block release on contrast or keyboard regressions", "validate focus on every interactive state"],
+    mustNot: ["Do not defer accessibility until after visual implementation"]
+  },
+  libraryPolicy: {
+    purpose: "Declare approved implementation libraries and runtime boundaries.",
+    expectedContents: ["components", "icons", "styling", "motion", "threeD"],
+    howToUse: ["Use as the dependency authorization boundary", "keep motion and threeD empty unless separately approved"],
+    mustNot: ["Do not infer WebGL, shader, Spline, or 3D runtime support from advisory motion"]
+  },
+  runtimeBudgets: {
+    purpose: "Set practical limits for sections, actions, interaction latency, and preview cost.",
+    expectedContents: ["section budgets", "action budgets", "latency budgets", "preview notes"],
+    howToUse: ["Use as a constraint during implementation", "validate slow or animation-heavy surfaces against it"],
+    mustNot: ["Do not add decorative weight that violates the budget"]
+  },
+  navigationModel: {
+    purpose: "Implementation-only context for route, tab, overlay, and deep-link ownership.",
+    expectedContents: ["route owner", "deep-link policy", "invalid route fallback", "overlay entry points"],
+    howToUse: ["Use from design-agent-handoff.json when wiring implementation state"],
+    mustNot: ["Do not patch this omitted block into Canvas governance"]
+  },
+  asyncModel: {
+    purpose: "Implementation-only context for loading, restart, cancellation, and URL-owned query state.",
+    expectedContents: ["owner", "load trigger", "restart triggers", "cancellation policy"],
+    howToUse: ["Use when wiring fetch/search state and stale-request handling"],
+    mustNot: ["Do not let components invent independent async ownership"]
+  },
+  performanceModel: {
+    purpose: "Implementation-only context for render hotspots and measurement posture.",
+    expectedContents: ["render hotspots", "stable identity policy", "list strategy", "measurement plan"],
+    howToUse: ["Use before building scan-heavy or motion-heavy surfaces"],
+    mustNot: ["Do not ship heavy interaction surfaces without measurement evidence"]
+  }
+};
 var buildInspiredesignFollowthroughSummary = () => `Read ${INSPIREDESIGN_HANDOFF_FILES.advancedBrief} first, then continue in OpenDevBrowser Canvas with ${INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest} and ${INSPIREDESIGN_HANDOFF_FILES.designAgentHandoff}, load ${INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS[0]} plus ${INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS[1]} before implementation, and note that any supplied reference URL already uses captureMode=deep.`;
 var buildInspiredesignNextStep = () => `Read ${INSPIREDESIGN_HANDOFF_FILES.advancedBrief} first. ${INSPIREDESIGN_HANDOFF_GUIDANCE.prepareCanvasPlanRequest} Then run ${INSPIREDESIGN_HANDOFF_COMMANDS.continueInCanvas}, confirm planStatus=accepted, then patch only the governance blocks listed in ${INSPIREDESIGN_HANDOFF_FILES.designAgentHandoff}.`;
 
@@ -10169,11 +10692,14 @@ var inspiredesign_advanced_brief_v1_default = {
   commonRules: [
     "Preserve only the product, brand, audience, platform, and tone cues that are explicitly present in the source brief.",
     "Treat missing details as open constraints instead of inventing brand facts or user needs.",
-    "Use inspiration references to extract transferable design logic rather than copying a single layout, visual treatment, or narrative beat literally."
+    "Use inspiration references to extract transferable design logic rather than copying a single layout, visual treatment, or narrative beat literally.",
+    "Treat shader, WebGL, Spline-style, and 3D motion ideas as advisory design cues only, not as runtime support or dependency approval.",
+    "Carry accepted advanced motion cues in designVectors and motionSystem as intent, and keep libraryPolicy authorization separate."
   ],
   outputRequirements: [
     "Return a reusable design contract that can drive design.md, implementation-plan artifacts, and a Canvas-ready prototype path.",
-    "Keep the direction premium, specific, and implementable instead of generic or template-driven."
+    "Keep the direction premium, specific, and implementable instead of generic or template-driven.",
+    "Keep libraryPolicy.motion and libraryPolicy.threeD empty in generated samples unless a separate runtime change explicitly approves those libraries."
   ],
   formats: [
     {
@@ -10182,12 +10708,15 @@ var inspiredesign_advanced_brief_v1_default = {
       bestFor: [
         "product homepages",
         "docs homepages",
+        "consulting service homepages",
         "launch pages",
         "rebrands"
       ],
       businessFocus: [
         "premium SaaS marketing",
         "product launches",
+        "AI consulting services",
+        "enterprise advisory landing pages",
         "docs-first brands",
         "brand refresh surfaces"
       ],
@@ -10199,6 +10728,11 @@ var inspiredesign_advanced_brief_v1_default = {
         "editorial",
         "hero",
         "marketing",
+        "consulting",
+        "advisory",
+        "enterprise AI",
+        "services",
+        "case studies",
         "docs"
       ],
       matchSignals: {
@@ -10212,6 +10746,16 @@ var inspiredesign_advanced_brief_v1_default = {
           "editorial",
           "hero",
           "marketing",
+          "consulting",
+          "advisory",
+          "ai consulting",
+          "enterprise ai",
+          "business services",
+          "client services",
+          "case studies",
+          "transformation",
+          "services",
+          "cta",
           "docs"
         ],
         excluded: [
@@ -10219,7 +10763,7 @@ var inspiredesign_advanced_brief_v1_default = {
           "admin",
           "onboarding"
         ],
-        tieBreaker: 1
+        tieBreaker: 2
       },
       lead: "Study the inspiration references and synthesize a premium editorial landing page system that translates the source brief into a reusable, brand-specific direction.",
       archetype: "editorial brand campaign",
@@ -10638,17 +11182,22 @@ var inspiredesign_advanced_brief_v1_default = {
       label: "Maison campaign world",
       bestFor: [
         "luxury fashion",
+        "fashion design studios",
         "fragrance launches",
         "jewelry campaigns",
         "premium hospitality brands"
       ],
       businessFocus: [
         "fashion maisons",
+        "fashion design studios",
         "luxury accessories",
         "fragrance campaigns",
         "high-end hospitality identity"
       ],
       keywords: [
+        "fashion",
+        "fashion design",
+        "fashion studio",
         "maison",
         "atelier",
         "collection",
@@ -10660,6 +11209,9 @@ var inspiredesign_advanced_brief_v1_default = {
       ],
       matchSignals: {
         positive: [
+          "fashion",
+          "fashion design",
+          "fashion studio",
           "maison",
           "atelier",
           "collection",
@@ -10904,7 +11456,7 @@ var inspiredesign_advanced_brief_v1_default = {
     },
     {
       id: "luminous-research-atlas",
-      label: "Luminous research atlas",
+      label: "Luminous insight landing page",
       bestFor: [
         "AI labs",
         "think tanks",
@@ -10914,15 +11466,14 @@ var inspiredesign_advanced_brief_v1_default = {
       businessFocus: [
         "research organizations",
         "evidence-led storytelling",
-        "atlas and observatory products",
-        "methodology-rich publications"
+        "insight-led public landing pages",
+        "visual research narratives"
       ],
       keywords: [
         "atlas",
         "observatory",
-        "methodology",
+        "insight",
         "evidence",
-        "report",
         "research",
         "index",
         "publication"
@@ -10931,9 +11482,8 @@ var inspiredesign_advanced_brief_v1_default = {
         positive: [
           "atlas",
           "observatory",
-          "methodology",
+          "insight",
           "evidence",
-          "report",
           "research",
           "map",
           "model",
@@ -10943,37 +11493,43 @@ var inspiredesign_advanced_brief_v1_default = {
         excluded: [
           "checkout",
           "festival",
-          "villa"
+          "villa",
+          "consulting",
+          "advisory",
+          "bcg",
+          "services",
+          "landing page",
+          "homepage"
         ],
-        tieBreaker: 3
+        tieBreaker: 1
       },
-      lead: "Study the inspiration references and synthesize a luminous research atlas that turns evidence, methodology, and narrative into a premium, readable system.",
-      archetype: "annotated evidence atlas",
-      layoutArchetype: "bright scroll atlas with chaptered evidence bands and annotation rails",
+      lead: "Study the inspiration references and synthesize a luminous insight landing page that turns research-backed ideas into a premium, text-light public story.",
+      archetype: "luminous insight landing page",
+      layoutArchetype: "full-bleed insight story with visual proof bands",
       typographySystem: "precise sans for data and narrative paired with restrained serif emphasis",
-      surfaceTreatment: "ivory research planes, layered evidence visuals, and quiet annotation rails",
-      shapeLanguage: "clean modules, chart frames, citation bars, and highlighted note rails",
-      componentGrammar: "evidence chapters, methodology blocks, chart plates, callout annotations, citation modules",
-      motionGrammar: "zoom-and-highlight transitions, subtle annotation reveals, and calm data emphasis",
+      surfaceTreatment: "ivory research planes, layered evidence visuals, and generous image-led whitespace",
+      shapeLanguage: "clean modules, visual proof frames, and quiet emphasis bands",
+      componentGrammar: "hero composition, insight proof bands, visual story panels, outcome moments, restrained CTA groups",
+      motionGrammar: "calm reveal transitions, proof-panel emphasis, and restrained visual depth",
       paletteIntent: "bright ivory base with measured accent coding for evidence groups",
       visualDensity: "balanced",
       designVariance: "structured expressiveness",
       focusAreas: [
         "evidence hierarchy",
-        "methodology framing",
-        "annotation rails",
-        "chart grammar",
-        "citation treatment",
+        "insight framing",
+        "visual proof bands",
+        "chart restraint",
+        "public story cadence",
         "scroll-story beats",
         "proof sequencing"
       ],
       responsiveCollapseRules: [
-        "Collapse annotation rails beneath the primary evidence block before reducing chart legibility.",
-        "Keep citations attached to the relevant section on mobile instead of moving them to a distant appendix treatment."
+        "Collapse visual proof bands into a single readable story stack before reducing chart legibility.",
+        "Keep evidence labels visually close to the relevant section without turning mobile into an appendix."
       ],
       guardrails: [
-        "Keep the surface bright, exact, and evidence-first rather than dashboard-like or cyber-styled.",
-        "Use motion only to clarify how the user should read charts, maps, and methodology layers."
+        "Keep the surface bright, exact, and evidence-led without becoming a documentation hub.",
+        "Use motion to clarify priority, proof, and action rather than to explain long-form methodology."
       ],
       antiPatterns: [
         "No cyber glow.",
@@ -10982,14 +11538,14 @@ var inspiredesign_advanced_brief_v1_default = {
         "No unexplained iconography."
       ],
       deliverables: [
-        "Define the evidence hierarchy, chart grammar, annotation system, citation treatment, and scroll-story beats.",
-        "Return a premium research contract detailed enough for publication surfaces and Canvas-ready implementation."
+        "Define the evidence hierarchy, visual proof rhythm, insight story cadence, and conversion path.",
+        "Return a premium insight landing contract detailed enough for a visually led Canvas-ready implementation."
       ],
       route: {
-        profile: "documentation",
+        profile: "product-story",
         themeStrategy: "single-theme",
-        navigationModel: "contextual",
-        layoutApproach: "annotated-atlas-scroll"
+        navigationModel: "global-header",
+        layoutApproach: "insight-led-landing-page"
       }
     },
     {
@@ -11304,7 +11860,13 @@ var inspiredesign_advanced_brief_v1_default = {
         excluded: [
           "villa",
           "festival",
-          "fragrance"
+          "fragrance",
+          "fashion",
+          "fashion design",
+          "maison",
+          "couture",
+          "collection",
+          "campaign"
         ],
         tieBreaker: 3
       },
@@ -11537,6 +12099,8 @@ var inspiredesign_advanced_brief_v1_default = {
 // src/inspiredesign/brief-expansion.ts
 var BRIEF_TEMPLATE = inspiredesign_advanced_brief_v1_default;
 var INSPIREDESIGN_BRIEF_TEMPLATE_VERSION = BRIEF_TEMPLATE.version;
+var INSPIREDESIGN_BRIEF_COMMON_RULES = [...BRIEF_TEMPLATE.commonRules];
+var INSPIREDESIGN_BRIEF_OUTPUT_REQUIREMENTS = [...BRIEF_TEMPLATE.outputRequirements];
 var normalizeInspiredesignBriefText = (value) => value.trim().replace(/\s+/g, " ");
 var formatBulletList = (items) => items.map((item) => `- ${item}`).join("\n");
 var countMatches = (brief, keywords) => {
@@ -11546,6 +12110,20 @@ var countMatches = (brief, keywords) => {
     0
   );
 };
+var escapeRegExp2 = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var removeNegativeSignal = (brief, keyword) => {
+  const escaped = escapeRegExp2(keyword.toLowerCase());
+  const modifiers = "(?:[a-z0-9-]+\\s+){0,3}";
+  return brief.replace(new RegExp(`\\b(?:not|no|without|avoid|exclude|excluding)\\s+(?:an?\\s+|the\\s+)?${modifiers}${escaped}\\b(?:\\s+[a-z0-9-]+){0,2}`, "g"), " ").replace(new RegExp(`\\b${escaped}\\s+(?:is\\s+)?(?:not|excluded|forbidden)\\b`, "g"), " ");
+};
+var positiveSignalText = (brief, formats) => {
+  const keywords = formats.flatMap((format) => [
+    ...format.matchSignals.positive,
+    ...format.matchSignals.required ?? [],
+    ...format.matchSignals.excluded ?? []
+  ]);
+  return [...new Set(keywords)].reduce(removeNegativeSignal, brief.toLowerCase());
+};
 var cloneStringList = (items) => [...items];
 var cloneRoute = (route) => ({
   profile: route.profile,
@@ -11569,6 +12147,7 @@ var cloneInspiredesignBriefFormat = (format) => ({
   paletteIntent: format.paletteIntent,
   visualDensity: format.visualDensity,
   designVariance: format.designVariance,
+  focusAreas: cloneStringList(format.focusAreas ?? []),
   responsiveCollapseRules: cloneStringList(format.responsiveCollapseRules),
   guardrails: cloneStringList(format.guardrails),
   antiPatterns: cloneStringList(format.antiPatterns),
@@ -11591,6 +12170,7 @@ var summarizeFormat = (format) => ({
   paletteIntent: format.paletteIntent,
   visualDensity: format.visualDensity,
   designVariance: format.designVariance,
+  focusAreas: cloneStringList(format.focusAreas),
   responsiveCollapseRules: cloneStringList(format.responsiveCollapseRules),
   guardrails: cloneStringList(format.guardrails),
   antiPatterns: cloneStringList(format.antiPatterns),
@@ -11611,12 +12191,13 @@ var findFormatById = (formatId) => {
   return BRIEF_TEMPLATE.formats.find((format) => format.id === formatId);
 };
 var scoreFormat = (sourceBrief, format) => {
-  const requiredMatches = countMatches(sourceBrief, format.matchSignals.required ?? []);
+  const brief = positiveSignalText(sourceBrief, BRIEF_TEMPLATE.formats);
+  const requiredMatches = countMatches(brief, format.matchSignals.required ?? []);
   if ((format.matchSignals.required?.length ?? 0) > 0 && requiredMatches === 0) {
     return Number.NEGATIVE_INFINITY;
   }
-  const excludedMatches = countMatches(sourceBrief, format.matchSignals.excluded ?? []);
-  const positiveMatches = countMatches(sourceBrief, format.matchSignals.positive);
+  const excludedMatches = countMatches(brief, format.matchSignals.excluded ?? []);
+  const positiveMatches = countMatches(brief, format.matchSignals.positive);
   return positiveMatches * 4 + requiredMatches * 6 - excludedMatches * 8 + (format.matchSignals.tieBreaker ?? 0);
 };
 var chooseFormat = (sourceBrief) => {
@@ -11706,10 +12287,390 @@ var expandInspiredesignBrief = (brief, preferredFormatId) => {
   };
 };
 
-// src/providers/inspiredesign-contract.ts
-var INSPIREDESIGN_CAPTURE_ATTEMPT_KEYS = ["snapshot", "clone", "dom"];
-var MALFORMED_CAPTURE_ATTEMPT_DETAIL = "Capture attempt metadata missing or malformed.";
-var NORMALIZED_CAPTURE_ATTEMPT_DETAIL = "Captured artifact was empty after normalization.";
+// src/inspiredesign/reference-pattern-board.ts
+var SIGNAL_LIMIT = 5;
+var SIGNAL_CLIP = 180;
+var PATTERN_LIMIT = 6;
+var ADVANCED_MOTION_FIELDS = [
+  "Advisory shader-style gradients: specify effect type, uniforms, static fallback, and reduced-motion replacement as design language only.",
+  "Advisory WebGL-style depth cues: describe layered depth, camera-like parallax, and spatial hierarchy without requiring WebGL runtime.",
+  "Advisory Spline-style staging: describe object-like hero composition, scene count, camera posture, depth model, asset source, and spatial sequencing as implementation guidance only.",
+  "Advanced motion performance policy: define frame budget, lazy loading, offscreen pause behavior, and vestibular risk before implementation.",
+  "Runtime boundary: implement with approved CSS and Canvas-safe primitives unless explicit source-owned runtime support is added later."
+];
+var trimText = (value) => value.trim().replace(/\s+/g, " ");
+var clipText = (value, maxLength) => {
+  if (value.length <= maxLength) return value;
+  return `${value.slice(0, Math.max(0, maxLength - 3)).trimEnd()}...`;
+};
+var textFromHtml = (html) => {
+  return html ? trimText(html.replace(/<[^>]+>/g, " ")) : void 0;
+};
+var stripActionRefs = (value) => value.replace(/\[r\d+\]\s+(?:link|button|combobox|textbox|option)\s+/gi, "").replace(/\[r\d+\]\s+/gi, "").replace(/\bvalue=/gi, "");
+var isCodeOrCssPreview = (value) => {
+  const lower = value.toLowerCase();
+  return lower.includes("dangerouslysetinnerhtml") || lower.includes("opendevbrowser-root") || lower.includes("align-content:") || lower.startsWith("import ") || /^[.#][a-z0-9_-]+\s*\{/.test(lower) || lower.includes("{") && /[a-z-]+:\s*[^;]+;/.test(lower);
+};
+var cleanEvidenceText = (value) => {
+  return trimText(stripActionRefs(value).replace(/[{};]/g, " "));
+};
+var DIAGNOSTIC_TEXT_MARKERS = [
+  "authentication required",
+  "sign in",
+  "login required",
+  "challenge page",
+  "access denied",
+  "browser capture unavailable",
+  "javascript required",
+  "javascript is required",
+  "captcha",
+  "verification challenge",
+  "enable cookies",
+  "checking if the site connection is secure",
+  "complete the verification",
+  "blocked reference"
+];
+var PUBLIC_LANDING_TEXT_MARKERS = [
+  "church",
+  "landing page",
+  "homepage",
+  "home page",
+  "consulting",
+  "advisory",
+  "bcg",
+  "ai consulting",
+  "enterprise ai",
+  "transformation",
+  "client services",
+  "business services",
+  "case studies",
+  "clients",
+  "industries",
+  "worship",
+  "locations",
+  "gallery",
+  "atelier",
+  "fashion"
+];
+var PUBLIC_LANDING_SUPPORT_MARKERS = [
+  "online",
+  "events",
+  "studio",
+  "website",
+  "full-bleed",
+  "hero",
+  "story",
+  "stories",
+  "services",
+  "service",
+  "cta"
+];
+var isDiagnosticText = (value) => {
+  const lower = value.toLowerCase();
+  return DIAGNOSTIC_TEXT_MARKERS.some((marker) => lower.includes(marker));
+};
+var hasPublicLandingSignal = (value) => {
+  const lower = value.toLowerCase();
+  const strongCount = PUBLIC_LANDING_TEXT_MARKERS.filter((marker) => lower.includes(marker)).length;
+  const supportCount = PUBLIC_LANDING_SUPPORT_MARKERS.filter((marker) => lower.includes(marker)).length;
+  const visualLandingCombo = lower.includes("hero") && (lower.includes("full-bleed") || lower.includes("cta") || lower.includes("website"));
+  return visualLandingCombo || strongCount >= 2 || strongCount >= 1 && strongCount + supportCount >= 2;
+};
+var pushSignal = (signals, value) => {
+  if (!value || isCodeOrCssPreview(value)) return;
+  const text = cleanEvidenceText(value);
+  if (isCodeOrCssPreview(text) || isDiagnosticText(text)) return;
+  if (text.length > 0 && !signals.includes(text)) {
+    signals.push(text);
+  }
+};
+var getInspiredesignReferenceSignals = (reference) => {
+  const signals = [];
+  pushSignal(signals, reference.title);
+  pushSignal(signals, reference.excerpt);
+  pushSignal(signals, reference.capture?.title);
+  pushSignal(signals, reference.capture?.snapshot?.content);
+  pushSignal(signals, textFromHtml(reference.capture?.clone?.componentPreview));
+  pushSignal(signals, reference.capture?.clone?.cssPreview);
+  pushSignal(signals, textFromHtml(reference.capture?.dom?.outerHTML));
+  return signals.map((signal) => clipText(signal, SIGNAL_CLIP)).slice(0, SIGNAL_LIMIT);
+};
+var hasCleanSignal = (value) => {
+  if (!value || isCodeOrCssPreview(value)) return false;
+  const text = cleanEvidenceText(value);
+  return text.length > 0 && !isCodeOrCssPreview(text) && !isDiagnosticText(text);
+};
+var hasUsableCloneCreativeEvidence = (reference) => hasCleanSignal(reference.capture?.clone?.componentPreview);
+var hasUsableCaptureEvidence = (reference) => hasCleanSignal(reference.capture?.snapshot?.content) || hasUsableCloneCreativeEvidence(reference) || hasCleanSignal(textFromHtml(reference.capture?.dom?.outerHTML));
+var hasInspiredesignUsableReferenceEvidence = (reference) => {
+  if (reference.captureStatus === "captured" && hasUsableCaptureEvidence(reference)) return true;
+  return reference.fetchStatus === "captured" && (hasCleanSignal(reference.title) || hasCleanSignal(reference.excerpt));
+};
+var firstSignal = (reference) => {
+  const preferred = [
+    reference.capture?.title,
+    reference.capture?.snapshot?.content,
+    textFromHtml(reference.capture?.clone?.componentPreview),
+    textFromHtml(reference.capture?.dom?.outerHTML),
+    reference.excerpt,
+    reference.title
+  ].map((value) => value ? cleanEvidenceText(value) : "").find((value) => value.length > 0 && !isCodeOrCssPreview(value) && !isDiagnosticText(value));
+  return preferred ? clipText(preferred, SIGNAL_CLIP) : reference.url;
+};
+var REFERENCE_PATTERN_RULES = [
+  {
+    summary: "location-first church discovery with regional pathways",
+    matches: ["find a church", "church locations", "location", "city or postcode", "current location"]
+  },
+  {
+    summary: "worship and music content as atmosphere and ministry proof",
+    matches: ["music", "worship", "united", "young & free", "chapel", "instrumentals"]
+  },
+  {
+    summary: "global region navigation with online participation path",
+    matches: ["asia pacific", "europe", "north america", "latin america", "africa", "middle east", "online"]
+  },
+  {
+    summary: "story-led editorial pathway after the primary church action",
+    matches: ["stories", "blog", "start reading", "newsroom"]
+  },
+  {
+    summary: "ministry ecosystem pathways for college, conferences, and events",
+    matches: ["college", "conference", "tours", "events"]
+  },
+  {
+    summary: "multilingual/global audience affordance",
+    matches: ["language", '"en"', '"fr"', '"es"', '"pt"', '"de"']
+  },
+  {
+    summary: "full-bleed hero with restrained CTA rail",
+    matches: ["full-bleed", "hero", "cta rail", "primary cta"]
+  },
+  {
+    summary: "premium consulting public landing page with service narrative, client proof, and conversion CTAs",
+    matches: ["consulting", "advisory", "bcg", "enterprise ai", "transformation", "client services", "case studies", "industries"]
+  }
+];
+var ruleMatches = (text, rule) => {
+  const lower = text.toLowerCase();
+  return rule.matches.some((match) => lower.includes(match));
+};
+var derivePatternSummaries = (signals, fallback) => {
+  const text = signals.join(" ");
+  const matches = REFERENCE_PATTERN_RULES.filter((rule) => ruleMatches(text, rule)).map((rule) => rule.summary);
+  return matches.length > 0 ? matches.slice(0, PATTERN_LIMIT) : [fallback];
+};
+var appendSourceDetail = (patterns, primarySignal) => {
+  if (patterns.some((pattern) => primarySignal.toLowerCase().includes(pattern.toLowerCase()))) {
+    return patterns;
+  }
+  return [...patterns, `source detail: ${primarySignal}`].slice(0, PATTERN_LIMIT);
+};
+var deriveCapturedVia = (reference) => {
+  const methods = [];
+  if (reference.fetchStatus === "captured") methods.push("fetch");
+  if (reference.capture?.snapshot?.content.trim()) methods.push("snapshot");
+  if (hasUsableCloneCreativeEvidence(reference)) {
+    methods.push("clone");
+  }
+  if (reference.capture?.dom?.outerHTML.trim()) methods.push("dom");
+  return methods;
+};
+var deriveComponentFamilies = (format, patterns, isPublicLanding) => {
+  const base = isPublicLanding ? "hero composition, proof bands, narrative pathways, service or story sections, conversion CTA, and footer" : format.componentGrammar;
+  return [base, ...patterns.slice(0, 3)];
+};
+var hasReferencePublicLandingEvidence = (reference) => {
+  const text = [
+    reference.surfaceType,
+    reference.layoutRecipe,
+    ...reference.contentHierarchy,
+    ...reference.patternsToBorrow
+  ].join(" ");
+  return hasPublicLandingSignal(text);
+};
+var hasBoardPublicLandingEvidence = (board) => board.references.some(hasReferencePublicLandingEvidence);
+var boardEvidenceText = (board) => board.references.map((reference) => [
+  reference.layoutRecipe,
+  ...reference.contentHierarchy,
+  ...reference.componentFamilies,
+  ...reference.motionPosture,
+  ...reference.patternsToBorrow
+].join(" ")).join(" ").toLowerCase();
+var hasEvidenceCue = (text, matches) => matches.some((match) => text.includes(match));
+var deriveReferenceEntry = (reference, format) => {
+  const signals = getInspiredesignReferenceSignals(reference);
+  const primarySignal = firstSignal(reference);
+  const patterns = appendSourceDetail(derivePatternSummaries(signals, primarySignal), primarySignal);
+  const isPublicLanding = signals.some(hasPublicLandingSignal);
+  return {
+    id: reference.id,
+    name: reference.title ?? reference.url,
+    url: reference.url,
+    surfaceType: isPublicLanding ? "public landing page" : format.archetype,
+    capturedVia: deriveCapturedVia(reference),
+    layoutRecipe: patterns.join("; "),
+    contentHierarchy: patterns.slice(0, 4),
+    componentFamilies: deriveComponentFamilies(format, patterns, isPublicLanding),
+    motionPosture: [format.motionGrammar, "Plan hero reveal, scroll reveal, CTA feedback, and reduced-motion behavior."],
+    tokenNotes: [format.paletteIntent, format.typographySystem, format.surfaceTreatment],
+    patternsToBorrow: [...patterns, ...signals.slice(0, 2)].slice(0, PATTERN_LIMIT),
+    patternsToReject: [...format.antiPatterns],
+    whyItWorks: reference.captureStatus === "captured" ? "Captured reference evidence provides reusable hierarchy, rhythm, and component cues." : "Available reference text provides directional content and hierarchy cues."
+  };
+};
+var buildInspiredesignReferencePatternBoard = (briefId, format, references) => {
+  const entries = references.filter(hasInspiredesignUsableReferenceEvidence).map((reference) => deriveReferenceEntry(reference, format));
+  const sharedStrengths = entries.flatMap((entry) => entry.patternsToBorrow).slice(0, 6);
+  const targetSurface = entries.some((entry) => entry.surfaceType === "public landing page") ? "reference-led public landing page" : format.layoutArchetype;
+  return {
+    briefId,
+    targetSurface,
+    references: entries,
+    synthesis: {
+      dominantDirection: entries[0]?.layoutRecipe ?? format.archetype,
+      sharedStrengths,
+      sharedFailuresToAvoid: [...format.antiPatterns],
+      contractDeltas: [
+        "Selected prompt format supplies route defaults and guardrails, not the creative source of truth.",
+        "Use captured reference hierarchy before generic profile defaults when URL evidence exists."
+      ]
+    }
+  };
+};
+var buildInteractionDensity = (format, board) => {
+  if (hasBoardPublicLandingEvidence(board)) {
+    return "low-to-medium; prioritize confident public-page CTAs over app-shell controls.";
+  }
+  if (format.route.navigationModel === "sidebar") {
+    return "medium-to-high; prioritize command surfaces, state clarity, and durable workspace controls.";
+  }
+  if (format.route.profile === "documentation") {
+    return "low-to-medium; prioritize visual overview, proof scanning, and a small number of clear action paths.";
+  }
+  if (format.route.profile === "auth-focused") {
+    return "low; prioritize one confident first action with clear feedback and trust cues.";
+  }
+  return "low-to-medium; prioritize confident public-page CTAs over app-shell controls.";
+};
+var buildImageryPosture = (format, board) => {
+  if (hasBoardPublicLandingEvidence(board)) {
+    return [format.surfaceTreatment, "Use dominant atmospheric imagery as the visual anchor."];
+  }
+  if (format.route.navigationModel === "sidebar") {
+    return [format.surfaceTreatment, "Use product state, data hierarchy, and workspace continuity as the visual anchor."];
+  }
+  return [format.surfaceTreatment, "Use dominant atmospheric imagery as the visual anchor."];
+};
+var buildInteractionMoments = (format, board) => {
+  const evidenceText = boardEvidenceText(board);
+  const publicLanding = hasBoardPublicLandingEvidence(board);
+  const referenceBacked = board.references.length > 0;
+  const cursorScope = publicLanding ? "hero CTA, media reveals, and primary navigation moments" : "high-value actions and selected command surfaces";
+  const moments = [
+    "Microinteractions: define hover effects, visible focus rings, pressed states, loading states, and confirmation feedback for every primary action.",
+    `Animation choreography: sequence ${format.motionGrammar}, hover feedback, active feedback, and page transitions through one timing system.`
+  ];
+  const cursorBacked = hasEvidenceCue(evidenceText, ["cursor", "magnetic", "follow-cursor", "pointer"]);
+  const cursorPolicy = cursorBacked ? `Cursor effects: reference evidence supports premium pointer affordances for ${cursorScope}; keep default cursor behavior for reading surfaces.` : `Cursor effects policy: consider magnetic or follow-cursor affordances only when reference evidence supports ${cursorScope}.`;
+  return referenceBacked ? [...moments, cursorPolicy] : moments;
+};
+var buildMaterialEffects = (board) => {
+  if (board.references.length === 0) {
+    return [
+      "Material effects: define elevation, shadows, surface contrast, and reduced-motion-safe depth from the brief.",
+      "Reduced-motion material fallback: preserve hierarchy and CTA clarity without transform-based depth."
+    ];
+  }
+  const evidenceText = boardEvidenceText(board);
+  const publicLanding = hasBoardPublicLandingEvidence(board);
+  const glassScope = publicLanding ? "navigation overlays, hero scrims, and atmospheric CTA surfaces" : "focused overlays, inspectors, or state containers";
+  const parallaxBacked = hasEvidenceCue(evidenceText, ["parallax", "depth", "layered", "immersive", "full-bleed"]);
+  const glassBacked = hasEvidenceCue(evidenceText, ["glass", "frosted", "blur", "translucent", "scrim", "overlay"]);
+  const parallax = parallaxBacked ? "Depth language: reference evidence supports restrained parallax, layered shadows, and atmospheric depth where it reinforces hierarchy." : "Depth language policy: use parallax only when reference evidence supports layered depth; otherwise use spacing, scale, and shadow hierarchy.";
+  const glass = glassBacked ? `Glassmorphism/translucency: reference evidence supports frosted or translucent surfaces for ${glassScope}; never use glass as generic decoration.` : `Glassmorphism/translucency policy: use frosted or translucent surfaces only when reference evidence supports ${glassScope}.`;
+  return [
+    parallax,
+    glass,
+    "Reduced-motion material fallback: remove parallax and cursor-follow transforms while preserving hierarchy, depth, and CTA clarity."
+  ];
+};
+var buildSectionArchitecture = (format, board) => {
+  if (hasBoardPublicLandingEvidence(board)) {
+    return [
+      "Use 8 to 12 primary landing-page sections unless the user explicitly asks for a microsite.",
+      "Build a clear sequence from hero, proof, story, service pathways, impact, conversion CTA, and footer."
+    ];
+  }
+  if (format.route.profile === "documentation") {
+    return [
+      "Use a text-light overview sequence for purpose, proof, examples, action paths, and footer.",
+      "Keep long-form reference depth, citation modules, annotation rails, and methodology blocks out of the primary visual route."
+    ];
+  }
+  if (format.route.profile === "auth-focused") {
+    return [
+      "Use a screen sequence for value, trust, input, confirmation, and first-action transition.",
+      "Keep the flow compact instead of expanding into marketing section sprawl."
+    ];
+  }
+  if (format.route.navigationModel === "immersive") {
+    return [
+      "Use cinematic scene beats for hero, product reveal, proof, detail, and decisive CTA.",
+      "Keep each scroll beat focused on one visual idea."
+    ];
+  }
+  if (format.route.navigationModel === "sidebar") {
+    return [
+      "Use workspace shell zones for navigation, command surfaces, primary work area, detail panels, and state feedback.",
+      "Prioritize task continuity over marketing-section cadence."
+    ];
+  }
+  return [
+    "Use 8 to 12 primary landing-page sections unless the user explicitly asks for a microsite.",
+    "Build a clear sequence from hero, proof, story, service pathways, impact, conversion CTA, and footer."
+  ];
+};
+var buildInspiredesignDesignVectors = (format, board) => {
+  const influence = board.synthesis.sharedStrengths.length > 0 ? board.synthesis.sharedStrengths : [format.archetype];
+  const publicLandingEvidence = hasBoardPublicLandingEvidence(board);
+  const surfaceIntent = publicLandingEvidence ? "reference-led public landing page" : format.archetype;
+  const compositionModel = publicLandingEvidence ? ["full-bleed hero with narrative section cadence", ...board.references.map((entry) => entry.layoutRecipe)] : [format.layoutArchetype, ...board.references.map((entry) => entry.layoutRecipe)];
+  return {
+    sourcePriority: board.references.length > 0 ? "reference-evidence-first" : "brief-only",
+    directionLabel: board.synthesis.dominantDirection,
+    surfaceIntent,
+    compositionModel: compositionModel.slice(0, 5),
+    premiumPosture: [
+      "premium visual hierarchy, refined spacing, and editorial image treatment.",
+      "Premium typography, spacing, visual hierarchy, palette, and image treatment must lead the page.",
+      format.surfaceTreatment,
+      format.paletteIntent
+    ],
+    motionPosture: [
+      "Use a hero entrance reveal, section scroll reveal, and CTA/focus feedback.",
+      "Respect reduced-motion preference with static hierarchy preserved.",
+      format.motionGrammar
+    ],
+    sectionArchitecture: buildSectionArchitecture(format, board),
+    typographyPosture: [format.typographySystem],
+    imageryPosture: buildImageryPosture(format, board),
+    interactionDensity: buildInteractionDensity(format, board),
+    interactionMoments: buildInteractionMoments(format, board),
+    materialEffects: buildMaterialEffects(board),
+    advancedMotionAdvisory: [...ADVANCED_MOTION_FIELDS],
+    referenceInfluence: influence,
+    patternsToBorrow: board.references.flatMap((entry) => entry.patternsToBorrow).slice(0, 8),
+    patternsToReject: board.references.flatMap((entry) => entry.patternsToReject).slice(0, 8),
+    guardrails: [...format.guardrails],
+    antiPatterns: [...format.antiPatterns]
+  };
+};
+
+// src/inspiredesign/contract.ts
+var INSPIREDESIGN_CAPTURE_ATTEMPT_KEYS = ["snapshot", "clone", "dom"];
+var MALFORMED_CAPTURE_ATTEMPT_DETAIL = "Capture attempt metadata missing or malformed.";
+var NORMALIZED_CAPTURE_ATTEMPT_DETAIL = "Captured artifact was empty after normalization.";
 var isJsonRecord2 = (value) => {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 };
@@ -12012,15 +12973,15 @@ var PROFILE_CONFIG = {
     }
   },
   "documentation": {
-    direction: "reference-first documentation",
-    visualPersonality: "legible, calm, highly structured",
-    brandTone: "expert and accessible",
-    hierarchyPrinciples: ["Make scanning effortless.", "Keep code, steps, and warnings visually distinct."],
-    interactionPhilosophy: "Light motion, sticky wayfinding, strong anchor visibility.",
+    direction: "text-light knowledge story",
+    visualPersonality: "legible, calm, visually led",
+    brandTone: "expert, concise, and accessible",
+    hierarchyPrinciples: ["Make scanning effortless.", "Use visual proof before long explanatory text."],
+    interactionPhilosophy: "Light motion, clear wayfinding, strong anchor visibility.",
     navigationModel: "sidebar",
-    layoutApproach: "docs-shell",
-    pagePatterns: ["Docs shell", "Procedure section", "Reference table block"],
-    componentSequence: ["Sidebar", "Search", "Anchored headings", "Code blocks", "Callouts"],
+    layoutApproach: "knowledge-story-shell",
+    pagePatterns: ["Insight overview", "Visual proof band", "Action path"],
+    componentSequence: ["Navigation", "Search", "Anchored headings", "Proof bands", "Callouts"],
     colors: {
       primary: "#1D4ED8",
       accent: "#0F766E",
@@ -12036,37 +12997,425 @@ var PROFILE_CONFIG = {
     }
   }
 };
-var trimText = (value) => {
+var trimText2 = (value) => {
   return value.trim().replace(/\s+/g, " ");
 };
-var clipText = (value, maxLength) => {
+var clipText2 = (value, maxLength) => {
   if (value.length <= maxLength) return value;
   return `${value.slice(0, Math.max(0, maxLength - 3)).trimEnd()}...`;
 };
+var REFERENCE_SUMMARY_CLIP_LENGTH = 220;
+var GENERATION_PLAN_REFERENCE_CLIP_LENGTH = 600;
+var buildReferenceSynthesis = (references) => {
+  const lines = references.filter(hasInspiredesignUsableReferenceEvidence).map((reference, index) => {
+    const signals = getInspiredesignReferenceSignals(reference);
+    if (signals.length === 0) return "";
+    return `Source ${index + 1} ${reference.title ?? reference.url}: ${signals.join(" | ")}`;
+  }).filter((line) => line.length > 0);
+  return {
+    lines,
+    summary: lines.length > 0 ? lines.map((line) => clipText2(line, REFERENCE_SUMMARY_CLIP_LENGTH)).join(" ") : "No live reference cues were captured."
+  };
+};
+var renderReferenceFirstAdvancedBrief = (briefExpansion, board, vectors, references) => {
+  if (board.references.length === 0) {
+    if (references.length > 0) {
+      return [
+        "Reference evidence unavailable:",
+        "URL references were attempted, but no usable creative evidence was captured. Treat this as a capture gap, not a design direction.",
+        "",
+        formatBulletList2(references.map((reference) => renderUnavailableReference(reference))),
+        "",
+        briefExpansion.advancedBrief
+      ].join("\n");
+    }
+    return briefExpansion.advancedBrief;
+  }
+  return [
+    "Reference pattern board:",
+    "URL reference evidence is the creative source of truth when references are supplied.",
+    "",
+    "Reference evidence analysis:",
+    formatBulletList2(board.references.map((reference) => `${reference.name}: ${reference.layoutRecipe}`)),
+    "",
+    "Design vectors:",
+    formatBulletList2([
+      `directionLabel: ${vectors.directionLabel}`,
+      `surfaceIntent: ${vectors.surfaceIntent}`,
+      `premiumPosture: ${vectors.premiumPosture.join(" ")}`,
+      `motionPosture: ${vectors.motionPosture.join(" ")}`,
+      `sectionArchitecture: ${vectors.sectionArchitecture.join(" ")}`,
+      `interactionMoments: ${vectors.interactionMoments.join(" ")}`,
+      `materialEffects: ${vectors.materialEffects.join(" ")}`,
+      `advancedMotionAdvisory: ${vectors.advancedMotionAdvisory.join(" ")}`
+    ]),
+    "",
+    "Fixed format guardrails:",
+    "Selected prompt format supplies route defaults and guardrails, not the creative source of truth.",
+    "",
+    briefExpansion.advancedBrief
+  ].join("\n");
+};
+var renderEvidenceDerivedAdvancedBrief = (briefExpansion, format) => [
+  `Selected prompt format: ${format.label}`,
+  "",
+  "Source brief:",
+  briefExpansion.sourceBrief,
+  "",
+  "Prompt objective:",
+  `Use the reference evidence and source brief to define a ${format.archetype}.`,
+  "",
+  "Business focus:",
+  formatBulletList2(format.businessFocus),
+  "",
+  "Keywords:",
+  formatBulletList2(format.keywords),
+  "",
+  "Route defaults:",
+  formatBulletList2([
+    `profile: ${format.route.profile}`,
+    `theme strategy: ${format.route.themeStrategy}`,
+    `navigation model: ${format.route.navigationModel}`,
+    `layout approach: ${format.route.layoutApproach}`
+  ]),
+  "",
+  "Design direction:",
+  formatBulletList2([
+    `archetype: ${format.archetype}`,
+    `layout archetype: ${format.layoutArchetype}`,
+    `typography system: ${format.typographySystem}`,
+    `surface treatment: ${format.surfaceTreatment}`,
+    `shape language: ${format.shapeLanguage}`,
+    `component grammar: ${format.componentGrammar}`,
+    `motion grammar: ${format.motionGrammar}`,
+    `palette intent: ${format.paletteIntent}`,
+    `visual density: ${format.visualDensity}`,
+    `design variance: ${format.designVariance}`
+  ]),
+  "",
+  "Responsive collapse rules:",
+  formatBulletList2(format.responsiveCollapseRules),
+  "",
+  "Focus areas:",
+  formatBulletList2(format.focusAreas ?? []),
+  "",
+  "Execution rules:",
+  formatBulletList2([...INSPIREDESIGN_BRIEF_COMMON_RULES, ...format.guardrails]),
+  "",
+  "Anti-patterns:",
+  formatBulletList2(format.antiPatterns),
+  "",
+  "Return:",
+  formatBulletList2([...INSPIREDESIGN_BRIEF_OUTPUT_REQUIREMENTS, ...format.deliverables]),
+  "",
+  "Best fit use cases:",
+  formatBulletList2(format.bestFor)
+].join("\n");
+var renderUnavailableReference = (reference) => {
+  const reason = reference.fetchFailure ?? reference.captureFailure ?? "no usable creative evidence captured";
+  return `${reference.url}: fetch=${reference.fetchStatus}, capture=${reference.captureStatus}, reason=${clipText2(reason, 160)}`;
+};
 var cloneTemplate = (value) => structuredClone(value);
 var referenceFingerprint = (value) => {
   return createHash3("sha256").update(value).digest("hex").slice(0, 12);
 };
 var summarizeBrief = (brief) => {
-  const normalized = trimText(brief);
+  const normalized = trimText2(brief);
   const sentence = normalized.split(/[.!?]/).map((part) => part.trim()).find(Boolean);
-  return clipText(sentence ?? normalized, 140);
+  return clipText2(sentence ?? normalized, 140);
 };
 var buildSupportingMessages = (references) => {
-  const messages = references.map((reference) => reference.title ?? reference.excerpt ?? "").map((value) => clipText(trimText(value), 72)).filter((value) => value.length > 0);
+  const messages = references.map((reference) => reference.title ?? reference.excerpt ?? "").map((value) => clipText2(trimText2(value), 72)).filter((value) => value.length > 0);
   return messages.slice(0, 3);
 };
-var buildGenerationPlan = (brief, format) => {
+var summarizeDesignVectors = (designVectors) => [
+  `direction: ${designVectors.directionLabel}`,
+  `sections: ${designVectors.sectionArchitecture.join(" ")}`,
+  `motion: ${designVectors.motionPosture.slice(0, 1).join(" ")}`,
+  `interactions: ${designVectors.interactionMoments.slice(0, 1).join(" ")}`,
+  `materials: ${designVectors.materialEffects.slice(0, 1).join(" ")}`,
+  `advancedMotion: ${designVectors.advancedMotionAdvisory.slice(0, 1).join(" ")}`
+].join(" ");
+var isReferenceFirstPublicLanding = (designVectors) => {
+  return designVectors.sourcePriority === "reference-evidence-first" && designVectors.surfaceIntent.toLowerCase().includes("public landing page");
+};
+var buildEvidenceDerivedFormat = (format, designVectors) => {
+  const clone = cloneInspiredesignBriefFormat(format);
+  if (!isReferenceFirstPublicLanding(designVectors)) return clone;
+  return {
+    ...clone,
+    label: "Reference-led public landing page",
+    archetype: "reference-led public landing page",
+    layoutArchetype: "full-bleed hero with narrative section cadence",
+    componentGrammar: "hero composition, proof bands, narrative pathways, service or story sections, conversion CTA, and footer",
+    route: {
+      ...clone.route,
+      profile: "product-story",
+      navigationModel: "global-header",
+      layoutApproach: "reference-led-landing-page"
+    }
+  };
+};
+var TARGET_KIND_ORDER = ["page", "component", "asset"];
+var TARGET_CONFIDENCE = {
+  defaultPage: 0.55,
+  pageIntentStep: 0.05,
+  nonPageBase: 0.55,
+  intentStep: 0.08,
+  supportingStep: 0.05,
+  maxPage: 0.7,
+  maxNonPage: 0.95
+};
+var TARGET_SIGNAL_PROFILES = {
+  page: {
+    intent: ["page", "landing page", "website", "homepage", "dashboard", "workspace", "screen", "flow", "surface", "microsite"],
+    supporting: ["section", "sections", "navigation", "footer", "hero section", "conversion flow"],
+    incidental: ["card", "cards", "button", "buttons", "image", "images", "media", "hero", "cta", "background"]
+  },
+  component: {
+    intent: ["component", "component family", "reusable component", "component prototype", "hero component", "card component", "storybook"],
+    supporting: ["prop", "props", "slot", "slots", "variant", "variants", "state matrix", "hover", "focus", "disabled", "loading", "error", "fixture", "fixtures", "arg", "args"],
+    incidental: ["card", "cards", "button", "buttons", "form", "modal", "drawer", "navbar", "hero", "input", "tabs", "cta"]
+  },
+  asset: {
+    intent: ["asset", "asset pack", "visual asset", "icon pack", "logo pack", "illustration set", "artwork set"],
+    supporting: ["responsive variant", "responsive variants", "responsive artwork", "provenance", "usage rules", "alt text", "replacement rules", "tokenized usage", "source asset", "source assets"],
+    incidental: ["icon", "icons", "illustration", "illustrations", "logo", "logos", "media", "image", "images", "background", "texture", "sprite", "artwork"]
+  }
+};
+var buildTargetCorpus = (brief, references, synthesis) => [
+  brief,
+  synthesis.lines.join(" "),
+  ...references.filter(hasInspiredesignUsableReferenceEvidence).flatMap((reference) => getInspiredesignReferenceSignals(reference))
+].join(" ").toLowerCase();
+var escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var matchesTargetSignal = (corpus, signal) => {
+  const pattern = escapeRegex(signal.toLowerCase()).replace(/\s+/g, "\\s+");
+  return new RegExp(`(^|[^a-z0-9])${pattern}([^a-z0-9]|$)`).test(corpus);
+};
+var findTargetSignalIndex = (corpus, signal) => {
+  const pattern = escapeRegex(signal.toLowerCase()).replace(/\s+/g, "\\s+");
+  return new RegExp(`(^|[^a-z0-9])${pattern}([^a-z0-9]|$)`).exec(corpus)?.index ?? null;
+};
+var findFirstBriefTargetKind = (brief) => {
+  const corpus = brief.toLowerCase();
+  const hits = TARGET_KIND_ORDER.flatMap((kind) => TARGET_SIGNAL_PROFILES[kind].intent.map((signal) => findTargetSignalIndex(corpus, signal)).filter((index) => index !== null).map((index) => ({ kind, index })));
+  return hits.sort((left, right) => left.index - right.index)[0]?.kind ?? null;
+};
+var collectTargetSignals = (corpus) => {
+  const collect = (kind) => {
+    const profile = TARGET_SIGNAL_PROFILES[kind];
+    return {
+      intent: profile.intent.filter((signal) => matchesTargetSignal(corpus, signal)),
+      supporting: profile.supporting.filter((signal) => matchesTargetSignal(corpus, signal)),
+      incidental: profile.incidental.filter((signal) => matchesTargetSignal(corpus, signal))
+    };
+  };
+  return {
+    page: collect("page"),
+    component: collect("component"),
+    asset: collect("asset")
+  };
+};
+var clampTargetConfidence = (value, max) => Math.min(max, Number(value.toFixed(2)));
+var buildPageConfidence = (signals) => {
+  return clampTargetConfidence(
+    TARGET_CONFIDENCE.defaultPage + signals.intent.length * TARGET_CONFIDENCE.pageIntentStep,
+    TARGET_CONFIDENCE.maxPage
+  );
+};
+var buildTargetEligibility = (kind, briefSignals, supportSignals) => {
+  const eligible = briefSignals.intent.length > 0 && supportSignals.supporting.length > 0;
+  const confidence = eligible ? clampTargetConfidence(
+    TARGET_CONFIDENCE.nonPageBase + briefSignals.intent.length * TARGET_CONFIDENCE.intentStep + supportSignals.supporting.length * TARGET_CONFIDENCE.supportingStep,
+    TARGET_CONFIDENCE.maxNonPage
+  ) : 0;
+  return {
+    kind,
+    eligible,
+    confidence,
+    triggeringSignals: [
+      ...briefSignals.intent.map((signal) => `${kind} intent: ${signal}`),
+      ...supportSignals.supporting.map((signal) => `${kind} support: ${signal}`)
+    ]
+  };
+};
+var choosePrimaryTargetKind = (pageConfidence, pageSignals, firstBriefTargetKind, component, asset) => {
+  const eligibleTargets = [component, asset].filter((target) => target.eligible);
+  if (eligibleTargets.length === 0) return { primaryKind: "page", reason: "no_non_page_gate" };
+  if (firstBriefTargetKind === "page" && pageSignals.intent.length > 0) {
+    return { primaryKind: "page", reason: "page_first_brief_target" };
+  }
+  const [first, second] = eligibleTargets.sort((left, right) => right.confidence - left.confidence);
+  if (!first || first.confidence <= pageConfidence) {
+    return { primaryKind: "page", reason: "non_page_did_not_beat_page" };
+  }
+  if (second && first.confidence === second.confidence && pageSignals.intent.length > 0) {
+    return { primaryKind: "page", reason: "page_tie_break" };
+  }
+  return { primaryKind: first.kind, reason: "non_page_selected" };
+};
+var chooseTargetKinds = (primaryKind, component, asset) => {
+  if (primaryKind === "page") return ["page"];
+  const eligible = new Set([component, asset].filter((target) => target.eligible).map((target) => target.kind));
+  const secondaryKinds = TARGET_KIND_ORDER.filter((kind) => kind !== primaryKind && eligible.has(kind));
+  return [primaryKind, ...secondaryKinds];
+};
+var buildTriggeringSignals = (decision, signals, component, asset) => {
+  const pageSignals = signals.page.intent.map((signal) => `page intent: ${signal}`);
+  const eligibleTargets = [component, asset].filter((target) => target.eligible);
+  const targetIntents = eligibleTargets.flatMap((target) => target.triggeringSignals.filter((signal) => signal.includes(" intent: ")));
+  const targetSupport = eligibleTargets.flatMap((target) => target.triggeringSignals.filter((signal) => signal.includes(" support: ")));
+  const defaultSignal = decision.primaryKind === "page" ? [buildPageDecisionSignal(decision.reason)] : [];
+  return [...pageSignals, ...targetIntents, ...targetSupport, ...defaultSignal].slice(0, 12);
+};
+var buildPageDecisionSignal = (reason) => {
+  if (reason === "no_non_page_gate") return "page default: non-page targets did not clear brief intent plus support gates";
+  if (reason === "non_page_did_not_beat_page") return "page default: non-page targets did not beat page confidence";
+  if (reason === "page_first_brief_target") return "page default: page was the first explicit target in the brief";
+  if (reason === "page_tie_break") return "page default: page intent won a tied non-page confidence score";
+  return "page default: page selected";
+};
+var getTargetConfidence = (primaryKind, pageConfidence, component, asset) => {
+  if (primaryKind === "component") return component.confidence;
+  if (primaryKind === "asset") return asset.confidence;
+  return pageConfidence;
+};
+var buildTargetEvidenceBuckets = (primaryKind, format, designVectors) => ({
+  anatomy: [`Map ${primaryKind} anatomy before styling: root, content hierarchy, interaction zones, and supporting regions.`],
+  propsSlots: [`Define props/slots from ${format.componentGrammar}; separate data props, content slots, and visual variant controls.`],
+  stateMatrix: ["Cover default, hover, focus, active, disabled, loading, empty, error, success, and selected where relevant."],
+  tokens: [`Resolve typography, color, spacing, radius, shadow, motion, and z-index through semantic tokens for ${format.paletteIntent}.`],
+  assets: [`Inventory source assets, derived assets, usage rights, responsive variants, and replacement notes for ${primaryKind} prototypes.`],
+  accessibility: ["Validate keyboard order, visible focus, accessible names, ARIA pattern fit, contrast, and WCAG 2.2 states."],
+  motion: [`Use ${format.motionGrammar}; include reduced-motion alternatives for ${designVectors.motionPosture.join(" ") || "all transitions"}.`],
+  previewFixtures: [`Build isolated preview fixtures for ${primaryKind} default, responsive, reduced-motion, and failure states.`]
+});
+var buildComponentTargetAnalysis = (briefHash, format) => ({
+  canvasType: "CanvasComponentInventoryItem",
+  inventoryItems: [{
+    id: `component_${briefHash}`,
+    name: `${format.label} Component`,
+    componentName: `${format.route.profile.replace(/-/g, "")}PrototypeComponent`,
+    description: `Reusable component prototype derived from ${format.componentGrammar}.`,
+    sourceFamily: "framework_component",
+    origin: "code_sync",
+    variants: [{
+      id: "default",
+      name: "Default",
+      selector: { interaction: "default" },
+      description: "Default preview fixture.",
+      metadata: {}
+    }],
+    props: [
+      { name: "variant", type: "string", required: false, description: "Visual variant key.", metadata: {} },
+      { name: "state", type: "string", required: false, description: "Interaction state fixture.", metadata: {} }
+    ],
+    slots: [
+      { name: "media", description: "Optional visual or icon slot.", allowedKinds: ["asset", "image", "icon"], metadata: {} },
+      { name: "content", description: "Primary text or rich content slot.", allowedKinds: ["text", "rich-text"], metadata: {} }
+    ],
+    events: [{ name: "onPrimaryAction", description: "Primary interaction callback.", payloadShape: {}, metadata: {} }],
+    content: { acceptsText: true, acceptsRichText: true, slotNames: ["media", "content"], metadata: {} },
+    metadata: { targetKind: "component" }
+  }],
+  prototypeGuidance: [
+    "Component prototype target: document anatomy, props/slots, variant rules, and interaction state fixtures before page composition.",
+    "Use Storybook-style args and interaction checks when converting this guidance into executable component previews."
+  ]
+});
+var buildAssetTargetAnalysis = (briefHash) => ({
+  canvasType: "CanvasAsset",
+  assets: [{
+    id: `asset_${briefHash}`,
+    sourceType: "page-derived",
+    kind: "visual-asset",
+    url: null,
+    status: "needs-production-source",
+    provenanceNotes: ["Derived from brief/reference evidence; recreate rather than copy proprietary source assets."],
+    usageNotes: ["Define responsive variants, token usage, alt text, and replacement rules before implementation."],
+    metadata: { targetKind: "asset" }
+  }],
+  prototypeGuidance: [
+    "Asset prototype target: catalog provenance, variants, token usage, responsive behavior, and replacement rules.",
+    "Pair each visual asset with preview fixtures for default, high contrast, and reduced-motion contexts when relevant."
+  ]
+});
+var buildPageTargetAnalysis = (format, designVectors) => ({
+  canvasType: "CanvasPage",
+  assemblyFocus: [
+    format.layoutArchetype,
+    ...designVectors.sectionArchitecture
+  ],
+  implementationNotes: [
+    "Page prototype target: validate section order, navigation model, CTA visibility, responsive collapse, and reduced-motion behavior.",
+    "Use component primitives before page-specific wrappers."
+  ]
+});
+var buildTargetAnalysis = (brief, format, references, synthesis, designVectors) => {
+  const briefSignals = collectTargetSignals(brief.toLowerCase());
+  const supportSignals = collectTargetSignals(buildTargetCorpus(brief, references, synthesis));
+  const pageConfidence = buildPageConfidence(briefSignals.page);
+  const component = buildTargetEligibility("component", briefSignals.component, supportSignals.component);
+  const asset = buildTargetEligibility("asset", briefSignals.asset, supportSignals.asset);
+  const decision = choosePrimaryTargetKind(
+    pageConfidence,
+    briefSignals.page,
+    findFirstBriefTargetKind(brief),
+    component,
+    asset
+  );
+  const primaryKind = decision.primaryKind;
+  const kinds = chooseTargetKinds(primaryKind, component, asset);
+  const briefHash = referenceFingerprint(brief);
+  return {
+    primaryKind,
+    kinds,
+    confidence: getTargetConfidence(primaryKind, pageConfidence, component, asset),
+    triggeringSignals: buildTriggeringSignals(decision, briefSignals, component, asset),
+    evidenceBuckets: buildTargetEvidenceBuckets(primaryKind, format, designVectors),
+    ...kinds.includes("page") ? { page: buildPageTargetAnalysis(format, designVectors) } : {},
+    ...kinds.includes("component") ? { component: buildComponentTargetAnalysis(briefHash, format) } : {},
+    ...kinds.includes("asset") ? { asset: buildAssetTargetAnalysis(briefHash) } : {}
+  };
+};
+var buildGenerationPlan = ({
+  brief,
+  format,
+  synthesis,
+  referencePatternBoard,
+  designVectors,
+  targetAnalysis
+}) => {
   const plan = cloneTemplate(BASE_GENERATION_PLAN);
   const profile = format.route.profile;
-  plan.targetOutcome.summary = summarizeBrief(brief);
+  const vectorSummary = summarizeDesignVectors(designVectors);
+  plan.targetOutcome.summary = clipText2(
+    `${summarizeBrief(brief)} Reference cues: ${synthesis.summary} ${vectorSummary}`,
+    GENERATION_PLAN_REFERENCE_CLIP_LENGTH
+  );
   plan.visualDirection.profile = profile;
   plan.visualDirection.themeStrategy = format.route.themeStrategy;
   plan.layoutStrategy.approach = format.route.layoutApproach;
   plan.layoutStrategy.navigationModel = format.route.navigationModel;
+  plan.contentStrategy.source = clipText2(
+    `${INSPIREDESIGN_HANDOFF_FILES.evidence}, ${INSPIREDESIGN_HANDOFF_FILES.advancedBrief}, ${INSPIREDESIGN_HANDOFF_FILES.designMarkdown}. Use reference pattern board and design vectors from evidence/handoff artifacts. ${synthesis.summary} ${vectorSummary}`,
+    GENERATION_PLAN_REFERENCE_CLIP_LENGTH
+  );
+  plan.componentStrategy.mode = clipText2(
+    `reuse-first, adapted from captured references: ${synthesis.summary}. Include hero entrance reveal, section scroll reveal, CTA/focus feedback, microinteractions, hover effects, evidence-gated cursor effects, material depth, parallax constraints, glass/translucency policy, and prefers-reduced-motion behavior. Capture desktop and mobile browser proof for responsive layout, reduced-motion behavior, focus states, and primary CTA visibility.`,
+    GENERATION_PLAN_REFERENCE_CLIP_LENGTH
+  );
   plan.componentStrategy.interactionStates = ["default", "hover", "focus", "disabled", "loading"];
   plan.validationTargets.requiredThemes = plan.visualDirection.themeStrategy === "single-theme" ? ["light"] : ["light", "dark"];
-  return plan;
+  return {
+    ...plan,
+    referencePatternBoard,
+    designVectors,
+    targetAnalysis,
+    interactionMoments: [...designVectors.interactionMoments],
+    materialEffects: [...designVectors.materialEffects]
+  };
 };
 var buildIntentBlock = (brief, urls, references, format) => {
   const intent = cloneTemplate(BASE_CONTRACT_TEMPLATE.intent);
@@ -12174,11 +13523,19 @@ var buildIconSystemBlock = () => ({
     "Decorative icons should remain visually lighter than primary copy."
   ]
 });
-var buildMotionSystemBlock = (format) => {
+var buildMotionSystemBlock = (format, designVectors) => {
   const block = cloneTemplate(BASE_CONTRACT_TEMPLATE.motionSystem);
   return {
     ...block,
     grammar: format.motionGrammar,
+    posture: [...designVectors.motionPosture],
+    interactionMoments: [...designVectors.interactionMoments],
+    materialEffects: [...designVectors.materialEffects],
+    advancedMotionAdvisory: [...designVectors.advancedMotionAdvisory],
+    advancedMotionRuntimePolicy: "Advanced motion fields are advisory contract metadata only and do not authorize shader, WebGL, Spline, R3F, Pixi, Babylon, or GLSL runtime support.",
+    parallaxPolicy: "Use parallax only as a restrained hierarchy cue and remove transform-based depth for reduced-motion users.",
+    hoverPolicy: "Hover effects must clarify clickability without becoming the only visible affordance.",
+    cursorPolicy: "Cursor effects are allowed only on premium hero or CTA moments and must not interfere with reading or form controls.",
     durations: {
       quick: "120ms",
       standard: "180ms",
@@ -12209,12 +13566,12 @@ var buildLibraryPolicyBlock = () => ({
   components: ["shadcn"],
   icons: ["tabler"],
   styling: ["tailwindcss"],
-  motion: ["css"],
+  motion: [],
   threeD: []
 });
 var buildRuntimeBudgetsBlock = (plan) => ({
   maxHeroActions: 2,
-  maxPrimarySections: 8,
+  maxPrimarySections: plan.layoutStrategy.navigationModel === "global-header" ? 12 : 8,
   maxInteractionLatencyMs: plan.validationTargets.maxInteractionLatencyMs,
   previewBudgetMs: 1500,
   notes: [
@@ -12254,7 +13611,21 @@ var buildPerformanceModelBlock = () => {
 var buildCanvasPlanRequest = (brief, generationPlan) => ({
   ...cloneTemplate(BASE_PLAN_REQUEST_TEMPLATE),
   requestId: `req_plan_${referenceFingerprint(brief).slice(0, 12)}`,
-  generationPlan
+  generationPlan: toCanvasGenerationPlan(generationPlan)
+});
+var toCanvasGenerationPlan = (plan) => cloneTemplate({
+  targetOutcome: plan.targetOutcome,
+  visualDirection: plan.visualDirection,
+  layoutStrategy: plan.layoutStrategy,
+  contentStrategy: plan.contentStrategy,
+  componentStrategy: plan.componentStrategy,
+  motionPosture: plan.motionPosture,
+  responsivePosture: plan.responsivePosture,
+  accessibilityPosture: plan.accessibilityPosture,
+  validationTargets: plan.validationTargets,
+  interactionMoments: [...plan.interactionMoments],
+  materialEffects: [...plan.materialEffects],
+  designVectors: plan.designVectors
 });
 var buildContractScope = () => ({
   emittedContract: "CanvasDesignGovernance",
@@ -12267,9 +13638,31 @@ var buildBriefExpansionMetadata = (briefExpansion) => ({
   file: INSPIREDESIGN_HANDOFF_FILES.advancedBrief,
   format: cloneInspiredesignBriefFormat(briefExpansion.format)
 });
-var buildFollowthrough = (generationPlan, briefExpansion) => ({
+var buildRequiredReferenceArtifacts = (includePrototypeGuidance) => {
+  const files = [
+    INSPIREDESIGN_HANDOFF_FILES.evidence,
+    INSPIREDESIGN_HANDOFF_FILES.advancedBrief,
+    INSPIREDESIGN_HANDOFF_FILES.designMarkdown,
+    INSPIREDESIGN_HANDOFF_FILES.generationPlan,
+    INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest,
+    INSPIREDESIGN_HANDOFF_FILES.designContract,
+    INSPIREDESIGN_HANDOFF_FILES.implementationPlanMarkdown
+  ];
+  return includePrototypeGuidance ? [...files, INSPIREDESIGN_HANDOFF_FILES.prototypeGuidance] : files;
+};
+var buildFollowthrough = ({
+  generationPlan,
+  briefExpansion,
+  synthesis,
+  includePrototypeGuidance,
+  referencePatternBoard,
+  designVectors,
+  targetAnalysis
+}) => ({
   summary: buildInspiredesignFollowthroughSummary(),
   nextStep: buildInspiredesignNextStep(),
+  artifactGuide: INSPIREDESIGN_ARTIFACT_GUIDE,
+  contractSectionGuide: INSPIREDESIGN_CONTRACT_SECTION_GUIDE,
   briefExpansion: buildBriefExpansionMetadata(briefExpansion),
   recommendedSkills: [...INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS],
   commandExamples: { ...INSPIREDESIGN_HANDOFF_COMMANDS },
@@ -12278,20 +13671,33 @@ var buildFollowthrough = (generationPlan, briefExpansion) => ({
   implementationContext: {
     navigationModel: buildNavigationModelBlock(generationPlan.layoutStrategy.navigationModel),
     asyncModel: buildAsyncModelBlock(),
-    performanceModel: buildPerformanceModelBlock()
+    performanceModel: buildPerformanceModelBlock(),
+    referenceSynthesis: {
+      requiredArtifacts: buildRequiredReferenceArtifacts(includePrototypeGuidance),
+      cues: synthesis.lines
+    },
+    referencePatternBoard,
+    designVectors,
+    targetAnalysis
   }
 });
-var buildDesignContract = (brief, urls, references, plan, format) => ({
+var buildDesignContract = ({
+  brief,
+  urls,
+  references,
+  plan,
+  format
+}) => ({
   intent: buildIntentBlock(brief, urls, references, format),
-  generationPlan: plan,
+  generationPlan: toCanvasGenerationPlan(plan),
   designLanguage: buildDesignLanguageBlock(plan.visualDirection.profile, format),
-  contentModel: buildContentModelBlock(brief, references),
+  contentModel: buildContentModelBlock(brief, references.filter(hasInspiredesignUsableReferenceEvidence)),
   layoutSystem: buildLayoutSystemBlock(plan, format),
   typographySystem: buildTypographySystemBlock(format),
   colorSystem: buildColorSystemBlock(plan.visualDirection.profile, format),
   surfaceSystem: buildSurfaceSystemBlock(format),
   iconSystem: buildIconSystemBlock(),
-  motionSystem: buildMotionSystemBlock(format),
+  motionSystem: buildMotionSystemBlock(format, plan.designVectors),
   responsiveSystem: buildResponsiveSystemBlock(format),
   accessibilityPolicy: buildAccessibilityBlock(),
   libraryPolicy: buildLibraryPolicyBlock(),
@@ -12353,17 +13759,32 @@ var buildComponentBuildPlan = (profile) => {
     implementationNote: "Use semantic tokens first and keep copy/state logic outside the visual component."
   }));
 };
-var buildImplementationPlan = (profile, format, references) => ({
+var buildImplementationPlan = ({
+  profile,
+  format,
+  references,
+  synthesis,
+  designVectors
+}) => ({
   architectureRecommendation: `Implement the surface as a ${format.archetype} using token-first components and shared semantic CSS variables, then compose page sections from those primitives before adding any page-specific polish.`,
   tokenStrategy: buildTokenStrategy(profile),
+  referenceImplementationNotes: synthesis.lines.length > 0 ? synthesis.lines : ["No live reference cues were captured; keep implementation anchored to the source brief and selected prompt format."],
   componentBuildPlan: buildComponentBuildPlan(profile),
   pageAssemblyPlan: [
     `Start with the ${format.layoutArchetype} and the primary navigation pattern.`,
+    ...designVectors.sectionArchitecture,
+    "Make each major section content-rich with a concrete headline, supporting copy, proof detail, and a clear role in the journey.",
     "Compose the hero or primary decision section before supporting sections.",
     "Add proof, utility, and footer sections only after the top-level hierarchy is stable."
   ],
   stateAndInteractionPlan: [
     `Use ${format.motionGrammar} while keeping hover, focus, loading, success, and error states visually distinct.`,
+    ...designVectors.motionPosture,
+    ...designVectors.interactionMoments,
+    ...designVectors.materialEffects,
+    ...designVectors.advancedMotionAdvisory,
+    "Implement hero entrance reveal, section scroll reveal, and CTA/focus feedback as the minimum motion system for landing pages.",
+    "Use @media (prefers-reduced-motion: reduce) to preserve hierarchy without motion.",
     "Preserve layout during loading and keep transient confirmations out of the main flow.",
     "Use reduced-motion-safe transitions for reveals and CTA feedback."
   ],
@@ -12379,25 +13800,33 @@ var buildImplementationPlan = (profile, format, references) => ({
     "Avoid horizontal scrolling for primary content."
   ],
   risksAndAmbiguities: [
-    references.length === 0 ? "No live references were supplied, so visual cues are derived entirely from the written brief." : "Live references were reduced into reusable patterns; unique brand assets should still be recreated, not copied.",
-    "Any missing interaction states must be validated during visual QA."
+    references.length === 0 ? "No live references were supplied, so visual cues are derived entirely from the written brief." : synthesis.lines.length > 0 ? "Live references were reduced into reusable patterns; unique brand assets should still be recreated, not copied." : "Reference URLs were attempted, but no usable creative evidence was captured; keep implementation anchored to the source brief and selected prompt format.",
+    "Any missing interaction states must be validated during visual QA.",
+    "Capture desktop and mobile browser proof before handoff, including reduced-motion behavior and primary CTA visibility."
   ],
   buildSequence: [
     "Define semantic tokens and typography.",
     "Build the shell, navigation, and primary CTA components.",
     "Implement section-level patterns and proof blocks.",
     "Add loading, empty, and error states.",
-    "Run accessibility, responsive, and browser QA before final polish."
+    "Capture desktop and mobile browser proof for responsive layout, reduced-motion behavior, focus states, and primary CTA visibility before final polish."
   ]
 });
 var formatBulletList2 = (items) => items.map((item) => `- ${item}`).join("\n");
+var renderAntiPatternRule = (rule) => {
+  const cleanRule = rule.replace(/\.$/, "").trim();
+  const withoutNo = cleanRule.replace(/^no\s+/i, "");
+  if (withoutNo !== cleanRule) return `Don't use ${withoutNo.charAt(0).toLowerCase()}${withoutNo.slice(1)}.`;
+  const withoutDoNot = cleanRule.replace(/^do not\s+/i, "");
+  if (withoutDoNot !== cleanRule) return `Don't ${withoutDoNot.charAt(0).toLowerCase()}${withoutDoNot.slice(1)}.`;
+  return `Don't ${cleanRule.charAt(0).toLowerCase()}${cleanRule.slice(1)}.`;
+};
 var formatRecordList = (record) => {
   return Object.entries(record).map(([key, value]) => `- \`${key}\`: ${value}`).join("\n");
 };
 var referenceContribution = (reference) => {
   if (reference.captureStatus === "captured") return "Live hierarchy and component evidence captured from the page.";
-  if (reference.fetchStatus === "captured") return "Content and structural cues inferred from fetched page data.";
-  return "Only operator brief context was available for this reference.";
+  return "Content and structural cues inferred from fetched page data.";
 };
 var referenceMotionNote = (reference) => {
   if (reference.capture?.snapshot?.warnings?.length) {
@@ -12406,8 +13835,13 @@ var referenceMotionNote = (reference) => {
   if (reference.captureStatus === "captured") return "Motion should remain subtle until validated against the live capture.";
   return "Motion is inferred from the brief rather than directly observed.";
 };
+var referenceLayoutObservation = (reference, excerpt) => {
+  if (!reference.capture?.snapshot && !reference.capture?.clone && !reference.capture?.dom) return excerpt;
+  const signals = getInspiredesignReferenceSignals(reference);
+  return signals.find((signal) => signal !== reference.title) ?? signals[0] ?? excerpt;
+};
 var renderReferenceMarkdown = (reference, index) => {
-  const excerpt = reference.excerpt ? clipText(reference.excerpt, 220) : "No fetched excerpt captured.";
+  const excerpt = reference.excerpt ? clipText2(reference.excerpt, 220) : "No fetched excerpt captured.";
   const title = reference.title ?? reference.url;
   return [
     `### Source ${index + 1}: ${title}`,
@@ -12415,13 +13849,20 @@ var renderReferenceMarkdown = (reference, index) => {
     `- notable UI patterns: ${reference.capture?.snapshot ? "Primary hierarchy and actionables were captured from the live page." : "Patterns inferred from brief and fetched content."}`,
     `- typography observations: ${reference.title ? "Headline density and copy hierarchy were inferred from the fetched title and excerpt." : "Typography is inferred."}`,
     `- color and theme observations: ${reference.captureStatus === "captured" ? "Color posture should be validated against the captured page before cloning brand treatment." : "Color posture remains a synthesis decision."}`,
-    `- layout and hierarchy observations: ${reference.capture?.snapshot ? clipText(reference.capture.snapshot.content, 180) : excerpt}`,
+    `- layout and hierarchy observations: ${referenceLayoutObservation(reference, excerpt)}`,
     `- component patterns: ${reference.capture?.clone ? "Buttons, cards, or layout wrappers can be inferred from the captured clone preview." : "Component families were inferred from available reference text."}`,
     `- motion/interaction observations: ${referenceMotionNote(reference)}`,
     `- accessibility/responsiveness notes: ${reference.captureStatus === "captured" ? "Validate focus order, CTA prominence, and stacked layouts during build QA." : "Accessibility and responsiveness are inferred from system defaults."}`,
     `- what should be adopted, adapted, or avoided: adopt layout hierarchy, adapt it to the new brand tokens, avoid copying proprietary copy or visual assets directly.`
   ].join("\n");
 };
+var renderInspirationAnalysis = (references, usableReferences) => {
+  if (usableReferences.length > 0) return usableReferences.map(renderReferenceMarkdown).join("\n\n");
+  if (references.length > 0) {
+    return "- Reference URLs were attempted, but no usable creative evidence was captured. See evidence.json for fetch/capture status.";
+  }
+  return "- No live inspiration source was provided. The system is derived entirely from the brief.";
+};
 var renderGovernanceMarkdown = (designContract, implementationPlan, format) => {
   const generationPlan = designContract.generationPlan;
   const profileConfig = PROFILE_CONFIG[generationPlan.visualDirection.profile];
@@ -12516,7 +13957,7 @@ var renderGovernanceMarkdown = (designContract, implementationPlan, format) => {
       "Do encode repeated visual rules into semantic tokens.",
       "Don't copy proprietary logos, screenshots, or brand-only illustrations.",
       "Don't hide important actions inside ambiguous hover-only affordances.",
-      ...format.antiPatterns.map((rule) => `Don't ${rule.replace(/\.$/, "").toLowerCase()}.`)
+      ...format.antiPatterns.map(renderAntiPatternRule)
     ]),
     "",
     "## 4.15 Acceptance Criteria",
@@ -12539,39 +13980,79 @@ var renderImplementationMarkdown = (implementationPlan) => {
     "",
     formatRecordList(implementationPlan.tokenStrategy.typography),
     "",
-    "## 5.3 Component Build Plan",
+    "## 5.3 Reference Implementation Notes",
+    formatBulletList2(implementationPlan.referenceImplementationNotes),
+    "",
+    "## 5.4 Component Build Plan",
     implementationPlan.componentBuildPlan.map((component, index) => `${index + 1}. ${component.name}: ${component.purpose}`).join("\n"),
     "",
-    "## 5.4 Page Assembly Plan",
+    "## 5.5 Page Assembly Plan",
     formatBulletList2(implementationPlan.pageAssemblyPlan),
     "",
-    "## 5.5 State and Interaction Plan",
+    "## 5.6 State and Interaction Plan",
     formatBulletList2(implementationPlan.stateAndInteractionPlan),
     "",
-    "## 5.6 Accessibility Implementation Checklist",
+    "## 5.7 Accessibility Implementation Checklist",
     formatBulletList2(implementationPlan.accessibilityChecklist),
     "",
-    "## 5.7 Responsive Implementation Checklist",
+    "## 5.8 Responsive Implementation Checklist",
     formatBulletList2(implementationPlan.responsiveChecklist),
     "",
-    "## 5.8 Risks and Ambiguities",
+    "## 5.9 Risks and Ambiguities",
     formatBulletList2(implementationPlan.risksAndAmbiguities),
     "",
-    "## 5.9 Recommended Build Sequence",
+    "## 5.10 Recommended Build Sequence",
     implementationPlan.buildSequence.map((step, index) => `${index + 1}. ${step}`).join("\n")
   ].join("\n");
 };
-var renderPrototypeGuidance = (profile) => {
+var renderTargetAnalysisGuidance = (targetAnalysis) => {
+  const targetGuidance = [
+    ...targetAnalysis.page?.implementationNotes ?? [],
+    ...targetAnalysis.component?.prototypeGuidance ?? [],
+    ...targetAnalysis.asset?.prototypeGuidance ?? []
+  ];
+  return [
+    "## 6.3 Target Analysis",
+    formatBulletList2([
+      `primary target: ${targetAnalysis.primaryKind}`,
+      `target kinds: ${targetAnalysis.kinds.join(", ")}`,
+      `confidence: ${targetAnalysis.confidence.toFixed(2)}`,
+      `triggering signals: ${targetAnalysis.triggeringSignals.join("; ")}`,
+      ...targetGuidance,
+      `anatomy: ${targetAnalysis.evidenceBuckets.anatomy.join(" ")}`,
+      `props/slots: ${targetAnalysis.evidenceBuckets.propsSlots.join(" ")}`,
+      `state matrix: ${targetAnalysis.evidenceBuckets.stateMatrix.join(" ")}`,
+      `tokens: ${targetAnalysis.evidenceBuckets.tokens.join(" ")}`,
+      `assets: ${targetAnalysis.evidenceBuckets.assets.join(" ")}`,
+      `accessibility: ${targetAnalysis.evidenceBuckets.accessibility.join(" ")}`,
+      `motion: ${targetAnalysis.evidenceBuckets.motion.join(" ")}`,
+      `preview fixtures: ${targetAnalysis.evidenceBuckets.previewFixtures.join(" ")}`
+    ])
+  ].join("\n");
+};
+var renderPrototypeGuidance = (profile, synthesis, designVectors, targetAnalysis) => {
   return [
     "# 6. Optional Prototype Plan",
     "",
-    "- page structure: establish the shell, hero or primary action zone, proof sections, and footer in that order.",
+    "## 6.1 Reference Anchors",
+    formatBulletList2(synthesis.lines.length > 0 ? synthesis.lines : ["No live reference cues were captured."]),
+    "",
+    "## 6.2 Prototype Structure",
+    "- page structure: for public landing pages, build 8 to 12 content-rich sections unless the brief explicitly asks for a microsite.",
+    `- section architecture: ${designVectors.sectionArchitecture.join(" ")}`,
     `- section order: ${PROFILE_CONFIG[profile].pagePatterns.join(" -> ")}`,
     "- component composition: reuse button, card, input, and navigation primitives before page-specific wrappers.",
-    "- interaction expectations: provide visible focus, compact hover feedback, and reduced-motion-safe entry transitions.",
-    "- HTML skeleton guidance: start with one main landmark, one primary CTA group, and semantic sections for proof or detail bands.",
-    "- styling approach: define CSS variables first, then map components to semantic tokens rather than raw values.",
-    "- first prototype should include vs omit: include shell, hero, CTA, one proof section, and one form or action cluster; omit analytics, heavy animation, and tertiary content until hierarchy is proven."
+    `- interaction expectations: ${designVectors.interactionMoments.join(" ")}`,
+    `- motion expectations: ${designVectors.motionPosture.join(" ")}`,
+    `- material and depth expectations: ${designVectors.materialEffects.join(" ")}`,
+    `- advisory advanced motion: ${designVectors.advancedMotionAdvisory.join(" ")}`,
+    "",
+    renderTargetAnalysisGuidance(targetAnalysis),
+    "",
+    "- browser proof: capture desktop and mobile browser screenshots, verify reduced-motion behavior, inspect focus states, and confirm the primary CTA remains visible without overlap.",
+    "- HTML skeleton guidance: start with one main landmark, one primary CTA group, and semantic sections that follow the design vector section architecture instead of fixed industry-specific defaults.",
+    "- styling approach: define CSS variables for timing, easing, elevation, translucency, backdrop blur, cursor effects, hover effects, and parallax distance before mapping components to semantic tokens.",
+    "- first prototype should include vs omit: include shell, primary hero or decision section, CTA group, proof or detail sections, section patterns named in the design vectors, final CTA, and footer; omit analytics, app-shell widgets, empty card grids, and any section not supported by the brief or reference evidence."
   ].join("\n");
 };
 var renderDeliverablesSummary = (includePrototypeGuidance) => {
@@ -12589,27 +14070,38 @@ var renderDeliverablesSummary = (includePrototypeGuidance) => {
   deliverables.push("Evidence digest describing brief, references, fetch outcomes, and capture outcomes");
   return formatBulletList2(deliverables);
 };
-var buildEvidencePayload = (brief, briefExpansion, urls, references) => ({
+var buildEvidencePayload = ({
+  brief,
+  briefExpansion,
+  advancedBriefMarkdown,
+  urls,
+  references,
+  referencePatternBoard,
+  designVectors,
+  targetAnalysis
+}) => ({
   brief,
   briefHash: referenceFingerprint(brief),
-  advancedBrief: briefExpansion.advancedBrief,
-  advancedBriefHash: referenceFingerprint(briefExpansion.advancedBrief),
+  advancedBrief: advancedBriefMarkdown,
+  advancedBriefHash: referenceFingerprint(advancedBriefMarkdown),
   briefExpansion: {
     templateVersion: briefExpansion.templateVersion,
     format: cloneInspiredesignBriefFormat(briefExpansion.format)
   },
   urls,
   referenceCount: references.length,
-  references: references.map((reference) => toReferenceEvidenceJson(reference))
+  references: references.map((reference) => toReferenceEvidenceJson(reference)),
+  referencePatternBoard,
+  designVectors,
+  targetAnalysis
 });
-var toCaptureEvidenceJson = (capture) => {
-  const normalized = normalizeInspiredesignCaptureEvidence(capture);
+var toCaptureEvidenceJson = (reference) => {
+  const normalized = normalizeInspiredesignCaptureEvidence(reference.capture);
   if (!normalized) return null;
+  const signals = getInspiredesignReferenceSignals(reference);
   return {
     ...normalized.title ? { title: normalized.title } : {},
-    ...normalized.snapshot ? { snapshot: normalized.snapshot } : {},
-    ...normalized.dom ? { dom: normalized.dom } : {},
-    ...normalized.clone ? { clone: normalized.clone } : {},
+    ...signals.length > 0 ? { signals } : {},
     ...normalized.attempts ? { attempts: normalized.attempts } : {}
   };
 };
@@ -12622,33 +14114,87 @@ var toReferenceEvidenceJson = (reference) => ({
   captureStatus: reference.captureStatus,
   ...reference.fetchFailure ? { fetchFailure: reference.fetchFailure } : {},
   ...reference.captureFailure ? { captureFailure: reference.captureFailure } : {},
-  capture: toCaptureEvidenceJson(reference.capture)
+  capture: toCaptureEvidenceJson(reference)
 });
 var buildInspiredesignPacket = (input) => {
-  const brief = trimText(input.brief);
+  const brief = trimText2(input.brief);
   const selectedFormat = cloneInspiredesignBriefFormat(input.briefExpansion.format);
-  const advancedBriefMarkdown = input.briefExpansion.advancedBrief;
-  const urls = [...new Set(input.urls.map((url) => trimText(url)).filter(Boolean))];
+  const includePrototypeGuidance = input.includePrototypeGuidance ?? false;
+  const urls = [...new Set(input.urls.map((url) => trimText2(url)).filter(Boolean))];
   const references = input.references.map((reference) => ({
     ...reference,
-    title: reference.title ? trimText(reference.title) : void 0,
-    excerpt: reference.excerpt ? trimText(reference.excerpt) : void 0
+    title: reference.title ? trimText2(reference.title) : void 0,
+    excerpt: reference.excerpt ? trimText2(reference.excerpt) : void 0
   }));
-  const generationPlan = buildGenerationPlan(brief, selectedFormat);
+  const usableReferences = references.filter(hasInspiredesignUsableReferenceEvidence);
+  const synthesis = buildReferenceSynthesis(usableReferences);
+  const referencePatternBoard = buildInspiredesignReferencePatternBoard(
+    referenceFingerprint(brief),
+    selectedFormat,
+    references
+  );
+  const designVectors = buildInspiredesignDesignVectors(selectedFormat, referencePatternBoard);
+  const effectiveFormat = buildEvidenceDerivedFormat(selectedFormat, designVectors);
+  const targetAnalysis = buildTargetAnalysis(
+    brief,
+    effectiveFormat,
+    references,
+    synthesis,
+    designVectors
+  );
+  const effectiveBriefExpansion = {
+    ...input.briefExpansion,
+    advancedBrief: isReferenceFirstPublicLanding(designVectors) ? renderEvidenceDerivedAdvancedBrief(input.briefExpansion, effectiveFormat) : input.briefExpansion.advancedBrief,
+    format: effectiveFormat
+  };
+  const advancedBriefMarkdown = renderReferenceFirstAdvancedBrief(
+    effectiveBriefExpansion,
+    referencePatternBoard,
+    designVectors,
+    references
+  );
+  const generationPlan = buildGenerationPlan({
+    brief,
+    format: effectiveFormat,
+    synthesis,
+    referencePatternBoard,
+    designVectors,
+    targetAnalysis
+  });
   const profile = generationPlan.visualDirection.profile;
   const canvasPlanRequest = buildCanvasPlanRequest(brief, generationPlan);
-  const designContract = buildDesignContract(brief, urls, references, generationPlan, selectedFormat);
-  const followthrough = buildFollowthrough(generationPlan, input.briefExpansion);
-  const implementationPlan = buildImplementationPlan(profile, selectedFormat, references);
-  const governanceMarkdown = renderGovernanceMarkdown(designContract, implementationPlan, selectedFormat);
+  const designContract = buildDesignContract({
+    brief,
+    urls,
+    references,
+    plan: generationPlan,
+    format: effectiveFormat
+  });
+  const followthrough = buildFollowthrough({
+    generationPlan,
+    briefExpansion: effectiveBriefExpansion,
+    synthesis,
+    includePrototypeGuidance,
+    referencePatternBoard,
+    designVectors,
+    targetAnalysis
+  });
+  const implementationPlan = buildImplementationPlan({
+    profile,
+    format: effectiveFormat,
+    references,
+    synthesis,
+    designVectors
+  });
+  const governanceMarkdown = renderGovernanceMarkdown(designContract, implementationPlan, effectiveFormat);
   const implementationPlanMarkdown = renderImplementationMarkdown(implementationPlan);
-  const prototypeGuidanceMarkdown = input.includePrototypeGuidance ? renderPrototypeGuidance(profile) : null;
+  const prototypeGuidanceMarkdown = includePrototypeGuidance ? renderPrototypeGuidance(profile, synthesis, designVectors, targetAnalysis) : null;
   const designMarkdown = [
     "# 1. Executive Summary",
     "",
     formatBulletList2([
       `Analyzed brief plus ${references.length || 0} inspiration reference(s).`,
-      `Chosen design direction: ${selectedFormat.archetype}.`,
+      `Chosen design direction: ${designVectors.surfaceIntent}.`,
       `Route profile: ${PROFILE_CONFIG[profile].direction}.`,
       `Prompt format: ${selectedFormat.label} (${input.briefExpansion.templateVersion}).`,
       "Final outcome: a reusable design contract, engineering plan, and optional prototype guidance.",
@@ -12657,16 +14203,39 @@ var buildInspiredesignPacket = (input) => {
     "",
     "# 2. Inspiration Analysis",
     "",
-    references.length > 0 ? references.map(renderReferenceMarkdown).join("\n\n") : "- No live inspiration source was provided. The system is derived entirely from the brief.",
+    renderInspirationAnalysis(references, usableReferences),
     "",
     "# 3. Unified Design Direction",
     "",
+    "## 3.1 Reference-Specific Build Rules",
+    "",
+    formatBulletList2(synthesis.lines.length > 0 ? synthesis.lines : ["No live reference cues were captured."]),
+    "",
+    "## 3.2 Reference Pattern Board",
+    "",
+    formatBulletList2(referencePatternBoard.synthesis.sharedStrengths.length > 0 ? referencePatternBoard.synthesis.sharedStrengths : ["No live reference cues were captured."]),
+    "",
+    "## 3.3 Design Vectors",
+    "",
+    formatBulletList2([
+      `source priority: ${designVectors.sourcePriority}`,
+      `direction: ${designVectors.directionLabel}`,
+      `premium posture: ${designVectors.premiumPosture.join(" ")}`,
+      `motion posture: ${designVectors.motionPosture.join(" ")}`,
+      `section architecture: ${designVectors.sectionArchitecture.join(" ")}`,
+      `interaction moments: ${designVectors.interactionMoments.join(" ")}`,
+      `material effects: ${designVectors.materialEffects.join(" ")}`,
+      `advanced motion advisory: ${designVectors.advancedMotionAdvisory.join(" ")}`
+    ]),
+    "",
+    "## 3.4 System Direction",
+    "",
     formatBulletList2([
       `visual personality: ${PROFILE_CONFIG[profile].visualPersonality}`,
       `tone: ${PROFILE_CONFIG[profile].brandTone}`,
-      `layout archetype: ${selectedFormat.layoutArchetype}`,
-      `typography system: ${selectedFormat.typographySystem}`,
-      `motion grammar: ${selectedFormat.motionGrammar}`,
+      `layout archetype: ${effectiveFormat.layoutArchetype}`,
+      `typography system: ${effectiveFormat.typographySystem}`,
+      `motion grammar: ${effectiveFormat.motionGrammar}`,
       `UX principles: ${PROFILE_CONFIG[profile].hierarchyPrinciples.join(" ")}`,
       `interaction philosophy: ${PROFILE_CONFIG[profile].interactionPhilosophy}`,
       "branding posture: preserve the intent of the references without cloning brand-only assets.",
@@ -12695,33 +14264,197 @@ var buildInspiredesignPacket = (input) => {
     implementationPlan,
     implementationPlanMarkdown,
     prototypeGuidanceMarkdown,
-    evidence: buildEvidencePayload(brief, input.briefExpansion, urls, references)
+    evidence: buildEvidencePayload({
+      brief,
+      briefExpansion: effectiveBriefExpansion,
+      advancedBriefMarkdown,
+      urls,
+      references,
+      referencePatternBoard,
+      designVectors,
+      targetAnalysis
+    })
   };
 };
 
-// src/providers/renderer.ts
-var toCurrency = (value) => `$${value.toFixed(2)}`;
-var primaryConstraintSummaryFromMeta = (meta) => {
-  const summary = meta.primaryConstraintSummary;
-  return typeof summary === "string" && summary.trim().length > 0 ? summary.trim() : null;
-};
-var isStringArray = (value) => Array.isArray(value) && value.every((item) => typeof item === "string");
-var inspiredesignCaptureAttemptReportFromMeta = (meta) => {
-  const report = meta.captureAttemptReport;
-  if (typeof report !== "object" || report === null || Array.isArray(report)) {
-    return null;
-  }
-  const candidate = report;
-  if (!isStringArray(candidate.worked) || !isStringArray(candidate.didNotWork)) {
-    return null;
-  }
-  return {
-    worked: candidate.worked,
-    didNotWork: candidate.didNotWork
-  };
+// src/providers/workflow-handoff.ts
+var PRODUCT_VIDEO_BRIEF_HELPER_PATH = "./skills/opendevbrowser-product-presentation-asset/scripts/render-video-brief.sh";
+var PRODUCT_VIDEO_BRIEF_HELPER_COMMAND = `${PRODUCT_VIDEO_BRIEF_HELPER_PATH} <pack>/manifest.json`;
+var createSuccessHandoff = (followthroughSummary, suggestedNextAction, suggestedSteps) => ({
+  followthroughSummary,
+  suggestedNextAction,
+  suggestedSteps
+});
+var cliExample = (command, args = "") => `npx opendevbrowser ${command}${args ? ` ${args}` : ""}`;
+var quoteCliValue = (value) => JSON.stringify(value);
+var buildResearchRerunCommand = (input) => cliExample(
+  "research run",
+  `--topic ${quoteCliValue(input.topic)} --days 14 --source-selection auto --sources web,community --browser-mode ${input.browserMode ?? "managed"} --mode json --output-format json`
+);
+var buildShoppingRerunCommand = (input) => {
+  const providers = input.providers?.length ? ` --providers ${input.providers.join(",")}` : " --providers shopping/bestbuy,shopping/ebay";
+  const budget = typeof input.budget === "number" ? ` --budget ${input.budget}` : "";
+  const region = input.region ? ` --region ${quoteCliValue(input.region)}` : "";
+  const browserMode = ` --browser-mode ${input.browserMode ?? "managed"}`;
+  const sort = input.sort ? ` --sort ${input.sort}` : "";
+  return cliExample(
+    "shopping run",
+    `--query ${quoteCliValue(input.query)}${providers}${budget}${region}${browserMode}${sort} --use-cookies --challenge-automation-mode browser_with_helper --mode json --output-format json`
+  );
 };
-var inspiredesignCaptureAttemptSummaryFromMeta = (meta) => {
-  const summary = meta.captureAttemptSummary;
+var buildProductVideoRerunCommand = (input = {}) => {
+  const target = input.productUrl ? `--product-url ${quoteCliValue(input.productUrl)}` : `--product-name ${quoteCliValue(input.productName ?? "<product-name>")}`;
+  const providerHint = input.providerHint ? ` --provider-hint ${input.providerHint}` : "";
+  const screenshots = input.includeScreenshots ? " --include-screenshots" : "";
+  const allImages = input.includeAllImages ? " --include-all-images" : "";
+  const includeCopy = input.includeCopy ? " --include-copy" : "";
+  const browserMode = ` --browser-mode ${input.browserMode ?? "managed"}`;
+  return cliExample(
+    "product-video run",
+    `${target}${providerHint}${screenshots}${allImages}${includeCopy}${browserMode} --use-cookies --challenge-automation-mode browser_with_helper --output-format json`
+  );
+};
+var buildMacroResolveArgs = (input, options) => {
+  const defaultProvider = input.defaultProvider ? ` --default-provider ${input.defaultProvider}` : "";
+  const execute = options?.execute ? " --execute" : "";
+  const browserMode = options?.browserMode ? ` --browser-mode ${options.browserMode}` : "";
+  const challenge = options?.challengeAutomationMode ? ` --challenge-automation-mode ${options.challengeAutomationMode}` : "";
+  const outputFormat = options?.includeOutputFormat === false ? "" : " --output-format json";
+  return `--expression ${quoteCliValue(input.expression)}${defaultProvider}${execute}${browserMode}${challenge}${outputFormat}`;
+};
+var buildMacroPreviewCommand = (input) => cliExample("macro-resolve", buildMacroResolveArgs(input));
+var buildMacroExecuteCommand = (input, challengeAutomationMode, browserMode) => cliExample("macro-resolve", buildMacroResolveArgs(input, {
+  execute: true,
+  browserMode,
+  challengeAutomationMode
+}));
+var buildResearchSuccessHandoff = (input) => {
+  const rerunCommand = buildResearchRerunCommand(input);
+  return createSuccessHandoff(
+    "Review the ranked records and artifact bundle before turning the result into a publishable claim.",
+    `Open the returned artifact path, inspect the supporting records, and rerun ${rerunCommand} if you need a tighter evidence set.`,
+    [
+      { reason: "Check which records actually support the final claim." },
+      {
+        reason: "Rerun with explicit sources and a narrower timebox if the evidence set is still too broad.",
+        command: rerunCommand
+      }
+    ]
+  );
+};
+var buildShoppingSuccessHandoff = (input) => {
+  const rerunCommand = buildShoppingRerunCommand(input);
+  return createSuccessHandoff(
+    "Review the offer set and diagnostics before calling any result a strong deal.",
+    `Inspect the offers and meta.offerFilterDiagnostics, then rerun ${rerunCommand} if you need a tighter comparison.`,
+    [
+      { reason: "Check which offers survived the workflow filters and why." },
+      {
+        reason: "Rerun with explicit providers or updated budget and region inputs if the comparison is still noisy.",
+        command: rerunCommand
+      }
+    ]
+  );
+};
+var buildProductVideoSuccessHandoff = (input = {}) => {
+  const rerunCommand = buildProductVideoRerunCommand(input);
+  return createSuccessHandoff(
+    "Review the generated asset pack to confirm whether it is visual-ready or metadata-first before briefing production.",
+    "Open the returned pack path, inspect manifest.json plus copy and features, then run the product-video brief helper with that manifest path to generate production briefs and sourcing notes.",
+    [
+      { reason: "Confirm whether the pack already includes enough images or screenshots for production." },
+      {
+        reason: "Run the product-presentation-asset brief helper on manifest.json to generate the production brief files.",
+        command: PRODUCT_VIDEO_BRIEF_HELPER_COMMAND
+      },
+      {
+        reason: "Rerun the asset workflow with adjusted provider or media flags when the current pack is too thin.",
+        command: rerunCommand
+      },
+      { reason: "Source or capture visuals before final handoff if the pack is metadata-first." }
+    ]
+  );
+};
+var buildMacroResolveSuccessHandoff = (input) => {
+  const previewCommand = buildMacroPreviewCommand(input);
+  const executeCommand = buildMacroExecuteCommand(input);
+  const browserRetryCommand = buildMacroExecuteCommand(input, "browser_with_helper", "extension");
+  if (!input.execute) {
+    return createSuccessHandoff(
+      "Review the resolved provider action and provenance before executing the macro.",
+      `Run ${executeCommand} when the resolved action looks correct.`,
+      [
+        { reason: "Inspect resolution.action and resolution.provenance to confirm provider and query shaping." },
+        { reason: "Execute the resolved macro once the plan looks correct.", command: executeCommand },
+        { reason: "Add --default-provider only when you need to force a different provider lane.", command: previewCommand }
+      ]
+    );
+  }
+  if (input.blocked) {
+    return createSuccessHandoff(
+      "Review execution.meta.blocker and failures before retrying the macro.",
+      `Run ${browserRetryCommand} after checking execution.meta.blocker and the current recovery path.`,
+      [
+        { reason: "Inspect execution.meta.blocker and execution.failures before retrying." },
+        { reason: "Retry with browser-scoped challenge automation when the blocker requires live follow-up.", command: browserRetryCommand },
+        { reason: "Preview the resolved action again if you need to switch providers before another execute attempt.", command: previewCommand }
+      ]
+    );
+  }
+  return createSuccessHandoff(
+    "Review execution.records and trace metadata before widening the macro or changing providers.",
+    `Inspect execution.records and execution.meta, then rerun ${previewCommand} if you need a narrower plan.`,
+    [
+      { reason: "Inspect execution.records and execution.meta to confirm the resolved action hit the expected lane." },
+      { reason: "Preview the macro again before changing providers or expression scope.", command: previewCommand },
+      { reason: "Re-execute with browser-scoped challenge automation when the target requires live browser recovery.", command: browserRetryCommand }
+    ]
+  );
+};
+var buildInspiredesignSuccessHandoff = (input) => createSuccessHandoff(
+  input.summary,
+  input.nextStep,
+  [
+    { reason: INSPIREDESIGN_HANDOFF_GUIDANCE.reviewAdvancedBrief },
+    {
+      reason: "Load the baseline workflow runbook before implementation.",
+      command: input.commandExamples.loadBestPractices
+    },
+    {
+      reason: "Load the Canvas contract lane before patching.",
+      command: input.commandExamples.loadDesignAgent
+    },
+    {
+      reason: INSPIREDESIGN_HANDOFF_GUIDANCE.prepareCanvasPlanRequest,
+      command: input.commandExamples.continueInCanvas
+    },
+    { reason: input.deepCaptureRecommendation }
+  ]
+);
+
+// src/providers/renderer.ts
+var toCurrency = (value) => `$${value.toFixed(2)}`;
+var primaryConstraintSummaryFromMeta = (meta) => {
+  const summary = meta.primaryConstraintSummary;
+  return typeof summary === "string" && summary.trim().length > 0 ? summary.trim() : null;
+};
+var isStringArray = (value) => Array.isArray(value) && value.every((item) => typeof item === "string");
+var inspiredesignCaptureAttemptReportFromMeta = (meta) => {
+  const report = meta.captureAttemptReport;
+  if (typeof report !== "object" || report === null || Array.isArray(report)) {
+    return null;
+  }
+  const candidate = report;
+  if (!isStringArray(candidate.worked) || !isStringArray(candidate.didNotWork)) {
+    return null;
+  }
+  return {
+    worked: candidate.worked,
+    didNotWork: candidate.didNotWork
+  };
+};
+var inspiredesignCaptureAttemptSummaryFromMeta = (meta) => {
+  const summary = meta.captureAttemptSummary;
   if (typeof summary === "string" && summary.trim().length > 0) {
     return summary.trim();
   }
@@ -12962,26 +14695,12 @@ var renderInspiredesign = (args) => {
     evidence: args.evidence,
     meta: args.meta
   };
-  const suggestedSteps = [
-    {
-      reason: INSPIREDESIGN_HANDOFF_GUIDANCE.reviewAdvancedBrief
-    },
-    {
-      reason: "Load the baseline workflow runbook before implementation.",
-      command: args.designAgentHandoff.commandExamples.loadBestPractices
-    },
-    {
-      reason: "Load the Canvas contract lane before patching.",
-      command: args.designAgentHandoff.commandExamples.loadDesignAgent
-    },
-    {
-      reason: INSPIREDESIGN_HANDOFF_GUIDANCE.prepareCanvasPlanRequest,
-      command: args.designAgentHandoff.commandExamples.continueInCanvas
-    },
-    {
-      reason: args.designAgentHandoff.deepCaptureRecommendation
-    }
-  ];
+  const handoff = buildInspiredesignSuccessHandoff({
+    summary: followthroughSummary,
+    nextStep: args.designAgentHandoff.nextStep,
+    commandExamples: args.designAgentHandoff.commandExamples,
+    deepCaptureRecommendation: args.designAgentHandoff.deepCaptureRecommendation
+  });
   const files = [
     { path: INSPIREDESIGN_HANDOFF_FILES.designMarkdown, content: args.designMarkdown },
     { path: INSPIREDESIGN_HANDOFF_FILES.advancedBrief, content: args.advancedBriefMarkdown },
@@ -13005,9 +14724,7 @@ var renderInspiredesign = (args) => {
       response: {
         mode: args.mode,
         summary,
-        followthroughSummary,
-        suggestedNextAction: args.designAgentHandoff.nextStep,
-        suggestedSteps,
+        ...handoff,
         ...captureAttemptFields,
         meta: args.meta
       },
@@ -13028,9 +14745,7 @@ var renderInspiredesign = (args) => {
         implementationPlan: args.implementationPlan,
         prototypeGuidanceMarkdown: args.prototypeGuidanceMarkdown,
         evidence: args.evidence,
-        followthroughSummary,
-        suggestedNextAction: args.designAgentHandoff.nextStep,
-        suggestedSteps,
+        ...handoff,
         ...captureAttemptFields,
         meta: args.meta
       },
@@ -13044,9 +14759,7 @@ var renderInspiredesign = (args) => {
         markdown: args.designMarkdown,
         implementationPlanMarkdown: args.implementationPlanMarkdown,
         prototypeGuidanceMarkdown: args.prototypeGuidanceMarkdown,
-        followthroughSummary,
-        suggestedNextAction: args.designAgentHandoff.nextStep,
-        suggestedSteps,
+        ...handoff,
         ...captureAttemptFields,
         meta: args.meta
       },
@@ -13058,9 +14771,7 @@ var renderInspiredesign = (args) => {
       response: {
         mode: args.mode,
         context: contextPayload,
-        followthroughSummary,
-        suggestedNextAction: args.designAgentHandoff.nextStep,
-        suggestedSteps,
+        ...handoff,
         ...captureAttemptFields,
         meta: args.meta
       },
@@ -13070,9 +14781,7 @@ var renderInspiredesign = (args) => {
   return {
     response: {
       mode: "path",
-      followthroughSummary,
-      suggestedNextAction: args.designAgentHandoff.nextStep,
-      suggestedSteps,
+      ...handoff,
       ...captureAttemptFields,
       meta: args.meta
     },
@@ -13093,251 +14802,119 @@ var CANVAS_GOVERNANCE_BLOCK_KEYS = [
   "colorSystem",
   "surfaceSystem",
   "iconSystem",
-  "motionSystem",
-  "responsiveSystem",
-  "accessibilityPolicy",
-  "libraryPolicy",
-  "runtimeBudgets"
-];
-var CANVAS_REQUIRED_MUTATION_GOVERNANCE_KEYS = [
-  "intent",
-  "generationPlan",
-  "designLanguage",
-  "contentModel",
-  "layoutSystem",
-  "typographySystem",
-  "motionSystem",
-  "responsiveSystem",
-  "accessibilityPolicy"
-];
-var CANVAS_REQUIRED_SAVE_GOVERNANCE_KEYS = [
-  "intent",
-  "generationPlan",
-  "designLanguage",
-  "contentModel",
-  "layoutSystem",
-  "typographySystem",
-  "colorSystem",
-  "surfaceSystem",
-  "iconSystem",
-  "motionSystem",
-  "responsiveSystem",
-  "accessibilityPolicy",
-  "libraryPolicy",
-  "runtimeBudgets"
-];
-var CANVAS_OPTIONAL_INHERITED_GOVERNANCE_KEYS = [
-  "colorSystem",
-  "surfaceSystem",
-  "iconSystem",
-  "libraryPolicy",
-  "runtimeBudgets"
-];
-var CANVAS_GENERATION_PLAN_REQUIRED_FIELDS = [
-  "targetOutcome",
-  "visualDirection",
-  "layoutStrategy",
-  "contentStrategy",
-  "componentStrategy",
-  "motionPosture",
-  "responsivePosture",
-  "accessibilityPosture",
-  "validationTargets"
-];
-var CANVAS_VISUAL_DIRECTION_PROFILES = [
-  "clean-room",
-  "cinematic-minimal",
-  "product-story",
-  "commerce-system",
-  "control-room",
-  "ops-control",
-  "auth-focused",
-  "settings-system",
-  "documentation"
-];
-var CANVAS_THEME_STRATEGIES = ["single-theme", "light-dark-parity", "multi-theme-system"];
-var CANVAS_NAVIGATION_MODELS = ["global-header", "sidebar", "tabbed", "contextual", "immersive"];
-var CANVAS_INTERACTION_STATES = [
-  "default",
-  "hover",
-  "focus",
-  "active",
-  "disabled",
-  "loading",
-  "empty",
-  "error",
-  "success",
-  "selected"
-];
-var CANVAS_PLAN_VIEWPORTS = ["desktop", "tablet", "mobile"];
-var CANVAS_PLAN_THEMES = ["light", "dark"];
-var CANVAS_MOTION_LEVELS = ["none", "minimal", "subtle", "expressive"];
-var CANVAS_REDUCED_MOTION_POLICIES = ["respect-user-preference", "static-alternative"];
-var CANVAS_KEYBOARD_NAVIGATION_MODES = ["full", "core-flows"];
-var CANVAS_BROWSER_VALIDATION_MODES = ["required", "optional"];
-var CANVAS_VALIDATION_TARGET_BLOCK_ON_CODES = [
-  "missing-generation-plan",
-  "invalid-generation-plan",
-  "missing-governance-block",
-  "missing-intent",
-  "missing-design-language",
-  "missing-content-model",
-  "missing-typography-system",
-  "missing-color-role",
-  "missing-surface-policy",
-  "missing-state-coverage",
-  "missing-reduced-motion-policy",
-  "missing-responsive-policy",
-  "overflow",
-  "token-missing",
-  "broken-asset-reference",
-  "contrast-failure",
-  "hierarchy-weak",
-  "asset-provenance-missing",
-  "font-policy-missing",
-  "font-load-failure",
-  "reduced-motion-violation",
-  "unresolved-component-binding",
-  "icon-policy-violation",
-  "library-policy-violation",
-  "responsive-mismatch",
-  "runtime-budget-exceeded",
-  "unsupported-target",
-  "export-warning"
-];
-var CANVAS_PUBLIC_WARNING_CLASSES = CANVAS_VALIDATION_TARGET_BLOCK_ON_CODES;
-
-// src/providers/workflow-handoff.ts
-var PRODUCT_VIDEO_BRIEF_HELPER_PATH = "./skills/opendevbrowser-product-presentation-asset/scripts/render-video-brief.sh";
-var PRODUCT_VIDEO_BRIEF_HELPER_COMMAND = `${PRODUCT_VIDEO_BRIEF_HELPER_PATH} <pack>/manifest.json`;
-var createSuccessHandoff = (followthroughSummary, suggestedNextAction, suggestedSteps) => ({
-  followthroughSummary,
-  suggestedNextAction,
-  suggestedSteps
-});
-var cliExample = (command, args = "") => `npx opendevbrowser ${command}${args ? ` ${args}` : ""}`;
-var quoteCliValue = (value) => JSON.stringify(value);
-var buildResearchRerunCommand = (topic) => cliExample(
-  "research run",
-  `--topic ${quoteCliValue(topic)} --days 14 --source-selection auto --sources web,community --mode json --output-format json`
-);
-var buildShoppingRerunCommand = (input) => {
-  const providers = input.providers?.length ? ` --providers ${input.providers.join(",")}` : " --providers shopping/bestbuy,shopping/ebay";
-  const budget = typeof input.budget === "number" ? ` --budget ${input.budget}` : "";
-  const region = input.region ? ` --region ${quoteCliValue(input.region)}` : "";
-  const browserMode = ` --browser-mode ${input.browserMode ?? "managed"}`;
-  const sort = input.sort ? ` --sort ${input.sort}` : "";
-  return cliExample(
-    "shopping run",
-    `--query ${quoteCliValue(input.query)}${providers}${budget}${region}${browserMode}${sort} --mode json --output-format json`
-  );
-};
-var buildProductVideoRerunCommand = (input = {}) => {
-  const target = input.productUrl ? `--product-url ${quoteCliValue(input.productUrl)}` : `--product-name ${quoteCliValue(input.productName ?? "<product-name>")}`;
-  const providerHint = input.providerHint ? ` --provider-hint ${input.providerHint}` : "";
-  const screenshots = input.includeScreenshots ? " --include-screenshots" : "";
-  const allImages = input.includeAllImages ? " --include-all-images" : "";
-  const includeCopy = input.includeCopy ? " --include-copy" : "";
-  return cliExample(
-    "product-video run",
-    `${target}${providerHint}${screenshots}${allImages}${includeCopy} --output-format json`
-  );
-};
-var buildMacroResolveArgs = (input, options) => {
-  const defaultProvider = input.defaultProvider ? ` --default-provider ${input.defaultProvider}` : "";
-  const execute = options?.execute ? " --execute" : "";
-  const challenge = options?.challengeAutomationMode ? ` --challenge-automation-mode ${options.challengeAutomationMode}` : "";
-  const outputFormat = options?.includeOutputFormat === false ? "" : " --output-format json";
-  return `--expression ${quoteCliValue(input.expression)}${defaultProvider}${execute}${challenge}${outputFormat}`;
-};
-var buildMacroPreviewCommand = (input) => cliExample("macro-resolve", buildMacroResolveArgs(input));
-var buildMacroExecuteCommand = (input, challengeAutomationMode) => cliExample("macro-resolve", buildMacroResolveArgs(input, {
-  execute: true,
-  challengeAutomationMode
-}));
-var buildResearchSuccessHandoff = (topic) => {
-  const rerunCommand = buildResearchRerunCommand(topic);
-  return createSuccessHandoff(
-    "Review the ranked records and artifact bundle before turning the result into a publishable claim.",
-    `Open the returned artifact path, inspect the supporting records, and rerun ${rerunCommand} if you need a tighter evidence set.`,
-    [
-      { reason: "Check which records actually support the final claim." },
-      {
-        reason: "Rerun with explicit sources and a narrower timebox if the evidence set is still too broad.",
-        command: rerunCommand
-      }
-    ]
-  );
-};
-var buildShoppingSuccessHandoff = (input) => {
-  const rerunCommand = buildShoppingRerunCommand(input);
-  return createSuccessHandoff(
-    "Review the offer set and diagnostics before calling any result a strong deal.",
-    `Inspect the offers and meta.offerFilterDiagnostics, then rerun ${rerunCommand} if you need a tighter comparison.`,
-    [
-      { reason: "Check which offers survived the workflow filters and why." },
-      {
-        reason: "Rerun with explicit providers or updated budget and region inputs if the comparison is still noisy.",
-        command: rerunCommand
-      }
-    ]
-  );
-};
-var buildProductVideoSuccessHandoff = (input = {}) => {
-  const rerunCommand = buildProductVideoRerunCommand(input);
-  return createSuccessHandoff(
-    "Review the generated asset pack to confirm whether it is visual-ready or metadata-first before briefing production.",
-    `Open the returned pack path, inspect manifest.json plus copy and features, then run ${PRODUCT_VIDEO_BRIEF_HELPER_COMMAND} to generate production briefs and sourcing notes.`,
-    [
-      { reason: "Confirm whether the pack already includes enough images or screenshots for production." },
-      {
-        reason: "Run the product-presentation-asset brief helper on manifest.json to generate the production brief files.",
-        command: PRODUCT_VIDEO_BRIEF_HELPER_COMMAND
-      },
-      {
-        reason: "Rerun the asset workflow with adjusted provider or media flags when the current pack is too thin.",
-        command: rerunCommand
-      },
-      { reason: "Source or capture visuals before final handoff if the pack is metadata-first." }
-    ]
-  );
-};
-var buildMacroResolveSuccessHandoff = (input) => {
-  const previewCommand = buildMacroPreviewCommand(input);
-  const executeCommand = buildMacroExecuteCommand(input);
-  const browserRetryCommand = buildMacroExecuteCommand(input, "browser");
-  if (!input.execute) {
-    return createSuccessHandoff(
-      "Review the resolved provider action and provenance before executing the macro.",
-      `Run ${executeCommand} when the resolved action looks correct.`,
-      [
-        { reason: "Inspect resolution.action and resolution.provenance to confirm provider and query shaping." },
-        { reason: "Execute the resolved macro once the plan looks correct.", command: executeCommand },
-        { reason: "Add --default-provider only when you need to force a different provider lane.", command: previewCommand }
-      ]
-    );
-  }
-  if (input.blocked) {
-    return createSuccessHandoff(
-      "Review execution.meta.blocker and failures before retrying the macro.",
-      `Run ${browserRetryCommand} after checking execution.meta.blocker and the current recovery path.`,
-      [
-        { reason: "Inspect execution.meta.blocker and execution.failures before retrying." },
-        { reason: "Retry with browser-scoped challenge automation when the blocker requires live follow-up.", command: browserRetryCommand },
-        { reason: "Preview the resolved action again if you need to switch providers before another execute attempt.", command: previewCommand }
-      ]
-    );
-  }
-  return createSuccessHandoff(
-    "Review execution.records and trace metadata before widening the macro or changing providers.",
-    `Inspect execution.records and execution.meta, then rerun ${previewCommand} if you need a narrower plan.`,
-    [
-      { reason: "Inspect execution.records and execution.meta to confirm the resolved action hit the expected lane." },
-      { reason: "Preview the macro again before changing providers or expression scope.", command: previewCommand },
-      { reason: "Re-execute with browser-scoped challenge automation when the target requires live browser recovery.", command: browserRetryCommand }
-    ]
-  );
-};
+  "motionSystem",
+  "responsiveSystem",
+  "accessibilityPolicy",
+  "libraryPolicy",
+  "runtimeBudgets"
+];
+var CANVAS_REQUIRED_MUTATION_GOVERNANCE_KEYS = [
+  "intent",
+  "generationPlan",
+  "designLanguage",
+  "contentModel",
+  "layoutSystem",
+  "typographySystem",
+  "motionSystem",
+  "responsiveSystem",
+  "accessibilityPolicy"
+];
+var CANVAS_REQUIRED_SAVE_GOVERNANCE_KEYS = [
+  "intent",
+  "generationPlan",
+  "designLanguage",
+  "contentModel",
+  "layoutSystem",
+  "typographySystem",
+  "colorSystem",
+  "surfaceSystem",
+  "iconSystem",
+  "motionSystem",
+  "responsiveSystem",
+  "accessibilityPolicy",
+  "libraryPolicy",
+  "runtimeBudgets"
+];
+var CANVAS_OPTIONAL_INHERITED_GOVERNANCE_KEYS = [
+  "colorSystem",
+  "surfaceSystem",
+  "iconSystem",
+  "libraryPolicy",
+  "runtimeBudgets"
+];
+var CANVAS_GENERATION_PLAN_REQUIRED_FIELDS = [
+  "targetOutcome",
+  "visualDirection",
+  "layoutStrategy",
+  "contentStrategy",
+  "componentStrategy",
+  "motionPosture",
+  "responsivePosture",
+  "accessibilityPosture",
+  "validationTargets"
+];
+var CANVAS_VISUAL_DIRECTION_PROFILES = [
+  "clean-room",
+  "cinematic-minimal",
+  "product-story",
+  "commerce-system",
+  "control-room",
+  "ops-control",
+  "auth-focused",
+  "settings-system",
+  "documentation"
+];
+var CANVAS_THEME_STRATEGIES = ["single-theme", "light-dark-parity", "multi-theme-system"];
+var CANVAS_NAVIGATION_MODELS = ["global-header", "sidebar", "tabbed", "contextual", "immersive"];
+var CANVAS_INTERACTION_STATES = [
+  "default",
+  "hover",
+  "focus",
+  "active",
+  "disabled",
+  "loading",
+  "empty",
+  "error",
+  "success",
+  "selected"
+];
+var CANVAS_PLAN_VIEWPORTS = ["desktop", "tablet", "mobile"];
+var CANVAS_PLAN_THEMES = ["light", "dark"];
+var CANVAS_MOTION_LEVELS = ["none", "minimal", "subtle", "expressive"];
+var CANVAS_REDUCED_MOTION_POLICIES = ["respect-user-preference", "static-alternative"];
+var CANVAS_KEYBOARD_NAVIGATION_MODES = ["full", "core-flows"];
+var CANVAS_BROWSER_VALIDATION_MODES = ["required", "optional"];
+var CANVAS_VALIDATION_TARGET_BLOCK_ON_CODES = [
+  "missing-generation-plan",
+  "invalid-generation-plan",
+  "missing-governance-block",
+  "missing-intent",
+  "missing-design-language",
+  "missing-content-model",
+  "missing-typography-system",
+  "missing-color-role",
+  "missing-surface-policy",
+  "missing-state-coverage",
+  "missing-reduced-motion-policy",
+  "missing-responsive-policy",
+  "overflow",
+  "token-missing",
+  "broken-asset-reference",
+  "contrast-failure",
+  "hierarchy-weak",
+  "asset-provenance-missing",
+  "font-policy-missing",
+  "font-load-failure",
+  "reduced-motion-violation",
+  "unresolved-component-binding",
+  "icon-policy-violation",
+  "library-policy-violation",
+  "responsive-mismatch",
+  "runtime-budget-exceeded",
+  "unsupported-target",
+  "export-warning"
+];
+var CANVAS_PUBLIC_WARNING_CLASSES = CANVAS_VALIDATION_TARGET_BLOCK_ON_CODES;
 
 // src/providers/shopping-postprocess.ts
 import { createHash as createHash4 } from "crypto";
@@ -14645,6 +16222,16 @@ var resolveResearchAutoExcludedProviders = (sourceSelection, resolvedSources, de
     return source !== null && sourceSet.has(source);
   }).sort((left, right) => left.localeCompare(right));
 };
+var buildResearchSearchFilters = (source, args) => ({
+  include_engagement: args.includeEngagement ?? false,
+  timebox_from: args.timebox.from,
+  timebox_to: args.timebox.to,
+  ...source === "community" || source === "social" ? {
+    pageLimit: 1,
+    hopLimit: 0,
+    expansionPerRecord: 0
+  } : {}
+});
 var compileResearchExecutionPlan = (args) => {
   const topic = args.input.topic?.trim();
   if (!topic) {
@@ -14681,11 +16268,10 @@ var compileResearchExecutionPlan = (args) => {
       source,
       query: topic,
       limit: searchLimit,
-      filters: {
-        include_engagement: args.input.includeEngagement ?? false,
-        timebox_from: timebox.from,
-        timebox_to: timebox.to
-      }
+      filters: buildResearchSearchFilters(source, {
+        includeEngagement: args.input.includeEngagement,
+        timebox
+      })
     }
   }));
   return {
@@ -14921,7 +16507,7 @@ var executeResearchWorkflowPlan = async (runtime, plan, options) => {
   };
 };
 
-// src/providers/inspiredesign-capture-mode.ts
+// src/inspiredesign/capture-mode.ts
 var hasInspiredesignUrls = (urls) => {
   return Array.isArray(urls) && urls.some((url) => url.trim().length > 0);
 };
@@ -15493,6 +17079,7 @@ var workflowTestUtils = {
   buildWorkflowResumePayload: (kind, input) => buildWorkflowResumePayload(kind, input)
 };
 var PRODUCT_ASSET_FETCH_TIMEOUT_MS = 15e3;
+var RESEARCH_PROVIDER_STEP_TIMEOUT_MS = 3e4;
 var resolveAuxiliaryFetchTimeoutMs = (timeoutMs) => {
   if (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs) || timeoutMs <= 0) {
     return PRODUCT_ASSET_FETCH_TIMEOUT_MS;
@@ -15676,9 +17263,16 @@ var createRemainingTimeoutResolver = (timeoutMs) => {
     return Math.max(1, timeoutMs - Math.max(0, Date.now() - startedAtMs));
   };
 };
+var resolveResearchProviderStepTimeoutMs = (timeoutMs) => {
+  if (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+    return void 0;
+  }
+  return Math.max(1, Math.min(timeoutMs, RESEARCH_PROVIDER_STEP_TIMEOUT_MS));
+};
 var INSPIREDESIGN_RENDER_MODES = /* @__PURE__ */ new Set(["compact", "json", "md", "context", "path"]);
 var INSPIREDESIGN_CAPTURE_MODES = /* @__PURE__ */ new Set(["off", "deep"]);
 var INSPIREDESIGN_COOKIE_POLICIES = /* @__PURE__ */ new Set(["off", "auto", "required"]);
+var WORKFLOW_BROWSER_MODES = /* @__PURE__ */ new Set(["auto", "extension", "managed"]);
 var isJsonRecord6 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var INSPIREDESIGN_CAPTURE_UNAVAILABLE_FAILURE = "Deep capture requested, but browser capture is unavailable in this execution lane.";
 var isCanvasVisualDirectionProfile = (value) => {
@@ -15701,6 +17295,7 @@ var serializeInspiredesignRunInput = (input) => ({
   ...typeof input.timeoutMs === "number" ? { timeoutMs: input.timeoutMs } : {},
   ...input.outputDir ? { outputDir: input.outputDir } : {},
   ...typeof input.ttlHours === "number" ? { ttlHours: input.ttlHours } : {},
+  ...input.browserMode ? { browserMode: input.browserMode } : {},
   ...typeof input.useCookies === "boolean" ? { useCookies: input.useCookies } : {},
   ...input.challengeAutomationMode ? { challengeAutomationMode: input.challengeAutomationMode } : {},
   ...input.cookiePolicyOverride ? { cookiePolicyOverride: input.cookiePolicyOverride } : {}
@@ -15775,6 +17370,7 @@ var parseInspiredesignEnvelopeInput = (input) => {
     ...typeof input.timeoutMs === "number" ? { timeoutMs: input.timeoutMs } : {},
     ...typeof input.outputDir === "string" && input.outputDir.length > 0 ? { outputDir: input.outputDir } : {},
     ...typeof input.ttlHours === "number" ? { ttlHours: input.ttlHours } : {},
+    ...typeof input.browserMode === "string" && WORKFLOW_BROWSER_MODES.has(input.browserMode) ? { browserMode: input.browserMode } : {},
     ...typeof input.useCookies === "boolean" ? { useCookies: input.useCookies } : {},
     ...isChallengeAutomationMode(input.challengeAutomationMode) ? { challengeAutomationMode: input.challengeAutomationMode } : {},
     ...typeof input.cookiePolicyOverride === "string" && INSPIREDESIGN_COOKIE_POLICIES.has(input.cookiePolicyOverride) ? { cookiePolicyOverride: input.cookiePolicyOverride } : {}
@@ -15868,10 +17464,13 @@ var buildInspiredesignStepEnvelope = (workflowInput, trace, stepIndex, url) => b
   }
 );
 var buildInspiredesignFetchOptions = (workflowInput, envelope, timeoutMs) => withWorkflowResumeEnvelopeIntent(
-  withChallengeAutomationOverride(
-    withCookieOverrides({
-      ...typeof timeoutMs === "number" ? { timeoutMs } : {}
-    }, workflowInput),
+  withBrowserModeOverride(
+    withChallengeAutomationOverride(
+      withCookieOverrides({
+        ...typeof timeoutMs === "number" ? { timeoutMs } : {}
+      }, workflowInput),
+      workflowInput
+    ),
     workflowInput
   ),
   "workflow.inspiredesign",
@@ -16054,8 +17653,12 @@ var excerptFromInspiredesignCapture = (capture) => {
   return captureSnippet(capture?.snapshot?.content, 240) ?? captureSnippet(capture?.dom?.outerHTML, 240) ?? captureSnippet(capture?.clone?.componentPreview, 240) ?? captureSnippet(capture?.clone?.cssPreview, 240);
 };
 var isInspiredesignFetchRecovered = (reference) => {
-  return reference.fetchStatus === "failed" && reference.captureStatus === "captured" && (Boolean(reference.title) || Boolean(reference.excerpt));
+  return reference.fetchStatus === "failed" && reference.captureStatus === "captured" && hasInspiredesignUsableReferenceEvidence(reference);
 };
+var summarizeInspiredesignRecoveredFetches = (references) => references.filter(isInspiredesignFetchRecovered).map((reference) => ({
+  url: reference.url,
+  ...reference.fetchFailure ? { fetchFailure: reference.fetchFailure } : {}
+}));
 var buildInspiredesignReference = (url, result, capture) => {
   const primary = getInspiredesignPrimaryRecord(result, url);
   const normalizedCapture = normalizeInspiredesignCaptureEvidence(capture.capture);
@@ -16102,11 +17705,13 @@ var summarizeInspiredesignFetchConstraint = (references) => {
 var buildInspiredesignMeta = (runtime, workflowInput, references, failures, followthrough) => {
   const failedCaptures = references.filter((reference) => reference.captureStatus === "failed");
   const captureAttemptReport = summarizeInspiredesignCaptureAttempts(references);
+  const recoveredFetches = summarizeInspiredesignRecoveredFetches(references);
   let reasonCodeDistribution = summarizeReasonCodeDistribution(failures);
   let meta = withCamelCasePrimaryConstraintMeta(withReasonCodeDistributionMeta({
     selection: {
       urls: workflowInput.urls,
       capture_mode: workflowInput.captureMode,
+      ...workflowInput.browserMode ? { requested_browser_mode: workflowInput.browserMode } : {},
       include_prototype_guidance: Boolean(workflowInput.includePrototypeGuidance)
     },
     metrics: {
@@ -16115,6 +17720,10 @@ var buildInspiredesignMeta = (runtime, workflowInput, references, failures, foll
       captured_references: references.filter((reference) => reference.captureStatus === "captured").length,
       failed_fetches: references.filter((reference) => reference.fetchStatus === "failed" && !isInspiredesignFetchRecovered(reference)).length,
       failed_captures: failedCaptures.length,
+      ...recoveredFetches.length > 0 ? {
+        recovered_fetches: recoveredFetches.length,
+        recovered_fetch_details: recoveredFetches
+      } : {},
       ...captureAttemptReport ? { capture_attempts: captureAttemptReport.counts } : {}
     },
     alerts: buildWorkflowAlerts(runtime, failures)
@@ -16657,10 +18266,17 @@ var runResearchWorkflow = async (runtime, input) => {
     }
   ];
   const buildResearchStepOptions = (step, stepEnvelope) => {
-    const stepOptions = withChallengeAutomationOverride(withCookieOverrides({
-      source: step.input.source,
-      ...typeof workflowInput.timeoutMs === "number" ? { timeoutMs: workflowInput.timeoutMs } : {}
-    }, workflowInput), workflowInput);
+    const timeoutMs = resolveResearchProviderStepTimeoutMs(workflowInput.timeoutMs);
+    const stepOptions = withBrowserModeOverride(
+      withChallengeAutomationOverride(
+        withCookieOverrides({
+          source: step.input.source,
+          ...typeof timeoutMs === "number" ? { timeoutMs } : {}
+        }, workflowInput),
+        workflowInput
+      ),
+      workflowInput
+    );
     return withWorkflowResumeEnvelopeIntent(
       stepOptions,
       "workflow.research",
@@ -16723,7 +18339,8 @@ var runResearchWorkflow = async (runtime, input) => {
     timebox: resolvedTimebox,
     selection: withExcludedProviders({
       source_selection: plan.compiled.sourceSelection,
-      resolved_sources: plan.compiled.resolvedSources
+      resolved_sources: plan.compiled.resolvedSources,
+      ...workflowInput.browserMode ? { requested_browser_mode: workflowInput.browserMode } : {}
     }, plan.compiled.autoExcludedProviders),
     metrics: {
       total_records: mergedRecords.length,
@@ -16750,7 +18367,10 @@ var runResearchWorkflow = async (runtime, input) => {
     failures: mergedFailures,
     alerts: buildWorkflowAlerts(runtime, mergedFailures)
   }, primaryConstraintFailures);
-  const handoff = buildResearchSuccessHandoff(plan.compiled.topic);
+  const handoff = buildResearchSuccessHandoff({
+    topic: plan.compiled.topic,
+    browserMode: workflowInput.browserMode
+  });
   const responseMeta = withFollowthroughMeta(meta, handoff);
   const rendered = renderResearch({
     mode: workflowInput.mode,
@@ -17185,6 +18805,7 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
         providers: providerHint ? [providerHint] : void 0,
         mode: "json",
         ...timeoutOptions,
+        browserMode: workflowInput.browserMode,
         useCookies: workflowInput.useCookies,
         challengeAutomationMode: workflowInput.challengeAutomationMode,
         cookiePolicyOverride: workflowInput.cookiePolicyOverride
@@ -17263,12 +18884,15 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
     details = await runtime.fetch(
       { url: productUrl },
       withWorkflowResumeEnvelopeIntent(
-        withChallengeAutomationOverride(
-          withCookieOverrides({
-            source,
-            providerIds: shoppingProviderId ? [shoppingProviderId] : void 0,
-            ...timeoutOptions
-          }, workflowInput),
+        withBrowserModeOverride(
+          withChallengeAutomationOverride(
+            withCookieOverrides({
+              source,
+              providerIds: shoppingProviderId ? [shoppingProviderId] : void 0,
+              ...timeoutOptions
+            }, workflowInput),
+            workflowInput
+          ),
           workflowInput
         ),
         "workflow.product_video",
@@ -17418,14 +19042,16 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
     productUrl,
     productName: workflowInput.product_name,
     providerHint,
+    browserMode: workflowInput.browserMode,
     includeScreenshots: workflowInput.include_screenshots,
     includeAllImages: workflowInput.include_all_images,
     includeCopy: workflowInput.include_copy
   });
   const meta = withFollowthroughMeta({
+    ...workflowInput.browserMode ? { selection: { requested_browser_mode: workflowInput.browserMode } } : {},
     alerts: buildWorkflowAlerts(runtime, details.failures),
     failures: details.failures,
-    ...primaryIssue ? { primaryConstraintSummary: primaryIssue.summary } : {},
+    ...primaryIssue ? { primaryConstraint: primaryIssue, primaryConstraintSummary: primaryIssue.summary } : {},
     reasonCodeDistribution,
     transcript_strategy_failures: transcriptStrategyFailures,
     transcriptStrategyFailures,
@@ -17466,11 +19092,11 @@ var WORKFLOW_KIND_BY_SUSPENDED_INTENT_KIND2 = {
   "workflow.inspiredesign": "inspiredesign",
   "workflow.product_video": "product_video"
 };
-var EXTENSION_FIRST_SOCIAL_FALLBACK_PLATFORMS = /* @__PURE__ */ new Set(["x", "reddit", "bluesky", "facebook", "linkedin"]);
+var EXTENSION_FIRST_SOCIAL_FALLBACK_PLATFORMS = /* @__PURE__ */ new Set(["x", "reddit", "bluesky", "facebook", "linkedin", "threads"]);
 var EXTENSION_MINIMAL_TRAVERSAL_SOCIAL_PLATFORMS = /* @__PURE__ */ new Set(["linkedin"]);
 var EXTENSION_FIRST_FALLBACK_MODES = ["extension", "managed_headed"];
 var SOCIAL_BROWSER_RECOVERY_REASON_CODES = /* @__PURE__ */ new Set(["challenge_detected"]);
-var SEARCH_RENDER_RECOVERY_SOCIAL_PLATFORMS = /* @__PURE__ */ new Set(["x", "bluesky", "reddit", "facebook"]);
+var SEARCH_RENDER_RECOVERY_SOCIAL_PLATFORMS = /* @__PURE__ */ new Set(["x", "bluesky", "reddit", "facebook", "threads"]);
 var withPrioritizedFallbackModes = (prioritized, existing) => [.../* @__PURE__ */ new Set([...prioritized, ...existing ?? []])];
 var buildSocialRecoveryHints = (platform, options) => {
   const existing = options?.recoveryHints?.();
@@ -17629,6 +19255,154 @@ var SOCIAL_SEARCH_ENDPOINTS = {
   threads: (query, page) => `https://www.threads.net/search?q=${encodeURIComponent(query)}&page=${page}`,
   youtube: (query, page) => `https://www.youtube.com/results?search_query=${encodeURIComponent(query)}&page=${page}`
 };
+var FALLBACK_SHELL_LINK_SEGMENTS = /* @__PURE__ */ new Set([
+  "account",
+  "auth",
+  "about",
+  "cart",
+  "categories",
+  "category",
+  "collections",
+  "contact",
+  "explore",
+  "help",
+  "home",
+  "legal",
+  "login",
+  "policies",
+  "product",
+  "products",
+  "privacy",
+  "search",
+  "settings",
+  "shop",
+  "signin",
+  "sign-in",
+  "sitemap",
+  "store",
+  "submit",
+  "support",
+  "terms"
+]);
+var FALLBACK_SHELL_TEXT_TOKENS = /* @__PURE__ */ new Set([
+  "account",
+  "ad",
+  "ads",
+  "about",
+  "cart",
+  "contact",
+  "explore",
+  "help",
+  "home",
+  "in",
+  "legal",
+  "log",
+  "login",
+  "policies",
+  "product",
+  "products",
+  "privacy",
+  "search",
+  "settings",
+  "sign",
+  "signin",
+  "submit",
+  "support",
+  "terms"
+]);
+var FALLBACK_HEAD_RE2 = /<head\b[^>]*>[\s\S]*?<\/head>/i;
+var FALLBACK_BODY_RE2 = /<body\b[^>]*>([\s\S]*?)<\/body>/i;
+var FALLBACK_MIN_MEANINGFUL_TEXT_CHARS = 20;
+var FALLBACK_MIN_MEANINGFUL_TOKENS = 3;
+var FALLBACK_SHELL_PHRASES_RE = /\b(?:search results?|please enable javascript|enable javascript|continue|welcome|accept cookies?|privacy policy|terms of service)\b/i;
+var extractFallbackBodyHtml = (html) => {
+  const body = FALLBACK_BODY_RE2.exec(html)?.[1];
+  return body ?? html.replace(FALLBACK_HEAD_RE2, " ");
+};
+var extractFallbackBodyText = (html) => {
+  return extractText(extractFallbackBodyHtml(html));
+};
+var hasUsableFallbackText = (html) => {
+  const text = extractFallbackBodyText(html);
+  const blocker = classifyBlockerSignal({
+    source: "runtime_fetch",
+    message: text,
+    status: 200,
+    providerErrorCode: "unavailable",
+    retryable: true
+  });
+  if (blocker && blocker.type !== "unknown") return false;
+  if (text.length < FALLBACK_MIN_MEANINGFUL_TEXT_CHARS || FALLBACK_SHELL_PHRASES_RE.test(text)) {
+    return false;
+  }
+  const tokens = text.toLowerCase().match(/[a-z0-9]+/g) ?? [];
+  const meaningfulTokens = tokens.filter((token) => !FALLBACK_SHELL_TEXT_TOKENS.has(token));
+  return meaningfulTokens.length >= FALLBACK_MIN_MEANINGFUL_TOKENS;
+};
+var isUsableFallbackLink = (link, documentUrl) => {
+  try {
+    const parsed = new URL(link);
+    const source = new URL(documentUrl);
+    const segments = parsed.pathname.toLowerCase().split("/").filter(Boolean);
+    const firstSegment = segments[0];
+    if (parsed.origin === source.origin && parsed.pathname === source.pathname) {
+      return false;
+    }
+    if (segments.length === 0 && parsed.search.length === 0) {
+      return false;
+    }
+    return firstSegment === void 0 || !FALLBACK_SHELL_LINK_SEGMENTS.has(firstSegment);
+  } catch {
+    return false;
+  }
+};
+var hasUsableFallbackBodyLink = (documentUrl, html) => extractStructuredContent(extractFallbackBodyHtml(html), documentUrl).links.some((link) => isUsableFallbackLink(link, documentUrl));
+var hasUsableFallbackContent = (documentUrl, html) => hasUsableFallbackText(html) || hasUsableFallbackBodyLink(documentUrl, html);
+var isBlockedRedditFallbackLink = (link) => {
+  try {
+    const hostname = new URL(link).hostname.toLowerCase();
+    const isReddit = hostname === "reddit.com" || hostname.endsWith(".reddit.com");
+    return isReddit && !isAllowedSocialSearchExpansionUrl("reddit", link);
+  } catch {
+    return false;
+  }
+};
+var shouldOwnerReviewCommunityRedditSearchFallback = (input) => input.providerId === "community/default" && input.source === "community" && input.operation === "search" && isFirstPartySocialSearchRoute("reddit", input.url) && input.extracted.links.length > 0 && input.extracted.links.every(isBlockedRedditFallbackLink);
+var shouldReturnCompletedFallbackForOwnerReview = (args) => args.document.browserFallback !== void 0 && args.ownerReview?.({
+  providerId: args.providerId,
+  source: args.source,
+  operation: args.operation,
+  url: args.document.url,
+  html: args.document.html,
+  extracted: extractStructuredContent(args.document.html, args.document.url)
+}) === true;
+var toCompletedFallbackDocument = (args) => {
+  const resolvedUrl = canonicalizeUrl(readFallbackString(args.fallback.output, "url") ?? args.url);
+  const html = readFallbackString(args.fallback.output, "html");
+  if (!html) {
+    throw toCompletedFallbackOutputError({ ...args, provider: args.providerId, url: resolvedUrl, outputReason: "missing_or_empty_html" });
+  }
+  const extracted = extractStructuredContent(html, resolvedUrl);
+  const reviewInput = {
+    providerId: args.providerId,
+    source: args.source,
+    operation: args.operation,
+    url: resolvedUrl,
+    html,
+    extracted
+  };
+  if (!hasUsableFallbackContent(resolvedUrl, html) && !args.ownerReview?.(reviewInput)) {
+    throw toCompletedFallbackOutputError({ ...args, provider: args.providerId, url: resolvedUrl, outputReason: "empty_extracted_content" });
+  }
+  return {
+    url: resolvedUrl,
+    status: 200,
+    html,
+    text: extracted.text,
+    links: extracted.links,
+    browserFallback: toBrowserFallbackObservation(args.fallback)
+  };
+};
 var describeDefaultFetchedIssue = (document) => {
   const extracted = extractStructuredContent(document.html, document.url);
   const title = typeof extracted.metadata.title === "string" ? extracted.metadata.title : void 0;
@@ -17690,6 +19464,9 @@ var resolveDefaultFallbackDocumentIfNeeded = async (args) => {
   if (!initialIssue) {
     return { document: currentDocument, ...described };
   }
+  if (shouldReturnCompletedFallbackForOwnerReview({ ...args, document: currentDocument })) {
+    return { document: currentDocument, ...described };
+  }
   if (initialIssue.reasonCode === "env_limited" && !initialIssue.constraint) {
     return { document: currentDocument, ...described };
   }
@@ -17720,18 +19497,18 @@ var resolveDefaultFallbackDocumentIfNeeded = async (args) => {
         fallback
       });
     }
-    const resolvedUrl = canonicalizeUrl(readFallbackString(fallback.output, "url") ?? currentDocument.url);
-    const html = readFallbackString(fallback.output, "html") ?? "";
-    const extracted = extractStructuredContent(html, resolvedUrl);
-    currentDocument = {
-      url: resolvedUrl,
-      status: 200,
-      html,
-      text: extracted.text,
-      links: extracted.links,
-      browserFallback: toBrowserFallbackObservation(fallback)
-    };
+    currentDocument = toCompletedFallbackDocument({
+      providerId: args.providerId,
+      source: args.source,
+      operation: args.operation,
+      url: currentDocument.url,
+      fallback,
+      ownerReview: args.ownerReview
+    });
     described = describeDefaultFetchedIssue(currentDocument);
+    if (shouldReturnCompletedFallbackForOwnerReview({ ...args, document: currentDocument })) {
+      return { document: currentDocument, ...described };
+    }
     if (!described.issue || described.issue.reasonCode === "env_limited" && !described.issue.constraint) {
       return { document: currentDocument, ...described };
     }
@@ -18008,6 +19785,57 @@ var readResponseTextWithAbort = async (response, args) => {
   }
 };
 var fetchRuntimeDocumentWithFallback = async (args) => {
+  const fallbackPort = args.context?.browserFallbackPort ?? args.browserFallbackPort;
+  const runtimePolicy = args.context?.runtimePolicy;
+  const forcedBrowserTransport = runtimePolicy?.browser.forceTransport === true;
+  const forcedReasonCode = runtimePolicy?.cookies.policy === "required" ? "auth_required" : "env_limited";
+  if (forcedBrowserTransport) {
+    const fallback = await resolveProviderBrowserFallback({
+      browserFallbackPort: fallbackPort,
+      provider: args.provider,
+      source: args.source,
+      operation: args.operation,
+      reasonCode: forcedReasonCode,
+      url: args.url,
+      context: args.context,
+      details: {
+        message: "Direct browser transport was selected for this provider run."
+      },
+      recoveryHints: args.recoveryHints
+    });
+    if (!fallback) {
+      throw new ProviderRuntimeError(
+        providerErrorCodeFromReasonCode(forcedReasonCode),
+        "Direct browser transport is required for this provider run, but no browser transport is available.",
+        {
+          provider: args.provider,
+          source: args.source,
+          retryable: false,
+          reasonCode: forcedReasonCode,
+          details: {
+            reasonCode: forcedReasonCode,
+            browserTransportRequired: true
+          }
+        }
+      );
+    }
+    if (fallback.disposition !== "completed") {
+      throw toProviderFallbackError({
+        provider: args.provider,
+        source: args.source,
+        url: args.url,
+        fallback
+      });
+    }
+    return toCompletedFallbackDocument({
+      providerId: args.provider,
+      source: args.source,
+      operation: args.operation,
+      url: args.url,
+      fallback,
+      ownerReview: args.ownerReview
+    });
+  }
   try {
     return await fetchRuntimeDocument({
       url: args.url,
@@ -18020,7 +19848,9 @@ var fetchRuntimeDocumentWithFallback = async (args) => {
       provider: args.provider,
       source: args.source
     });
-    const fallbackPort = args.context?.browserFallbackPort ?? args.browserFallbackPort;
+    if (args.recoverRuntimeErrors === false) {
+      throw error;
+    }
     if (!fallbackPort) {
       throw error;
     }
@@ -18054,17 +19884,14 @@ var fetchRuntimeDocumentWithFallback = async (args) => {
         fallback
       });
     }
-    const resolvedUrl = canonicalizeUrl(readFallbackString(fallback.output, "url") ?? args.url);
-    const html = readFallbackString(fallback.output, "html") ?? "";
-    const extracted = extractStructuredContent(html, resolvedUrl);
-    return {
-      url: resolvedUrl,
-      status: 200,
-      html,
-      text: extracted.text,
-      links: extracted.links,
-      browserFallback: toBrowserFallbackObservation(fallback)
-    };
+    return toCompletedFallbackDocument({
+      providerId: args.provider,
+      source: args.source,
+      operation: args.operation,
+      url: args.url,
+      fallback,
+      ownerReview: args.ownerReview
+    });
   }
 };
 var ProviderRuntime = class {
@@ -19220,7 +21047,8 @@ var withDefaultCommunityOptions = (options, browserFallbackPort) => {
         operation: "search",
         signal: context.signal,
         context,
-        browserFallbackPort
+        browserFallbackPort,
+        ownerReview: shouldOwnerReviewCommunityRedditSearchFallback
       });
       const { document: resolvedDocument, pageMessage } = await resolveDefaultFallbackDocumentIfNeeded({
         providerId,
@@ -19228,7 +21056,8 @@ var withDefaultCommunityOptions = (options, browserFallbackPort) => {
         operation: "search",
         document,
         context,
-        browserFallbackPort
+        browserFallbackPort,
+        ownerReview: shouldOwnerReviewCommunityRedditSearchFallback
       });
       const links = resolveCommunitySearchLinks(resolvedDocument, limit);
       if (shouldRejectBlockedCommunityFallback(resolvedDocument, links)) {
@@ -19340,6 +21169,12 @@ var withDefaultSocialPlatformOptions = (platform, options, browserFallbackPort)
       }
     );
   };
+  const shouldOwnerReviewSocialFallback = (input) => input.source === "social" && input.operation === "search" && detectSocialSearchShell(platform, {
+    url: input.url,
+    title: typeof input.extracted.metadata.title === "string" ? input.extracted.metadata.title : void 0,
+    content: toSnippet(stripUrls(input.extracted.text), 1600),
+    links: input.extracted.links
+  })?.browserRequired === true;
   const resolveFallbackDocumentIfNeeded = async (operation, document, context) => {
     let currentDocument = document;
     let described = describeDocumentIssue(operation, currentDocument);
@@ -19374,23 +21209,24 @@ var withDefaultSocialPlatformOptions = (platform, options, browserFallbackPort)
         });
       }
       const requestedUrl = currentDocument.url;
-      const resolvedUrl = canonicalizeUrl(readFallbackString(fallback.output, "url") ?? currentDocument.url);
-      const html = readFallbackString(fallback.output, "html") ?? "";
-      const extracted = extractStructuredContent(html, resolvedUrl);
+      const fallbackDocument = toCompletedFallbackDocument({
+        providerId,
+        source: "social",
+        operation,
+        url: currentDocument.url,
+        fallback,
+        ownerReview: shouldOwnerReviewSocialFallback
+      });
       const effectiveUrl = resolveRecoveredSocialSearchDocumentUrl({
         platform,
         operation,
         requestedUrl,
-        recoveredUrl: resolvedUrl,
-        recoveredLinks: extracted.links
+        recoveredUrl: fallbackDocument.url,
+        recoveredLinks: fallbackDocument.links
       });
       currentDocument = {
-        url: effectiveUrl,
-        status: 200,
-        html,
-        text: extracted.text,
-        links: extracted.links,
-        browserFallback: toBrowserFallbackObservation(fallback)
+        ...fallbackDocument,
+        url: effectiveUrl
       };
       described = describeDocumentIssue(operation, currentDocument);
       if (!described.issue || described.issue.reasonCode === "env_limited" && !described.issue.constraint) {
@@ -19414,7 +21250,9 @@ var withDefaultSocialPlatformOptions = (platform, options, browserFallbackPort)
         signal: context.signal,
         context,
         browserFallbackPort,
-        recoveryHints: extensionFirstRecoveryHints
+        recoveryHints: extensionFirstRecoveryHints,
+        recoverRuntimeErrors: EXTENSION_FIRST_SOCIAL_FALLBACK_PLATFORMS.has(platform),
+        ownerReview: shouldOwnerReviewSocialFallback
       });
       const { document: resolvedDocument, extracted, pageMessage } = await resolveFallbackDocumentIfNeeded("search", document, context);
       const links = dedupeLinks2(
@@ -19447,7 +21285,9 @@ var withDefaultSocialPlatformOptions = (platform, options, browserFallbackPort)
         signal: context.signal,
         context,
         browserFallbackPort,
-        recoveryHints: extensionFirstRecoveryHints
+        recoveryHints: extensionFirstRecoveryHints,
+        recoverRuntimeErrors: EXTENSION_FIRST_SOCIAL_FALLBACK_PLATFORMS.has(platform),
+        ownerReview: shouldOwnerReviewSocialFallback
       });
       const { document: resolvedDocument, extracted } = await resolveFallbackDocumentIfNeeded("fetch", document, context);
       const links = dedupeLinks2(resolvedDocument.links, resolvedDocument.url, 20);
@@ -19610,10 +21450,10 @@ export {
   enrichResearchRecords,
   INSPIREDESIGN_HANDOFF_COMMANDS,
   INSPIREDESIGN_HANDOFF_GUIDANCE,
+  buildMacroResolveSuccessHandoff,
   renderResearch,
   renderShopping,
   renderInspiredesign,
-  buildMacroResolveSuccessHandoff,
   resolveInspiredesignCaptureMode,
   workflowTestUtils,
   runResearchWorkflow,
@@ -19625,4 +21465,4 @@ export {
   createProviderRuntime,
   createDefaultRuntime
 };
-//# sourceMappingURL=chunk-AVQL6WAS.js.map
+//# sourceMappingURL=chunk-T3VVHJTK.js.map