faf-cli 6.0.13 → 6.0.15

package/dist/index.js

@@ -1,4 +1,4 @@
-import{createRequire as _}from"node:module";var E=Object.defineProperty;var b=(P,B)=>()=>(B||P((B={exports:{}}).exports,B),B.exports);var w=(P,B)=>{for(var H in B)E(P,H,{get:B[H],enumerable:!0,configurable:!0,set:(Y)=>B[H]=()=>Y})};var i=_(import.meta.url);var u=b((r,W)=>{var __dirname="/Users/wolfejam/FAF/cli/node_modules/faf-scoring-kernel",x={};x.__wbindgen_placeholder__=r;var R=null;function D(){if(R===null||R.byteLength===0)R=new Uint8Array(z.memory.buffer);return R}var v=new TextDecoder("utf-8",{ignoreBOM:!0,fatal:!0});v.decode();function n(P,B){return v.decode(D().subarray(P,P+B))}function $(P,B){return P=P>>>0,n(P,B)}r.sdk_version=function(){let P,B;try{let H=z.sdk_version();return P=H[0],B=H[1],$(H[0],H[1])}finally{z.__wbindgen_free(P,B,1)}};var X=0,F=new TextEncoder;if(!("encodeInto"in F))F.encodeInto=function(P,B){let H=F.encode(P);return B.set(H),{read:P.length,written:H.length}};function h(P,B,H){if(H===void 0){let q=F.encode(P),K=B(q.length,1)>>>0;return D().subarray(K,K+q.length).set(q),X=q.length,K}let Y=P.length,I=B(Y,1)>>>0,Q=D(),J=0;for(;J<Y;J++){let q=P.charCodeAt(J);if(q>127)break;Q[I+J]=q}if(J!==Y){if(J!==0)P=P.slice(J);I=H(I,Y,Y=J+P.length*3,1)>>>0;let q=D().subarray(I+J,I+Y),K=F.encodeInto(P,q);J+=K.written,I=H(I,Y,J,1)>>>0}return X=J,I}function G(P){let B=z.__wbindgen_externrefs.get(P);return z.__externref_table_dealloc(P),B}r.score_faf_enterprise=function(P){let B,H;try{let Q=h(P,z.__wbindgen_malloc,z.__wbindgen_realloc),J=X,q=z.score_faf_enterprise(Q,J);var Y=q[0],I=q[1];if(q[3])throw Y=0,I=0,G(q[2]);return B=Y,H=I,$(Y,I)}finally{z.__wbindgen_free(B,H,1)}};r.score_faf=function(P){let B,H;try{let Q=h(P,z.__wbindgen_malloc,z.__wbindgen_realloc),J=X,q=z.score_faf(Q,J);var Y=q[0],I=q[1];if(q[3])throw Y=0,I=0,G(q[2]);return B=Y,H=I,$(Y,I)}finally{z.__wbindgen_free(B,H,1)}};function M(P,B){let H=B(P.length*1,1)>>>0;return D().set(P,H/1),X=P.length,H}r.decompile_fafb=function(P){let B,H;try{let Q=M(P,z.__wbindgen_malloc),J=X,q=z.decompile_fafb(Q,J);var Y=q[0],I=q[1];if(q[3])throw Y=0,I=0,G(q[2]);return B=Y,H=I,$(Y,I)}finally{z.__wbindgen_free(B,H,1)}};r.score_fafb=function(P){let B,H;try{let Q=M(P,z.__wbindgen_malloc),J=X,q=z.score_fafb(Q,J);var Y=q[0],I=q[1];if(q[3])throw Y=0,I=0,G(q[2]);return B=Y,H=I,$(Y,I)}finally{z.__wbindgen_free(B,H,1)}};r.validate_faf=function(P){let B=h(P,z.__wbindgen_malloc,z.__wbindgen_realloc),H=X;return z.validate_faf(B,H)!==0};function s(P,B){return P=P>>>0,D().subarray(P/1,P/1+B)}r.compile_fafb=function(P){let B=h(P,z.__wbindgen_malloc,z.__wbindgen_realloc),H=X,Y=z.compile_fafb(B,H);if(Y[3])throw G(Y[2]);var I=s(Y[0],Y[1]).slice();return z.__wbindgen_free(Y[0],Y[1]*1,1),I};r.fafb_info=function(P){let B,H;try{let Q=M(P,z.__wbindgen_malloc),J=X,q=z.fafb_info(Q,J);var Y=q[0],I=q[1];if(q[3])throw Y=0,I=0,G(q[2]);return B=Y,H=I,$(Y,I)}finally{z.__wbindgen_free(B,H,1)}};r.__wbindgen_cast_2241b6af4c4b2941=function(P,B){return $(P,B)};r.__wbindgen_init_externref_table=function(){let P=z.__wbindgen_externrefs,B=P.grow(4);P.set(0,void 0),P.set(B+0,void 0),P.set(B+1,null),P.set(B+2,!0),P.set(B+3,!1)};var l=`${__dirname}/faf_wasm_sdk_bg.wasm`,a=i("fs").readFileSync(l),t=new WebAssembly.Module(a),z=r.__wasm=new WebAssembly.Instance(t,x).exports;z.__wbindgen_start()});var N=[{index:1,path:"project.name",description:"Project name",category:"project"},{index:2,path:"project.goal",description:"What the project does",category:"project"},{index:3,path:"project.main_language",description:"Primary language",category:"project"},{index:4,path:"human_context.who",description:"Who is building this",category:"human"},{index:5,path:"human_context.what",description:"What are they building",category:"human"},{index:6,path:"human_context.why",description:"Why does it exist",category:"human"},{index:7,path:"human_context.where",description:"Where does it run",category:"human"},{index:8,path:"human_context.when",description:"When was it started / timeline",category:"human"},{index:9,path:"human_context.how",description:"How is it built",category:"human"},{index:10,path:"stack.frontend",description:"Framework (React, Svelte, etc.)",category:"frontend"},{index:11,path:"stack.css_framework",description:"CSS framework",category:"frontend"},{index:12,path:"stack.ui_library",description:"UI component library",category:"frontend"},{index:13,path:"stack.state_management",description:"State management",category:"frontend"},{index:14,path:"stack.backend",description:"Backend framework",category:"backend"},{index:15,path:"stack.api_type",description:"API style (REST, GraphQL, etc.)",category:"backend"},{index:16,path:"stack.runtime",description:"Runtime (Node, Bun, Python, etc.)",category:"backend"},{index:17,path:"stack.database",description:"Database",category:"backend"},{index:18,path:"stack.connection",description:"Connection method (Prisma, etc.)",category:"backend"},{index:19,path:"stack.hosting",description:"Hosting platform",category:"universal"},{index:20,path:"stack.build",description:"Build tool",category:"universal"},{index:21,path:"stack.cicd",description:"CI/CD",category:"universal"},{index:22,path:"stack.monorepo_tool",description:"Monorepo tool",category:"enterprise_infra"},{index:23,path:"stack.package_manager",description:"Package manager",category:"enterprise_infra"},{index:24,path:"stack.workspaces",description:"Workspace configuration",category:"enterprise_infra"},{index:25,path:"monorepo.packages_count",description:"Number of packages",category:"enterprise_infra"},{index:26,path:"monorepo.build_orchestrator",description:"Build orchestration tool",category:"enterprise_infra"},{index:27,path:"stack.admin",description:"Admin panel",category:"enterprise_app"},{index:28,path:"stack.cache",description:"Caching layer",category:"enterprise_app"},{index:29,path:"stack.search",description:"Search engine",category:"enterprise_app"},{index:30,path:"stack.storage",description:"Object storage",category:"enterprise_app"},{index:31,path:"monorepo.versioning_strategy",description:"Version strategy",category:"enterprise_ops"},{index:32,path:"monorepo.shared_configs",description:"Shared configs",category:"enterprise_ops"},{index:33,path:"monorepo.remote_cache",description:"Remote build cache",category:"enterprise_ops"}],c=new Map(N.map((P)=>[P.path,P]));function y(P){return N.filter((B)=>B.category===P)}var g=N.filter((P)=>P.index<=21),f=N,A=new Set(["describe your project goal","development teams","cloud platform","null","none","unknown","n/a","not applicable"]);function p(P){if(P===null||P===void 0||P==="")return!0;if(typeof P==="string")return A.has(P.toLowerCase().trim());if(Array.isArray(P)&&P.length===0)return!0;if(typeof P==="object"&&Object.keys(P).length===0)return!0;return!1}var C=(P)=>(B)=>`\x1B[${P}m${B}\x1B[0m`,S=C("1"),U=C("2"),UP=C("3"),L=(P)=>`\x1B[38;2;0;212;212m${P}\x1B[0m`,O=(P)=>`\x1B[38;5;208m${P}\x1B[0m`;var j=[{name:"TROPHY",indicator:`${O("\uD83C\uDFC6")} ${O("TROPHY")}`,threshold:100},{name:"GOLD",indicator:`${O(S("★"))} ${O("GOLD")}`,threshold:99},{name:"SILVER",indicator:`${L("◆")} ${L("SILVER")}`,threshold:95},{name:"BRONZE",indicator:`${L("◇")} ${L("BRONZE")}`,threshold:85},{name:"GREEN",indicator:`${S("●")} GREEN`,threshold:70},{name:"YELLOW",indicator:`${U("●")} YELLOW`,threshold:55},{name:"RED",indicator:`${U("○")} RED`,threshold:1},{name:"WHITE",indicator:`${U("♡")}`,threshold:0}];function V(P){for(let B of j)if(P>=B.threshold)return B;return j[j.length-1]}function d(P){let B=V(P),H=j.indexOf(B);return H>0?j[H-1]:null}function m(P){return{score:P.score,tier:V(P.score),populated:P.populated,empty:P.empty,ignored:P.ignored,active:P.active,total:P.total,slots:P.slots}}function o(P){let B=[];if(!P||typeof P!=="object")return B.push("File is not a valid YAML mapping"),{valid:!1,errors:B};let H=P;if(!H.faf_version)B.push("Missing required field: faf_version");if(!H.project?.name)B.push("Missing required field: project.name");return{valid:B.length===0,errors:B}}var T={};w(T,{validate:()=>$P,sdkVersion:()=>NP,scoreFafb:()=>KP,scoreEnterprise:()=>ZP,score:()=>XP,fafbInfo:()=>GP,decompile:()=>DP,compile:()=>jP});var k=null;function Z(){if(!k)try{k=u()}catch{throw Error(`faf-scoring-kernel not installed.
+import{createRequire as c}from"node:module";var E=Object.defineProperty;var b=(P,B)=>()=>(B||P((B={exports:{}}).exports,B),B.exports);var w=(P)=>P;function _(P,B){this[P]=w.bind(null,B)}var i=(P,B)=>{for(var H in B)E(P,H,{get:B[H],enumerable:!0,configurable:!0,set:_.bind(B,H)})};var y=c(import.meta.url);var u=b((PP,W)=>{var __dirname="/Users/wolfejam/FAF/cli/node_modules/faf-scoring-kernel",x={};x.__wbindgen_placeholder__=PP;var R=null;function D(){if(R===null||R.byteLength===0)R=new Uint8Array(z.memory.buffer);return R}var v=new TextDecoder("utf-8",{ignoreBOM:!0,fatal:!0});v.decode();function l(P,B){return v.decode(D().subarray(P,P+B))}function $(P,B){return P=P>>>0,l(P,B)}PP.sdk_version=function(){let P,B;try{let H=z.sdk_version();return P=H[0],B=H[1],$(H[0],H[1])}finally{z.__wbindgen_free(P,B,1)}};var X=0,F=new TextEncoder;if(!("encodeInto"in F))F.encodeInto=function(P,B){let H=F.encode(P);return B.set(H),{read:P.length,written:H.length}};function h(P,B,H){if(H===void 0){let q=F.encode(P),K=B(q.length,1)>>>0;return D().subarray(K,K+q.length).set(q),X=q.length,K}let Y=P.length,I=B(Y,1)>>>0,Q=D(),J=0;for(;J<Y;J++){let q=P.charCodeAt(J);if(q>127)break;Q[I+J]=q}if(J!==Y){if(J!==0)P=P.slice(J);I=H(I,Y,Y=J+P.length*3,1)>>>0;let q=D().subarray(I+J,I+Y),K=F.encodeInto(P,q);J+=K.written,I=H(I,Y,J,1)>>>0}return X=J,I}function G(P){let B=z.__wbindgen_externrefs.get(P);return z.__externref_table_dealloc(P),B}PP.score_faf_enterprise=function(P){let B,H;try{let Q=h(P,z.__wbindgen_malloc,z.__wbindgen_realloc),J=X,q=z.score_faf_enterprise(Q,J);var Y=q[0],I=q[1];if(q[3])throw Y=0,I=0,G(q[2]);return B=Y,H=I,$(Y,I)}finally{z.__wbindgen_free(B,H,1)}};PP.score_faf=function(P){let B,H;try{let Q=h(P,z.__wbindgen_malloc,z.__wbindgen_realloc),J=X,q=z.score_faf(Q,J);var Y=q[0],I=q[1];if(q[3])throw Y=0,I=0,G(q[2]);return B=Y,H=I,$(Y,I)}finally{z.__wbindgen_free(B,H,1)}};function M(P,B){let H=B(P.length*1,1)>>>0;return D().set(P,H/1),X=P.length,H}PP.decompile_fafb=function(P){let B,H;try{let Q=M(P,z.__wbindgen_malloc),J=X,q=z.decompile_fafb(Q,J);var Y=q[0],I=q[1];if(q[3])throw Y=0,I=0,G(q[2]);return B=Y,H=I,$(Y,I)}finally{z.__wbindgen_free(B,H,1)}};PP.score_fafb=function(P){let B,H;try{let Q=M(P,z.__wbindgen_malloc),J=X,q=z.score_fafb(Q,J);var Y=q[0],I=q[1];if(q[3])throw Y=0,I=0,G(q[2]);return B=Y,H=I,$(Y,I)}finally{z.__wbindgen_free(B,H,1)}};PP.validate_faf=function(P){let B=h(P,z.__wbindgen_malloc,z.__wbindgen_realloc),H=X;return z.validate_faf(B,H)!==0};function a(P,B){return P=P>>>0,D().subarray(P/1,P/1+B)}PP.compile_fafb=function(P){let B=h(P,z.__wbindgen_malloc,z.__wbindgen_realloc),H=X,Y=z.compile_fafb(B,H);if(Y[3])throw G(Y[2]);var I=a(Y[0],Y[1]).slice();return z.__wbindgen_free(Y[0],Y[1]*1,1),I};PP.fafb_info=function(P){let B,H;try{let Q=M(P,z.__wbindgen_malloc),J=X,q=z.fafb_info(Q,J);var Y=q[0],I=q[1];if(q[3])throw Y=0,I=0,G(q[2]);return B=Y,H=I,$(Y,I)}finally{z.__wbindgen_free(B,H,1)}};PP.__wbindgen_cast_2241b6af4c4b2941=function(P,B){return $(P,B)};PP.__wbindgen_init_externref_table=function(){let P=z.__wbindgen_externrefs,B=P.grow(4);P.set(0,void 0),P.set(B+0,void 0),P.set(B+1,null),P.set(B+2,!0),P.set(B+3,!1)};var t=`${__dirname}/faf_wasm_sdk_bg.wasm`,r=y("fs").readFileSync(t),e=new WebAssembly.Module(r),z=PP.__wasm=new WebAssembly.Instance(e,x).exports;z.__wbindgen_start()});var N=[{index:1,path:"project.name",description:"Project name",category:"project"},{index:2,path:"project.goal",description:"What the project does",category:"project"},{index:3,path:"project.main_language",description:"Primary language",category:"project"},{index:4,path:"human_context.who",description:"Who is building this",category:"human"},{index:5,path:"human_context.what",description:"What are they building",category:"human"},{index:6,path:"human_context.why",description:"Why does it exist",category:"human"},{index:7,path:"human_context.where",description:"Where does it run",category:"human"},{index:8,path:"human_context.when",description:"When was it started / timeline",category:"human"},{index:9,path:"human_context.how",description:"How is it built",category:"human"},{index:10,path:"stack.frontend",description:"Framework (React, Svelte, etc.)",category:"frontend"},{index:11,path:"stack.css_framework",description:"CSS framework",category:"frontend"},{index:12,path:"stack.ui_library",description:"UI component library",category:"frontend"},{index:13,path:"stack.state_management",description:"State management",category:"frontend"},{index:14,path:"stack.backend",description:"Backend framework",category:"backend"},{index:15,path:"stack.api_type",description:"API style (REST, GraphQL, etc.)",category:"backend"},{index:16,path:"stack.runtime",description:"Runtime (Node, Bun, Python, etc.)",category:"backend"},{index:17,path:"stack.database",description:"Database",category:"backend"},{index:18,path:"stack.connection",description:"Connection method (Prisma, etc.)",category:"backend"},{index:19,path:"stack.hosting",description:"Hosting platform",category:"universal"},{index:20,path:"stack.build",description:"Build tool",category:"universal"},{index:21,path:"stack.cicd",description:"CI/CD",category:"universal"},{index:22,path:"stack.monorepo_tool",description:"Monorepo tool",category:"enterprise_infra"},{index:23,path:"stack.package_manager",description:"Package manager",category:"enterprise_infra"},{index:24,path:"stack.workspaces",description:"Workspace configuration",category:"enterprise_infra"},{index:25,path:"monorepo.packages_count",description:"Number of packages",category:"enterprise_infra"},{index:26,path:"monorepo.build_orchestrator",description:"Build orchestration tool",category:"enterprise_infra"},{index:27,path:"stack.admin",description:"Admin panel",category:"enterprise_app"},{index:28,path:"stack.cache",description:"Caching layer",category:"enterprise_app"},{index:29,path:"stack.search",description:"Search engine",category:"enterprise_app"},{index:30,path:"stack.storage",description:"Object storage",category:"enterprise_app"},{index:31,path:"monorepo.versioning_strategy",description:"Version strategy",category:"enterprise_ops"},{index:32,path:"monorepo.shared_configs",description:"Shared configs",category:"enterprise_ops"},{index:33,path:"monorepo.remote_cache",description:"Remote build cache",category:"enterprise_ops"}],g=new Map(N.map((P)=>[P.path,P]));function f(P){return N.filter((B)=>B.category===P)}var p=N.filter((P)=>P.index<=21),d=N,A=new Set(["describe your project goal","development teams","cloud platform","null","none","unknown","n/a","not applicable"]);function m(P){if(P===null||P===void 0||P==="")return!0;if(typeof P==="string")return A.has(P.toLowerCase().trim());if(Array.isArray(P)&&P.length===0)return!0;if(typeof P==="object"&&Object.keys(P).length===0)return!0;return!1}var C=(P)=>(B)=>`\x1B[${P}m${B}\x1B[0m`,S=C("1"),U=C("2"),RP=C("3"),L=(P)=>`\x1B[38;2;0;212;212m${P}\x1B[0m`,O=(P)=>`\x1B[38;5;208m${P}\x1B[0m`;var j=[{name:"TROPHY",indicator:`${O("\uD83C\uDFC6")} ${O("TROPHY")}`,threshold:100},{name:"GOLD",indicator:`${O(S("★"))} ${O("GOLD")}`,threshold:99},{name:"SILVER",indicator:`${L("◆")} ${L("SILVER")}`,threshold:95},{name:"BRONZE",indicator:`${L("◇")} ${L("BRONZE")}`,threshold:85},{name:"GREEN",indicator:`${S("●")} GREEN`,threshold:70},{name:"YELLOW",indicator:`${U("●")} YELLOW`,threshold:55},{name:"RED",indicator:`${U("○")} RED`,threshold:1},{name:"WHITE",indicator:`${U("♡")}`,threshold:0}];function V(P){for(let B of j)if(P>=B.threshold)return B;return j[j.length-1]}function o(P){let B=V(P),H=j.indexOf(B);return H>0?j[H-1]:null}function n(P){return{score:P.score,tier:V(P.score),populated:P.populated,empty:P.empty,ignored:P.ignored,active:P.active,total:P.total,slots:P.slots}}function s(P){let B=[];if(!P||typeof P!=="object")return B.push("File is not a valid YAML mapping"),{valid:!1,errors:B};let H=P;if(!H.faf_version)B.push("Missing required field: faf_version");if(!H.project?.name)B.push("Missing required field: project.name");return{valid:B.length===0,errors:B}}var T={};i(T,{validate:()=>DP,sdkVersion:()=>OP,scoreFafb:()=>LP,scoreEnterprise:()=>jP,score:()=>$P,fafbInfo:()=>NP,decompile:()=>KP,compile:()=>GP});var k=null;function Z(){if(!k)try{k=u()}catch{throw Error(`faf-scoring-kernel not installed.
 
   Run: npm install faf-scoring-kernel
-`)}return k}function XP(P){return JSON.parse(Z().score_faf(P))}function ZP(P){return JSON.parse(Z().score_faf_enterprise(P))}function $P(P){return Z().validate_faf(P)}function jP(P){return Z().compile_fafb(P)}function DP(P){return JSON.parse(Z().decompile_fafb(P))}function GP(P){return JSON.parse(Z().fafb_info(P))}function KP(P){return JSON.parse(Z().score_fafb(P))}function NP(){return Z().sdk_version()}export{o as validateFaf,y as slotsByCategory,T as kernel,p as isPlaceholder,V as getTier,d as getNextTier,m as enrichScore,j as TIERS,c as SLOT_BY_PATH,N as SLOTS,A as PLACEHOLDERS,f as ENTERPRISE_SLOTS,g as BASE_SLOTS};
+`)}return k}function $P(P){return JSON.parse(Z().score_faf(P))}function jP(P){return JSON.parse(Z().score_faf_enterprise(P))}function DP(P){return Z().validate_faf(P)}function GP(P){return Z().compile_fafb(P)}function KP(P){return JSON.parse(Z().decompile_fafb(P))}function NP(P){return JSON.parse(Z().fafb_info(P))}function LP(P){return JSON.parse(Z().score_fafb(P))}function OP(){return Z().sdk_version()}export{s as validateFaf,f as slotsByCategory,T as kernel,m as isPlaceholder,V as getTier,o as getNextTier,n as enrichScore,j as TIERS,g as SLOT_BY_PATH,N as SLOTS,A as PLACEHOLDERS,d as ENTERPRISE_SLOTS,p as BASE_SLOTS};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "faf-cli",
-  "version": "6.0.13",
-  "description": "Persistent AI Context Standard — project DNA for AI. IANA-registered. Anthropic-approved.",
+  "version": "6.0.15",
+  "description": "51,582+ downloads | Claude Code Skills | 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",
@@ -18,12 +18,13 @@
   },
   "files": [
     "dist/**/*",
+    "skills/**/*",
     "README.md",
     "LICENSE",
     "project.faf"
   ],
   "scripts": {
-    "dev": "bun src/cli.ts",
+    "dev": "bun run src/cli.ts",
     "build": "bun build src/cli.ts --outfile dist/cli.js --target=node --minify && bun build src/index.ts --outfile dist/index.js --target=node --minify",
     "compile": "bun build src/cli.ts --compile --bytecode --minify --outfile faf",
     "compile:all": "bun build src/cli.ts --compile --target=bun-darwin-arm64 --outfile faf-darwin-arm64 && bun build src/cli.ts --compile --target=bun-darwin-x64 --outfile faf-darwin-x64 && bun build src/cli.ts --compile --target=bun-linux-x64 --outfile faf-linux-x64 && bun build src/cli.ts --compile --target=bun-windows-x64 --outfile faf-windows-x64.exe",
@@ -31,7 +32,9 @@
     "test:watch": "bun test --watch",
     "lint": "eslint src/**/*.ts",
     "format": "prettier --write 'src/**/*.ts'",
-    "prepublishOnly": "bun run build"
+    "prepublishOnly": "bun run build",
+    "test:coverage": "bun test --coverage",
+    "typecheck": "bun --bun tsc --noEmit"
   },
   "keywords": [
     "faf",
@@ -52,29 +55,30 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Wolfe-Jam/faf-cli.git"
+    "url": "git+https://github.com/Wolfe-Jam/faf-cli.git"
   },
   "homepage": "https://faf.one",
   "bugs": {
     "url": "https://github.com/Wolfe-Jam/faf-cli/issues"
   },
   "dependencies": {
-    "commander": "^14.0.1",
+    "commander": "^14.0.3",
     "faf-scoring-kernel": "^2.0.3",
     "open": "8.4.2",
-    "yaml": "^2.4.1"
+    "yaml": "^2.8.3",
+    "zod": "^3.25.76"
   },
   "optionalDependencies": {
     "@anthropic-ai/sdk": "^0.74.0"
   },
   "devDependencies": {
-    "@types/node": "^22.15.0",
-    "@typescript-eslint/eslint-plugin": "^8.41.0",
-    "@typescript-eslint/parser": "^8.41.0",
-    "eslint": "^9.39.2",
-    "prettier": "^3.2.5",
-    "typescript": "^5.3.3",
-    "typescript-eslint": "^8.57.2"
+    "@types/node": "^22.19.17",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "@typescript-eslint/parser": "^8.58.0",
+    "eslint": "^9.39.4",
+    "prettier": "^3.8.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.58.0"
   },
   "engines": {
     "node": ">=18.0.0"

package/skills/faf/faf-champion/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: faf-champion
+description: Achieve 100% AI-readiness score for your project
+disable-model-invocation: false
+user-invocable: true
+allowed-tools: Bash, Read, Write, Glob, Grep, Task, TodoWrite
+---
+
+# FAF Champion - Achieve 100% AI-Readiness 🏆
+
+This skill helps you achieve a perfect 100% AI-readiness score for your project using the FAF (Foundational AI-Context Format) system.
+
+## Usage
+
+```
+/faf-champion
+```
+
+## What This Does
+
+1. **Analyzes your project** to understand its structure and stack
+2. **Creates or updates** your project.faf file with complete information
+3. **Guides you** through filling any missing context slots
+4. **Validates** the result to ensure 100% score
+5. **Awards** the championship trophy 🏆 when you reach perfection
+
+## Process
+
+### 1. Initial Assessment
+First, I'll check if you have a project.faf file and score it:
+
+```bash
+faf score --verbose
+```
+
+### 2. Auto-Generation
+If no .faf exists or score is low, I'll run the auto-generator:
+
+```bash
+faf auto
+```
+
+### 3. Guided Interview
+For any remaining gaps, I'll use the guided interview:
+
+```bash
+faf go
+```
+
+### 4. Validation
+Finally, I'll validate your achievement:
+
+```bash
+faf check --strict
+```
+
+## Tips for Success
+
+- **Be specific** about your project's purpose and goals
+- **Include examples** of key functionality
+- **Document integrations** with other systems
+- **List all frameworks** and dependencies
+- **Describe your deployment** target
+
+## Championship Benefits
+
+Achieving 100% AI-readiness means:
+- Zero context drift in AI sessions
+- Perfect project understanding
+- Instant onboarding for any AI tool
+- Complete documentation that versions with code
+- Championship-grade engineering practices
+
+## FAF Philosophy
+
+FAF is infrastructure, not just a format. It's the foundational layer that enables AI to understand your project completely, eliminating the "drift tax" of re-explaining context.
+
+Ready to become a champion? Let's begin!

package/skills/faf/faf-quickstart/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: faf-quickstart
+description: Initialize FAF context for your project in seconds
+disable-model-invocation: false
+user-invocable: true
+argument-hint: "[--yolo]"
+allowed-tools: Bash, Read, Write, Glob, Grep
+---
+
+# FAF Quickstart - Zero to Context in Seconds
+
+Get your project AI-ready with minimal setup using FAF's quickstart workflow.
+
+## Usage
+
+```
+/faf-quickstart         # Interactive setup
+/faf-quickstart --yolo  # Express setup with smart defaults
+```
+
+## What This Does
+
+1. **Detects** your project stack automatically
+2. **Creates** a project.faf file with sensible defaults
+3. **Syncs** with CLAUDE.md if it exists
+4. **Scores** your initial AI-readiness
+
+## Express Mode (--yolo)
+
+With the `--yolo` flag, FAF makes intelligent decisions:
+- Auto-detects framework and language
+- Uses directory name as project name
+- Infers purpose from package.json/Cargo.toml
+- Sets sensible defaults for all optional fields
+
+## Interactive Mode
+
+Without flags, you'll be asked key questions:
+- Project name and purpose
+- Main technologies used
+- Architecture overview
+- Key features
+
+## Example Workflow
+
+```bash
+# Check current directory
+pwd
+
+# Quick init with defaults
+faf init --yolo
+
+# Check the score
+faf score
+
+# View the generated context
+cat project.faf
+```
+
+## Next Steps
+
+After quickstart:
+1. Run `/faf-champion` to achieve 100% score
+2. Use `faf sync` to keep CLAUDE.md in sync
+3. Run `faf go` for guided improvements
+4. Check `faf info --faq` for common questions
+
+## Pro Tip
+
+The quickstart creates a solid foundation (usually 70-85% score). For championship-grade context (100%), use the full guided interview with `faf go`.

package/skills/faf/faf-sync-master/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: faf-sync-master
+description: Keep .faf and CLAUDE.md perfectly synchronized
+disable-model-invocation: false
+user-invocable: true
+argument-hint: "[--watch]"
+allowed-tools: Bash, Read, Write, Task
+---
+
+# FAF Sync Master - Bi-directional Context Synchronization
+
+Maintain perfect synchronization between your project.faf and CLAUDE.md files, ensuring AI context stays consistent across formats.
+
+## Usage
+
+```
+/faf-sync-master         # One-time sync
+/faf-sync-master --watch # Continuous sync mode
+```
+
+## What This Does
+
+1. **Detects** which file is newer (mtime-based)
+2. **Syncs** content in the correct direction automatically
+3. **Preserves** format-specific features in each file
+4. **Validates** the sync succeeded
+
+## Sync Modes
+
+### Auto Mode (Default)
+- Compares modification times
+- Newer file wins
+- Safe and predictable
+
+### Watch Mode
+- Monitors both files for changes
+- Syncs immediately on save
+- Perfect for active development
+
+### Manual Direction
+```bash
+faf sync --direction push  # .faf → CLAUDE.md
+faf sync --direction pull  # CLAUDE.md → .faf
+```
+
+## How It Works
+
+The sync engine:
+1. Reads both files
+2. Compares timestamps
+3. Transforms content between formats
+4. Preserves bidirectional markers
+5. Updates the target file
+
+## Sync Indicators
+
+Look for these in your files:
+- `**STATUS: BI-SYNC ACTIVE 🔗**` - Sync is working
+- `*Last Sync: [timestamp]*` - When last synced
+- `*Sync Engine: F1-Inspired*` - Using latest engine
+
+## Best Practices
+
+1. **Edit either file** - The sync handles both directions
+2. **Use watch mode** during active development
+3. **Check sync status** with `faf check --trust`
+4. **Let mtime decide** - Avoid forcing direction
+
+## Pro Features
+
+With `FAF_PRO=1`:
+- Tri-sync with MEMORY.md
+- Advanced merge strategies
+- Conflict resolution UI
+- Team sync coordination
+
+## Troubleshooting
+
+If sync seems stuck:
+1. Check both files exist
+2. Verify write permissions
+3. Look for sync markers
+4. Run `faf check --doctor`
+
+The sync engine is battle-tested across thousands of projects. Trust the process!

package/skills/faf/skills.json

@@ -0,0 +1,46 @@
+{
+  "name": "FAF Skills Package",
+  "version": "1.0.0",
+  "description": "Foundational AI-Context Format skills for Claude Code",
+  "author": "FAF Team",
+  "skills": [
+    {
+      "name": "faf-champion",
+      "description": "Achieve 100% AI-readiness score for your project",
+      "category": "optimization",
+      "complexity": "intermediate"
+    },
+    {
+      "name": "faf-quickstart", 
+      "description": "Initialize FAF context for your project in seconds",
+      "argument-hint": "[--yolo]",
+      "category": "setup",
+      "complexity": "beginner"
+    },
+    {
+      "name": "faf-sync-master",
+      "description": "Keep .faf and CLAUDE.md perfectly synchronized",
+      "argument-hint": "[--watch]",
+      "category": "maintenance",
+      "complexity": "beginner"
+    }
+  ],
+  "categories": {
+    "setup": {
+      "name": "Setup & Initialization",
+      "icon": "🚀"
+    },
+    "optimization": {
+      "name": "Optimization & Scoring",
+      "icon": "🏆"
+    },
+    "maintenance": {
+      "name": "Maintenance & Sync",
+      "icon": "🔄"
+    }
+  },
+  "requirements": {
+    "faf-cli": ">=6.0.0",
+    "claude-code": ">=2.0.0"
+  }
+}