opencode-buddy 0.2.1 → 0.3.0

package/src/buddy/state.js

@@ -1,168 +0,0 @@
-// 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(),
-    lastTick: 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(),
-    lastTick: Date.now(),
-    xp: state.xp + 5,
-  };
-}
-
-export function rest(state) {
-  return {
-    ...state,
-    energy: CLAMP(state.energy + 30),
-    lastTick: Date.now(),
-  };
-}
-
-export function rename(state, name) {
-  return {
-    ...state,
-    name: String(name).slice(0, 20),
-    lastTick: Date.now(),
-  };
-}
-
-export function switchSpecies(state, species) {
-  return { ...state, species, lastTick: Date.now() };
-}
-
-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}`;
-}

package/src/index.js

@@ -1,332 +0,0 @@
-// Main runtime. Wires together state, persistence, TUI, tmux polling.
-//
-// Usage from bin/opencode-buddy.js:
-//   await runInteractive()    // for `opencode-buddy start`
-//   await runCommand(args)    // for all other subcommands
-
-import * as persistence from "./persistence.js";
-import { createTui } from "./tui.js";
-import {
-  tick,
-  feed,
-  play,
-  rest,
-  rename,
-  switchSpecies,
-  celebrate,
-  scared,
-  working,
-  deriveState,
-  maybeLevelUp,
-  describe as describeState,
-  DEFAULT_STATE,
-} from "./buddy/state.js";
-import { SPECIES } from "./buddy/species.js";
-import {
-  inTmux,
-  currentPaneId,
-  splitRight,
-  captureMainPane,
-  inferActivity,
-  killBuddyPane,
-} from "./tmux.js";
-
-const TICK_MS = 1000;
-const SAVE_EVERY_MS = 5000;
-
-const HINT = `keys: f feed · p play · r rename · s switch · z rest · n hatch · q quit`;
-
-export async function loadOrInit() {
-  const existing = await persistence.load();
-  if (existing) return existing;
-  const fresh = { ...DEFAULT_STATE, lastTick: Date.now() };
-  await persistence.save(fresh);
-  return fresh;
-}
-
-export async function runInteractive({ autoSplit = true } = {}) {
-  if (!inTmux()) {
-    throw new Error(
-      "opencode-buddy start must run inside a tmux session. " +
-        "Start tmux first, then run: opencode-buddy start",
-    );
-  }
-
-  let state = await loadOrInit();
-  let buddyPane = null;
-  if (autoSplit) {
-    // The `start` subcommand: split a side pane that runs `render`,
-    // then exit so this main-pane process goes back to the shell prompt.
-    // The render process owns the TUI; we just kick it off.
-    splitRight(
-      `cd ${process.cwd()} && exec ${process.execPath} ${process.argv[1]} render`,
-      28,
-    );
-    return;
-  }
-
-  const tui = createTui({
-    onKey: (key) => {
-      switch (key) {
-        case "f":
-          state = feed(state);
-          flash("yum!");
-          break;
-        case "p":
-          state = play(state);
-          flash("hehe!");
-          break;
-        case "z":
-          state = rest(state);
-          flash("zzz...");
-          break;
-        case "n":
-          state = { ...DEFAULT_STATE, lastTick: Date.now() };
-          flash("new buddy!");
-          break;
-        case "r": {
-          // simple prompt via stdout
-          process.stdout.write(`\x1b[2J\x1b[Hnew name: `);
-          let name = "";
-          const onData = (b) => {
-            const s = b.toString("utf8");
-            if (s === "\n" || s === "\r" || s === "\u0003") {
-              process.stdin.off("data", onData);
-              if (name) state = rename(state, name);
-              flash(name ? `hi ${name}!` : "ok");
-            } else if (s === "\u007f" || s === "\b") {
-              name = name.slice(0, -1);
-            } else {
-              name += s.replace(/[\r\n]/g, "");
-            }
-          };
-          process.stdin.on("data", onData);
-          break;
-        }
-        case "s": {
-          // cycle species
-          const idx = SPECIES.indexOf(state.species);
-          const next = SPECIES[(idx + 1) % SPECIES.length];
-          state = switchSpecies(state, next);
-          flash(`now ${next}`);
-          break;
-        }
-        case "q":
-        case "ctrl-c":
-          cleanup();
-          process.exit(0);
-          break;
-        default:
-          // ignore
-          break;
-      }
-    },
-  });
-
-  let flashUntil = 0;
-  let flashText = "";
-  function flash(text, ms = 1500) {
-    flashText = text;
-    flashUntil = Date.now() + ms;
-  }
-
-  function buildHint() {
-    if (Date.now() < flashUntil) return `${flashText}   ·   ${HINT}`;
-    return HINT;
-  }
-
-  let lastActivity = "unknown";
-  let lastPoll = 0;
-  let lastSave = 0;
-  let lastReload = 0;
-  let lastKnownMtime = 0;
-  let running = true;
-
-  async function loop() {
-    while (running) {
-      const now = Date.now();
-
-      // 0. Reload from disk every 1.5s so the side pane picks up
-      //    changes made by other processes (opencode plugin, headless
-      //    CLI invocations from the main pane, etc.). Use mtime to
-      //    detect external writes — lastTick is not a reliable
-      //    signal because tick() rewrites it every loop.
-      if (now - lastReload > 1500) {
-        lastReload = now;
-        const mt = await persistence.mtime();
-        if (mt > 0 && mt !== lastKnownMtime) {
-          lastKnownMtime = mt;
-          const onDisk = await persistence.load();
-          if (onDisk) {
-            // Preserve in-memory transient state overrides
-            const transient = {
-              state: state.state,
-              stateUntil: state.stateUntil,
-              stateReason: state.stateReason,
-            };
-            state = { ...onDisk, ...transient };
-          }
-        }
-      }
-
-      // 1. tick attributes for time decay
-      state = tick(state, now);
-
-      // 2. capture tmux main pane every 2s for activity inference
-      if (now - lastPoll > 2000) {
-        lastPoll = now;
-        const text = captureMainPane(60);
-        const activity = inferActivity(text);
-        if (activity !== lastActivity) {
-          lastActivity = activity;
-          if (activity === "working") state = working(state);
-          else if (activity === "error") state = scared(state);
-          else if (activity === "idle")
-            state = celebrate(state, 1500);
-        }
-      }
-
-      // 3. derive final state (transient overrides first, then attributes)
-      state = deriveState(state, now);
-
-      // 4. level up check
-      state = maybeLevelUp(state);
-
-      // 5. render
-      tui.render(state, buildHint());
-
-      // 6. persist periodically
-      if (now - lastSave > SAVE_EVERY_MS) {
-        lastSave = now;
-        await persistence.save(state).catch(() => {});
-        lastKnownMtime = await persistence.mtime();
-      }
-
-      await new Promise((r) => setTimeout(r, TICK_MS));
-    }
-  }
-
-  function cleanup() {
-    running = false;
-    tui.stop();
-    if (buddyPane) killBuddyPane(buddyPane);
-  }
-
-  process.on("SIGINT", () => {
-    cleanup();
-    process.exit(0);
-  });
-  process.on("SIGTERM", () => {
-    cleanup();
-    process.exit(0);
-  });
-
-  tui.start();
-  await loop();
-}
-
-// Headless command runner: feed, play, rename, switch, hatch, stats, notify
-export async function runCommand(argv) {
-  const [cmd, ...rest] = argv;
-  let state = await loadOrInit();
-
-  switch (cmd) {
-    case "hatch":
-    case "reset": {
-      const species = rest[0] && SPECIES.includes(rest[0]) ? rest[0] : "duck";
-      state = {
-        ...DEFAULT_STATE,
-        species,
-        name: rest[1] || DEFAULT_STATE.name,
-        lastTick: Date.now(),
-      };
-      await persistence.save(state);
-      console.log(`Hatched a new ${state.species} named ${state.name}.`);
-      break;
-    }
-    case "feed":
-      state = feed(state);
-      await persistence.save(state);
-      console.log(`Fed ${state.name}. hunger -> ${Math.floor(state.hunger)}`);
-      break;
-    case "play":
-      state = play(state);
-      await persistence.save(state);
-      console.log(
-        `Played with ${state.name}. happiness -> ${Math.floor(state.happiness)}`,
-      );
-      break;
-    case "rest":
-      state = rest(state);
-      await persistence.save(state);
-      console.log(`${state.name} took a nap.`);
-      break;
-    case "rename": {
-      const name = rest.join(" ").trim();
-      if (!name) {
-        console.error("usage: opencode-buddy rename <name>");
-        process.exit(2);
-      }
-      state = rename(state, name);
-      await persistence.save(state);
-      console.log(`Renamed to ${state.name}.`);
-      break;
-    }
-    case "switch": {
-      const species = rest[0];
-      if (!species || !SPECIES.includes(species)) {
-        console.error(`species must be one of: ${SPECIES.join(", ")}`);
-        process.exit(2);
-      }
-      state = switchSpecies(state, species);
-      await persistence.save(state);
-      console.log(`${state.name} transformed into a ${species}.`);
-      break;
-    }
-    case "stats":
-      console.log(describeState(state));
-      break;
-    case "notify": {
-      const event = rest[0];
-      if (event === "working" || event === "start")
-        state = working(state);
-      else if (event === "done" || event === "celebrate")
-        state = celebrate(state);
-      else if (event === "error" || event === "scared")
-        state = scared(state);
-      else {
-        console.error(
-          "usage: opencode-buddy notify <working|done|error>",
-        );
-        process.exit(2);
-      }
-      await persistence.save(state);
-      console.log(`Notified buddy: ${event}`);
-      break;
-    }
-    case "path":
-      console.log(persistence.pathForDisplay());
-      break;
-    default:
-      printUsage();
-      process.exit(cmd ? 2 : 0);
-  }
-}
-
-function printUsage() {
-  console.log(`opencode-buddy — a virtual pet for your tmux session
-
-Usage:
-  opencode-buddy start                    Launch interactive buddy in a tmux side pane
-  opencode-buddy hatch [species] [name]   Start a brand new buddy (resets state)
-  opencode-buddy feed                     Feed your buddy
-  opencode-buddy play                     Play with your buddy
-  opencode-buddy rest                     Let your buddy rest
-  opencode-buddy rename <name>            Give your buddy a new name
-  opencode-buddy switch <species>         Change species (${SPECIES.join(", ")})
-  opencode-buddy notify <event>           Notify buddy of an opencode event
-                                           (working | done | error)
-  opencode-buddy stats                    Print current buddy stats
-  opencode-buddy path                     Print path to state file
-`);
-}

package/src/install.js

@@ -1,157 +0,0 @@
-// One-shot installer. Writes the /buddy slash command markdown file
-// and adds this package to opencode.json's plugin list so opencode will
-// bun-install it on the next startup.
-//
-// Re-runnable: safely no-ops if everything is already in place.
-
-import { promises as fs } from "node:fs";
-import path from "node:path";
-import os from "node:os";
-
-const OPENCODE_DIR = path.join(os.homedir(), ".config", "opencode");
-const COMMANDS_DIR = path.join(OPENCODE_DIR, "commands");
-const COMMAND_FILE = path.join(COMMANDS_DIR, "buddy.md");
-const CONFIG_FILE = path.join(OPENCODE_DIR, "opencode.json");
-
-const PLUGIN_NAME = "opencode-buddy";
-
-const COMMAND_BODY = `---
-description: Interact with your virtual buddy companion.
----
-
-The user typed \`/buddy\`. Use the \`buddy\` tool to respond.
-
-If the user typed \`/buddy\` with no arguments, call the tool with
-\`action: "status"\`. If they passed sub-arguments like \`/buddy feed\`
-or \`/buddy switch dragon\`, map them to the tool's \`action\`,
-\`species\`, and \`name\` arguments accordingly. Examples:
-
-  /buddy              -> buddy({ action: "status" })
-  /buddy feed         -> buddy({ action: "feed" })
-  /buddy play         -> buddy({ action: "play" })
-  /buddy switch cat   -> buddy({ action: "switch", species: "cat" })
-  /buddy rename Mia   -> buddy({ action: "rename", name: "Mia" })
-  /buddy hatch dragon Sparky -> buddy({ action: "hatch", species: "dragon", name: "Sparky" })
-  /buddy ascii        -> buddy({ action: "ascii" })
-
-Always show the tool's returned text to the user. If the user just wants
-to see the buddy, call \`action: "ascii"\` to render the current art in a
-code block.
-`;
-
-export async function install() {
-  const steps = [];
-  const errors = [];
-
-  // 1. Write the slash command file
-  try {
-    await fs.mkdir(COMMANDS_DIR, { recursive: true });
-    const existing = await fs.readFile(COMMAND_FILE, "utf8").catch(() => null);
-    if (existing === COMMAND_BODY) {
-      steps.push(`= ${COMMAND_FILE} (unchanged)`);
-    } else {
-      await fs.writeFile(COMMAND_FILE, COMMAND_BODY);
-      steps.push(`+ ${COMMAND_FILE}`);
-    }
-  } catch (err) {
-    errors.push(`failed to write ${COMMAND_FILE}: ${err.message}`);
-  }
-
-  // 2. Patch opencode.json
-  try {
-    let config = {};
-    try {
-      const raw = await fs.readFile(CONFIG_FILE, "utf8");
-      config = JSON.parse(raw);
-    } catch (err) {
-      if (err.code !== "ENOENT") throw err;
-    }
-
-    let pluginList = config.plugin;
-    if (pluginList == null) {
-      pluginList = [];
-      config.plugin = pluginList;
-    } else if (typeof pluginList === "string") {
-      pluginList = [pluginList];
-      config.plugin = pluginList;
-    } else if (!Array.isArray(pluginList)) {
-      errors.push(
-        `${CONFIG_FILE} has an unexpected "plugin" field type; expected array.`,
-      );
-      pluginList = [];
-    }
-
-    if (!pluginList.includes(PLUGIN_NAME)) {
-      pluginList.push(PLUGIN_NAME);
-      config.plugin = pluginList;
-      const tmp = CONFIG_FILE + ".tmp";
-      await fs.writeFile(tmp, JSON.stringify(config, null, 2));
-      await fs.rename(tmp, CONFIG_FILE);
-      steps.push(`~ ${CONFIG_FILE} (added "${PLUGIN_NAME}")`);
-    } else {
-      steps.push(`= ${CONFIG_FILE} (already lists "${PLUGIN_NAME}")`);
-    }
-  } catch (err) {
-    errors.push(`failed to patch ${CONFIG_FILE}: ${err.message}`);
-  }
-
-  // 3. Report
-  console.log("opencode-buddy install");
-  console.log("------------------------");
-  for (const s of steps) console.log(`  ${s}`);
-  if (errors.length) {
-    console.log("\nErrors:");
-    for (const e of errors) console.log(`  ! ${e}`);
-    process.exit(1);
-  }
-  console.log("\nDone. Restart opencode to activate the /buddy command.");
-  console.log("Then in opencode, try:  /buddy");
-}
-
-export async function uninstall() {
-  const steps = [];
-  const errors = [];
-
-  // 1. Remove the command file
-  try {
-    await fs.unlink(COMMAND_FILE);
-    steps.push(`- ${COMMAND_FILE}`);
-  } catch (err) {
-    if (err.code === "ENOENT") steps.push(`= ${COMMAND_FILE} (not present)`);
-    else errors.push(`failed to remove ${COMMAND_FILE}: ${err.message}`);
-  }
-
-  // 2. Remove from opencode.json
-  try {
-    const raw = await fs.readFile(CONFIG_FILE, "utf8");
-    const config = JSON.parse(raw);
-    if (Array.isArray(config.plugin)) {
-      const before = config.plugin.length;
-      config.plugin = config.plugin.filter((p) => p !== PLUGIN_NAME);
-      if (config.plugin.length === 0) delete config.plugin;
-      if (config.plugin.length !== before) {
-        const tmp = CONFIG_FILE + ".tmp";
-        await fs.writeFile(tmp, JSON.stringify(config, null, 2));
-        await fs.rename(tmp, CONFIG_FILE);
-        steps.push(`~ ${CONFIG_FILE} (removed "${PLUGIN_NAME}")`);
-      } else {
-        steps.push(`= ${CONFIG_FILE} (no entry to remove)`);
-      }
-    } else {
-      steps.push(`= ${CONFIG_FILE} (no plugin array)`);
-    }
-  } catch (err) {
-    if (err.code === "ENOENT") steps.push(`= ${CONFIG_FILE} (not present)`);
-    else errors.push(`failed to patch ${CONFIG_FILE}: ${err.message}`);
-  }
-
-  console.log("opencode-buddy uninstall");
-  console.log("--------------------------");
-  for (const s of steps) console.log(`  ${s}`);
-  if (errors.length) {
-    console.log("\nErrors:");
-    for (const e of errors) console.log(`  ! ${e}`);
-    process.exit(1);
-  }
-  console.log("\nDone. Restart opencode to deactivate the /buddy command.");
-}