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

package/hooks/suggest.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# coding-buddy Stop hook — proactive suggestion detection
+# Detects coding patterns and offers suggestions when relevant.
+#
+# Combined with buddy-comment.sh to avoid running two separate Stop hooks.
+
+# shellcheck source=../scripts/paths.sh
+source "$(dirname "${BASH_SOURCE[0]}")/../scripts/paths.sh"
+
+STATE_DIR="$BUDDY_STATE_DIR"
+CONFIG_FILE="$STATE_DIR/config.json"
+LAST_SUGGESTION_FILE="$STATE_DIR/.last_suggestion"
+SUGGESTIONS_FILE="$STATE_DIR/suggestions.json"
+
+[ -f "$CONFIG_FILE" ] || exit 0
+
+# Check if suggestions are enabled (default: true)
+SUGGESTIONS_ENABLED="true"
+if [ -f "$CONFIG_FILE" ]; then
+    _enabled=$(jq -r '.suggestionsEnabled // true' "$CONFIG_FILE" 2>/dev/null)
+    [ "$_enabled" = "false" ] && exit 0
+fi
+
+# Check cooldown (default: 180s = 3 min)
+SUGGESTION_COOLDOWN=180
+if [ -f "$CONFIG_FILE" ]; then
+    _cd=$(jq -r '.suggestionCooldown // 180' "$CONFIG_FILE" 2>/dev/null || echo 180)
+    [[ "$_cd" =~ ^[0-9]+$ ]] && SUGGESTION_COOLDOWN=$_cd
+fi
+
+if [ -f "$LAST_SUGGESTION_FILE" ]; then
+    LAST=$(cat "$LAST_SUGGESTION_FILE" 2>/dev/null)
+    NOW=$(date +%s)
+    DIFF=$(( NOW - ${LAST:-0} ))
+    [ "$DIFF" -lt "$SUGGESTION_COOLDOWN" ] && exit 0
+fi
+
+INPUT=$(cat)
+
+# Extract messages
+ASSISTANT_MSG=$(echo "$INPUT" | jq -r '.last_assistant_message // ""' 2>/dev/null)
+[ -z "$ASSISTANT_MSG" ] && exit 0
+
+# Record turn and check patterns
+PLUGIN_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+# Check for patterns via the suggestions script
+if [ -x "$(command -v bun)" ]; then
+    # Run the suggestion check (async, non-blocking)
+    bun run "$PLUGIN_ROOT/server/check-suggestions.ts" \
+        "$(echo "$ASSISTANT_MSG" | jq -Rs .)" \
+        >/dev/null 2>&1 &
+fi
+
+exit 0

package/package.json

@@ -1,65 +1,119 @@
 {
-    "name": "@ramarivera/coding-buddy",
-    "version": "0.4.0-alpha.8",
-    "description": "Persistent coding companion for Claude Code and pi",
-    "type": "module",
-    "bin": {
-        "coding-buddy": "./cli/index.ts"
+  "name": "@ramarivera/coding-buddy",
+  "version": "0.6.0",
+  "description": "Persistent coding companion for Claude Code, Pi, and Oh My Pi",
+  "type": "module",
+  "omp": {
+    "extensions": [
+      "./adapters/omp/index.ts"
+    ]
+  },
+  "pi": {
+    "extensions": [
+      "./adapters/pi/index.ts"
+    ]
+  },
+  "bin": {
+    "coding-buddy": "cli/index.ts"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.cjs",
+    "server": "bun run server/index.ts",
+    "pick": "bun run cli/pick.ts",
+    "hunt": "bun run cli/hunt.ts",
+    "install-buddy": "bun run cli/install.ts",
+    "show": "bun run cli/show.ts",
+    "doctor": "bun run cli/doctor.ts",
+    "test-statusline": "bun run cli/test-statusline.ts",
+    "backup": "bun run cli/backup.ts",
+    "settings": "bun run cli/settings.ts",
+    "disable": "bun run cli/disable.ts",
+    "enable": "bun run cli/install.ts",
+    "upgrade": "bun run cli/upgrade.ts",
+    "uninstall": "bun run cli/uninstall.ts",
+    "help": "bun run cli/index.ts help",
+    "buddy-shell": "npx tsx cli/buddy-shell.ts",
+    "tui": "bun run cli/tui.tsx",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "gen:emoji-widths": "bun run scripts/gen-emoji-widths.ts"
+  },
+  "files": [
+    "core/",
+    "adapters/",
+    "server/",
+    "cli/",
+    "skills/",
+    "hooks/",
+    "statusline/",
+    "scripts/",
+    ".claude-plugin/",
+    "!**/*.test.ts"
+  ],
+  "keywords": [
+    "coding-buddy",
+    "claude-code",
+    "pi",
+    "oh-my-pi",
+    "omp",
+    "buddy",
+    "companion",
+    "mcp",
+    "terminal-pet",
+    "tamagotchi",
+    "pi-package",
+    "omp-extension"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/1270011/claude-buddy.git"
+  },
+  "homepage": "https://github.com/1270011/claude-buddy#readme",
+  "license": "MIT",
+  "dependencies": {
+    "@homebridge/node-pty-prebuilt-multiarch": "^0.13.1",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@xterm/addon-serialize": "^0.14.0",
+    "@xterm/headless": "^6.0.0",
+    "ink": "^7.0.0",
+    "pino": "^10.3.1",
+    "react": "^19.2.5"
+  },
+  "devDependencies": {
+    "@mariozechner/pi-coding-agent": "0.66.1",
+    "@oh-my-pi/pi-agent-core": "17.0.9",
+    "@oh-my-pi/pi-ai": "17.0.9",
+    "@oh-my-pi/pi-coding-agent": "17.0.9",
+    "@oh-my-pi/pi-catalog": "17.0.9",
+    "@types/react": "^19.2.14",
+    "bun-types": "^1.3.11",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2"
+  },
+  "trustedDependencies": [
+    "@homebridge/node-pty-prebuilt-multiarch"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "0.66.1",
+    "@oh-my-pi/pi-agent-core": "17.0.9",
+    "@oh-my-pi/pi-ai": "17.0.9",
+    "@oh-my-pi/pi-coding-agent": "17.0.9"
+  },
+  "peerDependenciesMeta": {
+    "@mariozechner/pi-coding-agent": {
+      "optional": true
     },
-    "scripts": {
-        "server": "bun run adapters/claude/server/index.ts",
-        "pick": "bun run adapters/claude/install/pick.ts",
-        "hunt": "bun run adapters/claude/install/hunt.ts",
-        "install-buddy": "bun run adapters/claude/install/install.ts",
-        "show": "bun run adapters/claude/install/show.ts",
-        "doctor": "bun run adapters/claude/install/doctor.ts",
-        "test-statusline": "bun run adapters/claude/install/test-statusline.ts",
-        "backup": "bun run adapters/claude/install/backup.ts",
-        "settings": "bun run adapters/claude/install/settings.ts",
-        "disable": "bun run adapters/claude/install/disable.ts",
-        "enable": "bun run adapters/claude/install/install.ts",
-        "uninstall": "bun run adapters/claude/install/uninstall.ts",
-        "help": "bun run cli/index.ts help",
-        "test": "bun test",
-        "typecheck": "tsc --noEmit"
+    "@oh-my-pi/pi-agent-core": {
+      "optional": true
     },
-    "files": [
-        "core/",
-        "adapters/",
-        "cli/",
-        "!**/*.test.ts"
-    ],
-    "keywords": [
-        "claude-code",
-        "buddy",
-        "companion",
-        "mcp",
-        "terminal-pet",
-        "tamagotchi",
-        "pi-package"
-    ],
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/ramarivera/claude-buddy.git"
+    "@oh-my-pi/pi-ai": {
+      "optional": true
     },
-    "homepage": "https://github.com/ramarivera/claude-buddy#readme",
-    "license": "MIT",
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org/"
-    },
-    "pi": {
-        "extensions": [
-            "./adapters/pi/index.ts"
-        ]
-    },
-    "dependencies": {
-        "@mariozechner/pi-coding-agent": "0.66.1",
-        "@modelcontextprotocol/sdk": "^1.12.1",
-        "pino": "^10.3.1"
-    },
-    "devDependencies": {
-        "bun-types": "^1.3.11",
-        "typescript": "^6.0.2"
+    "@oh-my-pi/pi-coding-agent": {
+      "optional": true
     }
+  }
 }

package/scripts/gen-emoji-widths.ts

@@ -0,0 +1,34 @@
+/**
+ * Generate statusline/emoji-widths.data from Unicode's Emoji_Presentation
+ * property. The bash statusline renderer loads this file because awk has no
+ * Unicode property escapes; server/art.ts uses the same regex directly.
+ *
+ * Regenerate:  bun run gen:emoji-widths
+ *
+ * The emitted list holds decimal codepoints in U+2600-U+27BF that default to
+ * emoji rendering (2 cols). Everything outside that range is handled by
+ * simple range checks in the bash/TS code, so we only need to export the
+ * ambiguous Miscellaneous Symbols + Dingbats block.
+ */
+
+import { writeFileSync } from "fs";
+import { join } from "path";
+
+const OUT = join(import.meta.dir, "..", "statusline", "emoji-widths.data");
+
+const EMOJI_PRES_RE = /\p{Emoji_Presentation}/u;
+const codepoints: number[] = [];
+for (let cp = 0x2600; cp <= 0x27BF; cp++) {
+  if (EMOJI_PRES_RE.test(String.fromCodePoint(cp))) codepoints.push(cp);
+}
+
+const content = [
+  "# Auto-generated by scripts/gen-emoji-widths.ts — do not edit by hand.",
+  "# Decimal codepoints in U+2600-U+27BF with Unicode Emoji_Presentation=Yes.",
+  "# Regenerate with: bun run gen:emoji-widths",
+  codepoints.join(" "),
+  "",
+].join("\n");
+
+writeFileSync(OUT, content);
+console.log(`Wrote ${codepoints.length} codepoints to ${OUT}`);

package/scripts/paths.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# Path resolvers for coding-buddy shell scripts.
+#
+# Must stay in sync with server/path.ts. Source this file early:
+#   source "$(dirname "$0")/../scripts/paths.sh"
+# …and consumers get BUDDY_STATE_DIR, CLAUDE_CFG_DIR, CLAUDE_SETTINGS_FILE,
+# and CLAUDE_USER_CONFIG.
+#
+# Resolution rules (must match server/path.ts):
+#   - If CLAUDE_CONFIG_DIR is set → everything lives under it
+#     (settings.json, skills/, .claude.json inside the config dir, and
+#      buddy state at $CLAUDE_CONFIG_DIR/buddy-state).
+#   - Else (single-profile default) → $HOME/.claude, $HOME/.claude.json,
+#     $HOME/.claude-buddy.
+
+if [[ -n "${CLAUDE_CONFIG_DIR:-}" ]]; then
+  CLAUDE_CFG_DIR="$CLAUDE_CONFIG_DIR"
+else
+  CLAUDE_CFG_DIR="$HOME/.claude"
+fi
+
+CLAUDE_SETTINGS_FILE="$CLAUDE_CFG_DIR/settings.json"
+
+# .claude.json: inside CLAUDE_CONFIG_DIR when set, else $HOME. We never
+# fall back to $HOME when CLAUDE_CONFIG_DIR is set — doing so would break
+# profile isolation (enabling buddy in one profile could mutate the
+# home-level file that a different profile reads).
+if [[ -n "${CLAUDE_CONFIG_DIR:-}" ]]; then
+  CLAUDE_USER_CONFIG="$CLAUDE_CONFIG_DIR/.claude.json"
+else
+  CLAUDE_USER_CONFIG="$HOME/.claude.json"
+fi
+
+if [[ -n "${CLAUDE_CONFIG_DIR:-}" ]]; then
+  BUDDY_STATE_DIR="$CLAUDE_CONFIG_DIR/buddy-state"
+else
+  BUDDY_STATE_DIR="$HOME/.claude-buddy"
+fi
+
+export CLAUDE_CFG_DIR CLAUDE_SETTINGS_FILE CLAUDE_USER_CONFIG BUDDY_STATE_DIR
+
+# Windows: Chocolatey installs a PowerShell shim for jq that doesn't work in
+# Git Bash. If jq is not found on PATH, check the real Chocolatey binary path
+# and common Windows locations, then prepend to PATH so all scripts find it.
+if ! command -v jq >/dev/null 2>&1; then
+    for _jq_candidate in \
+        "/c/ProgramData/chocolatey/lib/jq/tools/jq.exe" \
+        "/c/tools/jq/jq.exe" \
+        "$HOME/bin/jq.exe" \
+        "/usr/local/bin/jq.exe"; do
+        if [ -x "$_jq_candidate" ]; then
+            export PATH="$(dirname "$_jq_candidate"):$PATH"
+            break
+        fi
+    done
+fi

package/scripts/postinstall.cjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+/**
+ * Post-install check: warn if bun is unavailable.
+ * Installation must succeed for Node-only Pi/OMP consumers; Claude-only commands
+ * will diagnose bun at runtime.
+ */
+
+const { spawn } = require("child_process");
+
+function checkBun() {
+  return new Promise((resolve) => {
+    const proc = spawn("bun", ["--version"], { stdio: "pipe" });
+    let output = "";
+    proc.stdout.on("data", (data) => {
+      output += data.toString();
+    });
+    proc.on("close", (code) => {
+      if (code === 0) {
+        console.log(`✓ bun ${output.trim()} detected`);
+        resolve(true);
+      } else {
+        console.warn(
+          "Bun is required only for Claude-only commands; install it from https://bun.sh or run `npm install -g bun`."
+        );
+        resolve(false);
+      }
+    });
+    proc.on("error", () => {
+      console.warn(
+        "Bun is required only for Claude-only commands; install it from https://bun.sh or run `npm install -g bun`."
+      );
+      resolve(false);
+    });
+  });
+}
+
+checkBun().then((ok) => {
+  if (!ok) {
+    console.warn("Install completed, but bun is required to run Claude-only commands.");
+  }
+  process.exit(0);
+});

package/scripts/snapshot-statusline.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+# Render the statusline for every species at every frame index. Used for
+# visual review after changes to art pipeline (server render + bash cycler).
+#
+# Usage:
+#   ./scripts/snapshot-statusline.sh                 # print to stdout
+#   ./scripts/snapshot-statusline.sh out/fixtures    # write one file per case
+#
+# Uses a temp BUDDY_STATE_DIR so it never touches the user's real state.
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+OUT_DIR="${1:-}"
+
+TMP_STATE=$(mktemp -d)
+trap 'rm -rf "$TMP_STATE"' EXIT
+export CLAUDE_CONFIG_DIR="$TMP_STATE"
+mkdir -p "$TMP_STATE/buddy-state"
+
+SPECIES_LIST=(duck goose blob cat dragon octopus owl penguin turtle snail
+              ghost axolotl capybara cactus robot rabbit mushroom chonk)
+HATS=(none crown propeller wizard)
+# Ticks hit all 4 distinct frames: 0→F0, 4→F1, 8→blink, 11→F2.
+TICKS=(0 4 8 11)
+
+for species in "${SPECIES_LIST[@]}"; do
+    for hat in "${HATS[@]}"; do
+        # Generate status.json with pre-rendered frames via a small bun script.
+        bun -e "
+import { writeStatusState } from '${ROOT}/server/state.ts';
+writeStatusState({
+    bones: {
+        species: '${species}', eye: '\\u00b0', hat: '${hat}',
+        rarity: 'common', shiny: false,
+        stats: { DEBUGGING: 50, PATIENCE: 50, CHAOS: 50, WISDOM: 50, SNARK: 50 },
+        peak: 'DEBUGGING', dump: 'PATIENCE',
+    },
+    name: 'Test', personality: '', hatchedAt: 0, userId: 'x',
+});
+" > /dev/null
+
+        for tick in "${TICKS[@]}"; do
+            label="${species}  hat=${hat}  tick=${tick}"
+            body=$(BUDDY_FAKE_NOW="$tick" COLUMNS=80 \
+                   "$ROOT/statusline/buddy-status.sh" < /dev/null)
+            if [ -n "$OUT_DIR" ]; then
+                mkdir -p "$OUT_DIR"
+                printf '%s\n' "$body" > "$OUT_DIR/${species}_${hat}_t${tick}.out"
+            else
+                printf '=== %s ===\n%s\n\n' "$label" "$body"
+            fi
+        done
+    done
+done