lovelace v0.1 — lace-clad lead tracker for Glitch University outreach

Standalone Python CLI + SQLite (stdlib only). Tracks creator leads, which
letters went to which address, replies, and the funnel (prospect → … → live).
Commands: init/add/list/show/set/note/sent/reply/next/stats/export. Lead data
(emails/PII) stays local and is gitignored.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

README.md

@@ -0,0 +1,53 @@
+# 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.