egutierrez
988e901066
Añade campos params y output al frontmatter YAML de las 506 funciones del registry. Cada parámetro tiene descripción semántica (qué representa, unidades, rango típico) y cada función describe qué produce su output. Permite a agentes razonar sobre cadenas de composición (ej: prices → log_return → sharpe_ratio) sin leer código.
2.3 KiB
2.3 KiB
name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path
| name | kind | lang | domain | version | purity | signature | description | tags | uses_functions | uses_types | returns | returns_optional | error_type | imports | params | output | tested | tests | test_file_path | file_path | |||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| win_firewall_add_rule | function | ps | infra | 1.0.0 | impure | win_firewall_add_rule -Name <string> -Port <int> [-Protocol <string>] | Añade una regla de entrada al firewall de Windows para permitir tráfico en un puerto TCP/UDP. Si ya existe una regla con el mismo nombre, la elimina y la recrea. Requiere privilegios de Administrador. |
|
false | error_go_core |
|
Void - crea regla de entrada en firewall de Windows, idempotente por nombre | false | powershell/functions/infra/win_firewall_add_rule.ps1 |
Uso
# Desde PowerShell (como Administrador)
.\win_firewall_add_rule.ps1 -Name "CDP-9222" -Port 9222
# Con protocolo explícito
.\win_firewall_add_rule.ps1 -Name "MyApp-UDP-5000" -Port 5000 -Protocol UDP
# Desde WSL2
powershell.exe -ExecutionPolicy Bypass -File win_firewall_add_rule.ps1 -Name "CDP-9222" -Port 9222
Parametros
| Parametro | Tipo | Obligatorio | Default | Descripcion |
|---|---|---|---|---|
-Name |
string | si | — | Nombre de la regla en el firewall |
-Port |
int | si | — | Puerto local (1-65535) |
-Protocol |
string | no | TCP | Protocolo: TCP o UDP |
Notas
- Requiere ejecutarse como Administrador en Windows. Si se llama desde WSL2, usar
powershell.exe(que corre en Windows) opwsh.exe. - Si ya existe una regla con el mismo nombre, la elimina primero y la recrea (idempotente respecto al nombre).
- La regla creada es
dir=in action=allow— solo aplica para tráfico entrante. - Caso de uso principal: permitir que WSL2 alcance Chrome CDP en el host Windows cuando Chrome escucha en
127.0.0.1:9222. - Retorna exit code 0 si tuvo éxito, 1 si hubo error (falta de privilegios, puerto inválido, fallo de netsh).