Terminal Notes · the kolu Atlas

Every terminal — active or sleeping — gets a Markdown notes scratchpad. The catch: the field already exists as intent (surface.ts:255), fully wired. So this is a rename + three surfaces, not a new feature.

The field already ships (left, green). Rename intent→notes — a one-time state.ts migration, title still shows the first line — and add three client surfaces (right, amber).

User-facing description

Notes live in their own Notes tab, with Edit / Preview sub-tabs (like the Code tab) and autosave as you type. When a terminal has notes, a note icon lights up in its title bar (→ the tab), and closing the terminal shows the notes one last time before they’re gone.

InspectorCodeNotes

EditPreview

## TODO

- [ ] fix auth bug

- [ ] ask Sri re: deploy|

●autosaved · debounced

Edit / Preview are sub-tabs — like the Code tab's modes. Edit shown; Preview swaps the pane to the rendered markdown.

apimainTODO✕

A note icon appears once a note has a body — click it → Notes tab. The first line still rides the title as the chip.

Close terminal?

NOTES

TODO

☐ fix auth bug · ☐ ask Sri re: deploy

⎇kolu/public-table

CancelClose terminal

Closing deletes the notes — so the dialog shows them first, read-only, from the frozen snapshot. A last look.

Architecture-level changes


Storage	reuse `intent`, renamed `notes` — persistence already done
Home	dedicated Notes tab + inline editor
Editor	plain `<textarea>` + `@kolu/solid-markdown` preview (Edit / Preview tabs)
Saving	debounced autosave (client → `setNotes` → server’s 500 ms → disk)
On close	deleted with the terminal; the dialog is the reminder
Boundary	leaf — reuses the existing renderer + surface; not a `@kolu/*` package

Reuse, renamed. intent is already persist + autosave + sleep/wake + restore + render. Rename → notes (one state.ts migration); the title still shows the first line as the chip.
New tab arm. Notes becomes a kind in the right-panel tab union (RightPanelTabKindSchema); the editor is extracted once into a shared NotesEditor.
Orchestration stays at the root. CloseConfirm renders the frozen target.meta.notes snapshot, never a live read — the contract that keeps the reminder from shifting under the user. Leaf components get data + callbacks; the editor singleton lives at App.tsx.
A leaf, not an electricity. The axes a notes editor could own are already packages — markdown → safe-HTML is @kolu/solid-markdown, live-state + persistence are @kolu/surface. NotesEditor just plugs into both, like defineMutation / @kolu/commands in the register.

Implementation details

One PR, with a test + visual evidence. In order:

Rename intent → notes across common/server/client + a state.ts migration (idempotent, optional-safe).
Extract NotesEditor (textarea + Edit / Preview sub-tabs) from the modal.
Notes tab — add the notes tab kind (compiler-enforced 3-place union change) + NotesPanel with inline debounced autosave.
Title-bar icon — body-gated NotesIcon → rightPanel.showNotes().
Close-dialog reminder — read-only, off the frozen target.meta.notes snapshot.