Connection Nest

The Connection Nest is the revenue layer of Owl’s Roost — the nest that turned AI Unleashed into a cash-printing connection mastermind, ported into software. Every member runs a five-stage pipeline (pending → contacted → meeting scheduled → proposal sent → closed-won) enforced by a state machine, with every transition writing a `ConnectionStatusHistory` row for full audit and firing the right side effects: emails to both parties, in-app notifications, dashboard counter increments, badge eligibility checks, and webhook events for any external integration listening.

When a member sends a connection, the platform drafts a warm intro using both members’ profiles, the contact’s stated need, and the leader’s tone. The draft is editable; once sent, it’s cached so opening the same connection later is instant. A `closed_won` transition automatically calculates commission from the deal value, creates a `ConnectionReward`, opens a `Payout` (`pending` → `scheduled` → `paid`), sends a "deal closed" email, and fires the notification — all in one transaction so state never drifts.

On top of the pipeline sits Connection Party® — a timed group-matching event where members are paired into reciprocal introductions, with cross-tenant matches tracked as `ConnectionPartyMatch` records. Every member also gets a personal CRM that supports adding `CrmContact` records by source (Fathom, LinkedIn, Instagram, phone, community, manual), connecting external tools via `IntegrationConnection`, and an importable CSV — plus a network graph of who has referred whom. Admins get a connection-network dashboard with aggregate stats, a payout management queue, top referrers, and conversion-by-stage funnels.