Method doInitialize

src/mcp/engine.ts:220–261

(searchFrom: string)

  }

  private async doInitialize(searchFrom: string): Promise<void> {
    this.toolHandler.setDefaultProjectHint(searchFrom);

    // Up-walk first; when nothing is indexed at or above searchFrom, a bounded
    // down-scan may adopt a SINGLE indexed sub-project as the default (#1606 —
    // the workspace-container shape where only children are indexed). Zero or
    // several candidates → no default project, but SAY so (#1607): the silent
    // variant of this state read as "CodeGraph is broken" and was diagnosable
    // only by knowing to look for a missing ~/.codegraph/daemons/ entry.
    const res = resolveServerRoot(searchFrom);
    const resolvedRoot = res.root;
    if (!resolvedRoot) {
      // Sessions may still discover a project later via roots/list, and the
      // per-call retry re-resolves — this state is recoverable, hence stderr
      // (not a failure) + candidates surfaced through the tool-call error.
      this.projectPath = searchFrom;
      this.toolHandler.setKnownSubprojects(res.candidates, searchFrom);
      process.stderr.write(
        `[CodeGraph MCP] No .codegraph/ at or above ${searchFrom}: no default project, live sync disabled.\n`
      );
      if (res.candidates.length > 0) {
        const rels = res.candidates.map((c) => path.relative(searchFrom, c) || '.');
        process.stderr.write(
          `[CodeGraph MCP] Indexed sub-projects found: ${rels.join(', ')}. Pass \`projectPath\` per call, or launch with --path.\n`
        );
      }
      return;
    }
    if (res.viaSubScan) this.logSubprojectAdoption(searchFrom, resolvedRoot);

    this.projectPath = resolvedRoot;
    try {
      this.cg = await loadCodeGraph().open(resolvedRoot);
      this.toolHandler.setDefaultCodeGraph(this.cg);
      this.startWatching();
      this.catchUpSync();
      this.maybeStartPool(resolvedRoot);
    } catch (err) {
      const msg = err instanceof Error ? err.message : String(err);
      process.stderr.write(`[CodeGraph MCP] Failed to open project at ${resolvedRoot}: ${msg}\n`);
    }
  }

  /** One stderr line when the default project came from the down-scan (#1606). */
  private logSubprojectAdoption(searchFrom: string, root: string): void {