[OSPY] Osprey — Customer service — IVR queues, complaint letters, disputes #4

New issue

Open

opened 2026-02-27 13:53:55 -08:00 by pyr0ball · 0 comments

pyr0ball commented

2026-02-27 13:53:55 -08:00

Owner

Osprey — Customer service hold-line automation + complaint drafting

Repo: https://git.opensourcesolarpunk.com/Circuit-Forge/osprey
Status: Early prototype — FTB dialer built, telephony provider under evaluation
Port: 8520 (API) · 8521 (UI, planned)

What it does

Osprey holds your place in government IVR (interactive voice response) queues so you do not have to. It navigates phone trees via DTMF (dual-tone multi-frequency) signaling, waits on hold, and calls you back when a human answers. It also drafts regulatory complaint letters with correct CFPB/FCC/FTC/state PUC citations, and tracks escalation ladders (CFPB → state AG → small claims).

Milestone Progress

Alpha — Pipeline

Core working: telephony live, Docker deployed, IVR navigates FTB, call bridges to user

#1 FTB dialer: fill in IVR sequence + telephony credentials to go live
#2 Telephony provider setup and credentials configuration
#3 IVR sequence map: California Franchise Tax Board
#4 Hold queue detection and estimated wait time display
#5 Wire Forgejo Actions CI/CD workflows
#6 Docker scaffold + manage.sh
#7 pyproject.toml + cf-core integration
#8 IVR dry-run / simulation mode
#9 Replace /tmp state file IPC with SQLite session store
#10 Test suite: pytest foundation + IVR webhook unit tests

Beta

Feature-complete: Vue UI, multi-agency IVR library, complaint drafting, case tracking, running on Heimdall

#11 Vue frontend: session UI (initiate call, status, history)
#12 Multi-agency IVR library: IRS, SSA, CFPB, state DMVs
#13 Complaint letter drafting: LLM + regulatory citation engine
#14 Case tracking + escalation ladder (CFPB → state AG → small claims)
#15 circuitforge-core integration: db, tiers, llm, config
#16 Heimdall license integration + tier gating

Public Launch

Production-ready: vision module, hardened, docs, free key provisioning

#17 Vision module: screenshot OCR for account portal parsing
#18 Production hardening: error recovery, call monitoring, alerts
#19 User onboarding + help docs
#20 Free key provisioning: website integration + Heimdall auto-issue

Tier Map

Feature	Free	Paid	Premium
IVR hold-line (any agency)	local LLM	✓	✓
Complaint letter drafting	BYOK only	✓ cloud LLM	✓
Case tracking	3 cases	unlimited	unlimited
Vision module (OCR)	—	✓	✓

Key Blockers

Telephony provider signup — SignalWire preferred; see spec in circuitforge-plans/osprey/superpowers/specs/2026-04-04-telephony-backend-design.md (osprey#2)
FTB IVR digit sequence confirmation — needs someone to walk the 800-852-5711 menu (osprey#3)

## Osprey — Customer service hold-line automation + complaint drafting **Repo:** https://git.opensourcesolarpunk.com/Circuit-Forge/osprey **Status:** Early prototype — FTB dialer built, telephony provider under evaluation **Port:** 8520 (API) · 8521 (UI, planned) --- ## What it does Osprey holds your place in government IVR (interactive voice response) queues so you do not have to. It navigates phone trees via DTMF (dual-tone multi-frequency) signaling, waits on hold, and calls you back when a human answers. It also drafts regulatory complaint letters with correct CFPB/FCC/FTC/state PUC citations, and tracks escalation ladders (CFPB → state AG → small claims). --- ## Milestone Progress ### Alpha — Pipeline > Core working: telephony live, Docker deployed, IVR navigates FTB, call bridges to user - #1 FTB dialer: fill in IVR sequence + telephony credentials to go live - #2 Telephony provider setup and credentials configuration - #3 IVR sequence map: California Franchise Tax Board - #4 Hold queue detection and estimated wait time display - #5 Wire Forgejo Actions CI/CD workflows - #6 Docker scaffold + manage.sh - #7 pyproject.toml + cf-core integration - #8 IVR dry-run / simulation mode - #9 Replace /tmp state file IPC with SQLite session store - #10 Test suite: pytest foundation + IVR webhook unit tests ### Beta > Feature-complete: Vue UI, multi-agency IVR library, complaint drafting, case tracking, running on Heimdall - #11 Vue frontend: session UI (initiate call, status, history) - #12 Multi-agency IVR library: IRS, SSA, CFPB, state DMVs - #13 Complaint letter drafting: LLM + regulatory citation engine - #14 Case tracking + escalation ladder (CFPB → state AG → small claims) - #15 circuitforge-core integration: db, tiers, llm, config - #16 Heimdall license integration + tier gating ### Public Launch > Production-ready: vision module, hardened, docs, free key provisioning - #17 Vision module: screenshot OCR for account portal parsing - #18 Production hardening: error recovery, call monitoring, alerts - #19 User onboarding + help docs - #20 Free key provisioning: website integration + Heimdall auto-issue --- ## Tier Map | Feature | Free | Paid | Premium | |---------|------|------|---------| | IVR hold-line (any agency) | local LLM | ✓ | ✓ | | Complaint letter drafting | BYOK only | ✓ cloud LLM | ✓ | | Case tracking | 3 cases | unlimited | unlimited | | Vision module (OCR) | — | ✓ | ✓ | --- ## Key Blockers 1. Telephony provider signup — SignalWire preferred; see spec in `circuitforge-plans/osprey/superpowers/specs/2026-04-04-telephony-backend-design.md` (osprey#2) 2. FTB IVR digit sequence confirmation — needs someone to walk the 800-852-5711 menu (osprey#3)