staleness-results-are-dicts-not-exceptions
IN premise
Both `check_stale` and `hash_sources` report problems (missing files, changed content, deleted sources) as list-of-dict return values, never raising exceptions — designed for batch audit operations that report all problems rather than aborting on the first.
Summary
The staleness-checking functions in the caching system are designed to collect and return all problems they find rather than failing fast. When a source file is missing, changed, or deleted, you get back a list of dictionaries describing each issue instead of an exception blowing up the process. This matters because it means callers can run a full audit pass and present a complete report of everything that needs attention, rather than having to fix issues one at a time in a try-catch loop.
Details
| Source | entries/2026/04/29/tests-test_check_stale.md |