Function resolveProjectSelector

src/index.ts:734–842

(selector: string)

}

async function resolveProjectSelector(selector: string): Promise<ProjectResolution> {
  const trimmedSelector = selector.trim();
  if (!trimmedSelector) {
    return {
      ok: false,
      response: buildProjectSelectionError(
        'unknown_project',
        'project must be a non-empty absolute path, file:// URI, or relative subproject path.'
      )
    };
  }

  if (trimmedSelector.startsWith('file://') || path.isAbsolute(trimmedSelector)) {
    const resolvedPath = parseProjectDirectory(trimmedSelector);
    if (!resolvedPath) {
      return {
        ok: false,
        response: buildProjectSelectionError(
          'unknown_project',
          'project must be a non-empty absolute path, file:// URI, or relative subproject path.'
        )
      };
    }
    return resolveProjectFromAbsolutePath(resolvedPath);
  }

  const normalizedSelector = trimmedSelector.replace(/\\/g, '/').replace(/^\.\/+/, '');
  const descriptorMatches = listProjectDescriptors().filter(
    (descriptor) =>
      descriptor.label === normalizedSelector ||
      descriptor.relativePath === normalizedSelector ||
      path.basename(descriptor.rootPath) === normalizedSelector
  );

  if (descriptorMatches.length === 1) {
    const matchedRootPath = descriptorMatches[0].rootPath;
    if (descriptorMatches[0].source === 'subdirectory') {
      registerDiscoveredProjectPath(matchedRootPath, 'subdirectory');
    } else {
      rememberProjectPath(matchedRootPath, classifyProjectSource(matchedRootPath), {
        touch: false
      });
    }
    const project = getOrCreateProject(matchedRootPath);
    return { ok: true, project };
  }

  if (descriptorMatches.length > 1) {
    return {
      ok: false,
      response: buildProjectSelectionError(
        'selection_required',
        `Project selector "${normalizedSelector}" matches multiple known projects. Retry with an absolute path.`,
        {
          reason: 'project_selector_ambiguous',
          nextAction: 'retry_with_project'
        }
      )