faf-cli 8.0.0 → 8.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "faf-cli",
-  "version": "8.0.0",
+  "version": "8.0.1",
   "description": "Persistent AI context + memory — .faf and .fafm, IANA-registered. Anthropic-merged.",
   "type": "module",
   "icon": "https://faf.one/orange-smiley.svg",
@@ -25,8 +25,7 @@
     "dist/**/*",
     "README.md",
     "LICENSE",
-    "project.faf",
-    "vendor/faf-scoring-kernel/**"
+    "project.faf"
   ],
   "scripts": {
     "dev": "bun src/cli.ts",
@@ -75,7 +74,7 @@
   },
   "dependencies": {
     "commander": "^14.0.3",
-    "faf-scoring-kernel": "file:./vendor/faf-scoring-kernel",
+    "faf-scoring-kernel": "^3.0.0",
     "open": "^11.0.0",
     "yaml": "^2.9.0"
   },

package/project.faf

@@ -1,8 +1,8 @@
 faf_version: "3.0"
 project:
   name: faf-cli
-  version: "8.0.0"
-  goal: "CLI for IANA-registered `.faf` + `.fafm` — context DNA and portable agent memory. TypeScript, Bun-native since v6. package faf-cli v8.0.0 The Always33 Edition — scored by the always-33 engine."
+  version: "8.0.1"
+  goal: "CLI for IANA-registered `.faf` + `.fafm` — context DNA and portable agent memory. TypeScript, Bun-native since v6. package faf-cli v8.0.1 The Always33 Edition — scored by the always-33 engine."
   main_language: TypeScript
   type: cli  # found: package.json bin
 # Commands + key_files feed `faf export --agents` (hand values win over detection).
@@ -61,7 +61,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; Bun-native since v6; current package 8.0.0 (always-33 engine)
+  when: Production since September 2025; Bun-native since v6; current package 8.0.1 (always-33 engine)
   how: bunx faf-cli auto, then project.faf versions with your code — faf show renders it human-visible
 monorepo:
   packages_count: slotignored

package/vendor/faf-scoring-kernel/README.md

@@ -1,88 +0,0 @@
-# faf-scoring-kernel
-
-**faf-scoring-kernel v3.0.0 — The Always33 Edition**
-
-One engine, one number: `score_faf` is always-33, so a repo scores the same in every FAF app.
-
-WASM from the FAF Rust workspace. Scores `.faf` against all 33 slots and compiles `.fafb`. `.faf` is IANA-registered as `application/vnd.faf+yaml`.
-
-## What's New — v3.0.0
-
-One engine, one number: `score_faf` is always-33, so a repo scores the same in every FAF app.
-
-- `score_faf` → always-33 — the same score as faf-kernel, the Rust SDK and the MCP servers
-- `score_faf_enterprise` → alias of `score_faf` (existing callers keep working)
-- `score_fafb` → agrees with `score_faf`
-- `tbd` / `todo` count as empty (placeholders)
-- Engine `sdk_version()` is **3.1.0** (the `faf-wasm-sdk` crate this WASM was built from)
-
-**Upgrading from 2.x:** a `.faf` without its 12 enterprise `slotignored` markers now scores against all 33 slots, so its number can drop (100 → 64). Mark the slots that don't apply as `slotignored` — a 21-slot project carries the 12 enterprise slots that way — and the score returns.
-
-## Install
-
-```bash
-npm install faf-scoring-kernel
-```
-
-Node.js 16+ and Bun.
-
-## Usage
-
-```javascript
-const kernel = require('faf-scoring-kernel');
-
-const yaml = `faf_version: 2.5.0
-project:
-  name: my-app
-  goal: Ship a fast CLI
-  main_language: Rust
-`;
-
-const result = JSON.parse(kernel.score_faf(yaml));
-console.log(result.score, result.populated, '/', result.active); // active = 33 minus slotignored
-
-const bytes = kernel.compile_fafb(yaml);
-console.log(String.fromCharCode(bytes[0], bytes[1], bytes[2], bytes[3])); // FAFB
-console.log(JSON.parse(kernel.decompile_fafb(bytes)).version);           // 2.0
-```
-
-## API
-
-8 pure-function exports. No classes. No state.
-
-| Function | Input | Output |
-|----------|-------|--------|
-| `sdk_version()` | — | engine version string (`3.1.0`) |
-| `score_faf(yaml)` | YAML string | JSON — always-33 |
-| `score_faf_enterprise(yaml)` | YAML string | JSON — same as `score_faf` |
-| `validate_faf(yaml)` | YAML string | `boolean` |
-| `compile_fafb(yaml)` | YAML string | `Uint8Array` — FAFb v2 |
-| `decompile_fafb(bytes)` | `Uint8Array` | JSON string |
-| `score_fafb(bytes)` | `Uint8Array` | JSON string — same score as `score_faf` |
-| `fafb_info(bytes)` | `Uint8Array` | JSON — header + section table |
-
-## Tiers
-
-| Score | Tier |
-|-------|------|
-| 100% | ✪ Trophy |
-| 99% | ★ Gold |
-| 95% | ◆ Silver |
-| 85% | ◇ Bronze |
-| 70% | ● Green |
-| 55% | ● Yellow |
-| 1% | ○ Red |
-| 0% | ♡ White |
-
-✪ is the work glyph for 100%. Same score as 🏆 on social surfaces.
-
-## Links
-
-- [faf.one](https://faf.one) · [the format spec](https://faf.one/spec)
-- [Source](https://github.com/Wolfe-Jam/faf-rust) — `crates/faf-wasm-sdk` (engine) · `npm/faf-scoring-kernel` (this package)
-- [IANA](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml) — `application/vnd.faf+yaml`
-- [faf-cli](https://www.npmjs.com/package/faf-cli) vendors this WASM
-
-## License
-
-MIT

package/vendor/faf-scoring-kernel/faf_wasm_sdk.d.ts

@@ -1,45 +0,0 @@
-/* tslint:disable */
-/* eslint-disable */
-
-/**
- * Compile YAML to a FAFb v2 binary — returns Uint8Array.
- */
-export function compile_fafb(yaml: string): Uint8Array;
-
-/**
- * Decompile a FAFb binary to JSON (full content) — returns JSON string.
- */
-export function decompile_fafb(bytes: Uint8Array): string;
-
-/**
- * Get FAFb file info (header + section metadata, no content) — returns JSON.
- */
-export function fafb_info(bytes: Uint8Array): string;
-
-/**
- * Score FAF YAML content with the Mk4 kernel (always-33) — returns JSON.
- *
- * Always 33 slots. A 21-slot file carries the 12 enterprise slots as
- * `slotignored`, so it scores the same here as in every other FAF app.
- */
-export function score_faf(yaml: string): string;
-
-/**
- * Same as [`score_faf`] (always-33). Kept so existing callers keep working.
- */
-export function score_faf_enterprise(yaml: string): string;
-
-/**
- * Score a FAFb binary — returns JSON string (same shape as `score_faf`).
- */
-export function score_fafb(bytes: Uint8Array): string;
-
-/**
- * Get SDK version.
- */
-export function sdk_version(): string;
-
-/**
- * Validate FAF YAML content — true if it parses as a YAML mapping.
- */
-export function validate_faf(yaml: string): boolean;

package/vendor/faf-scoring-kernel/faf_wasm_sdk.js

@@ -1,369 +0,0 @@
-/* @ts-self-types="./faf_wasm_sdk.d.ts" */
-
-/**
- * Compile YAML to a FAFb v2 binary — returns Uint8Array.
- * @param {string} yaml
- * @returns {Uint8Array}
- */
-function compile_fafb(yaml) {
-    try {
-        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(yaml, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-        const len0 = WASM_VECTOR_LEN;
-        wasm.compile_fafb(retptr, ptr0, len0);
-        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
-        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
-        if (r3) {
-            throw takeObject(r2);
-        }
-        var v2 = getArrayU8FromWasm0(r0, r1).slice();
-        wasm.__wbindgen_export3(r0, r1 * 1, 1);
-        return v2;
-    } finally {
-        wasm.__wbindgen_add_to_stack_pointer(16);
-    }
-}
-exports.compile_fafb = compile_fafb;
-
-/**
- * Decompile a FAFb binary to JSON (full content) — returns JSON string.
- * @param {Uint8Array} bytes
- * @returns {string}
- */
-function decompile_fafb(bytes) {
-    let deferred3_0;
-    let deferred3_1;
-    try {
-        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_export);
-        const len0 = WASM_VECTOR_LEN;
-        wasm.decompile_fafb(retptr, ptr0, len0);
-        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
-        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
-        var ptr2 = r0;
-        var len2 = r1;
-        if (r3) {
-            ptr2 = 0; len2 = 0;
-            throw takeObject(r2);
-        }
-        deferred3_0 = ptr2;
-        deferred3_1 = len2;
-        return getStringFromWasm0(ptr2, len2);
-    } finally {
-        wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export3(deferred3_0, deferred3_1, 1);
-    }
-}
-exports.decompile_fafb = decompile_fafb;
-
-/**
- * Get FAFb file info (header + section metadata, no content) — returns JSON.
- * @param {Uint8Array} bytes
- * @returns {string}
- */
-function fafb_info(bytes) {
-    let deferred3_0;
-    let deferred3_1;
-    try {
-        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_export);
-        const len0 = WASM_VECTOR_LEN;
-        wasm.fafb_info(retptr, ptr0, len0);
-        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
-        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
-        var ptr2 = r0;
-        var len2 = r1;
-        if (r3) {
-            ptr2 = 0; len2 = 0;
-            throw takeObject(r2);
-        }
-        deferred3_0 = ptr2;
-        deferred3_1 = len2;
-        return getStringFromWasm0(ptr2, len2);
-    } finally {
-        wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export3(deferred3_0, deferred3_1, 1);
-    }
-}
-exports.fafb_info = fafb_info;
-
-/**
- * Score FAF YAML content with the Mk4 kernel (always-33) — returns JSON.
- *
- * Always 33 slots. A 21-slot file carries the 12 enterprise slots as
- * `slotignored`, so it scores the same here as in every other FAF app.
- * @param {string} yaml
- * @returns {string}
- */
-function score_faf(yaml) {
-    let deferred3_0;
-    let deferred3_1;
-    try {
-        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(yaml, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-        const len0 = WASM_VECTOR_LEN;
-        wasm.score_faf(retptr, ptr0, len0);
-        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
-        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
-        var ptr2 = r0;
-        var len2 = r1;
-        if (r3) {
-            ptr2 = 0; len2 = 0;
-            throw takeObject(r2);
-        }
-        deferred3_0 = ptr2;
-        deferred3_1 = len2;
-        return getStringFromWasm0(ptr2, len2);
-    } finally {
-        wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export3(deferred3_0, deferred3_1, 1);
-    }
-}
-exports.score_faf = score_faf;
-
-/**
- * Same as [`score_faf`] (always-33). Kept so existing callers keep working.
- * @param {string} yaml
- * @returns {string}
- */
-function score_faf_enterprise(yaml) {
-    let deferred3_0;
-    let deferred3_1;
-    try {
-        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(yaml, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-        const len0 = WASM_VECTOR_LEN;
-        wasm.score_faf_enterprise(retptr, ptr0, len0);
-        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
-        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
-        var ptr2 = r0;
-        var len2 = r1;
-        if (r3) {
-            ptr2 = 0; len2 = 0;
-            throw takeObject(r2);
-        }
-        deferred3_0 = ptr2;
-        deferred3_1 = len2;
-        return getStringFromWasm0(ptr2, len2);
-    } finally {
-        wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export3(deferred3_0, deferred3_1, 1);
-    }
-}
-exports.score_faf_enterprise = score_faf_enterprise;
-
-/**
- * Score a FAFb binary — returns JSON string (same shape as `score_faf`).
- * @param {Uint8Array} bytes
- * @returns {string}
- */
-function score_fafb(bytes) {
-    let deferred3_0;
-    let deferred3_1;
-    try {
-        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_export);
-        const len0 = WASM_VECTOR_LEN;
-        wasm.score_fafb(retptr, ptr0, len0);
-        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
-        var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
-        var ptr2 = r0;
-        var len2 = r1;
-        if (r3) {
-            ptr2 = 0; len2 = 0;
-            throw takeObject(r2);
-        }
-        deferred3_0 = ptr2;
-        deferred3_1 = len2;
-        return getStringFromWasm0(ptr2, len2);
-    } finally {
-        wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export3(deferred3_0, deferred3_1, 1);
-    }
-}
-exports.score_fafb = score_fafb;
-
-/**
- * Get SDK version.
- * @returns {string}
- */
-function sdk_version() {
-    let deferred1_0;
-    let deferred1_1;
-    try {
-        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        wasm.sdk_version(retptr);
-        var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
-        var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
-        deferred1_0 = r0;
-        deferred1_1 = r1;
-        return getStringFromWasm0(r0, r1);
-    } finally {
-        wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export3(deferred1_0, deferred1_1, 1);
-    }
-}
-exports.sdk_version = sdk_version;
-
-/**
- * Validate FAF YAML content — true if it parses as a YAML mapping.
- * @param {string} yaml
- * @returns {boolean}
- */
-function validate_faf(yaml) {
-    const ptr0 = passStringToWasm0(yaml, wasm.__wbindgen_export, wasm.__wbindgen_export2);
-    const len0 = WASM_VECTOR_LEN;
-    const ret = wasm.validate_faf(ptr0, len0);
-    return ret !== 0;
-}
-exports.validate_faf = validate_faf;
-function __wbg_get_imports() {
-    const import0 = {
-        __proto__: null,
-        __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Ref(String) -> Externref`.
-            const ret = getStringFromWasm0(arg0, arg1);
-            return addHeapObject(ret);
-        },
-    };
-    return {
-        __proto__: null,
-        "./faf_wasm_sdk_bg.js": import0,
-    };
-}
-
-function addHeapObject(obj) {
-    if (heap_next === heap.length) heap.push(heap.length + 1);
-    const idx = heap_next;
-    heap_next = heap[idx];
-
-    heap[idx] = obj;
-    return idx;
-}
-
-function dropObject(idx) {
-    if (idx < 1028) return;
-    heap[idx] = heap_next;
-    heap_next = idx;
-}
-
-function getArrayU8FromWasm0(ptr, len) {
-    ptr = ptr >>> 0;
-    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
-}
-
-let cachedDataViewMemory0 = null;
-function getDataViewMemory0() {
-    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
-        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
-    }
-    return cachedDataViewMemory0;
-}
-
-function getStringFromWasm0(ptr, len) {
-    return decodeText(ptr >>> 0, len);
-}
-
-let cachedUint8ArrayMemory0 = null;
-function getUint8ArrayMemory0() {
-    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
-        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
-    }
-    return cachedUint8ArrayMemory0;
-}
-
-function getObject(idx) { return heap[idx]; }
-
-let heap = new Array(1024).fill(undefined);
-heap.push(undefined, null, true, false);
-
-let heap_next = heap.length;
-
-function passArray8ToWasm0(arg, malloc) {
-    const ptr = malloc(arg.length * 1, 1) >>> 0;
-    getUint8ArrayMemory0().set(arg, ptr / 1);
-    WASM_VECTOR_LEN = arg.length;
-    return ptr;
-}
-
-function passStringToWasm0(arg, malloc, realloc) {
-    if (realloc === undefined) {
-        const buf = cachedTextEncoder.encode(arg);
-        const ptr = malloc(buf.length, 1) >>> 0;
-        getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
-        WASM_VECTOR_LEN = buf.length;
-        return ptr;
-    }
-
-    let len = arg.length;
-    let ptr = malloc(len, 1) >>> 0;
-
-    const mem = getUint8ArrayMemory0();
-
-    let offset = 0;
-
-    for (; offset < len; offset++) {
-        const code = arg.charCodeAt(offset);
-        if (code > 0x7F) break;
-        mem[ptr + offset] = code;
-    }
-    if (offset !== len) {
-        if (offset !== 0) {
-            arg = arg.slice(offset);
-        }
-        ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
-        const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
-        const ret = cachedTextEncoder.encodeInto(arg, view);
-
-        offset += ret.written;
-        ptr = realloc(ptr, len, offset, 1) >>> 0;
-    }
-
-    WASM_VECTOR_LEN = offset;
-    return ptr;
-}
-
-function takeObject(idx) {
-    const ret = getObject(idx);
-    dropObject(idx);
-    return ret;
-}
-
-let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
-cachedTextDecoder.decode();
-function decodeText(ptr, len) {
-    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
-}
-
-const cachedTextEncoder = new TextEncoder();
-
-if (!('encodeInto' in cachedTextEncoder)) {
-    cachedTextEncoder.encodeInto = function (arg, view) {
-        const buf = cachedTextEncoder.encode(arg);
-        view.set(buf);
-        return {
-            read: arg.length,
-            written: buf.length
-        };
-    };
-}
-
-let WASM_VECTOR_LEN = 0;
-
-const wasmPath = `${__dirname}/faf_wasm_sdk_bg.wasm`;
-const wasmBytes = require('fs').readFileSync(wasmPath);
-const wasmModule = new WebAssembly.Module(wasmBytes);
-let wasmInstance = new WebAssembly.Instance(wasmModule, __wbg_get_imports());
-let wasm = wasmInstance.exports;

package/vendor/faf-scoring-kernel/faf_wasm_sdk_bg.wasm.d.ts

@@ -1,15 +0,0 @@
-/* tslint:disable */
-/* eslint-disable */
-export const memory: WebAssembly.Memory;
-export const compile_fafb: (a: number, b: number, c: number) => void;
-export const decompile_fafb: (a: number, b: number, c: number) => void;
-export const fafb_info: (a: number, b: number, c: number) => void;
-export const score_faf: (a: number, b: number, c: number) => void;
-export const score_faf_enterprise: (a: number, b: number, c: number) => void;
-export const score_fafb: (a: number, b: number, c: number) => void;
-export const sdk_version: (a: number) => void;
-export const validate_faf: (a: number, b: number) => number;
-export const __wbindgen_add_to_stack_pointer: (a: number) => number;
-export const __wbindgen_export: (a: number, b: number) => number;
-export const __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
-export const __wbindgen_export3: (a: number, b: number, c: number) => void;

package/vendor/faf-scoring-kernel/package.json

@@ -1,24 +0,0 @@
-{
-  "name": "faf-scoring-kernel",
-  "version": "3.0.0",
-  "description": "FAF Mk4 Scoring Kernel — WASM from faf-rust. Scores .faf always-33 and compiles FAFb v2.",
-  "license": "MIT",
-  "author": "wolfejam <wolfejam@faf.one>",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Wolfe-Jam/faf-rust.git",
-    "directory": "npm/faf-scoring-kernel"
-  },
-  "homepage": "https://faf.one",
-  "files": [
-    "faf_wasm_sdk_bg.wasm",
-    "faf_wasm_sdk.js",
-    "faf_wasm_sdk.d.ts",
-    "faf_wasm_sdk_bg.wasm.d.ts"
-  ],
-  "main": "faf_wasm_sdk.js",
-  "types": "faf_wasm_sdk.d.ts",
-  "engines": {
-    "node": ">=16.0.0"
-  }
-}