faf-cli 7.9.0 → 7.10.1

package/README.md

@@ -24,7 +24,7 @@ detected from your real stack, scored, and versioned with your code. No drift. N
 
 <br>
 
-**Over 110k+ downloads** · see [faf.one/downloads](https://faf.one/downloads) for latest stats · **IANA-registered · Anthropic-merged (#2759)**
+**133k+ downloads** · see [faf.one/downloads](https://faf.one/downloads) for latest stats · **IANA-registered · Anthropic-merged (#2759)**
 
 ⭐ Bookmarks it for you, helps other devs find it too.
 
@@ -35,7 +35,7 @@ detected from your real stack, scored, and versioned with your code. No drift. N
 [![TAF](./badge.svg)](https://github.com/Wolfe-Jam/faf-taf-git)
 [![CI](https://github.com/Wolfe-Jam/faf-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/Wolfe-Jam/faf-cli/actions/workflows/ci.yml)
 
-FAF defines. MD instructs. AI codes.
+FAF defines. AGENTS.md instructs. AI codes.
 
 <!-- trophy — bottom of hero -->
 [![FAF Trophy 100%](https://img.shields.io/badge/FAF-%F0%9F%8F%86%20100%25-000000?labelColor=FF6B35)](https://faf.one)
@@ -131,34 +131,33 @@ faf memory etch "a durable fact" --id my-fact
 faf memory show
 ```
 
-### What's New in v7.9.0 — The Git-Flow Edition
+### What's New in v7.10.1 — The Full-Facts Edition
 
-**`faf export` respects your repo's branch model — `project.default_branch` drives the `AGENTS.md` PR base instead of a hardcoded `main`.**
-
-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.
-
-```yaml
-# project.faf
-project:
-  default_branch: dev
-```
+**`faf git` grounds every slot in the repo's own files — docker-compose services, Makefile targets, the sibling app dirs where the real stack lives. A polyglot repo stops reporting `library` / `JavaScript`.**
 
 ```bash
-faf export --agents --output docs/context   # write anywhere, not just cwd
-faf check --verbose                          # per-slot breakdown with validation
+faf git future-agi/future-agi
 ```
 
-- **`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`).
+A polyglot repo (Django + React + Go, no npm workspace) used to report `type: library` / `main_language: JavaScript` / no stack. Now:
+
+- **`type: fullstack`** with `main_language: "Python (Django · backend); Go (backend); TypeScript (React · frontend)"` and a `# found: polyglot: …` rationale
+- **`stack.database: PostgreSQL · ClickHouse`** — read from `docker-compose.yml` service images (`kafka` / `temporal` → `stack.runtime`, Docker Compose → `stack.hosting`)
+- **`commands.test: cd futureagi && make test`** — read from the nested `Makefile`
+- **`security`** — from `.env.example`
+
+Every slot is backed by a file you can open. The README still fills `goal` and the 6 Ws — the human story a manifest doesn't hold.
+
+**7.10.1** — a repo that opens with a `> ⚠️ Nightly release…` blockquote or a `Docs · Blog · Discord` nav row no longer has that line seed `human_context.what`; the first real prose paragraph wins.
 
-**Recent sprint** — 7 ships
+**Recent sprint**
 
+- 🌱 [7.9.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v7.9.0) The Git-Flow Edition
 - 🎬 [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
 
 ---
 
@@ -218,7 +217,7 @@ Pivotal releases — full history in [CHANGELOG.md](./CHANGELOG.md):
 - **v6.16 — Know Your Stack** — every emitted file labels your stack identically.
 - **v6.15 — Copilot** — `faf export --copilot` writes the file GitHub Copilot reads.
 - **v6.14 — Loop** — `faf loop` drives any repo to ✪ 100% or the honest human wall.
-- **v6.7 — HTML** — `faf show` renders a `.faf` to a browsable page. *(FAF defines. MD instructs. AI codes. HTML shows.)*
+- **v6.7 — HTML** — `faf show` renders a `.faf` to a browsable page. *(FAF defines. AGENTS.md instructs. AI codes. HTML shows.)*
 - **v6.6 — Trophy** — 100% or nothing.
 - **v6.0 — Bun** — ground-up rewrite; single portable binary, four platforms.