@lamemind/loom-deck 0.15.0 → 0.17.0

package/README.md

@@ -4,12 +4,16 @@ Deck TUI (Ink) **per-progetto** della famiglia [loom](https://github.com/lamemin
 
 Legge il `tasks.md` del progetto e, con un tasto (poi un click), **spawna** una tab
 [Ptyxis](https://gitlab.gnome.org/chergert/ptyxis) che avvia una sessione Claude Code
-già bound alla task via `LOOM_TASK`, dritta su `/loom-works:run-task <Txx>`.
+già bound alla task via `LOOM_TASK`, con un prompt di recap sullo stato della task.
 
 ```
-↑↓ scegli la task  →  ⏎  →  tab CC di fianco  →  parte già su /loom-works:run-task <Txx>
+↑↓ scegli la task  →  ⏎  →  tab CC di fianco  →  LOOM_TASK bound + recap stato task
 ```
 
+Entrambi i prefissi del contratto loom entrano in lista: **`T`** (code task) e
+**`D`** (doc task). Nessuna differenza di trattamento — il prompt iniziale è un
+recap, non l'invocazione di una skill, quindi vale identico sulle due famiglie.
+
 ## Ruolo nella famiglia loom
 
 `loom-deck` è un **client** con runtime proprio (TUI Ink) che **consuma** il contratto
@@ -193,6 +197,11 @@ p  priorità     s  stato     i  id
 
 Partendo da catena vuota, digitare `ppi` produce `[pri ↓, id ↑]`. Il ciclo parte
 sempre **dallo stato corrente**, che il modale mostra dal vivo mentre digiti.
+
+Sull'**id** il confronto è numerico (`T9` prima di `T10`, non lessicografico) e i
+due prefissi sono blocchi distinti — le `D` in coda alle `T`: i counter `T` e `D`
+sono separati nel contratto loom, quindi `T01` e `D01` non sono confrontabili
+come numeri soli.
 A parità su tutte le chiavi decide sempre l'`id` (confronto **numerico**: `T9`
 prima di `T10`) → l'ordine è deterministico, mai instabile fra un refresh e l'altro.
 
@@ -234,7 +243,8 @@ npx @lamemind/loom-deck
 scripts/deck-run T18
 ```
 
-Apre una tab Ptyxis nella window attiva con `LOOM_TASK=T18 claude '/loom-works:run-task T18'`.
+Apre una tab Ptyxis nella window attiva con `LOOM_TASK=T18 claude 'recap stato task T18'`
+(prompt override-abile via `LOOM_DECK_ENTER_PROMPT`, placeholder `{TASK}`).
 
 ## Sviluppo (TUI Ink)
 

package/dist/cli.js

@@ -10,10 +10,10 @@ import { dirname, join } from 'node:path';
 import { resolveTasksPath, resolveTasksDir, loadTasks, loadTaskDetail, } from './tasks.js';
 import { discoverProjectSessions } from './sessions.js';
 import { buildRows, firstRowKey, moveRowSelection, rowIndexOfKey, searchSessions, selectedRow, DEFAULT_OPTIONS, MIN_QUERY, } from './search.js';
-import { appendPin, appendSessionRecord, appendTaskBinding, loadSessionIndex, } from './task-index.js';
-import { assembleSessionList, firstSelectableId, moveSelection, rowIndexOf, selectedSession, } from './session-list.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 { isCompact, layoutBudget, normalizeEmoji, readerCapacity, searchListCapacity, searchPreviewCapacity, windowRange, wrapLines, wrapWithOffsets, } from './viewport.js';
+import { isCompact, layoutBudget, normalizeEmoji, readerCapacity, searchListCapacity, searchPreviewCapacity, truncate, windowRange, wrapLines, wrapWithOffsets, } from './viewport.js';
 import { applyView, cycleSort, describeSort, priName, progName, toggleHidden, PRI_ENTRIES, PROG_ENTRIES, } from './view.js';
 import { initialDetail, progressText, writeTaskEdit, PRI_GLYPH, PRI_LABEL, PROG_GLYPH, } from './task-edit.js';
 import { loadView, saveView, viewFilePath } from './view-store.js';
@@ -284,6 +284,7 @@ function useSessions(projectRoot) {
         bindings: new Map(),
         forkOf: new Map(),
         pinned: new Map(),
+        notes: new Map(),
     });
     // T50 — pin/unpin scrive il sidecar e vuole feedback IMMEDIATO, non al
     // prossimo tick del poll (1.5s): la reload è esposta via ref così il toggle la
@@ -300,23 +301,25 @@ function useSessions(projectRoot) {
             }
             catch {
                 sessions = [];
-                index = { bindings: new Map(), forkOf: new Map(), pinned: new Map() };
+                index = { bindings: new Map(), forkOf: new Map(), pinned: new Map(), notes: new Map() };
             }
-            const { bindings, forkOf, pinned } = index;
-            // La signature copre anche fork e pin: un record di lineage o un toggle di
-            // pin appena scritto cambia la lista renderizzata, quindi deve forzare il
-            // re-render come farebbe un binding nuovo.
+            const { bindings, forkOf, pinned, notes } = index;
+            // La signature copre anche fork, pin e note: un record di lineage, un
+            // toggle di pin o una nota appena scritta cambiano la lista renderizzata,
+            // quindi devono forzare il re-render come farebbe un binding nuovo.
             const sig = sessions.map((s) => `${s.sessionId}:${s.ts}`).join('|') +
                 '#' +
                 [...bindings.entries()].map(([k, v]) => `${k}=${v}`).sort().join(',') +
                 '#' +
                 [...forkOf.entries()].map(([k, v]) => `${k}<${v}`).sort().join(',') +
                 '#' +
-                [...pinned.entries()].map(([k, v]) => `${k}@${v}`).sort().join(',');
+                [...pinned.entries()].map(([k, v]) => `${k}@${v}`).sort().join(',') +
+                '#' +
+                [...notes.entries()].map(([k, v]) => `${k}"${v}`).sort().join(',');
             if (sig === lastSig)
                 return;
             lastSig = sig;
-            setState({ sessions, bindings, forkOf, pinned });
+            setState({ sessions, bindings, forkOf, pinned, notes });
         };
         reloadRef.current = reload;
         reload();
@@ -336,12 +339,6 @@ function useTaskDetail(tasksDir, id) {
     }, [tasksDir, id]);
     return detail;
 }
-// Collassa gli spazi (description multi-paragrafo → blocco unico wrappabile) e
-// tronca: il pane resta compatto e d'altezza prevedibile sotto la lista.
-function truncate(s, n) {
-    const flat = s.replace(/\s+/g, ' ').trim();
-    return flat.length > n ? flat.slice(0, n - 1).trimEnd() + '…' : flat;
-}
 // Normalizzazione larghezza glifi → `normalizeEmoji` in viewport.ts.
 //
 // Sostituisce il precedente `forceEmojiWidth`, che aveva l'intuizione giusta
@@ -406,11 +403,28 @@ function relTime(ts) {
         return `${hr}h`;
     return `${Math.floor(hr / 24)}d`;
 }
+/**
+ * Ripulisce un chunk di stdin prima di scriverlo in un campo di testo.
+ *
+ * `useInput` consegna il CHUNK letto da stdin, non un tasto: un incollaggio — o
+ * una raffica piu' veloce di una read — arriva come stringa unica, byte di
+ * controllo compresi. Non si vedono a schermo, ma Ink li conta nella larghezza
+ * della riga, e in un campo che finisce su disco (la nota, T53) resterebbero
+ * li' per sempre. Le newline diventano SPAZIO invece di sparire: incollare due
+ * righe deve separare le parole, non fonderle.
+ */
+function sanitizeTyped(s) {
+    return s.replace(/[\r\n]/g, ' ').replace(/[\u0000-\u001f\u007f]/g, '');
+}
 const META_KEYS = ['Priority', 'Size', 'Estimated Time', 'Progress'];
 function Deck({ cwd, tasksPath, tasksDir }) {
     const { exit } = useApp();
     const { tasks, loadError } = useTasks(tasksPath);
-    const { sessions, bindings, forkOf, pinned, reload: reloadSessions } = useSessions(cwd);
+    // `notes` esce dall'indice come `sessionNotes`: in questo componente `note` è
+    // già la riga di STATO in fondo al frame (il feedback di un'azione). Due
+    // concetti diversi a una lettera di distanza sarebbero una trappola di
+    // lettura — e di scrittura, visto che `setNote` compare in quasi ogni ramo.
+    const { sessions, bindings, forkOf, pinned, notes: sessionNotes, reload: reloadSessions, } = useSessions(cwd);
     const [focus, setFocus] = useState('tasks');
     // T39 — selezione KEYED SU ID, non su indice. Con una vista trasformata
     // (filtro/sort) l'indice non identifica più la stessa task: leggere l'array
@@ -426,6 +440,11 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     // T30 create · T39 sort/filter.
     const [mode, setMode] = useState('normal');
     const [draft, setDraft] = useState('');
+    // T53 — bozza della nota sulla conversazione selezionata. Si apre PRECARICATA
+    // con la nota esistente: annotare due volte è quasi sempre correggere, non
+    // riscrivere da zero, e un campo vuoto costringerebbe a ridigitare tutto per
+    // cambiare una parola. Confermare il campo vuoto cancella la nota.
+    const [noteDraft, setNoteDraft] = useState('');
     // T39 — vista corrente (filtri + sort) e sua fotografia all'apertura di un
     // modale: la lista si aggiorna dal vivo, quindi `esc` deve poter ripristinare.
     const [view, setView] = useState(() => loadView(cwd));
@@ -456,6 +475,11 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     const launch = useMemo(() => loadLaunch(cwd), [cwd]);
     // Identità (T37): titolo delle tab terminale spawnate col tasto `t`.
     const identity = useMemo(() => loadIdentity(cwd), [cwd]);
+    // T53 — `<owner> <name>`: il core che ogni titolo di tab porta, quindi la
+    // colonna costante da togliere quando serve spazio. Hoistato qui perché ora
+    // lo consumano DUE schermate (lista e ricerca): calcolarlo su ogni call site
+    // è il modo in cui le due smettono di togliere la stessa cosa.
+    const projectCore = identity ? `${identity.owner} ${identity.name}` : null;
     // La vista è una trasformazione DERIVATA, applicata a valle del load: il
     // polling di tasks.md continua a funzionare senza saperne nulla.
     const { visible: viewTasks, hidden: hiddenTasks } = useMemo(() => applyView(tasks, view), [tasks, view]);
@@ -580,6 +604,38 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         });
         child.on('error', () => setNote(`⚠ create-task: '${CLAUDE_CMD}' non lanciabile`));
     }
+    // T53 — apertura del modale nota sulla conversazione selezionata. Come
+    // `openEdit`, la bozza parte dal valore ATTUALE: annotare una seconda volta è
+    // quasi sempre correggere, e ripartire da vuoto costringerebbe a ridigitare
+    // tutto per cambiare una parola.
+    function openNote() {
+        if (!selSessionId)
+            return;
+        setNoteDraft(sessionNotes.get(selSessionId) ?? '');
+        setNote('');
+        setMode('note');
+    }
+    // T53 — ⏎ nel modale nota: scrive il sidecar e ricarica subito, senza
+    // attendere il tick del poll (stesso feedback immediato del pin).
+    //
+    // Il campo VUOTO non è un annullamento: è la CANCELLAZIONE della nota. Sono
+    // due intenzioni diverse e hanno due tasti diversi — `esc` lascia tutto com'è,
+    // `⏎` su campo svuotato toglie la nota. Trattare il vuoto come un no-op (come
+    // fa `submitCreate`, dove però una task senza titolo non esiste) renderebbe
+    // impossibile disannotare una conversazione se non con un editor sul JSONL.
+    function submitNote() {
+        const sid = selSessionId;
+        const text = noteDraft.trim();
+        setMode('normal');
+        setNoteDraft('');
+        if (!sid)
+            return;
+        appendNote(cwd, sid, text);
+        reloadSessions();
+        setNote(text
+            ? `✎ nota su ${sid.slice(0, 8)}: "${truncate(text, 40)}"`
+            : `✎ nota rimossa da ${sid.slice(0, 8)}`);
+    }
     // T41 — apertura dell'edit: la bozza parte dai valori ATTUALI della task, non
     // 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
@@ -713,7 +769,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     // (T39), che cicla sui caratteri del chunk invece di leggerlo intero.
     function typeIntoField(chunk) {
         setNote('');
-        const clean = (s) => s.replace(/[\r\n]/g, ' ').replace(/[\u0000-\u001f\u007f]/g, '');
+        const clean = sanitizeTyped;
         const parts = chunk.split('\t');
         let field = searchField;
         const add = { hash: '', query: '' };
@@ -830,6 +886,43 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             }
             return;
         }
+        // T53 — modale nota. Come create, cattura il testo e corto-circuita la
+        // navigazione (qui `q` è una lettera da scrivere, non il quit).
+        if (mode === 'note') {
+            if (key.escape) {
+                setMode('normal');
+                setNoteDraft('');
+                setNote('N → nota annullata');
+            }
+            else if (key.return) {
+                submitNote();
+            }
+            else if (key.ctrl && input === 'u') {
+                // Svuota il campo in un colpo. NON è una scorciatoia di comodo: il
+                // backspace tenuto premuto cancella UN carattere per CHUNK letto da
+                // stdin, non per pressione (`useInput` consegna il chunk, e per una
+                // raffica di DEL Ink alza `key.backspace` una volta sola) — misurato,
+                // 30 pressioni → 2 caratteri. Siccome «campo vuoto» qui è l'unico modo
+                // di CANCELLARE una nota, dipendere dal backspace renderebbe
+                // l'operazione praticamente non eseguibile. `^U` è il kill-line delle
+                // shell, quindi il gesto è già nelle dita di chi usa un terminale.
+                setNoteDraft('');
+            }
+            else if (key.backspace || key.delete) {
+                setNoteDraft((d) => d.slice(0, -1));
+            }
+            else if (input && !key.ctrl && !key.meta) {
+                // Sanificazione dei byte di controllo, come `typeIntoField` della
+                // ricerca: `useInput` consegna il CHUNK letto da stdin, quindi un
+                // incollaggio porta dentro newline e control char. Invisibili a schermo
+                // ma contati da Ink nella larghezza della riga — e qui finirebbero
+                // scritti su disco, dove resterebbero a sporcare la riga per sempre.
+                // Le newline diventano spazio: incollare due righe deve separare le
+                // parole, non fonderle.
+                setNoteDraft((d) => d + sanitizeTyped(input));
+            }
+            return;
+        }
         // T39 — modale sort a grammatica libera: la SEQUENZA di tasti È la chain.
         // Digitare `ppi` = p(asc) p(desc) i(asc) → [pri desc, id asc]. La lista si
         // riordina dal vivo a ogni pressione.
@@ -1061,6 +1154,23 @@ function Deck({ cwd, tasksPath, tasksDir }) {
                 setNote(`${isPinned ? 'unpin' : '📌 pin'} ${selSessionId.slice(0, 8)}`);
             }
         }
+        else if (input === 'N') {
+            // T53 — nota sulla conversazione selezionata. MAIUSCOLA perché apre un
+            // modale: nel deck le minuscole sono azioni immediate (`f` fork, `p` pin,
+            // `t` term, `c` claude) e le maiuscole aprono un box (`C` create, `E`
+            // edit, `S` sort, `F` filtri). Vincolo di focus identico a `p`: vale anche
+            // su una pinnata STALE, perché annotare «questa non c'è più, era X» è
+            // proprio il caso in cui una nota serve.
+            if (focus !== 'sessions') {
+                setNote('N → nota: seleziona una sessione (←→ per il pane)');
+            }
+            else if (!selSessionId) {
+                setNote('N → nessuna sessione da annotare');
+            }
+            else {
+                openNote();
+            }
+        }
         else if (input === 't') {
             const title = identity ? `🖥️ ${identity.owner} ${identity.name} [term]` : null;
             const child = spawnTerminal(cwd, title);
@@ -1152,7 +1262,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
                 ts: sessions.find((s) => s.sessionId === h.sessionId)?.ts ?? 0,
             };
         }
-        return (_jsx(SearchScreen, { preview: preview, hash: searchHash, query: searchQuery, field: searchField, opts: searchOpts, result: searchResult, rows: searchRows.slice(win.start, win.end), selectedKey: searchSelKey, selectedKind: selectedRow(searchRows, searchSelKey)?.kind ?? null, above: win.start, below: searchRows.length - win.end, capacity: searchCap, bindings: bindings, pinned: pinned, projectCore: identity ? `${identity.owner} ${identity.name}` : null, columns: columns, note: note }));
+        return (_jsx(SearchScreen, { preview: preview, hash: searchHash, query: searchQuery, field: searchField, opts: searchOpts, result: searchResult, rows: searchRows.slice(win.start, win.end), selectedKey: searchSelKey, selectedKind: selectedRow(searchRows, searchSelKey)?.kind ?? null, above: win.start, below: searchRows.length - win.end, capacity: searchCap, bindings: bindings, pinned: pinned, sessionNotes: sessionNotes, projectCore: projectCore, columns: columns, note: note }));
     }
     // ── Budget d'altezza ────────────────────────────────────────────────────
     // Il frame deve restare sotto `rows`, sempre: oltre quella soglia Ink smette
@@ -1192,7 +1302,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 === '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' : '', " \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 === '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 })] }), note ? _jsx(Text, { color: "green", wrap: "truncate-end", children: normalizeEmoji(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: "\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: normalizeEmoji(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:
@@ -1267,13 +1377,7 @@ function searchTitleWidth(columns) {
  * conversazione e non un'altra.
  */
 function conversationLabel(s, core, bound) {
-    let t = s.title;
-    if (core) {
-        const at = t.indexOf(core);
-        if (at >= 0)
-            t = t.slice(at + core.length);
-    }
-    t = t.replace(/^[\s·]+/, '').trim();
+    let t = stripProjectCore(s.title, core);
     if (bound && t === bound)
         t = '';
     return t || s.firstPrompt || '(senza titolo)';
@@ -1309,14 +1413,21 @@ function SearchListHeader({ result, query, above, below, }) {
     }
     return (_jsxs(Text, { bold: true, wrap: "truncate-end", children: [result.shown, " occorrenze in ", result.sessionCount, " conversazioni", result.hidden > 0 ? _jsxs(Text, { color: "yellow", children: [" \u00B7 +", result.hidden, " oltre il cap"] }) : null, above > 0 ? _jsxs(Text, { dimColor: true, children: [" \u00B7 \u2191", above] }) : null, below > 0 ? _jsxs(Text, { dimColor: true, children: [" \u00B7 \u2193", below] }) : null] }));
 }
-function SearchScreen({ preview, hash, query, field, opts, result, rows, selectedKey, selectedKind, above, below, capacity, bindings, pinned, projectCore, columns, note, }) {
+function SearchScreen({ preview, hash, query, field, opts, result, rows, selectedKey, selectedKind, above, below, capacity, bindings, pinned, sessionNotes, projectCore, columns, note, }) {
     const enter = selectedKind === 'session' ? 'resume' : selectedKind === 'hit' ? 'leggi' : '—';
     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: ["ricerca \u00B7 ", _jsx(Text, { color: "yellow", children: "tab" }), " campo \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2191\u2193" }), " naviga \u00B7", ' ', _jsx(Text, { color: "yellow", children: "\u23CE" }), " ", enter, " \u00B7 ", _jsx(Text, { color: "yellow", children: "esc" }), " chiudi"] }), _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "yellow", paddingX: 1, marginTop: 1, children: [_jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: "hash   " }), _jsx(Text, { color: field === 'hash' ? 'yellow' : undefined, children: hash }), field === 'hash' ? _jsx(Text, { inverse: true, children: " " }) : null, !hash ? _jsx(Text, { dimColor: true, children: "  (vuoto = tutte le conversazioni)" }) : null] }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: "chiave " }), _jsx(Text, { color: field === 'query' ? 'yellow' : undefined, children: query }), field === 'query' ? _jsx(Text, { inverse: true, children: " " }) : null] }), _jsx(ToggleHint, { opts: opts })] }), _jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: "gray", paddingX: 1, marginTop: 1, children: [_jsx(SearchListHeader, { result: result, query: query, above: above, below: below }), rows.slice(0, Math.max(0, capacity)).map((row) => {
                         const sel = row.key === selectedKey;
                         if (row.kind === 'session') {
                             const s = row.session;
                             const bound = bindings.get(s.sessionId);
-                            return (_jsxs(Text, { inverse: sel, wrap: "truncate-end", children: [sel ? CARET : CARET_OFF, pinned.has(s.sessionId) ? _jsx(Text, { color: "yellow", children: "\uD83D\uDCCC" }) : _jsx(Text, { dimColor: true, children: "\u25CB" }), ' ', _jsx(Text, { color: "cyan", children: s.sessionId.slice(0, 8) }), _jsx(Text, { dimColor: true, children: " \u00B7 " }), bound ?? _jsx(Text, { dimColor: true, children: "spot" }), _jsx(Text, { dimColor: true, children: " \u00B7 " }), truncate(conversationLabel(s, projectCore, bound), searchTitleWidth(columns)), _jsxs(Text, { dimColor: true, children: ['  ', "(", row.hitCount, row.hidden > 0 ? `+${row.hidden}` : '', ") ", fmtDateTime(s.ts)] })] }, row.key));
+                            const rowNote = sessionNotes.get(s.sessionId);
+                            const noteShown = rowNote ? truncate(rowNote, 24) : '';
+                            // `+3` = i due caporali e lo spazio che li separa dall'etichetta.
+                            // Il pavimento non è cosmetico: senza, un terminale stretto manda
+                            // l'argomento di `truncate` sotto zero e `slice` conta dalla FINE
+                            // della stringa — mostrerebbe la coda del titolo, in silenzio.
+                            const restWidth = Math.max(8, searchTitleWidth(columns) - (noteShown ? noteShown.length + 3 : 0));
+                            return (_jsxs(Text, { inverse: sel, wrap: "truncate-end", children: [sel ? CARET : CARET_OFF, pinned.has(s.sessionId) ? _jsx(Text, { color: "yellow", children: "\uD83D\uDCCC" }) : _jsx(Text, { dimColor: true, children: "\u25CB" }), ' ', _jsx(Text, { color: "cyan", children: s.sessionId.slice(0, 8) }), _jsx(Text, { dimColor: true, children: " \u00B7 " }), bound ?? _jsx(Text, { dimColor: true, children: "spot" }), _jsx(Text, { dimColor: true, children: " \u00B7 " }), noteShown ? _jsxs(Text, { color: "yellow", bold: true, children: ["\u00AB", noteShown, "\u00BB "] }) : null, _jsx(Text, { dimColor: Boolean(noteShown), children: truncate(conversationLabel(s, projectCore, bound), restWidth) }), _jsxs(Text, { dimColor: true, children: ['  ', "(", row.hitCount, row.hidden > 0 ? `+${row.hidden}` : '', ") ", fmtDateTime(s.ts)] })] }, row.key));
                         }
                         const h = row.hit;
                         return (_jsxs(Text, { inverse: sel, wrap: "truncate-end", children: [sel ? CARET : CARET_OFF, _jsx(Text, { dimColor: true, children: String(h.idx).padStart(4) }), ' ', _jsx(Text, { color: KIND_COLOR[h.kind], children: KIND_TAG[h.kind] }), " ", h.excerpt] }, row.key));
@@ -1376,7 +1487,7 @@ function TasksPane({ tasks, filtered, total, hidden, view, selected, spotCount,
                 return (_jsxs(Text, { inverse: sel && focused, bold: sel && !focused, dimColor: !sel && isDone(task.prog), wrap: "truncate-end", children: [sel ? CARET : CARET_OFF, task.id, "  ", forceEmojiWidth(task.pri), "  ", displayProg(task.prog), "  ", task.desc, n > 0 ? ` (${n})` : ''] }, task.id));
             })), detail && detailLines > 0 ? (_jsx(DetailPane, { detail: detail, maxLines: detailLines, columns: columns })) : null] }));
 }
-function SessionsPane({ parentLabel, isSpot, rows, total, pinnedCount, hidden, selectedId, focused, above, below, detail, firstLines, lastLines, columns, forkOf, }) {
+function SessionsPane({ parentLabel, isSpot, rows, total, pinnedCount, hidden, selectedId, focused, above, below, detail, firstLines, lastLines, columns, forkOf, sessionNotes, projectCore, }) {
     return (_jsxs(Box, { flexDirection: "column", width: "50%", borderStyle: "single", borderColor: focused ? 'cyan' : 'gray', paddingX: 1, children: [_jsxs(Text, { bold: true, color: focused ? 'cyan' : undefined, wrap: "truncate-end", children: ["Sessions \u00B7 ", parentLabel, " (", total, ")", pinnedCount > 0 ? _jsxs(Text, { color: "yellow", children: [" \u00B7 \uD83D\uDCCC", pinnedCount] }) : null, hidden > 0 ? _jsxs(Text, { dimColor: true, children: [" \u00B7 +", hidden, " pi\u00F9 vecchie"] }) : null, above > 0 ? _jsxs(Text, { dimColor: true, children: [" \u00B7 \u2191", above] }) : null, below > 0 ? _jsxs(Text, { dimColor: true, children: [" \u00B7 \u2193", below] }) : null] }), total === 0 ? (_jsx(Text, { color: "yellow", wrap: "truncate-end", children: isSpot ? 'nessuna sessione libera' : 'nessuna sessione legata a questa task' })) : (rows.map((row, i) => {
                 // T50 — separatore leggero fra pinnate e contestuali: riga dim, non un
                 // box pesante (coerente con lo styling delle Done dimmate).
@@ -1387,7 +1498,7 @@ function SessionsPane({ parentLabel, isSpot, rows, total, pinnedCount, hidden, s
                 // T50 — pin stale: transcript sparito, nessuna Session da mostrare.
                 // Riga navigabile e spinnabile (`p`), marcata, mai un crash.
                 if (row.kind === 'pinned' && row.stale) {
-                    return (_jsxs(Text, { inverse: sel && focused, bold: sel && !focused, dimColor: true, wrap: "truncate-end", children: [sel ? CARET : CARET_OFF, _jsx(Text, { color: "yellow", children: WARN }), " pin stale", ' ', _jsx(Text, { dimColor: true, children: row.sessionId.slice(0, 8) })] }, row.sessionId));
+                    return (_jsxs(Text, { inverse: sel && focused, bold: sel && !focused, dimColor: true, wrap: "truncate-end", children: [sel ? CARET : CARET_OFF, _jsx(Text, { color: "yellow", children: WARN }), " pin stale", ' ', _jsx(Text, { dimColor: true, children: row.sessionId.slice(0, 8) }), sessionNotes.get(row.sessionId) ? (_jsxs(Text, { color: "yellow", children: [" \u00AB", truncate(sessionNotes.get(row.sessionId), 30), "\u00BB"] })) : null] }, row.sessionId));
                 }
                 const s = row.session; // non-stale → session presente
                 const isPinnedRow = row.kind === 'pinned';
@@ -1395,8 +1506,11 @@ function SessionsPane({ parentLabel, isSpot, rows, total, pinnedCount, hidden, s
                 // righe sarebbero identiche a occhio. `⑂` sta PRIMA del titolo, dove
                 // la troncatura non arriva mai.
                 const forked = forkOf.has(s.sessionId);
-                return (_jsxs(Text, { inverse: sel && focused, bold: sel && !focused, wrap: "truncate-end", children: [sel ? CARET : CARET_OFF, isPinnedRow ? (_jsx(Text, { color: "yellow", children: "\uD83D\uDCCC" })) : isSpot ? (_jsx(Text, { dimColor: true, children: "\u25CB" })) : (_jsx(Text, { color: "green", children: "\uD83D\uDD17" })), ' ', forked ? _jsx(Text, { color: "magenta", children: "\u2442 " }) : null, truncate(s.title, forked ? 42 : 44), ' ', _jsxs(Text, { dimColor: true, children: ["\u00B7 ", s.gitBranch || '-', " \u00B7 ", relTime(s.ts)] })] }, s.sessionId));
-            })), detail ? (_jsx(SessionDetailPane, { s: detail, firstLines: firstLines, lastLines: lastLines, columns: columns, origin: forkOf.get(detail.sessionId) ?? null })) : null] }));
+                // T53 — con una nota il prefisso di progetto sparisce e le sue colonne
+                // passano alla nota; senza, il titolo resta com'è (vedi `rowLabel`).
+                const label = rowLabel(s.title, sessionNotes.get(s.sessionId), projectCore, forked ? 42 : 44);
+                return (_jsxs(Text, { inverse: sel && focused, bold: sel && !focused, wrap: "truncate-end", children: [sel ? CARET : CARET_OFF, isPinnedRow ? (_jsx(Text, { color: "yellow", children: "\uD83D\uDCCC" })) : isSpot ? (_jsx(Text, { dimColor: true, children: "\u25CB" })) : (_jsx(Text, { color: "green", children: "\uD83D\uDD17" })), ' ', forked ? _jsx(Text, { color: "magenta", children: "\u2442 " }) : null, label.note ? (_jsxs(Text, { color: "yellow", bold: true, children: ["\u00AB", label.note, "\u00BB"] })) : null, label.note && label.rest ? ' ' : null, label.rest ? _jsx(Text, { dimColor: Boolean(label.note), children: label.rest }) : null, ' ', _jsxs(Text, { dimColor: true, children: ["\u00B7 ", s.gitBranch || '-', " \u00B7 ", relTime(s.ts)] })] }, s.sessionId));
+            })), detail ? (_jsx(SessionDetailPane, { s: detail, firstLines: firstLines, lastLines: lastLines, columns: columns, origin: forkOf.get(detail.sessionId) ?? null, note: sessionNotes.get(detail.sessionId) ?? '' })) : null] }));
 }
 // T49 — detail pane della sessione selezionata (hover), gemello del DetailPane
 // task. Tutti i campi vengono dal parse già cached dell'adapter (mtime-keyed):
@@ -1406,11 +1520,11 @@ function SessionsPane({ parentLabel, isSpot, rows, total, pinnedCount, hidden, s
 // — senza, il titolo È già il primo prompt e la riga lo duplicherebbe (D4
 // preflight). Le righe rese non superano mai il riservato dal budget
 // (`firstLines`/`lastLines`); renderne meno è sicuro (frame più corto).
-function SessionDetailPane({ s, firstLines, lastLines, columns, origin, }) {
+function SessionDetailPane({ s, firstLines, lastLines, columns, origin, note, }) {
     const width = detailTextWidth(columns);
     const first = s.customTitle && firstLines > 0 ? wrapLines(s.firstPrompt, width, firstLines) : [];
     const last = s.lastReply && lastLines > 0 ? wrapLines(s.lastReply, width, lastLines) : [];
-    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, borderStyle: "single", borderColor: "gray", paddingX: 1, children: [_jsx(Text, { bold: true, wrap: "truncate-end", children: s.title }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [fmtSize(s.sizeBytes), " \u00B7 ", s.turns, " turni \u00B7 ", fmtDateTime(s.ts), origin ? ` · ⑂ da ${origin.slice(0, 8)}` : ''] }), first.map((line, i) => (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [i === 0 ? '» ' : '  ', line] }, `f${i}`))), last.map((line, i) => (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [i === 0 ? '« ' : '  ', line] }, `l${i}`)))] }));
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, borderStyle: "single", borderColor: "gray", paddingX: 1, children: [_jsxs(Text, { bold: true, wrap: "truncate-end", children: [note ? _jsxs(Text, { color: "yellow", children: ["\u00AB", note, "\u00BB "] }) : null, _jsx(Text, { dimColor: Boolean(note), children: s.title })] }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [fmtSize(s.sizeBytes), " \u00B7 ", s.turns, " turni \u00B7 ", fmtDateTime(s.ts), origin ? ` · ⑂ da ${origin.slice(0, 8)}` : ''] }), first.map((line, i) => (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [i === 0 ? '» ' : '  ', line] }, `f${i}`))), last.map((line, i) => (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [i === 0 ? '« ' : '  ', line] }, `l${i}`)))] }));
 }
 /**
  * Righe non-wrappabili del dettaglio (titolo + meta + commit) e loro conteggio.

package/dist/session-list.js

@@ -14,6 +14,68 @@
 //  - Trap T39: la selezione è KEYED SU sessionId, non su indice posizionale. La
 //    lista è una vista trasformata (due gruppi + separatore): un indice grezzo
 //    identificherebbe la riga sbagliata dopo un pin/cambio-contesto.
+import { truncate } from './viewport.js';
+// ── T53 · etichetta di riga ────────────────────────────────────────────────
+/**
+ * Toglie dal titolo il core `<owner> <name>` del progetto e la punteggiatura di
+ * giunzione che resta appesa davanti.
+ *
+ * Il titolo di una sessione È la label della tab Ptyxis (`🧵 LOCAL loom-works ·
+ * T52`): dentro un deck che mostra un progetto solo, il core è una COLONNA
+ * COSTANTE ripetuta su ogni riga. Toglierlo libera le colonne per ciò che
+ * distingue davvero una conversazione dall'altra.
+ *
+ * `core` null (file config assente o senza identità) → titolo intatto: senza
+ * sapere cosa togliere non si indovina, si lascia stare.
+ */
+export function stripProjectCore(title, core) {
+    let t = title;
+    if (core) {
+        const at = t.indexOf(core);
+        if (at >= 0)
+            t = t.slice(at + core.length);
+    }
+    return t.replace(/^[\s·]+/, '').trim();
+}
+/** Colonne minime perché un residuo dopo la nota valga la riga: sotto questa
+ *  soglia si vedrebbero due lettere e un'ellissi, cioè rumore. */
+const MIN_REST = 6;
+/** Colonne garantite alla nota quando c'è anche un residuo da mostrare: la nota
+ *  è la parte scelta da un umano, non è lei a cedere il posto per prima. */
+const MIN_NOTE = 14;
+/**
+ * Cosa scrivere sulla riga di una conversazione, dentro `budget` colonne.
+ *
+ * Due regimi, ed è una decisione deliberata che NON siano lo stesso:
+ *
+ *  - **senza nota** → il titolo resta INTATTO, prefisso di progetto incluso.
+ *    Togliere il core qui lascerebbe `T52` o il nulla (i titoli di tab non
+ *    contengono altro), cioè meno informazione di prima, non più spazio.
+ *  - **con nota** → il core se ne va: la nota dice già quale conversazione è,
+ *    quindi le colonne del prefisso passano a lei. Il residuo (tipicamente la
+ *    task, `T52`) segue dimmato se ci sta; se non resta nulla va benissimo.
+ *
+ * Il budget si divide dando la precedenza alla nota, ma senza affamare il
+ * residuo: con entrambi presenti la nota cede fino a `MIN_NOTE` per lasciare
+ * spazio al residuo, e il residuo sparisce del tutto sotto `MIN_REST` invece di
+ * ridursi a un moncone.
+ */
+export function rowLabel(title, note, core, budget) {
+    if (!note)
+        return { note: '', rest: truncate(title, Math.max(0, budget)) };
+    // 2 colonne per i caporali « », 1 per lo spazio prima del residuo.
+    const rest = stripProjectCore(title, core);
+    const noteBudget = Math.max(0, budget - 2);
+    if (!rest)
+        return { note: truncate(note, noteBudget), rest: '' };
+    // Il `min` col budget totale non è ridondante: su un pane strettissimo
+    // `MIN_NOTE` supererebbe le colonne disponibili e la riga andrebbe a capo —
+    // che è precisamente il difetto che ogni larghezza qui dentro esiste per
+    // evitare (una riga wrappata sfonda il budget d'ALTEZZA, non solo l'estetica).
+    const shownNote = truncate(note, Math.min(noteBudget, Math.max(MIN_NOTE, noteBudget - MIN_REST - 1)));
+    const restBudget = noteBudget - shownNote.length - 1;
+    return { note: shownNote, rest: restBudget >= MIN_REST ? truncate(rest, restBudget) : '' };
+}
 export function assembleSessionList(childSessions, allSessions, pinned, maxContext) {
     // Le pinnate si risolvono contro TUTTE le sessioni del progetto, non solo le
     // figlie del parent: una pinnata può appartenere a un'altra task. Assente

package/dist/task-edit.js

@@ -3,7 +3,7 @@
 // isolata in `writeTaskEdit`, così la grammatica delle sostituzioni è testabile
 // senza toccare il filesystem.
 import { readFileSync, writeFileSync } from 'node:fs';
-import { findTaskFile } from './tasks.js';
+import { TASK_ID_RE, findTaskFile } from './tasks.js';
 // Il task file scrive la priorità per NOME (`- **Priority**: Med`), tasks.md la
 // scrive come GLIFO (colonna Pri). Due rappresentazioni dello stesso valore →
 // due mappe, entrambe keyed sul nome canonico di view.ts (unica fonte del rango).
@@ -81,11 +81,11 @@ export function initialDetail(current, prog, date = today()) {
  * 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.
  *
- * L'id deve rispettare `^T\d+$`, stesso gate di `parseTasks`: senza, un id
- * arbitrario matcherebbe la riga di HEADER (`| ID | Pri | K | Prog |`) o quella
- * di separatore, riscrivendone le celle e sfondando la tabella.
+ * 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.
  */
-const TASK_ID_RE = /^T\d+$/;
 export function updateTasksMdRow(content, id, priGlyph, progGlyph) {
     if (!TASK_ID_RE.test(id))
         return { content, ok: false };

package/dist/task-index.js

@@ -15,6 +15,10 @@ export function appendTaskBinding(projectRoot, sessionId, taskId) {
 export function appendPin(projectRoot, sessionId, pinned) {
     appendSessionRecord(projectRoot, { sessionId, pinned });
 }
+/** T53 — scrive (o cancella, con `note` vuota) la nota di una conversazione. */
+export function appendNote(projectRoot, sessionId, note) {
+    appendSessionRecord(projectRoot, { sessionId, note });
+}
 // Una sola lettura del JSONL per entrambe le mappe: il deck poll-a l'indice a
 // ogni tick, leggere il file due volte raddoppierebbe l'I/O per nulla.
 // Last-wins per campo (un re-pin dello stesso sessionId sovrascrive), e i due
@@ -24,12 +28,13 @@ export function loadSessionIndex(projectRoot) {
     const bindings = new Map();
     const forkOf = new Map();
     const pinned = new Map();
+    const notes = new Map();
     let content;
     try {
         content = readFileSync(taskIndexPath(projectRoot), 'utf8');
     }
     catch {
-        return { bindings, forkOf, pinned };
+        return { bindings, forkOf, pinned, notes };
     }
     let order = 0; // posizione crescente dei record pinned → rango di pin (D2)
     for (const line of content.split('\n')) {
@@ -51,10 +56,19 @@ export function loadSessionIndex(projectRoot) {
                 else
                     pinned.delete(d.sessionId);
             }
+            // T53 — stesso last-wins: la stringa vuota è la CANCELLAZIONE, non una
+            // 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') {
+                if (d.note)
+                    notes.set(d.sessionId, d.note);
+                else
+                    notes.delete(d.sessionId);
+            }
         }
         catch {
             // riga corrotta → skip
         }
     }
-    return { bindings, forkOf, pinned };
+    return { bindings, forkOf, pinned, notes };
 }

package/dist/tasks.js

@@ -1,6 +1,13 @@
 import { readFileSync, readdirSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { normalizeEmoji } from './viewport.js';
+/**
+ * Forma di un ID task: `T` (code) o `D` (doc) + numero. FONTE UNICA del gate —
+ * `parseTasks` lo usa per scartare header/separatore della tabella, `task-edit`
+ * per non riscrivere per sbaglio quelle stesse righe. Tenerlo in un posto solo
+ * evita che i due gate divergano (uno accetterebbe righe che l'altro rifiuta).
+ */
+export const TASK_ID_RE = /^[TD]\d+$/;
 // D1 (preflight T20): default docs/tasks.md, override della docs-root via env
 // LOOM_DECK_DOCS_ROOT (es. questo progetto usa `runtime`). No auto-detect.
 export function resolveTasksPath(cwd = process.cwd()) {
@@ -13,9 +20,11 @@ export function resolveTasksDir(cwd = process.cwd()) {
     return join(dirname(resolveTasksPath(cwd)), 'tasks');
 }
 // Estrae le righe `| Tnn | Pri | K | Prog | Task |` della Tasks Overview.
-// Il prefisso task è `T` (contratto plugin); le doc-task `D{N}` e le righe
-// header/separatore non matchano `^T\d+$` → scartate. deck-run agisce solo
-// su task T (run-task), quindi le D non hanno azione qui.
+// Due prefissi ammessi (contratto plugin, counter separati): `T` = code task,
+// `D` = doc task. Le D entrano in lista come le T perché `deck-run` NON inietta
+// `run-task`: il prompt iniziale è un recap diretto ("recap stato task <id>"),
+// valido identico su una doc task. Righe header/separatore non matchano `^[TD]\d+$`
+// → scartate.
 export function parseTasks(content) {
     const tasks = [];
     for (const line of content.split('\n')) {
@@ -25,7 +34,7 @@ export function parseTasks(content) {
         const cells = t.split('|').map((c) => c.trim());
         // cells[0] = '' (prima del primo |), cells[last] = '' (dopo l'ultimo |)
         const id = cells[1];
-        if (!/^T\d+$/.test(id))
+        if (!TASK_ID_RE.test(id))
             continue;
         // Colonne overview: | ID | Pri | K | Prog | Task | → cells[2]=Pri (icona
         // priorità), cells[4]=Prog. K (Kind, cells[3]) non serve al deck.
@@ -77,7 +86,10 @@ export function parseTaskDetail(id, content) {
     let inDesc = false;
     for (const line of content.split('\n')) {
         if (!title && line.startsWith('# ')) {
-            title = line.replace(/^#\s+/, '').replace(/^Task:\s*/, '').trim();
+            // I due template scrivono H1 diversi — `# Task: …` (code) e
+            // `# Doc Task: …` (doc): entrambi i cappelli vanno via, il titolo mostrato
+            // è la descrizione, non la sua categoria (già data dall'id).
+            title = line.replace(/^#\s+/, '').replace(/^(?:Doc\s+)?Task:\s*/, '').trim();
             continue;
         }
         if (line.startsWith('## ')) {

package/dist/view.js

@@ -53,11 +53,16 @@ export function progRank(glyph) {
     return PROG_TABLE.find((e) => e.glyph === g)?.rank ?? UNKNOWN_RANK;
 }
 // `T10`.localeCompare(`T9`) mette T10 prima: l'ID va confrontato NUMERICO.
-// parseTasks ammette solo /^T\d+$/, ma un id fuori forma non deve far esplodere
-// il comparator → finisce in coda con Number.MAX_SAFE_INTEGER.
+// parseTasks ammette due prefissi con counter SEPARATI (`T` code, `D` doc) →
+// il solo numero non basta, T01 e D01 collidono. Il prefisso pesa quindi come
+// cifra più significativa (T prima di D, blocco doc in coda), il numero come
+// meno significativa: il rango resta un intero singolo, quindi il comparator
+// della chain non cambia forma. Il gap 1e6 è oltre qualunque counter reale.
+// Un id fuori forma non deve far esplodere il comparator → coda con MAX_SAFE.
+const ID_PREFIX_RANK = { T: 0, D: 1 };
 export function idNum(id) {
-    const m = /^T(\d+)$/.exec(id);
-    return m ? Number(m[1]) : Number.MAX_SAFE_INTEGER;
+    const m = /^([TD])(\d+)$/.exec(id);
+    return m ? ID_PREFIX_RANK[m[1]] * 1_000_000 + Number(m[2]) : Number.MAX_SAFE_INTEGER;
 }
 function rankOf(task, key) {
     if (key === 'pri')

package/dist/viewport.js

@@ -50,6 +50,25 @@ export function normalizeEmoji(s) {
     }
     return out;
 }
+/**
+ * Collassa gli spazi (description multi-paragrafo → blocco unico) e tronca a
+ * `n` caratteri, con ellissi quando taglia.
+ *
+ * Vive qui e non nel modulo di render perché è misura di larghezza come il
+ * resto del file, e perché la cascata dell'etichetta di riga (`session-list.ts`)
+ * ne ha bisogno restando pura — importarla da `cli.tsx` tirerebbe dentro Ink e
+ * React in un modulo che si testa senza terminale.
+ */
+export function truncate(s, n) {
+    // Budget non positivo → stringa vuota, e va detto ESPLICITAMENTE: senza questa
+    // guardia `n = 0` produce `slice(0, -1)`, e un indice negativo in JS conta
+    // dalla FINE — restituirebbe quasi tutta la stringa invece di niente, cioè
+    // l'opposto del troncamento, in silenzio e proprio quando lo spazio manca.
+    if (n <= 0)
+        return '';
+    const flat = s.replace(/\s+/g, ' ').trim();
+    return flat.length > n ? flat.slice(0, n - 1).trimEnd() + '…' : flat;
+}
 /** Righe lasciate libere sotto il frame. La condizione di Ink è `>=`, quindi
  *  basterebbe 1; ne teniamo 1 come margine per l'a-capo del cursore. */
 export const SLACK = 1;
@@ -75,6 +94,7 @@ const MIN_SESSION_ROWS = 3;
 export const MODAL_HEIGHT = {
     normal: 0,
     create: 4, // marginTop + 2 bordi + 1 riga input
+    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

package/package.json

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