Skip to content

Repository files navigation

Bun Sticky

FAF Trophy 100%

Fastest bun under the sun. Zero dependencies. Mk4 WASM kernel. Pure Bun.

bunx bun-sticky score
────────────────────────────────────────────────

   ▄▄       ▄▀▀▀ ▀█▀ █ ▄▀▀ █▄▀ █ █
  ████      ▀▀█▄  █  █ █   █▀▄  █
██████      ▄▄▄▀  █  █ ▀▀▀ █ █  █
████████
████████    █▀▄  █ █ █▀▄
 ██████     ██▀  █ █ █ █
   ████     █▄▀  ▀▄▀ █ █
     ▀▀

🥐 Bun Sticky v2.1.1
   Fastest bun under the sun.

────────────────────────────────────────────────

  Project: my-cli
  Type:    cli

  🏆 100%  Trophy
  Filled: 11/11 slots
  Powered by faf-wasm-core v1.0.0 (Rust Mk4 WASM)

What is This?

Bun Sticky scores your project's AI-readiness using the Mk4 WASM kernel — the same Rust compiler that powers faf-cli, mcpaas.live, and builder.faf.one. 284μs per score.

FAF (Foundational AI-context Format) is an IANA-registered format — project DNA for AI assistants.

v2.1 — Sticky Stars

  • Star nudge — a tasteful, throttled star-ask at a top-tier score (95%+), so a tool people quietly use finally gets the stars it earns. Interactive terminals only; opt out with BUN_STICKY_NO_NUDGE.
  • faf-wasm-core embedded — Mk4 Rust WASM kernel (322KB), 284μs per score
  • Data-driven slotignore — the .faf file carries the scoring truth
  • 377 tests across 4 suites, zero dependencies

Try It

No install needed:

bunx bun-sticky score       # Score your project (WASM kernel)
bunx bun-sticky wasm-score  # Score with detailed WASM output
bunx bun-sticky bench       # Benchmark: 284μs per score
bunx bun-sticky badge       # Get your mcpaas.live badge
bunx bun-sticky init myapp  # Create project.faf
bunx bun-sticky sync        # Sync to CLAUDE.md
bunx bun-sticky version     # Show version
bunx bun-sticky help        # All commands

Or install globally:

bun install -g bun-sticky

Star nudge: at a top-tier score (95%+), Bun Sticky shows a one-line star-ask — interactive terminals only, capped at 3 shows and throttled to 30 days, silent in CI. Silence it entirely with BUN_STICKY_NO_NUDGE=1.

Scoring

21 slots across 5 categories. Data-driven — the .faf file carries the truth:

  • populated — slot has a value (counts toward score)
  • empty — slot is missing (counts against score)
  • slotignored — slot doesn't apply to this project type (excluded from denominator)

Score = Populated / Active × 100 where Active = Total - Ignored

A CLI project marks frontend/backend slots as slotignored in the .faf file itself. Every engine reads the same file, skips the same slots, gets the same score.

Tiers

Score Tier
100% 🏆 Trophy
99%+ ★ Gold
95%+ ◆ Silver
85%+ ◇ Bronze
70%+ ● Green
55%+ ● Yellow
<55% ○ Red

Speed

  • WASM score: 284μs average (Mk4 Rust kernel)
  • Cold start: <50ms
  • Zero dependencies: Pure Bun APIs
  • TypeScript native: No build step
  • 322KB: Embedded WASM binary

Testing

377 tests across 4 suites. Full Bun test API coverage.

bun test

The Kernel

bun-sticky embeds faf-wasm-core — a kernel router that wraps the published Rust WASM behind a FafKernel interface. Rust today, Zig Cascade tomorrow. Same interface, no consumer changes.

import { init } from "./lib/core";

const kernel = await init("rust");  // or "zig" when Cascade ships
const result = kernel.score(yaml);  // Same interface. Any engine.

Same interface, any engine. One kernel, one truth.

Want More?

bun-sticky scores your project. faf-cli is the full toolchain — 33 MCP tools, bi-sync, tri-sync, and more.

bunx faf-cli auto          # Bun
npx faf-cli auto           # npm
brew install faf-cli && faf auto  # Homebrew

FAF Ecosystem

Part of FAF — over 110k+ downloads; see faf.one/downloads for latest stats. See faf-cli for the full toolchain.

If bun-sticky has been useful, consider starring the repo — it helps others find it.

License

MIT


Part of the FAF ecosystem. Powered by Mk4 WASM.

Releases

Sponsor this project

Packages

Used by

Contributors

Languages