# Serato Doctor

Serato Doctor is a read-only-first toolkit for inspecting and eventually repairing
DJ libraries. Serato is the first supported engine.

## Analyze a Library

```shell
serato-doctor analyze \
  --serato ~/Music/_Serato_ \
  --music ~/Music/Jukebox
```

Analysis prints a transparent reference-integrity score plus broken references,
duplicate filenames, unused tracks, and suggested filename matches. It does not
modify the library or create report files.

If crates contain an older library root, supply it explicitly:

```shell
serato-doctor analyze --reference-root /Users/old-user/OneDrive/Jukebox
```

## Generate Detailed Reports

Running without a command preserves the original scanner behavior and writes CSV
and text reports:

```shell
serato-doctor --serato ~/Music/_Serato_ --music ~/Music/Jukebox
```

Use `--verbose` for progress on standard error or `--log-file PATH` for an
aggregate diagnostic log.

Serato Doctor never repairs files without an explicit future repair workflow,
preview, backup, and rollback path.