feat(leads): charge for lead generation, then sell it

[ralyodio]

The thing that was actually broken

LEAD_RUN_CREDITS was defined and never read:

$ rg LEAD_RUN_CREDITS
lib/credits.ts:36:export const LEAD_RUN_CREDITS = 3;

One hit. The declaration. Every campaign tick and every manual search has been free, and the expensive part is not the model — it's the search calls behind contact lookup. The one-shot finder was the wider hole: it budgeted up to 100 paid lookups per click and charged nothing.

So the meter goes in before the sales page, not after it.

Charging a tick that doesn't know yet what it will do

Charged once, lazily, at the first stage that actually reaches for search or a model.

• Up-front billing would cost 288 credits/day to leave an idle campaign switched on (one tick per 15 min).
• The cron can't know what a tick will do until it looks — a prospect whose scan hasn't landed costs nothing to skip, so the gate sits after that check, not before the loop.
• Charged but produced nothing → refunded. Some of it is genuinely spent by then; billing for a run with no output is the worse trade.
• Out of credits → the campaign stops and says so in the run history, the only place a stalled campaign gets to explain itself.

The manual finder is priced by size

Per hundred leads asked for, and the search budget scales with it:

Asked for	Credits	Paid lookups
≤100	3	10
1,000	30	100

Sizing the budget by the request instead is exactly what let a 1,000-lead run buy 100 lookups for the price of 10.

The size picker now goes to 1,000 to match — it was still offering 5/10/25 against an action that already accepted 1k, so a directory page reported a fraction of itself and looked broken.

Pure pricing moved to lib/credits.ts beside the other prices rather than next to the deduction, so the form can show the cost before the click without pulling a database client into the browser bundle.

Then the selling

• /lead-generation — the feature page
• A card on the home module grid (ModuleCard grew an optional href; cards without one stay non-clickable rather than eight of nine looking live and doing nothing)
• Footer link
• A "what else credits buy" section on /pricing, which until now priced only scans

Two claims the page deliberately doesn't make: open tracking and automatic reply detection. Neither is built.

The guard reads the source

A unit test of manualRunPrice would have passed for the entire time the price was unreferenced. The bug was that nobody called it — so four tests assert the call sites exist.

Checks

• tsc --noEmit clean · 966 tests pass (17 new) · build compiles, /lead-generation renders
• Migration credits_spent on outreach_campaign_runs applied to prod

Heads-up: two active campaigns on the account start drawing down a 1,760-credit balance once this lands.

🤖 Generated with Claude Code

[github-actions]

vu1nz Security Review

0 finding(s) in PR #?

No security issues found.