feat(rust): add uncached compatibility refresh to apply

[afonsojramos]

Summary

A freshly published compatibility fix can remain unavailable to normal Apply while GitHub's CDN serves an older index. spicetify apply --no-cache downloads fresh compatibility data without local file reuse or CDN cache hits, while retaining checksum verification.

A required refresh failure exits before Spotify is stopped or modified. Normal Apply keeps its offline fallback. The option refreshes classmaps, CSS-map overlays, metadata, and exposure patches; theme/module updates remain separate.

Companion documentation: spicetify/docs#238.

Related: spicetify/classmaps#8

Validation

• Rust workspace: 151 tests passed, 3 existing tests ignored.
• Production Clippy targets passed. All-targets Clippy reports existing test warnings, verified against the base branch.
• Live macOS Spotify 1.3.0.277: the worktree CLI downloaded all compatibility files and applied successfully; Text 0.1.6 retained its 16px track, separated timestamps, pointer/keyboard seeking, and duration toggle.
• An unavailable refresh endpoint returned an error while Spotify's PID and installed index remained unchanged. The local classmap override conflict also returned the documented error.

The live test used a development build. The installed Rust CLI was reapplied afterward; this option still needs a CLI release.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: 27497ad6-2842-4b58-9f48-f57158bc6efc

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}