Function resolveProjectFromAbsolutePath

src/index.ts:504–573

(resolvedPath: string)

}

async function resolveProjectFromAbsolutePath(resolvedPath: string): Promise<ProjectResolution> {
  const absolutePath = path.resolve(resolvedPath);
  const containingRoot = getContainingKnownRoot(absolutePath);

  if (clientRootsEnabled && getKnownRootPaths().length > 0 && !containingRoot) {
    return {
      ok: false,
      response: buildProjectSelectionError(
        'unknown_project',
        'Requested project is not under an active MCP root.'
      )
    };
  }

  let stats;
  try {
    stats = await fs.stat(absolutePath);
  } catch {
    return {
      ok: false,
      response: buildProjectSelectionError(
        'unknown_project',
        `project does not exist: ${absolutePath}`
      )
    };
  }

  const lookupPath = stats.isDirectory() ? absolutePath : path.dirname(absolutePath);
  const exactDescriptor = listProjectDescriptors().find(
    (descriptor) => normalizeRootKey(descriptor.rootPath) === normalizeRootKey(lookupPath)
  );
  if (exactDescriptor) {
    const project = getOrCreateProject(exactDescriptor.rootPath);
    if (exactDescriptor.source === 'subdirectory') {
      registerDiscoveredProjectPath(exactDescriptor.rootPath, 'subdirectory');
    } else {
      rememberProjectPath(exactDescriptor.rootPath, exactDescriptor.source, { touch: false });
    }
    return { ok: true, project };
  }

  const nearestBoundary = await findNearestProjectBoundary(absolutePath, containingRoot);
  const resolvedProjectPath =
    nearestBoundary?.rootPath ?? containingRoot ?? (stats.isDirectory() ? absolutePath : undefined);

  if (!resolvedProjectPath) {
    return {
      ok: false,
      response: buildProjectSelectionError(
        'unknown_project',
        `project was not found from path: ${absolutePath}`
      )
    };
  }

  const invalidProjectResponse = await validateResolvedProjectPath(resolvedProjectPath);
  if (invalidProjectResponse) {
    return { ok: false, response: invalidProjectResponse };