Function formatSparseSnapshotHint

src/utils/output.ts:656–663

(
  nodes: SnapshotNode[],
  options: Pick<SnapshotTextOptions, 'scoped' | 'depthLimited'>,
)

}

function formatSparseSnapshotHint(
  nodes: SnapshotNode[],
  options: Pick<SnapshotTextOptions, 'scoped' | 'depthLimited'>,
): string | null {
  if (options.scoped === true || options.depthLimited === true || nodes.length > 3) return null;
  const noun = nodes.length === 1 ? 'node' : 'nodes';
  return `Hint: sparse accessibility snapshot returned ${nodes.length} ${noun}; snapshot state is invalid or unavailable for this screen. Use plain screenshot, not screenshot --overlay-refs, as visual truth. If screenshot shows the Home Screen or another app, run open for this app again first. Then navigate away with coordinates if needed and retry snapshot -i on the next screen.`;
}

function readSnapshotWarnings(data: Record<string, unknown>): string[] {
  const rawWarnings = data.warnings;