faf-cli 7.1.3 → 7.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-cli",
-  "version": "7.1.3",
+  "version": "7.1.4",
   "description": "Persistent AI Context Standard — project DNA for AI. IANA-registered. Anthropic-merged.",
   "type": "module",
   "icon": "https://faf.one/orange-smiley.svg",
@@ -76,10 +76,11 @@
   },
   "devDependencies": {
     "@faf/specification": "github:Wolfe-Jam/faf",
-    "ajv": "^8.17.1",
+    "@types/bun": "^1.3.14",
     "@types/node": "^22.15.0",
     "@typescript-eslint/eslint-plugin": "^8.41.0",
     "@typescript-eslint/parser": "^8.41.0",
+    "ajv": "^8.17.1",
     "eslint": "^9.39.2",
     "prettier": "^3.2.5",
     "typescript": "^5.3.3",

package/project.faf

@@ -1,9 +1,35 @@
 faf_version: "3.0"
 project:
-  name: faf-cli v6
-  goal: "CLI for the `.faf` format — persistent AI context that versions with your code, and (v6.7, The HTML Edition) renders human-visible on-demand via `faf show`. IANA-registered media type: `application/vnd.faf+yaml`."
+  name: faf-cli
+  version: "7.1.4"
+  goal: "CLI for the IANA-registered `.faf` format (`application/vnd.faf+yaml`) — TypeScript, Bun-native since v6. package faf-cli v7.1.4."
   main_language: TypeScript
   type: cli  # found: package.json bin
+# Commands + key_files feed `faf export --agents` (hand values win over detection).
+commands:
+  install: bun install
+  build: bun run build
+  dev: bun run dev
+  test: bun run test
+  lint: bun run lint
+key_files:
+  - src/cli.ts
+  - src/index.ts
+  - src/commands/
+  - src/core/
+  - src/detect/
+  - src/interop/
+  - src/wasm/
+  - package.json
+  - project.faf
+instant_context:
+  what_building: CLI for IANA-registered .faf project DNA
+  tech_stack: TypeScript · Bun-native since v6
+  key_files:
+    - src/cli.ts
+    - src/commands/
+    - src/core/
+    - src/interop/agents.ts
 stack:
   frontend: slotignored
   css_framework: slotignored
@@ -29,7 +55,7 @@ human_context:
   what: Persistent AI Context Standard — project DNA for AI. IANA-registered. Anthropic-merged.
   why: Eliminates 91% context re-discovery tax — define once, AI remembers forever
   where: npm registry, Homebrew, GitHub
-  when: Production since September 2025; v7.0 The GIT Version, June 2026
+  when: Production since September 2025; Bun-native since v6; current package 7.1.4
   how: bunx faf-cli auto, then project.faf versions with your code — faf show renders it human-visible
 monorepo:
   packages_count: slotignored
@@ -45,3 +71,18 @@ surfaces:
   declared:                  # hand-authored: surfaces the manifests don't carry + targets
     - { type: npm,      id: faf,     status: live }      # dual-publish alias (faf-cli ⇄ faf)
     - { type: homebrew, id: faf-cli, status: live }
+ai_instructions:
+  # faf-cli's own custom rules — dogfooding ai_instructions.warnings.
+  # These land at the top of AGENTS.md Guardrails on `faf export --agents`.
+  warnings:
+    - "Use bun, not npm — this repo is Bun-native since v6."
+    - "TypeScript strict; zero type errors, zero test failures — always."
+    - "Scoring is a Rust→WASM kernel — compose it, never reimplement scoring in TS."
+    - "FAF authors — never 'generates'. And 'never guessed', not 'not guessed'."
+    - "Never write 'Guaranteed' (any form) — it's banned; it's free software."
+    - "Publish only via /pubpro — never hand-run npm publish."
+  working_style:
+    architecture: Domain-model first; single-source engines composed, never reimplemented.
+    testing: WJTTC — zero errors always; bun test green before any ship.
+    runtime: Bun-native since v6, TypeScript strict, Rust→WASM scoring kernel.
+    releases: Atomic via /pubpro — bump, verify, tag, publish in one motion.