@lamemind/loom-deck 0.41.0 → 0.42.0

package/README.md

@@ -28,17 +28,25 @@ Il deck è **UN processo Node**: spawna ma **non contiene** le sessioni CC — l
 
 ### 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 è stato eseguito, quotato come lo si scriverebbe in bash:
+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:
 
 ```
-$ /home/tizio/.local/lib/node_modules/@lamemind/loom-deck/scripts/deck-run T115 --session-id 9f3a… --prompt-kind run --model opus --title-note 'parser'
+$ LOOM_TASK=T115 claude --name '🧵 loom-works · T115 «parser»' --permission-mode auto --model opus --session-id 9f3a… '/loom-works:run-task T115'
 ```
 
-Task, `sessionId`, prompt-kind, modello e nota del titolo sono già argomenti del comando: 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.
+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 deck non passa mai da una shell (`spawn` senza `shell:true` consegna l'argv a `execve`): il quoting esiste per la sola resa, e serve a rendere la riga ricopiabile senza cambiare di una virgola ciò che è stato eseguito.
+**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
 
-Su un terminale stretto il taglio è **al mezzo** (`…`), non dalla coda: la testa è il path assoluto di `deck-run`, identico a ogni invocazione, mentre quel che distingue una sessione dall'altra sta tutto in fondo.
+```
+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.
 

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';
@@ -17,7 +17,7 @@ import { ALL, EDIT_PRI, EDIT_PROG, MAX_SESSIONS, MAX_SESSIONS_ALL, META_ROWS, RO
 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';
@@ -283,12 +283,12 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     // (`^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`): la testa è il path assoluto
-    // di `deck-run`, identico a ogni spawn, e un taglio dalla coda mostrerebbe
-    // solo quello. 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.
+    // 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
@@ -296,6 +296,29 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         // 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
@@ -343,14 +366,14 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         appendTaskBinding(cwd, sid, id);
         if (spawnNote)
             appendNote(cwd, sid, spawnNote);
-        const { child, cmd } = spawnDeck(id, cwd, sid, kind, model, spawnNote);
-        child.on('error', () => setNote(`⚠ spawn ${id} fallito (${DECK_RUN})`));
+        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.
-        noteCommand(cmd);
+        noteSpawn(spawned);
     }
     function spawnTaskSession(kind, keyLabel) {
         const task = selectedTaskOr(keyLabel, 'spawnare');
@@ -637,9 +660,9 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     // devono restare la stessa azione.
     function resumeSession(sessionId) {
         const bound = bindings.get(sessionId) ?? null;
-        const { child, cmd } = spawnDeckResume(bound, cwd, sessionId, sessionNotes.get(sessionId));
-        child.on('error', () => setNote(`⚠ resume fallito (${DECK_RUN})`));
-        noteCommand(cmd);
+        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.
     //
@@ -1043,9 +1066,9 @@ function Deck({ cwd, tasksPath, tasksDir }) {
                         ...(bound ? { taskId: bound } : {}),
                         forkOf: s.sessionId,
                     });
-                    const { child, cmd } = spawnDeckFork(bound, cwd, s.sessionId, newId);
-                    child.on('error', () => setNote(`⚠ fork fallito (${DECK_RUN})`));
-                    noteCommand(cmd);
+                    const spawned = spawnDeckFork(bound, cwd, s.sessionId, newId);
+                    spawned.child.on('error', () => setNote(`⚠ fork fallito (${DECK_RUN})`));
+                    noteSpawn(spawned);
                 }
             }
         }
@@ -1122,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, cmd } = spawnClaudeEmpty(cwd);
-            child.on('error', () => setNote(`⚠ c → spawn claude fallito (${DECK_RUN})`));
-            noteCommand(cmd);
+            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/spawn.js

@@ -61,11 +61,62 @@ export function shellCommand(cmd, args) {
 // 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' });
+    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.

package/package.json

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