@lamemind/loom-deck 0.40.0 → 0.42.0

package/README.md

@@ -26,6 +26,30 @@ Entrambi i prefissi del contratto loom entrano in lista: **`T`** (code task) e *
 Il deck è **UN processo Node**: spawna ma **non contiene** le sessioni CC — le possiede Ptyxis. Chiudere il deck non uccide le sessioni. La tab nasce nella window *attiva*
 (quella col focus = il deck) → desktop isolation "gratis".
 
+### La riga di stato dice il comando, non una parafrasi
+
+Ogni spawn di una sessione Claude — task (`⏎`/`^K`/`^P`/`^R`), resume, fork, sessione nuda (`c`) — scrive nella riga di stato in fondo al frame il **comando esatto** che gira dentro la tab, cioè l'invocazione `claude` vera con le env che la legano a task e progetto:
+
+```
+$ LOOM_TASK=T115 claude --name '🧵 loom-works · T115 «parser»' --permission-mode auto --model opus --session-id 9f3a… '/loom-works:run-task T115'
+```
+
+Task, `sessionId`, modello, titolo e prompt iniziale sono già lì dentro: una nota che li elencasse a parole li direbbe una seconda volta, in una grafia che non si può ricopiare in un terminale. Quello che si perde è il **tasto premuto**, che è ciò che hai appena fatto tu e non ciò che il deck ha fatto per te.
+
+**Il comando non lo compone il deck**, e non potrebbe senza riscrivere le stesse regole due volte: catalogo dei prompt, quoting, permission mode, profilo di stato e titolo vivono in `deck-run`. Il primitive lo **annuncia** su stdout prima di `exec`, con una riga
+
+```
+LOOM_DECK_INTAB <comando>
+```
+
+e il deck la legge da lì. L'annuncio è utile anche a chi lancia `deck-run` a mano: dice cosa sta per partire, mentre le diagnostiche restano su stderr.
+
+Ne discende che il comando in-tab arriva **asincrono**, qualche millisecondo dopo lo spawn. Nel frattempo la riga mostra il comando `deck-run` — che resta l'unica cosa visibile quando l'annuncio non arriva affatto (argomenti rifiutati, `deck-run` morto prima dell'exec), ed è anche il comando da ripetere a mano per vedere l'errore.
+
+Su un terminale stretto il taglio è **al mezzo** (`…`), non dalla coda: in un comando di spawn è la coda a distinguere un'invocazione dall'altra, e tagliare da lì la butterebbe via per intero.
+
+Restano fuori gli spawn che non aprono una sessione Claude interattiva: terminale (`t`), voci `launch` (`1`-`9`) e le skill headless (`C` create-task, `CANC` clean-tasks), dove la riga di stato serve a riportare l'**esito** di un'operazione asincrona.
+
 ## Stato
 
 Bootstrap + spike ① + **TUI ③** funzionante (legge `tasks.md`, `⏎` apre il detail). Roadmap:

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { render, Box, Text, useInput } from 'ink';
-import { useState, useEffect, useMemo } from 'react';
+import { useState, useEffect, useMemo, useRef } from 'react';
 import { randomUUID } from 'node:crypto';
 import { resolveTasksPath, resolveTasksDir, loadTasks, loadTaskFileText, } from './tasks.js';
 import { rowIndexOfKey, selectedRow, } from './search.js';
@@ -10,14 +10,14 @@ import { assembleSessionList, firstSelectableId, moveSelection, neighborId, rowI
 import { cellWidth, launchLegend, loadArchivableDays, loadIdentity, loadLaunch, } from './config.js';
 import { cycleSessionView, cycleTaskView, selectSessionRows, selectTasks, sessionView, taskView, TASK_VIEWS, } from './pane-views.js';
 import { isCompact, layoutBudget, searchPreviewCapacity, windowRange, } from './viewport.js';
-import { cut, sanitize, termWidth } from './width.js';
+import { cut, cutMiddle, sanitize, termWidth } from './width.js';
 import { applyView, cycleSort, describeSort, priName, progName, toggleHidden, PRI_ENTRIES, PROG_ENTRIES, } from './view.js';
 import { initialDetail, writeTaskEdit, PRI_GLYPH, PRI_LABEL } from './task-edit.js';
 import { ALL, EDIT_PRI, EDIT_PROG, MAX_SESSIONS, MAX_SESSIONS_ALL, META_ROWS, ROW_ALL, ROW_SPOT, SORT_TASTI, SPOT, } from './model.js';
 import { purgeTargets, splitTargets } from './purge.js';
 import { conversationLabel, cpLen, editField, insertAt, isDone, isTextRow, removeAt, EDIT_ROWS, } from './layout.js';
 import { TASK_EMPTY, relTime, sanitizeTyped } from './glyphs.js';
-import { commitTaskEdit, runLaunch, spawnClaudeEmpty, spawnCleanTasks, spawnCreateTask, spawnDeck, spawnDeckFork, spawnDeckResume, spawnTerminal, CLAUDE_CMD, DECK_RUN, MODEL_DEFAULT, } from './spawn.js';
+import { commitTaskEdit, runLaunch, spawnClaudeEmpty, spawnCleanTasks, spawnCreateTask, spawnDeck, spawnDeckFork, spawnDeckResume, spawnTerminal, onInTabCommand, CLAUDE_CMD, DECK_RUN, MODEL_DEFAULT, } from './spawn.js';
 import { EditModal, FilterModal, PurgeModal, SortModal, idList } from './ui/modals.js';
 import { ReaderScreen, SearchScreen } from './ui/search-screen.js';
 import { DetailScreen } from './ui/detail-screen.js';
@@ -273,6 +273,52 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         });
         child.on('error', () => setNote(`⚠ create-task: '${CLAUDE_CMD}' non lanciabile`));
     }
+    // La riga di stato di OGNI spawn di sessione Claude: il comando esatto, come
+    // lo si scriverebbe in bash, invece di una parafrasi.
+    //
+    // Non è un di più sulla nota descrittiva, la sostituisce: task, sessionId,
+    // prompt-kind, modello e nota del titolo sono già tutti argomenti del comando,
+    // quindi elencarli a parole li direbbe una seconda volta in una grafia che non
+    // si può ricopiare in un terminale. Ciò che va perso è il tasto premuto
+    // (`^K`, `⏎`, `f`), che è ciò che l'utente ha appena fatto e non ciò che il
+    // deck ha fatto per lui.
+    //
+    // Il taglio è al MEZZO (`cutMiddle`, non `cut`): in un comando di spawn è la
+    // coda a distinguere un'invocazione dall'altra, e un taglio dalla coda la
+    // butterebbe via per intero. Si taglia QUI, alla composizione, e non al
+    // render: la riga di stato porta anche messaggi normali, dove è la testa a
+    // contare. Ne discende che un resize successivo non ricalcola l'elisione — la
+    // nota è transitoria e `wrap="truncate-end"` resta come rete.
+    function noteCommand(cmd) {
+        // 4 = bordo + padding della cornice esterna, 2 = il prompt `$ `. Sbagliare
+        // il budget non produce un errore visibile: la `truncate-end` di Ink taglia
+        // il resto dalla CODA, e il comando esce col mezzo eliso E la fine persa —
+        // cioè con entrambi i pezzi che l'elisione al mezzo voleva salvare.
+        setNote(`$ ${cutMiddle(cmd, Math.max(8, columns - 6))}`);
+    }
+    // Le due note di uno spawn, in quest'ordine: il comando di `deck-run` subito,
+    // e appena arriva l'annuncio quello della sessione `claude` che gira DENTRO
+    // la tab — che è ciò che si vuole vedere davvero (`deck-run` è l'involucro,
+    // l'invocazione vera la compone lui).
+    //
+    // La prima non è un ripiego di stile: è l'unica che esiste quando l'annuncio
+    // non arriva (spawn inerte nei test, argomenti rifiutati, `deck-run` morto
+    // prima dell'exec), ed è anche il comando da ripetere a mano per vedere
+    // l'errore. Il salto fra le due dura i millisecondi che `deck-run` impiega a
+    // comporre.
+    const spawnSeq = useRef(0);
+    function noteSpawn(spawned) {
+        noteCommand(spawned.cmd);
+        const mine = ++spawnSeq.current;
+        onInTabCommand(spawned.child, (inTab) => {
+            // Due spawn ravvicinati: gli annunci sono asincroni e possono tornare
+            // fuori ordine, e senza guardia il più vecchio scriverebbe sopra il più
+            // recente — la riga di stato mostrerebbe un comando che non è l'ultimo
+            // partito.
+            if (spawnSeq.current === mine)
+                noteCommand(inTab);
+        });
+    }
     // T56 — apre una sessione bound alla task selezionata. Punto UNICO dei quattro
     // tasti (⏎/^K/^P/^R): fra loro cambia solo il prompt iniziale, tutto il resto
     // è identico — uuid pinnato, binding scritto PRIMA dello spawn (la sessione
@@ -315,25 +361,24 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     // il tempo di un tick la riga in lista comparirebbe nuda. Due record separati
     // sullo stesso `sessionId` sono la forma normale di un file append-only
     // last-wins, non una scrittura da fondere.
-    function spawnForTask(id, kind, model, keyLabel, spawnNote = '') {
+    function spawnForTask(id, kind, model, spawnNote = '') {
         const sid = randomUUID();
         appendTaskBinding(cwd, sid, id);
         if (spawnNote)
             appendNote(cwd, sid, spawnNote);
-        const child = spawnDeck(id, cwd, sid, kind, model, spawnNote);
-        child.on('error', () => setNote(`⚠ spawn ${id} fallito (${DECK_RUN})`));
-        const what = kind === 'none' ? '' : ` · ${kind}`;
-        // Il modello è SEMPRE nominato, anche quando è il default: gli acceleratori
-        // della lista non passano dal selettore del detail e usano il default fisso
-        // (T108 · via a), quindi senza dirlo l'utente crederebbe di aver ereditato
-        // la scelta fatta nell'ultimo detail aperto.
-        const named = spawnNote ? ` · «${cut(spawnNote, 24)}»` : '';
-        setNote(`${keyLabel} spawn ${id}${what} · ${model}${named} → tab CC (sid ${sid.slice(0, 8)})`);
+        const spawned = spawnDeck(id, cwd, sid, kind, model, spawnNote);
+        spawned.child.on('error', () => setNote(`⚠ spawn ${id} fallito (${DECK_RUN})`));
+        // Il modello resta SEMPRE visibile anche quando è il default, perché è un
+        // argomento esplicito del comando (T108): gli acceleratori della lista non
+        // passano dal selettore del detail e usano il default fisso, quindi senza
+        // vederlo l'utente crederebbe di aver ereditato la scelta dell'ultimo
+        // detail aperto.
+        noteSpawn(spawned);
     }
     function spawnTaskSession(kind, keyLabel) {
         const task = selectedTaskOr(keyLabel, 'spawnare');
         if (task)
-            spawnForTask(task.id, kind, MODEL_DEFAULT, keyLabel);
+            spawnForTask(task.id, kind, MODEL_DEFAULT);
     }
     // T53 — apertura del modale nota sulla conversazione selezionata. Come
     // `openEdit`, la bozza parte dal valore ATTUALE: annotare una seconda volta è
@@ -615,9 +660,9 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     // devono restare la stessa azione.
     function resumeSession(sessionId) {
         const bound = bindings.get(sessionId) ?? null;
-        const child = spawnDeckResume(bound, cwd, sessionId, sessionNotes.get(sessionId));
-        child.on('error', () => setNote(`⚠ resume fallito (${DECK_RUN})`));
-        setNote(`⏎ resume ${sessionId.slice(0, 8)} → tab CC${bound ? ` (${bound})` : ' (spot)'}`);
+        const spawned = spawnDeckResume(bound, cwd, sessionId, sessionNotes.get(sessionId));
+        spawned.child.on('error', () => setNote(`⚠ resume fallito (${DECK_RUN})`));
+        noteSpawn(spawned);
     }
     // T57 — ⏎ nel modale: riscrive il binding nel sidecar e ricarica subito.
     //
@@ -655,7 +700,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         columns,
         setMode,
         setNote,
-        onAction: (id, kind, model, spawnNote, label) => spawnForTask(id, kind, model, label, spawnNote),
+        onAction: (id, kind, model, spawnNote) => spawnForTask(id, kind, model, spawnNote),
     });
     const search = useSearchOverlay({
         sessions,
@@ -1021,9 +1066,9 @@ function Deck({ cwd, tasksPath, tasksDir }) {
                         ...(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)'}`);
+                    const spawned = spawnDeckFork(bound, cwd, s.sessionId, newId);
+                    spawned.child.on('error', () => setNote(`⚠ fork fallito (${DECK_RUN})`));
+                    noteSpawn(spawned);
                 }
             }
         }
@@ -1100,9 +1145,9 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             // Minuscola = azione immediata (convenzione T39), gemella di `t`: entrambe
             // aprono una surface del cappello senza passare da un modale. `C` (create
             // task) resta distinta — stessa lettera, ma la maiuscola è per i modali.
-            const child = spawnClaudeEmpty(cwd);
-            child.on('error', () => setNote(`⚠ c → spawn claude fallito (${DECK_RUN})`));
-            setNote(`c → claude nuda su ${projectName} (nessuna task)`);
+            const spawned = spawnClaudeEmpty(cwd);
+            spawned.child.on('error', () => setNote(`⚠ c → spawn claude fallito (${DECK_RUN})`));
+            noteSpawn(spawned);
         }
         else if (input === 'w') {
             // Salvataggio ESPLICITO: comporre una vista non tocca il disco, così

package/dist/overlays/sheet.js

@@ -205,7 +205,7 @@ export function useSheetOverlay(deps) {
             const note = spawnNote.trim();
             close();
             if (id)
-                onAction(id, act.kind, model, note, `⏎ ${act.label}`);
+                onAction(id, act.kind, model, note);
         }
         else if (key.tab) {
             // T108 — `tab` scorre il catalogo dei modelli, e da T111 è il SOLO canale:

package/dist/spawn.js

@@ -32,6 +32,91 @@ export function spawnOut(cmd, args, opts) {
     fake.unref = () => fake;
     return fake;
 }
+// Caratteri che una shell POSIX passa attraverso senza interpretarli: tutto il
+// resto (spazi, apici, `$`, glob, non-ASCII) va quotato o il comando ricopiato
+// dalla riga di stato non farebbe la stessa cosa di quello eseguito.
+const SHELL_SAFE = /^[A-Za-z0-9_@%+=:,./-]+$/;
+/**
+ * Un argomento come lo si scriverebbe in bash.
+ *
+ * Apici SINGOLI, non doppi: dentro i singoli nessun carattere resta speciale,
+ * quindi non c'è da enumerare cosa sfuggire. L'unico caso da chiudere è l'apice
+ * stesso, che si esce dalla stringa (`'\''`) invece di essere escapato dentro.
+ *
+ * Il deck non passa MAI da una shell — `spawn` senza `shell:true` consegna
+ * l'argv a execve così com'è. Questo quoting esiste per la sola RESA: rende la
+ * riga ricopiabile in un terminale senza cambiare di una virgola ciò che il
+ * deck ha davvero eseguito.
+ */
+export function shellQuote(arg) {
+    if (arg === '')
+        return "''";
+    if (SHELL_SAFE.test(arg))
+        return arg;
+    return `'${arg.replace(/'/g, `'\\''`)}'`;
+}
+export function shellCommand(cmd, args) {
+    return [cmd, ...args].map(shellQuote).join(' ');
+}
+// I quattro percorsi di spawn di una sessione Claude interattiva differiscono
+// SOLO per l'argv: stesso eseguibile, stesso detached, stesso `unref`. Il corpo
+// sta qui una volta sola, così anche il comando mostrato nasce in un punto solo.
+//
+// stdout in PIPE e non `ignore`: è il canale su cui `deck-run` annuncia il
+// comando in-tab (vedi `onInTabCommand`). Il figlio resta detached — la pipe
+// serve a leggere una riga, non a possedere il processo.
+function launchDeckRun(args, cwd) {
+    const child = spawnOut(DECK_RUN, args, {
+        cwd,
+        detached: true,
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    child.unref();
+    return { child, cmd: shellCommand(DECK_RUN, args) };
+}
+/** Prefisso della riga con cui `deck-run` annuncia il comando in-tab. */
+export const INTAB_MARKER = 'LOOM_DECK_INTAB ';
+/**
+ * Il comando che gira DENTRO la tab: la sessione `claude` vera, con le env che
+ * la legano a task e progetto (`LOOM_TASK`, `PTYXIS_PROFILE`), il titolo, il
+ * permission mode e il prompt iniziale già quotato.
+ *
+ * Non si compone qui e non si può: lo compone `deck-run`, che è il primitive
+ * dove vivono catalogo dei prompt, quoting, permission mode, profilo di stato e
+ * titolo. Ricostruirlo nel deck sarebbe una seconda scrittura delle stesse
+ * regole, che diverge al primo flag aggiunto da una parte sola — quindi
+ * `deck-run` lo annuncia su stdout prima di `exec` e qui lo si legge.
+ *
+ * Arriva ASINCRONO, millisecondi dopo lo spawn: chi mostra il comando deve
+ * avere già scritto qualcosa (il comando di `deck-run`), perché l'annuncio può
+ * non arrivare affatto — spawn inerte (`LOOM_DECK_NO_SPAWN`, che non ha nemmeno
+ * uno stdout), validazione degli argomenti fallita, `deck-run` morto prima
+ * dell'exec.
+ *
+ * Dopo la riga attesa lo stdout si drena e basta: da lì in poi appartiene a
+ * `ptyxis`, che ha preso il posto del processo.
+ */
+export function onInTabCommand(child, cb) {
+    if (!child.stdout)
+        return;
+    let buf = '';
+    let seen = false;
+    child.stdout.on('data', (chunk) => {
+        if (seen)
+            return;
+        buf += chunk.toString();
+        let nl;
+        while ((nl = buf.indexOf('\n')) >= 0) {
+            const line = buf.slice(0, nl);
+            buf = buf.slice(nl + 1);
+            if (line.startsWith(INTAB_MARKER)) {
+                seen = true;
+                cb(line.slice(INTAB_MARKER.length));
+                return;
+            }
+        }
+    });
+}
 // L'ordine È il giro di `tab` nel detail, non una preferenza di lettura:
 // cambiarlo sposta le voci sotto le dita di chi le ha imparate. Fino a T111 era
 // anche il binding delle cifre `1`-`4`, passate poi al campo nota.
@@ -79,13 +164,7 @@ export function deckArgs(id, sessionId, kind, model = MODEL_DEFAULT, spawnNote)
     return args;
 }
 export function spawnDeck(id, cwd, sessionId, kind, model = MODEL_DEFAULT, spawnNote) {
-    const child = spawnOut(DECK_RUN, deckArgs(id, sessionId, kind, model, spawnNote), {
-        cwd,
-        detached: true,
-        stdio: 'ignore',
-    });
-    child.unref();
-    return child;
+    return launchDeckRun(deckArgs(id, sessionId, kind, model, spawnNote), cwd);
 }
 // T49 — resume di una sessione esistente come nuova tab Ptyxis. Scoped (taskId
 // presente) → `deck-run <task> --resume <sid>`: la ripresa eredita LOOM_TASK +
@@ -109,13 +188,7 @@ export function resumeArgs(taskId, sessionId, note) {
     return args;
 }
 export function spawnDeckResume(taskId, cwd, sessionId, note) {
-    const child = spawnOut(DECK_RUN, resumeArgs(taskId, sessionId, note), {
-        cwd,
-        detached: true,
-        stdio: 'ignore',
-    });
-    child.unref();
-    return child;
+    return launchDeckRun(resumeArgs(taskId, sessionId, note), cwd);
 }
 // 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
@@ -140,13 +213,7 @@ export function forkArgs(taskId, originId, newId) {
     ];
 }
 export function spawnDeckFork(taskId, cwd, originId, newId) {
-    const child = spawnOut(DECK_RUN, forkArgs(taskId, originId, newId), {
-        cwd,
-        detached: true,
-        stdio: 'ignore',
-    });
-    child.unref();
-    return child;
+    return launchDeckRun(forkArgs(taskId, originId, newId), cwd);
 }
 // T42 — sessione Claude NUDA: nessuna task, nessun prompt iniziale, nessun
 // sessionId pinnato (quindi nessuna entry nel sidecar session-tasks.jsonl: senza
@@ -155,13 +222,7 @@ export function spawnDeckFork(taskId, cwd, originId, newId) {
 // sporcherebbe il percorso bound. Il titolo tab resta la label loom — lo mette
 // deck-run, perché il match compass è window-level e non sa nulla di task.
 export function spawnClaudeEmpty(cwd) {
-    const child = spawnOut(DECK_RUN, ['--no-task'], {
-        cwd,
-        detached: true,
-        stdio: 'ignore',
-    });
-    child.unref();
-    return child;
+    return launchDeckRun(['--no-task'], cwd);
 }
 // T39/T32: voce `launch` custom del file config, eseguita con cwd = project root.
 // Spawn detached come spawnDeck: il deck lancia ma non possiede il processo.

package/dist/width.js

@@ -328,6 +328,56 @@ export function pad(s, cols, align = 'left') {
     const fill = ' '.repeat(Math.max(0, cols - termWidth(t)));
     return align === 'right' ? fill + t : t + fill;
 }
+/**
+ * Taglio a un budget di COLONNE che sacrifica il MEZZO invece della coda.
+ *
+ * Serve dove la testa e la coda portano informazione diversa e la TESTA è quella
+ * costante: il comando di uno spawn è sempre lo stesso path assoluto di
+ * `deck-run`, e quel che cambia da un'invocazione all'altra (task, sessionId,
+ * prompt-kind, modello, nota) sta tutto in fondo. Un `cut()` su quella riga
+ * mostrerebbe l'unica parte che non cambia mai.
+ *
+ * La coda prende due terzi del budget e la testa il resto: basta a riconoscere
+ * l'eseguibile senza mangiare gli argomenti. Testa e coda non possono
+ * sovrapporsi — insieme occupano al più `cols - 1` colonne, cioè meno della
+ * stringa intera (che qui è già più larga del budget).
+ *
+ * Niente collasso del whitespace (a differenza di `cut`): la stringa in ingresso
+ * è un comando, e due spazi dentro un argomento quotato sono suoi. Restano
+ * appiattiti i soli a-capo, che sfonderebbero la riga singola.
+ */
+export function cutMiddle(s, cols) {
+    const flat = s.replace(/[\r\n\t]+/g, ' ');
+    if (cols <= 0)
+        return '';
+    if (termWidth(flat) <= cols)
+        return flat;
+    if (cols === 1)
+        return '…';
+    const budget = cols - 1; // -1 = la colonna dell'ellissi, che qui c'è di sicuro
+    const headCols = budget - Math.ceil((budget * 2) / 3);
+    let head = '';
+    let hw = 0;
+    for (const ch of flat) {
+        const cw = termWidth(ch);
+        if (hw + cw > headCols)
+            break;
+        head += ch;
+        hw += cw;
+    }
+    const chars = [...flat];
+    let tail = '';
+    let tw = 0;
+    for (let i = chars.length - 1; i >= 0; i--) {
+        const ch = chars[i];
+        const cw = termWidth(ch);
+        if (hw + tw + cw > budget)
+            break;
+        tail = ch + tail;
+        tw += cw;
+    }
+    return head + '…' + tail;
+}
 /**
  * Larghezza in colonne di UN carattere **dopo** `sanitize`.
  *

package/package.json

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

@@ -29,6 +29,12 @@
 # riprende RAMANDOLA (`--fork-session`): id nuovo, transcript copiato, l'origine
 # resta intatta e scrivibile.
 #
+# Su stdout, prima di aprire la tab, stampa una riga
+#   LOOM_DECK_INTAB <comando>
+# col comando che girerà DENTRO la tab (la sessione `claude` con le sue env).
+# Serve a chi spawna deck-run e vuole mostrare l'invocazione vera senza
+# ricomporla per conto proprio; le diagnostiche restano tutte su stderr.
+#
 # 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
@@ -440,6 +446,24 @@ else
 fi
 IN_TAB_CMD="${LOOM_DECK_INTAB_CMD:-$_default_intab}"
 
+# ANNUNCIO del comando in-tab, su stdout, prima dell'exec.
+#
+# È l'unico modo che ha un chiamante di sapere cosa gira davvero dentro la tab:
+# il comando si compone QUI — catalogo dei prompt, quoting, permission mode,
+# profilo di stato, titolo — e ricomporlo dall'altro lato sarebbe una seconda
+# scrittura delle stesse regole, divergente al primo flag aggiunto. Il deck lo
+# legge da questa riga e la mostra nella propria riga di stato.
+#
+# Deve stare DOPO l'ultima assegnazione di IN_TAB_CMD e PRIMA dell'exec (che
+# sostituisce il processo): annunciare un valore ancora modificabile
+# annuncerebbe qualcosa di diverso da quello eseguito.
+#
+# stdout e non stderr: qui non c'è nessuna anomalia da segnalare, è l'esito
+# normale del lavoro dello script. Le diagnostiche restano su stderr, e i
+# chiamanti che leggono l'ULTIMA riga di stdout (lo shim `ptyxis` dei test)
+# vedono comunque quello che vedevano prima.
+printf 'LOOM_DECK_INTAB %s\n' "$IN_TAB_CMD"
+
 case "$MODE" in
   inline)
     # --tab: tab nella window attiva. -- <cmd>: comando inline nella tab.