> **TRACKING EPIC. Do not build from this issue: build the slices below.** Order is pain-first (decision 7). ## Why The dashboard is being replaced by the Workbench (ADR 0001, `workflow/interface-redesign.md` D1-D18, `workflow/interface-spec.md`). This epic is the result of the 2026-10-12 slicing grill: every slice is a small, independently testable vertical unit. ## Decided in the grill (Nathan, 2026-10-12) 1. **Research-channels management is in v1, kept thin** (feeds editor S2, staged review L2); expand in v2. 2. **Slice 1 is a walking skeleton plus one slice per Settings section**; more, smaller issues are worth it. 3. **The SQLite store is introduced in the skeleton with only `ui_state`**, with numbered migrations; slice 5 adds its tables later. 4. **Browser smoke tests are a required CI job** (`browser-smoke`) for UI changes. 5. **Skeleton conventions confirmed:** layout `scripts/dashboard_static/next/`, URL shape, dark-first tokens, Sort control, wired tests, `node:test`. 6. **One cut-over, at parity with the old dashboard** (D18 amended): slices S, L, T, P and X1-X5 first, then the old dashboard is deleted. Run infrastructure, the Ask panel, Agents traces and costs, and the Lab (spec slices 5-8) land after the switch, each with its own grill (their Defaults depend on V1-V8). 7. **Build order is pain-first:** S1, then S2 (feeds editor), L1, L2 (staged review), the remaining Settings sections, Today, Projects, then X1-X3 and X5, then X4. 8. **Config is one system** (grill, 2026-10-12): tracked `tool-chest.toml` = shared defaults, never written by the UI; everything the UI edits is private in `<data_root>/config/` (one file per component plus a master for global settings; the roll-up is a computed view); a standard envelope with typed `kind` blocks; secrets are Keychain references, never values (v2: secure handling of all config from the localhost UI); feeds stay in `feeds.toml`; forms are schema-driven. Built in **C0 (#141)**; everything migrated and the old paths deleted in **C1 (#142)**. 9. **Order revised:** S1, **C0**, S2 (feeds editor and limits), L1, L2 (staged review), **C1**, then S3-S9, then Today, Projects, X1-X3 and X5, then X4. S5 and S8 (which edit config) are built after C1. ## Slices - [ ] #114 Workbench S1: walking skeleton (shell, ui_state store, Services & health, browser-smoke CI) - [ ] #115 Workbench S3: Settings -> Agent clients - [ ] #116 Workbench S4: Settings -> Project connections matrix - [ ] #117 Workbench S5: Settings -> Code library (source root, categories) - [ ] #118 Workbench S6: Settings -> First-run setup - [ ] #119 Workbench S7: Settings -> Security (live checks) - [ ] #120 Workbench S8: Settings -> OmniRoute (status and enable) - [ ] #121 Workbench S9: Settings -> run `make check` - [ ] #122 Workbench L1: Library skeleton, Find, and Read (Research, Books, Agent wiki, Patterns) - [ ] #123 Workbench L3: Library -> Skills and MCP servers - [ ] #124 Workbench L4: Library -> Code library freshness, drift and update - [ ] #125 Workbench L5: Library -> Code library Ingest, repos stage - [ ] #126 Workbench L6: Library -> Code library Ingest, proposals stage (accept and prune) - [ ] #127 Workbench T1: Today frame, summary line and Needs attention - [ ] #128 Workbench T2: Today -> Commitments - [ ] #129 Workbench T3: Today -> Where you left off - [ ] #130 Workbench T4: Today -> Inbox - [ ] #131 Workbench T5: Today -> Glance column - [ ] #132 Workbench P1: Projects -> index table and New project - [ ] #133 Workbench P2: Projects -> hub header, Repository and Agent connections cards - [ ] #134 Workbench P3: Projects -> hub PKM object, Commitments and Relevant patterns - [ ] #135 Workbench P4: Projects -> hub Lab experiments and Agent runs cards (empty states) - [ ] #136 Workbench X1: command palette (⌘K), navigation and project switch - [ ] #137 Workbench X2: Capture (⌘K action and form, text and voice) - [ ] #138 Workbench X3: Automations page - [ ] #139 Workbench X5: Harnesses catalog - [ ] #143 Workbench X6: Today -> Tasks page (completed tasks, un-complete, space picker) - [ ] #144 Workbench X7: Settings -> Capabilities overview (live area health, counts) and the layout check - [ ] #140 Workbench X4: switch over, delete the old dashboard and the prototype - [ ] #111 S2 Research channels: feeds editor and poll now (existing) - [ ] #112 L2 Staged review: review all, select, promote or delete (existing) - [ ] #141 C0 Config framework (private layered config, schema-driven forms, secret refs) - [ ] #142 C1 Migrate every component to the config system and delete the old paths ## Old dashboard to new home (the parity table X4 checks) | Old dashboard section | New home | Slice | |---|---|---| | Tasks | Today -> Commitments, Today -> Tasks | T2, X6 | | Inbox | Today -> Inbox (read), Capture (file) | T4, X2 | | Voice | Capture | X2 | | Automations | Automations page | X3 | | Projects | Projects | P1 to P4 | | Search | Library -> Find | L1 | | Skills, MCP | Library -> Skills and MCP; Settings -> Agent clients | L3, S3 | | Code library (source root, freshness, repos, review queue, categories, accepted tools) | Library and Settings | S5, L4, L5, L6 | | OmniRoute | Settings -> OmniRoute | S8 | | make check | Settings -> run make check | S9 | | Harnesses | Harnesses catalog | X5 | | Health and capabilities (the ring) | Settings -> Services & health, Settings -> Capabilities, Settings -> Security (layout), Today | S1, T1, X7 | ## How to build (applies to every slice) - **TDD.** Write the failing test first and watch it fail *for the stated reason* (calibrate it: a test that has never failed asserts nothing). Make it pass with the least code, then refactor. A CI failure from code your new tests are the first to exercise is not scope creep: fix it in the same MR. - **Then run `/backpass`** on the result: the forward pass solves the problem, the backward pass strips it to its essential form (dead code, over-abstraction, convoluted control flow). The MR description says what the backward pass removed. - **Reproduce CI before pushing** anything environment-sensitive (a clean `git archive` export with a minimal `PATH`). ## Done when Every slice is closed, X4 has switched `/` to the new shell and deleted the old dashboard, and the spec (§11, §12) matches this epic.