Skip to content

Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.

docs: sync modules, cache capacities, and dispatcher references

Samir Hossains4fe1bb35cfde
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index b6e442e..15a7ca0 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -43,7 +43,7 @@ Short version:
- `src/cache.rs`: Local disk caching to minimize API calls.
The app is message-driven. User input and background tasks produce `Action` values,
-handled by the dispatcher in `src/tui/app/mod.rs`. When adding behavior, prefer adding a
+handled by the dispatcher in `src/tui/app/run.rs`. When adding behavior, prefer adding a
new `Action` variant over blocking the UI thread.
## Workflow
diff --git a/docs/architecture.md b/docs/architecture.md
index 3d2f7a8..8783a61 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -46,7 +46,7 @@ src/
event.rs EventHandler: input events + tick → Action channel
player.rs player detection and command construction
overlay.rs popups, pickers, notifications
- screens/ render-only modules (home, details, help, startup)
+ screens/ render-only modules (home, details, help)
terminal.rs terminal capability probes
theme.rs color themes
text.rs grapheme-safe text helpers
diff --git a/docs/cache.md b/docs/cache.md
index 2bee59e..08b501f 100644
--- a/docs/cache.md
+++ b/docs/cache.md
@@ -39,9 +39,10 @@ The cache directory is `dirs::cache_dir()/moviebox-tui` (macOS
## In-memory caches (AppState)
-- `image_cache` (10), `search_posters` (30), `search_poster_protocols` (30),
- `preview_cache` (30): `lru::LruCache` for poster images and terminal image
- protocols; `stream_pool`: resolved streams per subject.
+- `image_cache` (30), `search_posters` (300), `failed_posters` (300),
+ `search_poster_protocols` (300), `preview_cache` (30): `lru::LruCache` for poster
+ images, negative lookup cache, and terminal image protocols; `stream_pool`:
+ resolved streams per subject.
All disk access in async code is wrapped in `tokio::task::spawn_blocking` so the event
loop never blocks. Failures are logged (see [logging.md](logging.md)) and treated as
diff --git a/docs/known-issues.md b/docs/known-issues.md
index da1bfaa..eee90d8 100644
--- a/docs/known-issues.md
+++ b/docs/known-issues.md
@@ -24,7 +24,7 @@ Tracked here so future work and issue reports reference the same facts.
- **Termux playback needs the device confirmed** on each release: `termux-open` /
`am` availability and the Android chooser behavior.
-## Test coverage
-
-- Unit tests cover browse ranking, score extraction, and curated group matching logic (`src/tui/app/search.rs`).
-- Correctness across UI and network flows is enforced by the lint gate (`cargo clippy`), type checking, unit tests (`cargo test`), and manual verification. CI runs `cargo audit` and `cargo package`.
+## Verification
+
+- This project currently has no unit-test suite by design.
+- Correctness across UI, providers, and network flows is enforced by strict compiler type checking, the lint gate (`cargo clippy --all-targets -- -D warnings`), formatting (`cargo fmt --check`), and the manual/runtime verification gates in [`release-checklist.md`](release-checklist.md). CI also runs `cargo audit` and `cargo package`.
diff --git a/docs/modules.md b/docs/modules.md
index 3c6ffbc..df02423 100644
--- a/docs/modules.md
+++ b/docs/modules.md
@@ -60,7 +60,6 @@ src/
home.rs Home/startup + search list rendering (streaming and TV).
details.rs Details screen rendering.
help.rs Keybinding help (mode-aware).
- startup.rs Startup splash.
terminal.rs Terminal capability probes (basic UI, image querying).
theme.rs Color themes + terminal color detection.
text.rs Grapheme-safe width/truncation helpers.