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.mdnew file mode 100644index 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.