@lamemind/loom-deck 0.66.1 → 0.68.0

package/scripts/deck-run

@@ -56,6 +56,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)
@@ -269,16 +272,25 @@ WORKDIR="${LOOM_DECK_WORKDIR:-$PWD}"
 # titolo finisce dentro apici singoli in `bash -lc "claude --name '…'"`, e la
 # nota è testo digitato a mano — enumerare i caratteri pericolosi significa
 # sbagliarne uno, enumerare quelli ammessi no. Restano lettere, cifre, accentate
-# italiane, spazio, trattino, underscore e quattro emoji (sotto); tutto il resto
+# italiane, spazio, trattino, underscore e sei emoji (sotto); tutto il resto
 # (apici, backslash, `$`, backtick, `;`, quadre, ogni altra emoji…) cade.
 #
-# T156 — le quattro 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.
+# 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
@@ -305,7 +317,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}"
@@ -382,7 +394,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

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