zuppaclaude 1.0.0

package/lib/components/claudehud.js

@@ -0,0 +1,198 @@
+/**
+ * Claude HUD component installer
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { Logger } = require('../utils/logger');
+const { Platform } = require('../utils/platform');
+
+class ClaudeHUDInstaller {
+  constructor() {
+    this.platform = new Platform();
+    this.logger = new Logger();
+    this.binPath = path.join(this.platform.localBin, this.platform.isWindows ? 'setup-claude-hud.cmd' : 'setup-claude-hud');
+  }
+
+  /**
+   * Check if Claude HUD setup script is installed
+   */
+  isInstalled() {
+    return fs.existsSync(this.binPath);
+  }
+
+  /**
+   * Check Claude Code version
+   */
+  checkVersion() {
+    if (!this.platform.commandExists('claude')) {
+      return { ok: false, version: null, message: 'Claude Code not found' };
+    }
+
+    try {
+      const output = this.platform.exec('claude --version', { silent: true });
+      const match = output?.match(/(\d+)\.(\d+)\.(\d+)/);
+
+      if (match) {
+        const [, major, minor, patch] = match.map(Number);
+        const version = `${major}.${minor}.${patch}`;
+
+        // Check if version >= 1.0.80
+        if (major < 1 || (major === 1 && minor === 0 && patch < 80)) {
+          return { ok: false, version, message: `Version ${version} < 1.0.80` };
+        }
+
+        return { ok: true, version, message: null };
+      }
+    } catch {
+      // Ignore errors
+    }
+
+    return { ok: true, version: 'unknown', message: null };
+  }
+
+  /**
+   * Install Claude HUD setup script
+   */
+  async install() {
+    this.logger.step('Step 6/7: Installing Claude HUD (Status Display)');
+
+    // Check version
+    const versionCheck = this.checkVersion();
+    if (!versionCheck.ok) {
+      this.logger.warning(versionCheck.message);
+      if (versionCheck.version) {
+        this.logger.info('Claude HUD requires Claude Code v1.0.80 or later');
+        this.logger.info('Update with: npm update -g @anthropic-ai/claude-code');
+      }
+      return false;
+    }
+
+    try {
+      this.platform.ensureDir(this.platform.localBin);
+
+      if (this.platform.isWindows) {
+        await this.createWindowsScript();
+      } else {
+        await this.createUnixScript();
+      }
+
+      this.logger.success('Claude HUD setup script created');
+      this.logger.info('Run \'setup-claude-hud\' for installation instructions');
+      return true;
+    } catch (error) {
+      this.logger.error(`Failed to install Claude HUD: ${error.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * Create Unix setup script
+   */
+  async createUnixScript() {
+    const script = `#!/bin/bash
+# Claude HUD Setup Script
+# Run this script, then execute the commands inside Claude Code
+
+echo ""
+echo -e "\\033[0;35m╔═══════════════════════════════════════════════════════════════════╗\\033[0m"
+echo -e "\\033[0;35m║   Claude HUD Setup                                                ║\\033[0m"
+echo -e "\\033[0;35m╚═══════════════════════════════════════════════════════════════════╝\\033[0m"
+echo ""
+echo "Run these commands inside Claude Code to install Claude HUD:"
+echo ""
+echo -e "  \\033[0;36m1. /plugin marketplace add jarrodwatts/claude-hud\\033[0m"
+echo -e "  \\033[0;36m2. /plugin install claude-hud\\033[0m"
+echo -e "  \\033[0;36m3. /claude-hud:setup\\033[0m"
+echo ""
+echo "Claude HUD provides:"
+echo "  • Real-time context usage meter"
+echo "  • Active tool tracking"
+echo "  • Running agent status"
+echo "  • Todo progress display"
+echo ""
+`;
+
+    fs.writeFileSync(this.binPath, script, 'utf8');
+    fs.chmodSync(this.binPath, 0o755);
+  }
+
+  /**
+   * Create Windows setup script
+   */
+  async createWindowsScript() {
+    const ps1Path = this.binPath.replace('.cmd', '.ps1');
+
+    const ps1Script = `# Claude HUD Setup Script
+# Run this script, then execute the commands inside Claude Code
+
+Write-Host ""
+Write-Host "=======================================================================" -ForegroundColor Magenta
+Write-Host "   Claude HUD Setup" -ForegroundColor Magenta
+Write-Host "=======================================================================" -ForegroundColor Magenta
+Write-Host ""
+Write-Host "Run these commands inside Claude Code to install Claude HUD:"
+Write-Host ""
+Write-Host "  1. /plugin marketplace add jarrodwatts/claude-hud" -ForegroundColor Cyan
+Write-Host "  2. /plugin install claude-hud" -ForegroundColor Cyan
+Write-Host "  3. /claude-hud:setup" -ForegroundColor Cyan
+Write-Host ""
+Write-Host "Claude HUD provides:"
+Write-Host "  - Real-time context usage meter"
+Write-Host "  - Active tool tracking"
+Write-Host "  - Running agent status"
+Write-Host "  - Todo progress display"
+Write-Host ""
+`;
+
+    const cmdScript = `@echo off
+powershell -ExecutionPolicy Bypass -File "%~dp0setup-claude-hud.ps1" %*
+`;
+
+    fs.writeFileSync(ps1Path, ps1Script, 'utf8');
+    fs.writeFileSync(this.binPath, cmdScript, 'utf8');
+  }
+
+  /**
+   * Uninstall Claude HUD setup script
+   */
+  uninstall() {
+    if (!this.isInstalled()) {
+      this.logger.warning('Claude HUD setup script not found');
+      return true;
+    }
+
+    try {
+      fs.unlinkSync(this.binPath);
+
+      if (this.platform.isWindows) {
+        const ps1Path = this.binPath.replace('.cmd', '.ps1');
+        if (fs.existsSync(ps1Path)) {
+          fs.unlinkSync(ps1Path);
+        }
+      }
+
+      this.logger.success('Claude HUD setup script removed');
+      return true;
+    } catch (error) {
+      this.logger.error(`Failed to remove Claude HUD: ${error.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * Verify installation
+   */
+  verify() {
+    if (this.isInstalled()) {
+      this.logger.success('Claude HUD: Setup script ready');
+      this.logger.info('Run \'setup-claude-hud\' for installation instructions');
+      return true;
+    } else {
+      this.logger.warning('Claude HUD: Not installed');
+      return false;
+    }
+  }
+}
+
+module.exports = { ClaudeHUDInstaller };

package/lib/components/claudez.js

@@ -0,0 +1,205 @@
+/**
+ * Claude-Z component installer
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { Logger } = require('../utils/logger');
+const { Platform } = require('../utils/platform');
+
+class ClaudeZInstaller {
+  constructor() {
+    this.platform = new Platform();
+    this.logger = new Logger();
+    this.configDir = this.platform.zaiConfigDir;
+    this.binPath = path.join(this.platform.localBin, this.platform.isWindows ? 'claude-z.cmd' : 'claude-z');
+  }
+
+  /**
+   * Check if Claude-Z is installed
+   */
+  isInstalled() {
+    return fs.existsSync(this.binPath);
+  }
+
+  /**
+   * Install Claude-Z
+   */
+  async install(apiKey) {
+    this.logger.step('Step 5/7: Installing Claude-Z (z.ai backend)');
+
+    if (!apiKey) {
+      this.logger.info('Skipping Claude-Z installation (no API key provided)');
+      return false;
+    }
+
+    try {
+      // Ensure directories exist
+      this.platform.ensureDir(this.configDir);
+      this.platform.ensureDir(this.platform.localBin);
+
+      // Save API key
+      const apiKeyPath = path.join(this.configDir, 'api_key');
+      fs.writeFileSync(apiKeyPath, apiKey, 'utf8');
+      fs.chmodSync(apiKeyPath, 0o600);
+      this.logger.success('Z.AI API key saved');
+
+      // Create claude-z script
+      if (this.platform.isWindows) {
+        await this.createWindowsScript();
+      } else {
+        await this.createUnixScript();
+      }
+
+      this.logger.success('Claude-Z installed');
+      return true;
+    } catch (error) {
+      this.logger.error(`Failed to install Claude-Z: ${error.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * Create Unix claude-z script
+   */
+  async createUnixScript() {
+    const script = `#!/bin/bash
+#===============================================================================
+#   Claude-Z - Claude Code with z.ai backend
+#===============================================================================
+
+ZAI_CONFIG_DIR="$HOME/.config/zai"
+API_KEY_FILE="$ZAI_CONFIG_DIR/api_key"
+
+# Banner
+echo ""
+echo -e "\\033[0;35m╔═══════════════════════════════════════════════════════════════════╗\\033[0m"
+echo -e "\\033[0;35m║   🚀 Claude-Z - Claude Code with z.ai backend                     ║\\033[0m"
+echo -e "\\033[0;35m╚═══════════════════════════════════════════════════════════════════╝\\033[0m"
+echo ""
+
+# Check for API key
+if [ ! -f "$API_KEY_FILE" ]; then
+    echo -e "\\033[0;31m[✗] Z.AI API key not found\\033[0m"
+    echo "Run the installer again to configure Claude-Z"
+    exit 1
+fi
+
+ZAI_API_KEY=$(cat "$API_KEY_FILE")
+
+# Export environment and run Claude
+export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
+export ANTHROPIC_API_KEY="$ZAI_API_KEY"
+
+echo -e "\\033[0;32m[✓]\\033[0m Using z.ai backend"
+echo -e "\\033[0;34m[i]\\033[0m Starting Claude Code..."
+echo ""
+
+exec claude "$@"
+`;
+
+    fs.writeFileSync(this.binPath, script, 'utf8');
+    fs.chmodSync(this.binPath, 0o755);
+  }
+
+  /**
+   * Create Windows claude-z script
+   */
+  async createWindowsScript() {
+    const ps1Path = this.binPath.replace('.cmd', '.ps1');
+
+    const ps1Script = `#===============================================================================
+#   Claude-Z - Claude Code with z.ai backend
+#===============================================================================
+
+$ZAI_CONFIG_DIR = "$env:USERPROFILE\\.config\\zai"
+$API_KEY_FILE = "$ZAI_CONFIG_DIR\\api_key"
+
+# Banner
+Write-Host ""
+Write-Host "=======================================================================" -ForegroundColor Magenta
+Write-Host "   Claude-Z - Claude Code with z.ai backend" -ForegroundColor Magenta
+Write-Host "=======================================================================" -ForegroundColor Magenta
+Write-Host ""
+
+# Check for API key
+if (-not (Test-Path $API_KEY_FILE)) {
+    Write-Host "[X] Z.AI API key not found" -ForegroundColor Red
+    Write-Host "Run the installer again to configure Claude-Z"
+    exit 1
+}
+
+$ZAI_API_KEY = Get-Content $API_KEY_FILE -Raw
+
+# Set environment and run Claude
+$env:ANTHROPIC_BASE_URL = "https://api.z.ai/api/anthropic"
+$env:ANTHROPIC_API_KEY = $ZAI_API_KEY.Trim()
+
+Write-Host "[OK] Using z.ai backend" -ForegroundColor Green
+Write-Host "[i] Starting Claude Code..." -ForegroundColor Blue
+Write-Host ""
+
+& claude $args
+`;
+
+    const cmdScript = `@echo off
+powershell -ExecutionPolicy Bypass -File "%~dp0claude-z.ps1" %*
+`;
+
+    fs.writeFileSync(ps1Path, ps1Script, 'utf8');
+    fs.writeFileSync(this.binPath, cmdScript, 'utf8');
+  }
+
+  /**
+   * Uninstall Claude-Z
+   */
+  uninstall() {
+    let success = true;
+
+    // Remove script
+    if (fs.existsSync(this.binPath)) {
+      fs.unlinkSync(this.binPath);
+      this.logger.success('Claude-Z script removed');
+    }
+
+    // Remove PS1 on Windows
+    if (this.platform.isWindows) {
+      const ps1Path = this.binPath.replace('.cmd', '.ps1');
+      if (fs.existsSync(ps1Path)) {
+        fs.unlinkSync(ps1Path);
+      }
+    }
+
+    // Remove config
+    if (fs.existsSync(this.configDir)) {
+      fs.rmSync(this.configDir, { recursive: true });
+      this.logger.success('Z.AI configuration removed');
+    }
+
+    return success;
+  }
+
+  /**
+   * Verify installation
+   */
+  verify() {
+    const apiKeyPath = path.join(this.configDir, 'api_key');
+
+    if (this.isInstalled()) {
+      this.logger.success('Claude-Z: Installed');
+    } else {
+      this.logger.warning('Claude-Z: Not installed');
+      return false;
+    }
+
+    if (fs.existsSync(apiKeyPath)) {
+      this.logger.success('Z.AI API Key: Configured');
+      return true;
+    } else {
+      this.logger.warning('Z.AI API Key: Not configured');
+      return false;
+    }
+  }
+}
+
+module.exports = { ClaudeZInstaller };

package/lib/components/config.js

@@ -0,0 +1,143 @@
+/**
+ * Configuration (CLAUDE.md) installer
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { Logger } = require('../utils/logger');
+const { Platform } = require('../utils/platform');
+
+const CONFIG_URL = 'https://raw.githubusercontent.com/hasankaantan/zuppaclaude/main/assets/CLAUDE.md';
+
+class ConfigInstaller {
+  constructor() {
+    this.platform = new Platform();
+    this.logger = new Logger();
+    this.configPath = path.join(this.platform.claudeDir, 'CLAUDE.md');
+  }
+
+  /**
+   * Check if config is installed
+   */
+  isInstalled() {
+    return fs.existsSync(this.configPath);
+  }
+
+  /**
+   * Install CLAUDE.md configuration
+   */
+  async install() {
+    this.logger.step('Step 4/7: Installing Configuration');
+
+    try {
+      this.platform.ensureDir(this.platform.claudeDir);
+
+      // Backup existing config
+      if (this.isInstalled()) {
+        const timestamp = Date.now();
+        const backupPath = `${this.configPath}.backup.${timestamp}`;
+        fs.copyFileSync(this.configPath, backupPath);
+        this.logger.info(`Existing config backed up to: ${backupPath}`);
+      }
+
+      // Download CLAUDE.md
+      this.logger.info('Downloading CLAUDE.md...');
+      await this.platform.download(CONFIG_URL, this.configPath);
+
+      this.logger.success('CLAUDE.md installed');
+      return true;
+    } catch (error) {
+      this.logger.error(`Failed to install config: ${error.message}`);
+
+      // Create a basic fallback config
+      try {
+        this.logger.info('Creating fallback configuration...');
+        const fallbackConfig = this.getFallbackConfig();
+        fs.writeFileSync(this.configPath, fallbackConfig, 'utf8');
+        this.logger.success('Fallback CLAUDE.md created');
+        return true;
+      } catch (fallbackError) {
+        this.logger.error(`Failed to create fallback config: ${fallbackError.message}`);
+        return false;
+      }
+    }
+  }
+
+  /**
+   * Get fallback configuration
+   */
+  getFallbackConfig() {
+    return `# Claude Code - Enhanced System Instructions
+
+## General Behavior
+- Be proactive: After analysis ask "Should I implement?" or "Let's start?"
+- Provide summary report when done (commit hash, changes, line count)
+- Don't ask open-ended questions, suggest the best option
+
+## SuperClaude Framework (Active)
+SuperClaude slash commands are loaded. Use them proactively:
+
+### Planning & Design
+- \`/sc:brainstorm\` - Idea development and brainstorming
+- \`/sc:design\` - Architectural design
+- \`/sc:estimate\` - Time/resource estimation
+
+### Development
+- \`/sc:implement\` - Code implementation
+- \`/sc:build\` - Build and compile
+- \`/sc:improve\` - Code improvement
+- \`/sc:explain\` - Code explanation
+
+### Testing & Quality
+- \`/sc:test\` - Test creation
+- \`/sc:analyze\` - Code analysis
+- \`/sc:troubleshoot\` - Debugging
+
+### Project Management
+- \`/sc:task\` - Task management
+- \`/sc:workflow\` - Workflow management
+- \`/sc:pm\` - Project management
+
+## Response Format
+- Short and concise answers
+- Use Markdown formatting
+- Specify language for code blocks
+`;
+  }
+
+  /**
+   * Uninstall config
+   */
+  uninstall() {
+    if (!this.isInstalled()) {
+      this.logger.warning('CLAUDE.md not found');
+      return true;
+    }
+
+    try {
+      const timestamp = Date.now();
+      const backupPath = `${this.configPath}.uninstall.${timestamp}`;
+      fs.renameSync(this.configPath, backupPath);
+      this.logger.success(`CLAUDE.md backed up to: ${backupPath}`);
+      return true;
+    } catch (error) {
+      this.logger.error(`Failed to backup CLAUDE.md: ${error.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * Verify installation
+   */
+  verify() {
+    if (this.isInstalled()) {
+      this.logger.success('CLAUDE.md: Installed');
+      return true;
+    } else {
+      this.logger.error('CLAUDE.md: Not installed');
+      return false;
+    }
+  }
+}
+
+module.exports = { ConfigInstaller };

package/lib/components/index.js

@@ -0,0 +1,17 @@
+/**
+ * Component installers index
+ */
+
+const { SuperClaudeInstaller } = require('./superclaude');
+const { SpecKitInstaller } = require('./speckit');
+const { ConfigInstaller } = require('./config');
+const { ClaudeZInstaller } = require('./claudez');
+const { ClaudeHUDInstaller } = require('./claudehud');
+
+module.exports = {
+  SuperClaudeInstaller,
+  SpecKitInstaller,
+  ConfigInstaller,
+  ClaudeZInstaller,
+  ClaudeHUDInstaller
+};

package/lib/components/speckit.js

@@ -0,0 +1,99 @@
+/**
+ * Spec Kit component installer
+ */
+
+const { Logger } = require('../utils/logger');
+const { Platform } = require('../utils/platform');
+
+const PACKAGE_NAME = 'specify-cli';
+
+class SpecKitInstaller {
+  constructor() {
+    this.platform = new Platform();
+    this.logger = new Logger();
+  }
+
+  /**
+   * Check if Spec Kit is installed
+   */
+  isInstalled() {
+    return this.platform.commandExists('specify');
+  }
+
+  /**
+   * Install Spec Kit
+   */
+  async install() {
+    this.logger.step('Step 3/7: Installing Spec Kit (specify-cli)');
+
+    const pipCommand = this.platform.getPipCommand();
+
+    if (!pipCommand) {
+      this.logger.error('No Python package manager found (pip, pipx, or uv)');
+      this.logger.info('Please install Python 3.8+ with pip');
+      return false;
+    }
+
+    try {
+      this.logger.info(`Installing ${PACKAGE_NAME} using ${pipCommand.split(' ')[0]}...`);
+      this.platform.exec(`${pipCommand} ${PACKAGE_NAME}`, { silent: true });
+      this.logger.success('Spec Kit installed');
+      return true;
+    } catch (error) {
+      this.logger.error(`Failed to install Spec Kit: ${error.message}`);
+
+      // Try fallback methods
+      const fallbacks = ['pipx install', 'pip3 install --user', 'pip install --user'];
+      for (const fallback of fallbacks) {
+        if (fallback === pipCommand) continue;
+        try {
+          this.logger.info(`Trying fallback: ${fallback}...`);
+          this.platform.exec(`${fallback} ${PACKAGE_NAME}`, { silent: true });
+          this.logger.success(`Spec Kit installed via ${fallback.split(' ')[0]}`);
+          return true;
+        } catch {
+          continue;
+        }
+      }
+
+      return false;
+    }
+  }
+
+  /**
+   * Uninstall Spec Kit
+   */
+  uninstall() {
+    const pipCommand = this.platform.getPipUninstallCommand();
+
+    if (!pipCommand) {
+      this.logger.warning('No Python package manager found');
+      return false;
+    }
+
+    try {
+      this.platform.exec(`${pipCommand} ${PACKAGE_NAME}`, { silent: true });
+      this.logger.success('Spec Kit removed');
+      return true;
+    } catch (error) {
+      this.logger.warning(`Could not remove Spec Kit: ${error.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * Verify installation
+   */
+  verify() {
+    if (this.isInstalled()) {
+      this.logger.success('Spec Kit: Installed');
+      return true;
+    } else {
+      this.logger.warning('Spec Kit: Not found in PATH');
+      this.logger.info('You may need to add ~/.local/bin to your PATH');
+      return false;
+    }
+  }
+}
+
+module.exports = { SpecKitInstaller };