@lamemind/loom-deck 0.69.0 → 0.70.0

package/dist/hooks.js

@@ -8,8 +8,8 @@ import { statSync } from 'node:fs';
 import { loadTasks, loadTaskDetail } from './tasks.js';
 import { discoverProjectSessions } from './sessions.js';
 import { discoverLiveSessions, liveSig } from './live-sessions.js';
-import { appendSessionMeta, loadSessionIndex } from './task-index.js';
-import { sidecarGaps } from './session-meta.js';
+import { loadSessionIndex } from './task-index.js';
+import { fillSidecarGaps } from './session-meta.js';
 import { archivableIds, SCAN_INTERVAL_MS } from './archivable.js';
 import { commitTimes } from './commit-times.js';
 import { scanEpicHierarchy, EMPTY_EPIC_HIERARCHY } from './epic-hierarchy.js';
@@ -213,23 +213,14 @@ export function useSessions(projectRoot, core) {
             // Gli append NON entrano nella signature e non producono un re-render: il
             // deck il titolo lo ha dalla `Session`, che è la fonte. Questi campi
             // esistono per un lettore che non può aprire un transcript, cioè compass.
-            try {
-                for (const gap of sidecarGaps({
-                    pinned,
-                    sessions,
-                    bindings,
-                    titles: index.titles,
-                    models: index.models,
-                    core,
-                })) {
-                    appendSessionMeta(projectRoot, gap.sessionId, gap);
-                }
-            }
-            catch {
-                // sidecar non scrivibile: il poll continua, il buco si riprova al giro
-                // dopo. Niente a schermo — è manutenzione di un campo di servizio, non
-                // un'azione che l'utente ha chiesto.
-            }
+            fillSidecarGaps(projectRoot, {
+                pinned,
+                sessions,
+                bindings,
+                titles: index.titles,
+                models: index.models,
+                core,
+            });
             // La signature copre anche fork, pin, note e marca di priorità: un record
             // di lineage, un toggle di pin, una nota appena scritta o un 🚨 acceso
             // cambiano la lista renderizzata, quindi devono forzare il re-render come

package/dist/session-meta.js

@@ -8,14 +8,18 @@
 // lì da chi ce l'ha in mano, cioè il deck, che a ogni tick materializza le
 // `Session` complete di titolo e modello.
 //
-// Modulo PURO come `session-list.ts`: nessun I/O, nessun import da ink/react.
-// Decide COSA appendere e ritorna i record; il chiamante li scrive. La
-// separazione è ciò che rende testabile la parte non ovvia — la convergenza:
-// un derivato che non combacia mai col valore su disco produrrebbe un append a
-// ogni tick del poll, per sempre, senza nessun errore a dirlo.
+// Il giudizio è separato dalla scrittura: `sidecarGaps` decide e ritorna i
+// record, `fillSidecarGaps` li scrive. La separazione è ciò che rende testabile
+// la parte non ovvia — la convergenza: un derivato che non combacia mai col
+// valore su disco produrrebbe un append a ogni tick del poll, per sempre, senza
+// nessun errore a dirlo.
+//
+// Nessun import da ink/react: il chiamante è un hook, questo modulo no.
 import { modelAlias } from './glyphs.js';
 import { stripProjectCore, stripTaskId } from './session-list.js';
 import { NO_TITLE } from './sessions.js';
+import { NO_SPAWN } from './spawn.js';
+import { appendSessionMeta } from './task-index.js';
 /**
  * Cap del titolo scritto nel sidecar, in CODE POINT.
  *
@@ -62,28 +66,6 @@ export function sidecarTitle(s, core, taskId) {
         return s.title === NO_TITLE ? '' : capTitle(s.title);
     return capTitle(stripTaskId(stripProjectCore(s.title, core), taskId));
 }
-/**
- * I buchi da riempire in questo giro: per ogni conversazione PINNATA, i campi
- * derivati che nel sidecar mancano o non corrispondono più al valore corrente.
- *
- * Solo le pinnate, e non tutte le conversazioni del progetto, perché sono le
- * sole che un lettore esterno mostra: il resto sarebbe churn su un file
- * append-only, un record per conversazione per ogni deck che si apre.
- *
- * Tre cose che non producono un append, e nessuna delle tre è un errore:
- *  - una pinnata STALE (il transcript non c'è più) — nessuna `Session`, quindi
- *    nessun valore da cui derivare;
- *  - un titolo derivato VUOTO — è l'assenza di P1, e appenderlo scriverebbe la
- *    cancellazione di un campo che nessuno ha chiesto di cancellare;
- *  - un modello non riconducibile a un alias (`''` o fuori famiglia) — chi
- *    riprende cadrà sulla propria cascata, che è meglio di un alias inventato.
- *
- * La CONVERGENZA è l'invariante da tenere: il confronto avviene fra il valore
- * derivato e il valore letto dal sidecar senza riscritture in mezzo (nessuna
- * sanificazione in lettura, cap applicato da questo lato una volta sola),
- * quindi un buco riempito resta riempito e il giro successivo non trova niente
- * da fare.
- */
 export function sidecarGaps(input) {
     const { pinned, sessions, bindings, titles, models, core } = input;
     if (pinned.size === 0)
@@ -106,3 +88,39 @@ export function sidecarGaps(input) {
     }
     return out;
 }
+/**
+ * Scrive i buchi di questo giro. Ritorna quanti record ha appeso — zero è
+ * l'esito normale a regime, non un fallimento.
+ *
+ * `NO_SPAWN` frena anche questa scrittura, ed è lo stesso freno delle tab
+ * Ptyxis per la stessa ragione: il gate su pseudo-terminale avvia il DECK VERO
+ * con cwd la project root del cappello, quindi senza freno ogni run della suite
+ * appende record nel sidecar reale di chi la lancia. Il valore scritto sarebbe
+ * pure corretto — è quello che il deck scriverebbe comunque — ma è una
+ * scrittura fuori dalla sandbox del test, che è precisamente ciò che il freno
+ * esiste per impedire.
+ *
+ * Il freno sta QUI e non nel chiamante perché questa è l'unica sede della
+ * scrittura: nel chiamante sarebbe una guardia che il prossimo scrittore non
+ * vede.
+ *
+ * Un sidecar non scrivibile non è un errore da mostrare: il giro dopo riprova,
+ * e nel frattempo il deck funziona identico — questi campi li legge un altro
+ * processo, non lui.
+ */
+export function fillSidecarGaps(projectRoot, input) {
+    if (NO_SPAWN)
+        return 0;
+    let scritti = 0;
+    try {
+        for (const gap of sidecarGaps(input)) {
+            appendSessionMeta(projectRoot, gap.sessionId, gap);
+            scritti++;
+        }
+    }
+    catch {
+        // sidecar non scrivibile: si riprova al giro dopo, niente a schermo — è
+        // manutenzione di un campo di servizio, non un'azione che l'utente ha chiesto.
+    }
+    return scritti;
+}

package/package.json

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