@lamemind/loom-deck 0.75.0 → 0.77.0

package/dist/windows-terminal.js

@@ -0,0 +1,153 @@
+// T176 — le tab di WINDOWS TERMINAL: argv di `wt.exe`, env della tab, il canale
+// che porta l'argv di `claude` al wrapper.
+//
+// Su Windows una conversazione si apre con
+//
+//     wt.exe -w 0 new-tab -p loom-deck -d <root> --title <titolo>
+//            --suppressApplicationTitle -- <node> <tab-wrapper.js>
+//
+// e l'argv di `claude` (nome, flag, prompt) NON sta su quella riga: viaggia come
+// JSON nella variabile `LOOM_DECK_TAB_ARGV`, perché la tab eredita l'env del
+// processo che lancia `wt.exe` (T174 verdetto 5, rimisurato con `-p`). Il
+// wrapper la legge, la toglie e lancia `claude` senza shell (P3 preflight).
+// Così il prompt non passa né dal parser di `wt` né da una shell: `wt` legge `;`
+// come separatore di sottocomandi in QUALUNQUE argomento, anche dopo `--` e
+// anche escapato `\;` (misurato su Windows Terminal 1.24: la coda dopo il `;`
+// diventa una tab a sé, col proprio errore), e cmd o PowerShell
+// interpreterebbero `' " & % ^ |`.
+//
+// Modulo PURO: l'env arriva come valore, il bash di Git come stringa già
+// risolta.
+/** Il lanciatore di Windows Terminal: l'alias d'esecuzione in `WindowsApps`,
+ *  che `spawn` trova nel `PATH` e lancia senza shell (misurato). */
+export const WT_CMD = 'wt.exe';
+/** Il profilo delle tab del deck (P9 preflight): uno solo per tutti i
+ *  progetti, nascosto dal menu, creato a mano dall'utente nel `settings.json` di
+ *  Windows Terminal. Porta ciò che i flag non dicono — font, `closeOnExit`, la
+ *  shell del tasto `t`; titolo, cartella e comando li passa il deck. */
+export const WT_PROFILE_DEFAULT = 'loom-deck';
+/** La variabile con cui l'argv di `claude` arriva al wrapper della tab. */
+export const TAB_ARGV_ENV = 'LOOM_DECK_TAB_ARGV';
+/**
+ * I marker che una sessione Claude Code inietta nei processi figli (P4
+ * preflight, misurati nella shell di una sessione su Windows).
+ *
+ * La tab eredita tutto l'env del deck, e un deck avviato da una shell aperta
+ * dentro Claude Code li porterebbe nella conversazione nuova: con
+ * `CLAUDE_CODE_CHILD_SESSION` la sessione non salva il transcript («Transcript
+ * saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker») e non compare
+ * nello storico del deck. Lista chiusa e non ogni `CLAUDE*`: un
+ * `CLAUDE_CONFIG_DIR` o un `CLAUDE_CODE_GIT_BASH_PATH` dell'utente sparirebbero
+ * senza segnale, mentre un marker nuovo di una versione futura si annuncia da
+ * sé, nel messaggio di avvio di `claude` che lo nomina.
+ */
+export const SESSION_MARKERS = [
+    'CLAUDECODE',
+    'CLAUDE_CODE_CHILD_SESSION',
+    'CLAUDE_CODE_SESSION_ID',
+    'CLAUDE_PID',
+    'CLAUDE_EFFORT',
+    'CLAUDE_CODE_MESSAGING_SOCKET',
+    'CLAUDE_CODE_MESSAGING_TOKEN',
+    'CLAUDE_CODE_ENTRYPOINT',
+    'CLAUDE_CODE_SESSION_ATTENDED',
+    'CLAUDE_CODE_EXECPATH',
+];
+const GIT_BASH_ENV = 'CLAUDE_CODE_GIT_BASH_PATH';
+/** Il profilo da passare a `-p`: `LOOM_DECK_WT_PROFILE` se impostata (vuota =
+ *  nessun `-p`, il profilo di default di Windows Terminal), altrimenti
+ *  `loom-deck`. Un profilo che non esiste non è un errore: Windows Terminal
+ *  apre la tab col profilo di default e non dice niente (misurato), quindi il
+ *  deck lo passa sempre senza verificarlo. */
+export function wtProfile(env) {
+    const v = env.LOOM_DECK_WT_PROFILE;
+    if (v === undefined)
+        return WT_PROFILE_DEFAULT;
+    return v || null;
+}
+/** Il titolo come lo riceve `wt`: senza `;`, che spezzerebbe il comando. Il
+ *  titolo è composto dal deck (label, TaskID, nota ridotta) e un `;` può
+ *  venire solo dal nome del progetto: si toglie invece di fallire. */
+export function wtTitle(title) {
+    return title.replace(/;/g, '');
+}
+/**
+ * L'argv di `wt.exe` per una tab nuova.
+ *
+ * `-w 0` è la finestra di Windows Terminal usata per ultima — quella da cui si
+ * lavora col deck —, `-w new` una finestra nuova (l'equivalente di
+ * `--new-window` di Ptyxis). `--suppressApplicationTitle` tiene il titolo del
+ * deck contro quello che il programma della tab imposta (misurato): è ciò che su
+ * Linux fa `-T` di Ptyxis contro l'OSC del prompt. Senza titolo il flag non si
+ * passa, e la tab prende quello della shell.
+ */
+export function wtNewTabArgs(tab) {
+    const args = ['-w', tab.newWindow ? 'new' : '0', 'new-tab'];
+    if (tab.profile)
+        args.push('-p', tab.profile);
+    args.push('-d', tab.cwd);
+    if (tab.title !== null)
+        args.push('--title', wtTitle(tab.title), '--suppressApplicationTitle');
+    if (tab.command)
+        args.push('--', ...tab.command);
+    return args;
+}
+/**
+ * Il primo argomento di `wt` che contiene un `;`, o `null`.
+ *
+ * Il titolo è già ripulito; restano i path (la cartella, node, il wrapper) e il
+ * nome del profilo. Un path col `;` è legale su NTFS e `wt` non lo sa portare:
+ * lo spawn si ferma dicendolo, invece di aprire una tab d'errore con metà
+ * comando.
+ */
+export function semicolonArg(args) {
+    return args.find((a) => a.includes(';')) ?? null;
+}
+/** Toglie una chiave ignorando le maiuscole: su Windows l'env non le distingue,
+ *  e una copia di `process.env` può portare `Path` invece di `PATH`. */
+function deleteKey(env, key) {
+    const want = key.toUpperCase();
+    for (const k of Object.keys(env))
+        if (k.toUpperCase() === want)
+            delete env[k];
+}
+function hasKey(env, key) {
+    const want = key.toUpperCase();
+    return Object.keys(env).some((k) => k.toUpperCase() === want && env[k]);
+}
+/**
+ * L'env di una tab aperta dal deck su Windows: quello del deck, meno i marker di
+ * sessione, con la task della conversazione e il bash di Git.
+ *
+ * `task` = `null` per le tab senza task (`--no-task`, il tasto `t`): una
+ * `LOOM_TASK` ereditata legherebbe a una task una sessione che non ne ha, e
+ * l'hook `SessionStart` ne inietterebbe il task file. `CLAUDE_CODE_GIT_BASH_PATH`
+ * entra quando manca e il bash si trova: la tab eredita anche il `PATH`, e col
+ * `PATH` di Git Bash `claude` eseguirebbe gli hook del plugin in PowerShell
+ * (T174 verdetto 9), cioè senza la task in contesto.
+ */
+export function windowsTabEnv(env, task, gitBash) {
+    const out = { ...env };
+    for (const marker of SESSION_MARKERS)
+        deleteKey(out, marker);
+    deleteKey(out, 'LOOM_TASK');
+    deleteKey(out, TAB_ARGV_ENV);
+    if (task)
+        out.LOOM_TASK = task;
+    if (gitBash && !hasKey(env, GIT_BASH_ENV))
+        out[GIT_BASH_ENV] = gitBash;
+    return out;
+}
+/** L'argv di `claude` letto dalla variabile della tab, o `null` se manca o non
+ *  è un array di stringhe. */
+export function parseTabArgv(raw) {
+    if (!raw)
+        return null;
+    try {
+        const v = JSON.parse(raw);
+        return Array.isArray(v) && v.every((a) => typeof a === 'string') ? v : null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/wrap-scan.js

@@ -87,7 +87,7 @@ export const WRAP_DEFAULT_PATH = '.';
  * T161 — il buco `{path}` del titolo e del prompt di una sessione di
  * srotolamento: il path reso a parole.
  *
- * Le barre diventano spazi e l'estensione cade QUI, prima di `_sane_note`, il
+ * Le barre diventano spazi e l'estensione cade QUI, prima di `saneNote`, il
  * cui alfabeto non ha né `/` né `.`: lasciandoceli cadere le parole si
  * salderebbero (`runtimereferencedoc-systemmd`), e il titolo della tab
  * divergerebbe da quello che la lista del deck legge dal sidecar.
@@ -145,7 +145,7 @@ export async function runWrapScan(projectRoot) {
     if (!script)
         return false;
     try {
-        const { stdout } = await execFileAsync('python3', [script, '--root', projectRoot, '--scan'], { cwd: projectRoot, maxBuffer: 16 * 1024 * 1024 });
+        const { stdout } = await execFileAsync('python3', [script, '--root', projectRoot, '--scan'], { cwd: projectRoot, maxBuffer: 16 * 1024 * 1024, windowsHide: true });
         const path = wrapCacheFile(projectRoot);
         mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
         writeFileSync(path, stdout, { mode: 0o600 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lamemind/loom-deck",
-  "version": "0.75.0",
+  "version": "0.77.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": {
@@ -13,7 +13,8 @@
   "scripts": {
     "dev": "tsx src/cli.tsx",
     "build": "tsc",
-    "test": "tsx --test test/*.test.ts",
+    "pretest": "tsc",
+    "test": "node test/run.mjs",
     "start": "node dist/cli.js",
     "prepare": "tsc"
   },