@lamemind/loom-deck 0.15.0 → 0.16.0

package/README.md

@@ -4,12 +4,16 @@ Deck TUI (Ink) **per-progetto** della famiglia [loom](https://github.com/lamemin
 
 Legge il `tasks.md` del progetto e, con un tasto (poi un click), **spawna** una tab
 [Ptyxis](https://gitlab.gnome.org/chergert/ptyxis) che avvia una sessione Claude Code
-già bound alla task via `LOOM_TASK`, dritta su `/loom-works:run-task <Txx>`.
+già bound alla task via `LOOM_TASK`, con un prompt di recap sullo stato della task.
 
 ```
-↑↓ scegli la task  →  ⏎  →  tab CC di fianco  →  parte già su /loom-works:run-task <Txx>
+↑↓ scegli la task  →  ⏎  →  tab CC di fianco  →  LOOM_TASK bound + recap stato task
 ```
 
+Entrambi i prefissi del contratto loom entrano in lista: **`T`** (code task) e
+**`D`** (doc task). Nessuna differenza di trattamento — il prompt iniziale è un
+recap, non l'invocazione di una skill, quindi vale identico sulle due famiglie.
+
 ## Ruolo nella famiglia loom
 
 `loom-deck` è un **client** con runtime proprio (TUI Ink) che **consuma** il contratto
@@ -193,6 +197,11 @@ p  priorità     s  stato     i  id
 
 Partendo da catena vuota, digitare `ppi` produce `[pri ↓, id ↑]`. Il ciclo parte
 sempre **dallo stato corrente**, che il modale mostra dal vivo mentre digiti.
+
+Sull'**id** il confronto è numerico (`T9` prima di `T10`, non lessicografico) e i
+due prefissi sono blocchi distinti — le `D` in coda alle `T`: i counter `T` e `D`
+sono separati nel contratto loom, quindi `T01` e `D01` non sono confrontabili
+come numeri soli.
 A parità su tutte le chiavi decide sempre l'`id` (confronto **numerico**: `T9`
 prima di `T10`) → l'ordine è deterministico, mai instabile fra un refresh e l'altro.
 
@@ -234,7 +243,8 @@ npx @lamemind/loom-deck
 scripts/deck-run T18
 ```
 
-Apre una tab Ptyxis nella window attiva con `LOOM_TASK=T18 claude '/loom-works:run-task T18'`.
+Apre una tab Ptyxis nella window attiva con `LOOM_TASK=T18 claude 'recap stato task T18'`
+(prompt override-abile via `LOOM_DECK_ENTER_PROMPT`, placeholder `{TASK}`).
 
 ## Sviluppo (TUI Ink)
 

package/dist/task-edit.js

@@ -3,7 +3,7 @@
 // isolata in `writeTaskEdit`, così la grammatica delle sostituzioni è testabile
 // senza toccare il filesystem.
 import { readFileSync, writeFileSync } from 'node:fs';
-import { findTaskFile } from './tasks.js';
+import { TASK_ID_RE, findTaskFile } from './tasks.js';
 // Il task file scrive la priorità per NOME (`- **Priority**: Med`), tasks.md la
 // scrive come GLIFO (colonna Pri). Due rappresentazioni dello stesso valore →
 // due mappe, entrambe keyed sul nome canonico di view.ts (unica fonte del rango).
@@ -81,11 +81,11 @@ export function initialDetail(current, prog, date = today()) {
  * restano i token grezzi originali: nessun re-flow della tabella, il diff resta
  * di una riga. `ok:false` = id assente → il chiamante non scrive nulla.
  *
- * L'id deve rispettare `^T\d+$`, stesso gate di `parseTasks`: senza, un id
- * arbitrario matcherebbe la riga di HEADER (`| ID | Pri | K | Prog |`) o quella
- * di separatore, riscrivendone le celle e sfondando la tabella.
+ * L'id deve rispettare `TASK_ID_RE` (importato da tasks.ts — stesso gate di
+ * `parseTasks`, non una copia): senza, un id arbitrario matcherebbe la riga di
+ * HEADER (`| ID | Pri | K | Prog |`) o quella di separatore, riscrivendone le
+ * celle e sfondando la tabella.
  */
-const TASK_ID_RE = /^T\d+$/;
 export function updateTasksMdRow(content, id, priGlyph, progGlyph) {
     if (!TASK_ID_RE.test(id))
         return { content, ok: false };

package/dist/tasks.js

@@ -1,6 +1,13 @@
 import { readFileSync, readdirSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { normalizeEmoji } from './viewport.js';
+/**
+ * Forma di un ID task: `T` (code) o `D` (doc) + numero. FONTE UNICA del gate —
+ * `parseTasks` lo usa per scartare header/separatore della tabella, `task-edit`
+ * per non riscrivere per sbaglio quelle stesse righe. Tenerlo in un posto solo
+ * evita che i due gate divergano (uno accetterebbe righe che l'altro rifiuta).
+ */
+export const TASK_ID_RE = /^[TD]\d+$/;
 // D1 (preflight T20): default docs/tasks.md, override della docs-root via env
 // LOOM_DECK_DOCS_ROOT (es. questo progetto usa `runtime`). No auto-detect.
 export function resolveTasksPath(cwd = process.cwd()) {
@@ -13,9 +20,11 @@ export function resolveTasksDir(cwd = process.cwd()) {
     return join(dirname(resolveTasksPath(cwd)), 'tasks');
 }
 // Estrae le righe `| Tnn | Pri | K | Prog | Task |` della Tasks Overview.
-// Il prefisso task è `T` (contratto plugin); le doc-task `D{N}` e le righe
-// header/separatore non matchano `^T\d+$` → scartate. deck-run agisce solo
-// su task T (run-task), quindi le D non hanno azione qui.
+// Due prefissi ammessi (contratto plugin, counter separati): `T` = code task,
+// `D` = doc task. Le D entrano in lista come le T perché `deck-run` NON inietta
+// `run-task`: il prompt iniziale è un recap diretto ("recap stato task <id>"),
+// valido identico su una doc task. Righe header/separatore non matchano `^[TD]\d+$`
+// → scartate.
 export function parseTasks(content) {
     const tasks = [];
     for (const line of content.split('\n')) {
@@ -25,7 +34,7 @@ export function parseTasks(content) {
         const cells = t.split('|').map((c) => c.trim());
         // cells[0] = '' (prima del primo |), cells[last] = '' (dopo l'ultimo |)
         const id = cells[1];
-        if (!/^T\d+$/.test(id))
+        if (!TASK_ID_RE.test(id))
             continue;
         // Colonne overview: | ID | Pri | K | Prog | Task | → cells[2]=Pri (icona
         // priorità), cells[4]=Prog. K (Kind, cells[3]) non serve al deck.
@@ -77,7 +86,10 @@ export function parseTaskDetail(id, content) {
     let inDesc = false;
     for (const line of content.split('\n')) {
         if (!title && line.startsWith('# ')) {
-            title = line.replace(/^#\s+/, '').replace(/^Task:\s*/, '').trim();
+            // I due template scrivono H1 diversi — `# Task: …` (code) e
+            // `# Doc Task: …` (doc): entrambi i cappelli vanno via, il titolo mostrato
+            // è la descrizione, non la sua categoria (già data dall'id).
+            title = line.replace(/^#\s+/, '').replace(/^(?:Doc\s+)?Task:\s*/, '').trim();
             continue;
         }
         if (line.startsWith('## ')) {

package/dist/view.js

@@ -53,11 +53,16 @@ export function progRank(glyph) {
     return PROG_TABLE.find((e) => e.glyph === g)?.rank ?? UNKNOWN_RANK;
 }
 // `T10`.localeCompare(`T9`) mette T10 prima: l'ID va confrontato NUMERICO.
-// parseTasks ammette solo /^T\d+$/, ma un id fuori forma non deve far esplodere
-// il comparator → finisce in coda con Number.MAX_SAFE_INTEGER.
+// parseTasks ammette due prefissi con counter SEPARATI (`T` code, `D` doc) →
+// il solo numero non basta, T01 e D01 collidono. Il prefisso pesa quindi come
+// cifra più significativa (T prima di D, blocco doc in coda), il numero come
+// meno significativa: il rango resta un intero singolo, quindi il comparator
+// della chain non cambia forma. Il gap 1e6 è oltre qualunque counter reale.
+// Un id fuori forma non deve far esplodere il comparator → coda con MAX_SAFE.
+const ID_PREFIX_RANK = { T: 0, D: 1 };
 export function idNum(id) {
-    const m = /^T(\d+)$/.exec(id);
-    return m ? Number(m[1]) : Number.MAX_SAFE_INTEGER;
+    const m = /^([TD])(\d+)$/.exec(id);
+    return m ? ID_PREFIX_RANK[m[1]] * 1_000_000 + Number(m[2]) : Number.MAX_SAFE_INTEGER;
 }
 function rankOf(task, key) {
     if (key === 'pri')

package/package.json

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