@lamemind/loom-deck 0.8.0 → 0.9.0

package/README.md

@@ -59,13 +59,25 @@ Assegnazioni correnti:
 | | Tasto | Cosa fa |
 |---|---|---|
 | modale | `C` | nuova task (create-task inline) |
+| modale | `E` | edit priorità/stato della task selezionata (salva + commit) |
 | modale | `S` | sort chain |
 | modale | `F` | filtri |
+| immediata | `t` | terminale @project-root (surface standard launch) |
+| immediata | `c` | sessione Claude **nuda**: nessuna task, nessun prompt iniziale |
 | immediata | `w` | salva la vista corrente su disco |
 | launch | `1`…`9` | esegue il `command` della voce, con `cwd` = project root |
 
-Le minuscole sono deliberatamente quasi tutte libere: le consumeranno le azioni
-in arrivo (start/preflight/checkpoint, fork/resume, terminale @project-root).
+Le voci `launch` sono elencate in una **riga di legenda** sotto il footer
+(`launch 1 📝 codium · 2 ☕ idea`): l'indice da solo è opaco, perché le voci sono
+custom per-progetto e non hanno una lettera fissa per app. Se non entrano in
+larghezza, la legenda si ferma a voci intere e mostra il contatore di quelle
+fuori riga — mai un troncamento silenzioso. Il cap a `9` è imposto dai tasti-cifra,
+non dallo schema: un progetto può dichiarare più di 9 voci, quelle oltre la nona
+sono configurate ma non raggiungibili (e la legenda lo dice).
+
+`t` e `c` sono gemelle: entrambe aprono una surface del cappello nella stessa
+finestra Ptyxis, senza passare da un modale. `c` (minuscola, azione) e `C`
+(maiuscola, modale create-task) restano distinte per la regola sopra.
 
 > **Nota di migrazione (0.6.0)**: `c` → **`C`** per creare una task, e le voci
 > `codium`/`idea` non hanno più una lettera dedicata (erano `C`/`I` hardcoded):

package/dist/cli.js

@@ -10,7 +10,7 @@ import { dirname, join } from 'node:path';
 import { resolveTasksPath, resolveTasksDir, loadTasks, loadTaskDetail, } from './tasks.js';
 import { discoverProjectSessions } from './sessions.js';
 import { appendTaskBinding, loadTaskBindings } from './task-index.js';
-import { loadIdentity, loadLaunch } from './config.js';
+import { launchLegend, loadIdentity, loadLaunch } from './config.js';
 import { applyView, cycleSort, describeSort, priName, progName, toggleHidden, PRI_ENTRIES, PROG_ENTRIES, } from './view.js';
 import { initialDetail, progressText, writeTaskEdit, PRI_GLYPH, PRI_LABEL, PROG_GLYPH, } from './task-edit.js';
 import { loadView, saveView, viewFilePath } from './view-store.js';
@@ -50,6 +50,21 @@ function spawnDeck(id, cwd, sessionId) {
     child.unref();
     return child;
 }
+// T42 — sessione Claude NUDA: nessuna task, nessun prompt iniziale, nessun
+// sessionId pinnato (quindi nessuna entry nel sidecar session-tasks.jsonl: senza
+// task non c'è nulla da legare). Funzione separata e non un parametro opzionale
+// di spawnDeck: i tre argomenti mancano tutti insieme, un `if` per ciascuno
+// 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.
+function spawnClaudeEmpty(cwd) {
+    const child = spawn(DECK_RUN, ['--no-task'], {
+        cwd,
+        detached: true,
+        stdio: 'ignore',
+    });
+    child.unref();
+    return child;
+}
 // 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.
 // Shell login+interattiva (bash -lic) perché i comandi tipici sono alias o
@@ -628,6 +643,14 @@ function Deck({ cwd, tasksPath, tasksDir }) {
             child.on('error', () => setNote('⚠ t → ptyxis non lanciabile'));
             setNote(`t → terminale su ${projectName}`);
         }
+        else if (input === 'c') {
+            // 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)`);
+        }
         else if (input === 'w') {
             // Salvataggio ESPLICITO: comporre una vista non tocca il disco, così
             // sperimentare non sporca lo stato persistito.
@@ -657,8 +680,10 @@ function Deck({ cwd, tasksPath, tasksDir }) {
     const selSessionId = visibleSessions[selSession]?.sessionId;
     const parentLabel = isSpot ? 'spot' : selectedTaskId ?? '—';
     const canSpawn = focus === 'tasks' && !isSpot;
-    const launchHint = launch.length > 0 ? `1-${Math.min(9, launch.length)} launch · ` : '';
-    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "loom-deck" }), mode === 'create' ? (_jsxs(Text, { dimColor: true, children: ["nuova task \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " crea \u00B7 ", _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'sort' ? (_jsxs(Text, { dimColor: true, children: ["sort \u00B7 ", _jsx(Text, { color: "yellow", children: "p" }), " pri ", _jsx(Text, { color: "yellow", children: "s" }), " stato", ' ', _jsx(Text, { color: "yellow", children: "i" }), " id (asc\u2192desc\u2192off) \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " ok \u00B7", ' ', _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'filter' ? (_jsxs(Text, { dimColor: true, children: ["filtri \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2191\u2193\u2190\u2192" }), " naviga \u00B7 ", _jsx(Text, { color: "yellow", children: "spazio" }), ' ', "mostra/nascondi \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " ok \u00B7 ", _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'edit' ? (_jsxs(Text, { dimColor: true, children: ["edit \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2191\u2193" }), " campo \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2190\u2192" }), " valore \u00B7", ' ', _jsx(Text, { color: "yellow", children: "\u23CE" }), " salva+commit \u00B7 ", _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : (_jsxs(Text, { dimColor: true, children: ["\u2191\u2193 naviga \u00B7 \u2190\u2192 pane \u00B7 \u23CE ", canSpawn ? 'spawn' : '—', " \u00B7 C nuova \u00B7 E edit \u00B7 S sort \u00B7 F filtri \u00B7 w salva \u00B7 t term \u00B7 ", launchHint, "q esci \u00B7 focus: ", _jsx(Text, { color: "cyan", children: focus })] })), mode === 'create' ? (_jsxs(Box, { borderStyle: "round", borderColor: "yellow", paddingX: 1, marginTop: 1, children: [_jsx(Text, { color: "yellow", children: "C \u203A " }), _jsx(Text, { children: draft }), _jsx(Text, { inverse: true, children: " " })] })) : null, mode === 'sort' ? _jsx(SortModal, { sort: view.sort }) : null, mode === 'filter' ? _jsx(FilterModal, { view: view, cursor: filterCursor }) : null, mode === 'edit' && edit && selTask ? (_jsx(EditModal, { id: selTask.id, draft: edit, row: editRow })) : null, _jsxs(Box, { flexDirection: "row", marginTop: 1, children: [_jsx(TasksPane, { tasks: viewTasks, total: tasks.length, hidden: hiddenTasks, view: view, selected: selIndex, spotCount: spotCount, childCount: childCount, focused: focus === 'tasks', loadError: loadError, detail: detail }), _jsx(SessionsPane, { parentLabel: parentLabel, isSpot: isSpot, sessions: visibleSessions, total: childSessions.length, hidden: hiddenSessions, selectedId: selSessionId, focused: focus === 'sessions' })] }), note ? _jsx(Text, { color: "green", children: note }) : null] }));
+    // Larghezza letta a ogni render (non memoizzata): dopo un resize il primo
+    // re-render utile ricalcola la legenda senza bisogno di un listener dedicato.
+    const legend = launchLegend(launch, process.stdout.columns || 80);
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "loom-deck" }), mode === 'create' ? (_jsxs(Text, { dimColor: true, children: ["nuova task \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " crea \u00B7 ", _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'sort' ? (_jsxs(Text, { dimColor: true, children: ["sort \u00B7 ", _jsx(Text, { color: "yellow", children: "p" }), " pri ", _jsx(Text, { color: "yellow", children: "s" }), " stato", ' ', _jsx(Text, { color: "yellow", children: "i" }), " id (asc\u2192desc\u2192off) \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " ok \u00B7", ' ', _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'filter' ? (_jsxs(Text, { dimColor: true, children: ["filtri \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2191\u2193\u2190\u2192" }), " naviga \u00B7 ", _jsx(Text, { color: "yellow", children: "spazio" }), ' ', "mostra/nascondi \u00B7 ", _jsx(Text, { color: "yellow", children: "\u23CE" }), " ok \u00B7 ", _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : mode === 'edit' ? (_jsxs(Text, { dimColor: true, children: ["edit \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2191\u2193" }), " campo \u00B7 ", _jsx(Text, { color: "yellow", children: "\u2190\u2192" }), " valore \u00B7", ' ', _jsx(Text, { color: "yellow", children: "\u23CE" }), " salva+commit \u00B7 ", _jsx(Text, { color: "yellow", children: "esc" }), " annulla"] })) : (_jsxs(Text, { dimColor: true, children: ["\u2191\u2193 naviga \u00B7 \u2190\u2192 pane \u00B7 \u23CE ", canSpawn ? 'spawn' : '—', " \u00B7 C nuova \u00B7 E edit \u00B7 S sort \u00B7 F filtri \u00B7 w salva \u00B7 t term \u00B7 c claude \u00B7 q esci \u00B7 focus: ", _jsx(Text, { color: "cyan", children: focus })] })), mode === 'normal' && launch.length > 0 ? (_jsxs(Text, { dimColor: true, children: ["launch ", legend.shown, legend.overflow > 0 ? (_jsxs(Text, { color: "yellow", children: [" \u00B7 +", legend.overflow, " fuori riga"] })) : null, legend.unreachable > 0 ? (_jsxs(Text, { color: "yellow", children: [" \u00B7 ", legend.unreachable, " oltre la 9\u00AA (non raggiungibili)"] })) : null] })) : null, mode === 'create' ? (_jsxs(Box, { borderStyle: "round", borderColor: "yellow", paddingX: 1, marginTop: 1, children: [_jsx(Text, { color: "yellow", children: "C \u203A " }), _jsx(Text, { children: draft }), _jsx(Text, { inverse: true, children: " " })] })) : null, mode === 'sort' ? _jsx(SortModal, { sort: view.sort }) : null, mode === 'filter' ? _jsx(FilterModal, { view: view, cursor: filterCursor }) : null, mode === 'edit' && edit && selTask ? (_jsx(EditModal, { id: selTask.id, draft: edit, row: editRow })) : null, _jsxs(Box, { flexDirection: "row", marginTop: 1, children: [_jsx(TasksPane, { tasks: viewTasks, total: tasks.length, hidden: hiddenTasks, view: view, selected: selIndex, spotCount: spotCount, childCount: childCount, focused: focus === 'tasks', loadError: loadError, detail: detail }), _jsx(SessionsPane, { parentLabel: parentLabel, isSpot: isSpot, sessions: visibleSessions, total: childSessions.length, hidden: hiddenSessions, selectedId: selSessionId, focused: focus === 'sessions' })] }), note ? _jsx(Text, { color: "green", children: note }) : null] }));
 }
 const SORT_UI = { pri: 'pri', prog: 'stato', id: 'id' };
 // Modali resi IN FLUSSO (come l'input box di create), non in overlay assoluto:

package/dist/config.js

@@ -39,6 +39,57 @@ export function loadLaunch(projectRoot) {
         return [];
     }
 }
+// T43 — le voci launch si raggiungono con le CIFRE `1`..`9`: il cap non viene
+// dallo schema config (che ne ammette quante se ne vogliono) ma dai tasti
+// disponibili. Le voci oltre la nona restano configurate e non raggiungibili.
+export const LAUNCH_MAX = 9;
+// Larghezza in celle terminale, approssimata: emoji astrali (U+1F000+) e simboli
+// BMP portati a presentazione emoji occupano 2 colonne, il VS16 è un modificatore
+// a larghezza 0, tutto il resto 1. Serve solo a decidere quante voci stanno in
+// riga — non deve essere esatta, deve non SOTTOstimare (sottostimare manderebbe
+// la riga a capo, che è il difetto da evitare).
+export function cellWidth(s) {
+    let w = 0;
+    for (const ch of s) {
+        const cp = ch.codePointAt(0);
+        if (cp === 0xfe0f)
+            continue;
+        w += cp >= 0x1f000 || (cp >= 0x2190 && cp <= 0x2bff) ? 2 : 1;
+    }
+    return w;
+}
+// T43 — legenda `indice → voce`. L'indice da solo è opaco (le launch sono voci
+// custom per-progetto, non hanno una lettera fissa per app), quindi la resa deve
+// esporre la mappa, non il conteggio. Degradazione mai silenziosa: ciò che non
+// entra in larghezza finisce in un contatore esplicito, non troncato a metà.
+export function launchLegend(entries, columns) {
+    const reachable = entries.slice(0, LAUNCH_MAX);
+    const unreachable = entries.length - reachable.length;
+    // bordo + padding del box + prefisso "launch " ≈ 12 celle; pavimento a 24 per
+    // non degenerare a legenda vuota su terminali strettissimi.
+    const budget = Math.max(24, columns - 12);
+    // I fallback di parseLaunch (`▸` per emoji, command per label) sono già
+    // applicati a monte: qui non si re-implementano né si assumono campi popolati.
+    const parts = reachable.map((e, i) => `${i + 1} ${e.emoji} ${e.label}`);
+    const fit = (reserve) => {
+        const taken = [];
+        let used = 0;
+        for (const p of parts) {
+            const cost = cellWidth(p) + (taken.length > 0 ? 3 : 0); // ' · '
+            if (used + cost > budget - reserve)
+                break;
+            taken.push(p);
+            used += cost;
+        }
+        return taken;
+    };
+    // Primo tentativo senza riserva: se entra tutto, nessuno spazio sprecato per un
+    // contatore che non servirebbe. Altrimenti si ripete riservando la coda.
+    let taken = fit(0);
+    if (taken.length < parts.length)
+        taken = fit(10);
+    return { shown: taken.join(' · '), overflow: parts.length - taken.length, unreachable };
+}
 export function parseIdentity(raw) {
     if (!raw || typeof raw !== 'object')
         return null;

package/package.json

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

@@ -1,12 +1,15 @@
 #!/usr/bin/env bash
 #
-# deck-run <TaskID> — spike ① spawn primitive (UI-agnostico) di loom-deck.
+# deck-run <TaskID> | deck-run --no-task — spawn primitive (UI-agnostico) di loom-deck.
 #
 # Apre una tab Ptyxis nella window ATTIVA (quella col focus = il deck) e vi
 # avvia una sessione Claude Code già bound alla task via LOOM_TASK, dritta sul
 # prompt iniziale (default: prompt diretto "recap stato task <TaskID>" — no skill,
 # solo recap → più controllo). Riusabile identico da TUI (Ink) e da web.
 #
+# Con --no-task la sessione è NUDA: niente LOOM_TASK, niente prompt iniziale,
+# niente --session-id. Serve al lavoro spot che non appartiene a nessuna task.
+#
 # 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
@@ -21,27 +24,42 @@
 #   LOOM_DECK_WORKDIR      dir di lavoro della tab (default: $PWD)
 #   LOOM_DECK_ENTER_PROMPT prompt iniziale sessione, {TASK}=TaskID (default: "recap stato task <TaskID>")
 #   LOOM_DECK_INTAB_CMD    override comando in-tab (default: la sessione CC; usato per i test)
+#   LOOM_DECK_PERMISSION_MODE  override del permissionMode del file config (default: campo file, poi 'manual')
 #
 set -euo pipefail
 
 TASK=""
 SESSION_ID=""
+NO_TASK=0
 # Positional <TaskID> + flag opzionale --session-id <uuid> (T27): il deck genera
 # l'UUID e lo pinna così il binding sidecar sessionId↔taskId è deterministico.
+# --no-task (T42): modalità NUDA, senza TaskID — nessuna LOOM_TASK, nessun prompt
+# iniziale, nessun sessionId pinnato. Flag esplicito e non "positional opzionale"
+# perché un `deck-run` a mani vuote resta un errore d'uso, non una sessione spot.
 while [[ $# -gt 0 ]]; do
   case "$1" in
     --session-id)
       SESSION_ID="${2:-}"; shift 2 ;;
     --session-id=*)
       SESSION_ID="${1#*=}"; shift ;;
+    --no-task)
+      NO_TASK=1; shift ;;
     *)
       if [[ -z "$TASK" ]]; then TASK="$1"; shift
       else echo "argomento inatteso: '$1'" >&2; exit 2; fi ;;
   esac
 done
 
-if [[ -z "$TASK" ]]; then
-  echo "uso: deck-run <TaskID> [--session-id <uuid>]   (es. deck-run T18)" >&2
+USAGE="uso: deck-run <TaskID> [--session-id <uuid>]   (es. deck-run T18)
+     | deck-run --no-task                          (sessione nuda, senza task)"
+
+if [[ $NO_TASK -eq 1 && -n "$TASK" ]]; then
+  echo "--no-task e <TaskID> sono mutuamente esclusivi" >&2
+  echo "$USAGE" >&2
+  exit 2
+fi
+if [[ $NO_TASK -eq 0 && -z "$TASK" ]]; then
+  echo "$USAGE" >&2
   exit 2
 fi
 
@@ -68,17 +86,47 @@ _find_project_root() {  # <start-dir> → dir con .claude/loom-works.json, o vuo
   return 1
 }
 
-TITLE="cc ${TASK}"
+# Project root risolta UNA volta: la usano sia la label sia permissionMode (T45).
+_proot=""
 if command -v jq >/dev/null 2>&1; then
   _proot="$(_find_project_root "$WORKDIR" || true)"
-  if [[ -n "${_proot:-}" ]]; then
-    _label="$(jq -r 'if (.emoji and .owner and .name)
-                     then "\(.emoji) \(.owner) \(.name)" else empty end' \
-              "${_proot}/.claude/loom-works.json" 2>/dev/null || true)"
-    [[ -n "${_label:-}" ]] && TITLE="${_label} · ${TASK}"
+fi
+_cfg=""
+[[ -n "$_proot" ]] && _cfg="${_proot}/.claude/loom-works.json"
+
+# La label vale per OGNI surface claude, task o no (T42): il match compass è
+# window-level e non sa nulla di task → legare la titolazione alla presenza di
+# una task sarebbe un errore di layer. Cambia solo il suffisso: `· <task>` quando
+# la sessione è bound, nessun suffisso quando è nuda.
+if [[ $NO_TASK -eq 1 ]]; then TITLE="cc"; else TITLE="cc ${TASK}"; fi
+if [[ -n "$_cfg" ]]; then
+  _label="$(jq -r 'if (.emoji and .owner and .name)
+                   then "\(.emoji) \(.owner) \(.name)" else empty end' \
+            "$_cfg" 2>/dev/null || true)"
+  if [[ -n "${_label:-}" ]]; then
+    if [[ $NO_TASK -eq 1 ]]; then TITLE="${_label}"; else TITLE="${_label} · ${TASK}"; fi
   fi
 fi
 
+# ── permissionMode (T45) ─────────────────────────────────────────────────────
+# Precedenza: env LOOM_DECK_PERMISSION_MODE > campo del file config > 'manual'.
+# Il flag è passato SEMPRE, anche per 'manual': lo spawn resta deterministico e
+# leggibile nel process tree, invece di dipendere dal default del CLI (che può
+# cambiare fra versioni). Un valore fuori enum NON viene passato al CLI (che
+# rifiuterebbe, lasciando una tab con un comando rotto): fallback su 'manual'
+# con segnalazione su stderr.
+PERM_MODE="${LOOM_DECK_PERMISSION_MODE:-}"
+if [[ -z "$PERM_MODE" && -n "$_cfg" ]]; then
+  PERM_MODE="$(jq -r '.permissionMode // empty' "$_cfg" 2>/dev/null || true)"
+fi
+case "${PERM_MODE:-}" in
+  acceptEdits|auto|bypassPermissions|manual|dontAsk|plan) ;;
+  '') PERM_MODE="manual" ;;
+  *)  echo "permissionMode ignoto: '${PERM_MODE}' → fallback 'manual'" >&2
+      PERM_MODE="manual" ;;
+esac
+MODE_FLAG="--permission-mode ${PERM_MODE} "
+
 # --session-id per la tab: pinna il sessionId della sessione CC (vuoto → CC ne
 # genera uno). Lo spazio finale tiene la concatenazione pulita quando è assente.
 SID_FLAG=""
@@ -102,7 +150,15 @@ fi
 # `--name '<TITLE>'` = canale AUTORITATIVO del terminal-title (Ptyxis -T è solo il
 # titolo iniziale, prima che CC parta): CC lo setta e nomina anche la sessione nel
 # picker. Override-abile via LOOM_DECK_INTAB_CMD per i test empirici (probe non-CC).
-IN_TAB_CMD="${LOOM_DECK_INTAB_CMD:-LOOM_TASK=${TASK} claude --name '${TITLE}' ${SID_FLAG}'${PROMPT}'}"
+# Ramo --no-task (T42): saltano i TRE elementi che legano la sessione alla task —
+# iniezione LOOM_TASK, prompt iniziale, --session-id pinnato. Resta claude nudo,
+# titolato e con il permission mode del progetto.
+if [[ $NO_TASK -eq 1 ]]; then
+  _default_intab="claude --name '${TITLE}' ${MODE_FLAG}"
+else
+  _default_intab="LOOM_TASK=${TASK} claude --name '${TITLE}' ${MODE_FLAG}${SID_FLAG}'${PROMPT}'"
+fi
+IN_TAB_CMD="${LOOM_DECK_INTAB_CMD:-$_default_intab}"
 
 case "$MODE" in
   inline)