opendevbrowser 0.0.12 → 0.0.16

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

package/skills/opendevbrowser-shopping/artifacts/deal-hunting-workflows.md

@@ -0,0 +1,37 @@
+# Deal Hunting Workflows
+
+## Baseline deal workflow
+
+1. Query providers
+2. Normalize offers
+3. Compute market averages/medians
+4. Rank by true savings
+5. Attach confidence tier and warnings per currency group
+
+## Cross-provider verification workflow
+
+1. Start from discounted listing
+2. Query same product across alternate providers
+3. Compare totals in same currency
+4. Report verified savings and confidence
+
+## High-value prioritization workflow
+
+1. Compute percent discount
+2. Compute absolute savings
+3. Tag high-value if both thresholds pass
+4. Present top-ranked offers first
+
+## Anchor reliability workflow
+
+1. Detect whether anchor/list price exists per offer
+2. Compute anchor coverage by currency group
+3. Distinguish anchor-only discounts from market-beating discounts
+4. Warn when anchor evidence is weak
+
+## Freshness workflow
+
+1. Capture offer retrieval timestamp when available
+2. Compute price age hours
+3. Flag stale or missing timestamps
+4. Lower confidence tier when freshness coverage is low

package/skills/opendevbrowser-shopping/assets/templates/deal-thresholds.json

@@ -0,0 +1,8 @@
+{
+  "high_percent_threshold": 40,
+  "high_absolute_threshold": 100,
+  "min_market_gap_percent": 5,
+  "min_offer_count_for_confidence": 3,
+  "max_price_age_hours_for_freshness": 24,
+  "min_anchor_coverage_for_confidence": 0.5
+}

package/skills/opendevbrowser-shopping/assets/templates/deals-context.json

@@ -0,0 +1,9 @@
+{
+  "query": "",
+  "highlights": [],
+  "offers": [],
+  "market": {
+    "currency_summaries": []
+  },
+  "meta": {}
+}

package/skills/opendevbrowser-shopping/assets/templates/deals-table.md

@@ -0,0 +1,4 @@
+# Deals Table
+
+| Provider | Product | Total | Market Avg Gap | Anchor Discount | Deal Score |
+|---|---|---:|---:|---:|---:|

package/skills/opendevbrowser-shopping/assets/templates/market-analysis.json

@@ -0,0 +1,30 @@
+{
+  "generated_at": "",
+  "offers_count": 0,
+  "currency_summaries": [
+    {
+      "currency": "USD",
+      "offer_count": 0,
+      "market_average_total": 0,
+      "market_median_total": 0,
+      "best_offer": {
+        "provider": "",
+        "title": "",
+        "total": 0
+      },
+      "confidence": {
+        "score": 0,
+        "tier": "low",
+        "sample_size": 0,
+        "anchor_coverage": 0,
+        "fresh_price_coverage": 0,
+        "warnings": []
+      },
+      "savings_vs_market_average": {
+        "absolute": 0,
+        "percent": 0
+      },
+      "top_discounts": []
+    }
+  ]
+}

package/skills/opendevbrowser-shopping/examples/sample-deals.md

@@ -0,0 +1,4 @@
+# Sample Deals
+
+1. Provider A - $49.99
+2. Provider B - $52.00

package/skills/opendevbrowser-shopping/examples/sample-query.json

@@ -0,0 +1,5 @@
+{
+  "query": "wireless earbuds",
+  "sort": "best_deal",
+  "mode": "context"
+}

package/skills/opendevbrowser-shopping/scripts/analyze-market.sh

@@ -0,0 +1,307 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: analyze-market.sh <shopping-json-file> [json|md] [thresholds-json-file]" >&2
+  exit 1
+fi
+
+input="$1"
+mode="${2:-json}"
+script_root="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+default_thresholds="$script_root/../assets/templates/deal-thresholds.json"
+thresholds_file="${3:-$default_thresholds}"
+
+node - "$input" "$mode" "$thresholds_file" <<'NODE'
+const fs = require("fs");
+
+const inputPath = process.argv[2];
+const mode = process.argv[3] || "json";
+const thresholdsPath = process.argv[4];
+
+const nowMs = Date.now();
+
+const defaults = {
+  high_percent_threshold: 40,
+  high_absolute_threshold: 100,
+  min_market_gap_percent: 5,
+  min_offer_count_for_confidence: 3,
+  max_price_age_hours_for_freshness: 24,
+  min_anchor_coverage_for_confidence: 0.5
+};
+
+const asNumber = (value, fallback = 0) => {
+  const parsed = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(parsed) ? parsed : fallback;
+};
+
+const round2 = (value) => Number(value.toFixed(2));
+
+const parseTimestamp = (value) => {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    const ms = value < 1e12 ? value * 1000 : value;
+    const dt = new Date(ms);
+    return Number.isFinite(dt.getTime()) ? dt : null;
+  }
+  if (typeof value !== "string" || value.trim() === "") return null;
+  const dt = new Date(value);
+  return Number.isFinite(dt.getTime()) ? dt : null;
+};
+
+const readThresholds = (filePath) => {
+  if (!filePath || !fs.existsSync(filePath)) return { ...defaults };
+  try {
+    const parsed = JSON.parse(fs.readFileSync(filePath, "utf8"));
+    return {
+      high_percent_threshold: asNumber(parsed.high_percent_threshold, defaults.high_percent_threshold),
+      high_absolute_threshold: asNumber(parsed.high_absolute_threshold, defaults.high_absolute_threshold),
+      min_market_gap_percent: asNumber(parsed.min_market_gap_percent, defaults.min_market_gap_percent),
+      min_offer_count_for_confidence: Math.max(1, asNumber(parsed.min_offer_count_for_confidence, defaults.min_offer_count_for_confidence)),
+      max_price_age_hours_for_freshness: Math.max(1, asNumber(parsed.max_price_age_hours_for_freshness, defaults.max_price_age_hours_for_freshness)),
+      min_anchor_coverage_for_confidence: Math.min(1, Math.max(0, asNumber(parsed.min_anchor_coverage_for_confidence, defaults.min_anchor_coverage_for_confidence)))
+    };
+  } catch {
+    return { ...defaults };
+  }
+};
+
+const readAnchor = (offer) => {
+  const attrs = offer && typeof offer === "object" ? (offer.attributes || {}) : {};
+  const candidates = [
+    attrs.list_price,
+    attrs.original_price,
+    attrs.msrp,
+    attrs?.shopping_offer?.list_price,
+    attrs?.shopping_offer?.original_price,
+    attrs?.shopping_offer?.msrp
+  ];
+
+  for (const candidate of candidates) {
+    if (typeof candidate === "number") return candidate;
+    if (candidate && typeof candidate === "object") {
+      const amount = asNumber(candidate.amount);
+      if (amount > 0) return amount;
+    }
+    const parsed = asNumber(candidate);
+    if (parsed > 0) return parsed;
+  }
+  return 0;
+};
+
+const readRetrievedAt = (offer) => {
+  const attrs = offer && typeof offer === "object" ? (offer.attributes || {}) : {};
+  const candidates = [
+    offer?.retrieved_at,
+    offer?.retrievedAt,
+    offer?.captured_at,
+    offer?.capturedAt,
+    attrs.retrieved_at,
+    attrs.retrievedAt,
+    attrs.captured_at,
+    attrs.capturedAt,
+    attrs?.shopping_offer?.retrieved_at,
+    attrs?.shopping_offer?.captured_at
+  ];
+
+  for (const candidate of candidates) {
+    const parsed = parseTimestamp(candidate);
+    if (parsed) return parsed;
+  }
+  return null;
+};
+
+const pickOffers = (payload) => {
+  if (Array.isArray(payload?.offers)) return payload.offers;
+  if (Array.isArray(payload?.data?.offers)) return payload.data.offers;
+  if (Array.isArray(payload?.context?.offers)) return payload.context.offers;
+  if (Array.isArray(payload?.data?.context?.offers)) return payload.data.context.offers;
+  return [];
+};
+
+const median = (values) => {
+  if (values.length === 0) return 0;
+  const sorted = [...values].sort((a, b) => a - b);
+  const mid = Math.floor(sorted.length / 2);
+  if (sorted.length % 2 === 0) return (sorted[mid - 1] + sorted[mid]) / 2;
+  return sorted[mid];
+};
+
+const payload = JSON.parse(fs.readFileSync(inputPath, "utf8"));
+const thresholds = readThresholds(thresholdsPath);
+
+const offers = pickOffers(payload).filter((offer) => offer && typeof offer === "object");
+const rows = offers.map((offer) => {
+  const currency = String(offer?.price?.currency || offer?.currency || "USD").toUpperCase();
+  const item = asNumber(offer?.price?.amount);
+  const shipping = asNumber(offer?.shipping?.amount);
+  const total = item + shipping;
+  const anchor = readAnchor(offer);
+  const retrievedAt = readRetrievedAt(offer);
+  const priceAgeHours = retrievedAt ? (nowMs - retrievedAt.getTime()) / 3600000 : null;
+  const anchorSavingsAbs = anchor > total ? anchor - total : 0;
+  const anchorSavingsPct = anchor > 0 ? (anchorSavingsAbs / anchor) * 100 : 0;
+
+  return {
+    provider: String(offer.provider || "unknown"),
+    title: String(offer.title || "untitled"),
+    url: String(offer.url || ""),
+    currency,
+    total,
+    item,
+    shipping,
+    anchor,
+    anchorSavingsAbs,
+    anchorSavingsPct,
+    dealScore: asNumber(offer?.deal_score),
+    retrievedAt: retrievedAt ? retrievedAt.toISOString() : null,
+    priceAgeHours
+  };
+}).filter((row) => row.total > 0);
+
+const byCurrency = new Map();
+for (const row of rows) {
+  const list = byCurrency.get(row.currency) || [];
+  list.push(row);
+  byCurrency.set(row.currency, list);
+}
+
+const currencySummaries = [];
+for (const [currency, list] of byCurrency.entries()) {
+  const totals = list.map((row) => row.total);
+  const avg = totals.reduce((sum, value) => sum + value, 0) / totals.length;
+  const med = median(totals);
+
+  const enriched = list.map((row) => {
+    const marketGapAbs = avg - row.total;
+    const marketGapPct = avg > 0 ? (marketGapAbs / avg) * 100 : 0;
+    const tags = [];
+    const flags = [];
+
+    if (row.anchorSavingsPct >= thresholds.high_percent_threshold) tags.push("high_percent");
+    if (row.anchorSavingsAbs >= thresholds.high_absolute_threshold) tags.push("high_absolute");
+    if (marketGapAbs > 0 && marketGapPct >= thresholds.min_market_gap_percent) tags.push("market_beating");
+    if (tags.includes("high_percent") && tags.includes("high_absolute")) tags.push("high_value");
+
+    if (row.anchor <= 0) flags.push("missing_anchor_price");
+    if (row.retrievedAt === null) flags.push("missing_price_timestamp");
+    if (row.priceAgeHours !== null && row.priceAgeHours > thresholds.max_price_age_hours_for_freshness) flags.push("stale_price");
+    if (marketGapAbs <= 0) flags.push("not_below_market_average");
+
+    return {
+      ...row,
+      marketGapAbs,
+      marketGapPct,
+      tags,
+      flags
+    };
+  });
+
+  const sortedBest = [...enriched].sort((a, b) => {
+    const scoreA = a.marketGapAbs + a.anchorSavingsAbs + a.dealScore;
+    const scoreB = b.marketGapAbs + b.anchorSavingsAbs + b.dealScore;
+    return scoreB - scoreA;
+  });
+
+  const topDiscounts = sortedBest.slice(0, 5).map((row) => ({
+    provider: row.provider,
+    title: row.title,
+    total: round2(row.total),
+    market_gap_abs: round2(row.marketGapAbs),
+    market_gap_pct: round2(row.marketGapPct),
+    anchor_savings_abs: round2(row.anchorSavingsAbs),
+    anchor_savings_pct: round2(row.anchorSavingsPct),
+    price_age_hours: row.priceAgeHours === null ? null : round2(row.priceAgeHours),
+    tags: row.tags,
+    flags: row.flags,
+    url: row.url
+  }));
+
+  const best = [...enriched].sort((a, b) => a.total - b.total || b.dealScore - a.dealScore)[0];
+  const savingsVsAvgAbs = avg - best.total;
+  const savingsVsAvgPct = avg > 0 ? (savingsVsAvgAbs / avg) * 100 : 0;
+
+  const anchorCoverage = enriched.filter((row) => row.anchor > 0).length / enriched.length;
+  const freshCoverage = enriched.filter((row) => row.priceAgeHours !== null && row.priceAgeHours <= thresholds.max_price_age_hours_for_freshness).length / enriched.length;
+
+  const sampleScore = Math.min(enriched.length / thresholds.min_offer_count_for_confidence, 1);
+  const anchorScore = thresholds.min_anchor_coverage_for_confidence === 0
+    ? 1
+    : Math.min(anchorCoverage / thresholds.min_anchor_coverage_for_confidence, 1);
+  const freshnessScore = freshCoverage;
+
+  const confidenceScore = (sampleScore * 0.4) + (anchorScore * 0.3) + (freshnessScore * 0.3);
+  const warnings = [];
+  if (enriched.length < thresholds.min_offer_count_for_confidence) warnings.push("low_sample_size");
+  if (anchorCoverage < thresholds.min_anchor_coverage_for_confidence) warnings.push("low_anchor_coverage");
+  if (freshCoverage < 0.5) warnings.push("stale_or_missing_prices");
+
+  let tier = "low";
+  if (confidenceScore >= 0.75) tier = "high";
+  else if (confidenceScore >= 0.5) tier = "medium";
+
+  currencySummaries.push({
+    currency,
+    offer_count: enriched.length,
+    market_average_total: round2(avg),
+    market_median_total: round2(med),
+    best_offer: {
+      provider: best.provider,
+      title: best.title,
+      total: round2(best.total)
+    },
+    confidence: {
+      score: round2(confidenceScore),
+      tier,
+      sample_size: enriched.length,
+      anchor_coverage: round2(anchorCoverage),
+      fresh_price_coverage: round2(freshCoverage),
+      warnings
+    },
+    savings_vs_market_average: {
+      absolute: round2(savingsVsAvgAbs),
+      percent: round2(savingsVsAvgPct)
+    },
+    top_discounts: topDiscounts
+  });
+}
+
+const summary = {
+  generated_at: new Date().toISOString(),
+  offers_count: rows.length,
+  thresholds_used: thresholds,
+  currency_summaries: currencySummaries
+};
+
+if (mode === "md") {
+  const lines = [
+    "# Market Deal Analysis",
+    "",
+    `Offers analyzed: ${summary.offers_count}`,
+    ""
+  ];
+
+  for (const group of summary.currency_summaries) {
+    lines.push(`## ${group.currency}`);
+    lines.push(`- Market average total: ${group.market_average_total.toFixed(2)}`);
+    lines.push(`- Market median total: ${group.market_median_total.toFixed(2)}`);
+    lines.push(`- Best offer: ${group.best_offer.provider} (${group.best_offer.total.toFixed(2)})`);
+    lines.push(`- Savings vs average: ${group.savings_vs_market_average.absolute.toFixed(2)} (${group.savings_vs_market_average.percent.toFixed(2)}%)`);
+    lines.push(`- Confidence: ${group.confidence.tier} (${group.confidence.score.toFixed(2)})`);
+    if (group.confidence.warnings.length > 0) {
+      lines.push(`- Warnings: ${group.confidence.warnings.join(", ")}`);
+    }
+    lines.push("");
+    lines.push("| Provider | Product | Total | Market Gap | Anchor Discount | Age(h) | Tags | Flags |");
+    lines.push("|---|---|---:|---:|---:|---:|---|---|");
+    for (const offer of group.top_discounts) {
+      const age = offer.price_age_hours === null ? "n/a" : offer.price_age_hours.toFixed(2);
+      lines.push(`| ${offer.provider} | ${offer.title} | ${offer.total.toFixed(2)} | ${offer.market_gap_abs.toFixed(2)} (${offer.market_gap_pct.toFixed(2)}%) | ${offer.anchor_savings_abs.toFixed(2)} (${offer.anchor_savings_pct.toFixed(2)}%) | ${age} | ${offer.tags.join(", ")} | ${offer.flags.join(", ")} |`);
+    }
+    lines.push("");
+  }
+
+  process.stdout.write(lines.join("\n"));
+} else {
+  process.stdout.write(JSON.stringify(summary, null, 2));
+}
+NODE

package/skills/opendevbrowser-shopping/scripts/normalize-offers.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: normalize-offers.sh <query> [providers]" >&2
+  exit 1
+fi
+
+query="$1"
+providers="${2:-}"
+
+cmd=(opendevbrowser shopping run --query "$query" --mode json --output-format json)
+if [[ -n "$providers" ]]; then
+  cmd+=(--providers "$providers")
+fi
+
+raw="$(${cmd[@]})"
+printf '%s\n' "$raw" | node -e '
+const fs=require("fs");
+const input=fs.readFileSync(0,"utf8");
+const payload=JSON.parse(input);
+const offers=Array.isArray(payload.offers)?payload.offers
+  : Array.isArray(payload?.data?.offers)?payload.data.offers
+  : Array.isArray(payload?.context?.offers)?payload.context.offers
+  : Array.isArray(payload?.data?.context?.offers)?payload.data.context.offers
+  : [];
+process.stdout.write(JSON.stringify({offers}, null, 2));
+'

package/skills/opendevbrowser-shopping/scripts/render-deals.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: render-deals.sh <shopping-json-file> [json|md]" >&2
+  exit 1
+fi
+
+input="$1"
+mode="${2:-md}"
+
+script_root="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+"$script_root/analyze-market.sh" "$input" "$mode"

package/skills/opendevbrowser-shopping/scripts/run-deal-hunt.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: run-deal-hunt.sh <query> [providers] [output-dir]" >&2
+  exit 1
+fi
+
+query="$1"
+providers="${2:-}"
+outdir="${3:-/tmp/odb-deals-$(date +%s)}"
+mkdir -p "$outdir"
+
+raw_json="$outdir/shopping.raw.json"
+analysis_json="$outdir/market-analysis.json"
+analysis_md="$outdir/market-analysis.md"
+
+cmd=(opendevbrowser shopping run --query "$query" --mode json --output-format json)
+if [[ -n "$providers" ]]; then
+  cmd+=(--providers "$providers")
+fi
+
+"${cmd[@]}" > "$raw_json"
+
+script_root="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+"$script_root/analyze-market.sh" "$raw_json" json > "$analysis_json"
+"$script_root/analyze-market.sh" "$raw_json" md > "$analysis_md"
+
+echo "Deal hunt complete"
+echo "- raw: $raw_json"
+echo "- json analysis: $analysis_json"
+echo "- markdown analysis: $analysis_md"

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

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: run-shopping.sh <query> [mode] [sort] [providers]" >&2
+  exit 1
+fi
+
+query="$1"
+mode="${2:-context}"
+sort="${3:-best_deal}"
+providers="${4:-}"
+
+cmd=(opendevbrowser shopping run --query "$query" --mode "$mode" --sort "$sort")
+if [[ -n "$providers" ]]; then
+  cmd+=(--providers "$providers")
+fi
+
+"${cmd[@]}"