claudehq 1.0.0

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "claudehq",
+  "version": "1.0.0",
+  "description": "Claude HQ - A real-time command center for Claude Code sessions",
+  "main": "lib/server.js",
+  "bin": {
+    "claudehq": "./bin/cli.js",
+    "chq": "./bin/cli.js"
+  },
+  "scripts": {
+    "start": "node lib/server.js",
+    "setup": "node scripts/setup.js install",
+    "uninstall": "node scripts/setup.js uninstall"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "task-board",
+    "kanban",
+    "ai",
+    "productivity"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alexwalz/claudehq"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "commander": "^12.0.0"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "hooks/",
+    "scripts/",
+    "README.md"
+  ]
+}

package/scripts/setup.js

@@ -0,0 +1,366 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { execSync } = require('child_process');
+
+// Paths
+const CLAUDE_DIR = path.join(os.homedir(), '.claude');
+const HOOKS_DIR = path.join(CLAUDE_DIR, 'hooks');
+const SETTINGS_FILE = path.join(CLAUDE_DIR, 'settings.json');
+const DATA_DIR = path.join(CLAUDE_DIR, 'tasks-board');
+const HOOK_SCRIPT_NAME = 'tasks-board-hook.sh';
+const HOOK_SCRIPT_DEST = path.join(HOOKS_DIR, HOOK_SCRIPT_NAME);
+
+// Source hook script (bundled with package)
+const HOOK_SCRIPT_SRC = path.join(__dirname, '..', 'hooks', HOOK_SCRIPT_NAME);
+
+// The hooks we need to install
+const REQUIRED_HOOKS = {
+  PreToolUse: {
+    matcher: '',
+    hooks: [{ type: 'command', command: `~/.claude/hooks/${HOOK_SCRIPT_NAME}` }]
+  },
+  PostToolUse: {
+    matcher: '',
+    hooks: [{ type: 'command', command: `~/.claude/hooks/${HOOK_SCRIPT_NAME}` }]
+  },
+  Stop: {
+    matcher: '',
+    hooks: [{ type: 'command', command: `~/.claude/hooks/${HOOK_SCRIPT_NAME}` }]
+  },
+  UserPromptSubmit: {
+    matcher: '',
+    hooks: [{ type: 'command', command: `~/.claude/hooks/${HOOK_SCRIPT_NAME}` }]
+  },
+  SubagentStop: {
+    matcher: '',
+    hooks: [{ type: 'command', command: `~/.claude/hooks/${HOOK_SCRIPT_NAME}` }]
+  }
+};
+
+// Colors for terminal output
+const colors = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m',
+  dim: '\x1b[2m'
+};
+
+function log(msg, color = '') {
+  console.log(`${color}${msg}${colors.reset}`);
+}
+
+function success(msg) { log(`✓ ${msg}`, colors.green); }
+function warn(msg) { log(`⚠ ${msg}`, colors.yellow); }
+function error(msg) { log(`✗ ${msg}`, colors.red); }
+function info(msg) { log(`  ${msg}`, colors.dim); }
+
+// Check if jq is installed
+function checkJq() {
+  try {
+    execSync('which jq', { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// Load existing settings or create default
+function loadSettings() {
+  if (fs.existsSync(SETTINGS_FILE)) {
+    try {
+      return JSON.parse(fs.readFileSync(SETTINGS_FILE, 'utf-8'));
+    } catch (e) {
+      warn(`Could not parse ${SETTINGS_FILE}, creating backup`);
+      fs.copyFileSync(SETTINGS_FILE, `${SETTINGS_FILE}.backup`);
+      return {};
+    }
+  }
+  return {};
+}
+
+// Save settings
+function saveSettings(settings) {
+  fs.writeFileSync(SETTINGS_FILE, JSON.stringify(settings, null, 2));
+}
+
+// Check if our hook is already in an array
+function hasOurHook(hooksArray) {
+  if (!Array.isArray(hooksArray)) return false;
+  return hooksArray.some(entry => {
+    if (!entry.hooks) return false;
+    return entry.hooks.some(h =>
+      h.command && h.command.includes(HOOK_SCRIPT_NAME)
+    );
+  });
+}
+
+// Add our hook to a hook type array, preserving existing hooks
+function addHookToArray(existingArray, newHook) {
+  if (!Array.isArray(existingArray)) {
+    existingArray = [];
+  }
+
+  // Check if we already have a hook with the same matcher
+  const matcherIndex = existingArray.findIndex(entry =>
+    entry.matcher === newHook.matcher
+  );
+
+  if (matcherIndex >= 0) {
+    // Add our hook command to existing entry if not already there
+    const entry = existingArray[matcherIndex];
+    if (!entry.hooks) entry.hooks = [];
+
+    const alreadyHasOurHook = entry.hooks.some(h =>
+      h.command && h.command.includes(HOOK_SCRIPT_NAME)
+    );
+
+    if (!alreadyHasOurHook) {
+      entry.hooks.push(...newHook.hooks);
+    }
+  } else {
+    // Add new entry
+    existingArray.push(newHook);
+  }
+
+  return existingArray;
+}
+
+// Install hooks
+async function install(options = {}) {
+  console.log('\n' + colors.cyan + '━━━ Claude HQ Setup ━━━' + colors.reset + '\n');
+
+  // Step 1: Check for jq
+  log('Checking dependencies...');
+  if (!checkJq()) {
+    error('jq is required but not installed');
+    console.log('\n  Install jq:');
+    if (process.platform === 'darwin') {
+      info('brew install jq');
+    } else {
+      info('sudo apt-get install jq  (Debian/Ubuntu)');
+      info('sudo yum install jq      (RHEL/CentOS)');
+    }
+    console.log('');
+    process.exit(1);
+  }
+  success('jq is installed');
+
+  // Step 2: Create directories
+  log('\nSetting up directories...');
+
+  if (!fs.existsSync(CLAUDE_DIR)) {
+    fs.mkdirSync(CLAUDE_DIR, { recursive: true });
+    success(`Created ${CLAUDE_DIR}`);
+  }
+
+  if (!fs.existsSync(HOOKS_DIR)) {
+    fs.mkdirSync(HOOKS_DIR, { recursive: true });
+    success(`Created ${HOOKS_DIR}`);
+  }
+
+  if (!fs.existsSync(DATA_DIR)) {
+    fs.mkdirSync(DATA_DIR, { recursive: true });
+    success(`Created ${DATA_DIR}`);
+  }
+
+  // Step 3: Copy hook script
+  log('\nInstalling hook script...');
+
+  if (fs.existsSync(HOOK_SCRIPT_DEST) && !options.force) {
+    info(`Hook script already exists at ${HOOK_SCRIPT_DEST}`);
+    info('Use --force to overwrite');
+  } else {
+    if (!fs.existsSync(HOOK_SCRIPT_SRC)) {
+      error(`Hook script not found at ${HOOK_SCRIPT_SRC}`);
+      process.exit(1);
+    }
+    fs.copyFileSync(HOOK_SCRIPT_SRC, HOOK_SCRIPT_DEST);
+    fs.chmodSync(HOOK_SCRIPT_DEST, '755');
+    success(`Installed hook script to ${HOOK_SCRIPT_DEST}`);
+  }
+
+  // Step 4: Configure Claude settings
+  log('\nConfiguring Claude Code hooks...');
+
+  const settings = loadSettings();
+
+  if (!settings.hooks) {
+    settings.hooks = {};
+  }
+
+  let hooksAdded = 0;
+  for (const [hookType, hookConfig] of Object.entries(REQUIRED_HOOKS)) {
+    if (!hasOurHook(settings.hooks[hookType])) {
+      settings.hooks[hookType] = addHookToArray(
+        settings.hooks[hookType] || [],
+        hookConfig
+      );
+      hooksAdded++;
+      success(`Added ${hookType} hook`);
+    } else {
+      info(`${hookType} hook already configured`);
+    }
+  }
+
+  if (hooksAdded > 0) {
+    saveSettings(settings);
+    success(`Updated ${SETTINGS_FILE}`);
+  }
+
+  // Done!
+  console.log('\n' + colors.green + '━━━ Setup Complete! ━━━' + colors.reset);
+  console.log(`
+Next steps:
+
+  1. ${colors.cyan}Restart Claude Code${colors.reset} for hooks to take effect
+
+  2. Start Claude HQ:
+     ${colors.dim}npx claudehq${colors.reset}
+     ${colors.dim}# or${colors.reset}
+     ${colors.dim}chq${colors.reset}
+
+  3. Open ${colors.cyan}http://localhost:3456${colors.reset} in your browser
+
+`);
+}
+
+// Uninstall hooks
+async function uninstall() {
+  console.log('\n' + colors.cyan + '━━━ Claude HQ Uninstall ━━━' + colors.reset + '\n');
+
+  // Remove hook script
+  if (fs.existsSync(HOOK_SCRIPT_DEST)) {
+    fs.unlinkSync(HOOK_SCRIPT_DEST);
+    success(`Removed ${HOOK_SCRIPT_DEST}`);
+  }
+
+  // Remove hooks from settings
+  if (fs.existsSync(SETTINGS_FILE)) {
+    const settings = loadSettings();
+
+    if (settings.hooks) {
+      let modified = false;
+
+      for (const hookType of Object.keys(REQUIRED_HOOKS)) {
+        if (Array.isArray(settings.hooks[hookType])) {
+          const before = settings.hooks[hookType].length;
+
+          settings.hooks[hookType] = settings.hooks[hookType].map(entry => {
+            if (entry.hooks) {
+              entry.hooks = entry.hooks.filter(h =>
+                !h.command || !h.command.includes(HOOK_SCRIPT_NAME)
+              );
+            }
+            return entry;
+          }).filter(entry => entry.hooks && entry.hooks.length > 0);
+
+          if (settings.hooks[hookType].length !== before) {
+            modified = true;
+            success(`Removed ${hookType} hook`);
+          }
+
+          // Clean up empty arrays
+          if (settings.hooks[hookType].length === 0) {
+            delete settings.hooks[hookType];
+          }
+        }
+      }
+
+      if (modified) {
+        saveSettings(settings);
+        success(`Updated ${SETTINGS_FILE}`);
+      }
+    }
+  }
+
+  console.log('\n' + colors.green + 'Uninstall complete!' + colors.reset);
+  info('You may also want to remove ~/.claude/tasks-board/ if you no longer need the event data\n');
+}
+
+// Check status
+async function status() {
+  console.log('\n' + colors.cyan + '━━━ Claude HQ Status ━━━' + colors.reset + '\n');
+
+  // Check jq
+  if (checkJq()) {
+    success('jq is installed');
+  } else {
+    error('jq is NOT installed');
+  }
+
+  // Check hook script
+  if (fs.existsSync(HOOK_SCRIPT_DEST)) {
+    success(`Hook script installed at ${HOOK_SCRIPT_DEST}`);
+  } else {
+    error('Hook script NOT installed');
+  }
+
+  // Check settings
+  if (fs.existsSync(SETTINGS_FILE)) {
+    const settings = loadSettings();
+    let allHooksConfigured = true;
+
+    for (const hookType of Object.keys(REQUIRED_HOOKS)) {
+      if (hasOurHook(settings.hooks?.[hookType])) {
+        success(`${hookType} hook configured`);
+      } else {
+        error(`${hookType} hook NOT configured`);
+        allHooksConfigured = false;
+      }
+    }
+  } else {
+    error('Claude settings file not found');
+  }
+
+  // Check data directory
+  if (fs.existsSync(DATA_DIR)) {
+    const eventsFile = path.join(DATA_DIR, 'events.jsonl');
+    if (fs.existsSync(eventsFile)) {
+      const stats = fs.statSync(eventsFile);
+      success(`Events file exists (${(stats.size / 1024).toFixed(1)} KB)`);
+    } else {
+      info('Events file not yet created (will be created when Claude runs)');
+    }
+  } else {
+    warn('Data directory not created yet');
+  }
+
+  // Check if server is running
+  try {
+    const http = require('http');
+    const req = http.get('http://localhost:3456/api/health', { timeout: 1000 }, (res) => {
+      if (res.statusCode === 200) {
+        success('Server is running on port 3456');
+      }
+    });
+    req.on('error', () => {
+      info('Server is not running');
+    });
+    req.end();
+  } catch {
+    info('Server is not running');
+  }
+
+  console.log('');
+}
+
+module.exports = { install, uninstall, status };
+
+// Allow running directly
+if (require.main === module) {
+  const cmd = process.argv[2];
+  if (cmd === 'install' || cmd === 'setup') {
+    install({ force: process.argv.includes('--force') });
+  } else if (cmd === 'uninstall') {
+    uninstall();
+  } else if (cmd === 'status') {
+    status();
+  } else {
+    console.log('Usage: setup.js [install|uninstall|status]');
+  }
+}