@umang-boss/claudemon 1.0.0

package/cli/install.ts

@@ -0,0 +1,248 @@
+/**
+ * Claudemon CLI Installer.
+ * Registers MCP server, hooks, and skill into Claude Code.
+ *
+ * Usage: bun run cli/install.ts
+ */
+
+import { mkdir, copyFile, chmod, access } from "node:fs/promises";
+import { constants as fsConstants } from "node:fs";
+
+import type { ClaudeConfig, ClaudeSettings, HookCommand, HookMatcher } from "./shared.js";
+import {
+  ok,
+  fail,
+  readJson,
+  writeJson,
+  CLAUDE_DIR,
+  CLAUDE_CONFIG,
+  CLAUDE_SETTINGS,
+  STATE_DIR,
+  SKILL_SRC,
+  SKILL_DEST_DIR,
+  SKILL_DEST,
+  HOOK_SCRIPT,
+  STOP_HOOK_SCRIPT,
+  USER_PROMPT_HOOK_SCRIPT,
+  STATUSLINE_SCRIPT,
+  SERVER_ENTRY,
+  getBunPath,
+} from "./shared.js";
+
+// ── Step 1: Check Prerequisites ──────────────────────────────
+
+async function checkPrerequisites(): Promise<boolean> {
+  let allGood = true;
+
+  // Check bun (sanity)
+  try {
+    const proc = Bun.spawn(["bun", "--version"], { stdout: "pipe", stderr: "pipe" });
+    const output = await new Response(proc.stdout).text();
+    await proc.exited;
+    ok(`Bun runtime: v${output.trim()}`);
+  } catch {
+    fail("Bun runtime not found. Install from https://bun.sh");
+    allGood = false;
+  }
+
+  // Check Claude Code directory
+  try {
+    await access(CLAUDE_DIR, fsConstants.F_OK);
+    ok("Claude Code directory: ~/.claude/");
+  } catch {
+    fail("Claude Code not found. Install Claude Code first: https://claude.ai/download");
+    console.error("    Expected directory: ~/.claude/");
+    allGood = false;
+  }
+
+  return allGood;
+}
+
+// ── Step 2: Create State Directory ───────────────────────────
+
+async function createStateDirectory(): Promise<void> {
+  await mkdir(STATE_DIR, { recursive: true });
+  ok(`State directory: ${STATE_DIR}/`);
+}
+
+// ── Step 3: Register MCP Server ──────────────────────────────
+
+async function registerMcpServer(): Promise<void> {
+  const existing = await readJson<ClaudeConfig>(CLAUDE_CONFIG);
+  const config: ClaudeConfig = existing ?? {};
+
+  if (!config.mcpServers) {
+    config.mcpServers = {};
+  }
+
+  config.mcpServers["claudemon"] = {
+    command: getBunPath(),
+    args: ["run", SERVER_ENTRY],
+    env: {},
+  };
+
+  await writeJson(CLAUDE_CONFIG, config);
+  ok("MCP server: registered in ~/.claude.json");
+}
+
+// ── Step 4: Install Hooks ────────────────────────────────────
+
+async function installHooks(): Promise<void> {
+  const existing = await readJson<ClaudeSettings>(CLAUDE_SETTINGS);
+  const settings: ClaudeSettings = existing ?? {};
+
+  if (!settings.hooks) {
+    settings.hooks = {};
+  }
+
+  const ourHook: HookCommand = {
+    type: "command",
+    command: HOOK_SCRIPT,
+    timeout: 5000,
+  };
+
+  const ourMatcher: HookMatcher = {
+    matcher: "Bash|Write|Edit|Read|Grep|Glob",
+    hooks: [ourHook],
+  };
+
+  // Check if PostToolUse already has our matcher
+  const postToolUse = settings.hooks["PostToolUse"];
+  if (postToolUse) {
+    // Remove any existing claudemon matcher (idempotent reinstall)
+    const filtered = postToolUse.filter(
+      (m) => !m.hooks.some((h) => h.command.includes("post-tool-use.sh")),
+    );
+    filtered.push(ourMatcher);
+    settings.hooks["PostToolUse"] = filtered;
+  } else {
+    settings.hooks["PostToolUse"] = [ourMatcher];
+  }
+
+  // ── Stop hook (extracts buddy comments from responses) ────
+  const stopHook: HookCommand = {
+    type: "command",
+    command: STOP_HOOK_SCRIPT,
+    timeout: 3000,
+  };
+
+  const stopEntry: HookMatcher = {
+    hooks: [stopHook],
+  };
+
+  const stopHooks = settings.hooks["Stop"];
+  if (stopHooks) {
+    const filtered = stopHooks.filter((m) => !m.hooks.some((h) => h.command.includes("stop.sh")));
+    filtered.push(stopEntry);
+    settings.hooks["Stop"] = filtered;
+  } else {
+    settings.hooks["Stop"] = [stopEntry];
+  }
+
+  // ── UserPromptSubmit hook (reacts to Pokemon name mentions) ─
+  const userPromptHook: HookCommand = {
+    type: "command",
+    command: USER_PROMPT_HOOK_SCRIPT,
+    timeout: 3000,
+  };
+
+  const userPromptEntry: HookMatcher = {
+    hooks: [userPromptHook],
+  };
+
+  const userPromptHooks = settings.hooks["UserPromptSubmit"];
+  if (userPromptHooks) {
+    const filtered = userPromptHooks.filter(
+      (m) => !m.hooks.some((h) => h.command.includes("user-prompt-submit.sh")),
+    );
+    filtered.push(userPromptEntry);
+    settings.hooks["UserPromptSubmit"] = filtered;
+  } else {
+    settings.hooks["UserPromptSubmit"] = [userPromptEntry];
+  }
+
+  await writeJson(CLAUDE_SETTINGS, settings);
+  ok("Hooks: PostToolUse, Stop, UserPromptSubmit configured in ~/.claude/settings.json");
+}
+
+// ── Step 5: Register Status Line ─────────────────────────────
+
+async function registerStatusLine(): Promise<void> {
+  const existing = await readJson<ClaudeSettings>(CLAUDE_SETTINGS);
+  const settings: ClaudeSettings = existing ?? {};
+
+  // Merge status line config without overwriting other settings
+  settings.statusLine = {
+    type: "command",
+    command: STATUSLINE_SCRIPT,
+    refreshInterval: 1,
+  };
+
+  await writeJson(CLAUDE_SETTINGS, settings);
+  ok("Status line: registered in ~/.claude/settings.json");
+}
+
+// ── Step 6: Install Skill ─────────────────────────────────────
+
+async function installSkill(): Promise<void> {
+  await mkdir(SKILL_DEST_DIR, { recursive: true });
+  await copyFile(SKILL_SRC, SKILL_DEST);
+  ok("Skill: /buddy command installed to ~/.claude/skills/buddy/");
+}
+
+// ── Step 7: Set Script Permissions ───────────────────────────
+
+async function setScriptPermissions(): Promise<void> {
+  await chmod(HOOK_SCRIPT, 0o755);
+  ok("Hook script: post-tool-use.sh set executable");
+  await chmod(STOP_HOOK_SCRIPT, 0o755);
+  ok("Hook script: stop.sh set executable");
+  await chmod(USER_PROMPT_HOOK_SCRIPT, 0o755);
+  ok("Hook script: user-prompt-submit.sh set executable");
+  await chmod(STATUSLINE_SCRIPT, 0o755);
+  ok("Status line script: set executable");
+}
+
+// ── Main ─────────────────────────────────────────────────────
+
+export async function install(): Promise<void> {
+  console.log("");
+  console.log("Claudemon Installer");
+  console.log("===================");
+  console.log("");
+  console.log("Checking prerequisites...");
+
+  const prereqOk = await checkPrerequisites();
+  if (!prereqOk) {
+    console.log("");
+    fail("Prerequisites not met. Fix the issues above and try again.");
+    process.exit(1);
+  }
+
+  console.log("");
+  console.log("Installing...");
+
+  await createStateDirectory();
+  await registerMcpServer();
+  await installHooks();
+  await registerStatusLine();
+  await installSkill();
+  await setScriptPermissions();
+
+  console.log("");
+  console.log("\u2713 Claudemon installed successfully!");
+  console.log("");
+  console.log("Next steps:");
+  console.log("  1. Start a new Claude Code session");
+  console.log("  2. Type /buddy starter to pick your first Pokemon!");
+  console.log("");
+  console.log("Run 'bun run cli/doctor.ts' to verify installation.");
+  console.log("");
+}
+
+// Run if executed directly
+install().catch((err: unknown) => {
+  const message = err instanceof Error ? err.message : String(err);
+  console.error(`\nInstallation failed: ${message}`);
+  process.exit(1);
+});

package/cli/shared.ts

@@ -0,0 +1,102 @@
+/**
+ * Shared types and utilities for Claudemon CLI commands.
+ * Centralizes Claude Code config interfaces and common helpers.
+ */
+
+import { resolve, dirname } from "node:path";
+
+// ── Config shape interfaces ──────────────────────────────────
+
+export interface McpServerEntry {
+  command: string;
+  args: string[];
+  env: Record<string, string>;
+}
+
+export interface ClaudeConfig {
+  mcpServers?: Record<string, McpServerEntry>;
+  [key: string]: unknown;
+}
+
+export interface HookCommand {
+  type: "command";
+  command: string;
+  timeout: number;
+}
+
+export interface HookMatcher {
+  matcher?: string;
+  hooks: HookCommand[];
+}
+
+export interface StatusLineConfig {
+  type: "command";
+  command: string;
+  refreshInterval: number;
+}
+
+export interface ClaudeSettings {
+  hooks?: Record<string, HookMatcher[]>;
+  statusLine?: StatusLineConfig;
+  [key: string]: unknown;
+}
+
+// ── Constants ────────────────────────────────────────────────
+
+const HOME = process.env["HOME"];
+if (!HOME) {
+  console.error("Error: HOME environment variable is not set.");
+  process.exit(1);
+}
+
+export const CLI_HOME = HOME;
+export const PROJECT_DIR = resolve(dirname(import.meta.dir));
+export const CLAUDE_DIR = `${HOME}/.claude`;
+export const CLAUDE_CONFIG = `${HOME}/.claude.json`;
+export const CLAUDE_SETTINGS = `${CLAUDE_DIR}/settings.json`;
+export const STATE_DIR = `${HOME}/.claudemon`;
+export const SKILL_SRC = `${PROJECT_DIR}/skills/buddy/SKILL.md`;
+export const SKILL_DEST_DIR = `${CLAUDE_DIR}/skills/buddy`;
+export const SKILL_DEST = `${SKILL_DEST_DIR}/SKILL.md`;
+export const HOOK_SCRIPT = `${PROJECT_DIR}/hooks/post-tool-use.sh`;
+export const STOP_HOOK_SCRIPT = `${PROJECT_DIR}/hooks/stop.sh`;
+export const USER_PROMPT_HOOK_SCRIPT = `${PROJECT_DIR}/hooks/user-prompt-submit.sh`;
+export const STATUSLINE_SCRIPT = `${PROJECT_DIR}/statusline/buddy-status.sh`;
+export const SERVER_ENTRY = `${PROJECT_DIR}/src/server/index.ts`;
+
+/** Resolve full path to bun binary (Claude Code may not have bun in PATH) */
+export function getBunPath(): string {
+  const { existsSync } = require("node:fs") as { existsSync: (p: string) => boolean };
+  const candidates = [`${HOME}/.bun/bin/bun`, "/usr/local/bin/bun", "/usr/bin/bun"];
+  for (const p of candidates) {
+    if (existsSync(p)) return p;
+  }
+  return "bun";
+}
+
+// ── Helpers ──────────────────────────────────────────────────
+
+export function ok(msg: string): void {
+  console.log(`  \u2713 ${msg}`);
+}
+
+export function fail(msg: string): void {
+  console.error(`  \u2717 ${msg}`);
+}
+
+export function info(msg: string): void {
+  console.log(`  - ${msg}`);
+}
+
+export async function readJson<T>(path: string): Promise<T | null> {
+  const file = Bun.file(path);
+  if (!(await file.exists())) {
+    return null;
+  }
+  const text = await file.text();
+  return JSON.parse(text) as T;
+}
+
+export async function writeJson(path: string, data: unknown): Promise<void> {
+  await Bun.write(path, JSON.stringify(data, null, 2) + "\n");
+}

package/cli/uninstall.ts

@@ -0,0 +1,155 @@
+/**
+ * Claudemon CLI Uninstaller.
+ * Cleanly removes MCP server, hooks, and skill from Claude Code.
+ *
+ * Usage: bun run cli/uninstall.ts
+ */
+
+import { rm } from "node:fs/promises";
+
+import type { ClaudeConfig, ClaudeSettings } from "./shared.js";
+import {
+  ok,
+  info,
+  readJson,
+  writeJson,
+  CLAUDE_CONFIG,
+  CLAUDE_SETTINGS,
+  STATE_DIR,
+  SKILL_DEST_DIR,
+} from "./shared.js";
+
+// ── Step 1: Remove MCP Server Registration ───────────────────
+
+async function removeMcpServer(): Promise<void> {
+  const config = await readJson<ClaudeConfig>(CLAUDE_CONFIG);
+  if (!config) {
+    info("MCP server: ~/.claude.json not found (nothing to remove)");
+    return;
+  }
+
+  if (!config.mcpServers || !config.mcpServers["claudemon"]) {
+    info("MCP server: not registered (nothing to remove)");
+    return;
+  }
+
+  delete config.mcpServers["claudemon"];
+
+  // Clean up empty mcpServers object
+  if (Object.keys(config.mcpServers).length === 0) {
+    delete config.mcpServers;
+  }
+
+  await writeJson(CLAUDE_CONFIG, config);
+  ok("MCP server: removed from ~/.claude.json");
+}
+
+// ── Step 2: Remove Hooks ─────────────────────────────────────
+
+async function removeHooks(): Promise<void> {
+  const settings = await readJson<ClaudeSettings>(CLAUDE_SETTINGS);
+  if (!settings) {
+    info("Hooks: ~/.claude/settings.json not found (nothing to remove)");
+    return;
+  }
+
+  if (!settings.hooks) {
+    info("Hooks: no hooks found (nothing to remove)");
+    return;
+  }
+
+  // Remove PostToolUse hook
+  if (settings.hooks["PostToolUse"]) {
+    const filtered = settings.hooks["PostToolUse"].filter(
+      (m) => !m.hooks.some((h) => h.command.includes("post-tool-use.sh")),
+    );
+    if (filtered.length === 0) {
+      delete settings.hooks["PostToolUse"];
+    } else {
+      settings.hooks["PostToolUse"] = filtered;
+    }
+  }
+
+  // Remove Stop hook
+  if (settings.hooks["Stop"]) {
+    const filtered = settings.hooks["Stop"].filter(
+      (m) => !m.hooks.some((h) => h.command.includes("stop.sh")),
+    );
+    if (filtered.length === 0) {
+      delete settings.hooks["Stop"];
+    } else {
+      settings.hooks["Stop"] = filtered;
+    }
+  }
+
+  // Remove UserPromptSubmit hook
+  if (settings.hooks["UserPromptSubmit"]) {
+    const filtered = settings.hooks["UserPromptSubmit"].filter(
+      (m) => !m.hooks.some((h) => h.command.includes("user-prompt-submit.sh")),
+    );
+    if (filtered.length === 0) {
+      delete settings.hooks["UserPromptSubmit"];
+    } else {
+      settings.hooks["UserPromptSubmit"] = filtered;
+    }
+  }
+
+  // Clean up empty hooks object
+  if (Object.keys(settings.hooks).length === 0) {
+    delete settings.hooks;
+  }
+
+  await writeJson(CLAUDE_SETTINGS, settings);
+  ok("Hooks: removed PostToolUse, Stop, UserPromptSubmit entries from ~/.claude/settings.json");
+}
+
+// ── Step 3: Remove Skill ─────────────────────────────────────
+
+async function removeSkill(): Promise<void> {
+  const file = Bun.file(`${SKILL_DEST_DIR}/SKILL.md`);
+  if (!(await file.exists())) {
+    info("Skill: ~/.claude/skills/buddy/ not found (nothing to remove)");
+    return;
+  }
+
+  await rm(SKILL_DEST_DIR, { recursive: true, force: true });
+  ok("Skill: removed ~/.claude/skills/buddy/");
+}
+
+// ── Step 4: Preserve State Data ──────────────────────────────
+
+async function preserveStateData(): Promise<void> {
+  const stateFile = Bun.file(`${STATE_DIR}/state.json`);
+  if (await stateFile.exists()) {
+    info(`Your Pokemon data is preserved at ${STATE_DIR}/. Delete manually to remove.`);
+  } else {
+    info(`State directory: ${STATE_DIR}/ (kept, no state file found)`);
+  }
+}
+
+// ── Main ─────────────────────────────────────────────────────
+
+export async function uninstall(): Promise<void> {
+  console.log("");
+  console.log("Claudemon Uninstaller");
+  console.log("=====================");
+  console.log("");
+  console.log("Removing Claudemon from Claude Code...");
+  console.log("");
+
+  await removeMcpServer();
+  await removeHooks();
+  await removeSkill();
+  await preserveStateData();
+
+  console.log("");
+  console.log("\u2713 Claudemon uninstalled successfully.");
+  console.log("");
+}
+
+// Run if executed directly
+uninstall().catch((err: unknown) => {
+  const message = err instanceof Error ? err.message : String(err);
+  console.error(`\nUninstall failed: ${message}`);
+  process.exit(1);
+});