orca-multiagent-kit 1.1.0 → 1.3.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 (63) hide show
  1. package/AI_INSTALL.md +3 -0
  2. package/CHANGELOG.md +51 -1
  3. package/README.md +10 -4
  4. package/VERSION +1 -1
  5. package/bin/omk.js +54 -20
  6. package/bin/ui.js +165 -0
  7. package/core/AGENTS.md +32 -29
  8. package/docs/CSR.md +95 -0
  9. package/docs/INSTALADOR-ORCA-WINDOWS.md +101 -0
  10. package/docs/MANUAL.md +3 -1
  11. package/docs/ORQUESTADOR.md +123 -0
  12. package/docs/PLUGIN-ORCA.md +102 -0
  13. package/install.sh +282 -92
  14. package/orca-plugin/.gitattributes +1 -0
  15. package/orca-plugin/README.md +12 -0
  16. package/orca-plugin/orca-plugin.json +80 -0
  17. package/orca-plugin/src/kit.test.ts +174 -0
  18. package/orca-plugin/src/kit.ts +141 -0
  19. package/orca-plugin/src/worker.test.ts +155 -0
  20. package/orca-plugin/src/worker.ts +182 -0
  21. package/orca-plugin/tsconfig.json +6 -0
  22. package/package.json +2 -2
  23. package/rules/00-router.md +2 -1
  24. package/rules/10-communication.md +11 -12
  25. package/rules/20-clean-code.md +7 -3
  26. package/rules/30-security.md +1 -1
  27. package/rules/31-security-audit.md +6 -2
  28. package/rules/32-ai-security.md +59 -0
  29. package/rules/40-testing.md +7 -0
  30. package/rules/50-done-gate.md +20 -17
  31. package/rules/60-git-workflow.md +1 -1
  32. package/rules/75-reliability.md +3 -3
  33. package/rules/80-supply-chain.md +18 -11
  34. package/rules/95-multi-agent.md +30 -9
  35. package/rules/lang/cpp.md +1 -1
  36. package/rules/lang/csharp.md +4 -4
  37. package/rules/lang/dart-flutter.md +1 -1
  38. package/rules/lang/infra.md +3 -4
  39. package/rules/lang/kotlin.md +1 -1
  40. package/rules/lang/php.md +1 -1
  41. package/rules/lang/shell.md +17 -1
  42. package/skills/csr-audit/SKILL.md +6 -5
  43. package/skills/csr-gate/SKILL.md +12 -8
  44. package/skills/csr-stack/SKILL.md +6 -3
  45. package/skills/orca/SKILL.md +17 -12
  46. package/skills/orca/references/adapters/artifact.md +1 -1
  47. package/skills/orca/references/adapters/chat.md +1 -1
  48. package/skills/orca/references/adapters/native-plan.md +1 -1
  49. package/skills/orca/references/adapters/plan-file.md +1 -1
  50. package/skills/orca/references/adapters/speckit.md +2 -0
  51. package/skills/orca/references/engine-manual.md +5 -5
  52. package/skills/orca/references/engine-orca.md +64 -23
  53. package/skills/orca/references/engine-subagents.md +13 -4
  54. package/skills/orca/references/integrate.md +27 -15
  55. package/skills/orca/references/ledger.md +56 -0
  56. package/skills/orca/references/race.md +1 -0
  57. package/skills/orca/references/setup.md +3 -2
  58. package/skills/orca/references/units.md +7 -0
  59. package/skills/orca/references/worker-contract.md +24 -11
  60. package/skills/speckit-orca-implement/SKILL.md +2 -0
  61. package/speckit-extension/orca/commands/implement.md +2 -0
  62. package/templates/ORCHESTRATION.md +4 -0
  63. package/templates/STACK.md +2 -2
@@ -0,0 +1,182 @@
1
+ // Worker del plugin: comandos de paleta del kit, referencia al contrato del worker en los
2
+ // despachos de orquestación y un resumen de agentes en la barra de estado.
3
+ // Orca transpila este fichero al cargarlo: no hay paso de build.
4
+ import type { OrcaWorkerApi } from 'orca/worker'
5
+ import {
6
+ INSTALL_HINT,
7
+ describeAgents,
8
+ isMissingCommand,
9
+ isValidAgentId,
10
+ parseContractHintMode,
11
+ pollUntil,
12
+ resolveFocusedWorkspaceId,
13
+ summarizeAgents,
14
+ withContractHint,
15
+ type ContractHintMode,
16
+ type TrackedAgent
17
+ } from './kit.ts'
18
+
19
+ const STATUS_ITEM = 'agents'
20
+ const INIT_PROMPT = 'inicializa el proyecto'
21
+ const DEFAULT_INIT_AGENT = 'claude'
22
+ // `omk verify` tarda poco; si en ~15 s no hay error de "comando no encontrado", existe.
23
+ const MISSING_CHECK = { attempts: 10, delayMs: 1500 }
24
+ const NO_WORKSPACE =
25
+ 'No identifico el workspace activo. Abre el proyecto en Orca y vuelve a lanzar el comando.'
26
+
27
+ type OmkSubcommand = 'verify' | 'update'
28
+
29
+ // Esperas pendientes de las comprobaciones de `omk`: `deactivate` las cancela al parar el worker.
30
+ const pendingTimers = new Set<ReturnType<typeof setTimeout>>()
31
+ const sleep = (ms: number) =>
32
+ new Promise<void>((resolve) => {
33
+ const timer = setTimeout(() => {
34
+ pendingTimers.delete(timer)
35
+ resolve()
36
+ }, ms)
37
+ pendingTimers.add(timer)
38
+ })
39
+
40
+ export function deactivate(): void {
41
+ for (const timer of pendingTimers) clearTimeout(timer)
42
+ pendingTimers.clear()
43
+ }
44
+ // Los errores del host son `Error` con `code` (host-api §Errors); el tipo no lo declara.
45
+ const describeError = (error: unknown) =>
46
+ error instanceof Error ? `${(error as { code?: string }).code ?? 'error'}: ${error.message}` : String(error)
47
+
48
+ export default async function activate(orca: OrcaWorkerApi): Promise<void> {
49
+ const { host } = orca
50
+ let contractHint: ContractHintMode = 'kit'
51
+ let statusBarEnabled = true
52
+ let initAgent: unknown = DEFAULT_INIT_AGENT
53
+ const agents = new Map<string, TrackedAgent>()
54
+
55
+ const notify = (title: string, body: string) => {
56
+ void host.call('notifications.show', { title, body }).catch((error: unknown) => {
57
+ orca.log(`notificación no entregada (${title}): ${describeError(error)}`)
58
+ })
59
+ }
60
+
61
+ // Un fallo de Orca en un comando se cuenta al usuario; nunca se queda en silencio.
62
+ const guarded = (label: string, run: () => Promise<string>) => async () => {
63
+ try {
64
+ return await run()
65
+ } catch (error) {
66
+ const message = `${label}: ${describeError(error)}`
67
+ orca.log(message)
68
+ notify('Orca Multiagent Kit', message)
69
+ return message
70
+ }
71
+ }
72
+
73
+ const focusedWorkspaceId = async () => {
74
+ const [focused, list] = await Promise.all([
75
+ host.call('workspace.readContext'),
76
+ host.call('workspace.list')
77
+ ])
78
+ return resolveFocusedWorkspaceId(focused, list.workspaces)
79
+ }
80
+
81
+ const renderStatus = () => {
82
+ const summary = summarizeAgents(agents.values())
83
+ const update = statusBarEnabled
84
+ ? { id: STATUS_ITEM, visible: true, text: summary.text, tone: summary.tone, tooltip: summary.tooltip }
85
+ : { id: STATUS_ITEM, visible: false }
86
+ void host.call('statusBar.update', update).catch((error: unknown) => {
87
+ orca.log(`barra de estado sin actualizar: ${describeError(error)}`)
88
+ })
89
+ }
90
+
91
+ const loadSettings = async () => {
92
+ try {
93
+ const settings = await orca.settings.get()
94
+ contractHint = parseContractHintMode(settings.contractHint)
95
+ statusBarEnabled = settings.statusBar !== false
96
+ initAgent = settings.initAgent ?? DEFAULT_INIT_AGENT
97
+ } catch (error) {
98
+ orca.log(`ajustes no leídos, uso los valores por defecto: ${describeError(error)}`)
99
+ }
100
+ }
101
+
102
+ const warnIfOmkMissing = async (terminalId: string) => {
103
+ const missing = await pollUntil(
104
+ async () => (await host.call('terminal.read', { terminalId, maxLines: 40 })).lines,
105
+ (lines) => isMissingCommand(lines),
106
+ { ...MISSING_CHECK, sleep }
107
+ )
108
+ if (missing) notify('omk no está instalado', INSTALL_HINT)
109
+ }
110
+
111
+ const runOmk = (subcommand: OmkSubcommand) =>
112
+ guarded(`omk ${subcommand}`, async () => {
113
+ const workspaceId = await focusedWorkspaceId()
114
+ if (!workspaceId) {
115
+ notify('Orca Multiagent Kit', NO_WORKSPACE)
116
+ return NO_WORKSPACE
117
+ }
118
+ // Literal fijo: nunca se interpola texto del usuario ni de terceros en el terminal.
119
+ const command = `omk ${subcommand}`
120
+ const { terminalId } = await host.call('terminal.create', { workspaceId, title: command, command })
121
+ void warnIfOmkMissing(terminalId).catch((error: unknown) => {
122
+ orca.log(`no pude leer la salida de ${command}: ${describeError(error)}`)
123
+ })
124
+ return `Ejecutando \`${command}\` en un terminal nuevo del workspace activo.`
125
+ })
126
+
127
+ const initProject = guarded('inicializar proyecto', async () => {
128
+ if (!isValidAgentId(initAgent)) {
129
+ const message = `El ajuste «Agente para inicializar» no es un id de agente válido: ${String(initAgent)}`
130
+ notify('Orca Multiagent Kit', message)
131
+ return message
132
+ }
133
+ const workspaceId = await focusedWorkspaceId()
134
+ if (!workspaceId) {
135
+ notify('Orca Multiagent Kit', NO_WORKSPACE)
136
+ return NO_WORKSPACE
137
+ }
138
+ await host.call('agent.launch', { workspaceId, agent: initAgent, prompt: INIT_PROMPT })
139
+ return `Lanzado ${initAgent} con «${INIT_PROMPT}» (skill kit-init) en el workspace activo.`
140
+ })
141
+
142
+ // El hook no deniega nunca: si no aplica, el prompt pasa intacto. Un fallo o un timeout
143
+ // también lo dejan pasar (`onError: "pass"`): es una ayuda al worker, no un control.
144
+ orca.hooks.on('agent.prompt.before', (event, next) => {
145
+ const prompt = withContractHint(event.prompt, event.inputKind, contractHint)
146
+ return prompt === null ? undefined : next({ ...event, prompt })
147
+ })
148
+
149
+ orca.commands.register('kit.verify', runOmk('verify'))
150
+ orca.commands.register('kit.update', runOmk('update'))
151
+ orca.commands.register('kit.init', initProject)
152
+ orca.commands.register('agents.status', async () => describeAgents(agents.values()))
153
+
154
+ orca.events.on('agent.status.changed', (event) => {
155
+ const key = event.terminalId ? `t:${event.terminalId}` : `p:${event.paneKey}`
156
+ if (event.state === 'done') agents.delete(key)
157
+ else agents.set(key, { workspaceId: event.workspaceId, title: event.title ?? null, state: event.state })
158
+ renderStatus()
159
+ })
160
+
161
+ orca.events.on('workspace.removed', (event) => {
162
+ for (const [key, agent] of agents) if (agent.workspaceId === event.workspaceId) agents.delete(key)
163
+ renderStatus()
164
+ })
165
+
166
+ orca.settings.onDidChange(() => {
167
+ void loadSettings().then(renderStatus)
168
+ })
169
+
170
+ await loadSettings()
171
+ try {
172
+ const { agents: current } = await host.call('agents.list')
173
+ for (const agent of current) {
174
+ if (agent.terminalId && agent.state !== 'done') {
175
+ agents.set(`t:${agent.terminalId}`, { workspaceId: null, title: agent.title, state: agent.state })
176
+ }
177
+ }
178
+ } catch (error) {
179
+ orca.log(`agentes iniciales no leídos; la barra se rellena con los eventos: ${describeError(error)}`)
180
+ }
181
+ renderStatus()
182
+ }
@@ -0,0 +1,6 @@
1
+ {
2
+ "extends": "./.orca/types/tsconfig.json",
3
+ "include": [
4
+ "src"
5
+ ]
6
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "orca-multiagent-kit",
3
- "version": "1.1.0",
3
+ "version": "1.3.0",
4
4
  "description": "Una sola fuente de reglas y skills (CSR + MAW) para Claude Code, Antigravity, Codex, Copilot y Cursor, con orquestación multiagente.",
5
5
  "license": "MIT",
6
6
  "author": "Fernando Baquero (https://github.com/FernandoBaqueroo)",
@@ -13,7 +13,7 @@
13
13
  "orca-multiagent-kit": "bin/omk.js"
14
14
  },
15
15
  "files": [
16
- "bin/", "speckit-extension/", "core/", "rules/", "skills/", "templates/", "output-styles/", "docs/",
16
+ "bin/", "speckit-extension/", "core/", "rules/", "skills/", "templates/", "output-styles/", "docs/", "orca-plugin/",
17
17
  "install.sh", "VERSION", "GUIA.html", "AI_INSTALL.md", "CHANGELOG.md", "LICENSE", "README.md"
18
18
  ],
19
19
  "engines": { "node": ">=18" },
@@ -7,7 +7,8 @@ Carga progresiva: el núcleo (`~/.agents/AGENTS.md`) está siempre en contexto;
7
7
  | `10-communication.md` | El usuario se queja del formato, pide verbosidad, o dudas de estilo | ~600 tok |
8
8
  | `20-clean-code.md` | Escribir, revisar o refactorizar cualquier código | ~1.100 tok |
9
9
  | `30-security.md` | Siempre que se escriba código de producción | ~1.300 tok |
10
- | `31-security-audit.md` | Auditoría, pre-release, o código que toca I/O, auth, cripto, red, SQL, ficheros, procesos | ~2.000 tok |
10
+ | `31-security-audit.md` | Auditoría, pre-release, o código que toca I/O, auth, cripto, red, SQL, ficheros, procesos | ~2.100 tok |
11
+ | `32-ai-security.md` | Código que llama a un LLM, construye prompts, hace RAG o define agentes, herramientas o MCP | ~1.800 tok |
11
12
  | `40-testing.md` | Escribir/arreglar tests o definir cobertura | ~1.200 tok |
12
13
  | `50-done-gate.md` | Antes de declarar una tarea terminada | ~1.100 tok |
13
14
  | `60-git-workflow.md` | Commit, rama, PR, release | ~700 tok |
@@ -1,7 +1,7 @@
1
1
  # 10 — Protocolo de comunicación: casos y ejemplos
2
2
 
3
- > Las reglas duras están en `~/.agents/AGENTS.md` §2 y no se repiten aquí.
4
- > Este fichero solo cubre lo que no cabe en el núcleo: prefijos, disparadores de detalle, excepciones y ejemplos.
3
+ > Las reglas duras (formato largo, excepciones a la brevedad, preguntas) están en `~/.agents/AGENTS.md` §2 y no se repiten aquí.
4
+ > Este fichero solo cubre lo que no cabe en el núcleo: significado de los prefijos, matices y ejemplos.
5
5
 
6
6
  ## Principio
7
7
  Los tokens de prosa son gasto. Los de razonamiento y código son inversión. Comprime lo primero; no toques lo segundo.
@@ -13,15 +13,11 @@ Los tokens de prosa son gasto. Los de razonamiento y código son inversión. Com
13
13
  - `CONFLICT:` una regla superior contradice a otra (ver precedencia en §0 del núcleo).
14
14
  - `DEFERRED:` fuera de alcance, o no hecho, y por qué.
15
15
 
16
- ## Cuándo extenderse
17
- Disparadores explícitos del usuario: `explica`, `detalla`, `justifica`, `compara`, `--verbose`, `why`, `walk me through`.
18
- También cuando el producto es un documento para terceros (ADR, README, informe, PR): ahí escribes para esa audiencia, con la extensión que merezca, no para el chat.
19
-
20
- ## Excepciones obligatorias a la brevedad (claridad por encima del ahorro)
21
- - Avisos de seguridad y acciones irreversibles: frase completa e inequívoca.
22
- - Secuencias donde el orden importa: migraciones, despliegues, rollback.
23
- - Cuando comprimir crearía ambigüedad técnica.
24
- - Cuando el usuario repite una pregunta: significa que la respuesta anterior no se entendió.
16
+ ## Matices de las excepciones a la brevedad
17
+ - Disparadores de detalle: además de los del núcleo, `walk me through` y equivalentes en cualquier idioma.
18
+ - Documento para terceros (ADR, README, informe, PR): escribes para esa audiencia, con la extensión que merezca, no para el chat.
19
+ - Comprimir no puede crear ambigüedad técnica: si una frase corta admite dos lecturas, usa la larga.
20
+ - Si el usuario repite una pregunta, la respuesta anterior no se entendió: cambia el enfoque, no la repitas más corta.
25
21
 
26
22
  ## Ejemplos
27
23
  Mal: «¡Buena pregunta! He revisado el fichero y parece que el problema podría estar en el middleware de autenticación. Voy a arreglarlo ahora.»
@@ -33,6 +29,9 @@ Bien: `4 ficheros, +120/-31. Gates: PASS.`
33
29
  Mal: pegar 80 líneas de stack trace.
34
30
  Bien: `FAIL test_transfer: expected 0, got -50 (overdraft.rs:44). Falta la comprobación de saldo.`
35
31
 
32
+ Mal: «Todo listo, debería funcionar.» (sin haber ejecutado nada)
33
+ Bien: `test: SKIPPED (no hay runner en STACK.md §3). Verificado a mano: curl /health → 200.`
34
+
36
35
  ## Lectura de ficheros
37
36
  Lee solo lo necesario, con búsqueda dirigida (grep/glob/símbolo) en vez de volcar ficheros enteros. No vuelques en el chat lo leído: solo el fragmento decisivo.
38
37
 
@@ -41,7 +40,7 @@ Lee solo lo necesario, con búsqueda dirigida (grep/glob/símbolo) en vez de vol
41
40
  - Pregunta solo si la ambigüedad cambia el resultado de forma material (arquitecturas incompatibles) o la acción es irreversible o de alto impacto (borrar datos, producción, migraciones). Una pregunta concreta, no una lista.
42
41
 
43
42
  ## Nivel técnico del usuario
44
- Desarrollador fullstack (Next.js/React, Node.js/Express, TypeScript, PostgreSQL/Supabase, Docker, CI/CD, Google Cloud). Da por sabidos los conceptos estándar (async/await, contenedores, REST, SQL, transacciones): sin glosarios ni analogías. Contexto histórico o teórico solo si lo pide ("por qué existe X").
43
+ El perfil (rol, stack habitual, nivel) va en `~/.agents/rules/personal.md`, que el kit no toca. Sin perfil, asume un desarrollador profesional: da por sabidos los conceptos estándar (async/await, contenedores, REST, SQL, transacciones), sin glosarios ni analogías. Contexto histórico o teórico solo si lo pide ("por qué existe X").
45
44
 
46
45
  ## Tabla de comportamiento
47
46
  | Situación | Comportamiento |
@@ -44,9 +44,13 @@ Escribe código que parezca escrito por quien ya mantenía el repo: mismas conve
44
44
  - Prefiere composición a herencia; herencia solo para sustitución real (LSP).
45
45
 
46
46
  ## Comentarios
47
- - Explican **por qué**, nunca **qué**. Si el comentario explica el qué, renombra el código.
48
- - Comentario obligatorio en: decisiones no obvias, workarounds (con enlace al issue), invariantes, complejidad algorítmica elegida, cualquier supresión de lint/tipo.
49
- - Prohibido: código comentado, changelogs en cabecera, comentarios obsoletos.
47
+ Explican **por qué**, nunca **qué**: si explica el qué, renombra el código. Cuándo son obligatorios y qué está prohibido: `90-docs-comments.md` §Comentarios.
48
+
49
+ ## Código generado con IA
50
+ - Lee lo que vas a entregar como si lo hubiera escrito otro: el código plausible no es código correcto.
51
+ - Cada import, función, flag o endpoint de un tercero se verifica contra la versión instalada (tipos, `--help`, docs de esa versión), no contra la memoria.
52
+ - Sin sobreingeniería por defecto: ni capas, ni opciones, ni manejo de casos que el requisito no pide (YAGNI aplica doble).
53
+ - Diff mínimo: no reformatees, renombres ni "mejores" código que no forma parte del cambio.
50
54
 
51
55
  ## Olores que obligan a refactor
52
56
  Función >40 líneas · clase >300 líneas · >3 niveles de anidamiento · lista de parámetros larga · envidia de características · obsesión por primitivos · cadenas de `if/else` sobre tipo (usa polimorfismo o match exhaustivo) · retorno de `null` como señal · booleano de control de flujo · dependencia circular · nombre con `Manager`/`Helper`/`Utils` sin significado.
@@ -78,4 +78,4 @@ Todo lo externo es hostil: body, query, headers, cookies, path, ficheros, variab
78
78
  Antes de añadir una dependencia: ¿es necesaria?, ¿mantenida?, ¿CVE abiertos?, ¿licencia compatible?, ¿cuántas transitivas arrastra? Ver `80-supply-chain.md`.
79
79
 
80
80
  ## C12. Específico de IA/LLM
81
- Trata toda salida de modelo, MCP o herramienta externa como entrada no confiable (inyección de prompt indirecta). Nunca ejecutes ni renderices su salida sin validar. Autoriza por permiso del usuario, no por lo que pida el texto.
81
+ Toda salida de modelo, MCP o herramienta externa es entrada no confiable (inyección de prompt indirecta): nunca se ejecuta, renderiza ni usa en SQL/shell/rutas sin validar, y autoriza el permiso del usuario, no lo que pida el texto. Si el código llama a un LLM o define agentes, herramientas o servidores MCP: `32-ai-security.md`.
@@ -11,6 +11,7 @@ Cuándo: antes de cerrar cualquier cambio que toque entrada de usuario, autentic
11
11
  6. **Peor caso**: si esta función se ejecuta con entrada del atacante, ¿qué consigue?
12
12
 
13
13
  ## Fase B — Revisión manual guiada por OWASP Top 10:2025
14
+ Si el cambio llama a un LLM o define agentes, herramientas o MCP, añade la tabla de `32-ai-security.md` §Auditoría.
14
15
  | # | Categoría | Comprobaciones mínimas |
15
16
  |---|---|---|
16
17
  | A01 | Broken Access Control | Autorización en servidor por petición; propiedad del objeto (IDOR/BOLA); segregación por tenant; rutas admin protegidas; SSRF (destinos, IP resuelta, redirects, metadata endpoint); CORS; path traversal; force browsing |
@@ -25,7 +26,8 @@ Cuándo: antes de cerrar cualquier cambio que toque entrada de usuario, autentic
25
26
  | A10 | Mishandling of Exceptional Conditions | Errores ignorados; `catch` vacío; fallback inseguro (fail-open); recursos no liberados; estado inconsistente tras fallo parcial; pánico/crash por entrada; errores que filtran detalles internos |
26
27
 
27
28
  ## Fase C — CWE Top 25 (2025): patrones a buscar en el diff
28
- XSS (79) · SQLi (89) · CSRF (352) · Missing authorization (862) · Out-of-bounds write (787) · Path traversal (22) · Use-after-free (416) · OOB read (125) · OS command injection (78) · Code injection (94) · Improper input validation (20) · Improper authentication (287) · Deserialization (502) · SSRF (918) · Integer overflow (190) · Buffer overflow clásico/stack/heap (120/121/122) · Improper access control (284) · Authorization bypass through user-controlled key (639) · Sensitive info exposure (200) · Hardcoded credentials (798) · Unrestricted upload (434) · Race condition (362) · NULL deref (476) · Resource allocation without limits (770).
29
+ En el orden de la lista oficial de MITRE: XSS (79) · SQLi (89) · CSRF (352) · Missing authorization (862) · Out-of-bounds write (787) · Path traversal (22) · Use-after-free (416) · OOB read (125) · OS command injection (78) · Code injection (94) · Buffer overflow clásico (120) · Unrestricted upload (434) · NULL deref (476) · Stack overflow (121) · Deserialization (502) · Heap overflow (122) · Incorrect authorization (863) · Improper input validation (20) · Improper access control (284) · Sensitive info exposure (200) · Missing authentication for critical function (306) · SSRF (918) · Command injection (77) · Authorization bypass through user-controlled key (639) · Resource allocation without limits (770).
30
+ Fuera del Top 25 de 2025, pero frecuentes en código de aplicación: hardcoded credentials (798), integer overflow (190), race condition (362), improper authentication (287).
29
31
 
30
32
  ## Fase D — Cobertura ASVS 5.0 (17 capítulos) por nivel
31
33
  Nivel objetivo por defecto: **L1** para apps internas/personales sin datos de terceros; **L2** para cualquier app con datos personales, dinero o autenticación; **L3** para sistemas críticos.
@@ -39,7 +41,9 @@ Marca cada capítulo `APLICA / NO APLICA (motivo) / PENDIENTE`.
39
41
  | SAST multi-lenguaje | `semgrep --config=auto`, `semgrep --config=p/owasp-top-ten` |
40
42
  | Vulnerabilidades en deps | `osv-scanner -r .` · `npm audit --omit=dev` · `pnpm audit` · `pip-audit` · `cargo audit` + `cargo deny check` · `govulncheck ./...` · `mvn dependency-check:check` · `dotnet list package --vulnerable` · `composer audit` · `bundler-audit` |
41
43
  | SAST por lenguaje | `bandit -r .` (py) · `gosec ./...` (go) · `cargo clippy -- -D warnings` (rust) · `eslint-plugin-security` (js/ts) · `spotbugs`+`find-sec-bugs` (java) · `security-code-scan` (.NET) · `psalm --taint-analysis` (php) · `brakeman` (rails) |
42
- | Contenedores e IaC | `trivy fs .` · `trivy image <img>` · `hadolint Dockerfile` · `checkov -d .` · `tfsec .` · `kube-score` |
44
+ | Contenedores e IaC | `trivy fs .` · `trivy image <img>` · `trivy config .` (sustituye a `tfsec`) · `hadolint Dockerfile` · `checkov -d .` · `kube-score` |
45
+ | CI/CD | `zizmor .` (GitHub Actions) · `actionlint` |
46
+ | Integridad de paquetes npm | `npm audit signatures` (firmas y procedencia del registro) |
43
47
  | Web dinámico | ZAP baseline · `nikto` · cabeceras con `curl -I` · CSP evaluator |
44
48
  | Fuzzing | `cargo fuzz` · `go test -fuzz` · `atheris`/`hypothesis` (py) · `jazzer` (jvm) · AFL++/libFuzzer (C/C++) |
45
49
  | Memoria (C/C++/unsafe) | ASan, UBSan, TSan, Valgrind, `-Wall -Wextra -Werror` |
@@ -0,0 +1,59 @@
1
+ # 32 — Seguridad de aplicaciones con LLM, agentes y MCP
2
+
3
+ Cuándo: el código llama a un modelo, construye prompts, define herramientas (tool/function calling), agentes o servidores/clientes MCP, o hace RAG.
4
+ Base: OWASP Top 10 for LLM Applications 2025 y OWASP Top 10 for Agentic Applications (2026), ambos del OWASP GenAI Security Project.
5
+ Lo general (entrada no confiable, inyección, secretos, autorización) sigue en `30-security.md`; aquí solo lo propio de los modelos.
6
+
7
+ ## L1. Modelo de confianza
8
+ - El modelo **no es un límite de seguridad**. Un system prompt no autoriza ni protege nada: lo que no puede pasar se impide en código.
9
+ - Todo lo que entra al contexto (documentos, webs, correos, tickets, resultados de herramientas, memoria) puede llevar instrucciones del atacante (inyección indirecta). Lo que sale del modelo es entrada no confiable.
10
+ - Separa instrucciones y datos: delimita el contenido externo y nunca concatenes entrada de usuario en el prompt de sistema.
11
+ - Supón que el system prompt se filtrará: sin secretos, credenciales, reglas de autorización ni datos de otros usuarios dentro.
12
+
13
+ ## L2. Agencia mínima (herramientas y agentes)
14
+ - Herramientas con el **mínimo privilegio**: solo las necesarias, con el alcance más estrecho (solo lectura si basta, un directorio, una tabla, un dominio).
15
+ - La autorización la decide el backend con la identidad del **usuario final**, no la del agente ni una cuenta de servicio con permisos amplios.
16
+ - Acciones irreversibles o con efectos externos (pagos, borrados, envíos, despliegues, cambios de permisos) ⇒ confirmación humana explícita, mostrando qué se va a ejecutar.
17
+ - Argumentos de cada llamada a herramienta validados con esquema estricto (tipos, enums, rangos, rutas dentro de la base). El modelo propone; el código valida.
18
+ - Ejecución de código generado: solo en sandbox aislado (contenedor o VM efímera, sin red o con allowlist, sin secretos, con límites de CPU/memoria/tiempo).
19
+ - Límites de bucle: máximo de pasos, de llamadas a herramientas y de tiempo por tarea; un agente sin tope es una denegación de servicio.
20
+ - Varios agentes: los mensajes entre agentes son datos no confiables; autentica el origen y no propagues permisos de un agente a otro.
21
+
22
+ ## L3. Salida del modelo
23
+ - Renderizado: escapa o sanea (Markdown/HTML con allowlist, sin `<script>`, sin imágenes remotas que exfiltren por URL).
24
+ - Nunca en `eval`, shell, SQL, rutas o plantillas sin validar (`30-security.md` §C2). Salida estructurada ⇒ valida contra esquema y rechaza lo que no encaje.
25
+ - Enlaces y URLs que genere el modelo: allowlist de dominios antes de seguirlos o mostrarlos como clicables.
26
+ - Afirmaciones críticas (datos, código, cifras) verificadas o marcadas como no verificadas; el usuario no debe confiar a ciegas (desinformación y exceso de confianza).
27
+
28
+ ## L4. Datos, RAG y memoria
29
+ - Permisos en la recuperación: el índice vectorial filtra por usuario/tenant **antes** de devolver fragmentos; nunca recuperes lo que el usuario no podría leer directamente.
30
+ - Datos sensibles fuera de prompts, logs de prompts y datasets de fine-tuning salvo necesidad y consentimiento; redacción de PII antes de enviar a un proveedor externo.
31
+ - Fuentes de ingesta (documentos, webs, memoria persistente) con procedencia registrada: lo que se envenena una vez se recupera siempre.
32
+ - Memoria de agente acotada por usuario y caducable; nada que un usuario escriba debe acabar en la memoria de otro.
33
+
34
+ ## L5. Consumo y coste
35
+ Límite de tokens de entrada y salida por petición, rate limit por usuario y clave, presupuesto y alerta de coste, timeout en cada llamada al proveedor y reintentos con backoff (`75-reliability.md`).
36
+
37
+ ## L6. Cadena de suministro de modelos y MCP
38
+ - Modelos, adaptadores y datasets de fuentes verificadas, con versión fijada; formatos seguros (`safetensors`) en vez de pickle.
39
+ - Servidores MCP de terceros = dependencia con ejecución de código: revisa origen, mantenedor, permisos y versión fijada (`80-supply-chain.md`). Desconfía de cambios en las descripciones de herramientas: también son texto que el modelo obedece.
40
+ - Servidor MCP propio: autenticación en transportes remotos, autorización por herramienta, validación de argumentos y sin devolver secretos en resultados.
41
+ - Credenciales del agente en el gestor de secretos o variables de entorno con alcance mínimo, nunca en el prompt ni en ficheros que el agente pueda leer y reenviar.
42
+
43
+ ## Auditoría (añadir a `31-security-audit.md` Fase B cuando aplique)
44
+ | Riesgo (LLM Top 10 2025) | Comprobación mínima |
45
+ |---|---|
46
+ | LLM01 Prompt Injection | Contenido externo delimitado; acciones sensibles no dependen solo del modelo; prueba con una instrucción maliciosa incrustada en un documento |
47
+ | LLM02 Sensitive Information Disclosure | Sin secretos ni datos ajenos en contexto, logs ni respuestas |
48
+ | LLM03 Supply Chain | Modelos, librerías y servidores MCP fijados y de origen verificado |
49
+ | LLM04 Data and Model Poisoning | Procedencia de datos de ingesta, fine-tuning y memoria |
50
+ | LLM05 Improper Output Handling | Salida escapada y validada antes de renderizar o ejecutar |
51
+ | LLM06 Excessive Agency | Herramientas mínimas, permisos del usuario final, confirmación humana en lo irreversible |
52
+ | LLM07 System Prompt Leakage | El system prompt no contiene nada cuya filtración importe |
53
+ | LLM08 Vector and Embedding Weaknesses | Filtro por permisos en la recuperación; aislamiento por tenant |
54
+ | LLM09 Misinformation | Respuestas críticas verificadas o señaladas |
55
+ | LLM10 Unbounded Consumption | Límites de tokens, pasos, tiempo y coste |
56
+ Agentes autónomos: recorre además los riesgos del Top 10 agéntico (secuestro del objetivo, mal uso de herramientas, abuso de identidad y privilegios, cadena de suministro agéntica, ejecución de código inesperada, envenenamiento de memoria y contexto, comunicación insegura entre agentes, fallos en cascada, explotación de la confianza humana, agentes fuera de control).
57
+
58
+ ## Tests obligatorios
59
+ Un test por control: inyección indirecta en un documento recuperado que intenta llamar a una herramienta, argumentos de herramienta fuera de esquema, salida con HTML/JS, recuperación cruzada entre tenants, y el tope de pasos alcanzado. Con el proveedor simulado (respuestas grabadas), no con el modelo real, para que sean deterministas.
@@ -30,6 +30,13 @@ Fast · Independent (sin orden ni estado compartido) · Repeatable (determinista
30
30
  - Datos de prueba con builders/factories y valores explícitos en lo relevante.
31
31
  - Snapshots: solo para salidas estables y pequeñas; revisar cada actualización, jamás `--update` a ciegas.
32
32
 
33
+ ## El test defiende el requisito, no el código
34
+ - El valor esperado sale del requisito, la spec o el bug reportado, **nunca** de ejecutar la implementación y copiar lo que devuelve.
35
+ - Escribe o lee el test antes que la implementación cuando puedas; un test escrito mirando el código tiende a repetir sus errores.
36
+ - Prohibido "arreglar" un test rojo cambiando su assert, borrándolo, saltándolo (`skip`, `xit`, `@Disabled`, `#[ignore]`) o ampliando la tolerancia, salvo que el requisito haya cambiado: dilo con `ASSUMPTION:` o pregunta.
37
+ - Un test que se modifica en el mismo cambio que el código que prueba exige revisar el diff del test con más sospecha, no menos.
38
+ - Ningún mock que reimplemente la lógica bajo prueba: si el doble necesita la misma lógica que el código, el test no prueba nada.
39
+
33
40
  ## Casos obligatorios por función
34
41
  Feliz · vacío/nulo · límite (0, 1, máx, máx+1) · tipo inesperado · Unicode y strings largos · negativo/desbordamiento · concurrencia si hay estado compartido · fallo de la dependencia externa · entrada hostil (inyección, path traversal, payload gigante).
35
42
 
@@ -1,10 +1,10 @@
1
1
  # 50 — Puerta de validez (Definition of Done)
2
2
 
3
- Un cambio es válido solo si ha superado las 8 fases. No se salta ninguna; si una no se puede ejecutar, se declara `SKIPPED (motivo)`.
3
+ El núcleo (`~/.agents/AGENTS.md` §4) fija las 8 fases y su orden. Aquí está **cómo** se cumple cada una y el formato del reporte. Si una fase no se puede ejecutar, se declara `SKIPPED (motivo)`; ninguna se salta en silencio.
4
4
 
5
5
  ## Fase 1 — Contexto
6
- - [ ] `STACK.md` leído (o generado con `/csr-stack` si falta).
7
- - [ ] Leído el código colindante y sus convenciones; buscado si ya existe algo equivalente (no duplicar).
6
+ - [ ] `STACK.md` leído (si falta: `csr-stack`, o comandos deducidos del manifiesto y dicho en una línea).
7
+ - [ ] Leído el código colindante y sus convenciones; buscado si ya existe algo equivalente (`grep` del concepto, no solo del nombre).
8
8
  - [ ] Alcance acotado: qué entra, qué queda fuera (`DEFERRED:`).
9
9
 
10
10
  ## Fase 2 — Diseño
@@ -14,13 +14,13 @@ Un cambio es válido solo si ha superado las 8 fases. No se salta ninguna; si un
14
14
  - [ ] Alternativa más simple descartada conscientemente.
15
15
 
16
16
  ## Fase 3 — Implementación
17
- - [ ] `20-clean-code.md` y `rules/lang/<lenguaje>.md` aplicados.
18
- - [ ] `30-security.md` aplicado.
19
- - [ ] Sin TODOs, sin código muerto, sin prints de depuración, sin secretos.
17
+ - [ ] `20-clean-code.md` y `lang/<lenguaje>.md` aplicados; `30-security.md` aplicado.
18
+ - [ ] Cada API, import, flag o paquete nuevo verificado contra la versión instalada (tipos, `--help`, docs) y, si es una dependencia nueva, contra el registro (`80-supply-chain.md`).
19
+ - [ ] Diff revisado línea a línea (`git diff`): sin TODOs, código muerto, prints de depuración, secretos ni cambios ajenos al alcance.
20
20
  - [ ] Cada supresión de lint/tipo justificada en línea.
21
21
 
22
22
  ## Fase 4 — Autorrevisión adversarial (pensar, no ejecutar)
23
- Responde por escrito, en una línea cada una:
23
+ Responde por escrito, en una línea cada una, **sobre el diff concreto** (no en abstracto):
24
24
  1. ¿Cómo rompo esto siendo un atacante?
25
25
  2. ¿Qué entrada hace que esto se comporte mal y no está probada?
26
26
  3. ¿Qué pasa si la dependencia externa falla, tarda o devuelve basura?
@@ -28,20 +28,24 @@ Responde por escrito, en una línea cada una:
28
28
  5. ¿Qué pasa si se ejecuta dos veces a la vez? ¿Y dos veces seguidas?
29
29
  6. ¿Qué he asumido sin verificar? ¿Qué fichero no he leído y debería?
30
30
  7. ¿Qué parte de esto no entiendo del todo?
31
- Cualquier respuesta incómoda ⇒ vuelve a Fase 2 o 3.
31
+ Cualquier respuesta incómoda ⇒ vuelve a Fase 2 o 3. "Nada" en las siete es sospechoso: busca una más.
32
32
 
33
33
  ## Fase 5 — Seguridad
34
34
  - [ ] Si toca entrada, auth, cripto, ficheros, red, SQL, procesos, deserialización o deps ⇒ `31-security-audit.md` completo.
35
+ - [ ] Si llama a un LLM o define agentes, herramientas o MCP ⇒ `32-ai-security.md`.
35
36
  - [ ] Si no toca nada de eso, declarar: `sec: N/A (solo lógica interna pura)`.
36
37
 
37
38
  ## Fase 6 — Tests
38
39
  - [ ] `40-testing.md`: casos obligatorios cubiertos, test de regresión si era un bug.
39
- - [ ] Los tests fallan si deshaces el cambio (verificado o razonado).
40
+ - [ ] Los tests nuevos **fallan sin el cambio**. Verifícalo ejecutándolos contra el código anterior (revierte temporalmente la corrección o usa el commit base en un worktree); si no es posible, razónalo en una línea.
41
+ - [ ] Ningún test existente se ha relajado, saltado o borrado para quedar en verde (`40-testing.md` §El test defiende el requisito).
40
42
 
41
43
  ## Fase 7 — Gates automáticos (ejecutar de verdad)
42
- Orden y comandos exactos desde `STACK.md`:
43
- `format → lint → typecheck → build → test → coverage → sec-scan → deps-audit`
44
- Regla: **un gate no ejecutado nunca se reporta como PASS**. Si falla, se arregla la causa raíz y se reejecuta desde ese gate.
44
+ Orden y comandos exactos desde `STACK.md` §3: `format → lint → typecheck → build → test → coverage → sec-scan → deps-audit`.
45
+ - Si falla, arregla la causa raíz y reejecuta **desde ese gate**. Si la causa queda fuera de alcance: ese gate `FAIL`, los siguientes `SKIPPED (bloqueado por <gate>)`, y `BLOCKED:`.
46
+ - Herramienta no instalada: `SKIPPED (no instalado: <herramienta>)`. No la instales sin permiso ni la sustituyas por otra sin decirlo.
47
+ - Sin red: `SKIPPED (sin red)`. Gate que no existe en este stack (`N/A` en `STACK.md` §3): `N/A`.
48
+ - Ejecuta en la shell que tengas (bash, Git Bash, PowerShell); si un comando de `STACK.md` no funciona en ella, dilo en vez de reescribirlo a ciegas.
45
49
 
46
50
  ## Fase 8 — Reporte final (formato fijo, sin prosa extra)
47
51
  ```
@@ -54,13 +58,12 @@ typecheck | tsc --noEmit | PASS
54
58
  build | pnpm build | PASS
55
59
  test | pnpm test | PASS 128/128
56
60
  coverage | pnpm test:cov | 86% cambiado
57
- sec-scan | semgrep --config=auto| PASS
61
+ sec-scan | semgrep --config=auto| SKIPPED (no instalado: semgrep)
58
62
  deps | npm audit | SKIPPED (sin red)
59
63
  RISK: <si aplica>
60
64
  DEFERRED: <si aplica>
61
65
  ```
66
+ Estados válidos: `PASS` (ejecutado y en verde) · `FAIL` (ejecutado y en rojo) · `SKIPPED (motivo)` (aplica, no se ejecutó) · `N/A` (no aplica a este stack).
62
67
 
63
- ## Honestidad — YOU MUST
64
- - No afirmes que algo funciona si no lo ejecutaste.
65
- - No maquilles un fallo como advertencia.
66
- - Si el usuario pidió algo que no pudiste terminar, dilo con `BLOCKED:` o `DEFERRED:` y entrega el resto completo.
68
+ ## Honestidad
69
+ Lo que no se terminó se dice con `BLOCKED:` o `DEFERRED:` y se entrega el resto completo. Un fallo no se rebaja a advertencia.
@@ -1,7 +1,7 @@
1
1
  # 60 — Git, commits, ramas y PR
2
2
 
3
3
  ## Reglas duras
4
- - Nunca hacer commit ni push salvo petición explícita del usuario.
4
+ - Nunca hacer commit ni push salvo petición explícita del usuario. Excepción: el «sí» al plan de rondas de la skill `orca` autoriza los commits del run en sus ramas de trabajo y de integración; nunca el push ni el merge a la rama por defecto (`95-multi-agent.md`).
5
5
  - Nunca en la rama por defecto: crea rama antes.
6
6
  - Nunca `--force` sobre rama compartida (`--force-with-lease` si el usuario lo pide en la suya).
7
7
  - Nunca `--no-verify` ni saltarse hooks. Si un hook falla, arregla la causa.
@@ -1,11 +1,11 @@
1
1
  # 75 — Fiabilidad, errores y observabilidad
2
2
 
3
3
  ## Errores
4
- - Distingue **error esperado** (devuélvelo tipado: `Result`, unión, excepción de dominio) de **bug** (falla ruidoso y rápido).
5
- - Nunca `catch` genérico sin volver a lanzar o tratar. Nunca fallback silencioso que devuelve datos falsos.
6
- - Conserva la causa (`cause`, `%w`, `raise ... from e`, `source()`).
4
+ Tipado, causa y `catch`: `20-clean-code.md` §Errores. Aquí, lo operativo:
5
+ - Nunca fallback silencioso que devuelve datos falsos (caché caducada, valor por defecto) sin marcarlo como degradado.
7
6
  - Fail-closed en seguridad (si no se puede verificar, deniega). Fail-open solo en funciones no críticas y declarado.
8
7
  - Libera recursos siempre, también en el camino de error.
8
+ - Fallo parcial: deja el sistema en un estado conocido (compensa, revierte o marca para reintento), nunca a medias.
9
9
 
10
10
  ## Llamadas externas (red, BD, cola, disco remoto)
11
11
  - **Timeout siempre** (conexión y lectura). Sin timeout = fuga garantizada.
@@ -3,29 +3,36 @@
3
3
 
4
4
  ## Antes de añadir una dependencia — YOU MUST preguntar
5
5
  1. ¿Se resuelve con la librería estándar o con 20 líneas propias? Entonces no la añadas.
6
- 2. ¿Mantenida? (commit en los últimos ~12 meses, issues atendidos, >1 mantenedor).
7
- 3. ¿CVE abiertos? ¿Historial de incidentes?
8
- 4. ¿Cuántas transitivas arrastra? ¿Peso en el bundle?
9
- 5. ¿Licencia compatible con el proyecto? (Copyleft fuerte en producto cerrado = no).
10
- 6. ¿Nombre correcto? Verifica typosquatting y que el paquete corresponde al repo oficial.
6
+ 2. ¿**Existe** con ese nombre exacto en el registro oficial y es la del proyecto que crees? Compruébalo (`npm view <pkg> repository`, la página de PyPI/crates.io/pkg.go.dev, el README del repo oficial) antes de instalar. Los nombres que propone un modelo pueden ser inventados, y los atacantes registran esos nombres (*slopsquatting*) y los parecidos (*typosquatting*).
7
+ 3. ¿Mantenida? (commit en los últimos ~12 meses, issues atendidos, >1 mantenedor). ¿Publicada hace días, con pocas descargas o con un mantenedor recién cambiado? Señal de alarma.
8
+ 4. ¿CVE abiertos? ¿Historial de incidentes?
9
+ 5. ¿Cuántas transitivas arrastra? ¿Peso en el bundle?
10
+ 6. ¿Licencia compatible con el proyecto? (Copyleft fuerte en producto cerrado = no). ¿Ha cambiado de licencia en la versión que vas a usar?
11
11
  7. ¿Ejecuta scripts en la instalación? Revísalos.
12
12
  Deja constancia de la decisión en el commit o en un ADR si es estructural.
13
13
 
14
+ ## Instalación
15
+ - Scripts de instalación desactivados por defecto donde se pueda: `npm ci --ignore-scripts` (y habilitar solo los necesarios); pnpm ≥10 ya no ejecuta los de dependencias salvo los permitidos en `onlyBuiltDependencies`.
16
+ - Retraso de adopción para versiones recién publicadas (la mayoría de paquetes maliciosos se retiran en horas o días): `minimumReleaseAge` en pnpm, `exclude-newer` en uv.
17
+ - Nunca `curl … | sh` ni instaladores sin checksum o firma verificada.
18
+
14
19
  ## Higiene continua
15
- - Lockfile commiteado siempre (`package-lock.json`, `pnpm-lock.yaml`, `poetry.lock`, `uv.lock`, `Cargo.lock`, `go.sum`, `composer.lock`, `Gemfile.lock`).
20
+ - Lockfile commiteado siempre (`package-lock.json`, `pnpm-lock.yaml`, `bun.lock`, `poetry.lock`, `uv.lock`, `Cargo.lock`, `go.sum`, `composer.lock`, `Gemfile.lock`).
16
21
  - Versiones fijadas en producción; rangos solo en desarrollo.
17
- - Instalación reproducible en CI: `npm ci`, `pnpm i --frozen-lockfile`, `poetry install --sync`, `cargo build --locked`, `go mod verify`.
18
- - Auditoría periódica: `osv-scanner -r .`, `npm audit`, `pip-audit`, `cargo audit`, `govulncheck`, `dotnet list package --vulnerable`, `composer audit`.
22
+ - Instalación reproducible en CI: `npm ci`, `pnpm install --frozen-lockfile`, `uv sync --locked`, `poetry sync` (Poetry ≥2), `cargo build --locked`, `go mod verify`.
23
+ - Auditoría periódica: `osv-scanner -r .`, `npm audit`, `npm audit signatures`, `pip-audit`, `cargo audit`, `govulncheck`, `dotnet list package --vulnerable`, `composer audit`.
19
24
  - Actualizaciones automatizadas (Renovate/Dependabot) con tests verdes como condición de merge.
20
25
  - SBOM (CycloneDX/SPDX) generado en release si el proyecto se distribuye.
21
- - Elimina lo que no se usa: `depcheck`, `knip`, `cargo-udeps`, `pip-check`.
26
+ - Elimina lo que no se usa: `knip` (JS/TS; `depcheck` ya no se mantiene), `cargo-udeps`/`cargo-machete`, `deptry` (Python).
22
27
 
23
28
  ## CI/CD
24
29
  - Acciones/plugins de terceros **anclados por SHA**, no por tag móvil.
25
- - Permisos mínimos del token (`permissions: contents: read`), sin secretos expuestos a PR de forks.
30
+ - Permisos mínimos del token (`permissions: contents: read`), sin secretos expuestos a PR de forks; `actions/checkout` con `persist-credentials: false` si el job no necesita hacer push.
26
31
  - Secretos solo por el gestor de secretos del runner; nunca en `env` de logs ni en `echo`.
27
- - Los workflows no ejecutan código de un PR no confiable con permisos de escritura (`pull_request_target` es peligroso).
32
+ - Los workflows no ejecutan código de un PR no confiable con permisos de escritura (`pull_request_target` y `workflow_run` son peligrosos). Sin interpolar `${{ github.event.* }}` en `run:`: pásalo por `env`.
33
+ - Analiza los workflows: `zizmor .` y `actionlint`.
28
34
  - Gates de calidad bloqueantes: format, lint, typecheck, build, test, cobertura, `gitleaks`, SAST, auditoría de deps.
35
+ - Publicación con identidad federada (OIDC / Trusted Publishing) y procedencia (`npm publish --provenance`) en vez de tokens de larga duración.
29
36
  - Build reproducible y artefactos firmados/con checksum si se publican.
30
37
  - Caché de CI con clave por lockfile, nunca compartida entre ramas no confiables.
31
38