Function buildAmbiguousMatchError

src/daemon/handlers/find.ts:631–651

(
  matches: SnapshotState['nodes'],
  locator: FindLocator,
  query: string,
)

}

function buildAmbiguousMatchError(
  matches: SnapshotState['nodes'],
  locator: FindLocator,
  query: string,
): DaemonResponse {
  const candidates = matches.slice(0, 8).map((candidate) => {
    const label =
      extractNodeText(candidate) || candidate.label || candidate.identifier || candidate.type || '';
    return `@${candidate.ref}${label ? `(${label})` : ''}`;
  });
  return errorResponse(
    'AMBIGUOUS_MATCH',
    `find matched ${matches.length} elements for ${locator} "${query}". Use a more specific locator or selector.`,
    {
      locator,
      query,
      matches: matches.length,
      candidates,
    },
  );
}

function shouldScopeFind(locator: FindLocator): boolean {
  return locator !== 'role';