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.
Files changed (179) hide show
  1. package/.next/standalone/.failproofai/policies/review-policies.mjs +112 -0
  2. package/.next/standalone/.failproofai/policies/workflow-policies.mjs +2 -1
  3. package/.next/standalone/.next/BUILD_ID +1 -1
  4. package/.next/standalone/.next/build-manifest.json +5 -5
  5. package/.next/standalone/.next/prerender-manifest.json +3 -3
  6. package/.next/standalone/.next/required-server-files.json +1 -1
  7. package/.next/standalone/.next/server/app/_global-error/page/build-manifest.json +2 -2
  8. package/.next/standalone/.next/server/app/_global-error/page/server-reference-manifest.json +1 -1
  9. package/.next/standalone/.next/server/app/_global-error/page.js.nft.json +1 -1
  10. package/.next/standalone/.next/server/app/_global-error/page_client-reference-manifest.js +1 -1
  11. package/.next/standalone/.next/server/app/_global-error.html +1 -1
  12. package/.next/standalone/.next/server/app/_global-error.rsc +7 -7
  13. package/.next/standalone/.next/server/app/_global-error.segments/__PAGE__.segment.rsc +2 -2
  14. package/.next/standalone/.next/server/app/_global-error.segments/_full.segment.rsc +7 -7
  15. package/.next/standalone/.next/server/app/_global-error.segments/_head.segment.rsc +3 -3
  16. package/.next/standalone/.next/server/app/_global-error.segments/_index.segment.rsc +3 -3
  17. package/.next/standalone/.next/server/app/_global-error.segments/_tree.segment.rsc +1 -1
  18. package/.next/standalone/.next/server/app/_not-found/page/build-manifest.json +2 -2
  19. package/.next/standalone/.next/server/app/_not-found/page/server-reference-manifest.json +1 -1
  20. package/.next/standalone/.next/server/app/_not-found/page.js.nft.json +1 -1
  21. package/.next/standalone/.next/server/app/_not-found/page_client-reference-manifest.js +1 -1
  22. package/.next/standalone/.next/server/app/_not-found.html +2 -2
  23. package/.next/standalone/.next/server/app/_not-found.rsc +15 -15
  24. package/.next/standalone/.next/server/app/_not-found.segments/_full.segment.rsc +15 -15
  25. package/.next/standalone/.next/server/app/_not-found.segments/_head.segment.rsc +4 -4
  26. package/.next/standalone/.next/server/app/_not-found.segments/_index.segment.rsc +10 -10
  27. package/.next/standalone/.next/server/app/_not-found.segments/_not-found/__PAGE__.segment.rsc +2 -2
  28. package/.next/standalone/.next/server/app/_not-found.segments/_not-found.segment.rsc +3 -3
  29. package/.next/standalone/.next/server/app/_not-found.segments/_tree.segment.rsc +1 -1
  30. package/.next/standalone/.next/server/app/index.html +1 -1
  31. package/.next/standalone/.next/server/app/index.rsc +15 -15
  32. package/.next/standalone/.next/server/app/index.segments/__PAGE__.segment.rsc +2 -2
  33. package/.next/standalone/.next/server/app/index.segments/_full.segment.rsc +15 -15
  34. package/.next/standalone/.next/server/app/index.segments/_head.segment.rsc +4 -4
  35. package/.next/standalone/.next/server/app/index.segments/_index.segment.rsc +10 -10
  36. package/.next/standalone/.next/server/app/index.segments/_tree.segment.rsc +1 -1
  37. package/.next/standalone/.next/server/app/page/build-manifest.json +2 -2
  38. package/.next/standalone/.next/server/app/page/server-reference-manifest.json +1 -1
  39. package/.next/standalone/.next/server/app/page.js.nft.json +1 -1
  40. package/.next/standalone/.next/server/app/page_client-reference-manifest.js +1 -1
  41. package/.next/standalone/.next/server/app/policies/page/build-manifest.json +2 -2
  42. package/.next/standalone/.next/server/app/policies/page/server-reference-manifest.json +8 -8
  43. package/.next/standalone/.next/server/app/policies/page.js.nft.json +1 -1
  44. package/.next/standalone/.next/server/app/policies/page_client-reference-manifest.js +1 -1
  45. package/.next/standalone/.next/server/app/project/[name]/page/build-manifest.json +2 -2
  46. package/.next/standalone/.next/server/app/project/[name]/page/server-reference-manifest.json +1 -1
  47. package/.next/standalone/.next/server/app/project/[name]/page.js.nft.json +1 -1
  48. package/.next/standalone/.next/server/app/project/[name]/page_client-reference-manifest.js +1 -1
  49. package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page/build-manifest.json +2 -2
  50. package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page/react-loadable-manifest.json +2 -2
  51. package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page/server-reference-manifest.json +2 -2
  52. package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page.js.nft.json +1 -1
  53. package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page_client-reference-manifest.js +1 -1
  54. package/.next/standalone/.next/server/app/projects/page/build-manifest.json +2 -2
  55. package/.next/standalone/.next/server/app/projects/page/server-reference-manifest.json +1 -1
  56. package/.next/standalone/.next/server/app/projects/page.js.nft.json +1 -1
  57. package/.next/standalone/.next/server/app/projects/page_client-reference-manifest.js +1 -1
  58. package/.next/standalone/.next/server/chunks/[root-of-the-server]__0g72weg._.js +1 -1
  59. package/.next/standalone/.next/server/chunks/package_json_[json]_cjs_0z7w.hh._.js +1 -1
  60. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__092s1ta._.js +2 -2
  61. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__09icjsf._.js +2 -2
  62. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__0g.lg8b._.js +2 -2
  63. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__0h..k-e._.js +2 -2
  64. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__0okos0k._.js +2 -2
  65. package/.next/standalone/.next/server/chunks/ssr/{[root-of-the-server]__0a~g15g._.js → [root-of-the-server]__0rh.18_._.js} +2 -2
  66. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__0w6l33k._.js +6 -6
  67. package/.next/standalone/.next/server/chunks/ssr/{[root-of-the-server]__0qn95h3._.js → [root-of-the-server]__0~kmh8w._.js} +2 -2
  68. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__11pa2ra._.js +2 -2
  69. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__12t-wym._.js +2 -2
  70. package/.next/standalone/.next/server/chunks/ssr/_10lm7or._.js +2 -2
  71. package/.next/standalone/.next/server/chunks/ssr/app_global-error_tsx_0xerkr6._.js +1 -1
  72. package/.next/standalone/.next/server/chunks/ssr/app_policies_hooks-client_tsx_0q-m0y-._.js +1 -1
  73. package/.next/standalone/.next/server/middleware-build-manifest.js +5 -5
  74. package/.next/standalone/.next/server/pages/404.html +2 -2
  75. package/.next/standalone/.next/server/pages/500.html +1 -1
  76. package/.next/standalone/.next/server/server-reference-manifest.js +1 -1
  77. package/.next/standalone/.next/server/server-reference-manifest.json +9 -9
  78. package/.next/standalone/.next/static/chunks/{0sme4lkv.tgn-.js → 01b~z8f1ws0rk.js} +1 -1
  79. package/.next/standalone/.next/static/chunks/{0lgbwkfqmnsmc.js → 03rz6ykw-a2xi.js} +1 -1
  80. package/.next/standalone/.next/static/chunks/{17manv47o-~wp.js → 08t08igdql9yt.js} +1 -1
  81. package/.next/standalone/.next/static/chunks/09_k80d~cq2wg.js +4 -0
  82. package/.next/standalone/.next/static/chunks/{0ksdlt_1hucdm.js → 0bvhsa6zva2o..js} +1 -1
  83. package/.next/standalone/.next/static/chunks/{09ikntpt2-o9b.js → 0gbf4cphy8ksq.js} +1 -1
  84. package/.next/standalone/.next/static/chunks/{0yumumfzx_f27.js → 0v.yd0kg_ld3r.js} +1 -1
  85. package/.next/standalone/.next/static/chunks/{13juklu.vksks.js → 0wlyoif4_kj_t.js} +1 -1
  86. package/.next/standalone/.next/static/chunks/{09e7drilkf1sn.js → 12simlrcfk3g2.js} +1 -1
  87. package/.next/standalone/.next/static/chunks/{0em7tspi4kylh.js → 12~yi9oj8av8p.js} +2 -2
  88. package/.next/standalone/.next/static/chunks/{turbopack-0r26pc8h0y_-e.js → turbopack-0o7k.hakttp4k.js} +1 -1
  89. package/.next/standalone/CHANGELOG.md +13 -0
  90. package/.next/standalone/README.md +2 -2
  91. package/.next/standalone/bun.lock +43 -85
  92. package/.next/standalone/dist/cli.mjs +107 -3
  93. package/.next/standalone/docs/ar/architecture.mdx +65 -64
  94. package/.next/standalone/docs/ar/configuration.mdx +42 -42
  95. package/.next/standalone/docs/ar/custom-policies.mdx +62 -64
  96. package/.next/standalone/docs/built-in-policies.mdx +37 -0
  97. package/.next/standalone/docs/custom-policies.mdx +1 -1
  98. package/.next/standalone/docs/de/architecture.mdx +92 -92
  99. package/.next/standalone/docs/de/configuration.mdx +34 -34
  100. package/.next/standalone/docs/de/custom-policies.mdx +49 -50
  101. package/.next/standalone/docs/es/architecture.mdx +72 -72
  102. package/.next/standalone/docs/es/configuration.mdx +25 -25
  103. package/.next/standalone/docs/es/custom-policies.mdx +48 -49
  104. package/.next/standalone/docs/examples.mdx +54 -0
  105. package/.next/standalone/docs/fr/architecture.mdx +53 -53
  106. package/.next/standalone/docs/fr/configuration.mdx +25 -25
  107. package/.next/standalone/docs/fr/custom-policies.mdx +42 -43
  108. package/.next/standalone/docs/getting-started.mdx +52 -0
  109. package/.next/standalone/docs/he/architecture.mdx +66 -66
  110. package/.next/standalone/docs/he/configuration.mdx +53 -52
  111. package/.next/standalone/docs/he/custom-policies.mdx +72 -73
  112. package/.next/standalone/docs/hi/architecture.mdx +106 -106
  113. package/.next/standalone/docs/hi/configuration.mdx +39 -39
  114. package/.next/standalone/docs/hi/custom-policies.mdx +75 -76
  115. package/.next/standalone/docs/i18n/README.ar.md +66 -66
  116. package/.next/standalone/docs/i18n/README.de.md +38 -38
  117. package/.next/standalone/docs/i18n/README.es.md +38 -38
  118. package/.next/standalone/docs/i18n/README.fr.md +42 -42
  119. package/.next/standalone/docs/i18n/README.he.md +67 -67
  120. package/.next/standalone/docs/i18n/README.hi.md +70 -70
  121. package/.next/standalone/docs/i18n/README.it.md +62 -62
  122. package/.next/standalone/docs/i18n/README.ja.md +54 -54
  123. package/.next/standalone/docs/i18n/README.ko.md +58 -58
  124. package/.next/standalone/docs/i18n/README.pt-br.md +43 -43
  125. package/.next/standalone/docs/i18n/README.ru.md +69 -69
  126. package/.next/standalone/docs/i18n/README.tr.md +76 -76
  127. package/.next/standalone/docs/i18n/README.vi.md +70 -70
  128. package/.next/standalone/docs/i18n/README.zh.md +52 -52
  129. package/.next/standalone/docs/it/architecture.mdx +54 -53
  130. package/.next/standalone/docs/it/configuration.mdx +44 -45
  131. package/.next/standalone/docs/it/custom-policies.mdx +76 -78
  132. package/.next/standalone/docs/ja/architecture.mdx +93 -93
  133. package/.next/standalone/docs/ja/configuration.mdx +47 -47
  134. package/.next/standalone/docs/ja/custom-policies.mdx +62 -63
  135. package/.next/standalone/docs/ko/architecture.mdx +66 -66
  136. package/.next/standalone/docs/ko/configuration.mdx +35 -35
  137. package/.next/standalone/docs/ko/custom-policies.mdx +71 -72
  138. package/.next/standalone/docs/pt-br/architecture.mdx +55 -55
  139. package/.next/standalone/docs/pt-br/configuration.mdx +35 -35
  140. package/.next/standalone/docs/pt-br/custom-policies.mdx +60 -61
  141. package/.next/standalone/docs/ru/architecture.mdx +59 -60
  142. package/.next/standalone/docs/ru/configuration.mdx +52 -53
  143. package/.next/standalone/docs/ru/custom-policies.mdx +68 -69
  144. package/.next/standalone/docs/tr/architecture.mdx +124 -124
  145. package/.next/standalone/docs/tr/configuration.mdx +45 -46
  146. package/.next/standalone/docs/tr/custom-policies.mdx +75 -75
  147. package/.next/standalone/docs/vi/architecture.mdx +65 -64
  148. package/.next/standalone/docs/vi/configuration.mdx +41 -41
  149. package/.next/standalone/docs/vi/custom-policies.mdx +68 -69
  150. package/.next/standalone/docs/zh/architecture.mdx +67 -67
  151. package/.next/standalone/docs/zh/configuration.mdx +34 -34
  152. package/.next/standalone/docs/zh/custom-policies.mdx +53 -54
  153. package/.next/standalone/node_modules/@next/env/package.json +1 -1
  154. package/.next/standalone/node_modules/next/dist/build/swc/index.js +1 -1
  155. package/.next/standalone/node_modules/next/dist/compiled/next-server/pages-turbo.runtime.prod.js +7 -7
  156. package/.next/standalone/node_modules/next/dist/lib/patch-incorrect-lockfile.js +3 -3
  157. package/.next/standalone/node_modules/next/dist/server/config-schema.js +10 -2
  158. package/.next/standalone/node_modules/next/dist/server/config.js +1 -1
  159. package/.next/standalone/node_modules/next/dist/server/dev/hot-reloader-turbopack.js +2 -2
  160. package/.next/standalone/node_modules/next/dist/server/dev/hot-reloader-webpack.js +1 -1
  161. package/.next/standalone/node_modules/next/dist/server/lib/app-info-log.js +1 -1
  162. package/.next/standalone/node_modules/next/dist/server/lib/start-server.js +1 -1
  163. package/.next/standalone/node_modules/next/dist/server/render.js +27 -20
  164. package/.next/standalone/node_modules/next/dist/shared/lib/errors/canary-only-config-error.js +1 -1
  165. package/.next/standalone/node_modules/next/dist/telemetry/anonymous-meta.js +1 -1
  166. package/.next/standalone/node_modules/next/dist/telemetry/events/swc-load-failure.js +1 -1
  167. package/.next/standalone/node_modules/next/dist/telemetry/events/version.js +2 -2
  168. package/.next/standalone/node_modules/next/package.json +15 -15
  169. package/.next/standalone/package.json +2 -2
  170. package/.next/standalone/server.js +1 -1
  171. package/.next/standalone/src/hooks/builtin-policies.ts +131 -0
  172. package/README.md +2 -2
  173. package/dist/cli.mjs +107 -3
  174. package/package.json +2 -2
  175. package/src/hooks/builtin-policies.ts +131 -0
  176. package/.next/standalone/.next/static/chunks/0_yayar~bpphd.js +0 -4
  177. /package/.next/standalone/.next/static/{hYQM6iCWnF1W5XDpsIRhV → CkmOT-ZvDN-sVULinGVKT}/_buildManifest.js +0 -0
  178. /package/.next/standalone/.next/static/{hYQM6iCWnF1W5XDpsIRhV → CkmOT-ZvDN-sVULinGVKT}/_clientMiddlewareManifest.js +0 -0
  179. /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 i criteri che mantengono i tuoi agenti AI affidabili, focalizzati e autonomi - per **Claude Code** e **Agents SDK**.
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 Criteri Integrati** - Rileva modalità di errore comuni degli agenti direttamente. Blocca comandi distruttivi, previeni fughe di segreti, mantieni gli agenti all'interno dei confini del progetto, rileva cicli infiniti e altro ancora.
29
- - **Criteri Personalizzati** - Scrivi le tue regole di affidabilità in JavaScript. Usa l'API `allow`/`deny`/`instruct` per applicare convenzioni, prevenire derive, limitare operazioni o integrarsi con sistemi esterni.
30
- - **Configurazione Facile** - Personalizza qualsiasi criterio senza scrivere codice. Imposta allowlist, rami protetti, soglie per progetto o globalmente. Tre ambiti di configurazione si uniscono automaticamente.
31
- - **Monitoraggio Agenti** - Vedi cosa hanno fatto i tuoi agenti mentre eri assente. Sfoglia le sessioni, ispeziona ogni chiamata di tool e rivedi esattamente dove i criteri si sono attivati.
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
- ## Installazione
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
- ## Guida veloce
54
+ ## Avvio rapido
55
55
 
56
- ### 1. Abilita i criteri globalmente
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 invocherà failproofai prima e dopo ogni chiamata di tool.
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 i criteri.
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 dei criteri
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 criteri specifici
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 i criteri
96
+ ### Rimuovi policy
97
97
 
98
98
  ```bash
99
99
  failproofai policies --uninstall
100
- # oppure per un ambito specifico:
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 dei criteri si trova in `~/.failproofai/policies-config.json` (globale) o `.failproofai/policies-config.json` nel tuo progetto (per progetto).
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": "Usa apt-get direttamente senza sudo."
123
+ "hint": "Use apt-get directly without sudo."
124
124
  },
125
125
  "block-push-master": {
126
126
  "protectedBranches": ["main", "release", "prod"],
127
- "hint": "Prova a creare un nuovo ramo invece."
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** si uniscono automaticamente (progetto → locale → globale). Vedi [docs/configuration.mdx](docs/configuration.mdx) per le regole di unione complete.
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
- ## Criteri integrati
146
-
147
- | Criterio | Descrizione | Configurabile |
148
- |----------|-------------|:---:|
149
- | `block-sudo` | Previeni gli agenti dall'eseguire comandi di sistema privilegiati | `allowPatterns` |
150
- | `block-rm-rf` | Previeni l'eliminazione ricorsiva accidentale di file | `allowPaths` |
151
- | `block-curl-pipe-sh` | Previeni gli agenti dal piping di script non attendibili nella shell | |
152
- | `block-failproofai-commands` | Previeni l'auto-disinstallazione | |
153
- | `sanitize-jwt` | Impedisci ai token JWT di trapelare nel contesto dell'agente | |
154
- | `sanitize-api-keys` | Impedisci alle chiavi API di trapelare nel contesto dell'agente | `additionalPatterns` |
155
- | `sanitize-connection-strings` | Impedisci alle credenziali del database di trapelare nel contesto dell'agente | |
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` | Impedisci agli agenti di leggere i file .env | |
159
- | `protect-env-vars` | Previeni gli agenti dal stampare variabili di ambiente | |
160
- | `block-read-outside-cwd` | Mantieni gli agenti all'interno dei confini del progetto | `allowPaths` |
161
- | `block-secrets-write` | Previeni le scritture su file di chiave privata e certificato | `additionalPatterns` |
162
- | `block-push-master` | Previeni i push accidentali su main/master | `protectedBranches` |
163
- | `block-work-on-main` | Mantieni gli agenti fuori dai rami protetti | `protectedBranches` |
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 le scritture di file inaspettatamente grandi | `thresholdKb` |
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 i lanci di processi in background indesiderati | |
173
- | `warn-global-package-install` | Rileva le installazioni di pacchetti globali indesiderate | |
174
- | …e altri | | |
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 dei criteri e riferimento dei parametri: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
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
- ## Criteri personalizzati
180
+ ## Policy personalizzate
181
181
 
182
- Scrivi i tuoi criteri per mantenere gli agenti affidabili e focalizzati:
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
- ### Helper di decisione
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` | Tool in via di invocazione (`"Bash"`, `"Write"`, `"Read"`, …) |
221
- | `toolInput` | `object` | Parametri di input del tool |
222
- | `payload` | `object` | Payload di evento grezzo completo |
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
- Gli hook personalizzati supportano importazioni locali transitive, async/await e accesso a `process.env`. Gli errori sono fail-open (registrati in `~/.failproofai/hook.log`, i criteri integrati continuano). Vedi [docs/custom-hooks.mdx](docs/custom-hooks.mdx) per la guida completa.
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
- ### Criteri basati su convenzione
229
+ ### Policy basate su convenzione
230
230
 
231
- Inserisci 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: inserisci un file, funziona e basta.
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 — committato su git, condiviso con il team
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. Prefissa con `01-`, `02-`, ecc. per controllare l'ordine. Vedi [examples/convention-policies/](examples/convention-policies/) per esempi pronti all'uso.
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 funzionalità. Il contenuto della sessione, i nomi dei file, gli input dei tool o le informazioni personali non vengono mai inviati.
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) | Tutti i 30 criteri integrati con parametri |
264
- | [Custom Policies](docs/custom-policies.mdx) | Scrivi i tuoi criteri |
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 rivedi l'attività dei criteri |
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 test |
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 controlla le modifiche se monti la directory dei documenti:
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 repo utilizza `bun ./bin/failproofai.mjs --hook <EventType>` invece del comando standard `npx -y failproofai`. Questo perché l'esecuzione di `npx -y failproofai` all'interno del progetto failproofai stesso crea un conflitto autoreferenziale.
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 repo, l'approccio consigliato è `npx -y failproofai`, installato tramite:
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
- Creato e Mantenuto da **ExosphereHost: Reliability Research Lab for Your Agents**. Aiutiamo le imprese e le startup a migliorare l'affidabilità dei loro agenti AI attraverso i nostri agenti, software ed esperienza. Scopri di più su [exosphere.host](https://exosphere.host).
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エージェントの信頼性を維持し、タスクに集中させ、自律的に動作させるためのポリシー管理ツール — **Claude Code** **Agents SDK** に対応。
26
+ AIエージェントを安定稼働させ、タスクに集中させ、自律的に動作させ続けるためのポリシー管理ツール — **Claude Code** および **Agents SDK** 対応。
27
27
 
28
- - **30種のビルトインポリシー** - よくあるエージェントの障害パターンをすぐに検出。破壊的なコマンドのブロック、シークレット漏洩の防止、プロジェクト境界内へのエージェント制限、ループ検出など。
29
- - **カスタムポリシー** - JavaScriptで独自の信頼性ルールを記述。`allow`/`deny`/`instruct` APIを使って、規約の適用・ドリフトの防止・操作のゲート処理・外部システムとの連携が可能。
30
- - **簡単な設定** - コードを書かずにポリシーをチューニング。許可リスト、保護ブランチ、しきい値をプロジェクト単位またはグローバルに設定。3つのスコープの設定が自動でマージされる。
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` にフックエントリを書き込みます。これにより Claude Code は各ツール呼び出しの前後に failproofai を呼び出すようになります。
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
- ポリシーの設定は `~/.failproofai/policies-config.json`(グローバル)またはプロジェクト内の `.failproofai/policies-config.json`(プロジェクト単位)に保存されます。
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` | 誤った再帰的ファイル削除を防止 | `allowPaths` |
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キーがエージェントコンテキストへ漏洩するのを防止 | `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` | エージェントによる環境変数の出力を防止 | |
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ブランチへの誤ったプッシュを防止 | `protectedBranches` |
163
- | `block-work-on-main` | 保護ブランチでの作業からエージェントを遠ざける | `protectedBranches` |
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` | 予期しない大きなファイル書き込みを検出 | `thresholdKb` |
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)` | 許可し、情報コンテキストを Claude に送信 |
212
- | `deny(message)` | 操作をブロック。メッセージが Claude に表示される |
213
- | `instruct(message)` | Claude のプロンプトにコンテキストを追加。ブロックはしない |
211
+ | `allow(message)` | 操作を許可し、Claude に情報コンテキストを送信 |
212
+ | `deny(message)` | 操作をブロック;メッセージが Claude に表示される |
213
+ | `instruct(message)` | Claude のプロンプトにコンテキストを追加;ブロックしない |
214
214
 
215
- ### コンテキストオブジェクト(`ctx`)
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
- カスタムフックは推移的なローカルインポート、async/await、`process.env` へのアクセスをサポートしています。エラーはフェイルオープン(`~/.failproofai/hook.log` に記録され、ビルトインポリシーは継続)となります。詳細なガイドは [docs/custom-hooks.mdx](docs/custom-hooks.mdx) を参照してください。
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
- 両方のレベルが読み込まれます(和集合)。ファイルは各ディレクトリ内でアルファベット順に読み込まれます。読み込み順を制御するには `01-`、`02-` などのプレフィックスを使用してください。すぐに使えるサンプルは [examples/convention-policies/](examples/convention-policies/) を参照してください。
242
+ 両方のレベルが読み込まれます(ユニオン)。各ディレクトリ内ではファイルがアルファベット順に読み込まれます。順序を制御するには `01-`、`02-` などのプレフィックスを使用してください。すぐに使えるサンプルは [examples/convention-policies/](examples/convention-policies/) を参照してください。
243
243
 
244
244
  ---
245
245
 
246
246
  ## テレメトリ
247
247
 
248
- Failproof AI は機能の利用状況を把握するため、PostHog を通じて匿名の使用状況テレメトリを収集します。セッションの内容、ファイル名、ツールの入力、個人情報は一切送信されません。
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
- | [ビルトインポリシー](docs/built-in-policies.mdx) | パラメータ付き30種のビルトインポリシー |
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 プロジェクト内で `npx -y failproofai` を実行すると自己参照の競合が発生するためです。
287
+ このリポジトリの `.claude/settings.json` は、標準の `npx -y failproofai` コマンドの代わりに `bun ./bin/failproofai.mjs --hook <EventType>` を使用しています。これは、failproofai プロジェクト自体で `npx -y failproofai` を実行すると自己参照の競合が発生するためです。
288
288
 
289
- その他すべてのリポジトリでは、推奨されるアプローチは `npx -y failproofai` であり、以下でインストールされます:
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** によって構築・メンテナンスされています。私たちは自社のエージェント、ソフトウェア、専門知識を通じて、企業やスタートアップのAIエージェントの信頼性向上を支援しています。詳細は [exosphere.host](https://exosphere.host) をご覧ください。
307
+ **ExosphereHost: Reliability Research Lab for Your Agents** によって構築・維持されています。エージェント、ソフトウェア、専門知識を通じて、企業やスタートアップのAIエージェントの信頼性向上を支援しています。詳細は [exosphere.host](https://exosphere.host) をご覧ください。