@ramarivera/coding-buddy 0.4.0-alpha.9 → 0.7.0

package/server/art.ts

@@ -1 +1,450 @@
-export * from "../core/render-model.ts";
+/**
+ * ASCII art for all 18 buddy species
+ *
+ * Each species has 3 animation frames (idle variations).
+ * Each frame is 5 lines, ~12 chars wide.
+ * {E} is replaced with the eye character at render time.
+ */
+
+import type { Species, Eye, Hat, Rarity, StatName, BuddyBones } from "../core/engine.ts"
+import { HAT_ART } from "../core/art-data.ts";
+import { getRarityColor } from "./theme.ts";
+export { HAT_ART };
+
+// ─── Species art: 3 frames × 5 lines each ──────────────────────────────────
+
+export const SPECIES_ART: Record<Species, string[][]> = {
+  duck: [
+    ["            ", "    __      ", "  <({E} )___  ", "   (  ._>   ", "    `--'    "],
+    ["            ", "    __      ", "  <({E} )___  ", "   (  ._>   ", "    `--'~   "],
+    ["            ", "    __      ", "  <({E} )___  ", "   (  .__>  ", "    `--'    "],
+  ],
+  goose: [
+    ["            ", "     ({E}>    ", "     ||     ", "   _(__)_   ", "    ^^^^    "],
+    ["            ", "    ({E}>     ", "     ||     ", "   _(__)_   ", "    ^^^^    "],
+    ["            ", "     ({E}>>   ", "     ||     ", "   _(__)_   ", "    ^^^^    "],
+  ],
+  blob: [
+    ["            ", "   .----.   ", "  ( {E}  {E} )  ", "  (      )  ", "   `----'   "],
+    ["            ", "  .------.  ", " (  {E}  {E}  ) ", " (        ) ", "  `------'  "],
+    ["            ", "    .--.    ", "   ({E}  {E})   ", "   (    )   ", "    `--'    "],
+  ],
+  cat: [
+    ["            ", "   /\\_/\\    ", "  ( {E}   {E})  ", "  (  \u03c9  )   ", "  (\")_(\")   "],
+    ["            ", "   /\\_/\\    ", "  ( {E}   {E})  ", "  (  \u03c9  )   ", "  (\")_(\")~  "],
+    ["            ", "   /\\-/\\    ", "  ( {E}   {E})  ", "  (  \u03c9  )   ", "  (\")_(\")   "],
+  ],
+  dragon: [
+    ["            ", "  /^\\  /^\\  ", " <  {E}  {E}  > ", " (   ~~   ) ", "  `-vvvv-'  "],
+    ["            ", "  /^\\  /^\\  ", " <  {E}  {E}  > ", " (        ) ", "  `-vvvv-'  "],
+    ["   ~    ~   ", "  /^\\  /^\\  ", " <  {E}  {E}  > ", " (   ~~   ) ", "  `-vvvv-'  "],
+  ],
+  octopus: [
+    ["            ", "   .----.   ", "  ( {E}  {E} )  ", "  (______)  ", "  /\\/\\/\\/\\  "],
+    ["            ", "   .----.   ", "  ( {E}  {E} )  ", "  (______)  ", "  \\/\\/\\/\\/  "],
+    ["     o      ", "   .----.   ", "  ( {E}  {E} )  ", "  (______)  ", "  /\\/\\/\\/\\  "],
+  ],
+  owl: [
+    ["            ", "   /\\  /\\   ", "  (({E})({E}))  ", "  (  ><  )  ", "   `----'   "],
+    ["            ", "   /\\  /\\   ", "  (({E})({E}))  ", "  (  ><  )  ", "   .----.   "],
+    ["            ", "   /\\  /\\   ", "  (({E})(-))  ", "  (  ><  )  ", "   `----'   "],
+  ],
+  penguin: [
+    ["            ", "  .---.     ", "  ({E}>{E})     ", " /(   )\\    ", "  `---'     "],
+    ["            ", "  .---.     ", "  ({E}>{E})     ", " |(   )|    ", "  `---'     "],
+    ["  .---.     ", "  ({E}>{E})     ", " /(   )\\    ", "  `---'     ", "   ~ ~      "],
+  ],
+  turtle: [
+    ["            ", "   _,--._   ", "  ( {E}  {E} )  ", " /[______]\\ ", "  ``    ``  "],
+    ["            ", "   _,--._   ", "  ( {E}  {E} )  ", " /[______]\\ ", "   ``  ``   "],
+    ["            ", "   _,--._   ", "  ( {E}  {E} )  ", " /[======]\\ ", "  ``    ``  "],
+  ],
+  snail: [
+    ["            ", " {E}    .--.  ", "  \\  ( @ )  ", "   \\_`--'   ", "  ~~~~~~~   "],
+    ["            ", "  {E}   .--.  ", "  |  ( @ )  ", "   \\_`--'   ", "  ~~~~~~~   "],
+    ["            ", " {E}    .--.  ", "  \\  ( @  ) ", "   \\_`--'   ", "   ~~~~~~   "],
+  ],
+  ghost: [
+    ["            ", "   .----.   ", "  / {E}  {E} \\  ", "  |      |  ", "  ~`~``~`~  "],
+    ["            ", "   .----.   ", "  / {E}  {E} \\  ", "  |      |  ", "  `~`~~`~`  "],
+    ["    ~  ~    ", "   .----.   ", "  / {E}  {E} \\  ", "  |      |  ", "  ~~`~~`~~  "],
+  ],
+  axolotl: [
+    ["            ", "}~(______)~{", "}~({E} .. {E})~{", "  ( .--. )  ", "  (_/  \\_)  "],
+    ["            ", "~}(______){~", "~}({E} .. {E}){~", "  ( .--. )  ", "  (_/  \\_)  "],
+    ["            ", "}~(______)~{", "}~({E} .. {E})~{", "  (  --  )  ", "  ~_/  \\_~  "],
+  ],
+  capybara: [
+    ["            ", "  n______n  ", " ( {E}    {E} ) ", " (   oo   ) ", "  `------'  "],
+    ["            ", "  n______n  ", " ( {E}    {E} ) ", " (   Oo   ) ", "  `------'  "],
+    ["    ~  ~    ", "  u______n  ", " ( {E}    {E} ) ", " (   oo   ) ", "  `------'  "],
+  ],
+  cactus: [
+    ["            ", " n  ____  n ", " | |{E}  {E}| | ", " |_|    |_| ", "   |    |   "],
+    ["            ", "    ____    ", " n |{E}  {E}| n ", " |_|    |_| ", "   |    |   "],
+    [" n        n ", " |  ____  | ", " | |{E}  {E}| | ", " |_|    |_| ", "   |    |   "],
+  ],
+  robot: [
+    ["            ", "   .[||].   ", "  [ {E}  {E} ]  ", "  [ ==== ]  ", "  `------'  "],
+    ["            ", "   .[||].   ", "  [ {E}  {E} ]  ", "  [ -==- ]  ", "  `------'  "],
+    ["     *      ", "   .[||].   ", "  [ {E}  {E} ]  ", "  [ ==== ]  ", "  `------'  "],
+  ],
+  rabbit: [
+    ["            ", "   (\\__/)   ", "  ( {E}  {E} )  ", " =(  ..  )= ", "  (\")__(\")" ],
+    ["            ", "   (|__/)   ", "  ( {E}  {E} )  ", " =(  ..  )= ", "  (\")__(\")" ],
+    ["            ", "   (\\__/)   ", "  ( {E}  {E} )  ", " =( .  . )= ", "  (\")__(\")" ],
+  ],
+  mushroom: [
+    ["            ", " .-o-OO-o-. ", "(__________)","   |{E}  {E}|   ", "   |____|   "],
+    ["            ", " .-O-oo-O-. ", "(__________)","   |{E}  {E}|   ", "   |____|   "],
+    ["   . o  .   ", " .-o-OO-o-. ", "(__________)","   |{E}  {E}|   ", "   |____|   "],
+  ],
+  chonk: [
+    ["            ", "  /\\    /\\  ", " ( {E}    {E} ) ", " (   ..   ) ", "  `------'  "],
+    ["            ", "  /\\    /|  ", " ( {E}    {E} ) ", " (   ..   ) ", "  `------'  "],
+    ["            ", "  /\\    /\\  ", " ( {E}    {E} ) ", " (   ..   ) ", "  `------'~ "],
+  ],
+  wyvern: [
+    ["}       {", 
+     "|\\^```^/|",
+     "\\ {E}' '{E} /", 
+     " \\ } { /",
+     " ≈(° °)≈",
+     "   '-'"],
+    ["}       {", 
+     "|\\^```^/|",
+     "\\ {E}' '{E} /", 
+     " \\ } { /",
+     " ≈(° °)≈",
+     "  \x1b[38;2;255;120;0m/\x1b[0m'\x1b[38;2;255;120;0m|\x1b[0m'\x1b[38;2;255;120;0m\\\x1b[0m"],
+    ["}       {", 
+     "|\\^```^/|",
+     "\\ {E}' '{E} /", 
+     " \\ } { /",
+     " ≈(° °)≈",
+     "   'v'"],
+  ],
+  pikachu: [
+    ["            ", "   /\\_/\\   ", "  ({E} {E})  ", "   (  ω )   ", "   (__)    "],
+    ["            ", "   /\\_/\\   ", "   (- -)   ", "   (  ω )   ", "   (__)    "],
+    ["            ", "   /\\_/\\   ", "  ({E} {E})  ", "   (  ~ )   ", "   (__)    "],
+  ],
+};
+
+
+// Wyvern line 0 is `}       {` (7 inner chars between horns).
+// These replace that line so the hat sits between the horns.
+const WYVERN_HAT: Partial<Record<Hat, string>> = {
+  crown:     "} \\^^^/ {",  // \^^^/ (5) centered in 7
+  tophat:    "} [___] {",   // [___] (5) centered in 7
+  propeller: "}  -+-  {",   // -+- (3) centered in 7
+  halo:      "} (   ) {",   // (   ) (5) centered in 7
+  wizard:    "}  /^\\  {",  // /^\ (3) centered in 7
+  beanie:    "} (___) {",   // (___) (5) centered in 7
+  tinyduck:  "}  ,>   {",   // ,> (2) slightly left of center
+};
+
+function applyHat(species: Species, hat: Hat, art: string[]): void {
+  if (hat === "none") return;
+  if (species === "wyvern") {
+    const wyvernLine = WYVERN_HAT[hat];
+    if (wyvernLine) art[0] = wyvernLine;
+  } else if (!art[0].trim()) {
+    art[0] = HAT_ART[hat];
+  }
+}
+
+const SHINY_COLOR = "\x1b[93m"; // bright yellow
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const NC = "\x1b[0m";
+
+export const RARITY_STARS: Record<Rarity, string> = {
+  common: "\u2605",
+  uncommon: "\u2605\u2605",
+  rare: "\u2605\u2605\u2605",
+  epic: "\u2605\u2605\u2605\u2605",
+  legendary: "\u2605\u2605\u2605\u2605\u2605",
+};
+
+// ─── Display width helpers ──────────────────────────────────────────────────
+
+function stripAnsi(s: string): string { return s.replace(/\x1b\[[^m]*m/g, ""); }
+
+// Unicode property escapes (ES2018) are the source of truth for which
+// codepoints terminals render 2 cols wide. The statusline (bash) can't use
+// these directly, so scripts/gen-emoji-widths.ts exports the subset that
+// bash needs into statusline/emoji-widths.data — regenerate on version bumps.
+const EMOJI_PRES_RE = /\p{Emoji_Presentation}/u;
+const EMOJI_RE = /\p{Emoji}/u;
+
+// Precondition: ch is neither a variation selector (U+FE00-U+FE0F) nor ZWJ
+// (U+200D); displayWidth filters those before calling in.
+function charWidth(ch: string): number {
+  if (EMOJI_PRES_RE.test(ch)) return 2;
+  const cp = ch.codePointAt(0)!;
+  if (cp >= 0x2500 && cp <= 0x259F) return 1;
+  if (cp >= 0x3000 && cp <= 0x9FFF) return 2;
+  if (cp >= 0xFF01 && cp <= 0xFF60) return 2;
+  return 1;
+}
+
+export function displayWidth(s: string): number {
+  let w = 0;
+  let upgradable = false;
+  for (const ch of stripAnsi(s)) {
+    const cp = ch.codePointAt(0)!;
+    if (cp === 0xFE0F) {
+      // VS16 forces emoji presentation on the previous codepoint; upgrade
+      // its width from 1 to 2 if it was narrow-but-emoji (e.g. ❤ + VS16).
+      if (upgradable) { w += 1; upgradable = false; }
+      continue;
+    }
+    if ((cp >= 0xFE00 && cp <= 0xFE0E) || cp === 0x200D) {
+      upgradable = false;
+      continue;
+    }
+    const cw = charWidth(ch);
+    w += cw;
+    upgradable = cw === 1 && EMOJI_RE.test(ch);
+  }
+  return w;
+}
+
+/** Pad string with spaces to reach target display width */
+function dpad(s: string, targetW: number): string {
+  const w = displayWidth(s);
+  return w < targetW ? s + " ".repeat(targetW - w) : s;
+}
+
+// ─── Render functions ───────────────────────────────────────────────────────
+
+export function getArtFrame(species: Species, eye: Eye, frame: number = 0): string[] {
+  const frames = SPECIES_ART[species];
+  const f = frames[frame % frames.length];
+  return f.map((line) => line.replace(/\{E\}/g, eye));
+}
+
+// Original 15-tick cycle [0,0,0,0,1,0,0,0,-1,0,0,2,0,0,0]: -1 (blink) becomes
+// index 3 in the pre-baked frames array.
+export const STATUS_FRAME_SEQUENCE: readonly number[] = [
+  0, 0, 0, 0, 1, 0, 0, 0, 3, 0, 0, 2, 0, 0, 0,
+];
+
+// Pre-resolves eye, hat overlay, and blink so the statusline shell does no art
+// work — it just cycles whatever frames the server writes. Each frame is a
+// \n-joined 5-line string (one jq call + mapfile in bash).
+export function getStatusFrames(bones: BuddyBones): {
+  frames: string[];
+  frameSequence: number[];
+} {
+  const resolveFrame = (frameIdx: number, eye: string): string => {
+    const raw = SPECIES_ART[bones.species][frameIdx];
+    const art = raw.map((line) => line.replace(/\{E\}/g, eye));
+    const hatLine = HAT_ART[bones.hat];
+    if (hatLine && !art[0].trim()) {
+      art[0] = hatLine;
+    }
+    return art.join("\n");
+  };
+
+  return {
+    frames: [
+      resolveFrame(0, bones.eye),
+      resolveFrame(1, bones.eye),
+      resolveFrame(2, bones.eye),
+      resolveFrame(0, "-"),
+    ],
+    frameSequence: [...STATUS_FRAME_SEQUENCE],
+  };
+}
+
+export function renderCompanionCard(
+  bones: BuddyBones,
+  name: string,
+  personality: string,
+  reaction?: string,
+  frame: number = 0,
+  width: number = 40,
+): string {
+  const color = getRarityColor(bones.rarity);
+  const stars = RARITY_STARS[bones.rarity];
+  const shiny = bones.shiny ? `${SHINY_COLOR}\u2728 ${NC}` : "";
+  const art = getArtFrame(bones.species, bones.eye, frame);
+  applyHat(bones.species, bones.hat, art);
+
+  // Build the card
+  const W = Math.max(24, width);
+  const hr = "\u2500".repeat(W - 2);
+  const lines: string[] = [];
+
+  // Top border
+  lines.push(`${color}\u256d${hr}\u256e${NC}`);
+
+  // Inner width = W - 2 (borders), content area = W - 4 (borders + padding)
+  const innerW = W - 4;
+
+  // Species art (centered)
+  for (const artLine of art) {
+    if (!artLine.trim()) continue;
+    lines.push(`${color}\u2502${NC}  ${dpad(artLine, innerW)}${color}\u2502${NC}`);
+  }
+
+  // Separator
+  lines.push(`${color}\u251c${"╌".repeat(W - 2)}\u2524${NC}`);
+
+  // Name + rarity
+  const nameStarsRaw = `${BOLD}${name}${NC}  ${color}${stars}${NC}`;
+  lines.push(`${color}\u2502${NC}  ${nameStarsRaw}${" ".repeat(Math.max(0, innerW - displayWidth(name) - 2 - displayWidth(stars)))}${color}\u2502${NC}`);
+
+  const rarityRaw = `${shiny}${color}${BOLD}${bones.rarity.toUpperCase()}${NC} ${bones.species}`;
+  const rarityVis = (bones.shiny ? 3 : 0) + bones.rarity.length + 1 + bones.species.length;
+  lines.push(`${color}\u2502${NC}  ${rarityRaw}${" ".repeat(Math.max(0, innerW - rarityVis))}${color}\u2502${NC}`);
+
+  // Eye + Hat info
+  const cosmeticLine = `eye: ${bones.eye}  hat: ${bones.hat}`;
+  lines.push(`${color}\u2502${NC}  ${DIM}${cosmeticLine}${NC}${" ".repeat(Math.max(0, innerW - displayWidth(cosmeticLine)))}${color}\u2502${NC}`);
+
+  // Separator
+  lines.push(`${color}\u251c${"╌".repeat(W - 2)}\u2524${NC}`);
+
+  // Stats
+  const STAT_NAMES: StatName[] = ["DEBUGGING", "PATIENCE", "CHAOS", "WISDOM", "SNARK"];
+  for (const stat of STAT_NAMES) {
+    const val = bones.stats[stat];
+    const filled = Math.round(val / 10);
+    const bar = "\u2588".repeat(filled) + "\u2591".repeat(10 - filled);
+    const label = stat.slice(0, 3).padEnd(3);
+    const marker = stat === bones.peak ? " \u25b2" : stat === bones.dump ? " \u25bc" : "  ";
+    const valStr = String(val).padStart(3);
+    const statLine = `${DIM}${label}${NC} ${bar} ${valStr}${marker}`;
+    const statVis = 3 + 1 + 10 + 1 + 3 + 2; // label + spaces + bar + val + marker = 20
+    lines.push(`${color}\u2502${NC}  ${statLine}${" ".repeat(Math.max(0, innerW - statVis))}${color}\u2502${NC}`);
+  }
+
+  // Speech bubble (if reaction)
+  if (reaction) {
+    lines.push(`${color}\u251c${"╌".repeat(W - 2)}\u2524${NC}`);
+    const maxMsg = innerW - 3; // "💬 " prefix (💬 = 2 cols + space)
+    const msg = displayWidth(reaction) > maxMsg ? reaction.slice(0, maxMsg - 1) + "\u2026" : reaction;
+    const msgPad = Math.max(0, innerW - displayWidth(msg) - 3);
+    lines.push(`${color}\u2502${NC}  \ud83d\udcac ${msg}${" ".repeat(msgPad)}${color}\u2502${NC}`);
+  }
+
+  // Personality
+  if (personality) {
+    lines.push(`${color}\u251c${"╌".repeat(W - 2)}\u2524${NC}`);
+    const words = personality.split(" ");
+    let line = "";
+    for (const word of words) {
+      if (displayWidth(line) + displayWidth(word) + 1 > innerW) {
+        lines.push(`${color}\u2502${NC}  ${DIM}${dpad(line, innerW)}${NC}${color}\u2502${NC}`);
+        line = word;
+      } else {
+        line = line ? `${line} ${word}` : word;
+      }
+    }
+    if (line) {
+      lines.push(`${color}\u2502${NC}  ${DIM}${dpad(line, innerW)}${NC}${color}\u2502${NC}`);
+    }
+  }
+
+  // Bottom border
+  lines.push(`${color}\u2570${hr}\u256f${NC}`);
+
+  return lines.join("\n");
+}
+
+// ─── Markdown-native render (for MCP tool responses) ───────────────────────
+//
+// Claude Code's UI doesn't render raw ANSI escape codes properly — it strips
+// the ESC byte but leaves "[38;2;...m" as literal text, making the output
+// unreadable. This renderer produces pure markdown with unicode rarity dots
+// instead of ANSI colors, so it renders cleanly in any MCP client UI.
+
+const RARITY_DOT: Record<Rarity, string> = {
+  common:    "\u26AA",  // ⚪ white circle
+  uncommon:  "\uD83D\uDFE2",  // 🟢 green circle
+  rare:      "\uD83D\uDD35",  // 🔵 blue circle
+  epic:      "\uD83D\uDFE3",  // 🟣 purple circle
+  legendary: "\uD83D\uDFE1",  // 🟡 yellow circle
+};
+
+export function renderCompanionCardMarkdown(
+  bones: BuddyBones,
+  name: string,
+  personality: string,
+  reaction?: string,
+  frame: number = 0,
+): string {
+  const dot = RARITY_DOT[bones.rarity];
+  const stars = RARITY_STARS[bones.rarity];
+  const shiny = bones.shiny ? " \u2728" : "";
+  const art = getArtFrame(bones.species, bones.eye, frame);
+  applyHat(bones.species, bones.hat, art);
+
+  // Strip empty lines from art for cleaner rendering
+  const artLines = art.filter((l) => l.trim().length > 0);
+
+  const STAT_NAMES: StatName[] = ["DEBUGGING", "PATIENCE", "CHAOS", "WISDOM", "SNARK"];
+  const statRows = STAT_NAMES.map((stat) => {
+    const val = bones.stats[stat];
+    const filled = Math.round(val / 10);
+    const bar = "\u2588".repeat(filled) + "\u2591".repeat(10 - filled);
+    const marker = stat === bones.peak ? " \u25B2" : stat === bones.dump ? " \u25BC" : "";
+    const label = `**${stat.slice(0, 3)}**${stat.slice(3)}`;
+    return `| ${label} | ${val}${marker} | \`${bar}\` |`;
+  }).join("\n");
+
+  const parts: string[] = [];
+
+  // Header: rarity dot, name, species+rarity, stars, shiny
+  parts.push(`### ${dot} ${name} · \`${bones.rarity.toUpperCase()} ${bones.species}\` · ${stars}${shiny}`);
+  parts.push("");
+
+  // ASCII art in a code block (preserves monospaced formatting)
+  parts.push("```");
+  parts.push(artLines.join("\n"));
+  parts.push("```");
+  parts.push("");
+
+  // Identity line
+  parts.push(`**Identity:** eye \`${bones.eye}\` · hat \`${bones.hat}\``);
+  parts.push("");
+
+  // Stats table
+  parts.push("| Stat | Value | Bar |");
+  parts.push("|---|---|---|");
+  parts.push(statRows);
+  parts.push("");
+
+  // Reaction (if any) — reactions often already contain asterisks
+  // for actions like "*blinks slowly*", so render them verbatim to avoid
+  // accidentally turning italics into bold.
+  if (reaction) {
+    parts.push(`\ud83d\udcac ${reaction}`);
+    parts.push("");
+  }
+
+  // Personality as blockquote
+  if (personality) {
+    parts.push(`> ${personality}`);
+  }
+
+  return parts.join("\n");
+}
+
+// ─── Compact status line render ─────────────────────────────────────────────
+
+export function renderStatusLine(
+  bones: BuddyBones,
+  name: string,
+  reaction?: string,
+): string {
+  const face = SPECIES_ART[bones.species][0][2]?.replace(/\{E\}/g, bones.eye).trim() || "(?)";
+  const color = getRarityColor(bones.rarity);
+  const stars = RARITY_STARS[bones.rarity];
+  const shiny = bones.shiny ? "\u2728" : "";
+  const msg = reaction ? ` \u2502 "${reaction}"` : "";
+  return `${color}${face}${NC} ${BOLD}${name}${NC} ${shiny}${color}${stars}${NC}${msg}`;
+}

package/server/award-xp.ts

@@ -0,0 +1,48 @@
+#!/usr/bin/env bun
+/**
+ * Lightweight XP awarding script — called from shell hooks.
+ * Awards XP for coding events without loading the full MCP server.
+ *
+ * Usage:
+ *   bun run server/award-xp.ts <event> [slot]
+ *
+ * Events: errors_spotted | tests_passed | tests_failed | large_diff | turn | time_spent | buddy_pet
+ */
+
+import { awardXp } from "./xp";
+import { loadCompanionSlot, loadActiveSlot } from "./state";
+import type { XpEvent } from "./xp";
+
+const VALID_EVENTS = new Set([
+  "errors_spotted",
+  "tests_passed",
+  "tests_failed",
+  "large_diff",
+  "turn",
+  "time_spent",
+  "buddy_pet",
+]);
+
+function main(): void {
+  const event = process.argv[2] as string;
+  const slot = process.argv[3] ?? loadActiveSlot();
+
+  if (!event || !VALID_EVENTS.has(event)) {
+    console.error(
+      `Usage: bun run server/award-xp.ts <event> [slot]\nValid events: ${[...VALID_EVENTS].join(" | ")}`,
+    );
+    process.exit(1);
+  }
+
+  // Get species and rarity for bonus calculation
+  const companion = loadCompanionSlot(slot);
+  const species = companion?.bones.species;
+  const rarity = companion?.bones.rarity;
+
+  const state = awardXp(event as XpEvent, slot, species, rarity);
+  console.log(
+    `XP awarded: +${event} → Level ${state.level} (${state.totalXp.toLocaleString()} XP total)`,
+  );
+}
+
+main();

package/server/check-suggestions.ts

@@ -0,0 +1,102 @@
+#!/usr/bin/env bun
+/**
+ * Check for suggestion patterns in the assistant's message.
+ * Called from suggest.sh hook.
+ *
+ * Usage:
+ *   bun run server/check-suggestions.ts <assistant_message>
+ */
+
+import { join } from "path";
+import { writeFileSync, mkdirSync, existsSync } from "fs";
+import { buddyStateDir } from "./path";
+import {
+  checkRepeatedError,
+  checkLargeDiff,
+  checkTodoComment,
+  checkLongFunction,
+  checkNoTestsLongSession,
+  recordTurn,
+  recordSuggestion,
+  isOnCooldown,
+  type Suggestion,
+} from "./suggestions";
+
+const PENDING_FILE = join(buddyStateDir(), ".pending_suggestion.json");
+
+function main(): void {
+  const message = process.argv[2] ?? "";
+  if (!message) {
+    // When called with no args, just record a turn
+    recordTurn();
+    return;
+  }
+
+  // Parse the JSON string (jq -Rs wraps in quotes and escapes)
+  const text = message.replace(/^"/, "").replace(/"$/, "").replace(/\\"/g, '"');
+
+  // Record turn happened
+  recordTurn();
+
+  // Check cooldown
+  if (isOnCooldown(180)) return;
+
+  let suggestion: Suggestion | null = null;
+
+  // Extract error messages
+  const errorPatterns = [
+    /([A-Z][a-z]+Error: .+)/,
+    /(SyntaxError: .+)/,
+    /(TypeError: .+)/,
+    /(ReferenceError: .+)/,
+    /(Error: .+)/,
+    /(panic: .+)/,
+  ];
+
+  for (const pattern of errorPatterns) {
+    const match = text.match(pattern);
+    if (match) {
+      suggestion = checkRepeatedError(match[0]);
+      if (suggestion) break;
+    }
+  }
+
+  // Check for large diffs (look for insertion counts)
+  if (!suggestion) {
+    const diffMatch = text.match(/(\d+)\s+insertions/);
+    if (diffMatch) {
+      const lines = parseInt(diffMatch[1], 10);
+      if (lines > 50) {
+        suggestion = checkLargeDiff(lines);
+      }
+    }
+  }
+
+  // Check for TODO/FIXME
+  if (!suggestion) {
+    suggestion = checkTodoComment(text);
+  }
+
+  // Check for long functions
+  if (!suggestion) {
+    suggestion = checkLongFunction(text);
+  }
+
+  // Check for no-tests-long-session
+  if (!suggestion) {
+    suggestion = checkNoTestsLongSession();
+  }
+
+  if (suggestion) {
+    recordSuggestion();
+    // Write suggestion to file for MCP server to pick up
+    mkdirSync(buddyStateDir(), { recursive: true });
+    writeFileSync(
+      PENDING_FILE,
+      JSON.stringify({ suggestion, timestamp: Date.now() }),
+    );
+    console.log(`Suggestion: ${suggestion.message}`);
+  }
+}
+
+main();

package/server/consolidate.ts

@@ -0,0 +1,33 @@
+#!/usr/bin/env bun
+/**
+ * Lightweight memory consolidation script — called from Stop hook.
+ * Extracts project, bug, and preference signals from the conversation.
+ *
+ * Usage:
+ *   bun run server/consolidate.ts <assistant_message> <user_prompt>
+ *
+ * Both arguments should be the raw text of the messages.
+ */
+
+import { consolidateMemory } from "./memory";
+
+function main(): void {
+  const assistantMessage = process.argv[2] ?? "";
+  const userPrompt = process.argv[3] ?? "";
+
+  if (!assistantMessage && !userPrompt) {
+    console.error("Usage: bun run server/consolidate.ts <assistant_message> <user_prompt>");
+    process.exit(1);
+  }
+
+  try {
+    consolidateMemory(assistantMessage, userPrompt);
+    console.log("Memory consolidated successfully.");
+  } catch (e) {
+    // Non-fatal — memory consolidation should never crash the hook
+    console.error("Memory consolidation failed:", e);
+    process.exit(0); // still exit 0 — don't break the hook
+  }
+}
+
+main();