@abyrd9/harbor-cli 1.1.0 → 1.1.1

package/dist/index.js

@@ -6,6 +6,7 @@ import { spawn } from 'node:child_process';
 import { chmodSync } from 'node:fs';
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
+import os from 'node:os';
 // Read version from package.json
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -24,8 +25,107 @@ const requiredDependencies = [
         requiredFor: 'JSON processing in service management',
     },
 ];
+function detectOS() {
+    const platform = os.platform();
+    const arch = os.arch();
+    const isWindows = platform === 'win32';
+    const isMac = platform === 'darwin';
+    const isLinux = platform === 'linux';
+    // Check if running in WSL
+    let isWSL = false;
+    if (isLinux) {
+        try {
+            const release = fs.readFileSync('/proc/version', 'utf-8');
+            isWSL = release.toLowerCase().includes('microsoft') || release.toLowerCase().includes('wsl');
+        }
+        catch {
+            // If we can't read /proc/version, assume not WSL
+        }
+    }
+    return {
+        platform,
+        arch,
+        isWindows,
+        isMac,
+        isLinux,
+        isWSL,
+    };
+}
+function getInstallInstructions(dependency, osInfo) {
+    const instructions = [];
+    if (dependency === 'tmux') {
+        if (osInfo.isMac) {
+            instructions.push('🍎 macOS:');
+            instructions.push('  • Using Homebrew: brew install tmux');
+            instructions.push('  • Using MacPorts: sudo port install tmux');
+            instructions.push('  • Manual: https://github.com/tmux/tmux/wiki/Installing');
+        }
+        else if (osInfo.isLinux) {
+            if (osInfo.isWSL) {
+                instructions.push('🐧 WSL/Linux:');
+                instructions.push('  • Ubuntu/Debian: sudo apt update && sudo apt install tmux');
+                instructions.push('  • CentOS/RHEL: sudo yum install tmux');
+                instructions.push('  • Fedora: sudo dnf install tmux');
+                instructions.push('  • Arch: sudo pacman -S tmux');
+                instructions.push('  • openSUSE: sudo zypper install tmux');
+            }
+            else {
+                instructions.push('🐧 Linux:');
+                instructions.push('  • Ubuntu/Debian: sudo apt update && sudo apt install tmux');
+                instructions.push('  • CentOS/RHEL: sudo yum install tmux');
+                instructions.push('  • Fedora: sudo dnf install tmux');
+                instructions.push('  • Arch: sudo pacman -S tmux');
+                instructions.push('  • openSUSE: sudo zypper install tmux');
+            }
+        }
+        else if (osInfo.isWindows) {
+            instructions.push('🪟 Windows:');
+            instructions.push('  • Using Chocolatey: choco install tmux');
+            instructions.push('  • Using Scoop: scoop install tmux');
+            instructions.push('  • Using WSL: Install in WSL and use from there');
+            instructions.push('  • Manual: https://github.com/tmux/tmux/wiki/Installing');
+        }
+    }
+    else if (dependency === 'jq') {
+        if (osInfo.isMac) {
+            instructions.push('🍎 macOS:');
+            instructions.push('  • Using Homebrew: brew install jq');
+            instructions.push('  • Using MacPorts: sudo port install jq');
+            instructions.push('  • Using Fink: fink install jq');
+            instructions.push('  • Manual: https://jqlang.org/download/');
+        }
+        else if (osInfo.isLinux) {
+            if (osInfo.isWSL) {
+                instructions.push('🐧 WSL/Linux:');
+                instructions.push('  • Ubuntu/Debian: sudo apt update && sudo apt install jq');
+                instructions.push('  • CentOS/RHEL: sudo yum install jq');
+                instructions.push('  • Fedora: sudo dnf install jq');
+                instructions.push('  • Arch: sudo pacman -S jq');
+                instructions.push('  • openSUSE: sudo zypper install jq');
+            }
+            else {
+                instructions.push('🐧 Linux:');
+                instructions.push('  • Ubuntu/Debian: sudo apt update && sudo apt install jq');
+                instructions.push('  • CentOS/RHEL: sudo yum install jq');
+                instructions.push('  • Fedora: sudo dnf install jq');
+                instructions.push('  • Arch: sudo pacman -S jq');
+                instructions.push('  • openSUSE: sudo zypper install jq');
+            }
+        }
+        else if (osInfo.isWindows) {
+            instructions.push('🪟 Windows:');
+            instructions.push('  • Using winget: winget install jqlang.jq');
+            instructions.push('  • Using Chocolatey: choco install jq');
+            instructions.push('  • Using Scoop: scoop install jq');
+            instructions.push('  • Using WSL: Install in WSL and use from there');
+            instructions.push('  • Manual: https://jqlang.org/download/');
+        }
+    }
+    return instructions;
+}
 async function checkDependencies() {
     const missingDeps = [];
+    const osInfo = detectOS();
     for (const dep of requiredDependencies) {
         try {
             await new Promise((resolve, reject) => {
@@ -44,10 +144,19 @@ async function checkDependencies() {
     }
     if (missingDeps.length > 0) {
         console.log('❌ Missing required dependencies:');
+        console.log(`\n🖥️  Detected OS: ${osInfo.platform} ${osInfo.arch}${osInfo.isWSL ? ' (WSL)' : ''}`);
         for (const dep of missingDeps) {
-            console.log(`\n${dep.name} (required for ${dep.requiredFor})`);
-            console.log(`Install instructions: ${dep.installMsg}`);
+            console.log(`\n📦 ${dep.name} (required for ${dep.requiredFor})`);
+            const instructions = getInstallInstructions(dep.name, osInfo);
+            if (instructions.length > 0) {
+                console.log('   Installation options:');
+                instructions.forEach(instruction => console.log(instruction));
+            }
+            else {
+                console.log(`   General instructions: ${dep.installMsg}`);
+            }
         }
+        console.log('\n💡 After installing the dependencies, run Harbor again.');
         throw new Error('Please install missing dependencies before continuing');
     }
 }
@@ -88,6 +197,7 @@ This is typically the first command you'll run in a new project.`)
     .option('-p, --path <path>', 'The path to the root of your project', './')
     .action(async (options) => {
     try {
+        await checkDependencies();
         const configExists = checkHasHarborConfig();
         if (configExists) {
             console.log('❌ Error: Harbor project already initialized');
@@ -107,20 +217,34 @@ program.command('moor')
     .description('Add new services to your harbor configuration')
     .option('-p, --path <path>', 'The path to the root of your project', './')
     .action(async (options) => {
-    if (!checkHasHarborConfig()) {
-        console.log('❌ No harbor configuration found');
-        console.log('\nTo initialize a new Harbor project, please use:');
-        console.log('  harbor dock');
+    try {
+        await checkDependencies();
+        if (!checkHasHarborConfig()) {
+            console.log('❌ No harbor configuration found');
+            console.log('\nTo initialize a new Harbor project, please use:');
+            console.log('  harbor dock');
+            process.exit(1);
+        }
+        await generateDevFile(options.path);
+    }
+    catch (err) {
+        console.log('❌ Error:', err instanceof Error ? err.message : 'Unknown error');
         process.exit(1);
     }
-    await generateDevFile(options.path);
 });
 program.command('launch')
     .description(`Launch your services in the harbor terminal multiplexer (Using tmux)
 
 Note: This command will stop any active Caddy processes, including those from other Harbor projects.`)
     .action(async () => {
-    await runServices();
+    try {
+        await checkDependencies();
+        await runServices();
+    }
+    catch (err) {
+        console.log('❌ Error:', err instanceof Error ? err.message : 'Unknown error');
+        process.exit(1);
+    }
 });
 program.parse();
 function fileExists(path) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@abyrd9/harbor-cli",
-  "version": "1.1.0",
-  "description": "A CLI tool for managing simple local development services with tmux sessions",
+  "version": "1.1.1",
+  "description": "A CLI tool for orchestrating local development services in tmux sessions. Perfect for microservices and polyglot projects with automatic service discovery and before/after script support.",
   "type": "module",
   "bin": {
     "harbor": "dist/index.js"