Function ensureProjectInitialized

src/index.ts:1505–1546

(project: ProjectState)

};

async function ensureProjectInitialized(project: ProjectState): Promise<void> {
  if (project.initPromise) {
    await project.initPromise;
    return;
  }

  if (project.indexState.status !== 'idle') {
    return;
  }

  project.initPromise = (async () => {
    // Migrate legacy structure
    try {
      const legacyPaths = makeLegacyPaths(project.rootPath);
      const migrated = await migrateToNewStructure(project.paths, legacyPaths);
      if (migrated && process.env.CODEBASE_CONTEXT_DEBUG) {
        console.error(`[DEBUG] Migrated to .codebase-context/ structure: ${project.rootPath}`);
      }
    } catch {
      // Non-fatal
    }

    // Check if indexing is needed
    const needsIndex = await shouldReindex(project.paths);
    if (needsIndex) {
      if (process.env.CODEBASE_CONTEXT_DEBUG) {
        console.error(`[DEBUG] Starting indexing: ${project.rootPath}`);
      }
      void performIndexing(project);
    } else {
      if (process.env.CODEBASE_CONTEXT_DEBUG) {
        console.error(`[DEBUG] Index found. Ready: ${project.rootPath}`);
      }
      project.indexState.status = 'ready';
      project.indexState.lastIndexed = new Date();
    }
  })().finally(() => {
    project.initPromise = undefined;
  });

  await project.initPromise;
}

function ensureProjectWatcher(project: ProjectState, debounceMs: number): void {
  if (project.stopWatcher) {