bun-sticky 1.0.0

package/lib/scorer.ts

@@ -0,0 +1,225 @@
+/**
+ * 🥐 Bun Sticky Scorer - Wolfejam Slot-Based Scoring
+ *
+ * Score = (Filled slots / Applicable slots) × 100
+ *
+ * 21 total slots, type-aware scoring.
+ * Zero dependencies. Pure Bun.
+ */
+
+import { hasValue, getNestedValue } from "./parser.ts";
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// SLOT DEFINITIONS - 21 Slots Total
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+export const SLOTS = {
+  // Project slots (3)
+  project: [
+    "project.name",
+    "project.goal",
+    "project.main_language",
+  ],
+  // Frontend slots (4)
+  frontend: [
+    "stack.frontend",
+    "stack.css_framework",
+    "stack.ui_library",
+    "stack.state_management",
+  ],
+  // Backend slots (5)
+  backend: [
+    "stack.backend",
+    "stack.api_type",
+    "stack.runtime",
+    "stack.database",
+    "stack.connection",
+  ],
+  // Universal slots (3)
+  universal: [
+    "stack.hosting",
+    "stack.build",
+    "stack.cicd",
+  ],
+  // Human context slots (6)
+  human: [
+    "human_context.who",
+    "human_context.what",
+    "human_context.why",
+    "human_context.where",
+    "human_context.when",
+    "human_context.how",
+  ],
+} as const;
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// TYPE DEFINITIONS - Which slots apply to each type
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+export type ProjectType =
+  | "cli"
+  | "library"
+  | "api"
+  | "webapp"
+  | "fullstack"
+  | "mobile"
+  | "unknown";
+
+export const TYPE_CATEGORIES: Record<ProjectType, (keyof typeof SLOTS)[]> = {
+  // CLI/Tool: 9 slots (project + human)
+  cli: ["project", "human"],
+
+  // Library/Package: 9 slots (project + human)
+  library: ["project", "human"],
+
+  // API/Backend: 17 slots (project + backend + universal + human)
+  api: ["project", "backend", "universal", "human"],
+
+  // Web App: 16 slots (project + frontend + universal + human)
+  webapp: ["project", "frontend", "universal", "human"],
+
+  // Fullstack: 21 slots (all)
+  fullstack: ["project", "frontend", "backend", "universal", "human"],
+
+  // Mobile: 9 slots (project + human) - simplified
+  mobile: ["project", "human"],
+
+  // Unknown: 9 slots (project + human) - safe default
+  unknown: ["project", "human"],
+};
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// SCORE INTERFACE
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+export interface SlotSection {
+  filled: number;
+  total: number;
+  percentage: number;
+}
+
+export interface FafScore {
+  projectType: ProjectType;
+  sections: {
+    project: SlotSection;
+    frontend: SlotSection;
+    backend: SlotSection;
+    universal: SlotSection;
+    human: SlotSection;
+  };
+  filled: number;
+  total: number;
+  score: number;
+}
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// SCORING FUNCTIONS
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+/**
+ * Detect project type from .faf content
+ */
+export function detectProjectType(faf: Record<string, unknown>): ProjectType {
+  const type = getNestedValue(faf, "project.type") as string;
+
+  if (type) {
+    const typeLower = type.toLowerCase();
+    if (typeLower.includes("cli")) return "cli";
+    if (typeLower.includes("lib") || typeLower.includes("package")) return "library";
+    if (typeLower.includes("api") || typeLower.includes("backend")) return "api";
+    if (typeLower.includes("web") || typeLower.includes("frontend")) return "webapp";
+    if (typeLower.includes("full")) return "fullstack";
+    if (typeLower.includes("mobile") || typeLower.includes("app")) return "mobile";
+  }
+
+  // Infer from stack
+  const hasFrontend = hasValue(faf, "stack.frontend");
+  const hasBackend = hasValue(faf, "stack.backend") || hasValue(faf, "stack.database");
+
+  if (hasFrontend && hasBackend) return "fullstack";
+  if (hasFrontend) return "webapp";
+  if (hasBackend) return "api";
+
+  return "unknown";
+}
+
+/**
+ * Count filled slots in a section
+ */
+function countSection(
+  faf: Record<string, unknown>,
+  slots: readonly string[],
+  applies: boolean
+): SlotSection {
+  if (!applies) {
+    return { filled: 0, total: 0, percentage: 0 };
+  }
+
+  let filled = 0;
+  for (const slot of slots) {
+    if (hasValue(faf, slot)) filled++;
+  }
+
+  const total = slots.length;
+  const percentage = total > 0 ? Math.round((filled / total) * 100) : 0;
+
+  return { filled, total, percentage };
+}
+
+/**
+ * Calculate score using wolfejam slot-based system
+ * Score = (Filled slots / Applicable slots) × 100
+ */
+export function calculateScore(faf: Record<string, unknown>): FafScore {
+  const projectType = detectProjectType(faf);
+  const applicableCategories = TYPE_CATEGORIES[projectType];
+
+  // Count each section
+  const sections = {
+    project: countSection(
+      faf,
+      SLOTS.project,
+      applicableCategories.includes("project")
+    ),
+    frontend: countSection(
+      faf,
+      SLOTS.frontend,
+      applicableCategories.includes("frontend")
+    ),
+    backend: countSection(
+      faf,
+      SLOTS.backend,
+      applicableCategories.includes("backend")
+    ),
+    universal: countSection(
+      faf,
+      SLOTS.universal,
+      applicableCategories.includes("universal")
+    ),
+    human: countSection(
+      faf,
+      SLOTS.human,
+      applicableCategories.includes("human")
+    ),
+  };
+
+  // Sum totals
+  let filled = 0;
+  let total = 0;
+
+  for (const section of Object.values(sections)) {
+    filled += section.filled;
+    total += section.total;
+  }
+
+  // Calculate final score
+  const score = total > 0 ? Math.round((filled / total) * 100) : 0;
+
+  return {
+    projectType,
+    sections,
+    filled,
+    total,
+    score,
+  };
+}

package/lib/tier.ts

@@ -0,0 +1,36 @@
+/**
+ * Tier System
+ *
+ * The medal hierarchy for FAF scores.
+ * Zero dependencies. Pure Bun.
+ */
+
+export interface Tier {
+  emoji: string;
+  name: string;
+  color: string;
+}
+
+// ANSI colors
+const YELLOW = "\x1b[33m";
+const GREEN = "\x1b[32m";
+const RED = "\x1b[31m";
+const DIM = "\x1b[2m";
+const ORANGE = "\x1b[38;5;208m";
+const WHITE = "\x1b[37m";
+
+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 };
+  if (score >= 99) return { emoji: "🥇", name: "Gold", color: YELLOW };
+  if (score >= 95) return { emoji: "🥈", name: "Silver", color: WHITE };
+  if (score >= 85) return { emoji: "🥉", name: "Bronze", color: ORANGE };
+  if (score >= 70) return { emoji: "🟢", name: "Green", color: GREEN };
+  if (score >= 55) return { emoji: "🟡", name: "Yellow", color: YELLOW };
+  if (score > 0) return { emoji: "🔴", name: "Red", color: RED };
+  return { emoji: "⚪", name: "Empty", color: DIM };
+}
+
+export function isLaunchReady(score: number): boolean {
+  return score >= 85;
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "bun-sticky",
+  "version": "1.0.0",
+  "description": "Fastest bun under the sum. FAF scoring CLI for Bun.",
+  "main": "index.ts",
+  "type": "module",
+  "bin": {
+    "bun-sticky": "./index.ts"
+  },
+  "scripts": {
+    "start": "bun run index.ts",
+    "score": "bun run index.ts score",
+    "test": "bun test"
+  },
+  "keywords": [
+    "faf",
+    "bun",
+    "cli",
+    "scoring",
+    "wolfejam",
+    "ai-context"
+  ],
+  "author": "wolfejam",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Wolfe-Jam/bun-sticky.git"
+  },
+  "homepage": "https://github.com/Wolfe-Jam/bun-sticky",
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "dependencies": {},
+  "devDependencies": {}
+}

package/project.faf

@@ -0,0 +1,23 @@
+# Bun Sticky - Project DNA
+# Fastest bun under the sum
+
+faf_version: 2.5.0
+
+project:
+  name: bun-sticky
+  goal: Bun-native FAF scoring CLI with wolfejam slot-based system
+  main_language: TypeScript
+  type: cli
+  version: 1.0.0
+
+human_context:
+  who: Developers using Bun for fast TypeScript CLIs
+  what: FAF scoring tool that rates project AI-readiness using slot-based scoring
+  why: Speed matters - 10x faster than Node, zero dependencies
+  where: Terminal, CI/CD pipelines, development workflows
+  when: Before commits, during reviews, in automation
+  how: bunx bun-sticky score
+
+stack:
+  runtime: Bun
+  build: none (TypeScript native)

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

@@ -0,0 +1,225 @@
+// 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": [
+    "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 2: Scoring Engine T2.14 - Full CLI 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.15 - 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",
+  ],
+}
+`;