@bhooai/nexus-cli 0.1.5 → 2.0.0

package/src/commands/cluster.ts

@@ -1,133 +0,0 @@
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-import { loadConfigAuto } from '../../../nexus-core/src/index.js';
-import { ClusterManager } from '@bhooai/nexus-cluster';
-import type { DeepPartial, NexusConfig } from '@bhooai/nexus-core';
-
-const GREEN = '\x1b[32m';
-const RED = '\x1b[31m';
-const YELLOW = '\x1b[33m';
-const CYAN = '\x1b[36m';
-const DIM = '\x1b[2m';
-const RESET = '\x1b[0m';
-
-/**
- * `nexus cluster <subcommand>` - central-side mesh orchestration.
- *
- *   cluster status            list linked nodes + LB RPS
- *   cluster link <url>        handshake + register a node by its agent URL
- *   cluster unlink <id>       forget a node
- *   cluster start|stop|restart|kill <id>
- *   cluster scale <n>         target exactly n backend nodes
- *   cluster serve             hold process: LB + autoscaler (foreground)
- *   cluster check             poll every node once (health + metrics)
- */
-export async function cluster(args: string[]): Promise<number> {
-  const cfg = await loadConfigAuto({ root: process.cwd() });
-  const [sub, a, b] = args;
-
-  // `serve` is the explicit "start the cluster" command - if a prior admin
-  // stop wrote {cluster:{enabled:false}} into nexus.runtime.json, that
-  // override wins over nexus.config.ts and would silently keep the cluster
-  // off. Re-enable it in runtime.json so the LB actually starts.
-  if (sub === 'serve' && !cfg.cluster.enabled) {
-    enableClusterInRuntime(process.cwd());
-    console.log(`${YELLOW}cluster was disabled in nexus.runtime.json - re-enabling${RESET}`);
-  }
-
-  // For non-serve commands, warn (don't block) when the cluster is off.
-  if (sub !== 'serve' && !cfg.cluster.enabled) {
-    console.warn(`${RED}cluster.enabled is false${RESET} - run ${CYAN}nexus cluster serve${RESET} to start it, or set cluster: { enabled: true } in nexus.config.ts`);
-  }
-
-  const manager = new ClusterManager({ config: cfg.cluster, root: process.cwd(), aiServerUrl: cfg.ai.serverUrl });
-
-  switch (sub ?? 'help') {
-    case 'status': {
-      const nodes = manager.list();
-      const rps = manager.rps();
-      console.log(`${CYAN}cluster${RESET} - ${nodes.length} linked node(s)`);
-      for (const n of nodes) {
-        const color = n.status === 'ready' ? GREEN : n.status === 'unreachable' ? RED : CYAN;
-        console.log(`  ${color}${n.status}${RESET} ${DIM}${n.identity.id}${RESET} role=${n.identity.role} tier=${n.identity.tier} enabled=${n.enabled} rps=${rps[n.identity.id] ?? 0}${n.lastMetrics ? ` cpu=${n.lastMetrics.cpu}% mem=${n.lastMetrics.memoryMb}MiB` : ''}`);
-      }
-      return 0;
-    }
-    case 'link': {
-      if (!a) { console.error('cluster link <agent-url>'); return 1; }
-      try {
-        const node = await manager.link(a);
-        const color = node.status === 'ready' ? GREEN : CYAN;
-        console.log(`${color}linked${RESET} ${node.identity.id} role=${node.identity.role} base=${node.identity.baseUrl}`);
-        return 0;
-      } catch (err) {
-        console.error(`${RED}link failed${RESET}: ${(err as Error).message}`);
-        return 1;
-      }
-    }
-    case 'unlink': {
-      if (!a) { console.error('cluster unlink <id>'); return 1; }
-      return manager.unlink(a) ? (console.log(`removed ${a}`), 0) : (console.error(`no such node: ${a}`), 1);
-    }
-    case 'start':
-    case 'stop':
-    case 'restart':
-    case 'kill': {
-      if (!a) { console.error(`cluster ${sub} <id>`); return 1; }
-      await manager.exec(a, sub === 'kill' ? 'stop' : sub);
-      console.log(`${sub} ${a}`);
-      return 0;
-    }
-    case 'scale': {
-      if (!a || !Number.isFinite(Number(a))) { console.error('cluster scale <n>'); return 1; }
-      try {
-        await manager.scaleTo(Number(a));
-        console.log(`scaled to ${a} backend node(s)`);
-        return 0;
-      } catch (err) {
-        console.error(`${RED}${(err as Error).message}${RESET}`);
-        return 1;
-      }
-    }
-    case 'check': {
-      await manager.pollAll();
-      console.log(`checked ${manager.list().length} node(s)`);
-      return 0;
-    }
-    case 'serve': {
-      console.log(`${CYAN}cluster${RESET} LB on ${cfg.cluster.lbHost}:${cfg.cluster.lbPort}${RESET}`);
-      await manager.listenLb(cfg.cluster.lbHost);
-      manager.autoscaler.start(10_000);
-      setInterval(() => void manager.pollAll().catch(() => {}), 15_000);
-      return 0;
-    }
-    case 'help':
-    default:
-      console.log(`Usage: nexus cluster <status|link|unlink|start|stop|restart|kill|scale|check|serve>`);
-      return 0;
-  }
-}
-
-/**
- * Patch `nexus.runtime.json` to set `cluster.enabled = true`. The admin
- * "stop cluster" endpoint writes `{cluster:{enabled:false}}` there, and that
- * override beats `nexus.config.ts` in the loader precedence - so `nexus
- * cluster serve` would read `enabled:false` and the LB would never bind.
- * This removes the stale override so `serve` actually starts the cluster.
- */
-function enableClusterInRuntime(root: string): void {
-  const runtimePath = resolve(root, 'nexus.runtime.json');
-  let runtime: Record<string, unknown> = {};
-  if (existsSync(runtimePath)) {
-    try {
-      runtime = JSON.parse(readFileSync(runtimePath, 'utf8')) as Record<string, unknown>;
-    } catch {
-      // corrupt runtime file - start fresh
-      runtime = {};
-    }
-  }
-  const cluster = (runtime['cluster'] ?? {}) as Record<string, unknown>;
-  cluster['enabled'] = true;
-  runtime['cluster'] = cluster;
-  writeFileSync(runtimePath, `${JSON.stringify(runtime, null, 2)}\n`);
-}

package/src/commands/node.ts

@@ -1,106 +0,0 @@
-import { loadConfigAuto } from '../../../nexus-core/src/index.js';
-import { NodeAgent, nodeIdFor } from '@bhooai/nexus-cluster';
-const GREEN = '\x1b[32m';
-const RED = '\x1b[31m';
-const CYAN = '\x1b[36m';
-const DIM = '\x1b[2m';
-const RESET = '\x1b[0m';
-
-/**
- * `nexus node <subcommand>` - run THIS machine as a cluster node.
- *
- *   node id --role <role>                  print this node's stable id
- *   node serve --role=<role> [--port]     start the agent + role service
- *
- * Onboarding per the mesh flow:
- *   server$ nexus node serve --role=backend
- *   -> prints agent URL + pairing token; paste the URL on the central:
- *   central$ nexus cluster link http://<this-host>:7575
- */
-export async function node(args: string[]): Promise<number> {
-  const sub = args[0];
-  const role = argValue(args, '--role') ?? 'backend';
-
-  const cfg = await loadConfigAuto({ root: process.cwd() });
-  const token = cfg.cluster.token;
-  const port = Number(argValue(args, '--port') ?? '7575');
-  const agentHost = cfg.cluster.nodeAgentHost;
-  const defaultPort = Number.isInteger(cfg.cluster.nodeAgentPort) ? cfg.cluster.nodeAgentPort : 7575;
-  const effectivePort = Number.isInteger(port) ? port : defaultPort;
-
-  if (sub === 'id') {
-    console.log(nodeIdFor(process.cwd(), role as never));
-    return 0;
-  }
-
-  if (sub === 'serve') {
-    const description = roleDescription(role);
-    const command = serviceCommand(role, cfg);
-    const noService = args.includes('--no-service');
-    const agent = new NodeAgent({
-      projectRoot: process.cwd(),
-      role: role as never,
-      tier: 'dev',
-      port: effectivePort,
-      token,
-      version: '0.1.0',
-      services: serviceUrls(role, cfg),
-      serviceCommand: noService ? [] : command,
-      serviceEnv: { NEXUS_SERVER_PORT: String(cfg.server.port) },
-      advertisedUrl: process.env.NEXUS_NODE_ADVERTISED_URL,
-    });
-    await agent.listen(agentHost);
-    console.log(`${CYAN}node-agent${RESET} ready - role ${role} ${description}`);
-    console.log(`  ${GREEN}agent url:  http://${agentHost}:${effectivePort}${RESET}`);
-    console.log(`  ${GREEN}token:      ${token ? `${token}` : '<empty - set cluster.token>'}`)
-    console.log(`  ${DIM}link it from the central:  nexus cluster link http://${agentHost}:${effectivePort}${RESET}`);
-    if (noService) {
-      console.log(`  ${DIM}agent-only mode (--no-service): not spawning a role service;${RESET}`);
-      console.log(`  ${DIM}advertising ${serviceUrls(role, cfg)[role as 'backend'] ?? '—'} as the role service.${RESET}`);
-    } else if (command.length) {
-      agent.startService();
-      console.log(`  started role service: ${command.join(' ')}`);
-    }
-    // Hold the process.
-    return await new Promise<number>(() => {});
-  }
-
-  console.log('Usage: nexus node <id|serve> [--role=backend|files|database|ai] [--port=N]');
-  return 1;
-}
-
-function argValue(args: string[], name: string): string | undefined {
-  const i = args.indexOf(name);
-  if (i >= 0) return args[i + 1];
-  return args.find((a) => a.startsWith(`${name}=`))?.slice(name.length + 1);
-}
-
-function roleDescription(role: string): string {
-  switch (role) {
-    case 'backend': return '(API core)';
-    case 'files': return '(static + uploads storage)';
-    case 'database': return '(Mongo + Redis)';
-    case 'ai': return '(AI inference engine)';
-    default: return '';
-  }
-}
-
-function serviceCommand(role: string, cfg: Awaited<ReturnType<typeof loadConfigAuto>>): string[] {
-  switch (role) {
-    case 'backend':
-      return ['tsx', 'apps/backend/src/main.ts'];
-    case 'ai':
-      return ['python', 'main.py'];
-    case 'files':
-      // Fall back to the framework uploads server launcher if present.
-      return ['tsx', 'apps/backend/src/main.ts'];
-    case 'database':
-      return ['tsx', 'apps/backend/src/main.ts'];
-    default:
-      return [];
-  }
-}
-
-function serviceUrls(role: string, cfg: Awaited<ReturnType<typeof loadConfigAuto>>): Partial<Record<'backend' | 'files' | 'database' | 'ai', string>> {
-  return { [role]: `http://localhost:${cfg.server.port}` };
-}

package/src/commands/pysetup.ts

@@ -1,142 +0,0 @@
-import { spawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import { versionOf } from '../util.js';
-import { isInteractive as wizardInteractive, confirm, prompt, closeWizard } from '../wizard.js';
-
-/**
- * Install the Python AI server dependencies (plus any extra packages).
- *
- * Locates `apps/ai-server/requirements.txt` (or a path given with --requirements),
- * optionally creates a virtualenv with --venv, and streams pip output through so the
- * user can watch progress.
- *
- *   nexus pysetup                        install from requirements.txt
- *   nexus pysetup openai pandas          install requirements.txt + extra packages
- *   nexus pysetup --venv                 create ./apps/ai-server/.venv and install into it
- *   nexus pysetup --interactive          prompt for venv y/n + python path (TTY only)
- *   nexus pysetup --upgrade              upgrade existing packages
- *   nexus pysetup --python C:/Python/Python314/python.exe
- *   nexus pysetup --requirements ./my-requirements.txt
- */
-export async function pysetup(args: string[]): Promise<number> {
-  let opts: PyOpts = parseArgs(args);
-
-  // -- interactive wizard mode (TTY only) ---------------------------
-  if (opts.interactive && wizardInteractive()) {
-    opts = await interactivePrompt(opts);
-    closeWizard();
-  }
-
-  const reqFile = resolve(process.cwd(), opts.requirements || findRequirementsFile(process.cwd()));
-  const py = await resolvePython(opts.python);
-
-  if (!opts.requirements && !findRequirementsFile(process.cwd())) {
-    console.error('Could not find apps/ai-server/requirements.txt - pass one with --requirements <path>.');
-    return 1;
-  }
-  if (!existsSync(reqFile)) {
-    console.error(`requirements file not found: ${reqFile}`);
-    return 1;
-  }
-  if (!py) {
-    console.error(`Python interpreter not found (tried python / python3). Pass --python <path>.`);
-    return 1;
-  }
-
-  const venvPy = opts.venv ? join(opts.venvDir, process.platform === 'win32' ? 'Scripts/python.exe' : 'bin/python') : py;
-  const createVenv = async () => {
-    if (existsSync(venvPy)) return 0;
-    console.log(`\n\x1b[36m[pysetup]\x1b[0m creating venv at ${opts.venvDir}`);
-    return run(py, ['-m', 'venv', opts.venvDir]);
-  };
-
-  console.log(`\n\x1b[36m[pysetup]\x1b[0m installing python packages`);
-  console.log(`  python      : ${py}${opts.venv ? ` -> ${venvPy}` : ''}`);
-  console.log(`  requirements: ${reqFile}`);
-  console.log(`  extras      : ${opts.extras.length ? opts.extras.join(', ') : '(none)'}`);
-  if (opts.venv) console.log(`  venv        : ${opts.venvDir}`);
-
-  if (opts.venv) {
-    const venvCode = await createVenv();
-    if (venvCode !== 0) return venvCode;
-  }
-
-  const pipArgs = ['-m', 'pip', 'install'];
-  if (opts.upgrade) pipArgs.push('--upgrade');
-  pipArgs.push('-r', reqFile, ...opts.extras);
-
-  const code = await run(venvPy ?? py, pipArgs);
-  if (code !== 0) {
-    console.error(`\n[pysetup] install failed (exit ${code}).`);
-    return code;
-  }
-  console.log(`\n\x1b[32m[pysetup]\x1b[0m done - ${opts.extras.length ? opts.extras.join(' ') : 'core requirements'} installed.`);
-  return 0;
-}
-
-/** Interactive prompts for venv + python path. Returns updated opts. */
-async function interactivePrompt(opts: PyOpts): Promise<PyOpts> {
-  const wantVenv = await confirm('Create a virtualenv for the AI server?', opts.venv);
-  const pythonPath = await prompt('Python interpreter path (blank = auto-detect)', opts.python || '');
-  return { ...opts, venv: wantVenv, python: pythonPath.trim() };
-}
-
-interface PyOpts { python: string; requirements: string; extras: string[]; upgrade: boolean; venv: boolean; venvDir: string; interactive: boolean }
-
-function parseArgs(args: string[]): PyOpts {
-  let python = '';
-  let requirements = '';
-  let upgrade = false;
-  let venv = false;
-  let interactive = false;
-  const extras: string[] = [];
-  for (let i = 0; i < args.length; i++) {
-    const a = args[i];
-    if (a === '--python') { python = args[++i] ?? ''; continue; }
-    if (a === '--requirements' || a === '-r') { requirements = args[++i] ?? ''; continue; }
-    if (a === '--upgrade' || a === '-U') { upgrade = true; continue; }
-    if (a === '--venv') { venv = true; continue; }
-    if (a === '--interactive') { interactive = true; continue; }
-    if (a.startsWith('--') || a.startsWith('-')) continue;
-    extras.push(a);
-  }
-  const reqDir = requirements ? resolve(requirements) : join(process.cwd(), 'apps', 'ai-server');
-  return { python, requirements, extras, upgrade, venv, venvDir: join(reqDir, '.venv'), interactive };
-}
-
-/** Find a requirements.txt under the cwd that belongs to the AI server. */
-function findRequirementsFile(cwd: string): string {
-  const candidates = [
-    join(cwd, 'apps', 'ai-server', 'requirements.txt'),
-    join(cwd, 'apps', 'server', 'requirements.txt'),
-    join(cwd, 'requirements.txt'),
-  ];
-  return candidates.find((p) => existsSync(p)) ?? '';
-}
-
-async function resolvePython(explicit: string): Promise<string> {
-  if (explicit) return existsSync(explicit) ? explicit : explicit;
-  const candidates = process.platform === 'win32' ? ['python', 'py'] : ['python3', 'python'];
-  for (const c of candidates) {
-    if (await versionOf(c)) return c;
-  }
-  return '';
-}
-
-function run(cmd: string, args: string[]): Promise<number> {
-  return new Promise((resolveRun) => {
-    // Windows: python may be a .cmd shim and needs a shell. Pass the full command
-    // line to avoid Node's DEP0190 warning (args + shell: true are concatenated
-    // unescaped anyway).
-    const win = process.platform === 'win32';
-    const child = win
-      ? spawn([cmd, ...args].map((t) => (/\s/.test(t) ? `"${t}"` : t)).join(' '), { stdio: 'inherit', shell: true })
-      : spawn(cmd, args, { stdio: 'inherit' });
-    child.on('error', (err) => {
-      console.error(`\x1b[31m[pysetup]\x1b[0m failed to run ${cmd}: ${err.message}`);
-      resolveRun(1);
-    });
-    child.on('close', (code) => resolveRun(code ?? 0));
-  });
-}

package/src/commands/sync.ts

@@ -1,116 +0,0 @@
-import { loadConfigAuto } from '../../../nexus-core/src/index.js';
-import {
-  readFingerprint,
-  syncConfig,
-  type FileSyncReport,
-  type SyncReport,
-} from '../config-sync.js';
-
-const GREEN = '\x1b[32m';
-const CYAN = '\x1b[36m';
-const YELLOW = '\x1b[33m';
-const DIM = '\x1b[2m';
-const BOLD = '\x1b[1m';
-const RESET = '\x1b[0m';
-
-/**
- * `nexus sync` - rewrite every derived artifact (Dockerfile, docker.* helpers,
- * bin/serve-all.mjs, apps/admin/package.json, the shared project-info DB) to
- * match the single `nexus.config.ts` source of truth.
- *
- * Returns the process exit code and always prints the resolved values so the
- * "one config prints everywhere" contract is visible.
- */
-export async function syncCommand(args: string[] = []): Promise<number> {
-  const root = process.cwd();
-  const opts = {
-    write: !args.includes('--check') && !args.includes('--dry-run'),
-    db: !args.includes('--no-db'),
-  };
-
-  if (!opts.write) {
-    process.stdout.write(`${DIM}  nexus sync - dry run (nothing written)${RESET}\n\n`);
-  }
-
-  const cfg = await loadConfigAuto({ root });
-  const report = await syncConfig(root, cfg, opts);
-
-  printReport(report, root);
-
-  if (!opts.write) {
-    process.stdout.write(`\n  ${YELLOW}Dry run - run \`nexus sync\` (no flag) to write the changes.${RESET}\n`);
-  }
-
-  const changed = report.files.some((f) => f.status === 'updated');
-  if (changed) {
-    process.stdout.write(`\n  ${GREEN}Synced. Run \`nexus dev\` to boot the stack on the new values.${RESET}\n`);
-  } else {
-    process.stdout.write(`\n  ${DIM}Everything is already in sync.${RESET}\n`);
-  }
-
-  return 0;
-}
-
-/** Print the per-value summary + per-file status table. */
-function printReport(report: SyncReport, root: string): void {
-  const v = report.values;
-
-  process.stdout.write(`\n${BOLD}  *  Nexus config sync${RESET} ${DIM}${root}${RESET}\n\n`);
-
-  process.stdout.write(`  ${CYAN}Value${RESET}${' '.repeat(12 - 5)}Config -> everywhere\n`);
-  process.stdout.write(`  -----------------------------\n`);
-  const rows: Array<[string, string]> = [
-    ['backend', `${v.serverPort}`],
-    ['frontend', `${v.frontendPort}`],
-    ['admin', `${v.adminPort}`],
-    ['node agent', `${v.nodePort}`],
-    ['cluster LB', `${v.lbPort}`],
-    ['AI server', `${v.aiPort}`],
-    ['database', `${v.dbName}`],
-  ];
-  for (const [label, value] of rows) {
-    const pad = label.padEnd(10);
-    process.stdout.write(`  ${CYAN}${pad}${RESET} ${value}\n`);
-  }
-
-  process.stdout.write('\n');
-  for (const f of report.files) {
-    const status = statusLabel(f);
-    process.stdout.write(`  ${f.file.padEnd(28)}${status}\n`);
-    if (f.status === 'updated' && f.changes.length > 0) {
-      for (const line of f.changes) {
-        process.stdout.write(`    ${DIM}${line}${RESET}\n`);
-      }
-    }
-  }
-
-  process.stdout.write(`\n  ${BOLD}Database${RESET}  ${dbLabel(report.db)}\n`);
-
-  if (readFingerprint(root)) {
-    process.stdout.write(`  ${DIM}fingerprint ${report.fingerprint}${RESET}\n`);
-  }
-}
-
-function statusLabel(f: FileSyncReport): string {
-  switch (f.status) {
-    case 'updated':
-      return `${GREEN}updated${RESET}`;
-    case 'in-sync':
-      return `${DIM}in sync${RESET}`;
-    case 'missing':
-      return `${YELLOW}missing${RESET}`;
-    default:
-      return `${YELLOW}no match - review${RESET}`;
-  }
-}
-
-function dbLabel(db: SyncReport['db']): string {
-  switch (db) {
-    case 'updated':
-      return `${GREEN}project record upserted${RESET}`;
-    case 'failed':
-      return `${YELLOW}unreachable - skipped${RESET}`;
-    default:
-      return `${DIM}skipped${RESET}`;
-  }
-}