opendevbrowser 0.0.31 → 0.0.33

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

@@ -2,26 +2,26 @@ import "./chunk-RJNI3BHT.js";
 import {
   parseNumberFlag,
   parseOptionalStringFlag
-} from "./chunk-RPXWUCQQ.js";
+} from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-MD655IPO.js";
-import "./chunk-COAOWH3G.js";
-import "./chunk-QOMWCRE3.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
   createUsageError
-} from "./chunk-IPE7TF2P.js";
-import "./chunk-STGGGVYT.js";
-import "./chunk-3ILXPKSJ.js";
+} from "./chunk-7BNU6DFI.js";
+import "./chunk-QMHKAFYX.js";
+import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-4BEJVZRK.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-KZ2IXVQT.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/dom/text.ts
@@ -81,4 +81,4 @@ async function runDomText(args) {
 export {
   runDomText
 };
-//# sourceMappingURL=text-V3B7UVIH.js.map
+//# sourceMappingURL=text-VUZU7D3L.js.map

package/dist/tools/inspiredesign_run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspiredesign_run.d.ts","sourceRoot":"","sources":["../../src/tools/inspiredesign_run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAgBvC,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAkDzE"}
+{"version":3,"file":"inspiredesign_run.d.ts","sourceRoot":"","sources":["../../src/tools/inspiredesign_run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAmBvC,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,cAAc,CAuEzE"}

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

@@ -1,26 +1,26 @@
 import "./chunk-RJNI3BHT.js";
 import {
   parseOptionalStringFlag
-} from "./chunk-RPXWUCQQ.js";
+} from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-MD655IPO.js";
-import "./chunk-COAOWH3G.js";
-import "./chunk-QOMWCRE3.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
   createUsageError
-} from "./chunk-IPE7TF2P.js";
-import "./chunk-STGGGVYT.js";
-import "./chunk-3ILXPKSJ.js";
+} from "./chunk-7BNU6DFI.js";
+import "./chunk-QMHKAFYX.js";
+import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-4BEJVZRK.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-KZ2IXVQT.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/interact/type.ts
@@ -91,4 +91,4 @@ async function runType(args) {
 export {
   runType
 };
-//# sourceMappingURL=type-IYBN3ZLR.js.map
+//# sourceMappingURL=type-N5SURP74.js.map

package/dist/{uncheck-SG737EGI.js → uncheck-JFMK3SSY.js}

@@ -1,26 +1,26 @@
 import "./chunk-RJNI3BHT.js";
 import {
   parseOptionalStringFlag
-} from "./chunk-RPXWUCQQ.js";
+} from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-MD655IPO.js";
-import "./chunk-COAOWH3G.js";
-import "./chunk-QOMWCRE3.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
   createUsageError
-} from "./chunk-IPE7TF2P.js";
-import "./chunk-STGGGVYT.js";
-import "./chunk-3ILXPKSJ.js";
+} from "./chunk-7BNU6DFI.js";
+import "./chunk-QMHKAFYX.js";
+import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-4BEJVZRK.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-KZ2IXVQT.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/interact/uncheck.ts
@@ -68,4 +68,4 @@ async function runUncheck(args) {
 export {
   runUncheck
 };
-//# sourceMappingURL=uncheck-SG737EGI.js.map
+//# sourceMappingURL=uncheck-JFMK3SSY.js.map

package/dist/{uninstall-KYKGJAX7.js → uninstall-FW5ORBIN.js}

@@ -1,7 +1,7 @@
 import {
   hasBundledSkillArtifacts,
   hasManagedBundledSkillInstall
-} from "./chunk-KDSNXS6N.js";
+} from "./chunk-ZMNEWS7A.js";
 import {
   getGlobalConfigPath,
   getLocalConfigPath,
@@ -9,7 +9,7 @@ import {
   readConfig,
   removePluginFromContent
 } from "./chunk-7THCPS52.js";
-import "./chunk-3ILXPKSJ.js";
+import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 
 // src/cli/commands/uninstall.ts
@@ -88,4 +88,4 @@ export {
   hasInstalledConfig,
   runUninstall
 };
-//# sourceMappingURL=uninstall-KYKGJAX7.js.map
+//# sourceMappingURL=uninstall-FW5ORBIN.js.map

package/dist/{update-skill-modes-BVX7IVMW.js → update-skill-modes-3ULKJK3Y.js}

@@ -1,9 +1,9 @@
 import {
   hasBundledSkillArtifacts,
   hasManagedBundledSkillInstall
-} from "./chunk-KDSNXS6N.js";
+} from "./chunk-ZMNEWS7A.js";
 import "./chunk-7THCPS52.js";
-import "./chunk-3ILXPKSJ.js";
+import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 
 // src/cli/update-skill-modes.ts
@@ -35,4 +35,4 @@ function resolveUpdateSkillModes(args) {
 export {
   resolveUpdateSkillModes
 };
-//# sourceMappingURL=update-skill-modes-BVX7IVMW.js.map
+//# sourceMappingURL=update-skill-modes-3ULKJK3Y.js.map

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

@@ -2,26 +2,26 @@ import "./chunk-RJNI3BHT.js";
 import {
   parseOptionalStringFlag,
   parseStringArrayFlag
-} from "./chunk-RPXWUCQQ.js";
+} from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-MD655IPO.js";
-import "./chunk-COAOWH3G.js";
-import "./chunk-QOMWCRE3.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
   createUsageError
-} from "./chunk-IPE7TF2P.js";
-import "./chunk-STGGGVYT.js";
-import "./chunk-3ILXPKSJ.js";
+} from "./chunk-7BNU6DFI.js";
+import "./chunk-QMHKAFYX.js";
+import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-4BEJVZRK.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-KZ2IXVQT.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/interact/upload.ts
@@ -53,4 +53,4 @@ export {
   __test__,
   runUpload
 };
-//# sourceMappingURL=upload-KH6ZABJA.js.map
+//# sourceMappingURL=upload-KFUYLL7M.js.map

package/dist/{use-7YDKO3U4.js → use-CNMPP2ED.js}

@@ -1,23 +1,23 @@
 import "./chunk-RJNI3BHT.js";
 import {
   callDaemon
-} from "./chunk-MD655IPO.js";
-import "./chunk-COAOWH3G.js";
-import "./chunk-QOMWCRE3.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
   createUsageError
-} from "./chunk-IPE7TF2P.js";
-import "./chunk-STGGGVYT.js";
-import "./chunk-3ILXPKSJ.js";
+} from "./chunk-7BNU6DFI.js";
+import "./chunk-QMHKAFYX.js";
+import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-4BEJVZRK.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-KZ2IXVQT.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/targets/use.ts
@@ -60,4 +60,4 @@ async function runTargetUse(args) {
 export {
   runTargetUse
 };
-//# sourceMappingURL=use-7YDKO3U4.js.map
+//# sourceMappingURL=use-CNMPP2ED.js.map

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

@@ -1,26 +1,26 @@
 import "./chunk-RJNI3BHT.js";
 import {
   parseOptionalStringFlag
-} from "./chunk-RPXWUCQQ.js";
+} from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-MD655IPO.js";
-import "./chunk-COAOWH3G.js";
-import "./chunk-QOMWCRE3.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
   createUsageError
-} from "./chunk-IPE7TF2P.js";
-import "./chunk-STGGGVYT.js";
-import "./chunk-3ILXPKSJ.js";
+} from "./chunk-7BNU6DFI.js";
+import "./chunk-QMHKAFYX.js";
+import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-4BEJVZRK.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-KZ2IXVQT.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/dom/value.ts
@@ -68,4 +68,4 @@ async function runDomValue(args) {
 export {
   runDomValue
 };
-//# sourceMappingURL=value-RZBWSKKM.js.map
+//# sourceMappingURL=value-J335MPZE.js.map

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

@@ -1,26 +1,26 @@
 import "./chunk-RJNI3BHT.js";
 import {
   parseOptionalStringFlag
-} from "./chunk-RPXWUCQQ.js";
+} from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-MD655IPO.js";
-import "./chunk-COAOWH3G.js";
-import "./chunk-QOMWCRE3.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
   createUsageError
-} from "./chunk-IPE7TF2P.js";
-import "./chunk-STGGGVYT.js";
-import "./chunk-3ILXPKSJ.js";
+} from "./chunk-7BNU6DFI.js";
+import "./chunk-QMHKAFYX.js";
+import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-4BEJVZRK.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-KZ2IXVQT.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/dom/visible.ts
@@ -68,4 +68,4 @@ async function runDomVisible(args) {
 export {
   runDomVisible
 };
-//# sourceMappingURL=visible-BSFTAKXR.js.map
+//# sourceMappingURL=visible-YQZWWPBZ.js.map

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

@@ -2,26 +2,26 @@ import "./chunk-RJNI3BHT.js";
 import {
   parseNumberFlag,
   parseOptionalStringFlag
-} from "./chunk-RPXWUCQQ.js";
+} from "./chunk-SKFB5ICF.js";
 import {
   callDaemon
-} from "./chunk-MD655IPO.js";
-import "./chunk-COAOWH3G.js";
-import "./chunk-QOMWCRE3.js";
+} from "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
 import {
   createUsageError
-} from "./chunk-IPE7TF2P.js";
-import "./chunk-STGGGVYT.js";
-import "./chunk-3ILXPKSJ.js";
+} from "./chunk-7BNU6DFI.js";
+import "./chunk-QMHKAFYX.js";
+import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-4BEJVZRK.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-KZ2IXVQT.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/nav/wait.ts
@@ -106,4 +106,4 @@ async function runWait(args) {
 export {
   runWait
 };
-//# sourceMappingURL=wait-TMTEAYOP.js.map
+//# sourceMappingURL=wait-IC7YJJPJ.js.map

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

@@ -2,25 +2,25 @@ import {
   callDesktopCommand,
   desktopCommandResult,
   parseDesktopReasonArgs
-} from "./chunk-AHEWXOKY.js";
+} from "./chunk-JROW6ZNN.js";
 import "./chunk-RJNI3BHT.js";
-import "./chunk-RPXWUCQQ.js";
+import "./chunk-SKFB5ICF.js";
 import "./chunk-OW5HMYMI.js";
-import "./chunk-MD655IPO.js";
-import "./chunk-COAOWH3G.js";
-import "./chunk-QOMWCRE3.js";
+import "./chunk-MJF67OTH.js";
+import "./chunk-HMRANSDX.js";
+import "./chunk-EOX6U6Q4.js";
 import "./chunk-MX3NFLCE.js";
 import "./chunk-ASMHEEKY.js";
-import "./chunk-IPE7TF2P.js";
-import "./chunk-STGGGVYT.js";
-import "./chunk-3ILXPKSJ.js";
+import "./chunk-7BNU6DFI.js";
+import "./chunk-QMHKAFYX.js";
+import "./chunk-BUVYTJZR.js";
 import "./chunk-TBUCZX4A.js";
 import "./chunk-Y2KL55OG.js";
 import "./chunk-5SWZDVOW.js";
-import "./chunk-4BEJVZRK.js";
+import "./chunk-FBKPDILE.js";
 import "./chunk-S5KZQJJI.js";
-import "./chunk-KZ2IXVQT.js";
-import "./chunk-WHQZBUNY.js";
+import "./chunk-IBIHDGTZ.js";
+import "./chunk-3WLCWHIV.js";
 import "./chunk-FUSXMW3G.js";
 
 // src/cli/commands/desktop/windows.ts
@@ -34,4 +34,4 @@ async function runDesktopWindows(args) {
 export {
   runDesktopWindows
 };
-//# sourceMappingURL=windows-HIZ23OHS.js.map
+//# sourceMappingURL=windows-AGVQ3KX3.js.map

package/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "OpenDevBrowser Relay",
-  "version": "0.0.31",
+  "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.31",
+  "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/AGENTS.md

@@ -1,6 +1,6 @@
 # skills/ — Agent Guidelines
 
-Bundled OpenDevBrowser skill directories (9 canonical packs). Extends root `AGENTS.md`.
+Bundled OpenDevBrowser skill directories (10 canonical packs). Extends root `AGENTS.md`.
 
 ## Structure
 
@@ -8,6 +8,7 @@ Bundled OpenDevBrowser skill directories (9 canonical packs). Extends root `AGEN
 skills/
 ├── opendevbrowser-best-practices/SKILL.md
 ├── opendevbrowser-design-agent/SKILL.md
+├── opendevbrowser-motion-design/SKILL.md
 ├── opendevbrowser-continuity-ledger/SKILL.md
 ├── opendevbrowser-login-automation/SKILL.md
 ├── opendevbrowser-form-testing/SKILL.md

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

@@ -145,12 +145,20 @@ 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:
 - keep inspiredesign references public-first; any supplied `--url` now forces deep capture so the workflow can collect DOM/layout evidence
 - use repeated `--url` flags instead of packed URL strings
-- after a successful run, read `advanced-brief.md` first, load `opendevbrowser_skill_load opendevbrowser-best-practices "quick start"` plus `opendevbrowser_skill_load opendevbrowser-design-agent "canvas-contract"`, 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`
+- 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
+- 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
@@ -168,6 +176,9 @@ Install and update refresh managed copies of these canonical packs; uninstall re
 - Prefer refs from `opendevbrowser_snapshot` over raw selectors.
 - Use one action per decision loop: snapshot -> action -> snapshot.
 - Keep a single correlation context (`requestId`, `sessionId`) across a run.
+- Before daemon-backed workflows, run `opendevbrowser status --daemon --output-format json` and require `data.fingerprintCurrent === true`.
+- Treat missing or false `data.fingerprintCurrent` as not current; use the matching binary, restart from the current install, or isolate shared runs with `OPENCODE_CONFIG_DIR`, `OPENCODE_CACHE_DIR`, and unique daemon or relay ports.
+- Do not conflate `daemon_fingerprint_mismatch` with native messaging host drift.
 - Run the same workflow shape across all three modes before claiming parity.
 - Default to read/research workflows. Social posting probes remain disabled unless explicitly requested via direct-run opt-in (`--include-social-posts`).
 - Apply rate-limit/backoff discipline (`Retry-After` aware) whenever 429 pressure appears.
@@ -181,7 +192,7 @@ Install and update refresh managed copies of these canonical packs; uninstall re
 - Use default extension `/ops` for relay-backed concurrency; use `/cdp` only for legacy compatibility paths.
 - For managed parallel runs with persisted profiles, use unique profile paths per session (or disable persistence) to avoid profile lock collisions.
 - Treat extension headless attempts (`--extension-only --headless`) as expected `unsupported_mode`; route headless workloads through managed/cdpConnect instead.
-- Before extension-mode runs, preflight `npx opendevbrowser status --daemon` and require `extensionConnected=true` plus `extensionHandshakeComplete=true`.
+- Before extension-mode runs, preflight `npx opendevbrowser status --daemon --output-format json` and require `data.fingerprintCurrent === true`, `data.relay.extensionConnected === true`, and `data.relay.extensionHandshakeComplete === true`.
 
 Operational references:
 - `artifacts/provider-workflows.md` (see Workflow E)
@@ -345,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,
@@ -372,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/artifacts/skill-runtime-surface-matrix.md

@@ -10,6 +10,7 @@ Canonical inventory of repo-local OpenDevBrowser skill packs and the audit evide
 | `opendevbrowser-continuity-ledger` | `doc_only` | `./skills/opendevbrowser-continuity-ledger/scripts/validate-skill-assets.sh` | continuity ownership, ledger template, reply protocol | validator output plus `skill-discovery` and `docs-drift`; no live browser probe | not applicable |
 | `opendevbrowser-data-extraction` | `workflow` | `./skills/opendevbrowser-data-extraction/scripts/validate-skill-assets.sh` | snapshot, DOM text/html extraction, pagination, quality gates, structured extraction | `node scripts/cli-smoke-test.mjs` plus `node scripts/product-video-fixture-live-probe.mjs` for structured extraction on a repo-local product page | extension unavailable at start if extension mode is audited separately |
 | `opendevbrowser-design-agent` | `browser_surface` | `./skills/opendevbrowser-design-agent/scripts/validate-skill-assets.sh` | `/canvas`, annotate send/stored semantics, design contract workflow, real-surface validation | `node scripts/live-regression-direct.mjs`, `node scripts/canvas-competitive-validation.mjs` | extension unavailable at start, optional Figma live smoke |
+| `opendevbrowser-motion-design` | `browser_surface` | `./skills/opendevbrowser-motion-design/scripts/validate-skill-assets.sh` | screenshot, debug-trace-snapshot, screencast-start, screencast-stop, `/canvas`, reduced-motion checks, viewport motion matrix | `node scripts/live-regression-direct.mjs`, `node scripts/canvas-competitive-validation.mjs`, `skill-discovery` | extension unavailable at start, reduced-motion emulation unavailable |
 | `opendevbrowser-form-testing` | `workflow` | `./skills/opendevbrowser-form-testing/scripts/validate-skill-assets.sh` | snapshot -> type/click -> validation loop, multi-step forms, challenge checkpoints, network correlation | `node scripts/cli-smoke-test.mjs` plus `node scripts/login-fixture-live-probe.mjs` for invalid-submit, MFA, and persistence branches | extension unavailable at start if extension mode is audited separately |
 | `opendevbrowser-login-automation` | `workflow` | `./skills/opendevbrowser-login-automation/scripts/validate-skill-assets.sh` | login branching, invalid credential handling, MFA step-up, session validation | `node scripts/login-fixture-live-probe.mjs` | none; proof lane is repo-local |
 | `opendevbrowser-product-presentation-asset` | `workflow` | `./skills/opendevbrowser-product-presentation-asset/scripts/validate-skill-assets.sh` | `product-video run`, asset-pack assembly, screenshots, evidence mapping | `node scripts/product-video-fixture-live-probe.mjs` | none; proof lane is repo-local |
@@ -36,12 +37,12 @@ Canonical inventory of repo-local OpenDevBrowser skill packs and the audit evide
 
 | Audit domain | Covers | Proof lanes | Contract tests | Targeted reruns |
 |---|---|---|---|---|
-| `skills-assets-discovery` | bundled skills, validator assets, loader discovery, install targets | `skill-discovery`, `docs-drift` | `tests/skill-loader.test.ts`, `tests/skill-workflow-packs.test.ts`, `tests/cli-skills-installer.test.ts` | `./skills/opendevbrowser-best-practices/scripts/validate-skill-assets.sh`, `node scripts/skill-runtime-audit.mjs --smoke --out artifacts/skill-runtime-audit/smoke.json` |
+| `skills-assets-discovery` | bundled skills including `opendevbrowser-motion-design`, validator assets, loader discovery, install targets | `skill-discovery`, `docs-drift` | `tests/skill-loader.test.ts`, `tests/skill-workflow-packs.test.ts`, `tests/cli-skills-installer.test.ts` | `./skills/opendevbrowser-best-practices/scripts/validate-skill-assets.sh`, `./skills/opendevbrowser-motion-design/scripts/validate-skill-assets.sh`, `node scripts/skill-runtime-audit.mjs --smoke --out artifacts/skill-runtime-audit/smoke.json` |
 | `cli-tools-surface` | CLI args/help, tool registry, surface inventory docs, generated help, onboarding metadata, and first-contact owners | `docs-drift`, `cli-smoke` | `tests/cli-help.test.ts`, `tests/cli-help-parity.test.ts`, `tests/daemon-commands.integration.test.ts` | `node scripts/docs-drift-check.mjs`, `node scripts/cli-smoke-test.mjs` |
 | `scripts-and-governance` | audit scripts, workflow router, drift and robustness policy, machine matrix, prose mirror, and surface-audit checklist | `docs-drift`, `best-practices-robustness`, `skill-discovery` | `tests/docs-drift-check.test.ts`, `tests/skill-runtime-audit.test.ts`, `tests/audit-zombie-files.test.ts` | `./skills/opendevbrowser-best-practices/scripts/run-robustness-audit.sh`, `node scripts/docs-drift-check.mjs` |
 | `browser-snapshot-interaction` | browser lifecycle, snapshot refs, DOM reads, click/type flows | `cli-smoke`, `login-fixture`, `product-video-fixture` | `tests/tools-workflows.test.ts`, `tests/tools-workflows-branches.test.ts`, `tests/browser-manager.test.ts` | `node scripts/cli-smoke-test.mjs`, `node scripts/login-fixture-live-probe.mjs --out artifacts/skill-runtime-audit/lanes/login-fixture.json` |
-| `canvas-annotate-design` | `/canvas`, annotate delivery, design-agent workflow, extension canvas runtime | `live-regression`, `canvas-competitive` | `tests/canvas-command-inventory.test.ts`, `tests/canvas-live-workflow-script.test.ts`, `tests/annotate-live-probe-script.test.ts` | `node scripts/live-regression-direct.mjs --out artifacts/skill-runtime-audit/lanes/live-regression.json`, `node scripts/canvas-competitive-validation.mjs --out artifacts/skill-runtime-audit/lanes/canvas-competitive.json` |
-| `extension-relay-cdp` | extension `/ops`, relay contracts, legacy CDP, target-session routing | `live-regression`, `docs-drift` | `tests/parity-matrix.test.ts`, `tests/relay-server.test.ts`, `tests/ops-browser-manager.test.ts` | `node scripts/live-regression-direct.mjs --out artifacts/skill-runtime-audit/lanes/live-regression.json`, `./skills/opendevbrowser-best-practices/scripts/odb-workflow.sh cdp-channel-check` |
+| `canvas-annotate-design` | `/canvas`, annotate delivery, design-agent workflow, motion-design temporal evidence workflow, extension canvas runtime | `live-regression`, `canvas-competitive` | `tests/canvas-command-inventory.test.ts`, `tests/canvas-live-workflow-script.test.ts`, `tests/annotate-live-probe-script.test.ts` | `node scripts/live-regression-direct.mjs --out artifacts/skill-runtime-audit/lanes/live-regression.json`, `node scripts/canvas-competitive-validation.mjs --out artifacts/skill-runtime-audit/lanes/canvas-competitive.json`, `./skills/opendevbrowser-motion-design/scripts/validate-skill-assets.sh` |
+| `extension-relay-cdp` | extension `/ops`, relay contracts, legacy CDP, target-session routing, motion-design replay parity | `live-regression`, `docs-drift` | `tests/parity-matrix.test.ts`, `tests/relay-server.test.ts`, `tests/ops-browser-manager.test.ts` | `node scripts/live-regression-direct.mjs --out artifacts/skill-runtime-audit/lanes/live-regression.json`, `./skills/opendevbrowser-best-practices/scripts/odb-workflow.sh cdp-channel-check` |
 | `providers-macros-workflows` | providers, workflow wrappers, inspiredesign contract synthesis, macro resolve or execute, product-video | `provider-direct`, `research-live`, `product-video-fixture` | `tests/provider-direct-runs.test.ts`, `tests/macro-resolve.test.ts`, `tests/cli-macro-resolve.test.ts`, `tests/providers-inspiredesign-workflow.test.ts` | `node scripts/provider-direct-runs.mjs --smoke --out artifacts/skill-runtime-audit/lanes/provider-direct.json`, `npm run test -- tests/macro-resolve.test.ts tests/cli-macro-resolve.test.ts tests/providers-inspiredesign-workflow.test.ts` |
 | `challenges-and-guardrails` | challenge coordinator, browser-scoped `challengeAutomationMode` computer-use boundary, login/form challenge branches, blocker envelopes | `login-fixture`, `provider-direct`, `research-live`, `live-regression` | `tests/challenges-capability-matrix.test.ts`, `tests/browser-manager-challenge-runtime-handle.test.ts`, `tests/ops-browser-manager-challenge-runtime-handle.test.ts` | `node scripts/login-fixture-live-probe.mjs --out artifacts/skill-runtime-audit/lanes/login-fixture.json`, `node scripts/provider-direct-runs.mjs --smoke --out artifacts/skill-runtime-audit/lanes/provider-direct.json` |
 | `runtime-infrastructure` | bootstrap, runtime factory, daemon client, shared hub utilities | `cli-smoke`, `live-regression` | `tests/core-bootstrap.test.ts`, `tests/providers-runtime-factory.test.ts`, `tests/daemon-client.test.ts` | `npm run test -- tests/core-bootstrap.test.ts tests/providers-runtime-factory.test.ts tests/daemon-client.test.ts`, `node scripts/cli-smoke-test.mjs` |

package/skills/opendevbrowser-best-practices/assets/templates/mode-flag-matrix.json

@@ -1,5 +1,12 @@
 {
   "schemaVersion": "1.0",
+  "daemonPreflight": {
+    "command": "npx opendevbrowser status --daemon --output-format json",
+    "required": true,
+    "statusExpectations": {
+      "fingerprintCurrent": true
+    }
+  },
   "modes": [
     {
       "name": "managed",