Tu agente de código lee tu workspace. Un archivo envenenado en cualquier rincón
puede llevar instrucciones que el agente ejecuta. ¿Sabes qué fracción de tu
workspace tiene que leer para que eso ocurra? topowatch mide eso.
El problema no es el prompt, es la topología
El paper Workspace Topology as an Attack Vector in Agentic Coding Assistants
(arXiv:2608.14876, Day et al., 2026) demostró algo que intuíamos pero no
medíamos: la topología del workspace afecta mediblemente el Attack Success
Rate (ASR) de la inyección indirecta. Los entornos altamente modulares
muestran ASR significativamente menor que los planos.
La razón es mecánica: si el agente acota su lectura al módulo de la tarea,
nunca llega al archivo envenenado. Si hace un wide read de todo el workspace,
lo lee siempre.
Qué es topowatch
topowatch es una herramienta de línea de comandos que, dado un workspace,
mide el ASR de una inyección indirecta de referencia bajo varias configuraciones
de topología, y reporta qué estructura minimiza el ASR.
Fundamentado en arXiv:2608.14876. Determinista y reproducible sin claves ni red:
usa un agente sintético configurable y un fixture con tres topologías (monolito,
modular, nesting profundo).
pip install -e ".[test]" topowatch --json Resultados
Sobre el fixture de referencia (200 trials, semilla fija):
| Topología | ASR | % leído |
|---|---|---|
| Monolito (plano) | 1.000 | 100% |
| Modular (acotado) | 0.000 | 28.5% |
| Nesting profundo | 0.000 | 66.6% |
El reporte incluye read_budget (fracción del workspace que lee el agente) y el
veredicto del defense contract: modular < monolito.
Honestidad sobre v0.1
v0.1 usa un agente sintético, no un coding assistant real (Claude Code /
Codex). El claim “modularidad → ASR menor” está anclado al fixture reproducible,
no a una medición contra un assistant real — eso es v0.2 (feature 002). El
objetivo de v0.1 es darte una herramienta para medir y recomendar modularidad,
no simular un ataque completo.
Roadmap
- v0.2: medición contra coding assistants reales (sandbox, sin credenciales)
- métrica de
read_budgetcontinua.
- métrica de
- v0.3: recomendación automática de reestructuración + plugin CoreDefense.
Dónde está
Repositorio: https://github.com/amurlaniakea/topowatch — AGPL-3.0-or-later.
Autor: Pedro Sordo Martínez.