LeadGen Machine & Outreach Studio
Multi-tenant Python B2B discovery engine, Iran B2B Pishro suite, and internal Instantly-class Outreach Studio — engineered with hard sender-freeze safety.
01 — The Operational Problem & Stakes
Scaling B2B customer acquisition across international export corridors and domestic industrial manufacturers requires two things off-the-shelf SaaS tools rarely combine: deep domain-specific lead enrichment (checking whether an exporter actually needs a website upgrade or corridor compliance) and ruthless sender-reputation protection.
Following early automated runs that processed 48,000+ leads across 21 countries (62,062 total records in `master.db`), internal review of early runs showed raw high-volume cold outreach yielded low reply rates (~0.08% observed vs. a ~3.43% industry benchmark estimate) — prompting an immediate owner-ordered outbound freeze on Nov 6, 2026 (`0` sends) and a ground-up architectural evolution toward precision quality.
02 — System Architecture & Execution
The LeadGen repository (`hamidmehrani/leadgen-machine`, 492-module test discipline) now encompasses three verified engineering pillars while keeping live production sending strictly locked at `0`: (1) the 30+ module discovery & 85-query-matrix qualification core, (2) **Pishro AI (`LG-PISHRO-IRAN-V1`)** featuring Iranian 11-digit national ID checksum validation, 31 provincial area codes, 12 industrial sector scorers, and a 12-page read-only insights cockpit (`p95 = 12.64ms`), and (3) **Exvorta Outreach Studio (`LG-OUTREACH-STUDIO-V1`)**.
Exvorta Outreach Studio is a pure-white internal Instantly.ai replacement featuring a 9-signal Website Redesign Scanner (`Redesign Need 0–100`), sister-domain DNS doctor (`SPF/DKIM/DMARC`), stepped warmup engine, `NEVER-CLAIM` fact validator reading each tenant’s `FACTS.md`, 3-pane Unibox, and a hard `SenderFreezeError` lock ensuring zero accidental live dispatches.
03 — Interactive Subsystem Topology (Click Any Node)
85-Query Matrix & 9-Signal Scanner
Discovers B2B exporters (auto-excluding sanctioned/US jurisdictions where applicable) and scores website redesign need 0–100.
04 — Key Engineering Decisions & Trade-Offs
Honest Engineering: Freezing Volume When Data Says Stop
When telemetry showed bulk sequences underperforming industry reply benchmarks, live daemons were frozen immediately (`0` sends since Nov 6, 2026) and monitor scripts were rewired to alert-only so daemons never self-restart.
Out-of-Repo Credential & Database Isolation
`studio_db.py` stores workspace SQLite files under `~/.local/share/leadgen-outreach/` and credentials in `0600` files outside SQLite and Git, plus CSV formula-injection sanitization.
Deterministic `FACTS.md` Guardrails Over Raw Prompting
Every tenant (`exvorta_web`, `firoza`, `iran_b2b`) carries machine-checked `NEVER-CLAIM` rules and currency locks (e.g., mandatory `0.0` price floor on unpriced Firoza lots).
Sub-13ms p95 Read-Only Analytics
14 read-only insight handlers tested at `p95 = 12.64 ms` with `< 250 KB` gzipped frontend assets.
05 — Verified Build, Test & Runtime Proof
$ CARD_RISK=R1 bash scripts/agent/gate.sh (leadgen-machine @ 53ed7920, verified 2026-11-18)
✓ Outreach Studio unit suite: 19/19 PASS | Cockpit suite: 62/62 PASS (p95 = 12.64 ms)
✓ Iran B2B Pishro suite: 29/29 PASS | SenderBridge default: SenderFreezeError [LOCKED]
✓ Live server check (hamesu-new): leadgen-exvorta=inactive · leadgen-firoza=inactive · 0 sends