Philip Guzman
28 lines
1.0 KiB
Markdown
28 lines
1.0 KiB
Markdown
# Broken Symlink Detection
|
|
|
|
## Problem
|
|
|
|
Library migrations may leave symbolic links pointing to files or folders that no
|
|
longer exist. The filesystem scanner previously skipped those links silently.
|
|
|
|
## Architecture
|
|
|
|
One read-only filesystem traversal now returns audio tracks and broken symbolic
|
|
links. Each finding preserves the link path and its raw target when the operating
|
|
system can read it. The library and health report retain only immutable findings.
|
|
|
|
Broken links are reported separately and do not affect the reference-integrity
|
|
score. The detector does not follow, recreate, remove, or rewrite any link.
|
|
|
|
## Edge Cases
|
|
|
|
- Relative and absolute link targets.
|
|
- Links to missing files and missing directories.
|
|
- Link targets that cannot be read due to an operating-system error.
|
|
- Valid symlinks, which remain eligible for ordinary audio scanning.
|
|
|
|
## Verification
|
|
|
|
Tests create synthetic valid and broken links in temporary directories, verify the
|
|
raw target, and confirm health integration. Existing scanner behavior is preserved.
|