@lamemind/loom-deck 0.21.0 → 0.21.2

package/README.md

@@ -83,18 +83,40 @@ Assegnazioni correnti:
 | immediata | `^P` | spawna la task selezionata sul **preflight** |
 | immediata | `^R` | spawna la task selezionata in **esecuzione** |
 | immediata | `f` | **forka** la sessione selezionata (solo col focus sul pane Sessions) |
-| immediata | `t` | terminale @project-root (surface standard launch) |
-| immediata | `c` | sessione Claude **nuda**: nessuna task, nessun prompt iniziale |
+| immediata | `t` 💻 | terminale @project-root (surface standard launch) |
+| immediata | `c` 🤖 | sessione Claude **nuda**: nessuna task, nessun prompt iniziale |
 | immediata | `w` | salva la vista corrente su disco |
 | launch | `1`…`9` | esegue il `command` della voce, con `cwd` = project root |
 
-Le voci `launch` sono elencate in una **riga di legenda** sotto il footer
-(`launch 1 📝 codium · 2 ☕ idea`): l'indice da solo è opaco, perché le voci sono
-custom per-progetto e non hanno una lettera fissa per app. Se non entrano in
-larghezza, la legenda si ferma a voci intere e mostra il contatore di quelle
-fuori riga — mai un troncamento silenzioso. Il cap a `9` è imposto dai tasti-cifra,
-non dallo schema: un progetto può dichiarare più di 9 voci, quelle oltre la nona
-sono configurate ma non raggiungibili (e la legenda lo dice).
+Il footer è **due righe con due nature diverse**:
+
+```
+⏎/^K/^P/^R spawn · ^F cerca · C nuova · E edit · S sort · F filtri · w salva
+t 💻 · c 🤖 · 1 📝 codium · 2 ☕ idea
+```
+
+- **tasti** — cosa puoi fare *qui e ora*. Solo le voci attive: quelle contestuali
+  compaiono quando il pane a fuoco le rende possibili e altrimenti spariscono,
+  invece di mostrarsi inerti. Fuori navigazione (`↑↓` `←→`), uscita (`q`) e
+  indicatore `focus:` — le prime due sono universali in qualunque TUI, il pane a
+  fuoco si vede già dall'evidenziazione.
+- **surface** — *dove* puoi aprire qualcosa: prima le due built-in (`t`/`c`), poi
+  le voci `launch` del progetto. Stanno insieme perché hanno la stessa natura —
+  fire-once, `cwd` = project root, nessuno stato — e differiscono solo per essere
+  universali invece che custom.
+
+L'indice da solo è opaco (le `launch` sono custom per-progetto, senza una lettera
+fissa per app), quindi la riga espone la mappa e non il conteggio. Se non entrano
+in larghezza, si ferma a voci intere e mostra il contatore di quelle fuori riga —
+mai un troncamento silenzioso; le celle delle due built-in sono riservate a monte,
+o le voci sfonderebbero il box di quel tanto. Il cap a `9` è imposto dai
+tasti-cifra, non dallo schema: un progetto può dichiarare più di 9 voci, quelle
+oltre la nona sono configurate ma non raggiungibili (e la riga lo dice).
+
+Le emoji sono quelle del menu compass. Per il terminale compass usa 🖥️, che nel
+frame Ink non sopravvive: `sanitize` lo sostituisce perché VTE lo disegna largo 1
+mentre `string-width` ne conta 2 (invariante ① di `src/width.ts`) — 💻 è il
+gemello concorde.
 
 `t` e `c` sono gemelle: entrambe aprono una surface del cappello nella stessa
 finestra Ptyxis, senza passare da un modale. `c` (minuscola, azione) e `C`

package/dist/cli.js

@@ -13,7 +13,7 @@ import { discoverProjectSessions } from './sessions.js';
 import { buildRows, firstRowKey, moveRowSelection, rowIndexOfKey, searchSessions, selectedRow, DEFAULT_OPTIONS, MIN_QUERY, } from './search.js';
 import { appendNote, appendPin, appendSessionRecord, appendTaskBinding, loadSessionIndex, } from './task-index.js';
 import { assembleSessionList, firstSelectableId, moveSelection, rowIndexOf, rowLabel, selectedSession, stripProjectCore, } from './session-list.js';
-import { launchLegend, loadIdentity, loadLaunch } from './config.js';
+import { cellWidth, launchLegend, loadIdentity, loadLaunch } from './config.js';
 import { isCompact, layoutBudget, readerCapacity, searchListCapacity, searchPreviewCapacity, windowRange, } from './viewport.js';
 import { caretWindow, cut, sanitize, termWidth, wrapLines, wrapWithOffsets, } from './width.js';
 import { applyView, cycleSort, describeSort, priName, progName, toggleHidden, PRI_ENTRIES, PROG_ENTRIES, } from './view.js';
@@ -1355,9 +1355,38 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     // T50 — il pin agisce su qualunque riga selezionata (anche stale, per
     // spinnarla); basta il focus sul pane e una selezione.
     const canPin = focus === 'sessions' && selSessionId !== null;
+    // Le due surface built-in del cappello stanno in testa alla riga launch, non
+    // fra i tasti: hanno la stessa natura delle voci `launch` — fire-once, cwd =
+    // project root, nessuno stato — e la differenza è solo che sono universali
+    // (nessun progetto le dichiara) invece che custom. Emoji del menu compass:
+    // 🤖 = nuova sessione claude. Per il terminale compass usa 🖥️, che nel frame
+    // Ink NON passa — `sanitize` lo sostituisce (VTE lo disegna largo 1,
+    // string-width dice 2: discordante, invariante ① di width.ts) e resterebbe un
+    // `·` muto. 💻 è il gemello concorde; il `sanitize` qui rende il vincolo
+    // automatico invece che da ricordare.
+    const surfaceLegend = sanitize('t 💻 · c 🤖');
     // Larghezza dal medesimo hook che dà l'altezza: dopo un resize la legenda si
-    // ricalcola con lo stesso re-render che ridimensiona i pane.
-    const legend = launchLegend(launch, columns);
+    // ricalcola con lo stesso re-render che ridimensiona i pane. Le celle delle
+    // surface (più il ` · ` che le separa dalle voci) sono già spese sulla riga →
+    // vanno riservate, o le voci launch la sfonderebbero di quel tanto.
+    const legend = launchLegend(launch, columns, cellWidth(surfaceLegend) + 3);
+    // Legenda della modalità normale. Elenca SOLO i tasti che fanno qualcosa qui e
+    // ora: le voci contestuali compaiono quando il pane a fuoco le rende possibili
+    // e altrimenti spariscono, invece di annunciarsi inerti con un `—`.
+    // Fuori: navigazione (`↑↓` `←→`) e uscita (`q`), universali in qualunque TUI, e
+    // l'indicatore `focus:` — il pane a fuoco si vede già dall'evidenziazione, e
+    // ridirlo a parole costava colonne su una riga che tronca in silenzio.
+    const keyLegend = sanitize([
+        ...(canSpawn ? ['⏎/^K/^P/^R spawn'] : canResume ? ['⏎ resume'] : []),
+        ...(canResume ? ['f fork'] : []),
+        ...(canPin ? ['p pin', 'N nota'] : []),
+        '^F cerca',
+        'C nuova',
+        'E edit',
+        'S sort',
+        'F filtri',
+        'w salva',
+    ].join(' · '));
     // ── T52 · schermate sostitutive ─────────────────────────────────────────
     // Ricerca e reader sono gli unici modali che NON stanno in flusso sopra i
     // pane: una lista di occorrenze non entra in un box da 4 righe. Prendono
@@ -1408,7 +1437,9 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     // Ptyxis significa un frame intero versato nello scrollback per ogni tick del
     // poll. Tutto ciò che varia in altezza (le due liste e la descrizione del
     // dettaglio) riceve qui la propria capienza.
-    const launchLine = mode === 'normal' && launch.length > 0;
+    // Le surface built-in `t`/`c` la rendono sempre presente in modalità normale:
+    // non dipende più da quante voci `launch` il progetto dichiara.
+    const launchLine = mode === 'normal';
     const detailParts = detail ? detailMetaOf(detail) : null;
     const budget = layoutBudget({
         rows,
@@ -1440,7 +1471,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     if (budget.compact) {
         return (_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { bold: true, color: "cyan", children: "loom-deck" }), _jsxs(Text, { dimColor: true, children: [' ', "\u00B7 ", viewTasks.length, " task \u00B7 sel ", selectedTaskId ?? 'spot', " \u00B7 terminale ", rows, "\u00D7", columns, ": troppo basso, allarga"] })] }));
     }
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "loom-deck" }), mode === 'create' ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["nuova task \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " crea \u00B7 ", _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'sort' ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["sort \u00B7 ", _jsx(Text, { color: "yellow", children: "p" }), " pri ", _jsx(Text, { color: "yellow", children: "s" }), " stato", ' ', _jsx(Text, { color: "yellow", children: "i" }), " id (asc\u2192desc\u2192off) \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " ok \u00B7", ' ', _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'filter' ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["filtri \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2191\u2193\u2190\u2192" }), " naviga \u00B7 ", _jsx(Text, { color: "yellow", children: "spazio" }), ' ', "mostra/nascondi \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " ok \u00B7 ", _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'note' ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["nota conversazione \u00B7 ", _jsx(Text, { color: "yellow", children: "^U" }), " svuota \u00B7", ' ', _jsx(Text, { color: "yellow", children: "\u23CE" }), " salva (vuoto = rimuove) \u00B7", ' ', _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'edit' ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["edit \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2191\u2193" }), " campo \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2190\u2192" }), " valore, o cursore sul testo \u00B7 ", _jsx(Text, { color: "yellow", children: "^A/^E" }), " inizio/fine \u00B7", ' ', _jsx(Text, { color: "yellow", children: "^D" }), " canc \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " salva+commit \u00B7", ' ', _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["\u2191\u2193 naviga \u00B7 \u2190\u2192 pane \u00B7", ' ', canSpawn ? '⏎/^K/^P/^R spawn' : canResume ? '⏎ resume' : '⏎ —', canResume ? ' · f fork' : '', canPin ? ' · p pin · N nota' : '', " \u00B7 ^F cerca \u00B7 C nuova \u00B7 E edit \u00B7 S sort \u00B7 F filtri \u00B7 w salva \u00B7 t term \u00B7 c claude \u00B7 q esci \u00B7 focus:", ' ', _jsx(Text, { color: "cyan", children: focus })] })), mode === 'normal' && launch.length > 0 ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["launch ", legend.shown, legend.overflow > 0 ? (_jsxs(Text, { color: "yellow", children: [" \u00B7 +", legend.overflow, " fuori riga"] })) : null, legend.unreachable > 0 ? (_jsxs(Text, { color: "yellow", children: [" \u00B7 ", legend.unreachable, " oltre la 9\u00AA (non raggiungibili)"] })) : null] })) : null, mode === 'create' ? (_jsxs(Box, { borderStyle: "round", borderColor: "yellow", paddingX: 1, marginTop: 1, children: [_jsx(Text, { color: "yellow", children: "C \u203A " }), _jsx(Text, { children: draft }), _jsx(Text, { inverse: true, children: " " })] })) : null, mode === 'note' ? (_jsxs(Box, { borderStyle: "round", borderColor: "yellow", paddingX: 1, marginTop: 1, children: [_jsx(Text, { color: "yellow", children: "\u270E \u203A " }), _jsx(Text, { children: noteDraft }), _jsx(Text, { inverse: true, children: " " })] })) : null, mode === 'sort' ? _jsx(SortModal, { sort: view.sort }) : null, mode === 'filter' ? _jsx(FilterModal, { view: view, cursor: filterCursor }) : null, mode === 'edit' && edit && selTask ? (_jsx(EditModal, { id: selTask.id, draft: edit, row: editRow, columns: columns })) : null, _jsxs(Box, { flexDirection: "row", marginTop: 1, children: [_jsx(TasksPane, { tasks: windowTasks, filtered: viewTasks.length, total: tasks.length, hidden: hiddenTasks, view: view, selected: selIndex, spotCount: spotCount, childCount: childCount, focused: focus === 'tasks', loadError: loadError, detail: detail, windowStart: taskWin.start, above: taskWin.start, below: viewTasks.length - taskWin.end, detailLines: budget.detailLines, columns: columns }), _jsx(SessionsPane, { parentLabel: parentLabel, isSpot: isSpot, rows: windowRows, total: assembled.pinnedCount + assembled.contextTotal, pinnedCount: assembled.pinnedCount, hidden: assembled.contextHidden, selectedId: selSessionId ?? undefined, focused: focus === 'sessions', above: sessionWin.start, below: sessionRows.length - sessionWin.end, detail: budget.sessionDetail ? selSessionObj : null, firstLines: budget.sessionFirstLines, lastLines: budget.sessionLastLines, columns: columns, forkOf: forkOf, sessionNotes: sessionNotes, projectCore: projectCore })] }), note ? _jsx(Text, { color: "green", wrap: "truncate-end", children: sanitize(note) }) : null] }));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "loom-deck" }), mode === 'create' ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["nuova task \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " crea \u00B7 ", _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'sort' ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["sort \u00B7 ", _jsx(Text, { color: "yellow", children: "p" }), " pri ", _jsx(Text, { color: "yellow", children: "s" }), " stato", ' ', _jsx(Text, { color: "yellow", children: "i" }), " id (asc\u2192desc\u2192off) \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " ok \u00B7", ' ', _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'filter' ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["filtri \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2191\u2193\u2190\u2192" }), " naviga \u00B7 ", _jsx(Text, { color: "yellow", children: "spazio" }), ' ', "mostra/nascondi \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " ok \u00B7 ", _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'note' ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["nota conversazione \u00B7 ", _jsx(Text, { color: "yellow", children: "^U" }), " svuota \u00B7", ' ', _jsx(Text, { color: "yellow", children: "\u23CE" }), " salva (vuoto = rimuove) \u00B7", ' ', _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'edit' ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["edit \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2191\u2193" }), " campo \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2190\u2192" }), " valore, o cursore sul testo \u00B7 ", _jsx(Text, { color: "yellow", children: "^A/^E" }), " inizio/fine \u00B7", ' ', _jsx(Text, { color: "yellow", children: "^D" }), " canc \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " salva+commit \u00B7", ' ', _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : (_jsx(Text, { dimColor: true, wrap: "truncate-end", children: keyLegend })), mode === 'normal' ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [surfaceLegend, legend.shown ? ` · ${legend.shown}` : '', legend.overflow > 0 ? (_jsxs(Text, { color: "yellow", children: [" \u00B7 +", legend.overflow, " fuori riga"] })) : null, legend.unreachable > 0 ? (_jsxs(Text, { color: "yellow", children: [" \u00B7 ", legend.unreachable, " oltre la 9\u00AA (non raggiungibili)"] })) : null] })) : null, mode === 'create' ? (_jsxs(Box, { borderStyle: "round", borderColor: "yellow", paddingX: 1, marginTop: 1, children: [_jsx(Text, { color: "yellow", children: "C \u203A " }), _jsx(Text, { children: draft }), _jsx(Text, { inverse: true, children: " " })] })) : null, mode === 'note' ? (_jsxs(Box, { borderStyle: "round", borderColor: "yellow", paddingX: 1, marginTop: 1, children: [_jsx(Text, { color: "yellow", children: "\u270E \u203A " }), _jsx(Text, { children: noteDraft }), _jsx(Text, { inverse: true, children: " " })] })) : null, mode === 'sort' ? _jsx(SortModal, { sort: view.sort }) : null, mode === 'filter' ? _jsx(FilterModal, { view: view, cursor: filterCursor }) : null, mode === 'edit' && edit && selTask ? (_jsx(EditModal, { id: selTask.id, draft: edit, row: editRow, columns: columns })) : null, _jsxs(Box, { flexDirection: "row", marginTop: 1, children: [_jsx(TasksPane, { tasks: windowTasks, filtered: viewTasks.length, total: tasks.length, hidden: hiddenTasks, view: view, selected: selIndex, spotCount: spotCount, childCount: childCount, focused: focus === 'tasks', loadError: loadError, detail: detail, windowStart: taskWin.start, above: taskWin.start, below: viewTasks.length - taskWin.end, detailLines: budget.detailLines, columns: columns }), _jsx(SessionsPane, { parentLabel: parentLabel, isSpot: isSpot, rows: windowRows, total: assembled.pinnedCount + assembled.contextTotal, pinnedCount: assembled.pinnedCount, hidden: assembled.contextHidden, selectedId: selSessionId ?? undefined, focused: focus === 'sessions', above: sessionWin.start, below: sessionRows.length - sessionWin.end, detail: budget.sessionDetail ? selSessionObj : null, firstLines: budget.sessionFirstLines, lastLines: budget.sessionLastLines, columns: columns, forkOf: forkOf, sessionNotes: sessionNotes, projectCore: projectCore })] }), note ? _jsx(Text, { color: "green", wrap: "truncate-end", children: sanitize(note) }) : null] }));
 }
 const SORT_UI = { pri: 'pri', prog: 'stato', id: 'id' };
 // Modali resi IN FLUSSO (come l'input box di create), non in overlay assoluto:

package/dist/config.js

@@ -66,12 +66,17 @@ export function cellWidth(s) {
 // custom per-progetto, non hanno una lettera fissa per app), quindi la resa deve
 // esporre la mappa, non il conteggio. Degradazione mai silenziosa: ciò che non
 // entra in larghezza finisce in un contatore esplicito, non troncato a metà.
-export function launchLegend(entries, columns) {
+// `reserved` = celle già occupate sulla stessa riga da chi la renderizza (le
+// surface built-in `t`/`c`, che precedono le voci). Parametro e non aritmetica
+// sul chiamante: `columns` significa "colonne del terminale" e passargliene di
+// meno per fargli credere a uno schermo più stretto renderebbe il calcolo
+// illeggibile al primo che lo rilegge.
+export function launchLegend(entries, columns, reserved = 0) {
     const reachable = entries.slice(0, LAUNCH_MAX);
     const unreachable = entries.length - reachable.length;
-    // bordo + padding del box + prefisso "launch " ≈ 12 celle; pavimento a 24 per
+    // bordo + padding del box ≈ 4 celle, più 2 di margine; pavimento a 24 per
     // non degenerare a legenda vuota su terminali strettissimi.
-    const budget = Math.max(24, columns - 12);
+    const budget = Math.max(24, columns - 6 - reserved);
     // I fallback di parseLaunch (`▸` per emoji, command per label) sono già
     // applicati a monte: qui non si re-implementano né si assumono campi popolati.
     const parts = reachable.map((e, i) => `${i + 1} ${e.emoji} ${e.label}`);

package/package.json

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