# lovelace

*A beautiful, enticing, lace-clad system for tracking creator leads — and the
letters we send to lure them into putting their content on Glitch University.*

Named for Ada: the first programmer, in lace. **lovelace** is the Phase 3 engine
of the WP6 influencer campaign — it remembers **who we wrote to, at which address,
what we said, who wrote back, and how close each creator is to a live subtree.**

No server, no dependencies — Python stdlib + a SQLite ledger. The lead data
(emails, PII) stays local and is never committed.

## Install

```bash
pip install -e .          # then `lovelace ...`
# or, without installing:
python3 -m lovelace ...
```

The ledger lives at `~/.lovelace/lovelace.db` (override with `LOVELACE_DB`).

## Use

```bash
lovelace init                                   # open the book

lovelace add --name "Jane Deepdive" --platform youtube \
    --topic "heterodox economics" --email jane@example.com \
    --difficulty low --status shortlist --fit "long-form, paid audience"

lovelace list                                   # the whole book
lovelace list --status shortlist                # filtered
lovelace next                                   # who to approach next (easiest graft first)

lovelace sent 1 --subject "Not a pitch..." --variant quince-A   # log a letter
lovelace reply 1 "Intrigued — what's the split?" --disposition interested
lovelace show 1                                 # full history for one lead

lovelace stats                                  # the funnel
lovelace export --csv leads.csv                 # hand-off / backup
```

## The funnel

`prospect → longlist → shortlist → contacted → replied → onboarding → live`
(plus `declined`). `sent` auto-advances a lead to *contacted*; `reply` to *replied*.

## Roadmap

- **Phase 3 (this):** lead DB + send/reply tracking + funnel. ✅
- **Phase 4:** actually send the emails and handle replies — lovelace already
  records the templates/variants so attribution is ready.