@saulwade/swl-ses 1.3.8 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (128) hide show
  1. package/CLAUDE.md +12 -4
  2. package/README.md +1 -1
  3. package/bin/swl-mcp-server.js +187 -187
  4. package/bin/swl-webhook-server.js +198 -0
  5. package/comandos/swl/.evolved.json +22 -22
  6. package/comandos/swl/adoptar-proyecto.md +21 -1
  7. package/comandos/swl/claudemd.md +14 -1
  8. package/comandos/swl/contribuir.md +233 -233
  9. package/comandos/swl/exportar-vault.md +108 -0
  10. package/comandos/swl/nuevo-proyecto.md +24 -2
  11. package/gateway/adapters/base.js +109 -0
  12. package/gateway/adapters/discord.js +167 -0
  13. package/gateway/adapters/email.js +221 -0
  14. package/gateway/adapters/slack.js +192 -0
  15. package/gateway/adapters/telegram.js +183 -0
  16. package/gateway/adapters/webhook.js +113 -0
  17. package/gateway/adapters/whatsapp.js +214 -0
  18. package/gateway/agent-executor.js +322 -0
  19. package/gateway/command-relay.js +271 -0
  20. package/gateway/cron/jobs.js +263 -0
  21. package/gateway/cron/scheduler.js +322 -0
  22. package/gateway/cron/store.js +335 -0
  23. package/gateway/index.js +320 -0
  24. package/gateway/lib/event-channel.js +191 -0
  25. package/gateway/session.js +131 -0
  26. package/gateway/webhook-server.js +324 -0
  27. package/habilidades/backend-production-resilience/SKILL.md +288 -288
  28. package/habilidades/benchmark-memoria/SKILL.md +186 -186
  29. package/habilidades/build-errors-nextjs/SKILL.md +55 -1
  30. package/habilidades/diagrama-arquitectura/assets/template.html +276 -276
  31. package/habilidades/doubt-driven-review/SKILL.md +171 -171
  32. package/habilidades/doubt-driven-review/recursos/EXAMPLES.md +130 -130
  33. package/habilidades/eval-framework/SKILL.md +212 -212
  34. package/habilidades/extractor-de-aprendizajes/SKILL.md +20 -10
  35. package/habilidades/harness-claude-code/SKILL.md +299 -299
  36. package/habilidades/infra-github-actions/SKILL.md +166 -166
  37. package/habilidades/legacy-code-rescue/SKILL.md +267 -267
  38. package/habilidades/manejo-errores/.evolved.json +8 -8
  39. package/habilidades/meta-skills-estandar/recursos/convencion-examples.md +93 -93
  40. package/habilidades/meta-skills-estandar/recursos/skills-as-agents.md +163 -163
  41. package/habilidades/nextjs-testing/SKILL.md +89 -5
  42. package/habilidades/node-experto/SKILL.md +37 -1
  43. package/habilidades/patrones-python/SKILL.md +229 -229
  44. package/habilidades/patrones-python/recursos/patrones-avanzados.md +469 -469
  45. package/habilidades/planear-fase/SKILL.md +319 -319
  46. package/habilidades/react-experto/SKILL.md +45 -4
  47. package/habilidades/release-semver/.evolved.json +8 -8
  48. package/habilidades/tdd-workflow/SKILL.md +36 -4
  49. package/habilidades/testing-python/SKILL.md +340 -340
  50. package/hooks/claudemd-bloat-detector.js +161 -161
  51. package/hooks/inyeccion-contexto.js +8 -3
  52. package/hooks/lib/agent-routing.js +107 -107
  53. package/hooks/lib/auto-consolidator.js +335 -335
  54. package/hooks/lib/error-classifier.js +308 -308
  55. package/hooks/lib/merkle-audit.js +96 -96
  56. package/hooks/lib/provenance-tracker.js +191 -191
  57. package/hooks/lib/rate-limit-ip.js +177 -0
  58. package/hooks/lib/rate-limit-tracker.js +253 -253
  59. package/hooks/lib/resource-quota.js +122 -122
  60. package/hooks/lib/retry-jitter.js +165 -165
  61. package/hooks/lib/skill-auditor.js +588 -588
  62. package/hooks/lib/sync-status.js +228 -228
  63. package/hooks/lib/taint-tracker.js +107 -107
  64. package/hooks/lib/text-similarity.js +241 -241
  65. package/hooks/lib/toon-compressor.js +245 -245
  66. package/hooks/lib/webhook-dedup.js +184 -0
  67. package/hooks/lib/webhook-verify.js +123 -0
  68. package/hooks/proteccion-rutas.js +120 -15
  69. package/hooks/registro-turnos.js +209 -209
  70. package/hooks/sugerir-regenerar-inventario.js +170 -170
  71. package/hooks/validar-formato-post-subagente.js +140 -140
  72. package/hooks/validar-memoria-hook.js +218 -218
  73. package/instintos/prompt-appendices.yaml +57 -57
  74. package/manifiestos/agent-output-schemas.json +57 -57
  75. package/manifiestos/modulos.json +1 -0
  76. package/manifiestos/skills-lock.json +34 -34
  77. package/package.json +5 -3
  78. package/plantillas/auditor-veto-template.md +105 -105
  79. package/plantillas/github-workflows/README.md +47 -47
  80. package/plantillas/github-workflows/release-please.yml +44 -44
  81. package/plantillas/github-workflows/swl-ci.yml +107 -107
  82. package/plantillas/github-workflows/swl-security.yml +51 -51
  83. package/plugin.json +1 -1
  84. package/reglas/analisis-previo-tareas-grandes.md +172 -172
  85. package/reglas/arreglar-al-detectar.md +147 -147
  86. package/reglas/fragmentos-compartidos.md +152 -152
  87. package/reglas/harness-claude-code.md +213 -213
  88. package/reglas/usar-context7.md +226 -226
  89. package/reglas/usar-sistema-swl.md +251 -0
  90. package/schemas/diary-entry.schema.json +80 -80
  91. package/scripts/benchmark-memoria.js +167 -167
  92. package/scripts/comandos/skills.js +251 -2
  93. package/scripts/configurar-branch-protection.js +418 -418
  94. package/scripts/detectar-aprendizajes-duplicados.js +151 -151
  95. package/scripts/field-report.js +199 -199
  96. package/scripts/generar-checklists-consolidados.js +273 -273
  97. package/scripts/generar-inventario.js +420 -420
  98. package/scripts/generar-matriz-lenguajes.js +271 -271
  99. package/scripts/lib/artefactos-python.js +43 -43
  100. package/scripts/lib/benchmark-metrics.js +160 -160
  101. package/scripts/lib/budget-enforcer.js +252 -252
  102. package/scripts/lib/configurar-ci.js +380 -380
  103. package/scripts/lib/contadores-inventario.js +217 -217
  104. package/scripts/lib/detectar-stack-detallado.js +307 -307
  105. package/scripts/lib/diary-entry.js +234 -234
  106. package/scripts/lib/eval-metrics-store.js +218 -218
  107. package/scripts/lib/eval-quality.js +171 -171
  108. package/scripts/lib/eval-schemas.js +144 -144
  109. package/scripts/lib/eval-self-correct.js +106 -106
  110. package/scripts/lib/eval-validator.js +185 -185
  111. package/scripts/lib/jaccard-similarity.js +98 -98
  112. package/scripts/lib/longmemeval-runner.js +125 -125
  113. package/scripts/lib/npm-version.js +261 -261
  114. package/scripts/lib/paquetes-conocidos.js +50 -50
  115. package/scripts/lib/prompt-builder.js +264 -264
  116. package/scripts/lib/rrf-fusion.js +175 -175
  117. package/scripts/lib/scoring-instintos.js +277 -277
  118. package/scripts/lib/semantic-search.js +252 -252
  119. package/scripts/limpiar-artefactos-python.js +131 -131
  120. package/scripts/mcp-server/README.md +128 -128
  121. package/scripts/mcp-server/handlers.js +206 -206
  122. package/scripts/migrar-csv-a-array.js +168 -168
  123. package/scripts/migrar-fase-dominio.js +201 -201
  124. package/scripts/publicar.js +511 -511
  125. package/scripts/run-eval.js +141 -141
  126. package/scripts/validar-manifest.js +195 -195
  127. package/scripts/validar-userland-vacio.js +110 -110
  128. package/scripts/verificar-release.js +110 -0
@@ -1,171 +1,171 @@
1
- 'use strict';
2
-
3
- /**
4
- * eval-quality.js — Métricas de calidad para outputs estructurados de SWL.
5
- *
6
- * Patrón adoptado de `temp/agentmemory-main/src/eval/quality.ts`. Adaptado a
7
- * swl-ses: scoring de aprendizajes, instintos, y resultados de búsqueda
8
- * memoria.
9
- *
10
- * Cada función devuelve un score en [0, 100]. Los puntos se asignan por
11
- * "presencia y calidad de campos clave" — un output con todos los campos
12
- * tiene score 100, un output trivial tiene score bajo.
13
- *
14
- * Funciones puras zero-deps.
15
- *
16
- * @module scripts/lib/eval-quality
17
- */
18
-
19
- // ── helpers ───────────────────────────────────────────────────────────────────
20
-
21
- function clamp(n, min, max) {
22
- if (Number.isNaN(n)) return min;
23
- return Math.max(min, Math.min(max, n));
24
- }
25
-
26
- // ── scoring de outputs ────────────────────────────────────────────────────────
27
-
28
- /**
29
- * Score de calidad de una observación comprimida.
30
- * Adaptado de scoreCompression() de agentmemory.
31
- *
32
- * Distribución de puntos:
33
- * - facts presentes (no vacíos): 25
34
- * - facts ≥ 3: +10
35
- * - narrative ≥ 20 chars: 20
36
- * - narrative ≥ 50 chars: +5
37
- * - title 5-120 chars: 15
38
- * - concepts presentes: 15
39
- * - importance ∈ [1, 10]: 10
40
- *
41
- * @param {object} obs
42
- * @returns {number} en [0, 100]
43
- */
44
- function scoreObservacion(obs) {
45
- let score = 0;
46
- if (Array.isArray(obs?.facts) && obs.facts.length > 0) score += 25;
47
- if (Array.isArray(obs?.facts) && obs.facts.length >= 3) score += 10;
48
- if (typeof obs?.narrative === 'string' && obs.narrative.length >= 20) score += 20;
49
- if (typeof obs?.narrative === 'string' && obs.narrative.length >= 50) score += 5;
50
- if (typeof obs?.title === 'string' && obs.title.length >= 5 && obs.title.length <= 120) score += 15;
51
- if (Array.isArray(obs?.concepts) && obs.concepts.length > 0) score += 15;
52
- if (typeof obs?.importance === 'number' && obs.importance >= 1 && obs.importance <= 10) score += 10;
53
- return clamp(score, 0, 100);
54
- }
55
-
56
- /**
57
- * Score de calidad de un resumen de sesión.
58
- * Adaptado de scoreSummary() de agentmemory.
59
- *
60
- * @param {object} summary
61
- * @returns {number} en [0, 100]
62
- */
63
- function scoreResumen(summary) {
64
- let score = 0;
65
- if (typeof summary?.title === 'string' && summary.title.length >= 5) score += 20;
66
- if (typeof summary?.narrative === 'string' && summary.narrative.length >= 20) score += 25;
67
- if (typeof summary?.narrative === 'string' && summary.narrative.length >= 100) score += 5;
68
- if (Array.isArray(summary?.keyDecisions) && summary.keyDecisions.length > 0) score += 20;
69
- if (Array.isArray(summary?.filesModified) && summary.filesModified.length > 0) score += 15;
70
- if (Array.isArray(summary?.concepts) && summary.concepts.length > 0) score += 15;
71
- return clamp(score, 0, 100);
72
- }
73
-
74
- /**
75
- * Score de relevancia de un contexto inyectado.
76
- * Adaptado de scoreContextRelevance() de agentmemory.
77
- *
78
- * @param {string} context - Texto del contexto.
79
- * @param {string} project - Nombre del proyecto.
80
- * @returns {number} en [0, 100]
81
- */
82
- function scoreRelevanciaContexto(context, project) {
83
- if (typeof context !== 'string') return 0;
84
- let score = 0;
85
- if (context.length > 0) score += 20;
86
- if (project && context.toLowerCase().includes(String(project).toLowerCase())) score += 20;
87
- if (context.includes('<')) score += 15;
88
- const sectionCount = (context.match(/<\w+>/g) || []).length;
89
- if (sectionCount >= 2) score += 15;
90
- if (sectionCount >= 4) score += 10;
91
- if (context.length >= 100) score += 10;
92
- if (context.length >= 500) score += 10;
93
- return clamp(score, 0, 100);
94
- }
95
-
96
- /**
97
- * Score de calidad de un aprendizaje SWL extraído de una sesión.
98
- * Específico de swl-ses (no en agentmemory).
99
- *
100
- * Distribución:
101
- * - título no vacío y descriptivo (≥ 10 chars): 20
102
- * - título empieza con fecha [YYYY-MM-DD]: 10
103
- * - cuerpo ≥ 100 chars: 20
104
- * - cuerpo ≥ 300 chars: +10
105
- * - tipo identificado (decisión|patrón|...): 15
106
- * - menciona archivo o regla concreta: 15
107
- * - tiene "trigger" o "criterio de disparo": 10
108
- *
109
- * @param {object} aprendizaje { titulo, contenido, tipo? }
110
- * @returns {number}
111
- */
112
- function scoreAprendizaje(aprendizaje) {
113
- let score = 0;
114
- const titulo = String(aprendizaje?.titulo || '');
115
- const contenido = String(aprendizaje?.contenido || '');
116
-
117
- if (titulo.length >= 10) score += 20;
118
- if (/^\[\d{4}-\d{2}-\d{2}\]/.test(titulo)) score += 10;
119
- if (contenido.length >= 100) score += 20;
120
- if (contenido.length >= 300) score += 10;
121
-
122
- const tipos = ['decisión', 'patrón', 'anti-patrón', 'bug-fix', 'descubrimiento', 'gotcha'];
123
- if (aprendizaje?.tipo && tipos.some(t => String(aprendizaje.tipo).includes(t))) {
124
- score += 15;
125
- }
126
-
127
- if (/`[^`]+\.(js|ts|md|py|json|yaml)`|`[^`]+\/[^`]+`/.test(contenido)) score += 15;
128
- if (/trigger|criterio de disparo|cuando .+ entonces/i.test(contenido)) score += 10;
129
-
130
- return clamp(score, 0, 100);
131
- }
132
-
133
- /**
134
- * Score de calidad de un instinto.
135
- * Específico de swl-ses.
136
- *
137
- * Distribución:
138
- * - pattern presente: 25
139
- * - pattern ≥ 30 chars: +10
140
- * - confidence ∈ [0, 1]: 15
141
- * - status válido (active|degraded|archived): 10
142
- * - source_sessions o source_agents declarado: 15
143
- * - evidence_count ≥ 1: 15
144
- * - last_validated_at presente: 10
145
- *
146
- * @param {object} instinto
147
- * @returns {number}
148
- */
149
- function scoreInstinto(instinto) {
150
- let score = 0;
151
- const pattern = String(instinto?.pattern || '');
152
- if (pattern.length > 0) score += 25;
153
- if (pattern.length >= 30) score += 10;
154
- if (typeof instinto?.confidence === 'number' && instinto.confidence >= 0 && instinto.confidence <= 1) score += 15;
155
- if (['active', 'degraded', 'archived'].includes(instinto?.status)) score += 10;
156
- if ((Array.isArray(instinto?.source_sessions) && instinto.source_sessions.length > 0) ||
157
- (Array.isArray(instinto?.source_agents) && instinto.source_agents.length > 0)) score += 15;
158
- if (typeof instinto?.evidence_count === 'number' && instinto.evidence_count >= 1) score += 15;
159
- if (instinto?.last_validated_at || instinto?.last_validated) score += 10;
160
- return clamp(score, 0, 100);
161
- }
162
-
163
- // ── exports ───────────────────────────────────────────────────────────────────
164
-
165
- module.exports = {
166
- scoreObservacion,
167
- scoreResumen,
168
- scoreRelevanciaContexto,
169
- scoreAprendizaje,
170
- scoreInstinto,
171
- };
1
+ 'use strict';
2
+
3
+ /**
4
+ * eval-quality.js — Métricas de calidad para outputs estructurados de SWL.
5
+ *
6
+ * Patrón adoptado de `temp/agentmemory-main/src/eval/quality.ts`. Adaptado a
7
+ * swl-ses: scoring de aprendizajes, instintos, y resultados de búsqueda
8
+ * memoria.
9
+ *
10
+ * Cada función devuelve un score en [0, 100]. Los puntos se asignan por
11
+ * "presencia y calidad de campos clave" — un output con todos los campos
12
+ * tiene score 100, un output trivial tiene score bajo.
13
+ *
14
+ * Funciones puras zero-deps.
15
+ *
16
+ * @module scripts/lib/eval-quality
17
+ */
18
+
19
+ // ── helpers ───────────────────────────────────────────────────────────────────
20
+
21
+ function clamp(n, min, max) {
22
+ if (Number.isNaN(n)) return min;
23
+ return Math.max(min, Math.min(max, n));
24
+ }
25
+
26
+ // ── scoring de outputs ────────────────────────────────────────────────────────
27
+
28
+ /**
29
+ * Score de calidad de una observación comprimida.
30
+ * Adaptado de scoreCompression() de agentmemory.
31
+ *
32
+ * Distribución de puntos:
33
+ * - facts presentes (no vacíos): 25
34
+ * - facts ≥ 3: +10
35
+ * - narrative ≥ 20 chars: 20
36
+ * - narrative ≥ 50 chars: +5
37
+ * - title 5-120 chars: 15
38
+ * - concepts presentes: 15
39
+ * - importance ∈ [1, 10]: 10
40
+ *
41
+ * @param {object} obs
42
+ * @returns {number} en [0, 100]
43
+ */
44
+ function scoreObservacion(obs) {
45
+ let score = 0;
46
+ if (Array.isArray(obs?.facts) && obs.facts.length > 0) score += 25;
47
+ if (Array.isArray(obs?.facts) && obs.facts.length >= 3) score += 10;
48
+ if (typeof obs?.narrative === 'string' && obs.narrative.length >= 20) score += 20;
49
+ if (typeof obs?.narrative === 'string' && obs.narrative.length >= 50) score += 5;
50
+ if (typeof obs?.title === 'string' && obs.title.length >= 5 && obs.title.length <= 120) score += 15;
51
+ if (Array.isArray(obs?.concepts) && obs.concepts.length > 0) score += 15;
52
+ if (typeof obs?.importance === 'number' && obs.importance >= 1 && obs.importance <= 10) score += 10;
53
+ return clamp(score, 0, 100);
54
+ }
55
+
56
+ /**
57
+ * Score de calidad de un resumen de sesión.
58
+ * Adaptado de scoreSummary() de agentmemory.
59
+ *
60
+ * @param {object} summary
61
+ * @returns {number} en [0, 100]
62
+ */
63
+ function scoreResumen(summary) {
64
+ let score = 0;
65
+ if (typeof summary?.title === 'string' && summary.title.length >= 5) score += 20;
66
+ if (typeof summary?.narrative === 'string' && summary.narrative.length >= 20) score += 25;
67
+ if (typeof summary?.narrative === 'string' && summary.narrative.length >= 100) score += 5;
68
+ if (Array.isArray(summary?.keyDecisions) && summary.keyDecisions.length > 0) score += 20;
69
+ if (Array.isArray(summary?.filesModified) && summary.filesModified.length > 0) score += 15;
70
+ if (Array.isArray(summary?.concepts) && summary.concepts.length > 0) score += 15;
71
+ return clamp(score, 0, 100);
72
+ }
73
+
74
+ /**
75
+ * Score de relevancia de un contexto inyectado.
76
+ * Adaptado de scoreContextRelevance() de agentmemory.
77
+ *
78
+ * @param {string} context - Texto del contexto.
79
+ * @param {string} project - Nombre del proyecto.
80
+ * @returns {number} en [0, 100]
81
+ */
82
+ function scoreRelevanciaContexto(context, project) {
83
+ if (typeof context !== 'string') return 0;
84
+ let score = 0;
85
+ if (context.length > 0) score += 20;
86
+ if (project && context.toLowerCase().includes(String(project).toLowerCase())) score += 20;
87
+ if (context.includes('<')) score += 15;
88
+ const sectionCount = (context.match(/<\w+>/g) || []).length;
89
+ if (sectionCount >= 2) score += 15;
90
+ if (sectionCount >= 4) score += 10;
91
+ if (context.length >= 100) score += 10;
92
+ if (context.length >= 500) score += 10;
93
+ return clamp(score, 0, 100);
94
+ }
95
+
96
+ /**
97
+ * Score de calidad de un aprendizaje SWL extraído de una sesión.
98
+ * Específico de swl-ses (no en agentmemory).
99
+ *
100
+ * Distribución:
101
+ * - título no vacío y descriptivo (≥ 10 chars): 20
102
+ * - título empieza con fecha [YYYY-MM-DD]: 10
103
+ * - cuerpo ≥ 100 chars: 20
104
+ * - cuerpo ≥ 300 chars: +10
105
+ * - tipo identificado (decisión|patrón|...): 15
106
+ * - menciona archivo o regla concreta: 15
107
+ * - tiene "trigger" o "criterio de disparo": 10
108
+ *
109
+ * @param {object} aprendizaje { titulo, contenido, tipo? }
110
+ * @returns {number}
111
+ */
112
+ function scoreAprendizaje(aprendizaje) {
113
+ let score = 0;
114
+ const titulo = String(aprendizaje?.titulo || '');
115
+ const contenido = String(aprendizaje?.contenido || '');
116
+
117
+ if (titulo.length >= 10) score += 20;
118
+ if (/^\[\d{4}-\d{2}-\d{2}\]/.test(titulo)) score += 10;
119
+ if (contenido.length >= 100) score += 20;
120
+ if (contenido.length >= 300) score += 10;
121
+
122
+ const tipos = ['decisión', 'patrón', 'anti-patrón', 'bug-fix', 'descubrimiento', 'gotcha'];
123
+ if (aprendizaje?.tipo && tipos.some(t => String(aprendizaje.tipo).includes(t))) {
124
+ score += 15;
125
+ }
126
+
127
+ if (/`[^`]+\.(js|ts|md|py|json|yaml)`|`[^`]+\/[^`]+`/.test(contenido)) score += 15;
128
+ if (/trigger|criterio de disparo|cuando .+ entonces/i.test(contenido)) score += 10;
129
+
130
+ return clamp(score, 0, 100);
131
+ }
132
+
133
+ /**
134
+ * Score de calidad de un instinto.
135
+ * Específico de swl-ses.
136
+ *
137
+ * Distribución:
138
+ * - pattern presente: 25
139
+ * - pattern ≥ 30 chars: +10
140
+ * - confidence ∈ [0, 1]: 15
141
+ * - status válido (active|degraded|archived): 10
142
+ * - source_sessions o source_agents declarado: 15
143
+ * - evidence_count ≥ 1: 15
144
+ * - last_validated_at presente: 10
145
+ *
146
+ * @param {object} instinto
147
+ * @returns {number}
148
+ */
149
+ function scoreInstinto(instinto) {
150
+ let score = 0;
151
+ const pattern = String(instinto?.pattern || '');
152
+ if (pattern.length > 0) score += 25;
153
+ if (pattern.length >= 30) score += 10;
154
+ if (typeof instinto?.confidence === 'number' && instinto.confidence >= 0 && instinto.confidence <= 1) score += 15;
155
+ if (['active', 'degraded', 'archived'].includes(instinto?.status)) score += 10;
156
+ if ((Array.isArray(instinto?.source_sessions) && instinto.source_sessions.length > 0) ||
157
+ (Array.isArray(instinto?.source_agents) && instinto.source_agents.length > 0)) score += 15;
158
+ if (typeof instinto?.evidence_count === 'number' && instinto.evidence_count >= 1) score += 15;
159
+ if (instinto?.last_validated_at || instinto?.last_validated) score += 10;
160
+ return clamp(score, 0, 100);
161
+ }
162
+
163
+ // ── exports ───────────────────────────────────────────────────────────────────
164
+
165
+ module.exports = {
166
+ scoreObservacion,
167
+ scoreResumen,
168
+ scoreRelevanciaContexto,
169
+ scoreAprendizaje,
170
+ scoreInstinto,
171
+ };
@@ -1,144 +1,144 @@
1
- 'use strict';
2
-
3
- /**
4
- * eval-schemas.js — Schemas JSON-lite para evaluación de outputs SWL.
5
- *
6
- * Patrón adoptado de `temp/agentmemory-main/src/eval/schemas.ts`. Adaptado a
7
- * swl-ses: sin Zod (sería dep externa). Uso JSON Schema-lite con validador
8
- * propio en `eval-validator.js`. Funciones puras zero-deps.
9
- *
10
- * Cada schema describe la estructura esperada de un output evaluable. El
11
- * validador devuelve `{ valid, errors[] }` para que el caller decida.
12
- *
13
- * @module scripts/lib/eval-schemas
14
- */
15
-
16
- // ── tipos enumerados ──────────────────────────────────────────────────────────
17
-
18
- const TIPOS_OBSERVACION = [
19
- 'file_read', 'file_write', 'file_edit',
20
- 'command_run', 'search', 'web_fetch',
21
- 'conversation', 'error', 'decision',
22
- 'discovery', 'subagent', 'notification',
23
- 'task', 'other',
24
- ];
25
-
26
- const TIPOS_MEMORIA = [
27
- 'pattern', 'preference', 'architecture',
28
- 'bug', 'workflow', 'fact',
29
- ];
30
-
31
- const TIPOS_RELACION = [
32
- 'supersedes', 'extends', 'derives', 'contradicts', 'related',
33
- ];
34
-
35
- // ── schemas JSON-lite ─────────────────────────────────────────────────────────
36
-
37
- /**
38
- * Schema para output de compresión de observación.
39
- * Estructura compatible con `CompressOutputSchema` de agentmemory.
40
- */
41
- const COMPRESS_OUTPUT_SCHEMA = {
42
- type: 'object',
43
- required: ['type', 'title', 'facts', 'narrative', 'concepts', 'files', 'importance'],
44
- properties: {
45
- type: { type: 'string', enum: TIPOS_OBSERVACION },
46
- title: { type: 'string', minLength: 1, maxLength: 120 },
47
- subtitle: { type: 'string' },
48
- facts: { type: 'array', minItems: 1, items: { type: 'string' } },
49
- narrative: { type: 'string', minLength: 10 },
50
- concepts: { type: 'array', items: { type: 'string' } },
51
- files: { type: 'array', items: { type: 'string' } },
52
- importance: { type: 'integer', minimum: 1, maximum: 10 },
53
- },
54
- };
55
-
56
- /**
57
- * Schema para output de resumen de sesión.
58
- */
59
- const SUMMARY_OUTPUT_SCHEMA = {
60
- type: 'object',
61
- required: ['title', 'narrative', 'keyDecisions', 'filesModified', 'concepts'],
62
- properties: {
63
- title: { type: 'string', minLength: 1 },
64
- narrative: { type: 'string', minLength: 20 },
65
- keyDecisions: { type: 'array', items: { type: 'string' } },
66
- filesModified: { type: 'array', items: { type: 'string' } },
67
- concepts: { type: 'array', items: { type: 'string' } },
68
- },
69
- };
70
-
71
- /**
72
- * Schema para input de búsqueda.
73
- */
74
- const SEARCH_INPUT_SCHEMA = {
75
- type: 'object',
76
- required: ['query'],
77
- properties: {
78
- query: { type: 'string', minLength: 1 },
79
- limit: { type: 'integer', minimum: 1 },
80
- },
81
- };
82
-
83
- /**
84
- * Schema para input de "remember" (guardar memoria).
85
- */
86
- const REMEMBER_INPUT_SCHEMA = {
87
- type: 'object',
88
- required: ['content'],
89
- properties: {
90
- content: { type: 'string', minLength: 1 },
91
- type: { type: 'string', enum: TIPOS_MEMORIA },
92
- concepts: { type: 'array', items: { type: 'string' } },
93
- files: { type: 'array', items: { type: 'string' } },
94
- },
95
- };
96
-
97
- /**
98
- * Schema para resultado de evaluación.
99
- */
100
- const EVAL_RESULT_SCHEMA = {
101
- type: 'object',
102
- required: ['valid', 'qualityScore', 'latencyMs', 'functionId'],
103
- properties: {
104
- valid: { type: 'boolean' },
105
- errors: { type: 'array', items: { type: 'string' } },
106
- qualityScore: { type: 'number', minimum: 0, maximum: 100 },
107
- latencyMs: { type: 'number', minimum: 0 },
108
- functionId: { type: 'string', minLength: 1 },
109
- metadata: { type: 'object' },
110
- },
111
- };
112
-
113
- /**
114
- * Schema para resultado de búsqueda en memoria SWL.
115
- */
116
- const MEMORY_SEARCH_RESULT_SCHEMA = {
117
- type: 'object',
118
- required: ['id', 'tipo', 'titulo', 'fecha', 'relevancia'],
119
- properties: {
120
- id: { type: 'string', minLength: 1 },
121
- tipo: { type: 'string', enum: ['aprendizaje', 'sesion', 'instinto'] },
122
- titulo: { type: 'string' },
123
- fecha: { type: 'string' },
124
- relevancia: { type: 'number', minimum: 0, maximum: 1 },
125
- combinedScore: { type: 'number', minimum: 0 },
126
- confidence: { type: 'number', minimum: 0, maximum: 1 },
127
- },
128
- };
129
-
130
- // ── exports ───────────────────────────────────────────────────────────────────
131
-
132
- module.exports = {
133
- // Schemas
134
- COMPRESS_OUTPUT_SCHEMA,
135
- SUMMARY_OUTPUT_SCHEMA,
136
- SEARCH_INPUT_SCHEMA,
137
- REMEMBER_INPUT_SCHEMA,
138
- EVAL_RESULT_SCHEMA,
139
- MEMORY_SEARCH_RESULT_SCHEMA,
140
- // Enums
141
- TIPOS_OBSERVACION,
142
- TIPOS_MEMORIA,
143
- TIPOS_RELACION,
144
- };
1
+ 'use strict';
2
+
3
+ /**
4
+ * eval-schemas.js — Schemas JSON-lite para evaluación de outputs SWL.
5
+ *
6
+ * Patrón adoptado de `temp/agentmemory-main/src/eval/schemas.ts`. Adaptado a
7
+ * swl-ses: sin Zod (sería dep externa). Uso JSON Schema-lite con validador
8
+ * propio en `eval-validator.js`. Funciones puras zero-deps.
9
+ *
10
+ * Cada schema describe la estructura esperada de un output evaluable. El
11
+ * validador devuelve `{ valid, errors[] }` para que el caller decida.
12
+ *
13
+ * @module scripts/lib/eval-schemas
14
+ */
15
+
16
+ // ── tipos enumerados ──────────────────────────────────────────────────────────
17
+
18
+ const TIPOS_OBSERVACION = [
19
+ 'file_read', 'file_write', 'file_edit',
20
+ 'command_run', 'search', 'web_fetch',
21
+ 'conversation', 'error', 'decision',
22
+ 'discovery', 'subagent', 'notification',
23
+ 'task', 'other',
24
+ ];
25
+
26
+ const TIPOS_MEMORIA = [
27
+ 'pattern', 'preference', 'architecture',
28
+ 'bug', 'workflow', 'fact',
29
+ ];
30
+
31
+ const TIPOS_RELACION = [
32
+ 'supersedes', 'extends', 'derives', 'contradicts', 'related',
33
+ ];
34
+
35
+ // ── schemas JSON-lite ─────────────────────────────────────────────────────────
36
+
37
+ /**
38
+ * Schema para output de compresión de observación.
39
+ * Estructura compatible con `CompressOutputSchema` de agentmemory.
40
+ */
41
+ const COMPRESS_OUTPUT_SCHEMA = {
42
+ type: 'object',
43
+ required: ['type', 'title', 'facts', 'narrative', 'concepts', 'files', 'importance'],
44
+ properties: {
45
+ type: { type: 'string', enum: TIPOS_OBSERVACION },
46
+ title: { type: 'string', minLength: 1, maxLength: 120 },
47
+ subtitle: { type: 'string' },
48
+ facts: { type: 'array', minItems: 1, items: { type: 'string' } },
49
+ narrative: { type: 'string', minLength: 10 },
50
+ concepts: { type: 'array', items: { type: 'string' } },
51
+ files: { type: 'array', items: { type: 'string' } },
52
+ importance: { type: 'integer', minimum: 1, maximum: 10 },
53
+ },
54
+ };
55
+
56
+ /**
57
+ * Schema para output de resumen de sesión.
58
+ */
59
+ const SUMMARY_OUTPUT_SCHEMA = {
60
+ type: 'object',
61
+ required: ['title', 'narrative', 'keyDecisions', 'filesModified', 'concepts'],
62
+ properties: {
63
+ title: { type: 'string', minLength: 1 },
64
+ narrative: { type: 'string', minLength: 20 },
65
+ keyDecisions: { type: 'array', items: { type: 'string' } },
66
+ filesModified: { type: 'array', items: { type: 'string' } },
67
+ concepts: { type: 'array', items: { type: 'string' } },
68
+ },
69
+ };
70
+
71
+ /**
72
+ * Schema para input de búsqueda.
73
+ */
74
+ const SEARCH_INPUT_SCHEMA = {
75
+ type: 'object',
76
+ required: ['query'],
77
+ properties: {
78
+ query: { type: 'string', minLength: 1 },
79
+ limit: { type: 'integer', minimum: 1 },
80
+ },
81
+ };
82
+
83
+ /**
84
+ * Schema para input de "remember" (guardar memoria).
85
+ */
86
+ const REMEMBER_INPUT_SCHEMA = {
87
+ type: 'object',
88
+ required: ['content'],
89
+ properties: {
90
+ content: { type: 'string', minLength: 1 },
91
+ type: { type: 'string', enum: TIPOS_MEMORIA },
92
+ concepts: { type: 'array', items: { type: 'string' } },
93
+ files: { type: 'array', items: { type: 'string' } },
94
+ },
95
+ };
96
+
97
+ /**
98
+ * Schema para resultado de evaluación.
99
+ */
100
+ const EVAL_RESULT_SCHEMA = {
101
+ type: 'object',
102
+ required: ['valid', 'qualityScore', 'latencyMs', 'functionId'],
103
+ properties: {
104
+ valid: { type: 'boolean' },
105
+ errors: { type: 'array', items: { type: 'string' } },
106
+ qualityScore: { type: 'number', minimum: 0, maximum: 100 },
107
+ latencyMs: { type: 'number', minimum: 0 },
108
+ functionId: { type: 'string', minLength: 1 },
109
+ metadata: { type: 'object' },
110
+ },
111
+ };
112
+
113
+ /**
114
+ * Schema para resultado de búsqueda en memoria SWL.
115
+ */
116
+ const MEMORY_SEARCH_RESULT_SCHEMA = {
117
+ type: 'object',
118
+ required: ['id', 'tipo', 'titulo', 'fecha', 'relevancia'],
119
+ properties: {
120
+ id: { type: 'string', minLength: 1 },
121
+ tipo: { type: 'string', enum: ['aprendizaje', 'sesion', 'instinto'] },
122
+ titulo: { type: 'string' },
123
+ fecha: { type: 'string' },
124
+ relevancia: { type: 'number', minimum: 0, maximum: 1 },
125
+ combinedScore: { type: 'number', minimum: 0 },
126
+ confidence: { type: 'number', minimum: 0, maximum: 1 },
127
+ },
128
+ };
129
+
130
+ // ── exports ───────────────────────────────────────────────────────────────────
131
+
132
+ module.exports = {
133
+ // Schemas
134
+ COMPRESS_OUTPUT_SCHEMA,
135
+ SUMMARY_OUTPUT_SCHEMA,
136
+ SEARCH_INPUT_SCHEMA,
137
+ REMEMBER_INPUT_SCHEMA,
138
+ EVAL_RESULT_SCHEMA,
139
+ MEMORY_SEARCH_RESULT_SCHEMA,
140
+ // Enums
141
+ TIPOS_OBSERVACION,
142
+ TIPOS_MEMORIA,
143
+ TIPOS_RELACION,
144
+ };