@lamemind/loom-deck 0.56.1 → 0.57.0

package/dist/viewport.js

@@ -29,6 +29,12 @@ 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`.
 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
@@ -36,6 +42,12 @@ const PREVIEW_CHROME = 3; // marginTop + 2 bordi
  *  variabili, ciascuna al più MAX_SESSION_PREVIEW righe. */
 const SESSION_DETAIL_FIXED = 2;
 const MAX_SESSION_PREVIEW = 3;
+/** T134 — preview inbox: nome del file + riga meta (natura, marcatori, branch,
+ *  cappello, cifre, età). Righe TUTTE fisse, nessuna variabile: il corpo del
+ *  file sta nel detail fullscreen, e mostrarne qui le prime righe costerebbe una
+ *  lettura di file a ogni movimento di selezione per un'anteprima che il detail
+ *  dà per intero. */
+const INBOX_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 = {
@@ -73,6 +85,14 @@ export const MODAL_HEIGHT = {
     // progetto è un documento lungo quanto un task file, quindi vale la stessa
     // ragione delle altre quattro. La sua altezza la distribuisce `statusCapacity`.
     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`.
+    inbox: 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`.
+    wrap: 0,
 };
 /**
  * Distribuisce le righe disponibili fra lista task, lista sessioni e preview.
@@ -158,6 +178,16 @@ export function layoutBudget(input) {
             previewCost = fixed + sessionFirstLines + sessionLastLines;
         }
     }
+    else if (input.preview === 'inbox') {
+        // 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;
+        if (avail - floor - fixed >= 0) {
+            preview = true;
+            previewCost = fixed;
+        }
+    }
     // Ciò che resta va a ENTRAMBE le colonne: la preview sta sotto il blocco dei
     // pane, quindi il suo costo lo pagano insieme una volta sola.
     const listAvail = avail - previewCost;
@@ -272,6 +302,36 @@ 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.
+//   2  bordi del box esterno
+//   1  riga di testata (natura :: nome del file)
+//   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);
+}
+// T134 — cornice della lista hard-wrap.
+//   2  bordi del box esterno
+//   1  riga di testata (conteggi + ora dell'ultimo scan)
+//   1  riga hint
+//   1  marginTop del box lista
+//   2  bordi del box lista
+//   1  marginTop del box path
+//   2  bordi del box path
+//   1  riga del campo path
+const WRAP_CHROME = 12;
+/** Righe di lista che entrano nel terminale. */
+export function wrapListCapacity(rows) {
+    return Math.max(0, (rows || 24) - SLACK - WRAP_CHROME);
+}
 /**
  * Righe scorse da una pressione di PagGiù/PagSu: METÀ della capienza visibile.
  *

package/dist/wrap-scan.js

@@ -45,7 +45,11 @@ export function parseWrapTsv(stdout) {
             if (m)
                 fields[m[1]] = m[2];
         }
-        const column = Number(fields.col);
+        // `Number('')` vale 0, non NaN: senza il controllo sul campo VUOTO una
+        // colonna non stimabile (troppe poche righe candidate) si leggerebbe come
+        // `col=0`, cioè una misura che non esiste travestita da misura.
+        const raw = fields.col ?? '';
+        const column = raw === '' ? Number.NaN : Number(raw);
         out.push({
             verdict,
             path: cells[1],
@@ -73,6 +77,31 @@ export function parseWrapTsv(stdout) {
 export function wrapCount(files) {
     return files.filter((f) => f.verdict === 'WRAP').length;
 }
+/** Quanti file `misto`: fuori dal contatore ma in lista, col proprio marker. */
+export function mixedCount(files) {
+    return files.filter((f) => f.verdict === 'misto').length;
+}
+/** Radice di default dell'area di srotolamento: la project root intera (D4). */
+export const WRAP_DEFAULT_PATH = '.';
+/**
+ * Il prompt della sessione che srotola un path.
+ *
+ * CABLATO per decisione, non per fretta (D9): parametrizzarlo prima di aver
+ * visto come si comporta significherebbe scegliere i parametri a occhio. Le tre
+ * cose che dice sono le tre che rendono l'operazione reversibile e verificabile
+ * — backup fuori dal repo, rapporto, commit solo se il diff è chiaramente
+ * innocuo — e nessuna delle tre è una preferenza da esporre.
+ *
+ * Il `<path>` è l'unico buco. Arriva dal campo della lista e finisce dentro
+ * `--prompt` come argv singolo, quindi non passa da nessuna shell prima di
+ * `deck-run`, che lo quota ad apici singoli: non c'è quoting da fare qui.
+ */
+export function wrapPrompt(path) {
+    const target = path.trim() || WRAP_DEFAULT_PATH;
+    return (`lancia md-wrap modo apply su ${target} e backup in cartella tmp dedicata. ` +
+        'verifica risultato e fai rapporto. se le modifiche sono tutte chiaramente safe, ' +
+        'puoi committare direttamente');
+}
 /**
  * Cartella della cache, una per utente e con `mode 0700` — stessa ragione del
  * project status: `/tmp` è condivisa, e un file a nome prevedibile può essere

package/package.json

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

@@ -26,8 +26,12 @@
 # Il quarto asse (T108) è indipendente dagli altri tre: vale sul ramo bound come
 # su --no-task, su una sessione nuova come su una ripresa.
 #
-# 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 --no-task la sessione è NUDA: niente LOOM_TASK, niente --session-id.
+# Serve al lavoro spot che non appartiene a nessuna task.
+# T134 — un prompt iniziale ce l'ha se glielo si passa LETTERALE (`--prompt`):
+# il lavoro sulla doc — drenare un file inbox, srotolare l'hard-wrap di un path
+# — non appartiene a nessuna task e non deve ereditarne una. I `--prompt-kind`
+# del catalogo restano invece rifiutati con --no-task: nominano tutti un TaskID.
 #
 # Con --resume <sid> riprende una conversazione esistente; aggiungendo --fork la
 # riprende RAMANDOLA (`--fork-session`): id nuovo, transcript copiato, l'origine
@@ -172,7 +176,9 @@ USAGE="uso: deck-run <TaskID> [--model <alias>] [--prompt-kind <kind>] [--sessio
        checkpoint  /loom-works:checkpoint-task <TaskID>
 
   --prompt       prompt LETTERALE, per chi lo ha già composto (o fatto
-                 modificare). Esclusivo con --prompt-kind; vuoto = nessun prompt
+                 modificare). Esclusivo con --prompt-kind; vuoto = nessun
+                 prompt. Ammesso anche con --no-task: un testo già scritto non
+                 ha una task da nominare, a differenza dei kind del catalogo
 
   --model        modello della sessione: fable|opus|sonnet|haiku (default: opus)
                  valore ignoto → fallback sul default, con avviso su stderr
@@ -219,11 +225,21 @@ if [[ $NO_TASK -eq 1 && -n "$PROMPT_KIND" ]]; then
   echo "$USAGE" >&2
   exit 2
 fi
-if [[ $NO_TASK -eq 1 && $PROMPT_GIVEN -eq 1 ]]; then
-  echo "--prompt richiede una task: una sessione --no-task non ha prompt iniziale" >&2
-  echo "$USAGE" >&2
-  exit 2
-fi
+# T134/D9 — `--prompt` con `--no-task` è AMMESSO, e il divieto che c'era qui è
+# caduto. Il razionale del divieto valeva per il catalogo, non per il testo
+# letterale: i sette kind nominano tutti il TaskID, quindi senza task non c'è
+# nulla da chiedere loro; un prompt già composto dal chiamante non ha invece
+# nessuna task da nominare — e ce ne sono di legittimi che non ne hanno una.
+# Il caso che ha fatto cadere il divieto: il deck offre il drain di un file
+# inbox e lo srotolamento dei `.md` di un path, due lavori che stanno sulla doc
+# e non su una task; legarli a un cappello esporterebbe `LOOM_TASK`, farebbe
+# iniettare in contesto il task file di un lavoro chiuso e metterebbe `· T<n>`
+# nel titolo della tab (D10 preflight).
+#
+# Il divieto gemello su `--prompt-kind` RESTA. Toglierlo non è simmetrico:
+# ogni template del catalogo interpola `{TASK}`, e senza task produrrebbe un
+# prompt come `/loom-works:run-task ` con l'id vuoto — cioè una sessione che
+# parte su un comando monco, che è il guasto che il divieto esiste per evitare.
 # Due modi di dire la stessa cosa: accettarli insieme obbligherebbe a stabilire
 # quale vince, cioè a scrivere una precedenza che nessun chiamante ha chiesto.
 if [[ $PROMPT_GIVEN -eq 1 && -n "$PROMPT_KIND" ]]; then
@@ -528,7 +544,12 @@ PROMPT_ARG=""
 # scelta di chi apre la sessione, non una proprietà della task né della ripresa
 # (T108) — stesso layer di MODE_FLAG, che infatti gli sta accanto.
 if [[ $NO_TASK -eq 1 ]]; then
-  _default_intab="${PROFILE_ENV}claude --name '${TITLE}' ${MODE_FLAG}${MODEL_FLAG}${SID_FLAG}${RES_FLAG}${FORK_FLAG}"
+  # T134/D9 — il PROMPT_ARG entra anche qui: dal 134 una sessione nuda può
+  # nascere su un prompt letterale (drain di un file inbox, srotolamento di un
+  # path). Resta vuoto su ogni altro percorso `--no-task`, perché senza
+  # `--prompt` il ramo del catalogo non gira — `PROMPT_KIND` con `--no-task`
+  # è ancora rifiutato a monte.
+  _default_intab="${PROFILE_ENV}claude --name '${TITLE}' ${MODE_FLAG}${MODEL_FLAG}${SID_FLAG}${RES_FLAG}${FORK_FLAG}${PROMPT_ARG}"
 else
   _default_intab="${PROFILE_ENV}LOOM_TASK=${TASK} claude --name '${TITLE}' ${MODE_FLAG}${MODEL_FLAG}${SID_FLAG}${RES_FLAG}${FORK_FLAG}${PROMPT_ARG}"
 fi