Yay

Author: Explosion-Scratch

CLAUDE.md

@@ -0,0 +1,126 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+`justinstall` is a command-line tool that makes it easy to install software from various sources including GitHub repositories, direct URLs, and local files. It supports multiple file formats and platforms, with intelligent detection of install scripts and binaries.
+
+## Development Environment
+
+- **Runtime**: Bun (JavaScript runtime)
+- **Main entry point**: `index.js`
+- **Configuration**: `jsconfig.json` (TypeScript support without compilation)
+- **Build script**: `build.sh` for creating platform-specific binaries
+
+## Build Commands
+
+```bash
+# Build for all platforms
+./build.sh
+
+# Individual platform builds (manual)
+bun build --compile --target=bun-linux-x64 index.js --outfile build/justinstall-v1.2.0-linux-x64
+bun build --compile --target=bun-linux-arm64 index.js --outfile build/justinstall-v1.2.0-linux-arm64
+bun build --compile --target=bun-windows-x64 index.js --outfile build/justinstall-v1.2.0-windows-x64.exe
+bun build --compile --target=bun-darwin-x64 index.js --outfile build/justinstall-v1.2.0-darwin-x64
+bun build --compile --target=bun-darwin-arm64 index.js --outfile build/justinstall-v1.2.0-darwin-arm64
+```
+
+## Architecture Overview
+
+### Core Components
+
+1. **Main Entry Point (`index.js`)**
+   - CLI argument parsing and command routing
+   - Help text and usage information
+   - Integration of all major modules
+
+2. **Installation System (`lib/installer.js`)**
+   - Main installation orchestration
+   - Coordinates between sources and installers
+   - Handles user confirmation and progress tracking
+
+3. **Source Management (`lib/sources.js`)**
+   - GitHub repository parsing and asset discovery
+   - Website scraping and download detection
+   - Smart URL handling and fallback strategies
+   - Install script detection from README/release notes
+
+4. **Platform Installers (`lib/installers.js`)**
+   - Platform-specific installation logic
+   - Archive extraction (tar.gz, zip, tar.xz)
+   - Binary detection and installation (~/.local/bin)
+   - macOS-specific: DMG mounting, PKG installation, .app handling
+   - Linux-specific: DEB package installation
+
+5. **Update Management (`lib/updater.js`)**
+   - Configuration management (`~/.config/justinstall/config.json`)
+   - Update checking and installation
+   - Package listing and uninstallation
+
+6. **Search Functionality (`lib/search.js`)**
+   - GitHub repository search
+   - Interactive selection interface
+   - Repository metadata fetching
+
+7. **Utilities (`lib/utils.js`)**
+   - Logging system with configurable levels
+   - File operations and path management
+   - Platform detection and capability checking
+   - User interaction helpers (confirmation prompts)
+
+8. **Configuration (`lib/config.js`)**
+   - Installation history tracking
+   - Package metadata storage
+   - Configuration file management
+
+## Key Features
+
+### Installation Sources
+- **GitHub**: Repository owner/repo format, releases, assets
+- **Direct URLs**: Website downloads, direct file links
+- **Local Files**: Local package installation
+- **Smart URLs**: Intelligent fallback and discovery
+
+### Supported Formats
+- Archives: `.tar.gz`, `.zip`, `.tar.xz`
+- macOS: `.dmg`, `.pkg`, `.app`
+- Linux: `.deb`
+- Binaries: Direct executable installation
+
+### Platform Support
+- **macOS**: Full support with code signing and quarantine handling
+- **Linux**: Binary and DEB package support
+- **Windows**: Basic binary support
+- **BSD**: Limited support for basic operations
+
+## Installation Strategy
+
+The tool uses a sophisticated asset selection algorithm:
+1. Platform-specific asset detection (architecture, OS)
+2. Fallback chains for compatibility
+3. Smart binary detection within archives
+4. Install script discovery and execution
+5. User confirmation for overwrites and sensitive operations
+
+## Configuration
+
+- **Config location**: `~/.config/justinstall/config.json`
+- **Binary install location**: `~/.local/bin`
+- **Logging**: Configurable levels with file output option
+- **Update tracking**: Automatic version checking and updates
+
+## Testing
+
+The project currently does not have automated tests. Manual testing should cover:
+- Installation from various sources
+- Different file formats and platforms
+- Update and uninstall operations
+- Error handling and edge cases
+
+## Dependencies
+
+- **cli-progress**: Progress bar functionality
+- **@types/bun**: TypeScript definitions for Bun
+- **typescript**: Peer dependency for type checking

index.js

@@ -224,6 +224,7 @@ const main = async () => {
   } catch (error) {
     const log = createLogger();
     log.error(error.message);
+    log.error(error.stack);
     process.exit(1);
   }
 })();

lib/config.js

@@ -103,10 +103,10 @@ const extractName = (selected) => {
   return selected.name
     .replace(/\.(tar\.gz|tar\.xz|zip|dmg|pkg|deb|app)$/i, "")
     .replace(/v?[0-9]+\.[0-9]+\.[0-9]+/i, "")
-    .replace(/[-_]+(?:darwin|linux|windows|mac|osx|apple|x64|arm64|aarch64|universal|amd64)[-_]*/gi, "")
-    .replace(/(?:darwin|linux|windows|mac|osx|apple|x64|arm64|aarch64|universal|amd64)[-_]*/gi, "")
-    .replace(/[-_]+(?:darwin|linux|windows|mac|osx|apple|x64|arm64|aarch64|universal|amd64)$/gi, "")
-    .replace(/^(?:darwin|linux|windows|mac|osx|apple|x64|arm64|aarch64|universal|amd64)[-_]+/gi, "")
+    .replace(/[-_]+(?:darwin|linux|windows|mac|osx|macos|apple|x64|arm64|aarch64|universal|amd64)[-_]*/gi, "")
+    .replace(/(?:darwin|linux|windows|mac|osx|macos|apple|x64|arm64|aarch64|universal|amd64)[-_]*/gi, "")
+    .replace(/[-_]+(?:darwin|linux|windows|mac|osx|macos|apple|x64|arm64|aarch64|universal|amd64)$/gi, "")
+    .replace(/^(?:darwin|linux|windows|mac|osx|macos|apple|x64|arm64|aarch64|universal|amd64)[-_]+/gi, "")
     .replace(/[0-9]+\.[0-9]+\.[0-9]+/i, "")
     .replace(/[-_]+$/, "")
     .replace(/^[-_]+/, "")

lib/installer.js

@@ -1,6 +1,6 @@
 const fs = require("fs");
 const path = require("path");
-const { execSync } = require("child_process");
+const { safeExecSync } = require("./utils");
 const os = require("os");
 
 const {
@@ -65,7 +65,7 @@ const performInstallation = async (args, isUpdate = false, yesFlag = false) => {
   const source = parseSource(args[0]);
   const customFilePath = args[1]; // For update with custom file path
 
-  tmpdir = execSync("mktemp -d").toString().trim();
+  tmpdir = safeExecSync("mktemp -d", [], { encoding: "utf8" }).trim();
 
   const platformInfo = getPlatformInfo();
   const capabilities = getInstallCapabilities();
@@ -110,6 +110,7 @@ const performInstallation = async (args, isUpdate = false, yesFlag = false) => {
           platformInfo,
           capabilities,
           log,
+          yesFlag,
         );
 
         // Handle script installation case
@@ -128,9 +129,7 @@ const performInstallation = async (args, isUpdate = false, yesFlag = false) => {
     }
 
     const shouldInstall = await confirm(
-      `Ok to ${isUpdate ? "update" : "install"} ${selected.name} (${fileSize(
-        selected.size,
-      )})?`,
+      `Ok to ${isUpdate ? "update" : "install"} ${selected.name} (${selected.size ? fileSize(selected.size) : selected.browser_download_url})?`,
       "y",
       yesFlag
     );
@@ -478,10 +477,10 @@ const selectInstallScript = async (installScripts, log, yesFlag = false) => {
 const executeInstallScript = (script, log) => {
   log.debug("Running install script...");
   const processedCode = processInstallSnippetReplacements(script.code);
-  execSync(processedCode, { stdio: "inherit" });
+  safeExecSync("sh", ["-c", processedCode], { stdio: "inherit" });
 };
 
-const handleGitHubSource = async (source, platformInfo, capabilities, log) => {
+const handleGitHubSource = async (source, platformInfo, capabilities, log, yesFlag = false) => {
   let assets = [];
   let body = "";
   let tag = null;
@@ -535,8 +534,8 @@ const handleGitHubSource = async (source, platformInfo, capabilities, log) => {
         scriptPath,
         log,
       );
-      execSync(`chmod +x ${JSON.stringify(scriptPath)}`);
-      execSync(scriptPath, { stdio: "inherit" });
+      safeExecSync("chmod", ["+x", scriptPath]);
+      safeExecSync(scriptPath, [], { stdio: "inherit" });
 
       const installRecord = createInstallationRecord(source, installerScript, {
         name: source.repo,
@@ -667,7 +666,7 @@ const installSelected = async (selected, downloadPath, log, yesFlag = false) =>
 
           // Ask to open app
           if (await confirm(`Open app ${path.basename(destinations[0])}?`)) {
-            execSync(`open -n ${JSON.stringify(destinations[0])}`);
+            safeExecSync("open", ["-n", destinations[0]]);
           }
         } else if (pkgFile) {
           log.log(`Installing .pkg file: ${pkgFile}`);
@@ -718,7 +717,7 @@ const installSelected = async (selected, downloadPath, log, yesFlag = false) =>
 
       // Ask to open app
       if (await confirm(`Open app ${path.basename(destinations[0])}?`, "y", yesFlag)) {
-        execSync(`open -n ${JSON.stringify(destinations[0])}`);
+        safeExecSync("open", ["-n", destinations[0]]);
       }
       break;
 
@@ -763,7 +762,7 @@ const installSelected = async (selected, downloadPath, log, yesFlag = false) =>
         if (installationMethod === "archive_app") {
           // Ask to open app
           if (await confirm(`Open app ${path.basename(destinations[0])}?`, "y", yesFlag)) {
-            execSync(`open -n ${JSON.stringify(destinations[0])}`);
+            safeExecSync("open", ["-n", destinations[0]]);
           }
         }
       } else {
@@ -793,9 +792,42 @@ const installSelected = async (selected, downloadPath, log, yesFlag = false) =>
 const cleanup = () => {
   if (tmpdir && fs.existsSync(tmpdir)) {
     try {
+      // First, try to make files writable in case they're read-only
+      const { safeExecSync } = require('./utils');
+      try {
+        safeExecSync('chmod', ['-R', '+w', tmpdir], { stdio: 'pipe' });
+      } catch (chmodError) {
+        // If chmod fails, continue with cleanup attempt
+      }
+      
+      // Attempt to remove the directory
       fs.rmSync(tmpdir, { recursive: true, force: true });
     } catch (e) {
-      // Ignore cleanup errors
+      // If removal fails, try a more aggressive approach
+      try {
+        // Try to remove individual files first
+        const files = fs.readdirSync(tmpdir, { withFileTypes: true });
+        for (const file of files) {
+          const filePath = path.join(tmpdir, file.name);
+          try {
+            if (file.isDirectory()) {
+              fs.rmSync(filePath, { recursive: true, force: true });
+            } else {
+              fs.unlinkSync(filePath);
+            }
+          } catch (fileError) {
+            // Continue with other files if one fails
+          }
+        }
+        // Try to remove the directory again
+        fs.rmSync(tmpdir, { recursive: true, force: true });
+      } catch (finalError) {
+        // If all attempts fail, log a warning but don't crash
+        const { createLogger } = require('./utils');
+        const logger = createLogger();
+        logger.warn(`Failed to completely clean up temporary directory: ${tmpdir}`);
+        logger.warn(`Manual cleanup may be required. Error: ${finalError.message}`);
+      }
     }
   }
 };