Function runInit

src/bin/codegraph.ts:680–784

* The `init` flow — shared by `codegraph init` and `codegraph install --init` * (#1578): refuse an unsafe root, create `.codegraph/`, build the initial * index under supervision, then the post-index offers. `yes` makes every * offer non-interactive (defaults only), so a container / CI bootstrap n

(
  projectPath: string,
  options: { index?: boolean; force?: boolean; verbose?: boolean; yes?: boolean },
)

 * (no `--force` is implied by any caller); an index failure exits 1.
 */
async function runInit(
  projectPath: string,
  options: { index?: boolean; force?: boolean; verbose?: boolean; yes?: boolean },
): Promise<void> {
  const clack = await importESM('@clack/prompts');

  clack.intro('Initializing CodeGraph');

  try {
    // Refuse to index your home directory / a filesystem root — it pulls in
    // caches, other projects, and your whole tree (a multi-GB index + watcher
    // churn, and on pre-1.0 macOS a machine-crashing fd blowup, #845).
    const unsafe = unsafeIndexRootReason(projectPath);
    if (unsafe && !options.force) {
      clack.log.error(`Refusing to initialize in ${projectPath} — it looks like ${unsafe}.`);
      clack.log.info('Run this inside a specific project directory, or pass --force if you really mean to index everything under it.');
      clack.outro('');
      process.exitCode = 1;
      return;
    }

    if (isInitialized(projectPath)) {
      clack.log.warn(`Already initialized in ${projectPath}`);
      clack.log.info('Use "codegraph index" to re-index or "codegraph sync" to update');
      try {
        const { offerWatchFallback } = await import('../installer');
        await offerWatchFallback(clack, projectPath, { yes: options.yes });
      } catch { /* non-fatal */ }
      clack.outro('');
      return;
    }

    if (hasForeignDbFile(projectPath)) {
      const dbFile = path.join(getCodeGraphDir(projectPath), 'codegraph.db');
      clack.log.error(`${dbFile} is not a SQLite database, so it cannot be rebuilt in place.`);
      clack.log.info('Move or delete that file, then run "codegraph init" again.');
      clack.outro('');
      process.exitCode = 1;
      return;
    }
    if (hasSchemalessDb(projectPath)) {
      clack.log.warn(`Found a codegraph.db without the codegraph schema in ${getCodeGraphDir(projectPath)} (left by an interrupted init?) — rebuilding it.`);
    }
    const { default: CodeGraph, getDatabasePath } = await loadCodeGraph();
    const cg = await CodeGraph.init(projectPath, { index: false });
    clack.log.success(`Initialized in ${projectPath}`);
    // A fresh index on a Windows drive under WSL gets its own directory (#995).
    // It isn't the documented name, so say where it went and why.
    const dataDir = path.basename(getCodeGraphDir(projectPath));
    if (dataDir !== codeGraphDirName()) {
      clack.log.info(
        `The index is in ${dataDir}/: this project is on a Windows drive, so WSL keeps its own index ` +
        `rather than share ${DEFAULT_CODEGRAPH_DIR}/ with CodeGraph on Windows. Set CODEGRAPH_DIR to choose the name yourself.`
      );
    }

    // Indexing runs by default now. The legacy -i/--index flag is still
    // accepted (so existing muscle memory and scripts don't break) but is a