Una regla deny es el único límite que tienes

· 5 min de lectura

Todo lo demás que un harness de agentes llama permiso es una valoración del coste. Merece la pena decirlo claramente, porque la interfaz no lo dice: una solicitud de aprobación, un modo llamado Auto y un ajuste de raíces con permiso de escritura parecen cosas del mismo tipo, y solo una de ellas es una línea que el sistema mantendrá pase lo que pase.

OHarness tiene cinco modos de permisos. Manual pregunta antes de cualquier cosa que cambie el estado. Aceptar ediciones deja pasar las escrituras de archivos y pregunta por lo demás. Plan rechaza cualquier cambio y solo lee. Auto deja pasar las ediciones y los comandos rutinarios y pregunta por los arriesgados. Bypass lo aprueba todo.

Cuatro de esos cinco son un regulador de cuántas veces te interrumpen. El quinto ni siquiera es un modo.

Qué mide realmente el clasificador

Auto es el modo en el que se queda la mayoría, así que conviene saber qué decide. El clasificador que hay detrás mide el radio de impacto, no la intención: rm, sudo, git push, kubectl, npm publish, una escritura en una ruta absoluta fuera de /tmp. Todo lo que no reconoce como rutinario sigue preguntando.

Ese sesgo es deliberado y es el único sensato. El fallo que cuesta algo es aprobar un comando que destruye trabajo. El fallo en la otra dirección es que te pregunten por un ls más, lo que cuesta una pulsación. Un clasificador ajustado para ser listo con lo segundo es un clasificador que tarde o temprano se equivocará con lo primero.

Pero un clasificador conservador sigue siendo un clasificador. Lee un comando y adivina. bash -c 'python -c "..."' es una línea de shell cuyo radio de impacto no se ve en absoluto en sus argumentos, y ningún trabajo con patrones lo arregla, porque la información no está ahí para leerla.

Las reglas que no son conjeturas

Bajo los modos hay tres listas, que se comparan tanto con el nombre de una herramienta como con una forma Tool(argument):

{
  "allow": ["Bash(npm run test:*)", "mcp__github__get_*"],
  "ask":   ["Bash(git push*)"],
  "deny":  ["Bash(rm -rf *)", "write(.env*)"]
}

deny gana a todo, incluido el modo bypass. Es la única frase del sistema de permisos en la que una persona puede confiar por completo: no hay modo, ni aprobación, ni «permitir siempre» que reabra un camino que una regla deny ha cerrado. Todo lo que hay por encima —los modos, el clasificador, las solicitudes— es andamiaje alrededor de una pregunta: cuánto quieres que te pregunten.

Las aprobaciones persisten, y dónde persisten importa. «Permitir siempre» se escribe en un archivo de configuración en uno de tres ámbitos: ~/.oharness/settings.json para un hábito personal, .oharness/settings.json para algo que pertenece al repositorio y puede revisarse en un pull request, y .oharness/settings.local.json para una elección de esa copia de trabajo que se queda fuera de Git. Las denegaciones se acumulan en los tres y un ámbito más estrecho nunca las anula, porque un proyecto tiene que poder prohibir lo que un usuario permitió de forma global.

Lo que se escribe es el patrón más específico que cubre lo que aprobaste. Aprobar Bash(npm test) no debe conceder en silencio cualquier Bash(...), y aprobar una herramienta de una app conectada no debe conceder el resto de esa app, y mucho menos todas las apps que hayas conectado. Un sistema de permisos que se amplía solo mientras vas haciendo clic es peor que no tener sistema de permisos, porque produce un archivo de configuración que parece una política y se comporta como un bypass.

Las raíces con escritura son un filtro de política, no un sandbox

workspaceMode es read-only, workspace-write o full-access, y la comprobación se ejecuta antes de la solicitud de aprobación: ofrecer a alguien una opción que la política ya prohíbe es una buena forma de enseñarle que las solicitudes son decorativas.

Conviene ser exactos sobre qué es esa comprobación. Inspecciona los argumentos de las herramientas y rechaza las rutas fuera de las raíces permitidas. No confina el proceso. Un comando de shell puede llegar a cualquier ruta a la que llegues tú, y el caso de python -c de antes burla por completo la inspección de argumentos. El confinamiento real es una función del sistema operativo —un contenedor, una máquina virtual, una cuenta de usuario con menos derechos— y un harness que diga lo contrario está vendiendo la sensación de un límite.

Así que: una protección contra los errores, que es la mayor parte de lo que sale mal. No una protección contra un comando decidido, que es lo que la gente cree haber comprado.

El registro es lo que querrás más adelante

Cada decisión de permisos se registra junto a la transcripción que la produjo, como dos líneas emparejadas por id:

{"kind":"decision","id":"dec_9f2c","tool":"bash","behavior":"ask","principal":"Bash(npm test)"}
{"kind":"answer","id":"dec_9f2c","outcome":"allowed","remembered":"Bash(npm test)"}

La decisión es lo que dijeron las reglas. La respuesta es lo que dijo la persona. Un ask sin respuesta significa que el proceso se detuvo mientras la pregunta seguía en pantalla, que es justo el estado que no puedes reconstruir de memoria una semana después. outcome: "unavailable" es el caso de fallo cerrado: nada pudo preguntar, así que la llamada se rechazó sin nadie en el bucle.

Está activado salvo que lo desactives, porque el registro cuesta unas pocas líneas cortas por turno y el estado en el que falta es, sin excepción, el estado en el que resulta que se necesitaba. Se queda en el equipo que tomó las decisiones: la sincronización envía transcripciones y artefactos y, deliberadamente, no esto, y se elimina junto con su sesión.

Las escrituras en él son de tipo «disparar y olvidar», pero serializadas. Es una contrapartida elegida a propósito: el registro no debe retrasar ni hacer fallar una llamada a herramienta, así que una escritura fallida es una advertencia en el log, no un comando rechazado. Este registro describe lo que pasó. No lo controla. Que es, una vez más, la misma distinción: saber cuáles de tus controles son valoraciones y cuál es un límite.


OHarness es un harness de agentes de código abierto con licencia MIT. La referencia de permisos tiene la tabla completa de modos, ámbitos y formas de reglas, y la referencia de arquitectura explica dónde se sitúa la capa de permisos respecto al modelo y las herramientas.