@lamemind/loom-deck 0.35.1 → 0.37.0

package/dist/cli.js

@@ -29,6 +29,7 @@ import { useSearchOverlay } from './overlays/search.js';
 import { useSheetOverlay } from './overlays/sheet.js';
 import { useAssignOverlay } from './overlays/assign.js';
 import { captures } from './input-modes.js';
+import { VERSION } from './version.js';
 function Deck({ cwd, tasksPath, tasksDir }) {
     const { exit } = useApp();
     const { tasks, loadError } = useTasks(tasksPath);
@@ -285,17 +286,28 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     // Lo spawn vero, su una task GIÀ risolta. Separato dalla guardia perché il
     // detail passa l'id fotografato all'apertura e non la selezione corrente: la
     // lista lì sotto non è più a schermo, quindi non è più la fonte dell'oggetto.
-    function spawnForTask(id, kind, model, keyLabel) {
+    // T111 — `spawnNote` arriva dal campo sempre attivo del detail ed è vuota per
+    // ogni altro percorso (`^K`/`^P`/`^R` non passano di lì, quindi non hanno da
+    // dove prenderla). Si scrive nel sidecar PRIMA dello spawn, accanto al
+    // binding e per la stessa ragione: la conversazione deve risultare figlia
+    // della task e portare la propria maniglia appena il suo JSONL compare, o per
+    // il tempo di un tick la riga in lista comparirebbe nuda. Due record separati
+    // sullo stesso `sessionId` sono la forma normale di un file append-only
+    // last-wins, non una scrittura da fondere.
+    function spawnForTask(id, kind, model, keyLabel, spawnNote = '') {
         const sid = randomUUID();
         appendTaskBinding(cwd, sid, id);
-        const child = spawnDeck(id, cwd, sid, kind, model);
+        if (spawnNote)
+            appendNote(cwd, sid, spawnNote);
+        const child = spawnDeck(id, cwd, sid, kind, model, spawnNote);
         child.on('error', () => setNote(`⚠ spawn ${id} fallito (${DECK_RUN})`));
         const what = kind === 'none' ? '' : ` · ${kind}`;
         // Il modello è SEMPRE nominato, anche quando è il default: gli acceleratori
         // della lista non passano dal selettore del detail e usano il default fisso
         // (T108 · via a), quindi senza dirlo l'utente crederebbe di aver ereditato
         // la scelta fatta nell'ultimo detail aperto.
-        setNote(`${keyLabel} spawn ${id}${what} · ${model} → tab CC (sid ${sid.slice(0, 8)})`);
+        const named = spawnNote ? ` · «${cut(spawnNote, 24)}»` : '';
+        setNote(`${keyLabel} spawn ${id}${what} · ${model}${named} → tab CC (sid ${sid.slice(0, 8)})`);
     }
     function spawnTaskSession(kind, keyLabel) {
         const task = selectedTaskOr(keyLabel, 'spawnare');
@@ -490,7 +502,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         columns,
         setMode,
         setNote,
-        onAction: (id, kind, model, label) => spawnForTask(id, kind, model, label),
+        onAction: (id, kind, model, spawnNote, label) => spawnForTask(id, kind, model, label, spawnNote),
     });
     const search = useSearchOverlay({
         sessions,
@@ -1023,7 +1035,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         // posizione è lo scroll mosso a mano. Il clamp serve comunque — un resize
         // può accorciare il testo sotto uno scroll già dato.
         const start = Math.min(sheet.top, sheet.maxTop);
-        return (_jsx(DetailScreen, { id: sheet.sheet.id, title: sheet.sheet.title, missing: sheet.sheet.text === null, lines: sheet.lines.slice(start, start + sheet.capacity), spans: sheet.doc?.spans ?? [], top: start, total: sheet.lines.length, capacity: sheet.capacity, action: sheet.action, model: sheet.model, columns: columns, find: sheet.find, occ: sheet.findRes.occ, occCur: sheet.occCur }));
+        return (_jsx(DetailScreen, { id: sheet.sheet.id, title: sheet.sheet.title, missing: sheet.sheet.text === null, lines: sheet.lines.slice(start, start + sheet.capacity), spans: sheet.doc?.spans ?? [], top: start, total: sheet.lines.length, capacity: sheet.capacity, action: sheet.action, model: sheet.model, spawnNote: sheet.spawnNote, columns: columns, find: sheet.find, occ: sheet.findRes.occ, occCur: sheet.occCur }));
     }
     // ── T52 · schermate sostitutive ─────────────────────────────────────────
     // Ricerca e reader sono gli unici modali che NON stanno in flusso sopra i
@@ -1112,9 +1124,9 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     // a una riga sola. Perdere il deck per un terminale basso è meglio che
     // sporcare la cronologia del terminale a ogni poll.
     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 ?? parentLabel, " \u00B7 terminale ", rows, "\u00D7", columns, ": troppo basso, allarga"] })] }));
+        return (_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { bold: true, color: "cyan", children: "loom-deck" }), _jsxs(Text, { dimColor: true, children: [' ', "v", VERSION, " \u00B7 ", viewTasks.length, " task \u00B7 sel ", selectedTaskId ?? parentLabel, " \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"] })) : (_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, counts: taskCounts, activeView: taskViewId, paneCount: paneTasks.length, view: view, selected: selIndex, spotCount: spotCount, allCount: sessions.length, childCount: childCount, focused: focus === 'tasks', loadError: loadError, windowStart: taskWin.start, above: taskWin.start, below: paneTasks.length - taskWin.end, columns: columns }), _jsx(SessionsPane, { parentLabel: parentLabel, isSpot: isSpot, isAll: isAll, bindings: bindings, taskW: sessionCols.task, ageW: sessionCols.age, rows: windowRows, counts: sessionCounts, activeView: sessionViewId, paneCount: sessionRows.length, selectedId: selSessionId ?? undefined, focused: focus === 'sessions', above: sessionWin.start, below: sessionRows.length - sessionWin.end, columns: columns, forkOf: forkOf, sessionNotes: sessionNotes, projectCore: projectCore, live: live })] }), budget.preview && previewKind === 'task' && detail ? (_jsx(PreviewPane, { kind: "task", detail: detail, maxLines: budget.detailLines, columns: columns })) : budget.preview && previewKind === 'session' && selSessionObj ? (_jsx(PreviewPane, { kind: "session", s: selSessionObj, firstLines: budget.sessionFirstLines, lastLines: budget.sessionLastLines, columns: columns, origin: forkOf.get(selSessionObj.sessionId) ?? null, note: sessionNotes.get(selSessionObj.sessionId) ?? '', live: live.get(selSessionObj.sessionId) ?? null })) : null, note ? _jsx(Text, { color: "green", wrap: "truncate-end", children: sanitize(note) }) : null] }));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [_jsxs(Box, { flexDirection: "row", justifyContent: "space-between", children: [_jsx(Text, { bold: true, color: "cyan", children: "loom-deck" }), _jsxs(Text, { dimColor: true, children: ["v", VERSION] })] }), 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, counts: taskCounts, activeView: taskViewId, paneCount: paneTasks.length, view: view, selected: selIndex, spotCount: spotCount, allCount: sessions.length, childCount: childCount, focused: focus === 'tasks', loadError: loadError, windowStart: taskWin.start, above: taskWin.start, below: paneTasks.length - taskWin.end, columns: columns }), _jsx(SessionsPane, { parentLabel: parentLabel, isSpot: isSpot, isAll: isAll, bindings: bindings, taskW: sessionCols.task, ageW: sessionCols.age, rows: windowRows, counts: sessionCounts, activeView: sessionViewId, paneCount: sessionRows.length, selectedId: selSessionId ?? undefined, focused: focus === 'sessions', above: sessionWin.start, below: sessionRows.length - sessionWin.end, columns: columns, forkOf: forkOf, sessionNotes: sessionNotes, projectCore: projectCore, live: live })] }), budget.preview && previewKind === 'task' && detail ? (_jsx(PreviewPane, { kind: "task", detail: detail, maxLines: budget.detailLines, columns: columns })) : budget.preview && previewKind === 'session' && selSessionObj ? (_jsx(PreviewPane, { kind: "session", s: selSessionObj, firstLines: budget.sessionFirstLines, lastLines: budget.sessionLastLines, columns: columns, origin: forkOf.get(selSessionObj.sessionId) ?? null, note: sessionNotes.get(selSessionObj.sessionId) ?? '', live: live.get(selSessionObj.sessionId) ?? null })) : null, note ? _jsx(Text, { color: "green", wrap: "truncate-end", children: sanitize(note) }) : null] }));
 }
 const cwd = process.cwd();
 render(_jsx(Deck, { cwd: cwd, tasksPath: resolveTasksPath(cwd), tasksDir: resolveTasksDir(cwd) }));

package/dist/overlays/sheet.js

@@ -28,6 +28,13 @@ export function useSheetOverlay(deps) {
     // deck: si azzera a ogni apertura come scroll e azione, quindi non esiste una
     // selezione invisibile che cambi il comportamento dei tasti della lista.
     const [model, setModel] = useState(MODEL_DEFAULT);
+    // T111 — la nota con cui nascerà la conversazione. Campo SEMPRE ATTIVO: riceve
+    // la scrittura appena il detail si apre, senza nessun tasto che lo apra, e per
+    // questo si prende l'alfabeto nudo del modo (le cifre del selettore modello,
+    // `g`/`G` degli estremi del testo). Si azzera a ogni apertura come scroll,
+    // azione e modello: una nota armata che sopravvive alla chiusura sarebbe uno
+    // stato invisibile che cambia il titolo dello spawn successivo.
+    const [spawnNote, setSpawnNote] = useState('');
     // T91 — ricerca dentro il detail. `open` distingue i due modi in cui la si
     // lascia: `esc` butta via ciò che il modale ha prodotto (`find` a null,
     // evidenziazione via), `⏎` lo congela e restituisce il controllo allo strato
@@ -77,12 +84,13 @@ export function useSheetOverlay(deps) {
             return;
         setTop(topForOffset(lines, o.start, capacity));
     }, [findRes, occCur, lines, capacity]);
-    /** Apre il detail su una task, azzerando scroll, azione, modello e ricerca. */
+    /** Apre il detail su una task, azzerando scroll, azione, modello, nota e ricerca. */
     function open(next) {
         setSheet(next);
         setTop(0);
         setAction(0);
         setModel(MODEL_DEFAULT);
+        setSpawnNote('');
         setFind(null);
         setOccIdx(0);
         setNote('');
@@ -150,16 +158,32 @@ export function useSheetOverlay(deps) {
     // selezione per ognuna. Il modo cattura TUTTO, acceleratori `^K`/`^P`/`^R`
     // compresi: chi è già nel detail ha i bottoni. L'unica deroga è `^F`, che qui
     // apre la ricerca nel testo invece di quella sulle conversazioni.
+    //
+    // T111 — con il campo nota sempre attivo l'ultimo ramo è la SCRITTURA, quindi
+    // ogni funzione che resta viva deve stare su un tasto che un campo di testo
+    // non contende: `tab`, frecce, `PgUp`/`PgDn`, CTRL, `⏎`, `esc`.
     function onKey(input, key) {
         if (find?.open) {
             onFindKey(input, key);
             return;
         }
-        if (key.ctrl && input === 'f') {
-            // Fuori dal detail `^F` è la ricerca conversazioni; qui è la ricerca nel
-            // testo. La query sopravvive a una chiusura con `⏎`, quindi riaprire
-            // riprende da dov'era invece di ricominciare.
-            setFind((f) => (f ? { ...f, open: true } : { q: '', caret: 0, open: true }));
+        if (key.ctrl) {
+            // Ramo CTRL chiuso in testa, e non più il solo `if` su `^F`: sotto c'è la
+            // scrittura nel campo nota, e senza questo ramo `^K` ci finirebbe come
+            // lettera `k` — la combo non arriva come tasto proprio, `key.ctrl` è
+            // l'unico discriminante fra `^X` e `x`.
+            //
+            // `^F` è la deroga dichiarata (`CTRL_DEROGATIONS.detail`): fuori dal
+            // detail è la ricerca conversazioni, qui è la ricerca nel testo. La query
+            // sopravvive a una chiusura con `⏎`, quindi riaprire riprende da dov'era.
+            // `^U` svuota la nota — non è una deroga ma una combo che il modo gestisce
+            // da sé, come il filtro del modale assegnazione. Ogni altro CTRL è inerte.
+            if (input === 'f') {
+                setFind((f) => (f ? { ...f, open: true } : { q: '', caret: 0, open: true }));
+            }
+            else if (input === 'u') {
+                setSpawnNote('');
+            }
             return;
         }
         if (key.escape) {
@@ -178,24 +202,18 @@ export function useSheetOverlay(deps) {
             // competizione sul tasto.
             const act = DETAIL_ACTIONS[action];
             const id = sheet?.id;
+            const note = spawnNote.trim();
             close();
             if (id)
-                onAction(id, act.kind, model, `⏎ ${act.label}`);
+                onAction(id, act.kind, model, note, `⏎ ${act.label}`);
         }
         else if (key.tab) {
-            // T108 — `tab` scorre il catalogo dei modelli. Libero solo QUI: in vista
-            // normale cicla la vista del pane a fuoco, e le cifre `1`-`9` sono della
-            // legenda launch. Il detail cattura l'input per intero, quindi è dove un
-            // alfabeto già speso torna disponibile.
+            // T108 — `tab` scorre il catalogo dei modelli, e da T111 è il SOLO canale:
+            // le cifre `1`-`4` sono passate al campo nota. Libero solo QUI: in vista
+            // normale cicla la vista del pane a fuoco. Il detail cattura l'input per
+            // intero, quindi è dove un alfabeto già speso torna disponibile.
             setModel((m) => MODELS[(MODELS.indexOf(m) + 1) % MODELS.length]);
         }
-        else if (input.length === 1 && input >= '1' && input <= String(MODELS.length)) {
-            // Scelta diretta: chi sa già quale vuole non paga lo scorrimento. Il test
-            // sulla lunghezza non è pleonastico: `useInput` consegna il CHUNK letto da
-            // stdin, quindi un incollato come `12` passerebbe il confronto fra
-            // stringhe e indicizzerebbe il catalogo fuori range.
-            setModel(MODELS[Number(input) - 1]);
-        }
         else if (key.leftArrow || key.rightArrow) {
             // Scorrimento CICLICO come le righe di scelta del modale edit: cinque
             // voci, arrivare in fondo e ripartire costa meno che invertire direzione.
@@ -214,14 +232,19 @@ export function useSheetOverlay(deps) {
         else if (key.pageDown) {
             scroll(capacity);
         }
-        else if (input === 'g') {
-            // Estremi su lettera per lo stesso motivo del reader: Ink riconosce
-            // `Home`/`End` ma non le espone, e qui non c'è input di testo che
-            // contenda le lettere.
-            setTop(0);
+        else if (key.backspace || key.delete) {
+            // Nessun movimento di caret nel campo (D3): `←→` sono già delle azioni e
+            // riprenderle costerebbe la barra. Si cancella quindi in coda — e
+            // `key.delete` è ANCHE Backspace in Ink, come nel campo di ricerca.
+            setSpawnNote((s) => removeAt(s, cpLen(s) - 1));
         }
-        else if (input === 'G') {
-            setTop(maxTop);
+        else if (input && !key.meta) {
+            // Ultimo ramo: tutto ciò che nessun tasto vivo ha reclamato è testo. Ci
+            // cadono le cifre `1`-`4` (prima il selettore modello) e `g`/`G` (prima
+            // gli estremi del testo, che nel detail si raggiungono con
+            // `PgUp`/`PgDn`); nel reader fullscreen restano, perché lì nessun campo
+            // contende le lettere.
+            setSpawnNote((s) => s + sanitizeTyped(input));
         }
     }
     return {
@@ -230,6 +253,7 @@ export function useSheetOverlay(deps) {
         top,
         action,
         model,
+        spawnNote,
         find,
         lines,
         capacity,

package/dist/spawn.js

@@ -32,8 +32,9 @@ export function spawnOut(cmd, args, opts) {
     fake.unref = () => fake;
     return fake;
 }
-// L'ordine È il binding dei tasti `1`-`4` nel detail, non una preferenza di
-// lettura: cambiarlo sposta i tasti sotto le dita di chi li ha imparati.
+// L'ordine È il giro di `tab` nel detail, non una preferenza di lettura:
+// cambiarlo sposta le voci sotto le dita di chi le ha imparate. Fino a T111 era
+// anche il binding delle cifre `1`-`4`, passate poi al campo nota.
 export const MODELS = ['fable', 'opus', 'sonnet', 'haiku'];
 // Default del selettore e di ogni percorso di spawn che non passa da lui
 // (`^K`/`^P`/`^R` dalla lista, resume, fork). Duplicato del default di deck-run
@@ -65,11 +66,20 @@ export const DETAIL_ACTIONS = [
 // Il modello, al contrario del kind, ha un default (T108): i percorsi che non
 // passano dal selettore del detail non devono nominarlo per forza, e l'unico
 // valore sensato per loro è quello che il selettore stesso mostra all'apertura.
-export function deckArgs(id, sessionId, kind, model = MODEL_DEFAULT) {
-    return [id, '--session-id', sessionId, '--prompt-kind', kind, '--model', model];
+// T111 — `spawnNote` è la nota data alla NASCITA della conversazione, dal campo
+// sempre attivo del detail. Stesso flag `--title-note` del resume (T64): il
+// suffisso `«nota»` viene appeso a `TITLE` dentro deck-run PRIMA che i rami si
+// separino, quindi il flag non appartiene alla ripresa — vale su ogni spawn.
+// Assente quando la nota è vuota, e non passato vuoto: `--title-note ''`
+// produrrebbe un `«»` a vuoto nel titolo.
+export function deckArgs(id, sessionId, kind, model = MODEL_DEFAULT, spawnNote) {
+    const args = [id, '--session-id', sessionId, '--prompt-kind', kind, '--model', model];
+    if (spawnNote)
+        args.push('--title-note', spawnNote);
+    return args;
 }
-export function spawnDeck(id, cwd, sessionId, kind, model = MODEL_DEFAULT) {
-    const child = spawnOut(DECK_RUN, deckArgs(id, sessionId, kind, model), {
+export function spawnDeck(id, cwd, sessionId, kind, model = MODEL_DEFAULT, spawnNote) {
+    const child = spawnOut(DECK_RUN, deckArgs(id, sessionId, kind, model, spawnNote), {
         cwd,
         detached: true,
         stdio: 'ignore',

package/dist/ui/detail-screen.js

@@ -5,6 +5,7 @@ import { Box, Text } from 'ink';
 import { caretWindow, cut, cutParts, sanitize } from '../width.js';
 import { sliceLine } from '../text-search.js';
 import { sliceSpans } from '../markdown.js';
+import { cpLen } from '../layout.js';
 import { DETAIL_ACTIONS, MODELS } from '../spawn.js';
 import { WARN } from '../glyphs.js';
 /** Resa di ogni costrutto markdown (T75 · D4): un solo livello di enfasi per
@@ -51,14 +52,19 @@ export function DetailLine({ line, spans, occ, current, }) {
             return (_jsx(Text, { bold: st?.bold, color: st?.color, children: sliceLine(seg.text, at, occ, current).map((p, j) => p.hit ? (_jsx(Text, { backgroundColor: p.current ? 'cyan' : 'yellow', color: "black", children: p.text }, j)) : (_jsx(Text, { children: p.text }, j))) }, i));
         }) }));
 }
-/** Campo della ricerca nel detail: finestra ancorata al caret, cursore inverso
- *  sulla cella reale. Gemello di `EditTextField` senza la label, che qui sta
- *  fuori perché il campo vive in FLUSSO su una riga condivisa col contatore —
- *  non su una riga propria. */
-export function DetailFindField({ value, caret, cols }) {
+/** Campo di testo del detail: finestra ancorata al caret, cursore inverso sulla
+ *  cella reale. Gemello di `EditTextField` senza la label, che qui sta fuori
+ *  perché il campo vive in FLUSSO su una riga condivisa con altro (il contatore
+ *  di occorrenze per la ricerca, il segnaposto per la nota) — non su una riga
+ *  propria. Lo usano i due campi del detail: la ricerca `^F`, dove il caret si
+ *  muove, e la nota (T111), dove il caret sta sempre in coda. */
+export function DetailTextField({ value, caret, cols }) {
     const win = caretWindow(value, caret, cols);
     return (_jsxs(_Fragment, { children: [_jsx(Text, { children: sanitize(win.head) }), _jsx(Text, { inverse: true, children: sanitize(win.at) }), _jsx(Text, { children: sanitize(win.tail) })] }));
 }
+/** Segnaposto della riga nota quando il campo è vuoto. Costante e non letterale
+ *  inline perché la sua larghezza entra nel budget del campo accanto. */
+const NOTE_HINT = ' · nome della conversazione';
 /**
  * Detail della task (T66): il task file scrollabile più la barra azioni.
  *
@@ -72,7 +78,7 @@ export function DetailFindField({ value, caret, cols }) {
  * all'arrivo del mouse (T21 · SGR enable + hit-test) senza migrazione. La
  * navigazione da tastiera ci si sovrappone senza conflitti.
  */
-export function DetailScreen({ id, title, missing, lines, spans, top, total, capacity, action, model, columns, find, occ, occCur, }) {
+export function DetailScreen({ id, title, missing, lines, spans, top, total, capacity, action, model, spawnNote, columns, find, occ, occCur, }) {
     const last = Math.min(total, top + capacity);
     // Il taglio lo fa il chiamante (invariante ③ di width.ts): la riga bottoni è
     // ASCII, quindi `truncate-end` oggi darebbe il risultato giusto per caso — ma
@@ -98,14 +104,16 @@ export function DetailScreen({ id, title, missing, lines, spans, top, total, cap
     // enfasi diverse su due righe adiacenti (là `inverse`, qui un grassetto
     // colorato) obbligano a guardare da vicino per capire quale voce è scelta —
     // la stessa resa si legge di colpo su entrambe.
-    // La cifra sta DENTRO la quadra: è il tasto che seleziona quella voce, e
-    // sull'unica riga del deck dove le cifre valgono qualcosa toglierla
-    // costringerebbe a contare le posizioni.
+    // T111 — la cifra è USCITA dalla quadra: `1`-`4` sono passate al campo nota e
+    // il modello si scorre col solo `tab`. Un'etichetta che nomina un tasto è
+    // accoppiata al binding, e tenerla dopo che il binding è morto non è
+    // un'informazione parziale — è una resa che dichiara un tasto che non fa più
+    // quella cosa, cioè peggio di nessuna indicazione.
     // `priority` sulla voce SELEZIONATA e non sulla prima: qui il troncamento
     // cancellerebbe l'unica informazione che la riga esiste per dare — quale
     // modello sta per essere usato — mentre nella barra azioni la voce attiva è
     // comunque nota dal tasto appena premuto.
-    const mSegs = MODELS.map((m, i) => `[ ${i + 1} ${m} ]`);
+    const mSegs = MODELS.map((m) => `[ ${m} ]`);
     const mParts = [];
     mSegs.forEach((s, i) => {
         if (i > 0)
@@ -120,5 +128,14 @@ export function DetailScreen({ id, title, missing, lines, spans, top, total, cap
     if (dropped(mShown, mSegs) > 0)
         mShown = cutParts(mParts, Math.max(0, mWidth - 6), mIdx * 2);
     const mCut = dropped(mShown, mSegs);
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "loom-deck" }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [_jsx(Text, { color: "cyan", children: id }), " \u00B7 ", cut(title, Math.max(10, width - 34)), missing ? '' : ` · righe ${total === 0 ? 0 : top + 1}-${last} di ${total}`] }), find?.open ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [_jsx(Text, { color: "yellow", children: "\u2191\u2193" }), " occorrenza \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2190\u2192" }), " caret \u00B7", ' ', _jsx(Text, { color: "yellow", children: "^U" }), " svuota \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " tieni \u00B7", ' ', _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [_jsx(Text, { color: "yellow", children: "\u2191\u2193" }), " riga \u00B7 ", _jsx(Text, { color: "yellow", children: "PgUp/PgDn" }), " pagina \u00B7", ' ', _jsx(Text, { color: "yellow", children: "g/G" }), " estremi \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2190\u2192" }), " azione \u00B7", ' ', _jsx(Text, { color: "yellow", children: "1-4/tab" }), " modello \u00B7 ", _jsx(Text, { color: "yellow", children: "^F" }), " cerca \u00B7", ' ', _jsx(Text, { color: "yellow", children: "\u23CE" }), " esegui \u00B7 ", _jsx(Text, { color: "yellow", children: "esc" }), " chiudi"] })), _jsx(Box, { flexDirection: "column", borderStyle: "single", borderColor: "gray", paddingX: 1, marginTop: 1, children: missing ? (_jsxs(Text, { color: "yellow", wrap: "truncate-end", children: [WARN, " task file non trovato \u00B7 le azioni restano attive (deck-run risolve la task per id)"] })) : (lines.map((l, i) => (_jsx(DetailLine, { line: l, spans: spans, occ: occ, current: occCur }, top + i)))) }), find?.open ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: "cerca " }), _jsx(DetailFindField, { value: find.q, caret: find.caret, cols: Math.max(10, width - 28) }), find.q.length === 0 ? (_jsx(Text, { dimColor: true, children: " \u00B7 digita per cercare" })) : occ.length === 0 ? (_jsx(Text, { color: "yellow", children: " \u00B7 nessuna occorrenza" })) : (_jsxs(Text, { color: "cyan", children: [' ', "\u00B7 ", occCur + 1, "/", occ.length] }))] }) })) : null, _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: "modello " }), mShown.map((part, i) => i % 2 === 1 ? (_jsx(Text, { children: part }, i)) : (_jsx(Text, { inverse: i / 2 === mIdx, color: i / 2 === mIdx ? 'green' : 'gray', children: part }, i))), mCut > 0 ? _jsxs(Text, { color: "yellow", children: [" \u00B7 +", mCut] }) : null] }), _jsxs(Text, { wrap: "truncate-end", children: [shown.map((part, i) => i % 2 === 1 ? (_jsx(Text, { children: part }, i)) : (_jsx(Text, { inverse: i / 2 === action, color: i / 2 === action ? 'green' : 'gray', children: part }, i))), cutCount > 0 ? _jsxs(Text, { color: "yellow", children: [" \u00B7 +", cutCount] }) : null] })] })] }));
+    // T111 — riga della nota. FISSA (D1): il valore armato si vede sempre, e il
+    // suo costo sta in `DETAIL_CHROME` invece che in un secondo `extra`
+    // condizionale di `detailCapacity`. Prefisso largo 8 come `modello `, così i
+    // due parametri dello spawn si leggono incolonnati.
+    // Il campo non ha nessun tasto che lo apra: il cursore è l'unica cosa che lo
+    // dichiara attivo, e il segnaposto dice cosa ci si scrive. Le colonne del
+    // segnaposto si riservano SOLO quando c'è (cioè a nota vuota): riservarle
+    // sempre toglierebbe testo visibile a una nota lunga per un avviso assente.
+    const nWidth = Math.max(10, width - 8 - (spawnNote ? 0 : NOTE_HINT.length));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "loom-deck" }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [_jsx(Text, { color: "cyan", children: id }), " \u00B7 ", cut(title, Math.max(10, width - 34)), missing ? '' : ` · righe ${total === 0 ? 0 : top + 1}-${last} di ${total}`] }), find?.open ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [_jsx(Text, { color: "yellow", children: "\u2191\u2193" }), " occorrenza \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2190\u2192" }), " caret \u00B7", ' ', _jsx(Text, { color: "yellow", children: "^U" }), " svuota \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " tieni \u00B7", ' ', _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [_jsx(Text, { color: "yellow", children: "\u2191\u2193/PgUp/PgDn" }), " testo \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2190\u2192" }), " azione \u00B7", ' ', _jsx(Text, { color: "yellow", children: "tab" }), " modello \u00B7", ' ', _jsx(Text, { color: "yellow", children: "scrivi" }), " nota \u00B7 ", _jsx(Text, { color: "yellow", children: "^U" }), " svuota \u00B7", ' ', _jsx(Text, { color: "yellow", children: "^F" }), " cerca \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " esegui \u00B7", ' ', _jsx(Text, { color: "yellow", children: "esc" }), " chiudi"] })), _jsx(Box, { flexDirection: "column", borderStyle: "single", borderColor: "gray", paddingX: 1, marginTop: 1, children: missing ? (_jsxs(Text, { color: "yellow", wrap: "truncate-end", children: [WARN, " task file non trovato \u00B7 le azioni restano attive (deck-run risolve la task per id)"] })) : (lines.map((l, i) => (_jsx(DetailLine, { line: l, spans: spans, occ: occ, current: occCur }, top + i)))) }), find?.open ? (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: "cerca " }), _jsx(DetailTextField, { value: find.q, caret: find.caret, cols: Math.max(10, width - 28) }), find.q.length === 0 ? (_jsx(Text, { dimColor: true, children: " \u00B7 digita per cercare" })) : occ.length === 0 ? (_jsx(Text, { color: "yellow", children: " \u00B7 nessuna occorrenza" })) : (_jsxs(Text, { color: "cyan", children: [' ', "\u00B7 ", occCur + 1, "/", occ.length] }))] }) })) : null, _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: "modello " }), mShown.map((part, i) => i % 2 === 1 ? (_jsx(Text, { children: part }, i)) : (_jsx(Text, { inverse: i / 2 === mIdx, color: i / 2 === mIdx ? 'green' : 'gray', children: part }, i))), mCut > 0 ? _jsxs(Text, { color: "yellow", children: [" \u00B7 +", mCut] }) : null] }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: "nota    " }), _jsx(DetailTextField, { value: spawnNote, caret: cpLen(spawnNote), cols: nWidth }), spawnNote ? null : _jsx(Text, { dimColor: true, children: NOTE_HINT })] }), _jsxs(Text, { wrap: "truncate-end", children: [shown.map((part, i) => i % 2 === 1 ? (_jsx(Text, { children: part }, i)) : (_jsx(Text, { inverse: i / 2 === action, color: i / 2 === action ? 'green' : 'gray', children: part }, i))), cutCount > 0 ? _jsxs(Text, { color: "yellow", children: [" \u00B7 +", cutCount] }) : null] })] })] }));
 }

package/dist/version.js

@@ -0,0 +1,22 @@
+// Versione del pacchetto, letta dal `package.json` vero invece che cablata in
+// un `const`: una costante duplicata dal manifest è un calco — al primo bump
+// dimenticato il deck mostrerebbe con sicurezza un numero falso, ed è
+// esattamente il caso in cui serve (capire quale build sto guardando).
+//
+// Il path relativo `../package.json` vale per entrambe le forme in cui questo
+// modulo gira: `src/version.ts` sotto `tsx` e `dist/version.js` dopo il build —
+// il manifest sta un livello sopra in tutti e due i casi.
+import { readFileSync } from 'node:fs';
+function readVersion() {
+    try {
+        const raw = readFileSync(new URL('../package.json', import.meta.url), 'utf8');
+        const parsed = JSON.parse(raw);
+        return typeof parsed.version === 'string' ? parsed.version : '?';
+    }
+    catch {
+        // Installazione monca o manifest illeggibile: la versione è cosmetica,
+        // non vale far cadere il deck per averla persa.
+        return '?';
+    }
+}
+export const VERSION = readVersion();

package/dist/viewport.js

@@ -218,13 +218,21 @@ export function readerCapacity(rows) {
 //   2  bordi del box testo
 //   1  marginTop della riga azioni
 //   1  riga modello (T108)
+//   1  riga nota (T111)
 //   1  riga azioni
 //
-// Le ultime tre sono il motivo per cui il detail non può riusare READER_CHROME:
-// barra bottoni e selettore modello sono righe FISSE in più dentro l'overlay, e
-// ogni riga fissa aggiunta va scalata dalla capienza del contenuto o il frame
-// sfonda `rows` (stessa invariante di TASKS_PANE_CHROME).
-const DETAIL_CHROME = 11;
+// Le ultime quattro sono il motivo per cui il detail non può riusare
+// READER_CHROME: barra bottoni, selettore modello e campo nota sono righe FISSE
+// in più dentro l'overlay, e ogni riga fissa aggiunta va scalata dalla capienza
+// del contenuto o il frame sfonda `rows` (stessa invariante di
+// TASKS_PANE_CHROME).
+//
+// La nota è una riga fissa e non un secondo `extra` di `detailCapacity` (T111 ·
+// D1): due condizionali mutuamente esclusivi obbligherebbero il parametro a dire
+// QUALE è aperto — un solo booleano per entrambi sottostima quando quello aperto
+// è il più alto, e sommarli toglie righe al testo per un campo che non è a
+// schermo.
+const DETAIL_CHROME = 12;
 // T91 — la ricerca dentro il detail: marginTop + riga del campo.
 //
 // `MODAL_HEIGHT` dice che il detail costa 0 ai due pane (li sostituisce), e da

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lamemind/loom-deck",
-  "version": "0.35.1",
+  "version": "0.37.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": {