@lamemind/loom-deck 0.70.0 → 0.71.0

package/dist/ui/preview.js

@@ -6,6 +6,7 @@ import { cut, cutParts, wrapLines } from '../width.js';
 import { previewTextWidth, previewTitleParts } from '../layout.js';
 import { LIVE_BUSY, LIVE_IDLE, META_KEYS, fmtDateTime, fmtSize, modelAlias, } from '../glyphs.js';
 import { NATURA_SHORT, inboxMark } from '../inbox.js';
+import { flagNames } from '../doc-tree.js';
 import { ChoiceRow } from './fields.js';
 import { MODELS } from '../spawn-catalog.js';
 /** Colonne del prefisso delle due anteprime della preview sessione (`» `, `« `,
@@ -14,7 +15,7 @@ import { MODELS } from '../spawn-catalog.js';
  *  un bordo mangiato. */
 const PREVIEW_PREFIX_W = 2;
 export function PreviewPane(p) {
-    return (_jsx(Box, { flexDirection: "column", marginTop: 1, borderStyle: "single", borderColor: "gray", paddingX: 1, children: p.kind === 'task' ? (_jsx(TaskPreview, { detail: p.detail, maxLines: p.maxLines, columns: p.columns })) : p.kind === 'inbox' ? (_jsx(InboxPreview, { file: p.file, columns: p.columns })) : (_jsx(SessionPreview, { s: p.s, firstLines: p.firstLines, lastLines: p.lastLines, columns: p.columns, origin: p.origin, note: p.note, live: p.live, resumeModel: p.resumeModel })) }));
+    return (_jsx(Box, { flexDirection: "column", marginTop: 1, borderStyle: "single", borderColor: "gray", paddingX: 1, children: p.kind === 'task' ? (_jsx(TaskPreview, { detail: p.detail, maxLines: p.maxLines, columns: p.columns })) : p.kind === 'inbox' ? (_jsx(InboxPreview, { file: p.file, columns: p.columns })) : p.kind === 'doc' ? (_jsx(DocPreview, { row: p.row, columns: p.columns })) : (_jsx(SessionPreview, { s: p.s, firstLines: p.firstLines, lastLines: p.lastLines, columns: p.columns, origin: p.origin, note: p.note, live: p.live, resumeModel: p.resumeModel })) }));
 }
 /**
  * T134 — corpo della preview inbox: due righe FISSE, contate da
@@ -40,6 +41,29 @@ export function InboxPreview({ file, columns }) {
                 : 'in coda: una skill può prenderlo da sola';
     return (_jsxs(_Fragment, { children: [_jsxs(Text, { bold: true, wrap: "truncate-end", children: [_jsx(Text, { color: "cyan", children: NATURA_SHORT[file.natura] }), ' ', cut(file.basename, Math.max(10, width - 8))] }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [file.nozioni, " nozioni \u00B7 ", file.aperte, " aperte \u00B7 ", fmtSize(file.chars), " \u00B7", ' ', fmtDateTime(file.created * 1000), file.cappello ? ` · ${file.cappello}` : '', file.indexed ? ' · indexed' : '', " \u00B7 ", state] })] }));
 }
+/**
+ * T160 — corpo della preview doc: due righe FISSE, contate da
+ * `DOC_DETAIL_FIXED`. Ogni riga aggiunta va scalata lì, o il frame sfonda `rows`
+ * e Ink passa a `clearTerminal`.
+ *
+ * Porta le due cose che la riga di lista non può (P6): il PATH intero — in lista
+ * l'albero mostra l'ultimo segmento e le viste piatte troncano — e i NOMI INTERI
+ * dei flag accanto alle cifre che li spiegano. Le short di riga dicono quale
+ * flag; qui si legge perché ce l'ha, che è il dato su cui si decide se lanciare
+ * l'operazione.
+ *
+ * La riga meta cambia di natura fra file e cartella e non è un ramo di
+ * cortesia: `char` di un file è la sua lunghezza, `char` di una cartella è la
+ * somma dei suoi — due misure che si confrontano con due soglie diverse, e
+ * mostrarle con la stessa etichetta le farebbe leggere come la stessa cosa.
+ */
+export function DocPreview({ row, columns }) {
+    const width = previewTextWidth(columns);
+    const names = flagNames(row.flags);
+    return (_jsxs(_Fragment, { children: [_jsxs(Text, { bold: true, wrap: "truncate-end", children: [_jsx(Text, { color: "cyan", children: row.kind === 'dir' ? 'dir ' : 'file' }), ' ', cut(row.path, Math.max(10, width - 6))] }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [row.kind === 'dir'
+                        ? `${row.files} file · ${fmtSize(row.chars)} in cartella`
+                        : `${fmtSize(row.chars)} · TLDR ${row.tldr || 'assente'}`, ' · ', names.length > 0 ? names.join(' · ') : 'nessun flag: in equilibrio'] })] }));
+}
 // T49 — corpo della preview sessione. Tutti i campi vengono dal parse già
 // cached dell'adapter (mtime-keyed): non costa I/O al movimento di selezione.
 // Mostra "da dove parte, dove è arrivata": il primo prompt utente (`» `) e

package/dist/ui/screens.js

@@ -34,7 +34,7 @@ import { taskColumns } from '../view.js';
 import { AssignScreen } from './assign-screen.js';
 import { DetailScreen } from './detail-screen.js';
 import { StatusScreen } from './status-screen.js';
-import { InboxScreen } from './inbox-screen.js';
+import { FileSheetScreen, docSheetHead, inboxSheetHead } from './file-sheet-screen.js';
 import { WrapScreen } from './wrap-screen.js';
 import { SpawnScreen } from './spawn-screen.js';
 import { ReaderScreen, SearchScreen } from './search-screen.js';
@@ -108,7 +108,7 @@ export function HintBar({ mode, purge, keyLegend, indicators, columns, }) {
  */
 export function screenFor(input) {
     const { mode, rows, columns, note, overlays } = input;
-    const { assign, sheet, search, status, inbox, wrap, spawn } = overlays;
+    const { assign, sheet, search, status, inbox, doc, wrap, spawn } = overlays;
     // ── T57 · schermata di assegnazione ─────────────────────────────────────
     // Sostitutiva come ricerca e reader (D3): la lista task non entra in un box
     // sopra i due pane, e prendendo l'intero frame non costa nulla al loro budget.
@@ -169,12 +169,24 @@ export function screenFor(input) {
     // nozioni supera i 28KB, cioè è più lungo di ogni task file del progetto.
     if (mode === 'inbox' && inbox.sheet) {
         if (isCompact(inbox.capacity)) {
-            return (_jsx(CompactNotice, { what: inbox.sheet.file.basename, esc: "chiude", rows: rows, columns: columns }));
+            return (_jsx(CompactNotice, { what: inbox.sheet.item.basename, esc: "chiude", rows: rows, columns: columns }));
         }
         // Il clamp serve anche qui: un resize può accorciare il testo sotto uno
         // scroll già dato.
         const start = Math.min(inbox.top, inbox.maxTop);
-        return (_jsx(InboxScreen, { file: inbox.sheet.file, missing: inbox.sheet.text === null, lines: inbox.lines.slice(start, start + inbox.capacity), spans: inbox.doc?.spans ?? [], top: start, total: inbox.lines.length, capacity: inbox.capacity, prompt: inbox.prompt, columns: columns }));
+        return (_jsx(FileSheetScreen, { head: inboxSheetHead(inbox.sheet.item), missing: inbox.sheet.text === null, lines: inbox.lines.slice(start, start + inbox.capacity), spans: inbox.doc?.spans ?? [], top: start, total: inbox.lines.length, capacity: inbox.capacity, prompt: inbox.prompt, hint: inbox.hint, columns: columns }));
+    }
+    // ── T160 · detail di un bersaglio doc ───────────────────────────────────
+    // Nona schermata sostitutiva: la stessa dell'inbox (`useFileSheet`, due
+    // istanze) su un altro oggetto. Su una cartella il corpo porta l'elenco dei
+    // suoi file al posto di un testo (P10): il gesto è lo stesso, cambia cosa si
+    // legge.
+    if (mode === 'doc' && doc.sheet) {
+        if (isCompact(doc.capacity)) {
+            return _jsx(CompactNotice, { what: doc.sheet.item.path, esc: "chiude", rows: rows, columns: columns });
+        }
+        const start = Math.min(doc.top, doc.maxTop);
+        return (_jsx(FileSheetScreen, { head: docSheetHead(doc.sheet.item), missing: doc.sheet.text === null, lines: doc.lines.slice(start, start + doc.capacity), spans: doc.doc?.spans ?? [], top: start, total: doc.lines.length, capacity: doc.capacity, prompt: doc.prompt, hint: doc.hint, columns: columns }));
     }
     // ── T134 · lista hard-wrap ──────────────────────────────────────────────
     // Settima schermata sostitutiva: sul cappello lo scan trova 77 `WRAP` e 147

package/dist/viewport.js

@@ -29,12 +29,17 @@ const MAX_DETAIL_LINES = 6;
 // a un pane va scalata qui, o il frame sfonda `rows` e Ink passa a
 // clearTerminal (frame-fantasma nello scrollback di VTE).
 const TASKS_PANE_CHROME = 6; // 2 bordi + header "Tasks (n)" + riga sort + 2 righe meta
-// T134 — vale per ENTRAMBI i pane dello slot destro: il pane inbox ha la stessa
-// cornice (2 bordi + header) e uno solo dei due è montato alla volta, quindi
-// `Budget.sessionRows` è la capienza del pane destro qualunque esso sia. Se un
-// giorno l'inbox guadagnasse una riga fissa, questa costante deve sdoppiarsi e
-// il budget guadagnare un ramo: una riga fissa non contata è ciò che fa sfondare
-// `rows` e manda Ink nel ramo `clearTerminal`.
+// T134/T160 — vale per TRE pane su quattro: conversazioni, coda inbox e albero
+// doc hanno la stessa cornice (2 bordi + header) e ne sono montati al massimo
+// due alla volta, quindi `Budget.sessionRows` è la capienza di ognuno di loro.
+// Solo il pane task ha una cornice propria (`TASKS_PANE_CHROME`), perché porta
+// la riga sort e le due righe meta.
+//
+// Il pane doc sta nello slot SINISTRO e paga comunque questa cornice, non quella
+// del pane task: il costo lo decide ciò che il pane disegna, non il lato in cui
+// sta. Se un giorno uno dei tre guadagnasse una riga fissa, questa costante deve
+// sdoppiarsi e il budget guadagnare un ramo — una riga fissa non contata è ciò
+// che fa sfondare `rows` e manda Ink nel ramo `clearTerminal`.
 const SESSIONS_PANE_CHROME = 3; // 2 bordi + header "Sessions · …"
 const PREVIEW_CHROME = 3; // marginTop + 2 bordi
 /** Preview sessione: righe fisse = titolo + riga meta (size · turni · ultima
@@ -50,6 +55,11 @@ const MAX_SESSION_PREVIEW = 3;
  *  lettura di file a ogni movimento di selezione per un'anteprima che il detail
  *  dà per intero. */
 const INBOX_DETAIL_FIXED = 2;
+/** T160 — preview doc: nome intero del bersaglio + riga meta (cifre e nomi
+ *  interi dei flag). Righe TUTTE fisse come per l'inbox, e per la stessa
+ *  ragione: il corpo del file sta nel detail fullscreen, e mostrarne qui le
+ *  prime righe costerebbe una lettura di file a ogni movimento di selezione. */
+const DOC_DETAIL_FIXED = 2;
 /** Altezza di ciascuna modale, marginTop incluso. In flusso, non in overlay:
  *  spingono giù i pane, quindi il loro costo va scalato dal budget. */
 export const MODAL_HEIGHT = {
@@ -89,8 +99,13 @@ export const MODAL_HEIGHT = {
     status: 0,
     // T134 — il detail di un file inbox: sesta sostitutiva. Un file di nozioni
     // arriva a 28KB, cioè più lungo di ogni task file del progetto: la stessa
-    // ragione delle altre cinque. Altezza da `inboxDetailCapacity`.
+    // ragione delle altre cinque. Altezza da `fileSheetCapacity`.
     inbox: 0,
+    // T160 — il detail di un bersaglio doc, nona sostitutiva: stessa schermata
+    // dell'inbox (`useFileSheet`, due istanze) su un altro oggetto. Un modo
+    // proprio e non uno condiviso perché `esc` deve riportare al pane da cui si è
+    // entrati, e un modo solo obbligherebbe a ricordarselo altrove.
+    doc: 0,
     // T134 — la lista hard-wrap: settima sostitutiva. Sul cappello lo scan trova
     // 77 `WRAP` e 147 `misto`, cioè una lista che non entra in nessun box sopra i
     // pane. Altezza da `wrapListCapacity`.
@@ -184,11 +199,13 @@ export function layoutBudget(input) {
             previewCost = fixed + sessionFirstLines + sessionLastLines;
         }
     }
-    else if (input.preview === 'inbox') {
+    else if (input.preview === 'inbox' || input.preview === 'doc') {
         // Tutte righe fisse: o il blocco entra intero o non esiste. Non c'è una
         // parte variabile da sacrificare per farlo stare, quindi non c'è nemmeno la
-        // domanda di quanto concedergli.
-        const fixed = PREVIEW_CHROME + INBOX_DETAIL_FIXED;
+        // domanda di quanto concedergli. I due blocchi costano uguale e non sono
+        // mai a schermo insieme (stanno nei due pane dello stesso modo, e il blocco
+        // preview è uno solo, scelto dal focus).
+        const fixed = PREVIEW_CHROME + (input.preview === 'inbox' ? INBOX_DETAIL_FIXED : DOC_DETAIL_FIXED);
         if (avail - floor - fixed >= 0) {
             preview = true;
             previewCost = fixed;
@@ -309,21 +326,27 @@ const STATUS_CHROME = 8;
 export function statusCapacity(rows) {
     return Math.max(0, (rows || 24) - SLACK - STATUS_CHROME);
 }
-// T134 — cornice del detail di un file inbox. Gemella di STATUS_CHROME più una
-// riga: il detail porta in fondo la riga dell'azione (quale skill partirà su
-// `⏎`), che è l'unica cosa che l'utente deve leggere prima di premere.
+// T134/T160 — cornice del detail di un FILE, condivisa dalle due istanze dello
+// sheet (coda inbox e bersaglio doc). Gemella di STATUS_CHROME più una riga: il
+// detail porta in fondo la riga dell'azione (quale comando partirà su `⏎`), che
+// è l'unica cosa che l'utente deve leggere prima di premere.
 //   2  bordi del box esterno
-//   1  riga di testata (natura :: nome del file)
+//   1  riga di testata (natura o tipo :: nome del bersaglio)
 //   1  riga meta (marcatori · cifre · posizione nel testo)
 //   1  riga hint
 //   1  marginTop del box corpo
 //   2  bordi del box corpo
 //   1  marginTop della riga azione
 //   1  riga azione
-const INBOX_CHROME = 10;
-/** Righe di file inbox che entrano nel terminale. */
-export function inboxDetailCapacity(rows) {
-    return Math.max(0, (rows || 24) - SLACK - INBOX_CHROME);
+//
+// Una costante sola per le due schermate perché è la stessa cornice, disegnata
+// dallo stesso schema: due numeri uguali con due nomi diversi divergerebbero al
+// primo ritocco di una delle due, e quella che resta indietro sfonda `rows`
+// senza che niente lo dica.
+const FILE_SHEET_CHROME = 10;
+/** Righe di testo che entrano nel terminale dentro uno sheet di file. */
+export function fileSheetCapacity(rows) {
+    return Math.max(0, (rows || 24) - SLACK - FILE_SHEET_CHROME);
 }
 // T134 — cornice della lista hard-wrap.
 //   2  bordi del box esterno

package/package.json

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

@@ -299,10 +299,11 @@ WORKDIR="${LOOM_DECK_WORKDIR:-$PWD}"
 # conversazione portava due titoli diversi, senza errore. Le quadre che
 # delimitavano il prefisso sono cadute col prefisso stesso: l'emoji da sola si
 # stacca già dallo slug.
-# T161 — le sei stanno tutte nei TEMPLATE di titolo del catalogo delle azioni
-# (`SPAWN_ACTIONS` in `src/spawn-catalog.ts`), che il progetto può riscrivere:
-# quattro nominano un'azione su una task (📐🚀📊🏁), 🧹 il file inbox che si
-# drena, 📏 il path che si srotola.
+# T161/T160 — le sette stanno tutte nei TEMPLATE di titolo del catalogo delle
+# azioni (`SPAWN_ACTIONS` in `src/spawn-catalog.ts`), che il progetto può
+# riscrivere: quattro nominano un'azione su una task (📐🚀📊🏁), 🧹 il file inbox
+# che si drena, 📏 il path che si srotola, 🧭 il bersaglio doc che si
+# riorganizza.
 # Questa whitelist ha un GEMELLO TypeScript (`saneNote` in `src/sane-note.ts`),
 # che riduce il template al salvataggio perché quello che sta nel file di
 # progetto sia quello che la tab mostrerà. I due lati non si leggono a vicenda e
@@ -335,7 +336,7 @@ _sane_note() {  # <raw> → nota ridotta, spazi collassati, cap 60 char
   # `tr` non ne ha bisogno: squeeza uno spazio ASCII, e 0x20 non compare mai
   # come byte di continuazione di una sequenza UTF-8.
   s="$(printf '%s' "$1" \
-       | LC_ALL=C.UTF-8 sed 's/[^A-Za-z0-9 _àèéìòùÀÈÉÌÒÙ📐🚀📊🏁🧹📏-]//g' \
+       | LC_ALL=C.UTF-8 sed 's/[^A-Za-z0-9 _àèéìòùÀÈÉÌÒÙ📐🚀📊🏁🧹📏🧭-]//g' \
        | tr -s ' ')"
   s="${s# }"; s="${s% }"
   printf '%s' "${s:0:60}"