Una regola deny è l'unico confine che hai

· 5 min di lettura

Tutto il resto che un harness per agenti chiama permesso è una valutazione di costo. Vale la pena dirlo chiaramente, perché l'interfaccia non lo dice: una richiesta di approvazione, una modalità chiamata Auto e un'impostazione delle radici scrivibili sembrano tutte lo stesso tipo di cosa, e solo una di esse è un limite che il sistema manterrà in ogni caso.

OHarness ha cinque modalità di permesso. Manuale chiede prima di qualsiasi cosa modifichi lo stato. Accetta modifiche lascia passare le scritture sui file e chiede per il resto. Plan rifiuta ogni modifica e si limita a leggere. Auto lascia passare le modifiche e i comandi di routine e chiede per quelli rischiosi. Bypass approva tutto.

Quattro di queste cinque sono una manopola su quanto spesso vieni interrotto. La quinta non è affatto una modalità.

Cosa misura davvero il classificatore

Auto è la modalità in cui si stabilisce la maggior parte delle persone, quindi conviene sapere che cosa decide. Il classificatore dietro di essa misura il raggio d'impatto, non l'intenzione: rm, sudo, git push, kubectl, npm publish, una scrittura su un percorso assoluto fuori da /tmp. Tutto ciò che non riconosce come routine chiede comunque.

Questa inclinazione è voluta ed è l'unica sensata. L'errore che costa qualcosa è approvare un comando che distrugge lavoro. L'errore nella direzione opposta è sentirsi chiedere un ls in più, che costa un tasto. Un classificatore tarato per essere furbo sul secondo è un classificatore che prima o poi sbaglierà sul primo.

Ma un classificatore prudente resta un classificatore. Legge un comando e tira a indovinare. bash -c 'python -c "..."' è una riga di shell il cui raggio d'impatto non è affatto visibile dai suoi argomenti, e nessuna quantità di lavoro sui pattern lo risolve, perché l'informazione da leggere non c'è.

Le regole che non tirano a indovinare

Sotto le modalità ci sono tre liste, confrontate sia con il nome di uno strumento sia con una forma Tool(argument):

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

deny batte tutto, compresa la modalità bypass. È l'unica frase del sistema di permessi su cui una persona può fare affidamento in assoluto: non esiste modalità, approvazione o "consenti sempre" che riapra un percorso chiuso da una regola di divieto. Tutto ciò che sta sopra — le modalità, il classificatore, le richieste — è un'impalcatura attorno alla domanda su quanto vuoi che ti venga chiesto.

Le approvazioni persistono, e conta dove persistono. "Consenti sempre" viene scritto in un file di impostazioni in uno di tre ambiti: ~/.oharness/settings.json per un'abitudine personale, .oharness/settings.json per qualcosa che appartiene al repository e può essere revisionato in una pull request, e .oharness/settings.local.json per una scelta legata al singolo checkout che resta fuori da Git. I divieti si sommano su tutti e tre gli ambiti e non vengono mai scavalcati da un ambito più ristretto, perché un progetto deve poter vietare ciò che un utente ha consentito a livello globale.

Ciò che viene scritto è il pattern più specifico che copre quanto hai approvato. Approvare Bash(npm test) non deve concedere in silenzio ogni Bash(...), e approvare uno strumento di un'app collegata non deve concedere il resto di quell'app, tanto meno tutte le app che hai collegato. Un sistema di permessi che si allarga mentre fai clic è peggio di nessun sistema di permessi, perché produce un file di impostazioni che si legge come una policy e si comporta come un bypass.

Le radici scrivibili sono un filtro di policy, non una sandbox

workspaceMode vale read-only, workspace-write o full-access, e il controllo avviene prima della richiesta di approvazione: offrire a qualcuno una scelta che la policy già vieta è un buon modo per insegnargli che le richieste sono decorative.

Vale la pena essere precisi su che cosa sia questo controllo. Esamina gli argomenti degli strumenti e rifiuta i percorsi fuori dalle radici consentite. Non confina il processo. Un comando di shell può raggiungere qualsiasi percorso che puoi raggiungere tu, e il caso python -c visto sopra elude del tutto l'esame degli argomenti. Il vero confinamento è una funzione del sistema operativo — un container, una VM, un account utente con meno diritti — e un harness che sostiene il contrario vende la sensazione di un confine.

Quindi: una protezione contro gli errori, che sono la maggior parte di ciò che va storto. Non una protezione contro un comando determinato, che è ciò che la gente crede di aver comprato.

La traccia è la parte che vorrai più tardi

Ogni decisione sui permessi viene registrata accanto alla trascrizione che l'ha prodotta, come due righe abbinate tramite 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 decisione è ciò che dicevano le regole. La risposta è ciò che ha detto la persona. Un ask senza risposta significa che il processo si è fermato mentre la domanda era ancora a schermo — esattamente lo stato che una settimana dopo non riesci a ricostruire a memoria. outcome: "unavailable" è il caso fail-closed: nulla era in grado di chiedere, quindi la chiamata è stata rifiutata senza nessuno nel ciclo.

È attiva a meno che tu non la disattivi, perché la traccia costa poche righe brevi per turno e lo stato in cui manca è, immancabilmente, quello in cui si scopre che sarebbe servita. Resta sulla macchina che ha preso le decisioni: la sincronizzazione invia trascrizioni e artefatti e, deliberatamente, non questa, e viene eliminata insieme alla sua sessione.

Le scritture su di essa sono fire-and-forget ma serializzate. È un compromesso voluto: la registrazione non deve ritardare né far fallire una chiamata di strumento, quindi una scrittura non riuscita è un avviso nel log e non un comando rifiutato. Questa traccia descrive ciò che è successo. Non lo filtra. Che è, ancora una volta, la stessa distinzione: sapere quali dei tuoi controlli sono valutazioni e quale è un confine.


OHarness è un harness per agenti open source, con licenza MIT. Il riferimento sui permessi contiene la tabella completa di modalità, ambiti e forme delle regole, e il riferimento sull'architettura spiega dove si colloca il livello dei permessi rispetto al modello e agli strumenti.