bun-sticky 1.0.0 → 1.0.1

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,7 +20,7 @@ import { getTier } from "./lib/tier.ts";
 // CONSTANTS
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-const VERSION = "1.0.0";
+const VERSION = "1.0.1";
 
 // Bun Brand Colors (ANSI 256)
 const BUN_BLUE = "\x1b[38;5;39m";    // #00a6e1
@@ -112,6 +112,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(`    ${CYAN}${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(`    ${CYAN}${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(`    ${CYAN}${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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bun-sticky",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "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": {