faf-cli 8.2.1 → 8.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -22,6 +22,7 @@ detected from your real stack, scored, and versioned with your code. No drift. N
22
22
  [![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge.svg)](https://github.com/hesreallyhim/awesome-claude-code)
23
23
  [![downloads](https://img.shields.io/npm/dt/faf-cli?color=008B8B&label=downloads)](https://www.npmjs.com/package/faf-cli)
24
24
  [![npm](https://img.shields.io/npm/v/faf-cli?color=00CCFF)](https://www.npmjs.com/package/faf-cli)
25
+ [![Business card · Get yours →](https://wolfe-jam.github.io/agent-business-card/badge.svg)](https://wolfe-jam.github.io/agent-business-card/?repo=Wolfe-Jam/faf-cli)
25
26
 
26
27
  <br>
27
28
 
@@ -113,7 +114,6 @@ Run `faf` with no arguments:
113
114
  | `faf hooks --install` | Pre-commit guard against context regression |
114
115
  | `faf compile` / `decompile` | `.faf` → `.fafb` **v2** sealed brick; `decompile` shows sections as JSON |
115
116
  | `faf check` | Validate a `.faf` file |
116
- | `faf recover` | Rebuild `.faf` from an existing `CLAUDE.md` / `AGENTS.md` |
117
117
  | `faf show` | Render `project.faf` to a browsable HTML page |
118
118
  | `faf formats` | List supported stacks and formats |
119
119
 
@@ -133,7 +133,21 @@ faf memory etch "a durable fact" --id my-fact
133
133
  faf memory show
134
134
  ```
135
135
 
136
- ### What's New in v8.2.0 — The Ladder Edition
136
+ ### What's New in v8.3.0 — The Business Card Edition
137
+
138
+ **Business cards say what the repo is: a package can be a CLI or a library, from npm, PyPI or crates.io, and only an MCP server gets MCP cards.**
139
+
140
+ ```bash
141
+ npx faf-cli@latest card init --package pypi:my-lib --kind library
142
+ ```
143
+
144
+ - **`--kind mcp|cli|library`** says what `--package` is. `mcp` stays the default.
145
+ - **`npm:`, `pypi:` and `crates:`** name the registry. A bare name is still npm.
146
+ - **`--homepage <url>`** sets the business card's homepage.
147
+ - **`faf cards` writes MCP cards only for an MCP server.** A CLI or a library gets its plain cards and a one-line reason.
148
+ - **`faf init` offers the business card** when the repo has none: `next: 'faf card init'`. It writes nothing for it.
149
+
150
+ ### The Ladder Edition (8.2)
137
151
 
138
152
  **One ladder for every card: agent.fafa builds the plain cards, and project.faf adds FAF's context.**
139
153
 
@@ -184,6 +198,8 @@ npx faf-cli@latest card init # seven questions → agent.fafa → A2A card,
184
198
 
185
199
  **Recent sprint**
186
200
 
201
+ - ✪ [8.3.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.3.0) The Business Card Edition — CLI, library or MCP server, from npm, PyPI or crates.io
202
+ - ✪ [8.2.2](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.2.2) Markdown never writes project.faf — `sync` is one way, `recover` is gone
187
203
  - ✪ [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
188
204
  - ✪ [8.2.0](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.2.0) The Ladder Edition — one ladder for every card
189
205
  - ✪ [8.1.1](https://github.com/Wolfe-Jam/faf-cli/releases/tag/v8.1.1) SvelteKit 3 read in full — kit, adapter, Vite 8