faf 8.1.1 → 8.2.1

package/README.md

@@ -25,7 +25,7 @@ detected from your real stack, scored, and versioned with your code. No drift. N
 
 <br>
 
-**144.4k downloads** · see [faf.one/downloads](https://faf.one/downloads) for latest stats · **IANA-registered · Anthropic-merged (#2759)**
+[![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.
 
@@ -133,20 +133,18 @@ faf memory etch "a durable fact" --id my-fact
 faf memory show
 ```
 
-### What's New in v8.1.1 — The Always33+ Edition
+### What's New in v8.2.0 — The Ladder Edition
 
-**faf-cli reads SvelteKit 3 projects: SvelteKit, its adapter and its hosting, from vite.config and devDependencies.**
+**One ladder for every card: agent.fafa builds the plain cards, and project.faf adds FAF's context.**
 
-```bash
-npx faf-cli@latest auto     # in a SvelteKit 3 app
-```
-
-```text
-frontend: SvelteKit · backend: SvelteKit · hosting: Cloudflare · build: Vite 8
-```
+| You have | `faf cards` gives you |
+|---|---|
+| `agent.fafa` (BETTER) | the plain cards its endpoints allow: A2A card, MCP Server Card, registry entry, AI Catalog and ARD rows |
+| + `project.faf` (BEST) | the same cards, with FAF's context in each |
 
-- **SvelteKit 3 moved its config into `vite.config`.** faf-cli reads the adapter there (and still in `svelte.config.js` for SvelteKit 2), and finds the kit in devDependencies, where SvelteKit apps list it.
-- **The build slot names Vite's major version:** `Vite 8`.
+- **A card's identity comes from the `.fafa`.** An existing `server.json` keeps the name it was published under; renaming it takes `--force`.
+- **The pack projector writes the same cards as `faf cards`** (`projectPack`, `buildPack`).
+- **The full test suite runs on Windows** before every merge, alongside Ubuntu and macOS.
 
 ### The Always33+ Edition (8.1)
 
@@ -160,8 +158,8 @@ npx faf-cli@latest card init     # seven questions → agent.fafa → A2A card,
 
 | You have | `faf cards` gives you | Rung |
 |---|---|---|
-| `agent.fafa` | A2A card, AI Catalog, ARD | BETTER |
-| + `project.faf` | + FAF context on the A2A card, MCP Server Card, registry | BEST |
+| `agent.fafa` | A2A card, MCP Server Card, registry, AI Catalog, ARD (as its endpoints allow) | BETTER |
+| + `project.faf` | the same cards, with FAF context | BEST |
 
 - **Scripts ask nothing:** every answer is a flag (`--name`, `--domain`, `--url` or `--package`, `--skill`, `--example`, `--set-version`).
 - **Help says what each command touches,** with a "What touches what" footer and [docs.faf.one/side-effects](https://docs.faf.one/side-effects).
@@ -186,6 +184,8 @@ npx faf-cli@latest card init     # seven questions → agent.fafa → A2A card,
 
 **Recent sprint**
 
+- ✪ [8.2.1](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.2.1) Cards stay honest — `updatedAt` moves only on a change; whole http(s) URLs
+- ✪ [8.2.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.2.0) The Ladder Edition — one ladder for every card
 - ✪ [8.1.1](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.1.1) SvelteKit 3 read in full — kit, adapter, Vite 8
 - ✪ [8.1.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.1.0) The Always33+ Edition — from nothing to listed in one command
 - ✪ [8.0.1](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.0.1) pnpm installs work — faf-scoring-kernel from npm