@saulwade/swl-ses 2.2.4 → 2.3.0

package/hooks/captura-acciones-session.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Hook: captura-acciones-session.js
+ * Tipo: SessionStart
+ *
+ * Al abrir sesión en un repo git con `.planning/`, contrasta el git real contra
+ * los índices que pobló `captura-acciones-post.js` (PostToolUse) para detectar
+ * señales de ACCIÓN del usuario ocurridas fuera de sesión (Fase 17):
+ *   - revert/reset de commits del agente (SHA registrado ausente del historial),
+ *   - edición neta de archivos que el agente escribió (hash en disco ≠ registrado),
+ *   - rechazo de plan (PLAN en borrador sin lock G1 con fase cerrada),
+ *   - override de veredicto (VERIFICACION no-aprobatoria — caso determinista).
+ *
+ * Encola en el mismo `feedback-queue.jsonl` con `tipo:"accion"`. A diferencia
+ * del briefing (Fase 12), este hook NO emite `additionalContext`: solo persiste
+ * señales (alcance Fase 17 = capturar + telemetría). Zero-deps salvo la lib.
+ * Opt-out SWL_CAPTURAR_FEEDBACK=0. Skip si no hay repo git (REQ-17-11). Exit 0.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execFileSync } = require('child_process');
+
+// Require dual: el instalador aplana `hooks/lib/X.js → <hooks>/X.js`. (Idioma
+// compartido; no se extrae a lib por la paradoja de bootstrap del aplanado.)
+function requireDual(nombre) {
+  try {
+    return require(`./lib/${nombre}`);
+  } catch (e1) {
+    if (e1 && e1.code !== 'MODULE_NOT_FOUND') throw e1;
+    return require(`./${nombre}`);
+  }
+}
+
+let lib;
+try {
+  lib = requireDual('captura-acciones');
+} catch (_) {
+  lib = null;
+}
+
+const PREVIEW_RAW = 4096; // ver nota en captura-acciones-post.js (no derrotar PEM)
+const SHA_PREFIX_LEN = 12; // < 32 chars: no dispara PATRONES_REDACT[0] del sanitizador
+const MAX_LOG = 2000; // horizonte de git log; el agente no registra commits previos a ~5 años
+
+function esRepoGit(baseDir) {
+  try {
+    execFileSync('git', ['rev-parse', '--is-inside-work-tree'], { cwd: baseDir, stdio: 'ignore' });
+    return true;
+  } catch (_) {
+    return false;
+  }
+}
+
+function historialShas(baseDir) {
+  try {
+    return execFileSync('git', ['log', `--max-count=${MAX_LOG}`, '--format=%H'], { cwd: baseDir, encoding: 'utf8' })
+      .split(/\r?\n/)
+      .filter(Boolean);
+  } catch (_) {
+    return [];
+  }
+}
+
+/** (1) Revert/reset de commits del agente — REQ-17-01. */
+function _encolarReverts(baseDir) {
+  const reverts = lib.detectarRevert(lib.leerCommitsAgente(baseDir), historialShas(baseDir));
+  for (const sha of reverts) {
+    lib.encolarAccion(baseDir, { accion: 'revert', evidencia: `commit ${sha.slice(0, SHA_PREFIX_LEN)} ausente del historial actual` });
+  }
+  return reverts.length;
+}
+
+/** (2) Edición neta de archivos escritos por el agente — REQ-17-02. */
+function _encolarEdicionesNetas(baseDir) {
+  const indice = lib.leerIndiceWrites(baseDir);
+  const hashActual = {};
+  for (const rel of Object.keys(indice)) {
+    try {
+      hashActual[rel] = lib.hashContenido(fs.readFileSync(path.resolve(baseDir, rel), 'utf8'));
+    } catch (_) {
+      /* archivo borrado/ilegible → detectarEdicionNeta lo ignora */
+    }
+  }
+  const netas = lib.detectarEdicionNeta(indice, hashActual);
+  for (const rel of netas) {
+    let ev = '';
+    try {
+      ev = fs.readFileSync(path.resolve(baseDir, rel), 'utf8').slice(0, PREVIEW_RAW);
+    } catch (_) {
+      /* sin evidencia */
+    }
+    lib.encolarAccion(baseDir, { accion: 'edicion-manual', archivo: rel, evidencia: ev });
+  }
+  return netas.length;
+}
+
+/** (3) Rechazo de plan — REQ-17-04. */
+function _encolarPlanesRechazados(baseDir) {
+  const señales = lib.detectarPlanRechazado(baseDir);
+  for (const s of señales) {
+    lib.encolarAccion(baseDir, { accion: 'plan-rechazado', archivo: s.archivo, evidencia: `plan de fase ${s.fase} en borrador sin lock G1` });
+  }
+  return señales.length;
+}
+
+/** (4) Override de veredicto — REQ-17-05 (caso determinista). */
+function _encolarVeredictosOverride(baseDir) {
+  const señales = lib.detectarVeredictoOverride(baseDir);
+  for (const s of señales) {
+    lib.encolarAccion(baseDir, { accion: 'veredicto-override', archivo: s.archivo, evidencia: `veredicto ${s.veredicto} en ${s.archivo}` });
+  }
+  return señales.length;
+}
+
+/**
+ * Inspecciona el repo y encola las señales de acción detectadas.
+ * @param {string} baseDir raíz del proyecto.
+ * @returns {{encolados:number, skip?:string}}
+ */
+function inspeccionar(baseDir) {
+  if (process.env.SWL_CAPTURAR_FEEDBACK === '0') return { skip: 'opt-out', encolados: 0 };
+  if (!lib) return { skip: 'no-lib', encolados: 0 };
+  if (!esRepoGit(baseDir)) return { skip: 'no-git', encolados: 0 }; // REQ-17-11
+  if (!fs.existsSync(path.join(baseDir, '.planning'))) return { skip: 'no-planning', encolados: 0 };
+
+  let n = 0;
+  try {
+    n += _encolarReverts(baseDir);
+    n += _encolarEdicionesNetas(baseDir);
+    n += _encolarPlanesRechazados(baseDir);
+    n += _encolarVeredictosOverride(baseDir);
+  } catch (_) {
+    /* nunca bloquear */
+  }
+  return { encolados: n };
+}
+
+// Listeners de stdin SOLO en modo CLI.
+if (require.main === module) {
+  let inputRaw = '';
+  process.stdin.on('data', (c) => { inputRaw += c; });
+  process.stdin.on('end', () => {
+    try {
+      inspeccionar(process.cwd());
+    } catch (_) {
+      /* silencioso: el hook nunca bloquea la sesión */
+    }
+    // No emite additionalContext: solo persiste señales (alcance Fase 17).
+  });
+} else {
+  module.exports = { inspeccionar, esRepoGit, historialShas };
+}