@lamemind/loom-deck 0.18.1 → 0.20.0

package/dist/cli.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } 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';
@@ -14,7 +15,7 @@ import { appendNote, appendPin, appendSessionRecord, appendTaskBinding, loadSess
 import { assembleSessionList, firstSelectableId, moveSelection, rowIndexOf, rowLabel, selectedSession, stripProjectCore, } from './session-list.js';
 import { launchLegend, loadIdentity, loadLaunch } from './config.js';
 import { isCompact, layoutBudget, readerCapacity, searchListCapacity, searchPreviewCapacity, windowRange, } from './viewport.js';
-import { cut, sanitize, termWidth, wrapLines, wrapWithOffsets, } from './width.js';
+import { caretWindow, cut, sanitize, termWidth, wrapLines, wrapWithOffsets, } from './width.js';
 import { applyView, cycleSort, describeSort, priName, progName, toggleHidden, PRI_ENTRIES, PROG_ENTRIES, } from './view.js';
 import { initialDetail, progressText, writeTaskEdit, PRI_GLYPH, PRI_LABEL, PROG_GLYPH, } from './task-edit.js';
 import { loadView, saveView, viewFilePath } from './view-store.js';
@@ -29,6 +30,36 @@ 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;
+}
+/** Chiave della bozza scritta dalla riga di testo `r`. */
+function editField(r) {
+    return r === 2 ? 'detail' : 'title';
+}
+/**
+ * Lunghezza in CODE POINT. Il caret ci indicizza sopra: `.length` conterebbe le
+ * code unit UTF-16 e un'emoji nel titolo varrebbe 2 posizioni, cioè un cursore
+ * che si ferma a metà glifo e un `slice` che lo spezza in due surrogati.
+ */
+function cpLen(s) {
+    return [...s].length;
+}
+/** Inserisce `ins` alla posizione `at` (code point). */
+function insertAt(s, at, ins) {
+    const cp = [...s];
+    return cp.slice(0, at).join('') + ins + cp.slice(at).join('');
+}
+/** Toglie il code point in posizione `at`; fuori range = stringa invariata. */
+function removeAt(s, at) {
+    const cp = [...s];
+    if (at < 0 || at >= cp.length)
+        return s;
+    cp.splice(at, 1);
+    return cp.join('');
+}
 // 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 +92,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 +137,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 +158,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 +169,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 +186,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 +206,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 +223,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 +266,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 +679,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 +693,10 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             pri: priName(selTask.pri) ?? 'med',
             prog,
             detail: initialDetail(detail?.fields['Progress'] ?? '', prog),
+            title: selTask.rawDesc,
+            // Si apre sulla riga 0 (priorità), che non è un campo di testo: il caret
+            // prende la sua posizione entrando in una riga di testo con ↑↓.
+            caret: 0,
         });
         setEditRow(0);
         setNote('');
@@ -648,9 +714,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 +740,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 +1041,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) {
@@ -974,13 +1054,15 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             else if (key.return) {
                 submitEdit();
             }
-            else if (key.upArrow) {
-                setEditRow((r) => ((r + 2) % 3));
-            }
-            else if (key.downArrow) {
-                setEditRow((r) => ((r + 1) % 3));
-            }
-            else if (key.leftArrow || key.rightArrow) {
+            else if (key.upArrow || key.downArrow) {
+                const next = ((editRow + EDIT_ROWS + (key.upArrow ? -1 : 1)) % EDIT_ROWS);
+                setEditRow(next);
+                // Il caret segue la riga attiva e atterra in CODA al nuovo campo: è la
+                // posizione da cui si continua a scrivere, ed è anche l'unica che non
+                // dipende da dove stava il cursore nel campo precedente.
+                setEdit((e) => (e && isTextRow(next) ? { ...e, caret: cpLen(e[editField(next)]) } : e));
+            }
+            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 +1075,52 @@ function Deck({ cwd, tasksPath, tasksDir }) {
                         : e);
                 }
             }
-            else if (editRow === 2) {
-                if (key.backspace || key.delete) {
-                    setEdit((e) => (e ? { ...e, detail: e.detail.slice(0, -1) } : e));
+            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 = editField(editRow);
+                if (key.ctrl) {
+                    // T54 — ramo CTRL ANTEPOSTO a quelli su carattere, come in modalità
+                    // normale: `^A` e `a` arrivano con lo stesso `input`, quindi senza
+                    // questa precedenza il `^A` finirebbe dentro il testo.
+                    //
+                    // `^A`/`^E` (convenzione readline) perché `Home`/`End` NON sono
+                    // esposte da `useInput`: arrivano come input vuoto, indistinguibili
+                    // da qualunque altro tasto senza nome.
+                    //
+                    // `^D` è il delete-forward, e anche qui il motivo è un limite di Ink:
+                    // il tasto Backspace fisico manda `\x7f` e il tasto Canc manda
+                    // `\x1b[3~`, ma `parseKeypress` li battezza ENTRAMBI `delete` e
+                    // svuota `input` — a valle sono lo stesso evento. `key.delete` va
+                    // quindi al backspace (il tasto che si usa davvero) e la
+                    // cancellazione in avanti prende il suo tasto readline.
+                    if (input === 'a')
+                        setEdit((e) => (e ? { ...e, caret: 0 } : e));
+                    else if (input === 'e')
+                        setEdit((e) => (e ? { ...e, caret: cpLen(e[field]) } : e));
+                    else if (input === 'd')
+                        setEdit((e) => (e ? { ...e, [field]: removeAt(e[field], e.caret) } : e));
                 }
-                else if (input && !key.ctrl && !key.meta) {
-                    setEdit((e) => (e ? { ...e, detail: e.detail + input } : e));
+                else if (key.leftArrow || key.rightArrow) {
+                    // CLAMP agli estremi, non wrap: a inizio campo `←` non deve saltare in
+                    // fondo. Le liste di valori (righe 0/1) ciclano perché sono 3-4 voci;
+                    // un testo no — il salto sarebbe indistinguibile da uno sfarfallio.
+                    const d = key.leftArrow ? -1 : 1;
+                    setEdit((e) => e ? { ...e, caret: Math.max(0, Math.min(cpLen(e[field]), e.caret + d)) } : e);
+                }
+                else if (key.backspace || key.delete) {
+                    setEdit((e) => e ? { ...e, [field]: removeAt(e[field], e.caret - 1), caret: Math.max(0, e.caret - 1) } : e);
+                }
+                else if (input && !key.meta) {
+                    // `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. Ed è per lo stesso motivo che
+                    // il caret avanza della LUNGHEZZA del chunk, non di uno: un incollaggio
+                    // entra tutto insieme.
+                    const ins = sanitizeTyped(input);
+                    setEdit((e) => e ? { ...e, [field]: insertAt(e[field], e.caret, ins), caret: e.caret + cpLen(ins) } : e);
                 }
             }
             return;
@@ -1285,7 +1407,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, o cursore sul testo \u00B7 ", _jsx(Text, { color: "yellow", children: "^A/^E" }), " inizio/fine \u00B7", ' ', _jsx(Text, { color: "yellow", children: "^D" }), " canc \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " salva+commit \u00B7", ' ', _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: ["\u2191\u2193 naviga \u00B7 \u2190\u2192 pane \u00B7 \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 +1429,33 @@ 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)))] }));
 }
+/**
+ * Campo di testo del modale edit: finestra ancorata al caret + cursore inverso
+ * nella posizione REALE.
+ *
+ * Il cursore non è più uno spazio inverso appiccicato in coda ma la cella `at`
+ * della finestra — cioè il carattere su cui il caret sta davvero. Fuori fuoco
+ * (`focused` falso) il caret non si disegna e la finestra si ancora in fondo,
+ * che è la vista utile per un campo che non si sta scrivendo.
+ */
+function EditTextField({ label, value, caret, focused, cols, }) {
+    const win = caretWindow(value, focused ? caret : cpLen(value), cols);
+    return (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: label }), _jsxs(Text, { children: ['  ', sanitize(win.head)] }), focused ? _jsx(Text, { inverse: true, children: sanitize(win.at) }) : null, _jsx(Text, { children: sanitize(win.tail) })] }));
+}
 // 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 dei campi di testo, 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 fieldBudget = 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(EditTextField, { label: "prog  ", value: draft.detail, caret: draft.caret, focused: row === 2, cols: fieldBudget }), !draft.detail && row !== 2 ? _jsx(Text, { dimColor: true, children: "(default)" }) : null] }), _jsxs(Text, { children: [mark(3), _jsx(EditTextField, { label: "titolo", value: draft.title, caret: draft.caret, focused: row === 3, cols: fieldBudget })] }), _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/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/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/dist/width.js

@@ -202,6 +202,102 @@ export function cut(s, cols) {
     // informazione, tolgono una colonna di testo.
     return out.trimEnd().replace(/…$/, '') + '…';
 }
+/**
+ * Larghezza in colonne di UN carattere **dopo** `sanitize`.
+ *
+ * Misurare il carattere grezzo significa misurare qualcosa che nel frame non
+ * entra mai: la sanificazione può cambiarne la larghezza (`✔`, largo 1, diventa
+ * `✅`, largo 2 — invariante ①). Chi taglia su un budget deve contare le colonne
+ * che verranno DISEGNATE, altrimenti sbaglia di una colonna per ogni glifo
+ * sostituito. La cache di `fixChar` rende la doppia chiamata gratuita.
+ */
+export function cellWidth(ch) {
+    return termWidth(sanitize(ch));
+}
+/**
+ * Porzione visibile di un campo di testo con un caret MOBILE, larga al più
+ * `cols` colonne.
+ *
+ * Perché non basta un taglio dalla coda: mostrare sempre le ultime `cols`
+ * colonne è corretto solo finché si scrive in fondo. Con un caret che si muove,
+ * appena rientra a sinistra del bordo visibile si finirebbe per digitare in un
+ * punto che non si vede — il testo deve scorrere DIETRO il cursore, non
+ * viceversa.
+ *
+ * Il caret è un indice per CODE POINT (`[...s]`), non per code unit: un'emoji
+ * nel titolo sono due code unit e muoversi per unità la spezzerebbe a metà.
+ *
+ * La finestra si espande ALTERNANDO i due lati, così il cursore resta al centro
+ * finché il testo lo consente: muoversi di un carattere fa scorrere il testo di
+ * uno, invece di far saltare la vista da un bordo all'altro. Le ellissi entrano
+ * nel budget e ne escono da sole — quando un lato tocca il bordo del testo la
+ * sua ellissi non serve più e la colonna liberata va all'altro lato.
+ *
+ * Restituisce i tre pezzi già pronti al render (non la sola stringa visibile):
+ * il cursore si disegna invertendo `at`, e ricavarlo tagliando `visible` a
+ * `cursorCol` vorrebbe dire rifare qui fuori lo stesso conteggio in colonne.
+ */
+export function caretWindow(text, caret, cols) {
+    const empty = { head: '', at: '', tail: '', cursorCol: 0 };
+    if (cols <= 0)
+        return empty;
+    const chars = [...text];
+    const c = Math.max(0, Math.min(caret, chars.length));
+    // Il caret a fine campo non ha un carattere sotto di sé: gliene si dà uno
+    // virtuale, così il cursore ha sempre una cella da invertire e la finestra ha
+    // sempre un centro. È lo spazio inverso che il modale disegnava in coda.
+    const cells = c === chars.length ? [...chars, ' '] : chars;
+    const len = cells.length;
+    const w = cells.map(cellWidth);
+    const cost = (s, e, tw) => tw + (s > 0 ? 1 : 0) + (e < len ? 1 : 0);
+    let start = c;
+    let end = c + 1;
+    let textW = w[c];
+    // Budget più stretto della sola cella del cursore: non c'è finestra da dare.
+    if (cost(start, end, textW) > cols)
+        return empty;
+    let goRight = true;
+    let stuckL = false;
+    let stuckR = false;
+    while (!stuckL || !stuckR) {
+        const canR = end < len && !stuckR;
+        const canL = start > 0 && !stuckL;
+        if (!canR && !canL)
+            break;
+        if (canR && (goRight || !canL)) {
+            const nw = textW + w[end];
+            if (cost(start, end + 1, nw) > cols)
+                stuckR = true;
+            else {
+                textW = nw;
+                end++;
+                // Arrivare in fondo toglie l'ellissi di coda: la colonna che si libera
+                // può rimettere in gioco il lato che si era fermato per un pelo.
+                if (end === len)
+                    stuckL = false;
+            }
+        }
+        else {
+            const nw = textW + w[start - 1];
+            if (cost(start - 1, end, nw) > cols)
+                stuckL = true;
+            else {
+                textW = nw;
+                start--;
+                if (start === 0)
+                    stuckR = false;
+            }
+        }
+        goRight = !goRight;
+    }
+    const head = (start > 0 ? '…' : '') + cells.slice(start, c).join('');
+    return {
+        head,
+        at: cells[c],
+        tail: cells.slice(c + 1, end).join('') + (end < len ? '…' : ''),
+        cursorCol: termWidth(sanitize(head)),
+    };
+}
 /**
  * Indice sorgente raggiunto consumando al più `cols` colonne da `from`.
  *

package/package.json

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