bun-sticky 1.0.3 → 1.0.5

package/index.ts

@@ -1,349 +0,0 @@
-#!/usr/bin/env bun
-/**
- * 🥐 Bun Sticky - Fastest bun under the sum.
- *
- * Built the Anthropic way:
- * - First principles
- * - Zero dependencies
- * - Native Bun APIs
- * - TypeScript native
- *
- * Wolfejam slot-based scoring (NOT Elon weights).
- * For Claude Codesters.
- */
-
-import { parseYaml, getNestedValue } from "./lib/parser.ts";
-import { calculateScore, FafScore } from "./lib/scorer.ts";
-import { getTier } from "./lib/tier.ts";
-
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// CONSTANTS
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-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";
-const BOLD = "\x1b[1m";
-const DIM = "\x1b[2m";
-const RESET = "\x1b[0m";
-
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// ASCII ART BANNER
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-const BANNER = `
-────────────────────────────────────────────────
-
-   ▄▄       ▄▀▀▀ ▀█▀ █ ▄▀▀ █▄▀ █ █
-  ████      ▀▀█▄  █  █ █   █▀▄  █
-██████      ▄▄▄▀  █  █ ▀▀▀ █ █  █
-████████
-████████    █▀▄  █ █ █▀▄
- ██████     ██▀  █ █ █ █
-   ████     █▄▀  ▀▄▀ █ █
-     ▀▀
-
-🥐 Bun Sticky v${VERSION} .faf CLI
-   Fastest bun under the sum.
-
-────────────────────────────────────────────────
-`;
-
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// COMMANDS
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-async function cmdScore(): Promise<void> {
-  const file = Bun.file("project.faf");
-
-  if (!(await file.exists())) {
-    console.log(`${RED}No project.faf found${RESET}`);
-    console.log(`${DIM}Run: bun-sticky init <name>${RESET}`);
-    process.exit(1);
-  }
-
-  const content = await file.text();
-  const faf = parseYaml(content);
-  const result = calculateScore(faf);
-  const tier = getTier(result.score);
-
-  console.log(BANNER);
-
-  // Project name & type
-  const name = (getNestedValue(faf, "project.name") as string) || "Unknown";
-  console.log(`  Project: ${BOLD}${name}${RESET}`);
-  console.log(`  Type:    ${DIM}${result.projectType}${RESET}`);
-  console.log();
-
-  // Section breakdown (only show applicable sections)
-  const { sections } = result;
-
-  if (sections.project.total > 0) {
-    console.log(`  ${DIM}Project${RESET}   ${formatBar(sections.project.percentage)} ${sections.project.filled}/${sections.project.total}`);
-  }
-  if (sections.frontend.total > 0) {
-    console.log(`  ${DIM}Frontend${RESET}  ${formatBar(sections.frontend.percentage)} ${sections.frontend.filled}/${sections.frontend.total}`);
-  }
-  if (sections.backend.total > 0) {
-    console.log(`  ${DIM}Backend${RESET}   ${formatBar(sections.backend.percentage)} ${sections.backend.filled}/${sections.backend.total}`);
-  }
-  if (sections.universal.total > 0) {
-    console.log(`  ${DIM}Universal${RESET} ${formatBar(sections.universal.percentage)} ${sections.universal.filled}/${sections.universal.total}`);
-  }
-  if (sections.human.total > 0) {
-    console.log(`  ${DIM}Human${RESET}     ${formatBar(sections.human.percentage)} ${sections.human.filled}/${sections.human.total}`);
-  }
-  console.log();
-
-  // Total
-  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 {
-  const width = 12;
-  const filled = Math.round((percent / 100) * width);
-  const empty = width - filled;
-  const bar = "█".repeat(filled) + "░".repeat(empty);
-
-  if (percent >= 85) return `${GREEN}${bar}${RESET}`;
-  if (percent >= 70) return `${GREEN}${bar}${RESET}`;
-  if (percent >= 55) return `${YELLOW}${bar}${RESET}`;
-  return `${RED}${bar}${RESET}`;
-}
-
-async function cmdInit(name: string): Promise<void> {
-  const file = Bun.file("project.faf");
-
-  if (await file.exists()) {
-    console.log(`${YELLOW}project.faf already exists${RESET}`);
-    process.exit(1);
-  }
-
-  const template = `# ${name} - Project DNA
-# Generated by Bun Sticky
-
-faf_version: 2.5.0
-
-project:
-  name: ${name}
-  goal: Define your project goal here
-  main_language: TypeScript
-  type: cli
-  version: 0.1.0
-
-human_context:
-  who: Your target users
-  what: What this project does
-  why: Why it exists
-  where: Where it runs
-  when: When to use it
-  how: How to get started
-
-stack:
-  runtime: Bun
-  build: bun build
-`;
-
-  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();
-}
-
-async function cmdSync(): Promise<void> {
-  const fafFile = Bun.file("project.faf");
-
-  if (!(await fafFile.exists())) {
-    console.log(`${RED}No project.faf found${RESET}`);
-    process.exit(1);
-  }
-
-  const content = await fafFile.text();
-  const faf = parseYaml(content);
-  const name = (getNestedValue(faf, "project.name") as string) || "Project";
-  const goal = (getNestedValue(faf, "project.goal") as string) || "";
-  const result = calculateScore(faf);
-  const tier = getTier(result.score);
-
-  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;
-        }
-      }
-
-      // 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}
-
-${goal}
-
-${scoreBadge}
-
----
-*Synced by Bun Sticky*
-`;
-    await Bun.write("CLAUDE.md", claudeMd);
-  }
-
-  console.log(BANNER);
-  console.log(`  ${GREEN}Synced${RESET} project.faf → CLAUDE.md`);
-  console.log();
-}
-
-function cmdHelp(): void {
-  console.log(BANNER);
-  console.log(`  ${BOLD}Commands${RESET}`);
-  console.log();
-  console.log(`    score       Show FAF score + tier`);
-  console.log(`    init <n>    Create project.faf`);
-  console.log(`    sync        Sync to CLAUDE.md`);
-  console.log(`    version     Show version`);
-  console.log(`    help        Show this help`);
-  console.log();
-  console.log(`  ${DIM}Zero dependencies. Pure Bun.${RESET}`);
-  console.log(`  ${DIM}Wolfejam slot-based scoring.${RESET}`);
-  console.log();
-}
-
-function cmdVersion(): void {
-  console.log(`bun-sticky v${VERSION}`);
-}
-
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// MAIN
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-const args = process.argv.slice(2);
-const cmd = args[0] || "help";
-
-switch (cmd) {
-  case "score":
-    await cmdScore();
-    break;
-  case "init":
-    const name = args[1];
-    if (!name) {
-      console.log(`${RED}Usage: bun-sticky init <name>${RESET}`);
-      process.exit(1);
-    }
-    await cmdInit(name);
-    break;
-  case "sync":
-    await cmdSync();
-    break;
-  case "version":
-  case "-v":
-  case "--version":
-    cmdVersion();
-    break;
-  case "help":
-  case "-h":
-  case "--help":
-  default:
-    cmdHelp();
-    break;
-}

package/lib/parser.ts

@@ -1,75 +0,0 @@
-/**
- * Minimal YAML Parser for .faf files
- *
- * Zero dependencies. Pure Bun.
- * Handles: scalars, nested objects, arrays
- */
-
-export function parseYaml(content: string): Record<string, unknown> {
-  const result: Record<string, unknown> = {};
-  const lines = content.split("\n");
-  const stack: { indent: number; obj: Record<string, unknown> }[] = [
-    { indent: -1, obj: result },
-  ];
-
-  for (const line of lines) {
-    // Skip comments and empty lines
-    if (line.trim().startsWith("#") || line.trim() === "") continue;
-
-    const indent = line.search(/\S/);
-    const trimmed = line.trim();
-
-    // Handle key: value pairs
-    const colonIndex = trimmed.indexOf(":");
-    if (colonIndex === -1) continue;
-
-    const key = trimmed.slice(0, colonIndex).trim();
-    const value = trimmed.slice(colonIndex + 1).trim();
-
-    // Pop stack to find parent
-    while (stack.length > 1 && stack[stack.length - 1].indent >= indent) {
-      stack.pop();
-    }
-
-    const parent = stack[stack.length - 1].obj;
-
-    if (value === "" || value === "|" || value === ">") {
-      // Nested object or multiline
-      const newObj: Record<string, unknown> = {};
-      parent[key] = newObj;
-      stack.push({ indent, obj: newObj });
-    } else if (value.startsWith("[") && value.endsWith("]")) {
-      // Inline array
-      parent[key] = value
-        .slice(1, -1)
-        .split(",")
-        .map((s) => s.trim().replace(/^["']|["']$/g, ""));
-    } else if (value.startsWith("- ")) {
-      // Array item (simple case)
-      parent[key] = [value.slice(2).trim()];
-    } else {
-      // Scalar value
-      parent[key] = value.replace(/^["']|["']$/g, "");
-    }
-  }
-
-  return result;
-}
-
-export function getNestedValue(obj: Record<string, unknown>, path: string): unknown {
-  const parts = path.split(".");
-  let current: unknown = obj;
-  for (const part of parts) {
-    if (current === null || current === undefined) return undefined;
-    if (typeof current !== "object") return undefined;
-    current = (current as Record<string, unknown>)[part];
-  }
-  return current;
-}
-
-export function hasValue(obj: Record<string, unknown>, path: string): boolean {
-  const value = getNestedValue(obj, path);
-  if (value === undefined || value === null) return false;
-  if (typeof value === "string" && value.trim() === "") return false;
-  return true;
-}

package/lib/scorer.ts

@@ -1,237 +0,0 @@
-/**
- * 🥐 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;
-  missing: string[];
-}
-
-// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-// 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;
-
-  // 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

@@ -1,46 +0,0 @@
-/**
- * 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 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 };
-  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;
-}