Function buildSnapshotNotices

src/utils/output.ts:619–641

(
  data: Record<string, unknown>,
  nodes: SnapshotNode[],
  options: SnapshotTextOptions,
  helperPresentation: AndroidHelperPresentationInput = { nodes, filteredCount: 0 },
)

}

function buildSnapshotNotices(
  data: Record<string, unknown>,
  nodes: SnapshotNode[],
  options: SnapshotTextOptions,
  helperPresentation: AndroidHelperPresentationInput = { nodes, filteredCount: 0 },
): string[] {
  const notices = readSnapshotWarnings(data);
  // The structured snapshot quality verdict already carries a sharper version of this hint.
  if (shouldRenderLegacySparseSnapshotHint(data)) {
    const sparseSnapshotHint = formatSparseSnapshotHint(nodes, options);
    if (sparseSnapshotHint) notices.push(sparseSnapshotHint);
  }
  if (!options.raw && helperPresentation.filteredCount > 0) {
    notices.push(
      `Collapsed ${helperPresentation.filteredCount} Android helper node${helperPresentation.filteredCount === 1 ? '' : 's'} from the agent-facing text snapshot; use --raw or --json for the full hierarchy.`,
    );
  }
  const repeatedNavNodes = helperPresentation.filteredCount > 0 ? helperPresentation.nodes : nodes;
  if (!options.raw && detectPossibleRepeatedNavSubtree(repeatedNavNodes)) {
    notices.push('Warning: possible repeated nav subtree detected.');
  }
  return notices;
}

function shouldRenderLegacySparseSnapshotHint(data: Record<string, unknown>): boolean {
  return !data.snapshotQuality && !isWebSnapshotData(data);