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

package/adapters/claude/storage/state.ts

@@ -1,365 +0,0 @@
-/**
- * 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):
- *   <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
- *     config.json      <- user preferences (cooldown, bubble style, etc.)
- *
- * Rules:
- *   - saveCompanionSlot()  APPENDS only — throws if the slot already exists
- *   - saveCompanion()      UPDATES the currently-active slot (rename / personality)
- *   - All manifest writes are atomic (write tmp -> rename)
- *
- * Combined: PR #4 menagerie + PR #6 session isolation + config
- */
-
-import {
-  readFileSync,
-  writeFileSync,
-  mkdirSync,
-  existsSync,
-  readdirSync,
-  renameSync,
-  rmSync,
-} from "fs";
-import { join } from "path";
-import type { Companion } from "../../../core/engine.ts";
-import { getBuddyStateDir } from "./paths.ts";
-
-export const STATE_DIR = getBuddyStateDir();
-const MANIFEST_FILE = join(STATE_DIR, "menagerie.json");
-const CONFIG_FILE = join(STATE_DIR, "config.json");
-
-// ─── Session ID (PR #6: tmux session isolation) ─────────────────────────────
-
-function sessionId(): string {
-  const pane = process.env.TMUX_PANE;
-  if (!pane) return "default";
-  return pane.replace(/^%/, "");
-}
-
-function reactionFile(): string {
-  return join(STATE_DIR, `reaction.${sessionId()}.json`);
-}
-
-// ─── Manifest schema ─────────────────────────────────────────────────────────
-
-interface Manifest {
-  active: string;
-  companions: Record<string, Companion>;
-}
-
-function emptyManifest(): Manifest {
-  return { active: "buddy", companions: {} };
-}
-
-// ─── Atomic manifest I/O ─────────────────────────────────────────────────────
-
-function loadManifest(): Manifest {
-  try {
-    const raw = readFileSync(MANIFEST_FILE, "utf8");
-    const m = JSON.parse(raw) as Manifest;
-    if (!m.companions) m.companions = {};
-    return m;
-  } catch {
-    return emptyManifest();
-  }
-}
-
-function saveManifest(m: Manifest): void {
-  mkdirSync(STATE_DIR, { recursive: true });
-  const tmp = MANIFEST_FILE + ".tmp";
-  writeFileSync(tmp, JSON.stringify(m, null, 2));
-  renameSync(tmp, MANIFEST_FILE); // atomic on same filesystem
-}
-
-// ─── Slot helpers ────────────────────────────────────────────────────────────
-
-/** Normalise a string to a safe slot key (a-z0-9-, max 14 chars). */
-export function slugify(name: string): string {
-  return (
-    name
-      .toLowerCase()
-      .replace(/[^a-z0-9-]/g, "-")
-      .replace(/-+/g, "-")
-      .replace(/^-|-$/g, "")
-      .slice(0, 14) || "buddy"
-  );
-}
-
-/**
- * Return a random fallback name whose slug is not already in the manifest.
- * Falls back to "buddy-<random 3 digits>" if all names are taken.
- */
-export function unusedName(): string {
-  const { generateFallbackName } =
-    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();
-    if (!taken.has(slugify(n))) return n;
-  }
-  let suffix = 0;
-  while (taken.has(`buddy-${suffix}`)) suffix++;
-  return `buddy-${suffix}`;
-}
-
-// ─── Active slot ─────────────────────────────────────────────────────────────
-
-export function loadActiveSlot(): string {
-  const m = loadManifest();
-  if (m.active && m.companions[m.active]) return m.active;
-  const first = Object.keys(m.companions)[0];
-  if (first) {
-    m.active = first;
-    saveManifest(m);
-    return first;
-  }
-  return "buddy";
-}
-
-export function saveActiveSlot(slot: string): void {
-  const m = loadManifest();
-  m.active = slot;
-  saveManifest(m);
-}
-
-// ─── Companion slot API ───────────────────────────────────────────────────────
-
-export function loadCompanionSlot(slot: string): Companion | null {
-  return loadManifest().companions[slot] ?? null;
-}
-
-/**
- * APPEND a new companion to the manifest.
- * Throws if the slot already exists — use saveCompanion() to update an existing buddy.
- */
-export function saveCompanionSlot(companion: Companion, slot: string): void {
-  const m = loadManifest();
-  if (m.companions[slot]) {
-    throw new Error(`Slot "${slot}" already exists. Choose a different name.`);
-  }
-  m.companions[slot] = companion;
-  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];
-  if (m.active === slot) {
-    m.active = Object.keys(m.companions)[0] ?? "buddy";
-  }
-  saveManifest(m);
-}
-
-export function listCompanionSlots(): Array<{
-  slot: string;
-  companion: Companion;
-}> {
-  return Object.entries(loadManifest().companions).map(([slot, companion]) => ({
-    slot,
-    companion,
-  }));
-}
-
-// ─── Primary companion API ────────────────────────────────────────────────────
-
-export function loadCompanion(): Companion | null {
-  migrateIfNeeded();
-  const m = loadManifest();
-  return m.companions[m.active] ?? null;
-}
-
-/**
- * UPDATE the currently-active companion (rename, personality changes, etc.).
- * This is the ONLY intentional in-place update path.
- */
-export function saveCompanion(companion: Companion): void {
-  const m = loadManifest();
-  m.companions[m.active] = companion;
-  saveManifest(m);
-}
-
-// ─── Migration: legacy companion.json -> single manifest ────────────────────
-
-function migrateIfNeeded(): void {
-  if (existsSync(MANIFEST_FILE)) return;
-
-  const companions: Record<string, Companion> = {};
-  let active = "buddy";
-
-  // Absorb menagerie/<slot>.json files
-  const menagerieDir = join(STATE_DIR, "menagerie");
-  if (existsSync(menagerieDir)) {
-    try {
-      for (const f of readdirSync(menagerieDir).filter((f) =>
-        f.endsWith(".json"),
-      )) {
-        const slot = f.slice(0, -5);
-        try {
-          companions[slot] = JSON.parse(
-            readFileSync(join(menagerieDir, f), "utf8"),
-          );
-        } catch {
-          /* skip malformed */
-        }
-      }
-    } catch {
-      /* noop */
-    }
-  }
-
-  // Absorb legacy companion.json
-  const legacyFile = join(STATE_DIR, "companion.json");
-  if (existsSync(legacyFile) && Object.keys(companions).length === 0) {
-    try {
-      const c: Companion = JSON.parse(readFileSync(legacyFile, "utf8"));
-      const slot = slugify(c.name);
-      companions[slot] = c;
-      active = slot;
-    } catch {
-      /* noop */
-    }
-  }
-
-  // Read active pointer if it exists
-  const activeFile = join(STATE_DIR, "active");
-  if (existsSync(activeFile)) {
-    try {
-      const a = readFileSync(activeFile, "utf8").trim();
-      if (a && companions[a]) active = a;
-    } catch {
-      /* noop */
-    }
-  }
-
-  if (Object.keys(companions).length > 0) {
-    active = active && companions[active] ? active : Object.keys(companions)[0];
-  }
-
-  saveManifest({ active, companions });
-}
-
-// ─── Reaction state (session-scoped for tmux isolation) ──────────────────────
-
-export interface ReactionState {
-  reaction: string;
-  timestamp: number;
-  reason: string;
-}
-
-export function loadReaction(): ReactionState | null {
-  try {
-    const data: ReactionState = JSON.parse(readFileSync(reactionFile(), "utf8"));
-    const { reactionTTL } = loadConfig();
-    if (reactionTTL > 0 && Date.now() - data.timestamp > reactionTTL * 1000) return null;
-    return data;
-  } catch {
-    return null;
-  }
-}
-
-export function saveReaction(reaction: string, reason: string): void {
-  mkdirSync(STATE_DIR, { recursive: true });
-  const state: ReactionState = { reaction, timestamp: Date.now(), reason };
-  writeFileSync(reactionFile(), JSON.stringify(state));
-}
-
-// ─── Config persistence (PR #6: tmux popup settings) ─────────────────────────
-
-export interface BuddyConfig {
-  commentCooldown: number;
-  reactionTTL: number;
-  bubbleStyle: "classic" | "round";
-  bubblePosition: "top" | "left";
-  showRarity: boolean;
-  statusLineEnabled: boolean;
-}
-
-const DEFAULT_CONFIG: BuddyConfig = {
-  commentCooldown: 30,
-  reactionTTL: 0,
-  bubbleStyle: "classic",
-  bubblePosition: "top",
-  showRarity: true,
-  statusLineEnabled: false,
-};
-
-export function loadConfig(): BuddyConfig {
-  try {
-    const data = JSON.parse(readFileSync(CONFIG_FILE, "utf8"));
-    return { ...DEFAULT_CONFIG, ...data };
-  } catch {
-    return { ...DEFAULT_CONFIG };
-  }
-}
-
-export function saveConfig(config: Partial<BuddyConfig>): BuddyConfig {
-  mkdirSync(STATE_DIR, { recursive: true });
-  const current = loadConfig();
-  const merged = { ...current, ...config };
-  writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2));
-  return merged;
-}
-
-// ─── Status line state (compact JSON for the shell script) ───────────────────
-
-export interface StatusState {
-  name: string;
-  species: string;
-  rarity: string;
-  stars: string;
-  face: string;
-  eye: string;
-  shiny: boolean;
-  hat: string;
-  reaction: string;
-  muted: boolean;
-  achievement: string;
-}
-
-export function writeStatusState(
-  companion: Companion,
-  reaction?: string,
-  muted?: boolean,
-  achievement?: string,
-): void {
-  mkdirSync(STATE_DIR, { recursive: true });
-  const { renderFace, RARITY_STARS } =
-    require("../../../core/engine.ts") as typeof import("../../../core/engine.ts");
-  const state: StatusState = {
-    name: companion.name,
-    species: companion.bones.species,
-    rarity: companion.bones.rarity,
-    stars: RARITY_STARS[companion.bones.rarity],
-    face: renderFace(companion.bones.species, companion.bones.eye),
-    eye: companion.bones.eye,
-    shiny: companion.bones.shiny,
-    hat: companion.bones.hat,
-    reaction: reaction ?? "",
-    muted: muted ?? false,
-    achievement: achievement ?? "",
-  };
-  writeFileSync(join(STATE_DIR, "status.json"), JSON.stringify(state));
-}
-

package/adapters/pi/README.md

@@ -1,83 +0,0 @@
-# Pi adapter
-
-Native pi extension for `coding-buddy`.
-
-## Load locally during development
-
-Project-local in pi:
-
-```bash
-mkdir -p .pi/extensions
-ln -sf ../../adapters/pi/index.ts .pi/extensions/coding-buddy.ts
-pi
-```
-
-Or run directly:
-
-```bash
-pi -e ./adapters/pi/index.ts
-```
-
-## Install as a pi package
-
-Because the root `package.json` now declares:
-
-```json
-{
-  "pi": {
-    "extensions": ["./adapters/pi/index.ts"]
-  }
-}
-```
-
-pi can install this repo/package directly:
-
-```bash
-pi install /absolute/path/to/claude-buddy
-# or
-pi install npm:@ramarivera/coding-buddy
-```
-
-## What the extension provides
-
-- `/buddy`
-- `/buddy pet`
-- `/buddy stats`
-- `/buddy rename <name>`
-- `/buddy personality <text>`
-- `/buddy off` / `/buddy on`
-- `/buddy save [slot]`
-- `/buddy summon [slot]`
-- `/buddy list`
-- `/buddy dismiss <slot>`
-- `/buddy achievements`
-
-Passive behavior:
-
-- initializes on `session_start`
-- reacts to buddy-name mentions on `input`
-- reacts to some tool failures and large diffs on `tool_result`
-- refreshes widget/status on `turn_end`
-
-Persistence lives under:
-
-- `~/.pi/agent/buddy/`
-
-## Config
-
-Buddy config is stored in:
-
-- `~/.pi/agent/buddy/config.json`
-
-You can optionally force the end-of-turn buddy comment generator to use a different model than the main pi session:
-
-```json
-{
-  "turnCommentModel": {
-    "provider": "google",
-    "model": "gemini-2.5-flash"
-  }
-}
-```
-
-If `turnCommentModel` is unset, or the configured model cannot be found, buddy falls back to the active session model.

package/adapters/pi/tools.ts

@@ -1,6 +0,0 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-
-export function registerBuddyTools(_pi: ExtensionAPI): void {
-  // Intentionally empty for the Phase 2 MVP.
-  // Pi gets its native buddy experience through commands, events, and UI first.
-}

package/server/engine.ts

@@ -1 +0,0 @@
-export * from "../core/engine.ts";

package/server/reactions.ts

@@ -1 +0,0 @@
-export * from "../core/reactions.ts";