feat(tui): command palette and overlay compositor (#71, #59)

CHANGELOG.md

@@ -11,6 +11,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - The report screen now draws a per-day sparkline of the selected range, with
   idle days rendered as gaps rather than as low bars (#80).
+- Command palette (`ctrl+p`): a fuzzy action launcher that floats over the current screen,
+  offering both that screen's commands and one-step navigation to any other (#71).
+- An overlay compositor: `View()` can now layer a floating box over a screen instead of
+  replacing it (#59).
 
 ### Changed
 

README.it.md

@@ -28,8 +28,9 @@
 Provala senza account ClickUp: **`CLICKUP_DEMO=1 clup`** avvia una modalità demo con dati
 fittizi — che include anche il modello di fatturazione: split billable/non billable, due
 valute di fatturazione, voci taggate e un budget per lista. Il GIF è registrato con
-[vhs](https://github.com/charmbracelet/vhs) da [`docs/demo.tape`](docs/demo.tape) (lancia
-`vhs docs/demo.tape` per rigenerarlo).
+[vhs](https://github.com/charmbracelet/vhs) da [`docs/demo.tape`](docs/demo.tape); rigeneralo
+con un binario compilato in locale e un `PATH` temporaneo, senza installare nulla —
+`go build -o /tmp/clupdemo/clup ./cmd/clup && PATH=/tmp/clupdemo:$PATH vhs docs/demo.tape`.
 
 ## Requisiti
 
@@ -125,6 +126,11 @@ prima, così le colonne numeriche e l'importo restano leggibili. Sopra la tabell
 sparkline giornaliera mostra a colpo d'occhio l'andamento del periodo — un giorno
 senza ore registrate appare come un vuoto, non come una barra.
 
+Premi `ctrl+p` da qualunque schermata per aprire la **command palette**: un launcher
+fuzzy che galleggia sopra quello che stai guardando. Scrivi qualche lettera e premi
+`Enter` — offre i comandi della schermata corrente (gli stessi che il footer annuncia,
+con i loro tasti) più la navigazione in un passo verso qualunque altra schermata.
+
 ### Comandi nella TUI
 
 Ogni schermata mostra un footer con i tasti che accetta in quel momento, generato

README.md

@@ -28,8 +28,9 @@
 Try it yourself without a ClickUp account: **`CLICKUP_DEMO=1 clup`** runs a demo mode with
 fixture data — including the billing model: a billable/non-billable split, two invoicing
 currencies, tagged entries, and a per-list budget. The GIF is recorded with
-[vhs](https://github.com/charmbracelet/vhs) from [`docs/demo.tape`](docs/demo.tape) (run
-`vhs docs/demo.tape` to regenerate).
+[vhs](https://github.com/charmbracelet/vhs) from [`docs/demo.tape`](docs/demo.tape); regenerate
+it with a locally built binary on a temporary `PATH`, without installing anything —
+`go build -o /tmp/clupdemo/clup ./cmd/clup && PATH=/tmp/clupdemo:$PATH vhs docs/demo.tape`.
 
 ## Requirements
 
@@ -121,6 +122,11 @@ the label column gives up its space first, so the numeric and amount columns kee
 their footing. Above the table, a per-day sparkline shows the shape of the period at a
 glance — a day with no logged hours renders as a gap, not a bar.
 
+Press `ctrl+p` from any screen to open the **command palette**: a fuzzy launcher that
+floats over whatever you're looking at. Type a few letters and press `Enter` — it offers
+the current screen's own commands (the same ones the footer advertises, with their keys)
+plus one-step navigation to any other screen.
+
 ### TUI commands
 
 Every screen shows a footer with the keys it currently accepts, generated directly

docs/demo.tape

@@ -1,11 +1,13 @@
 # docs/demo.tape — vhs script for the README demo GIF.
 #
-# Generate:  vhs docs/demo.tape        (writes docs/demo.gif)
 # Install vhs: https://github.com/charmbracelet/vhs   (brew install vhs)
 #
 # Uses the built-in demo mode (CLICKUP_DEMO=1): fixture data, no ClickUp
-# account or token needed, so the GIF is fully reproducible. Requires the
-# `clup` binary on PATH (go install ./cmd/clup).
+# account or token needed, so the GIF is fully reproducible.
+#
+# Regenerate with a locally built binary, without installing anything:
+#   go build -o /tmp/clupdemo/clup ./cmd/clup
+#   PATH=/tmp/clupdemo:$PATH vhs docs/demo.tape
 #
 # NOTE: re-run `vhs docs/demo.tape` after ANY change to what a screen
 # renders. The v1.9 design system makes this easy to forget: the key footer
@@ -53,6 +55,16 @@ Sleep 700ms
 Enter
 Sleep 2500ms
 
+# Command palette (#71): ctrl+p opens a fuzzy launcher that floats over the
+# report; type a few letters to filter, then dismiss without picking anything
+# so the report underneath is untouched for the grouping cycle that follows
+Ctrl+P
+Sleep 1s
+Type "exp"
+Sleep 1500ms
+Escape
+Sleep 500ms
+
 # Cycle the grouping: total -> task -> list -> day -> tag (v1.7: the summary
 # line, billable/non-billable split and per-currency subtotals sit below the
 # bucket rows on every grouping — the pause after the last "g" lets a viewer