Configurazione locale

Failproof AI mantiene separato ciò che un repository può eseguire nel commit — il cablaggio dei hook, i parametri delle policy, le policy personalizzate — dallo stato della macchina come credenziali, pack installati e daemon.

Scegli un ambito

Un ambito decide dove vengono cablati gli hook e in quale file di configurazione scrivi i parametri e i percorsi delle policy personalizzate:

User si applica a tutti i progetti su questa macchina.
Project appartiene al repository e può essere sottoposto a commit.
Local sovrascrive un progetto per un utente e deve rimanere gitignored.

failproofai policies --install --cli claude --scope project   # wire hooks for this repository
failproofai policies --install --cli claude --scope user      # or for every project on this machine
failproofai policies

Non tutti gli harness supportano l’ambito locale; la CLI rifiuta un ambito che l’harness selezionato non può rappresentare. Quali policy dei pack sono attive non sono scoped. L’interruttore viene registrato con il pack installato, quindi failproofai policies add <name> attiva una policy per tutta la macchina, indipendentemente da ciò che dice --scope.

Ambito	File di configurazione della policy
Project	`<project>/.failproofai/policies-config.json`
Local	`<project>/.failproofai/policies-config.local.json`
User	`~/.failproofai/policies-config.json`

I parametri delle policy utilizzano il primo ambito che definisce i parametri per quella policy, nell’ordine project → local → user. I percorsi espliciti delle policy personalizzate utilizzano il primo ambito che li definisce.

Configura i parametri delle policy

Dashboard
CLI

Apri la policy nel dashboard locale, modifica i suoi parametri supportati e salva nell’ambito selezionato. Esegui un’azione dell’agent corrispondente e non corrispondente, quindi ispeziona la decisione in Observe → policy.

Modifica il file policies-config.json dell’ambito selezionato, quindi esegui failproofai policies: ti avviserà di una voce policyParams che nomina una policy che nessun pack installato contiene. Non controlla le chiavi all’interno di una voce, quindi verifica la loro ortografia rispetto alla tabella sottostante.

{
  "policyParams": {
    "block-rm-rf": {
      "allowPaths": ["/tmp/build-output"]
    }
  }
}

failproofai policies

Parametri che le policy di Failproof AI accettano

Ogni policy valida i suoi propri tipi di parametri.

Policy	Parametro	Tipo e impostazione predefinita
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`; le voci contengono `regex` e `label`
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
Infrastructure blockers	`allowPatterns`	`string[]`, `[]`
`block-secrets-write`	`additionalPatterns`	`string[]`, `[]`
`block-push-master`	`protectedBranches`	`string[]`, `["main", "master"]`
`block-work-on-main`	`protectedBranches`	`string[]`, `["main", "master"]`
`prefer-package-manager`	`allowed`, `blocked`	`string[]`, `[]`
`warn-large-file-write`	`thresholdKb`	`number`, `1024`
`require-push-before-stop`	`remote`, `baseBranch`	`string`, `"origin"`; `string`, `"main"`
`require-pr-before-stop`	`baseBranch`	`string`, `"main"`
`require-no-conflicts-before-stop`	`baseBranch`	`string`, `"main"`

Un pattern di allowance amplia ciò che un agent può fare. Testa l’esatta tokenizzazione e le varianti di comando sull’harness di destinazione prima di implementarla in un parco.

Comprendi i file della macchina

~/.failproofai contiene file separati per confini di fiducia separati:

Percorso	Scopo
`config.json`	Impostazioni daemon, audit e telemetry non sensibili
`credentials.json`	Credenziali cloud; archiviati con permessi solo del proprietario
`policies-config.json`	Parametri di ambito utente e percorsi espliciti delle policy personalizzate
`policies/`	Policy di convenzione utente, pack installati e quali delle loro policy sono attive, e artefatti di policy gestiti da Cloud
`hook-activity/`	Log locale delle decisioni di policy
`state/`	Spool daemon, salute, pausa e stato di runtime

Utilizza FAILPROOFAI_HOME per riposizionare il layout completo della macchina per un container o un test isolato. Non riposizionare le directory di stato individualmente in modo indipendente.

Non eseguire mai il commit di credentials.json. Esegui il commit della configurazione della policy del progetto e delle policy di convenzione del progetto solo dopo averle revisionate come codice di enforcement.

Connect your agents

Reference

Scegli un ambito

Configura i parametri delle policy

Parametri che le policy di Failproof AI accettano

Comprendi i file della macchina

​Scegli un ambito

​Configura i parametri delle policy

​Parametri che le policy di Failproof AI accettano

​Comprendi i file della macchina

Scegli un ambito

Configura i parametri delle policy

Parametri che le policy di Failproof AI accettano

Comprendi i file della macchina