@lamemind/loom-deck 0.11.0 → 0.12.0

package/README.md

@@ -62,6 +62,7 @@ Assegnazioni correnti:
 | modale | `E` | edit priorità/stato della task selezionata (salva + commit) |
 | modale | `S` | sort chain |
 | modale | `F` | filtri |
+| immediata | `f` | **forka** la sessione selezionata (solo col focus sul pane Sessions) |
 | immediata | `t` | terminale @project-root (surface standard launch) |
 | immediata | `c` | sessione Claude **nuda**: nessuna task, nessun prompt iniziale |
 | immediata | `w` | salva la vista corrente su disco |
@@ -77,7 +78,30 @@ sono configurate ma non raggiungibili (e la legenda lo dice).
 
 `t` e `c` sono gemelle: entrambe aprono una surface del cappello nella stessa
 finestra Ptyxis, senza passare da un modale. `c` (minuscola, azione) e `C`
-(maiuscola, modale create-task) restano distinte per la regola sopra.
+(maiuscola, modale create-task) restano distinte per la regola sopra — così come
+`f` (fork) e `F` (filtri).
+
+### `f` — forkare una conversazione
+
+Il fork rama la sessione selezionata: `claude --resume <origine> --fork-session`
+apre un **sessionId nuovo** con il transcript copiato, lasciando l'origine
+intatta. Serve quando vuoi ripartire da un certo stato senza perdere il ramo
+originale — e siccome i due id sono distinti, non esistono mai due processi che
+scrivono lo stesso file (il vincolo *single-writer* dello store di Claude Code).
+
+Il nuovo id lo genera il deck e lo pinna con `--session-id`, per due ragioni:
+
+- il ramo **eredita la task** dell'origine (senza id noto in anticipo il fork
+  di una sessione scoped comparirebbe come spot);
+- il **lineage** finisce nel sidecar `.claude/loom/session-tasks.jsonl` come
+  campo `forkOf`. Serve perché il transcript del fork **non nomina** la sessione
+  d'origine da nessuna parte: è una copia verbatim (stessi uuid dei messaggi) e
+  `parentUuid` incatena i messaggi dentro un transcript, non le sessioni fra
+  loro. Senza quel record un ramo sarebbe una riga gemella dell'originale, di
+  cui eredita anche il titolo.
+
+Un ramo si riconosce dal marker `⑂` nella lista e dalla riga `⑂ da <id>` nel
+pannello di dettaglio; la sua tab Ptyxis titola `<label> · <task> · fork`.
 
 > **Nota di migrazione (0.6.0)**: `c` → **`C`** per creare una task, e le voci
 > `codium`/`idea` non hanno più una lettera dedicata (erano `C`/`I` hardcoded):

package/dist/cli.js

@@ -9,7 +9,7 @@ import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 import { resolveTasksPath, resolveTasksDir, loadTasks, loadTaskDetail, } from './tasks.js';
 import { discoverProjectSessions } from './sessions.js';
-import { appendTaskBinding, loadTaskBindings } from './task-index.js';
+import { appendSessionRecord, appendTaskBinding, loadSessionIndex, } from './task-index.js';
 import { launchLegend, loadIdentity, loadLaunch } from './config.js';
 import { layoutBudget, normalizeEmoji, windowRange, wrapLines, } from './viewport.js';
 import { applyView, cycleSort, describeSort, priName, progName, toggleHidden, PRI_ENTRIES, PROG_ENTRIES, } from './view.js';
@@ -63,6 +63,27 @@ function spawnDeckResume(taskId, cwd, sessionId) {
     child.unref();
     return child;
 }
+// T28 — FORK: `deck-run <task|--no-task> --resume <origine> --fork --session-id
+// <nuovo>`. Variante del resume, non una terza forma: cambia solo che CC apre un
+// id nuovo (`--fork-session`) invece di riprendere a scrivere sull'origine —
+// due writer sullo stesso JSONL non esistono mai, che è l'intero punto del fork.
+// Il nuovo id lo genera il DECK e lo pinna, come in spawnDeck: è l'unico modo di
+// conoscerlo prima che la sessione esista, e senza conoscerlo non si possono
+// scrivere né il binding task né il record di lineage (il transcript del fork
+// non nomina da nessuna parte la sessione d'origine).
+function spawnDeckFork(taskId, cwd, originId, newId) {
+    const args = [
+        ...(taskId ? [taskId] : ['--no-task']),
+        '--resume',
+        originId,
+        '--fork',
+        '--session-id',
+        newId,
+    ];
+    const child = spawn(DECK_RUN, args, { cwd, detached: true, stdio: 'ignore' });
+    child.unref();
+    return child;
+}
 // T42 — sessione Claude NUDA: nessuna task, nessun prompt iniziale, nessun
 // sessionId pinnato (quindi nessuna entry nel sidecar session-tasks.jsonl: senza
 // task non c'è nulla da legare). Funzione separata e non un parametro opzionale
@@ -240,27 +261,34 @@ function useSessions(projectRoot) {
     const [state, setState] = useState({
         sessions: [],
         bindings: new Map(),
+        forkOf: new Map(),
     });
     useEffect(() => {
         let lastSig = '';
         const reload = () => {
             let sessions;
-            let bindings;
+            let index;
             try {
                 sessions = discoverProjectSessions(projectRoot);
-                bindings = loadTaskBindings(projectRoot);
+                index = loadSessionIndex(projectRoot);
             }
             catch {
                 sessions = [];
-                bindings = new Map();
+                index = { bindings: new Map(), forkOf: new Map() };
             }
+            const { bindings, forkOf } = index;
+            // La signature copre anche i fork: un record di lineage appena scritto
+            // cambia il marker della riga, quindi deve 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(',');
+                [...bindings.entries()].map(([k, v]) => `${k}=${v}`).sort().join(',') +
+                '#' +
+                [...forkOf.entries()].map(([k, v]) => `${k}<${v}`).sort().join(',');
             if (sig === lastSig)
                 return;
             lastSig = sig;
-            setState({ sessions, bindings });
+            setState({ sessions, bindings, forkOf });
         };
         reload();
         const id = setInterval(reload, POLL_MS);
@@ -346,7 +374,7 @@ const META_KEYS = ['Priority', 'Size', 'Estimated Time', 'Progress'];
 function Deck({ cwd, tasksPath, tasksDir }) {
     const { exit } = useApp();
     const { tasks, loadError } = useTasks(tasksPath);
-    const { sessions, bindings } = useSessions(cwd);
+    const { sessions, bindings, forkOf } = 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
@@ -702,6 +730,37 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             setNote('');
             setMode('filter');
         }
+        else if (input === 'f') {
+            // T28 — fork della sessione selezionata. Minuscola come `t`/`c` (T39):
+            // azione immediata, nessun modale — la `F` maiuscola resta ai filtri.
+            // Vive solo sul pane sessioni: il fork ha per oggetto una conversazione,
+            // e senza focus lì non ce n'è una selezionata su cui agire.
+            if (focus !== 'sessions') {
+                setNote('f → fork: seleziona una sessione (←→ per il pane)');
+            }
+            else {
+                const s = visibleSessions[selSession];
+                if (!s) {
+                    setNote('f → nessuna sessione da forkare');
+                }
+                else {
+                    // L'id del ramo nasce qui, prima dello spawn: pinnandolo posso
+                    // scrivere subito binding e lineage. Il binding task si eredita
+                    // dall'origine (un ramo appartiene alla stessa task), il lineage
+                    // registra la provenienza che il transcript non porta.
+                    const newId = randomUUID();
+                    const bound = bindings.get(s.sessionId) ?? null;
+                    appendSessionRecord(cwd, {
+                        sessionId: newId,
+                        ...(bound ? { taskId: bound } : {}),
+                        forkOf: s.sessionId,
+                    });
+                    const child = spawnDeckFork(bound, cwd, s.sessionId, newId);
+                    child.on('error', () => setNote(`⚠ fork fallito (${DECK_RUN})`));
+                    setNote(`⑂ fork ${s.sessionId.slice(0, 8)} → ${newId.slice(0, 8)}${bound ? ` (${bound})` : ' (spot)'}`);
+                }
+            }
+        }
         else if (input === 't') {
             const title = identity ? `🖥️ ${identity.owner} ${identity.name} [term]` : null;
             const child = spawnTerminal(cwd, title);
@@ -787,7 +846,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' : '—', " \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, sessions: windowSessions, total: childSessions.length, hidden: hiddenSessions, selectedId: selSessionId, focused: focus === 'sessions', above: sessionWin.start, below: visibleSessions.length - sessionWin.end, detail: budget.sessionDetail ? selSessionObj : null, firstLines: budget.sessionFirstLines, lastLines: budget.sessionLastLines, columns: columns })] }), 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 === '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' : '', " \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, sessions: windowSessions, total: childSessions.length, hidden: hiddenSessions, selectedId: selSessionId, focused: focus === 'sessions', above: sessionWin.start, below: visibleSessions.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] }));
 }
 const SORT_UI = { pri: 'pri', prog: 'stato', id: 'id' };
 // Modali resi IN FLUSSO (come l'input box di create), non in overlay assoluto:
@@ -832,11 +891,15 @@ 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, sessions, total, hidden, selectedId, focused, above, below, detail, firstLines, lastLines, columns, }) {
+function SessionsPane({ parentLabel, isSpot, sessions, total, hidden, selectedId, focused, above, below, detail, firstLines, lastLines, columns, forkOf, }) {
     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, ")", 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' })) : (sessions.map((s) => {
                 const sel = s.sessionId === selectedId;
-                return (_jsxs(Text, { inverse: sel && focused, bold: sel && !focused, wrap: "truncate-end", children: [sel ? CARET : CARET_OFF, isSpot ? _jsx(Text, { dimColor: true, children: "\u25CB" }) : _jsx(Text, { color: "green", children: "\uD83D\uDD17" }), ' ', truncate(s.title, 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 })) : null] }));
+                // T28 — un ramo eredita il titolo dell'origine: senza marcatore le due
+                // 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, 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] }));
 }
 // T49 — detail pane della sessione selezionata (hover), gemello del DetailPane
 // task. Tutti i campi vengono dal parse già cached dell'adapter (mtime-keyed):
@@ -846,11 +909,11 @@ function SessionsPane({ parentLabel, isSpot, sessions, total, hidden, selectedId
 // — 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, }) {
+function SessionDetailPane({ s, firstLines, lastLines, columns, origin, }) {
     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)] }), 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: [_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}`)))] }));
 }
 /**
  * Righe non-wrappabili del dettaglio (titolo + meta + commit) e loro conteggio.

package/dist/task-index.js

@@ -1,46 +1,46 @@
 import { appendFileSync, mkdirSync, readFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
-// SIDECAR sessionId ↔ taskId (T27).
-//
-// Lo store JSONL di CC NON registra LOOM_TASK/taskId: la classificazione
-// spot vs scoped non può derivare dal transcript. La verità è QUESTO indice,
-// che il deck popola allo spawn — quando pinna `--session-id <uuid>` (D1
-// preflight) il sessionId è già noto, quindi il binding è deterministico.
-//
-// Store (D3 preflight): project-local `<root>/.claude/loom/session-tasks.jsonl`,
-// JSONL append-only. Append (non read-modify-write) = concurrency-safe fra
-// spawn concorrenti; last-wins in lettura copre eventuali re-pin.
 export function taskIndexPath(projectRoot) {
     return join(projectRoot, '.claude', 'loom', 'session-tasks.jsonl');
 }
-export function appendTaskBinding(projectRoot, sessionId, taskId) {
+export function appendSessionRecord(projectRoot, rec) {
     const path = taskIndexPath(projectRoot);
     mkdirSync(dirname(path), { recursive: true });
-    const record = { sessionId, taskId, ts: new Date().toISOString() };
-    appendFileSync(path, JSON.stringify(record) + '\n');
+    appendFileSync(path, JSON.stringify({ ...rec, ts: new Date().toISOString() }) + '\n');
+}
+export function appendTaskBinding(projectRoot, sessionId, taskId) {
+    appendSessionRecord(projectRoot, { sessionId, taskId });
 }
-// sessionId → taskId, last-wins (un re-pin dello stesso sessionId sovrascrive).
-export function loadTaskBindings(projectRoot) {
+// 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
+// campi sono indipendenti — un record di solo `forkOf` non cancella un binding
+// task scritto prima per lo stesso sessionId.
+export function loadSessionIndex(projectRoot) {
     const bindings = new Map();
+    const forkOf = new Map();
     let content;
     try {
         content = readFileSync(taskIndexPath(projectRoot), 'utf8');
     }
     catch {
-        return bindings;
+        return { bindings, forkOf };
     }
     for (const line of content.split('\n')) {
         if (!line.trim())
             continue;
         try {
             const d = JSON.parse(line);
-            if (typeof d.sessionId === 'string' && typeof d.taskId === 'string') {
+            if (typeof d.sessionId !== 'string')
+                continue;
+            if (typeof d.taskId === 'string')
                 bindings.set(d.sessionId, d.taskId);
-            }
+            if (typeof d.forkOf === 'string')
+                forkOf.set(d.sessionId, d.forkOf);
         }
         catch {
             // riga corrotta → skip
         }
     }
-    return bindings;
+    return { bindings, forkOf };
 }

package/package.json

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

package/scripts/deck-run

@@ -10,6 +10,10 @@
 # Con --no-task la sessione è NUDA: niente LOOM_TASK, niente prompt iniziale,
 # niente --session-id. Serve al lavoro spot che non appartiene a nessuna task.
 #
+# Con --resume <sid> riprende una conversazione esistente; aggiungendo --fork la
+# riprende RAMANDOLA (`--fork-session`): id nuovo, transcript copiato, l'origine
+# resta intatta e scrivibile.
+#
 # Modalità spawn (LOOM_DECK_SPAWN_MODE):
 #   inline   → ptyxis --tab -- <cmd>            (default)  comando inline, LOOM_TASK diretta, zero dconf
 #   profile  → ptyxis --tab-with-profile=<UUID>            riusa il profilo, riscrive il custom-command via dconf
@@ -32,6 +36,7 @@ TASK=""
 SESSION_ID=""
 RESUME_ID=""
 NO_TASK=0
+FORK=0
 # Positional <TaskID> + flag opzionale --session-id <uuid> (T27): il deck genera
 # l'UUID e lo pinna così il binding sidecar sessionId↔taskId è deterministico.
 # --no-task (T42): modalità NUDA, senza TaskID — nessuna LOOM_TASK, nessun prompt
@@ -43,6 +48,13 @@ NO_TASK=0
 # <sid>` (spot: resume nudo). Su resume niente prompt iniziale (si continua la
 # conversazione, non se ne inietta una nuova) e niente --session-id (l'id ce
 # l'ha già la sessione ripresa).
+# --fork (T28): MODIFICATORE di --resume, speculare al `--fork-session` del CLI
+# (che è definito allo stesso modo: "when resuming, create a new session ID").
+# Non è una terza forma di spawn ma una variante della ripresa → richiede
+# --resume, e senza di esso è un errore d'uso, non un fork "dell'ultima".
+# Sotto --fork il --session-id torna AMMESSO (anzi: è il punto) — la mutua
+# esclusione con --resume esiste perché una ripresa nuda riscrive il transcript
+# dell'id ripreso, mentre il fork ne apre uno NUOVO, che possiamo quindi pinnare.
 while [[ $# -gt 0 ]]; do
   case "$1" in
     --session-id)
@@ -53,6 +65,8 @@ while [[ $# -gt 0 ]]; do
       RESUME_ID="${2:-}"; shift 2 ;;
     --resume=*)
       RESUME_ID="${1#*=}"; shift ;;
+    --fork)
+      FORK=1; shift ;;
     --no-task)
       NO_TASK=1; shift ;;
     *)
@@ -64,7 +78,9 @@ done
 USAGE="uso: deck-run <TaskID> [--session-id <uuid>]   (es. deck-run T18)
      | deck-run --no-task                          (sessione nuda, senza task)
      | deck-run <TaskID> --resume <uuid>           (riprende sessione scoped)
-     | deck-run --no-task --resume <uuid>          (riprende sessione spot)"
+     | deck-run --no-task --resume <uuid>          (riprende sessione spot)
+     | deck-run <TaskID> --resume <uuid> --fork [--session-id <nuovo-uuid>]
+                                                   (forka: ramo con id NUOVO)"
 
 if [[ $NO_TASK -eq 1 && -n "$TASK" ]]; then
   echo "--no-task e <TaskID> sono mutuamente esclusivi" >&2
@@ -75,8 +91,14 @@ if [[ $NO_TASK -eq 0 && -z "$TASK" ]]; then
   echo "$USAGE" >&2
   exit 2
 fi
-if [[ -n "$RESUME_ID" && -n "$SESSION_ID" ]]; then
+if [[ $FORK -eq 1 && -z "$RESUME_ID" ]]; then
+  echo "--fork richiede --resume <uuid>: si forka una conversazione esistente, non il nulla" >&2
+  echo "$USAGE" >&2
+  exit 2
+fi
+if [[ -n "$RESUME_ID" && -n "$SESSION_ID" && $FORK -eq 0 ]]; then
   echo "--resume e --session-id sono mutuamente esclusivi (la sessione ripresa ha già il suo id)" >&2
+  echo "usa --fork se vuoi un ramo con id nuovo" >&2
   echo "$USAGE" >&2
   exit 2
 fi
@@ -125,6 +147,11 @@ if [[ -n "$_cfg" ]]; then
     if [[ $NO_TASK -eq 1 ]]; then TITLE="${_label}"; else TITLE="${_label} · ${TASK}"; fi
   fi
 fi
+# Suffisso fork (T28): un ramo eredita task e label dell'origine, quindi senza
+# marcatore le due tab risulterebbero omonime nella stessa window. Suffisso e
+# non prefisso perché il match compass è `.includes(label)` e la label deve
+# restare intatta in testa — stesso schema di `· <task>` e `· deck`.
+[[ $FORK -eq 1 ]] && TITLE="${TITLE} · fork"
 
 # ── permissionMode (T45) ─────────────────────────────────────────────────────
 # Precedenza: env LOOM_DECK_PERMISSION_MODE > campo del file config > 'manual'.
@@ -155,6 +182,13 @@ SID_FLAG=""
 RES_FLAG=""
 [[ -n "$RESUME_ID" ]] && RES_FLAG="--resume ${RESUME_ID} "
 
+# --fork-session per la tab (T28): CC apre un id NUOVO invece di riscrivere
+# quello ripreso → mai due writer sullo stesso JSONL. Terzo gemello del pattern
+# flag-opzionale, per la stessa ragione degli altri due: la variante non deve
+# duplicare IN_TAB_CMD.
+FORK_FLAG=""
+[[ $FORK -eq 1 ]] && FORK_FLAG="--fork-session "
+
 # Prompt iniziale della sessione. Default: prompt DIRETTO (no skill) che chiede
 # a Claude un recap dello stato della task — l'utente rivede/steera prima di
 # lanciare (= più controllo), nessuna esecuzione automatica. Override completo via
@@ -177,13 +211,18 @@ fi
 # iniezione LOOM_TASK, prompt iniziale, --session-id pinnato. Resta claude nudo,
 # titolato e con il permission mode del progetto.
 # Su resume (T49) il prompt iniziale salta anche nel ramo task: riprendere una
-# conversazione significa continuarla, non iniettarle un nuovo messaggio.
+# conversazione significa continuarla, non iniettarle un nuovo messaggio. Il
+# fork (T28) ricade nello stesso ramo — è una ripresa, con id nuovo.
 PROMPT_ARG="'${PROMPT}'"
 [[ -n "$RESUME_ID" ]] && PROMPT_ARG=""
+# Il SID_FLAG entra anche nel ramo --no-task, che altrimenti lo scarta insieme
+# agli altri elementi task-bound: nel fork di una sessione SPOT il sessionId
+# pinnato non serve a legare una task (non c'è) ma a rendere noto in anticipo
+# l'id del ramo, senza il quale il lineage non sarebbe registrabile.
 if [[ $NO_TASK -eq 1 ]]; then
-  _default_intab="claude --name '${TITLE}' ${MODE_FLAG}${RES_FLAG}"
+  _default_intab="claude --name '${TITLE}' ${MODE_FLAG}${SID_FLAG}${RES_FLAG}${FORK_FLAG}"
 else
-  _default_intab="LOOM_TASK=${TASK} claude --name '${TITLE}' ${MODE_FLAG}${SID_FLAG}${RES_FLAG}${PROMPT_ARG}"
+  _default_intab="LOOM_TASK=${TASK} claude --name '${TITLE}' ${MODE_FLAG}${SID_FLAG}${RES_FLAG}${FORK_FLAG}${PROMPT_ARG}"
 fi
 IN_TAB_CMD="${LOOM_DECK_INTAB_CMD:-$_default_intab}"