Function bootstrap

src/index.ts:40–147

()

import { fileURLToPath } from 'url';
import { logger } from './utils/logger.js';

async function bootstrap(): Promise<{
  config: Awaited<ReturnType<typeof loadConfig>>;
  router: ModelRouter;
  registry: ToolRegistry;
  permissions: PermissionEngine;
  mcpManager: MCPManager;
  codeGraph: CodeGraphDB;
  indexer: Indexer;
  hooks: HooksManager;
}> {
  await ensureQodexHome();
  await logger.init('info');
  logger.info('QodeX starting', { node: process.version, cwd: process.cwd() });

  // Load any API keys stored in ~/.qodex/.env (written by `qodex provider add`) into the
  // environment BEFORE the router reads them. An explicit `export` in the user's shell still
  // wins, so this never overrides a key they set themselves.
  try {
    const { loadEnvFileIntoProcess } = await import('./setup/env-writer.js');
    const n = await loadEnvFileIntoProcess();
    if (n > 0) logger.info(`Loaded ${n} API key(s) from ~/.qodex/.env`);
  } catch (e: any) {
    logger.debug('No ~/.qodex/.env loaded', { err: e?.message });
  }

  // Warm the real BPE tokenizer in the background (gpt-tokenizer, if installed).
  // Non-blocking: token counts use the calibrated heuristic until this resolves.
  void import('./utils/tokenizer.js').then(t => t.warmTokenizer()).catch((err) => logger.debug('tokenizer warm-up failed', { err }));

  const config = await loadConfig(process.cwd());
  // Import Claude Code plugins/standalone assets: agents → dispatchable roles (for the
  // `task` tool + plugin commands like /review-pr), plus plugin-declared MCP servers and
  // hooks. User config always wins on collisions. (Skills/commands are loaded separately
  // by their own loaders.) Disable all of this with QODEX_DISABLE_CLAUDE_PLUGINS=1.
  try {
    const { applyClaudeCodeIntegration } = await import('./integrations/claude-plugins.js');
    const r = await applyClaudeCodeIntegration(config, process.cwd());
    if (r.agents || r.mcp || r.hooks) {
      logger.info('Claude Code integration applied', r);
    }
  } catch (e: any) {
    logger.debug('Claude Code integration skipped', { err: e?.message });
  }
  setActiveConfig(config);
  // Browser CDP attach: if configured, the browser_* tools attach to the user's running
  // browser instead of launching a fresh headless one. (QODEX_BROWSER_CDP_URL env wins.)
  if ((config as any).browser?.cdpUrl) {
    try {
      const { setBrowserCdpUrl } = await import('./tools/browser/session.js');
      setBrowserCdpUrl((config as any).browser.cdpUrl);
    } catch { /* browser module optional */ }
  }
  const router = new ModelRouter(config);
  const registry = new ToolRegistry();
  const permissions = new PermissionEngine(config);

  // Code graph — project-local SQLite