@lamemind/loom-deck 0.18.0 → 0.19.0

package/dist/cli.js

@@ -3,6 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { render, Box, Text, useApp, useInput, useStdout } from 'ink';
 import { useState, useEffect, useMemo, useRef } from 'react';
 import { spawn } from 'node:child_process';
+import { EventEmitter } from 'node:events';
 import { statSync } from 'node:fs';
 import { randomUUID } from 'node:crypto';
 import { fileURLToPath } from 'node:url';
@@ -29,6 +30,11 @@ const MAX_SESSIONS = 30;
 // meta "spot" (sentinella) che raccoglie le sessioni NON legate ad alcuna task.
 // La selezione nel Tasks pane è il "padre"; il Sessions pane mostra i suoi figli.
 const SPOT = Symbol('spot');
+const EDIT_ROWS = 4;
+/** Le righe del modale edit che sono campi di TESTO (il resto è scelta ←→). */
+function isTextRow(r) {
+    return r === 2 || r === 3;
+}
 // Modale sort a grammatica libera: un tasto per chiave, pressioni successive
 // ciclano asc → desc → fuori dalla chain.
 const SORT_TASTI = { p: 'pri', s: 'prog', i: 'id' };
@@ -61,11 +67,36 @@ const EDIT_PROG = ['todo', 'wip', 'done', 'locked'];
 function isDone(prog) {
     return prog.includes('✔');
 }
+/**
+ * Freno agli effetti VERSO L'ESTERNO (tab Ptyxis, sessioni Claude, git commit).
+ *
+ * Il gate di larghezza avvia il deck vero in uno pseudo-terminale e gli manda
+ * tasti — e in questa TUI un tasto è un'azione: `⏎` su una riga sessione apre
+ * una tab Ptyxis, `t` un terminale, `⏎` nel modale edit committa. Ogni run dei
+ * test apriva quindi finestre reali sulla macchina di chi li lanciava, in
+ * qualunque progetto avesse in focus.
+ *
+ * Il gate va tenuto sul deck VERO (è tutto il suo valore: misura il frame che
+ * VTE disegna davvero), quindi il freno sta qui: `LOOM_DECK_NO_SPAWN=1` fa
+ * restituire un figlio finto e inerte invece di lanciare il processo. Non è un
+ * mock del comportamento — l'azione semplicemente non avviene, e il frame che il
+ * test misura resta identico.
+ */
+const NO_SPAWN = process.env.LOOM_DECK_NO_SPAWN === '1';
+function spawnOut(cmd, args, opts) {
+    if (!NO_SPAWN)
+        return spawn(cmd, args, opts);
+    // Figlio inerte: emette nulla, quindi i `.on('error'|'close')` dei chiamanti
+    // restano appesi senza mai scattare — che è esattamente "non è successo niente".
+    const fake = new EventEmitter();
+    fake.unref = () => fake;
+    return fake;
+}
 // Spawn detached: il deck spawna ma NON contiene la sessione (la possiede
 // ptyxis-agent). unref + stdio ignore → ritorna subito, la TUI resta viva.
 // sessionId pinnato (T27) → il binding sidecar è deterministico allo spawn.
 function spawnDeck(id, cwd, sessionId) {
-    const child = spawn(DECK_RUN, [id, '--session-id', sessionId], {
+    const child = spawnOut(DECK_RUN, [id, '--session-id', sessionId], {
         cwd,
         detached: true,
         stdio: 'ignore',
@@ -81,7 +112,7 @@ function spawnDeck(id, cwd, sessionId) {
 // continuarla, non iniettarle un messaggio (lo salta deck-run).
 function spawnDeckResume(taskId, cwd, sessionId) {
     const args = taskId ? [taskId, '--resume', sessionId] : ['--no-task', '--resume', sessionId];
-    const child = spawn(DECK_RUN, args, { cwd, detached: true, stdio: 'ignore' });
+    const child = spawnOut(DECK_RUN, args, { cwd, detached: true, stdio: 'ignore' });
     child.unref();
     return child;
 }
@@ -102,7 +133,7 @@ function spawnDeckFork(taskId, cwd, originId, newId) {
         '--session-id',
         newId,
     ];
-    const child = spawn(DECK_RUN, args, { cwd, detached: true, stdio: 'ignore' });
+    const child = spawnOut(DECK_RUN, args, { cwd, detached: true, stdio: 'ignore' });
     child.unref();
     return child;
 }
@@ -113,7 +144,7 @@ function spawnDeckFork(taskId, cwd, originId, newId) {
 // sporcherebbe il percorso bound. Il titolo tab resta la label loom — lo mette
 // deck-run, perché il match compass è window-level e non sa nulla di task.
 function spawnClaudeEmpty(cwd) {
-    const child = spawn(DECK_RUN, ['--no-task'], {
+    const child = spawnOut(DECK_RUN, ['--no-task'], {
         cwd,
         detached: true,
         stdio: 'ignore',
@@ -130,7 +161,7 @@ function spawnClaudeEmpty(cwd) {
 // esplicito in project-config-architecture.md). La project root arriva via cwd,
 // non interpolata nella stringa.
 function runLaunch(entry, cwd) {
-    const child = spawn('bash', ['-lic', entry.command], {
+    const child = spawnOut('bash', ['-lic', entry.command], {
         cwd,
         detached: true,
         stdio: 'ignore',
@@ -150,7 +181,7 @@ function runLaunch(entry, cwd) {
 // dal radar finché quella tab è in primo piano).
 function spawnTerminal(cwd, title) {
     const args = title ? ['--tab', '-T', title, '-d', cwd] : ['--tab', '-d', cwd];
-    const child = spawn('ptyxis', args, { cwd, detached: true, stdio: 'ignore' });
+    const child = spawnOut('ptyxis', args, { cwd, detached: true, stdio: 'ignore' });
     child.unref();
     return child;
 }
@@ -167,7 +198,7 @@ const CLAUDE_CMD = process.env.LOOM_DECK_CLAUDE_CMD ?? 'claude';
 //    completa commit+push da sé; stdout in pipe SOLO per leggere il result event.
 // Il prompt viaggia come singolo argv (no shell) → nessuna injection dal testo utente.
 function spawnCreateTask(text, cwd, sessionId, onResult) {
-    const child = spawn(CLAUDE_CMD, [
+    const child = spawnOut(CLAUDE_CMD, [
         '-p',
         '--output-format',
         'stream-json',
@@ -210,7 +241,7 @@ function spawnCreateTask(text, cwd, sessionId, onResult) {
 // veloce e il suo esito va riportato nella nota. stderr raccolto per dire perché
 // ha fallito (identità git assente, hook che rifiuta, …) invece di un generico ⚠.
 function commitTaskEdit(cwd, paths, message, onResult) {
-    const child = spawn('git', ['commit', '-m', message, '--', ...paths], {
+    const child = spawnOut('git', ['commit', '-m', message, '--', ...paths], {
         cwd,
         stdio: ['ignore', 'ignore', 'pipe'],
     });
@@ -623,6 +654,12 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     // da default. La priorità arriva dal glifo di tasks.md (già in `selTask`), lo
     // stato dal suo glifo Prog; il progresso arbitrario dal campo `Progress` del
     // task file — ma solo se è davvero custom (vedi `initialDetail`).
+    //
+    // Il titolo si semina dalla riga di tasks.md e non dall'H1 del task file per
+    // due ragioni: è la fonte che esiste SEMPRE (un task file può mancare), ed è
+    // il testo che l'utente sta guardando in lista quando preme `E`. Grezzo
+    // (`rawDesc`), non sanificato: rimandare a disco la forma sanificata
+    // riscriverebbe i glifi anche senza toccare il campo.
     function openEdit() {
         if (!selTask)
             return;
@@ -631,6 +668,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             pri: priName(selTask.pri) ?? 'med',
             prog,
             detail: initialDetail(detail?.fields['Progress'] ?? '', prog),
+            title: selTask.rawDesc,
         });
         setEditRow(0);
         setNote('');
@@ -648,9 +686,23 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         setEdit(null);
         if (!task || !draft)
             return;
+        // Il titolo si scrive solo se è CAMBIATO davvero: rimandarlo identico
+        // riscriverebbe comunque la cella (collassando spazi ed escape) e sporcherebbe
+        // il diff di una riga per un edit di sola priorità. Vuoto → scartato: una
+        // task senza descrizione in overview non è più riconoscibile.
+        const title = draft.title.trim();
+        const titleChanged = title.length > 0 && title !== task.rawDesc.trim();
         let res;
         try {
-            res = writeTaskEdit({ tasksPath, tasksDir, id: task.id, ...draft });
+            res = writeTaskEdit({
+                tasksPath,
+                tasksDir,
+                id: task.id,
+                pri: draft.pri,
+                prog: draft.prog,
+                detail: draft.detail,
+                title: titleChanged ? title : undefined,
+            });
         }
         catch (e) {
             setNote(`⚠ ${task.id}: scrittura fallita (${e.message})`);
@@ -660,9 +712,9 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             setNote(`⚠ ${task.id}: nessun campo aggiornabile (riga o task file assenti)`);
             return;
         }
-        const summary = `${PRI_GLYPH[draft.pri]} ${PRI_LABEL[draft.pri]} · ${res.progress}`;
+        const summary = `${PRI_GLYPH[draft.pri]} ${PRI_LABEL[draft.pri]} · ${res.progress}${titleChanged ? ` · "${cut(sanitize(title), 32)}"` : ''}`;
         setNote(`⏳ ${task.id} → ${summary} · commit…`);
-        commitTaskEdit(cwd, res.paths, `chore(${task.id}): pri ${PRI_LABEL[draft.pri]} · stato ${res.progress}`, (ok, err) => {
+        commitTaskEdit(cwd, res.paths, `chore(${task.id}): pri ${PRI_LABEL[draft.pri]} · stato ${res.progress}${titleChanged ? ' · titolo' : ''}`, (ok, err) => {
             setNote(ok ? `✔ ${task.id} → ${summary} · committato` : `⚠ ${task.id} salvato, commit fallito: ${err}`);
         });
     }
@@ -961,9 +1013,9 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             }
             return;
         }
-        // T41 — modale edit: griglia a 3 righe. Righe 0/1 = scelta a valore singolo
-        // (←→ scorre), riga 2 = testo libero (ogni carattere stampabile entra nel
-        // progresso). Come gli altri modali cattura tutto: `esc` annulla senza
+        // T41 — modale edit: griglia a 4 righe. Righe 0/1 = scelta a valore singolo
+        // (←→ scorre), righe 2/3 = testo libero (ogni carattere stampabile entra nel
+        // campo). Come gli altri modali cattura tutto: `esc` annulla senza
         // scrivere né uscire dal deck.
         if (mode === 'edit') {
             if (key.escape) {
@@ -975,12 +1027,12 @@ function Deck({ cwd, tasksPath, tasksDir }) {
                 submitEdit();
             }
             else if (key.upArrow) {
-                setEditRow((r) => ((r + 2) % 3));
+                setEditRow((r) => ((r + EDIT_ROWS - 1) % EDIT_ROWS));
             }
             else if (key.downArrow) {
-                setEditRow((r) => ((r + 1) % 3));
+                setEditRow((r) => ((r + 1) % EDIT_ROWS));
             }
-            else if (key.leftArrow || key.rightArrow) {
+            else if ((key.leftArrow || key.rightArrow) && !isTextRow(editRow)) {
                 const d = key.leftArrow ? -1 : 1;
                 // Scorrimento CICLICO (wrap) e non clampato: le liste sono di 3-4 voci,
                 // arrivare in fondo e ripartire costa meno di invertire direzione.
@@ -993,12 +1045,20 @@ function Deck({ cwd, tasksPath, tasksDir }) {
                         : e);
                 }
             }
-            else if (editRow === 2) {
+            else if (isTextRow(editRow)) {
+                // Un solo ramo per i due campi di testo, la riga sceglie la chiave:
+                // duplicarlo significherebbe tenere allineate a mano due copie della
+                // stessa grammatica di input a ogni tasto aggiunto.
+                const field = editRow === 2 ? 'detail' : 'title';
                 if (key.backspace || key.delete) {
-                    setEdit((e) => (e ? { ...e, detail: e.detail.slice(0, -1) } : e));
+                    setEdit((e) => (e ? { ...e, [field]: e[field].slice(0, -1) } : e));
                 }
                 else if (input && !key.ctrl && !key.meta) {
-                    setEdit((e) => (e ? { ...e, detail: e.detail + input } : e));
+                    // `sanitizeTyped`: `useInput` consegna il CHUNK di stdin, quindi un
+                    // incollaggio porta dentro newline e byte di controllo — invisibili
+                    // nel campo ma contati da Ink nella larghezza della riga, e destinati
+                    // a finire tali e quali dentro tasks.md.
+                    setEdit((e) => (e ? { ...e, [field]: e[field] + sanitizeTyped(input) } : e));
                 }
             }
             return;
@@ -1285,7 +1345,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 \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 \u23CE ", canSpawn ? '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 })) : 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 \u00B7", ' ', _jsx(Text, { color: "yellow", children: "testo" }), " su prog/titolo \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 \u23CE ", canSpawn ? '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] }));
 }
 const SORT_UI = { pri: 'pri', prog: 'stato', id: 'id' };
 // Modali resi IN FLUSSO (come l'input box di create), non in overlay assoluto:
@@ -1307,13 +1367,47 @@ function FilterModal({ view, cursor }) {
                         return (_jsxs(Text, { inverse: here, color: on ? 'green' : 'gray', dimColor: !on, children: ['  ', "[", on ? 'x' : ' ', "] ", sanitize(e.glyph)] }, e.name));
                     })] }, row.label)))] }));
 }
+/**
+ * Taglio dalla TESTA: tiene la CODA della stringa dentro `cols`.
+ *
+ * `cut()` fa l'opposto (tiene l'inizio) ed è giusto per un testo che si LEGGE;
+ * qui il testo si SCRIVE, il cursore sta in fondo (append-only come gli altri
+ * campi del deck) e ciò che serve vedere è l'ultima parola digitata, non la
+ * prima — con `cut()` un titolo lungo sparirebbe sotto l'ellissi proprio mentre
+ * lo si sta scrivendo. Budget in COLONNE (`termWidth`), non in code unit: è
+ * quello che decide se la riga sfonda il bordo del box.
+ */
+function tailCut(s, cols) {
+    if (cols <= 0)
+        return '';
+    if (termWidth(s) <= cols)
+        return s;
+    const chars = [...s];
+    let out = '';
+    let w = 1; // la colonna dell'ellissi di testa
+    for (let i = chars.length - 1; i >= 0; i--) {
+        const cw = termWidth(chars[i]);
+        if (w + cw > cols)
+            break;
+        out = chars[i] + out;
+        w += cw;
+    }
+    return `…${out}`;
+}
 // T41 — modale edit, in flusso come gli altri (spinge giù i pane invece di
 // coprirli: la riga che stai modificando resta visibile sopra la lista).
 // La riga di anteprima mostra il testo ESATTO che finirà nel campo `Progress`
 // del task file — così il default (`✔️ Done at <oggi>`) non è una sorpresa.
-function EditModal({ id, draft, row }) {
+function EditModal({ id, draft, row, columns, }) {
     const mark = (r) => (row === r ? CARET : CARET_OFF);
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "yellow", paddingX: 1, marginTop: 1, children: [_jsxs(Text, { color: "yellow", children: ["E \u203A ", id, " \u00B7 priorit\u00E0 e stato"] }), _jsxs(Text, { children: [mark(0), _jsx(Text, { dimColor: true, children: "pri  " }), EDIT_PRI.map((p) => (_jsxs(Text, { inverse: draft.pri === p, color: draft.pri === p ? 'green' : 'gray', children: ['  ', sanitize(PRI_GLYPH[p]), " ", PRI_LABEL[p]] }, p)))] }), _jsxs(Text, { children: [mark(1), _jsx(Text, { dimColor: true, children: "stato" }), EDIT_PROG.map((p) => (_jsxs(Text, { inverse: draft.prog === p, color: draft.prog === p ? 'green' : 'gray', children: ['  ', sanitize(PROG_GLYPH[p]), " ", p] }, p)))] }), _jsxs(Text, { children: [mark(2), _jsx(Text, { dimColor: true, children: "prog " }), _jsxs(Text, { children: ['  ', draft.detail] }), row === 2 ? _jsx(Text, { inverse: true, children: " " }) : null, !draft.detail && row !== 2 ? _jsx(Text, { dimColor: true, children: "(default)" }) : null] }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["\u21B3 ", sanitize(progressText(draft.prog, draft.detail))] })] }));
+    // Budget del campo titolo, DERIVATO da `columns` (mai una costante): il box
+    // del modale è ANNIDATO nella cornice del deck, quindi le cornici da scalare
+    // sono due — root (bordo 2 + paddingX 2) e modale (bordo 2 + paddingX 2) — più
+    // caret 2, etichetta 6, gap 2 e cursore 1. Totale 19.
+    // Un titolo di tasks.md arriva a ~64 caratteri: senza taglio la riga va a capo
+    // dentro il box, che si alza di una riga e sfonda il budget verticale (invariante ③).
+    const titleBudget = Math.max(8, columns - 19);
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "yellow", paddingX: 1, marginTop: 1, children: [_jsxs(Text, { color: "yellow", children: ["E \u203A ", id, " \u00B7 titolo, priorit\u00E0 e stato"] }), _jsxs(Text, { children: [mark(0), _jsx(Text, { dimColor: true, children: "pri   " }), EDIT_PRI.map((p) => (_jsxs(Text, { inverse: draft.pri === p, color: draft.pri === p ? 'green' : 'gray', children: ['  ', sanitize(PRI_GLYPH[p]), " ", PRI_LABEL[p]] }, p)))] }), _jsxs(Text, { children: [mark(1), _jsx(Text, { dimColor: true, children: "stato " }), EDIT_PROG.map((p) => (_jsxs(Text, { inverse: draft.prog === p, color: draft.prog === p ? 'green' : 'gray', children: ['  ', sanitize(PROG_GLYPH[p]), " ", p] }, p)))] }), _jsxs(Text, { children: [mark(2), _jsx(Text, { dimColor: true, children: "prog  " }), _jsxs(Text, { children: ['  ', sanitize(draft.detail)] }), row === 2 ? _jsx(Text, { inverse: true, children: " " }) : null, !draft.detail && row !== 2 ? _jsx(Text, { dimColor: true, children: "(default)" }) : null] }), _jsxs(Text, { children: [mark(3), _jsx(Text, { dimColor: true, children: "titolo" }), _jsxs(Text, { children: ['  ', sanitize(tailCut(draft.title, titleBudget))] }), row === 3 ? _jsx(Text, { inverse: true, children: " " }) : null] }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["\u21B3 ", sanitize(progressText(draft.prog, draft.detail))] })] }));
 }
 // T52 — marcatore compatto del tipo di corpo sulla riga-occorrenza. Due
 // caratteri ASCII e non un'emoji: con più toggle accesi la colonna deve

package/dist/sessions.js

@@ -231,8 +231,15 @@ export function parseTranscript(content, path, mtime, sizeBytes) {
         sizeBytes,
         turns,
         customTitle,
-        firstPrompt: firstUserText,
-        lastReply: lastAssistantText,
+        // Sanificati come il titolo, e per lo stesso motivo: le due preview del
+        // detail pane sono testo di transcript messo NEL FRAME. Erano l'ultimo
+        // varco rimasto — un `✅` (BMP largo 2) nell'estratto prende una cella
+        // sola nella griglia di Ink e due colonne sul terminale, quindi la riga
+        // scivola a destra e si mangia il bordo del pane. Qui il confine è lo
+        // stesso di `title`, non il render: `wrapLines` conta le colonne su questo
+        // testo, sanificare a valle sposterebbe l'a-capo già calcolato.
+        firstPrompt: sanitize(firstUserText),
+        lastReply: sanitize(lastAssistantText),
         bodies,
     };
 }

package/dist/task-edit.js

@@ -75,18 +75,27 @@ export function initialDetail(current, prog, date = today()) {
     return stripProgGlyph(s);
 }
 /**
- * Riscrive le celle Pri (col 2) e Prog (col 4) della riga `| Tnn | … |` in
- * tasks.md. Solo la PRIMA riga con quell'id — l'overview è unica, un secondo
- * match sarebbe un duplicato da non propagare. Le altre celle (K, descrizione)
- * restano i token grezzi originali: nessun re-flow della tabella, il diff resta
- * di una riga. `ok:false` = id assente → il chiamante non scrive nulla.
+ * Riscrive le celle Pri (col 2), Prog (col 4) e — se `desc` è passata — la
+ * descrizione (col 5) della riga `| Tnn | … |` in tasks.md. Solo la PRIMA riga
+ * con quell'id — l'overview è unica, un secondo match sarebbe un duplicato da
+ * non propagare. Le celle non toccate restano i token grezzi originali: nessun
+ * re-flow della tabella, il diff resta di una riga. `ok:false` = id assente →
+ * il chiamante non scrive nulla.
+ *
+ * `desc` undefined ≠ `desc` vuota: la prima non tocca la cella (chiamata
+ * legacy, solo pri/prog), la seconda la svuota davvero.
+ *
+ * La descrizione è l'ULTIMA colonna e può contenere `|` — che in una tabella
+ * markdown spezza la cella. Riscriverla significa quindi collassare tutte le
+ * celle da 5 fino alla penultima in una sola (`splice`), altrimenti i pezzi
+ * della vecchia descrizione resterebbero appesi in coda alla nuova.
  *
  * L'id deve rispettare `TASK_ID_RE` (importato da tasks.ts — stesso gate di
  * `parseTasks`, non una copia): senza, un id arbitrario matcherebbe la riga di
  * HEADER (`| ID | Pri | K | Prog |`) o quella di separatore, riscrivendone le
  * celle e sfondando la tabella.
  */
-export function updateTasksMdRow(content, id, priGlyph, progGlyph) {
+export function updateTasksMdRow(content, id, priGlyph, progGlyph, desc) {
     if (!TASK_ID_RE.test(id))
         return { content, ok: false };
     let ok = false;
@@ -103,20 +112,49 @@ export function updateTasksMdRow(content, id, priGlyph, progGlyph) {
         ok = true;
         cells[2] = ` ${priGlyph} `;
         cells[4] = ` ${progGlyph} `;
+        if (desc !== undefined) {
+            // Da cells[5] fino alla penultima: l'ultima è la coda dopo il `|` finale
+            // (stringa vuota su una riga ben formata) e va conservata, o la riga
+            // perderebbe il proprio bordo destro.
+            cells.splice(5, cells.length - 6, ` ${sanitizeCell(desc)} `);
+        }
         return cells.join('|');
     });
     return { content: ok ? lines.join('\n') : content, ok };
 }
 /**
- * Riscrive i bullet header `- **Priority**:` e `- **Progress**:` del task file.
+ * Rende un testo scrivibile dentro una CELLA di tabella markdown. Due caratteri
+ * la romperebbero e non sono rappresentabili altrimenti su una riga sola:
+ * il `|` (chiude la cella) e l'a-capo (chiude la riga). Il primo va escapato,
+ * il secondo collassato a spazio. È l'unico posto dove il titolo viene toccato:
+ * nel task file, che è markdown libero, va scritto verbatim.
+ */
+function sanitizeCell(s) {
+    return s.replace(/\s+/g, ' ').replace(/\|/g, '\\|').trim();
+}
+/**
+ * Riscrive i bullet header `- **Priority**:` e `- **Progress**:` del task file,
+ * più — se `title` è passato — l'H1 di testa.
  * First-match-wins per chiave, stessa regola di `parseTaskDetail`: se un campo
  * ricompare nel body (residuo template) vince quello dell'header — così ciò che
  * il deck mostra e ciò che scrive restano la stessa riga.
+ *
+ * L'H1 conserva il proprio CAPPELLO (`# Task: …` code, `# Doc Task: …` doc):
+ * `parseTaskDetail` lo strippa in lettura, quindi il titolo che arriva dal
+ * modale non ce l'ha e riscrivere la riga nuda perderebbe la categoria. Il
+ * prefisso si rilegge dalla riga esistente e si ri-antepone tale e quale — così
+ * una T resta `# Task:` e una D resta `# Doc Task:` senza doverlo sapere qui.
  */
-export function updateTaskFileFields(content, priLabel, progress) {
+export function updateTaskFileFields(content, priLabel, progress, title) {
     let priDone = false;
     let progDone = false;
+    let titleDone = false;
     const lines = content.split('\n').map((line) => {
+        if (title !== undefined && !titleDone && /^#\s+/.test(line)) {
+            titleDone = true;
+            const prefix = line.match(/^#\s+((?:Doc\s+)?Task:\s*)/)?.[1] ?? '';
+            return `# ${prefix}${title.replace(/\s+/g, ' ').trim()}`;
+        }
         if (!priDone && /^-\s*\*\*Priority\*\*:/.test(line)) {
             priDone = true;
             return `- **Priority**: ${priLabel}`;
@@ -127,7 +165,7 @@ export function updateTaskFileFields(content, priLabel, progress) {
         }
         return line;
     });
-    const ok = priDone || progDone;
+    const ok = priDone || progDone || titleDone;
     return { content: ok ? lines.join('\n') : content, ok };
 }
 /**
@@ -138,10 +176,10 @@ export function updateTaskFileFields(content, priLabel, progress) {
  * si scrive ciò che esiste e il risultato dice cosa è stato toccato.
  */
 export function writeTaskEdit(input) {
-    const { tasksPath, tasksDir, id, pri, prog, detail } = input;
+    const { tasksPath, tasksDir, id, pri, prog, detail, title } = input;
     const progress = progressText(prog, detail);
     const paths = [];
-    const row = updateTasksMdRow(readFileSync(tasksPath, 'utf8'), id, PRI_GLYPH[pri], PROG_GLYPH[prog]);
+    const row = updateTasksMdRow(readFileSync(tasksPath, 'utf8'), id, PRI_GLYPH[pri], PROG_GLYPH[prog], title);
     if (row.ok) {
         writeFileSync(tasksPath, row.content, 'utf8');
         paths.push(tasksPath);
@@ -149,7 +187,7 @@ export function writeTaskEdit(input) {
     let fileUpdated = false;
     const taskFile = findTaskFile(tasksDir, id);
     if (taskFile) {
-        const upd = updateTaskFileFields(readFileSync(taskFile, 'utf8'), PRI_LABEL[pri], progress);
+        const upd = updateTaskFileFields(readFileSync(taskFile, 'utf8'), PRI_LABEL[pri], progress, title);
         if (upd.ok) {
             writeFileSync(taskFile, upd.content, 'utf8');
             paths.push(taskFile);

package/dist/task-index.js

@@ -1,5 +1,6 @@
 import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
+import { sanitize } from './width.js';
 export function taskIndexPath(projectRoot) {
     return join(projectRoot, '.claude', 'loom', 'session-tasks.jsonl');
 }
@@ -60,8 +61,14 @@ export function loadSessionIndex(projectRoot) {
             // nota vuota da mostrare. Il `typeof` esclude i record senza il campo, che
             // non devono toccare una nota scritta da un record precedente.
             if (typeof d.note === 'string') {
+                // Sanificata in lettura, non solo alla digitazione: `sanitizeTyped`
+                // toglie i byte di controllo ma non ripara la larghezza, e il file è
+                // editabile a mano — una nota con un `✅` finirebbe nel frame larga il
+                // doppio di quanto Ink ha contato. Il round-trip (edit di una nota già
+                // sanificata → riscrittura del sostituto) è il prezzo accettato: a
+                // schermo il glifo originale non era comunque disegnabile.
                 if (d.note)
-                    notes.set(d.sessionId, d.note);
+                    notes.set(d.sessionId, sanitize(d.note));
                 else
                     notes.delete(d.sessionId);
             }

package/dist/tasks.js

@@ -52,7 +52,7 @@ export function parseTasks(content) {
         // il glifo, e `task-edit` lo riscrive in tasks.md. Sanificarli qui
         // renderebbe `✔` un `✅` anche su disco, cambiando il formato di famiglia.
         // La sanificazione di quei due avviene al display (`displayProg`).
-        tasks.push({ id, pri, prog, desc: sanitize(desc) });
+        tasks.push({ id, pri, prog, desc: sanitize(desc), rawDesc: desc });
     }
     return tasks;
 }

package/dist/viewport.js

@@ -41,7 +41,7 @@ export const MODAL_HEIGHT = {
     note: 4, // T53 — gemello di create: marginTop + 2 bordi + 1 riga input
     sort: 5, // marginTop + 2 bordi + titolo + 1 riga catena
     filter: 6, // marginTop + 2 bordi + titolo + 2 righe (pri, stato)
-    edit: 8, // marginTop + 2 bordi + titolo + 3 campi + riga anteprima
+    edit: 9, // marginTop + 2 bordi + titolo + 4 campi (pri, stato, prog, titolo) + riga anteprima
     // T52 — search e reader sono gli unici modali NON in flusso: sostituiscono i
     // due pane invece di spingerli giù (una lista di occorrenze non entra in un
     // box sopra il deck). Costo 0 nel budget dei pane perché quel budget non

package/package.json

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