From 4977e517feb651ad6410c8d408a82d47ca58f883 Mon Sep 17 00:00:00 2001 From: pyr0ball Date: Wed, 25 Mar 2026 13:07:05 -0700 Subject: [PATCH] =?UTF-8?q?feat:=20Snipe=20MVP=20v0.1=20=E2=80=94=20eBay?= =?UTF-8?q?=20trust=20scorer=20with=20faceted=20filter=20UI?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- PRIVACY.md | 7 +++++ README.md | 75 ++++++++++++++++++++++++++++++++++++++++++++++++++++-- 2 files changed, 80 insertions(+), 2 deletions(-) create mode 100644 PRIVACY.md diff --git a/PRIVACY.md b/PRIVACY.md new file mode 100644 index 0000000..afc7b9f --- /dev/null +++ b/PRIVACY.md @@ -0,0 +1,7 @@ +# Privacy Policy + +CircuitForge LLC's privacy policy applies to this product and is published at: + +**** + +Last reviewed: March 2026. diff --git a/README.md b/README.md index 958b008..19deac0 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,74 @@ -# snipe +# Snipe — Auction Sniping & Bid Management -snipe by Circuit Forge LLC — Auction sniping — CT Bids, antiques, estate auctions, eBay \ No newline at end of file +> *Part of the Circuit Forge LLC "AI for the tasks you hate most" suite.* + +**Status:** Backlog — not yet started. Peregrine must prove the model first. + +## What it does + +Snipe manages online auction participation: monitoring listings across platforms, scheduling last-second bids, tracking price history to avoid overpaying, and managing the post-win logistics (payment, shipping coordination, provenance documentation for antiques). + +The name is the origin of the word "sniping" — common snipes are notoriously elusive birds, secretive and camouflaged, that flush suddenly from cover. Shooting one required extreme patience, stillness, and a precise last-second shot. That's the auction strategy. + +## Primary platforms + +- **CT Bids** — Connecticut state surplus and municipal auctions +- **GovPlanet / IronPlanet** — government surplus equipment +- **AuctionZip** — antique auction house aggregator (1,000+ houses) +- **Invaluable / LiveAuctioneers** — fine art and antiques +- **Bidsquare** — antiques and collectibles +- **eBay** — general + collectibles +- **HiBid** — estate auctions +- **Proxibid** — industrial and collector auctions + +## Why it's hard + +Online auctions are frustrating because: +- Winning requires being present at the exact closing moment — sometimes 2 AM +- Platforms vary wildly: some allow proxy bids, some don't; closing times extend on activity +- Price history is hidden — you don't know if an item is underpriced or a trap +- Shipping logistics for large / fragile antiques require coordination with auction house +- Provenance documentation is inconsistent across auction houses + +## Core pipeline + +``` +Configure search (categories, keywords, platforms, max price, location) +→ Monitor listings → Alert on matching items +→ Human review: approve or skip +→ Price research: comparable sales history, condition assessment via photos +→ Schedule snipe bid (configurable: X seconds before close, Y% above current) +→ Execute bid → Monitor for counter-bid (soft-close extension handling) +→ Win notification → Payment + shipping coordination workflow +→ Provenance documentation for antiques +``` + +## Bidding strategy engine + +- **Hard snipe**: submit bid N seconds before close (default: 8s) +- **Soft-close handling**: detect if platform extends on last-minute bids; adjust strategy +- **Proxy ladder**: set max and let the engine bid in increments, reserve snipe for final window +- **Reserve detection**: identify likely reserve price from bid history patterns +- **Comparable sales**: pull recent auction results for same/similar items across platforms + +## Post-win workflow + +1. Payment method routing (platform-specific: CC, wire, check) +2. Shipping quote requests to approved carriers (for freight / large items) +3. Condition report request from auction house +4. Provenance packet generation (for antiques / fine art resale or insurance) +5. Add to inventory (for dealers / collectors tracking portfolio value) + +## Product code (license key) + +`CFG-SNPE-XXXX-XXXX-XXXX` + +## Tech notes + +- Shared `circuitforge-core` scaffold +- Platform adapters: AuctionZip, Invaluable, HiBid, eBay, CT Bids (Playwright + API where available) +- Bid execution: Playwright automation with precise timing (NTP-synchronized) +- Soft-close detection: platform-specific rules engine +- Comparable sales: scrape completed auctions, normalize by condition/provenance +- Vision module: condition assessment from listing photos (moondream2 / Claude vision) +- Shipping quote integration: uShip API for freight, FedEx / UPS for parcel