@lamemind/loom-deck 0.26.0 → 0.27.1

package/dist/cli.js

@@ -157,8 +157,19 @@ function spawnDeck(id, cwd, sessionId, kind) {
 // task). Spot → `--no-task --resume`: resume nudo, solo label progetto. Nessun
 // prompt iniziale in entrambi i casi: riprendere una conversazione significa
 // continuarla, non iniettarle un messaggio (lo salta deck-run).
-function spawnDeckResume(taskId, cwd, sessionId) {
+//
+// T64 — la NOTA della conversazione (se c'è) viaggia nel titolo della tab. Più
+// sessioni sulla stessa task hanno oggi titoli identici (`label · T81`): la nota
+// è già ciò con cui l'utente le distingue in lista, quindi è anche ciò che
+// distingue le tab. La passa il DECK e non la legge deck-run perché la nota vive
+// nel sidecar `session-tasks.jsonl`, che deck-run non tocca (legge solo
+// `.claude/loom-works.json`): tenerlo così evita di dare al primitive un secondo
+// file da conoscere. Il titolo si congela qui — `claude --name` lo setta una
+// volta sola, quindi una nota cambiata DOPO non ri-titola la tab già aperta.
+function spawnDeckResume(taskId, cwd, sessionId, note) {
     const args = taskId ? [taskId, '--resume', sessionId] : ['--no-task', '--resume', sessionId];
+    if (note)
+        args.push('--title-note', note);
     const child = spawnOut(DECK_RUN, args, { cwd, detached: true, stdio: 'ignore' });
     child.unref();
     return child;
@@ -171,6 +182,10 @@ function spawnDeckResume(taskId, cwd, sessionId) {
 // conoscerlo prima che la sessione esista, e senza conoscerlo non si possono
 // scrivere né il binding task né il record di lineage (il transcript del fork
 // non nomina da nessuna parte la sessione d'origine).
+// Nessun `--title-note` (T64): il ramo nasce con un sessionId proprio e SENZA
+// nota nel sidecar — ereditare quella dell'origine metterebbe nel titolo una
+// maniglia che nella lista non compare, cioè una promessa falsa. Il fork si
+// distingue col suo marcatore, `· fork`.
 function spawnDeckFork(taskId, cwd, originId, newId) {
     const args = [
         ...(taskId ? [taskId] : ['--no-task']),
@@ -665,7 +680,11 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         for (const r of sessionRows) {
             if (r.kind === 'separator')
                 continue;
-            if (isAll) {
+            // La colonna serve dove l'appartenenza NON è già scritta altrove sullo
+            // schermo: nella vista "tutte" (ogni riga ha un binding proprio) e su
+            // OGNI riga pinnata, in qualunque vista — una pinnata è sganciata dal
+            // parent selezionato, quindi l'header del pane non parla per lei.
+            if (isAll || r.kind === 'pinned') {
                 const b = bindings.get(r.sessionId);
                 if (b)
                     task = Math.max(task, termWidth(b));
@@ -1016,7 +1035,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
         }
         if (row.kind === 'session') {
             const bound = bindings.get(row.session.sessionId) ?? null;
-            const child = spawnDeckResume(bound, cwd, row.session.sessionId);
+            const child = spawnDeckResume(bound, cwd, row.session.sessionId, sessionNotes.get(row.session.sessionId));
             child.on('error', () => setNote(`⚠ resume fallito (${DECK_RUN})`));
             setNote(`⏎ resume ${row.session.sessionId.slice(0, 8)} → tab CC${bound ? ` (${bound})` : ' (spot)'}`);
             return;
@@ -1466,7 +1485,7 @@ function Deck({ cwd, tasksPath, tasksDir }) {
                 }
                 else {
                     const bound = bindings.get(s.sessionId) ?? null;
-                    const child = spawnDeckResume(bound, cwd, s.sessionId);
+                    const child = spawnDeckResume(bound, cwd, s.sessionId, sessionNotes.get(s.sessionId));
                     child.on('error', () => setNote(`⚠ resume fallito (${DECK_RUN})`));
                     setNote(`⏎ resume ${s.sessionId.slice(0, 8)} → tab CC${bound ? ` (${bound})` : ' (spot)'}`);
                 }
@@ -2044,8 +2063,17 @@ function SessionsPane({ parentLabel, isSpot, isAll, bindings, taskW, ageW, rows,
                     // riga oltre il bordo, e a ripararla arrivava `cli-truncate` (che
                     // sfora di una colonna per emoji e mangia il bordo stesso).
                     const staleNote = sessionNotes.get(row.sessionId);
-                    const staleW = Math.max(0, paneTextWidth(columns) - (2 /* caret */ + termWidth(`${WARN} pin stale `) + SID_CHARS + 3 /* spazio + caporali */));
-                    return (_jsxs(Text, { inverse: sel && focused, bold: sel && !focused, dimColor: true, wrap: "truncate-end", children: [sel ? CARET : CARET_OFF, _jsx(Text, { color: "yellow", children: WARN }), " pin stale", ' ', _jsx(Text, { dimColor: true, children: row.sessionId.slice(0, SID_CHARS) }), staleNote ? _jsxs(Text, { color: "yellow", children: [" \u00AB", cut(staleNote, staleW), "\u00BB"] }) : null] }, row.sessionId));
+                    // La riga stale è libera (niente colonne: non ha né titolo né
+                    // data), ma il binding va detto lo stesso — è una pinnata, quindi
+                    // l'header del pane non ne dice l'appartenenza.
+                    const staleTask = bindings.get(row.sessionId) ?? null;
+                    const staleW = Math.max(0, paneTextWidth(columns) -
+                        (2 /* caret */ +
+                            termWidth(`${WARN} pin stale `) +
+                            SID_CHARS +
+                            (staleTask ? termWidth(staleTask) + 1 : 0) +
+                            3 /* spazio + caporali */));
+                    return (_jsxs(Text, { inverse: sel && focused, bold: sel && !focused, dimColor: true, wrap: "truncate-end", children: [sel ? CARET : CARET_OFF, _jsx(Text, { color: "yellow", children: WARN }), " pin stale", ' ', _jsx(Text, { dimColor: true, children: row.sessionId.slice(0, SID_CHARS) }), staleTask ? _jsxs(Text, { color: "green", children: [" ", staleTask] }) : null, staleNote ? _jsxs(Text, { color: "yellow", children: [" \u00AB", cut(staleNote, staleW), "\u00BB"] }) : null] }, row.sessionId));
                 }
                 const s = row.session; // non-stale → session presente
                 const isPinnedRow = row.kind === 'pinned';
@@ -2061,6 +2089,13 @@ function SessionsPane({ parentLabel, isSpot, isAll, bindings, taskW, ageW, rows,
                 // task accanto, che esiste solo in questa vista.
                 const bound = bindings.get(s.sessionId) ?? null;
                 const linked = isAll ? Boolean(bound) : !isSpot;
+                // Stesso motivo per cui la colonna esiste: una pinnata resta in lista
+                // qualunque sia il parent selezionato, quindi l'header non ne dice
+                // l'appartenenza e la cella va riempita anche fuori dalla vista
+                // "tutte". Sulle contestuali, dove l'header parla già, resta vuota —
+                // ma la cella è comunque larga `taskW`, o le colonne a destra
+                // slitterebbero riga per riga.
+                const taskCell = isAll || isPinnedRow ? (bound ?? TASK_EMPTY) : '';
                 // T60 — colonne VERE: ogni cella fissa è larga esattamente quanto
                 // dichiara, riempita di spazi con `pad` (che misura in colonne, non in
                 // caratteri). Il marker va portato a 2 anche quando è `○`, largo 1:
@@ -2094,7 +2129,7 @@ function SessionsPane({ parentLabel, isSpot, isAll, bindings, taskW, ageW, rows,
                 const used = (label.note ? termWidth(label.note) + 2 : 0) +
                     (label.note && label.rest ? 1 : 0) +
                     termWidth(label.rest);
-                return (_jsxs(Text, { inverse: sel && focused, bold: sel && !focused, wrap: "truncate-end", children: [sel ? CARET : CARET_OFF, isPinnedRow ? (_jsx(Text, { color: "yellow", children: pad('📌', 2) })) : linked ? (_jsx(Text, { color: "green", children: pad('🔗', 2) })) : (_jsx(Text, { dimColor: true, children: pad('○', 2) })), ' ', _jsx(Text, { color: "cyan", children: s.sessionId.slice(0, SID_CHARS) }), ' ', taskW > 0 ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: bound ? 'green' : undefined, dimColor: !bound, children: pad(bound ?? TASK_EMPTY, taskW) }), ' '] })) : null, forkMark ? _jsx(Text, { color: "magenta", children: forkMark }) : null, label.note ? (_jsxs(Text, { color: "yellow", bold: true, children: ["\u00AB", label.note, "\u00BB"] })) : null, label.note && label.rest ? ' ' : null, label.rest ? _jsx(Text, { dimColor: Boolean(label.note), children: label.rest }) : null, ' '.repeat(Math.max(0, inner - used)), ' ', _jsx(Text, { dimColor: true, children: pad(age, ageW, 'right') })] }, s.sessionId));
+                return (_jsxs(Text, { inverse: sel && focused, bold: sel && !focused, wrap: "truncate-end", children: [sel ? CARET : CARET_OFF, isPinnedRow ? (_jsx(Text, { color: "yellow", children: pad('📌', 2) })) : linked ? (_jsx(Text, { color: "green", children: pad('🔗', 2) })) : (_jsx(Text, { dimColor: true, children: pad('○', 2) })), ' ', _jsx(Text, { color: "cyan", children: s.sessionId.slice(0, SID_CHARS) }), ' ', taskW > 0 ? (_jsxs(_Fragment, { children: [_jsx(Text, { color: bound && taskCell ? 'green' : undefined, dimColor: !bound, children: pad(taskCell, taskW) }), ' '] })) : null, forkMark ? _jsx(Text, { color: "magenta", children: forkMark }) : null, label.note ? (_jsxs(Text, { color: "yellow", bold: true, children: ["\u00AB", label.note, "\u00BB"] })) : null, label.note && label.rest ? ' ' : null, label.rest ? _jsx(Text, { dimColor: Boolean(label.note), children: label.rest }) : null, ' '.repeat(Math.max(0, inner - used)), ' ', _jsx(Text, { dimColor: true, children: pad(age, ageW, 'right') })] }, s.sessionId));
             })), detail ? (_jsx(SessionDetailPane, { s: detail, firstLines: firstLines, lastLines: lastLines, columns: columns, origin: forkOf.get(detail.sessionId) ?? null, note: sessionNotes.get(detail.sessionId) ?? '' })) : null] }));
 }
 // T49 — detail pane della sessione selezionata (hover), gemello del DetailPane

package/package.json

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

@@ -49,6 +49,7 @@ SESSION_ID=""
 RESUME_ID=""
 NO_TASK=0
 FORK=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
 # (nessun prompt, come sempre) e il secondo è un errore d'uso.
@@ -76,8 +77,17 @@ PROMPT_KIND=""
 # dentro apici singoli in `bash -lc`, quindi il testo va tenuto in un posto solo
 # e verificato una volta, invece di spostare il rischio di quoting su ogni
 # chiamante. Assente → `recap`, così ogni invocazione preesistente è invariata.
+# --title-note <testo> (T64): appende la nota della conversazione al titolo della
+# tab. È l'UNICO ingresso di testo libero nel titolo — gli altri componenti
+# (emoji/name dal file committato, TaskID) sono controllati — quindi il testo non
+# si quota, si RIDUCE a un alfabeto sicuro (vedi _sane_note): tutto ciò che non
+# ci rientra sparisce, apici inclusi.
 while [[ $# -gt 0 ]]; do
   case "$1" in
+    --title-note)
+      TITLE_NOTE="${2:-}"; shift 2 ;;
+    --title-note=*)
+      TITLE_NOTE="${1#*=}"; shift ;;
     --prompt-kind)
       PROMPT_KIND="${2:-}"; shift 2 ;;
     --prompt-kind=*)
@@ -112,7 +122,10 @@ USAGE="uso: deck-run <TaskID> [--prompt-kind <kind>] [--session-id <uuid>]
        none        nessun prompt — sessione aperta sulla task, a mani nude
        recap       recap stato task <TaskID>
        preflight   /loom-works:preflight-task <TaskID>
-       run         /loom-works:run-task <TaskID>  (run-doc sulle task D)"
+       run         /loom-works:run-task <TaskID>  (run-doc sulle task D)
+
+  --title-note   nota della conversazione, appesa al titolo tab come «nota»
+                 (ridotta a lettere/cifre/spazi/-/_, cap 60 char)"
 
 if [[ $NO_TASK -eq 1 && -n "$TASK" ]]; then
   echo "--no-task e <TaskID> sono mutuamente esclusivi" >&2
@@ -167,6 +180,29 @@ WORKDIR="${LOOM_DECK_WORKDIR:-$PWD}"
 # suffisso "· <task>" per restare distinguibili fra più tab claude (il suffisso
 # non rompe il match: è .includes, non equals — stesso pattern del "· deck").
 # Fallback su "cc <task>" se manca il file o jq (progetto non loom-registered).
+
+# Riduzione della nota a un alfabeto sicuro (T64). Whitelist, non blacklist: il
+# 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; tutto il resto (apici, backslash,
+# `$`, backtick, `;`, emoji…) cade.
+# Il cap a 60 CHARACTER è largo di proposito: una tab che sfora tronca a destra
+# da sola, quindi il limite serve solo a non spingere fuori vista la parte del
+# titolo che compass matcha, non a far stare la nota nella tab.
+_sane_note() {  # <raw> → nota ridotta, spazi collassati, cap 60 char
+  # LC_ALL locale alla funzione: serve a bash per tagliare a 60 CARATTERI e non
+  # a 60 byte (a byte, un cap che cade a metà di una `à` lascia UTF-8 rotto nel
+  # titolo). L'assegnazione rifà setlocale, l'uscita dalla funzione lo ripristina.
+  local LC_ALL=C.UTF-8
+  local s
+  s="$(printf '%s' "$1" \
+       | sed 's/[^A-Za-z0-9 _àèéìòùÀÈÉÌÒÙ-]//g' \
+       | tr -s ' ')"
+  s="${s# }"; s="${s% }"
+  printf '%s' "${s:0:60}"
+}
+
 _find_project_root() {  # <start-dir> → dir con .claude/loom-works.json, o vuoto
   local d="${1%/}"
   while [[ -n "$d" && "$d" != "/" ]]; do
@@ -198,6 +234,18 @@ if [[ -n "$_cfg" ]]; then
     if [[ $NO_TASK -eq 1 ]]; then TITLE="${_label}"; else TITLE="${_label} · ${TASK}"; fi
   fi
 fi
+# Suffisso nota (T64): distingue fra loro le tab di più conversazioni sulla
+# STESSA task, che altrimenti condividono un titolo identico (`label · T81`) —
+# la nota è già la maniglia con cui l'utente le distingue in lista, e le stesse
+# `«…»` della lista la rendono riconoscibile a colpo d'occhio anche nella tab
+# bar. In coda per la solita ragione degli altri suffissi: il match compass è
+# `.includes(label)`, la label deve restare intatta in TESTA.
+# Nota ridotta a vuoto (era tutta emoji/punteggiatura) → nessun suffisso, non
+# `«»` a vuoto.
+if [[ -n "$TITLE_NOTE" ]]; then
+  _note="$(_sane_note "$TITLE_NOTE")"
+  [[ -n "$_note" ]] && TITLE="${TITLE} «${_note}»"
+fi
 # Suffisso fork (T28): un ramo eredita task e label dell'origine, quindi senza
 # marcatore le due tab risulterebbero omonime nella stessa window. Suffisso e
 # non prefisso perché il match compass è `.includes(label)` e la label deve