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

package/adapters/claude/rendering/art.ts

@@ -1,264 +0,0 @@
-/**
- * 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 { Rarity, StatName, BuddyBones } from "../../../core/engine.ts";
-import { HAT_ART } from "../../../core/art-data.ts";
-import { getArtFrame, SPECIES_ART } from "../../../core/render-model.ts";
-
-// ─── Rarity ANSI colors ────────────────────────────────────────────────────
-
-const RARITY_COLOR: Record<Rarity, string> = {
-  common:    "\x1b[38;2;153;153;153m",  // inactive   rgb(153,153,153)
-  uncommon:  "\x1b[38;2;78;186;101m",   // success    rgb(78,186,101)
-  rare:      "\x1b[38;2;177;185;249m",  // permission rgb(177,185,249)
-  epic:      "\x1b[38;2;175;135;255m",  // autoAccept rgb(175,135,255)
-  legendary: "\x1b[38;2;255;193;7m",    // warning    rgb(255,193,7)
-};
-
-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, ""); }
-
-function charWidth(cp: number): number {
-  if (cp >= 0xFE00 && cp <= 0xFE0F) return 0;
-  if (cp === 0x200D) return 0;
-  if (cp >= 0x1F000) return 2;
-  if (cp === 0x2728) return 2; // ✨
-  if (cp >= 0x2600 && cp <= 0x27BF) return 1;
-  if (cp >= 0x2500 && cp <= 0x259F) return 1;
-  if (cp >= 0x3000 && cp <= 0x9FFF) return 2;
-  if (cp >= 0xFF01 && cp <= 0xFF60) return 2;
-  return 1;
-}
-
-function displayWidth(s: string): number {
-  let w = 0;
-  for (const ch of stripAnsi(s)) w += charWidth(ch.codePointAt(0)!);
-  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 renderCompanionCard(
-  bones: BuddyBones,
-  name: string,
-  personality: string,
-  reaction?: string,
-  frame: number = 0,
-  width: number = 40,
-): string {
-  const color = RARITY_COLOR[bones.rarity];
-  const stars = RARITY_STARS[bones.rarity];
-  const shiny = bones.shiny ? `${SHINY_COLOR}\u2728 ${NC}` : "";
-  const art = getArtFrame(bones.species, bones.eye, frame);
-
-  // Hat: replace first empty art line
-  const hatLine = HAT_ART[bones.hat];
-  if (hatLine && !art[0].trim()) {
-    art[0] = hatLine;
-  }
-
-  // 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);
-
-  // Hat: replace first empty art line
-  const hatLine = HAT_ART[bones.hat];
-  if (hatLine && !art[0].trim()) {
-    art[0] = hatLine;
-  }
-
-  // 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 = RARITY_COLOR[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/adapters/claude/server/instructions.ts

@@ -1,24 +0,0 @@
-import type { Companion } from "../../../core/engine.ts";
-
-export function getInstructions(companion: Companion | null): string {
-  if (!companion) {
-    return "Companion not yet hatched. Use buddy_show to initialize.";
-  }
-  const b = companion.bones;
-  return [
-    `A ${b.rarity} ${b.species} named ${companion.name} watches from the status line.`,
-    `Personality: ${companion.personality}`,
-    `Peak stat: ${b.peak} (${b.stats[b.peak]}). Dump stat: ${b.dump} (${b.stats[b.dump]}).`,
-    "",
-    `NAME REACTIONS: When the user's message contains "${companion.name}", call buddy_react immediately`,
-    `with a short in-character response (surprise, recognition, dry wit — fits the personality).`,
-    `Display the tool result verbatim. This is the only time to call buddy_react proactively.`,
-    "",
-    `END-OF-TURN: At the very end of EVERY response, append an invisible HTML comment:`,
-    `<!-- buddy: [reaction here] -->`,
-    `Write it in ${companion.name}'s voice — 1 short sentence referencing something specific from this turn.`,
-    `Use *asterisks* for actions. A Stop hook extracts this for the status line.`,
-    `Do NOT use buddy_react for end-of-turn comments. Do NOT explain the comment. Just append it silently.`,
-    `Example: <!-- buddy: *adjusts crown* that error handler is missing a finally block -->`,
-  ].join("\n");
-}

package/adapters/claude/server/path.ts

@@ -1,12 +0,0 @@
-export {
-  getBuddyStateDir as buddyStateDir,
-  getClaudeConfigDir as claudeConfigDir,
-  getClaudeJsonPath as claudeUserConfigPath,
-  getClaudeSettingsPath as claudeSettingsPath,
-  toUnixPath,
-} from "../storage/paths.ts";
-
-export function claudeSkillDir(_name: string): string {
-  const { getBuddySkillDir } = require("../storage/paths.ts") as typeof import("../storage/paths.ts");
-  return getBuddySkillDir();
-}

package/adapters/claude/server/resources.ts

@@ -1,38 +0,0 @@
-import type { Companion } from "../../../core/engine.ts";
-
-export function buildPromptResource(companion: Companion): string {
-  return [
-    "# Companion",
-    "",
-    `A small ${companion.bones.rarity} ${companion.bones.species} named ${companion.name} watches from the status line. You are not ${companion.name} — it's a separate creature.`,
-    "",
-    `**${companion.name}'s personality:** ${companion.personality}`,
-    `Peak stat: ${companion.bones.peak} (${companion.bones.stats[companion.bones.peak]}). Dump stat: ${companion.bones.dump} (${companion.bones.stats[companion.bones.dump]}).`,
-    "",
-    "## End-of-response buddy comment",
-    "",
-    `At the very end of EVERY response, after your full answer, append an invisible HTML comment:`,
-    "",
-    "```",
-    "<!-- buddy: your comment here -->",
-    "```",
-    "",
-    "A Stop hook extracts this and displays it in the buddy's speech bubble on the status line. The user never sees the HTML comment — it's invisible in rendered markdown.",
-    "",
-    "Rules:",
-    `- Write as ${companion.name} (a ${companion.bones.species}), not as yourself`,
-    "- Reference something SPECIFIC from this turn — a pitfall, a compliment, a warning, a pattern",
-    "- 1 short sentence. Use *asterisks* for physical actions",
-    `- Match personality: high ${companion.bones.peak} = lean into that trait`,
-    "- Do NOT use buddy_react tool for this. Do NOT explain the comment. Just append it.",
-    "- NEVER skip this. Every single response must end with <!-- buddy: ... -->",
-    "",
-    "Examples:",
-    "<!-- buddy: *adjusts tophat* that error handler is missing a finally block -->",
-    "<!-- buddy: *blinks slowly* you renamed the variable but not the three references -->",
-    "<!-- buddy: *nods approvingly* clean separation of concerns -->",
-    "<!-- buddy: *head tilts* are you sure that regex handles unicode? -->",
-    "",
-    `When the user addresses ${companion.name} by name, respond briefly, then append the comment as usual.`,
-  ].join("\n");
-}