@saulwade/swl-ses 1.5.1 → 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.
- package/CLAUDE.md +225 -209
- package/README.md +561 -561
- package/agentes/arquitecto-swl.md +33 -1
- package/agentes/nemesis-auditor-swl.md +59 -19
- package/bin/swl-mcp-server.js +214 -214
- package/comandos/swl/.evolved.json +22 -22
- package/comandos/swl/contribuir.md +233 -233
- package/comandos/swl/nemesis.md +230 -56
- package/gateway/lib/event-channel.js +191 -191
- package/habilidades/backend-production-resilience/SKILL.md +288 -288
- package/habilidades/benchmark-memoria/SKILL.md +186 -186
- package/habilidades/diagrama-arquitectura/assets/template.html +276 -276
- package/habilidades/doubt-driven-review/SKILL.md +171 -171
- package/habilidades/doubt-driven-review/recursos/EXAMPLES.md +130 -130
- package/habilidades/ejecutar-task-iterativo/SKILL.md +278 -278
- package/habilidades/eval-framework/SKILL.md +212 -212
- package/habilidades/feynman-auditor-swl/SKILL.md +123 -123
- package/habilidades/feynman-auditor-swl/recursos/preguntas-language-agnostic.md +108 -108
- package/habilidades/harness-claude-code/SKILL.md +299 -299
- package/habilidades/infra-github-actions/SKILL.md +166 -166
- package/habilidades/legacy-code-rescue/SKILL.md +267 -267
- package/habilidades/manejo-errores/.evolved.json +8 -8
- package/habilidades/meta-skills-estandar/SKILL.md +207 -4
- package/habilidades/meta-skills-estandar/recursos/convencion-examples.md +93 -93
- package/habilidades/meta-skills-estandar/recursos/skills-as-agents.md +163 -163
- package/habilidades/nemesis-evaluacion-json/SKILL.md +266 -0
- package/habilidades/nemesis-redistribuir/SKILL.md +341 -0
- package/habilidades/node-experto/SKILL.md +94 -4
- package/habilidades/patrones-python/SKILL.md +229 -229
- package/habilidades/patrones-python/recursos/patrones-avanzados.md +469 -469
- package/habilidades/planear-fase/SKILL.md +319 -319
- package/habilidades/protocolo-revision-swl/SKILL.md +350 -276
- package/habilidades/release-semver/.evolved.json +8 -8
- package/habilidades/state-inconsistency-auditor-swl/SKILL.md +166 -166
- package/habilidades/state-inconsistency-auditor-swl/recursos/coupled-state-patterns.md +147 -147
- package/habilidades/tdd-workflow/SKILL.md +121 -4
- package/habilidades/testing-python/SKILL.md +340 -340
- package/habilidades/web-fetcher-routing/SKILL.md +75 -75
- package/hooks/check-update.js +31 -3
- package/hooks/claudemd-bloat-detector.js +161 -161
- package/hooks/lib/agent-routing.js +107 -107
- package/hooks/lib/auto-consolidator.js +335 -335
- package/hooks/lib/error-classifier.js +308 -308
- package/hooks/lib/merkle-audit.js +96 -96
- package/hooks/lib/provenance-tracker.js +191 -191
- package/hooks/lib/rate-limit-tracker.js +253 -253
- package/hooks/lib/resource-quota.js +122 -122
- package/hooks/lib/retry-jitter.js +165 -165
- package/hooks/lib/security-net.js +201 -201
- package/hooks/lib/skill-auditor.js +588 -588
- package/hooks/lib/sync-status.js +228 -228
- package/hooks/lib/taint-tracker.js +107 -107
- package/hooks/lib/text-similarity.js +241 -241
- package/hooks/lib/toon-compressor.js +245 -245
- package/hooks/registro-turnos.js +209 -209
- package/hooks/sugerir-regenerar-inventario.js +170 -170
- package/hooks/validar-formato-post-subagente.js +140 -140
- package/hooks/validar-memoria-hook.js +218 -218
- package/instintos/prompt-appendices.yaml +57 -57
- package/manifiestos/agent-output-schemas.json +57 -57
- package/manifiestos/modulos.json +1324 -1321
- package/manifiestos/skills-lock.json +1114 -1114
- package/package.json +2 -2
- package/plantillas/auditor-veto-template.md +105 -105
- package/plantillas/github-workflows/README.md +47 -47
- package/plantillas/github-workflows/release-please.yml +44 -44
- package/plantillas/github-workflows/swl-ci.yml +107 -107
- package/plantillas/github-workflows/swl-security.yml +51 -51
- package/plugin.json +353 -351
- package/reglas/analisis-previo-tareas-grandes.md +172 -172
- package/reglas/arreglar-al-detectar.md +147 -147
- package/reglas/fragmentos-compartidos.md +152 -152
- package/reglas/harness-claude-code.md +213 -213
- package/reglas/registro-componentes-nuevos.md +192 -0
- package/reglas/usar-context7.md +226 -226
- package/schemas/diary-entry.schema.json +80 -80
- package/scripts/actualizar.js +110 -1
- package/scripts/audit-tools/audit-history.js +330 -330
- package/scripts/audit-tools/bundle-tracker.js +290 -290
- package/scripts/audit-tools/canary-monitor.js +352 -352
- package/scripts/audit-tools/code-profiler.js +605 -605
- package/scripts/audit-tools/dep-doctor.js +320 -320
- package/scripts/audit-tools/env-validator.js +206 -206
- package/scripts/audit-tools/lib/fs-walk.js +48 -48
- package/scripts/audit-tools/lib/output.js +23 -23
- package/scripts/audit-tools/migration-checker.js +392 -392
- package/scripts/audit-tools/pentest-scanner.js +1436 -1436
- package/scripts/benchmark-memoria.js +167 -167
- package/scripts/configurar-branch-protection.js +418 -418
- package/scripts/derivar-feature-list.js +489 -489
- package/scripts/detectar-aprendizajes-duplicados.js +151 -151
- package/scripts/doctor.js +27 -0
- package/scripts/field-report.js +199 -199
- package/scripts/generar-checklists-consolidados.js +273 -273
- package/scripts/generar-inventario.js +420 -420
- package/scripts/generar-matriz-lenguajes.js +271 -271
- package/scripts/lib/artefactos-python.js +43 -43
- package/scripts/lib/benchmark-metrics.js +160 -160
- package/scripts/lib/budget-enforcer.js +252 -252
- package/scripts/lib/configurar-ci.js +380 -380
- package/scripts/lib/contadores-inventario.js +217 -217
- package/scripts/lib/detectar-stack-detallado.js +307 -307
- package/scripts/lib/diary-entry.js +234 -234
- package/scripts/lib/eval-metrics-store.js +218 -218
- package/scripts/lib/eval-quality.js +171 -171
- package/scripts/lib/eval-schemas.js +144 -144
- package/scripts/lib/eval-self-correct.js +106 -106
- package/scripts/lib/eval-validator.js +185 -185
- package/scripts/lib/expandir-targets.js +71 -71
- package/scripts/lib/jaccard-similarity.js +98 -98
- package/scripts/lib/longmemeval-runner.js +125 -125
- package/scripts/lib/mcp_config.py +127 -0
- package/scripts/lib/npm-version.js +261 -261
- package/scripts/lib/paquetes-conocidos.js +50 -50
- package/scripts/lib/prompt-builder.js +264 -264
- package/scripts/lib/rrf-fusion.js +175 -175
- package/scripts/lib/scoring-instintos.js +277 -277
- package/scripts/lib/semantic-search.js +252 -252
- package/scripts/lib/toml-merge.js +204 -204
- package/scripts/lib/transformadores/codex.js +375 -375
- package/scripts/lib/transformadores/cursor.js +359 -359
- package/scripts/limpiar-artefactos-python.js +131 -131
- package/scripts/mcp-orchestrator.py +8 -18
- package/scripts/mcp-pool-manager.py +12 -23
- package/scripts/mcp-server/README.md +170 -170
- package/scripts/mcp-server/auth.js +105 -105
- package/scripts/mcp-server/cache.js +106 -106
- package/scripts/mcp-server/telemetry.js +78 -78
- package/scripts/migrar-csv-a-array.js +168 -168
- package/scripts/migrar-fase-dominio.js +201 -201
- package/scripts/publicar.js +511 -511
- package/scripts/run-eval.js +141 -141
- 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
|
+
}
|