@ramarivera/coding-buddy 0.4.0-alpha.8 → 0.6.0

package/server/path.ts

@@ -0,0 +1,82 @@
+// Path utilities and helpers
+//
+// Two related concerns live here:
+//   1. Path normalization (Windows compat) — toUnixPath().
+//   2. Resolution of Claude Code config / state paths — claudeConfigDir,
+//      claudeSettingsPath, claudeSkillDir, claudeUserConfigPath, buddyStateDir.
+//      These honor CLAUDE_CONFIG_DIR so coding-buddy works with Claude Code's
+//      multi-account layout (one CLAUDE_CONFIG_DIR per profile).
+//
+// The shell counterpart of (2) lives in scripts/paths.sh and MUST stay in sync.
+
+import { join } from "path";
+import { homedir } from "os";
+
+// ─── (1) Path normalization ─────────────────────────────────────────────────
+
+// Node's path.join() produces backslash paths on Windows, which bash treats as
+// escape sequences, stripping them entirely (e.g. C:\Users -> C:Users).
+// Use forward slashes in all paths written to config files.
+
+/**
+ * Converts all backslashes in a file path to forward slashes, producing a Unix-style path.
+ *
+ * @param p - The file path to convert.
+ * @returns The converted path with forward slashes.
+ */
+export function toUnixPath(p: string): string {
+  return p.replace(/\\/g, "/");
+}
+
+// ─── (2) Claude config / state path resolvers ───────────────────────────────
+//
+// Resolution rules:
+//   - If CLAUDE_CONFIG_DIR is set: everything lives under
+//     $CLAUDE_CONFIG_DIR/. .claude.json is preferred inside the config dir
+//     when present, falling back to $HOME/.claude.json for setups that
+//     keep it at $HOME. Buddy state goes to $CLAUDE_CONFIG_DIR/buddy-state.
+//   - If CLAUDE_CONFIG_DIR is NOT set: the single-profile defaults —
+//     ~/.claude/, ~/.claude.json, ~/.claude-buddy/.
+
+function envDir(name: string): string | undefined {
+  const v = process.env[name];
+  return v && v.length > 0 ? v : undefined;
+}
+
+export function claudeConfigDir(): string {
+  return envDir("CLAUDE_CONFIG_DIR") ?? join(homedir(), ".claude");
+}
+
+export function claudeSettingsPath(): string {
+  return join(claudeConfigDir(), "settings.json");
+}
+
+export function claudeSkillDir(name: string): string {
+  return join(claudeConfigDir(), "skills", name);
+}
+
+/**
+ * Resolve the path to Claude Code's user-config file (.claude.json).
+ *
+ * When CLAUDE_CONFIG_DIR is set the file lives inside it — we always
+ * resolve there so every read and write stays profile-scoped. Falling
+ * back to $HOME/.claude.json when the in-dir file is missing would
+ * break that isolation: installs in one profile could mutate the
+ * home-level file that a different profile reads. If the in-dir file
+ * doesn't exist yet, callers surface a clear "Start Claude Code once
+ * first" preflight error instead of silently writing to $HOME.
+ *
+ * When CLAUDE_CONFIG_DIR is unset we use $HOME/.claude.json — the
+ * single-profile default.
+ */
+export function claudeUserConfigPath(): string {
+  const cfgDir = envDir("CLAUDE_CONFIG_DIR");
+  if (cfgDir) return join(cfgDir, ".claude.json");
+  return join(homedir(), ".claude.json");
+}
+
+export function buddyStateDir(): string {
+  const cfgDir = envDir("CLAUDE_CONFIG_DIR");
+  if (cfgDir) return join(cfgDir, "buddy-state");
+  return join(homedir(), ".claude-buddy");
+}

package/server/shift-mood.ts

@@ -0,0 +1,43 @@
+#!/usr/bin/env bun
+/**
+ * Lightweight mood shifting script — called from shell hooks.
+ * Shifts mood based on coding events.
+ *
+ * Usage:
+ *   bun run server/shift-mood.ts <trigger> [slot]
+ *
+ * Triggers: tests_pass | tests_fail | error | large_diff | achievement | long_session | idle | rest
+ */
+
+import { shiftMood, MOOD_NAMES, MOOD_COLORS } from "./mood";
+import type { MoodTrigger } from "./mood";
+
+const VALID_TRIGGERS = new Set([
+  "tests_pass",
+  "tests_fail",
+  "error",
+  "large_diff",
+  "achievement",
+  "long_session",
+  "idle",
+  "rest",
+]);
+
+function main(): void {
+  const trigger = process.argv[2] as string;
+
+  if (!trigger || !VALID_TRIGGERS.has(trigger)) {
+    console.error(
+      `Usage: bun run server/shift-mood.ts <trigger>\nValid triggers: ${[...VALID_TRIGGERS].join(" | ")}`,
+    );
+    process.exit(1);
+  }
+
+  const state = shiftMood(trigger as MoodTrigger);
+  const mood = state.current;
+  const color = MOOD_COLORS[mood] ?? "💫";
+  const name = MOOD_NAMES[mood] ?? mood;
+  console.log(`Mood: ${color} ${name} (intensity ${state.intensity}/3)`);
+}
+
+main();

package/{adapters/claude/storage → server}/state.ts

@@ -1,8 +1,12 @@
 /**
- * State management — reads/writes companion data to ~/.claude-buddy/
+ * State management — reads/writes companion data to the buddy state dir.
+ *
+ * The state dir resolves via server/paths.ts (honors CLAUDE_CONFIG_DIR).
+ * Default: ~/.claude-buddy/. With CLAUDE_CONFIG_DIR set:
+ * $CLAUDE_CONFIG_DIR/buddy-state/.
  *
  * Storage layout (v3 — single manifest):
- *   ~/.claude-buddy/
+ *   <state-dir>/
  *     menagerie.json   <- SSOT: { active, companions: { [slot]: Companion } }
  *     reaction.$SID.json  <- transient reaction state (session-scoped)
  *     status.json      <- compact state for the status-line shell script
@@ -23,12 +27,18 @@ import {
   existsSync,
   readdirSync,
   renameSync,
+  rmSync,
 } from "fs";
 import { join } from "path";
-import { homedir } from "os";
-import type { Companion } from "../../../core/engine.ts";
+import type { Companion } from "../core/engine.ts"
+import {
+  buddyStateDir,
+  claudeSettingsPath,
+  claudeUserConfigPath,
+  toUnixPath,
+} from "./path.ts";
 
-const STATE_DIR = join(homedir(), ".claude-buddy");
+export const STATE_DIR = buddyStateDir();
 const MANIFEST_FILE = join(STATE_DIR, "menagerie.json");
 const CONFIG_FILE = join(STATE_DIR, "config.json");
 
@@ -95,7 +105,7 @@ export function slugify(name: string): string {
  */
 export function unusedName(): string {
   const { generateFallbackName } =
-    require("../../../core/reactions.ts") as typeof import("../../../core/reactions.ts");
+    require("../core/reactions.ts") as typeof import("../core/reactions.ts");
   const taken = new Set(Object.keys(loadManifest().companions));
   for (let i = 0; i < 50; i++) {
     const n = generateFallbackName();
@@ -145,6 +155,19 @@ export function saveCompanionSlot(companion: Companion, slot: string): void {
   saveManifest(m);
 }
 
+/**
+ * UPDATE an existing (possibly non-active) companion slot.
+ * Throws if the slot does not exist.
+ */
+export function updateCompanionSlot(slot: string, companion: Companion): void {
+  const m = loadManifest();
+  if (!m.companions[slot]) {
+    throw new Error(`Slot "${slot}" does not exist.`);
+  }
+  m.companions[slot] = companion;
+  saveManifest(m);
+}
+
 export function deleteCompanionSlot(slot: string): void {
   const m = loadManifest();
   delete m.companions[slot];
@@ -267,6 +290,17 @@ export function saveReaction(reaction: string, reason: string): void {
   writeFileSync(reactionFile(), JSON.stringify(state));
 }
 
+// ─── Identity resolution ─────────────────────────────────────────────────────
+
+export function resolveUserId(): string {
+  try {
+    const claudeJson = JSON.parse(readFileSync(claudeUserConfigPath(), "utf8"));
+    return claudeJson.oauthAccount?.accountUuid ?? claudeJson.userID ?? "anon";
+  } catch {
+    return "anon";
+  }
+}
+
 // ─── Config persistence (PR #6: tmux popup settings) ─────────────────────────
 
 export interface BuddyConfig {
@@ -276,6 +310,15 @@ export interface BuddyConfig {
   bubblePosition: "top" | "left";
   showRarity: boolean;
   statusLineEnabled: boolean;
+  bubbleWidth: number;
+  bubbleMargin: number;
+  useCombinedStatus: boolean;
+  rainbowColors?: string[];
+  theme: "dark" | "light" | "auto";
+  moodEnabled: boolean;
+  memoryEnabled: boolean;
+  suggestionsEnabled: boolean;
+  suggestionCooldown: number;
 }
 
 const DEFAULT_CONFIG: BuddyConfig = {
@@ -285,6 +328,14 @@ const DEFAULT_CONFIG: BuddyConfig = {
   bubblePosition: "top",
   showRarity: true,
   statusLineEnabled: false,
+  bubbleWidth: 28,
+  bubbleMargin: 8,
+  useCombinedStatus: false,
+  theme: "auto",
+  moodEnabled: true,
+  memoryEnabled: true,
+  suggestionsEnabled: true,
+  suggestionCooldown: 180,
 };
 
 export function loadConfig(): BuddyConfig {
@@ -318,6 +369,11 @@ export interface StatusState {
   reaction: string;
   muted: boolean;
   achievement: string;
+  frames: string[];
+  frameSequence: number[];
+  level: number;
+  xp: number;
+  mood: string;
 }
 
 export function writeStatusState(
@@ -325,10 +381,32 @@ export function writeStatusState(
   reaction?: string,
   muted?: boolean,
   achievement?: string,
+  level?: number,
+  xp?: number,
 ): void {
   mkdirSync(STATE_DIR, { recursive: true });
   const { renderFace, RARITY_STARS } =
-    require("../../../core/engine.ts") as typeof import("../../../core/engine.ts");
+    require("../core/engine.ts") as typeof import("../core/engine.ts");
+  const { getStatusFrames } =
+    require("./art.ts") as typeof import("./art.ts");
+  const { frames, frameSequence } = getStatusFrames(companion.bones);
+  let xpLevel = level ?? 1;
+  let xpTotal = xp ?? 0;
+  let moodStr = "focused";
+  try {
+    const { getXpState } = require("./xp.ts") as typeof import("./xp.ts");
+    const xpState = getXpState();
+    xpLevel = xpState.level;
+    xpTotal = xpState.totalXp;
+  } catch {
+    // XP state is optional during first install / version skew.
+  }
+  try {
+    const { getMood } = require("./mood.ts") as typeof import("./mood.ts");
+    moodStr = getMood().current;
+  } catch {
+    // Mood state is optional during first install / version skew.
+  }
   const state: StatusState = {
     name: companion.name,
     species: companion.bones.species,
@@ -341,7 +419,122 @@ export function writeStatusState(
     reaction: reaction ?? "",
     muted: muted ?? false,
     achievement: achievement ?? "",
+    frames,
+    frameSequence,
+    level: xpLevel,
+    xp: xpTotal,
+    mood: moodStr,
   };
   writeFileSync(join(STATE_DIR, "status.json"), JSON.stringify(state));
 }
 
+// ─── Claude Code settings.json patching (for buddy_statusline tool) ──────────
+
+export const CLAUDE_SETTINGS_PATH = claudeSettingsPath();
+
+/**
+ * Write settings.statusLine pointing to the given buddy-status script.
+ * Atomic via tmp + rename. Returns false if settings.json is unreachable.
+ */
+export function setBuddyStatusLine(
+  statusScript: string,
+  settingsPath: string = CLAUDE_SETTINGS_PATH,
+): boolean {
+  try {
+    const settings = JSON.parse(readFileSync(settingsPath, "utf8"));
+    settings.statusLine = {
+      type: "command",
+      command: toUnixPath(statusScript),
+      padding: 1,
+      refreshInterval: 1,
+    };
+    const tmp = settingsPath + ".tmp";
+    writeFileSync(tmp, JSON.stringify(settings, null, 2) + "\n");
+    renameSync(tmp, settingsPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Remove settings.statusLine — but only if it points to buddy-status.sh.
+ * Leaves foreign statusLines untouched. Returns false if no buddy line was
+ * present or settings.json is unreachable.
+ */
+export function unsetBuddyStatusLine(
+  settingsPath: string = CLAUDE_SETTINGS_PATH,
+): boolean {
+  try {
+    const settings = JSON.parse(readFileSync(settingsPath, "utf8"));
+    if (!settings.statusLine?.command?.includes("buddy-status.sh")) return false;
+    delete settings.statusLine;
+    const tmp = settingsPath + ".tmp";
+    writeFileSync(tmp, JSON.stringify(settings, null, 2) + "\n");
+    renameSync(tmp, settingsPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ─── Plugin uninstall cleanup ───────────────────────────────────────────────
+
+export interface CleanupResult {
+  statusLineRemoved: boolean;
+  foreignStatusLineKept: boolean;
+  transientFilesRemoved: number;
+}
+
+const TRANSIENT_PREFIXES = [
+  "popup-stop.",
+  "popup-resize.",
+  "popup-env.",
+  "popup-scroll.",
+  "popup-reopen-pid.",
+  "reaction.",
+  ".last_reaction.",
+  ".last_comment.",
+];
+
+/**
+ * Clean up plugin-owned writes to the user's global state so that
+ * `claude plugin uninstall` leaves no orphaned entries behind. Specifically:
+ *   - remove settings.statusLine if it points to buddy-status.sh
+ *   - delete session-scoped transient files under ~/.claude-buddy/
+ *
+ * Companion data (menagerie.json, status.json, config.json) is intentionally
+ * kept — users reinstalling get their buddy back. Call-sites that want a full
+ * wipe should delete STATE_DIR themselves after calling this.
+ */
+export function cleanupPluginState(
+  settingsPath: string = CLAUDE_SETTINGS_PATH,
+  stateDir: string = STATE_DIR,
+): CleanupResult {
+  const statusLineRemoved = unsetBuddyStatusLine(settingsPath);
+
+  let foreignStatusLineKept = false;
+  try {
+    const settings = JSON.parse(readFileSync(settingsPath, "utf8"));
+    const cmd = settings.statusLine?.command;
+    if (cmd && !cmd.includes("buddy-status.sh")) foreignStatusLineKept = true;
+  } catch {
+    /* missing settings.json is fine */
+  }
+
+  let transientFilesRemoved = 0;
+  try {
+    if (existsSync(stateDir)) {
+      for (const f of readdirSync(stateDir)) {
+        if (TRANSIENT_PREFIXES.some(p => f.startsWith(p))) {
+          rmSync(join(stateDir, f), { force: true });
+          transientFilesRemoved++;
+        }
+      }
+    }
+  } catch {
+    /* state dir unreadable is fine */
+  }
+
+  return { statusLineRemoved, foreignStatusLineKept, transientFilesRemoved };
+}