@zhigang1992/happy-cli 0.12.1 → 0.12.4

package/scripts/download-tool.cjs

@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+
+/**
+ * Downloads and extracts a tool binary on first use
+ * Usage: node download-tool.cjs <toolName>
+ *
+ * This script is designed to be called before using a tool.
+ * It's idempotent - if the tool is already downloaded, it does nothing.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const https = require('https');
+const { createGunzip } = require('zlib');
+const { pipeline } = require('stream/promises');
+const { getDownloadUrl, getBinaryName, getToolPath, TOOLS } = require('./tools-config.cjs');
+
+/**
+ * Follow redirects and download a file
+ */
+function downloadFile(url, destPath, maxRedirects = 5) {
+    return new Promise((resolve, reject) => {
+        if (maxRedirects <= 0) {
+            reject(new Error('Too many redirects'));
+            return;
+        }
+
+        const protocol = url.startsWith('https') ? https : require('http');
+
+        protocol.get(url, (response) => {
+            // Handle redirects
+            if (response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
+                downloadFile(response.headers.location, destPath, maxRedirects - 1)
+                    .then(resolve)
+                    .catch(reject);
+                return;
+            }
+
+            if (response.statusCode !== 200) {
+                reject(new Error(`Download failed with status ${response.statusCode}`));
+                return;
+            }
+
+            const fileStream = fs.createWriteStream(destPath);
+            response.pipe(fileStream);
+
+            fileStream.on('finish', () => {
+                fileStream.close();
+                resolve();
+            });
+
+            fileStream.on('error', (err) => {
+                fs.unlink(destPath, () => {}); // Clean up partial file
+                reject(err);
+            });
+        }).on('error', reject);
+    });
+}
+
+/**
+ * Extract a tar.gz file
+ */
+async function extractTarGz(archivePath, destDir, toolName) {
+    const tar = require('tar');
+    const tool = TOOLS[toolName];
+
+    await tar.extract({
+        file: archivePath,
+        cwd: destDir,
+        filter: (entryPath) => {
+            // Only extract the binary we need
+            const binaryName = getBinaryName(toolName, os.platform());
+            return entryPath.endsWith(binaryName);
+        },
+        strip: tool.archiveStructure === 'nested' ? 1 : 0
+    });
+}
+
+/**
+ * Extract a zip file (for Windows)
+ */
+async function extractZip(archivePath, destDir, toolName) {
+    const AdmZip = require('adm-zip');
+    const tool = TOOLS[toolName];
+    const binaryName = getBinaryName(toolName, os.platform());
+
+    const zip = new AdmZip(archivePath);
+    const entries = zip.getEntries();
+
+    for (const entry of entries) {
+        if (entry.entryName.endsWith(binaryName)) {
+            const content = entry.getData();
+            const destPath = path.join(destDir, binaryName);
+            fs.writeFileSync(destPath, content);
+            break;
+        }
+    }
+}
+
+/**
+ * Ensure a tool is downloaded and available
+ */
+async function ensureTool(toolName) {
+    const tool = TOOLS[toolName];
+    if (!tool) {
+        throw new Error(`Unknown tool: ${toolName}`);
+    }
+
+    const platform = os.platform();
+    const arch = os.arch();
+    const toolPath = getToolPath(toolName);
+
+    // Check if already downloaded
+    if (fs.existsSync(toolPath)) {
+        return toolPath;
+    }
+
+    const toolDir = path.dirname(toolPath);
+    fs.mkdirSync(toolDir, { recursive: true });
+
+    // Get download URL
+    const url = getDownloadUrl(toolName, platform, arch);
+    const isZip = url.endsWith('.zip');
+    const archivePath = path.join(toolDir, `archive${isZip ? '.zip' : '.tar.gz'}`);
+
+    console.error(`[happy-cli] Downloading ${toolName} v${tool.version}...`);
+
+    try {
+        // Download the archive
+        await downloadFile(url, archivePath);
+
+        // Extract
+        if (isZip) {
+            await extractZip(archivePath, toolDir, toolName);
+        } else {
+            await extractTarGz(archivePath, toolDir, toolName);
+        }
+
+        // Set executable permission on Unix
+        if (platform !== 'win32') {
+            fs.chmodSync(toolPath, 0o755);
+        }
+
+        // Clean up archive
+        fs.unlinkSync(archivePath);
+
+        console.error(`[happy-cli] ${toolName} v${tool.version} installed to ${toolPath}`);
+        return toolPath;
+    } catch (error) {
+        // Clean up on failure
+        try {
+            fs.unlinkSync(archivePath);
+        } catch {}
+        throw error;
+    }
+}
+
+/**
+ * Run a tool, downloading it first if necessary
+ * Returns the path to the binary
+ */
+async function getOrDownloadTool(toolName) {
+    return ensureTool(toolName);
+}
+
+// If run directly, download the specified tool
+if (require.main === module) {
+    const toolName = process.argv[2];
+    if (!toolName) {
+        console.error('Usage: node download-tool.cjs <toolName>');
+        console.error('Available tools:', Object.keys(TOOLS).join(', '));
+        process.exit(1);
+    }
+
+    ensureTool(toolName)
+        .then((toolPath) => {
+            // Output the path so callers can use it
+            console.log(toolPath);
+        })
+        .catch((error) => {
+            console.error(`Failed to download ${toolName}:`, error.message);
+            process.exit(1);
+        });
+}
+
+module.exports = { ensureTool, getOrDownloadTool };

package/scripts/ripgrep_launcher.cjs

@@ -3,12 +3,63 @@
 /**
  * Ripgrep runner - executed as a subprocess to run the native module
  * This file is intentionally written in CommonJS to avoid ESM complexities
+ *
+ * Uses the ripgrep.node native module bundled with @anthropic-ai/claude-code
  */
 
 const path = require('path');
+const os = require('os');
+const fs = require('fs');
 
-// Load the native module from unpacked directory
-const modulePath = path.join(__dirname, '..', 'tools', 'unpacked', 'ripgrep.node');
+/**
+ * Get the platform-specific directory name for claude-code vendor
+ */
+function getPlatformDir() {
+    const platform = os.platform();
+    const arch = os.arch();
+
+    if (platform === 'darwin') {
+        return arch === 'arm64' ? 'arm64-darwin' : 'x64-darwin';
+    } else if (platform === 'linux') {
+        return arch === 'arm64' ? 'arm64-linux' : 'x64-linux';
+    } else if (platform === 'win32') {
+        return 'x64-win32';
+    }
+    throw new Error(`Unsupported platform: ${platform}-${arch}`);
+}
+
+/**
+ * Find the ripgrep.node native module
+ * First checks claude-code vendor directory, falls back to local tools
+ */
+function findRipgrepModule() {
+    const platformDir = getPlatformDir();
+
+    // Try claude-code vendor first (preferred - it's always up to date)
+    const claudeCodePaths = [
+        // When installed as a dependency
+        path.join(__dirname, '..', 'node_modules', '@anthropic-ai', 'claude-code', 'vendor', 'ripgrep', platformDir, 'ripgrep.node'),
+        // When running from workspace root
+        path.join(__dirname, '..', '..', 'node_modules', '@anthropic-ai', 'claude-code', 'vendor', 'ripgrep', platformDir, 'ripgrep.node'),
+    ];
+
+    for (const modulePath of claudeCodePaths) {
+        if (fs.existsSync(modulePath)) {
+            return modulePath;
+        }
+    }
+
+    // Fallback to local tools/unpacked (for development)
+    const localPath = path.join(__dirname, '..', 'tools', 'unpacked', 'ripgrep.node');
+    if (fs.existsSync(localPath)) {
+        return localPath;
+    }
+
+    throw new Error('Could not find ripgrep.node native module. Make sure @anthropic-ai/claude-code is installed.');
+}
+
+// Load the native module
+const modulePath = findRipgrepModule();
 const ripgrepNative = require(modulePath);
 
 // Get arguments from command line (skip node and script name)

package/scripts/tools-config.cjs

@@ -0,0 +1,119 @@
+/**
+ * Configuration for external tool binaries
+ * These are downloaded on first use, not bundled with the package
+ */
+
+const TOOLS = {
+    difftastic: {
+        version: '0.64.0',
+        repo: 'Wilfred/difftastic',
+        // Map platform/arch to GitHub release asset names
+        assets: {
+            'darwin-arm64': 'difft-aarch64-apple-darwin.tar.gz',
+            'darwin-x64': 'difft-x86_64-apple-darwin.tar.gz',
+            'linux-arm64': 'difft-aarch64-unknown-linux-gnu.tar.gz',
+            'linux-x64': 'difft-x86_64-unknown-linux-gnu.tar.gz',
+            'win32-x64': 'difft-x86_64-pc-windows-msvc.zip',
+        },
+        // Binary name inside the archive (or after extraction)
+        binaryName: {
+            'win32': 'difft.exe',
+            'default': 'difft'
+        },
+        // Some archives have the binary in a subdirectory
+        archiveStructure: 'flat' // binary is at root of archive
+    },
+    ripgrep: {
+        version: '14.1.1',
+        repo: 'BurntSushi/ripgrep',
+        assets: {
+            'darwin-arm64': 'ripgrep-14.1.1-aarch64-apple-darwin.tar.gz',
+            'darwin-x64': 'ripgrep-14.1.1-x86_64-apple-darwin.tar.gz',
+            'linux-arm64': 'ripgrep-14.1.1-aarch64-unknown-linux-gnu.tar.gz',
+            'linux-x64': 'ripgrep-14.1.1-x86_64-unknown-linux-musl.tar.gz',
+            'win32-x64': 'ripgrep-14.1.1-x86_64-pc-windows-msvc.zip',
+        },
+        binaryName: {
+            'win32': 'rg.exe',
+            'default': 'rg'
+        },
+        // ripgrep archives have files in a subdirectory named after the archive
+        archiveStructure: 'nested' // binary is in a subdirectory
+    }
+};
+
+/**
+ * Get download URL for a tool
+ */
+function getDownloadUrl(toolName, platform, arch) {
+    const tool = TOOLS[toolName];
+    if (!tool) {
+        throw new Error(`Unknown tool: ${toolName}`);
+    }
+
+    const key = `${platform}-${arch}`;
+    const asset = tool.assets[key];
+    if (!asset) {
+        throw new Error(`Unsupported platform for ${toolName}: ${key}`);
+    }
+
+    return `https://github.com/${tool.repo}/releases/download/${tool.version}/${asset}`;
+}
+
+/**
+ * Get binary name for a tool on the current platform
+ */
+function getBinaryName(toolName, platform) {
+    const tool = TOOLS[toolName];
+    if (!tool) {
+        throw new Error(`Unknown tool: ${toolName}`);
+    }
+
+    return tool.binaryName[platform] || tool.binaryName['default'];
+}
+
+/**
+ * Get cache directory for tools
+ * Uses ~/.cache/happy-cli/tools on Unix, %LOCALAPPDATA%/happy-cli/tools on Windows
+ */
+function getCacheDir() {
+    const os = require('os');
+    const path = require('path');
+
+    const platform = os.platform();
+    const homeDir = os.homedir();
+
+    if (platform === 'win32') {
+        const localAppData = process.env.LOCALAPPDATA || path.join(homeDir, 'AppData', 'Local');
+        return path.join(localAppData, 'happy-cli', 'tools');
+    } else {
+        const cacheHome = process.env.XDG_CACHE_HOME || path.join(homeDir, '.cache');
+        return path.join(cacheHome, 'happy-cli', 'tools');
+    }
+}
+
+/**
+ * Get the expected path for a tool binary
+ */
+function getToolPath(toolName) {
+    const os = require('os');
+    const path = require('path');
+
+    const tool = TOOLS[toolName];
+    if (!tool) {
+        throw new Error(`Unknown tool: ${toolName}`);
+    }
+
+    const cacheDir = getCacheDir();
+    const binaryName = getBinaryName(toolName, os.platform());
+
+    return path.join(cacheDir, toolName, tool.version, binaryName);
+}
+
+module.exports = {
+    TOOLS,
+    getDownloadUrl,
+    getBinaryName,
+    getCacheDir,
+    getToolPath
+};

package/tools/archives/difftastic-LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2021-2025 Wilfred Hughes
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/tools/archives/ripgrep-LICENSE

@@ -1,3 +0,0 @@
-This project is dual-licensed under the Unlicense and MIT licenses.
-
-You may use this code under the terms of either license.

package/tools/licenses/difftastic-LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2021-2025 Wilfred Hughes
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/tools/licenses/ripgrep-LICENSE

@@ -1,3 +0,0 @@
-This project is dual-licensed under the Unlicense and MIT licenses.
-
-You may use this code under the terms of either license.