faf-cli 6.7.1 → 6.8.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
@@ -1,4 +1,4 @@
1
- <!-- faf: faf-cli | TypeScript | cli | CLI for the .faf format — IANA-registered AI context that versions with your code -->
1
+ <!-- faf: faf-cli | TypeScript | cli | CLI for the .faf and .fafm IANA-registered formats — AI context + memory that versions with your code -->
2
2
  <!-- faf: doc=readme | canonical=project.faf | score=100 | family=FAF -->
3
3
 
4
4
  <div style="display: flex; align-items: center; gap: 12px;">
@@ -11,17 +11,20 @@
11
11
  </div>
12
12
  </div>
13
13
 
14
+ [![FAF Trophy 100%](https://img.shields.io/badge/FAF-%F0%9F%8F%86%20100%25-000000?labelColor=FF6B35)](https://faf.one)
15
+ [![IANA: vnd.faf+yaml](https://img.shields.io/badge/IANA-vnd.faf%2Byaml-00D4D4)](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml)[![IANA: vnd.fafm+yaml](https://img.shields.io/badge/IANA-vnd.fafm%2Byaml-00D4D4)](https://www.iana.org/assignments/media-types/application/vnd.fafm+yaml)
16
+ [![DOI: Context paper](https://img.shields.io/badge/DOI-Context%20paper-FF6B35)](https://doi.org/10.5281/zenodo.18251362)[![DOI: Memory paper](https://img.shields.io/badge/DOI-Memory%20paper-FF6B35)](https://doi.org/10.5281/zenodo.20348942)
17
+
18
+ **Home:** [faf.one/cli](https://faf.one/cli)
19
+
14
20
  **FAF defines. MD instructs. AI codes.**
15
21
 
16
22
  [![FAF](https://mcpaas.live/badge/Wolfe-Jam/faf-cli.svg)](https://builder.faf.one)
17
23
  [![TAF](./badge.svg)](https://github.com/Wolfe-Jam/faf-taf-git)
18
24
  [![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)
19
- [![NPM Downloads](https://img.shields.io/npm/dt/faf-cli?label=total%20downloads&color=00CCFF)](https://www.npmjs.com/package/faf-cli)
20
25
  [![npm version](https://img.shields.io/npm/v/faf-cli?color=00CCFF)](https://www.npmjs.com/package/faf-cli)
21
26
  [![Homebrew](https://img.shields.io/badge/Homebrew-faf--cli-orange)](https://github.com/Wolfe-Jam/homebrew-faf)
22
- [![Website](https://img.shields.io/badge/Website-faf.one-orange)](https://faf.one)
23
27
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
24
- [![Built with Bun](https://img.shields.io/badge/Built_with-Bun-f9f1e1?logo=bun)](https://bun.sh)
25
28
  [![project.faf](https://img.shields.io/badge/project.faf-inside-00D4D4)](https://github.com/Wolfe-Jam/faf)
26
29
 
27
30
  ```
@@ -271,10 +274,43 @@ If `faf-cli` has been useful, consider starring the repo — it helps others fin
271
274
 
272
275
  ---
273
276
 
277
+
278
+ ## Citation
279
+
280
+ If you use `faf-cli` or the `.faf` / `.fafm` formats in research or production, please cite the format papers:
281
+
282
+ > Wolfe, J. (2025). *Format-Driven AI Context Architecture: The .faf Standard for Persistent Project Understanding*. Zenodo. https://doi.org/10.5281/zenodo.18251362
283
+
284
+ > 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
285
+
286
+ ### BibTeX
287
+
288
+ ```bibtex
289
+ @article{wolfe2025faf,
290
+ title = {Format-Driven AI Context Architecture: The .faf Standard for Persistent Project Understanding},
291
+ author = {Wolfe, James},
292
+ year = {2025},
293
+ month = {nov},
294
+ publisher = {Zenodo},
295
+ doi = {10.5281/zenodo.18251362},
296
+ url = {https://doi.org/10.5281/zenodo.18251362}
297
+ }
298
+
299
+ @article{wolfe2026fafm,
300
+ title = {Permanent Memory and Instant Recall: The .fafm Standard for Multi-Profile AI Agent Memory},
301
+ author = {Wolfe, James},
302
+ year = {2026},
303
+ month = {may},
304
+ publisher = {Zenodo},
305
+ doi = {10.5281/zenodo.20348942},
306
+ url = {https://doi.org/10.5281/zenodo.20348942}
307
+ }
308
+ ```
309
+
274
310
  ## License
275
311
 
276
312
  MIT — Free and open source
277
313
 
278
- **IANA-registered:** [`application/vnd.faf+yaml`](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml)
314
+ **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)
279
315
 
280
316
  *format | driven 🏎️⚡️ [wolfejam.dev](https://wolfejam.dev)*