@lamemind/loom-deck 0.67.0 → 0.69.0

package/dist/ui/screens.js

@@ -36,6 +36,7 @@ import { DetailScreen } from './detail-screen.js';
 import { StatusScreen } from './status-screen.js';
 import { InboxScreen } from './inbox-screen.js';
 import { WrapScreen } from './wrap-screen.js';
+import { SpawnScreen } from './spawn-screen.js';
 import { ReaderScreen, SearchScreen } from './search-screen.js';
 /**
  * Il ripiego per un terminale troppo basso: una riga sola al posto della
@@ -107,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 } = overlays;
+    const { assign, sheet, search, status, inbox, 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.
@@ -185,6 +186,16 @@ export function screenFor(input) {
         const start = Math.min(wrap.top, wrap.maxTop);
         return (_jsx(WrapScreen, { files: wrap.files.slice(start, start + wrap.capacity), count: wrap.count, mixed: wrap.mixed, mtime: wrap.mtime, top: start, capacity: wrap.capacity, path: wrap.path, caret: wrap.caret, columns: columns }));
     }
+    // ── T161 · pagina delle azioni di spawn ─────────────────────────────────
+    // Ottava schermata sostitutiva: undici righe per quattro colonne, più l'area
+    // di compilazione. In un box sopra i due pane al prompt resterebbero due
+    // colonne.
+    if (mode === 'spawn' && spawn.open) {
+        if (isCompact(spawn.capacity)) {
+            return _jsx(CompactNotice, { what: "azioni di spawn", esc: "chiude", rows: rows, columns: columns });
+        }
+        return (_jsx(SpawnScreen, { rows: spawn.table, sel: spawn.sel, top: Math.min(spawn.top, spawn.maxTop), capacity: spawn.capacity, configured: spawn.table.filter((r) => r.touched).length, dirty: spawn.dirty, editing: spawn.editing, editable: spawn.editable, fieldTitle: spawn.fieldTitle, fieldModel: spawn.fieldModel, fieldPrompt: spawn.fieldPrompt, cursor: spawn.cursor, example: spawn.example, columns: columns, note: note }));
+    }
     // ── T52 · ricerca e reader ──────────────────────────────────────────────
     // Gli unici modali che NON stanno in flusso sopra i pane: una lista di
     // occorrenze non entra in un box da 4 righe. Prendono l'intero frame, quindi

package/dist/ui/spawn-screen.js

@@ -0,0 +1,99 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+// T161 — la pagina delle azioni di spawn: la tabella e la sua area di
+// compilazione.
+import { Box, Text } from 'ink';
+import { cut, pad, sanitize, termWidth } from '../width.js';
+import { ChoiceRow, FieldText, LABEL_W } from './fields.js';
+import { CARET, CARET_OFF } from '../glyphs.js';
+import { interpolate, saneNote } from '../sane-note.js';
+import { MODELS, SPAWN_FIELDS, spawnCell, } from '../spawn-catalog.js';
+/**
+ * Il glifo della riga configurata.
+ *
+ * Non è riusato da nessun'altra superficie del deck: `●`/`◍` dicono la liveness
+ * di un processo, `📌`/`🔗`/`○` l'appartenenza di una conversazione, `✎` il
+ * titolo — un falso amico costa più di un simbolo nuovo. Concorde alle due
+ * contabilità di larghezza (`agrees('◆')`), quindi `sanitize` lo lascia passare
+ * invece di renderlo `·`.
+ */
+const TOUCHED = '◆';
+/** Cella del glifo: si riempie di spazi anche quando è vuota, o le righe non
+ *  configurate sposterebbero a sinistra tutto ciò che segue. */
+const MARK_W = 2;
+/** Colonna modello: il dominio è chiuso, e a decidere la larghezza non è la voce
+ *  più lunga (`sonnet`, 6) ma l'INTESTAZIONE — `modello` ne vuole 7, e una
+ *  testata di colonna troncata con l'ellissi si legge come un difetto. */
+const MODEL_W = 7;
+/** Tetto della colonna funzione: la label più lunga del catalogo (`drain di un
+ *  file inbox`) sta esattamente dentro. Un tetto più alto le celle le
+ *  toglierebbe al prompt, che è l'unico dei quattro valori senza una forma
+ *  breve; più basso troncherebbe due label su undici già a piena larghezza. */
+const FUNC_MAX = 22;
+/** Le etichette delle righe dell'area, in italiano come ogni altra etichetta a
+ *  schermo: la chiave del campo è un nome del codice e finisce nel file di
+ *  progetto, non sotto gli occhi di chi compila. */
+const FIELD_LABEL = {
+    title: 'titolo',
+    model: 'modello',
+    prompt: 'prompt',
+};
+/**
+ * Le quattro colonne, per sottrazione come ogni lista del deck: le fisse sono
+ * note, e ciò che resta si divide fra titolo e prompt.
+ *
+ * Il prompt prende la fetta maggiore perché è l'unico dei quattro valori che non
+ * ha una forma breve: un titolo tagliato resta riconoscibile dal prefisso, un
+ * prompt tagliato a dieci colonne dice solo `/loom-works…`.
+ *
+ * Pavimento 0 su ogni cella: è un tetto, non una preferenza, e alzarlo sopra lo
+ * spazio reale fa uscire la riga dal box mangiandone il bordo (invariante ③ di
+ * `width.ts`).
+ */
+export function spawnColumns(width, rows) {
+    // `- 4` = bordo + padding del box tabella, che sta DENTRO quello esterno.
+    const avail = Math.max(0, width - 4);
+    const func = Math.min(FUNC_MAX, Math.max(0, ...rows.map((r) => termWidth(r.action.label))));
+    // I tre separatori fra le quattro colonne vanno contati insieme alle celle:
+    // sommare solo le celle è l'off-by-one che tronca la coda della riga.
+    const rest = Math.max(0, avail - CARET_OFF.length - MARK_W - func - MODEL_W - 3);
+    // Il titolo ha un TETTO oltre il quale non cresce: i template sono corti
+    // (`📊 {slug}`), quindi su un terminale largo ogni colonna in più gli
+    // resterebbe vuota mentre al prompt serve.
+    const title = Math.min(28, Math.floor(rest * 0.4));
+    return { func, title, model: MODEL_W, prompt: Math.max(0, rest - title) };
+}
+/** Una cella della tabella, col suo colore: il valore in chiaro, il segnaposto
+ *  smorzato, l'override in ciano — l'origine si legge senza una legenda. */
+function Cell({ row, field, value, width, }) {
+    const cell = spawnCell(row.action, field, value, row.raw.overridden.has(field));
+    const text = cut(cell.text, width);
+    return (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: cell.placeholder, color: cell.origin === 'override' && !cell.placeholder ? 'cyan' : undefined, children: text }), ' '.repeat(Math.max(0, width - termWidth(text)))] }));
+}
+export function SpawnScreen({ rows, sel, top, capacity, configured, dirty, editing, editable, fieldTitle, fieldModel, fieldPrompt, cursor, example, columns, note, }) {
+    const width = Math.max(20, (columns || 80) - 4);
+    const col = spawnColumns(width, rows);
+    const window = rows.slice(top, top + capacity);
+    const current = rows[sel];
+    /** La riga disegnata `field` è quella in fuoco? Il cursore indicizza le sole
+     *  celle editabili, la resa le disegna tutte e tre. */
+    const focused = (field) => editing && editable[cursor.row] === field;
+    const textW = Math.max(10, width - LABEL_W - CARET_OFF.length);
+    // L'anteprima si fa sul titolo GIÀ ridotto, come lo farà `deck-run`: mostrare
+    // il template interpolato ma non ridotto prometterebbe un titolo che la tab
+    // non porta.
+    const rendered = saneNote(interpolate(fieldTitle, example) ?? '');
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [_jsxs(Text, { bold: true, wrap: "truncate-end", children: [_jsx(Text, { color: "cyan", children: "azioni di spawn" }), ' ', _jsxs(Text, { dimColor: true, children: ["\u00B7 ", rows.length, " azioni \u00B7 ", configured, " configurate"] }), dirty ? _jsx(Text, { color: "yellow", children: " \u00B7 modifiche non salvate" }) : null] }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [_jsx(Text, { color: "yellow", children: "\u2191\u2193" }), " riga \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), ' ', editing ? 'conferma' : 'modifica', " \u00B7 ", _jsx(Text, { color: "yellow", children: "CANC" }), " torna al default \u00B7", ' ', _jsx(Text, { color: "yellow", children: "w" }), " salva \u00B7 ", _jsx(Text, { color: "yellow", children: "esc" }), ' ', editing ? 'annulla' : 'chiude'] }), _jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: "gray", paddingX: 1, marginTop: 1, children: [_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [CARET_OFF, ' '.repeat(MARK_W), pad('funzione', col.func), " ", pad('titolo', col.title), " ", pad('modello', col.model), ' ', pad('prompt', col.prompt)] }), window.map((r, i) => {
+                        const at = top + i;
+                        return (_jsxs(Text, { wrap: "truncate-end", children: [at === sel ? CARET : CARET_OFF, _jsx(Text, { color: "cyan", children: pad(r.touched ? TOUCHED : '', MARK_W) }), _jsx(Text, { bold: at === sel, children: pad(cut(r.action.label, col.func), col.func) }), ' ', _jsx(Cell, { row: r, field: "title", value: r.raw.title, width: col.title }), ' ', _jsx(Cell, { row: r, field: "model", value: r.raw.model, width: col.model }), ' ', _jsx(Cell, { row: r, field: "prompt", value: r.raw.prompt, width: col.prompt })] }, r.action.id));
+                    })] }), editing ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [SPAWN_FIELDS.map((field) => {
+                        const fixed = current.action.fixed[field];
+                        if (fixed !== undefined) {
+                            return (_jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [CARET_OFF, FIELD_LABEL[field].padEnd(LABEL_W), "(", fixed, ")"] }, field));
+                        }
+                        if (field === 'model') {
+                            return (_jsx(ChoiceRow, { label: "modello", values: MODELS, index: Math.max(0, MODELS.indexOf(fieldModel)), focused: focused('model'), width: width }, field));
+                        }
+                        const value = field === 'title' ? fieldTitle : fieldPrompt;
+                        return (_jsxs(Text, { wrap: "truncate-end", children: [focused(field) ? CARET : CARET_OFF, _jsx(Text, { dimColor: true, children: FIELD_LABEL[field].padEnd(LABEL_W) }), _jsx(FieldText, { value: value, caret: cursor.caret, focused: focused(field), cols: textW })] }, field));
+                    }), _jsxs(Text, { dimColor: true, wrap: "truncate-end", children: [CARET_OFF, 'esempio'.padEnd(LABEL_W), current.action.title === null ? ('nessun titolo per questa azione') : (_jsx(Text, { color: rendered ? 'green' : undefined, children: rendered ? cut(rendered, textW) : 'titolo a vuoto: nessuna nota' }))] })] })) : null, note ? _jsx(Text, { color: "green", wrap: "truncate-end", children: sanitize(note) }) : null] }));
+}

package/dist/viewport.js

@@ -95,6 +95,10 @@ export const MODAL_HEIGHT = {
     // 77 `WRAP` e 147 `misto`, cioè una lista che non entra in nessun box sopra i
     // pane. Altezza da `wrapListCapacity`.
     wrap: 0,
+    // T161 — la pagina delle azioni di spawn: ottava sostitutiva. Undici righe di
+    // tabella più l'area di compilazione: in un box sopra i pane resterebbero due
+    // colonne per il prompt. Altezza da `spawnListCapacity`.
+    spawn: 0,
 };
 /**
  * Distribuisce le righe disponibili fra lista task, lista sessioni e preview.
@@ -335,6 +339,37 @@ const WRAP_CHROME = 12;
 export function wrapListCapacity(rows) {
     return Math.max(0, (rows || 24) - SLACK - WRAP_CHROME);
 }
+// T161 — cornice della pagina delle azioni di spawn.
+//   2  bordi del box esterno
+//   1  riga di testata (nome della pagina · quante righe · quante configurate)
+//   1  riga hint
+//   1  marginTop del box tabella
+//   2  bordi del box tabella
+//   1  riga di intestazione delle colonne
+const SPAWN_CHROME = 8;
+// L'area di compilazione: marginTop + le TRE righe (titolo, modello, prompt) +
+// la riga dell'anteprima resa.
+//
+// Fisse e non proporzionali alle celle editabili della riga aperta: su `bare`,
+// che ha il solo modello, le altre due si disegnano comunque per dire perché non
+// si modificano. Un'altezza che dipendesse dalla riga selezionata farebbe
+// saltare la tabella di due righe a ogni movimento del caret, e il budget
+// dovrebbe sapere quale riga è aperta per non sottostimare — lo stesso motivo
+// per cui le cinque righe del detail sono dentro `DETAIL_CHROME` invece che
+// condizionali (T111 · D1).
+const SPAWN_FIELDS_CHROME = 5;
+/**
+ * Righe di tabella che entrano nel terminale.
+ *
+ * Le righe dell'area aperta e la riga di stato si pagano QUI, non altrove: la
+ * pagina è una schermata sostitutiva, quindi la nota che le sue azioni scrivono
+ * la disegna lei — a differenza della lista, dove la riga di stato sta fuori dai
+ * pane e il suo costo è già in `layoutBudget`.
+ */
+export function spawnListCapacity(rows, editing = false, noteLine = false) {
+    const extra = (editing ? SPAWN_FIELDS_CHROME : 0) + (noteLine ? 1 : 0);
+    return Math.max(0, (rows || 24) - SLACK - SPAWN_CHROME - extra);
+}
 /**
  * Righe scorse da una pressione di PagGiù/PagSu: METÀ della capienza visibile.
  *

package/dist/wrap-scan.js

@@ -84,48 +84,29 @@ export function mixedCount(files) {
 /** 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.
+ * T161 — il buco `{path}` del titolo e del prompt di una sessione di
+ * srotolamento: il path reso a parole.
  *
- * 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');
-}
-/** Prefisso del titolo di una sessione di srotolamento. Astrale, come le altre
- *  emoji che finiscono in un titolo: le BMP `sanitize` (`src/width.ts`) le rende
- *  `·`. Va tenuta allineata alla whitelist di `_sane_note` in `deck-run`. */
-const WRAP_EMOJI = '📏';
-/**
- * Il titolo della sessione che srotola un path: `📏 <path a parole>`.
- *
- * Le barre diventano spazi e l'estensione cade PRIMA di `_sane_note`, il cui
- * alfabeto non ha né `/` né `.`: lasciandoceli cadere le parole si salderebbero
- * (`runtimereferencedoc-systemmd`), e il titolo della tab divergerebbe da quello
- * che la lista del deck legge dal sidecar.
+ * Le barre diventano spazi e l'estensione cade QUI, prima di `_sane_note`, il
+ * cui alfabeto non ha né `/` né `.`: lasciandoceli cadere le parole si
+ * salderebbero (`runtimereferencedoc-systemmd`), e il titolo della tab
+ * divergerebbe da quello che la lista del deck legge dal sidecar.
  *
  * Il path di default (`.`, la project root intera) non ha parole da mostrare e
- * diventa una frase: un titolo `📏 ` sarebbe il solo prefisso.
+ * diventa una frase: interpolato in `📏 {path}` darebbe il solo prefisso, cioè
+ * un titolo uguale per ogni srotolamento.
+ *
+ * L'emoji del prefisso non sta più qui: è dentro il template della riga
+ * `unwrap` del catalogo delle azioni, dove il progetto può riscriverla.
  */
-export function wrapTitle(path) {
+export function wrapWords(path) {
     const target = path.trim() || WRAP_DEFAULT_PATH;
     if (target === WRAP_DEFAULT_PATH)
-        return `${WRAP_EMOJI} tutto il progetto`;
-    const words = target
+        return 'tutto il progetto';
+    return target
         .replace(/\.md$/i, '')
         .replace(/[./]+/g, ' ')
         .trim();
-    return `${WRAP_EMOJI} ${words}`;
 }
 /**
  * Cartella della cache, una per utente e con `mode 0700` — stessa ragione del

package/package.json

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

@@ -13,6 +13,8 @@
 #   continuità     nuova ........ --resume [--fork]
 #   prompt         --prompt-kind none|recap|preflight|run|checkpoint | --prompt <testo>
 #   modello        --model fable|opus|sonnet|haiku
+# Fuori dai quattro, e volutamente non un asse: --new-window, che cambia SOLO il
+# verbo dell'exec finale (tab nella finestra attiva → finestra nuova).
 # Il terzo asse (T56) prima non esisteva: il prompt era una CONSEGUENZA degli
 # altri due (bound ⇒ recap, --no-task ⇒ niente, --resume ⇒ niente), quindi
 # "task-bound SENZA prompt" era inesprimibile e l'unico modo di non avere un
@@ -56,6 +58,9 @@
 #   LOOM_DECK_PROFILE_UUID UUID profilo Ptyxis     (default: cc-host)
 #   LOOM_DECK_WORKDIR      dir di lavoro della tab (default: $PWD)
 #   LOOM_DECK_ENTER_PROMPT override del prompt iniziale, {TASK}=TaskID (vince sul kind, tranne `none`)
+#                          T161: inerte sugli spawn che arrivano dal deck TUI —
+#                          quelli passano SEMPRE `--prompt`, su cui non ha mai
+#                          vinto. Resta per le invocazioni a mano e per i test.
 #   LOOM_DECK_INTAB_CMD    override comando in-tab (default: la sessione CC; usato per i test)
 #   LOOM_DECK_STATE_PROFILE  PTYXIS_PROFILE annunciata a compass (default: bindings/claude
 #                            del progetto, letto da dconf; settata a vuoto = nessun annuncio)
@@ -75,6 +80,17 @@ SESSION_ID=""
 RESUME_ID=""
 NO_TASK=0
 FORK=0
+# T162 — finestra NUOVA invece di una tab nella finestra attiva.
+#
+# `ptyxis --tab` va sempre nella finestra col focus, e va bene per il deck, che
+# è già una tab della finestra del progetto. Un chiamante che vive FUORI da
+# quella finestra — compass, che riapre una conversazione pinnata di un
+# progetto chiuso — non ha una finestra attiva giusta: senza un verbo diverso
+# la tab finisce nella finestra di un altro progetto, o in una a caso.
+#
+# Non è un quinto asse: non cambia cosa gira nella tab, solo dove la tab nasce.
+# Vale identico nei due rami di spawn (inline e profile).
+NEW_WINDOW=0
 TITLE_NOTE=""
 # Vuoto = flag non passato (≠ un default già risolto): serve a distinguere
 # "kind implicito" da "kind chiesto", perché con --no-task il primo è legittimo
@@ -154,6 +170,8 @@ while [[ $# -gt 0 ]]; do
       FORK=1; shift ;;
     --no-task)
       NO_TASK=1; shift ;;
+    --new-window)
+      NEW_WINDOW=1; shift ;;
     *)
       if [[ -z "$TASK" ]]; then TASK="$1"; shift
       else echo "argomento inatteso: '$1'" >&2; exit 2; fi ;;
@@ -187,7 +205,10 @@ USAGE="uso: deck-run <TaskID> [--model <alias>] [--prompt-kind <kind>] [--sessio
                  valore ignoto → fallback sul default, con avviso su stderr
 
   --title-note   nota della conversazione, appesa al titolo tab
-                 (ridotta a lettere/cifre/spazi/-/_, cap 60 char)"
+                 (ridotta a lettere/cifre/spazi/-/_, cap 60 char)
+
+  --new-window   apre una FINESTRA nuova invece di una tab nella finestra
+                 attiva. Per chi chiama da fuori dalla finestra del progetto"
 
 if [[ $NO_TASK -eq 1 && -n "$TASK" ]]; then
   echo "--no-task e <TaskID> sono mutuamente esclusivi" >&2
@@ -272,17 +293,22 @@ WORKDIR="${LOOM_DECK_WORKDIR:-$PWD}"
 # italiane, spazio, trattino, underscore e sei emoji (sotto); tutto il resto
 # (apici, backslash, `$`, backtick, `;`, quadre, ogni altra emoji…) cade.
 #
-# T156 — le emoji entrano per il PREFISSO del titolo di fallback che il deck
-# genera quando il campo nota è vuoto (`🚀 slug`, `ACTION_EMOJI` in
-# `src/spawn.ts`). Senza di loro il prefisso spariva qui e restava nella lista
-# del deck, che riceve la nota grezza dal sidecar `session-tasks.jsonl`: la
-# stessa conversazione portava due titoli diversi, senza errore. Le quadre che
+# T156 — le emoji entrano per il PREFISSO del titolo che il deck compone
+# (`🚀 slug`). Senza di loro il prefisso spariva qui e restava nella lista del
+# deck, che riceve la nota grezza dal sidecar `session-tasks.jsonl`: la stessa
+# 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.
-# Quattro nominano un'azione su una task (📐🚀📊🏁); le altre due nominano
-# l'oggetto di una sessione che una task non ce l'ha — 🧹 il file inbox che si
-# drena (`inboxTitle`, `src/inbox.ts`), 📏 il path che si srotola (`wrapTitle`,
-# `src/wrap-scan.ts`).
+# 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.
+# 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
+# vanno cambiati insieme: il custode è il gate di `test/deck-run.test.ts`, che
+# passa la stessa batteria di input a questa funzione e al gemello e pretende
+# l'uguaglianza.
 # La whitelist le nomina una per una e NON apre un intervallo di code point. Due
 # ragioni: un'emoji arriva nella tab solo se il deck la mostra identica in lista,
 # cioè se `sanitize` (`src/width.ts`) la lascia passare invece di renderla `·`, e
@@ -386,7 +412,15 @@ MODE_FLAG="--permission-mode ${PERM_MODE} "
 
 # ── modello (T108 + T152) ────────────────────────────────────────────────────
 # Precedenza: --model > env LOOM_DECK_MODEL > modello del kind nel catalogo >
-# 'fable'. L'ultimo gradino è il gemello bash di `MODEL_DEFAULT` in spawn.ts e
+# 'fable'.
+#
+# T161 — questa cascata vale per chi invoca deck-run A MANO. Il deck TUI passa
+# SEMPRE `--model` già risolto (default del deck ← override di progetto nel
+# blocco `spawn` di `.claude/loom-works.json`), quindi dal deck si ferma al primo
+# gradino e i tre sotto non intervengono mai. Il blocco di progetto qui non si
+# legge di proposito: `jq` è dipendenza opzionale di questo script, e dargli un
+# JSON da consultare la renderebbe obbligatoria su un percorso che oggi degrada
+# senza. L'ultimo gradino è il gemello bash di `MODEL_DEFAULT` in spawn.ts e
 # va tenuto allineato a mano: i due lati non si leggono a vicenda (il deck deve
 # poter MOSTRARE la selezione iniziale prima che deck-run esista come processo),
 # quindi un cambio qui senza l'altro fa partire dalla lista un modello diverso
@@ -653,19 +687,30 @@ IN_TAB_CMD="${LOOM_DECK_INTAB_CMD:-$_default_intab}"
 # vedono comunque quello che vedevano prima.
 printf 'LOOM_DECK_INTAB %s\n' "$IN_TAB_CMD"
 
+# Verbo di apertura (T162): tab nella finestra attiva, o finestra nuova. Una
+# variabile e non due rami duplicati per ogni modalità di spawn — `--new-window`
+# è l'unica differenza fra i due casi.
+if [[ $NEW_WINDOW -eq 1 ]]; then WIN_FLAG="--new-window"; else WIN_FLAG="--tab"; fi
+
 case "$MODE" in
   inline)
     # --tab: tab nella window attiva. -- <cmd>: comando inline nella tab.
     # LOOM_TASK viaggia dentro il comando → nessuna scrittura dconf.
-    exec ptyxis --tab -d "$WORKDIR" -T "${TITLE}" -- bash -lc "$IN_TAB_CMD"
+    exec ptyxis "$WIN_FLAG" -d "$WORKDIR" -T "${TITLE}" -- bash -lc "$IN_TAB_CMD"
     ;;
   profile)
     # --tab-with-profile: riusa il profilo (custom-command FISSO) → per iniettare
     # LOOM_TASK+task va riscritto il custom-command al volo via dconf (stato condiviso).
+    # Con --new-window i due flag convivono: la finestra nasce e il profilo
+    # decide cosa gira nella sua prima tab.
     dpath="/org/gnome/Ptyxis/Profiles/${PROFILE_UUID}/"
     dconf write "${dpath}use-custom-command" true
     dconf write "${dpath}custom-command" "'bash -lc \"${IN_TAB_CMD//\"/\\\"}\"'"
-    exec ptyxis --tab-with-profile="$PROFILE_UUID" -d "$WORKDIR" -T "${TITLE}"
+    if [[ $NEW_WINDOW -eq 1 ]]; then
+      exec ptyxis --new-window --tab-with-profile="$PROFILE_UUID" -d "$WORKDIR" -T "${TITLE}"
+    else
+      exec ptyxis --tab-with-profile="$PROFILE_UUID" -d "$WORKDIR" -T "${TITLE}"
+    fi
     ;;
   *)
     echo "LOOM_DECK_SPAWN_MODE ignoto: '$MODE' (usa 'inline' o 'profile')" >&2

package/scripts/prompt-catalog

@@ -8,9 +8,23 @@
 #
 # Perché un file dati e non un `case` dentro deck-run: due lati hanno bisogno
 # dello stesso testo — deck-run per comporre il comando in-tab, il deck TUI per
-# pre-riempire il campo prompt (e ora anche il modello) del detail con ciò che
-# sta per essere eseguito. Come codice, il secondo lato dovrebbe riscriverlo, e
-# le due copie divergono alla prima voce aggiunta da una parte sola.
+# pre-riempire i campi del detail con ciò che sta per essere eseguito. Come
+# codice, il secondo lato dovrebbe riscriverlo, e le due copie divergono alla
+# prima voce aggiunta da una parte sola.
+#
+# T161 — questo file resta la FONTE UNICA dei sette kind, e non è diventato un
+# blocco JSON nel file di progetto per una ragione precisa: `jq` è dipendenza
+# OPZIONALE di deck-run, e un JSON da consultare la renderebbe obbligatoria su
+# un percorso che oggi degrada senza. Le sue righe sono il primo gradino del
+# default di un'azione su task; il secondo è la riga di catalogo in
+# `src/spawn-catalog.ts`, e sopra entrambi sta l'override di progetto nel blocco
+# `spawn` di `.claude/loom-works.json`, che legge il solo deck.
+#
+# Le azioni SENZA kind (la sessione nuda, il drain di un file inbox, lo
+# srotolamento dell'hard-wrap, il project status) non hanno una riga qui e non
+# devono averla: le chiavi di questo file sono i valori di `--prompt-kind`, e
+# quelle quattro non ne passano nessuno — una riga qui sarebbe irraggiungibile
+# da ogni chiamante. I loro default vivono in `src/spawn-catalog.ts`.
 #
 # `none` non compare: nessun prompt non è un template vuoto, è l'assenza della
 # voce. Chi chiede un kind fuori da questo file riceve un prompt vuoto e nessun