failproofai 0.0.5 → 0.0.6-beta.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.next/standalone/.failproofai/policies/review-policies.mjs +112 -0
- package/.next/standalone/.failproofai/policies/workflow-policies.mjs +2 -1
- package/.next/standalone/.next/BUILD_ID +1 -1
- package/.next/standalone/.next/build-manifest.json +5 -5
- package/.next/standalone/.next/prerender-manifest.json +3 -3
- package/.next/standalone/.next/required-server-files.json +1 -1
- package/.next/standalone/.next/server/app/_global-error/page/build-manifest.json +2 -2
- package/.next/standalone/.next/server/app/_global-error/page/server-reference-manifest.json +1 -1
- package/.next/standalone/.next/server/app/_global-error/page.js.nft.json +1 -1
- package/.next/standalone/.next/server/app/_global-error/page_client-reference-manifest.js +1 -1
- package/.next/standalone/.next/server/app/_global-error.html +1 -1
- package/.next/standalone/.next/server/app/_global-error.rsc +7 -7
- package/.next/standalone/.next/server/app/_global-error.segments/__PAGE__.segment.rsc +2 -2
- package/.next/standalone/.next/server/app/_global-error.segments/_full.segment.rsc +7 -7
- package/.next/standalone/.next/server/app/_global-error.segments/_head.segment.rsc +3 -3
- package/.next/standalone/.next/server/app/_global-error.segments/_index.segment.rsc +3 -3
- package/.next/standalone/.next/server/app/_global-error.segments/_tree.segment.rsc +1 -1
- package/.next/standalone/.next/server/app/_not-found/page/build-manifest.json +2 -2
- package/.next/standalone/.next/server/app/_not-found/page/server-reference-manifest.json +1 -1
- package/.next/standalone/.next/server/app/_not-found/page.js.nft.json +1 -1
- package/.next/standalone/.next/server/app/_not-found/page_client-reference-manifest.js +1 -1
- package/.next/standalone/.next/server/app/_not-found.html +2 -2
- package/.next/standalone/.next/server/app/_not-found.rsc +15 -15
- package/.next/standalone/.next/server/app/_not-found.segments/_full.segment.rsc +15 -15
- package/.next/standalone/.next/server/app/_not-found.segments/_head.segment.rsc +4 -4
- package/.next/standalone/.next/server/app/_not-found.segments/_index.segment.rsc +10 -10
- package/.next/standalone/.next/server/app/_not-found.segments/_not-found/__PAGE__.segment.rsc +2 -2
- package/.next/standalone/.next/server/app/_not-found.segments/_not-found.segment.rsc +3 -3
- package/.next/standalone/.next/server/app/_not-found.segments/_tree.segment.rsc +1 -1
- package/.next/standalone/.next/server/app/index.html +1 -1
- package/.next/standalone/.next/server/app/index.rsc +15 -15
- package/.next/standalone/.next/server/app/index.segments/__PAGE__.segment.rsc +2 -2
- package/.next/standalone/.next/server/app/index.segments/_full.segment.rsc +15 -15
- package/.next/standalone/.next/server/app/index.segments/_head.segment.rsc +4 -4
- package/.next/standalone/.next/server/app/index.segments/_index.segment.rsc +10 -10
- package/.next/standalone/.next/server/app/index.segments/_tree.segment.rsc +1 -1
- package/.next/standalone/.next/server/app/page/build-manifest.json +2 -2
- package/.next/standalone/.next/server/app/page/server-reference-manifest.json +1 -1
- package/.next/standalone/.next/server/app/page.js.nft.json +1 -1
- package/.next/standalone/.next/server/app/page_client-reference-manifest.js +1 -1
- package/.next/standalone/.next/server/app/policies/page/build-manifest.json +2 -2
- package/.next/standalone/.next/server/app/policies/page/server-reference-manifest.json +8 -8
- package/.next/standalone/.next/server/app/policies/page.js.nft.json +1 -1
- package/.next/standalone/.next/server/app/policies/page_client-reference-manifest.js +1 -1
- package/.next/standalone/.next/server/app/project/[name]/page/build-manifest.json +2 -2
- package/.next/standalone/.next/server/app/project/[name]/page/server-reference-manifest.json +1 -1
- package/.next/standalone/.next/server/app/project/[name]/page.js.nft.json +1 -1
- package/.next/standalone/.next/server/app/project/[name]/page_client-reference-manifest.js +1 -1
- package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page/build-manifest.json +2 -2
- package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page/react-loadable-manifest.json +2 -2
- package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page/server-reference-manifest.json +2 -2
- package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page.js.nft.json +1 -1
- package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page_client-reference-manifest.js +1 -1
- package/.next/standalone/.next/server/app/projects/page/build-manifest.json +2 -2
- package/.next/standalone/.next/server/app/projects/page/server-reference-manifest.json +1 -1
- package/.next/standalone/.next/server/app/projects/page.js.nft.json +1 -1
- package/.next/standalone/.next/server/app/projects/page_client-reference-manifest.js +1 -1
- package/.next/standalone/.next/server/chunks/[root-of-the-server]__0g72weg._.js +1 -1
- package/.next/standalone/.next/server/chunks/package_json_[json]_cjs_0z7w.hh._.js +1 -1
- package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__092s1ta._.js +2 -2
- package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__09icjsf._.js +2 -2
- package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__0g.lg8b._.js +2 -2
- package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__0h..k-e._.js +2 -2
- package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__0okos0k._.js +2 -2
- package/.next/standalone/.next/server/chunks/ssr/{[root-of-the-server]__0a~g15g._.js → [root-of-the-server]__0rh.18_._.js} +2 -2
- package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__0w6l33k._.js +6 -6
- package/.next/standalone/.next/server/chunks/ssr/{[root-of-the-server]__0qn95h3._.js → [root-of-the-server]__0~kmh8w._.js} +2 -2
- package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__11pa2ra._.js +2 -2
- package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__12t-wym._.js +2 -2
- package/.next/standalone/.next/server/chunks/ssr/_10lm7or._.js +2 -2
- package/.next/standalone/.next/server/chunks/ssr/app_global-error_tsx_0xerkr6._.js +1 -1
- package/.next/standalone/.next/server/chunks/ssr/app_policies_hooks-client_tsx_0q-m0y-._.js +1 -1
- package/.next/standalone/.next/server/middleware-build-manifest.js +5 -5
- package/.next/standalone/.next/server/pages/404.html +2 -2
- package/.next/standalone/.next/server/pages/500.html +1 -1
- package/.next/standalone/.next/server/server-reference-manifest.js +1 -1
- package/.next/standalone/.next/server/server-reference-manifest.json +9 -9
- package/.next/standalone/.next/static/chunks/{0sme4lkv.tgn-.js → 01b~z8f1ws0rk.js} +1 -1
- package/.next/standalone/.next/static/chunks/{0lgbwkfqmnsmc.js → 03rz6ykw-a2xi.js} +1 -1
- package/.next/standalone/.next/static/chunks/{17manv47o-~wp.js → 08t08igdql9yt.js} +1 -1
- package/.next/standalone/.next/static/chunks/09_k80d~cq2wg.js +4 -0
- package/.next/standalone/.next/static/chunks/{0ksdlt_1hucdm.js → 0bvhsa6zva2o..js} +1 -1
- package/.next/standalone/.next/static/chunks/{09ikntpt2-o9b.js → 0gbf4cphy8ksq.js} +1 -1
- package/.next/standalone/.next/static/chunks/{0yumumfzx_f27.js → 0v.yd0kg_ld3r.js} +1 -1
- package/.next/standalone/.next/static/chunks/{13juklu.vksks.js → 0wlyoif4_kj_t.js} +1 -1
- package/.next/standalone/.next/static/chunks/{09e7drilkf1sn.js → 12simlrcfk3g2.js} +1 -1
- package/.next/standalone/.next/static/chunks/{0em7tspi4kylh.js → 12~yi9oj8av8p.js} +2 -2
- package/.next/standalone/.next/static/chunks/{turbopack-0r26pc8h0y_-e.js → turbopack-0o7k.hakttp4k.js} +1 -1
- package/.next/standalone/CHANGELOG.md +13 -0
- package/.next/standalone/README.md +2 -2
- package/.next/standalone/bun.lock +43 -85
- package/.next/standalone/dist/cli.mjs +107 -3
- package/.next/standalone/docs/ar/architecture.mdx +65 -64
- package/.next/standalone/docs/ar/configuration.mdx +42 -42
- package/.next/standalone/docs/ar/custom-policies.mdx +62 -64
- package/.next/standalone/docs/built-in-policies.mdx +37 -0
- package/.next/standalone/docs/custom-policies.mdx +1 -1
- package/.next/standalone/docs/de/architecture.mdx +92 -92
- package/.next/standalone/docs/de/configuration.mdx +34 -34
- package/.next/standalone/docs/de/custom-policies.mdx +49 -50
- package/.next/standalone/docs/es/architecture.mdx +72 -72
- package/.next/standalone/docs/es/configuration.mdx +25 -25
- package/.next/standalone/docs/es/custom-policies.mdx +48 -49
- package/.next/standalone/docs/examples.mdx +54 -0
- package/.next/standalone/docs/fr/architecture.mdx +53 -53
- package/.next/standalone/docs/fr/configuration.mdx +25 -25
- package/.next/standalone/docs/fr/custom-policies.mdx +42 -43
- package/.next/standalone/docs/getting-started.mdx +52 -0
- package/.next/standalone/docs/he/architecture.mdx +66 -66
- package/.next/standalone/docs/he/configuration.mdx +53 -52
- package/.next/standalone/docs/he/custom-policies.mdx +72 -73
- package/.next/standalone/docs/hi/architecture.mdx +106 -106
- package/.next/standalone/docs/hi/configuration.mdx +39 -39
- package/.next/standalone/docs/hi/custom-policies.mdx +75 -76
- package/.next/standalone/docs/i18n/README.ar.md +66 -66
- package/.next/standalone/docs/i18n/README.de.md +38 -38
- package/.next/standalone/docs/i18n/README.es.md +38 -38
- package/.next/standalone/docs/i18n/README.fr.md +42 -42
- package/.next/standalone/docs/i18n/README.he.md +67 -67
- package/.next/standalone/docs/i18n/README.hi.md +70 -70
- package/.next/standalone/docs/i18n/README.it.md +62 -62
- package/.next/standalone/docs/i18n/README.ja.md +54 -54
- package/.next/standalone/docs/i18n/README.ko.md +58 -58
- package/.next/standalone/docs/i18n/README.pt-br.md +43 -43
- package/.next/standalone/docs/i18n/README.ru.md +69 -69
- package/.next/standalone/docs/i18n/README.tr.md +76 -76
- package/.next/standalone/docs/i18n/README.vi.md +70 -70
- package/.next/standalone/docs/i18n/README.zh.md +52 -52
- package/.next/standalone/docs/it/architecture.mdx +54 -53
- package/.next/standalone/docs/it/configuration.mdx +44 -45
- package/.next/standalone/docs/it/custom-policies.mdx +76 -78
- package/.next/standalone/docs/ja/architecture.mdx +93 -93
- package/.next/standalone/docs/ja/configuration.mdx +47 -47
- package/.next/standalone/docs/ja/custom-policies.mdx +62 -63
- package/.next/standalone/docs/ko/architecture.mdx +66 -66
- package/.next/standalone/docs/ko/configuration.mdx +35 -35
- package/.next/standalone/docs/ko/custom-policies.mdx +71 -72
- package/.next/standalone/docs/pt-br/architecture.mdx +55 -55
- package/.next/standalone/docs/pt-br/configuration.mdx +35 -35
- package/.next/standalone/docs/pt-br/custom-policies.mdx +60 -61
- package/.next/standalone/docs/ru/architecture.mdx +59 -60
- package/.next/standalone/docs/ru/configuration.mdx +52 -53
- package/.next/standalone/docs/ru/custom-policies.mdx +68 -69
- package/.next/standalone/docs/tr/architecture.mdx +124 -124
- package/.next/standalone/docs/tr/configuration.mdx +45 -46
- package/.next/standalone/docs/tr/custom-policies.mdx +75 -75
- package/.next/standalone/docs/vi/architecture.mdx +65 -64
- package/.next/standalone/docs/vi/configuration.mdx +41 -41
- package/.next/standalone/docs/vi/custom-policies.mdx +68 -69
- package/.next/standalone/docs/zh/architecture.mdx +67 -67
- package/.next/standalone/docs/zh/configuration.mdx +34 -34
- package/.next/standalone/docs/zh/custom-policies.mdx +53 -54
- package/.next/standalone/node_modules/@next/env/package.json +1 -1
- package/.next/standalone/node_modules/next/dist/build/swc/index.js +1 -1
- package/.next/standalone/node_modules/next/dist/compiled/next-server/pages-turbo.runtime.prod.js +7 -7
- package/.next/standalone/node_modules/next/dist/lib/patch-incorrect-lockfile.js +3 -3
- package/.next/standalone/node_modules/next/dist/server/config-schema.js +10 -2
- package/.next/standalone/node_modules/next/dist/server/config.js +1 -1
- package/.next/standalone/node_modules/next/dist/server/dev/hot-reloader-turbopack.js +2 -2
- package/.next/standalone/node_modules/next/dist/server/dev/hot-reloader-webpack.js +1 -1
- package/.next/standalone/node_modules/next/dist/server/lib/app-info-log.js +1 -1
- package/.next/standalone/node_modules/next/dist/server/lib/start-server.js +1 -1
- package/.next/standalone/node_modules/next/dist/server/render.js +27 -20
- package/.next/standalone/node_modules/next/dist/shared/lib/errors/canary-only-config-error.js +1 -1
- package/.next/standalone/node_modules/next/dist/telemetry/anonymous-meta.js +1 -1
- package/.next/standalone/node_modules/next/dist/telemetry/events/swc-load-failure.js +1 -1
- package/.next/standalone/node_modules/next/dist/telemetry/events/version.js +2 -2
- package/.next/standalone/node_modules/next/package.json +15 -15
- package/.next/standalone/package.json +2 -2
- package/.next/standalone/server.js +1 -1
- package/.next/standalone/src/hooks/builtin-policies.ts +131 -0
- package/README.md +2 -2
- package/dist/cli.mjs +107 -3
- package/package.json +2 -2
- package/src/hooks/builtin-policies.ts +131 -0
- package/.next/standalone/.next/static/chunks/0_yayar~bpphd.js +0 -4
- /package/.next/standalone/.next/static/{hYQM6iCWnF1W5XDpsIRhV → CkmOT-ZvDN-sVULinGVKT}/_buildManifest.js +0 -0
- /package/.next/standalone/.next/static/{hYQM6iCWnF1W5XDpsIRhV → CkmOT-ZvDN-sVULinGVKT}/_clientMiddlewareManifest.js +0 -0
- /package/.next/standalone/.next/static/{hYQM6iCWnF1W5XDpsIRhV → CkmOT-ZvDN-sVULinGVKT}/_ssgManifest.js +0 -0
|
@@ -23,12 +23,12 @@
|
|
|
23
23
|
|
|
24
24
|
**Traduzioni**: [简体中文](docs/i18n/README.zh.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) | [Español](docs/i18n/README.es.md) | [Português](docs/i18n/README.pt-br.md) | [Deutsch](docs/i18n/README.de.md) | [Français](docs/i18n/README.fr.md) | [Русский](docs/i18n/README.ru.md) | [हिन्दी](docs/i18n/README.hi.md) | [Türkçe](docs/i18n/README.tr.md) | [Tiếng Việt](docs/i18n/README.vi.md) | [Italiano](docs/i18n/README.it.md) | [العربية](docs/i18n/README.ar.md) | [עברית](docs/i18n/README.he.md)
|
|
25
25
|
|
|
26
|
-
Il modo più semplice per gestire
|
|
26
|
+
Il modo più semplice per gestire le policy che mantengono i tuoi agenti AI affidabili, focalizzati e in esecuzione autonoma - per **Claude Code** e **Agents SDK**.
|
|
27
27
|
|
|
28
|
-
- **30
|
|
29
|
-
- **
|
|
30
|
-
- **Configurazione Facile** - Personalizza qualsiasi
|
|
31
|
-
- **Monitoraggio Agenti** - Vedi cosa hanno fatto i tuoi agenti mentre eri assente. Sfoglia le sessioni, ispeziona ogni chiamata di
|
|
28
|
+
- **30 Policy Integrate** - Rileva i comuni modi di fallimento degli agenti immediatamente. Blocca i comandi distruttivi, previeni le fughe di segreti, mantieni gli agenti entro i confini del progetto, rileva i loop e altro ancora.
|
|
29
|
+
- **Policy Personalizzate** - Scrivi le tue regole di affidabilità in JavaScript. Usa l'API `allow`/`deny`/`instruct` per imporre convenzioni, prevenire derive, controllare operazioni o integrarti con sistemi esterni.
|
|
30
|
+
- **Configurazione Facile** - Personalizza qualsiasi policy senza scrivere codice. Imposta allowlist, rami protetti, soglie per progetto o globalmente. La configurazione con tre ambiti si unisce automaticamente.
|
|
31
|
+
- **Monitoraggio Agenti** - Vedi cosa hanno fatto i tuoi agenti mentre eri assente. Sfoglia le sessioni, ispeziona ogni chiamata di strumento e verifica esattamente dove sono state applicate le policy.
|
|
32
32
|
|
|
33
33
|
Tutto funziona localmente - nessun dato esce dalla tua macchina.
|
|
34
34
|
|
|
@@ -41,7 +41,7 @@ Tutto funziona localmente - nessun dato esce dalla tua macchina.
|
|
|
41
41
|
|
|
42
42
|
---
|
|
43
43
|
|
|
44
|
-
##
|
|
44
|
+
## Installa
|
|
45
45
|
|
|
46
46
|
```bash
|
|
47
47
|
npm install -g failproofai
|
|
@@ -51,15 +51,15 @@ bun add -g failproofai
|
|
|
51
51
|
|
|
52
52
|
---
|
|
53
53
|
|
|
54
|
-
##
|
|
54
|
+
## Avvio rapido
|
|
55
55
|
|
|
56
|
-
### 1. Abilita
|
|
56
|
+
### 1. Abilita le policy globalmente
|
|
57
57
|
|
|
58
58
|
```bash
|
|
59
59
|
failproofai policies --install
|
|
60
60
|
```
|
|
61
61
|
|
|
62
|
-
Scrive voci di hook in `~/.claude/settings.json`. Claude Code ora
|
|
62
|
+
Scrive le voci di hook in `~/.claude/settings.json`. Claude Code ora richiamerà failproofai prima e dopo ogni chiamata di strumento.
|
|
63
63
|
|
|
64
64
|
### 2. Avvia il dashboard
|
|
65
65
|
|
|
@@ -67,7 +67,7 @@ Scrive voci di hook in `~/.claude/settings.json`. Claude Code ora invocherà fai
|
|
|
67
67
|
failproofai
|
|
68
68
|
```
|
|
69
69
|
|
|
70
|
-
Apre `http://localhost:8020` - sfoglia le sessioni, ispeziona i log, gestisci
|
|
70
|
+
Apre `http://localhost:8020` - sfoglia le sessioni, ispeziona i log, gestisci le policy.
|
|
71
71
|
|
|
72
72
|
### 3. Controlla cosa è attivo
|
|
73
73
|
|
|
@@ -77,7 +77,7 @@ failproofai policies
|
|
|
77
77
|
|
|
78
78
|
---
|
|
79
79
|
|
|
80
|
-
## Installazione
|
|
80
|
+
## Installazione delle policy
|
|
81
81
|
|
|
82
82
|
### Ambiti
|
|
83
83
|
|
|
@@ -87,17 +87,17 @@ failproofai policies
|
|
|
87
87
|
| Progetto | `failproofai policies --install --scope project` | `.claude/settings.json` |
|
|
88
88
|
| Locale | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
|
|
89
89
|
|
|
90
|
-
### Installa
|
|
90
|
+
### Installa policy specifiche
|
|
91
91
|
|
|
92
92
|
```bash
|
|
93
93
|
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
|
|
94
94
|
```
|
|
95
95
|
|
|
96
|
-
### Rimuovi
|
|
96
|
+
### Rimuovi policy
|
|
97
97
|
|
|
98
98
|
```bash
|
|
99
99
|
failproofai policies --uninstall
|
|
100
|
-
#
|
|
100
|
+
# o per uno specifico ambito:
|
|
101
101
|
failproofai policies --uninstall --scope project
|
|
102
102
|
```
|
|
103
103
|
|
|
@@ -105,7 +105,7 @@ failproofai policies --uninstall --scope project
|
|
|
105
105
|
|
|
106
106
|
## Configurazione
|
|
107
107
|
|
|
108
|
-
La configurazione
|
|
108
|
+
La configurazione delle policy si trova in `~/.failproofai/policies-config.json` (globale) o `.failproofai/policies-config.json` nel tuo progetto (per progetto).
|
|
109
109
|
|
|
110
110
|
```json
|
|
111
111
|
{
|
|
@@ -120,11 +120,11 @@ La configurazione dei criteri si trova in `~/.failproofai/policies-config.json`
|
|
|
120
120
|
"policyParams": {
|
|
121
121
|
"block-sudo": {
|
|
122
122
|
"allowPatterns": ["sudo systemctl status", "sudo journalctl"],
|
|
123
|
-
"hint": "
|
|
123
|
+
"hint": "Use apt-get directly without sudo."
|
|
124
124
|
},
|
|
125
125
|
"block-push-master": {
|
|
126
126
|
"protectedBranches": ["main", "release", "prod"],
|
|
127
|
-
"hint": "
|
|
127
|
+
"hint": "Try creating a fresh branch instead."
|
|
128
128
|
},
|
|
129
129
|
"sanitize-api-keys": {
|
|
130
130
|
"additionalPatterns": [
|
|
@@ -138,48 +138,48 @@ La configurazione dei criteri si trova in `~/.failproofai/policies-config.json`
|
|
|
138
138
|
}
|
|
139
139
|
```
|
|
140
140
|
|
|
141
|
-
**Tre ambiti di configurazione**
|
|
141
|
+
**Tre ambiti di configurazione** vengono uniti automaticamente (progetto → locale → globale). Vedi [docs/configuration.mdx](docs/configuration.mdx) per le regole di unione complete.
|
|
142
142
|
|
|
143
143
|
---
|
|
144
144
|
|
|
145
|
-
##
|
|
146
|
-
|
|
147
|
-
|
|
|
148
|
-
|
|
149
|
-
| `block-sudo` | Previeni gli agenti
|
|
150
|
-
| `block-rm-rf` | Previeni l'eliminazione ricorsiva
|
|
151
|
-
| `block-curl-pipe-sh` | Previeni gli agenti
|
|
152
|
-
| `block-failproofai-commands` | Previeni l'
|
|
153
|
-
| `sanitize-jwt` |
|
|
154
|
-
| `sanitize-api-keys` |
|
|
155
|
-
| `sanitize-connection-strings` |
|
|
145
|
+
## Policy integrate
|
|
146
|
+
|
|
147
|
+
| Policy | Descrizione | Configurabile |
|
|
148
|
+
|--------|-------------|:---:|
|
|
149
|
+
| `block-sudo` | Previeni che gli agenti eseguano comandi di sistema privilegiati | `allowPatterns` |
|
|
150
|
+
| `block-rm-rf` | Previeni l'eliminazione accidentale ricorsiva di file | `allowPaths` |
|
|
151
|
+
| `block-curl-pipe-sh` | Previeni che gli agenti inviino script non attendibili alla shell tramite pipe | |
|
|
152
|
+
| `block-failproofai-commands` | Previeni l'autodisininstallazione | |
|
|
153
|
+
| `sanitize-jwt` | Ferma i token JWT dal trapelare nel contesto dell'agente | |
|
|
154
|
+
| `sanitize-api-keys` | Ferma le chiavi API dal trapelare nel contesto dell'agente | `additionalPatterns` |
|
|
155
|
+
| `sanitize-connection-strings` | Ferma le credenziali del database dal trapelare nel contesto dell'agente | |
|
|
156
156
|
| `sanitize-private-key-content` | Redigi i blocchi di chiave privata PEM dall'output | |
|
|
157
157
|
| `sanitize-bearer-tokens` | Redigi i token Authorization Bearer dall'output | |
|
|
158
|
-
| `block-env-files` |
|
|
159
|
-
| `protect-env-vars` | Previeni gli agenti
|
|
160
|
-
| `block-read-outside-cwd` | Mantieni gli agenti
|
|
161
|
-
| `block-secrets-write` | Previeni le scritture
|
|
162
|
-
| `block-push-master` | Previeni i push accidentali
|
|
163
|
-
| `block-work-on-main` | Mantieni gli agenti
|
|
158
|
+
| `block-env-files` | Mantieni gli agenti lontani dalla lettura dei file .env | |
|
|
159
|
+
| `protect-env-vars` | Previeni che gli agenti stampino le variabili di ambiente | |
|
|
160
|
+
| `block-read-outside-cwd` | Mantieni gli agenti entro i confini del progetto | `allowPaths` |
|
|
161
|
+
| `block-secrets-write` | Previeni le scritture nei file di chiave privata e certificati | `additionalPatterns` |
|
|
162
|
+
| `block-push-master` | Previeni i push accidentali a main/master | `protectedBranches` |
|
|
163
|
+
| `block-work-on-main` | Mantieni gli agenti lontani dai rami protetti | `protectedBranches` |
|
|
164
164
|
| `block-force-push` | Previeni `git push --force` | |
|
|
165
165
|
| `warn-git-amend` | Ricorda agli agenti prima di modificare i commit | |
|
|
166
166
|
| `warn-git-stash-drop` | Ricorda agli agenti prima di eliminare gli stash | |
|
|
167
167
|
| `warn-all-files-staged` | Rileva `git add -A` accidentale | |
|
|
168
168
|
| `warn-destructive-sql` | Rileva DROP/DELETE SQL prima dell'esecuzione | |
|
|
169
169
|
| `warn-schema-alteration` | Rileva ALTER TABLE prima dell'esecuzione | |
|
|
170
|
-
| `warn-large-file-write` | Rileva
|
|
170
|
+
| `warn-large-file-write` | Rileva scritture di file inaspettatamente grandi | `thresholdKb` |
|
|
171
171
|
| `warn-package-publish` | Rileva `npm publish` accidentale | |
|
|
172
|
-
| `warn-background-process` | Rileva
|
|
173
|
-
| `warn-global-package-install` | Rileva
|
|
174
|
-
| …e
|
|
172
|
+
| `warn-background-process` | Rileva avvii di processi in background non previsti | |
|
|
173
|
+
| `warn-global-package-install` | Rileva installazioni di pacchetti globali non previste | |
|
|
174
|
+
| …e altre | | |
|
|
175
175
|
|
|
176
|
-
Dettagli completi
|
|
176
|
+
Dettagli completi delle policy e riferimento dei parametri: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
|
|
177
177
|
|
|
178
178
|
---
|
|
179
179
|
|
|
180
|
-
##
|
|
180
|
+
## Policy personalizzate
|
|
181
181
|
|
|
182
|
-
Scrivi
|
|
182
|
+
Scrivi le tue policy per mantenere gli agenti affidabili e focalizzati:
|
|
183
183
|
|
|
184
184
|
```js
|
|
185
185
|
import { customPolicies, allow, deny, instruct } from "failproofai";
|
|
@@ -203,35 +203,35 @@ Installa con:
|
|
|
203
203
|
failproofai policies --install --custom ./my-policies.js
|
|
204
204
|
```
|
|
205
205
|
|
|
206
|
-
###
|
|
206
|
+
### Funzioni helper per le decisioni
|
|
207
207
|
|
|
208
208
|
| Funzione | Effetto |
|
|
209
209
|
|----------|--------|
|
|
210
210
|
| `allow()` | Consenti l'operazione |
|
|
211
211
|
| `allow(message)` | Consenti e invia contesto informativo a Claude |
|
|
212
|
-
| `deny(message)` | Blocca l'operazione; messaggio mostrato a Claude |
|
|
212
|
+
| `deny(message)` | Blocca l'operazione; il messaggio viene mostrato a Claude |
|
|
213
213
|
| `instruct(message)` | Aggiungi contesto al prompt di Claude; non blocca |
|
|
214
214
|
|
|
215
|
-
### Oggetto contesto (`ctx`)
|
|
215
|
+
### Oggetto di contesto (`ctx`)
|
|
216
216
|
|
|
217
217
|
| Campo | Tipo | Descrizione |
|
|
218
218
|
|-------|------|-------------|
|
|
219
219
|
| `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
|
|
220
|
-
| `toolName` | `string` |
|
|
221
|
-
| `toolInput` | `object` | Parametri di input
|
|
222
|
-
| `payload` | `object` | Payload
|
|
220
|
+
| `toolName` | `string` | Strumento richiamato (`"Bash"`, `"Write"`, `"Read"`, …) |
|
|
221
|
+
| `toolInput` | `object` | Parametri di input dello strumento |
|
|
222
|
+
| `payload` | `object` | Payload grezzo completo dell'evento |
|
|
223
223
|
| `session.cwd` | `string` | Directory di lavoro della sessione Claude Code |
|
|
224
224
|
| `session.sessionId` | `string` | Identificatore della sessione |
|
|
225
225
|
| `session.transcriptPath` | `string` | Percorso del file di trascrizione della sessione |
|
|
226
226
|
|
|
227
|
-
|
|
227
|
+
I hook personalizzati supportano importazioni locali transitive, async/await e accesso a `process.env`. Gli errori sono fail-open (registrati in `~/.failproofai/hook.log`, le policy integrate continuano). Vedi [docs/custom-hooks.mdx](docs/custom-hooks.mdx) per la guida completa.
|
|
228
228
|
|
|
229
|
-
###
|
|
229
|
+
### Policy basate su convenzione
|
|
230
230
|
|
|
231
|
-
|
|
231
|
+
Metti i file `*policies.{js,mjs,ts}` in `.failproofai/policies/` e vengono caricati automaticamente - nessun flag `--custom` o modifiche di configurazione necessarie. Funziona come i git hook: metti un file e basta.
|
|
232
232
|
|
|
233
233
|
```text
|
|
234
|
-
# Livello di progetto —
|
|
234
|
+
# Livello di progetto — commits in git, condiviso con il team
|
|
235
235
|
.failproofai/policies/security-policies.mjs
|
|
236
236
|
.failproofai/policies/workflow-policies.mjs
|
|
237
237
|
|
|
@@ -239,13 +239,13 @@ Inserisci i file `*policies.{js,mjs,ts}` in `.failproofai/policies/` e vengono c
|
|
|
239
239
|
~/.failproofai/policies/my-policies.mjs
|
|
240
240
|
```
|
|
241
241
|
|
|
242
|
-
Entrambi i livelli si caricano (unione). I file vengono caricati alfabeticamente all'interno di ogni directory.
|
|
242
|
+
Entrambi i livelli si caricano (unione). I file vengono caricati alfabeticamente all'interno di ogni directory. Usa il prefisso `01-`, `02-`, ecc. per controllare l'ordine. Vedi [examples/convention-policies/](examples/convention-policies/) per esempi pronti all'uso.
|
|
243
243
|
|
|
244
244
|
---
|
|
245
245
|
|
|
246
246
|
## Telemetria
|
|
247
247
|
|
|
248
|
-
Failproof AI raccoglie telemetria di utilizzo anonima tramite PostHog per comprendere l'utilizzo delle
|
|
248
|
+
Failproof AI raccoglie telemetria di utilizzo anonima tramite PostHog per comprendere l'utilizzo delle funzioni. Nessun contenuto di sessione, nome di file, input di strumenti o informazioni personali viene mai inviato.
|
|
249
249
|
|
|
250
250
|
Disabilitalo:
|
|
251
251
|
|
|
@@ -260,12 +260,12 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
|
|
|
260
260
|
| Guida | Descrizione |
|
|
261
261
|
|-------|-------------|
|
|
262
262
|
| [Getting Started](docs/getting-started.mdx) | Installazione e primi passi |
|
|
263
|
-
| [Built-in Policies](docs/built-in-policies.mdx) |
|
|
264
|
-
| [Custom Policies](docs/custom-policies.mdx) | Scrivi
|
|
263
|
+
| [Built-in Policies](docs/built-in-policies.mdx) | Tutte le 30 policy integrate con parametri |
|
|
264
|
+
| [Custom Policies](docs/custom-policies.mdx) | Scrivi le tue policy |
|
|
265
265
|
| [Configuration](docs/configuration.mdx) | Formato del file di configurazione e unione degli ambiti |
|
|
266
|
-
| [Dashboard](docs/dashboard.mdx) | Monitora le sessioni e
|
|
266
|
+
| [Dashboard](docs/dashboard.mdx) | Monitora le sessioni e verifica l'attività delle policy |
|
|
267
267
|
| [Architecture](docs/architecture.mdx) | Come funziona il sistema di hook |
|
|
268
|
-
| [Testing](docs/testing.mdx) | Eseguire test e scrivere nuovi
|
|
268
|
+
| [Testing](docs/testing.mdx) | Eseguire i test e scrivere i nuovi |
|
|
269
269
|
|
|
270
270
|
### Esegui la documentazione localmente
|
|
271
271
|
|
|
@@ -274,7 +274,7 @@ docker build -f Dockerfile.docs -t failproofai-docs .
|
|
|
274
274
|
docker run --rm -p 3000:3000 failproofai-docs
|
|
275
275
|
```
|
|
276
276
|
|
|
277
|
-
Apre il sito della documentazione Mintlify su `http://localhost:3000`. Il contenitore
|
|
277
|
+
Apre il sito della documentazione Mintlify su `http://localhost:3000`. Il contenitore osserva i cambiamenti se monti la directory dei documenti:
|
|
278
278
|
|
|
279
279
|
```bash
|
|
280
280
|
docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
|
|
@@ -284,9 +284,9 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
|
|
|
284
284
|
|
|
285
285
|
## Nota per i contributori di failproofai
|
|
286
286
|
|
|
287
|
-
Il file `.claude/settings.json` di questo
|
|
287
|
+
Il file `.claude/settings.json` di questo repository utilizza `bun ./bin/failproofai.mjs --hook <EventType>` al posto del comando standard `npx -y failproofai`. Questo perché eseguire `npx -y failproofai` all'interno del progetto failproofai stesso crea un conflitto auto-referenziante.
|
|
288
288
|
|
|
289
|
-
Per tutti gli altri
|
|
289
|
+
Per tutti gli altri repository, l'approccio consigliato è `npx -y failproofai`, installato tramite:
|
|
290
290
|
|
|
291
291
|
```bash
|
|
292
292
|
failproofai policies --install --scope project
|
|
@@ -304,4 +304,4 @@ Vedi [LICENSE](LICENSE).
|
|
|
304
304
|
|
|
305
305
|
---
|
|
306
306
|
|
|
307
|
-
|
|
307
|
+
Costruito e mantenuto da **ExosphereHost: Reliability Research Lab per i tuoi Agenti**. Aiutiamo aziende e startup a migliorare l'affidabilità dei loro agenti AI attraverso i nostri agenti, software e expertise. Scopri di più su [exosphere.host](https://exosphere.host).
|
|
@@ -23,21 +23,21 @@
|
|
|
23
23
|
|
|
24
24
|
**翻訳**: [简体中文](docs/i18n/README.zh.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) | [Español](docs/i18n/README.es.md) | [Português](docs/i18n/README.pt-br.md) | [Deutsch](docs/i18n/README.de.md) | [Français](docs/i18n/README.fr.md) | [Русский](docs/i18n/README.ru.md) | [हिन्दी](docs/i18n/README.hi.md) | [Türkçe](docs/i18n/README.tr.md) | [Tiếng Việt](docs/i18n/README.vi.md) | [Italiano](docs/i18n/README.it.md) | [العربية](docs/i18n/README.ar.md) | [עברית](docs/i18n/README.he.md)
|
|
25
25
|
|
|
26
|
-
AI
|
|
26
|
+
AIエージェントを安定稼働させ、タスクに集中させ、自律的に動作させ続けるためのポリシー管理ツール — **Claude Code** および **Agents SDK** 対応。
|
|
27
27
|
|
|
28
|
-
- **30
|
|
29
|
-
- **カスタムポリシー** - JavaScriptで独自の信頼性ルールを記述。`allow`/`deny`/`instruct` API
|
|
30
|
-
- **簡単な設定** -
|
|
31
|
-
- **エージェントモニター** -
|
|
28
|
+
- **30種類の組み込みポリシー** - よくあるエージェントの障害パターンをすぐに検出。破壊的なコマンドのブロック、シークレット漏洩の防止、エージェントをプロジェクト境界内に制限、ループの検出など。
|
|
29
|
+
- **カスタムポリシー** - JavaScriptで独自の信頼性ルールを記述。`allow`/`deny`/`instruct` APIを使用して、規約の強制、ドリフトの防止、操作のゲート、外部システムとの連携が可能。
|
|
30
|
+
- **簡単な設定** - コードを書かずにポリシーを調整。許可リスト、保護ブランチ、しきい値をプロジェクトごとまたはグローバルに設定可能。3段階のスコープ設定が自動的にマージ。
|
|
31
|
+
- **エージェントモニター** - 不在時にエージェントが行ったことを確認。セッションの閲覧、すべてのツール呼び出しの検査、ポリシーが発動した箇所の詳細レビュー。
|
|
32
32
|
|
|
33
|
-
すべてローカルで動作 —
|
|
33
|
+
すべてローカルで動作 — データが外部に送信されることはありません。
|
|
34
34
|
|
|
35
35
|
---
|
|
36
36
|
|
|
37
37
|
## 動作要件
|
|
38
38
|
|
|
39
39
|
- Node.js >= 20.9.0
|
|
40
|
-
- Bun >= 1.3.0(任意 —
|
|
40
|
+
- Bun >= 1.3.0(任意 — 開発時またはソースからビルドする場合のみ必要)
|
|
41
41
|
|
|
42
42
|
---
|
|
43
43
|
|
|
@@ -59,7 +59,7 @@ bun add -g failproofai
|
|
|
59
59
|
failproofai policies --install
|
|
60
60
|
```
|
|
61
61
|
|
|
62
|
-
`~/.claude/settings.json`
|
|
62
|
+
`~/.claude/settings.json` にフックエントリを書き込みます。これ以降、Claude Code は各ツール呼び出しの前後に failproofai を起動します。
|
|
63
63
|
|
|
64
64
|
### 2. ダッシュボードを起動
|
|
65
65
|
|
|
@@ -67,7 +67,7 @@ failproofai policies --install
|
|
|
67
67
|
failproofai
|
|
68
68
|
```
|
|
69
69
|
|
|
70
|
-
`http://localhost:8020` が開きます —
|
|
70
|
+
`http://localhost:8020` が開きます — セッションの閲覧、ログの確認、ポリシーの管理が行えます。
|
|
71
71
|
|
|
72
72
|
### 3. 有効なポリシーを確認
|
|
73
73
|
|
|
@@ -82,7 +82,7 @@ failproofai policies
|
|
|
82
82
|
### スコープ
|
|
83
83
|
|
|
84
84
|
| スコープ | コマンド | 書き込み先 |
|
|
85
|
-
|
|
85
|
+
|-------|---------|-----------------|
|
|
86
86
|
| グローバル(デフォルト) | `failproofai policies --install` | `~/.claude/settings.json` |
|
|
87
87
|
| プロジェクト | `failproofai policies --install --scope project` | `.claude/settings.json` |
|
|
88
88
|
| ローカル | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
|
|
@@ -93,7 +93,7 @@ failproofai policies
|
|
|
93
93
|
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
|
|
94
94
|
```
|
|
95
95
|
|
|
96
|
-
###
|
|
96
|
+
### ポリシーを削除
|
|
97
97
|
|
|
98
98
|
```bash
|
|
99
99
|
failproofai policies --uninstall
|
|
@@ -105,7 +105,7 @@ failproofai policies --uninstall --scope project
|
|
|
105
105
|
|
|
106
106
|
## 設定
|
|
107
107
|
|
|
108
|
-
|
|
108
|
+
ポリシー設定は `~/.failproofai/policies-config.json`(グローバル)またはプロジェクト内の `.failproofai/policies-config.json`(プロジェクト単位)に保存されます。
|
|
109
109
|
|
|
110
110
|
```json
|
|
111
111
|
{
|
|
@@ -142,32 +142,32 @@ failproofai policies --uninstall --scope project
|
|
|
142
142
|
|
|
143
143
|
---
|
|
144
144
|
|
|
145
|
-
##
|
|
145
|
+
## 組み込みポリシー
|
|
146
146
|
|
|
147
147
|
| ポリシー | 説明 | 設定可能パラメータ |
|
|
148
|
-
|
|
148
|
+
|--------|-------------|:---:|
|
|
149
149
|
| `block-sudo` | エージェントによる特権システムコマンドの実行を防止 | `allowPatterns` |
|
|
150
|
-
| `block-rm-rf` |
|
|
151
|
-
| `block-curl-pipe-sh` |
|
|
150
|
+
| `block-rm-rf` | 誤ったファイルの再帰的削除を防止 | `allowPaths` |
|
|
151
|
+
| `block-curl-pipe-sh` | 信頼できないスクリプトをシェルにパイプすることを防止 | |
|
|
152
152
|
| `block-failproofai-commands` | 自己アンインストールを防止 | |
|
|
153
|
-
| `sanitize-jwt` | JWT
|
|
154
|
-
| `sanitize-api-keys` | API
|
|
155
|
-
| `sanitize-connection-strings` |
|
|
156
|
-
| `sanitize-private-key-content` | 出力からPEM
|
|
157
|
-
| `sanitize-bearer-tokens` | 出力からAuthorization Bearer
|
|
158
|
-
| `block-env-files` |
|
|
159
|
-
| `protect-env-vars` |
|
|
153
|
+
| `sanitize-jwt` | JWTトークンがエージェントのコンテキストに漏洩するのを防止 | |
|
|
154
|
+
| `sanitize-api-keys` | APIキーがエージェントのコンテキストに漏洩するのを防止 | `additionalPatterns` |
|
|
155
|
+
| `sanitize-connection-strings` | データベース認証情報がエージェントのコンテキストに漏洩するのを防止 | |
|
|
156
|
+
| `sanitize-private-key-content` | 出力からPEM秘密鍵ブロックを削除 | |
|
|
157
|
+
| `sanitize-bearer-tokens` | 出力からAuthorization Bearerトークンを削除 | |
|
|
158
|
+
| `block-env-files` | エージェントが.envファイルを読み取ることを防止 | |
|
|
159
|
+
| `protect-env-vars` | エージェントが環境変数を出力することを防止 | |
|
|
160
160
|
| `block-read-outside-cwd` | エージェントをプロジェクト境界内に制限 | `allowPaths` |
|
|
161
161
|
| `block-secrets-write` | 秘密鍵・証明書ファイルへの書き込みを防止 | `additionalPatterns` |
|
|
162
|
-
| `block-push-master` | main/master
|
|
163
|
-
| `block-work-on-main` |
|
|
162
|
+
| `block-push-master` | main/masterへの誤ったプッシュを防止 | `protectedBranches` |
|
|
163
|
+
| `block-work-on-main` | エージェントが保護ブランチで作業することを防止 | `protectedBranches` |
|
|
164
164
|
| `block-force-push` | `git push --force` を防止 | |
|
|
165
|
-
| `warn-git-amend` |
|
|
166
|
-
| `warn-git-stash-drop` |
|
|
165
|
+
| `warn-git-amend` | コミット修正前にエージェントに通知 | |
|
|
166
|
+
| `warn-git-stash-drop` | スタッシュの破棄前にエージェントに通知 | |
|
|
167
167
|
| `warn-all-files-staged` | 誤った `git add -A` を検出 | |
|
|
168
168
|
| `warn-destructive-sql` | 実行前にDROP/DELETE SQLを検出 | |
|
|
169
169
|
| `warn-schema-alteration` | 実行前にALTER TABLEを検出 | |
|
|
170
|
-
| `warn-large-file-write` |
|
|
170
|
+
| `warn-large-file-write` | 予期せず大きなファイル書き込みを検出 | `thresholdKb` |
|
|
171
171
|
| `warn-package-publish` | 誤った `npm publish` を検出 | |
|
|
172
172
|
| `warn-background-process` | 意図しないバックグラウンドプロセスの起動を検出 | |
|
|
173
173
|
| `warn-global-package-install` | 意図しないグローバルパッケージインストールを検出 | |
|
|
@@ -179,7 +179,7 @@ failproofai policies --uninstall --scope project
|
|
|
179
179
|
|
|
180
180
|
## カスタムポリシー
|
|
181
181
|
|
|
182
|
-
|
|
182
|
+
エージェントの安定性とタスク集中を維持するための独自ポリシーを作成できます:
|
|
183
183
|
|
|
184
184
|
```js
|
|
185
185
|
import { customPolicies, allow, deny, instruct } from "failproofai";
|
|
@@ -205,49 +205,49 @@ failproofai policies --install --custom ./my-policies.js
|
|
|
205
205
|
|
|
206
206
|
### 判定ヘルパー
|
|
207
207
|
|
|
208
|
-
| 関数 |
|
|
209
|
-
|
|
208
|
+
| 関数 | 動作 |
|
|
209
|
+
|----------|--------|
|
|
210
210
|
| `allow()` | 操作を許可 |
|
|
211
|
-
| `allow(message)` |
|
|
212
|
-
| `deny(message)` |
|
|
213
|
-
| `instruct(message)` | Claude
|
|
211
|
+
| `allow(message)` | 操作を許可し、Claude に情報コンテキストを送信 |
|
|
212
|
+
| `deny(message)` | 操作をブロック;メッセージが Claude に表示される |
|
|
213
|
+
| `instruct(message)` | Claude のプロンプトにコンテキストを追加;ブロックしない |
|
|
214
214
|
|
|
215
|
-
###
|
|
215
|
+
### コンテキストオブジェクト (`ctx`)
|
|
216
216
|
|
|
217
217
|
| フィールド | 型 | 説明 |
|
|
218
|
-
|
|
218
|
+
|-------|------|-------------|
|
|
219
219
|
| `eventType` | `string` | `"PreToolUse"`、`"PostToolUse"`、`"Notification"`、`"Stop"` |
|
|
220
|
-
| `toolName` | `string` | 呼び出されるツール(`"Bash"`、`"Write"`、`"Read"
|
|
220
|
+
| `toolName` | `string` | 呼び出されるツール(`"Bash"`、`"Write"`、`"Read"` など) |
|
|
221
221
|
| `toolInput` | `object` | ツールの入力パラメータ |
|
|
222
222
|
| `payload` | `object` | 生のイベントペイロード全体 |
|
|
223
223
|
| `session.cwd` | `string` | Claude Code セッションの作業ディレクトリ |
|
|
224
224
|
| `session.sessionId` | `string` | セッション識別子 |
|
|
225
|
-
| `session.transcriptPath` | `string` |
|
|
225
|
+
| `session.transcriptPath` | `string` | セッションのトランスクリプトファイルへのパス |
|
|
226
226
|
|
|
227
|
-
|
|
227
|
+
カスタムフックは、推移的なローカルインポート、async/await、`process.env` へのアクセスをサポートします。エラーはフェイルオープン(`~/.failproofai/hook.log` に記録され、組み込みポリシーは継続して動作)です。詳細なガイドは [docs/custom-hooks.mdx](docs/custom-hooks.mdx) を参照してください。
|
|
228
228
|
|
|
229
229
|
### 規約ベースのポリシー
|
|
230
230
|
|
|
231
|
-
`*policies.{js,mjs,ts}` ファイルを `.failproofai/policies/` に配置するだけで自動的に読み込まれます — `--custom` フラグや設定変更は不要です。git
|
|
231
|
+
`*policies.{js,mjs,ts}` ファイルを `.failproofai/policies/` に配置するだけで自動的に読み込まれます — `--custom` フラグや設定変更は不要です。gitフックと同じ仕組み:ファイルを置くだけで動作します。
|
|
232
232
|
|
|
233
233
|
```text
|
|
234
|
-
# プロジェクトレベル — git
|
|
234
|
+
# プロジェクトレベル — gitにコミットし、チームで共有
|
|
235
235
|
.failproofai/policies/security-policies.mjs
|
|
236
236
|
.failproofai/policies/workflow-policies.mjs
|
|
237
237
|
|
|
238
|
-
# ユーザーレベル —
|
|
238
|
+
# ユーザーレベル — 個人用、全プロジェクトに適用
|
|
239
239
|
~/.failproofai/policies/my-policies.mjs
|
|
240
240
|
```
|
|
241
241
|
|
|
242
|
-
|
|
242
|
+
両方のレベルが読み込まれます(ユニオン)。各ディレクトリ内ではファイルがアルファベット順に読み込まれます。順序を制御するには `01-`、`02-` などのプレフィックスを使用してください。すぐに使えるサンプルは [examples/convention-policies/](examples/convention-policies/) を参照してください。
|
|
243
243
|
|
|
244
244
|
---
|
|
245
245
|
|
|
246
246
|
## テレメトリ
|
|
247
247
|
|
|
248
|
-
Failproof AI
|
|
248
|
+
Failproof AI は PostHog を通じて匿名の使用状況テレメトリを収集し、機能の利用状況を把握します。セッションの内容、ファイル名、ツールの入力、個人情報は一切送信されません。
|
|
249
249
|
|
|
250
|
-
|
|
250
|
+
無効化する方法:
|
|
251
251
|
|
|
252
252
|
```bash
|
|
253
253
|
FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
|
|
@@ -258,14 +258,14 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
|
|
|
258
258
|
## ドキュメント
|
|
259
259
|
|
|
260
260
|
| ガイド | 説明 |
|
|
261
|
-
|
|
261
|
+
|-------|-------------|
|
|
262
262
|
| [はじめに](docs/getting-started.mdx) | インストールと最初のステップ |
|
|
263
|
-
| [
|
|
264
|
-
| [カスタムポリシー](docs/custom-policies.mdx) |
|
|
263
|
+
| [組み込みポリシー](docs/built-in-policies.mdx) | パラメータ付き30種類の組み込みポリシー一覧 |
|
|
264
|
+
| [カスタムポリシー](docs/custom-policies.mdx) | 独自ポリシーの作成方法 |
|
|
265
265
|
| [設定](docs/configuration.mdx) | 設定ファイルの形式とスコープのマージ |
|
|
266
266
|
| [ダッシュボード](docs/dashboard.mdx) | セッションの監視とポリシーアクティビティのレビュー |
|
|
267
267
|
| [アーキテクチャ](docs/architecture.mdx) | フックシステムの仕組み |
|
|
268
|
-
| [テスト](docs/testing.mdx) |
|
|
268
|
+
| [テスト](docs/testing.mdx) | テストの実行と新しいテストの作成 |
|
|
269
269
|
|
|
270
270
|
### ドキュメントをローカルで実行
|
|
271
271
|
|
|
@@ -282,17 +282,17 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
|
|
|
282
282
|
|
|
283
283
|
---
|
|
284
284
|
|
|
285
|
-
## failproofai
|
|
285
|
+
## failproofai コントリビューター向けの注意事項
|
|
286
286
|
|
|
287
|
-
このリポジトリの `.claude/settings.json` は、標準の `npx -y failproofai` コマンドの代わりに `bun ./bin/failproofai.mjs --hook <EventType>` を使用しています。これは、failproofai
|
|
287
|
+
このリポジトリの `.claude/settings.json` は、標準の `npx -y failproofai` コマンドの代わりに `bun ./bin/failproofai.mjs --hook <EventType>` を使用しています。これは、failproofai プロジェクト自体で `npx -y failproofai` を実行すると自己参照の競合が発生するためです。
|
|
288
288
|
|
|
289
|
-
|
|
289
|
+
その他すべてのリポジトリでは、推奨される方法は `npx -y failproofai` であり、以下のコマンドでインストールします:
|
|
290
290
|
|
|
291
291
|
```bash
|
|
292
292
|
failproofai policies --install --scope project
|
|
293
293
|
```
|
|
294
294
|
|
|
295
|
-
##
|
|
295
|
+
## コントリビューション
|
|
296
296
|
|
|
297
297
|
[CONTRIBUTING.md](CONTRIBUTING.md) を参照してください。
|
|
298
298
|
|
|
@@ -304,4 +304,4 @@ failproofai policies --install --scope project
|
|
|
304
304
|
|
|
305
305
|
---
|
|
306
306
|
|
|
307
|
-
**ExosphereHost: Reliability Research Lab for Your Agents**
|
|
307
|
+
**ExosphereHost: Reliability Research Lab for Your Agents** によって構築・維持されています。エージェント、ソフトウェア、専門知識を通じて、企業やスタートアップのAIエージェントの信頼性向上を支援しています。詳細は [exosphere.host](https://exosphere.host) をご覧ください。
|