@overlordai/cli 1.0.0

package/dist/installer/wizard.js

@@ -0,0 +1,213 @@
+import * as p from '@clack/prompts';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import chalk from 'chalk';
+import { EnvChecker } from './env-checker.js';
+import { SecretGenerator } from './secret-gen.js';
+import { ConfigWriter } from './config-writer.js';
+import { DbInitializer } from './db-initializer.js';
+import { AdminCreator } from './admin-creator.js';
+/**
+ * 10-step interactive installation wizard using @clack/prompts.
+ */
+export class InstallWizard {
+    checker = new EnvChecker();
+    secretGen = new SecretGenerator();
+    configWriter = new ConfigWriter();
+    dbInit = new DbInitializer();
+    adminCreator = new AdminCreator();
+    async run() {
+        // Step 1: Welcome
+        p.note('This wizard will guide you through setting up Overlord.\n' +
+            'You can press Ctrl+C at any time to cancel.', 'Welcome to Overlord');
+        // Step 2: Check prerequisites
+        const s = p.spinner();
+        s.start('Checking prerequisites...');
+        const gitCheck = this.checker.checkGit();
+        if (!gitCheck.ok) {
+            s.stop('Prerequisites check failed');
+            p.log.error(`Git: ${gitCheck.detail}`);
+            throw new Error('Missing required dependency: Git >= 2.20');
+        }
+        const nodeCheck = this.checker.checkNode();
+        if (!nodeCheck.ok) {
+            s.stop('Prerequisites check failed');
+            p.log.error(`Node.js: ${nodeCheck.detail}`);
+            throw new Error('Missing required dependency: Node.js >= 20');
+        }
+        s.stop('Prerequisites OK');
+        p.log.success(`Git: ${gitCheck.detail}`);
+        p.log.success(`Node.js: ${nodeCheck.detail}`);
+        // Optional CLI checks (non-blocking)
+        const claudeCheck = this.checker.checkClaudeCli();
+        const cursorCheck = this.checker.checkCursorCli();
+        const codeCheck = this.checker.checkCodeCli();
+        if (claudeCheck.ok)
+            p.log.success(`claude CLI: found`);
+        else
+            p.log.warn('claude CLI: not found (optional)');
+        if (cursorCheck.ok)
+            p.log.success(`agent CLI: found`);
+        else
+            p.log.warn('agent CLI: not found (optional)');
+        if (codeCheck.ok)
+            p.log.success(`code CLI: found`);
+        else
+            p.log.warn('code CLI: not found (optional)');
+        // Step 3: Choose install directory
+        const installDir = await p.text({
+            message: 'Installation directory:',
+            placeholder: path.join(os.homedir(), '.overlord'),
+            defaultValue: path.join(os.homedir(), '.overlord'),
+            validate: (value) => {
+                if (!value)
+                    return 'Directory is required';
+                if (!path.isAbsolute(value))
+                    return 'Must be an absolute path';
+                return undefined;
+            },
+        });
+        if (p.isCancel(installDir))
+            throw new Error('cancelled');
+        // Check disk space for chosen directory
+        const diskCheck = this.checker.checkDiskSpace(path.dirname(installDir));
+        if (!diskCheck.ok) {
+            p.log.error(`Disk space: ${diskCheck.detail}`);
+            throw new Error('Insufficient disk space');
+        }
+        p.log.success(`Disk space: ${diskCheck.detail}`);
+        // Step 4: Generate secrets
+        const secrets = this.secretGen.generateAll();
+        p.log.success('Secrets generated (JWT_SECRET, WORKER_JWT_SECRET, ENCRYPTION_KEY)');
+        // Step 5: Configure Redis URL
+        const redisUrl = await p.text({
+            message: 'Redis URL:',
+            placeholder: 'redis://localhost:6379/0',
+            defaultValue: 'redis://localhost:6379/0',
+            validate: (value) => {
+                if (!value)
+                    return 'Redis URL is required';
+                if (!value.startsWith('redis://') && !value.startsWith('rediss://')) {
+                    return 'Must start with redis:// or rediss://';
+                }
+                return undefined;
+            },
+        });
+        if (p.isCancel(redisUrl))
+            throw new Error('cancelled');
+        // Step 6: Configure DB path
+        const dbPath = await p.text({
+            message: 'SQLite database path:',
+            placeholder: path.join(installDir, 'data', 'overlord.db'),
+            defaultValue: path.join(installDir, 'data', 'overlord.db'),
+            validate: (value) => {
+                if (!value)
+                    return 'Database path is required';
+                if (!path.isAbsolute(value))
+                    return 'Must be an absolute path';
+                return undefined;
+            },
+        });
+        if (p.isCancel(dbPath))
+            throw new Error('cancelled');
+        // Step 7: Write .env file
+        const envPath = path.join(installDir, '.env');
+        const envConfig = {
+            NODE_ENV: 'production',
+            INSTALL_DIR: installDir,
+            DATABASE_PATH: dbPath,
+            REDIS_URL: redisUrl,
+            JWT_SECRET: secrets.jwtSecret,
+            WORKER_JWT_SECRET: secrets.workerJwtSecret,
+            ENCRYPTION_KEY: secrets.encryptionKey,
+            SERVER_PORT: '9000',
+            WORKER_DIAG_PORT: '9100',
+        };
+        const writeSpinner = p.spinner();
+        writeSpinner.start('Writing configuration...');
+        this.configWriter.write(envConfig, envPath);
+        writeSpinner.stop('Configuration written');
+        p.log.success(`.env written to ${envPath} (chmod 600)`);
+        // Step 8: Run migrations
+        const migrationsDir = path.join(process.cwd(), 'database', 'migrations');
+        const migrateSpinner = p.spinner();
+        migrateSpinner.start('Initializing database...');
+        try {
+            this.dbInit.initialize(dbPath, migrationsDir);
+            migrateSpinner.stop('Database initialized');
+        }
+        catch (err) {
+            migrateSpinner.stop('Database initialization failed');
+            p.log.error(err instanceof Error ? err.message : String(err));
+            throw err;
+        }
+        // Step 9: Create admin user
+        const adminUsername = await p.text({
+            message: 'Admin username:',
+            placeholder: 'admin',
+            defaultValue: 'admin',
+            validate: (value) => {
+                if (!value || value.length < 2)
+                    return 'Username must be at least 2 characters';
+                return undefined;
+            },
+        });
+        if (p.isCancel(adminUsername))
+            throw new Error('cancelled');
+        const adminPassword = await p.password({
+            message: 'Admin password:',
+            validate: (value) => {
+                if (!value || value.length < 8)
+                    return 'Password must be at least 8 characters';
+                return undefined;
+            },
+        });
+        if (p.isCancel(adminPassword))
+            throw new Error('cancelled');
+        const gitName = await p.text({
+            message: 'Admin Git name:',
+            placeholder: 'Admin',
+            defaultValue: 'Admin',
+        });
+        if (p.isCancel(gitName))
+            throw new Error('cancelled');
+        const gitEmail = await p.text({
+            message: 'Admin Git email:',
+            placeholder: 'admin@example.com',
+            validate: (value) => {
+                if (!value || !value.includes('@'))
+                    return 'Valid email is required';
+                return undefined;
+            },
+        });
+        if (p.isCancel(gitEmail))
+            throw new Error('cancelled');
+        const adminSpinner = p.spinner();
+        adminSpinner.start('Creating admin account...');
+        const adminConfig = {
+            username: adminUsername,
+            password: adminPassword,
+            gitName: gitName,
+            gitEmail: gitEmail,
+        };
+        try {
+            await this.adminCreator.create(dbPath, adminConfig);
+            adminSpinner.stop('Admin account created');
+        }
+        catch (err) {
+            adminSpinner.stop('Failed to create admin account');
+            p.log.error(err instanceof Error ? err.message : String(err));
+            throw err;
+        }
+        // Step 10: Complete
+        p.note(`Installation directory: ${installDir}\n` +
+            `Database: ${dbPath}\n` +
+            `Redis: ${redisUrl}\n` +
+            `Admin user: ${adminUsername}\n\n` +
+            `Next steps:\n` +
+            `  1. Run ${chalk.cyan('overlord start')} to start services\n` +
+            `  2. Run ${chalk.cyan('overlord status')} to check status\n` +
+            `  3. Run ${chalk.cyan('overlord doctor')} to verify setup`, 'Installation Summary');
+    }
+}
+//# sourceMappingURL=wizard.js.map

package/dist/installer/wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.js","sourceRoot":"","sources":["../../src/installer/wizard.ts"],"names":[],"mappings":"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"}

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { installCommand } from './commands/install.js';
+import { startCommand } from './commands/start.js';
+import { stopCommand } from './commands/stop.js';
+import { statusCommand } from './commands/status.js';
+import { logsCommand } from './commands/logs.js';
+import { doctorCommand } from './commands/doctor.js';
+import { upgradeCommand } from './commands/upgrade.js';
+const program = new Command();
+program
+    .name('overlord')
+    .description('Overlord Operations CLI — server installation, management, and diagnostics')
+    .version('1.0.0');
+program
+    .command('install')
+    .description('Interactive installation wizard')
+    .action(installCommand);
+program
+    .command('start')
+    .description('Start server and worker processes')
+    .argument('[component]', 'Component to start (server, worker, or all)', 'all')
+    .action(startCommand);
+program
+    .command('stop')
+    .description('Stop all processes')
+    .argument('[component]', 'Component to stop (server, worker, or all)', 'all')
+    .action(stopCommand);
+program
+    .command('status')
+    .description('Show process status table')
+    .action(statusCommand);
+program
+    .command('logs')
+    .description('Tail server/worker logs')
+    .argument('[component]', 'Component to show logs for (server, worker)', 'server')
+    .option('-n, --lines <number>', 'Number of lines to show', '50')
+    .action(logsCommand);
+program
+    .command('doctor')
+    .description('Run system health checks')
+    .action(doctorCommand);
+program
+    .command('upgrade')
+    .description('Download and apply latest release')
+    .option('--rollback', 'Rollback to previous version')
+    .action(upgradeCommand);
+program.parse();
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CAAC,4EAA4E,CAAC;KACzF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,iCAAiC,CAAC;KAC9C,MAAM,CAAC,cAAc,CAAC,CAAC;AAE1B,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,mCAAmC,CAAC;KAChD,QAAQ,CAAC,aAAa,EAAE,6CAA6C,EAAE,KAAK,CAAC;KAC7E,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,oBAAoB,CAAC;KACjC,QAAQ,CAAC,aAAa,EAAE,4CAA4C,EAAE,KAAK,CAAC;KAC5E,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,2BAA2B,CAAC;KACxC,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,yBAAyB,CAAC;KACtC,QAAQ,CAAC,aAAa,EAAE,6CAA6C,EAAE,QAAQ,CAAC;KAChF,MAAM,CAAC,sBAAsB,EAAE,yBAAyB,EAAE,IAAI,CAAC;KAC/D,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,mCAAmC,CAAC;KAChD,MAAM,CAAC,YAAY,EAAE,8BAA8B,CAAC;KACpD,MAAM,CAAC,cAAc,CAAC,CAAC;AAE1B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/process-manager.d.ts

@@ -0,0 +1,36 @@
+import { type ChildProcess } from 'node:child_process';
+export interface PM2AppConfig {
+    name: string;
+    script: string;
+    cwd?: string;
+    instances?: number;
+    env?: Record<string, string>;
+    waitReady?: boolean;
+}
+export interface PM2ProcessInfo {
+    name: string;
+    pid: number;
+    status: string;
+    cpu: number;
+    memory: number;
+    uptime: number;
+}
+/**
+ * Wrapper around PM2 programmatic API via CLI invocation.
+ * Uses pm2 commands directly to manage processes.
+ */
+export declare class ProcessManager {
+    private pm2Bin;
+    constructor(pm2Bin?: string);
+    start(config: PM2AppConfig): Promise<void>;
+    stop(name: string): Promise<void>;
+    restart(name: string): Promise<void>;
+    list(): Promise<PM2ProcessInfo[]>;
+    logs(name: string, lines?: number): Promise<ChildProcess>;
+    dump(): Promise<void>;
+    delete(name: string): Promise<void>;
+    killDaemon(): Promise<void>;
+    private exec;
+    private execWithEnv;
+}
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../src/process-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE5E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,MAAc;IAI5B,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC1C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAuBjC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAO7D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,WAAW;CAOpB"}

package/dist/process-manager.js

@@ -0,0 +1,111 @@
+import { execFileSync, spawn } from 'node:child_process';
+/**
+ * Wrapper around PM2 programmatic API via CLI invocation.
+ * Uses pm2 commands directly to manage processes.
+ */
+export class ProcessManager {
+    pm2Bin;
+    constructor(pm2Bin = 'pm2') {
+        this.pm2Bin = pm2Bin;
+    }
+    async start(config) {
+        const args = ['start', config.script, '--name', config.name];
+        if (config.cwd) {
+            args.push('--cwd', config.cwd);
+        }
+        if (config.instances !== undefined) {
+            args.push('-i', String(config.instances));
+        }
+        if (config.waitReady) {
+            args.push('--wait-ready');
+        }
+        // Build a minimal env for PM2 — never spread process.env to avoid leaking secrets
+        const childEnv = {
+            PATH: process.env.PATH ?? '/usr/local/bin:/usr/bin:/bin',
+            HOME: process.env.HOME ?? '',
+            USER: process.env.USER ?? '',
+            SHELL: process.env.SHELL ?? '/bin/sh',
+            LANG: process.env.LANG ?? 'en_US.UTF-8',
+            TERM: process.env.TERM ?? 'xterm-256color',
+            NODE_ENV: process.env.NODE_ENV ?? 'production',
+        };
+        if (config.env) {
+            for (const [key, value] of Object.entries(config.env)) {
+                childEnv[key] = value;
+            }
+        }
+        this.execWithEnv(args, childEnv);
+    }
+    async stop(name) {
+        try {
+            this.exec(['stop', name]);
+        }
+        catch {
+            // Process may already be stopped
+        }
+    }
+    async restart(name) {
+        this.exec(['reload', name]);
+    }
+    async list() {
+        try {
+            const output = execFileSync(this.pm2Bin, ['jlist'], {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            const processes = JSON.parse(output);
+            return processes.map((proc) => ({
+                name: proc.name,
+                pid: (proc.pid ?? 0),
+                status: (proc.pm2_env?.status ?? 'unknown'),
+                cpu: (proc.monit?.cpu ?? 0),
+                memory: (proc.monit?.memory ?? 0),
+                uptime: proc.pm2_env?.pm_uptime
+                    ? Date.now() - proc.pm2_env.pm_uptime
+                    : 0,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    async logs(name, lines = 50) {
+        const child = spawn(this.pm2Bin, ['logs', name, '--lines', String(lines)], {
+            stdio: 'inherit',
+        });
+        return child;
+    }
+    async dump() {
+        this.exec(['save']);
+    }
+    async delete(name) {
+        try {
+            this.exec(['delete', name]);
+        }
+        catch {
+            // Process may not exist
+        }
+    }
+    async killDaemon() {
+        try {
+            this.exec(['kill']);
+        }
+        catch {
+            // Daemon may already be dead
+        }
+    }
+    exec(args) {
+        execFileSync(this.pm2Bin, args, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    execWithEnv(args, env) {
+        execFileSync(this.pm2Bin, args, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env,
+        });
+    }
+}
+//# sourceMappingURL=process-manager.js.map

package/dist/process-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.js","sourceRoot":"","sources":["../src/process-manager.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@overlordai/cli",
+  "version": "1.0.0",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "overlord": "./dist/main.js"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "@clack/prompts": "^0.10.0",
+    "chalk": "^5.4.1",
+    "bcrypt": "^6.0.0",
+    "better-sqlite3": "^11.0.0",
+    "dotenv": "^16.5.0",
+    "@overlordai/protocol": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.0",
+    "@types/node": "^22.0.0",
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/bcrypt": "^5.0.2",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/main.js",
+    "test": "vitest run",
+    "lint": "tsc --noEmit"
+  }
+}