commit 3c98abacd4b2e2d7b8aab973b2d8624a0e63ac54 Author: pyr0ball Date: Mon May 11 06:22:19 2026 -0700 docs: initial product stub 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 new file mode 100644 index 0000000..32c989b --- /dev/null +++ b/README.md @@ -0,0 +1,47 @@ +# Kestrel — Government Appointment Booking + +> *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 + +Kestrel monitors appointment availability at government offices — DMV, passport agencies, Social Security offices, USCIS Application Support Centers, courts — and auto-books the moment a slot opens. Sends reminders with a checklist of required documents. + +The kestrel hovers perfectly still in the air before diving with precision. That's the metaphor: watch and wait, then strike the instant an appointment opens. + +## Why it's hard + +Government appointment systems are: +- Chronically overbooked (passport offices, USCIS biometrics) +- Updated sporadically — cancellations open and fill in minutes +- Scattered across different booking systems (Login.gov, agency-specific portals, state DMV sites) +- Unforgiving of missed appointments (back to the queue) + +## Core pipeline + +``` +Configure target agency + deadline urgency +→ Monitor booking portal (polling + change detection) +→ Alert when slot opens → Auto-book if within preferences +→ Send confirmation + document checklist reminder +``` + +## Key differentiators vs. Peregrine + +- Time-critical real-time monitoring vs. batch job discovery +- Booking automation: Playwright form-fill on detected availability +- Document checklist generator: per-appointment-type required docs +- Multi-office monitoring: find the closest available slot across locations + +## Product code (license key) + +`CFG-KSTR-XXXX-XXXX-XXXX` + +## Tech notes + +- Shared `circuitforge-core` scaffold +- Appointment monitor: background daemon with configurable poll interval +- Portal adapters: Login.gov, USCIS, individual state DMV systems +- Playwright for form submission on slot detection +- Push notifications: ntfy.sh / Pushover / email alert on slot found