faf-cli 6.7.0 → 6.8.0

package/dist/interop/faf.d.ts

@@ -0,0 +1,14 @@
+import type { FafData } from '../core/types.js';
+/** Read and parse a .faf file */
+export declare function readFaf(path: string): FafData;
+/** Write a .faf file from data.
+ *
+ *  If `data._meta.found` is present, it's stripped before serialization and
+ *  rendered as a `# found: <list>` YAML comment next to the `type:` field —
+ *  Glass Hood doctrine: the user sees WHY the cli classified the project as
+ *  it did. `_meta` is a runtime hint, never a serialized .faf field. */
+export declare function writeFaf(path: string, data: FafData): void;
+/** Read raw YAML text from a .faf file */
+export declare function readFafRaw(path: string): string;
+/** Find the .faf file in a directory (walks up) */
+export declare function findFafFile(dir?: string): string | null;

package/dist/interop/projecthtml.d.ts

@@ -0,0 +1,5 @@
+import type { FafData, ScoreResult } from '../core/types.js';
+/** Render project.faf data + its score into a self-contained HTML string. */
+export declare function generateProjectHtml(data: FafData, result: ScoreResult, fafPath?: string): string;
+/** Write project.html beside project.faf (repo root). */
+export declare function writeProjectHtml(dir: string, data: FafData, result: ScoreResult, fafPath?: string): void;

package/dist/ui/colors.d.ts

@@ -0,0 +1,11 @@
+export declare const bold: (s: string) => string;
+export declare const dim: (s: string) => string;
+export declare const italic: (s: string) => string;
+export declare const FAF_HEX: {
+    readonly cyan: "#00D4D4";
+    readonly cyanDeep: "#0E8C8C";
+    readonly orange: "#FF6B35";
+};
+export declare const fafCyan: (s: string) => string;
+export declare const fafCyanDeep: (s: string) => string;
+export declare const orange: (s: string) => string;

package/dist/wasm/kernel.d.ts

@@ -0,0 +1,22 @@
+import type { KernelScoreResult, FafbInfo } from '../core/types.js';
+/** Score a .faf YAML string (21 base slots) */
+export declare function score(yaml: string): KernelScoreResult;
+/** Score a .faf YAML string (33 enterprise slots) */
+export declare function scoreEnterprise(yaml: string): KernelScoreResult;
+/** Validate .faf YAML */
+export declare function validate(yaml: string): boolean;
+/** Compile .faf YAML to FAFb binary */
+export declare function compile(yaml: string): Uint8Array;
+/** Decompile FAFb binary to JSON info */
+export declare function decompile(bytes: Uint8Array): FafbInfo;
+/** Get FAFb file metadata */
+export declare function fafbInfo(bytes: Uint8Array): FafbInfo;
+/** Get FAFb binary metadata (name, version, source) */
+export interface FafbMeta {
+    source: string;
+    name: string;
+    faf_version: string;
+}
+export declare function scoreFafb(bytes: Uint8Array): FafbMeta;
+/** Get WASM SDK version */
+export declare function sdkVersion(): string;

package/package.json

@@ -1,18 +1,19 @@
 {
   "name": "faf-cli",
-  "version": "6.7.0",
+  "version": "6.8.0",
   "description": "Persistent AI Context Standard — project DNA for AI. IANA-registered. Anthropic-approved.",
   "type": "module",
   "icon": "https://faf.one/orange-smiley.svg",
   "logo": "https://faf.one/orange-smiley.svg",
   "main": "dist/index.js",
+  "types": "./dist/index.d.ts",
   "bin": {
     "faf": "dist/cli.js",
     "faf-cli": "dist/cli.js"
   },
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     }
   },
@@ -24,11 +25,11 @@
   ],
   "scripts": {
     "dev": "bun src/cli.ts",
-    "build": "bun build src/cli.ts --outdir dist --target=node --minify --sourcemap=linked --external faf-scoring-kernel --external open && bun build src/index.ts --outdir dist --target=node --minify --sourcemap=linked --external faf-scoring-kernel --external open",
+    "build": "bun build src/cli.ts --outdir dist --target=node --minify --sourcemap=linked --external faf-scoring-kernel --external open && bun build src/index.ts --outdir dist --target=node --minify --sourcemap=linked --external faf-scoring-kernel --external open && tsc -p tsconfig.build.json",
     "compile": "bun build src/cli.ts --compile --bytecode --minify --outfile faf",
     "compile:all": "bun build src/cli.ts --compile --bytecode --minify --target=bun-darwin-arm64 --outfile faf-darwin-arm64 && bun build src/cli.ts --compile --bytecode --minify --target=bun-darwin-x64 --outfile faf-darwin-x64 && bun build src/cli.ts --compile --bytecode --minify --target=bun-linux-x64 --outfile faf-linux-x64 && bun build src/cli.ts --compile --bytecode --minify --target=bun-windows-x64 --outfile faf-windows-x64.exe",
-    "test": "bun test --timeout=30000",
-    "test:watch": "bun test --watch --timeout=30000",
+    "test": "bun test --timeout=120000",
+    "test:watch": "bun test --watch --timeout=120000",
     "lint": "eslint src/**/*.ts",
     "format": "prettier --write 'src/**/*.ts'",
     "check:no-hardcode": "! grep -rEln '/(Users|home/runner|private/var)/' dist/ || (echo '❌ Hardcoded build-machine path leaked into dist — see grep output above. Externalize the offending dep in the build script.'; exit 1)",
@@ -69,6 +70,8 @@
     "@anthropic-ai/sdk": "^0.91.1"
   },
   "devDependencies": {
+    "@faf/specification": "github:Wolfe-Jam/faf",
+    "ajv": "^8.17.1",
     "@types/node": "^22.15.0",
     "@typescript-eslint/eslint-plugin": "^8.41.0",
     "@typescript-eslint/parser": "^8.41.0",