opendevbrowser 0.0.15 → 0.0.17

package/skills/opendevbrowser-product-presentation-asset/assets/templates/video-assembly.md

@@ -0,0 +1,18 @@
+# Video Assembly Instructions
+
+## Assets
+
+- Manifest: `manifest.json`
+- Product metadata: `product.json`
+- Pricing: `pricing.json`
+- Copy and features: `copy.md`, `features.md`
+- Visuals: `images/*`, `screenshots/*`
+- Claim evidence map: `claims-evidence-map.md`
+
+## Assembly Steps
+
+1. Build script from top 3 verified benefits.
+2. Match each line to one visual asset.
+3. Create sequence: hook -> proof -> CTA.
+4. Verify all price/discount statements against `pricing.json`.
+5. Mark `claims-evidence-map.md` rows as verified before publishing.

package/skills/opendevbrowser-product-presentation-asset/examples/sample-input.json

@@ -0,0 +1,6 @@
+{
+  "product_url": "https://example.com/product/123",
+  "include_screenshots": true,
+  "include_all_images": true,
+  "include_copy": true
+}

package/skills/opendevbrowser-product-presentation-asset/examples/sample-manifest.json

@@ -0,0 +1,18 @@
+{
+  "run_id": "example-run-id",
+  "created_at": "2026-02-16T00:00:00.000Z",
+  "source_url": "https://example.com/product/123",
+  "provider": "shopping/others",
+  "product": {
+    "title": "Example Product",
+    "brand": "Example",
+    "price": { "amount": 29.99, "currency": "USD", "retrieved_at": "2026-02-16T00:00:00.000Z" },
+    "features": ["Feature 1", "Feature 2"],
+    "copy": "Example copy"
+  },
+  "assets": {
+    "images": ["images/image-01.jpg"],
+    "screenshots": ["screenshots/screenshot-01.png"],
+    "raw": ["raw/source-record.json"]
+  }
+}

package/skills/opendevbrowser-product-presentation-asset/scripts/capture-screenshots.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: capture-screenshots.sh <product-url>"
+  exit 1
+fi
+
+opendevbrowser product-video run --product-url "$1" --include-screenshots --include-all-images=false

package/skills/opendevbrowser-product-presentation-asset/scripts/collect-product.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: collect-product.sh <product-url|product-name>"
+  exit 1
+fi
+
+VALUE="$1"
+if [[ "$VALUE" == http* ]]; then
+  opendevbrowser product-video run --product-url "$VALUE"
+else
+  opendevbrowser product-video run --product-name "$VALUE"
+fi

package/skills/opendevbrowser-product-presentation-asset/scripts/download-images.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: download-images.sh <product-url>"
+  exit 1
+fi
+
+opendevbrowser product-video run --product-url "$1" --include-all-images --include-screenshots=false

package/skills/opendevbrowser-product-presentation-asset/scripts/render-video-brief.sh

@@ -0,0 +1,96 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: render-video-brief.sh <manifest-json> [output-dir]" >&2
+  exit 1
+fi
+
+manifest="$1"
+outdir="${2:-$(dirname "$manifest")}" 
+mkdir -p "$outdir"
+
+node - "$manifest" "$outdir" <<'NODE'
+const fs = require("fs");
+const path = require("path");
+
+const manifestPath = process.argv[2];
+const outdir = process.argv[3];
+
+const data = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+const product = data.product || {};
+const pricing = product.price || {};
+
+const title = product.title || "Unknown product";
+const brand = product.brand || "Unknown brand";
+const amount = typeof pricing.amount === "number" ? pricing.amount.toFixed(2) : "N/A";
+const currency = pricing.currency || "USD";
+const features = Array.isArray(product.features) ? product.features.slice(0, 5) : [];
+const copy = typeof product.copy === "string" ? product.copy.trim().slice(0, 600) : "";
+const images = Array.isArray(data?.assets?.images) ? data.assets.images : [];
+const screenshots = Array.isArray(data?.assets?.screenshots) ? data.assets.screenshots : [];
+
+const claimRows = (features.length ? features : ["Add verified feature claims"]).map((claim, index) => {
+  const evidence = screenshots[index] || images[index] || images[0] || screenshots[0] || "<asset>";
+  return `| ${claim} | ${evidence} | product.features[${index}] | no |`;
+});
+
+const videoBrief = [
+  "# Video Brief",
+  "",
+  `- Product: ${title}`,
+  `- Brand: ${brand}`,
+  `- Price: ${amount} ${currency}`,
+  "",
+  "## Verified Features",
+  ...(features.length ? features.map((entry) => `- ${entry}`) : ["- Add verified feature bullets"]),
+  "",
+  "## Suggested Hook",
+  `- "${title} solves <problem> faster with <core benefit>."`,
+  "",
+  "## Copy Input",
+  copy ? copy : "(No copy captured)",
+  "",
+  "## Assets",
+  `- Images: ${images.length}`,
+  `- Screenshots: ${screenshots.length}`,
+  "- Claims evidence map: claims-evidence-map.md"
+].join("\n");
+
+const shotList = [
+  "# Shot List",
+  "",
+  "| Scene | Goal | Asset | Voiceover | Duration |",
+  "|---|---|---|---|---:|",
+  `| 1 | Hook | ${screenshots[0] || images[0] || "<asset>"} | Problem + promise | 2s |`,
+  `| 2 | Feature demo | ${images[0] || screenshots[0] || "<asset>"} | Show proof | 4s |`,
+  `| 3 | Outcome + CTA | ${images[1] || screenshots[1] || images[0] || "<asset>"} | Benefit + CTA | 4s |`
+].join("\n");
+
+const ugcBrief = [
+  "# UGC Brief",
+  "",
+  "## Creator Direction",
+  "- Speak as a real user solving a real problem.",
+  "- Show product in use before listing specs.",
+  "- Keep claims aligned with captured assets and manifest data.",
+  "",
+  "## CTA",
+  "- Use one clear CTA tied to the strongest verified benefit."
+].join("\n");
+
+const claimsEvidenceMap = [
+  "# Claims Evidence Map",
+  "",
+  "| Claim | Evidence Asset | Source Field | Verified |",
+  "|---|---|---|---|",
+  ...claimRows
+].join("\n");
+
+fs.writeFileSync(path.join(outdir, "video-brief.md"), videoBrief);
+fs.writeFileSync(path.join(outdir, "shot-list.md"), shotList);
+fs.writeFileSync(path.join(outdir, "ugc-brief.md"), ugcBrief);
+fs.writeFileSync(path.join(outdir, "claims-evidence-map.md"), claimsEvidenceMap);
+
+process.stdout.write(`Video brief files written to ${outdir}\n`);
+NODE

package/skills/opendevbrowser-product-presentation-asset/scripts/validate-skill-assets.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+skill_file="$root/SKILL.md"
+
+required=(
+  "artifacts/asset-pack-assembly.md"
+  "artifacts/ugc-creative-guide.md"
+  "assets/templates/manifest.schema.json"
+  "assets/templates/copy.md"
+  "assets/templates/features.md"
+  "assets/templates/video-assembly.md"
+  "assets/templates/user-actions.md"
+  "assets/templates/ugc-concepts.md"
+  "assets/templates/shot-list.md"
+  "assets/templates/claims-evidence-map.md"
+  "scripts/collect-product.sh"
+  "scripts/capture-screenshots.sh"
+  "scripts/download-images.sh"
+  "scripts/write-manifest.sh"
+  "scripts/render-video-brief.sh"
+  "scripts/validate-skill-assets.sh"
+)
+
+status=0
+for rel in "${required[@]}"; do
+  if [[ ! -f "$root/$rel" ]]; then
+    echo "Missing required asset: $rel" >&2
+    status=1
+  fi
+  if ! grep -Fq "$rel" "$skill_file"; then
+    echo "SKILL.md missing reference: $rel" >&2
+    status=1
+  fi
+done
+
+for rel in scripts/collect-product.sh scripts/capture-screenshots.sh scripts/download-images.sh scripts/write-manifest.sh scripts/render-video-brief.sh scripts/validate-skill-assets.sh; do
+  if [[ -f "$root/$rel" && ! -x "$root/$rel" ]]; then
+    echo "Script is not executable: $rel" >&2
+    status=1
+  fi
+done
+
+if [[ -f "$root/assets/templates/manifest.schema.json" ]]; then
+  if ! node -e 'const fs=require("fs"); JSON.parse(fs.readFileSync(process.argv[1], "utf8"));' "$root/assets/templates/manifest.schema.json" >/dev/null 2>&1; then
+    echo "Invalid JSON template: assets/templates/manifest.schema.json" >&2
+    status=1
+  fi
+fi
+
+if [[ $status -ne 0 ]]; then
+  exit $status
+fi
+
+echo "Product presentation asset skill pack validated."

package/skills/opendevbrowser-product-presentation-asset/scripts/write-manifest.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 2 ]]; then
+  echo "Usage: write-manifest.sh <product-url|product-name> <output-dir>"
+  exit 1
+fi
+
+VALUE="$1"
+OUTDIR="$2"
+mkdir -p "$OUTDIR"
+
+cmd=(opendevbrowser product-video run --output-dir "$OUTDIR" --output-format json)
+if [[ "$VALUE" == http* ]]; then
+  cmd+=(--product-url "$VALUE")
+else
+  cmd+=(--product-name "$VALUE")
+fi
+
+json_output="$("${cmd[@]}")"
+printf '%s\n' "$json_output"
+
+bundle_path="$(printf '%s\n' "$json_output" | node -e 'const fs=require("fs");const input=fs.readFileSync(0,"utf8").split(/\r?\n/).map((line)=>line.trim()).filter(Boolean);let payload=null;for(const line of input){try{payload=JSON.parse(line);}catch{}}const p=payload?.data?.path; if(typeof p==="string") process.stdout.write(p);')"
+manifest_out="$OUTDIR/manifest.json"
+
+if [[ ! -f "$manifest_out" ]]; then
+  source_manifest=""
+  if [[ -n "$bundle_path" && -f "$bundle_path/manifest.json" ]]; then
+    source_manifest="$bundle_path/manifest.json"
+  else
+    source_manifest="$(find "$OUTDIR" -maxdepth 6 -type f -name manifest.json | head -n 1)"
+  fi
+  if [[ -n "$source_manifest" && -f "$source_manifest" ]]; then
+    cp "$source_manifest" "$manifest_out"
+  fi
+fi
+
+if [[ ! -f "$manifest_out" ]]; then
+  echo "Manifest not found in output dir: $OUTDIR" >&2
+  exit 2
+fi
+
+echo "Manifest ready: $manifest_out"

package/skills/opendevbrowser-research/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: opendevbrowser-research
+description: Deterministic multi-source research workflow with strict timebox and artifact outputs.
+version: 2.0.0
+---
+
+# Research Skill
+
+Use this skill when you need benchmark-style research across `web|community|social|shopping` with strict timebox semantics and stable output modes.
+
+## Pack Contents
+
+- `artifacts/research-workflows.md`
+- `assets/templates/compact.md`
+- `assets/templates/context.json`
+- `assets/templates/report.md`
+- `scripts/run-research.sh`
+- `scripts/render-output.sh`
+- `scripts/write-artifacts.sh`
+- `scripts/validate-skill-assets.sh`
+- Shared robustness matrix: `../opendevbrowser-best-practices/artifacts/browser-agent-known-issues-matrix.md`
+
+## Fast Start
+
+```bash
+./skills/opendevbrowser-research/scripts/validate-skill-assets.sh
+./skills/opendevbrowser-research/scripts/run-research.sh "browser automation" 30 context
+./skills/opendevbrowser-research/scripts/render-output.sh "browser automation" compact
+```
+
+## Core Rules
+
+- Define timebox first (`--days` or `--from/--to`).
+- Prefer explicit sources for high-stakes claims.
+- Persist artifacts and return reproducible paths.
+- Mark unsupported claims as tentative; do not overstate certainty.
+- Honor bounded retries and backoff windows under 429 pressure.
+
+## Parallel Multitab Alignment
+
+- Apply shared concurrency policy from `../opendevbrowser-best-practices/SKILL.md` ("Parallel Operations").
+- Run research acceptance in `managed`, `extension`, and `cdpConnect` where browser-backed evidence capture is used.
+- Keep provider query orchestration mode-agnostic; isolate browser interaction per session worker.
+
+## Robustness Coverage (Known-Issue Matrix)
+
+Matrix source: `../opendevbrowser-best-practices/artifacts/browser-agent-known-issues-matrix.md`
+
+- `ISSUE-06`: upstream throttling and retry discipline
+- `ISSUE-09`: pagination/result drift across sources
+- `ISSUE-10`: locale/currency normalization consistency
+- `ISSUE-12`: stale evidence and claim traceability
+
+## Workflow
+
+1. Resolve timebox (`days` or `from/to`).
+2. Choose sources (`auto|web|community|social|shopping|all`).
+3. Run `opendevbrowser research run`.
+4. Return requested mode output and artifact path.
+
+## Commands
+
+```bash
+opendevbrowser research run --topic "<topic>" --days 30 --mode context
+opendevbrowser research run --topic "<topic>" --source-selection all --mode json
+opendevbrowser research run --topic "<topic>" --sources web,shopping --mode md
+```
+
+## Notes
+
+- `auto` resolves to `web|community|social` in v1.
+- Use `--source-selection all` or `--sources shopping,...` to include shopping.
+- Use `--mode path` with `scripts/write-artifacts.sh` when you need replayable handoff bundles.

package/skills/opendevbrowser-research/artifacts/research-workflows.md

@@ -0,0 +1,29 @@
+# Research Workflows
+
+## Deterministic baseline workflow
+
+1. Define topic and strict time window
+2. Resolve source selection (`auto|all|explicit`)
+3. Run research workflow command
+4. Persist context/report artifacts
+5. Validate source diversity and freshness
+
+## Cross-source corroboration workflow
+
+1. Identify claims from first-pass output
+2. Require at least two independent source records for critical claims
+3. Mark unsupported claims as tentative
+4. Escalate when corroboration is missing
+
+## Backoff/retry workflow
+
+1. Detect repeated 429/upstream throttling
+2. Honor retry windows and bounded retries
+3. Resume from persisted context artifact
+4. Report partial coverage when limits persist
+
+## Compact handoff workflow
+
+1. Produce compact summary with key findings
+2. Include unresolved risks and missing evidence
+3. Attach artifact paths for replay

package/skills/opendevbrowser-research/assets/templates/compact.md

@@ -0,0 +1,7 @@
+# Compact Research Template
+
+- Top findings:
+- Source diversity:
+- Key risks:
+- Rate-limit/backoff notes:
+- Open evidence gaps:

package/skills/opendevbrowser-research/assets/templates/context.json

@@ -0,0 +1,18 @@
+{
+  "topic": "",
+  "timebox": {
+    "days": 30
+  },
+  "issue_ids": [
+    "ISSUE-06",
+    "ISSUE-09",
+    "ISSUE-10",
+    "ISSUE-12"
+  ],
+  "highlights": [],
+  "records": [],
+  "meta": {
+    "source_count": 0,
+    "warnings": []
+  }
+}

package/skills/opendevbrowser-research/assets/templates/report.md

@@ -0,0 +1,9 @@
+# Research Report
+
+## Executive Summary
+
+## Findings
+
+## Confidence and Gaps
+
+## Sources

package/skills/opendevbrowser-research/examples/sample-input.json

@@ -0,0 +1,6 @@
+{
+  "topic": "ai browser automation",
+  "days": 30,
+  "sourceSelection": "auto",
+  "mode": "context"
+}

package/skills/opendevbrowser-research/examples/sample-output.md

@@ -0,0 +1,4 @@
+# Sample Output
+
+1. Example finding one
+2. Example finding two

package/skills/opendevbrowser-research/scripts/render-output.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 2 ]]; then
+  echo "Usage: render-output.sh <topic> <mode>"
+  exit 1
+fi
+
+TOPIC="$1"
+MODE="$2"
+
+opendevbrowser research run --topic "$TOPIC" --mode "$MODE"

package/skills/opendevbrowser-research/scripts/run-research.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: run-research.sh <topic> [days] [mode] [source-selection] [sources]"
+  exit 1
+fi
+
+TOPIC="$1"
+DAYS="${2:-30}"
+MODE="${3:-context}"
+SOURCE_SELECTION="${4:-}"
+SOURCES="${5:-}"
+
+cmd=(opendevbrowser research run --topic "$TOPIC" --days "$DAYS" --mode "$MODE")
+if [[ -n "$SOURCE_SELECTION" ]]; then
+  cmd+=(--source-selection "$SOURCE_SELECTION")
+fi
+if [[ -n "$SOURCES" ]]; then
+  cmd+=(--sources "$SOURCES")
+fi
+
+"${cmd[@]}"

package/skills/opendevbrowser-research/scripts/validate-skill-assets.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+skill_file="$root/SKILL.md"
+
+required=(
+  "artifacts/research-workflows.md"
+  "assets/templates/compact.md"
+  "assets/templates/context.json"
+  "assets/templates/report.md"
+  "scripts/run-research.sh"
+  "scripts/render-output.sh"
+  "scripts/write-artifacts.sh"
+  "scripts/validate-skill-assets.sh"
+)
+
+status=0
+for rel in "${required[@]}"; do
+  if [[ ! -f "$root/$rel" ]]; then
+    echo "Missing required asset: $rel" >&2
+    status=1
+  fi
+  if ! grep -Fq "$rel" "$skill_file"; then
+    echo "SKILL.md missing reference: $rel" >&2
+    status=1
+  fi
+done
+
+for rel in scripts/run-research.sh scripts/render-output.sh scripts/write-artifacts.sh scripts/validate-skill-assets.sh; do
+  if [[ -f "$root/$rel" && ! -x "$root/$rel" ]]; then
+    echo "Script is not executable: $rel" >&2
+    status=1
+  fi
+done
+
+if [[ -f "$root/assets/templates/context.json" ]]; then
+  if ! node -e 'const fs=require("fs"); JSON.parse(fs.readFileSync(process.argv[1], "utf8"));' "$root/assets/templates/context.json" >/dev/null 2>&1; then
+    echo "Invalid JSON template: assets/templates/context.json" >&2
+    status=1
+  fi
+fi
+
+if [[ $status -ne 0 ]]; then
+  exit $status
+fi
+
+echo "Research skill assets validated."

package/skills/opendevbrowser-research/scripts/write-artifacts.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 2 ]]; then
+  echo "Usage: write-artifacts.sh <topic> <output-dir>"
+  exit 1
+fi
+
+TOPIC="$1"
+OUTDIR="$2"
+
+json_output="$(opendevbrowser research run --topic "$TOPIC" --mode path --output-dir "$OUTDIR" --output-format json)"
+printf '%s\n' "$json_output"
+
+artifact_path="$(printf '%s\n' "$json_output" | node -e 'const fs=require("fs");const lines=fs.readFileSync(0,"utf8").split(/\r?\n/).map((line)=>line.trim()).filter(Boolean);let payload=null;for(const line of lines){try{payload=JSON.parse(line);}catch{}}const p=payload?.data?.path; if(typeof p==="string") process.stdout.write(p);')"
+if [[ -z "$artifact_path" || ! -d "$artifact_path" ]]; then
+  manifest_path="$(find "$OUTDIR" -maxdepth 4 -type f -name bundle-manifest.json 2>/dev/null | head -n 1)"
+  if [[ -n "$manifest_path" ]]; then
+    artifact_path="$(dirname "$manifest_path")"
+  fi
+fi
+
+if [[ -z "$artifact_path" || ! -d "$artifact_path" ]]; then
+  echo "Artifact path not found for output dir: $OUTDIR" >&2
+  exit 2
+fi
+
+node -e 'console.log(JSON.stringify({ data: { path: process.argv[1] } }));' "$artifact_path"
+echo "Artifacts ready: $artifact_path"

package/skills/opendevbrowser-shopping/SKILL.md

@@ -0,0 +1,118 @@
+---
+name: opendevbrowser-shopping
+description: Deterministic multi-provider shopping and deal-comparison workflow.
+version: 2.0.0
+---
+
+# Shopping Skill
+
+Use this skill for robust deal hunting across providers with market-baseline validation and savings analysis.
+
+## Pack Contents
+
+- `artifacts/deal-hunting-workflows.md`
+- `assets/templates/deals-context.json`
+- `assets/templates/deals-table.md`
+- `assets/templates/market-analysis.json`
+- `assets/templates/deal-thresholds.json`
+- `scripts/run-shopping.sh`
+- `scripts/normalize-offers.sh`
+- `scripts/render-deals.sh`
+- `scripts/analyze-market.sh`
+- `scripts/run-deal-hunt.sh`
+- `scripts/validate-skill-assets.sh`
+- Shared robustness matrix: `../opendevbrowser-best-practices/artifacts/browser-agent-known-issues-matrix.md`
+
+## Fast Start
+
+```bash
+./skills/opendevbrowser-shopping/scripts/validate-skill-assets.sh
+./skills/opendevbrowser-shopping/scripts/run-shopping.sh "wireless earbuds" context best_deal
+./skills/opendevbrowser-shopping/scripts/run-deal-hunt.sh "wireless earbuds" "shopping/amazon,shopping/walmart"
+```
+
+## Deal-Hunting Model
+
+Use a two-layer check for each offer:
+
+1. Provider discount check
+- Compare listed total to provider anchor price (MSRP/list/original) when available.
+- Capture absolute savings and percentage savings.
+
+2. Market baseline check
+- Compare listed total against cross-provider market average and median.
+- Flag offers that are truly cheaper than market, not just marked "on sale".
+
+## Parallel Multitab Alignment
+
+- Apply shared concurrency policy from `../opendevbrowser-best-practices/SKILL.md` ("Parallel Operations").
+- Validate shopping workflows across `managed`, `extension`, and `cdpConnect` when browser-backed provider paths are exercised.
+- Keep one session per worker for parallel offer collection and avoid session-level target contention.
+
+## Savings Math
+
+Per offer:
+- `total_price = item_price + shipping`
+- `anchor_savings_abs = max(anchor_price - total_price, 0)`
+- `anchor_savings_pct = anchor_savings_abs / anchor_price * 100`
+
+Per market group (same currency):
+- `market_avg = average(total_price)`
+- `market_median = median(total_price)`
+- `market_savings_abs = market_avg - offer_total`
+- `market_savings_pct = market_savings_abs / market_avg * 100`
+
+This captures both:
+- high-percentage discounts (for example 50% off)
+- high-absolute savings (for example $500 saved)
+
+## Robustness Coverage (Known-Issue Matrix)
+
+Matrix source: `../opendevbrowser-best-practices/artifacts/browser-agent-known-issues-matrix.md`
+
+- `ISSUE-06`: rate-limit/backoff handling while collecting offers
+- `ISSUE-09`: dedupe and pagination drift controls in offer collection
+- `ISSUE-10`: currency normalization and same-currency grouping
+- `ISSUE-11`: weak/missing anchor price detection
+- `ISSUE-12`: stale price and unsupported claim controls
+
+## Canonical Workflow
+
+1. Run shopping search across selected providers.
+2. Normalize offers into stable records.
+3. Compute market analysis with `analyze-market.sh`.
+4. Render markdown/json summary for user decision.
+
+```bash
+opendevbrowser shopping run --query "<query>" --providers shopping/amazon,shopping/walmart --mode json --output-format json
+```
+
+## Classification Heuristics
+
+Default tags from analysis script:
+- `high_percent` when anchor discount percent exceeds threshold.
+- `high_absolute` when anchor discount absolute exceeds threshold.
+- `high_value` when both are true.
+- `market_beating` when offer is materially below market average.
+
+Threshold defaults are in `assets/templates/deal-thresholds.json`.
+
+Confidence model:
+- score combines sample size, anchor coverage, and freshness coverage.
+- warnings call out low-sample, missing-anchor, and stale/missing timestamp risk.
+
+## Good Deal Decision Rules
+
+Mark as strong only when at least one is true:
+- anchor discount is material and market gap is positive
+- market price is materially below average/median even without anchor
+
+Avoid false positives:
+- anchor discount exists but market total is not competitive
+- low total due to unavailable stock or hidden constraints
+
+## References
+
+- FTC Guides Against Deceptive Pricing (16 CFR 233): https://www.ecfr.gov/current/title-16/chapter-I/subchapter-B/part-233
+- NIST SP 1181 (unit pricing and value comparison): https://www.nist.gov/publications/unit-pricing-guide
+- Schema.org Offer (price metadata): https://schema.org/Offer