@saulwade/swl-ses 1.5.0 → 1.5.2

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 (134) hide show
  1. package/CLAUDE.md +19 -2
  2. package/README.md +561 -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/comandos/swl/.evolved.json +22 -22
  7. package/comandos/swl/contribuir.md +233 -233
  8. package/comandos/swl/nemesis.md +230 -56
  9. package/gateway/lib/event-channel.js +191 -191
  10. package/habilidades/backend-production-resilience/SKILL.md +288 -288
  11. package/habilidades/benchmark-memoria/SKILL.md +186 -186
  12. package/habilidades/diagrama-arquitectura/assets/template.html +276 -276
  13. package/habilidades/doubt-driven-review/SKILL.md +171 -171
  14. package/habilidades/doubt-driven-review/recursos/EXAMPLES.md +130 -130
  15. package/habilidades/ejecutar-task-iterativo/SKILL.md +278 -278
  16. package/habilidades/eval-framework/SKILL.md +212 -212
  17. package/habilidades/feynman-auditor-swl/SKILL.md +123 -123
  18. package/habilidades/feynman-auditor-swl/recursos/preguntas-language-agnostic.md +108 -108
  19. package/habilidades/harness-claude-code/SKILL.md +299 -299
  20. package/habilidades/infra-github-actions/SKILL.md +166 -166
  21. package/habilidades/legacy-code-rescue/SKILL.md +267 -267
  22. package/habilidades/manejo-errores/.evolved.json +8 -8
  23. package/habilidades/meta-skills-estandar/SKILL.md +225 -1
  24. package/habilidades/meta-skills-estandar/recursos/convencion-examples.md +93 -93
  25. package/habilidades/meta-skills-estandar/recursos/skills-as-agents.md +163 -163
  26. package/habilidades/nemesis-evaluacion-json/SKILL.md +266 -0
  27. package/habilidades/nemesis-redistribuir/SKILL.md +341 -0
  28. package/habilidades/node-experto/SKILL.md +105 -4
  29. package/habilidades/patrones-python/SKILL.md +229 -229
  30. package/habilidades/patrones-python/recursos/patrones-avanzados.md +469 -469
  31. package/habilidades/planear-fase/SKILL.md +319 -319
  32. package/habilidades/protocolo-revision-swl/SKILL.md +350 -276
  33. package/habilidades/release-semver/.evolved.json +8 -8
  34. package/habilidades/state-inconsistency-auditor-swl/SKILL.md +166 -166
  35. package/habilidades/state-inconsistency-auditor-swl/recursos/coupled-state-patterns.md +147 -147
  36. package/habilidades/tdd-workflow/SKILL.md +150 -4
  37. package/habilidades/testing-python/SKILL.md +340 -340
  38. package/habilidades/verificar-trabajo/SKILL.md +8 -3
  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/lib/agent-routing.js +107 -107
  43. package/hooks/lib/auto-consolidator.js +335 -335
  44. package/hooks/lib/error-classifier.js +308 -308
  45. package/hooks/lib/merkle-audit.js +96 -96
  46. package/hooks/lib/provenance-tracker.js +191 -191
  47. package/hooks/lib/rate-limit-tracker.js +253 -253
  48. package/hooks/lib/resource-quota.js +122 -122
  49. package/hooks/lib/retry-jitter.js +165 -165
  50. package/hooks/lib/security-net.js +201 -201
  51. package/hooks/lib/skill-auditor.js +588 -588
  52. package/hooks/lib/sync-status.js +228 -228
  53. package/hooks/lib/taint-tracker.js +107 -107
  54. package/hooks/lib/text-similarity.js +241 -241
  55. package/hooks/lib/toon-compressor.js +245 -245
  56. package/hooks/registro-turnos.js +209 -209
  57. package/hooks/sugerir-regenerar-inventario.js +170 -170
  58. package/hooks/validar-formato-post-subagente.js +140 -140
  59. package/hooks/validar-memoria-hook.js +218 -218
  60. package/instintos/prompt-appendices.yaml +57 -57
  61. package/manifiestos/agent-output-schemas.json +57 -57
  62. package/manifiestos/modulos.json +1324 -1321
  63. package/manifiestos/skills-lock.json +1114 -1114
  64. package/package.json +2 -2
  65. package/plantillas/auditor-veto-template.md +105 -105
  66. package/plantillas/github-workflows/README.md +47 -47
  67. package/plantillas/github-workflows/release-please.yml +44 -44
  68. package/plantillas/github-workflows/swl-ci.yml +107 -107
  69. package/plantillas/github-workflows/swl-security.yml +51 -51
  70. package/plugin.json +353 -351
  71. package/reglas/analisis-previo-tareas-grandes.md +172 -172
  72. package/reglas/arreglar-al-detectar.md +147 -147
  73. package/reglas/fragmentos-compartidos.md +152 -152
  74. package/reglas/harness-claude-code.md +213 -213
  75. package/reglas/registro-componentes-nuevos.md +192 -0
  76. package/reglas/usar-context7.md +226 -226
  77. package/schemas/diary-entry.schema.json +80 -80
  78. package/scripts/actualizar.js +110 -1
  79. package/scripts/audit-tools/audit-history.js +330 -330
  80. package/scripts/audit-tools/bundle-tracker.js +290 -290
  81. package/scripts/audit-tools/canary-monitor.js +352 -352
  82. package/scripts/audit-tools/code-profiler.js +605 -605
  83. package/scripts/audit-tools/dep-doctor.js +320 -320
  84. package/scripts/audit-tools/env-validator.js +206 -206
  85. package/scripts/audit-tools/lib/fs-walk.js +48 -48
  86. package/scripts/audit-tools/lib/output.js +23 -23
  87. package/scripts/audit-tools/migration-checker.js +392 -392
  88. package/scripts/audit-tools/pentest-scanner.js +1436 -1436
  89. package/scripts/benchmark-memoria.js +167 -167
  90. package/scripts/configurar-branch-protection.js +418 -418
  91. package/scripts/derivar-feature-list.js +489 -489
  92. package/scripts/detectar-aprendizajes-duplicados.js +151 -151
  93. package/scripts/doctor.js +58 -4
  94. package/scripts/field-report.js +199 -199
  95. package/scripts/generar-checklists-consolidados.js +273 -273
  96. package/scripts/generar-inventario.js +420 -420
  97. package/scripts/generar-matriz-lenguajes.js +271 -271
  98. package/scripts/lib/artefactos-python.js +43 -43
  99. package/scripts/lib/benchmark-metrics.js +160 -160
  100. package/scripts/lib/budget-enforcer.js +252 -252
  101. package/scripts/lib/configurar-ci.js +380 -380
  102. package/scripts/lib/contadores-inventario.js +217 -217
  103. package/scripts/lib/detectar-stack-detallado.js +307 -307
  104. package/scripts/lib/diary-entry.js +234 -234
  105. package/scripts/lib/eval-metrics-store.js +218 -218
  106. package/scripts/lib/eval-quality.js +171 -171
  107. package/scripts/lib/eval-schemas.js +144 -144
  108. package/scripts/lib/eval-self-correct.js +106 -106
  109. package/scripts/lib/eval-validator.js +185 -185
  110. package/scripts/lib/expandir-targets.js +71 -71
  111. package/scripts/lib/jaccard-similarity.js +98 -98
  112. package/scripts/lib/longmemeval-runner.js +125 -125
  113. package/scripts/lib/mcp_config.py +127 -0
  114. package/scripts/lib/npm-version.js +261 -261
  115. package/scripts/lib/paquetes-conocidos.js +50 -50
  116. package/scripts/lib/prompt-builder.js +264 -264
  117. package/scripts/lib/rrf-fusion.js +175 -175
  118. package/scripts/lib/scoring-instintos.js +277 -277
  119. package/scripts/lib/semantic-search.js +252 -252
  120. package/scripts/lib/toml-merge.js +204 -204
  121. package/scripts/lib/transformadores/codex.js +375 -375
  122. package/scripts/lib/transformadores/cursor.js +359 -359
  123. package/scripts/limpiar-artefactos-python.js +131 -131
  124. package/scripts/mcp-orchestrator.py +8 -18
  125. package/scripts/mcp-pool-manager.py +12 -23
  126. package/scripts/mcp-server/README.md +170 -170
  127. package/scripts/mcp-server/auth.js +105 -105
  128. package/scripts/mcp-server/cache.js +106 -106
  129. package/scripts/mcp-server/telemetry.js +78 -78
  130. package/scripts/migrar-csv-a-array.js +168 -168
  131. package/scripts/migrar-fase-dominio.js +201 -201
  132. package/scripts/publicar.js +511 -511
  133. package/scripts/run-eval.js +141 -141
  134. package/scripts/validar-userland-vacio.js +110 -110
@@ -1,50 +1,50 @@
1
- 'use strict';
2
-
3
- /**
4
- * paquetes-conocidos.js — fuente única de verdad para los nombres de
5
- * paquete del rebrand swl-ses.
6
- *
7
- * Por qué existe:
8
- * La asimetría intencional de scopes (npmjs `@saulwade/swl-ses` vs
9
- * GitHub Packages `@saul-wade/swl-ses`) requiere que múltiples scripts
10
- * reconozcan ambos nombres más el legacy. Tener la lista hardcodeada
11
- * en cada archivo es violación DRY de conocimiento — un cambio futuro
12
- * (deprecar el nombre desnudo, agregar otro mirror) requeriría editar
13
- * varios archivos.
14
- *
15
- * Convenciones:
16
- * - NOMBRE_NPMJS_CANONICO: canónico publicado en registry.npmjs.org.
17
- * - NOMBRE_GITHUB_MIRROR: mirror publicado en npm.pkg.github.com.
18
- * - NOMBRES_DETECCION: orden de prioridad para consultas remotas
19
- * (canónico npmjs primero porque no requiere auth).
20
- * - NOMBRES_VALIDOS: nombres aceptables para `package.json#name`.
21
- * NO incluye 'swl-ses' sin scope (deprecated, eliminado en v1.0.0).
22
- */
23
-
24
- const NOMBRE_NPMJS_CANONICO = '@saulwade/swl-ses';
25
- const NOMBRE_GITHUB_MIRROR = '@saul-wade/swl-ses';
26
- const NOMBRE_LEGACY_DESNUDO = 'swl-ses';
27
-
28
- const NOMBRES_DETECCION = Object.freeze([
29
- NOMBRE_NPMJS_CANONICO,
30
- NOMBRE_GITHUB_MIRROR,
31
- NOMBRE_LEGACY_DESNUDO,
32
- ]);
33
-
34
- const NOMBRES_VALIDOS = Object.freeze([
35
- NOMBRE_NPMJS_CANONICO,
36
- NOMBRE_GITHUB_MIRROR,
37
- ]);
38
-
39
- const REGISTRY_NPMJS = 'https://registry.npmjs.org/';
40
- const REGISTRY_GITHUB = 'https://npm.pkg.github.com';
41
-
42
- module.exports = {
43
- NOMBRE_NPMJS_CANONICO,
44
- NOMBRE_GITHUB_MIRROR,
45
- NOMBRE_LEGACY_DESNUDO,
46
- NOMBRES_DETECCION,
47
- NOMBRES_VALIDOS,
48
- REGISTRY_NPMJS,
49
- REGISTRY_GITHUB,
50
- };
1
+ 'use strict';
2
+
3
+ /**
4
+ * paquetes-conocidos.js — fuente única de verdad para los nombres de
5
+ * paquete del rebrand swl-ses.
6
+ *
7
+ * Por qué existe:
8
+ * La asimetría intencional de scopes (npmjs `@saulwade/swl-ses` vs
9
+ * GitHub Packages `@saul-wade/swl-ses`) requiere que múltiples scripts
10
+ * reconozcan ambos nombres más el legacy. Tener la lista hardcodeada
11
+ * en cada archivo es violación DRY de conocimiento — un cambio futuro
12
+ * (deprecar el nombre desnudo, agregar otro mirror) requeriría editar
13
+ * varios archivos.
14
+ *
15
+ * Convenciones:
16
+ * - NOMBRE_NPMJS_CANONICO: canónico publicado en registry.npmjs.org.
17
+ * - NOMBRE_GITHUB_MIRROR: mirror publicado en npm.pkg.github.com.
18
+ * - NOMBRES_DETECCION: orden de prioridad para consultas remotas
19
+ * (canónico npmjs primero porque no requiere auth).
20
+ * - NOMBRES_VALIDOS: nombres aceptables para `package.json#name`.
21
+ * NO incluye 'swl-ses' sin scope (deprecated, eliminado en v1.0.0).
22
+ */
23
+
24
+ const NOMBRE_NPMJS_CANONICO = '@saulwade/swl-ses';
25
+ const NOMBRE_GITHUB_MIRROR = '@saul-wade/swl-ses';
26
+ const NOMBRE_LEGACY_DESNUDO = 'swl-ses';
27
+
28
+ const NOMBRES_DETECCION = Object.freeze([
29
+ NOMBRE_NPMJS_CANONICO,
30
+ NOMBRE_GITHUB_MIRROR,
31
+ NOMBRE_LEGACY_DESNUDO,
32
+ ]);
33
+
34
+ const NOMBRES_VALIDOS = Object.freeze([
35
+ NOMBRE_NPMJS_CANONICO,
36
+ NOMBRE_GITHUB_MIRROR,
37
+ ]);
38
+
39
+ const REGISTRY_NPMJS = 'https://registry.npmjs.org/';
40
+ const REGISTRY_GITHUB = 'https://npm.pkg.github.com';
41
+
42
+ module.exports = {
43
+ NOMBRE_NPMJS_CANONICO,
44
+ NOMBRE_GITHUB_MIRROR,
45
+ NOMBRE_LEGACY_DESNUDO,
46
+ NOMBRES_DETECCION,
47
+ NOMBRES_VALIDOS,
48
+ REGISTRY_NPMJS,
49
+ REGISTRY_GITHUB,
50
+ };
@@ -1,264 +1,264 @@
1
- 'use strict';
2
-
3
- /**
4
- * prompt-builder.js — Construcción dinámica de instrucciones para comandos
5
- * `/swl:*` y agentes desde un base + contexto + apéndices YAML por proyecto.
6
- *
7
- * Patrón adaptado de `temp/claudian-main/src/core/prompt/mainAgent.ts`
8
- * (plugin Obsidian Claudian, Yishen Tu, MIT). Diferencias respecto al
9
- * original:
10
- * - SWL no controla el system prompt del subagente (lo gestiona Claude
11
- * Code). Esta librería se enfoca en composición de mensajes/instrucciones
12
- * que comandos `/swl:*` o agentes generan dinámicamente al delegar.
13
- * - Zero-deps Node stdlib (sin js-yaml). Parser YAML mínimo y suficiente
14
- * para apéndices simples (key: scalar, listas y bloques `>`).
15
- *
16
- * Uso programático:
17
- * const pb = require('./scripts/lib/prompt-builder');
18
- * const apendices = pb.cargarApendices(); // lee instintos/prompt-appendices.yaml
19
- * const mensaje = pb.construirPrompt({
20
- * base: 'Implementa la fase X siguiendo el PLAN.md.',
21
- * contexto: { proyecto: 'sigaf', fase: '03-validacion' },
22
- * appendices: ['estilo_respuesta', 'restricciones_dominio'],
23
- * apendicesDisponibles: apendices,
24
- * });
25
- *
26
- * Uso CLI (debug):
27
- * node scripts/lib/prompt-builder.js --base "instr" --apendice estilo_respuesta
28
- *
29
- * @module scripts/lib/prompt-builder
30
- */
31
-
32
- const fs = require('fs');
33
- const path = require('path');
34
-
35
- const RUTA_APENDICES_DEFAULT = path.join(process.cwd(), 'instintos', 'prompt-appendices.yaml');
36
-
37
- /**
38
- * Parser YAML mínimo zero-deps. Soporta:
39
- * - claves de primer nivel con valor escalar: `key: value`
40
- * - claves con bloque `>` o `|`: continúa hasta encontrar otra clave de
41
- * primer nivel o EOF
42
- * - secciones anidadas de un nivel: `parent:\n hijo: valor`
43
- * - listas inline `key: [a, b, c]` o multilínea con `- ` (no profundas)
44
- *
45
- * NO soporta: anidamiento profundo arbitrario, anclas `&`, alias `*`, tags.
46
- * Si se requiere YAML complejo, cargar js-yaml como dependencia opcional
47
- * (NO incluido aquí por principio zero-deps).
48
- *
49
- * @param {string} texto
50
- * @returns {object}
51
- */
52
- function parsearYamlMinimo(texto) {
53
- if (!texto || typeof texto !== 'string') return {};
54
- const lineas = texto.split(/\r?\n/);
55
- const resultado = {};
56
-
57
- let claveSeccion = null;
58
- let bufferBloque = null;
59
- let claveBloque = null;
60
- let modoBloque = null;
61
- let seccionActual = null;
62
-
63
- const esLineaIndentadaSeccion = (l) => /^\s{2,}\S/.test(l);
64
- const esComentario = (l) => /^\s*#/.test(l) || l.trim() === '';
65
-
66
- function commitBloque() {
67
- if (claveBloque !== null && bufferBloque !== null) {
68
- const valor = modoBloque === '>'
69
- ? bufferBloque.replace(/\n+/g, ' ').trim()
70
- : bufferBloque.replace(/\n$/, '');
71
- if (claveSeccion) {
72
- if (!resultado[claveSeccion] || typeof resultado[claveSeccion] !== 'object') {
73
- resultado[claveSeccion] = {};
74
- }
75
- resultado[claveSeccion][claveBloque] = valor;
76
- } else {
77
- resultado[claveBloque] = valor;
78
- }
79
- }
80
- bufferBloque = null;
81
- claveBloque = null;
82
- modoBloque = null;
83
- }
84
-
85
- for (const linea of lineas) {
86
- if (claveBloque !== null) {
87
- if (esComentario(linea)) continue;
88
- if (esLineaIndentadaSeccion(linea)) {
89
- bufferBloque += linea.replace(/^\s+/, '') + '\n';
90
- continue;
91
- } else {
92
- commitBloque();
93
- }
94
- }
95
-
96
- if (esComentario(linea)) continue;
97
-
98
- const matchSeccion = linea.match(/^([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*$/);
99
- if (matchSeccion) {
100
- commitBloque();
101
- claveSeccion = matchSeccion[1];
102
- seccionActual = claveSeccion;
103
- if (!resultado[claveSeccion]) resultado[claveSeccion] = {};
104
- continue;
105
- }
106
-
107
- const matchBloque = linea.match(/^(\s*)([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*([>|])\s*$/);
108
- if (matchBloque) {
109
- const [, indent, k, modo] = matchBloque;
110
- if (indent.length > 0 && claveSeccion) {
111
- claveBloque = k;
112
- } else {
113
- commitBloque();
114
- claveSeccion = null;
115
- claveBloque = k;
116
- }
117
- bufferBloque = '';
118
- modoBloque = modo;
119
- continue;
120
- }
121
-
122
- const matchKV = linea.match(/^(\s*)([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*(.+?)\s*$/);
123
- if (matchKV) {
124
- const [, indent, k, rawV] = matchKV;
125
- const v = rawV.replace(/^["'](.*)["']$/, '$1');
126
- if (indent.length > 0 && seccionActual) {
127
- if (!resultado[seccionActual] || typeof resultado[seccionActual] !== 'object') {
128
- resultado[seccionActual] = {};
129
- }
130
- resultado[seccionActual][k] = v;
131
- } else {
132
- seccionActual = null;
133
- claveSeccion = null;
134
- resultado[k] = v;
135
- }
136
- continue;
137
- }
138
- }
139
- commitBloque();
140
- return resultado;
141
- }
142
-
143
- /**
144
- * Carga el archivo `instintos/prompt-appendices.yaml` si existe.
145
- * Retorna `{}` si no existe o si el parseo falla (zero-throw).
146
- *
147
- * @param {string} [ruta] - Ruta absoluta opcional para tests.
148
- * @returns {object} mapa de apéndices
149
- */
150
- function cargarApendices(ruta) {
151
- const r = ruta || RUTA_APENDICES_DEFAULT;
152
- try {
153
- if (!fs.existsSync(r)) return {};
154
- const contenido = fs.readFileSync(r, 'utf8');
155
- return parsearYamlMinimo(contenido);
156
- } catch {
157
- return {};
158
- }
159
- }
160
-
161
- /**
162
- * Sustituye placeholders `{clave}` en una cadena con valores del contexto.
163
- * Solo claves planas (no expresiones); valores undefined dejan el placeholder.
164
- *
165
- * @param {string} texto
166
- * @param {object} contexto
167
- * @returns {string}
168
- */
169
- function interpolar(texto, contexto) {
170
- if (!texto || !contexto) return texto || '';
171
- return String(texto).replace(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_m, clave) => {
172
- const v = contexto[clave];
173
- return v === undefined ? `{${clave}}` : String(v);
174
- });
175
- }
176
-
177
- /**
178
- * Construye un prompt/instrucción dinámico componiendo:
179
- * 1. base (obligatorio)
180
- * 2. apéndices seleccionados del catálogo (instintos/prompt-appendices.yaml)
181
- * 3. customAppend (instrucciones ad-hoc no en catálogo)
182
- *
183
- * Todos los componentes pasan por `interpolar()` con el contexto provisto.
184
- *
185
- * @param {object} opts
186
- * @param {string} opts.base - Texto base obligatorio.
187
- * @param {object} [opts.contexto] - Variables para interpolación.
188
- * @param {string[]} [opts.appendices] - Nombres de apéndices a incluir.
189
- * @param {object} [opts.apendicesDisponibles] - Catálogo (resultado de cargarApendices).
190
- * @param {string} [opts.customAppend] - Texto adicional sin pasar por catálogo.
191
- * @returns {string}
192
- */
193
- function construirPrompt(opts = {}) {
194
- const base = opts.base;
195
- if (!base || typeof base !== 'string') {
196
- throw new Error('construirPrompt: opts.base es obligatorio (string)');
197
- }
198
- const contexto = opts.contexto || {};
199
- const apendicesDisp = opts.apendicesDisponibles || {};
200
- const seleccion = Array.isArray(opts.appendices) ? opts.appendices : [];
201
-
202
- const partes = [interpolar(base, contexto).trim()];
203
-
204
- for (const nombre of seleccion) {
205
- const valor = apendicesDisp[nombre];
206
- if (valor && typeof valor === 'string' && valor.trim().length > 0) {
207
- partes.push(interpolar(valor, contexto).trim());
208
- }
209
- }
210
-
211
- if (opts.customAppend && typeof opts.customAppend === 'string' && opts.customAppend.trim()) {
212
- partes.push(interpolar(opts.customAppend, contexto).trim());
213
- }
214
-
215
- return partes.filter(Boolean).join('\n\n');
216
- }
217
-
218
- /**
219
- * Calcula un identificador estable de un prompt construido. Útil para
220
- * caché o deduplicación (mismo input → misma key).
221
- *
222
- * Patrón adaptado de `computeSystemPromptKey` de claudian.
223
- *
224
- * @param {object} opts
225
- * @returns {string}
226
- */
227
- function calcularKey(opts = {}) {
228
- const partes = [
229
- opts.base || '',
230
- JSON.stringify(opts.contexto || {}),
231
- (opts.appendices || []).join('||'),
232
- opts.customAppend || '',
233
- ];
234
- return partes.join('::');
235
- }
236
-
237
- module.exports = {
238
- construirPrompt,
239
- cargarApendices,
240
- calcularKey,
241
- _internals: {
242
- parsearYamlMinimo,
243
- interpolar,
244
- RUTA_APENDICES_DEFAULT,
245
- },
246
- };
247
-
248
- if (require.main === module) {
249
- const args = process.argv.slice(2);
250
- const opts = {};
251
- for (let i = 0; i < args.length; i++) {
252
- if (args[i] === '--base') opts.base = args[++i];
253
- else if (args[i] === '--apendice') {
254
- opts.appendices = opts.appendices || [];
255
- opts.appendices.push(args[++i]);
256
- } else if (args[i] === '--ruta-apendices') opts.rutaApendices = args[++i];
257
- }
258
- if (!opts.base) {
259
- process.stderr.write('Uso: node prompt-builder.js --base "<texto>" [--apendice <nombre>]+ [--ruta-apendices <ruta>]\n');
260
- process.exit(1);
261
- }
262
- opts.apendicesDisponibles = cargarApendices(opts.rutaApendices);
263
- process.stdout.write(construirPrompt(opts) + '\n');
264
- }
1
+ 'use strict';
2
+
3
+ /**
4
+ * prompt-builder.js — Construcción dinámica de instrucciones para comandos
5
+ * `/swl:*` y agentes desde un base + contexto + apéndices YAML por proyecto.
6
+ *
7
+ * Patrón adaptado de `temp/claudian-main/src/core/prompt/mainAgent.ts`
8
+ * (plugin Obsidian Claudian, Yishen Tu, MIT). Diferencias respecto al
9
+ * original:
10
+ * - SWL no controla el system prompt del subagente (lo gestiona Claude
11
+ * Code). Esta librería se enfoca en composición de mensajes/instrucciones
12
+ * que comandos `/swl:*` o agentes generan dinámicamente al delegar.
13
+ * - Zero-deps Node stdlib (sin js-yaml). Parser YAML mínimo y suficiente
14
+ * para apéndices simples (key: scalar, listas y bloques `>`).
15
+ *
16
+ * Uso programático:
17
+ * const pb = require('./scripts/lib/prompt-builder');
18
+ * const apendices = pb.cargarApendices(); // lee instintos/prompt-appendices.yaml
19
+ * const mensaje = pb.construirPrompt({
20
+ * base: 'Implementa la fase X siguiendo el PLAN.md.',
21
+ * contexto: { proyecto: 'sigaf', fase: '03-validacion' },
22
+ * appendices: ['estilo_respuesta', 'restricciones_dominio'],
23
+ * apendicesDisponibles: apendices,
24
+ * });
25
+ *
26
+ * Uso CLI (debug):
27
+ * node scripts/lib/prompt-builder.js --base "instr" --apendice estilo_respuesta
28
+ *
29
+ * @module scripts/lib/prompt-builder
30
+ */
31
+
32
+ const fs = require('fs');
33
+ const path = require('path');
34
+
35
+ const RUTA_APENDICES_DEFAULT = path.join(process.cwd(), 'instintos', 'prompt-appendices.yaml');
36
+
37
+ /**
38
+ * Parser YAML mínimo zero-deps. Soporta:
39
+ * - claves de primer nivel con valor escalar: `key: value`
40
+ * - claves con bloque `>` o `|`: continúa hasta encontrar otra clave de
41
+ * primer nivel o EOF
42
+ * - secciones anidadas de un nivel: `parent:\n hijo: valor`
43
+ * - listas inline `key: [a, b, c]` o multilínea con `- ` (no profundas)
44
+ *
45
+ * NO soporta: anidamiento profundo arbitrario, anclas `&`, alias `*`, tags.
46
+ * Si se requiere YAML complejo, cargar js-yaml como dependencia opcional
47
+ * (NO incluido aquí por principio zero-deps).
48
+ *
49
+ * @param {string} texto
50
+ * @returns {object}
51
+ */
52
+ function parsearYamlMinimo(texto) {
53
+ if (!texto || typeof texto !== 'string') return {};
54
+ const lineas = texto.split(/\r?\n/);
55
+ const resultado = {};
56
+
57
+ let claveSeccion = null;
58
+ let bufferBloque = null;
59
+ let claveBloque = null;
60
+ let modoBloque = null;
61
+ let seccionActual = null;
62
+
63
+ const esLineaIndentadaSeccion = (l) => /^\s{2,}\S/.test(l);
64
+ const esComentario = (l) => /^\s*#/.test(l) || l.trim() === '';
65
+
66
+ function commitBloque() {
67
+ if (claveBloque !== null && bufferBloque !== null) {
68
+ const valor = modoBloque === '>'
69
+ ? bufferBloque.replace(/\n+/g, ' ').trim()
70
+ : bufferBloque.replace(/\n$/, '');
71
+ if (claveSeccion) {
72
+ if (!resultado[claveSeccion] || typeof resultado[claveSeccion] !== 'object') {
73
+ resultado[claveSeccion] = {};
74
+ }
75
+ resultado[claveSeccion][claveBloque] = valor;
76
+ } else {
77
+ resultado[claveBloque] = valor;
78
+ }
79
+ }
80
+ bufferBloque = null;
81
+ claveBloque = null;
82
+ modoBloque = null;
83
+ }
84
+
85
+ for (const linea of lineas) {
86
+ if (claveBloque !== null) {
87
+ if (esComentario(linea)) continue;
88
+ if (esLineaIndentadaSeccion(linea)) {
89
+ bufferBloque += linea.replace(/^\s+/, '') + '\n';
90
+ continue;
91
+ } else {
92
+ commitBloque();
93
+ }
94
+ }
95
+
96
+ if (esComentario(linea)) continue;
97
+
98
+ const matchSeccion = linea.match(/^([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*$/);
99
+ if (matchSeccion) {
100
+ commitBloque();
101
+ claveSeccion = matchSeccion[1];
102
+ seccionActual = claveSeccion;
103
+ if (!resultado[claveSeccion]) resultado[claveSeccion] = {};
104
+ continue;
105
+ }
106
+
107
+ const matchBloque = linea.match(/^(\s*)([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*([>|])\s*$/);
108
+ if (matchBloque) {
109
+ const [, indent, k, modo] = matchBloque;
110
+ if (indent.length > 0 && claveSeccion) {
111
+ claveBloque = k;
112
+ } else {
113
+ commitBloque();
114
+ claveSeccion = null;
115
+ claveBloque = k;
116
+ }
117
+ bufferBloque = '';
118
+ modoBloque = modo;
119
+ continue;
120
+ }
121
+
122
+ const matchKV = linea.match(/^(\s*)([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*(.+?)\s*$/);
123
+ if (matchKV) {
124
+ const [, indent, k, rawV] = matchKV;
125
+ const v = rawV.replace(/^["'](.*)["']$/, '$1');
126
+ if (indent.length > 0 && seccionActual) {
127
+ if (!resultado[seccionActual] || typeof resultado[seccionActual] !== 'object') {
128
+ resultado[seccionActual] = {};
129
+ }
130
+ resultado[seccionActual][k] = v;
131
+ } else {
132
+ seccionActual = null;
133
+ claveSeccion = null;
134
+ resultado[k] = v;
135
+ }
136
+ continue;
137
+ }
138
+ }
139
+ commitBloque();
140
+ return resultado;
141
+ }
142
+
143
+ /**
144
+ * Carga el archivo `instintos/prompt-appendices.yaml` si existe.
145
+ * Retorna `{}` si no existe o si el parseo falla (zero-throw).
146
+ *
147
+ * @param {string} [ruta] - Ruta absoluta opcional para tests.
148
+ * @returns {object} mapa de apéndices
149
+ */
150
+ function cargarApendices(ruta) {
151
+ const r = ruta || RUTA_APENDICES_DEFAULT;
152
+ try {
153
+ if (!fs.existsSync(r)) return {};
154
+ const contenido = fs.readFileSync(r, 'utf8');
155
+ return parsearYamlMinimo(contenido);
156
+ } catch {
157
+ return {};
158
+ }
159
+ }
160
+
161
+ /**
162
+ * Sustituye placeholders `{clave}` en una cadena con valores del contexto.
163
+ * Solo claves planas (no expresiones); valores undefined dejan el placeholder.
164
+ *
165
+ * @param {string} texto
166
+ * @param {object} contexto
167
+ * @returns {string}
168
+ */
169
+ function interpolar(texto, contexto) {
170
+ if (!texto || !contexto) return texto || '';
171
+ return String(texto).replace(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_m, clave) => {
172
+ const v = contexto[clave];
173
+ return v === undefined ? `{${clave}}` : String(v);
174
+ });
175
+ }
176
+
177
+ /**
178
+ * Construye un prompt/instrucción dinámico componiendo:
179
+ * 1. base (obligatorio)
180
+ * 2. apéndices seleccionados del catálogo (instintos/prompt-appendices.yaml)
181
+ * 3. customAppend (instrucciones ad-hoc no en catálogo)
182
+ *
183
+ * Todos los componentes pasan por `interpolar()` con el contexto provisto.
184
+ *
185
+ * @param {object} opts
186
+ * @param {string} opts.base - Texto base obligatorio.
187
+ * @param {object} [opts.contexto] - Variables para interpolación.
188
+ * @param {string[]} [opts.appendices] - Nombres de apéndices a incluir.
189
+ * @param {object} [opts.apendicesDisponibles] - Catálogo (resultado de cargarApendices).
190
+ * @param {string} [opts.customAppend] - Texto adicional sin pasar por catálogo.
191
+ * @returns {string}
192
+ */
193
+ function construirPrompt(opts = {}) {
194
+ const base = opts.base;
195
+ if (!base || typeof base !== 'string') {
196
+ throw new Error('construirPrompt: opts.base es obligatorio (string)');
197
+ }
198
+ const contexto = opts.contexto || {};
199
+ const apendicesDisp = opts.apendicesDisponibles || {};
200
+ const seleccion = Array.isArray(opts.appendices) ? opts.appendices : [];
201
+
202
+ const partes = [interpolar(base, contexto).trim()];
203
+
204
+ for (const nombre of seleccion) {
205
+ const valor = apendicesDisp[nombre];
206
+ if (valor && typeof valor === 'string' && valor.trim().length > 0) {
207
+ partes.push(interpolar(valor, contexto).trim());
208
+ }
209
+ }
210
+
211
+ if (opts.customAppend && typeof opts.customAppend === 'string' && opts.customAppend.trim()) {
212
+ partes.push(interpolar(opts.customAppend, contexto).trim());
213
+ }
214
+
215
+ return partes.filter(Boolean).join('\n\n');
216
+ }
217
+
218
+ /**
219
+ * Calcula un identificador estable de un prompt construido. Útil para
220
+ * caché o deduplicación (mismo input → misma key).
221
+ *
222
+ * Patrón adaptado de `computeSystemPromptKey` de claudian.
223
+ *
224
+ * @param {object} opts
225
+ * @returns {string}
226
+ */
227
+ function calcularKey(opts = {}) {
228
+ const partes = [
229
+ opts.base || '',
230
+ JSON.stringify(opts.contexto || {}),
231
+ (opts.appendices || []).join('||'),
232
+ opts.customAppend || '',
233
+ ];
234
+ return partes.join('::');
235
+ }
236
+
237
+ module.exports = {
238
+ construirPrompt,
239
+ cargarApendices,
240
+ calcularKey,
241
+ _internals: {
242
+ parsearYamlMinimo,
243
+ interpolar,
244
+ RUTA_APENDICES_DEFAULT,
245
+ },
246
+ };
247
+
248
+ if (require.main === module) {
249
+ const args = process.argv.slice(2);
250
+ const opts = {};
251
+ for (let i = 0; i < args.length; i++) {
252
+ if (args[i] === '--base') opts.base = args[++i];
253
+ else if (args[i] === '--apendice') {
254
+ opts.appendices = opts.appendices || [];
255
+ opts.appendices.push(args[++i]);
256
+ } else if (args[i] === '--ruta-apendices') opts.rutaApendices = args[++i];
257
+ }
258
+ if (!opts.base) {
259
+ process.stderr.write('Uso: node prompt-builder.js --base "<texto>" [--apendice <nombre>]+ [--ruta-apendices <ruta>]\n');
260
+ process.exit(1);
261
+ }
262
+ opts.apendicesDisponibles = cargarApendices(opts.rutaApendices);
263
+ process.stdout.write(construirPrompt(opts) + '\n');
264
+ }