opendevbrowser 0.0.33 → 0.0.34

package/dist/{chunk-FBKPDILE.js → chunk-5FDXH4CS.js}

@@ -11245,10 +11245,15 @@ var pinterestGuidance = {
 var PINTEREST_PIN_ID_PATTERN = /^\d+$/;
 var RESERVED_PINTEREST_BOARD_PATHS = /* @__PURE__ */ new Set([
   "about",
+  "ads",
   "board",
   "business",
+  "careers",
+  "contact",
   "create",
+  "developers",
   "explore",
+  "help",
   "ideas",
   "login",
   "messages",
@@ -11257,11 +11262,13 @@ var RESERVED_PINTEREST_BOARD_PATHS = /* @__PURE__ */ new Set([
   "search",
   "settings",
   "shopping",
+  "terms",
   "today"
 ]);
 var RESERVED_PINTEREST_IDEA_PATHS = /* @__PURE__ */ new Set(["create", "edit", "search"]);
 var RESERVED_PINTEREST_PROFILE_TABS = /* @__PURE__ */ new Set([
   "activity",
+  "boards",
   "comments",
   "created",
   "followers",
@@ -11870,13 +11877,25 @@ var rejectionReasonForReference = (reference) => {
   }
   return "Reference evidence was diagnostic, empty, or too weak for creative synthesis.";
 };
-var buildRejectedReferences = (references) => references.filter((reference) => !hasInspiredesignUsableReferenceEvidence(reference)).map((reference) => ({
-  id: reference.id,
-  url: reference.url,
-  reason: rejectionReasonForReference(reference),
-  fetchStatus: reference.fetchStatus,
-  captureStatus: reference.captureStatus
-}));
+var hasCapturedEvidence = (reference) => reference.captureStatus === "captured" || reference.capture?.visual?.status === "captured";
+var capturedButRejectedReason = (diagnosticReasons) => diagnosticReasons.length > 0 ? `Captured browser evidence was rejected because it only exposed diagnostic signals: ${diagnosticReasons.join(", ")}.` : "Captured browser evidence was rejected because it did not contain usable creative reference evidence.";
+var buildRejectedReferences = (references) => references.filter((reference) => !hasInspiredesignUsableReferenceEvidence(reference)).map((reference) => {
+  const diagnosticReasons = referenceDiagnosticReasons(reference);
+  const captured = hasCapturedEvidence(reference);
+  return {
+    id: reference.id,
+    url: reference.url,
+    reason: rejectionReasonForReference(reference),
+    fetchStatus: reference.fetchStatus,
+    captureStatus: reference.captureStatus,
+    ...captured ? { captured: true } : {},
+    ...diagnosticReasons.length > 0 ? { diagnosticReasons } : {},
+    ...captured ? {
+      capturedButRejectedReason: capturedButRejectedReason(diagnosticReasons),
+      evidenceGap: "Design-facing artifacts require creative layout evidence; diagnostic browser chrome is kept only as rejection metadata."
+    } : {}
+  };
+});
 var buildQualitySummary = (references, rankedEntries, rejectedReferences) => {
   const diagnosticOnlyReasons = [...new Set(references.flatMap(referenceDiagnosticReasons))];
   const rankedIds = new Set(rankedEntries.map((entry) => entry.id));
@@ -11900,6 +11919,40 @@ var buildQualitySummary = (references, rankedEntries, rejectedReferences) => {
 var summarizeInspiredesignReferenceQuality = (board) => ({ ...board.qualitySummary });
 var isInspiredesignReadyReference = (reference) => reference.intentMatched && reference.score >= MIN_READY_REFERENCE_SCORE && reference.confidence >= MIN_READY_REFERENCE_CONFIDENCE;
 var isInspiredesignDesignReference = (reference) => !isPinterestOwnedReferenceUrl(reference.url) || isPinterestVisualReferenceUrl(reference.url) && isInspiredesignReadyReference(reference);
+var buildNotReadyRejectedReference = (reference) => {
+  const captured = reference.capturedVia.length > 0;
+  return {
+    id: reference.id,
+    url: reference.url,
+    reason: reference.intentMatched ? "Reference evidence did not meet the design-ready ranking threshold." : "Reference evidence did not match the requested design intent.",
+    fetchStatus: reference.capturedVia.includes("fetch") ? "captured" : "skipped",
+    captureStatus: reference.capturedVia.some((method) => method !== "fetch") ? "captured" : "off",
+    ...captured ? {
+      captured: true,
+      capturedButRejectedReason: "Captured reference evidence did not satisfy design-ready ranking gates.",
+      evidenceGap: "Design-facing artifacts require design-ready creative evidence; non-ready captures are kept only as rejection metadata."
+    } : {}
+  };
+};
+var mergeRejectedReferences = (rejectedReferences) => {
+  const seen = /* @__PURE__ */ new Set();
+  return rejectedReferences.filter((reference) => {
+    if (seen.has(reference.id)) return false;
+    seen.add(reference.id);
+    return true;
+  });
+};
+var buildInspiredesignRankedArtifactPatternBoard = (designBoard, sourceBoard) => {
+  const designReferenceIds = new Set(designBoard.references.map((reference) => reference.id));
+  const notReadyReferences = sourceBoard.references.filter((reference) => !designReferenceIds.has(reference.id)).map(buildNotReadyRejectedReference);
+  return {
+    ...designBoard,
+    rejectedReferences: mergeRejectedReferences([
+      ...sourceBoard.rejectedReferences,
+      ...notReadyReferences
+    ])
+  };
+};
 var buildInspiredesignDesignReferencePatternBoard = (board, designVectors) => {
   const references = board.references.filter(isInspiredesignDesignReference);
   const notReadyCount = board.references.length - references.length;
@@ -13906,6 +13959,7 @@ var buildInspiredesignPacket = (input) => {
     visualEvidence,
     screenshotIndex,
     rankedReferences: designReferencePatternBoard.references,
+    referencePatternBoard,
     metaPromptMarkdown,
     evidence: buildEvidencePayload({
       brief,
@@ -14498,6 +14552,7 @@ var DEFAULT_INSPIREDESIGN_BRIEF = "Digital photography studio landing page";
 var DEFAULT_INSPIREDESIGN_QUERY = "cinematic photography studio landing page inspiration";
 var DEFAULT_RESEARCH_TOPIC = "browser automation provider recovery";
 var DEFAULT_PROVIDER = "provider diagnostics";
+var DEFAULT_PINTEREST_REFERENCE_URL = "https://www.pinterest.com/pin/27654985208435505/";
 var isCanvasGenerationPlanIssue = (value) => {
   if (!value || typeof value !== "object" || Array.isArray(value)) return false;
   const record = value;
@@ -14522,12 +14577,28 @@ var inspiredesignCookieFlags = (context) => {
   if (selectedProviderIsPinterest(context)) return " --use-cookies --cookie-policy required";
   return context.useCookies === true ? " --use-cookies" : "";
 };
+var pinterestRecoveryUrls = (context) => {
+  if (!isPinterestScopedRecovery(context)) return [];
+  const urls = context.referenceUrls ?? [];
+  const canonicalUrls = urls.map(normalizePinterestReferenceUrl).filter((url) => url !== null);
+  return [...new Set(canonicalUrls)];
+};
+var inspiredesignRecoveryExampleUrls = (context) => selectedProviderIsPinterest(context) ? [DEFAULT_PINTEREST_REFERENCE_URL] : ["https://example.com/usable-reference"];
 var inspiredesignHarvestCommand = (context) => {
   const brief = typeof context.details?.brief === "string" ? context.details.brief : DEFAULT_INSPIREDESIGN_BRIEF;
   const query = context.query ?? DEFAULT_INSPIREDESIGN_QUERY;
   const provider = selectedInspiredesignProvider(context);
   const browserMode = inspiredesignBrowserMode(context);
   const cookieFlags = inspiredesignCookieFlags(context);
+  const urls = pinterestRecoveryUrls(context);
+  if (urls.length > 0) {
+    const urlFlags = urls.map((url) => `--url ${quote(url)}`).join(" ");
+    return {
+      id: "inspiredesign-harvest-url-recovery",
+      label: "Recover Inspired Design harvest with explicit Pinterest URLs",
+      command: `npx opendevbrowser inspiredesign harvest --brief ${quote(brief)} --provider social/pinterest ${urlFlags} --max-references 5 --visual-evidence required --browser-mode extension --use-cookies --cookie-policy required --challenge-automation-mode browser_with_helper --mode json --output-format json`
+    };
+  }
   return {
     id: "inspiredesign-harvest-rerun",
     label: "Rerun Inspired Design harvest with explicit evidence settings",
@@ -14848,7 +14919,7 @@ var buildEvidenceRecoveryGuidance = (context, readiness, reasonCode, actionLabel
     label: "Use explicit high-quality visual references when provider discovery is blocked",
     params: {
       brief: typeof context.details?.brief === "string" ? context.details.brief : DEFAULT_INSPIREDESIGN_BRIEF,
-      urls: ["https://example.com/usable-reference"],
+      urls: inspiredesignRecoveryExampleUrls(context),
       visualEvidence: "required",
       browserMode: inspiredesignBrowserMode(context),
       ...selectedProviderIsPinterest(context) ? { useCookies: true, cookiePolicy: "required" } : {}
@@ -15538,22 +15609,75 @@ var researchFailureMessage = (content) => boundedInlineText({
   target: "meta.json"
 });
 var CANVAS_CONTINUATION_BLOCKED_COMMAND = "Unavailable until nextStepGuidance.readiness is ready.";
+var CANVAS_PLAN_OMITTED_GUIDANCE = "Canvas plan request omitted until nextStepGuidance.readiness is ready.";
 var canContinueInspiredesignInCanvas = (guidance) => guidance?.readiness === "ready";
-var blockInspiredesignCanvasArtifactGuide = (handoff, recoverySummary) => ({
-  ...handoff.artifactGuide,
-  [INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest]: {
-    ...handoff.artifactGuide[INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest],
-    purpose: "Diagnostic Canvas request preview only until nextStepGuidance.readiness is ready.",
-    howToUse: [
-      recoverySummary,
-      "Do not submit this payload to Canvas until usable ranked references pass the readiness checks."
-    ],
-    mustNot: [
-      "Do not submit canvas.plan.set while nextStepGuidance.readiness is not ready.",
-      "Do not treat rejected or not-ready references as Canvas design direction."
-    ]
-  }
+var scrubCanvasPlanReference = (value) => value.includes(INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest) ? CANVAS_PLAN_OMITTED_GUIDANCE : value;
+var scrubGuideEntryCanvasReferences = (entry) => ({
+  ...entry,
+  expectedContents: entry.expectedContents.map(scrubCanvasPlanReference),
+  howToUse: entry.howToUse.map(scrubCanvasPlanReference),
+  mustNot: entry.mustNot.map(scrubCanvasPlanReference)
 });
+var scrubArtifactGuideCanvasReferences = (guide) => {
+  const scrubbed = {};
+  for (const [key, entry] of Object.entries(guide)) {
+    if (entry) {
+      scrubbed[key] = scrubGuideEntryCanvasReferences(entry);
+    }
+  }
+  return scrubbed;
+};
+var scrubContractSectionGuideCanvasReferences = (guide) => {
+  const scrubbed = {};
+  for (const [key, entry] of Object.entries(guide)) {
+    scrubbed[key] = scrubGuideEntryCanvasReferences(entry);
+  }
+  return scrubbed;
+};
+var blockInspiredesignCanvasArtifactGuide = (handoff) => {
+  const artifactGuide = { ...handoff.artifactGuide };
+  delete artifactGuide[INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest];
+  return artifactGuide;
+};
+var blockInspiredesignNotReadyArtifacts = (handoff) => {
+  const referenceSynthesis = plainObject(handoff.implementationContext.referenceSynthesis);
+  const blockedArtifacts = /* @__PURE__ */ new Set([
+    INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest,
+    INSPIREDESIGN_HANDOFF_FILES.prototypeGuidance
+  ]);
+  const requiredArtifacts = isStringArray(referenceSynthesis.requiredArtifacts) ? referenceSynthesis.requiredArtifacts.filter((artifact) => !blockedArtifacts.has(artifact)) : [];
+  const artifactGuide = { ...handoff.artifactGuide };
+  delete artifactGuide[INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest];
+  delete artifactGuide[INSPIREDESIGN_HANDOFF_FILES.prototypeGuidance];
+  return {
+    ...handoff,
+    artifactGuide: scrubArtifactGuideCanvasReferences(artifactGuide),
+    contractSectionGuide: scrubContractSectionGuideCanvasReferences(handoff.contractSectionGuide),
+    implementationContext: {
+      ...handoff.implementationContext,
+      referenceSynthesis: {
+        ...referenceSynthesis,
+        requiredArtifacts
+      }
+    }
+  };
+};
+var blockPrototypeGuidanceInDesignMarkdown = (markdown, prototypeGuidanceMarkdown) => {
+  const withoutCanvasDeliverable = markdown.replace(
+    /\n- Diagnostic `canvasPlanRequest` preview; do not submit to Canvas until next-step guidance is ready/g,
+    `
+- ${CANVAS_PLAN_OMITTED_GUIDANCE}`
+  );
+  const withoutPrototypeDeliverable = withoutCanvasDeliverable.replace(
+    /\n- Prototype guidance Markdown for the first HTML pass/g,
+    ""
+  );
+  if (!prototypeGuidanceMarkdown) return withoutPrototypeDeliverable;
+  return withoutPrototypeDeliverable.replace(
+    prototypeGuidanceMarkdown,
+    "# 6. Optional Prototype Plan\n\n- Prototype guidance omitted because next-step guidance is not ready."
+  );
+};
 var buildMissingInspiredesignGuidanceHandoff = () => {
   const summary = "Canvas continuation unavailable until nextStepGuidance.readiness is ready.";
   return {
@@ -16010,6 +16134,7 @@ var renderInspiredesign = (args) => {
   const followthroughSummary = prependPrimaryConstraint(args.designAgentHandoff.summary, args.meta);
   const canContinueInCanvas = canContinueInspiredesignInCanvas(args.nextStepGuidance);
   const prototypeGuidanceMarkdown = canContinueInCanvas ? args.prototypeGuidanceMarkdown : null;
+  const designMarkdown = canContinueInCanvas ? args.designMarkdown : blockPrototypeGuidanceInDesignMarkdown(args.designMarkdown, args.prototypeGuidanceMarkdown);
   const commandExamples2 = {
     ...args.designAgentHandoff.commandExamples,
     continueInCanvas: canContinueInCanvas ? args.designAgentHandoff.commandExamples.continueInCanvas : CANVAS_CONTINUATION_BLOCKED_COMMAND
@@ -16022,8 +16147,8 @@ var renderInspiredesign = (args) => {
     ...args.nextStepGuidance ? { nextStepGuidance: args.nextStepGuidance } : {}
   });
   const handoff = args.nextStepGuidance ? renderedWorkflowHandoff : buildMissingInspiredesignGuidanceHandoff();
-  const blockedCanvasArtifactGuide = canContinueInCanvas ? args.designAgentHandoff.artifactGuide : blockInspiredesignCanvasArtifactGuide(args.designAgentHandoff, handoff.suggestedNextAction);
-  const renderedDesignAgentHandoff = {
+  const blockedCanvasArtifactGuide = canContinueInCanvas ? args.designAgentHandoff.artifactGuide : blockInspiredesignCanvasArtifactGuide(args.designAgentHandoff);
+  const renderedDesignAgentHandoffBase = {
     ...args.designAgentHandoff,
     ...handoff,
     summary: handoff.followthroughSummary,
@@ -16031,17 +16156,18 @@ var renderInspiredesign = (args) => {
     artifactGuide: blockedCanvasArtifactGuide,
     commandExamples: commandExamples2
   };
+  const renderedDesignAgentHandoff = canContinueInCanvas ? renderedDesignAgentHandoffBase : blockInspiredesignNotReadyArtifacts(renderedDesignAgentHandoffBase);
   const contextPayload = {
     brief: args.brief,
     advancedBriefMarkdown: args.advancedBriefMarkdown,
     urls: args.urls,
     designContract: args.designContract,
-    canvasPlanRequest: args.canvasPlanRequest,
+    ...canContinueInCanvas ? { canvasPlanRequest: args.canvasPlanRequest } : {},
     designAgentHandoff: renderedDesignAgentHandoff,
     ...args.nextStepGuidance ? { nextStepGuidance: args.nextStepGuidance } : {},
     generationPlan: args.generationPlan,
     implementationPlan: args.implementationPlan,
-    designMarkdown: args.designMarkdown,
+    designMarkdown,
     implementationPlanMarkdown: args.implementationPlanMarkdown,
     prototypeGuidanceMarkdown,
     evidence: args.evidence,
@@ -16052,10 +16178,9 @@ var renderInspiredesign = (args) => {
     meta: args.meta
   };
   const files = [
-    { path: INSPIREDESIGN_HANDOFF_FILES.designMarkdown, content: args.designMarkdown },
+    { path: INSPIREDESIGN_HANDOFF_FILES.designMarkdown, content: designMarkdown },
     { path: INSPIREDESIGN_HANDOFF_FILES.advancedBrief, content: args.advancedBriefMarkdown },
     { path: INSPIREDESIGN_HANDOFF_FILES.designContract, content: args.designContract },
-    { path: INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest, content: args.canvasPlanRequest },
     {
       path: INSPIREDESIGN_HANDOFF_FILES.designAgentHandoff,
       content: renderedDesignAgentHandoff
@@ -16072,6 +16197,9 @@ var renderInspiredesign = (args) => {
   if (prototypeGuidanceMarkdown) {
     files.push({ path: INSPIREDESIGN_HANDOFF_FILES.prototypeGuidance, content: prototypeGuidanceMarkdown });
   }
+  if (canContinueInCanvas) {
+    files.push({ path: INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest, content: args.canvasPlanRequest });
+  }
   const captureAttemptFields = {
     ...captureAttemptSummary ? { captureAttemptSummary } : {},
     ...captureAttemptReport ? { captureAttemptReport } : {}
@@ -16095,7 +16223,7 @@ var renderInspiredesign = (args) => {
         brief: args.brief,
         advancedBriefMarkdown: args.advancedBriefMarkdown,
         urls: args.urls,
-        canvasPlanRequest: args.canvasPlanRequest,
+        ...canContinueInCanvas ? { canvasPlanRequest: args.canvasPlanRequest } : {},
         designAgentHandoff: renderedDesignAgentHandoff,
         ...args.nextStepGuidance ? { nextStepGuidance: args.nextStepGuidance } : {},
         designContract: args.designContract,
@@ -16118,7 +16246,7 @@ var renderInspiredesign = (args) => {
     return {
       response: {
         mode: args.mode,
-        markdown: args.designMarkdown,
+        markdown: designMarkdown,
         implementationPlanMarkdown: args.implementationPlanMarkdown,
         prototypeGuidanceMarkdown,
         ...handoff,
@@ -16242,6 +16370,10 @@ var reasonCodeForInspiredesign = (source) => {
   if (hasWeakTopReference2(source)) return "weak_reference";
   return "design_ready";
 };
+var dedupeInspiredesignReferenceUrls = (source) => {
+  const urls = [...source.urls ?? [], ...source.discovery.acceptedUrls].map((url) => url.trim()).filter((url) => url.length > 0);
+  return [...new Set(urls)];
+};
 var resolveInspiredesignSiteRecipe = (source) => {
   const providerRecipe = source.requestedProviders.map((providerId) => resolveSiteRecipeForProvider(providerId)).find((recipe) => recipe !== void 0);
   if (providerRecipe) return providerRecipe.id;
@@ -16250,12 +16382,14 @@ var resolveInspiredesignSiteRecipe = (source) => {
 };
 var createInspiredesignGuidanceContext = (source) => {
   const siteRecipeId = resolveInspiredesignSiteRecipe(source);
+  const referenceUrls = dedupeInspiredesignReferenceUrls(source);
   return {
     workflow: "inspiredesign",
     reasonCode: reasonCodeForInspiredesign(source),
     requestedProviders: source.requestedProviders,
     ...siteRecipeId ? { siteRecipeId } : {},
     ...source.query ? { query: source.query } : {},
+    ...referenceUrls.length > 0 ? { referenceUrls } : {},
     ...source.browserMode ? { browserMode: source.browserMode } : {},
     ...source.cookiePolicy ? { cookiePolicy: source.cookiePolicy } : {},
     ...typeof source.useCookies === "boolean" ? { useCookies: source.useCookies } : {},
@@ -16282,6 +16416,110 @@ var createInspiredesignGuidanceContext = (source) => {
   };
 };
 
+// src/guidance/recipes/site-recipe-validation.ts
+var normalizeNonBlank = (values) => values.map((value) => value.trim()).filter((value) => value.length > 0);
+var incompatible = (message) => ({ ok: false, message });
+var supportsBrowserNativeRecovery = (recipe) => typeof recipe?.browserNativeDiscovery?.buildSearchUrl === "function";
+var isCanonicalRecipeReferenceUrl = (recipe, url) => {
+  if (recipe.id === "social/pinterest") {
+    return normalizePinterestReferenceUrl(url) !== null;
+  }
+  return true;
+};
+var isPinterestLikeHostname = (value) => {
+  const hostname = value.toLowerCase();
+  return [
+    hostname === "pinterest.com",
+    hostname.endsWith(".pinterest.com"),
+    hostname.startsWith("pinterest."),
+    hostname.includes(".pinterest.")
+  ].some(Boolean);
+};
+var isPinterestLikeUrl = (value) => {
+  try {
+    return isPinterestLikeHostname(new URL(value).hostname);
+  } catch {
+    return false;
+  }
+};
+var isNonCanonicalPinterestLikeUrl = (url) => (resolveSiteRecipeForUrl(url)?.id === "social/pinterest" || isPinterestLikeUrl(url)) && normalizePinterestReferenceUrl(url) === null;
+var requiresProviderUrlSiteRecipeCompatibility = ({
+  providers,
+  urls,
+  query
+}) => {
+  const providerIds = normalizeNonBlank(providers);
+  if (providerIds.length === 0) return false;
+  if (!query?.trim()) return true;
+  return false;
+};
+var validateProviderScopedUrlCanonicality = ({
+  providers,
+  urls
+}) => {
+  const providerHasPinterest = normalizeNonBlank(providers).some((providerId) => resolveSiteRecipeForProvider(providerId)?.id === "social/pinterest");
+  if (!providerHasPinterest) return { ok: true };
+  const nonCanonicalPinterestUrl = normalizeNonBlank(urls).find((url) => normalizePinterestReferenceUrl(url) === null);
+  if (!nonCanonicalPinterestUrl) return { ok: true };
+  return incompatible(
+    `URL ${nonCanonicalPinterestUrl} is not a canonical social/pinterest reference URL for provider-scoped recovery.`
+  );
+};
+var validateProviderUrlSiteRecipeCompatibility = ({
+  providers,
+  urls
+}) => {
+  const providerIds = normalizeNonBlank(providers);
+  const referenceUrls = normalizeNonBlank(urls);
+  if (providerIds.length === 0) {
+    return incompatible("Provider-scoped URL recovery requires at least one provider.");
+  }
+  if (referenceUrls.length === 0) {
+    return incompatible("Provider-scoped URL recovery requires at least one URL.");
+  }
+  const providerRecipes = providerIds.map((providerId) => ({
+    providerId,
+    recipe: resolveSiteRecipeForProvider(providerId)
+  }));
+  const missingProviderRecipe = providerRecipes.find((entry) => entry.recipe === void 0);
+  if (missingProviderRecipe) {
+    return incompatible(`Provider ${missingProviderRecipe.providerId} does not support URL-only site recipe recovery.`);
+  }
+  const nonNativeProviderRecipe = providerRecipes.find((entry) => !supportsBrowserNativeRecovery(entry.recipe));
+  if (nonNativeProviderRecipe) {
+    return incompatible(`Provider ${nonNativeProviderRecipe.providerId} does not support browser-native URL-only site recipe recovery.`);
+  }
+  const urlRecipes = referenceUrls.map((url) => ({
+    url,
+    recipe: resolveSiteRecipeForUrl(url)
+  }));
+  const missingUrlRecipe = urlRecipes.find((entry) => entry.recipe === void 0);
+  if (missingUrlRecipe) {
+    return incompatible(`URL ${missingUrlRecipe.url} does not match a browser-native site recipe for provider-scoped recovery.`);
+  }
+  const nonNativeUrlRecipe = urlRecipes.find((entry) => !supportsBrowserNativeRecovery(entry.recipe));
+  if (nonNativeUrlRecipe) {
+    return incompatible(`URL ${nonNativeUrlRecipe.url} does not match a browser-native site recipe for provider-scoped recovery.`);
+  }
+  const recipeIds = /* @__PURE__ */ new Set([
+    ...providerRecipes.map((entry) => entry.recipe?.id),
+    ...urlRecipes.map((entry) => entry.recipe?.id)
+  ]);
+  if (recipeIds.size !== 1) {
+    return incompatible("Provider-scoped URL recovery requires every provider and URL to resolve to the same site recipe.");
+  }
+  const recipeId = providerRecipes[0]?.recipe?.id;
+  if (!recipeId) {
+    return incompatible("Provider-scoped URL recovery could not resolve a site recipe.");
+  }
+  const recipe = providerRecipes[0]?.recipe;
+  const nonReferenceUrl = recipe ? urlRecipes.find((entry) => !isCanonicalRecipeReferenceUrl(recipe, entry.url)) : void 0;
+  if (nonReferenceUrl) {
+    return incompatible(`URL ${nonReferenceUrl.url} is not a canonical ${recipeId} reference URL for provider-scoped recovery.`);
+  }
+  return { ok: true, recipeId };
+};
+
 // src/inspiredesign/reference-discovery.ts
 var normalizeHttpUrl = (value) => {
   try {
@@ -19465,8 +19703,18 @@ var normalizeInspiredesignInput = (input) => {
   if (query && input.harvest !== true) {
     throw new Error("Inspiredesign workflow query is only supported when harvest is true.");
   }
-  if (providers.length > 0 && !query) {
-    throw new Error("Inspiredesign workflow providers require query.");
+  const canonicality = validateProviderScopedUrlCanonicality({ providers, urls });
+  if (!canonicality.ok) {
+    throw new Error(`Inspiredesign workflow ${canonicality.message}`);
+  }
+  if (requiresProviderUrlSiteRecipeCompatibility({ providers, urls, query })) {
+    if (input.harvest !== true) {
+      throw new Error("Inspiredesign workflow providers require query unless harvest uses compatible URL recovery.");
+    }
+    const compatibility = validateProviderUrlSiteRecipeCompatibility({ providers, urls });
+    if (!compatibility.ok) {
+      throw new Error(`Inspiredesign workflow ${compatibility.message}`);
+    }
   }
   if (input.harvest === true && !query && urls.length === 0) {
     throw new Error("Inspiredesign harvest requires query or URL references.");
@@ -19656,6 +19904,27 @@ var capMixedInspiredesignDiscovery = (siteDiscovery, standardDiscovery, maxRefer
     rejected: [...siteDiscovery.rejected, ...standardDiscovery.rejected]
   };
 };
+var filterStandardDiscoveryForSiteRecipe = (siteRecipe, discovery) => {
+  if (siteRecipe.id !== "social/pinterest") return discovery;
+  const accepted = [];
+  const rejected = [...discovery.rejected];
+  discovery.accepted.forEach((candidate) => {
+    if (!isNonCanonicalPinterestLikeUrl(candidate.url)) {
+      accepted.push(candidate);
+      return;
+    }
+    rejected.push({
+      status: "rejected",
+      reason: "invalid_url",
+      rawUrl: candidate.url,
+      ...candidate.title ? { title: candidate.title } : {},
+      source: candidate.source,
+      provider: candidate.provider,
+      rank: candidate.rank
+    });
+  });
+  return { accepted, rejected };
+};
 var discoverInspiredesignReferences = async (runtime, workflowInput, envelope, timeoutMs) => {
   if (!workflowInput.query) {
     return emptyInspiredesignDiscoveryDiagnostics(workflowInput, typeof runtime.search === "function");
@@ -19700,7 +19969,10 @@ var discoverInspiredesignReferences = async (runtime, workflowInput, envelope, t
           }
         );
         const searchFailures = searchResult2.failures.length > 0 ? searchResult2.failures : failureFromInspiredesignDiscoveryError({ ...workflowInput, providers: standardProviderIds }, searchResult2.error);
-        const discovery3 = normalizeInspiredesignDiscoveryRecords(searchResult2.records);
+        const discovery3 = filterStandardDiscoveryForSiteRecipe(
+          siteRecipe,
+          normalizeInspiredesignDiscoveryRecords(searchResult2.records)
+        );
         const siteResult2 = await runSiteRecipeDiscovery();
         const siteDiscovery = normalizeInspiredesignDiscoveryRecords(siteResult2.records);
         const combinedDiscovery = capMixedInspiredesignDiscovery(
@@ -21539,7 +21811,10 @@ var runInspiredesignWorkflow = async (runtime, input, options = {}) => {
       visualEvidence: packet.visualEvidence,
       screenshotIndex: packet.screenshotIndex,
       rankedReferences: packet.rankedReferences,
-      referencePatternBoard: packet.generationPlan.referencePatternBoard,
+      referencePatternBoard: buildInspiredesignRankedArtifactPatternBoard(
+        packet.generationPlan.referencePatternBoard,
+        packet.referencePatternBoard
+      ),
       metaPromptMarkdown: packet.metaPromptMarkdown,
       nextStepGuidance,
       meta: metaWithGuidance
@@ -24346,6 +24621,8 @@ var mergeBudgets = (base, partial) => {
 };
 
 export {
+  WORKFLOW_ARTIFACT_DIRECTORY,
+  resolveWorkflowArtifactRoot,
   CHALLENGE_AUTOMATION_MODES,
   isChallengeAutomationMode,
   resolveChallengeAutomationPolicy,
@@ -24399,8 +24676,6 @@ export {
   createShoppingProviders,
   createShoppingProviderById,
   createWebProvider,
-  WORKFLOW_ARTIFACT_DIRECTORY,
-  resolveWorkflowArtifactRoot,
   resolveTimebox,
   isWithinTimebox,
   filterByTimebox,
@@ -24410,6 +24685,9 @@ export {
   renderResearch,
   renderShopping,
   renderInspiredesign,
+  requiresProviderUrlSiteRecipeCompatibility,
+  validateProviderScopedUrlCanonicality,
+  validateProviderUrlSiteRecipeCompatibility,
   resolveInspiredesignCaptureMode,
   workflowTestUtils,
   runResearchWorkflow,
@@ -24421,4 +24699,4 @@ export {
   createProviderRuntime,
   createDefaultRuntime
 };
-//# sourceMappingURL=chunk-FBKPDILE.js.map
+//# sourceMappingURL=chunk-5FDXH4CS.js.map