source-path-format
IN premise
Source references use `"reponame/relative/path"` format; `resolve_source_path` splits on the first `/` to look up the repo key in a `repos: dict[str, Path]` mapping.
Summary
When referencing source files, the system expects a specific format where the repository name comes first, followed by a slash and the file path within that repo. The resolver function uses that first slash as the split point to find which local repository directory to look in, so getting the format wrong means the file lookup will fail silently or error out.
Dependents
These beliefs depend on this one:
- source-resolution-is-convention-based-and-fail-safe — Source path resolution follows a convention-based repo-alias/relative-path format and returns None on missing files rather than raising exceptions, providing safe path resolution for the staleness checking pipeline.
Details
| Source | entries/2026/04/24/tests-test_check_stale.md |