bun-sticky 1.0.0 → 1.0.2

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 (200+)
+
+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/CLAUDE.md

@@ -1,81 +1,96 @@
-# 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.
+
+## 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 (200+ 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/PUBLISH-PROTOCOL.md

@@ -3,10 +3,10 @@
 ## Pre-Publish Checklist
 
 ### 1. Code Quality
-- [ ] All 45 tests passing (`bun test`)
-- [ ] Zero TypeScript errors
-- [ ] Zero runtime dependencies
-- [ ] Pure Bun APIs only
+- [x] All 177 tests passing (`bun test`)
+- [x] Zero TypeScript errors
+- [x] Zero runtime dependencies
+- [x] Pure Bun APIs only
 
 ### 2. Version Bump
 ```bash
@@ -18,44 +18,42 @@
 ### 3. Test Suite
 ```bash
 bun test
-# Expect: 45 pass, 0 fail
+# Expect: 177 pass, 0 fail
 ```
 
 ### 4. Manual Verification
 ```bash
-bun run index.ts --version
-bun run index.ts help
-bun run index.ts score
+bunx bun-sticky --version  # ✓
+bunx bun-sticky help       # ✓
+bunx bun-sticky init test  # ✓
+bunx bun-sticky score      # ✓
 ```
 
 ## Publish Commands
 
 ### npm Registry
 ```bash
-# Login (first time)
-npm login
-
-# Publish
-npm publish
+npm publish --access public
 ```
 
-### Bun Package Manager (future)
+### Verify
 ```bash
-# When Bun has its own registry
-bun publish
+npm view bun-sticky
+bunx bun-sticky help
 ```
 
 ## Post-Publish
 
-1. Tag release in git
-2. Update ZIG-n-RUST.md benchmarks
-3. Announce in faf-cli ecosystem
+1. [x] Tag release in git
+2. [ ] Update ZIG-n-RUST.md benchmarks
+3. [ ] Announce in faf-cli ecosystem
 
 ## Version History
 
 | Version | Date | Notes |
 |---------|------|-------|
-| 1.0.0 | TBD | Initial release - Wolfejam slot-based scoring |
+| 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 |
 
 ---
 

package/README.md

@@ -18,7 +18,7 @@ bunx bun-sticky score
    ████     █▄▀  ▀▄▀ █ █
      ▀▀
 
-🥐 Bun Sticky v1.0.0 .faf CLI
+🥐 Bun Sticky v1.0.1 .faf CLI
    Fastest bun under the sum.
 
 ────────────────────────────────────────────────

package/index.ts

@@ -20,19 +20,9 @@ import { getTier } from "./lib/tier.ts";
 // CONSTANTS
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-const VERSION = "1.0.0";
-
-// 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.2";
+
+// 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}
+────────────────────────────────────────────────
 `;
 
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -112,6 +102,72 @@ async function cmdScore(): Promise<void> {
   console.log(`  ${tier.color}${tier.emoji} ${BOLD}${result.score}%${RESET} ${tier.color}${tier.name}${RESET}`);
   console.log(`  ${DIM}Filled: ${result.filled}/${result.total} slots${RESET}`);
   console.log();
+
+  // Show missing slots with copy-paste YAML
+  if (result.missing.length > 0) {
+    console.log(`  ${YELLOW}Add to project.faf:${RESET}`);
+    console.log();
+
+    // Group by section
+    const projectMissing = result.missing.filter(s => s.startsWith("project."));
+    const humanMissing = result.missing.filter(s => s.startsWith("human_context."));
+    const stackMissing = result.missing.filter(s => s.startsWith("stack."));
+
+    if (projectMissing.length > 0) {
+      console.log(`  ${DIM}project:${RESET}`);
+      for (const slot of projectMissing) {
+        const field = slot.replace("project.", "");
+        console.log(`    ${DIM}${field}:${RESET} "${getHint(field)}"`);
+      }
+    }
+
+    if (stackMissing.length > 0) {
+      console.log(`  ${DIM}stack:${RESET}`);
+      for (const slot of stackMissing) {
+        const field = slot.replace("stack.", "");
+        console.log(`    ${DIM}${field}:${RESET} "${getHint(field)}"`);
+      }
+    }
+
+    if (humanMissing.length > 0) {
+      console.log(`  ${DIM}human_context:${RESET}`);
+      for (const slot of humanMissing) {
+        const field = slot.replace("human_context.", "");
+        console.log(`    ${DIM}${field}:${RESET} "${getHint(field)}"`);
+      }
+    }
+    console.log();
+  }
+}
+
+function getHint(field: string): string {
+  const hints: Record<string, string> = {
+    // Project
+    name: "Project name",
+    goal: "What problem does this solve?",
+    main_language: "TypeScript",
+    // Human context - questions that make you think
+    who: "Who is it for?",
+    what: "What does it do?",
+    why: "Why does it exist?",
+    where: "Where is it deployed/used?",
+    when: "When is it due/released?",
+    how: "How is it built?",
+    // Stack
+    frontend: "React",
+    css_framework: "Tailwind",
+    ui_library: "shadcn",
+    state_management: "zustand",
+    backend: "Node.js",
+    api_type: "REST",
+    runtime: "Bun",
+    database: "PostgreSQL",
+    connection: "prisma",
+    hosting: "Vercel",
+    build: "vite",
+    cicd: "GitHub Actions",
+  };
+  return hints[field] || "";
 }
 
 function formatBar(percent: number): string {

package/lib/scorer.ts

@@ -110,6 +110,7 @@ export interface FafScore {
   filled: number;
   total: number;
   score: number;
+  missing: string[];
 }
 
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -215,11 +216,22 @@ export function calculateScore(faf: Record<string, unknown>): FafScore {
   // Calculate final score
   const score = total > 0 ? Math.round((filled / total) * 100) : 0;
 
+  // Find missing slots
+  const missing: string[] = [];
+  for (const category of applicableCategories) {
+    for (const slot of SLOTS[category]) {
+      if (!hasValue(faf, slot)) {
+        missing.push(slot);
+      }
+    }
+  }
+
   return {
     projectType,
     sections,
     filled,
     total,
     score,
+    missing,
   };
 }

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.0",
+  "version": "1.0.2",
   "description": "Fastest bun under the sum. FAF scoring CLI for Bun.",
   "main": "index.ts",
   "type": "module",

package/tests/__snapshots__/sticky.test.ts.snap

@@ -1,117 +1,5 @@
 // Bun Snapshot v1, https://bun.sh/docs/test/snapshots
 
-exports[`Tier 9: Snapshot Testing T9.01 - SLOTS structure snapshot 1`] = `
-{
-  "backend": [
-    "stack.backend",
-    "stack.api_type",
-    "stack.runtime",
-    "stack.database",
-    "stack.connection",
-  ],
-  "frontend": [
-    "stack.frontend",
-    "stack.css_framework",
-    "stack.ui_library",
-    "stack.state_management",
-  ],
-  "human": [
-    "human_context.who",
-    "human_context.what",
-    "human_context.why",
-    "human_context.where",
-    "human_context.when",
-    "human_context.how",
-  ],
-  "project": [
-    "project.name",
-    "project.goal",
-    "project.main_language",
-  ],
-  "universal": [
-    "stack.hosting",
-    "stack.build",
-    "stack.cicd",
-  ],
-}
-`;
-
-exports[`Tier 9: Snapshot Testing T9.02 - TYPE_CATEGORIES snapshot 1`] = `
-{
-  "api": [
-    "project",
-    "backend",
-    "universal",
-    "human",
-  ],
-  "cli": [
-    "project",
-    "human",
-  ],
-  "fullstack": [
-    "project",
-    "frontend",
-    "backend",
-    "universal",
-    "human",
-  ],
-  "library": [
-    "project",
-    "human",
-  ],
-  "mobile": [
-    "project",
-    "human",
-  ],
-  "unknown": [
-    "project",
-    "human",
-  ],
-  "webapp": [
-    "project",
-    "frontend",
-    "universal",
-    "human",
-  ],
-}
-`;
-
-exports[`Tier 9: Snapshot Testing T9.03 - Full CLI score result snapshot 1`] = `
-{
-  "filled": 9,
-  "projectType": "cli",
-  "score": 100,
-  "sections": {
-    "backend": {
-      "filled": 0,
-      "percentage": 0,
-      "total": 0,
-    },
-    "frontend": {
-      "filled": 0,
-      "percentage": 0,
-      "total": 0,
-    },
-    "human": {
-      "filled": 6,
-      "percentage": 100,
-      "total": 6,
-    },
-    "project": {
-      "filled": 3,
-      "percentage": 100,
-      "total": 3,
-    },
-    "universal": {
-      "filled": 0,
-      "percentage": 0,
-      "total": 0,
-    },
-  },
-  "total": 9,
-}
-`;
-
 exports[`Tier 2: Scoring Engine T2.07 - SLOTS structure snapshot 1`] = `
 {
   "backend": [
@@ -151,6 +39,7 @@ exports[`Tier 2: Scoring Engine T2.07 - SLOTS structure snapshot 1`] = `
 exports[`Tier 2: Scoring Engine T2.14 - Full CLI result snapshot 1`] = `
 {
   "filled": 9,
+  "missing": [],
   "projectType": "cli",
   "score": 100,
   "sections": {