@ekkos/cli 0.2.9 → 0.2.11

package/dist/commands/agent.js

@@ -0,0 +1,300 @@
+"use strict";
+/**
+ * ekkos agent - Agent management commands for remote terminal
+ *
+ * Subcommands:
+ * - daemon: Run the agent daemon (used by service)
+ * - start: Start the agent service
+ * - stop: Stop the agent service
+ * - restart: Restart the agent service
+ * - status: Check agent status
+ * - uninstall: Remove agent service
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentDaemon = agentDaemon;
+exports.agentStart = agentStart;
+exports.agentStop = agentStop;
+exports.agentRestart = agentRestart;
+exports.agentStatus = agentStatus;
+exports.agentUninstall = agentUninstall;
+exports.agentLogs = agentLogs;
+const chalk_1 = __importDefault(require("chalk"));
+const os = __importStar(require("os"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const state_1 = require("../utils/state");
+const daemon_1 = require("../agent/daemon");
+/**
+ * Run the agent daemon (foreground)
+ */
+async function agentDaemon(options = {}) {
+    const verbose = options.verbose || false;
+    // Load device info
+    const deviceFilePath = path.join(state_1.EKKOS_DIR, 'device.json');
+    if (!fs.existsSync(deviceFilePath)) {
+        console.error(chalk_1.default.red('Device not configured. Run `ekkos setup-remote` first.'));
+        process.exit(1);
+    }
+    const deviceData = JSON.parse(fs.readFileSync(deviceFilePath, 'utf-8'));
+    if (!deviceData.deviceToken) {
+        console.error(chalk_1.default.red('Device not paired. Run `ekkos setup-remote` first.'));
+        process.exit(1);
+    }
+    if (verbose) {
+        console.log(chalk_1.default.cyan(`Starting ekkOS agent daemon...`));
+        console.log(chalk_1.default.gray(`  Device: ${deviceData.deviceName}`));
+        console.log(chalk_1.default.gray(`  Platform: ${deviceData.platform}/${deviceData.arch}`));
+    }
+    // Start the daemon
+    const daemon = new daemon_1.AgentDaemon({
+        deviceToken: deviceData.deviceToken,
+        deviceId: deviceData.deviceId,
+        deviceName: deviceData.deviceName,
+        verbose,
+    });
+    await daemon.start();
+    // Handle shutdown signals
+    const shutdown = async () => {
+        console.log(chalk_1.default.gray('\nShutting down agent...'));
+        await daemon.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+/**
+ * Start the agent service
+ */
+async function agentStart(options = {}) {
+    const platform = os.platform();
+    try {
+        if (platform === 'darwin') {
+            const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', 'dev.ekkos.agent.plist');
+            if (!fs.existsSync(plistPath)) {
+                console.log(chalk_1.default.yellow('Agent not installed. Run `ekkos setup-remote` first.'));
+                return;
+            }
+            (0, child_process_1.execSync)(`launchctl load "${plistPath}" 2>/dev/null || true`, { encoding: 'utf-8' });
+            console.log(chalk_1.default.green('Agent started.'));
+        }
+        else if (platform === 'win32') {
+            (0, child_process_1.execSync)('schtasks /run /tn "ekkOS Agent"', { encoding: 'utf-8' });
+            console.log(chalk_1.default.green('Agent started.'));
+        }
+        else if (platform === 'linux') {
+            (0, child_process_1.execSync)('systemctl --user start ekkos-agent', { encoding: 'utf-8' });
+            console.log(chalk_1.default.green('Agent started.'));
+        }
+    }
+    catch (err) {
+        console.error(chalk_1.default.red(`Failed to start agent: ${err.message}`));
+        process.exit(1);
+    }
+}
+/**
+ * Stop the agent service
+ */
+async function agentStop(options = {}) {
+    const platform = os.platform();
+    try {
+        if (platform === 'darwin') {
+            const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', 'dev.ekkos.agent.plist');
+            (0, child_process_1.execSync)(`launchctl unload "${plistPath}" 2>/dev/null || true`, { encoding: 'utf-8' });
+            console.log(chalk_1.default.green('Agent stopped.'));
+        }
+        else if (platform === 'win32') {
+            (0, child_process_1.execSync)('taskkill /im "node.exe" /fi "windowtitle eq ekkOS*" /f 2>nul', { encoding: 'utf-8' });
+            console.log(chalk_1.default.green('Agent stopped.'));
+        }
+        else if (platform === 'linux') {
+            (0, child_process_1.execSync)('systemctl --user stop ekkos-agent', { encoding: 'utf-8' });
+            console.log(chalk_1.default.green('Agent stopped.'));
+        }
+    }
+    catch (err) {
+        // May not be running
+        console.log(chalk_1.default.gray('Agent was not running.'));
+    }
+}
+/**
+ * Restart the agent service
+ */
+async function agentRestart(options = {}) {
+    await agentStop(options);
+    await agentStart(options);
+}
+/**
+ * Check agent status
+ */
+async function agentStatus(options = {}) {
+    const platform = os.platform();
+    let running = false;
+    let statusOutput = '';
+    try {
+        if (platform === 'darwin') {
+            statusOutput = (0, child_process_1.execSync)('launchctl list | grep dev.ekkos.agent || true', { encoding: 'utf-8' });
+            running = statusOutput.includes('dev.ekkos.agent');
+        }
+        else if (platform === 'win32') {
+            statusOutput = (0, child_process_1.execSync)('schtasks /query /tn "ekkOS Agent" 2>nul || true', { encoding: 'utf-8' });
+            running = statusOutput.includes('Running');
+        }
+        else if (platform === 'linux') {
+            statusOutput = (0, child_process_1.execSync)('systemctl --user is-active ekkos-agent 2>/dev/null || true', { encoding: 'utf-8' });
+            running = statusOutput.trim() === 'active';
+        }
+    }
+    catch {
+        running = false;
+    }
+    console.log('');
+    console.log(chalk_1.default.cyan.bold('  ekkOS Agent Status'));
+    console.log('');
+    // Check device info
+    const deviceFilePath = path.join(state_1.EKKOS_DIR, 'device.json');
+    if (!fs.existsSync(deviceFilePath)) {
+        console.log(chalk_1.default.yellow('  Not configured. Run `ekkos setup-remote` first.'));
+        return;
+    }
+    const deviceData = JSON.parse(fs.readFileSync(deviceFilePath, 'utf-8'));
+    console.log(`  Device:  ${chalk_1.default.white(deviceData.deviceName)}`);
+    console.log(`  ID:      ${chalk_1.default.gray(deviceData.deviceId.slice(0, 8))}...`);
+    console.log(`  Paired:  ${deviceData.deviceToken ? chalk_1.default.green('Yes') : chalk_1.default.red('No')}`);
+    console.log(`  Service: ${running ? chalk_1.default.green('Running') : chalk_1.default.red('Stopped')}`);
+    console.log('');
+    // Check cloud connection
+    if (deviceData.deviceToken) {
+        console.log(chalk_1.default.gray('  Checking cloud connection...'));
+        try {
+            const authToken = (0, state_1.getAuthToken)();
+            const state = (0, state_1.getState)();
+            if (authToken && state?.userId) {
+                const MEMORY_API_URL = process.env.MEMORY_API_URL || 'https://mcp.ekkos.dev';
+                const response = await fetch(`${MEMORY_API_URL}/api/v1/relay/devices/${state.userId}`, {
+                    headers: { 'Authorization': `Bearer ${authToken}` },
+                });
+                if (response.ok) {
+                    const data = await response.json();
+                    const device = data.devices?.find((d) => d.deviceId === deviceData.deviceId);
+                    if (device?.online) {
+                        console.log(`  Cloud:   ${chalk_1.default.green('Connected')}`);
+                    }
+                    else {
+                        console.log(`  Cloud:   ${chalk_1.default.yellow('Offline')}`);
+                    }
+                }
+            }
+        }
+        catch {
+            console.log(`  Cloud:   ${chalk_1.default.gray('Unable to check')}`);
+        }
+    }
+    console.log('');
+    // Show log location
+    console.log(chalk_1.default.gray(`  Logs: ${path.join(state_1.EKKOS_DIR, 'agent.out.log')}`));
+    console.log('');
+}
+/**
+ * Uninstall the agent service
+ */
+async function agentUninstall(options = {}) {
+    const platform = os.platform();
+    console.log(chalk_1.default.cyan('Uninstalling ekkOS agent...'));
+    try {
+        if (platform === 'darwin') {
+            const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', 'dev.ekkos.agent.plist');
+            (0, child_process_1.execSync)(`launchctl unload "${plistPath}" 2>/dev/null || true`, { encoding: 'utf-8' });
+            if (fs.existsSync(plistPath)) {
+                fs.unlinkSync(plistPath);
+            }
+            console.log(chalk_1.default.green('  ✓ Service removed'));
+        }
+        else if (platform === 'win32') {
+            (0, child_process_1.execSync)('schtasks /delete /tn "ekkOS Agent" /f 2>nul || true', { encoding: 'utf-8' });
+            console.log(chalk_1.default.green('  ✓ Scheduled task removed'));
+        }
+        else if (platform === 'linux') {
+            (0, child_process_1.execSync)('systemctl --user disable ekkos-agent 2>/dev/null || true', { encoding: 'utf-8' });
+            (0, child_process_1.execSync)('systemctl --user stop ekkos-agent 2>/dev/null || true', { encoding: 'utf-8' });
+            const servicePath = path.join(os.homedir(), '.config', 'systemd', 'user', 'ekkos-agent.service');
+            if (fs.existsSync(servicePath)) {
+                fs.unlinkSync(servicePath);
+            }
+            console.log(chalk_1.default.green('  ✓ Service removed'));
+        }
+        // Remove device token (but keep device ID for potential re-pairing)
+        const deviceFilePath = path.join(state_1.EKKOS_DIR, 'device.json');
+        if (fs.existsSync(deviceFilePath)) {
+            const deviceData = JSON.parse(fs.readFileSync(deviceFilePath, 'utf-8'));
+            delete deviceData.deviceToken;
+            delete deviceData.pairedAt;
+            fs.writeFileSync(deviceFilePath, JSON.stringify(deviceData, null, 2));
+            console.log(chalk_1.default.green('  ✓ Device token removed'));
+        }
+        console.log('');
+        console.log(chalk_1.default.green('Agent uninstalled. Run `ekkos setup-remote` to set up again.'));
+        console.log('');
+    }
+    catch (err) {
+        console.error(chalk_1.default.red(`Failed to uninstall: ${err.message}`));
+        process.exit(1);
+    }
+}
+/**
+ * Show agent logs
+ */
+async function agentLogs(options = {}) {
+    const logPath = path.join(state_1.EKKOS_DIR, 'agent.out.log');
+    if (!fs.existsSync(logPath)) {
+        console.log(chalk_1.default.gray('No logs found.'));
+        return;
+    }
+    if (options.follow) {
+        // Use tail -f
+        const tail = (0, child_process_1.spawn)('tail', ['-f', logPath], { stdio: 'inherit' });
+        tail.on('close', () => process.exit(0));
+    }
+    else {
+        // Show last 50 lines
+        const content = fs.readFileSync(logPath, 'utf-8');
+        const lines = content.split('\n').slice(-50);
+        console.log(lines.join('\n'));
+    }
+}

package/dist/commands/doctor.d.ts

@@ -1,3 +1,13 @@
+/**
+ * ekkOS CLI: doctor command
+ * Checks system prerequisites for ekkOS
+ *
+ * Per ekkOS Onboarding Spec v1.2 + Addendum:
+ * - Node gate: Node >= 18 required (FAIL if missing)
+ * - PTY gate: WARN on Windows if missing (monitor-only mode available)
+ * - Hooks gate: Verifies hook installation
+ * - NO jq checks (jq dependency eliminated)
+ */
 type GateStatus = 'PASS' | 'FAIL' | 'WARN';
 interface Check {
     name: string;