opendevbrowser 0.0.32 → 0.0.33

package/dist/{status-KHYCLGUD.js → status-CKGPNYIH.js}

@@ -5,14 +5,14 @@ import {
 } from "./chunk-L3YNUGYF.js";
 import {
   callDaemon
-} from "./chunk-XDLJE3RJ.js";
+} from "./chunk-MJF67OTH.js";
 import {
   DAEMON_FINGERPRINT_MISMATCH_REASON,
   DEFAULT_DAEMON_STATUS_FETCH_OPTIONS,
   buildDaemonFingerprintMismatchStatusGuidance,
   fetchDaemonStatusFromMetadata
-} from "./chunk-ZOVMMQO6.js";
-import "./chunk-HBK56JST.js";
+} from "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
@@ -24,10 +24,10 @@ import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-RO3SMXF3.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-2X4JFMKJ.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/session/status.ts
@@ -137,4 +137,4 @@ async function runStatus(args) {
 export {
   runStatus
 };
-//# sourceMappingURL=status-KHYCLGUD.js.map
+//# sourceMappingURL=status-CKGPNYIH.js.map

package/dist/{status-R4EV4TWO.js → status-LEBY2X7N.js}

@@ -2,13 +2,13 @@ import {
   callDesktopCommand,
   desktopCommandResult,
   parseDesktopTimeoutArgs
-} from "./chunk-BUXFIY2P.js";
+} from "./chunk-JROW6ZNN.js";
 import "./chunk-RJNI3BHT.js";
 import "./chunk-SKFB5ICF.js";
 import "./chunk-OW5HMYMI.js";
-import "./chunk-XDLJE3RJ.js";
-import "./chunk-ZOVMMQO6.js";
-import "./chunk-HBK56JST.js";
+import "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import "./chunk-7BNU6DFI.js";
@@ -17,10 +17,10 @@ import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-RO3SMXF3.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-2X4JFMKJ.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/desktop/status.ts
@@ -32,4 +32,4 @@ async function runDesktopStatus(args) {
 export {
   runDesktopStatus
 };
-//# sourceMappingURL=status-R4EV4TWO.js.map
+//# sourceMappingURL=status-LEBY2X7N.js.map

package/dist/{status-capabilities-XD3RGLKF.js → status-capabilities-6QTWNGKM.js}

@@ -1,6 +1,6 @@
 import {
   parseOptionalChallengeAutomationMode
-} from "./chunk-PIFHXKV4.js";
+} from "./chunk-52ZIOWVU.js";
 import "./chunk-RJNI3BHT.js";
 import {
   parseNumberFlag,
@@ -11,9 +11,9 @@ import {
 } from "./chunk-OW5HMYMI.js";
 import {
   callDaemon
-} from "./chunk-XDLJE3RJ.js";
-import "./chunk-ZOVMMQO6.js";
-import "./chunk-HBK56JST.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import "./chunk-7BNU6DFI.js";
@@ -22,10 +22,10 @@ import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-RO3SMXF3.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-2X4JFMKJ.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/status-capabilities.ts
@@ -54,4 +54,4 @@ async function runStatusCapabilities(args) {
 export {
   runStatusCapabilities
 };
-//# sourceMappingURL=status-capabilities-XD3RGLKF.js.map
+//# sourceMappingURL=status-capabilities-6QTWNGKM.js.map

package/dist/{text-TANLFZ4O.js → text-VUZU7D3L.js}

@@ -5,9 +5,9 @@ import {
 } from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-XDLJE3RJ.js";
-import "./chunk-ZOVMMQO6.js";
-import "./chunk-HBK56JST.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
@@ -18,10 +18,10 @@ import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-RO3SMXF3.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-2X4JFMKJ.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/dom/text.ts
@@ -81,4 +81,4 @@ async function runDomText(args) {
 export {
   runDomText
 };
-//# sourceMappingURL=text-TANLFZ4O.js.map
+//# sourceMappingURL=text-VUZU7D3L.js.map

package/dist/{type-Y2Y7LX7Y.js → type-N5SURP74.js}

@@ -4,9 +4,9 @@ import {
 } from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-XDLJE3RJ.js";
-import "./chunk-ZOVMMQO6.js";
-import "./chunk-HBK56JST.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
@@ -17,10 +17,10 @@ import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-RO3SMXF3.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-2X4JFMKJ.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/interact/type.ts
@@ -91,4 +91,4 @@ async function runType(args) {
 export {
   runType
 };
-//# sourceMappingURL=type-Y2Y7LX7Y.js.map
+//# sourceMappingURL=type-N5SURP74.js.map

package/dist/{uncheck-6REVUUB2.js → uncheck-JFMK3SSY.js}

@@ -4,9 +4,9 @@ import {
 } from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-XDLJE3RJ.js";
-import "./chunk-ZOVMMQO6.js";
-import "./chunk-HBK56JST.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
@@ -17,10 +17,10 @@ import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-RO3SMXF3.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-2X4JFMKJ.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/interact/uncheck.ts
@@ -68,4 +68,4 @@ async function runUncheck(args) {
 export {
   runUncheck
 };
-//# sourceMappingURL=uncheck-6REVUUB2.js.map
+//# sourceMappingURL=uncheck-JFMK3SSY.js.map

package/dist/{upload-GGZC5UQP.js → upload-KFUYLL7M.js}

@@ -5,9 +5,9 @@ import {
 } from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-XDLJE3RJ.js";
-import "./chunk-ZOVMMQO6.js";
-import "./chunk-HBK56JST.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
@@ -18,10 +18,10 @@ import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-RO3SMXF3.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-2X4JFMKJ.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/interact/upload.ts
@@ -53,4 +53,4 @@ export {
   __test__,
   runUpload
 };
-//# sourceMappingURL=upload-GGZC5UQP.js.map
+//# sourceMappingURL=upload-KFUYLL7M.js.map

package/dist/{use-B4Q7CFG2.js → use-CNMPP2ED.js}

@@ -1,9 +1,9 @@
 import "./chunk-RJNI3BHT.js";
 import {
   callDaemon
-} from "./chunk-XDLJE3RJ.js";
-import "./chunk-ZOVMMQO6.js";
-import "./chunk-HBK56JST.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
@@ -14,10 +14,10 @@ import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-RO3SMXF3.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-2X4JFMKJ.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/targets/use.ts
@@ -60,4 +60,4 @@ async function runTargetUse(args) {
 export {
   runTargetUse
 };
-//# sourceMappingURL=use-B4Q7CFG2.js.map
+//# sourceMappingURL=use-CNMPP2ED.js.map

package/dist/{value-DHOHO55D.js → value-J335MPZE.js}

@@ -4,9 +4,9 @@ import {
 } from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-XDLJE3RJ.js";
-import "./chunk-ZOVMMQO6.js";
-import "./chunk-HBK56JST.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
@@ -17,10 +17,10 @@ import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-RO3SMXF3.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-2X4JFMKJ.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/dom/value.ts
@@ -68,4 +68,4 @@ async function runDomValue(args) {
 export {
   runDomValue
 };
-//# sourceMappingURL=value-DHOHO55D.js.map
+//# sourceMappingURL=value-J335MPZE.js.map

package/dist/{visible-S5BTWYNH.js → visible-YQZWWPBZ.js}

@@ -4,9 +4,9 @@ import {
 } from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-XDLJE3RJ.js";
-import "./chunk-ZOVMMQO6.js";
-import "./chunk-HBK56JST.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
@@ -17,10 +17,10 @@ import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-RO3SMXF3.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-2X4JFMKJ.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/dom/visible.ts
@@ -68,4 +68,4 @@ async function runDomVisible(args) {
 export {
   runDomVisible
 };
-//# sourceMappingURL=visible-S5BTWYNH.js.map
+//# sourceMappingURL=visible-YQZWWPBZ.js.map

package/dist/{wait-WV6NZUKL.js → wait-IC7YJJPJ.js}

@@ -5,9 +5,9 @@ import {
 } from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-XDLJE3RJ.js";
-import "./chunk-ZOVMMQO6.js";
-import "./chunk-HBK56JST.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
@@ -18,10 +18,10 @@ import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-RO3SMXF3.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-2X4JFMKJ.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/nav/wait.ts
@@ -106,4 +106,4 @@ async function runWait(args) {
 export {
   runWait
 };
-//# sourceMappingURL=wait-WV6NZUKL.js.map
+//# sourceMappingURL=wait-IC7YJJPJ.js.map

package/dist/{windows-GKE36DJQ.js → windows-AGVQ3KX3.js}

@@ -2,13 +2,13 @@ import {
   callDesktopCommand,
   desktopCommandResult,
   parseDesktopReasonArgs
-} from "./chunk-BUXFIY2P.js";
+} from "./chunk-JROW6ZNN.js";
 import "./chunk-RJNI3BHT.js";
 import "./chunk-SKFB5ICF.js";
 import "./chunk-OW5HMYMI.js";
-import "./chunk-XDLJE3RJ.js";
-import "./chunk-ZOVMMQO6.js";
-import "./chunk-HBK56JST.js";
+import "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import "./chunk-7BNU6DFI.js";
@@ -17,10 +17,10 @@ import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-RO3SMXF3.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-2X4JFMKJ.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/desktop/windows.ts
@@ -34,4 +34,4 @@ async function runDesktopWindows(args) {
 export {
   runDesktopWindows
 };
-//# sourceMappingURL=windows-GKE36DJQ.js.map
+//# sourceMappingURL=windows-AGVQ3KX3.js.map

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "OpenDevBrowser Relay",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "description": "Optional bridge to reuse existing Chrome tabs with OpenDevBrowser.",
   "permissions": [
     "debugger",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opendevbrowser",
-  "version": "0.0.32",
+  "version": "0.0.33",
   "description": "Browser automation runtime with snapshot-refs-actions, browser replay screencasts, public read-only desktop observation, and browser-scoped computer-use orchestration",
   "type": "module",
   "main": "dist/index.js",

package/skills/opendevbrowser-best-practices/SKILL.md

@@ -146,6 +146,7 @@ Rules:
 ```bash
 npx opendevbrowser inspiredesign run --brief "Design a premium docs workspace" --url "https://example.com/reference-a" --url "https://example.com/reference-b" --browser-mode managed --use-cookies --challenge-automation-mode browser_with_helper --include-prototype-guidance --mode json --output-format json
 npx opendevbrowser inspiredesign harvest --brief "Design a premium docs workspace" --query "best docs product landing pages" --provider web/default --max-references 5 --visual-evidence required --browser-mode managed --mode path --output-format json
+npx opendevbrowser inspiredesign harvest --brief "Premium digital photography studio landing page" --query "Pinterest premium digital photography studio landing page cinematic parallax portfolio" --provider social/pinterest --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
 ```
 
 Rules:
@@ -153,8 +154,11 @@ Rules:
 - use repeated `--url` flags instead of packed URL strings
 - provide `--query` or at least one `--url` for `inspiredesign harvest`; use `--query` when provider discovery is part of the task
 - use `inspiredesign harvest` when visual reference discovery, screenshot PNG artifacts, ranked references, metadata-only visual JSON, `meta-prompt.md`, or motion-design follow-through is required
+- treat `social/pinterest` as a browser-native site recipe, not a default full social provider; use extension mode, cookies, and `--cookie-policy required` for logged-in Pinterest search
+- inspect `nextStepGuidance.readiness`, `reasonCode`, `primaryAction`, `paramsExamples`, `validationChecks`, and `doNotProceedIf` before continuing from any harvest
 - visual harvest must not bypass `policy_blocked`, unresolved `auth_required`, `challenge_detected`, or `rate_limited`; inspect diagnostics instead of forcing screenshots through blocked references
-- after a successful run or harvest, read `advanced-brief.md` first, inspect `ranked-references.json`, `visual-evidence.json`, `screenshot-index.json`, and `meta-prompt.md` when present, load `opendevbrowser_skill_load opendevbrowser-best-practices "quick start"`, `opendevbrowser_skill_load opendevbrowser-design-agent "canvas-contract"`, and `opendevbrowser_skill_load opendevbrowser-motion-design "quick start"`, fill the ids in `canvas-plan.request.json`, run `opendevbrowser canvas --command canvas.plan.set --params-file ./canvas-plan.request.json`, confirm `planStatus=accepted`, then patch only the governance blocks listed in `design-agent-handoff.json`
+- if readiness is `needs_recovery`, `blocked`, or `diagnostic_only`, follow the recovery-first command examples and do not continue to Canvas
+- after a ready run or harvest, read `advanced-brief.md` first, inspect `ranked-references.json`, `visual-evidence.json`, `screenshot-index.json`, and `meta-prompt.md` when present, load `opendevbrowser_skill_load opendevbrowser-best-practices "quick start"`, `opendevbrowser_skill_load opendevbrowser-design-agent "canvas-contract"`, and `opendevbrowser_skill_load opendevbrowser-motion-design "quick start"`, open a Canvas session, fill the ids in `canvas-plan.request.json`, run `opendevbrowser canvas --command canvas.plan.set --params-file ./canvas-plan.request.json`, confirm `planStatus=accepted`, then patch only the governance blocks listed in `design-agent-handoff.json`
 - pair this lane with `opendevbrowser-design-agent` when the brief moves from contract synthesis into implementation or `/canvas`
 
 ## Agent Sync Targets
@@ -352,6 +356,7 @@ Recommended command order:
    - `mutationPolicy.allowedBeforePlan`
    - `guidance.recommendedNextCommands`
    - `guidance.reason`
+   - `guidance.nextStepGuidance`, `guidance.paramsExamples`, `guidance.fieldExamples`, `guidance.validationChecks`, and `guidance.doNotProceedIf` when a repair envelope is present
    - treat `allowedLibraries.components`, `allowedLibraries.icons`, and `allowedLibraries.styling` as separate policy lanes:
      `components` are reusable UI adapters such as `shadcn`,
      `icons` are approved icon families,
@@ -379,7 +384,8 @@ Recommended command order:
    - `validationTargets.maxInteractionLatencyMs`
 5. Immediately inspect the `canvas.plan.set` response.
    - If `planStatus="accepted"` or `preflightState="plan_accepted"`, follow the returned `guidance.recommendedNextCommands`.
-   - If the command fails with `generation_plan_invalid`, inspect `details.missingFields`, `details.issues`, and the handshake `generationPlanIssues`, then optionally re-read with `canvas.plan.get` or `canvas.capabilities.get` before resubmitting.
+   - If the command fails with `generation_plan_invalid`, inspect `details.missingFields`, `details.issues`, `guidance.paramsExamples`, `guidance.fieldExamples`, `guidance.validationChecks`, `guidance.doNotProceedIf`, and the handshake `generationPlanIssues`, then repair the params file before resubmitting.
+   - Use `canvas.plan.get` or `canvas.capabilities.get` only as diagnostics when the repair examples are not enough.
 6. Only after the plan is accepted, call `canvas.document.patch`.
 7. After every successful `canvas.document.patch`, `canvas.preview.render`, `canvas.preview.refresh`, `canvas.feedback.poll`, `canvas.document.save`, or `canvas.document.export`, read `guidance.recommendedNextCommands` and `guidance.reason` before deciding the next command.
 8. Use `canvas.preview.render`, `canvas.tab.open`, `canvas.overlay.mount`, and `canvas.overlay.select` when a browser-backed live view is required.

package/skills/opendevbrowser-best-practices/artifacts/canvas-governance-playbook.md

@@ -7,11 +7,11 @@ Use this playbook before any `/canvas` mutation and during every design-feedback
 ## Required command order
 
 1. `canvas.session.open`
-2. Read the handshake and inspect `planStatus`, `preflightState`, `generationPlanRequirements.allowedValues`, `generationPlanIssues`, `guidance.recommendedNextCommands`, and `guidance.reason`
+2. Read the handshake and inspect `planStatus`, `preflightState`, `generationPlanRequirements.allowedValues`, `generationPlanIssues`, `guidance.recommendedNextCommands`, `guidance.reason`, `guidance.nextStepGuidance`, `guidance.paramsExamples`, `guidance.fieldExamples`, `guidance.validationChecks`, and `guidance.doNotProceedIf` when present
 3. Follow `guidance.recommendedNextCommands` from the handshake before choosing the next command
 4. `canvas.plan.set`
 5. If the response is accepted, follow the returned guidance into `canvas.document.patch`
-6. If the response fails with `generation_plan_invalid`, inspect `details.missingFields`, `details.issues`, and `generationPlanIssues`, then optionally re-read with `canvas.plan.get` or `canvas.capabilities.get`
+6. If the response fails with `generation_plan_invalid`, inspect `details.missingFields`, `details.issues`, `generationPlanIssues`, and the typed repair examples, then repair the params file before retrying
 7. `canvas.preview.render` or `canvas.tab.open`
 8. `canvas.feedback.poll`
 9. `canvas.document.save` or `canvas.document.export`
@@ -112,9 +112,9 @@ If `canvas.document.patch` or `canvas.document.save` returns a blocker, stop mut
 
 | Audit ID | Failure class | Typical signal | Required response |
 |---|---|---|---|
-| `CANVAS-01` | Handshake missing or unread before mutation | `plan_required`, missing `handshake_read` evidence | Re-run `canvas.session.open` or `canvas.capabilities.get`, then `canvas.plan.set` |
+| `CANVAS-01` | Handshake missing or unread before mutation | `plan_required`, missing `handshake_read` evidence | Run `canvas.session.open`, then use `canvas.capabilities.get` only with the returned `canvasSessionId` if more diagnostics are needed |
 | `CANVAS-02` | Required governance block missing | save blocker, empty `requiredBeforeSave`, validation warning | Fill missing `designGovernance.*` fields before save/export |
-| `CANVAS-03` | Required `generationPlan` field missing or malformed | `canvas.plan.set` rejected with `generation_plan_invalid`, plus `generationPlanIssues` or issue details | Submit a complete plan and wait for acceptance |
+| `CANVAS-03` | Required `generationPlan` field missing or malformed | `canvas.plan.set` rejected with `generation_plan_invalid`, plus `generationPlanIssues` or issue details | Submit a complete plan from `guidance.paramsExamples` and wait for acceptance |
 | `CANVAS-04` | Library or icon-policy violation | validation warning, policy blocker, downgraded export | Adjust component/library choice to match `libraryPolicy` and `iconSystem` |
 | `CANVAS-05` | Unsupported target or overlay mount failure | `unsupported_target`, `restricted_url`, overlay mount error | Move to a normal http(s) preview target or managed mode |
 | `CANVAS-06` | Runtime budget exceeded or preview downgrade ignored | degrade warning, overflowed media/fonts/telemetry budget | Reduce preview cost or accept the downgrade before proceeding |

package/skills/opendevbrowser-best-practices/scripts/odb-workflow.sh

@@ -85,6 +85,9 @@ EOF
     cat <<EOF
 # Pair with opendevbrowser-design-agent when the contract will flow into implementation or /canvas work.
 $CLI_PREFIX inspiredesign run --brief "Design a premium docs workspace" --url "https://example.com/reference-a" --url "https://example.com/reference-b" --capture-mode off --include-prototype-guidance --mode json --output-format json
+$CLI_PREFIX inspiredesign harvest --brief "Premium digital photography studio landing page" --query "Pinterest premium digital photography studio landing page cinematic parallax portfolio" --provider social/pinterest --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
+# Inspect nextStepGuidance.readiness and doNotProceedIf before Canvas continuation. For non-ready evidence, follow recovery-first guidance.
+# Review visual-evidence.json, screenshot-index.json, ranked-references.json, and meta-prompt.md before design or Canvas work.
 EOF
     ;;
   parallel-multipage-safe)
@@ -136,6 +139,7 @@ $CLI_PREFIX canvas --command canvas.session.open --params '{"requestId":"req_ope
 $CLI_PREFIX canvas --command canvas.plan.set --params-file skills/opendevbrowser-best-practices/assets/templates/canvas-generation-plan.v1.json
 # Replace placeholders in the plan file with canvasSessionId, leaseId, and documentId from the open response.
 # If canvas.plan.set succeeds with planStatus=accepted or preflightState=plan_accepted, follow the returned guidance into canvas.document.patch.
+# If canvas.plan.set returns generation_plan_invalid, read guidance.nextStepGuidance, guidance.paramsExamples, guidance.fieldExamples, guidance.validationChecks, and guidance.doNotProceedIf, then repair the params file and retry.
 # Optional diagnostics after generation_plan_invalid:
 # $CLI_PREFIX canvas --command canvas.plan.get --params '{"requestId":"req_plan_get_01","canvasSessionId":"<canvas-session-id>","leaseId":"<lease-id>","documentId":"<document-id>"}'
 # or re-read with canvas.capabilities.get to inspect generationPlanIssues before resubmitting canvas.plan.set.
@@ -214,6 +218,9 @@ $CLI_PREFIX shopping run --query "27 inch 4k monitor" --providers shopping/bestb
 # Public-reference inspiredesign contract synthesis
 $CLI_PREFIX inspiredesign run --brief "Design a premium docs workspace" --url "https://example.com/reference-a" --url "https://example.com/reference-b" --capture-mode off --include-prototype-guidance --mode json --output-format json
 
+# Browser-native Pinterest recipe. Continue only when nextStepGuidance.readiness is ready.
+$CLI_PREFIX inspiredesign harvest --brief "Premium digital photography studio landing page" --query "Pinterest premium digital photography studio landing page cinematic parallax portfolio" --provider social/pinterest --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
+
 # Region note: advisory unless output reports meta.selection.region_authoritative=true
 $CLI_PREFIX shopping run --query "wireless earbuds" --providers shopping/amazon --region us --browser-mode managed --mode json --output-format json
 EOF

package/skills/opendevbrowser-best-practices/scripts/validate-skill-assets.sh

@@ -66,6 +66,10 @@ const executableScripts = [
 const workflowMarkers = [
   "inspiredesign)",
   "inspiredesign run",
+  "inspiredesign harvest",
+  "social/pinterest",
+  "nextStepGuidance.readiness",
+  "visual-evidence.json",
   "--include-prototype-guidance",
   "canvas-preflight",
   "canvas-feedback-eval",
@@ -105,6 +109,8 @@ const canvasPlaybookMarkers = [
   "canvas.plan.set",
   "canvas.feedback.poll",
   "guidance.recommendedNextCommands",
+  "guidance.nextStepGuidance",
+  "guidance.paramsExamples",
   "generationPlanIssues",
   "plan_invalid",
   "generation_plan_invalid",

package/skills/opendevbrowser-design-agent/SKILL.md

@@ -81,7 +81,7 @@ Use this skill for frontend work that must be visually strong, contract-first, a
 ## Core Rules
 
 - Start with a design contract, not ad-hoc implementation.
-- Build a reference pattern board before locking a new direction when external inspiration matters.
+- Build a reference pattern board before locking a new direction when external inspiration matters, and inspect `nextStepGuidance.readiness` before treating a harvest as design-ready.
 - Choose a component family from `artifacts/component-pattern-index.md` before inventing a new screen structure.
 - Start from the closest shipped OpenDevBrowser example in `artifacts/opendevbrowser-ui-example-map.md` when the repo already has a related surface.
 - Route repo-first redesigns through `artifacts/existing-surface-adaptation.md` before changing shells or component anatomy.
@@ -95,7 +95,7 @@ Use this skill for frontend work that must be visually strong, contract-first, a
 - Keep one visual direction per task. Do not mix unrelated design languages.
 - Prefer real content, realistic states, and explicit user journeys over placeholder copy.
 - Preserve the repo's existing design system when one already exists. Only introduce a new direction when the brief or product gap justifies it.
-- Treat `/canvas` governance as the strongest contract in the repo: read the handshake, respect `generationPlanRequirements`, and do not mutate before the plan is accepted.
+- Treat `/canvas` governance as the strongest contract in the repo: read the handshake, respect `generationPlanRequirements`, inspect typed repair examples, and do not mutate before the plan is accepted.
 - Treat `preflightState="handshake_read"` as the required ready state for the first post-open decision loop unless the handshake is already reporting an invalid-plan repair path.
 - For non-canvas frontend work, still fill the same design-contract fields before coding so decisions stay consistent across code, preview, and docs.
 - Use one owner for overlays, drawers, sheets, and detail panels; prefer item-backed state over boolean sprawl.
@@ -168,7 +168,9 @@ Use when a redesign needs external references or when the brief explicitly asks
 
 - Start with `artifacts/research-harvest-workflow.md`.
 - Capture `3` to `5` live references with OpenDevBrowser.
-- Record them in `assets/templates/reference-pattern-board.v1.json`.
+- For Pinterest, use the browser-native `social/pinterest` recipe with extension mode and cookies instead of treating Pinterest as a default full provider.
+- Inspect `nextStepGuidance.readiness`, `doNotProceedIf`, and recovery commands before using the bundle.
+- Record ready evidence in `assets/templates/reference-pattern-board.v1.json`.
 - Turn the synthesis into contract deltas before implementation.
 
 ### `screenshot-audit`
@@ -185,13 +187,13 @@ Use when starting from screenshots, mocks, or an existing page.
 
 Use when the task should run through the design canvas.
 
-- Start with `canvas.session.open` or `canvas.capabilities.get`.
-- Read the handshake and inspect `planStatus`, `preflightState`, `generationPlanRequirements.allowedValues`, `generationPlanIssues`, and `guidance.recommendedNextCommands` before choosing the next command.
+- Start with `canvas.session.open`; use `canvas.capabilities.get` only after you have a `canvasSessionId`.
+- Read the handshake and inspect `planStatus`, `preflightState`, `generationPlanRequirements.allowedValues`, `generationPlanIssues`, `guidance.recommendedNextCommands`, `guidance.nextStepGuidance`, params examples, field examples, validation checks, and do-not-proceed blockers before choosing the next command.
 - Treat `preflightState="handshake_read"` as the normal first-step checkpoint before `canvas.plan.set`; if the handshake already reports `plan_invalid`, repair the plan instead of mutating.
 - Fill the full design contract and extract the `generationPlan`.
 - Submit `canvas.plan.set`.
 - If `canvas.plan.set` succeeds with `planStatus="accepted"` or `preflightState="plan_accepted"`, follow the returned `guidance.recommendedNextCommands`, then mutate with `canvas.document.patch`.
-- If `canvas.plan.set` fails with `generation_plan_invalid`, inspect `details.missingFields`, `details.issues`, and `generationPlanIssues`, then optionally re-read with `canvas.plan.get` or `canvas.capabilities.get` before resubmitting.
+- If `canvas.plan.set` fails with `generation_plan_invalid`, inspect `details.missingFields`, `details.issues`, `guidance.paramsExamples`, `guidance.fieldExamples`, `guidance.validationChecks`, `guidance.doNotProceedIf`, and `generationPlanIssues`, then repair and resubmit the params file. Use `canvas.plan.get` or `canvas.capabilities.get` only when diagnostics are still needed after reading repair examples.
 - After every successful `canvas.document.patch`, `canvas.preview.render`, `canvas.preview.refresh`, `canvas.feedback.poll`, `canvas.document.save`, or `canvas.document.export`, read `guidance.recommendedNextCommands` and `guidance.reason` before choosing the next step.
 - Validate extension-stage history controls against public `canvas.history.undo` and `canvas.history.redo`; design-tab clicks emit the internal `canvas_history_requested` event, but acceptance is still on the public command outcomes.
 - When token work is in scope, validate collection or mode authoring, token value or alias edits, selected-node binding, and token usage inspection in the extension stage.