faf-cli 7.7.0 → 7.9.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,16 +131,34 @@ faf memory etch "a durable fact" --id my-fact
 faf memory show
 ```
 
-### What's New in v7.7.0 — The Swift Edition
+### What's New in v7.9.0 — The Git-Flow Edition
 
-**Content-aware Swift** — `Package.swift alone ≠ app`. Libraries stay libraries.
+**`faf export` respects your repo's branch model — `project.default_branch` drives the `AGENTS.md` PR base instead of a hardcoded `main`.**
 
-- **Products + deps** — MCP · Vapor · Hummingbird · CLI · Xcode app · library (static parse — does not run `swift build`).
-- **Still shipping** — Ruby (7.6.0) `Gemfile alone ≠ Rails` · JVM (7.5.x) `pom`/`gradle` alone ≠ type · C# (7.4.0) `.csproj alone ≠ type` · Go (7.3.0) `go.mod alone ≠ backend`.
+Set it once in `project.faf`; git-flow repos that PR into `dev` / `develop` get the right base everywhere `faf export` writes it. Default stays `main` when the field is absent.
 
-### Dart/Flutter — knowledge v2 in 7.2.1
+```yaml
+# project.faf
+project:
+  default_branch: dev
+```
+
+```bash
+faf export --agents --output docs/context   # write anywhere, not just cwd
+faf check --verbose                          # per-slot breakdown with validation
+```
+
+- **`key_files` annotations** — write `src/ — entrypoint` and it renders as a `Path | Role` table in "Where things live".
+- Surfaced by the first external `AGENTS.md` deployment (future-agi, base `dev`).
+
+**Recent sprint** — 7 ships
 
-**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.
+- 🎬 [7.8.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v7.8.0) The Projector Edition
+- 🐦 [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
 
 ---
 
@@ -181,7 +200,7 @@ tri-sync:  .faf  ←── 8ms ──→  CLAUDE.md ↔ MEMORY.md
 
 ## Docs
 
-The full manual lives at **[docs.faf.one](https://docs.faf.one)** — facts for devs, faf-cli first.
+The full manual lives at **[docs.faf.one](https://docs.faf.one)** — facts for devs, faf-cli first. One-page overview: **[faf-cli.vercel.app](https://faf-cli.vercel.app)**.
 
 - [Getting started](https://docs.faf.one/getting-started) — install · run · use
 - [Custom rules](https://docs.faf.one/custom-rules) — pin instructions your AI must follow
@@ -262,12 +281,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
@@ -290,13 +311,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)*