@ekkos/cli 0.3.3 → 1.0.1

package/dist/utils/platform.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WINDSURF_MCP = exports.WINDSURF_DIR = exports.CURSOR_MCP = exports.CURSOR_DIR = exports.CLAUDE_MD = exports.CLAUDE_STATE_DIR = exports.CLAUDE_PLUGINS_DIR = exports.CLAUDE_AGENTS_DIR = exports.CLAUDE_SKILLS_DIR = exports.CLAUDE_HOOKS_DIR = exports.CLAUDE_SETTINGS = exports.CLAUDE_CONFIG = exports.CLAUDE_DIR = exports.EKKOS_CONFIG = exports.EKKOS_DIR = exports.HOME_DIR = exports.MCP_API_URL = exports.PLATFORM_URL = exports.isLinux = exports.isMac = exports.isWindows = void 0;
+exports.WINDSURF_MCP = exports.WINDSURF_DIR = exports.CURSOR_MCP = exports.CURSOR_DIR = exports.CLAUDE_EKKOS_RULES = exports.CLAUDE_RULES_DIR = exports.CLAUDE_MD = exports.CLAUDE_STATE_DIR = exports.CLAUDE_PLUGINS_DIR = exports.CLAUDE_AGENTS_DIR = exports.CLAUDE_SKILLS_DIR = exports.CLAUDE_HOOKS_DIR = exports.CLAUDE_SETTINGS = exports.CLAUDE_CONFIG = exports.CLAUDE_DIR = exports.EKKOS_CONFIG = exports.EKKOS_DIR = exports.HOME_DIR = exports.MCP_API_URL = exports.PLATFORM_URL = exports.isLinux = exports.isMac = exports.isWindows = void 0;
 exports.detectInstalledIDEs = detectInstalledIDEs;
 exports.detectCurrentIDE = detectCurrentIDE;
 const os_1 = require("os");
@@ -24,6 +24,8 @@ exports.CLAUDE_AGENTS_DIR = (0, path_1.join)(exports.CLAUDE_DIR, 'agents');
 exports.CLAUDE_PLUGINS_DIR = (0, path_1.join)(exports.CLAUDE_DIR, 'plugins', 'ekkos');
 exports.CLAUDE_STATE_DIR = (0, path_1.join)(exports.CLAUDE_DIR, 'state');
 exports.CLAUDE_MD = (0, path_1.join)(exports.CLAUDE_DIR, 'CLAUDE.md');
+exports.CLAUDE_RULES_DIR = (0, path_1.join)(exports.CLAUDE_DIR, 'rules');
+exports.CLAUDE_EKKOS_RULES = (0, path_1.join)(exports.CLAUDE_RULES_DIR, 'ekkos.md');
 exports.CURSOR_DIR = (0, path_1.join)(exports.HOME_DIR, '.cursor');
 exports.CURSOR_MCP = (0, path_1.join)(exports.CURSOR_DIR, 'mcp.json');
 exports.WINDSURF_DIR = (0, path_1.join)(exports.HOME_DIR, '.codeium', 'windsurf');

package/dist/utils/session-binding.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Bind the real session name to the proxy
+ * This replaces the '_pending' placeholder for this user, enabling proper eviction
+ */
+export declare function bindSession(realSession: string, projectPath: string, pendingSession?: string): Promise<boolean>;

package/dist/utils/session-binding.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bindSession = bindSession;
+const state_1 = require("./state");
+const MEMORY_API_URL = process.env.EKKOS_PROXY_URL || 'https://proxy.ekkos.dev';
+/**
+ * Bind the real session name to the proxy
+ * This replaces the '_pending' placeholder for this user, enabling proper eviction
+ */
+async function bindSession(realSession, projectPath, pendingSession) {
+    try {
+        // Get userId same way as run.ts
+        const config = (0, state_1.getConfig)();
+        let userId = config?.userId;
+        if (!userId || userId === 'anonymous') {
+            const token = (0, state_1.getAuthToken)();
+            if (token?.startsWith('ekk_')) {
+                const parts = token.split('_');
+                if (parts.length >= 2) {
+                    userId = parts[1];
+                }
+            }
+        }
+        if (!userId || userId === 'anonymous')
+            return false;
+        // Use global fetch (Node 18+)
+        const response = await fetch(`${MEMORY_API_URL}/proxy/session/bind`, {
+            method: 'POST',
+            signal: AbortSignal.timeout(2500),
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({
+                userId,
+                realSession,
+                projectPath,
+                pendingSession: pendingSession || null,
+            })
+        });
+        return response.ok;
+    }
+    catch (err) {
+        // Fail silently - don't crash CLI
+        return false;
+    }
+}

package/dist/utils/state.js

@@ -341,6 +341,10 @@ function getActiveSessionByName(sessionName) {
  * Check if a process is still alive
  */
 function isProcessAlive(pid) {
+    // pid <= 1 (including 0 placeholders from hooks) are not valid user processes.
+    if (!Number.isInteger(pid) || pid <= 1) {
+        return false;
+    }
     try {
         // Sending signal 0 doesn't kill the process, just checks if it exists
         process.kill(pid, 0);

package/dist/utils/verify-remote-terminal.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Remote Terminal Verification Script
+ *
+ * Systematically verifies that all remote terminal components are properly configured
+ * and working correctly. Run this after setup-remote to validate the installation.
+ */
+/**
+ * Run all verification tests
+ */
+export declare function verifyRemoteTerminal(): Promise<void>;

package/dist/utils/verify-remote-terminal.js

@@ -0,0 +1,415 @@
+"use strict";
+/**
+ * Remote Terminal Verification Script
+ *
+ * Systematically verifies that all remote terminal components are properly configured
+ * and working correctly. Run this after setup-remote to validate the installation.
+ */
+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.verifyRemoteTerminal = verifyRemoteTerminal;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+const chalk_1 = __importDefault(require("chalk"));
+const EKKOS_DIR = path.join(os.homedir(), '.ekkos');
+const results = [];
+/**
+ * Test 1: Device configuration file exists
+ */
+function testDeviceConfig() {
+    const devicePath = path.join(EKKOS_DIR, 'device.json');
+    if (fs.existsSync(devicePath)) {
+        try {
+            const data = JSON.parse(fs.readFileSync(devicePath, 'utf-8'));
+            if (data.deviceId && data.deviceToken && data.deviceName) {
+                results.push({
+                    name: 'Device Configuration',
+                    status: 'pass',
+                    message: 'Device config found and valid',
+                    details: `Device: ${data.deviceName} (${data.deviceId.slice(0, 8)}...)`,
+                });
+            }
+            else {
+                results.push({
+                    name: 'Device Configuration',
+                    status: 'fail',
+                    message: 'Device config exists but is incomplete',
+                });
+            }
+        }
+        catch (err) {
+            results.push({
+                name: 'Device Configuration',
+                status: 'fail',
+                message: 'Device config is invalid JSON',
+            });
+        }
+    }
+    else {
+        results.push({
+            name: 'Device Configuration',
+            status: 'fail',
+            message: 'Device not configured - run ekkos setup-remote',
+        });
+    }
+}
+/**
+ * Test 2: Service is installed
+ */
+function testServiceInstalled() {
+    const platform = os.platform();
+    try {
+        if (platform === 'darwin') {
+            // macOS: check launchctl
+            const output = (0, child_process_1.execSync)('launchctl list | grep dev.ekkos.agent || true', {
+                encoding: 'utf-8',
+            });
+            if (output.includes('dev.ekkos.agent')) {
+                results.push({
+                    name: 'Service Installation',
+                    status: 'pass',
+                    message: 'Service is installed on macOS',
+                });
+            }
+            else {
+                results.push({
+                    name: 'Service Installation',
+                    status: 'fail',
+                    message: 'Service not found - run ekkos agent start',
+                });
+            }
+        }
+        else if (platform === 'win32') {
+            // Windows: check scheduled task
+            const output = (0, child_process_1.execSync)('schtasks /query /tn "ekkOS Agent" 2>nul || echo NOT_FOUND', {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            if (!output.includes('NOT_FOUND')) {
+                results.push({
+                    name: 'Service Installation',
+                    status: 'pass',
+                    message: 'Service is installed on Windows',
+                });
+            }
+            else {
+                results.push({
+                    name: 'Service Installation',
+                    status: 'fail',
+                    message: 'Service not found - run ekkos agent start',
+                });
+            }
+        }
+        else if (platform === 'linux') {
+            // Linux: check systemd
+            const output = (0, child_process_1.execSync)('systemctl --user is-active ekkos-agent 2>/dev/null || echo INACTIVE', {
+                encoding: 'utf-8',
+            });
+            if (output.includes('active')) {
+                results.push({
+                    name: 'Service Installation',
+                    status: 'pass',
+                    message: 'Service is installed on Linux',
+                });
+            }
+            else {
+                results.push({
+                    name: 'Service Installation',
+                    status: 'fail',
+                    message: 'Service not active - run ekkos agent start',
+                });
+            }
+        }
+    }
+    catch (err) {
+        results.push({
+            name: 'Service Installation',
+            status: 'fail',
+            message: 'Failed to check service status',
+            details: String(err).slice(0, 100),
+        });
+    }
+}
+/**
+ * Test 3: Service is running
+ */
+function testServiceRunning() {
+    const pidPath = path.join(EKKOS_DIR, 'agent.pid');
+    if (!fs.existsSync(pidPath)) {
+        results.push({
+            name: 'Service Running',
+            status: 'fail',
+            message: 'No PID file - service may not have started',
+        });
+        return;
+    }
+    try {
+        const pid = parseInt(fs.readFileSync(pidPath, 'utf-8').trim());
+        (0, child_process_1.execSync)(`kill -0 ${pid} 2>/dev/null`);
+        results.push({
+            name: 'Service Running',
+            status: 'pass',
+            message: `Process running (PID ${pid})`,
+        });
+    }
+    catch {
+        results.push({
+            name: 'Service Running',
+            status: 'fail',
+            message: 'PID file exists but process is not running - restart with ekkos agent restart',
+        });
+    }
+}
+/**
+ * Test 4: Logs are being written
+ */
+function testLogsWriting() {
+    const logPath = path.join(EKKOS_DIR, 'agent.log');
+    if (!fs.existsSync(logPath)) {
+        results.push({
+            name: 'Log Output',
+            status: 'warn',
+            message: 'No logs yet - service may not have started or run long enough',
+        });
+        return;
+    }
+    try {
+        const stats = fs.statSync(logPath);
+        const lastModified = Date.now() - stats.mtime.getTime();
+        const fiveMinutes = 5 * 60 * 1000;
+        if (lastModified < fiveMinutes) {
+            results.push({
+                name: 'Log Output',
+                status: 'pass',
+                message: `Logs updating (last write ${Math.round(lastModified / 1000)}s ago)`,
+            });
+        }
+        else {
+            results.push({
+                name: 'Log Output',
+                status: 'warn',
+                message: `No logs written for ${Math.round(lastModified / 1000 / 60)}m - check for errors`,
+            });
+        }
+    }
+    catch (err) {
+        results.push({
+            name: 'Log Output',
+            status: 'fail',
+            message: 'Failed to read log file',
+        });
+    }
+}
+/**
+ * Test 5: Network connectivity to relay
+ */
+async function testNetworkConnectivity() {
+    try {
+        const RELAY_URL = 'wss://ekkos-relay-production.up.railway.app';
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5000);
+        const response = await fetch(`${RELAY_URL}/api/v1/health`, {
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        if (response.ok) {
+            results.push({
+                name: 'Network Connectivity',
+                status: 'pass',
+                message: 'Relay server is reachable',
+            });
+        }
+        else {
+            results.push({
+                name: 'Network Connectivity',
+                status: 'warn',
+                message: `Relay server returned ${response.status}`,
+            });
+        }
+    }
+    catch (err) {
+        if (err.name === 'AbortError') {
+            results.push({
+                name: 'Network Connectivity',
+                status: 'fail',
+                message: 'Timeout connecting to relay (>5s) - check internet connection',
+            });
+        }
+        else {
+            results.push({
+                name: 'Network Connectivity',
+                status: 'fail',
+                message: `Cannot reach relay server: ${err.message}`,
+            });
+        }
+    }
+}
+/**
+ * Test 6: WebSocket connection from daemon
+ */
+function testDaemonConnection() {
+    const logPath = path.join(EKKOS_DIR, 'agent.log');
+    if (!fs.existsSync(logPath)) {
+        results.push({
+            name: 'Daemon WebSocket',
+            status: 'warn',
+            message: 'Cannot check - no logs yet',
+        });
+        return;
+    }
+    try {
+        const content = fs.readFileSync(logPath, 'utf-8');
+        const lines = content.split('\n');
+        const lastLines = lines.slice(-50);
+        const hasConnected = lastLines.some(l => l.includes('Connected to relay server'));
+        const hasRegistered = lastLines.some(l => l.includes('Registered with relay'));
+        const hasError = lastLines.some(l => l.includes('WebSocket error'));
+        const hasDisconnected = lastLines.some(l => l.includes('Disconnected'));
+        if (hasConnected && hasRegistered && !hasError) {
+            results.push({
+                name: 'Daemon WebSocket',
+                status: 'pass',
+                message: 'Daemon connected and registered with relay',
+            });
+        }
+        else if (hasDisconnected && !hasConnected) {
+            results.push({
+                name: 'Daemon WebSocket',
+                status: 'warn',
+                message: 'Daemon disconnected - reconnecting, check again in 30s',
+            });
+        }
+        else if (hasError) {
+            results.push({
+                name: 'Daemon WebSocket',
+                status: 'fail',
+                message: 'Daemon has WebSocket errors - check network and firewall',
+                details: lastLines
+                    .filter(l => l.includes('error'))
+                    .slice(-1)[0],
+            });
+        }
+        else {
+            results.push({
+                name: 'Daemon WebSocket',
+                status: 'warn',
+                message: 'Unknown connection state - run ekkos agent logs -f to monitor',
+            });
+        }
+    }
+    catch (err) {
+        results.push({
+            name: 'Daemon WebSocket',
+            status: 'fail',
+            message: 'Failed to read logs',
+        });
+    }
+}
+/**
+ * Print verification results
+ */
+function printResults() {
+    console.log('');
+    console.log(chalk_1.default.cyan.bold('  Remote Terminal Verification'));
+    console.log('');
+    let passed = 0;
+    let warned = 0;
+    let failed = 0;
+    for (const result of results) {
+        let icon = '';
+        let color = chalk_1.default.gray;
+        if (result.status === 'pass') {
+            icon = chalk_1.default.green('✓');
+            color = chalk_1.default.green;
+            passed++;
+        }
+        else if (result.status === 'warn') {
+            icon = chalk_1.default.yellow('⚠');
+            color = chalk_1.default.yellow;
+            warned++;
+        }
+        else {
+            icon = chalk_1.default.red('✗');
+            color = chalk_1.default.red;
+            failed++;
+        }
+        console.log(`  ${icon} ${color(result.name)}`);
+        console.log(`    ${result.message}`);
+        if (result.details) {
+            console.log(`    ${chalk_1.default.gray(result.details.slice(0, 80))}`);
+        }
+    }
+    console.log('');
+    console.log(chalk_1.default.gray(`  Results: ${chalk_1.default.green(`${passed} pass`)}, ${chalk_1.default.yellow(`${warned} warn`)}, ${chalk_1.default.red(`${failed} fail`)}`));
+    console.log('');
+    // Overall status
+    if (failed === 0) {
+        if (warned === 0) {
+            console.log(chalk_1.default.green('  ✓ All checks passed!'));
+        }
+        else {
+            console.log(chalk_1.default.yellow('  ⚠ Most checks passed, but review warnings above.'));
+        }
+    }
+    else {
+        console.log(chalk_1.default.red('  ✗ Some checks failed. See above for fixes.'));
+    }
+    console.log('');
+    // Next steps
+    if (failed > 0) {
+        console.log(chalk_1.default.cyan('  Next steps:'));
+        console.log('    1. Review failed checks above');
+        console.log('    2. Run suggested commands');
+        console.log('    3. Wait 30s and run this verification again');
+        console.log('');
+    }
+}
+/**
+ * Run all verification tests
+ */
+async function verifyRemoteTerminal() {
+    testDeviceConfig();
+    testServiceInstalled();
+    testServiceRunning();
+    testLogsWriting();
+    await testNetworkConnectivity();
+    testDaemonConnection();
+    printResults();
+}

package/package.json

@@ -1,13 +1,19 @@
 {
   "name": "@ekkos/cli",
-  "version": "0.3.3",
+  "version": "1.0.1",
   "description": "Setup ekkOS memory for AI coding assistants (Claude Code, Cursor, Windsurf)",
   "main": "dist/index.js",
   "bin": {
     "ekkos": "dist/index.js",
     "cli": "dist/index.js",
-    "ekkos-capture": "dist/cache/capture.js",
-    "ekkos-promote": "dist/cron/promoter.js"
+    "ekkos-capture": "dist/cache/capture.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "prepack": "node scripts/build-templates.js prepack",
+    "postpack": "node scripts/build-templates.js postpack",
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "ekkos",
@@ -23,16 +29,19 @@
   "license": "MIT",
   "dependencies": {
     "@supabase/supabase-js": "^2.39.8",
+    "blessed": "^0.1.81",
+    "blessed-contrib": "^4.11.0",
+    "ccusage": "^18.0.5",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "inquirer": "^9.2.23",
     "node-pty": "1.2.0-beta.7",
     "open": "^10.0.0",
     "ora": "^8.0.1",
-    "ws": "^8.19.0",
-    "@ekkos/prometheus": "0.1.0"
+    "ws": "^8.19.0"
   },
   "devDependencies": {
+    "@types/blessed": "^0.1.27",
     "@types/node": "^20.11.0",
     "typescript": "^5.3.3"
   },
@@ -42,9 +51,5 @@
   "files": [
     "dist",
     "templates"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "dev": "ts-node src/index.ts"
-  }
-}
+  ]
+}