bun-sticky 1.0.2 → 1.0.4

package/.claude/commands/test.md

@@ -6,7 +6,7 @@ Run the championship-grade test suite and report results.
 bun test --summary all
 ```
 
-Expected: All tests pass (200+)
+Expected: All tests pass (328+)
 
 If any tests fail:
 1. Identify the failing test

package/.github/workflows/ci.yml

@@ -24,6 +24,3 @@ jobs:
 
       - name: Run tests
         run: bun test
-
-      - name: Type check
-        run: bun run tsc --noEmit

package/CLAUDE.md

@@ -2,10 +2,12 @@
 
 Fastest bun under the sum. Bun-native .faf CLI with Wolfejam slot-based scoring.
 
+**🏆 100% Trophy** - 9/9 slots filled
+
 ## Quick Commands
 
 ```bash
-bun test                    # Run WJTTC test suite (200+ tests)
+bun test                    # Run WJTTC test suite (328 tests)
 bun run index.ts score      # Score current project
 bun run index.ts help       # Show commands
 bun publish                 # Publish to npm (see PUBLISH-PROTOCOL.md)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 wolfejam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -3,7 +3,7 @@
 ## Pre-Publish Checklist
 
 ### 1. Code Quality
-- [x] All 177 tests passing (`bun test`)
+- [x] All 328 tests passing (`bun test`)
 - [x] Zero TypeScript errors
 - [x] Zero runtime dependencies
 - [x] Pure Bun APIs only
@@ -18,7 +18,7 @@
 ### 3. Test Suite
 ```bash
 bun test
-# Expect: 177 pass, 0 fail
+# Expect: 328 pass, 0 fail
 ```
 
 ### 4. Manual Verification
@@ -54,6 +54,9 @@ bunx bun-sticky help
 |---------|------|-------|
 | 1.0.0 | 2024-12-22 | Initial release - Wolfejam slot-based scoring, 177 tests |
 | 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.1 .faf CLI
+🥐 Bun Sticky v1.0.4 .faf CLI
    Fastest bun under the sum.
 
 ────────────────────────────────────────────────
@@ -29,14 +29,14 @@ bunx bun-sticky score
   Project   ████████████ 3/3
   Human     ████████░░░░ 4/6
 
-  🥉 78% Bronze
+  🟢 78% Green
   Filled: 7/9 slots
 ```
 
 ## 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?
@@ -97,7 +97,7 @@ Built for Bun's speed:
 
 ## Testing
 
-177 tests. Championship-grade WJTTC test suite.
+328 tests. Championship-grade WJTTC test suite.
 
 ```bash
 bun test

package/index.ts

@@ -20,7 +20,7 @@ import { getTier } from "./lib/tier.ts";
 // CONSTANTS
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-const VERSION = "1.0.2";
+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();
 }
 
@@ -237,20 +237,58 @@ async function cmdSync(): Promise<void> {
   const result = calculateScore(faf);
   const tier = getTier(result.score);
 
-  // Generate CLAUDE.md
-  const claudeMd = `# ${name}
+  const scoreBadge = `**${tier.emoji} ${result.score}% ${tier.name}** - ${result.filled}/${result.total} slots filled`;
+  const claudeFile = Bun.file("CLAUDE.md");
+
+  if (await claudeFile.exists()) {
+    // Update existing CLAUDE.md - preserve content, update/insert score badge
+    let existing = await claudeFile.text();
+    const badgePattern = /^\*\*[🏆🥇🥈🥉🟢🟡🔴⚪🍊]\s*\d+%.*\*\*.*slots filled$/mu;
+
+    if (badgePattern.test(existing)) {
+      // Replace existing badge
+      existing = existing.replace(badgePattern, scoreBadge);
+    } else {
+      // Insert badge after first paragraph (after title + description)
+      const lines = existing.split("\n");
+      let insertIndex = 1;
+
+      // Find first empty line after title
+      for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === "") {
+          insertIndex = i + 1;
+          // Skip consecutive empty lines
+          while (insertIndex < lines.length && lines[insertIndex].trim() === "") {
+            insertIndex++;
+          }
+          break;
+        }
+      }
 
-${goal}
+      // Check if next line is already a heading, insert before it
+      if (lines[insertIndex]?.startsWith("#")) {
+        lines.splice(insertIndex, 0, scoreBadge, "");
+      } else {
+        lines.splice(insertIndex, 0, "", scoreBadge);
+      }
+      existing = lines.join("\n");
+    }
 
-## Score: ${tier.emoji} ${result.score}%
+    await Bun.write("CLAUDE.md", existing);
+  } else {
+    // Create new minimal CLAUDE.md
+    const claudeMd = `# ${name}
 
-Filled: ${result.filled}/${result.total} slots
+${goal}
+
+${scoreBadge}
 
 ---
 *Synced by Bun Sticky*
 `;
+    await Bun.write("CLAUDE.md", claudeMd);
+  }
 
-  await Bun.write("CLAUDE.md", claudeMd);
   console.log(BANNER);
   console.log(`  ${GREEN}Synced${RESET} project.faf → CLAUDE.md`);
   console.log();
@@ -289,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.2",
+  "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.0
+  version: 1.0.4
 
 human_context:
   who: Developers using Bun for fast TypeScript CLIs