faf 1.0.3 → 6.5.0

package/README.md

@@ -1,51 +1,19 @@
-# FAF - Foundational AI-context Format
+# faf
 
-**IANA-registered standard: `application/vnd.faf+yaml`**
-
-Project DNA for AI. Like package.json, but for context.
-
-## Install
-
-```bash
-npm install -g faf
-```
-
-## Usage
+**Thin alias for `faf-cli`.** Same CLI, shorter name.
 
 ```bash
-faf           # Auto-detect your project, create .faf, score it
-faf init      # Initialize .faf from your project
-faf auto      # Zero-to-context instantly
-faf go        # Guided interview to 100%
-faf bi-sync   # Keep .faf and CLAUDE.md in sync
+bunx faf init
+bunx faf auto
+bunx faf go
+bunx faf wjttc
 ```
 
-## What is FAF?
-
-FAF encapsulates project goals, stack, rules, and architecture in a structured YAML format. Run faf-CLI commands and get AI-Context in seconds — no uploads required.
-
-## Ecosystem
-
-- **faf-cli** - CLI toolchain (this package wraps it)
-- **claude-faf-mcp** - Official Anthropic MCP integration
-- **faf-mcp** - MCP server implementation
-- **grok-faf-mcp** - xAI Grok MCP server
-- **gemini-faf-mcp** - Google Gemini MCP server
-
-## Links
-
-- Website: [faf.one](https://faf.one)
-- GitHub: [github.com/Wolfe-Jam/faf](https://github.com/Wolfe-Jam/faf)
-- IANA Registration: [application/vnd.faf+yaml](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml)
-
-## Downloads
-
-50,000+ downloads across the FAF ecosystem.
-
-## License
-
-MIT
+This package resolves [`faf-cli`](https://npmjs.com/package/faf-cli) at install time and forwards args through. All docs, all commands, all features live in the canonical CLI.
 
----
+- **Canonical CLI:** https://npmjs.com/package/faf-cli
+- **Spec:** https://faf.one
+- **Issues:** https://github.com/Wolfe-Jam/faf-cli/issues
+- **Format:** IANA-registered `application/vnd.faf+yaml`
 
-*Created by [@wolfe_jam](https://x.com/wolfe_jam)*
+> FAF defines. MD instructs. AI codes.

package/bin/faf.js

@@ -1,14 +1,18 @@
 #!/usr/bin/env node
 
 /**
- * FAF - Foundational AI-context Format
+ * FAF — Foundational AI-context Format
  * IANA-registered: application/vnd.faf+yaml
  *
- * Passes through to faf-cli's CLI entry point.
- * Install: npm install -g faf
- * Usage: faf | faf init | faf auto | faf go
+ * Thin alias for `faf-cli`. Resolves the canonical CLI at install time
+ * (via `faf-cli: latest` dependency) and forwards user args through.
  *
- * https://faf.one
+ * Install: bunx faf | npx faf | npm install -g faf
+ * Usage:   faf | faf init | faf auto | faf go | faf wjttc | ...
+ *
+ * Canonical CLI:  https://npmjs.com/package/faf-cli
+ * Spec:           https://faf.one
+ * Bugs:           https://github.com/Wolfe-Jam/faf-cli/issues
  */
 
 const { execFileSync } = require('child_process');

package/package.json

@@ -1,19 +1,9 @@
 {
   "name": "faf",
-  "version": "1.0.3",
-  "description": "FAF - Foundational AI-context Format. IANA-registered standard (application/vnd.faf+yaml). Project DNA for AI.",
-  "keywords": [
-    "faf",
-    "ai-context",
-    "ai",
-    "context",
-    "llm",
-    "claude",
-    "grok",
-    "mcp",
-    "yaml"
-  ],
-  "author": "Wolfe James <wolfe@wolfejam.dev> (https://wolfejam.dev)",
+  "version": "6.5.0",
+  "description": "FAF — Foundational AI-context Format. IANA-registered (application/vnd.faf+yaml). Project DNA for AI. This package is a thin alias to faf-cli — see the canonical CLI for full docs.",
+  "keywords": ["faf", "ai-context", "ai", "context", "llm", "claude", "grok", "mcp", "yaml", "cli"],
+  "author": "wolfejam <wolfejam@faf.one>",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -21,12 +11,15 @@
   },
   "homepage": "https://faf.one",
   "bugs": {
-    "url": "https://github.com/Wolfe-Jam/faf/issues"
+    "url": "https://github.com/Wolfe-Jam/faf-cli/issues"
   },
   "dependencies": {
     "faf-cli": "latest"
   },
   "bin": {
     "faf": "./bin/faf.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
   }
 }