@nac3/forge-cli 1.19.5 → 1.20.0

package/dist/chat/instances.js

@@ -0,0 +1,224 @@
+/**
+ * LIVE FORGE INSTANCES -- the register that did not exist (PND-161, PND-162,
+ * PND-160).
+ *
+ * `src/tasks/alive.ts` answers "what background TASK is still running" very
+ * well: the supervisor knows what it launched. But a chat panel and a
+ * `yf start` are not supervisor tasks. Nobody counted them, nobody warned
+ * about them, and no command could stop one. The owner found out the way
+ * you find out about this class of bug: on 2026-10-21 his machine had nine
+ * node processes holding 134 GB of virtual space between them, three of them
+ * launched two days earlier, and Windows declared virtual memory exhaustion
+ * seven times in eighteen minutes. The identity of the processes being
+ * killed was lost with their pids, because Forge kept no register.
+ *
+ * This module is the same lesson as alive.ts, one level up -- what does not
+ * finish has to be VISIBLE, COUNTABLE and STOPPABLE -- applied to the
+ * instances themselves. It reads the lock files (the only record an instance
+ * leaves) and answers three questions:
+ *
+ *   1. what is running now, since when, and how much memory does it hold
+ *      (PND-162: `yf task list` and the panel's startup notice);
+ *   2. which previous session died without closing, and at what time
+ *      (PND-161: the chat notice, dated by the lock's last heartbeat);
+ *   3. is anything running from the GLOBAL module right now
+ *      (PND-160: the global update has to refuse, not warn-and-proceed).
+ *
+ * Virtual size, not just heap. A node process paged out entirely shows a
+ * working set of 0 MB and still counts its full commit charge against the
+ * system: that is what trips Windows event 2004, and it is why the heap
+ * number alone made the machine look healthy. The heartbeat cannot afford a
+ * subprocess, so it records heap and RSS; this module adds the virtual size
+ * at LIST time, with one query for every pid at once, and says so when the
+ * platform will not give it.
+ *
+ * ASCII-only.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { listInstanceLocks } from './instance_lock.js';
+const execFileP = promisify(execFile);
+const MAX_LISTED = 8;
+function toLive(h, now, processStart) {
+    return {
+        pid: h.pid, port: h.port, root: h.root,
+        kind: h.kind ?? 'desconocido',
+        ...(h.version ? { version: h.version } : {}),
+        started_at: h.since,
+        age_minutes: Math.max(0, Math.round((now - h.since) / 60000)),
+        ...(h.beat_at != null ? { beat_at: h.beat_at, beat_age_minutes: Math.max(0, Math.round((now - h.beat_at) / 60000)) } : {}),
+        ...(h.heap_mb != null ? { heap_mb: h.heap_mb } : {}),
+        ...(h.heap_limit_mb != null ? { heap_limit_mb: h.heap_limit_mb } : {}),
+        ...(h.rss_mb != null ? { rss_mb: h.rss_mb } : {}),
+        ...(h.module_dir ? { module_dir: h.module_dir } : {}),
+        from_previous_session: h.since < processStart,
+    };
+}
+/** Virtual size in MB per pid, best effort, ONE query for all of them.
+ *
+ *  Windows: Get-Process, which is the only place VirtualMemorySize64 lives.
+ *  Linux: /proc/<pid>/statm, field 1, in pages. Elsewhere: nothing, and the
+ *  caller is told it is nothing rather than zero. */
+export async function virtualSizes(pids) {
+    const bytes = new Map();
+    if (!pids.length)
+        return { bytes, unavailable: false };
+    try {
+        if (process.platform === 'win32') {
+            const script = 'Get-Process -Id ' + pids.join(',') + ' -ErrorAction SilentlyContinue'
+                + ' | ForEach-Object { "$($_.Id) $($_.VirtualMemorySize64)" }';
+            const { stdout } = await execFileP('powershell', ['-NoProfile', '-NonInteractive', '-Command', script], { encoding: 'utf8', windowsHide: true, timeout: 8000 });
+            for (const line of stdout.split('\n')) {
+                const m = /^\s*(\d+)\s+(\d+)\s*$/.exec(line);
+                if (m)
+                    bytes.set(Number(m[1]), Number(m[2]));
+            }
+            return { bytes, unavailable: false };
+        }
+        if (process.platform === 'linux') {
+            const fs = await import('node:fs/promises');
+            const pageSize = 4096;
+            for (const pid of pids) {
+                try {
+                    const statm = await fs.readFile('/proc/' + pid + '/statm', 'utf8');
+                    const pages = Number(statm.trim().split(/\s+/)[0]);
+                    if (Number.isFinite(pages))
+                        bytes.set(pid, pages * pageSize);
+                }
+                catch { /* gone between the listing and here */ }
+            }
+            return { bytes, unavailable: false };
+        }
+    }
+    catch { /* the query itself failed: report unavailable, never zero */ }
+    return { bytes, unavailable: true };
+}
+/** The instance report. `with_vsz` costs one subprocess, so it is opt-in:
+ *  the panel's startup notice does not need it, `yf task list` does. */
+export async function instanceReport(opts = {}) {
+    const now = opts.now ?? Date.now();
+    const processStart = opts.processStart ?? (Date.now() - Math.round(process.uptime() * 1000));
+    const { alive, dead } = listInstanceLocks();
+    const live = alive.map((h) => toLive(h, now, processStart));
+    if (!opts.with_vsz || !live.length)
+        return { alive: live, dead };
+    const { bytes, unavailable } = await virtualSizes(live.map((i) => i.pid));
+    for (const i of live) {
+        const b = bytes.get(i.pid);
+        if (b != null)
+            i.vsz_mb = Math.round(b / (1024 * 1024));
+    }
+    return { alive: live, dead, ...(unavailable ? { vsz_unavailable: true } : {}) };
+}
+function age(minutes) {
+    if (minutes < 60)
+        return minutes + ' min';
+    const h = Math.floor(minutes / 60);
+    return h < 24 ? h + ' h' : Math.floor(h / 24) + ' d';
+}
+function hhmm(ms) {
+    const d = new Date(ms);
+    const p = (n) => String(n).padStart(2, '0');
+    return p(d.getHours()) + ':' + p(d.getMinutes());
+}
+/** The chat line for a PREVIOUS session that died without closing (PND-161).
+ *
+ *  Empty when there is nothing to say -- and that is the hard rule here: an
+ *  ordered shutdown removes its lock, so it reaches this function as
+ *  nothing, and produces no message. A notice about the normal case becomes
+ *  noise and then stops being read, which would cost exactly the signal
+ *  this was built to give. */
+export function renderDeathNotice(dead) {
+    if (!dead.length)
+        return '';
+    const lines = [];
+    for (const d of dead.slice(0, MAX_LISTED)) {
+        const what = d.kind === 'start' ? 'El servidor' : 'La sesion';
+        if (d.beat_at != null) {
+            const mins = Math.max(0, Math.round((d.beat_at - d.since) / 60000));
+            lines.push('  - ' + what + ' anterior (PID ' + d.pid + ') se corto cerca de las ' + hhmm(d.beat_at)
+                + ' sin cierre ordenado, despues de ' + age(mins) + ' viva.'
+                + (d.heap_mb != null && d.heap_limit_mb ? ' Ultimo latido: heap ' + d.heap_mb + '/' + d.heap_limit_mb + ' MB'
+                    + (d.rss_mb != null ? ', RSS ' + d.rss_mb + ' MB' : '') + '.' : '')
+                + (d.memory_pressure ? ' El heap venia arriba del 85% del techo: la muerte es CONSISTENTE con falta de memoria (no es prueba: Forge no ve el kill).' : ''));
+        }
+        else {
+            /* A lock from a Forge without the heartbeat. The death is certain --
+             * the lock was never released -- but the hour is not, and inventing
+             * one from the file's timestamps would be the same guessing the
+             * heartbeat exists to replace. */
+            lines.push('  - ' + what + ' anterior (PID ' + d.pid + ') murio sin cierre ordenado. La hora exacta no quedo'
+                + ' registrada: ese panel es de una version sin latido.');
+        }
+    }
+    if (dead.length > MAX_LISTED)
+        lines.push('  ... y ' + (dead.length - MAX_LISTED) + ' mas');
+    return ['[sesion] ' + (dead.length === 1 ? 'La sesion anterior de este proyecto no cerro bien:' : dead.length + ' sesiones anteriores no cerraron bien:'),
+        ...lines,
+        'Si estabas en medio de un turno, revisa el ultimo mensaje: lo que el cerebro no alcanzo a guardar no esta.'].join('\n');
+}
+/** The chat line for OTHER instances still running (PND-162). Only the ones
+ *  from a previous session: the one the owner just opened is not news, and
+ *  a second panel on another project is legitimate and current. */
+export function renderOldInstancesNotice(alive, selfPid = process.pid) {
+    const old = alive.filter((i) => i.pid !== selfPid && i.from_previous_session);
+    if (!old.length)
+        return '';
+    const lines = [
+        '[instancias] Hay ' + old.length + ' proceso(s) de Forge de una sesion anterior todavia vivos:',
+        ...old.slice(0, MAX_LISTED).map((i) => '  - PID ' + i.pid + ' [' + i.kind + ']'
+            + ' hace ' + age(i.age_minutes)
+            + (i.rss_mb != null ? ', RSS ' + i.rss_mb + ' MB' : '')
+            + (i.vsz_mb != null ? ', virtual ' + i.vsz_mb + ' MB' : '')
+            + ' -- ' + i.root),
+    ];
+    if (old.length > MAX_LISTED)
+        lines.push('  ... y ' + (old.length - MAX_LISTED) + ' mas');
+    lines.push('Cada uno reserva memoria del sistema aunque no lo uses. Los listas con `yf task list` y los paras con `yf instance stop <pid>`.');
+    return lines.join('\n');
+}
+/** Stop a Forge instance by pid, with its whole process tree.
+ *
+ *  Two guards, and both matter. It refuses our own pid, and it refuses any
+ *  pid that is not in the lock registry -- so this is a way to stop Forge
+ *  instances, never a general process killer reachable from the chat. On
+ *  Windows the tree flag is not optional: a panel's real work happens in
+ *  children, and killing only the parent leaves them holding the memory
+ *  that was the problem in the first place. */
+export async function stopInstance(pid, selfPid = process.pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return { stopped: false, reason: 'pid invalido' };
+    if (pid === selfPid)
+        return { stopped: false, reason: 'es el proceso actual: cerralo normalmente' };
+    const { alive } = listInstanceLocks();
+    if (!alive.some((h) => h.pid === pid)) {
+        return { stopped: false, reason: 'no es una instancia de Forge viva (no hay lock con ese pid)' };
+    }
+    try {
+        if (process.platform === 'win32') {
+            await execFileP('taskkill', ['/PID', String(pid), '/T', '/F'], { windowsHide: true, timeout: 10000 });
+        }
+        else {
+            process.kill(pid, 'SIGTERM');
+        }
+        return { stopped: true };
+    }
+    catch (e) {
+        return { stopped: false, reason: e instanceof Error ? e.message.split('\n')[0] : String(e) };
+    }
+}
+/** Instances running from the GLOBAL module, for the update precheck
+ *  (PND-160). A panel keeps better_sqlite3.node mapped, and on Windows a
+ *  mapped file cannot be replaced -- so `npm i -g` deletes the old module,
+ *  fails to write the new native binary, and aborts leaving the global
+ *  package as a bare node_modules with no dist and no binaries. `yf` stops
+ *  existing. The matching is on the lock's own record of where the process
+ *  came from, so it does not depend on reading another process's argv. */
+export function instancesFromGlobal(alive, globalPrefix, selfPid = process.pid) {
+    const norm = (p) => (process.platform === 'win32' ? p.toLowerCase() : p).replace(/[\\/]+$/, '');
+    const prefix = norm(globalPrefix);
+    if (!prefix)
+        return [];
+    return alive.filter((i) => i.pid !== selfPid && norm(i.module_dir ?? '').startsWith(prefix));
+}
+//# sourceMappingURL=instances.js.map

package/dist/chat/instances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instances.js","sourceRoot":"","sources":["../../src/chat/instances.ts"],"names":[],"mappings":"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"}

package/dist/chat/panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/chat/panel.ts"],"names":[],"mappings":"AAmBA,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;2BAKuB;IACvB,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAu5bxD"}
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/chat/panel.ts"],"names":[],"mappings":"AAmBA,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;2BAKuB;IACvB,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAsqcxD"}

package/dist/chat/panel.js

@@ -1103,6 +1103,16 @@ body {
 #yf-full .pz-pnd-chip.pnd-prio-cold { border-color: #d4cbb8; color: #8d8470; }
 #yf-full .pz-pnd-chip.pnd-doc    { border-color: rgba(111,139,94,0.6); color: #5d7a4c; }
 #yf-full .pz-pnd-chip.pnd-nodoc  { border-color: rgba(164,74,54,0.4); color: #a44a36; }
+/* PND-156: el reporte honesto es OTRO dato que el expediente, y antes
+ * compartia la clase pnd-doc, con lo cual se veian identicos y parecian el
+ * mismo indicador repetido. Indigo sumi-e, no verde. */
+#yf-full .pz-pnd-chip.pnd-report { border-color: rgba(79,91,135,0.6); color: #4f5b87; background: rgba(79,91,135,0.06); }
+/* PND-155: control de orden de la lista. */
+#yf-full .pz-pnd-sort { font: inherit; font-size: 11px; color: var(--ink-muted, #6f6650); background: var(--bg-0, #fffdf7);
+  border: 1px solid #d4cbb8; border-radius: 4px; padding: 2px 4px; cursor: pointer; }
+#yf-full .pz-pnd-dir { font: inherit; font-size: 11px; width: 24px; color: var(--ink-muted, #6f6650);
+  background: var(--bg-0, #fffdf7); border: 1px solid #d4cbb8; border-radius: 4px; cursor: pointer; padding: 2px 0; }
+#yf-full .pz-pnd-dir:hover, #yf-full .pz-pnd-sort:hover { border-color: var(--amber, #c8a04d); color: var(--ink, #3b3528); }
 /* Pestana BPMN 2.0 (flujos de proceso). */
 #yf-full .pz-body.pz-bpmn-wrap { background: var(--bg-1, #f5f0e6); padding: 12px; overflow: auto; }
 #yf-full .pz-bpmn-svg { display: block; width: 100%; height: auto; }
@@ -3292,7 +3302,10 @@ let state = {
      { id, title, kind, content, language?, file_path?,
        isEditing?, editValue?, dirty? }
      activeId picks which tab body to render. */
-  pizarron: { items: [], activeId: null },
+  /* PND-153: ui = memoria por pestana (foco, caret, scroll); renderedId =
+   * la pestana que esta EN EL DOM, que en un cambio de pestana NO es la
+   * activa -- confundir esas dos era el bug. */
+  pizarron: { items: [], activeId: null, ui: {}, renderedId: null },
   /* alpha.43 F1 -- cached NAC3 manifest + version. Updated on
      boot via GET /api/forge/nac3-manifest and on every chat
      response that carries nac3_manifest_version. Mismatch
@@ -5665,6 +5678,7 @@ function pizarronDropItem(id) {
   const idx = state.pizarron.items.findIndex((x) => x.id === id);
   if (idx < 0) return;
   state.pizarron.items.splice(idx, 1);
+  pzForgetUiState(id); /* PND-153: no acumular memoria de pestanas cerradas */
   if (state.pizarron.activeId === id) {
     const next = state.pizarron.items[state.pizarron.items.length - 1];
     state.pizarron.activeId = next ? next.id : null;
@@ -5737,7 +5751,7 @@ function uzkRenderModal(r) {
     for (var k = 0; k < r.receipts.length; k++) {
       var rc = r.receipts[k];
       h += '<li class="' + (rc.verdict === 'ok' ? 'uzk-ok' : 'uzk-fail') + '">' + escapeHtml(rc.id + ' ' + rc.kind + (rc.pending_id ? ' (' + rc.pending_id + ')' : '') + ' -- ' + (rc.verdict === 'ok' ? 'OK' : 'NOT OK'))
-        + '<span class="uzk-det">' + escapeHtml(rc.command + (rc.counts ? ' | ' + rc.counts : '')) + '</span></li>';
+        + '<span class="uzk-det">' + escapeHtml(rc.command + (rc.counts ? ' | ' + rc.counts : '') + (rc.why ? ' | ' + rc.why : '')) + '</span></li>';
     }
     h += '</ul>';
   }
@@ -5847,6 +5861,7 @@ function pizarronCloseItem(id) {
     yfCoding.raf = null;
   }
   state.pizarron.items.splice(idx, 1);
+  pzForgetUiState(id); /* PND-153: no acumular memoria de pestanas cerradas */
   if (state.pizarron.activeId === id) {
     const next = state.pizarron.items[state.pizarron.items.length - 1];
     state.pizarron.activeId = next ? next.id : null;
@@ -6268,14 +6283,146 @@ function pzRestoreScroll(body, snap) {
   try { requestAnimationFrame(apply); } catch (e) { /* entorno sin rAF */ }
 }
 
+/* ---- PND-153: memoria de UI POR PESTANA (foco, caret, scroll) ----
+ *
+ * Pablo lo planteo como impresion: "me parece que el foco es compartido
+ * entre todas las pestanas, no guarda foco por pestana". Medido en el
+ * codigo, es algo distinto y peor: el foco no se comparte, se DESTRUYE.
+ * renderPizarron reescribe body.innerHTML entero en cada render, asi que
+ * el elemento enfocado deja de existir y el navegador manda el foco al
+ * body. Y el scroll solo se preservaba DENTRO de un mismo render de la
+ * MISMA pestana (pzRestoreScroll sale temprano si cambio activeId), asi
+ * que al volver a una pestana empezaba de cero.
+ *
+ * O sea: no habia estado de UI por pestana, ni de foco ni de scroll. Esto
+ * lo agrega, con una regla: la memoria se guarda contra la pestana que
+ * estaba EN EL DOM, no contra la activa -- en un cambio de pestana esas dos
+ * son distintas, y escribirla contra la activa era el bug de origen. */
+
+/** La clave con la que se vuelve a encontrar un elemento despues de que el
+ *  innerHTML lo destruyo. data-nac-id primero: la doctrina NAC-3 obliga a
+ *  que todo elemento interactivo lleve uno, y es estable entre renders.
+ *  Si no lo tiene, un camino tag+indice dentro de la tarjeta, que no es
+ *  estable si cambia el contenido pero si lo es en un re-render igual. */
+function pzFocusKey(el, root) {
+  if (!el || !root || !root.contains(el)) return null;
+  var nac = el.getAttribute && el.getAttribute('data-nac-id');
+  /* Un id con comilla no se puede meter en un selector de atributo sin
+   * escaparlo, y escapar aca es imposible: este bloque vive dentro de un
+   * template literal de TypeScript, que se come las barras invertidas. Los
+   * data-nac-id son puntos y alfanumericos por doctrina, asi que el caso no
+   * existe -- y si apareciera, cae al camino estructural. */
+  if (nac && nac.indexOf('"') < 0) return 'nac:' + nac;
+  var parts = [];
+  var cur = el;
+  while (cur && cur !== root && cur.parentNode) {
+    var sibs = cur.parentNode.children || [];
+    var idx = 0;
+    for (var i = 0; i < sibs.length; i++) { if (sibs[i] === cur) { idx = i; break; } }
+    parts.unshift(cur.tagName + '[' + idx + ']');
+    cur = cur.parentNode;
+  }
+  return parts.length ? 'path:' + parts.join('>') : null;
+}
+
+/* Sin expresiones regulares y sin una sola barra invertida, a proposito:
+ * este codigo se emite desde un template literal, asi que un \\[ o un \\d
+ * en la fuente llegan al navegador como [ y d -- la primera version de esto
+ * tenia /^(.+)\\[(\\d+)\\]$/ y el panel recibio /^(.+)[(d+)]$/, que casa
+ * cualquier cosa y devolvia el elemento equivocado. El test lo agarro. */
+function pzFindByFocusKey(key, root) {
+  if (!key || !root) return null;
+  if (key.indexOf('nac:') === 0) {
+    try { return root.querySelector('[data-nac-id="' + key.slice(4) + '"]'); } catch (e) { return null; }
+  }
+  if (key.indexOf('path:') !== 0) return null;
+  var parts = key.slice(5).split('>');
+  var cur = root;
+  for (var i = 0; i < parts.length; i++) {
+    var part = parts[i];
+    var open = part.lastIndexOf('[');
+    if (open <= 0 || part.charAt(part.length - 1) !== ']') return null;
+    var tag = part.slice(0, open);
+    var idx = Number(part.slice(open + 1, part.length - 1));
+    if (!cur || !isFinite(idx)) return null;
+    var kid = (cur.children || [])[idx];
+    if (!kid || kid.tagName !== tag) return null;
+    cur = kid;
+  }
+  return cur === root ? null : cur;
+}
+
+/** Lo que el usuario estaba haciendo en la pestana que esta en el DOM. */
+function pzCaptureUiState(body) {
+  if (!body) return;
+  var tabId = state.pizarron.renderedId;
+  if (!tabId) return;
+  var entry = { };
+  var sc = pzScroller(body);
+  if (sc) {
+    entry.top = sc.scrollTop;
+    entry.atBottom = (sc.scrollHeight - sc.scrollTop - sc.clientHeight) <= PZ_STICK_PX;
+  }
+  try {
+    var act = document.activeElement;
+    var key = pzFocusKey(act, body);
+    if (key) {
+      entry.focusKey = key;
+      /* El caret, no solo "el input estaba enfocado": volver al campo con
+       * el cursor al principio es casi tan molesto como perder el foco. */
+      if (typeof act.selectionStart === 'number') {
+        entry.selStart = act.selectionStart;
+        entry.selEnd = act.selectionEnd;
+      }
+      if (typeof act.scrollTop === 'number') entry.innerScroll = act.scrollTop;
+    }
+  } catch (e) { /* sin DOM de foco: nada que guardar */ }
+  if (!state.pizarron.ui) state.pizarron.ui = {};
+  state.pizarron.ui[tabId] = entry;
+}
+
+/** Devolver al usuario donde estaba, en la pestana que se acaba de pintar. */
+function pzRestoreUiState(body) {
+  var tabId = state.pizarron.activeId;
+  if (!body || !tabId || !state.pizarron.ui) return;
+  var entry = state.pizarron.ui[tabId];
+  if (!entry) return;
+  var apply = function () {
+    var sc = pzScroller(body);
+    if (sc && entry.top != null) sc.scrollTop = entry.atBottom ? sc.scrollHeight : entry.top;
+    if (!entry.focusKey) return;
+    var el = pzFindByFocusKey(entry.focusKey, body);
+    if (!el || typeof el.focus !== 'function') return;
+    /* preventScroll: el foco no debe pelearse con el scroll que acabamos
+     * de restaurar dos lineas arriba. */
+    try { el.focus({ preventScroll: true }); } catch (e) { try { el.focus(); } catch (e2) { return; } }
+    if (entry.selStart != null && typeof el.setSelectionRange === 'function') {
+      try { el.setSelectionRange(entry.selStart, entry.selEnd != null ? entry.selEnd : entry.selStart); } catch (e) { /* input sin seleccion */ }
+    }
+    if (entry.innerScroll != null && typeof el.scrollTop === 'number') el.scrollTop = entry.innerScroll;
+  };
+  apply();
+  try { requestAnimationFrame(apply); } catch (e) { /* entorno sin rAF */ }
+}
+
+/** Olvidar la memoria de una pestana cerrada: si no, el mapa crece con
+ *  cada pestana que el usuario abre y cierra durante la sesion. */
+function pzForgetUiState(id) {
+  if (state.pizarron.ui && id in state.pizarron.ui) delete state.pizarron.ui[id];
+}
+
 function renderPizarron() {
   const tabs = $('#pizarron-tabs');
   const body = $('#pizarron-body');
   const empty = $('#pizarron-empty');
   const count = $('#pizarron-count');
   if (!tabs || !body || !count) return;
-  /* Antes de tocar el DOM: donde estaba mirando el usuario. */
+  /* Antes de tocar el DOM: donde estaba mirando el usuario. El snapshot
+   * de scroll intra-render sigue (misma pestana); pzCaptureUiState guarda
+   * ademas foco y caret CONTRA LA PESTANA QUE ESTA EN EL DOM, que es lo que
+   * permite recuperarlos al volver (PND-153). */
   const _pzScroll = pzCaptureScroll(body);
+  pzCaptureUiState(body);
   count.textContent = state.pizarron.items.length + ' ' + (state.pizarron.items.length === 1 ? CONFIG.i18n.tabOne : CONFIG.i18n.tabMany);
   /* Render tabs */
   applySavedTabOrder(); /* PND-137 -- respeta el orden elegido por drag */
@@ -6371,6 +6518,11 @@ function renderPizarron() {
   }
   /* Devolver al usuario donde estaba: pegado al fondo si venia pegado. */
   pzRestoreScroll(body, _pzScroll);
+  /* Y la memoria de ESTA pestana: foco, caret y scroll de la ultima vez que
+   * el usuario estuvo en ella (PND-153). Va despues del scroll intra-render
+   * para que gane el estado propio de la pestana al volver a ella. */
+  state.pizarron.renderedId = state.pizarron.activeId;
+  pzRestoreUiState(body);
 }
 
 /* Selector multi-workflow: persiste el indice elegido por tab id (igual
@@ -6507,6 +6659,21 @@ function renderPendingsView(content) {
     + '<input type="text" class="pz-pnd-q" data-pz-pnd-q spellcheck="false"'
     + '       placeholder="Buscar: id, titulo, archivo, caso de uso..."'
     + '       aria-label="Buscar en la lista" />'
+    /* PND-155: tres criterios, los dos sentidos. "registro" es el orden que
+     * manda el servidor (prioridad), y es el default: elegir orden es una
+     * accion del usuario, no algo que le cambie la lista sin pedirlo. */
+    + '<select class="pz-pnd-sort" data-pz-pnd-sort'
+    + '        data-nac-id="yujin.pending.sort.criterion" data-nac-role="select"'
+    + '        data-nac-action="sort_pendings" aria-label="Ordenar la lista por">'
+    + '  <option value="default">orden del registro</option>'
+    + '  <option value="id">nro de PND</option>'
+    + '  <option value="title">titulo</option>'
+    + '  <option value="date">fecha de ' + (done ? 'cierre' : 'creacion') + '</option>'
+    + '</select>'
+    + '<button type="button" class="pz-pnd-dir" data-pz-pnd-dir'
+    + '        data-nac-id="yujin.pending.sort.direction" data-nac-role="action"'
+    + '        data-nac-action="toggle_sort_direction"'
+    + '        title="Invertir el orden" aria-label="Invertir el orden">&#8597;</button>'
     + '<span class="pz-pnd-hint">click para ver el detalle</span>'
     + '</div>';
   if (!d.items.length) {
@@ -6520,10 +6687,21 @@ function renderPendingsView(content) {
     var meta = done
       ? '<span class="pz-pnd-when">' + escapeHtml(pndFmtDate(it.closed_at)) + '</span>'
         + '<span class="pz-pnd-chip pnd-reason">' + escapeHtml(pndReasonLabel(it.closed_reason)) + '</span>'
+        /* PND-156. Pablo vio "un boton Reporte que hace lo mismo que el
+         * boton doc". Medido: no son botones y no hacen lo mismo -- son dos
+         * indicadores de DOS datos distintos (expediente de implementacion
+         * vs reporte honesto), y parecian el mismo porque compartian la
+         * clase pnd-doc, con lo cual se veian identicos, y porque el unico
+         * elemento clickeable es la FILA entera: apretar sobre cualquiera
+         * de los dos abre el detalle. Hacian lo mismo porque no hacian
+         * nada. Esto es el cambio minimo: cada indicador con su estilo y su
+         * texto propio, sin perder ninguno de los dos datos. Hacerlos
+         * clickeables para que abran su seccion del detalle es una decision
+         * de diseno de Pablo, y queda abierta. */
         + (impl && (impl.functional || impl.use_cases)
-            ? '<span class="pz-pnd-chip pnd-doc" title="tiene expediente de implementacion">doc</span>'
+            ? '<span class="pz-pnd-chip pnd-doc" title="tiene expediente de implementacion: que se puede hacer ahora y con que casos de uso">expediente</span>'
             : '<span class="pz-pnd-chip pnd-nodoc" title="cerrado sin descripcion funcional">sin doc</span>')
-        + (impl && impl.report ? '<span class="pz-pnd-chip pnd-doc" title="reporte honesto: verificado / creido / punto ciego">reporte</span>' : '')
+        + (impl && impl.report ? '<span class="pz-pnd-chip pnd-report" title="tiene reporte honesto: que quedo verificado, que creido y que es punto ciego">reporte</span>' : '')
       /* PND-154 (Pablo 2026-10-20): la tarjeta de un pendiente ABIERTO
        * muestra su fecha de CREACION, como la de Hecho ya mostraba la de
        * cierre. El dato estaba en el registro desde siempre y no se veia,
@@ -6534,7 +6712,17 @@ function renderPendingsView(content) {
         + '<span class="pz-pnd-chip ' + pndPrioClass(it.priority) + '">' + escapeHtml(String(it.priority != null ? it.priority : '-')) + '</span>'
         + '<span class="pz-pnd-chip pnd-cat">' + escapeHtml(pndCatLabel(it.category)) + '</span>'
         + (it.blocker_who ? '<span class="pz-pnd-chip pnd-who">' + escapeHtml(String(it.blocker_who)) + '</span>' : '');
+    /* PND-155: las claves de orden viajan en la fila, como data-pnd-q ya
+     * hace para el buscador, asi que ordenar es reacomodar nodos en el DOM
+     * -- sin request, sin re-render, y sin pelearse con el refresh de 12 s.
+     * El numero va aparte del id a proposito: ordenar "PND-170" como texto
+     * pone PND-10 antes de PND-9. */
+    var pndNum = (function () { var m = /(\d+)\s*$/.exec(id); return m ? Number(m[1]) : -1; })();
+    var pndTs = Number(done ? (it.closed_at || 0) : (it.created_at || 0)) || 0;
     return '<button type="button" class="pz-pnd-row" data-pz-pnd-row data-pnd-id="' + escapeHtml(id) + '"'
+      + ' data-pnd-num="' + pndNum + '"'
+      + ' data-pnd-ts="' + pndTs + '"'
+      + ' data-pnd-title="' + escapeHtml(String((it && it.title) || '')) + '"'
       + ' data-pnd-q="' + escapeHtml(pendingSearchText(it)) + '"'
       + ' data-nac-id="yujin.pending.' + escapeHtml(id) + '.open"'
       + ' data-nac-role="action" data-nac-action="open_pending_detail">'
@@ -6704,6 +6892,61 @@ function pendingDetailMd(it, done) {
   return L.join('\\n');
 }
 
+/* ---- PND-155: orden de la lista de Pendientes / Hecho ----
+ *
+ * Tres criterios y los dos sentidos, con dos cuidados que el pedido nombra
+ * explicitamente: el nro de PND se ordena NUMERICO (PND-9 antes de PND-10;
+ * como texto sale al revas) y el titulo con localeCompare en el idioma
+ * configurado, no byte a byte.
+ *
+ * Y uno que el pedido tambien nombra: la eleccion se guarda POR PESTANA
+ * (Pendientes y Hecho son dos listas distintas y cada una tiene su orden
+ * natural), no en una variable global -- que es el agujero de PND-153. */
+function pndSortKey(mode) {
+  var slug = (CONFIG && (CONFIG.projectSlug || CONFIG.projectName)) || 'default';
+  return 'yf_pnd_sort_' + slug + '_' + (mode || 'open');
+}
+
+function pndReadSortPref(mode) {
+  try {
+    var raw = localStorage.getItem(pndSortKey(mode));
+    if (raw) {
+      var p = JSON.parse(raw);
+      if (p && typeof p.by === 'string') return { by: p.by, dir: p.dir === 'desc' ? 'desc' : 'asc' };
+    }
+  } catch (e) { /* sin localStorage: el default alcanza */ }
+  return { by: 'default', dir: 'asc' };
+}
+
+function pndWriteSortPref(mode, pref) {
+  try { localStorage.setItem(pndSortKey(mode), JSON.stringify(pref)); } catch (e) { /* no persiste, no importa */ }
+}
+
+/** Reordenar las filas que ya estan en el DOM. rows es el orden ORIGINAL
+ *  del registro, que es lo que permite volver a 'default' sin recargar. */
+function pndApplySort(list, rows, pref) {
+  if (!list) return;
+  var arr = [];
+  for (var i = 0; i < rows.length; i++) arr.push(rows[i]);
+  if (pref.by !== 'default') {
+    var lang = (CONFIG && CONFIG.lang) || undefined;
+    var cmp = function (a, b) {
+      if (pref.by === 'id') return Number(a.getAttribute('data-pnd-num')) - Number(b.getAttribute('data-pnd-num'));
+      if (pref.by === 'date') return Number(a.getAttribute('data-pnd-ts')) - Number(b.getAttribute('data-pnd-ts'));
+      var ta = a.getAttribute('data-pnd-title') || '';
+      var tb = b.getAttribute('data-pnd-title') || '';
+      try { return ta.localeCompare(tb, lang); } catch (e) { return ta < tb ? -1 : (ta > tb ? 1 : 0); }
+    };
+    arr.sort(cmp);
+    if (pref.dir === 'desc') arr.reverse();
+  } else if (pref.dir === 'desc') {
+    arr.reverse();
+  }
+  /* appendChild mueve el nodo: no se clona nada, asi que los handlers y el
+   * estado de display del filtro sobreviven al reorden. */
+  for (var j = 0; j < arr.length; j++) list.appendChild(arr[j]);
+}
+
 function initPendingsTab(it) {
   var body = document.querySelector('[data-nac-id="yujin.pizarron.item.' + it.id + '.body"]');
   if (!body) return;
@@ -6740,6 +6983,33 @@ function initPendingsTab(it) {
       if (ev.key === 'Escape') { q.value = ''; applyFilter(); }
     });
   }
+
+  /* PND-155: el orden. Se aplica al abrir la pestana (con lo que el usuario
+   * eligio la ultima vez) y en cada cambio del control. */
+  var sortSel = body.querySelector('[data-pz-pnd-sort]');
+  var dirBtn = body.querySelector('[data-pz-pnd-dir]');
+  var list = body.querySelector('.pz-pnd-list');
+  if (sortSel && dirBtn && list) {
+    var mode = d.mode === 'done' ? 'done' : 'open';
+    var pref = pndReadSortPref(mode);
+    var paint = function () {
+      sortSel.value = pref.by;
+      dirBtn.textContent = pref.dir === 'desc' ? '↓' : '↑';
+      dirBtn.setAttribute('title', pref.dir === 'desc' ? 'Orden descendente (click para invertir)' : 'Orden ascendente (click para invertir)');
+      pndApplySort(list, rows, pref);
+    };
+    sortSel.addEventListener('change', function () {
+      pref = { by: String(sortSel.value || 'default'), dir: pref.dir };
+      pndWriteSortPref(mode, pref);
+      paint();
+    });
+    dirBtn.addEventListener('click', function () {
+      pref = { by: pref.by, dir: pref.dir === 'desc' ? 'asc' : 'desc' };
+      pndWriteSortPref(mode, pref);
+      paint();
+    });
+    paint();
+  }
   for (var k = 0; k < rows.length; k++) {
     rows[k].addEventListener('click', function () {
       var pid = this.getAttribute('data-pnd-id');
@@ -7449,6 +7719,7 @@ function autoCloseCodingTab() {
   if (idx < 0) return;
   if (yfCoding.raf != null) { try { cancelAnimationFrame(yfCoding.raf); } catch (e) { /* */ } yfCoding.raf = null; }
   state.pizarron.items.splice(idx, 1);
+  pzForgetUiState(CODING_TAB_ID); /* PND-153: no acumular memoria de pestanas cerradas */
   if (state.pizarron.activeId === CODING_TAB_ID) {
     const next = state.pizarron.items[state.pizarron.items.length - 1];
     state.pizarron.activeId = next ? next.id : null;