# Dashboard reconstruction — durable TODO

Updated: 2026-10-16. Contract: [styleguide](dashboard-styleguide.md). Scope and sequence: [plan](dashboard-reconstruction-plan.md).

Use `[x]` only after implementation and relevant verification. Record evidence below; retain incomplete items across handoffs.

## Design and discovery
- [x] Inventory all nine routes, shared/static/dynamic modules and existing browser tests.
- [x] Trace weight caches, download/load differences, output ownership and missing deletion APIs.
- [x] Write grayscale hierarchy, broad negative-space composition and reusable component contract.
- [x] Specify Departure Mono, local bundling and license.
- [x] Specify nested model-module explorer in a modal instead of raw model dropdown.
- [x] Write page-by-page implementation and validation plan before production edits.

## Shared system and pages
- [x] Bundle Departure Mono and license; verify actual browser font loading.
- [x] Replace pure black/white tokens with readable muted grayscale surface hierarchy.
- [x] Reconstruct shared shell, headings, sections, fields, actions, lists and dialogs.
- [x] Chat and nested workspace/session/voice controls.
- [x] Agent and nested run/approval/detail controls.
- [x] Voice and nested ASR/TTS/clone/model controls.
- [x] Generate composer, all generation/analysis modes and optional parameter groups.
- [x] Projects and nested management.
- [x] Dashboard and nested telemetry/jobs.
- [x] Activity and nested event detail.
- [x] Discover and nested capability exploration.
- [x] Settings and nested configuration forms.

## Model modules and saved media
- [x] Accurate model/dependency/cache inventory and explicit unsupported-provider states.
- [x] Durable download-only jobs, deduplication, status and restart recovery.
- [x] Scoped guarded weight deletion, shared dependency and busy-operation handling.
- [x] Guard generation/download/store mutation interactions.
- [x] Reusable model browser dialog, search, module detail/back and selected-model trigger.
- [x] Download/status/delete actions plus exact storage paths and first-use explanation.
- [x] Safe saved-gallery DELETE with explicit artifact/metadata scope.
- [x] Result/library/detail Delete action with confirmation and failure recovery.
- [x] Preserve authenticated preview/download receipts and blob cleanup.

## Verification and delivery
- [x] Backend isolated mutation/lifecycle/security tests.
- [x] Media runtime/modal/mode identity tests.
- [x] Mandatory chat transport/runtime/script gate.
- [x] Route/style/contrast checks.
- [x] Real Chromium: nine routes, mobile/tablet/desktop, light/dark.
- [x] Real Chromium: nested model/weights/output deletion, media/analysis/voice flows.
- [x] Sidebar pointer/keyboard, mobile navigation and Send regression harness.
- [x] Screenshot review; fix negative space, nested hierarchy, overflow and font issues.
- [x] Scoped verified commits fetched/pushed to current tracked branch.
- [x] Record precise evidence and remaining limitations; publishing left to user.

## Evidence / handoff log

- Discovery: three read-only delegated searches, no user-data or runtime mutations. Existing prepare/pull tools may allocate CUDA; dedicated download-only implementation required.
- Baseline source: `cd22526b` on `main` / `origin/main`. Existing unrelated work and concurrent `publish/` changes are outside this task.
- Initial design documents written before production changes. User's later dot-grid reference and nested model explorer / Departure Mono instructions incorporated.

### Implementation in progress

- Model explorer controller implemented with nested catalog/detail views, per-kind selection, explicit cache paths/dependencies, asynchronous download status and scoped deletion confirmation. Shared markup/style integration is underway.
- Generated-media deletion controller captures exact item identity, requires a matching daemon deletion receipt, retains media on failure, and revokes previews after success.
- Gallery pagination now retains existing acquired previews instead of downloading every visible image again. Store inspection is deferred to the model dialog.
- Verification so far: 21 media runtime tests pass; mandatory chat transport/runtime/script gate passes (34 tests). Full backend and Chromium integration remain pending; no live deployment claim.

### Shared interface verification

- All nine page compositions and dynamic Voice/settings controls reconstructed; dialogs and media/voice model selection share module primitives. Local unmodified Departure Mono WOFF2 (22,496 bytes) loads in Chromium; license is embedded and shipped under CLI assets.
- Media runtime now 23 passing tests, including cancel, voice draft preservation and acquired-preview reuse. The seven-suite frontend gate passed 74 tests before adding two extra runtime cases; the route registry also passed its two tests.
- Browser iteration passed 162 fixture checks including four nested voice engines; screenshot review then found and corrected detail centering, irrelevant Chat controls on media pages, and inverse-action hover contrast. Final rerun pending those fixes.
- Navigation/Send browser harness passed all18 checks against source, including short viewport,1106sessions, pointer/keyboard resize/collapse/reopen and light/dark contrast.

### Final source verification

- All planned browser pages, nested model modules, weight inventory/download/cancel/delete and saved-media deletion are implemented. Earlier progress entries above are historical.
- Frontend: 85 passing tests across nine suites, including all three mandatory chat transport/runtime/script suites. Backend/execution: 134 passing tests across twelve suites, overlapping those same 34 transport tests. Combined unique total: **185 tests across eighteen suites**.
- Final isolated Chromium: **168 checks** (nine routes, 1440/768/360 widths, dark/light, generated media playback/download, nested Voice/model modules, shared-weight confirmation, cancellation, gallery deletion and analysis). Sidebar/Send: **18 checks**, including 1,106 fixture sessions. Both use identical production HTML SHA256 `20bd243e434d83bf99d758584796ff1102b58b48868910bbd9dd07db45ae617b`.
- Zero browser page errors, console errors or external requests. Departure Mono and pinned syntax highlighting are bundled locally; provider marks make no favicon requests. Reviewed final desktop Generate and mobile model-dialog screenshots, in addition to the previous page/theme reviews.
- CLI and execution typechecks pass; scoped whitespace checks pass. Existing managed-stop test fixtures emit SIGINT/SIGTERM listener-count warnings; their assertions pass.
- Durable receipts: `docs/work-orders/evidence/dashboard-media-management-20261016.json` and `docs/work-orders/evidence/dashboard-browser-reconstruction-20261016.json`. Reproducible browser scripts build isolated source bundles, without touching shared dist/publish output.
- No live inference, real model downloads/deletions, installed-package changes, daemon restart, or npm publishing. The running 11435 daemon has **not** been updated by this source delivery. Publishing remains with the user.
- Participating media operations serialize per shared store because generation can download or evict weights. External programs and older running versions do not participate. Download-only jobs fetch full pinned repository snapshots; provider-specific TTS/ASR remains separate. Saved-media deletion currently removes the gallery copy and sidecar only, retaining source/work copies.
- **Next phase, explicitly deferred by the user until this delivery:** [media unification TODO](media-unification-TODO.md). It covers shared weights with project-scoped artifacts across browser/TUI sessions, compact generation progress, responsive previews, and audio/video playback. This delivery does not claim that storage/interface unification is complete.

### Git delivery

- Fetched `origin/main` and pushed verified implementation commits `48eef78f` (media management) and `be16ac1b` (dashboard reconstruction) to `origin/main`. Initial design contract was pushed first as `1cc8b037`. Unrelated working-tree and publishing changes were preserved.
