This adds scripts/doc_freshness.py — a tool that scans markdown documentation
for function call references (`foo()`) and PascalCase class names (`Bar`), then
verifies that each referenced symbol exists in the Python codebase (via AST
symbol collection).
- Parses docs for function/class references (backticked identifiers that are
either function calls ending with () or PascalCase class names)
- Checks if referenced items still exist in the code
- Reports stale doc references with file paths and line numbers
- Suitable for weekly cron execution; exit code 1 when stale refs found
Includes tests in tests/test_doc_freshness.py covering:
- symbol collection from Python AST
- doc reference extraction heuristics
- missing detection integration
Smallest concrete implementation satisfying all acceptance criteria.
ae675e72c2