Function resolveProjectForTool

src/index.ts:1421–1475

(args: Record<string, unknown>)

}

async function resolveProjectForTool(args: Record<string, unknown>): Promise<ProjectResolution> {
  const requestedProject = parseProjectSelector(args.project);
  const requestedProjectDirectory = parseProjectSelector(args.project_directory);

  if (requestedProject || requestedProjectDirectory) {
    return resolveExplicitProjectSelection({
      project: requestedProject,
      projectDirectory: requestedProjectDirectory
    });
  }

  const activeProject = activeProjectKey ? getTrackedRootPathByKey(activeProjectKey) : undefined;
  if (activeProject) {
    const project = getOrCreateProject(activeProject);
    await initProject(project.rootPath, watcherDebounceMs, { enableWatcher: true });
    touchProject(project.rootPath);
    return { ok: true, project };
  }

  const availableProjects = listProjectDescriptors();
  if (availableProjects.length === 0) {
    return {
      ok: false,
      response: buildProjectSelectionError(
        'selection_required',
        'No active project is available yet. Retry with project or wait for MCP roots to arrive.',
        {
          reason: clientRootsEnabled
            ? 'workspace_waiting_for_project_selection'
            : 'workspace_waiting_for_roots_or_project',
          nextAction: 'retry_with_project'
        }
      )
    };
  }

  if (availableProjects.length === 1) {
    const project = getOrCreateProject(availableProjects[0].rootPath);
    await initProject(project.rootPath, watcherDebounceMs, { enableWatcher: true });
    setActiveProject(project.rootPath);
    return { ok: true, project };
  }

  return {
    ok: false,
    response: buildProjectSelectionError(
      'selection_required',
      'Multiple projects are available and no active project could be inferred. Retry with project.',
      {
        reason: 'multiple_projects_configured_no_active_context',
        nextAction: 'retry_with_project'
      }
    )
  };
}

async function resolveProjectForResource(): Promise<ProjectState | undefined> {
  const activeProject = activeProjectKey ? getTrackedRootPathByKey(activeProjectKey) : undefined;