9router-manager 0.0.1

package/src/cli.js

@@ -0,0 +1,799 @@
+// src/cli.js
+// 9Router Manager CLI
+//
+// CLI wiring (commander v12):
+// - 7 commands: scan, list, results, test, setup, version, help
+// - results has aliases: check, status
+// - list accepts --details to print models in each combo
+// - each command delegates to the appropriate module
+// - no-args → interactive menu (banner + numbered/letter choices)
+// - each command returns an exit code (0 success, 1 error)
+import { Command } from 'commander';
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { loadEnv, getUserConfigPath, _generateVerifyToken } from './env.js';
+import * as combo from './combo.js';
+import {
+  login,
+  getModels,
+  testModelConcurrentWithBar,
+  testSingleModel,
+  writeAudit,
+  buildAuditData,
+  setVerifyContext,
+  clearVerifyContext,
+  setResolvedPassword,
+} from './scan.js';
+import { main as resultsMain } from './results.js';
+import { getProviderForModel } from './metadata.js';
+import { resolvePassword, passwordNotSetMessage } from './password.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PKG_PATH = path.join(__dirname, '..', 'package.json');
+const PROG_NAME = '9router-manager';
+
+function readPackageVersion() {
+  try {
+    return JSON.parse(fs.readFileSync(PKG_PATH, 'utf-8')).version;
+  } catch {
+    return 'unknown';
+  }
+}
+
+const VERSION = readPackageVersion();
+
+// ============================================================
+// UI HELPERS
+// ============================================================
+function banner(version = VERSION) {
+  return [
+    '',
+    '╔═══════════════════════════════════════════════════╗',
+    `║           9Router Manager v${version}                  ║`,
+    '╠═══════════════════════════════════════════════════╣',
+    '║  AI Gateway Local - Model Scanner                 ║',
+    '╚═══════════════════════════════════════════════════╝',
+    '',
+  ].join('\n');
+}
+
+function formatDuration(s) {
+  if (s < 60) return `${s.toFixed(2)}s`;
+  const m = Math.floor(s / 60);
+  const sec = (s % 60).toFixed(0);
+  return `${m}m ${sec}s`;
+}
+
+function formatTimestamp(d) {
+  const pad = (n) => String(n).padStart(2, '0');
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+}
+
+// ============================================================
+// COMMAND IMPLEMENTATIONS
+// ============================================================
+export async function runScan(opts = {}) {
+  const envPath = loadEnv();
+  if (!envPath) {
+    console.error('ERROR: .env not found. Copy .env.template to .env first.');
+    return 1;
+  }
+  // Resolve password from CLI flag → env var → TTY prompt (see src/password.js).
+  const password = await resolvePassword({ cliPassword: opts.password });
+  if (!password) {
+    console.error(passwordNotSetMessage());
+    return 1;
+  }
+  setResolvedPassword(password);
+  const baseUrl = process.env.NINEROUTER_BASE_URL || 'http://localhost:20128';
+  const sleep = parseFloat(process.env.NINEROUTER_SLEEP || '0.05');
+  const maxRetries = parseInt(process.env.NINEROUTER_RETRY_429_MAX || '2', 10);
+  const maxWorkers = parseInt(process.env.NINEROUTER_MAX_WORKERS || '1', 10);
+
+  const startedAt = new Date();
+  console.error(`[scan] starting at ${formatTimestamp(startedAt)}`);
+
+  // Generate unique verification token up front. The model must echo this token
+  // verbatim in its response — guarantees a real round-trip (anti-caching).
+  // The full prompt is recorded in the audit alongside the token (sanitized on write).
+  const verifyToken = _generateVerifyToken(8);
+  const verifyPrompt = `Reply with this exact token and nothing else: ${verifyToken}`;
+  setVerifyContext(verifyToken, verifyPrompt);
+  console.error(`[scan] verification token: ${verifyToken}`);
+
+  try {
+    // 1) Login
+    try {
+      await login({ baseUrl, password });
+      console.error('[scan] logged in');
+    } catch (e) {
+      console.error(`ERROR: login failed: ${e.message}`);
+      return 1;
+    }
+
+    // 2) Get models
+    let models;
+    try {
+      models = await getModels({ baseUrl });
+      console.error(`[scan] discovered ${models.length} models`);
+    } catch (e) {
+      console.error(`ERROR: getModels failed: ${e.message}`);
+      return 1;
+    }
+
+    // 3) Filter to active providers only
+    let activeProviders;
+    try {
+      activeProviders = await combo.getAvailableProviders();
+    } catch (e) {
+      console.error(`WARN: getAvailableProviders failed (${e.message}); proceeding with all models`);
+      activeProviders = new Set();
+    }
+    const candidates = models.filter((m) => {
+      const p = getProviderForModel(m);
+      return !p || activeProviders.size === 0 || activeProviders.has(p);
+    });
+    const skipped = models.length - candidates.length;
+    console.error(`[scan] ${candidates.length} candidates (${skipped} skipped, inactive provider)`);
+
+    // 4) Concurrent test
+    const results = await testModelConcurrentWithBar(candidates, {
+      baseUrl,
+      maxRetries,
+      sleep,
+      maxWorkers,
+    });
+    const okCount = results.filter((r) => r.ok).length;
+    const failedCount = results.length - okCount;
+    console.error(`[scan] ${okCount} ok, ${failedCount} failed`);
+
+    // 5) Detect target combo
+    let targetCombo;
+    try {
+      targetCombo = await combo.detectTargetCombo(models);
+      console.error(`[scan] target combo: ${targetCombo}`);
+    } catch (e) {
+      console.error(`ERROR: detect target combo: ${e.message}`);
+      return 1;
+    }
+
+    // 6) Update combo
+    let oldModels = [];
+    let newModels = [];
+    try {
+      const out = await combo.updateCombo(results, targetCombo);
+      oldModels = out.oldModels;
+      newModels = out.newModels;
+      const addedCount = newModels.filter((m) => !oldModels.includes(m)).length;
+      const removedCount = oldModels.filter((m) => !newModels.includes(m)).length;
+      console.error(`[scan] combo updated: +${addedCount} added, -${removedCount} removed`);
+    } catch (e) {
+      console.error(`ERROR: updateCombo failed: ${e.message}`);
+      return 1;
+    }
+
+    // 7) Audit
+    const finishedAt = new Date();
+    const durationSeconds = (finishedAt - startedAt) / 1000;
+    const auditData = buildAuditData({
+      startedAt: formatTimestamp(startedAt),
+      finishedAt: formatTimestamp(finishedAt),
+      durationSeconds,
+      verifyToken,
+      verifyPrompt,
+      models,
+      candidates,
+      skipped,
+      okCount,
+      failedCount,
+      oldModels,
+      newModels,
+      results,
+    });
+
+    // Sanitize verifyToken before writing to audit JSON
+    const sanitizedAuditData = {
+      ...auditData,
+      verify_token: '***REDACTED***',
+      verify_prompt: auditData.verify_prompt.replace(verifyToken, '***REDACTED***')
+    };
+
+    try {
+      await writeAudit(sanitizedAuditData);
+    } catch (e) {
+      console.error(`WARN: writeAudit failed: ${e.message}`);
+    }
+
+    console.error(`[scan] done in ${formatDuration(durationSeconds)}`);
+    return 0;
+  } finally {
+    clearVerifyContext();
+  }
+}
+
+export async function listCombo() {
+  loadEnv();
+  try {
+    const names = await combo.getComboNames();
+    if (names.length === 0) {
+      console.log('(no combos in DB)');
+      return 0;
+    }
+    console.log('Combos in database:');
+    for (const n of names) console.log(`  - ${n}`);
+    return 0;
+  } catch (e) {
+    console.error(`ERROR: ${e.message}`);
+    return 1;
+  }
+}
+
+export async function listComboDetails() {
+  loadEnv();
+  try {
+    const combos = await combo.getComboDetails();
+    if (combos.length === 0) {
+      console.log('(no combos in DB)');
+      return 0;
+    }
+    console.log('Combos in database:');
+    for (const c of combos) {
+      console.log(`  - ${c.name} (${c.models.length} models, updated: ${c.updatedAt || '-'})`);
+      if (c.models.length === 0) {
+        console.log('      (no models)');
+      } else {
+        for (const m of c.models) console.log(`      - ${m}`);
+      }
+    }
+    return 0;
+  } catch (e) {
+    console.error(`ERROR: ${e.message}`);
+    return 1;
+  }
+}
+
+export async function runTestInteractive() {
+  const readline = await import('node:readline/promises');
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const password = await resolvePassword({});
+    if (!password) {
+      console.error(passwordNotSetMessage());
+      return 1;
+    }
+    setResolvedPassword(password);
+
+    const baseUrl = process.env.NINEROUTER_BASE_URL || 'http://localhost:20128';
+    try {
+      await login({ baseUrl, password });
+    } catch (e) {
+      console.error(`ERROR: login failed: ${e.message}`);
+      return 1;
+    }
+
+    console.log('\n  Fetching available models...');
+    let models = [];
+    try {
+      models = await getModels();
+    } catch (e) {
+      console.error(`\n  ERROR: failed to fetch models: ${e.message}`);
+      return 1;
+    }
+
+    if (models.length === 0) {
+      console.log('\n  No models found.');
+      return 1;
+    }
+
+    // Paginate so a 100+ model list doesn't blow past a single screen.
+    const PAGE_SIZE = 20;
+    let page = 0;
+    const totalPages = Math.ceil(models.length / PAGE_SIZE);
+    while (true) {
+      const start = page * PAGE_SIZE;
+      const end = Math.min(start + PAGE_SIZE, models.length);
+      console.log(`\n  Available models (${models.length} total) — page ${page + 1}/${totalPages}:`);
+      for (let i = start; i < end; i++) {
+        console.log(`    [${i + 1}] ${models[i]}`);
+      }
+      // Navigation options are clearly separated from the model list.
+      const navOptions = ['[b] Back'];
+      if (totalPages > 1) {
+        navOptions.push(page > 0 ? '[p] Previous page' : null);
+        navOptions.push(page < totalPages - 1 ? '[n] Next page' : null);
+      }
+      const navLine = navOptions.filter(Boolean).join('  ');
+      console.log(`\n  ${navLine}`);
+
+      const promptLabel = totalPages > 1 ? 'nomor/p/n/b' : 'nomor/b';
+      const ans = (await rl.question(`\n  Pilih model (${promptLabel}): `)).trim().toLowerCase();
+      if (ans === 'b' || ans === 'back') {
+        return 0;
+      }
+      if (ans === 'n' || ans === 'next') {
+        if (page < totalPages - 1) {
+          page++;
+          continue;
+        }
+        console.log('  Sudah di halaman terakhir.');
+        continue;
+      }
+      if (ans === 'p' || ans === 'prev' || ans === 'previous') {
+        if (page > 0) {
+          page--;
+          continue;
+        }
+        console.log('  Sudah di halaman pertama.');
+        continue;
+      }
+      const n = parseInt(ans, 10);
+      if (!Number.isFinite(n) || n < 1 || n > models.length) {
+        console.log('  Pilihan tidak valid.');
+        continue;
+      }
+      const modelId = models[n - 1];
+      console.log(`\n  Testing model: ${modelId}`);
+      const r = await testSingleModel(modelId, { baseUrl, maxRetries: 0 });
+      console.log('\n  ' + JSON.stringify(r, null, 2).split('\n').join('\n  '));
+      return r.ok ? 0 : 1;
+    }
+  } finally {
+    rl.close();
+  }
+}
+
+export async function runTest(modelId, opts = {}) {
+  const envPath = loadEnv();
+  if (!envPath) {
+    console.error('ERROR: .env not found.');
+    return 1;
+  }
+  if (!modelId) {
+    console.error('ERROR: model id required. Usage: 9router-manager test <model>');
+    return 1;
+  }
+  // Resolve password from CLI flag → env var → TTY prompt (see src/password.js).
+  const password = await resolvePassword({ cliPassword: opts.password });
+  if (!password) {
+    console.error(passwordNotSetMessage());
+    return 1;
+  }
+  setResolvedPassword(password);
+  const baseUrl = process.env.NINEROUTER_BASE_URL || 'http://localhost:20128';
+  try {
+    await login({ baseUrl, password });
+  } catch (e) {
+    console.error(`ERROR: login failed: ${e.message}`);
+    return 1;
+  }
+  const r = await testSingleModel(modelId, { baseUrl, maxRetries: 0 });
+  console.log(JSON.stringify(r, null, 2));
+  return r.ok ? 0 : 1;
+}
+
+export async function runSetup({ yes = false } = {}) {
+  // Print the platform-appropriate scheduler installer.
+  // - Default: ask for confirmation, then spawn the script (stdio inherited)
+  //   so the user sees the same prompts they would see running it directly.
+  // - With { yes: true }: skip the prompt (for non-interactive invocations).
+  // - Falls back to "print and exit" if stdin is not a TTY and --yes not set.
+  const system = process.platform; // 'win32' | 'darwin' | 'linux' | ...
+  const lines = [
+    '9Router Manager — scheduler setup',
+    '==================================',
+    '',
+    'This will install a daily scan on your system\'s task scheduler.',
+    'A setup script must be run separately to make the actual changes.',
+    '',
+  ];
+
+  let scriptRel, scriptCmd, scriptArgs;
+  switch (system) {
+    case 'win32':
+      scriptRel = 'bat\\setup-scheduler.bat';
+      scriptCmd = 'cmd';
+      scriptArgs = ['/c', scriptRel];
+      break;
+    case 'darwin':
+      scriptRel = 'sh/setup-scheduler-macos.sh';
+      scriptCmd = 'bash';
+      scriptArgs = [scriptRel];
+      break;
+    case 'linux':
+    default:
+      scriptRel = 'sh/setup-scheduler.sh';
+      scriptCmd = 'bash';
+      scriptArgs = [scriptRel];
+      break;
+  }
+  // Project root = src/cli.js → ../  (sh/ and bat/ live here).
+  const projectRoot = path.resolve(__dirname, '..');
+  const scriptAbs = path.join(projectRoot, ...scriptRel.split(/[\\/]/));
+
+  // Sanity check: refuse to spawn if the script is missing.
+  if (!fs.existsSync(scriptAbs)) {
+    console.error(`ERROR: setup script not found at ${scriptAbs}`);
+    return 1;
+  }
+
+  lines.push(`Detected platform: ${system}`);
+  lines.push('');
+  lines.push(`Setup script:`);
+  lines.push(`  ${scriptRel}`);
+  lines.push('');
+  lines.push(`Full path (in case cwd is not project root):`);
+  lines.push(`  ${scriptAbs}`);
+  lines.push('');
+
+  // Skip prompt in non-TTY contexts unless --yes is set
+  if (!yes && !process.stdin.isTTY) {
+    lines.push('Non-interactive shell detected — re-run with --yes to actually run the script,');
+    lines.push('or copy the command above and run it yourself.');
+    console.log(lines.join('\n'));
+    return 0;
+  }
+
+  if (!yes) {
+    const readline = await import('node:readline/promises');
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    try {
+      // Accept any string starting with 'y' (with optional whitespace) as yes.
+      // This handles terminals that echo input or repeat keystrokes (e.g. "yy").
+      const ans = (await rl.question('Run the script now? This will modify your system. (y/n): ')).trim().toLowerCase();
+      if (!ans.startsWith('y')) {
+        console.log('Aborted. You can run the script manually using the command above.');
+        return 0;
+      }
+    } finally {
+      rl.close();
+    }
+  }
+
+  // Print a separator so the user can see the boundary between Node and the child script.
+  console.log('---');
+  console.log(`Running: ${scriptCmd} ${scriptArgs.join(' ')}`);
+  console.log('---');
+
+  return new Promise((resolve) => {
+    // Use the script's absolute path so the child can find it regardless of cwd.
+    // The leading forward slash in Windows paths is fine: Node normalizes it.
+    const absArgs = process.platform === 'win32'
+      ? [scriptAbs]
+      : [scriptAbs];
+    const child = spawn(scriptCmd, absArgs, {
+      cwd: projectRoot,
+      stdio: 'inherit',
+      shell: false,
+    });
+    child.on('error', (err) => {
+      console.error(`ERROR: failed to spawn setup script: ${err.message}`);
+      resolve(1);
+    });
+    child.on('exit', (code) => {
+      resolve(code ?? 1);
+    });
+  });
+}
+
+export async function runConfig() {
+  const readline = await import('node:readline/promises');
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  console.log('\n9Router Manager — Global Configuration');
+  console.log('====================================\n');
+
+  // Ensure we have current values loaded
+  loadEnv();
+
+  const currentPassword = process.env.NINEROUTER_PASSWORD || '';
+  const currentBaseUrl = process.env.NINEROUTER_BASE_URL || 'http://localhost:20128';
+
+  // Don't show the actual password if it exists
+  const passwordPrompt = currentPassword && currentPassword !== '***ISI_PASSWORD_DISINI***'
+    ? 'Enter 9Router Password (leave empty to keep current): '
+    : 'Enter 9Router Password: ';
+
+  let newPassword;
+  try {
+    // We don't mask here because we want a simple wizard, but we could use the masked prompt
+    // from password.js if we wanted to. For config wizard, standard question is often fine,
+    // but let's be secure and import the masked prompt.
+    const { promptMasked } = await import('./password.js');
+    newPassword = await promptMasked(passwordPrompt);
+  } catch (e) {
+    console.error(`\nError: ${e.message}`);
+    rl.close();
+    return 1;
+  }
+
+  const newBaseUrl = await rl.question(`Enter 9Router Base URL [${currentBaseUrl}]: `);
+  rl.close();
+
+  const finalPassword = newPassword || currentPassword;
+  const finalBaseUrl = newBaseUrl || currentBaseUrl;
+
+  if (!finalPassword || finalPassword === '***ISI_PASSWORD_DISINI***') {
+    console.error('\n❌ Configuration cancelled: Password is required.');
+    return 1;
+  }
+
+  const configPath = getUserConfigPath();
+  const configDir = path.dirname(configPath);
+
+  try {
+    fs.mkdirSync(configDir, { recursive: true });
+
+    // Read existing to preserve other variables if they exist
+    let envContent = '';
+    if (fs.existsSync(configPath)) {
+      envContent = fs.readFileSync(configPath, 'utf8');
+    }
+
+    // Update or append variables
+    const varsToUpdate = {
+      NINEROUTER_PASSWORD: finalPassword,
+      NINEROUTER_BASE_URL: finalBaseUrl
+    };
+
+    let newContent = envContent;
+
+    for (const [key, value] of Object.entries(varsToUpdate)) {
+      const regex = new RegExp(`^${key}=.*$`, 'm');
+      if (regex.test(newContent)) {
+        newContent = newContent.replace(regex, `${key}=${value}`);
+      } else {
+        // Ensure ends with newline before appending
+        if (newContent && !newContent.endsWith('\n')) newContent += '\n';
+        newContent += `${key}=${value}\n`;
+      }
+    }
+
+    fs.writeFileSync(configPath, newContent, { mode: 0o600 }); // strict permissions for password
+    console.log(`\n✅ Configuration saved to ${configPath}`);
+    return 0;
+  } catch (e) {
+    console.error(`\n❌ Failed to save configuration: ${e.message}`);
+    return 1;
+  }
+}
+
+function cmdVersion() {
+  console.log(`9Router Manager v${VERSION}`);
+  return 0;
+}
+
+// ============================================================
+// PROGRAM
+// ============================================================
+function buildProgram() {
+  const program = new Command();
+
+  program
+    .name(PROG_NAME)
+    .description('9Router AI Gateway Local - Combo Model Scanner')
+    .version(VERSION, '-V, --version', 'output the version number')
+    .helpOption('-h, --help', 'display help for command')
+    .showHelpAfterError(false);
+
+  program
+    .command('scan')
+    .description('Run daily combo model scan')
+    .option('-p, --password <pwd>', 'NINEROUTER_PASSWORD (insecure: visible in process list; for testing only)')
+    .action(async (opts) => {
+      process.exitCode = await runScan({ password: opts.password });
+    });
+
+  program
+    .command('config')
+    .description('Configure global settings (interactive)')
+    .action(async () => {
+      process.exitCode = await runConfig();
+    });
+
+  program
+    .command('list')
+    .description('List combos in database (use --details to show models)')
+    .option('--details', 'show models in each combo')
+    .action(async (opts) => {
+      process.exitCode = opts.details ? await listComboDetails() : await listCombo();
+    });
+
+  program
+    .command('results')
+    .alias('check')
+    .alias('status')
+    .description('Show last scan results')
+    .action(async () => {
+      loadEnv();
+      try {
+        process.exitCode = await resultsMain();
+      } catch (e) {
+        // resultsMain may call process.exit directly; only hit this if it threw
+        console.error(`ERROR: ${e.message}`);
+        process.exitCode = 1;
+      }
+    });
+
+  program
+    .command('test <model>')
+    .description('Test a single model')
+    .option('-p, --password <pwd>', 'NINEROUTER_PASSWORD (insecure: visible in process list; for testing only)')
+    .action(async (model, opts) => {
+      process.exitCode = await runTest(model, { password: opts.password });
+    });
+
+  program
+    .command('setup')
+    .description('Setup auto-scan scheduler')
+    .option('-y, --yes', 'skip the confirmation prompt before running the platform setup script')
+    .action(async (opts) => {
+      process.exitCode = await runSetup({ yes: !!opts.yes });
+    });
+
+  program
+    .command('version')
+    .description('Show version info')
+    .action(() => {
+      process.exitCode = cmdVersion();
+    });
+
+  program
+    .command('help')
+    .description('Show help')
+    .action(() => {
+      program.help();
+    });
+
+  return program;
+}
+
+// ============================================================
+// INTERACTIVE
+// ============================================================
+const INTERACTIVE_OPTIONS = [
+  ['scan', 'Run Model Scan'],
+  ['list', 'List Combos'],
+  ['results', 'Show Last Scan Results'],
+  ['test', 'Test Single Model'],
+  ['setup', 'Setup Auto-Scan Scheduler'],
+  ['config', 'Configure Settings'],
+  ['version', 'Version Info'],
+  ['help', 'Show Help'],
+  ['quit', 'Quit'],
+];
+
+async function runInteractive(program) {
+  const readline = await import('node:readline/promises');
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+  // Map letter shortcuts to commands
+  const LETTER_SHORTCUTS = {
+    q: 'quit',
+    h: 'help',
+    v: 'version',
+  };
+  try {
+    while (true) {
+      console.log(banner(VERSION));
+      // Split menu items into "main" (numbered 1..N) and "shortcuts" (v/h/q).
+      // Main items are listed vertically; shortcuts (version, help, quit) are
+      // appended inline on the last line so they don't eat a row each.
+      const mainItems = INTERACTIVE_OPTIONS.filter(([k]) => k !== 'version' && k !== 'help' && k !== 'quit');
+      mainItems.forEach(([key, label], i) => {
+        console.log(`  [${i + 1}] ${label}`);
+      });
+      // Footer line: 2 columns of shortcuts, right-aligned to a fixed width so
+      // the layout stays tidy in narrow terminals.
+      console.log('─'.repeat(60));
+      console.log(`  [v] Version Info    [h] Show Help    [q] Quit`);
+
+      const ans = (await rl.question('\n  Pilihan (nomor/v/h/q): ')).trim().toLowerCase();
+      if (ans === 'q' || ans === 'quit') {
+        console.log('Bye.');
+        break;
+      }
+      if (ans === 'h' || ans === 'help') {
+        program.help();
+        await rl.question('\n  Press Enter to continue...');
+        continue;
+      }
+      if (ans === 'v' || ans === 'version') {
+        cmdVersion();
+        await rl.question('\n  Press Enter to continue...');
+        continue;
+      }
+      const n = parseInt(ans, 10);
+      if (!Number.isFinite(n) || n < 1 || n > INTERACTIVE_OPTIONS.length) {
+        console.log('  Pilihan tidak valid.');
+        await rl.question('  Press Enter to continue...');
+        continue;
+      }
+      const [cmd] = INTERACTIVE_OPTIONS[n - 1];
+      if (cmd === 'quit') {
+        console.log('Bye.');
+        break;
+      }
+      if (cmd === 'help') {
+        program.help();
+        await rl.question('\n  Press Enter to continue...');
+        continue;
+      }
+      if (cmd === 'version') {
+        cmdVersion();
+        await rl.question('\n  Press Enter to continue...');
+        continue;
+      }
+      if (cmd === 'test') {
+        // Test single model — fetch from API and show as paginated numbered list.
+        // Handled inline (not via synthetic argv) because commander requires a <model>
+        // argument and we want to let the user pick interactively, not type an ID.
+        await runTestInteractive();
+        await rl.question('\n  Press Enter to continue...');
+        continue;
+      }
+      console.log();
+      // For commands that need their own pre-argv prompting (e.g. list --details),
+      // we re-invoke via synthetic argv. test and config are handled inline above.
+      const fakeArgs = [process.argv[0] || 'node', process.argv[1] || 'src/cli.js', cmd];
+      if (cmd === 'list') {
+        const showDetails = (await rl.question('  Tampilkan model dalam combo? (y/n): ')).trim().toLowerCase();
+        if (showDetails === 'y' || showDetails === 'yes') {
+          fakeArgs.push('--details');
+        }
+      }
+      // Reset exitCode so interactive loop can re-enter
+      process.exitCode = 0;
+      await program.parseAsync(fakeArgs);
+      // Don't break on non-zero — let the user choose again
+      await rl.question('\n  Press Enter to continue...');
+    }
+  } finally {
+    rl.close();
+  }
+  return 0;
+}
+
+// ============================================================
+// MAIN
+// ============================================================
+export async function main(argv = process.argv) {
+  const args = argv.slice(2);
+
+  // No args → interactive mode
+  if (args.length === 0) {
+    const program = buildProgram();
+    return runInteractive(program);
+  }
+
+  // Load .env — silent when missing.
+  loadEnv();
+
+  const program = buildProgram();
+  await program.parseAsync(argv);
+  return process.exitCode ?? 0;
+}
+
+// Entry point: only run when this file is executed directly,
+// not when it's imported as a module (e.g. by tests or by bin/9router-manager.js).
+function resolveArgv1() {
+  try {
+    return fileURLToPath(`file://${process.argv[1]}`);
+  } catch {
+    return process.argv[1];
+  }
+}
+
+const isDirectInvocation =
+  process.argv[1] && fileURLToPath(import.meta.url) === resolveArgv1();
+
+if (isDirectInvocation) {
+  main().catch((err) => {
+    console.error('FATAL:', err?.message ?? err);
+    process.exit(1);
+  });
+}