bun-sticky 1.0.3 → 1.0.4

package/PRODUCT-SHEET.md

@@ -0,0 +1,124 @@
+# bun-sticky
+
+## Fastest bun under the sum
+
+**Bun-native FAF scoring CLI with Wolfejam slot-based scoring**
+
+---
+
+## Features
+
+### Zero Dependencies
+Pure Bun APIs only. No node_modules bloat. No supply chain risk.
+
+### TypeScript Native
+No build step. No transpilation. Bun runs TypeScript directly.
+
+### Wolfejam Slot-Based Scoring
+21 slots across 5 categories. Type-aware scoring that knows CLI differs from fullstack.
+
+### Instant Feedback
+Cold start <50ms. Score command <100ms. Fast enough you'll actually use it.
+
+### Bi-Sync
+Keep project.faf and CLAUDE.md in sync. Non-destructive - preserves your content.
+
+### Championship Testing
+328 tests. WJTTC certified. Full Bun test API coverage.
+
+---
+
+## Commands
+
+```bash
+faf score      # Show FAF score + tier
+faf init myapp # Create project.faf
+faf sync       # Sync to CLAUDE.md
+faf help       # Show commands
+```
+
+---
+
+## Tier System
+
+| Score | Tier | Status |
+|-------|------|--------|
+| 100% | Trophy | Perfect |
+| 99%+ | Gold | Exceptional |
+| 95%+ | Silver | Excellent |
+| 85%+ | Bronze | Production ready |
+| 70%+ | Green | Solid |
+| 55%+ | Yellow | Needs work |
+| <55% | Red | Critical |
+
+---
+
+# Specifications
+
+## Scoring Categories
+
+| Category | Slots | Fields |
+|----------|-------|--------|
+| Project | 3 | name, goal, main_language |
+| Frontend | 4 | frontend, css_framework, ui_library, state_management |
+| Backend | 5 | backend, api_type, runtime, database, connection |
+| Universal | 3 | hosting, build, cicd |
+| Human | 6 | who, what, why, where, when, how |
+
+## Type-Aware Slot Counts
+
+| Project Type | Applicable Slots |
+|--------------|------------------|
+| CLI | 9 |
+| Library | 9 |
+| API | 17 |
+| Webapp | 16 |
+| Fullstack | 21 |
+
+## Formula
+
+```
+Score = (Filled Slots / Applicable Slots) × 100
+```
+
+## Performance
+
+| Metric | Target | Actual |
+|--------|--------|--------|
+| Cold start | <50ms | <50ms |
+| Score command | <100ms | <100ms |
+| Dependencies | 0 | 0 |
+
+## Technical
+
+| Spec | Value |
+|------|-------|
+| Runtime | Bun >=1.0.0 |
+| Language | TypeScript (native) |
+| Tests | 328 |
+| License | MIT |
+| Package Size | 24.4 kB |
+
+## Installation
+
+```bash
+# npm
+npm install -g bun-sticky
+
+# bunx (run directly)
+bunx bun-sticky score
+```
+
+## Links
+
+| Resource | URL |
+|----------|-----|
+| npm | https://npmjs.com/package/bun-sticky |
+| GitHub | https://github.com/Wolfe-Jam/bun-sticky |
+| FAF Ecosystem | https://faf.one |
+
+---
+
+*Part of the FAF ecosystem. Built for Bun. Made for Claude Code.*
+
+**v1.0.3** | MIT License | Zero Dependencies

package/PUBLISH-PROTOCOL.md

@@ -56,6 +56,7 @@ bunx bun-sticky help
 | 1.0.1 | 2024-12-22 | Proper publish ceremony, version consistency |
 | 1.0.2 | 2025-12-22 | Test fixes (rounding, TIERS export, Empty tier) |
 | 1.0.3 | 2025-12-22 | Fix sync command overwriting CLAUDE.md |
+| 1.0.4 | 2025-12-22 | Binary renamed to `faf` for ecosystem consistency |
 
 ---
 

package/README.md

@@ -3,7 +3,7 @@
 Fastest bun under the sum. Zero dependencies. Pure Bun.
 
 ```bash
-bunx bun-sticky score
+faf score
 ```
 
 ```
@@ -18,7 +18,7 @@ bunx bun-sticky score
    ████     █▄▀  ▀▄▀ █ █
      ▀▀
 
-🥐 Bun Sticky v1.0.3 .faf CLI
+🥐 Bun Sticky v1.0.4 .faf CLI
    Fastest bun under the sum.
 
 ────────────────────────────────────────────────
@@ -36,7 +36,7 @@ bunx bun-sticky score
 ## Install
 
 ```bash
-bun add -g bun-sticky
+npm install -g bun-sticky
 ```
 
 Or run directly:
@@ -48,10 +48,10 @@ bunx bun-sticky score
 ## Commands
 
 ```bash
-bun-sticky score      # Show FAF score + tier
-bun-sticky init myapp # Create project.faf
-bun-sticky sync       # Sync to CLAUDE.md
-bun-sticky help       # Show commands
+faf score      # Show FAF score + tier
+faf init myapp # Create project.faf
+faf sync       # Sync to CLAUDE.md
+faf help       # Show commands
 ```
 
 ## What is FAF?

package/index.ts

@@ -20,7 +20,7 @@ import { getTier } from "./lib/tier.ts";
 // CONSTANTS
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-const VERSION = "1.0.3";
+const VERSION = "1.0.4";
 
 // Standard colors only (B/W version - color reserved for ZIG poster child)
 const GREEN = "\x1b[32m";
@@ -61,7 +61,7 @@ async function cmdScore(): Promise<void> {
 
   if (!(await file.exists())) {
     console.log(`${RED}No project.faf found${RESET}`);
-    console.log(`${DIM}Run: bun-sticky init <name>${RESET}`);
+    console.log(`${DIM}Run: faf init <name>${RESET}`);
     process.exit(1);
   }
 
@@ -218,7 +218,7 @@ stack:
   await Bun.write("project.faf", template);
   console.log(BANNER);
   console.log(`  ${GREEN}Created${RESET} project.faf`);
-  console.log(`  ${DIM}Run: bun-sticky score${RESET}`);
+  console.log(`  ${DIM}Run: faf score${RESET}`);
   console.log();
 }
 
@@ -327,7 +327,7 @@ switch (cmd) {
   case "init":
     const name = args[1];
     if (!name) {
-      console.log(`${RED}Usage: bun-sticky init <name>${RESET}`);
+      console.log(`${RED}Usage: faf init <name>${RESET}`);
       process.exit(1);
     }
     await cmdInit(name);

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "bun-sticky",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Fastest bun under the sum. FAF scoring CLI for Bun.",
   "main": "index.ts",
   "type": "module",
   "bin": {
-    "bun-sticky": "./index.ts"
+    "faf": "./index.ts"
   },
   "scripts": {
     "start": "bun run index.ts",

package/project.faf

@@ -8,7 +8,7 @@ project:
   goal: Bun-native FAF scoring CLI with wolfejam slot-based system
   main_language: TypeScript
   type: cli
-  version: 1.0.3
+  version: 1.0.4
 
 human_context:
   who: Developers using Bun for fast TypeScript CLIs