docs: documentar desglose multi-issue de 0019

Añade seccion "Desglose multi-issue" al issue 0019 con:
- Tabla de sub-issues (0019a-d), rama, alcance y estado
- Checklist de progreso por tarea agrupado por fase
- 0019a (tool hardening) marcado como completado

Esto permite trackear el avance de features multi-issue
directamente en el documento del issue.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-07 19:19:47 +00:00
parent 75e46a3f53
commit d2b3e89e0e
@@ -101,6 +101,62 @@ agents/*/config.yaml MOD — storage.base_path fuera del proyecto
---
## Desglose multi-issue
Este issue es demasiado grande para una sola rama. Se desglosa en sub-issues con feature flag `prompt-injection-hardening` (OFF hasta completar todo).
| Sub-issue | Rama | Alcance | Fases | Estado |
|-----------|------|---------|-------|--------|
| **0019a** | `issue/0019a-tool-hardening` | Deny-by-default en tools, path traversal, SSRF, SSH allowlist + syntax, Matrix room auth | 1 (parcial), 5, 6 (parcial) | **completado** |
| **0019b** | `issue/0019b-input-sanitization` | `pkg/sanitize/` + integracion en runtime.go | 2, 6 (parcial) | pendiente |
| **0019c** | `issue/0019c-rate-limiting` | Rate limiting de tools por agente+room en registry | 4, 6 (parcial) | pendiente |
| **0019d** | `issue/0019d-prompt-hardening-docs` | Hardening de system prompts + docs + activar flag | 1 (restante: base_path), 3, 7 | pendiente |
### Progreso por tarea
#### Fase 1 — completado parcial (0019a)
- [x] **1.3** `tools/file.go`: deny-by-default (AllowedPaths vacio = todo denegado)
- [x] **1.4** `tools/file.go`: path traversal con EvalSymlinks, proteccion contra `../` y prefix confusion
- [x] **1.5** `tools/ssh.go`: AllowedCommands allowlist + validacion de sintaxis shell
- [ ] **1.1** Mover `storage.base_path` default (pendiente 0019d)
- [ ] **1.2** Actualizar schema con nuevo default (pendiente 0019d)
#### Fase 2 — pendiente (0019b)
- [ ] **2.1** `pkg/sanitize/patterns.go`
- [ ] **2.2** `pkg/sanitize/sanitize.go`
- [ ] **2.3** Integracion en `agents/runtime.go`
#### Fase 3 — pendiente (0019d)
- [ ] **3.1** Template anti-injection para system prompts
- [ ] **3.2** Aplicar a assistant-bot
- [ ] **3.3** Aplicar a asistente-2
- [ ] **3.4** Documentar en regla create_agent.md
#### Fase 4 — pendiente (0019c)
- [ ] **4.1** Rate limiter por agente+room en registry
- [ ] **4.2** Config via `security.tool_rate_limit`
- [ ] **4.3** Loguear al alcanzar limite
#### Fase 5 — completado (0019a)
- [x] **5.1** SSH: validacion de pipes, subshells, redirects, chains
- [x] **5.2** HTTP: SSRF protection (bloqueo de IPs privadas, loopback, link-local, metadata)
- [x] **5.3** Matrix: AllowedRooms para restringir rooms destino
#### Fase 6 — completado parcial
- [x] **6.2** Tests path traversal en file.go (0019a)
- [x] **6.3** Tests SSH allowlist/blocklist (0019a)
- [x] **6.4** Tests SSRF en http.go (0019a)
- [ ] **6.1** Tests para `pkg/sanitize/` (0019b)
- [ ] **6.5** Tests para rate limiting (0019c)
#### Fase 7 — pendiente (0019d)
- [ ] Actualizar CLAUDE.md
- [ ] Actualizar create_tool.md
- [ ] Actualizar create_agent.md
- [ ] Documentar en docs/security.md
---
## Ejemplo de uso
```