check-stale-result-schema-uniform
IN premise
All `check_stale` result dicts share the same 6-key schema (`node_id`, `old_hash`, `new_hash`, `source`, `source_path`, `reason`) regardless of reason type, so consumers can iterate results without type-checking.
Summary
Every result returned by the staleness checker uses the same six fields no matter what triggered the staleness, which means any code processing these results can treat them uniformly without branching on the reason type. This keeps downstream consumers simple and makes it safe to add new staleness reasons without updating every caller.
Dependents
These beliefs depend on this one:
- check-stale-output-is-deterministic-and-structured — Staleness checking produces deterministic (sorted by node ID), uniformly structured (consistent 6-key schema across all result types), and exception-free (returns structured dicts for missing files rather than raising) output suitable for programmatic consumption and diffing.
Details
| Source | entries/2026/04/29/tests-test_check_stale_issue25.md |