faf 7.5.1 → 7.8.0

package/README.md

@@ -18,14 +18,15 @@ detected from your real stack, scored, and versioned with your code. No drift. N
 [![Anthropic MCP #2759](https://img.shields.io/badge/Anthropic_MCP-merged_%232759-blueviolet)](https://github.com/modelcontextprotocol/servers/pull/2759)
 [![IANA vnd.faf+yaml](https://img.shields.io/badge/IANA-vnd.faf%2Byaml-008B8B)](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml)
 [![IANA vnd.fafm+yaml](https://img.shields.io/badge/IANA-vnd.fafm%2Byaml-008B8B)](https://www.iana.org/assignments/media-types/application/vnd.fafm+yaml)
+[![IANA vnd.fafa+yaml](https://img.shields.io/badge/IANA-vnd.fafa%2Byaml-008B8B)](https://www.iana.org/assignments/media-types/application/vnd.fafa+yaml)
 [![downloads](https://img.shields.io/npm/dt/faf-cli?color=008B8B&label=downloads)](https://www.npmjs.com/package/faf-cli)
 [![npm](https://img.shields.io/npm/v/faf-cli?color=00CCFF)](https://www.npmjs.com/package/faf-cli)
 
 <br>
 
-**Over 100k downloads** · see [faf.one/downloads](https://faf.one/downloads) for latest stats · **IANA-registered · Anthropic-merged (#2759)**
+**Over 110k+ downloads** · see [faf.one/downloads](https://faf.one/downloads) for latest stats · **IANA-registered · Anthropic-merged (#2759)**
 
-⭐ **A star helps other devs find faf-cli** — despite the downloads, ~3 of 4 devs check stars.
+⭐ 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)
@@ -130,17 +131,28 @@ faf memory etch "a durable fact" --id my-fact
 faf memory show
 ```
 
-### What's New in v7.5.1 — The JVM Edition (patch)
+### What's New in v7.8.0 — The Projector Edition
 
-**Content-aware JVM** — `pom` / `gradle` alone ≠ type. **Also:** bare build files ≠ Spring Boot on `tech_stack` (7.5.1 closes the stranger-smoke gap).
+**`faf cards` projects `.faf` + `.fafa` onto A2A, MCP, registry, and catalog — one context block, every door.**
 
-- **7.5.1** — Spring Boot only when the file *says* Boot (`spring-boot` / `springframework.boot` in body).
-- **7.5.0** — plugins · parents · catalogs · multi-module: Spring · Quarkus · MCP · CLI · library · Android / KMP facets.
-- **Still shipping** — C# (7.4.0) `.csproj alone ≠ type` · Go (7.3.0) `go.mod alone ≠ backend`.
+Author `.faf` (context) and `.fafa` (identity + skills + endpoints). The CLI writes the host cards. Complementary — it does not replace A2A or MCP.
 
-### Dart/Flutter — knowledge v2 in 7.2.1
+```bash
+faf cards                  # emit whatever inputs allow
+faf cards --target a2a     # A2A Agent Card only
+faf cards --check          # print, do not write
+```
+
+- **One projector** — same `fafContextBlock()` on every door. Does not invent a door or an agent.
 
-**pubspec ≠ Flutter — pure Dart stays Dart.** Same content-aware detection as the [Dart Edition](https://faf.one/blog/dart-edition). **7.2.1** refreshes the single-source knowledge table: Riverpod annotation, Flutter Hooks, Beamer, Routemaster, Jaspr, Relic, and more MCP package names — still **one classifier**, composed by the MCPs.
+**Recent sprint** — 6 ships, 4 days
+
+- 🐦 [7.7.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v7.7.0) The Swift Edition
+- 💎 [7.6.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v7.6.0) The Ruby Edition
+- ☕ [7.5.1](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v7.5.1) The JVM Edition
+- 💠 [7.4.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v7.4.0) The C# Edition
+- 🐹 [7.3.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v7.3.0) The Go Edition
+- 🎯 [7.2.1](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v7.2.1) Dart/Flutter knowledge v2
 
 ---
 
@@ -263,12 +275,14 @@ If `faf-cli` has been useful, consider starring the repo — it helps others fin
 
 ## Citation
 
-If you use `faf-cli` or the `.faf` / `.fafm` formats in research or production, please cite the format papers:
+If you use `faf-cli` or the `.faf` / `.fafm` / `.fafa` formats in research or production, please cite the format papers:
 
 > Wolfe, J. (2025). *Format-Driven AI Context Architecture: The .faf Standard for Persistent Project Understanding*. Zenodo. https://doi.org/10.5281/zenodo.18251362
 
 > Wolfe, J. (2026). *Permanent Memory and Instant Recall: The .fafm Standard for Multi-Profile AI Agent Memory*. Zenodo. https://doi.org/10.5281/zenodo.20348942
 
+> Wolfe, J. (2026). *Why Agents Need a Passport: .fafa — Portable Identity for the Agentic Era*. Zenodo. https://doi.org/10.5281/zenodo.21951641
+
 ### BibTeX
 
 ```bibtex
@@ -291,13 +305,23 @@ If you use `faf-cli` or the `.faf` / `.fafm` formats in research or production,
   doi       = {10.5281/zenodo.20348942},
   url       = {https://doi.org/10.5281/zenodo.20348942}
 }
+
+@article{wolfe2026fafa,
+  title     = {Why Agents Need a Passport: .fafa — Portable Identity for the Agentic Era},
+  author    = {Wolfe, James},
+  year      = {2026},
+  month     = {aug},
+  publisher = {Zenodo},
+  doi       = {10.5281/zenodo.21951641},
+  url       = {https://doi.org/10.5281/zenodo.21951641}
+}
 ```
 
 ## License
 
 MIT — Free and open source
 
-**IANA-registered:** [`application/vnd.faf+yaml`](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml) (Context Layer) · [`application/vnd.fafm+yaml`](https://www.iana.org/assignments/media-types/application/vnd.fafm+yaml) (Memory Layer)
+**IANA-registered:** [`application/vnd.faf+yaml`](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml) (Context Layer) · [`application/vnd.fafm+yaml`](https://www.iana.org/assignments/media-types/application/vnd.fafm+yaml) (Memory Layer) · [`application/vnd.fafa+yaml`](https://www.iana.org/assignments/media-types/application/vnd.fafa+yaml) (Agent Layer)
 
 *format | driven 🏎️⚡️ [wolfejam.dev](https://wolfejam.dev) · [faf.one/cli](https://faf.one/cli)*