@lamemind/loom-deck 0.69.0 → 0.71.0

package/dist/actions.js

@@ -26,6 +26,7 @@ import { onInTabCommand, runLaunch, spawnClaudeEmpty, spawnBare, spawnDeck, spaw
 import { resolveSpawnId } from './spawn-config.js';
 import { useTaskOps } from './task-ops.js';
 import { inboxWords } from './inbox.js';
+import { docWords } from './doc-tree.js';
 import { wrapWords } from './wrap-scan.js';
 export function useDeckActions({ cwd, tasksPath, tasksDir, columns, model, overrides, catalog, setNote, }) {
     // La riga di stato di OGNI spawn di sessione Claude: il comando esatto, come
@@ -386,6 +387,58 @@ export function useDeckActions({ cwd, tasksPath, tasksDir, columns, model, overr
         spawned.child.on('error', () => setNote(`⚠ drain ${file.basename} fallito (${DECK_RUN})`));
         noteSpawn(spawned);
     }
+    /**
+     * T160 — la terna della riga `rebalance` sul bersaglio selezionato.
+     *
+     * Separata dallo spawn perché ha due chiamanti che la vogliono in due momenti
+     * diversi: la schermata, che MOSTRA il comando in fondo prima che `⏎` lo
+     * lanci, e l'attuatore, che lo lancia. Comporlo due volte darebbe due comandi
+     * capaci di divergere — e quello mostrato è la sola cosa che rende `⏎` una
+     * scelta invece di un salto nel buio.
+     *
+     * P9 — su una riga SENZA FLAG il prompt è vuoto, e il deck non spawna. Il
+     * flag resta un invito a guardare e non un ordine, quindi la skill su un
+     * bersaglio in equilibrio produrrebbe un report e nient'altro: aprire una
+     * conversazione per farselo dire è un giro di modello pagato per niente. La
+     * ragione viaggia accanto al vuoto (`hint`), o la riga muta si leggerebbe come
+     * un comando che non si è riusciti a comporre.
+     */
+    function rebalanceSpawn(row) {
+        if (row.flags.length === 0) {
+            return {
+                prompt: '',
+                hint: `${row.path} non porta flag: rebalance-doc non ha niente da fare qui`,
+            };
+        }
+        const d = spawnDefaults('rebalance', { target: row.path, words: docWords(row.path) });
+        return { prompt: d.prompt ?? '', hint: '' };
+    }
+    /**
+     * T160 — apre la sessione che RIORGANIZZA la topologia attorno a un bersaglio.
+     *
+     * Gemella di `drainInbox` e `unwrapPath` nella forma: sessione NUDA (il
+     * rebalance lavora sulla doc, non su una task), `sessionId` pinnato per poter
+     * scrivere la nota nel sidecar, titolo dalla riga di catalogo.
+     *
+     * Il modello della riga è `sonnet` ed è una cella FISSA, non una preferenza:
+     * `rebalance-doc` dichiara `model: sonnet` nel frontmatter e quel campo
+     * ri-timbra il modello della sessione qualunque `--model` arrivi dallo spawn.
+     * Passarlo comunque nell'argv resta giusto — lo spawn è deterministico e la
+     * riga di stato mostra il comando vero — ma configurarlo sarebbe una cella che
+     * mente.
+     */
+    function rebalanceDoc(row, prompt) {
+        if (!prompt)
+            return;
+        const sid = randomUUID();
+        const d = spawnDefaults('rebalance', { target: row.path, words: docWords(row.path) });
+        const title = d.title ?? '';
+        if (title)
+            appendNote(cwd, sid, title);
+        const spawned = spawnBare(cwd, prompt, d.model, sid, title);
+        spawned.child.on('error', () => setNote(`⚠ rebalance ${row.path} fallito (${DECK_RUN})`));
+        noteSpawn(spawned);
+    }
     /**
      * T134 — apre la sessione che SROTOLA l'hard-wrap di un path.
      *
@@ -463,6 +516,8 @@ export function useDeckActions({ cwd, tasksPath, tasksDir, columns, model, overr
         togglePin,
         togglePriority,
         drainInbox,
+        rebalanceSpawn,
+        rebalanceDoc,
         unwrapPath,
         openTerminal,
         openClaude,

package/dist/cli.js

@@ -32,7 +32,7 @@ import { useSearchOverlay } from './overlays/search.js';
 import { useSheetOverlay } from './overlays/sheet.js';
 import { useAssignOverlay } from './overlays/assign.js';
 import { useProjectStatus } from './overlays/status.js';
-import { useInboxOverlay } from './overlays/inbox.js';
+import { useFileSheet } from './overlays/file-sheet.js';
 import { useWrapOverlay } from './overlays/wrap.js';
 import { useSpawnPage } from './overlays/spawn.js';
 import { useGitlink } from './overlays/gitlink.js';
@@ -41,7 +41,9 @@ import { useTextModals, useViewModals } from './overlays/modals.js';
 import { useTerminalSize, useSpawnConfig } from './hooks.js';
 import { EditModal, FilterModal, PurgeModal, SortModal } from './ui/modals.js';
 import { StatusHeadline } from './ui/status-screen.js';
-import { InboxPane, SessionsPane, TasksPane } from './ui/panes.js';
+import { SessionsPane, TasksPane } from './ui/panes.js';
+import { InboxPane } from './ui/inbox-pane.js';
+import { DocPane } from './ui/doc-pane.js';
 import { PreviewPane, detailMetaOf } from './ui/preview.js';
 import { CompactNotice, HintBar, TextBox, screenFor } from './ui/screens.js';
 import { VERSION } from './version.js';
@@ -123,14 +125,27 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         setMode,
         setNote,
     });
-    // T134 — il detail di un file inbox. Come lo sheet della task riceve lo spawn
-    // come callback: un hook di overlay non esce dal deck.
-    const inbox = useInboxOverlay({
+    // T134/T160 — le DUE istanze dello sheet di file: la coda inbox e il bersaglio
+    // doc. Stesso hook (`useFileSheet`, P11), due modi distinti — `esc` da una
+    // torna al pane inbox, dall'altra al pane doc, e un modo condiviso
+    // obbligherebbe a ricordare altrove da dove si era entrati. Come lo sheet
+    // della task ricevono lo spawn come callback: un hook di overlay non esce dal
+    // deck.
+    const inbox = useFileSheet({
+        mode: 'inbox',
         rows,
         columns,
         setMode,
         setNote,
-        onDrain: actions.drainInbox,
+        onEnter: actions.drainInbox,
+    });
+    const docSheet = useFileSheet({
+        mode: 'doc',
+        rows,
+        columns,
+        setMode,
+        setNote,
+        onEnter: actions.rebalanceDoc,
     });
     // T134 — l'hard-wrap. Come il project status non è solo un overlay: i suoi
     // numeri si leggono in testata a schermata chiusa, e la lista è una delle sue
@@ -188,6 +203,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         search,
         status,
         inbox,
+        doc: docSheet,
         wrap,
         spawn,
         gitlink,
@@ -210,9 +226,13 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             ? model.selInbox
                 ? 'inbox'
                 : 'none'
-            : model.selSessionObj
-                ? 'session'
-                : 'none';
+            : model.focus === 'doctree'
+                ? model.selDoc
+                    ? 'doc'
+                    : 'none'
+                : model.selSessionObj
+                    ? 'session'
+                    : 'none';
     const detailParts = model.detail ? detailMetaOf(model.detail) : null;
     const launch = launchRow(model.launch, columns);
     // T154 — i bottoni del blocco selettore della nuda: stessa primitiva
@@ -262,11 +282,16 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         sessionViewId: model.sessionViewId,
         parentLabel: model.parentLabel,
         hasLoadError: Boolean(model.loadError),
-        rightPane: model.rightPane,
+        deckMode: model.deckMode,
         inboxFiles: model.inboxFiles,
         selInboxPath: model.selInboxPath,
         inboxCounts: model.inboxCounts,
         inboxViewId: model.inboxViewId,
+        docRows: model.docRows,
+        selDocPath: model.selDocPath,
+        docCounts: model.docCounts,
+        docViewId: model.docViewId,
+        docHasDirs: model.docHasDirs,
     });
     useDeckInput({
         cwd,
@@ -296,7 +321,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         projectName: model.projectName,
         taskRowData: model.taskRowData,
         hiddenTasks: model.hiddenTasks,
-        overlays: { assign, sheet, search, status, inbox, wrap, spawn },
+        overlays: { assign, sheet, search, status, inbox, doc: docSheet, wrap, spawn },
     });
     if (screen)
         return screen;
@@ -312,10 +337,11 @@ function Deck({ cwd, tasksPath, tasksDir }) {
                     hasSession: model.selSessionObj !== null,
                     hasSessionId: model.selSessionId !== null,
                     purgeBulk: model.purgeBulk,
-                    inboxPane: model.rightPane === 'inbox',
+                    docMode: model.deckMode === 'doc',
                     hasInbox: model.selInbox !== null,
+                    hasDoc: model.selDoc !== null,
                     gitlink: gitlink.enabled,
-                }), indicators: indicators, columns: columns }), frame.launchLine ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [launch.segments.map((s) => s.text).join(LAUNCH_SEP), launch.overflow > 0 ? (_jsxs(Text, { color: "yellow", children: [" \u00B7 +", launch.overflow, " fuori riga"] })) : null, launch.unreachable > 0 ? (_jsxs(Text, { color: "yellow", children: [" \u00B7 ", launch.unreachable, " oltre la 9\u00AA (non raggiungibili)"] })) : null, launch.filler, BARE_LABEL.text, ' ', bareButtons.nodes] })) : null, mode === 'create' ? _jsx(TextBox, { glyph: "C", value: textModals.draft }) : null, mode === 'note' ? _jsx(TextBox, { glyph: "\u270E", value: textModals.noteDraft }) : null, mode === 'sort' ? _jsx(SortModal, { sort: model.view.sort }) : null, mode === 'filter' ? (_jsx(FilterModal, { view: model.view, cursor: viewModals.filterCursor })) : null, mode === 'edit' && textModals.edit && textModals.editTask ? (_jsx(EditModal, { id: textModals.editTask.id, draft: textModals.edit, row: textModals.editCursor.row, caret: textModals.editCursor.caret, columns: columns })) : null, mode === 'purge' && purge.draft ? (_jsx(PurgeModal, { draft: purge.draft, columns: columns })) : null, _jsxs(Box, { flexDirection: "row", marginTop: 1, children: [_jsx(TasksPane, { tasks: frame.windowTasks, counts: model.taskCounts, activeView: model.taskViewId, paneCount: model.paneTasks.length, view: model.view, selected: model.selIndex, spotCount: model.spotCount, allCount: model.sessions.length, idW: model.taskCols.id, tailW: model.taskCols.tail, focused: model.focus === 'tasks', loadError: model.loadError, windowStart: frame.taskWin.start, above: frame.taskWin.start, below: model.paneTasks.length - frame.taskWin.end, columns: columns, data: model.taskRowData, blockMark: model.blockMark }), model.rightPane === 'inbox' ? (_jsx(InboxPane, { files: frame.windowInbox, counts: model.inboxCounts, activeView: model.inboxViewId, paneCount: model.inboxFiles.length, selectedPath: model.selInboxPath, focused: model.focus === 'inbox', above: frame.inboxWin.start, below: model.inboxFiles.length - frame.inboxWin.end, columns: columns, ok: model.inboxOk, scanned: model.inboxScanned })) : (_jsx(SessionsPane, { parentLabel: model.parentLabel, isSpot: model.isSpot, isAll: model.isAll, bindings: model.bindings, taskW: model.sessionCols.task, ageW: model.sessionCols.age, rows: frame.windowRows, counts: model.sessionCounts, activeView: model.sessionViewId, paneCount: model.sessionRows.length, selectedId: model.selSessionId ?? undefined, focused: model.focus === 'sessions', above: frame.sessionWin.start, below: model.sessionRows.length - frame.sessionWin.end, columns: columns, forkOf: model.forkOf, sessionNotes: model.sessionNotes, sessionPriority: model.sessionPriority, projectCore: model.projectCore, live: model.live }))] }), frame.budget.preview && previewKind === 'task' && model.detail ? (_jsx(PreviewPane, { kind: "task", detail: model.detail, maxLines: frame.budget.detailLines, columns: columns })) : frame.budget.preview && previewKind === 'inbox' && model.selInbox ? (_jsx(PreviewPane, { kind: "inbox", file: model.selInbox, columns: columns })) : frame.budget.preview && previewKind === 'session' && model.selSessionObj ? (_jsx(PreviewPane, { kind: "session", s: model.selSessionObj, firstLines: frame.budget.sessionFirstLines, lastLines: frame.budget.sessionLastLines, columns: columns, origin: model.forkOf.get(model.selSessionObj.sessionId) ?? null, note: model.sessionNotes.get(model.selSessionObj.sessionId) ?? '', live: model.live.get(model.selSessionObj.sessionId) ?? null, resumeModel: model.resumeModel })) : null, note ? _jsx(Text, { color: "green", wrap: "truncate-end", children: sanitize(note) }) : null] }));
+                }), indicators: indicators, columns: columns }), frame.launchLine ? (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [launch.segments.map((s) => s.text).join(LAUNCH_SEP), launch.overflow > 0 ? (_jsxs(Text, { color: "yellow", children: [" \u00B7 +", launch.overflow, " fuori riga"] })) : null, launch.unreachable > 0 ? (_jsxs(Text, { color: "yellow", children: [" \u00B7 ", launch.unreachable, " oltre la 9\u00AA (non raggiungibili)"] })) : null, launch.filler, BARE_LABEL.text, ' ', bareButtons.nodes] })) : null, mode === 'create' ? _jsx(TextBox, { glyph: "C", value: textModals.draft }) : null, mode === 'note' ? _jsx(TextBox, { glyph: "\u270E", value: textModals.noteDraft }) : null, mode === 'sort' ? _jsx(SortModal, { sort: model.view.sort }) : null, mode === 'filter' ? (_jsx(FilterModal, { view: model.view, cursor: viewModals.filterCursor })) : null, mode === 'edit' && textModals.edit && textModals.editTask ? (_jsx(EditModal, { id: textModals.editTask.id, draft: textModals.edit, row: textModals.editCursor.row, caret: textModals.editCursor.caret, columns: columns })) : null, mode === 'purge' && purge.draft ? (_jsx(PurgeModal, { draft: purge.draft, columns: columns })) : null, _jsxs(Box, { flexDirection: "row", marginTop: 1, children: [model.deckMode === 'doc' ? (_jsx(DocPane, { rows: frame.windowDoc, counts: model.docCounts, activeView: model.docViewId, paneCount: model.docRows.length, selectedPath: model.selDocPath, focused: model.focus === 'doctree', above: frame.docWin.start, below: model.docRows.length - frame.docWin.end, columns: columns, ok: model.docOk, scanned: model.docScanned, scanning: model.docScanning, hasDirs: model.docHasDirs })) : (_jsx(TasksPane, { tasks: frame.windowTasks, counts: model.taskCounts, activeView: model.taskViewId, paneCount: model.paneTasks.length, view: model.view, selected: model.selIndex, spotCount: model.spotCount, allCount: model.sessions.length, idW: model.taskCols.id, tailW: model.taskCols.tail, focused: model.focus === 'tasks', loadError: model.loadError, windowStart: frame.taskWin.start, above: frame.taskWin.start, below: model.paneTasks.length - frame.taskWin.end, columns: columns, data: model.taskRowData, blockMark: model.blockMark })), model.deckMode === 'doc' ? (_jsx(InboxPane, { files: frame.windowInbox, counts: model.inboxCounts, activeView: model.inboxViewId, paneCount: model.inboxFiles.length, selectedPath: model.selInboxPath, focused: model.focus === 'inbox', above: frame.inboxWin.start, below: model.inboxFiles.length - frame.inboxWin.end, columns: columns, ok: model.inboxOk, scanned: model.inboxScanned })) : (_jsx(SessionsPane, { parentLabel: model.parentLabel, isSpot: model.isSpot, isAll: model.isAll, bindings: model.bindings, taskW: model.sessionCols.task, ageW: model.sessionCols.age, rows: frame.windowRows, counts: model.sessionCounts, activeView: model.sessionViewId, paneCount: model.sessionRows.length, selectedId: model.selSessionId ?? undefined, focused: model.focus === 'sessions', above: frame.sessionWin.start, below: model.sessionRows.length - frame.sessionWin.end, columns: columns, forkOf: model.forkOf, sessionNotes: model.sessionNotes, sessionPriority: model.sessionPriority, projectCore: model.projectCore, live: model.live }))] }), frame.budget.preview && previewKind === 'task' && model.detail ? (_jsx(PreviewPane, { kind: "task", detail: model.detail, maxLines: frame.budget.detailLines, columns: columns })) : frame.budget.preview && previewKind === 'inbox' && model.selInbox ? (_jsx(PreviewPane, { kind: "inbox", file: model.selInbox, columns: columns })) : frame.budget.preview && previewKind === 'doc' && model.selDoc ? (_jsx(PreviewPane, { kind: "doc", row: model.selDoc, columns: columns })) : frame.budget.preview && previewKind === 'session' && model.selSessionObj ? (_jsx(PreviewPane, { kind: "session", s: model.selSessionObj, firstLines: frame.budget.sessionFirstLines, lastLines: frame.budget.sessionLastLines, columns: columns, origin: model.forkOf.get(model.selSessionObj.sessionId) ?? null, note: model.sessionNotes.get(model.selSessionObj.sessionId) ?? '', live: model.live.get(model.selSessionObj.sessionId) ?? null, resumeModel: model.resumeModel })) : null, note ? _jsx(Text, { color: "green", wrap: "truncate-end", children: sanitize(note) }) : null] }));
 }
 const cwd = process.cwd();
 // T116 — `exitOnCtrlC: false` toglie a Ink l'uscita immediata su `^C`: senza,

package/dist/deck-model.js

@@ -14,15 +14,16 @@
 // la ragione per cui i loro conti di parametri restano leggibili.
 import { useEffect, useMemo, useState } from 'react';
 import { loadArchivableDays, loadIdentity, loadLaunch } from './config.js';
-import { useArchivable, useCommitTimes, useDirtyFolders, useEpicHierarchy, useInboxScan, useSessions, useTaskDetail, useTasks, } from './hooks.js';
+import { useArchivable, useCommitTimes, useDirtyFolders, useDocScan, useEpicHierarchy, useInboxScan, useSessions, useTaskDetail, useTasks, } from './hooks.js';
 import { DEFAULT_INBOX_STALE_HOURS, staleCount } from './inbox.js';
+import { cycleDocView, docCounts as deriveDocCounts, docView, selectDocRows, } from './doc-views.js';
 import { cycleInboxView, inboxCounts as deriveInboxCounts, inboxView, selectInboxRows, } from './inbox-views.js';
 import { docsRootName } from './tasks.js';
 import { isDone } from './layout.js';
 import { TASK_EMPTY, modelAlias, relTime } from './glyphs.js';
 import { assembleSessionList, firstSelectableId, rowIndexOf, selectedSession, } from './session-list.js';
 import { cycleSessionView, cycleTaskView, selectSessionRows, selectTasks, sessionView, taskView, } from './pane-views.js';
-import { ALL, MAX_SESSIONS, MAX_SESSIONS_ALL, META_ROWS, ROW_ALL, ROW_SPOT, SPOT, } from './model.js';
+import { ALL, LEFT_PANE, MAX_SESSIONS, MAX_SESSIONS_ALL, META_ROWS, RIGHT_PANE, ROW_ALL, ROW_SPOT, SPOT, isLeftPane, } from './model.js';
 import { applyView, epicRollup, taskColumns } from './view.js';
 import { loadView } from './view-store.js';
 import { termWidth } from './width.js';
@@ -166,15 +167,21 @@ export function useDeckModel({ cwd, tasksPath, tasksDir, bareModel: bareModelDef
     // riaperta a freddo si legge come la lista intera.
     const [taskViewId, setTaskViewId] = useState('tasks');
     const [sessionViewId, setSessionViewId] = useState('context');
-    // T134 — quale pane occupa lo slot destro, e la vista attiva di quello inbox.
-    // Volatili entrambi (D6 preflight): il deck riapre sempre sulle sessioni.
-    const [rightPane, setRightPane] = useState('sessions');
+    // T160 — il MODO del deck (quale coppia di pane è montata) e la vista attiva
+    // dei due pane che il modo doc porta con sé. Volatili tutti e tre: il deck
+    // riapre sempre in modo task, sulle viste di default.
+    const [deckMode, setDeckMode] = useState('task');
     const [inboxViewId, setInboxViewId] = useState('all');
+    const [docViewId, setDocViewId] = useState('all');
     // Selezione KEYED SUL PATH, mai su indice: la lista si riordina sotto le
     // viste e si accorcia a ogni scan, e un indice grezzo punterebbe alla riga
     // sbagliata in silenzio (stessa trappola di T39 sulle task e T50 sulle
     // conversazioni).
     const [selInboxPath, setSelInboxPath] = useState(null);
+    // T160 — gemella della precedente, sul pane doc: keyed sul PATH e mai
+    // sull'indice, perché la lista cambia forma fra le viste (albero con le
+    // cartelle, liste piatte per flag) e si riordina a ogni scan.
+    const [selDocPath, setSelDocPath] = useState(null);
     // T136 — data dell'ultimo commit di ogni task file, per la chiave `commit`
     // della chain di sort.
     const commitAt = useCommitTimes(tasksDir, cwd);
@@ -218,6 +225,21 @@ export function useDeckModel({ cwd, tasksPath, tasksDir, bareModel: bareModelDef
     const inboxStale = staleCount(inbox.files, DEFAULT_INBOX_STALE_HOURS, Date.now());
     const inboxFiles = useMemo(() => selectInboxRows(inboxViewId, inbox.files), [inboxViewId, inbox.files]);
     const selInbox = inboxFiles.find((f) => f.path === selInboxPath) ?? null;
+    // T160 — l'albero della doc, quinto scan della famiglia e l'unico con un
+    // interruttore: gira solo mentre il modo doc è montato (P3 preflight). Il
+    // primo giro lo fa partire l'effect di `useDocScan` quando `enabled` passa a
+    // vero, quindi il montaggio rimisura da sé — `toggleDeckMode` sotto non deve
+    // chiamare `doc.scan()` come fa il gemello inbox, e chiamarlo darebbe due
+    // spawn da quattro secondi per un gesto solo.
+    const doc = useDocScan(cwd, docsRoot, deckMode === 'doc');
+    // La misura GREZZA, memoizzata a parte: la consumano tre derivazioni (i
+    // contatori, le righe della vista, l'elenco dei file di una cartella nello
+    // sheet) e ricomporre l'oggetto a ogni render darebbe una identità nuova a
+    // ogni giro, cioè tre memo che non memoizzano più niente.
+    const docData = useMemo(() => ({ files: doc.files, dirs: doc.dirs, hasDirs: doc.hasDirs }), [doc.files, doc.dirs, doc.hasDirs]);
+    const docCounts = useMemo(() => deriveDocCounts(docData), [docData]);
+    const docRows = useMemo(() => selectDocRows(docViewId, docData), [docViewId, docData]);
+    const selDoc = docRows.find((r) => r.path === selDocPath) ?? null;
     // T100 — le task effettivamente a schermo: la vista principale coincide con
     // `viewTasks` (nessun ricalcolo sul cammino di default), le altre due passano
     // dal predicato del catalogo. I CONTATORI restano misurati sulla vista di
@@ -344,6 +366,17 @@ export function useDeckModel({ cwd, tasksPath, tasksDir, bareModel: bareModelDef
             setSelInboxPath(inboxFiles[0].path);
         }
     }, [inboxFiles, selInboxPath]);
+    // T160 — gemello del precedente sul pane doc: un file splittato sparisce dalla
+    // vista `SPLIT` al primo scan dopo l'operazione, e la selezione cade sulla
+    // prima riga invece che su una posizione a caso.
+    useEffect(() => {
+        if (selDocPath !== null && !docRows.some((r) => r.path === selDocPath)) {
+            setSelDocPath(docRows[0]?.path ?? null);
+        }
+        else if (selDocPath === null && docRows.length > 0) {
+            setSelDocPath(docRows[0].path);
+        }
+    }, [docRows, selDocPath]);
     /** Selezione per INDICE nella vista, riconvertita subito in sentinella o id.
      *  T21 — la chiama anche il click su una riga del pane task. */
     function selectTaskRow(index) {
@@ -391,11 +424,20 @@ export function useDeckModel({ cwd, tasksPath, tasksDir, bareModel: bareModelDef
         setSelInboxPath(null);
         setNote(`vista inbox: ${inboxView(next).label(inboxCounts)}`);
     }
+    function selectDocView(next) {
+        if (next === docViewId)
+            return;
+        setDocViewId(next);
+        setSelDocPath(null);
+        setNote(`vista doc: ${docView(next).label(docCounts)}`);
+    }
     function cycleView(delta) {
         if (focus === 'tasks')
             selectTaskView(cycleTaskView(taskViewId, delta));
         else if (focus === 'inbox')
             selectInboxView(cycleInboxView(inboxViewId, delta));
+        else if (focus === 'doctree')
+            selectDocView(cycleDocView(docViewId, delta));
         else
             selectSessionView(cycleSessionView(sessionViewId, delta));
     }
@@ -412,6 +454,20 @@ export function useDeckModel({ cwd, tasksPath, tasksDir, bareModel: bareModelDef
         const next = Math.max(0, Math.min(inboxFiles.length - 1, (at < 0 ? 0 : at) + delta));
         setSelInboxPath(inboxFiles[next].path);
     }
+    /** Gemelle delle due sopra, sul pane doc. Nessuna riga è non-selezionabile:
+     *  una cartella è un bersaglio di `rebalance-doc` quanto un file. */
+    function selectDocRow(index) {
+        const r = docRows[index];
+        if (r)
+            setSelDocPath(r.path);
+    }
+    function moveDocSel(delta) {
+        const at = docRows.findIndex((r) => r.path === selDocPath);
+        if (docRows.length === 0)
+            return;
+        const next = Math.max(0, Math.min(docRows.length - 1, (at < 0 ? 0 : at) + delta));
+        setSelDocPath(docRows[next].path);
+    }
     /** T148 — `m` scorre il selettore modello della riga sessione selezionata al
      *  valore SUCCESSIVO del catalogo (ciclico), gemella di `cycleView` ma su un
      *  asse diverso: qui non c'è una vista da cambiare, solo un valore da far
@@ -434,34 +490,45 @@ export function useDeckModel({ cwd, tasksPath, tasksDir, bareModel: bareModelDef
         return next;
     }
     /**
-     * T134 — `^B` scambia i due pane dello slot destro (D8 preflight).
+     * T160 — `^B` scambia il MODO, cioè ENTRAMBI gli slot insieme.
+     *
+     * Erede del `toggleInboxPane` di T134, che scambiava il solo pane destro. Un
+     * tasto per slot avrebbe reso raggiungibili le due combinazioni che l'asse
+     * unico esiste per non avere (albero doc accanto alle conversazioni, lista
+     * task accanto alla coda inbox), e ne avrebbe richiesto un secondo che nessuna
+     * legenda ha spazio per annunciare.
      *
-     * Il FOCUS segue il pane: chi stava guardando a destra continua a guardare a
-     * destra, ma quello che c'è adesso è l'altro pane. Lasciarlo su `sessions`
-     * con l'inbox montato darebbe un focus su un pane che non è a schermo, e le
-     * azioni della lista sessioni resterebbero attive su una selezione invisibile.
+     * Il FOCUS segue la POSIZIONE, non il contenuto: chi stava guardando a
+     * sinistra continua a guardare a sinistra, e quello che c'è adesso è l'altro
+     * pane. È la stessa regola di T134 (lì con una posizione sola su cui valeva) e
+     * la stessa di `←→`, che nominano un lato e non un pane.
+     *
+     * Nessuno scan esplicito qui, a differenza del gemello di T134: il montaggio
+     * lo rimisura da sé, perché l'effect di `useDocScan` è keyed sull'interruttore
+     * e riparte quando passa a vero. Chiamarlo anche di qui darebbe due spawn da
+     * quattro secondi per un gesto solo. Lo scan inbox invece resta chiesto a
+     * mano — il suo hook gira sempre, e non ha un interruttore che gli dica che
+     * qualcuno ha appena aperto il pane.
      */
-    function toggleInboxPane() {
-        const next = rightPane === 'inbox' ? 'sessions' : 'inbox';
-        setRightPane(next);
-        setFocus((f) => (f === 'tasks' ? f : next));
-        // Montare il pane RIMISURA la coda. Il periodico resta, come rete per il
-        // deck lasciato aperto sul pane inbox, ma non è più l'unico canale: senza
-        // questa chiamata chi apre il pane guarda l'ultima misura, che può essere
-        // vecchia quanto l'intero intervallo. Non serve il verso opposto — tornare
-        // alle sessioni non guarda la coda, e uno scan lì si pagherebbe per nessuno.
-        if (next === 'inbox')
+    function switchMode(next) {
+        if (next === deckMode)
+            return;
+        setDeckMode(next);
+        setFocus((f) => (isLeftPane(f) ? LEFT_PANE[next] : RIGHT_PANE[next]));
+        if (next === 'doc')
             inbox.scan();
-        setNote(next === 'inbox' ? '^B → pane inbox' : '^B → pane sessioni');
+        setNote(next === 'doc' ? '^B → modo doc' : '^B → modo task');
+    }
+    function toggleDeckMode() {
+        switchMode(deckMode === 'doc' ? 'task' : 'doc');
     }
-    /** `esc` in vista normale: torna alle sessioni. Solo in quel verso — `esc`
-     *  dice «esci da dove sei», e sulle sessioni non c'è più niente da cui uscire
-     *  (il tasto resta inerte, come è sempre stato). */
-    function closeInboxPane() {
-        if (rightPane !== 'inbox')
+    /** `esc` in vista normale: torna al modo task. Solo in quel verso — `esc` dice
+     *  «esci da dove sei», e dal modo task non c'è più niente da cui uscire (il
+     *  tasto resta inerte, come è sempre stato). */
+    function closeDocMode() {
+        if (deckMode !== 'doc')
             return false;
-        setRightPane('sessions');
-        setFocus((f) => (f === 'inbox' ? 'sessions' : f));
+        switchMode('task');
         return true;
     }
     return {
@@ -517,8 +584,9 @@ export function useDeckModel({ cwd, tasksPath, tasksDir, bareModel: bareModelDef
         cycleResumeModel,
         bareModel,
         cycleBareModel,
+        // modo del deck
+        deckMode,
         // derivazioni del pane inbox
-        rightPane,
         inboxScanned: inbox.scanned,
         inboxOk: inbox.ok,
         inboxViewId,
@@ -527,6 +595,17 @@ export function useDeckModel({ cwd, tasksPath, tasksDir, bareModel: bareModelDef
         inboxFiles,
         selInboxPath,
         selInbox,
+        // derivazioni del pane doc
+        docData,
+        docScanned: doc.scanned,
+        docOk: doc.ok,
+        docScanning: doc.scanning,
+        docHasDirs: doc.hasDirs,
+        docViewId,
+        docCounts,
+        docRows,
+        selDocPath,
+        selDoc,
         // mutatori di navigazione
         selectTaskRow,
         moveTaskSel,
@@ -535,8 +614,11 @@ export function useDeckModel({ cwd, tasksPath, tasksDir, bareModel: bareModelDef
         selectInboxView,
         selectInboxRow,
         moveInboxSel,
-        toggleInboxPane,
-        closeInboxPane,
+        selectDocView,
+        selectDocRow,
+        moveDocSel,
+        toggleDeckMode,
+        closeDocMode,
         cycleView,
     };
 }