@saulwade/swl-ses 1.5.1 → 1.6.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 (155) hide show
  1. package/CLAUDE.md +225 -209
  2. package/README.md +578 -561
  3. package/agentes/arquitecto-swl.md +33 -1
  4. package/agentes/nemesis-auditor-swl.md +59 -19
  5. package/bin/swl-mcp-server.js +214 -214
  6. package/bin/swl-ses.js +49 -7
  7. package/comandos/swl/.evolved.json +22 -22
  8. package/comandos/swl/contribuir.md +233 -233
  9. package/comandos/swl/nemesis.md +230 -56
  10. package/gateway/lib/event-channel.js +191 -191
  11. package/habilidades/backend-production-resilience/SKILL.md +288 -288
  12. package/habilidades/benchmark-memoria/SKILL.md +186 -186
  13. package/habilidades/diagrama-arquitectura/assets/template.html +276 -276
  14. package/habilidades/doubt-driven-review/SKILL.md +171 -171
  15. package/habilidades/doubt-driven-review/recursos/EXAMPLES.md +130 -130
  16. package/habilidades/ejecutar-task-iterativo/SKILL.md +278 -278
  17. package/habilidades/eval-framework/SKILL.md +212 -212
  18. package/habilidades/feynman-auditor-swl/SKILL.md +123 -123
  19. package/habilidades/feynman-auditor-swl/recursos/preguntas-language-agnostic.md +108 -108
  20. package/habilidades/harness-claude-code/SKILL.md +299 -299
  21. package/habilidades/infra-github-actions/SKILL.md +166 -166
  22. package/habilidades/legacy-code-rescue/SKILL.md +267 -267
  23. package/habilidades/manejo-errores/.evolved.json +8 -8
  24. package/habilidades/meta-skills-estandar/SKILL.md +207 -4
  25. package/habilidades/meta-skills-estandar/recursos/convencion-examples.md +93 -93
  26. package/habilidades/meta-skills-estandar/recursos/skills-as-agents.md +163 -163
  27. package/habilidades/nemesis-evaluacion-json/SKILL.md +266 -0
  28. package/habilidades/nemesis-redistribuir/SKILL.md +341 -0
  29. package/habilidades/node-experto/SKILL.md +94 -4
  30. package/habilidades/patrones-python/SKILL.md +229 -229
  31. package/habilidades/patrones-python/recursos/patrones-avanzados.md +469 -469
  32. package/habilidades/planear-fase/SKILL.md +319 -319
  33. package/habilidades/protocolo-revision-swl/SKILL.md +350 -276
  34. package/habilidades/release-semver/.evolved.json +8 -8
  35. package/habilidades/state-inconsistency-auditor-swl/SKILL.md +166 -166
  36. package/habilidades/state-inconsistency-auditor-swl/recursos/coupled-state-patterns.md +147 -147
  37. package/habilidades/tdd-workflow/SKILL.md +121 -4
  38. package/habilidades/testing-python/SKILL.md +340 -340
  39. package/habilidades/web-fetcher-routing/SKILL.md +75 -75
  40. package/hooks/check-update.js +31 -3
  41. package/hooks/claudemd-bloat-detector.js +161 -161
  42. package/hooks/extraccion-aprendizajes.js +11 -0
  43. package/hooks/lib/agent-routing.js +107 -107
  44. package/hooks/lib/auto-consolidator.js +335 -335
  45. package/hooks/lib/error-classifier.js +308 -308
  46. package/hooks/lib/merkle-audit.js +96 -96
  47. package/hooks/lib/provenance-tracker.js +191 -191
  48. package/hooks/lib/rate-limit-tracker.js +253 -253
  49. package/hooks/lib/resource-quota.js +122 -122
  50. package/hooks/lib/retry-jitter.js +165 -165
  51. package/hooks/lib/security-net.js +201 -201
  52. package/hooks/lib/skill-auditor.js +588 -588
  53. package/hooks/lib/sync-status.js +228 -228
  54. package/hooks/lib/taint-tracker.js +107 -107
  55. package/hooks/lib/text-similarity.js +241 -241
  56. package/hooks/lib/toon-compressor.js +245 -245
  57. package/hooks/registro-turnos.js +209 -209
  58. package/hooks/sugerir-regenerar-inventario.js +170 -170
  59. package/hooks/validar-formato-post-subagente.js +140 -140
  60. package/hooks/validar-memoria-hook.js +218 -218
  61. package/instintos/prompt-appendices.yaml +57 -57
  62. package/manifiestos/agent-output-schemas.json +57 -57
  63. package/manifiestos/modulos.json +1324 -1321
  64. package/manifiestos/skills-lock.json +1142 -1114
  65. package/package.json +5 -4
  66. package/plantillas/auditor-veto-template.md +105 -105
  67. package/plantillas/github-workflows/README.md +47 -47
  68. package/plantillas/github-workflows/release-please.yml +44 -44
  69. package/plantillas/github-workflows/swl-ci.yml +107 -107
  70. package/plantillas/github-workflows/swl-security.yml +51 -51
  71. package/plugin.json +355 -351
  72. package/reglas/analisis-previo-tareas-grandes.md +172 -172
  73. package/reglas/arreglar-al-detectar.md +147 -147
  74. package/reglas/fragmentos-compartidos.md +152 -152
  75. package/reglas/harness-claude-code.md +213 -213
  76. package/reglas/registro-componentes-nuevos.md +192 -0
  77. package/reglas/usar-context7.md +226 -226
  78. package/schemas/diary-entry.schema.json +80 -80
  79. package/scripts/actualizar.js +110 -1
  80. package/scripts/audit-tools/audit-history.js +330 -330
  81. package/scripts/audit-tools/bundle-tracker.js +290 -290
  82. package/scripts/audit-tools/canary-monitor.js +352 -352
  83. package/scripts/audit-tools/code-profiler.js +605 -605
  84. package/scripts/audit-tools/dep-doctor.js +320 -320
  85. package/scripts/audit-tools/env-validator.js +206 -206
  86. package/scripts/audit-tools/lib/fs-walk.js +48 -48
  87. package/scripts/audit-tools/lib/output.js +23 -23
  88. package/scripts/audit-tools/migration-checker.js +392 -392
  89. package/scripts/audit-tools/pentest-scanner.js +1436 -1436
  90. package/scripts/benchmark-memoria.js +167 -167
  91. package/scripts/configurar-branch-protection.js +418 -418
  92. package/scripts/derivar-feature-list.js +489 -489
  93. package/scripts/desinstalar.js +105 -24
  94. package/scripts/detectar-aprendizajes-duplicados.js +151 -151
  95. package/scripts/doctor.js +27 -0
  96. package/scripts/field-report.js +199 -199
  97. package/scripts/generar-checklists-consolidados.js +273 -273
  98. package/scripts/generar-inventario.js +420 -420
  99. package/scripts/generar-matriz-lenguajes.js +271 -271
  100. package/scripts/instalador.js +55 -4
  101. package/scripts/lib/artefactos-python.js +43 -43
  102. package/scripts/lib/benchmark-metrics.js +160 -160
  103. package/scripts/lib/budget-enforcer.js +252 -252
  104. package/scripts/lib/configurar-ci.js +380 -380
  105. package/scripts/lib/contadores-inventario.js +217 -217
  106. package/scripts/lib/detectar-stack-detallado.js +307 -307
  107. package/scripts/lib/diary-entry.js +234 -234
  108. package/scripts/lib/eval-metrics-store.js +218 -218
  109. package/scripts/lib/eval-quality.js +171 -171
  110. package/scripts/lib/eval-schemas.js +144 -144
  111. package/scripts/lib/eval-self-correct.js +106 -106
  112. package/scripts/lib/eval-validator.js +185 -185
  113. package/scripts/lib/expandir-targets.js +71 -71
  114. package/scripts/lib/jaccard-similarity.js +98 -98
  115. package/scripts/lib/longmemeval-runner.js +125 -125
  116. package/scripts/lib/mcp_config.py +127 -0
  117. package/scripts/lib/npm-version.js +261 -261
  118. package/scripts/lib/paquetes-conocidos.js +50 -50
  119. package/scripts/lib/parsear-opciones.js +3 -0
  120. package/scripts/lib/prompt-builder.js +264 -264
  121. package/scripts/lib/rrf-fusion.js +175 -175
  122. package/scripts/lib/scoring-instintos.js +277 -277
  123. package/scripts/lib/semantic-search.js +252 -252
  124. package/scripts/lib/toml-merge.js +204 -204
  125. package/scripts/lib/transformadores/codex.js +375 -375
  126. package/scripts/lib/transformadores/cursor.js +359 -359
  127. package/scripts/lib/ui.js +148 -22
  128. package/scripts/limpiar-artefactos-python.js +131 -131
  129. package/scripts/mcp-orchestrator.py +8 -18
  130. package/scripts/mcp-pool-manager.py +12 -23
  131. package/scripts/mcp-server/README.md +170 -170
  132. package/scripts/mcp-server/auth.js +105 -105
  133. package/scripts/mcp-server/cache.js +106 -106
  134. package/scripts/mcp-server/telemetry.js +78 -78
  135. package/scripts/migrar-csv-a-array.js +168 -168
  136. package/scripts/migrar-fase-dominio.js +201 -201
  137. package/scripts/publicar.js +511 -511
  138. package/scripts/run-eval.js +141 -141
  139. package/scripts/tui/componentes/selector-multi.js +189 -0
  140. package/scripts/tui/componentes/selector-unico.js +158 -0
  141. package/scripts/tui/ejecutores.js +375 -0
  142. package/scripts/tui/index.js +162 -0
  143. package/scripts/tui/lib/colores.js +129 -0
  144. package/scripts/tui/lib/render.js +264 -0
  145. package/scripts/tui/lib/teclas.js +113 -0
  146. package/scripts/tui/pantallas/inspect.js +173 -0
  147. package/scripts/tui/pantallas/install-wizard.js +334 -0
  148. package/scripts/tui/pantallas/menu-principal.js +52 -0
  149. package/scripts/tui/pantallas/progreso.js +274 -0
  150. package/scripts/tui/pantallas/resumen.js +132 -0
  151. package/scripts/tui/pantallas/uninstall-wizard.js +208 -0
  152. package/scripts/tui/pantallas/update-wizard.js +232 -0
  153. package/scripts/tui/pantallas/welcome.js +187 -0
  154. package/scripts/validar-userland-vacio.js +110 -110
  155. package/scripts/verificar-docs-vs-codigo.js +425 -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
+ };