offerprinter 0.2.0__tar.gz → 0.4.0__tar.gz

{offerprinter-0.2.0 → offerprinter-0.4.0}/.gitignore

@@ -1,6 +1,8 @@
 # --- OfferPrinter ---
 # Never commit secrets or generated user output.
-config.toml
+# Anchored to the repo root: an unanchored "config.toml" also matches nested
+# files like .streamlit/config.toml, which is checked in on purpose.
+/config.toml
 .env
 output/
 !examples/output/

offerprinter-0.4.0/CHANGELOG.md

@@ -0,0 +1,217 @@
+# Changelog
+
+All notable changes to OfferPrinter are documented here.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.4.0] — 2026-08-25
+
+The "it has to look like something" release. v0.3.0 made the output provable;
+this one makes it presentable, and makes getting your history in a two-minute job
+rather than an afternoon.
+
+### Added
+
+- **Six PDF templates**: `classic`, `compact`, `serif`, `rule`, `accent`, `mono`.
+  Choose with `--template`, list with `offerprinter templates`, and see them with
+  `offerprinter templates --sample ./samples`. Set a default under `[output]` in
+  `config.toml`, or `OFFERPRINTER_TEMPLATE`.
+- **LinkedIn import** (`--linkedin`). Takes either export LinkedIn offers: the PDF
+  from *More → Save to PDF*, or the CSV archive from *Get a copy of your data*.
+  Nothing is scraped and nothing is fetched — you export your own data and this
+  reads the file.
+
+### Notes on the templates
+
+Every template stays inside what an ATS can parse: one of the 14 PDF base fonts,
+no columns, no tables, no images, no text boxes. What varies is typeface, spacing,
+rules, capitalisation and one accent colour. The test suite checks, per template,
+that the PDF embeds no font program, contains no `/Image` or `/XObject`, and that
+a naive text extraction still returns the name, the email and every bullet.
+
+`accent` is labelled *email only*: it extracts cleanly, but carries enough colour
+that a strict parser could lose a heading.
+
+The LinkedIn importer is held to the no-fabrication guarantee too. A test takes
+every word of its output and asserts it appeared in the input, because an importer
+that quietly tidied up your history would break the guarantee before the generator
+ever ran.
+
+### Unchanged
+
+`classic` renders byte-for-byte what v0.3.0 rendered. There is a test for that, so
+upgrading changes nothing unless you ask it to.
+
+## [0.3.0] — 2026-08-20
+
+The "prove it" release. v0.2.0 made OfferPrinter installable; this one makes its
+central claim checkable, and extends the tool across the rest of a job hunt.
+
+### Added
+
+**Proving the guarantee**
+- **Fabrication verifier.** Every number, date and named entity in the tailored
+  CV and cover letter is checked against your source CV, and the tailored CV is
+  cross-checked against the ATS report's own list of gaps — so a package that
+  contradicts itself is caught automatically. Writes `fabrication-check.md`.
+  `--strict` exits 3 if anything is unverified, which makes it usable as a gate.
+  Until now "never fabricate" was an instruction in a prompt; now it is an
+  assertion the tool makes about its own output.
+- **`offerprinter verify`** re-checks an already-generated package — after you
+  have hand-edited it, or in CI. Makes no API calls, so it is free and offline.
+- **Tailoring diff.** `tailoring-diff.md` shows exactly what changed: which
+  bullets were reworded, what was added or dropped, and which vocabulary is new.
+  The verifier proves nothing was invented; the diff shows what was done.
+- **Eval harness** (`evals/`, `scripts/run_evals.py`). Golden cases with
+  per-case assertions about which gaps must be named and which terms must never
+  be claimed, plus an LLM-as-judge pass scoring grounding, specificity, honesty,
+  usefulness and format. The deterministic half runs in CI on every PR; the
+  judge runs on demand. Prompt changes are no longer a guess.
+
+**New commands**
+- **`offerprinter rank`** — score a folder of adverts and rank them by fit
+  without generating a single document. Two cheap calls per job; triage twenty
+  roles for a couple of pence, then print packages only for the ones worth it.
+- **`offerprinter followup`** — thank-you email, recruiter message, LinkedIn
+  note (hard-capped at 300 characters) or a polite nudge. Written from your CV
+  and your notes; it will not invent a conversation that did not happen.
+- **`offerprinter practice`** — an interactive mock interview. It asks, you
+  answer, it critiques and rewrites your answer using only your real experience,
+  then summarises the patterns worth fixing.
+- **`offerprinter mcp`** — run as an MCP server on stdio, so Claude Desktop,
+  Claude Code and other agents can call OfferPrinter natively and get structured
+  results back. Hand-rolled JSON-RPC; no new dependencies.
+- **`offerprinter cache stats` / `cache clear`**.
+
+**Privacy and job-board reality**
+- **PII redaction** (`--redact`). Your name, email, phone and profile links are
+  replaced with placeholders before the provider sees anything, and restored in
+  the output. The model keeps every employer, date and metric it needs.
+- **`--jd-clipboard`** and a **browser extension** (`extension/`). Job boards
+  are the most common reason a run fails; the advert is already rendered in your
+  tab, so read it from there. The extension has no host permissions and makes no
+  network requests.
+- **schema.org `JobPosting` JSON-LD extraction.** Many boards embed the whole
+  advert as structured data — cleaner than anything scraped, and it supplies the
+  company and job title for free.
+
+**Cost**
+- **Response caching.** Keyed on provider, model, temperature and both prompts,
+  so anything that could change the answer correctly misses. Re-running after a
+  CV tweak is now mostly free.
+
+### Fixed
+
+- Multi-word entities could match across a line break, producing nonsense claims
+  glued together from two sentences.
+- A level-two heading (`## Missing keywords`) was not recognised as a sentence
+  start, so its first word was treated as a named entity.
+- A capitalised word at the very start of a bullet ("Used SQL daily") was read
+  as an entity, because the sentence-start pattern only handled bullets that
+  followed a newline, not one at the start of the text.
+
+### Changed
+
+- Config gains `[output] redact`, `[generation] verify`, `diff` and `cache`.
+- The test suite grew from 73 to 143 tests, still fully offline.
+
+
+## [0.2.0] — 2026-08-18
+
+The "actually installable, and quite a lot faster" release.
+
+### Added
+
+**Distribution**
+- Published to PyPI: `pipx install offerprinter`, `uvx offerprinter`, or
+  `pip install offerprinter`.
+- `offerprinter` and `opr` console scripts, so it works from anywhere after
+  install rather than only from a git clone.
+- Standalone binaries for macOS, Linux and Windows attached to each release —
+  no Python installation required.
+- Multi-arch Docker image published to GHCR on every push and tag:
+  `ghcr.io/mohitagw15856/offerprinter:latest`.
+- Homebrew formula in `packaging/homebrew/` for a `brew install` tap.
+- Deployment guides for Streamlit Community Cloud, Hugging Face Spaces, Docker
+  and container platforms, in `deploy/`.
+
+**Features**
+- **Fit score** — every run ends with a 0-100 score, a band, and honest
+  strengths and gaps. Written to `fit-score.md` and shown in the CLI and web UI.
+- **PDF output** — real, selectable, ATS-friendly Helvetica text, written by a
+  dependency-free PDF writer rather than a rendering engine. Enable with
+  `--formats md,docx,pdf`.
+- **Roast mode** — `offerprinter roast --cv cv.pdf`, or `--roast` during a run.
+  Blunt, funny, opt-in critique of your CV's *writing*. Still never dishonest.
+- **Application tracker** — every run is recorded locally in
+  `~/.offerprinter/applications.json`. New commands: `offerprinter list`,
+  `offerprinter stats`, `offerprinter status <slug> <status>`.
+- **Achievements** — eleven small milestones, computed from your local history.
+- **Batch mode** — `--jd-dir ./jobs` prints a package for every job description
+  in a folder.
+- **Cost and token reporting** — every run reports calls, tokens and estimated
+  spend. `--dry-run` forecasts the cost without calling the API at all.
+- **Ollama provider** — run entirely on your own machine with no API key and no
+  data leaving your laptop: `--provider ollama`.
+- **Printer animation** — an ASCII dot-matrix printer feeding a sheet per
+  document. Degrades to plain status lines when not a terminal, or with
+  `--no-animation`.
+- **Demo mode in the web UI** — with no API key configured, the app shows the
+  bundled example package instead of an error, which is what makes a public
+  hosted demo possible.
+
+**Reliability**
+- Automatic retries with exponential backoff and `Retry-After` support on 429s
+  and 5xx errors. A single rate limit no longer kills a five-document run.
+- `[pricing]` config table to override list prices with your actual rates.
+
+**Project**
+- `CONTRIBUTING.md`, `SECURITY.md`, `CODE_OF_CONDUCT.md`, this changelog, issue
+  and pull request templates.
+- CI now runs the test suite across Python 3.11/3.12/3.13 with macOS and Windows
+  spot-checks, plus coverage, a packaging build, and a console-script smoke test.
+
+### Changed
+
+- **Artifacts now generate in parallel.** They are independent of each other, so
+  a full run takes about as long as its slowest single document instead of the
+  sum of all five. Use `--sequential` for the old behaviour.
+- The CLI moved to `offerprinter/cli.py` so it ships inside the installed
+  package. `python cli.py …` still works from a clone.
+- The web UI (`streamlit`) is now an optional extra, keeping
+  `pipx install offerprinter` small. Install it with `offerprinter[web]`.
+- Default output formats remain `md` and `docx`; `pdf` is opt-in via config
+  or `--formats`.
+
+### Fixed
+
+- The `offerprinter` console script pointed at a root-level `cli` module that
+  was never included in the wheel, so it could not resolve after an install.
+- The README claimed CI ran `pytest`. It didn't. Now it does.
+
+## [0.1.0] — 2026-08-18
+
+First release — "First Print".
+
+### Added
+
+- Five generated artifacts from one CV and one job description: tailored CV,
+  cover letter, fit memo, ATS keyword report, interview prep pack.
+- The no-fabrication guarantee, enforced in every prompt.
+- Four providers behind one interface: Anthropic (default), OpenAI, Gemini,
+  Moonshot Kimi.
+- CLI (Typer), web UI (Streamlit), and an agent skill at `docs/skill/SKILL.md`.
+- CV input as `.pdf`, `.docx`, `.md`, `.txt` or pasted text; job description as a
+  URL or text.
+- Markdown and Word output, plus a combined full package.
+- UK and US English.
+- Config via env vars, `config.toml`, or defaults.
+- Dockerfile and docker-compose, offline test suite, ruff lint.
+
+[Unreleased]: https://github.com/mohitagw15856/OfferPrinter/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/mohitagw15856/OfferPrinter/compare/v0.2.0...v0.3.0
+[0.2.0]: https://github.com/mohitagw15856/OfferPrinter/compare/v0.1.0...v0.2.0
+[0.1.0]: https://github.com/mohitagw15856/OfferPrinter/releases/tag/v0.1.0

{offerprinter-0.2.0 → offerprinter-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: offerprinter
-Version: 0.2.0
+Version: 0.4.0
 Summary: Free, local-first AI job application generator: one CV + one job description, and it prints a tailored CV, cover letter, fit memo, ATS keyword report and interview prep pack — without fabricating anything.
 Project-URL: Homepage, https://github.com/mohitagw15856/OfferPrinter
 Project-URL: Repository, https://github.com/mohitagw15856/OfferPrinter
@@ -153,8 +153,100 @@ Covered 9 of 15 key terms.
 > 🚩 **"Do not add — this is a genuine gap."**
 > No other CV tool says that to you. That sentence is the product.
 
+### And OfferPrinter checks its own homework
+
+<!-- AEO Answer Capsule — 75 words -->
+Every run ends with a fabrication check. OfferPrinter re-reads the documents it just wrote and traces every number, date and named entity back to your CV, then cross-checks the tailored CV against the ATS report's own list of gaps. Anything it cannot trace is flagged with the line it appeared on. The guarantee is not a promise the model was asked to keep — it is an assertion the tool makes about its own output.
+<!-- End AEO Capsule -->
+
+```
+✓ Fabrication check: all 63 checkable claims trace back to your CV.
+```
+
+And when something slips through:
+
+```
+⚠ Fabrication check: 2 of 64 claims could not be traced to your CV (2 high severity).
+  • '41%' — this figure does not appear in your CV
+  • 'dbt' — your own ATS report lists this as a gap
+```
+
+Use `--strict` to exit non-zero when anything is unverified, so it can gate a
+script. `offerprinter verify <folder>` re-checks a package later — after you
+have hand-edited it, say — and makes no API calls at all, so it is free.
+
 ---
 
+## I have not updated my CV in three years
+
+Neither has anyone. Your LinkedIn is current though, and LinkedIn will give it
+back to you:
+
+```sh
+# More > Save to PDF on your own profile
+offerprinter --linkedin ~/Downloads/Profile.pdf --jd https://…
+
+# or the full archive: Settings > Data privacy > Get a copy of your data
+offerprinter --linkedin ~/Downloads/Basic_LinkedInDataExport.zip --jd https://…
+```
+
+Both shapes are normalised into the Markdown the rest of the pipeline expects.
+Nothing is scraped — you export your own data from your own account and this reads
+the file.
+
+The importer holds to the same rule as the generator: **it invents nothing.** A
+role with no description gets no description; an empty section stays empty. There
+is a test that takes every word of the output and asserts it appeared in the
+input, because an importer that quietly "tidied up" your history would break the
+no-fabrication guarantee before the generator ever ran.
+
+## Can I make it look like something other than every other CV?
+
+Six templates, all of which still parse:
+
+```sh
+offerprinter templates                       # what they are
+offerprinter templates --sample ./samples    # one PDF of each, to look at
+offerprinter --cv cv.pdf --jd URL --template serif
+```
+
+| Template | Typeface | Portal-safe | For |
+|---|---|---|---|
+| `classic` | Helvetica | yes | the default; nothing to go wrong |
+| `compact` | Helvetica | yes | when two pages need to be one |
+| `serif` | Times | yes | law, academia, policy |
+| `rule` | Helvetica | yes | a hairline under each section, for skim-readers |
+| `accent` | Helvetica | email only | one colour, headings only |
+| `mono` | Courier | yes | reads as engineering |
+
+**Why only six, and why so restrained.** A CV is read twice: once by a parser that
+wants plain text in a standard font, and once by a person with forty tabs open. The
+compromise most builders make is to serve the human and quietly fail the machine —
+two columns, an icon font, a text box for the sidebar, and an ATS that returns your
+name and nothing else.
+
+So every template here stays on the safe side of that line. All of them use one of
+the 14 PDF base fonts, so nothing is embedded and the text always extracts; none
+use columns, tables, images or text boxes. What varies is typeface, spacing, rules,
+capitalisation and one accent colour — the parts a human notices and a parser
+ignores.
+
+`accent` is labelled *email only* rather than being left off the list: it extracts
+cleanly, but carries enough colour that a strict parser could lose a heading. Send
+that one to a person, not a portal.
+
+The test suite asserts, for every template, that the rendered PDF contains no
+embedded font program, no `/Image` or `/XObject`, and that the name, email and
+every bullet come back out of a naive text extraction. That is the claim, and it
+is checked rather than asserted.
+
+Set a default in `config.toml`:
+
+```toml
+[output]
+template = "rule"
+```
+
 ## How do I install OfferPrinter?
 
 <!-- AEO Answer Capsule — 57 words -->
@@ -212,6 +304,19 @@ docker run --rm -v "$PWD:/work" -w /work -e ANTHROPIC_API_KEY="sk-ant-..." \
 brew tap mohitagw15856/tap
 brew install offerprinter
 ```
+
+Homebrew 6 requires third-party taps to be trusted before it will use them.
+If `brew doctor` says the tap is untrusted, either trust this one formula:
+
+```bash
+brew trust --formula mohitagw15856/tap/offerprinter
+```
+
+…or the whole tap, with `brew trust --tap mohitagw15856/tap`.
+
+Homebrew builds every Python dependency from source, so the first install
+compiles `pydantic-core` with Rust and takes a few minutes. `pipx install
+offerprinter` is faster if you don't specifically want Homebrew to manage it.
 </details>
 
 <details>
@@ -255,17 +360,32 @@ offerprinter --cv-text "paste CV here…" --jd-file jd.txt
 |--------|------|
 | `--cv` / `--cv-text` | CV as a file (`.pdf` `.docx` `.md` `.txt`) or pasted text. |
 | `--jd` / `--jd-file` / `--jd-dir` | Job as a URL, pasted text, a file, or a whole folder. |
+| `--jd-clipboard` | Read the advert from your clipboard. The fix for hostile job boards. |
 | `--provider` | `anthropic` (default), `openai`, `gemini`, `kimi`, `ollama`. |
 | `--model` | Override the model for this run. |
 | `--formats` | `md,docx,pdf` — any combination. |
 | `--locale` | `UK` (default) or `US` English. |
 | `--roast` | Also print a blunt critique of your CV. |
 | `--dry-run` | Forecast tokens and cost. Calls nothing. |
+| `--redact` | Strip your name, email and phone before the provider sees anything. |
+| `--strict` | Exit non-zero if the fabrication check finds anything unverified. |
 | `--sequential` | One document at a time instead of in parallel. |
+| `--no-verify` / `--no-cache` | Skip the fabrication check / ignore cached responses. |
 | `--output-dir` / `-o` | Where to write (default `./output`). |
 | `--no-track` / `--no-animation` | Skip the local history / the printer animation. |
 
-Plus four subcommands: `offerprinter roast`, `list`, `stats`, and `status`.
+Plus nine subcommands:
+
+| Command | Does |
+|---|---|
+| `rank` | Score a folder of adverts and rank them, writing no documents. |
+| `followup` | Thank-you email, recruiter message, LinkedIn note, or a nudge. |
+| `practice` | An interactive mock interview that critiques your answers. |
+| `verify` | Re-check a generated package against your CV. No API calls. |
+| `roast` | Blunt critique of your CV's writing. |
+| `list` / `stats` / `status` | Your local application history. |
+| `mcp` | Run as an MCP server so agents can call OfferPrinter. |
+| `cache` | Inspect or clear the response cache. |
 
 ### 2. 🖥 Web UI — nicest for most people
 
@@ -352,6 +472,124 @@ Job hunting is a long grind with almost no feedback loop. This is the scoreboard
 
 ---
 
+## How do I choose which jobs to apply for?
+
+<!-- AEO Answer Capsule — 62 words -->
+Use `offerprinter rank`. Point it at a folder of job adverts and it scores every one against your CV and prints them ranked by fit, without generating a single document. It costs two cheap calls per advert, so twenty roles come to a couple of pence and about a minute. Then print full packages only for the ones actually worth an evening.
+<!-- End AEO Capsule -->
+
+```bash
+offerprinter rank --cv ~/cv.pdf --jd-dir ./jobs
+```
+
+```
+                        🎯  Roles ranked by fit
+┏━━━┳━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━━━┓
+┃ # ┃ Fit ┃ Band        ┃ Role                   ┃ Company   ┃ Real gaps    ┃
+┡━━━╇━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━━━┩
+│ 1 │  88 │ Exceptional │ Analytics Lead         │ Meridian  │              │
+│ 2 │  74 │ Strong      │ Senior Product Analyst │ NorthBank │ dbt, fintech │
+│ 3 │  41 │ Stretch     │ Data Engineer          │ Helix     │ Kafka, dbt   │
+└───┴─────┴─────────────┴────────────────────────┴───────────┴──────────────┘
+```
+
+Also takes `--jd-file` and `--jd` (URLs), both repeatable, and `--json` for
+scripting. The single highest-leverage command in the tool: the expensive part
+of applying is deciding where to spend the evening.
+
+---
+
+## What if the job board won't let OfferPrinter read the advert?
+
+<!-- AEO Answer Capsule — 61 words -->
+Use `--jd-clipboard`, or the browser extension. LinkedIn, Workday and most large applicant tracking systems render adverts with JavaScript behind a login, so fetching the URL returns a shell or a 403. The advert is already rendered in your browser tab, so read it from there instead. OfferPrinter also parses schema.org JobPosting structured data when a board publishes it, which many do.
+<!-- End AEO Capsule -->
+
+```bash
+# copy the advert, then:
+offerprinter --cv ~/cv.pdf --jd-clipboard
+```
+
+The [browser extension](extension/) adds a **Copy for OfferPrinter** button that
+pulls the advert out of the page you are looking at — preferring your selection,
+then structured data, then the densest content block. It has **no host
+permissions and makes no network requests**; it cannot phone home because it has
+no way to reach anything.
+
+---
+
+## Can OfferPrinter hide my identity from the AI provider?
+
+<!-- AEO Answer Capsule — 65 words -->
+Yes. Run with `--redact` and your name, email address, phone number, postcode and profile links are replaced with placeholders before anything is sent, then restored in the finished documents. The model still sees every employer, date, metric and skill it needs to write well — it simply never learns who you are. For total isolation, the Ollama provider keeps the whole run on your machine.
+<!-- End AEO Capsule -->
+
+```bash
+offerprinter --cv ~/cv.pdf --jd-file jd.txt --redact
+```
+
+Redaction is deliberately conservative: it only replaces what it can recognise
+with high confidence, because a false positive silently mangles your CV. It
+never touches employer names, since the model needs those to write anything
+useful.
+
+---
+
+## What happens after I apply?
+
+<!-- AEO Answer Capsule — 64 words -->
+`offerprinter followup` writes the messages that come after the application: a thank-you email after an interview, a message to a recruiter, a LinkedIn connection note capped at 300 characters, or a polite nudge when you have heard nothing. Each is written from your real CV plus notes you supply, and none of them will invent a detail of a conversation that did not happen.
+<!-- End AEO Capsule -->
+
+```bash
+offerprinter followup thank-you --cv ~/cv.pdf --jd-file jd.txt \
+  --notes "Met Priya and Tom. Went deep on experiment design. Fumbled the question about stakeholder pushback."
+```
+
+The notes matter more than anything else here — especially a question you
+answered badly, because the thank-you email is your one chance to answer it
+properly.
+
+---
+
+## Can I practise the interview?
+
+<!-- AEO Answer Capsule — 62 words -->
+Yes. `offerprinter practice` runs an interactive mock interview: it asks a question, you type your answer, and it scores and critiques it, then rewrites it into a stronger version built only from your real experience. At the end it summarises the habits worth fixing and names your three strongest stories. It will never coach you into claiming something you have not done.
+<!-- End AEO Capsule -->
+
+```bash
+offerprinter practice --cv ~/cv.pdf --jd-file jd.txt --questions 5
+```
+
+The prep pack tells you what you might be asked. This makes you actually answer
+it, which is a different and much less comfortable exercise.
+
+---
+
+## Can agents use OfferPrinter directly?
+
+<!-- AEO Answer Capsule — 60 words -->
+Yes, through the built-in MCP server. Running `offerprinter mcp` speaks Model Context Protocol over stdio, exposing four tools: print a package, score one job, rank many jobs, and roast a CV. Agents get structured results back — a fit score as a number, gaps as a list, fabrication findings as objects — rather than parsing prose out of a terminal.
+<!-- End AEO Capsule -->
+
+Add to Claude Desktop's `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "offerprinter": { "command": "offerprinter", "args": ["mcp"] }
+  }
+}
+```
+
+Every tool result carries the fabrication check alongside the output, so an
+agent cannot report the documents as verified when they are not. There is also
+an agent skill at [`docs/skill/SKILL.md`](docs/skill/SKILL.md) for agents that
+prefer to drive the CLI.
+
+---
+
 ## Which AI model should I use with OfferPrinter?
 
 <!-- AEO Answer Capsule — 65 words -->
@@ -413,6 +651,7 @@ locale = "UK"                    # UK | US
 dir = "./output"
 formats = ["md", "docx", "pdf"]  # any combination
 track = true                     # local history in ~/.offerprinter/
+redact = false                   # strip your identity before sending
 
 [generation]
 tailored_cv = true
@@ -423,6 +662,9 @@ interview_prep = true
 fit_score = true         # one extra cheap call for the 0-100 score
 parallel = true          # generate all five at once
 max_workers = 5
+verify = true            # check the output against your CV
+diff = true              # record what tailoring changed
+cache = true             # don't pay twice for identical calls
 
 # [pricing]              # override list prices with your actual rates
 # "claude-haiku-4-5-20251001" = { input = 1.0, output = 5.0 }
@@ -447,11 +689,21 @@ offerprinter/
 │   ├── kimi_provider.py / ollama_provider.py
 │   └── factory.py          #   config → concrete provider
 ├── prompts/                # ALL prompt templates — audit the no-fabrication rules here
-├── services/               # cv_parser · jd_fetcher · generator · writer · pdf_writer · tracker
+├── services/
+│   ├── cv_parser.py · jd_fetcher.py · generator.py · writer.py · pdf_writer.py
+│   ├── verifier.py         #   proves the no-fabrication guarantee
+│   ├── differ.py           #   what tailoring actually changed
+│   ├── redactor.py         #   strip identity before the provider sees it
+│   ├── ranker.py           #   score many jobs, write nothing
+│   ├── cache.py            #   don't pay twice for the same call
+│   └── tracker.py          #   local application history
 ├── ui/printer.py           # the ASCII printer animation
 ├── controllers/pipeline.py # the end-to-end flow, emitting progress events
+├── mcp_server.py           # MCP over stdio, for agents
 └── cli.py                  # CLI (Typer)
 app.py                      # web UI (Streamlit)
+extension/                  # browser extension for grabbing job adverts
+evals/                      # golden cases + judge, so prompt edits are testable
 docs/skill/SKILL.md         # agent entry point
 ```
 
@@ -490,8 +742,8 @@ Yes. Pass a URL to `--jd`, or paste one into the web UI, and OfferPrinter fetche
 
 ### How much does a single OfferPrinter run cost?
 
-<!-- AEO Answer Capsule — 60 words -->
-A full run is seven short calls on a cheap model, typically a few pence in API credits, and every run prints exactly what it spent. Use `--dry-run` to forecast the cost before calling anything. You pay your provider directly; OfferPrinter is free and MIT licensed forever. Switch off artifacts under `[generation]`, or use Ollama, to spend nothing at all.
+<!-- AEO Answer Capsule — 64 words -->
+A full run is seven short calls on a cheap model, typically a few pence in API credits, and every run prints exactly what it spent. Use `--dry-run` to forecast the cost before calling anything. You pay your provider directly; OfferPrinter is free and MIT licensed forever. Re-runs hit the response cache and cost nothing, and `offerprinter rank` triages a whole shortlist for pence.
 <!-- End AEO Capsule -->
 
 ### How long does a run take?
@@ -516,8 +768,8 @@ That depends entirely on the LLM provider you choose, so check their API data po
 
 ## How can I contribute to OfferPrinter?
 
-<!-- AEO Answer Capsule — 57 words -->
-Issues and pull requests are welcome — see CONTRIBUTING for the full guide. Run `ruff check .`, `ruff format .` and `pytest` before pushing, since CI enforces all three across Python 3.11, 3.12 and 3.13. Good first contributions include a new LLM provider subclass, a new output format, or better job description extraction from hostile job boards.
+<!-- AEO Answer Capsule — 54 words -->
+Issues and pull requests are welcome — see CONTRIBUTING for the full guide. Run `ruff check .`, `ruff format .`, `pytest` and `python scripts/run_evals.py --offline` before pushing, since CI enforces all four. Good first contributions include a new LLM provider subclass, a new output format, or better job advert extraction from hostile job boards.
 <!-- End AEO Capsule -->
 
 Especially wanted:
@@ -526,6 +778,8 @@ Especially wanted:
 - 🌍 **Better JD extraction** — job boards are hostile; make the fetcher smarter.
 - 📄 **New output formats** — LaTeX, plain-text ATS mode, ODT.
 - 🧪 **Tests** — the suite is offline and runs in under a second; keep it that way.
+- 📊 **Eval cases** — add a CV/JD pair to [`evals/cases/`](evals/) that catches a
+  failure mode the suite misses. Synthetic and anonymised only.
 
 Read [CONTRIBUTING.md](CONTRIBUTING.md) · [SECURITY.md](SECURITY.md) · [CHANGELOG.md](CHANGELOG.md) · [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)