@ekkos/cli 0.2.18 → 1.0.0

package/dist/commands/setup-remote.js

@@ -189,68 +189,177 @@ async function installService(verbose) {
 async function installMacOSService(verbose) {
     const plistName = 'dev.ekkos.agent';
     const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', `${plistName}.plist`);
-    // Find node path
+    // Find node path - use execPath of current process
     const nodePath = process.execPath;
-    // Find ekkos CLI path (assuming it's in node_modules/.bin or globally installed)
+    if (verbose) {
+        console.log(chalk_1.default.gray(`  Node path: ${nodePath}`));
+    }
+    // Find ekkos CLI path
     let ekkosPath;
+    let useNpx = false;
     try {
         ekkosPath = (0, child_process_1.execSync)('which ekkos', { encoding: 'utf-8' }).trim();
+        if (!ekkosPath)
+            throw new Error('Empty path');
     }
     catch {
         // Fall back to npx
-        ekkosPath = 'npx @ekkos/cli';
+        ekkosPath = 'npx';
+        useNpx = true;
     }
-    const plistContent = `<?xml version="1.0" encoding="UTF-8"?>
+    if (verbose) {
+        console.log(chalk_1.default.gray(`  ekkOS path: ${ekkosPath}${useNpx ? ' (via npx)' : ''}`));
+    }
+    // Build program arguments
+    const programArgs = [nodePath];
+    if (useNpx) {
+        programArgs.push(ekkosPath);
+        programArgs.push('@ekkos/cli');
+    }
+    else {
+        programArgs.push(ekkosPath);
+    }
+    programArgs.push('agent');
+    programArgs.push('daemon');
+    // Build plist XML programmatically to avoid string template issues
+    const plistContent = buildPlist(plistName, programArgs, nodePath);
+    // Ensure directory exists
+    const launchAgentsDir = path.dirname(plistPath);
+    if (!fs.existsSync(launchAgentsDir)) {
+        fs.mkdirSync(launchAgentsDir, { recursive: true });
+    }
+    // Unload if already loaded
+    try {
+        (0, child_process_1.execSync)(`launchctl unload "${plistPath}" 2>/dev/null`, { encoding: 'utf-8' });
+        if (verbose) {
+            console.log(chalk_1.default.gray(`  Unloaded existing: ${plistName}`));
+        }
+    }
+    catch {
+        // Ignore if not loaded
+    }
+    // Write plist
+    fs.writeFileSync(plistPath, plistContent);
+    if (verbose) {
+        console.log(chalk_1.default.gray(`  Created: ${plistPath}`));
+    }
+    // Load the service
+    try {
+        (0, child_process_1.execSync)(`launchctl load "${plistPath}"`, { encoding: 'utf-8' });
+        if (verbose) {
+            console.log(chalk_1.default.gray(`  Loaded: ${plistName}`));
+        }
+    }
+    catch (err) {
+        throw new Error(`Failed to load launchd service: ${err.message}`);
+    }
+    // Verify it's loaded
+    try {
+        const output = (0, child_process_1.execSync)('launchctl list | grep dev.ekkos.agent', { encoding: 'utf-8' });
+        if (verbose && output.trim()) {
+            console.log(chalk_1.default.gray(`  Service status: ${output.trim()}`));
+        }
+    }
+    catch {
+        // Ignore if grep finds nothing
+    }
+}
+/**
+ * Build plist content with proper XML escaping
+ */
+function buildPlist(label, args, nodePath) {
+    const homeDir = os.homedir();
+    const ekkosDir = state_1.EKKOS_DIR;
+    const nodeBinDir = path.dirname(nodePath);
+    const launchPath = `${nodeBinDir}:${path.join(homeDir, '.local', 'bin')}:/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin`;
+    // Build ProgramArguments array
+    let argXml = '';
+    for (const arg of args) {
+        argXml += `        <string>${escapeXml(arg)}</string>\n`;
+    }
+    return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
     <key>Label</key>
-    <string>${plistName}</string>
+    <string>${escapeXml(label)}</string>
+
     <key>ProgramArguments</key>
     <array>
-        <string>${nodePath}</string>
-        <string>${ekkosPath.includes('npx') ? ekkosPath.split(' ')[0] : ekkosPath}</string>
-        ${ekkosPath.includes('npx') ? '<string>@ekkos/cli</string>' : ''}
-        <string>agent</string>
-        <string>daemon</string>
-    </array>
+${argXml}    </array>
+
+    <!-- Run at system login and on demand -->
     <key>RunAtLoad</key>
     <true/>
+
+    <!-- Keep alive: restart immediately if it exits or crashes -->
     <key>KeepAlive</key>
-    <true/>
+    <dict>
+        <!-- Restart even if exit code is 0 (successful exit) -->
+        <key>SuccessfulExit</key>
+        <false/>
+        <!-- Restart if process is terminated by signal -->
+        <key>Crashed</key>
+        <true/>
+    </dict>
+
+    <!-- Logging -->
     <key>StandardErrorPath</key>
-    <string>${path.join(state_1.EKKOS_DIR, 'agent.err.log')}</string>
+    <string>${escapeXml(path.join(ekkosDir, 'agent.err.log'))}</string>
+
     <key>StandardOutPath</key>
-    <string>${path.join(state_1.EKKOS_DIR, 'agent.out.log')}</string>
+    <string>${escapeXml(path.join(ekkosDir, 'agent.out.log'))}</string>
+
+    <!-- Environment variables -->
     <key>EnvironmentVariables</key>
     <dict>
         <key>PATH</key>
-        <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
+        <string>${escapeXml(launchPath)}</string>
+        <key>NODE_ENV</key>
+        <string>production</string>
+        <key>HOME</key>
+        <string>${escapeXml(homeDir)}</string>
     </dict>
+
+    <!-- Process management -->
+    <key>ProcessType</key>
+    <string>Background</string>
+
+    <!-- Critical: Allow daemon to handle network reconnections -->
+    <key>AbandonProcessGroup</key>
+    <true/>
+
+    <!-- Restart throttle: wait 10s before restarting crashed process -->
+    <key>ThrottleInterval</key>
+    <integer>10</integer>
+
+    <!-- Higher priority for reliable connectivity -->
+    <key>Nice</key>
+    <integer>-5</integer>
+
+    <!-- File descriptor limits -->
+    <key>SoftResourceLimits</key>
+    <dict>
+        <key>NumberOfFiles</key>
+        <integer>2048</integer>
+    </dict>
+
+    <!-- Working directory -->
+    <key>WorkingDirectory</key>
+    <string>${escapeXml(homeDir)}</string>
 </dict>
 </plist>`;
-    // Ensure directory exists
-    const launchAgentsDir = path.dirname(plistPath);
-    if (!fs.existsSync(launchAgentsDir)) {
-        fs.mkdirSync(launchAgentsDir, { recursive: true });
-    }
-    // Write plist
-    fs.writeFileSync(plistPath, plistContent);
-    if (verbose) {
-        console.log(chalk_1.default.gray(`  Created: ${plistPath}`));
-    }
-    // Unload if already loaded
-    try {
-        (0, child_process_1.execSync)(`launchctl unload "${plistPath}" 2>/dev/null`, { encoding: 'utf-8' });
-    }
-    catch {
-        // Ignore if not loaded
-    }
-    // Load the service
-    (0, child_process_1.execSync)(`launchctl load "${plistPath}"`, { encoding: 'utf-8' });
-    if (verbose) {
-        console.log(chalk_1.default.gray(`  Loaded: ${plistName}`));
-    }
+}
+/**
+ * Escape XML special characters
+ */
+function escapeXml(str) {
+    return str
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
 }
 /**
  * Install Windows service

package/dist/commands/swarm-dashboard.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ekkos swarm dashboard
+ *
+ * Live TUI dashboard for monitoring a swarm of parallel Claude Code workers.
+ * Uses blessed-contrib for rich terminal widgets.
+ *
+ * Layout:
+ *   Header:   Swarm name + worker count + total cost + duration
+ *   Workers:  Per-worker status cards (context bar, cost, turns, model)
+ *   Chart:    Combined token usage from all workers
+ *   Table:    All turns from all workers (with worker column)
+ *   Usage:    Anthropic rate limit windows
+ *   Footer:   Aggregate totals + routing breakdown + keybindings
+ *
+ * Usage:
+ *   ekkos swarm dashboard                    Auto-detect active swarm
+ *   ekkos swarm dashboard --launch-ts 123    Use specific launch timestamp
+ */
+import { Command } from 'commander';
+export declare const swarmDashboardCommand: Command;