@saulwade/swl-ses 1.1.4 → 1.2.1

package/scripts/lib/benchmark-metrics.js

@@ -0,0 +1,160 @@
+'use strict';
+
+/**
+ * benchmark-metrics.js — Métricas de retrieval para benchmark de memoria SWL.
+ *
+ * Patrón adoptado de `temp/agentmemory-main/benchmark/longmemeval-bench.ts`.
+ * Funciones puras zero-deps. Adaptado a IDs SWL (aprendizaje, sesion,
+ * instinto) en lugar de session_id de agentmemory.
+ *
+ * Métricas:
+ *   - recallAt(k): 1.0 si al menos un gold ID está en los top-k, sino 0.0
+ *   - precisionAt(k): proporción de top-k que son gold
+ *   - mrr: Mean Reciprocal Rank (1/rank del primer gold encontrado)
+ *   - ndcgAt(k): Normalized Discounted Cumulative Gain
+ *
+ * @module scripts/lib/benchmark-metrics
+ */
+
+// ── helpers ───────────────────────────────────────────────────────────────────
+
+function asSet(arr) {
+  return new Set(Array.isArray(arr) ? arr : []);
+}
+
+// ── métricas individuales ─────────────────────────────────────────────────────
+
+/**
+ * Recall @ k: 1.0 si ALGÚN id gold está en los primeros k retrieved.
+ *
+ * @param {string[]} retrievedIds - IDs ordenados (mejor primero).
+ * @param {string[]} goldIds - IDs correctos esperados.
+ * @param {number} k
+ * @returns {number} 0 o 1
+ */
+function recallAt(retrievedIds, goldIds, k) {
+  if (!Array.isArray(retrievedIds) || !Array.isArray(goldIds)) return 0;
+  const topK = new Set(retrievedIds.slice(0, k));
+  return goldIds.some(g => topK.has(g)) ? 1.0 : 0.0;
+}
+
+/**
+ * Precision @ k: proporción de los primeros k retrieved que son gold.
+ *
+ * @param {string[]} retrievedIds
+ * @param {string[]} goldIds
+ * @param {number} k
+ * @returns {number} en [0, 1]
+ */
+function precisionAt(retrievedIds, goldIds, k) {
+  if (!Array.isArray(retrievedIds) || !Array.isArray(goldIds) || k <= 0) return 0;
+  const goldSet = asSet(goldIds);
+  const topK = retrievedIds.slice(0, k);
+  if (topK.length === 0) return 0;
+  const hits = topK.filter(id => goldSet.has(id)).length;
+  return hits / topK.length;
+}
+
+/**
+ * Mean Reciprocal Rank: 1/rank del primer gold encontrado, o 0 si ninguno.
+ *
+ * @param {string[]} retrievedIds
+ * @param {string[]} goldIds
+ * @returns {number} en [0, 1]
+ */
+function mrr(retrievedIds, goldIds) {
+  if (!Array.isArray(retrievedIds) || !Array.isArray(goldIds)) return 0;
+  const goldSet = asSet(goldIds);
+  for (let i = 0; i < retrievedIds.length; i++) {
+    if (goldSet.has(retrievedIds[i])) {
+      return 1 / (i + 1);
+    }
+  }
+  return 0;
+}
+
+function dcg(relevancias, k) {
+  let suma = 0;
+  for (let i = 0; i < Math.min(k, relevancias.length); i++) {
+    suma += (relevancias[i] ? 1 : 0) / Math.log2(i + 2);
+  }
+  return suma;
+}
+
+/**
+ * Normalized Discounted Cumulative Gain @ k.
+ *
+ * @param {string[]} retrievedIds
+ * @param {string[]} goldIds
+ * @param {number} k
+ * @returns {number} en [0, 1]
+ */
+function ndcgAt(retrievedIds, goldIds, k) {
+  if (!Array.isArray(retrievedIds) || !Array.isArray(goldIds) || k <= 0) return 0;
+  const goldSet = asSet(goldIds);
+  const rels = retrievedIds.slice(0, k).map(id => goldSet.has(id));
+  const idealRels = Array.from({ length: Math.min(k, goldSet.size) }, () => true);
+  const idealDCG = dcg(idealRels, k);
+  if (idealDCG === 0) return 0;
+  return dcg(rels, k) / idealDCG;
+}
+
+// ── agregados ─────────────────────────────────────────────────────────────────
+
+/**
+ * Calcula el conjunto completo de métricas para una query.
+ *
+ * @param {string[]} retrievedIds
+ * @param {string[]} goldIds
+ * @returns {{ recall_at_5, recall_at_10, recall_at_20, mrr, ndcg_at_10, precision_at_5 }}
+ */
+function calcularMetricas(retrievedIds, goldIds) {
+  return {
+    recall_at_5:    recallAt(retrievedIds, goldIds, 5),
+    recall_at_10:   recallAt(retrievedIds, goldIds, 10),
+    recall_at_20:   recallAt(retrievedIds, goldIds, 20),
+    mrr:            mrr(retrievedIds, goldIds),
+    ndcg_at_10:     ndcgAt(retrievedIds, goldIds, 10),
+    precision_at_5: precisionAt(retrievedIds, goldIds, 5),
+  };
+}
+
+/**
+ * Promedia métricas sobre múltiples queries.
+ *
+ * @param {Array<object>} resultados - Array de objetos producidos por calcularMetricas().
+ * @returns {object} Promedios con campo `n` (cantidad de queries).
+ */
+function promediar(resultados) {
+  if (!Array.isArray(resultados) || resultados.length === 0) {
+    return {
+      n: 0,
+      recall_at_5: 0,
+      recall_at_10: 0,
+      recall_at_20: 0,
+      mrr: 0,
+      ndcg_at_10: 0,
+      precision_at_5: 0,
+    };
+  }
+
+  const claves = ['recall_at_5', 'recall_at_10', 'recall_at_20', 'mrr', 'ndcg_at_10', 'precision_at_5'];
+  const promedio = { n: resultados.length };
+  for (const k of claves) {
+    const sum = resultados.reduce((a, r) => a + (r[k] || 0), 0);
+    promedio[k] = sum / resultados.length;
+  }
+  return promedio;
+}
+
+// ── exports ───────────────────────────────────────────────────────────────────
+
+module.exports = {
+  recallAt,
+  precisionAt,
+  mrr,
+  ndcgAt,
+  dcg,
+  calcularMetricas,
+  promediar,
+};

package/scripts/lib/eval-metrics-store.js

@@ -0,0 +1,218 @@
+'use strict';
+
+/**
+ * eval-metrics-store.js — Persistencia agregada de métricas de evaluación.
+ *
+ * Patrón adoptado de `temp/agentmemory-main/src/eval/metrics-store.ts`.
+ * Adaptado a swl-ses: file-based en lugar de SQLite. Persiste:
+ *   - JSONL append-only:    `.planning/evolucion/eval-results.jsonl` (cada eval individual)
+ *   - JSON agregado:        `.planning/evolucion/eval-metrics.json`  (totales por functionId)
+ *
+ * El JSONL preserva el detalle histórico (un evento por evaluación). El JSON
+ * agregado se recalcula incrementalmente: avg latency, avg quality, success
+ * rate por functionId. Lectura barata sin escanear todo el JSONL.
+ *
+ * Funciones puras donde es posible. Las funciones I/O usan escrituras atómicas
+ * (atomicWriteJSON) para `eval-metrics.json`. El JSONL usa appendFileSync
+ * (regla SWL: JSONL para alta frecuencia).
+ *
+ * @module scripts/lib/eval-metrics-store
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+let atomicWriteJSON;
+try {
+  ({ atomicWriteJSON } = require('../../hooks/lib/atomic-write'));
+} catch {
+  atomicWriteJSON = (p, o) => fs.writeFileSync(p, JSON.stringify(o, null, 2), 'utf8');
+}
+
+// ── constantes ────────────────────────────────────────────────────────────────
+
+const DIR_EVOLUCION = path.join('.planning', 'evolucion');
+const RUTA_JSONL    = path.join(DIR_EVOLUCION, 'eval-results.jsonl');
+const RUTA_AGREGADO = path.join(DIR_EVOLUCION, 'eval-metrics.json');
+
+// ── helpers ───────────────────────────────────────────────────────────────────
+
+function asegurarDir(baseDir) {
+  const dir = path.join(baseDir, DIR_EVOLUCION);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+}
+
+function leerAgregado(baseDir) {
+  const ruta = path.join(baseDir, RUTA_AGREGADO);
+  if (!fs.existsSync(ruta)) return {};
+  try {
+    return JSON.parse(fs.readFileSync(ruta, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+// ── API pública ───────────────────────────────────────────────────────────────
+
+/**
+ * Registra una evaluación completada.
+ *
+ * Append-only al JSONL + actualización incremental del agregado.
+ *
+ * @param {string} baseDir - Raíz del proyecto.
+ * @param {object} evento
+ * @param {string} evento.functionId - Identificador de la función evaluada.
+ * @param {number} evento.latencyMs
+ * @param {boolean} evento.success
+ * @param {number} [evento.qualityScore] - en [0, 100]
+ * @param {object} [evento.metadata]
+ * @returns {{ recorded: boolean, error?: string }}
+ */
+function registrar(baseDir, evento) {
+  if (!evento || typeof evento.functionId !== 'string') {
+    return { recorded: false, error: 'functionId requerido' };
+  }
+
+  asegurarDir(baseDir);
+
+  const ts = new Date().toISOString();
+  const lineaJSONL = JSON.stringify({
+    timestamp: ts,
+    functionId: evento.functionId,
+    latencyMs: typeof evento.latencyMs === 'number' ? evento.latencyMs : 0,
+    success: Boolean(evento.success),
+    qualityScore: typeof evento.qualityScore === 'number' ? evento.qualityScore : null,
+    metadata: evento.metadata || null,
+  });
+
+  try {
+    fs.appendFileSync(path.join(baseDir, RUTA_JSONL), lineaJSONL + '\n', 'utf8');
+  } catch (err) {
+    return { recorded: false, error: 'JSONL append failed: ' + err.message };
+  }
+
+  // Actualizar agregado
+  try {
+    const agregado = leerAgregado(baseDir);
+    const fid = evento.functionId;
+    const m = agregado[fid] || {
+      functionId: fid,
+      totalCalls: 0,
+      successCount: 0,
+      failureCount: 0,
+      avgLatencyMs: 0,
+      avgQualityScore: 0,
+      qualityCallCounts: 0,
+      lastUpdatedAt: ts,
+    };
+
+    const prev = m.totalCalls;
+    m.totalCalls += 1;
+    m.avgLatencyMs = (m.avgLatencyMs * prev + (evento.latencyMs || 0)) / m.totalCalls;
+    if (evento.success) m.successCount += 1;
+    else m.failureCount += 1;
+
+    if (typeof evento.qualityScore === 'number') {
+      const prevQ = m.qualityCallCounts || 0;
+      m.avgQualityScore = (m.avgQualityScore * prevQ + evento.qualityScore) / (prevQ + 1);
+      m.qualityCallCounts = prevQ + 1;
+    }
+
+    m.lastUpdatedAt = ts;
+    agregado[fid] = m;
+    atomicWriteJSON(path.join(baseDir, RUTA_AGREGADO), agregado);
+  } catch (err) {
+    return { recorded: true, error: 'Aggregate update failed: ' + err.message };
+  }
+
+  return { recorded: true };
+}
+
+/**
+ * Lee las métricas agregadas para un functionId específico.
+ * @param {string} baseDir
+ * @param {string} functionId
+ * @returns {object|null}
+ */
+function obtener(baseDir, functionId) {
+  const agregado = leerAgregado(baseDir);
+  return agregado[functionId] || null;
+}
+
+/**
+ * Lee todas las métricas agregadas.
+ * @param {string} baseDir
+ * @returns {object[]}
+ */
+function obtenerTodos(baseDir) {
+  const agregado = leerAgregado(baseDir);
+  return Object.values(agregado);
+}
+
+/**
+ * Recorre el JSONL y reconstruye el agregado desde cero.
+ * Útil tras corrupción del agregado o auditoría histórica.
+ *
+ * @param {string} baseDir
+ * @returns {{ rebuilt: number, functions: number }}
+ */
+function reconstruirAgregado(baseDir) {
+  const ruta = path.join(baseDir, RUTA_JSONL);
+  if (!fs.existsSync(ruta)) return { rebuilt: 0, functions: 0 };
+
+  const agregado = {};
+  let lineas = 0;
+  const contenido = fs.readFileSync(ruta, 'utf8');
+  for (const linea of contenido.split('\n')) {
+    if (!linea.trim()) continue;
+    let evento;
+    try { evento = JSON.parse(linea); } catch { continue; }
+
+    const fid = evento.functionId;
+    if (!fid) continue;
+    lineas++;
+
+    const m = agregado[fid] || {
+      functionId: fid,
+      totalCalls: 0,
+      successCount: 0,
+      failureCount: 0,
+      avgLatencyMs: 0,
+      avgQualityScore: 0,
+      qualityCallCounts: 0,
+      lastUpdatedAt: evento.timestamp,
+    };
+
+    const prev = m.totalCalls;
+    m.totalCalls += 1;
+    m.avgLatencyMs = (m.avgLatencyMs * prev + (evento.latencyMs || 0)) / m.totalCalls;
+    if (evento.success) m.successCount += 1;
+    else m.failureCount += 1;
+
+    if (typeof evento.qualityScore === 'number') {
+      const prevQ = m.qualityCallCounts || 0;
+      m.avgQualityScore = (m.avgQualityScore * prevQ + evento.qualityScore) / (prevQ + 1);
+      m.qualityCallCounts = prevQ + 1;
+    }
+
+    m.lastUpdatedAt = evento.timestamp;
+    agregado[fid] = m;
+  }
+
+  asegurarDir(baseDir);
+  atomicWriteJSON(path.join(baseDir, RUTA_AGREGADO), agregado);
+  return { rebuilt: lineas, functions: Object.keys(agregado).length };
+}
+
+// ── exports ───────────────────────────────────────────────────────────────────
+
+module.exports = {
+  registrar,
+  obtener,
+  obtenerTodos,
+  reconstruirAgregado,
+  RUTA_JSONL,
+  RUTA_AGREGADO,
+};

package/scripts/lib/eval-quality.js

@@ -0,0 +1,171 @@
+'use strict';
+
+/**
+ * eval-quality.js — Métricas de calidad para outputs estructurados de SWL.
+ *
+ * Patrón adoptado de `temp/agentmemory-main/src/eval/quality.ts`. Adaptado a
+ * swl-ses: scoring de aprendizajes, instintos, y resultados de búsqueda
+ * memoria.
+ *
+ * Cada función devuelve un score en [0, 100]. Los puntos se asignan por
+ * "presencia y calidad de campos clave" — un output con todos los campos
+ * tiene score 100, un output trivial tiene score bajo.
+ *
+ * Funciones puras zero-deps.
+ *
+ * @module scripts/lib/eval-quality
+ */
+
+// ── helpers ───────────────────────────────────────────────────────────────────
+
+function clamp(n, min, max) {
+  if (Number.isNaN(n)) return min;
+  return Math.max(min, Math.min(max, n));
+}
+
+// ── scoring de outputs ────────────────────────────────────────────────────────
+
+/**
+ * Score de calidad de una observación comprimida.
+ * Adaptado de scoreCompression() de agentmemory.
+ *
+ * Distribución de puntos:
+ *   - facts presentes (no vacíos):       25
+ *   - facts ≥ 3:                         +10
+ *   - narrative ≥ 20 chars:               20
+ *   - narrative ≥ 50 chars:               +5
+ *   - title 5-120 chars:                  15
+ *   - concepts presentes:                 15
+ *   - importance ∈ [1, 10]:               10
+ *
+ * @param {object} obs
+ * @returns {number} en [0, 100]
+ */
+function scoreObservacion(obs) {
+  let score = 0;
+  if (Array.isArray(obs?.facts) && obs.facts.length > 0) score += 25;
+  if (Array.isArray(obs?.facts) && obs.facts.length >= 3) score += 10;
+  if (typeof obs?.narrative === 'string' && obs.narrative.length >= 20) score += 20;
+  if (typeof obs?.narrative === 'string' && obs.narrative.length >= 50) score += 5;
+  if (typeof obs?.title === 'string' && obs.title.length >= 5 && obs.title.length <= 120) score += 15;
+  if (Array.isArray(obs?.concepts) && obs.concepts.length > 0) score += 15;
+  if (typeof obs?.importance === 'number' && obs.importance >= 1 && obs.importance <= 10) score += 10;
+  return clamp(score, 0, 100);
+}
+
+/**
+ * Score de calidad de un resumen de sesión.
+ * Adaptado de scoreSummary() de agentmemory.
+ *
+ * @param {object} summary
+ * @returns {number} en [0, 100]
+ */
+function scoreResumen(summary) {
+  let score = 0;
+  if (typeof summary?.title === 'string' && summary.title.length >= 5) score += 20;
+  if (typeof summary?.narrative === 'string' && summary.narrative.length >= 20) score += 25;
+  if (typeof summary?.narrative === 'string' && summary.narrative.length >= 100) score += 5;
+  if (Array.isArray(summary?.keyDecisions) && summary.keyDecisions.length > 0) score += 20;
+  if (Array.isArray(summary?.filesModified) && summary.filesModified.length > 0) score += 15;
+  if (Array.isArray(summary?.concepts) && summary.concepts.length > 0) score += 15;
+  return clamp(score, 0, 100);
+}
+
+/**
+ * Score de relevancia de un contexto inyectado.
+ * Adaptado de scoreContextRelevance() de agentmemory.
+ *
+ * @param {string} context - Texto del contexto.
+ * @param {string} project - Nombre del proyecto.
+ * @returns {number} en [0, 100]
+ */
+function scoreRelevanciaContexto(context, project) {
+  if (typeof context !== 'string') return 0;
+  let score = 0;
+  if (context.length > 0) score += 20;
+  if (project && context.toLowerCase().includes(String(project).toLowerCase())) score += 20;
+  if (context.includes('<')) score += 15;
+  const sectionCount = (context.match(/<\w+>/g) || []).length;
+  if (sectionCount >= 2) score += 15;
+  if (sectionCount >= 4) score += 10;
+  if (context.length >= 100) score += 10;
+  if (context.length >= 500) score += 10;
+  return clamp(score, 0, 100);
+}
+
+/**
+ * Score de calidad de un aprendizaje SWL extraído de una sesión.
+ * Específico de swl-ses (no en agentmemory).
+ *
+ * Distribución:
+ *   - título no vacío y descriptivo (≥ 10 chars):  20
+ *   - título empieza con fecha [YYYY-MM-DD]:       10
+ *   - cuerpo ≥ 100 chars:                          20
+ *   - cuerpo ≥ 300 chars:                          +10
+ *   - tipo identificado (decisión|patrón|...):     15
+ *   - menciona archivo o regla concreta:           15
+ *   - tiene "trigger" o "criterio de disparo":     10
+ *
+ * @param {object} aprendizaje { titulo, contenido, tipo? }
+ * @returns {number}
+ */
+function scoreAprendizaje(aprendizaje) {
+  let score = 0;
+  const titulo = String(aprendizaje?.titulo || '');
+  const contenido = String(aprendizaje?.contenido || '');
+
+  if (titulo.length >= 10) score += 20;
+  if (/^\[\d{4}-\d{2}-\d{2}\]/.test(titulo)) score += 10;
+  if (contenido.length >= 100) score += 20;
+  if (contenido.length >= 300) score += 10;
+
+  const tipos = ['decisión', 'patrón', 'anti-patrón', 'bug-fix', 'descubrimiento', 'gotcha'];
+  if (aprendizaje?.tipo && tipos.some(t => String(aprendizaje.tipo).includes(t))) {
+    score += 15;
+  }
+
+  if (/`[^`]+\.(js|ts|md|py|json|yaml)`|`[^`]+\/[^`]+`/.test(contenido)) score += 15;
+  if (/trigger|criterio de disparo|cuando .+ entonces/i.test(contenido)) score += 10;
+
+  return clamp(score, 0, 100);
+}
+
+/**
+ * Score de calidad de un instinto.
+ * Específico de swl-ses.
+ *
+ * Distribución:
+ *   - pattern presente:                          25
+ *   - pattern ≥ 30 chars:                        +10
+ *   - confidence ∈ [0, 1]:                       15
+ *   - status válido (active|degraded|archived):  10
+ *   - source_sessions o source_agents declarado: 15
+ *   - evidence_count ≥ 1:                        15
+ *   - last_validated_at presente:                10
+ *
+ * @param {object} instinto
+ * @returns {number}
+ */
+function scoreInstinto(instinto) {
+  let score = 0;
+  const pattern = String(instinto?.pattern || '');
+  if (pattern.length > 0) score += 25;
+  if (pattern.length >= 30) score += 10;
+  if (typeof instinto?.confidence === 'number' && instinto.confidence >= 0 && instinto.confidence <= 1) score += 15;
+  if (['active', 'degraded', 'archived'].includes(instinto?.status)) score += 10;
+  if ((Array.isArray(instinto?.source_sessions) && instinto.source_sessions.length > 0) ||
+      (Array.isArray(instinto?.source_agents) && instinto.source_agents.length > 0)) score += 15;
+  if (typeof instinto?.evidence_count === 'number' && instinto.evidence_count >= 1) score += 15;
+  if (instinto?.last_validated_at || instinto?.last_validated) score += 10;
+  return clamp(score, 0, 100);
+}
+
+// ── exports ───────────────────────────────────────────────────────────────────
+
+module.exports = {
+  scoreObservacion,
+  scoreResumen,
+  scoreRelevanciaContexto,
+  scoreAprendizaje,
+  scoreInstinto,
+};

package/scripts/lib/eval-schemas.js

@@ -0,0 +1,144 @@
+'use strict';
+
+/**
+ * eval-schemas.js — Schemas JSON-lite para evaluación de outputs SWL.
+ *
+ * Patrón adoptado de `temp/agentmemory-main/src/eval/schemas.ts`. Adaptado a
+ * swl-ses: sin Zod (sería dep externa). Uso JSON Schema-lite con validador
+ * propio en `eval-validator.js`. Funciones puras zero-deps.
+ *
+ * Cada schema describe la estructura esperada de un output evaluable. El
+ * validador devuelve `{ valid, errors[] }` para que el caller decida.
+ *
+ * @module scripts/lib/eval-schemas
+ */
+
+// ── tipos enumerados ──────────────────────────────────────────────────────────
+
+const TIPOS_OBSERVACION = [
+  'file_read', 'file_write', 'file_edit',
+  'command_run', 'search', 'web_fetch',
+  'conversation', 'error', 'decision',
+  'discovery', 'subagent', 'notification',
+  'task', 'other',
+];
+
+const TIPOS_MEMORIA = [
+  'pattern', 'preference', 'architecture',
+  'bug', 'workflow', 'fact',
+];
+
+const TIPOS_RELACION = [
+  'supersedes', 'extends', 'derives', 'contradicts', 'related',
+];
+
+// ── schemas JSON-lite ─────────────────────────────────────────────────────────
+
+/**
+ * Schema para output de compresión de observación.
+ * Estructura compatible con `CompressOutputSchema` de agentmemory.
+ */
+const COMPRESS_OUTPUT_SCHEMA = {
+  type: 'object',
+  required: ['type', 'title', 'facts', 'narrative', 'concepts', 'files', 'importance'],
+  properties: {
+    type: { type: 'string', enum: TIPOS_OBSERVACION },
+    title: { type: 'string', minLength: 1, maxLength: 120 },
+    subtitle: { type: 'string' },
+    facts: { type: 'array', minItems: 1, items: { type: 'string' } },
+    narrative: { type: 'string', minLength: 10 },
+    concepts: { type: 'array', items: { type: 'string' } },
+    files: { type: 'array', items: { type: 'string' } },
+    importance: { type: 'integer', minimum: 1, maximum: 10 },
+  },
+};
+
+/**
+ * Schema para output de resumen de sesión.
+ */
+const SUMMARY_OUTPUT_SCHEMA = {
+  type: 'object',
+  required: ['title', 'narrative', 'keyDecisions', 'filesModified', 'concepts'],
+  properties: {
+    title: { type: 'string', minLength: 1 },
+    narrative: { type: 'string', minLength: 20 },
+    keyDecisions: { type: 'array', items: { type: 'string' } },
+    filesModified: { type: 'array', items: { type: 'string' } },
+    concepts: { type: 'array', items: { type: 'string' } },
+  },
+};
+
+/**
+ * Schema para input de búsqueda.
+ */
+const SEARCH_INPUT_SCHEMA = {
+  type: 'object',
+  required: ['query'],
+  properties: {
+    query: { type: 'string', minLength: 1 },
+    limit: { type: 'integer', minimum: 1 },
+  },
+};
+
+/**
+ * Schema para input de "remember" (guardar memoria).
+ */
+const REMEMBER_INPUT_SCHEMA = {
+  type: 'object',
+  required: ['content'],
+  properties: {
+    content: { type: 'string', minLength: 1 },
+    type: { type: 'string', enum: TIPOS_MEMORIA },
+    concepts: { type: 'array', items: { type: 'string' } },
+    files: { type: 'array', items: { type: 'string' } },
+  },
+};
+
+/**
+ * Schema para resultado de evaluación.
+ */
+const EVAL_RESULT_SCHEMA = {
+  type: 'object',
+  required: ['valid', 'qualityScore', 'latencyMs', 'functionId'],
+  properties: {
+    valid: { type: 'boolean' },
+    errors: { type: 'array', items: { type: 'string' } },
+    qualityScore: { type: 'number', minimum: 0, maximum: 100 },
+    latencyMs: { type: 'number', minimum: 0 },
+    functionId: { type: 'string', minLength: 1 },
+    metadata: { type: 'object' },
+  },
+};
+
+/**
+ * Schema para resultado de búsqueda en memoria SWL.
+ */
+const MEMORY_SEARCH_RESULT_SCHEMA = {
+  type: 'object',
+  required: ['id', 'tipo', 'titulo', 'fecha', 'relevancia'],
+  properties: {
+    id: { type: 'string', minLength: 1 },
+    tipo: { type: 'string', enum: ['aprendizaje', 'sesion', 'instinto'] },
+    titulo: { type: 'string' },
+    fecha: { type: 'string' },
+    relevancia: { type: 'number', minimum: 0, maximum: 1 },
+    combinedScore: { type: 'number', minimum: 0 },
+    confidence: { type: 'number', minimum: 0, maximum: 1 },
+  },
+};
+
+// ── exports ───────────────────────────────────────────────────────────────────
+
+module.exports = {
+  // Schemas
+  COMPRESS_OUTPUT_SCHEMA,
+  SUMMARY_OUTPUT_SCHEMA,
+  SEARCH_INPUT_SCHEMA,
+  REMEMBER_INPUT_SCHEMA,
+  EVAL_RESULT_SCHEMA,
+  MEMORY_SEARCH_RESULT_SCHEMA,
+  // Enums
+  TIPOS_OBSERVACION,
+  TIPOS_MEMORIA,
+  TIPOS_RELACION,
+};