faf-cli 3.1.2 → 3.1.4

package/README.md

@@ -1,7 +1,10 @@
-# faf-cli
+<div align="left">
+  <img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/logos/orange-smiley.svg" alt="FAF" width="40" align="left" style="margin-right: 12px;" />
+  <h1> faf-cli</h1>
+  <p><strong>IANA-Registered Format for AI Context</strong> · <code>application/vnd.faf+yaml</code></p>
+</div>
+<br clear="left"/>
 
-> **🏆 IANA-Registered Format** - .FAF is now an Internet-standard format.
-> Create official `application/vnd.faf+yaml` files from any codebase
 > Universal CLI for FAF (Foundational AI-context Format) using project.faf -
 > sits with package.json and README.md in every repo to provide AI context 
 ## TL;DR
@@ -43,7 +46,7 @@ Use CLI for raw speed and local development; use MCP for AI-integrated workflows
 ### 📸 See It In Action
 
 <div align="center">
-<img src="./assets/screenshots/package-json+project-faf.png" alt="project.faf sits between package.json and README.md" width="500" />
+<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/screenshots/package-json-project-faf.png" alt="project.faf sits between package.json and README.md" width="500" />
 
 **`project.faf` sits right between `package.json` and `README.md`** - exactly where it belongs.
 
@@ -58,15 +61,17 @@ Visible. Discoverable. Universal.
 
 <div align="center">
 
-<img src="https://cdn.jsdelivr.net/npm/faf-cli@latest/assets/icons/orange-smiley.svg" alt="FAF Logo" width="64" />
+<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/logos/orange-smiley.svg" alt="FAF Logo" width="64" />
 
 **Free and Open Source** • **Project DNA for any AI** • **Zero Faff™**
 
-[![NPM Version](https://img.shields.io/npm/v/faf-cli?color=FF4500)](https://www.npmjs.com/package/faf-cli)
-[![Downloads](https://img.shields.io/npm/dt/faf-cli?color=00CCFF)](https://www.npmjs.com/package/faf-cli)
+[![GitHub stars](https://img.shields.io/github/stars/Wolfe-Jam/faf-cli?style=social)](https://github.com/Wolfe-Jam/faf-cli)
+[![NPM Downloads](https://img.shields.io/npm/dt/faf-cli?label=total%20downloads&color=00CCFF)](https://www.npmjs.com/package/faf-cli)
 [![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865F2?logo=discord&logoColor=white)](https://discord.com/invite/3pjzpKsP)
-[![IANA Registered](https://img.shields.io/badge/IANA-application%2Fvnd.faf%2Byaml-blue)](https://faf.one/blog/iana-registration)
 [![Homebrew](https://img.shields.io/badge/Homebrew-faf--cli-orange)](https://github.com/Wolfe-Jam/homebrew-faf)
+[![Website](https://img.shields.io/badge/Website-faf.one-orange)](https://faf.one)
+[![Spec Version](https://img.shields.io/badge/Spec-v1.1.0-green)](https://github.com/Wolfe-Jam/faf/blob/main/SPECIFICATION.md)
+[![IANA Registered](https://img.shields.io/badge/IANA-application%2Fvnd.faf%2Byaml-blue)](https://faf.one/blog/iana-registration)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 **[Website](https://faf.one)** • **[Discord](https://discord.com/invite/3pjzpKsP)** • **[GitHub](https://github.com/Wolfe-Jam/faf-cli)** • **[Discussions](https://github.com/Wolfe-Jam/faf-cli/discussions)**
@@ -91,6 +96,29 @@ brew install faf-cli
 
 **One command. Zero configuration. Production-ready.**
 
+### Using Claude Desktop?
+
+Install the MCP server too for integrated workflows:
+
+```bash
+npm install -g claude-faf-mcp
+# or
+brew install wolfe-jam/faf/claude-faf-mcp
+```
+
+Add to `claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "claude-faf-mcp": {
+      "command": "claude-faf-mcp"
+    }
+  }
+}
+```
+
+**[claude-faf-mcp on npm →](https://www.npmjs.com/package/claude-faf-mcp)**
+
 ---
 
 ## 🎉 What's New in v3.1.2 - Discord Community Launch
@@ -535,7 +563,7 @@ We created this tool together across thousands of conversations. Yet without pro
 
 ### Before `.faf` - Birth: 12%
 <div align="center">
-<img src="https://cdn.jsdelivr.net/npm/faf-cli@latest/assets/birth-dna-12-percent.png" alt="FAF CLI birth score: 12% context" width="700" />
+<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/demos/birth-dna-12-percent.png" alt="FAF CLI birth score: 12% context" width="700" />
 </div>
 
 **Context Score: 12%** — Even the AI that built it couldn't recognize it
@@ -544,7 +572,7 @@ We created this tool together across thousands of conversations. Yet without pro
 
 ### The Transformation - 344ms Later
 <div align="center">
-<img src="https://cdn.jsdelivr.net/npm/faf-cli@latest/assets/faf-init-demo.gif" alt="Running faf init - 344ms" width="700" />
+<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/demos/faf-init-demo.gif" alt="Running faf init - 344ms" width="700" />
 </div>
 
 **`faf init`** — One command. Zero configuration. Project DNA created.
@@ -553,7 +581,7 @@ We created this tool together across thousands of conversations. Yet without pro
 
 ### After `.faf` - Current: 89%
 <div align="center">
-<img src="https://cdn.jsdelivr.net/npm/faf-cli@latest/assets/growth-to-89-percent.png" alt="FAF CLI after .faf: 89% context score" width="700" />
+<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/demos/growth-to-89-percent.png" alt="FAF CLI after .faf: 89% context score" width="700" />
 </div>
 
 **Context Score: 89%** — Instant comprehension. Persistent memory.
@@ -792,7 +820,7 @@ Next Milestone: 95% 🥈 Silver (6% to go!)
 
 ### Normal Balance (Any Ratio)
 <div align="center">
-<img src="https://cdn.jsdelivr.net/npm/faf-cli@latest/assets/ai-human-balance-50-50.png" alt="AI|HUMAN Balance at 50/50" width="700" />
+<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/demos/ai-human-balance-50-50.png" alt="AI|HUMAN Balance at 50/50" width="700" />
 </div>
 
 **AI 50% | HUMAN 50%** — Working toward optimal context
@@ -801,7 +829,7 @@ Next Milestone: 95% 🥈 Silver (6% to go!)
 
 ### 💚 PERFECT BALANCE ACHIEVED! (50|50)
 <div align="center">
-<img src="https://cdn.jsdelivr.net/npm/faf-cli@latest/assets/prd-balance-perfect-green.png" alt="PRD Balance - Perfect 50/50 goes GREEN" width="700" />
+<img src="https://raw.githubusercontent.com/Wolfe-Jam/faf/main/assets/demos/prd-balance-perfect-green.png" alt="PRD Balance - Perfect 50/50 goes GREEN" width="700" />
 </div>
 
 **⚖️ PERFECT BALANCE!** — When you hit exactly 50|50, the balance bar turns **GREEN 💚** signaling championship-level context optimization. This is the sweet spot where AI and human readers both get exactly what they need.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-cli",
-  "version": "3.1.2",
+  "version": "3.1.4",
   "description": "Anthropic-Approved codebase that powers claude-faf-mcp • Persistent project context, on-demand • Format-driven CLI • Open Source Universal Standard • MIT License",
   "icon": "https://faf.one/orange-smiley.svg",
   "logo": "https://faf.one/orange-smiley.svg",

package/assets/icons/orange-smiley.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="40" zoomAndPan="magnify" viewBox="0 0 30 30.000001" height="40" preserveAspectRatio="xMidYMid meet" version="1.2"><defs><clipPath id="d09fd64dcd"><path d="M 0.484375 0 L 29.515625 0 L 29.515625 29.03125 L 0.484375 29.03125 Z M 0.484375 0 "/></clipPath><clipPath id="5c964e3735"><path d="M 15 0 C 6.984375 0 0.484375 6.5 0.484375 14.515625 C 0.484375 22.53125 6.984375 29.03125 15 29.03125 C 23.015625 29.03125 29.515625 22.53125 29.515625 14.515625 C 29.515625 6.5 23.015625 0 15 0 Z M 15 0 "/></clipPath><clipPath id="6f00ce6b40"><path d="M 2.410156 1.992188 L 27.8125 1.992188 L 27.8125 27.394531 L 2.410156 27.394531 Z M 2.410156 1.992188 "/></clipPath><clipPath id="e0dcf6a574"><path d="M 2.316406 1.859375 L 27.71875 1.859375 L 27.71875 27.261719 L 2.316406 27.261719 Z M 2.316406 1.859375 "/></clipPath><clipPath id="df5f65e3f7"><path d="M 2.207031 1.792969 L 27.613281 1.792969 L 27.613281 27.195312 L 2.207031 27.195312 Z M 2.207031 1.792969 "/></clipPath></defs><g id="5998e49e64"><g clip-rule="nonzero" clip-path="url(#d09fd64dcd)"><g clip-rule="nonzero" clip-path="url(#5c964e3735)"><path style=" stroke:none;fill-rule:nonzero;fill:#000000;fill-opacity:1;" d="M 0.484375 0 L 29.515625 0 L 29.515625 29.03125 L 0.484375 29.03125 Z M 0.484375 0 "/></g></g><g clip-rule="nonzero" clip-path="url(#6f00ce6b40)"><path style=" stroke:none;fill-rule:nonzero;fill:#ff6d4d;fill-opacity:1;" d="M 27.507812 14.539062 C 27.507812 15.363281 27.425781 16.179688 27.265625 16.988281 C 27.105469 17.796875 26.867188 18.582031 26.550781 19.34375 C 26.238281 20.105469 25.851562 20.828125 25.394531 21.515625 C 24.933594 22.199219 24.414062 22.832031 23.832031 23.414062 C 23.25 24 22.617188 24.519531 21.929688 24.976562 C 21.246094 25.433594 20.523438 25.820312 19.761719 26.136719 C 19 26.453125 18.214844 26.691406 17.40625 26.851562 C 16.597656 27.011719 15.78125 27.089844 14.957031 27.089844 C 14.132812 27.089844 13.316406 27.011719 12.507812 26.851562 C 11.699219 26.691406 10.914062 26.453125 10.152344 26.136719 C 9.394531 25.820312 8.667969 25.433594 7.984375 24.976562 C 7.300781 24.519531 6.664062 24 6.082031 23.414062 C 5.5 22.832031 4.980469 22.199219 4.523438 21.515625 C 4.0625 20.828125 3.675781 20.105469 3.363281 19.34375 C 3.046875 18.582031 2.808594 17.796875 2.648438 16.988281 C 2.488281 16.179688 2.40625 15.363281 2.40625 14.539062 C 2.40625 13.71875 2.488281 12.902344 2.648438 12.09375 C 2.808594 11.285156 3.046875 10.5 3.363281 9.738281 C 3.675781 8.976562 4.0625 8.253906 4.523438 7.566406 C 4.980469 6.882812 5.5 6.25 6.082031 5.667969 C 6.664062 5.082031 7.300781 4.5625 7.984375 4.105469 C 8.667969 3.648438 9.394531 3.261719 10.152344 2.945312 C 10.914062 2.628906 11.699219 2.390625 12.507812 2.230469 C 13.316406 2.070312 14.132812 1.992188 14.957031 1.992188 C 15.78125 1.992188 16.597656 2.070312 17.40625 2.230469 C 18.214844 2.390625 19 2.628906 19.761719 2.945312 C 20.523438 3.261719 21.246094 3.648438 21.929688 4.105469 C 22.617188 4.5625 23.25 5.082031 23.832031 5.667969 C 24.414062 6.25 24.933594 6.882812 25.394531 7.566406 C 25.851562 8.253906 26.238281 8.976562 26.550781 9.738281 C 26.867188 10.5 27.105469 11.285156 27.265625 12.09375 C 27.425781 12.902344 27.507812 13.71875 27.507812 14.539062 Z M 27.507812 14.539062 "/></g><path style=" stroke:none;fill-rule:nonzero;fill:#ffffff;fill-opacity:1;" d="M 13.003906 9.871094 L 11.964844 10.332031 C 11.921875 10.351562 11.875 10.316406 11.878906 10.269531 L 12.160156 7.222656 C 12.164062 7.175781 12.117188 7.140625 12.074219 7.160156 L 11.277344 7.515625 L 10.277344 7.957031 C 10.253906 7.96875 10.242188 7.992188 10.242188 8.015625 L 10.269531 12.003906 C 10.269531 12.046875 10.3125 12.078125 10.355469 12.058594 L 11.394531 11.597656 C 11.4375 11.578125 11.484375 11.609375 11.484375 11.652344 L 11.472656 15.011719 C 11.472656 15.042969 11.496094 15.066406 11.519531 15.070312 C 11.550781 15.078125 11.582031 15.066406 11.59375 15.027344 L 13.089844 9.945312 C 13.105469 9.894531 13.050781 9.851562 13.003906 9.871094 Z M 13.003906 9.871094 "/><path style=" stroke:none;fill-rule:nonzero;fill:#ffffff;fill-opacity:1;" d="M 19.851562 9.871094 L 18.8125 10.332031 C 18.769531 10.351562 18.722656 10.316406 18.726562 10.269531 L 19.007812 7.222656 C 19.015625 7.175781 18.964844 7.140625 18.921875 7.160156 L 18.125 7.515625 L 17.125 7.957031 C 17.105469 7.96875 17.089844 7.992188 17.089844 8.015625 L 17.117188 12.003906 C 17.117188 12.046875 17.164062 12.078125 17.203125 12.058594 L 18.246094 11.597656 C 18.285156 11.578125 18.332031 11.609375 18.332031 11.652344 L 18.320312 15.011719 C 18.320312 15.042969 18.34375 15.066406 18.367188 15.070312 C 18.398438 15.078125 18.433594 15.066406 18.441406 15.027344 L 19.9375 9.945312 C 19.953125 9.894531 19.902344 9.851562 19.851562 9.871094 Z M 19.851562 9.871094 "/><path style=" stroke:none;fill-rule:nonzero;fill:#ffffff;fill-opacity:1;" d="M 24.34375 15.03125 C 23.554688 14.484375 22.574219 14.320312 21.648438 14.578125 C 21.425781 14.640625 21.296875 14.875 21.359375 15.097656 C 21.421875 15.320312 21.652344 15.449219 21.875 15.386719 C 22.066406 15.332031 22.257812 15.304688 22.449219 15.300781 C 21.484375 18.625 18.453125 20.917969 14.957031 20.917969 C 11.460938 20.917969 8.429688 18.625 7.464844 15.300781 C 7.65625 15.304688 7.847656 15.332031 8.039062 15.386719 C 8.261719 15.449219 8.492188 15.320312 8.554688 15.097656 C 8.617188 14.871094 8.488281 14.640625 8.265625 14.578125 C 7.339844 14.320312 6.359375 14.484375 5.570312 15.03125 C 5.378906 15.164062 5.332031 15.425781 5.464844 15.617188 C 5.546875 15.734375 5.679688 15.796875 5.8125 15.796875 C 5.894531 15.796875 5.976562 15.773438 6.050781 15.722656 C 6.230469 15.59375 6.425781 15.496094 6.628906 15.425781 C 7.664062 19.167969 11.050781 21.757812 14.957031 21.757812 C 18.867188 21.757812 22.25 19.167969 23.285156 15.425781 C 23.488281 15.496094 23.683594 15.59375 23.863281 15.722656 C 23.9375 15.773438 24.019531 15.796875 24.105469 15.796875 C 24.238281 15.796875 24.367188 15.734375 24.449219 15.617188 C 24.582031 15.425781 24.535156 15.164062 24.34375 15.03125 Z M 24.34375 15.03125 "/><g clip-rule="nonzero" clip-path="url(#e0dcf6a574)"><path style=" stroke:none;fill-rule:nonzero;fill:#ffffff;fill-opacity:1;" d="M 14.972656 1.859375 C 7.980469 1.859375 2.316406 7.523438 2.316406 14.515625 C 2.316406 21.503906 7.980469 27.171875 14.972656 27.171875 C 21.960938 27.171875 27.628906 21.503906 27.628906 14.515625 C 27.628906 7.523438 21.960938 1.859375 14.972656 1.859375 Z M 14.972656 24.640625 C 9.378906 24.640625 4.847656 20.105469 4.847656 14.515625 C 4.847656 8.921875 9.378906 4.390625 14.972656 4.390625 C 20.5625 4.390625 25.097656 8.921875 25.097656 14.515625 C 25.097656 20.105469 20.5625 24.640625 14.972656 24.640625 Z M 14.972656 24.640625 "/></g><g clip-rule="nonzero" clip-path="url(#df5f65e3f7)"><path style=" stroke:none;fill-rule:nonzero;fill:#5ce1e6;fill-opacity:1;" d="M 14.90625 1.789062 C 7.902344 1.789062 2.207031 7.488281 2.207031 14.492188 C 2.207031 21.492188 7.902344 27.191406 14.90625 27.191406 C 21.910156 27.191406 27.609375 21.492188 27.609375 14.492188 C 27.609375 7.488281 21.910156 1.789062 14.90625 1.789062 Z M 14.90625 25.605469 C 8.777344 25.605469 3.792969 20.617188 3.792969 14.492188 C 3.792969 8.363281 8.777344 3.378906 14.90625 3.378906 C 21.035156 3.378906 26.019531 8.363281 26.019531 14.492188 C 26.019531 20.617188 21.035156 25.605469 14.90625 25.605469 Z M 14.90625 25.605469 "/></g></g></svg>