@saulwade/swl-ses 2.2.3 → 2.3.0

package/schemas/instinct.schema.json

@@ -1,152 +1,161 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://swl-ses.dev/schemas/instinct.json",
-  "$schemaVersion": "1.0.0",
-  "title": "SWL Instinct",
-  "description": "Schema de validacion para instintos YAML del sistema SWL",
-  "type": "object",
-  "required": [
-    "version",
-    "instintos"
-  ],
-  "properties": {
-    "version": {
-      "type": "string"
-    },
-    "generado": {
-      "type": "string"
-    },
-    "total_instintos": {
-      "type": "integer",
-      "minimum": 0
-    },
-    "instintos": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": [
-          "id",
-          "pattern",
-          "confidence",
-          "scope",
-          "status"
-        ],
-        "properties": {
-          "id": {
-            "type": "string",
-            "pattern": "^inst-\\d{3,}$",
-            "description": "Identificador unico secuencial"
-          },
-          "pattern": {
-            "type": "string",
-            "minLength": 10,
-            "maxLength": 500,
-            "description": "Descripcion del patron observado"
-          },
-          "confidence": {
-            "type": "number",
-            "minimum": 0,
-            "maximum": 1,
-            "description": "Nivel de confianza (0.0 bajo, 1.0 certeza)"
-          },
-          "scope": {
-            "type": "string",
-            "enum": [
-              "project",
-              "domain",
-              "global"
-            ],
-            "description": "Alcance del instinto"
-          },
-          "source": {
-            "type": "string",
-            "description": "ID de sesion o 'manual'"
-          },
-          "evidence_count": {
-            "type": "integer",
-            "minimum": 0,
-            "description": "Veces que el patron ha sido observado"
-          },
-          "last_validated": {
-            "type": "string",
-            "description": "Fecha de ultima validacion (YYYY-MM-DD)"
-          },
-          "contradictions": {
-            "type": "integer",
-            "minimum": 0,
-            "description": "Veces que el patron ha sido contradicho"
-          },
-          "status": {
-            "type": "string",
-            "enum": [
-              "active",
-              "degraded",
-              "promoted",
-              "archived"
-            ],
-            "description": "Estado actual del instinto"
-          },
-          "tags": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Etiquetas para clasificacion"
-          },
-          "created_at": {
-            "type": "string",
-            "description": "Fecha de creacion (YYYY-MM-DD)"
-          },
-          "decay_half_life_days": {
-            "type": "integer",
-            "minimum": 1,
-            "default": 90,
-            "description": "Dias para que la confianza decaiga a la mitad. 90 dias por defecto."
-          },
-          "helpful_count": {
-            "type": "integer",
-            "minimum": 0,
-            "default": 0,
-            "description": "Numero de veces que el instinto fue util en una sesion"
-          },
-          "harmful_count": {
-            "type": "integer",
-            "minimum": 0,
-            "default": 0,
-            "description": "Numero de veces que el instinto guio a un resultado incorrecto"
-          },
-          "last_validated_at": {
-            "type": "string",
-            "description": "Timestamp ISO o YYYY-MM-DD de la ultima validacion via feedback (sustituye a last_validated en sistemas con scoring)"
-          },
-          "source_sessions": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "uniqueItems": true,
-            "description": "IDs de sesiones que contribuyeron a este instinto (para priorizacion por evidencia multiple)"
-          },
-          "source_agents": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "uniqueItems": true,
-            "description": "Nombres de agentes que validaron este instinto (cross-agent enrichment)"
-          },
-          "maturity": {
-            "type": "string",
-            "enum": [
-              "candidate",
-              "established",
-              "proven",
-              "deprecated"
-            ],
-            "description": "Estado de maduracion derivado (computado, no persistente). Ver scripts/lib/scoring-instintos.js"
-          }
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://swl-ses.dev/schemas/instinct.json",
+  "$schemaVersion": "1.0.0",
+  "title": "SWL Instinct",
+  "description": "Schema de validacion para instintos YAML del sistema SWL",
+  "type": "object",
+  "required": [
+    "version",
+    "instintos"
+  ],
+  "properties": {
+    "version": {
+      "type": "string"
+    },
+    "generado": {
+      "type": "string"
+    },
+    "total_instintos": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "instintos": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "pattern",
+          "confidence",
+          "scope",
+          "status"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^inst-\\d{3,}$",
+            "description": "Identificador unico secuencial"
+          },
+          "pattern": {
+            "type": "string",
+            "minLength": 10,
+            "maxLength": 500,
+            "description": "Descripcion del patron observado"
+          },
+          "confidence": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Nivel de confianza (0.0 bajo, 1.0 certeza)"
+          },
+          "scope": {
+            "type": "string",
+            "enum": [
+              "project",
+              "domain",
+              "global"
+            ],
+            "description": "Alcance del instinto"
+          },
+          "source": {
+            "type": "string",
+            "description": "ID de sesion o 'manual'"
+          },
+          "evidence_count": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Veces que el patron ha sido observado"
+          },
+          "last_validated": {
+            "type": "string",
+            "description": "Fecha de ultima validacion (YYYY-MM-DD)"
+          },
+          "contradictions": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Veces que el patron ha sido contradicho"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "active",
+              "degraded",
+              "promoted",
+              "archived"
+            ],
+            "description": "Estado actual del instinto"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Etiquetas para clasificacion"
+          },
+          "created_at": {
+            "type": "string",
+            "description": "Fecha de creacion (YYYY-MM-DD)"
+          },
+          "decay_half_life_days": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 90,
+            "description": "Dias para que la confianza decaiga a la mitad. 90 dias por defecto."
+          },
+          "helpful_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0,
+            "description": "Numero de veces que el instinto fue util en una sesion"
+          },
+          "harmful_count": {
+            "type": "integer",
+            "minimum": 0,
+            "default": 0,
+            "description": "Numero de veces que el instinto guio a un resultado incorrecto"
+          },
+          "last_validated_at": {
+            "type": "string",
+            "description": "Timestamp ISO o YYYY-MM-DD de la ultima validacion via feedback (sustituye a last_validated en sistemas con scoring)"
+          },
+          "source_sessions": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "uniqueItems": true,
+            "description": "IDs de sesiones que contribuyeron a este instinto (para priorizacion por evidencia multiple)"
+          },
+          "source_agents": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "uniqueItems": true,
+            "description": "Nombres de agentes que validaron este instinto (cross-agent enrichment)"
+          },
+          "maturity": {
+            "type": "string",
+            "enum": [
+              "candidate",
+              "established",
+              "proven",
+              "deprecated"
+            ],
+            "description": "Estado de maduracion derivado (computado, no persistente). Ver scripts/lib/scoring-instintos.js"
+          },
+          "tipo_memoria": {
+            "type": "string",
+            "enum": [
+              "semantic",
+              "episodic",
+              "procedural"
+            ],
+            "description": "Eje cognitivo de memoria (ORTOGONAL al canal de almacenamiento): semantic=hechos/decisiones, episodic=experiencia pasada de una sesion, procedural=como manejar un caso. Opcional y backward-compatible: instintos sin el campo siguen validos. Ver reglas/memoria-consolidada.md."
+          }
+        }
+      }
+    }
+  }
+}

package/scripts/bootstrap-instintos.js

@@ -49,15 +49,31 @@ const flags = {
 // Config de secciones → confidence/tags
 // ---------------------------------------------------------------------------
 
+// tipo_memoria (eje cognitivo, Fase 19): patron/anti-patron = "cómo hacer / qué
+// evitar" → procedural; decisión/gotcha/regla = hechos → semantic. episodic NO se
+// infiere del bootstrap (nace de registros de sesión, no de APRENDIZAJES).
 const SECCIONES = [
-  { regex: /anti[-\s]?patrones?/i,                  confidence: 0.7, tags: ['anti-patron'] },
-  { regex: /patrones?\s+exitosos?/i,                confidence: 0.6, tags: ['patron'] },
-  { regex: /decisiones?\s+de\s+arquitectura/i,      confidence: 0.8, tags: ['decision', 'arquitectura'] },
-  { regex: /gotchas?/i,                             confidence: 0.6, tags: ['gotcha'] },
-  { regex: /patrones?/i,                            confidence: 0.6, tags: ['patron'] },
-  { regex: /reglas?\s+de\s+proyecto/i,              confidence: 0.8, tags: ['regla-proyecto'] },
+  { regex: /anti[-\s]?patrones?/i,                  confidence: 0.7, tags: ['anti-patron'], tipoMemoria: 'procedural' },
+  { regex: /patrones?\s+exitosos?/i,                confidence: 0.6, tags: ['patron'], tipoMemoria: 'procedural' },
+  { regex: /decisiones?\s+de\s+arquitectura/i,      confidence: 0.8, tags: ['decision', 'arquitectura'], tipoMemoria: 'semantic' },
+  { regex: /gotchas?/i,                             confidence: 0.6, tags: ['gotcha'], tipoMemoria: 'semantic' },
+  { regex: /patrones?/i,                            confidence: 0.6, tags: ['patron'], tipoMemoria: 'procedural' },
+  { regex: /reglas?\s+de\s+proyecto/i,              confidence: 0.8, tags: ['regla-proyecto'], tipoMemoria: 'semantic' },
 ];
 
+/**
+ * Infiere el eje cognitivo de memoria de un instinto por su sección de origen.
+ * Heurístico declarado (no autoritativo): default 'semantic' para hechos.
+ * @param {string} seccion
+ * @returns {'semantic'|'episodic'|'procedural'}
+ */
+function inferirTipoMemoria(seccion) {
+  for (const s of SECCIONES) {
+    if (s.regex.test(seccion || '')) return s.tipoMemoria;
+  }
+  return 'semantic';
+}
+
 function detectarConfidence(seccion) {
   for (const s of SECCIONES) {
     if (s.regex.test(seccion)) return { confidence: s.confidence, tags: [...s.tags] };
@@ -163,6 +179,7 @@ function generarInstintos(entradas) {
       tags,
       created_at: hoy,
       seccion_origen: e.seccion,
+      tipo_memoria: inferirTipoMemoria(e.seccion),
       decay_half_life_days: 90,
       helpful_count: 0,
       harmful_count: 0,
@@ -200,6 +217,7 @@ instintos:
       `    tags: [${i.tags.map(t => `"${t}"`).join(', ')}]`,
       `    created_at: "${i.created_at}"`,
       `    seccion_origen: ${escapeYaml(i.seccion_origen)}`,
+      `    tipo_memoria: ${i.tipo_memoria}`,
       `    decay_half_life_days: ${i.decay_half_life_days}`,
       `    helpful_count: ${i.helpful_count}`,
       `    harmful_count: ${i.harmful_count}`,
@@ -266,4 +284,4 @@ function main() {
 
 if (require.main === module) main();
 
-module.exports = { parsearAprendizajes, generarInstintos, detectarConfidence, main };
+module.exports = { parsearAprendizajes, generarInstintos, detectarConfidence, inferirTipoMemoria, main };

package/scripts/lib/claude-sessions.js

@@ -27,6 +27,7 @@ const TOLERANCIA_FUTURO_MS = 60 * 1000;
 
 // Tabla de precios por modelo (USD por token)
 const PRECIOS_MODELO = {
+  'claude-opus-4-8': { entrada: 15 / 1_000_000, salida: 75 / 1_000_000 },
   'claude-opus-4-7': { entrada: 15 / 1_000_000, salida: 75 / 1_000_000 },
   'claude-opus-4-6': { entrada: 15 / 1_000_000, salida: 75 / 1_000_000 },
   'claude-sonnet-4-6': { entrada: 3 / 1_000_000, salida: 15 / 1_000_000 },

package/scripts/lib/gitignore-manifest.js

@@ -11,8 +11,9 @@
  * Todo lo que instala o genera en runtime se ignora en git (framework, hooks,
  * métricas, sesiones, aprendizajes, trazas, instintos).
  *
- * Solo se commitean: CLAUDE.md, .claude/settings.json, y las plantillas de
- * .planning/ que el equipo edita (PROYECTO.md, REQUISITOS.md, etc.).
+ * Solo se commitean: CLAUDE.md, .claude/settings.json, instintos/proyecto.yaml
+ * (memoria del proyecto), y las plantillas de .planning/ que el equipo edita
+ * (PROYECTO.md, REQUISITOS.md, etc.).
  */
 
 const fs = require("fs");
@@ -54,11 +55,8 @@ const ENTRADAS_BASE = [
   ".swl-ses",
 
   // ── Runtime: archivos generados automáticamente por hooks ──────────
-  // Aprendizajes, métricas, compactación (extraccion-aprendizajes, tracking-costos, context-compressor)
-  ".planning/APRENDIZAJES.md",
+  // Métricas (tracking-costos)
   ".planning/METRICAS.md",
-  ".planning/COMPACTACION.md",
-  ".planning/REPORTE-GRAFO.md",
 
   // Audit trail (audit-trail.js, merkle-audit.js)
   ".planning/*.jsonl",
@@ -88,8 +86,13 @@ const ENTRADAS_BASE = [
   "!.planning/locks/*PLAN.md.lock",
   ".planning/user-profile/",
 
-  // Instintos modificados automáticamente por hooks (degradacion-instintos.js)
-  "instintos/",
+  // Instintos: global/perfil-usuario/prompt-appendices/autonomia son framework +
+  // runtime + personal (no se commitean). proyecto.yaml es memoria del proyecto
+  // (hermano YAML de APRENDIZAJES.md, memoria-consolidada § canal 3) → versionable.
+  // Patrón dir/* + negación: git no re-incluye archivos bajo un dir ignorado
+  // (mismo gotcha documentado en locks/ arriba), por eso se ignora el contenido.
+  "instintos/*",
+  "!instintos/proyecto.yaml",
 
   // Base de datos de uso
   "usage.db",
@@ -305,8 +308,16 @@ function limpiarTracked(cwd, extras = []) {
     return resultado; // No es repo git, nada que hacer
   }
 
-  // Obtener todas las entradas gitignore de swl-ses (directorios y archivos)
-  const entradas = [...new Set([...ENTRADAS_BASE, ...extras])];
+  // Obtener todas las entradas gitignore de swl-ses (directorios y archivos).
+  // Las negaciones (!...) marcan archivos versionables que NUNCA se des-trackean
+  // (instintos/proyecto.yaml, plan-locks G1 *PLAN.md.lock). git ls-files NO honra
+  // las negaciones del .gitignore, así que se excluyen explícitamente de la lista
+  // a limpiar — de lo contrario el glob padre (instintos/*, locks/*) las arrastraría.
+  const todas = [...new Set([...ENTRADAS_BASE, ...extras])];
+  const negaciones = todas
+    .filter((e) => e.startsWith("!"))
+    .map((e) => patronAGlobRegex(e.slice(1)));
+  const entradas = todas.filter((e) => !e.startsWith("!"));
 
   for (const entrada of entradas) {
     try {
@@ -322,7 +333,12 @@ function limpiarTracked(cwd, extras = []) {
 
       if (!archivosTracked) continue;
 
-      const lista = archivosTracked.split("\n").filter(Boolean);
+      const lista = archivosTracked
+        .split("\n")
+        .filter(Boolean)
+        // Preservar archivos versionables cubiertos por una negación del gitignore
+        // (ej. instintos/proyecto.yaml frente al glob instintos/*).
+        .filter((archivo) => !negaciones.some((re) => re.test(archivo)));
       if (lista.length === 0) continue;
 
       // Quitar del índice uno por uno (--cached = solo del índice, no del disco)
@@ -353,6 +369,23 @@ function escapeRegex(str) {
   return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
+/**
+ * Convierte un patrón estilo gitignore (sin el '!' inicial) a una RegExp anclada
+ * para matchear rutas que devuelve `git ls-files` (siempre con '/' como separador).
+ * `*` no cruza '/' (semántica gitignore). Una entrada de directorio matchea también
+ * su contenido. Se usa en limpiarTracked para excluir archivos negados del untrack.
+ *
+ * @param {string} patron  Ej. "instintos/proyecto.yaml", ".planning/locks/*PLAN.md.lock"
+ * @returns {RegExp}
+ */
+function patronAGlobRegex(patron) {
+  const cuerpo = patron
+    .replace(/\/$/, "")
+    .replace(/[.+?^${}()|[\]\\]/g, "\\$&")
+    .replace(/\*/g, "[^/]*");
+  return new RegExp("^" + cuerpo + "(?:/.*)?$");
+}
+
 module.exports = {
   actualizarGitignore,
   entradasParaRuntime,

package/scripts/lib/skill-metrics.js

@@ -199,11 +199,38 @@ function resumen(cwd) {
   };
 }
 
+const MS_DIA = 86400000;
+
+/**
+ * Skills "fríos": tuvieron uso previo pero su último uso es más antiguo que `dias`.
+ * Los skills NUNCA usados NO aparecen (obtenerMetricas solo incluye skills con ≥1
+ * entrada) — eso es bloat, dominio distinto a staleness (Fase 20 / análisis self-learning).
+ *
+ * @param {string} cwd
+ * @param {Date}   [hoy=new Date()]
+ * @param {{dias?: number}} [opts]  umbral en días (default SWL_SKILL_STALE_DIAS o 90)
+ * @returns {Array<{skill: string, ultimoUso: string, diasInactivo: number}>}
+ *          ordenado por diasInactivo descendente.
+ */
+function skillsStale(cwd, hoy = new Date(), opts = {}) {
+  const dias = Number(opts.dias) || Number(process.env.SWL_SKILL_STALE_DIAS) || 90;
+  const ahora = (hoy instanceof Date ? hoy : new Date(hoy)).getTime();
+  const out = [];
+  for (const m of obtenerMetricas(cwd)) {
+    if (!m.ultimoUso) continue;
+    const t = new Date(m.ultimoUso).getTime();
+    if (Number.isNaN(t)) continue;
+    const diasInactivo = Math.floor((ahora - t) / MS_DIA);
+    if (diasInactivo > dias) out.push({ skill: m.skill, ultimoUso: m.ultimoUso, diasInactivo });
+  }
+  return out.sort((a, b) => b.diasInactivo - a.diasInactivo);
+}
+
 // ---------------------------------------------------------------------------
 // Exports
 // ---------------------------------------------------------------------------
 
-module.exports = { registrarUso, obtenerMetricas, topFallidos, topLentos, resumen };
+module.exports = { registrarUso, obtenerMetricas, topFallidos, topLentos, resumen, skillsStale };
 
 // ---------------------------------------------------------------------------
 // CLI dual-use
@@ -218,6 +245,19 @@ if (require.main === module) {
     process.exit(0);
   }
 
+  if (cmd === '--stale' || cmd === 'stale') {
+    const stale = skillsStale(cwd);
+    if (stale.length === 0) {
+      process.stdout.write('Sin skills fríos (todos con uso reciente o sin métricas).\n');
+    } else {
+      process.stdout.write('\nSkills fríos (uso previo, inactivos > umbral):\n');
+      for (const s of stale) {
+        process.stdout.write(`  ${s.skill.padEnd(36)} ${String(s.diasInactivo).padStart(4)}d sin uso  → /swl:evaluar-skill ${s.skill}\n`);
+      }
+    }
+    process.exit(0);
+  }
+
   // Modo resumen (default)
   const r = resumen(cwd);
   process.stdout.write('\nMétricas de habilidades SWL\n');

package/scripts/lib/tool-cost-analyzer.js

@@ -23,6 +23,7 @@ const DB_PATH = path.join(os.homedir(), '.claude', 'usage.db');
 
 // Precios estimados por 1M tokens (USD) — actualizados a 2026-04-17
 const PRECIOS = {
+  'claude-opus-4-8':    { input: 15.00, output: 75.00, cache_read: 1.50,  cache_creation: 18.75 },
   'claude-opus-4-7':    { input: 15.00, output: 75.00, cache_read: 1.50,  cache_creation: 18.75 },
   'claude-opus-4-6':    { input: 15.00, output: 75.00, cache_read: 1.50,  cache_creation: 18.75 },
   'claude-sonnet-4-6':  { input:  3.00, output: 15.00, cache_read: 0.30,  cache_creation:  3.75 },