@ramarivera/coding-buddy 0.7.3 → 0.8.0

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
     },
     "metadata": {
         "description": "Persistent coding companion for Claude Code, Pi, and Oh My Pi (requires bun: https://bun.sh/install)",
-        "version": "0.7.3"
+        "version": "0.8.0"
     },
     "plugins": [
         {
             "name": "coding-buddy",
             "source": "./",
             "description": "Persistent coding companion for Claude Code, Pi, and Oh My Pi. MCP-based terminal pet with ASCII art, stats, reactions, and personality. Requires bun runtime (https://bun.sh/install).",
-            "version": "0.7.3",
+            "version": "0.8.0",
             "author": {
                 "name": "ramarivera"
             },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
     "name": "coding-buddy",
-    "version": "0.7.3",
+    "version": "0.8.0",
     "description": "Persistent coding companion for Claude Code, Pi, and Oh My Pi. MCP-based terminal pet with ASCII art, stats, reactions, and personality.",
     "author": {
         "name": "ramarivera"

package/hooks/file-type-react.sh

@@ -8,4 +8,4 @@ BUN="$(command -v bun 2>/dev/null || true)"
 [ -x "$BUN" ] || BUN="/opt/homebrew/bin/bun"
 [ -x "$BUN" ] || BUN="/usr/local/bin/bun"
 [ -x "$BUN" ] || exit 0
-exec "$BUN" run "$ROOT/server/hooks/legacy-bash.ts" file-type-react.sh || exit 0
+exec "$BUN" run "$ROOT/server/hooks/file-type-react.ts" || exit 0

package/hooks/mood-react.sh

@@ -8,4 +8,4 @@ BUN="$(command -v bun 2>/dev/null || true)"
 [ -x "$BUN" ] || BUN="/opt/homebrew/bin/bun"
 [ -x "$BUN" ] || BUN="/usr/local/bin/bun"
 [ -x "$BUN" ] || exit 0
-exec "$BUN" run "$ROOT/server/hooks/legacy-bash.ts" mood-react.sh || exit 0
+exec "$BUN" run "$ROOT/server/hooks/mood-react.ts" || exit 0

package/hooks/name-react.sh

@@ -8,4 +8,4 @@ BUN="$(command -v bun 2>/dev/null || true)"
 [ -x "$BUN" ] || BUN="/opt/homebrew/bin/bun"
 [ -x "$BUN" ] || BUN="/usr/local/bin/bun"
 [ -x "$BUN" ] || exit 0
-exec "$BUN" run "$ROOT/server/hooks/legacy-bash.ts" name-react.sh || exit 0
+exec "$BUN" run "$ROOT/server/hooks/name-react.ts" || exit 0

package/hooks/react.sh

@@ -8,4 +8,4 @@ BUN="$(command -v bun 2>/dev/null || true)"
 [ -x "$BUN" ] || BUN="/opt/homebrew/bin/bun"
 [ -x "$BUN" ] || BUN="/usr/local/bin/bun"
 [ -x "$BUN" ] || exit 0
-exec "$BUN" run "$ROOT/server/hooks/legacy-bash.ts" react.sh || exit 0
+exec "$BUN" run "$ROOT/server/hooks/react.ts" || exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ramarivera/coding-buddy",
-  "version": "0.7.3",
+  "version": "0.8.0",
   "description": "Persistent coding companion for Claude Code, Pi, and Oh My Pi",
   "type": "module",
   "omp": {

package/scripts/ci/check-statusline.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+# CI golden check for the Claude Code statusline: renders buddy-status.sh
+# against the committed fixture state and asserts the output shape.
+# Run from the repo root: bash scripts/ci/check-statusline.sh
+set -euo pipefail
+
+fixture_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/statusline-fixture" && pwd)"
+payload='{"session_id":"ci","model":{"display_name":"CI"},"workspace":{"current_dir":"."}}'
+
+start=$(date +%s)
+output="$(printf '%s' "$payload" | CLAUDE_CONFIG_DIR="$fixture_dir" bash statusline/buddy-status.sh)"
+elapsed=$(( $(date +%s) - start ))
+
+plain="$(printf '%s' "$output" | sed $'s/\x1b\[[0-9;]*m//g')"
+lines=$(printf '%s\n' "$plain" | wc -l | tr -d ' ')
+
+fail() { echo "FAIL: $1" >&2; printf '%s\n' "$plain" >&2; exit 1; }
+
+name="$(jq -r .name "$fixture_dir/buddy-state/status.json")"
+printf '%s' "$plain" | grep -q "$name" || fail "pet name '$name' missing from output"
+[ "$lines" -ge 4 ] || fail "expected >=4 output lines, got $lines"
+[ "$elapsed" -le 10 ] || fail "statusline took ${elapsed}s (budget 10s)"
+
+echo "OK: statusline rendered $lines lines with '$name' in ${elapsed}s"

package/scripts/ci/statusline-fixture/buddy-state/config.json

@@ -0,0 +1 @@
+{"useCombinedStatus": false}

package/scripts/ci/statusline-fixture/buddy-state/status.json

@@ -0,0 +1,39 @@
+{
+  "name": "Cobalt",
+  "species": "pikachu",
+  "rarity": "uncommon",
+  "stars": "★★",
+  "face": "(@ω@)",
+  "eye": "@",
+  "shiny": false,
+  "hat": "wizard",
+  "reaction": "*does a little dance*",
+  "muted": false,
+  "achievement": "",
+  "frames": [
+    "    /^\\     \n   /\\_/\\   \n  (@ @)  \n   (  ω )   \n   (__)    ",
+    "    /^\\     \n   /\\_/\\   \n   (- -)   \n   (  ω )   \n   (__)    ",
+    "    /^\\     \n   /\\_/\\   \n  (@ @)  \n   (  ~ )   \n   (__)    ",
+    "    /^\\     \n   /\\_/\\   \n  (- -)  \n   (  ω )   \n   (__)    "
+  ],
+  "frameSequence": [
+    0,
+    0,
+    0,
+    0,
+    1,
+    0,
+    0,
+    0,
+    3,
+    0,
+    0,
+    2,
+    0,
+    0,
+    0
+  ],
+  "level": 1,
+  "xp": 0,
+  "mood": "tired"
+}

package/scripts/ci/statusline.tape

@@ -0,0 +1,9 @@
+Output scripts/ci/statusline.gif
+Set Width 1400
+Set Height 500
+Set FontSize 14
+Set Shell "bash"
+Type "echo '{\"session_id\":\"ci\",\"model\":{\"display_name\":\"CI\"},\"workspace\":{\"current_dir\":\".\"}}' | CLAUDE_CONFIG_DIR=scripts/ci/statusline-fixture bash statusline/buddy-status.sh"
+Enter
+Sleep 12s
+Screenshot scripts/ci/statusline.png

package/server/hooks/common.ts

@@ -6,13 +6,23 @@ import { buddyStateDir } from "../path.ts";
 export type JsonObject = Record<string, unknown>;
 
 export interface HookRuntime {
+  clock?: () => HookClock;
   now?: () => number;
   packageRoot?: string;
+  random?: () => number;
   sessionId?: string;
   spawnDetached?: (script: string, args: string[]) => void;
   stateDir?: string;
 }
 
+export interface HookClock {
+  day: number;
+  dayOfWeek: number;
+  hour: number;
+  month: number;
+  nowSeconds: number;
+}
+
 export function parseHookInput(raw: string): JsonObject | null {
   try {
     const value = JSON.parse(raw) as unknown;
@@ -56,6 +66,29 @@ export function nonNegativeInteger(value: unknown, fallback: number): number {
   return fallback;
 }
 
+export function randomIndex(length: number, runtime: HookRuntime = {}): number {
+  return Math.floor((runtime.random?.() ?? Math.random()) * length);
+}
+
+export function pickRandom<T>(values: readonly T[], runtime: HookRuntime = {}): T | undefined {
+  if (values.length === 0) return undefined;
+  return values[randomIndex(values.length, runtime)];
+}
+
+export function hookClock(runtime: HookRuntime = {}): HookClock {
+  if (runtime.clock) return runtime.clock();
+  const nowMs = runtime.now?.() ?? Date.now();
+  const date = new Date(nowMs);
+  const jsDay = date.getDay();
+  return {
+    day: date.getDate(),
+    dayOfWeek: jsDay === 0 ? 7 : jsDay,
+    hour: date.getHours(),
+    month: date.getMonth() + 1,
+    nowSeconds: Math.floor(nowMs / 1000),
+  };
+}
+
 export function isOnCooldown(path: string, cooldownSeconds: number, nowMs: number): boolean {
   try {
     const last = Number.parseInt(readFileSync(path, "utf8").trim(), 10);

package/server/hooks/file-type-react.ts

@@ -0,0 +1,147 @@
+#!/usr/bin/env bun
+
+import { mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+import { fileReactionPool } from "./reaction-data.ts";
+import {
+  fileExists,
+  isOnCooldown,
+  nonNegativeInteger,
+  parseHookInput,
+  pickRandom,
+  readJsonFile,
+  readStdin,
+  resolveHookSessionId,
+  resolveHookStateDir,
+  type HookRuntime,
+} from "./common.ts";
+
+interface BuddyStatus {
+  muted?: unknown;
+  species?: unknown;
+  reaction?: unknown;
+  [key: string]: unknown;
+}
+
+interface FileConfig {
+  commentCooldown?: unknown;
+}
+
+export interface FileTypeReactResult {
+  fileType?: string;
+  reaction?: string;
+  updated: boolean;
+}
+
+const FILE_TYPE_PATTERNS: ReadonlyArray<readonly [string, string]> = [
+  ["readme", "*/README*|*/CHANGELOG*|*/CONTRIBUTING*|*/LICENSE*"],
+  ["package-file", "*/package.json|*/Cargo.toml|*/go.mod|*/go.sum|*/pyproject.toml|*/requirements*.txt"],
+  ["ci-file", "*/.github/workflows/*|*/Jenkinsfile*|*/.gitlab-ci*|*.ci.yml|*.ci.yaml"],
+  ["gitignore", "*/.gitignore|*/.dockerignore|*/.eslintignore|*/.prettierignore|.gitignore|.dockerignore|.eslintignore|.prettierignore"],
+  ["env-file", "*/.env*|.env*"],
+  ["makefile", "*/Makefile*|Makefile*|*.mk"],
+  ["docker-file", "*/Dockerfile*|Dockerfile*|*/docker-compose*|docker-compose*|*.dockerfile"],
+  ["regex-file", "*.regex|*.pattern"],
+  ["css-file", "*.css|*.scss|*.less|*.sass"],
+  ["sql-file", "*.sql|*migration*"],
+  ["lock-file", "*.lock|*/package-lock.json|*/bun.lockb|*/yarn.lock|*/pnpm-lock.yaml"],
+  ["test-file", "*.test.*|*.spec.*|*_test.*|*test_*"],
+  ["doc-file", "*.md|*.rst|*.txt|*.adoc"],
+  ["config-file", "*.json|*.yaml|*.yml|*.toml|*.ini|*.conf"],
+  ["binary-file", "*.png|*.jpg|*.gif|*.woff*|*.ico|*.exe|*.so|*.dylib|*.bin"],
+  ["proto-file", "*.proto|*.graphql|*.gql"],
+  ["lang-python", "*.py"],
+  ["lang-typescript", "*.ts|*.tsx"],
+  ["lang-javascript", "*.js|*.jsx"],
+  ["lang-rust", "*.rs"],
+  ["lang-go", "*.go"],
+  ["lang-java", "*.java"],
+  ["lang-ruby", "*.rb"],
+  ["lang-php", "*.php"],
+  ["lang-c", "*.c|*.h"],
+  ["lang-cpp", "*.cpp|*.hpp"],
+  ["lang-swift", "*.swift"],
+  ["lang-kotlin", "*.kt"],
+  ["lang-haskell", "*.hs"],
+  ["lang-elixir", "*.ex|*.exs"],
+  ["lang-zig", "*.zig"],
+];
+
+function shellGlob(pattern: string): RegExp {
+  let source = "^";
+  for (const character of pattern) {
+    if (character === "*") source += ".*";
+    else if (character === "?") source += ".";
+    else source += character.replace(/[\\^$.*+()[\]{}|]/g, "\\$&");
+  }
+  return new RegExp(`${source}$`);
+}
+
+function matchesAnyPattern(path: string, patterns: string): boolean {
+  return patterns.split("|").some((pattern) => shellGlob(pattern).test(path));
+}
+
+export function fileTypeForPath(filePath: string): string {
+  for (const [fileType, patterns] of FILE_TYPE_PATTERNS) {
+    if (matchesAnyPattern(filePath, patterns)) return fileType;
+  }
+  return "";
+}
+
+function textValue(value: unknown): string {
+  if (typeof value === "string") return value;
+  if (value === null || value === undefined) return "";
+  return typeof value === "object" ? JSON.stringify(value) : String(value);
+}
+
+export function handleFileTypeReact(rawInput: string, runtime: HookRuntime = {}): FileTypeReactResult {
+  const stateDir = resolveHookStateDir(runtime);
+  const statusFile = join(stateDir, "status.json");
+  if (!fileExists(statusFile)) return { updated: false };
+
+  const config = readJsonFile<FileConfig>(join(stateDir, "config.json")) ?? {};
+  const cooldown = nonNegativeInteger(config.commentCooldown, 30);
+  const sid = resolveHookSessionId(runtime);
+  const now = runtime.now?.() ?? Date.now();
+  if (isOnCooldown(join(stateDir, `.last_reaction.${sid}`), cooldown, now)) {
+    return { updated: false };
+  }
+
+  const parsedStatus = readJsonFile<BuddyStatus>(statusFile);
+  const status = parsedStatus ?? {};
+  if (status.muted === true || status.muted === "true") return { updated: false };
+
+  const input = parseHookInput(rawInput);
+  if (!input) return { updated: false };
+  const filePath = textValue(input.file_path);
+  if (!filePath) return { updated: false };
+
+  if ((runtime.random?.() ?? Math.random()) * 100 >= 15) return { updated: false };
+
+  let fileType = fileTypeForPath(filePath);
+  if (!fileType) return { updated: false };
+  if (fileType === "lang-javascript") fileType = "lang-typescript";
+
+  const species = textValue(status.species) || "blob";
+  const reaction = pickRandom(fileReactionPool(species, fileType), runtime);
+  if (!reaction) return { updated: false };
+
+  mkdirSync(stateDir, { recursive: true });
+  writeFileSync(join(stateDir, `.last_reaction.${sid}`), String(Math.floor(now / 1000)));
+  writeFileSync(
+    join(stateDir, `reaction.${sid}.json`),
+    JSON.stringify({ reaction, timestamp: Math.floor(now / 1000) * 1000, reason: fileType }),
+  );
+  if (parsedStatus) writeFileSync(statusFile, JSON.stringify({ ...status, reaction }, null, 2));
+
+  return { fileType, reaction, updated: true };
+}
+
+if (import.meta.main) {
+  try {
+    handleFileTypeReact(await readStdin());
+  } catch {
+    // Claude Code hooks must never fail the turn.
+  }
+  process.exit(0);
+}

package/server/hooks/mood-react.ts

@@ -0,0 +1,107 @@
+#!/usr/bin/env bun
+
+import { mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+import { moodReactionPool } from "./reaction-data.ts";
+import {
+  fileExists,
+  isOnCooldown,
+  nonNegativeInteger,
+  parseHookInput,
+  pickRandom,
+  readJsonFile,
+  readStdin,
+  resolveHookSessionId,
+  resolveHookStateDir,
+  stringField,
+  type HookRuntime,
+} from "./common.ts";
+
+interface BuddyStatus {
+  muted?: unknown;
+  species?: unknown;
+  reaction?: unknown;
+  [key: string]: unknown;
+}
+
+interface MoodConfig {
+  moodCooldown?: unknown;
+}
+
+interface Events {
+  [key: string]: unknown;
+}
+
+export interface MoodReactResult {
+  mood?: "frustrated" | "happy" | "stuck";
+  reaction?: string;
+  updated: boolean;
+}
+
+const MOOD_PATTERNS: ReadonlyArray<readonly [MoodReactResult["mood"], RegExp]> = [
+  ["frustrated", /\bwtf\b|\bugh\b|\bstupid\b|\bbroken\b|why won.?t|\bcome on\b|\bseriously\b|\bdamn\b|\bhell\b|this sucks|hate this|\bgrr\b|\bargh\b|\bannoying\b|\bfrustrat\b|\bterrible\b|\bhorrible\b|\bworst\b/i],
+  ["happy", /\bnice!?\b|\bworks!?\b|\bawesome\b|\bperfect\b|\bgreat\b|love it|\byay\b|\bsweet\b|\bbeautiful\b|\bamazing\b|hell yes|nailed it|fixed it|\bhell yeah\b|\bfantastic\b/i],
+  ["stuck", /\bstuck\b|\bhelp\b|\bconfused\b|don.?t understand|how do i\b|what does\b|why is\b|i can.?t\b|no idea|\blost\b|\bclueless\b|\bbaffled\b|\bpuzzled\b/i],
+];
+
+export function moodForPrompt(prompt: string): MoodReactResult["mood"] {
+  return MOOD_PATTERNS.find(([, pattern]) => pattern.test(prompt))?.[0];
+}
+
+function incrementEvent(stateDir: string, key: string): void {
+  const eventsFile = join(stateDir, "events.json");
+  const parsedEvents = readJsonFile<Events>(eventsFile);
+  if (!parsedEvents && fileExists(eventsFile)) return;
+  const events = parsedEvents ?? {};
+  events[key] = typeof events[key] === "number" ? Number(events[key]) + 1 : 1;
+  writeFileSync(eventsFile, JSON.stringify(events, null, 2));
+}
+
+export function handleMoodReact(rawInput: string, runtime: HookRuntime = {}): MoodReactResult {
+  const stateDir = resolveHookStateDir(runtime);
+  const statusFile = join(stateDir, "status.json");
+  if (!fileExists(statusFile)) return { updated: false };
+
+  const config = readJsonFile<MoodConfig>(join(stateDir, "config.json")) ?? {};
+  const cooldown = nonNegativeInteger(config.moodCooldown, 60);
+  const sid = resolveHookSessionId(runtime);
+  const now = runtime.now?.() ?? Date.now();
+  if (isOnCooldown(join(stateDir, `.last_mood.${sid}`), cooldown, now)) {
+    return { updated: false };
+  }
+
+  const input = parseHookInput(rawInput);
+  if (!input) return { updated: false };
+  const prompt = stringField(input, "prompt");
+  if (!prompt) return { updated: false };
+
+  const parsedStatus = readJsonFile<BuddyStatus>(statusFile);
+  const status = parsedStatus ?? {};
+  if (status.muted === true || status.muted === "true") return { updated: false };
+
+  const mood = moodForPrompt(prompt);
+  if (!mood) return { updated: false };
+  const species = typeof status.species === "string" ? status.species : "blob";
+  const reaction = pickRandom(moodReactionPool(species, mood), runtime);
+  if (!reaction) return { updated: false };
+
+  mkdirSync(stateDir, { recursive: true });
+  writeFileSync(join(stateDir, `.last_mood.${sid}`), String(Math.floor(now / 1000)));
+  writeFileSync(
+    join(stateDir, `reaction.${sid}.json`),
+    JSON.stringify({ reaction, timestamp: Math.floor(now / 1000) * 1000, reason: mood }),
+  );
+  if (parsedStatus) writeFileSync(statusFile, JSON.stringify({ ...status, reaction }, null, 2));
+  incrementEvent(stateDir, `mood_${mood}`);
+
+  return { mood, reaction, updated: true };
+}
+
+if (import.meta.main) {
+  try {
+    handleMoodReact(await readStdin());
+  } catch {
+    // Claude Code hooks must never fail the turn.
+  }
+  process.exit(0);
+}

package/server/hooks/name-react.ts

@@ -0,0 +1,98 @@
+#!/usr/bin/env bun
+
+import { mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+import {
+  DEFAULT_NAME_REACTIONS,
+  NAME_REACTION_POOLS,
+} from "./reaction-data.ts";
+import {
+  fileExists,
+  parseHookInput,
+  pickRandom,
+  readJsonFile,
+  readStdin,
+  resolveHookSessionId,
+  resolveHookStateDir,
+  type JsonObject,
+  type HookRuntime,
+} from "./common.ts";
+
+interface BuddyStatus {
+  muted?: unknown;
+  name?: unknown;
+  species?: unknown;
+  reaction?: unknown;
+  [key: string]: unknown;
+}
+
+export interface NameReactResult {
+  reaction?: string;
+  updated: boolean;
+}
+
+function promptFromInput(input: JsonObject): string {
+  const direct = input.prompt ?? input.message ?? input.user_message;
+  if (direct !== undefined && direct !== null) {
+    return typeof direct === "string" ? direct : String(direct);
+  }
+
+  const messages = input.messages;
+  if (!Array.isArray(messages) || messages.length === 0) return "";
+  const content = (messages[messages.length - 1] as JsonObject | null)?.content;
+  if (Array.isArray(content)) {
+    const first = content[0];
+    return first && typeof first === "object" ? String((first as JsonObject).text ?? "") : "";
+  }
+  return typeof content === "string" ? content : "";
+}
+
+export function hasNameMention(prompt: string, name: string): boolean {
+  if (!name) return false;
+  try {
+    return new RegExp(`(^|[^a-zA-Z])${name}([^a-zA-Z]|$)`, "i").test(prompt);
+  } catch {
+    return false;
+  }
+}
+
+export function handleNameReact(rawInput: string, runtime: HookRuntime = {}): NameReactResult {
+  const stateDir = resolveHookStateDir(runtime);
+  const statusFile = join(stateDir, "status.json");
+  if (!fileExists(statusFile)) return { updated: false };
+
+  const input = parseHookInput(rawInput);
+  if (!input) return { updated: false };
+  const prompt = promptFromInput(input);
+  if (!prompt) return { updated: false };
+
+  const parsedStatus = readJsonFile<BuddyStatus>(statusFile);
+  const status = parsedStatus ?? {};
+  const name = typeof status.name === "string" ? status.name : "";
+  if (!hasNameMention(prompt, name)) return { updated: false };
+  if (status.muted === true || status.muted === "true") return { updated: false };
+
+  const species = typeof status.species === "string" ? status.species : "blob";
+  const reaction = pickRandom(NAME_REACTION_POOLS[species] ?? DEFAULT_NAME_REACTIONS, runtime);
+  if (!reaction) return { updated: false };
+
+  const now = runtime.now?.() ?? Date.now();
+  const sid = resolveHookSessionId(runtime);
+  mkdirSync(stateDir, { recursive: true });
+  if (parsedStatus) writeFileSync(statusFile, JSON.stringify({ ...status, reaction }, null, 2));
+  writeFileSync(
+    join(stateDir, `reaction.${sid}.json`),
+    JSON.stringify({ reaction, timestamp: Math.floor(now / 1000) * 1000, reason: "name" }),
+  );
+
+  return { reaction, updated: true };
+}
+
+if (import.meta.main) {
+  try {
+    handleNameReact(await readStdin());
+  } catch {
+    // Claude Code hooks must never fail the turn.
+  }
+  process.exit(0);
+}