ENGINEERED · FROZEN 2026 · System Creator & AI Architect

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.

48,000+
B2B Leads Processed Across 21 Countries
30+ Mods
Isolated Python Discovery, Scoring & Safety Suite
110/110
Outreach Studio + Cockpit + Pishro Automated Tests Passing

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)

DISCOVERY · 21 COUNTRIES 85-Query Matrix & 9-Signa… Python · 30+ Modules · SSRF SAFETY · DOMAIN SHIELD Primary Brand Shield & Fr… studio_safety.py · SenderFre SEQUENCES · FACTS GATE A/B Sequence & NEVER-CLAI… studio_campaigns.py · FACTS. TRIAGE · UNIBOX CRM 3-Pane Unibox & 6-Stage D… AI Intent Classifier · Atomi ANALYTICS · COCKPIT 12-Page Read-Only Telemet… 14 Read-Only Handlers · p95
DISCOVERY · 21 COUNTRIES Python · 30+ Modules · SSRF Guard · MX/Phone Check

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

01

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.

02

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.

03

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).

04

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

06 — Deterministic Quality Gate Ledger

Historical Scale Processed ✓ 48,000+ B2B Leads · 21 Countries
Live Outbound Freeze Gate ✓ Inactive Since 2026-11-06 · 0 Live Sends
Outreach + Cockpit Tests ✓ 19/19 + 62/62 + 29/29 Automated PASS
Playwright UI Audit ✓ 15 Screens @ 1440px & 390px · 0px Overflow