faf-cli 8.5.0 → 8.7.0

package/README.md

@@ -28,7 +28,7 @@ detected from your real stack, scored, and versioned with your code. No drift. N
 
 [![FAF downloads](https://img.shields.io/endpoint?url=https://faf.one/api/downloads.json)](https://faf.one/downloads) · across npm, PyPI and crates.io · **IANA-registered · Anthropic-merged (#2759)**
 
-⭐ Bookmarks it for you, helps other devs find it too.
+⭐ [Star it on GitHub](https://github.com/Wolfe-Jam/faf-cli): bookmarks it for you, helps other devs find it too.
 
 <!-- ② papers · funnel · testing — one line -->
 [![DOI: Context paper](https://img.shields.io/badge/DOI-Context%20paper-FF6B35)](https://doi.org/10.5281/zenodo.18251362)
@@ -112,6 +112,8 @@ Run `faf` with no arguments:
 | `faf memory` | `.fafm` soul ops — convert Claude memory, etch, recall, ls, show |
 | `faf diff` / `log` | Semantic context diff + score timeline across git history |
 | `faf hooks --install` | Pre-commit guard against context regression |
+| `faf taf setup` | Write the CI workflow that prints a Test Receipt for every run (JavaScript with Jest, Vitest or Bun; Python; Go) |
+| `faf taf receipts` | Your Test Receipts in the terminal, newest first |
 | `faf compile` / `decompile` | `.faf` → `.fafb` **v2** sealed brick; `decompile` shows sections as JSON |
 | `faf check` | Validate a `.faf` file |
 | `faf show` | Render `project.faf` to a browsable HTML page |
@@ -133,7 +135,30 @@ faf memory etch "a durable fact" --id my-fact
 faf memory show
 ```
 
-### What's New in v8.5.0 — The Agent Skills Edition
+### What's New in v8.7.0 — The Receipts Edition
+
+**Your Test Receipts, in your terminal: `faf taf receipts` shows them, `taf setup` writes the recipe for JavaScript (Jest, Vitest, Bun), Python and Go, and every test run on your default branch gets one, red ones too.**
+
+A Test Receipt is one line of proof that your tests ran: when, the result, passed/total. [faf-taf-git](https://github.com/Wolfe-Jam/faf-taf-git) appends one to `.taf` on a `taf-receipts` branch for every CI run, so the record stays in git after the CI logs expire.
+
+- **`faf taf receipts`** shows them in your terminal, newest first, with a tally. `--limit`, `--json` and `--ref`. It reads git and never fetches or writes.
+- **`faf taf setup`** writes the workflow: JavaScript with Jest, Vitest or Bun, Python with pytest, and Go with gotestsum. Any other repo gets a placeholder to fill in.
+- **Red runs get a receipt too**, and the job still goes red. Only your default branch is recorded; pull requests run the tests and print none.
+- **Plain text when piped.** Colour shows only in a terminal; `NO_COLOR` and `FORCE_COLOR` are respected.
+
+### The Birth Certificate Edition (8.6)
+
+**One birth certificate per project, protected: `init --new` rebuilds project.faf without touching it, `go` and `edit` record every climb, and `faf dna --json` shows the lineage.**
+
+`.faf-dna` is the project's birth certificate: its first score, recorded once, the way a baby's birth weight is. A project gets one. faf keeps it, and records what happens after.
+
+- **`faf init --new`** replaces a stale project.faf with a fresh one from the repo. `.faf-dna` stays exactly as it is.
+- **`faf go` and `faf edit` record every climb** on the DNA, alongside `faf auto` and `faf refresh`. `faf dna` shows the whole journey.
+- **`faf dna --json`** gives the lineage as data: birth, certificate, current score, growth, peak, every version, and any earlier lives.
+- **Gitignored? faf says so.** If `.faf-dna` is gitignored, a fresh clone loses it. `faf init` and `faf dna` name the rule. Put the reason in a `#` comment above it, and faf stays quiet.
+- **Protected, never reissued.** A `.faf-dna` faf didn't write is read and left as it is. faf no longer suggests replacing it.
+
+### The Agent Skills Edition (8.5)
 
 **faf knows a skills repo when it sees one, and the skills types name their framework: `skills` is 10 slots, `skills-plugin` is 14.**
 
@@ -224,6 +249,8 @@ npx faf-cli@latest card init     # seven questions → agent.fafa → A2A card,
 
 **Recent sprint**
 
+- ✪ [8.7.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.7.0) The Receipts Edition — `faf taf receipts`; `taf setup` for JavaScript, Python and Go; red runs get a receipt
+- ✪ [8.6.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.6.0) The Birth Certificate Edition — `init --new` keeps `.faf-dna`; `go`/`edit` record growth; `faf dna --json`
 - ✪ [8.5.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.5.0) The Agent Skills Edition — faf detects skills repos; `skills` (10) and `skills-plugin` (14) name their framework
 - ✪ [8.4.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.4.0) The Skills Edition — `skills` (9) and `skills-plugin` (12) app-types
 - ✪ [8.3.2](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.3.2) `faf check` warns when a key_files path no longer exists