bun-sticky 1.0.1 → 1.0.3

package/.claude/commands/score.md

@@ -0,0 +1,12 @@
+# Score Current Project
+
+Run bun-sticky on the current directory to check FAF score.
+
+```bash
+bun run index.ts score
+```
+
+Review the output:
+- Check which slots are missing
+- Suggest improvements to reach next tier
+- Target: 85%+ Bronze for production-ready

package/.claude/commands/test.md

@@ -0,0 +1,15 @@
+# Run WJTTC Test Suite
+
+Run the championship-grade test suite and report results.
+
+```bash
+bun test --summary all
+```
+
+Expected: All tests pass (328+)
+
+If any tests fail:
+1. Identify the failing test
+2. Check the assertion message
+3. Fix the code or test
+4. Re-run until all green

package/.github/FUNDING.yml

@@ -2,4 +2,4 @@
 # Free for devs. Teams and enterprise contact us.
 
 github: wolfejam
-custom: ['https://faf.one/enterprise']
+custom: ['mailto:team@faf.one']

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

@@ -1,81 +1,98 @@
-# Bun Sticky
+# bun-sticky
 
-Fastest bun under the sum. Bun-native .faf CLI.
+Fastest bun under the sum. Bun-native .faf CLI with Wolfejam slot-based scoring.
+
+**🏆 100% Trophy** - 9/9 slots filled
+
+## Quick Commands
 
-## Quick Start
 ```bash
-bunx bun-sticky score    # Score current project
-bunx bun-sticky init app # Create project.faf
-bunx bun-sticky help     # Show commands
+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)
 ```
 
 ## Architecture
+
 ```
 bun-sticky/
-├── index.ts           # CLI + ASCII banner
+├── index.ts              # CLI entry + ASCII banner
 ├── lib/
-│   ├── parser.ts      # Zero-dep YAML parser
-│   ├── scorer.ts      # Wolfejam slot-based scoring
-│   └── tier.ts        # 9-tier system
-├── tests/
-│   └── sticky.test.ts # 177 tests, WJTTC championship
-└── package.json       # Zero dependencies
+│   ├── parser.ts         # Zero-dep YAML parser
+│   ├── scorer.ts         # Wolfejam 21-slot scoring
+│   └── tier.ts           # 7-tier ranking system
+└── tests/
+    ├── sticky.test.ts    # Core unit tests
+    └── wjttc.test.ts     # Championship test suite
 ```
 
-## Core Concepts
+## Scoring System
+
+**Wolfejam Slot-Based Scoring** (NOT Elon weights):
 
-**Wolfejam Slot-Based Scoring** (NOT Elon weights)
 - 21 total slots across 5 categories
-- Type-aware: CLI=9 slots, Fullstack=21 slots
-- Score = Filled Slots / Applicable Slots × 100
+- Type-aware: CLI=9, Fullstack=21, etc.
+- Formula: `Score = (Filled / Applicable) × 100`
+
+| 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 |
+
+## Tier System
 
-**Tier System**
 | Score | Tier | Emoji |
 |-------|------|-------|
-| 100%  | Trophy | 🏆 |
-| 99%+  | Gold   | 🥇 |
-| 95%+  | Silver | 🥈 |
-| 85%+  | Bronze | 🥉 |
-| 70%+  | Green  | 🟢 |
-| 55%+  | Yellow | 🟡 |
-| <55%  | Red    | 🔴 |
+| 100% | Trophy | 🏆 |
+| 99%+ | Gold | 🥇 |
+| 95%+ | Silver | 🥈 |
+| 85%+ | Bronze | 🥉 |
+| 70%+ | Green | 🟢 |
+| 55%+ | Yellow | 🟡 |
+| <55% | Red | 🔴 |
 
 ## Key Files
-| File | Line | What |
-|------|------|------|
-| `lib/scorer.ts` | 16 | SLOTS definition (21 slots) |
-| `lib/scorer.ts` | 68 | TYPE_CATEGORIES mapping |
-| `lib/scorer.ts` | 173 | calculateScore() |
-| `lib/tier.ts` | 22 | getTier() |
-| `lib/parser.ts` | 1 | parseYaml() zero-dep |
-
-## Design Principles
-1. **Zero Dependencies** - Pure Bun APIs
-2. **TypeScript Native** - No build step
-3. **Speed First** - Sub-50ms cold start
-4. **WJTTC Testing** - Championship-grade test suite
-
-## Commands
-| Command | Description |
-|---------|-------------|
-| `score` | Show FAF score + tier |
-| `init <name>` | Create project.faf |
-| `sync` | Sync project.faf → CLAUDE.md |
-| `version` | Show version |
-| `help` | Show help |
+
+| File | Purpose |
+|------|---------|
+| `lib/scorer.ts:16` | SLOTS definition (21 slots) |
+| `lib/scorer.ts:68` | TYPE_CATEGORIES mapping |
+| `lib/scorer.ts:173` | calculateScore() function |
+| `lib/tier.ts:22` | getTier() function |
+| `lib/parser.ts:1` | parseYaml() zero-dep parser |
 
 ## Testing
+
+Championship-grade WJTTC test suite with full Bun test API coverage:
+
+- `test.each` - Parametrized tests
+- `test.concurrent` - Parallel execution
+- `mock`, `spyOn` - Mocking
+- Lifecycle hooks - beforeAll, afterEach, etc.
+- Full matcher suite
+
 ```bash
-bun test
-# 177 tests, 1254 assertions
-# Full Bun API: test.each, mock, spyOn, snapshots
-# WJTTC Championship Grade
+bun test --coverage        # With coverage
+bun test --watch           # Watch mode
+CLAUDECODE=1 bun test      # AI-friendly output
 ```
 
-## Part of FAF Ecosystem
-- **faf-cli** - Full Node.js CLI (15,000+ downloads)
-- **bun-sticky** - Bun-native lite CLI (you are here)
-- **xai-faf-zig** - Ultra-fast Zig implementation
+## Development Rules
+
+1. **Zero Dependencies** - Only Bun native APIs
+2. **No npm repeats** - Follow PUBLISH-PROTOCOL.md exactly
+3. **Tests first** - All changes need tests
+4. **Wolfejam slots only** - Never use Elon weights
+
+## Publishing
+
+**NEVER publish without explicit GO! approval.**
+
+See `PUBLISH-PROTOCOL.md` for the complete ceremony.
 
 ---
-*Zero dependencies. Pure Bun. Wolfejam slot-based scoring.*
+*Part of FAF ecosystem. Built for Claude Code.*

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/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,8 @@ 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 |
 
 ---
 

package/README.md

@@ -18,7 +18,7 @@ bunx bun-sticky score
    ████     █▄▀  ▀▄▀ █ █
      ▀▀
 
-🥐 Bun Sticky v1.0.1 .faf CLI
+🥐 Bun Sticky v1.0.3 .faf CLI
    Fastest bun under the sum.
 
 ────────────────────────────────────────────────
@@ -29,7 +29,7 @@ bunx bun-sticky score
   Project   ████████████ 3/3
   Human     ████████░░░░ 4/6
 
-  🥉 78% Bronze
+  🟢 78% Green
   Filled: 7/9 slots
 ```
 
@@ -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,19 +20,9 @@ import { getTier } from "./lib/tier.ts";
 // CONSTANTS
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-const VERSION = "1.0.1";
-
-// Bun Brand Colors (ANSI 256)
-const BUN_BLUE = "\x1b[38;5;39m";    // #00a6e1
-const BUN_PINK = "\x1b[38;5;205m";   // #ec4899
-const BUN_ORANGE = "\x1b[38;5;215m"; // #f89b4b (medium - croissant)
-const BUN_ORANGE_DARK = "\x1b[38;5;208m";  // dark orange (BUN)
-const BUN_YELLOW = "\x1b[38;5;220m"; // #febc2e
-const BUN_CREAM = "\x1b[38;5;223m";  // Croissant color
-const WHITE = "\x1b[97m";            // bright white (STICKY)
-
-// Standard colors
-const CYAN = "\x1b[36m";
+const VERSION = "1.0.3";
+
+// Standard colors only (B/W version - color reserved for ZIG poster child)
 const GREEN = "\x1b[32m";
 const YELLOW = "\x1b[33m";
 const RED = "\x1b[31m";
@@ -45,21 +35,21 @@ const RESET = "\x1b[0m";
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 const BANNER = `
-${BUN_BLUE}────────────────────────────────────────────────${RESET}
+────────────────────────────────────────────────
 
-   ${BUN_ORANGE}▄▄${RESET}       ${WHITE}▄▀▀▀ ▀█▀ █ ▄▀▀ █▄▀ █ █${RESET}
-  ${BUN_ORANGE}████${RESET}      ${WHITE}▀▀█▄  █  █ █   █▀▄  █${RESET}
-${BUN_ORANGE}██████${RESET}      ${WHITE}▄▄▄▀  █  █ ▀▀▀ █ █  █${RESET}
-${BUN_ORANGE}████████${RESET}
-${BUN_ORANGE}████████${RESET}    ${BUN_ORANGE_DARK}█▀▄  █ █ █▀▄${RESET}
- ${BUN_ORANGE}██████${RESET}     ${BUN_ORANGE_DARK}██▀  █ █ █ █${RESET}
-   ${BUN_ORANGE}████${RESET}     ${BUN_ORANGE_DARK}█▄▀  ▀▄▀ █ █${RESET}
-     ${BUN_ORANGE}▀▀${RESET}
+   ▄▄       ▄▀▀▀ ▀█▀ █ ▄▀▀ █▄▀ █ █
+  ████      ▀▀█▄  █  █ █   █▀▄  █
+██████      ▄▄▄▀  █  █ ▀▀▀ █ █  █
+████████
+████████    █▀▄  █ █ █▀▄
+ ██████     ██▀  █ █ █ █
+   ████     █▄▀  ▀▄▀ █ █
+     ▀▀
 
-${WHITE}🥐 Bun Sticky v${VERSION} .faf CLI${RESET}
-   ${BUN_ORANGE_DARK}Fastest bun under the sum.${RESET}
+🥐 Bun Sticky v${VERSION} .faf CLI
+   Fastest bun under the sum.
 
-${BUN_BLUE}────────────────────────────────────────────────${RESET}
+────────────────────────────────────────────────
 `;
 
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -127,7 +117,7 @@ async function cmdScore(): Promise<void> {
       console.log(`  ${DIM}project:${RESET}`);
       for (const slot of projectMissing) {
         const field = slot.replace("project.", "");
-        console.log(`    ${CYAN}${field}:${RESET} "${getHint(field)}"`);
+        console.log(`    ${DIM}${field}:${RESET} "${getHint(field)}"`);
       }
     }
 
@@ -135,7 +125,7 @@ async function cmdScore(): Promise<void> {
       console.log(`  ${DIM}stack:${RESET}`);
       for (const slot of stackMissing) {
         const field = slot.replace("stack.", "");
-        console.log(`    ${CYAN}${field}:${RESET} "${getHint(field)}"`);
+        console.log(`    ${DIM}${field}:${RESET} "${getHint(field)}"`);
       }
     }
 
@@ -143,7 +133,7 @@ async function cmdScore(): Promise<void> {
       console.log(`  ${DIM}human_context:${RESET}`);
       for (const slot of humanMissing) {
         const field = slot.replace("human_context.", "");
-        console.log(`    ${CYAN}${field}:${RESET} "${getHint(field)}"`);
+        console.log(`    ${DIM}${field}:${RESET} "${getHint(field)}"`);
       }
     }
     console.log();
@@ -247,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");
+    }
+
+    await Bun.write("CLAUDE.md", existing);
+  } else {
+    // Create new minimal CLAUDE.md
+    const claudeMd = `# ${name}
 
-## Score: ${tier.emoji} ${result.score}%
+${goal}
 
-Filled: ${result.filled}/${result.total} slots
+${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();

package/lib/tier.ts

@@ -19,6 +19,16 @@ const DIM = "\x1b[2m";
 const ORANGE = "\x1b[38;5;208m";
 const WHITE = "\x1b[37m";
 
+export const TIERS: Tier[] = [
+  { emoji: "🏆", name: "Trophy", color: YELLOW },
+  { emoji: "🥇", name: "Gold", color: YELLOW },
+  { emoji: "🥈", name: "Silver", color: WHITE },
+  { emoji: "🥉", name: "Bronze", color: ORANGE },
+  { emoji: "🟢", name: "Green", color: GREEN },
+  { emoji: "🟡", name: "Yellow", color: YELLOW },
+  { emoji: "🔴", name: "Red", color: RED },
+];
+
 export function getTier(score: number): Tier {
   if (score >= 105) return { emoji: "🍊", name: "Big Orange", color: ORANGE };
   if (score >= 100) return { emoji: "🏆", name: "Trophy", color: YELLOW };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bun-sticky",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Fastest bun under the sum. FAF scoring CLI for Bun.",
   "main": "index.ts",
   "type": "module",

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.3
 
 human_context:
   who: Developers using Bun for fast TypeScript CLIs