@lamemind/loom-deck 0.33.0 → 0.34.0

package/README.md

@@ -45,8 +45,8 @@ Regola unica, senza eccezioni — pensata per reggere l'aggiunta di nuove azioni
 | Tasto | Semantica | Note |
 |---|---|---|
 | `↑` `↓` | naviga nella lista | |
-| `tab` | cambia pane | l'unico tasto che sposta il focus |
-| `←` `→` | cambia **vista** del pane a fuoco | ciclico; il catalogo è l'header stesso |
+| `←` `→` | cambia pane | assoluto, non toggle: `←` = Tasks, `→` = Sessions — la direzione nomina il pane, che è affiancato |
+| `tab` | cambia **vista** del pane a fuoco | ciclico (`shift+tab` indietro); il catalogo è l'header stesso |
 | `⏎` | azione primaria del pane | Tasks → apre il **detail** della task selezionata · Sessions → riprende (`claude --resume`) la sessione selezionata |
 | **MAIUSCOLA** | **apre un modale** | cattura tutti i tasti; `esc` annulla, non esce |
 | minuscola | azione immediata, one-shot | |
@@ -122,7 +122,7 @@ Le azioni non sono un catalogo nuovo: chiamano lo **stesso** percorso di spawn d
 
 Sono bottoni affiancati e non voci di un menu verticale perché è la forma che sopravvive all'arrivo del mouse: un rettangolo ha già coordinate e area cliccabile, una lista di voci andrebbe rifatta.
 
-Dentro il detail `←→` cicla i bottoni invece di cambiare la vista del pane — il
+Dentro il detail `←→` cicla i bottoni invece di cambiare pane, e `tab` non cambia la vista — il
 ramo `useInput` della modalità chiude prima di arrivare a quello di default. Ink non ha focus-trap: la cattura **è** l'ordine dei rami, e cambiare cosa fa un tasto fuori dal detail non tocca cosa fa dentro.
 
 Il catalogo dei prompt vive in `scripts/deck-run`, non nella TUI: è il primitive UI-agnostico, il deck gli passa un **simbolo** (`--prompt-kind`) e non una stringa. Così il testo sta in un posto solo, e con lui il suo vincolo di quoting — il prompt viaggia dentro apici singoli in `bash -lc`, quindi non può contenerne.
@@ -209,7 +209,7 @@ e al riavvio viene ripristinata. File assente o corrotto → default puliti.
 ## L'header è un selettore di vista
 
 Ogni segmento dell'header nomina un sottoinsieme che il deck sa già calcolare.
-`←`/`→` lo rendono **raggiungibile**: la voce attiva si evidenzia in video
+`tab` lo rende **raggiungibile**: la voce attiva si evidenzia in video
 inverso e la lista sotto mostra quel sottoinsieme.
 
 ```

package/dist/cli.js

@@ -628,7 +628,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     // modale: la lista si aggiorna dal vivo, quindi `esc` deve poter ripristinare.
     const [view, setView] = useState(() => loadView(cwd));
     const [viewBackup, setViewBackup] = useState(null);
-    // T100 — vista attiva di ciascun pane, navigata con ←/→. VOLATILE per
+    // T100 — vista attiva di ciascun pane, navigata con `tab`. VOLATILE per
     // decisione (D3 create): non entra in `deck-view.json`, il deck riapre sempre
     // su `Tasks` e su `{parent}`. Il criterio è il rischio di leggere una lista
     // parziale credendola completa — un filtro salvato lo si è scelto, una vista
@@ -990,7 +990,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     // messaggi a mano. `verb` è l'unica cosa che cambia fra i due usi.
     function selectedTaskOr(keyLabel, verb) {
         if (focus !== 'tasks') {
-            setNote(`${keyLabel} → ${verb}: seleziona una task (tab per il pane)`);
+            setNote(`${keyLabel} → ${verb}: seleziona una task (← per il pane)`);
             return null;
         }
         // T59 — la guardia è "non è una task", non "è spot": le righe meta sono due
@@ -1241,7 +1241,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         else
             setSel(paneTasks[next - META_ROWS]?.id ?? SPOT);
     }
-    // T100 — ←/→ navigano il catalogo viste del pane in focus. Il reset della
+    // T100 — `tab` naviga il catalogo viste del pane in focus. Il reset della
     // selezione è la regola letterale «prima riga in alto», senza eccezioni: sul
     // pane task è `ROW_ALL` (D2 preflight — le righe meta non si saltano, e il
     // parent delle sessioni che torna a `tutte` è un effetto accettato); sul pane
@@ -1669,7 +1669,10 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         // selezione per ognuna. Sta PRIMA del ramo di default per la stessa ragione
         // di reader e ricerca — Ink non ha focus-trap, quindi la cattura È l'ordine
         // dei rami — e il `return` in fondo è ciò che impedisce a `←→` di cambiare
-        // pane mentre muove fra le azioni: qui quel binding non esiste più.
+        // pane mentre muove fra le azioni: qui quel binding non esiste più. Cade lì
+        // anche `tab`, cioè il cambio vista: dentro il detail nessuno dei due tasti
+        // di navigazione del pane risponde, e non è un'eccezione da ricordare per
+        // ognuno — è il `return` che chiude tutto il ramo di default in una volta.
         // È anche prima del ramo CTRL, quindi `^K`/`^P`/`^R` restano acceleratori
         // della sola lista: chi è già nel detail ha i bottoni.
         if (mode === 'detail') {
@@ -1794,16 +1797,22 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             return;
         }
         if (key.tab) {
-            // T100 — `tab` resta l'unico tasto che sposta il focus fra i due pane. Le
-            // frecce orizzontali facevano lo stesso lavoro (due tasti per un'azione)
-            // mentre la navigazione DENTRO un pane non ne aveva nessuno: ora sono il
-            // selettore di vista dell'header. Il ramo `mode === 'detail'`, anteposto e
-            // chiuso da `return`, non è più l'eccezione a «cambia pane» ma a «cambia
-            // vista» — l'ordine dei rami non cambia, cambia cosa cattura.
-            setFocus((f) => (f === 'tasks' ? 'sessions' : 'tasks'));
+            // `tab` cicla la VISTA del pane a fuoco, `←→` spostano il focus fra i due
+            // pane: il criterio dell'assegnazione è spaziale. Una freccia orizzontale
+            // porta con sé una direzione e i pane sono affiancati (task a sinistra,
+            // sessioni a destra), quindi il tasto NOMINA il pane invece di limitarsi
+            // a scambiarlo; un catalogo ciclico non ha un verso da rispettare, e un
+            // tasto solo gli basta. `shift+tab` (backtab, `[Z`) scorre a rovescio — il
+            // verso che un tasto singolo non esprime sta nel modificatore, e su cinque
+            // voci risparmia quattro pressioni.
+            cycleView(key.shift ? -1 : 1);
         }
         else if (key.leftArrow || key.rightArrow) {
-            cycleView(key.leftArrow ? -1 : 1);
+            // Binding ASSOLUTO, non toggle: `←` porta sempre sui task e `→` sempre
+            // sulle sessioni, quindi ripremere lo stesso tasto non riporta indietro.
+            // È ciò che lo rende spaziale — la direzione indica una destinazione, e
+            // con due soli pane un toggle sarebbe indistinguibile solo per caso.
+            setFocus(key.leftArrow ? 'tasks' : 'sessions');
         }
         else if (key.upArrow) {
             if (focus === 'tasks')
@@ -1880,7 +1889,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             // Vive solo sul pane sessioni: il fork ha per oggetto una conversazione,
             // e senza focus lì non ce n'è una selezionata su cui agire.
             if (focus !== 'sessions') {
-                setNote('f → fork: seleziona una sessione (tab per il pane)');
+                setNote('f → fork: seleziona una sessione (→ per il pane)');
             }
             else {
                 const s = selSessionObj;
@@ -1912,7 +1921,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             // pinnata STALE (l'unico modo di spinnarla). Scrive il sidecar e ricarica
             // subito, senza attendere il tick del poll.
             if (focus !== 'sessions') {
-                setNote('p → pin: seleziona una sessione (tab per il pane)');
+                setNote('p → pin: seleziona una sessione (→ per il pane)');
             }
             else if (!selSessionId) {
                 setNote('p → nessuna sessione da pinnare');
@@ -1940,7 +1949,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             // su una pinnata STALE, perché annotare «questa non c'è più, era X» è
             // proprio il caso in cui una nota serve.
             if (focus !== 'sessions') {
-                setNote('N → nota: seleziona una sessione (tab per il pane)');
+                setNote('N → nota: seleziona una sessione (→ per il pane)');
             }
             else if (!selSessionId) {
                 setNote('N → nessuna sessione da annotare');
@@ -1958,7 +1967,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             // il binding è nostro, il transcript è di CC — riassegnare una
             // conversazione il cui transcript non c'è più resta legittimo.
             if (focus !== 'sessions') {
-                setNote('A → assegna: seleziona una sessione (tab per il pane)');
+                setNote('A → assegna: seleziona una sessione (→ per il pane)');
             }
             else if (!selSessionId) {
                 setNote('A → nessuna sessione da assegnare');
@@ -2513,7 +2522,7 @@ function AssignScreen({ sessionId, label, current, filter, rows, selected, match
  * segmento resta il primo a cedere il posto (`↑↓` in coda alle voci navigabili).
  *
  * T100 — la riga non è più informativa: le voci del catalogo sono SELEZIONABILI
- * con ←/→, e l'attiva si distingue in video inverso (D5 — costa 0 colonne e non
+ * con `tab`, e l'attiva si distingue in video inverso (D5 — costa 0 colonne e non
  * entra in gara con la semantica di colore già occupata). Le voci ci sono tutte
  * anche a 0 (D1): un catalogo che si accorcia sposta le voci sotto le dita.
  * L'ordine è vincolato — le navigabili PRIMA di `↑N`/`↓N`, che cadono per primi

package/dist/pane-views.js

@@ -1,7 +1,7 @@
 // T100 — Catalogo delle viste dei due pane. L'header smette di essere una riga
 // di contatori e diventa un SELETTORE: ogni segmento che nomina un sottoinsieme
 // calcolabile (`nascoste`, `archiviabili`, `vive`, `📌`, `+più vecchie`) è una
-// vista raggiungibile con ←/→.
+// vista raggiungibile con `tab`.
 //
 // Modulo PURO: nessun import da ink/react, nessun I/O. Il calcolo resta dove
 // stava — `view.ts` per i filtri task, `session-list.ts` per l'assemblaggio a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lamemind/loom-deck",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Deck TUI Ink per-progetto della famiglia loom: legge tasks.md e spawna sessioni Claude Code bound via LOOM_TASK",
   "type": "module",
   "bin": {