ClaudeDo/docs/superpowers/specs/2026-06-03-daily-prep-live-view-design.md

# Daily Prep — Live Output View + Clear Day — Design

Date: 2026-06-03

## Overview

Two follow-ups to the daily-prep ("Prime Claude") feature:

1. **Live output view.** While Claude prepares the day, there is no feedback. Add a
   live, human-readable view of the prep run's output, shown as a new content mode in
   the existing right-hand **Details island** (mirroring how Daily Notes works — a mode
   swap, not a separate window/column).
2. **Clear Day button.** A MyDay-header button that clears the MyDay selection
   immediately.

## Goals

- See the prep run's progress live, rendered with the same friendly terminal renderer
  used for task runs (assistant text + tool calls like `set_my_day …`, not raw NDJSON).
- Both manual (button) and scheduled prep runs stream into the log.
- The manual button opens the prep view; a scheduled run fills the log silently and is
  opened via a dedicated "Vorbereitungs-Log" button (the existing `PrimeStatus` footer
  remains the hint that a run happened).
- A "Tag leeren" button clears all MyDay tasks (any status) with no confirmation.

## Non-Goals

- No new island/column and no popup/overlay — reuse the Details island as a mode swap.
- No persistence of prep output across app restarts (in-memory log only).
- No undo for Clear Day (re-runnable via "Tag vorbereiten").

## Key Decisions

| Topic | Decision |
| --- | --- |
| Rendering | Reuse the existing `SessionTerminalView` / `StreamLineFormatter` renderer. |
| Location | New `IsPrepMode` content panel inside the Details island (like `IsNotesMode`). |
| Lifecycle | Manual click opens the view (UI-local); `PrepStarted/PrepLine/PrepFinished` events fill the log regardless of current mode; scheduled runs do not auto-open. |
| Open after schedule | Dedicated "Vorbereitungs-Log" header button + existing `PrimeStatus` footer hint. |
| Clear Day scope | All MyDay tasks regardless of status. |
| Clear Day confirm | None — clear directly. |

## Architecture

### Feature A — Live prep output

**Worker**
- Extend `IPrimeBroadcaster` (`src/ClaudeDo.Worker/Prime/Interfaces/IPrimeBroadcaster.cs`)
  with `PrepStartedAsync()`, `PrepLineAsync(string line)`, `PrepFinishedAsync(bool success)`.
- Implement in `HubBroadcaster` (`src/ClaudeDo.Worker/Hub/HubBroadcaster.cs`) sending
  SignalR events `PrepStarted`, `PrepLine` (string), `PrepFinished` (bool).
- `PrimeRunner` (`src/ClaudeDo.Worker/Prime/PrimeRunner.cs`): inject `IPrimeBroadcaster`.
  In `FireAsync`, after the single-flight gate is entered and a run will actually happen:
  call `PrepStartedAsync()` before `RunAsync`; replace the discard lambda with
  `async line => await _broadcaster.PrepLineAsync(line)`; call
  `PrepFinishedAsync(result.IsSuccess)` after. The "already running" early-return path
  emits nothing (no run occurs). Both scheduled and manual runs go through `FireAsync`,
  so both stream.

**UI**
- `WorkerClient` (`src/ClaudeDo.Ui/Services/WorkerClient.cs`): register
  `_hub.On<…>("PrepStarted"/"PrepLine"/"PrepFinished", …)` each via
  `Dispatcher.UIThread.Post`, raising `PrepStartedEvent` / `PrepLineEvent(string)` /
  `PrepFinishedEvent(bool)`. Declare these on `IWorkerClient`.
- `DetailsIslandViewModel`: add `IsPrepMode` (bool), `IsPrepRunning` (bool), a dedicated
  `PrepLog` (`ObservableCollection<LogLineViewModel>`), and `ShowPrep()` (calls
  `Bind(null)`, sets `IsNotesMode=false`, `IsPrepMode=true`). Subscribe to the three prep
  events in the ctor (always active, independent of mode):
  - `PrepStarted` → clear `PrepLog`, `IsPrepRunning=true`.
  - `PrepLine` → format the line with the same `StreamLineFormatter` path used by the
    stdout branch of `OnTaskMessage`, append a `LogLineViewModel` to `PrepLog`.
  - `PrepFinished` → `IsPrepRunning=false` (optionally append a status line).
  Mode exclusivity: the normal task-details panel becomes visible on
  `!IsNotesMode && !IsPrepMode`; `ShowNotes()` also sets `IsPrepMode=false`; `Bind(task)`
  resets both flags.
- `DetailsIslandView.axaml`: add a third `<Panel IsVisible="{Binding IsPrepMode}">` in the
  body grid alongside the existing details/notes panels, rendering `PrepLog` in the
  terminal style (reuse the `LogLineViewModel` item template used by `SessionTerminalView`).

**Wiring**
- `TasksIslandViewModel`: add a `PrepRequested` event (mirror `NotesRequested`).
  `PrepareDayCommand` raises `PrepRequested` in addition to calling
  `RunDailyPrepNowAsync()`. Add `ShowPrepLogCommand` that raises `PrepRequested`. Add the
  "Vorbereitungs-Log" button to the MyDay header (`IsVisible="{Binding IsMyDayList}"`).
- `IslandsShellViewModel`: wire `Tasks.PrepRequested += () => Details.ShowPrep()`.

### Feature B — Clear Day

**Worker**
- `WorkerHub.ClearMyDay()` (`src/ClaudeDo.Worker/Hub/WorkerHub.cs`): query ids where
  `IsMyDay == true`; `ExecuteUpdateAsync` setting `is_my_day = false`; broadcast
  `TaskUpdated(id)` for each affected id (the UI reloads the current list on `TaskUpdated`).

**UI**
- `IWorkerClient.ClearMyDayAsync()` + `WorkerClient` impl invoking `"ClearMyDay"`.
- `TasksIslandViewModel.ClearDayCommand` calls `_worker.ClearMyDayAsync()` (no confirm).
  Add the "Tag leeren" button to the MyDay header next to "Tag vorbereiten".

## Data Flow (live view)

1. Trigger (schedule or button) → `PrimeRunner.FireAsync`.
2. `PrepStartedAsync()` → SignalR `PrepStarted` → `WorkerClient.PrepStartedEvent` →
   `DetailsIslandViewModel` clears `PrepLog`, sets `IsPrepRunning`.
3. Each Claude stdout line → `PrepLineAsync(line)` → `PrepLine` → formatted, appended to
   `PrepLog` (visible if the user is in prep mode; filled silently otherwise).
4. Run ends → `PrepFinishedAsync(success)` → `PrepFinished` → `IsPrepRunning=false`.
5. Manual button click also raised `PrepRequested` → `Details.ShowPrep()` (view open).
   After a scheduled run, the user clicks "Vorbereitungs-Log" to open it.

## Error Handling

- Prep run fails/times out → `PrepFinished(false)`; the existing `PrimeFired` footer
  status still reports failure.
- "Already running" → no prep events emitted (no run happened); existing behavior intact.
- `ClearMyDay` with zero MyDay tasks → no-op, no broadcasts.

## Testing

- Worker: `PrimeRunner` streams `PrepStarted` → N×`PrepLine` → `PrepFinished` (fake
  `IClaudeProcess` invokes `onStdoutLine` with sample lines; fake `IPrimeBroadcaster`
  records calls). `WorkerHub.ClearMyDay` clears all IsMyDay rows and broadcasts per id
  (real SQLite, mirror existing hub tests).
- UI: `DetailsIslandViewModel` appends to `PrepLog` on `PrepLineEvent` and `ShowPrep()`
  sets the mode flags (mutual exclusivity with notes); `TasksIslandViewModel.ClearDayCommand`
  calls `ClearMyDayAsync` (stub worker client).

## Files (high level)

**Modify**
- `src/ClaudeDo.Worker/Prime/Interfaces/IPrimeBroadcaster.cs`
- `src/ClaudeDo.Worker/Hub/HubBroadcaster.cs`
- `src/ClaudeDo.Worker/Prime/PrimeRunner.cs`
- `src/ClaudeDo.Worker/Hub/WorkerHub.cs` (ClearMyDay)
- `src/ClaudeDo.Ui/Services/Interfaces/IWorkerClient.cs`
- `src/ClaudeDo.Ui/Services/WorkerClient.cs`
- `src/ClaudeDo.Ui/ViewModels/Islands/DetailsIslandViewModel.cs`
- `src/ClaudeDo.Ui/Views/Islands/DetailsIslandView.axaml`
- `src/ClaudeDo.Ui/ViewModels/Islands/TasksIslandViewModel.cs`
- `src/ClaudeDo.Ui/Views/Islands/TasksIslandView.axaml`
- `src/ClaudeDo.Ui/ViewModels/IslandsShellViewModel.cs`
- `src/ClaudeDo.Localization/locales/en.json`, `de.json` (button labels)

**Test**
- `tests/ClaudeDo.Worker.Tests/Prime/PrimeRunnerTests.cs`
- `tests/ClaudeDo.Worker.Tests/Hub/…` (ClearMyDay)
- `tests/ClaudeDo.Ui.Tests/…` (DetailsIslandViewModel prep events; TasksIslandViewModel ClearDay) + `StubWorkerClient`

## Known fragility

Changing `IWorkerClient` / `WorkerClient` / VM constructors breaks hand-rolled fakes
(`StubWorkerClient`, `FakeWorkerClient`) in both test projects — update all of them.