FAF WASM SDK

AI Context Format for Browsers and Edge Compute. Sub-10ms context loads globally.

Features

• YAML parsing via serde_yaml (WASM-proven)
• Glass Hood AI-readiness scoring
• 8-tier rating system (🤍 to 🏆)
• Cloudflare Workers / Vercel Edge ready
• <2ms parse + score performance

Installation

npm install @faf/wasm-sdk

Usage

Browser / Node.js

import { initialize, createFAF, scoreFAF } from '@faf/wasm-sdk';

await initialize();

const faf = createFAF(`
project:
  name: my-project
  stack: typescript
`);

console.log(faf.weighted_score);  // 45.0
console.log(faf.tier);            // 🟢

Cloudflare Workers

import init, { FAF } from '@faf/wasm-sdk';

export default {
  async fetch(request) {
    await init();
    const faf = new FAF(yamlContent);
    return Response.json({ score: faf.weighted_score });
  }
};

API

FAF Class

• new FAF(yamlContent) - Parse and score FAF content
• name - Project name
• stack - Technology stack
• weighted_score - Weighted AI-readiness (0-100)
• truth_score - Unweighted average (0-100)
• tier - Tier emoji (🤍🔴🟡🟢🥉🥈🥇🏆)
• completeness - Core DNA score (40% weight)
• clarity - Instructions score (35% weight)
• structure - Context score (15% weight)
• metadata - Metadata score (10% weight)

Hot Path Functions

For maximum edge performance:

import { score_weights_fast, WEIGHTS_F32 } from '@faf/wasm-sdk';

const values = new Float32Array([80, 70, 60, 50]);
const score = score_weights_fast(WEIGHTS_F32, values);

Build

# Install wasm-pack
cargo install wasm-pack

# Build WASM
wasm-pack build --target web --release

# Run tests
wasm-pack test --headless --chrome

Deploy to Cloudflare

npm install -g wrangler
wrangler deploy

Scoring Algorithm

Glass Hood - Full transparency scoring:

| Category | Weight | Description | |----------|--------|-------------| | Completeness | 40% | Core project DNA fields | | Clarity | 35% | AI instructions quality | | Structure | 15% | Context organization | | Metadata | 10% | Versioning and tags |

Tier System

| Score | Tier | Emoji | |-------|------|-------| | 0-12 | White | 🤍 | | 13-25 | Red | 🔴 | | 26-38 | Yellow | 🟡 | | 39-51 | Green | 🟢 | | 52-64 | Bronze | 🥉 | | 65-77 | Silver | 🥈 | | 78-90 | Gold | 🥇 | | 91-100 | Championship | 🏆 |

License

MIT

Links

• FAF Format
• IANA Registration