@saulwade/swl-ses 1.6.1 → 1.6.5

package/schemas/skill-frontmatter.schema.json

@@ -1,170 +1,245 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://swl-ses.dev/schemas/skill-frontmatter.json",
-  "title": "SWL Skill Frontmatter",
-  "description": "Schema de validacion para el frontmatter YAML de skills del sistema SWL",
-  "type": "object",
-  "required": ["name", "description"],
-  "properties": {
-    "name": {
-      "type": "string",
-      "pattern": "^[a-z][a-z0-9-]+$",
-      "maxLength": 64,
-      "description": "Nombre en kebab-case que coincide con el directorio"
-    },
-    "description": {
-      "type": "string",
-      "minLength": 20,
-      "maxLength": 1024,
-      "description": "Descripcion que incluye QUE hace y CUANDO cargarla"
-    },
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$"
-    },
-    "provenance": {
-      "type": "object",
-      "description": "Campo legacy. Equivalente espanol: 'procedencia'. Si ambos presentes deben coincidir (W010).",
-      "properties": {
-        "origin": {
-          "type": "string",
-          "enum": ["manual", "auto-evolution", "imported", "community"]
-        },
-        "created_at": {
-          "type": "string",
-          "format": "date"
-        },
-        "confidence": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1
-        },
-        "author": {
-          "type": "string"
-        }
-      }
-    },
-    "procedencia": {
-      "type": "object",
-      "description": "Alias en espanol de 'provenance'. Campo propio de swl-ses. Si ambos presentes, deben coincidir (W010).",
-      "properties": {
-        "origin": {
-          "type": "string",
-          "enum": ["manual", "auto-evolution", "imported", "community"]
-        },
-        "created_at": {
-          "type": "string",
-          "format": "date"
-        },
-        "confidence": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1
-        },
-        "author": {
-          "type": "string"
-        }
-      }
-    },
-    "targets": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": ["claude", "openclaude", "copilot", "opencode", "codex", "gemini"]
-      },
-      "description": "Campo legacy. Equivalente espanol: 'destinos'. Runtimes a los que se sincroniza este skill. Patron adoptado de skillshare (targets.yaml). Si ambos presentes deben coincidir (W010)."
-    },
-    "destinos": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": ["claude", "openclaude", "copilot", "opencode", "codex", "gemini"]
-      },
-      "description": "Alias en espanol de 'targets'. Campo propio de swl-ses. Runtimes a los que se sincroniza este skill."
-    },
-    "user-invocable": {
-      "type": "boolean",
-      "description": "Si el usuario puede invocar este skill directamente con Skill(nombre)"
-    },
-    "license": {
-      "type": "string",
-      "description": "Licencia del skill si es externo o adaptado"
-    },
-    "evolvable": {
-      "type": "boolean",
-      "description": "Campo legacy. Equivalente espanol: 'evolucionable'. Marca AGP learnability. Si false, el loop de auto-evolucion NO debe proponer cambios a este skill. Recomendado: false para skills criticos. Si ambos presentes deben coincidir (W010)."
-    },
-    "evolucionable": {
-      "type": "boolean",
-      "description": "Alias en espanol de 'evolvable'. Campo propio de swl-ses. Marca AGP learnability. Si false, el loop de auto-evolucion NO propone cambios a este skill."
-    },
-    "evolvable_scope": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": ["description", "content", "examples", "references", "anti-patterns"]
-      },
-      "description": "Campo legacy. Equivalente espanol: 'evolucionable_alcance'. Si evolvable=true, limita las secciones del SKILL.md que pueden modificarse. Ausente implica 'content' y 'examples' unicamente. Si ambos presentes deben coincidir (W010)."
-    },
-    "evolucionable_alcance": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": ["description", "content", "examples", "references", "anti-patterns"]
-      },
-      "description": "Alias en espanol de 'evolvable_scope'. Campo propio de swl-ses. Si evolucionable=true, limita las secciones modificables."
-    },
-    "when_to_use": {
-      "type": "string",
-      "maxLength": 512,
-      "description": "Campo del protocolo Anthropic. Contexto adicional sobre cuando activar la skill, leido por Claude Code como bloque combinado con description (total max 1536 chars). Usar cuando description ocupa mas de 900 chars y aun hay triggers que no caben."
-    },
-    "exclusiones": {
-      "type": "array",
-      "items": { "type": "string" },
-      "description": "Situaciones donde esta skill NO debe activarse aunque parezca relevante superficialmente. Campo propio de swl-ses; previene skill hijacking por similitud de terminos. Equivalente estructural de la seccion 'Cuando NO cargar' en el cuerpo de SKILL.md, legible por herramientas de analisis sin parsear markdown."
-    },
-    "allowed-tools": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": ["Read", "Write", "Edit", "Bash", "Glob", "Grep", "WebSearch", "WebFetch"]
-      },
-      "description": "Campo del protocolo Anthropic. Pre-aprobacion de UX leida por Claude Code. NO es restriccion de seguridad real. Las restricciones reales provienen de permission rules en .claude/settings.json o del matcher en hooks."
-    },
-    "herramientasPermitidas": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "enum": ["Read", "Write", "Edit", "Bash", "Glob", "Grep", "WebSearch", "WebFetch"]
-      },
-      "description": "Campo propio de swl-ses. Alias semantico de allowed-tools, usado por las herramientas internas (evaluar-skill, validadores). Debe coincidir con allowed-tools cuando ambos estan presentes. Si divergen, el validador emite W011. Para skills nuevos en swl-ses, declarar solo este campo; una herramienta de sincronizacion propagara el valor a allowed-tools al construir artefactos para Claude Code."
-    },
-    "nist_csf": {
-      "type": "array",
-      "items": { "type": "string", "pattern": "^(GV|ID|PR|DE|RS|RC)\\.[A-Z]{2}(-[0-9]{2})?$" },
-      "description": "Campo propio de swl-ses. Mapeo a NIST Cybersecurity Framework 2.0. Cada entrada es un ID de subcategoria tipo 'GV.SC-07', 'PR.PS-01', 'DE.CM-01'. Opcional. Usado para reportes de cobertura en /swl:salud y /swl:dashboard. Referencia: https://www.nist.gov/cyberframework"
-    },
-    "nist_ai_rmf": {
-      "type": "array",
-      "items": { "type": "string", "pattern": "^(GOVERN|MAP|MEASURE|MANAGE)(-[0-9]+(\\.[0-9]+)?)?$" },
-      "description": "Campo propio de swl-ses. Mapeo a NIST AI Risk Management Framework 1.0. Cada entrada es un ID de subcategoria tipo 'GOVERN-1.1', 'MAP-5.1', 'MEASURE-2.7'. Opcional. Particularmente relevante para skills de seguridad de sistemas agenticos. Referencia: https://airc.nist.gov/AI_RMF"
-    },
-    "atlas_techniques": {
-      "type": "array",
-      "items": { "type": "string", "pattern": "^AML\\.T[0-9]{4}(\\.[0-9]{3})?$" },
-      "description": "Campo propio de swl-ses. Mapeo a MITRE ATLAS v5.4 (Adversarial Threat Landscape for AI Systems). Cada entrada es una tecnica tipo 'AML.T0051' (LLM Prompt Injection), 'AML.T0080' (AI Agent Context Poisoning). Opcional. Critico para skills que protegen el sistema agentico mismo. Referencia: https://atlas.mitre.org"
-    },
-    "attack_techniques": {
-      "type": "array",
-      "items": { "type": "string", "pattern": "^T[0-9]{4}(\\.[0-9]{3})?$" },
-      "description": "Campo propio de swl-ses. Mapeo a MITRE ATT&CK v18. Cada entrada es una tecnica tipo 'T1071' (Application Layer Protocol), 'T1190' (Exploit Public-Facing Application). Opcional. Mas aplicable a skills de defensa de infraestructura o deteccion de amenazas en el sistema desplegado. Referencia: https://attack.mitre.org"
-    },
-    "d3fend_techniques": {
-      "type": "array",
-      "items": { "type": "string", "pattern": "^D3-[A-Z]+$" },
-      "description": "Campo propio de swl-ses. Mapeo a MITRE D3FEND v1.3 (Defensive countermeasures). Cada entrada es una tecnica tipo 'D3-NTA' (Network Traffic Analysis), 'D3-PSA' (Process Spawn Analysis). Opcional. Referencia: https://d3fend.mitre.org"
-    }
-  },
-  "additionalProperties": true
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://swl-ses.dev/schemas/skill-frontmatter.json",
+  "$schemaVersion": "1.0.0",
+  "title": "SWL Skill Frontmatter",
+  "description": "Schema de validacion para el frontmatter YAML de skills del sistema SWL",
+  "type": "object",
+  "required": [
+    "name",
+    "description"
+  ],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]+$",
+      "maxLength": 64,
+      "description": "Nombre en kebab-case que coincide con el directorio"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 20,
+      "maxLength": 1024,
+      "description": "Descripcion que incluye QUE hace y CUANDO cargarla"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "provenance": {
+      "type": "object",
+      "description": "Campo legacy. Equivalente espanol: 'procedencia'. Si ambos presentes deben coincidir (W010).",
+      "properties": {
+        "origin": {
+          "type": "string",
+          "enum": [
+            "manual",
+            "auto-evolution",
+            "imported",
+            "community"
+          ]
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "author": {
+          "type": "string"
+        }
+      }
+    },
+    "procedencia": {
+      "type": "object",
+      "description": "Alias en espanol de 'provenance'. Campo propio de swl-ses. Si ambos presentes, deben coincidir (W010).",
+      "properties": {
+        "origin": {
+          "type": "string",
+          "enum": [
+            "manual",
+            "auto-evolution",
+            "imported",
+            "community"
+          ]
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date"
+        },
+        "confidence": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "author": {
+          "type": "string"
+        }
+      }
+    },
+    "targets": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "claude",
+          "openclaude",
+          "copilot",
+          "opencode",
+          "codex",
+          "gemini"
+        ]
+      },
+      "description": "Campo legacy. Equivalente espanol: 'destinos'. Runtimes a los que se sincroniza este skill. Patron adoptado de skillshare (targets.yaml). Si ambos presentes deben coincidir (W010)."
+    },
+    "destinos": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "claude",
+          "openclaude",
+          "copilot",
+          "opencode",
+          "codex",
+          "gemini"
+        ]
+      },
+      "description": "Alias en espanol de 'targets'. Campo propio de swl-ses. Runtimes a los que se sincroniza este skill."
+    },
+    "user-invocable": {
+      "type": "boolean",
+      "description": "Si el usuario puede invocar este skill directamente con Skill(nombre)"
+    },
+    "license": {
+      "type": "string",
+      "description": "Licencia del skill si es externo o adaptado"
+    },
+    "evolvable": {
+      "type": "boolean",
+      "description": "Campo legacy. Equivalente espanol: 'evolucionable'. Marca AGP learnability. Si false, el loop de auto-evolucion NO debe proponer cambios a este skill. Recomendado: false para skills criticos. Si ambos presentes deben coincidir (W010)."
+    },
+    "evolucionable": {
+      "type": "boolean",
+      "description": "Alias en espanol de 'evolvable'. Campo propio de swl-ses. Marca AGP learnability. Si false, el loop de auto-evolucion NO propone cambios a este skill."
+    },
+    "evolvable_scope": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "description",
+          "content",
+          "examples",
+          "references",
+          "anti-patterns"
+        ]
+      },
+      "description": "Campo legacy. Equivalente espanol: 'evolucionable_alcance'. Si evolvable=true, limita las secciones del SKILL.md que pueden modificarse. Ausente implica 'content' y 'examples' unicamente. Si ambos presentes deben coincidir (W010)."
+    },
+    "evolucionable_alcance": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "description",
+          "content",
+          "examples",
+          "references",
+          "anti-patterns"
+        ]
+      },
+      "description": "Alias en espanol de 'evolvable_scope'. Campo propio de swl-ses. Si evolucionable=true, limita las secciones modificables."
+    },
+    "when_to_use": {
+      "type": "string",
+      "maxLength": 512,
+      "description": "Campo del protocolo Anthropic. Contexto adicional sobre cuando activar la skill, leido por Claude Code como bloque combinado con description (total max 1536 chars). Usar cuando description ocupa mas de 900 chars y aun hay triggers que no caben."
+    },
+    "exclusiones": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Situaciones donde esta skill NO debe activarse aunque parezca relevante superficialmente. Campo propio de swl-ses; previene skill hijacking por similitud de terminos. Equivalente estructural de la seccion 'Cuando NO cargar' en el cuerpo de SKILL.md, legible por herramientas de analisis sin parsear markdown."
+    },
+    "allowed-tools": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "Read",
+          "Write",
+          "Edit",
+          "Bash",
+          "Glob",
+          "Grep",
+          "WebSearch",
+          "WebFetch"
+        ]
+      },
+      "description": "Campo del protocolo Anthropic. Pre-aprobacion de UX leida por Claude Code. NO es restriccion de seguridad real. Las restricciones reales provienen de permission rules en .claude/settings.json o del matcher en hooks."
+    },
+    "herramientasPermitidas": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "Read",
+          "Write",
+          "Edit",
+          "Bash",
+          "Glob",
+          "Grep",
+          "WebSearch",
+          "WebFetch"
+        ]
+      },
+      "description": "Campo propio de swl-ses. Alias semantico de allowed-tools, usado por las herramientas internas (evaluar-skill, validadores). Debe coincidir con allowed-tools cuando ambos estan presentes. Si divergen, el validador emite W011. Para skills nuevos en swl-ses, declarar solo este campo; una herramienta de sincronizacion propagara el valor a allowed-tools al construir artefactos para Claude Code."
+    },
+    "nist_csf": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^(GV|ID|PR|DE|RS|RC)\\.[A-Z]{2}(-[0-9]{2})?$"
+      },
+      "description": "Campo propio de swl-ses. Mapeo a NIST Cybersecurity Framework 2.0. Cada entrada es un ID de subcategoria tipo 'GV.SC-07', 'PR.PS-01', 'DE.CM-01'. Opcional. Usado para reportes de cobertura en /swl:salud y /swl:dashboard. Referencia: https://www.nist.gov/cyberframework"
+    },
+    "nist_ai_rmf": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^(GOVERN|MAP|MEASURE|MANAGE)(-[0-9]+(\\.[0-9]+)?)?$"
+      },
+      "description": "Campo propio de swl-ses. Mapeo a NIST AI Risk Management Framework 1.0. Cada entrada es un ID de subcategoria tipo 'GOVERN-1.1', 'MAP-5.1', 'MEASURE-2.7'. Opcional. Particularmente relevante para skills de seguridad de sistemas agenticos. Referencia: https://airc.nist.gov/AI_RMF"
+    },
+    "atlas_techniques": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^AML\\.T[0-9]{4}(\\.[0-9]{3})?$"
+      },
+      "description": "Campo propio de swl-ses. Mapeo a MITRE ATLAS v5.4 (Adversarial Threat Landscape for AI Systems). Cada entrada es una tecnica tipo 'AML.T0051' (LLM Prompt Injection), 'AML.T0080' (AI Agent Context Poisoning). Opcional. Critico para skills que protegen el sistema agentico mismo. Referencia: https://atlas.mitre.org"
+    },
+    "attack_techniques": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^T[0-9]{4}(\\.[0-9]{3})?$"
+      },
+      "description": "Campo propio de swl-ses. Mapeo a MITRE ATT&CK v18. Cada entrada es una tecnica tipo 'T1071' (Application Layer Protocol), 'T1190' (Exploit Public-Facing Application). Opcional. Mas aplicable a skills de defensa de infraestructura o deteccion de amenazas en el sistema desplegado. Referencia: https://attack.mitre.org"
+    },
+    "d3fend_techniques": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^D3-[A-Z]+$"
+      },
+      "description": "Campo propio de swl-ses. Mapeo a MITRE D3FEND v1.3 (Defensive countermeasures). Cada entrada es una tecnica tipo 'D3-NTA' (Network Traffic Analysis), 'D3-PSA' (Process Spawn Analysis). Opcional. Referencia: https://d3fend.mitre.org"
+    }
+  },
+  "additionalProperties": true
+}

package/scripts/generar-inventario.js

@@ -82,7 +82,9 @@ function contarSkills(dir) {
 
 function recolectarAgentes() {
   const dir = path.join(RAIZ, 'agentes');
-  const archivos = fs.readdirSync(dir).filter(f => f.endsWith('.md'));
+  // Excluir fragmentos compartidos (`_*.md`) — no son agentes routables.
+  // Ver reglas/fragmentos-compartidos.md.
+  const archivos = fs.readdirSync(dir).filter(f => f.endsWith('.md') && !f.startsWith('_'));
   return archivos.map(f => {
     const fm = leerFrontmatter(path.join(dir, f));
     return {

package/scripts/lib/mcp_config.py

@@ -23,6 +23,7 @@ seccion "Code style": settings.local.json sobrescribe por key, no reemplaza.
 from __future__ import annotations
 
 import json
+import os
 import sys
 from pathlib import Path
 from typing import Any
@@ -30,9 +31,9 @@ from typing import Any
 # Orden de capas: base -> override. La ultima capa gana por clave al hacer
 # merge, igual que el deep merge interno de Claude Code.
 CAPAS_DEFAULT = (
-    'mcp-servers.json',
-    '.claude/settings.json',
-    '.claude/settings.local.json',
+    "mcp-servers.json",
+    ".claude/settings.json",
+    ".claude/settings.local.json",
 )
 
 
@@ -45,10 +46,10 @@ def _leer_servers(ruta: Path) -> dict:
     if not ruta.exists():
         return {}
     try:
-        data = json.loads(ruta.read_text(encoding='utf-8'))
+        data = json.loads(ruta.read_text(encoding="utf-8"))
     except (OSError, json.JSONDecodeError):
         return {}
-    servers = data.get('mcpServers')
+    servers = data.get("mcpServers")
     if not isinstance(servers, dict):
         return {}
     return servers
@@ -71,12 +72,14 @@ def _fusionar_servidor(base: dict, override: dict) -> dict:
     resultado: dict[str, Any] = dict(base)
 
     for clave, valor in override.items():
-        if clave == 'env' and isinstance(valor, dict):
-            env_base = resultado.get('env') if isinstance(resultado.get('env'), dict) else {}
-            resultado['env'] = {**env_base, **valor}
-        elif clave == 'args':
+        if clave == "env" and isinstance(valor, dict):
+            env_base = (
+                resultado.get("env") if isinstance(resultado.get("env"), dict) else {}
+            )
+            resultado["env"] = {**env_base, **valor}
+        elif clave == "args":
             # args reemplaza, no mergea: una lista parcial seria peligrosa.
-            resultado['args'] = valor
+            resultado["args"] = valor
         elif isinstance(valor, dict) and isinstance(resultado.get(clave), dict):
             resultado[clave] = {**resultado[clave], **valor}
         else:
@@ -111,17 +114,29 @@ def cargar_config_mcp(cwd: Path, config_path: str | None = None) -> dict:
     return fusionado
 
 
+def build_stdio_env(cfg: dict) -> dict:
+    """Entorno para StdioServerParameters: siempre hereda os.environ.
+
+    Con env: {} en settings.json, devolver None hacia el SDK MCP dejaba al
+    subproceso sin variables del padre (p. ej. OBSIDIAN_API_KEY vía setx).
+    """
+    extra = cfg.get("env") if isinstance(cfg.get("env"), dict) else {}
+    merged = dict(os.environ)
+    merged.update(extra)
+    return merged
+
+
 def _main(argv: list[str]) -> int:
     """Entry point CLI: imprime el JSON fusionado para uso en tests."""
-    cwd = Path(argv[0]) if argv else Path('.')
+    cwd = Path(argv[0]) if argv else Path(".")
     if not cwd.is_dir():
-        sys.stderr.write(f'[mcp_config] CWD no es directorio: {cwd}\n')
+        sys.stderr.write(f"[mcp_config] CWD no es directorio: {cwd}\n")
         return 1
     resultado = cargar_config_mcp(cwd)
     sys.stdout.write(json.dumps(resultado, indent=2, ensure_ascii=False))
-    sys.stdout.write('\n')
+    sys.stdout.write("\n")
     return 0
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     sys.exit(_main(sys.argv[1:]))