Skip to content

Autonomous AI sales agent powered by Claude Code or Codex. Finds prospects, writes cold emails, sends campaigns, handles replies, books meetings. No API keys needed — runs on your Claude or Codex subscriptions.

Release 0.2.0: add a changelog

Ethan08051f64016b
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..4c259d8
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,113 @@
+# Changelog
+
+Notable changes to Harvey. Dates are release dates; the format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) loosely and versions
+follow [semver](https://semver.org/), with the caveat that Harvey is pre-1.0 and
+minor versions can still change behaviour.
+
+## [0.2.0] — 2026-09-13
+
+The release that made Harvey worth running. The previous version could write
+and send email but could not reliably find anyone to send it to, and it needed
+a paid third-party platform to send at all. Both are fixed.
+
+### Added
+
+- **A prospecting pipeline that works.** Four stages, each independently
+ runnable and re-runnable: DISCOVER (who exists) → PROFILE (what they are) →
+ ENRICH (who decides) → VERIFY (can you reach them).
+- **DISCOVER, with a provider menu.** Four sources behind one adapter
+ interface, shown side by side in the dashboard with what each does, what it
+ costs, its free tier and which keys it needs. The default — OpenStreetMap —
+ needs no account, no card and no key, so the whole pipeline can be run
+ before paying anyone. `harvey discover`.
+- **Cost discipline in the collector.** Every discovery run estimates before it
+ spends, refuses to start over your cap, re-checks the cap between batches,
+ reads a kill switch, and flushes observations per batch so a run that dies
+ keeps what it learned. `harvey discover --estimate` prints the projection and
+ exits.
+- **PROFILE.** Free — three HTTP requests per business, no browser, no model
+ call. Reads the incumbent agency out of the site footer, ad pixels, missing
+ schema, abandoned blogs, open roles and named people. Chained onto DISCOVER
+ and run on every heartbeat. `harvey profile`.
+- **A signal catalog you confirm.** Harvey knows how to collect 23 signals and
+ collects none of them until a human says so. Each shows a plain-language
+ description, what it costs, and how many companies already carry it.
+ `harvey signals`.
+- **The cohort builder.** Pick what a prospect must have and what disqualifies
+ them; see the matching companies live. A prospect list is a query you can
+ explain, not a file.
+- **Native mail providers.** Gmail (REST + OAuth) and any SMTP+IMAP mailbox.
+- **The outbox approval ladder.** Every outgoing email waits for approval by
+ default (`pending_review → approved → sent`), reviewed one at a time in a
+ decisions desk with `A`/`R`/`J`/`K`. A deterministic pre-send gate — no model
+ involved — rejects unrendered merge tags, banned phrases, over-length bodies,
+ too many links, HTML, undeliverable addresses and recipient mismatches.
+- **Bounce handling and a kill switch.** A bounce marks the address invalid,
+ cancels that prospect's queued sends, and trips a global pause past a
+ configured bounce rate. `harvey sending pause|resume`.
+- **Claude usage tracking.** Per-call attribution by agent, task and model, plus
+ live subscription-quota gauges read the same way `/usage` does, so Harvey
+ throttles itself and leaves headroom for your own interactive work.
+ `harvey usage`.
+- **CSV export.** `harvey export` writes a sequencer-ready list. Harvey is worth
+ running as a list-builder even if you never let it send.
+- **A dashboard worth looking at.** Opens on Today — what needs a human — with
+ an activity feed and a rail of pipeline figures, collector runs and setup.
+ Light and dark are the same design re-tokenised; appearance follows your OS by
+ default. Fonts are vendored so it renders with the network off.
+- **A Python version guard.** `python3 -m venv` on macOS builds from the system
+ 3.9, which cannot run Harvey. It now fails immediately with the fix instead of
+ surfacing later as an unrelated-looking ImportError.
+
+### Changed
+
+- **The data model.** Every fact Harvey learns is now an observation — a row in
+ `observations`, never a column. A new signal needs no migration, re-observing
+ over time is a free time series, and confidence and provenance travel with the
+ fact. The vocabulary is governed: a database trigger rejects any signal code
+ not in `signal_codes`.
+- **Email finding is pattern-first.** Harvey derives the domain's address format
+ and verifies one candidate rather than brute-forcing name variations, and
+ grades every address honestly as `verified` / `risky` / `guess` / `invalid`.
+ Only deliverable addresses are ever sent to.
+- **The default mail provider** is now `gmail`. Instantly is still supported as
+ a legacy option.
+- **Discovery depth defaults to 30, not 100.** Google removed
+ 100-results-per-page in September 2025, so depth 100 is now billed as ten
+ pages nearly everywhere — and below rank 30 it is mostly directories.
+- **The dashboard's HTML, CSS and JS** are real files in `harvey/web/` instead
+ of a 1,500-line string literal in `dashboard.py`. Still no build step.
+
+### Fixed
+
+- **Guessed emails were being reported as verified** whenever the domain merely
+ had an MX record. The migration downgrades every legacy `email_verified=1` row
+ to `guess`.
+- **Cohorts counted the wrong companies.** PROFILE records a false boolean when
+ it checks and finds nothing — which is correct — but `cohort()` matched on the
+ row existing, so "companies running Google Ads" silently meant "companies we
+ checked for Google Ads", which was all of them. Cohorts now read the newest
+ observation per company and signal, and require it to be true.
+- **Usage tracking counted every Claude session on the machine**, not just
+ Harvey's. The transcript reconciler is gone; the ledger contains only rows
+ Harvey's own Brain wrote.
+- **Page titles were being extracted as people** ("Request Service", "Commercial
+ Services"), and titles bled between team members.
+- **Confirming a signal before anything had loaded the catalog** reported success
+ while changing nothing.
+- **The free OSM provider answered unmapped search terms with every registered
+ office in the area** — coffee roasters and churches for a roofing query. It now
+ refuses the query and names the trades it can search.
+
+### Security
+
+- Test fixtures no longer carry real businesses' phone numbers or street
+ addresses.
+- `harvey.local.yaml` (gitignored) overrides the tracked `harvey.yaml`, so a
+ fork can hold real product configuration without it reaching a public repo.
+
+## [0.1.0]
+
+Initial release: the heartbeat loop, five sub-agents, the skills library, the
+website trainer, Instantly-based sending, and the first dashboard.