opencode-buddy 0.2.0

package/src/buddy/species.js

@@ -0,0 +1,399 @@
+// Species library: 6 ASCII animals × multiple states × animation frames.
+//
+// Frame format: array of strings, each string is one row. All frames in a
+// state are the same width/height, so the renderer can swap them at a fixed
+// cadence without resizing the canvas.
+
+const RESET = "\x1b[0m";
+
+const C = {
+  reset: RESET,
+  dim: "\x1b[2m",
+  bold: "\x1b[1m",
+  red: "\x1b[31m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  blue: "\x1b[34m",
+  magenta: "\x1b[35m",
+  cyan: "\x1b[36m",
+  gray: "\x1b[90m",
+  brightRed: "\x1b[91m",
+  brightGreen: "\x1b[92m",
+  brightYellow: "\x1b[93m",
+  brightBlue: "\x1b[94m",
+  brightMagenta: "\x1b[95m",
+  brightCyan: "\x1b[96m",
+  bgYellow: "\x1b[43m",
+  bgRed: "\x1b[41m",
+};
+
+// Each frame is a multiline string. Keep them all the same dimensions
+// across states of the same species so the canvas doesn't jitter.
+const RAW = {
+  duck: {
+    idle: [
+      `         __         `,
+      `       <(o )___     `,
+      `        ( ._> /     `,
+      `         \`--'       `,
+      `                    `,
+      `      ~ idle ~      `,
+    ],
+    working: [
+      `         __         `,
+      `       <(o )___     `,
+      `        ( ._> /     `,
+      `       *\`--'* .. .. `,
+      `      /   /         `,
+      `    coding...       `,
+    ],
+    celebrating: [
+      `       \\o/          `,
+      `      <(o )___  !   `,
+      `       ( ._> /      `,
+      `        \`--'    \\o/ `,
+      `                    `,
+      `      \\o/ nice!    `,
+    ],
+    scared: [
+      `         __         `,
+      `       <(O )___     `,
+      `        ( ._> /     `,
+      `         \`--'   !!  `,
+      `                    `,
+      `      !!  oh no     `,
+    ],
+    sleeping: [
+      `         __         `,
+      `       <(o )___     `,
+      `        ( -_> z     `,
+      `         \`--'   z   `,
+      `                    `,
+      `     z z z z z       `,
+    ],
+  },
+
+  cat: {
+    idle: [
+      `    /\\_/\\           `,
+      `   ( o.o )          `,
+      `    > ^ <           `,
+      `   /|   |\\          `,
+      `  (_|   |_)         `,
+      `      meow          `,
+    ],
+    working: [
+      `    /\\_/\\  ...      `,
+      `   ( o.o )          `,
+      `    > ^ <           `,
+      `   /|   |\\  ..      `,
+      `  (_|   |_)         `,
+      `    typing...       `,
+    ],
+    celebrating: [
+      `    /\\_/\\           `,
+      `   ( ^.^ )   \\o/    `,
+      `    > ~ <           `,
+      `   /|   |\\  \\o/     `,
+      `  (_|   |_)         `,
+      `   purrrfect!       `,
+    ],
+    scared: [
+      `    /\\_/\\    !!     `,
+      `   ( O.O )          `,
+      `    > ^ <           `,
+      `   /|   |\\          `,
+      `  (_|   |_)  /\\     `,
+      `    !! hiss         `,
+    ],
+    sleeping: [
+      `    /\\_/\\           `,
+      `   ( -.- )  z       `,
+      `    > ^ <           `,
+      `   /|   |\\   z      `,
+      `  (_|   |_)         `,
+      `   z z z z z        `,
+    ],
+  },
+
+  dragon: {
+    idle: [
+      `      /\\_/\\         `,
+      `     ( o o )  ~~    `,
+      `      > ^ < /       `,
+      `     /|   |\\        `,
+      `    (_|   |_)       `,
+      `      rawr          `,
+    ],
+    working: [
+      `      /\\_/\\   ~~~   `,
+      `     ( o o ) ~~     `,
+      `      > ^ <         `,
+      `     /|   |\\  ~~    `,
+      `    (_|   |_)       `,
+      `    forging...      `,
+    ],
+    celebrating: [
+      `      /\\^/\\    \\o/  `,
+      `     ( ^.^ )        `,
+      `      > ~ <    \\o/  `,
+      `     /|   |\\        `,
+      `    (_|   |_)       `,
+      `   +50 xp!! \\o/    `,
+    ],
+    scared: [
+      `      /\\_/\\    !!   `,
+      `     ( O O )        `,
+      `      > ^ <         `,
+      `     /|   |\\   !!   `,
+      `    (_|   |_)       `,
+      `    !! yikes        `,
+    ],
+    sleeping: [
+      `      /\\_/\\         `,
+      `     ( - - ) z      `,
+      `      > ^ <         `,
+      `     /|   |\\   z    `,
+      `    (_|   |_)       `,
+      `   z z z z z        `,
+    ],
+  },
+
+  axolotl: {
+    idle: [
+      `      ^___^         `,
+      `     (o . o)        `,
+      `    \\|_|_|/        `,
+      `     \\| |/         `,
+      `      ) (          `,
+      `    ~ ambien       `,
+    ],
+    working: [
+      `      ^___^   ..    `,
+      `     (o . o)        `,
+      `    \\|_|_|/  ..    `,
+      `     \\| |/         `,
+      `      ) (          `,
+      `     swimming...    `,
+    ],
+    celebrating: [
+      `      ^___^   \\o/   `,
+      `     (o ^ o)        `,
+      `    \\|_|_|/ \\o/    `,
+      `     \\| |/         `,
+      `      ) (          `,
+      `   \\o/  splish!    `,
+    ],
+    scared: [
+      `      ^___^   !!    `,
+      `     (O . O)        `,
+      `    \\|_|_|/        `,
+      `     \\| |/   !!    `,
+      `      ) (          `,
+      `    !!  gulp       `,
+    ],
+    sleeping: [
+      `      ^___^         `,
+      `     (o - o) z      `,
+      `    \\|_|_|/        `,
+      `     \\| |/   z     `,
+      `      ) (          `,
+      `   z z z z z        `,
+    ],
+  },
+
+  robot: {
+    idle: [
+      `     [ O . O ]      `,
+      `    /|#####|\\       `,
+      `   / |#####| \\      `,
+      `     |     |        `,
+      `    /| | | |\\       `,
+      `     beep           `,
+    ],
+    working: [
+      `     [ O . O ] ...  `,
+      `    /|#####|\\       `,
+      `   / |#####| \\  ..  `,
+      `     |     |        `,
+      `    /| | | |\\       `,
+      `   compiling...     `,
+    ],
+    celebrating: [
+      `     [ ^ . ^ ] \\o/  `,
+      `    /|#####|\\       `,
+      `   / |#####| \\      `,
+      `     |     |        `,
+      `    /| | | |\\ \\o/   `,
+      `   pass tests!      `,
+    ],
+    scared: [
+      `     [ O . O ] !!   `,
+      `    /|#####|\\       `,
+      `   / |#####| \\      `,
+      `     |     |   !!   `,
+      `    /| | | |\\       `,
+      `    !! segfault     `,
+    ],
+    sleeping: [
+      `     [ - . - ] z    `,
+      `    /|#####|\\       `,
+      `   / |#####| \\  z   `,
+      `     |     |        `,
+      `    /| | | |\\       `,
+      `   z z z z z        `,
+    ],
+  },
+
+  ghost: {
+    idle: [
+      `     .-\"\"-.        `,
+      `    ( o . o )       `,
+      `    | ~  ~ |        `,
+      `    |     |         `,
+      `    \\uuuuu/         `,
+      `      boo           `,
+    ],
+    working: [
+      `     .-\"\"-.  ...    `,
+      `    ( o . o )       `,
+      `    | ~  ~ |        `,
+      `    |     |         `,
+      `    \\uuuuu/        `,
+      `   haunting...      `,
+    ],
+    celebrating: [
+      `     .-\"\"-.  \\o/    `,
+      `    ( ^ . ^ )       `,
+      `    | ~  ~ | \\o/    `,
+      `    |     |         `,
+      `    \\uuuuu/        `,
+      `   \\o/ spooky!     `,
+    ],
+    scared: [
+      `     .-\"\"-.   !!    `,
+      `    ( O . O )       `,
+      `    | ~  ~ |        `,
+      `    |     |   !!    `,
+      `    \\uuuuu/        `,
+      `    !! yeek         `,
+    ],
+    sleeping: [
+      `     .-\"\"-.         `,
+      `    ( - . - ) z     `,
+      `    | ~  ~ |        `,
+      `    |     |         `,
+      `    \\uuuuu/   z    `,
+      `   z z z z z        `,
+    ],
+  },
+};
+
+// Per-character color map. Each species has a function that takes a char
+// from the raw frame and returns an ANSI-colored version. This way we
+// can give ducks a yellow bill, axolotls pink gills, ghosts a translucent
+// hue, etc.
+const PALETTES = {
+  duck: (ch) => {
+    if (ch === "o" || ch === "O") return C.brightYellow + ch + RESET;
+    if (ch === "(" || ch === ")" || ch === "<" || ch === ">")
+      return C.yellow + ch + RESET;
+    if (ch === "_" || ch === "-") return C.yellow + ch + RESET;
+    if (ch === "." || ch === "*") return C.cyan + ch + RESET;
+    if (ch === "z") return C.gray + ch + RESET;
+    if (ch === "!") return C.brightYellow + ch + RESET;
+    if (ch === "~") return C.cyan + ch + RESET;
+    if (ch === " ") return ch;
+    return C.yellow + ch + RESET;
+  },
+
+  cat: (ch) => {
+    if (ch === "o" || ch === "O" || ch === "^") return C.brightGreen + ch + RESET;
+    if (ch === "!" || ch === "~") return C.brightMagenta + ch + RESET;
+    if (ch === "z") return C.gray + ch + RESET;
+    if (ch === ".") return C.gray + ch + RESET;
+    if (ch === " ") return ch;
+    return C.green + ch + RESET;
+  },
+
+  dragon: (ch) => {
+    if (ch === "o" || ch === "O" || ch === "^") return C.brightRed + ch + RESET;
+    if (ch === "~") return C.red + ch + RESET;
+    if (ch === "!" || ch === "o" || ch === "O") return C.brightYellow + ch + RESET;
+    if (ch === "z") return C.gray + ch + RESET;
+    if (ch === " ") return ch;
+    return C.green + ch + RESET;
+  },
+
+  axolotl: (ch) => {
+    if (ch === "o" || ch === "O") return C.brightMagenta + ch + RESET;
+    if (ch === "^" || ch === "_") return C.magenta + ch + RESET;
+    if (ch === "!" || ch === "o") return C.brightYellow + ch + RESET;
+    if (ch === "z") return C.gray + ch + RESET;
+    if (ch === ".") return C.cyan + ch + RESET;
+    if (ch === " ") return ch;
+    return C.magenta + ch + RESET;
+  },
+
+  robot: (ch) => {
+    if (ch === "O" || ch === "#") return C.brightCyan + ch + RESET;
+    if (ch === "o") return C.cyan + ch + RESET;
+    if (ch === ".") return C.gray + ch + RESET;
+    if (ch === "!" || ch === "o") return C.brightYellow + ch + RESET;
+    if (ch === "z") return C.gray + ch + RESET;
+    if (ch === " ") return ch;
+    return C.gray + ch + RESET;
+  },
+
+  ghost: (ch) => {
+    if (ch === "o" || ch === "O") return C.brightCyan + ch + RESET;
+    if (ch === "~") return C.cyan + ch + RESET;
+    if (ch === "!" || ch === "o") return C.brightMagenta + ch + RESET;
+    if (ch === "z") return C.gray + ch + RESET;
+    if (ch === ".") return C.gray + ch + RESET;
+    if (ch === " ") return ch;
+    return C.brightCyan + ch + RESET;
+  },
+};
+
+export const SPECIES = ["duck", "cat", "dragon", "axolotl", "robot", "ghost"];
+
+export const STATES = ["idle", "working", "celebrating", "scared", "sleeping"];
+
+// Random flavor line shown under the buddy in idle / sleeping.
+export const FLAVOR = {
+  duck: ["quack.", "need code.", "swimming in semicolons"],
+  cat: ["purr.", "knock something off desk?", "yarn > threads"],
+  dragon: ["rawr.", "hoarding stack traces", "breathing fire on bugs"],
+  axolotl: ["ambien?", "regenerating tail...", "neotenic forever"],
+  robot: ["beep boop", "01010110", "needs oil"],
+  ghost: ["boo.", "haunting the stack", "passed on... to prod"],
+};
+
+function targetWidth() {
+  // All species share this width so the rendered canvas never resizes when
+  // a state changes. Each row is padded (or trimmed) to this length.
+  return 20;
+}
+
+export function paint(species, state) {
+  const frame = RAW[species][state];
+  const palette = PALETTES[species];
+  const w = targetWidth();
+  return frame.map((row) => {
+    let out = "";
+    // Use [...row] to count grapheme-ish units. ASCII art is pure ASCII
+    // so spread over code units is fine and matches visual columns.
+    for (const ch of row) out += palette(ch);
+    if (out.length < w) out += " ".repeat(w - out.length);
+    return out;
+  });
+}
+
+export function frameHeight(species) {
+  return RAW[species].idle.length;
+}
+
+export function frameWidth() {
+  return targetWidth();
+}

package/src/buddy/state.js

@@ -0,0 +1,161 @@
+// Buddy state machine + attribute bookkeeping.
+//
+// Attributes (all 0..100):
+//   hunger     100 = full, 0 = starving
+//   happiness  100 = delighted, 0 = grumpy
+//   energy     100 = wide awake, 0 = exhausted
+//
+// External events from opencode (via tmux pane polling or CLI notify):
+//   working    -> state becomes 'working' (boosts happiness over time)
+//   done       -> state becomes 'celebrating' for a few seconds
+//   error      -> state becomes 'scared' for a few seconds
+//   idle       -> state returns to 'idle' / 'sleeping' based on energy
+//
+// User actions:
+//   feed       -> +25 hunger, -5 energy
+//   play       -> +20 happiness, -10 energy, -5 hunger
+//   rest       -> +30 energy
+//
+// Time decay: every minute, hunger -0.5, happiness -0.3, energy -0.2.
+
+export const DEFAULT_STATE = {
+  species: "duck",
+  name: "Quack",
+  hunger: 80,
+  happiness: 80,
+  energy: 100,
+  xp: 0,
+  level: 1,
+  hatchedAt: Date.now(),
+  lastFed: Date.now(),
+  lastPlayed: Date.now(),
+  lastTick: Date.now(),
+  // ephemeral, not persisted as state-of-truth
+  state: "idle",
+  stateUntil: 0,
+  stateReason: "",
+};
+
+const CLAMP = (n, lo = 0, hi = 100) => Math.max(lo, Math.min(hi, n));
+
+export function tick(state, now = Date.now()) {
+  const minutes = (now - state.lastTick) / 60_000;
+  if (minutes <= 0) return state;
+
+  const next = {
+    ...state,
+    hunger: CLAMP(state.hunger - 0.5 * minutes),
+    happiness: CLAMP(state.happiness - 0.3 * minutes),
+    energy: CLAMP(state.energy - 0.2 * minutes),
+    lastTick: now,
+  };
+  return next;
+}
+
+export function feed(state) {
+  return {
+    ...state,
+    hunger: CLAMP(state.hunger + 25),
+    energy: CLAMP(state.energy - 5),
+    lastFed: Date.now(),
+  };
+}
+
+export function play(state) {
+  return {
+    ...state,
+    happiness: CLAMP(state.happiness + 20),
+    energy: CLAMP(state.energy - 10),
+    hunger: CLAMP(state.hunger - 5),
+    lastPlayed: Date.now(),
+    xp: state.xp + 5,
+  };
+}
+
+export function rest(state) {
+  return {
+    ...state,
+    energy: CLAMP(state.energy + 30),
+  };
+}
+
+export function rename(state, name) {
+  return { ...state, name: String(name).slice(0, 20) };
+}
+
+export function switchSpecies(state, species) {
+  return { ...state, species };
+}
+
+export function celebrate(state, durationMs = 4000) {
+  return {
+    ...state,
+    happiness: CLAMP(state.happiness + 5),
+    state: "celebrating",
+    stateUntil: Date.now() + durationMs,
+    stateReason: "session idle",
+  };
+}
+
+export function scared(state, durationMs = 5000) {
+  return {
+    ...state,
+    state: "scared",
+    stateUntil: Date.now() + durationMs,
+    stateReason: "session error",
+  };
+}
+
+export function working(state) {
+  // Don't overwrite a stronger transient state
+  if (state.state === "celebrating" && Date.now() < state.stateUntil)
+    return state;
+  if (state.state === "scared" && Date.now() < state.stateUntil) return state;
+  return { ...state, state: "working", stateUntil: 0, stateReason: "" };
+}
+
+// Derive state purely from attributes when no external override is active.
+export function deriveState(state, now = Date.now()) {
+  if (state.state === "celebrating" && now < state.stateUntil) return state;
+  if (state.state === "scared" && now < state.stateUntil) return state;
+
+  if (state.energy < 20) {
+    return { ...state, state: "sleeping", stateReason: "low energy" };
+  }
+  if (state.hunger < 25) {
+    return { ...state, state: "scared", stateReason: "hungry", stateUntil: now + 30_000 };
+  }
+  if (state.state === "working") return state;
+  return { ...state, state: "idle", stateReason: "" };
+}
+
+export function maybeLevelUp(state) {
+  const xpNeeded = state.level * 50;
+  if (state.xp < xpNeeded) return state;
+  return {
+    ...state,
+    level: state.level + 1,
+    xp: state.xp - xpNeeded,
+    happiness: CLAMP(state.happiness + 10),
+  };
+}
+
+export function describe(state) {
+  const mood =
+    state.happiness > 80
+      ? "happy"
+      : state.happiness > 50
+        ? "okay"
+        : state.happiness > 25
+          ? "grumpy"
+          : "depressed";
+  const tummy =
+    state.hunger > 70
+      ? "full"
+      : state.hunger > 40
+        ? "peckish"
+        : state.hunger > 20
+          ? "hungry"
+          : "starving";
+  return `${state.name} the ${state.species} | Lv ${state.level} | ${mood} | ${tummy} | hunger ${Math.floor(state.hunger)} happiness ${Math.floor(state.happiness)} energy ${Math.floor(state.energy)} | xp ${state.xp}/${state.level * 50}`;
+}