failproofai 0.0.3 → 0.0.4

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 (134) hide show
  1. package/.next/standalone/.next/BUILD_ID +1 -1
  2. package/.next/standalone/.next/build-manifest.json +3 -3
  3. package/.next/standalone/.next/prerender-manifest.json +3 -3
  4. package/.next/standalone/.next/required-server-files.json +1 -1
  5. package/.next/standalone/.next/server/app/_global-error/page/server-reference-manifest.json +1 -1
  6. package/.next/standalone/.next/server/app/_global-error/page.js.nft.json +1 -1
  7. package/.next/standalone/.next/server/app/_global-error/page_client-reference-manifest.js +1 -1
  8. package/.next/standalone/.next/server/app/_global-error.html +1 -1
  9. package/.next/standalone/.next/server/app/_global-error.rsc +7 -7
  10. package/.next/standalone/.next/server/app/_global-error.segments/__PAGE__.segment.rsc +2 -2
  11. package/.next/standalone/.next/server/app/_global-error.segments/_full.segment.rsc +7 -7
  12. package/.next/standalone/.next/server/app/_global-error.segments/_head.segment.rsc +3 -3
  13. package/.next/standalone/.next/server/app/_global-error.segments/_index.segment.rsc +3 -3
  14. package/.next/standalone/.next/server/app/_global-error.segments/_tree.segment.rsc +1 -1
  15. package/.next/standalone/.next/server/app/_not-found/page/server-reference-manifest.json +1 -1
  16. package/.next/standalone/.next/server/app/_not-found/page.js.nft.json +1 -1
  17. package/.next/standalone/.next/server/app/_not-found/page_client-reference-manifest.js +1 -1
  18. package/.next/standalone/.next/server/app/_not-found.html +2 -2
  19. package/.next/standalone/.next/server/app/_not-found.rsc +15 -15
  20. package/.next/standalone/.next/server/app/_not-found.segments/_full.segment.rsc +15 -15
  21. package/.next/standalone/.next/server/app/_not-found.segments/_head.segment.rsc +4 -4
  22. package/.next/standalone/.next/server/app/_not-found.segments/_index.segment.rsc +10 -10
  23. package/.next/standalone/.next/server/app/_not-found.segments/_not-found/__PAGE__.segment.rsc +2 -2
  24. package/.next/standalone/.next/server/app/_not-found.segments/_not-found.segment.rsc +3 -3
  25. package/.next/standalone/.next/server/app/_not-found.segments/_tree.segment.rsc +1 -1
  26. package/.next/standalone/.next/server/app/index.html +1 -1
  27. package/.next/standalone/.next/server/app/index.rsc +15 -15
  28. package/.next/standalone/.next/server/app/index.segments/__PAGE__.segment.rsc +2 -2
  29. package/.next/standalone/.next/server/app/index.segments/_full.segment.rsc +15 -15
  30. package/.next/standalone/.next/server/app/index.segments/_head.segment.rsc +4 -4
  31. package/.next/standalone/.next/server/app/index.segments/_index.segment.rsc +10 -10
  32. package/.next/standalone/.next/server/app/index.segments/_tree.segment.rsc +1 -1
  33. package/.next/standalone/.next/server/app/page/server-reference-manifest.json +1 -1
  34. package/.next/standalone/.next/server/app/page.js.nft.json +1 -1
  35. package/.next/standalone/.next/server/app/page_client-reference-manifest.js +1 -1
  36. package/.next/standalone/.next/server/app/policies/page/server-reference-manifest.json +8 -8
  37. package/.next/standalone/.next/server/app/policies/page.js.nft.json +1 -1
  38. package/.next/standalone/.next/server/app/policies/page_client-reference-manifest.js +1 -1
  39. package/.next/standalone/.next/server/app/project/[name]/page/server-reference-manifest.json +1 -1
  40. package/.next/standalone/.next/server/app/project/[name]/page.js.nft.json +1 -1
  41. package/.next/standalone/.next/server/app/project/[name]/page_client-reference-manifest.js +1 -1
  42. package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page/react-loadable-manifest.json +2 -2
  43. package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page/server-reference-manifest.json +2 -2
  44. package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page.js.nft.json +1 -1
  45. package/.next/standalone/.next/server/app/project/[name]/session/[sessionId]/page_client-reference-manifest.js +1 -1
  46. package/.next/standalone/.next/server/app/projects/page/server-reference-manifest.json +1 -1
  47. package/.next/standalone/.next/server/app/projects/page.js.nft.json +1 -1
  48. package/.next/standalone/.next/server/app/projects/page_client-reference-manifest.js +1 -1
  49. package/.next/standalone/.next/server/chunks/[root-of-the-server]__0g72weg._.js +1 -1
  50. package/.next/standalone/.next/server/chunks/package_json_[json]_cjs_0z7w.hh._.js +1 -1
  51. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__092s1ta._.js +2 -2
  52. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__09icjsf._.js +2 -2
  53. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__0g.lg8b._.js +2 -2
  54. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__0h..k-e._.js +2 -2
  55. package/.next/standalone/.next/server/chunks/ssr/{[root-of-the-server]__0bo8s~-._.js → [root-of-the-server]__0lty_fo._.js} +2 -2
  56. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__0okos0k._.js +2 -2
  57. package/.next/standalone/.next/server/chunks/ssr/{[root-of-the-server]__03kiqd5._.js → [root-of-the-server]__0v1egkj._.js} +2 -2
  58. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__0w6l33k._.js +2 -2
  59. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__11pa2ra._.js +2 -2
  60. package/.next/standalone/.next/server/chunks/ssr/[root-of-the-server]__12t-wym._.js +2 -2
  61. package/.next/standalone/.next/server/chunks/ssr/_10lm7or._.js +2 -2
  62. package/.next/standalone/.next/server/chunks/ssr/app_global-error_tsx_0xerkr6._.js +1 -1
  63. package/.next/standalone/.next/server/chunks/ssr/app_policies_hooks-client_tsx_0q-m0y-._.js +1 -1
  64. package/.next/standalone/.next/server/middleware-build-manifest.js +3 -3
  65. package/.next/standalone/.next/server/pages/404.html +2 -2
  66. package/.next/standalone/.next/server/pages/500.html +1 -1
  67. package/.next/standalone/.next/server/server-reference-manifest.js +1 -1
  68. package/.next/standalone/.next/server/server-reference-manifest.json +9 -9
  69. package/.next/standalone/.next/static/chunks/{03oepxbqx6o8~.js → 0b2_069x5qnxg.js} +2 -2
  70. package/.next/standalone/.next/static/chunks/{02t9.s735hqyq.js → 0de3q2juhg_dr.js} +1 -1
  71. package/.next/standalone/.next/static/chunks/{18cl6wups7ouq.js → 0p5sfob-upg0g.js} +1 -1
  72. package/.next/standalone/.next/static/chunks/{0h5kbvg~.xf.v.js → 0tw_xfxb1tto..js} +1 -1
  73. package/.next/standalone/.next/static/chunks/{0od..umlku4bb.js → 0uxpbrcv44lga.js} +1 -1
  74. package/.next/standalone/.next/static/chunks/0xjz3w.yw5tza.js +1 -0
  75. package/.next/standalone/.next/static/chunks/{0xbwzy4dl87-0.js → 0y-bi_mp2rv4l.js} +1 -1
  76. package/.next/standalone/.next/static/chunks/{0cwft44dh9bww.js → 11zlh73ggln0w.js} +1 -1
  77. package/.next/standalone/CHANGELOG.md +5 -0
  78. package/.next/standalone/dist/cli.mjs +4 -8
  79. package/.next/standalone/docs/ar/built-in-policies.mdx +100 -129
  80. package/.next/standalone/docs/ar/cli/install-policies.mdx +10 -11
  81. package/.next/standalone/docs/ar/cli/remove-policies.mdx +10 -12
  82. package/.next/standalone/docs/built-in-policies.mdx +3 -30
  83. package/.next/standalone/docs/cli/install-policies.mdx +0 -1
  84. package/.next/standalone/docs/cli/remove-policies.mdx +0 -1
  85. package/.next/standalone/docs/de/built-in-policies.mdx +65 -92
  86. package/.next/standalone/docs/de/cli/install-policies.mdx +3 -4
  87. package/.next/standalone/docs/de/cli/remove-policies.mdx +3 -4
  88. package/.next/standalone/docs/docs.json +5 -0
  89. package/.next/standalone/docs/es/built-in-policies.mdx +66 -93
  90. package/.next/standalone/docs/es/cli/install-policies.mdx +4 -5
  91. package/.next/standalone/docs/es/cli/remove-policies.mdx +4 -5
  92. package/.next/standalone/docs/fr/built-in-policies.mdx +83 -110
  93. package/.next/standalone/docs/fr/cli/install-policies.mdx +11 -12
  94. package/.next/standalone/docs/fr/cli/remove-policies.mdx +2 -3
  95. package/.next/standalone/docs/he/built-in-policies.mdx +131 -160
  96. package/.next/standalone/docs/he/cli/install-policies.mdx +14 -15
  97. package/.next/standalone/docs/he/cli/remove-policies.mdx +13 -14
  98. package/.next/standalone/docs/hi/built-in-policies.mdx +168 -197
  99. package/.next/standalone/docs/hi/cli/install-policies.mdx +10 -11
  100. package/.next/standalone/docs/hi/cli/remove-policies.mdx +13 -14
  101. package/.next/standalone/docs/it/built-in-policies.mdx +83 -110
  102. package/.next/standalone/docs/it/cli/install-policies.mdx +12 -13
  103. package/.next/standalone/docs/it/cli/remove-policies.mdx +5 -6
  104. package/.next/standalone/docs/ja/built-in-policies.mdx +119 -146
  105. package/.next/standalone/docs/ja/cli/install-policies.mdx +12 -13
  106. package/.next/standalone/docs/ja/cli/remove-policies.mdx +8 -9
  107. package/.next/standalone/docs/ko/built-in-policies.mdx +80 -107
  108. package/.next/standalone/docs/ko/cli/install-policies.mdx +10 -11
  109. package/.next/standalone/docs/ko/cli/remove-policies.mdx +2 -3
  110. package/.next/standalone/docs/pt-br/built-in-policies.mdx +46 -73
  111. package/.next/standalone/docs/pt-br/cli/install-policies.mdx +5 -6
  112. package/.next/standalone/docs/pt-br/cli/remove-policies.mdx +11 -12
  113. package/.next/standalone/docs/ru/built-in-policies.mdx +107 -132
  114. package/.next/standalone/docs/ru/cli/install-policies.mdx +10 -10
  115. package/.next/standalone/docs/ru/cli/remove-policies.mdx +13 -14
  116. package/.next/standalone/docs/tr/built-in-policies.mdx +106 -131
  117. package/.next/standalone/docs/tr/cli/install-policies.mdx +14 -15
  118. package/.next/standalone/docs/tr/cli/remove-policies.mdx +7 -8
  119. package/.next/standalone/docs/vi/built-in-policies.mdx +73 -100
  120. package/.next/standalone/docs/vi/cli/install-policies.mdx +17 -18
  121. package/.next/standalone/docs/vi/cli/remove-policies.mdx +11 -12
  122. package/.next/standalone/docs/zh/built-in-policies.mdx +77 -104
  123. package/.next/standalone/docs/zh/cli/install-policies.mdx +4 -5
  124. package/.next/standalone/docs/zh/cli/remove-policies.mdx +8 -9
  125. package/.next/standalone/package.json +1 -1
  126. package/.next/standalone/server.js +1 -1
  127. package/.next/standalone/src/hooks/builtin-policies.ts +0 -4
  128. package/dist/cli.mjs +4 -8
  129. package/package.json +1 -1
  130. package/src/hooks/builtin-policies.ts +0 -4
  131. package/.next/standalone/.next/static/chunks/0e2uz2g026ckb.js +0 -1
  132. /package/.next/standalone/.next/static/{En9eEShUkUjgeYbY9v6Gy → LayjxQulxIcNH19Lqgjbf}/_buildManifest.js +0 -0
  133. /package/.next/standalone/.next/static/{En9eEShUkUjgeYbY9v6Gy → LayjxQulxIcNH19Lqgjbf}/_clientMiddlewareManifest.js +0 -0
  134. /package/.next/standalone/.next/static/{En9eEShUkUjgeYbY9v6Gy → LayjxQulxIcNH19Lqgjbf}/_ssgManifest.js +0 -0
@@ -1,33 +1,32 @@
1
1
  ---
2
2
  title: नीतियों को इंस्टॉल करें
3
- description: "नीतियों को सक्षम करें ताकि वे हर एजेंट टूल कॉल पर चलें"
3
+ description: "नीतियों को सक्षम करें ताकि वे हर agent tool call पर चलें"
4
4
  ---
5
5
 
6
6
  ```bash
7
7
  failproofai policies --install [policy-names...] [options]
8
8
  ```
9
9
 
10
- Claude Code के `settings.json` में हुक एंट्रीज लिखता है ताकि failproofai टूल कॉल को रोक सके।
10
+ Claude Code के `settings.json` में hook entries लिखता है ताकि failproofai tool calls को intercept कर सके।
11
11
 
12
12
  उपनाम: `failproofai p -i`
13
13
 
14
14
  ## विकल्प
15
15
 
16
- | फ्लैग | विवरण |
16
+ | Flag | विवरण |
17
17
  |------|-------------|
18
- | `--scope user` | `~/.claude/settings.json` में इंस्टॉल करें (डिफ़ॉल्ट - सभी सेशन) |
18
+ | `--scope user` | `~/.claude/settings.json` में इंस्टॉल करें (डिफ़ॉल्ट - सभी सत्र) |
19
19
  | `--scope project` | वर्तमान निर्देशिका में `.claude/settings.json` में इंस्टॉल करें |
20
20
  | `--scope local` | वर्तमान निर्देशिका में `.claude/settings.local.json` में इंस्टॉल करें |
21
- | `--custom <path>` / `-c` | कस्टम हुक नीतियों वाली JS फ़ाइल का पथ |
22
- | `--beta` | बीटा नीतियां शामिल करें |
21
+ | `--custom <path>` / `-c` | कस्टम hook policies वाली JS फाइल का पाथ |
23
22
 
24
23
  ## व्यवहार
25
24
 
26
- - **कोई नीति नाम नहीं** - नीतियों का चयन करने के लिए एक इंटरैक्टिव प्रॉम्प्ट खोलता है
27
- - **विशिष्ट नाम** - उन नीतियों को सक्षम करता है (पहले से सक्षम किसी भी नीति में जोड़ा जाता है)
25
+ - **कोई नीति नाम नहीं** - नीतियों का चयन करने के लिए एक इंटरैक्टिव prompt खोलता है
26
+ - **विशिष्ट नाम** - उन नीतियों को सक्षम करता है (पहले से सक्षम किए गए किसी भी नीति में जोड़ा जाता है)
28
27
  - **`all`** - हर उपलब्ध नीति को सक्षम करता है
29
28
 
30
- इंस्टॉलेशन योगात्मक है: `--install` को फिर से चलाने से नई नीतियां जुड़ती हैं बिना मौजूदा नीतियों को हटाए।
29
+ इंस्टॉलेशन additive है: `--install` को फिर से चलाने से नई नीतियां जोड़ी जाती हैं बिना मौजूदा नीतियों को हटाए।
31
30
 
32
31
  ## उदाहरण
33
32
 
@@ -41,8 +40,8 @@ failproofai policies --install block-sudo sanitize-api-keys --scope project
41
40
  # एक बार में सभी नीतियों को सक्षम करें
42
41
  failproofai policies --install all
43
42
 
44
- # कस्टम नीतियों फ़ाइल के साथ इंस्टॉल करें
43
+ # कस्टम policies फाइल के साथ इंस्टॉल करें
45
44
  failproofai policies --install --custom ./my-policies.js
46
45
  ```
47
46
 
48
- जब `--custom <path>` प्रदान किया जाता है, तो फ़ाइल को तुरंत सत्यापित किया जाता है - इसे कम से कम एक बार `customPolicies.add()` को कॉल करना चाहिए। हल किया गया पथ `policies-config.json` में `customPoliciesPath` के रूप में सहेजा जाता है।
47
+ जब `--custom <path>` प्रदान किया जाता है, तो फाइल तुरंत सत्यापित की जाती है - इसे कम से कम एक बार `customPolicies.add()` को कॉल करना चाहिए। Resolved पाथ `policies-config.json` में `customPoliciesPath` के रूप में सहेजा जाता है।
@@ -1,13 +1,13 @@
1
1
  ---
2
- title: पॉलिसीज़ को अनइंस्टॉल करें
3
- description: "Claude Code की सेटिंग्स से hook entries को हटाएँ"
2
+ title: नीतियों को अनइंस्टॉल करें
3
+ description: "Claude Code की सेटिंग्स से हुक एंट्रीज़ को हटाएं"
4
4
  ---
5
5
 
6
6
  ```bash
7
7
  failproofai policies --uninstall [policy-names...] [options]
8
8
  ```
9
9
 
10
- Claude Code के `settings.json` से failproofai hook entries को हटाता है।
10
+ Claude Code की `settings.json` से failproofai हुक एंट्रीज़ को हटाता है।
11
11
 
12
12
  उपनाम: `failproofai p -u`
13
13
 
@@ -15,30 +15,29 @@ Claude Code के `settings.json` से failproofai hook entries को हट
15
15
 
16
16
  | फ्लैग | विवरण |
17
17
  |------|-------------|
18
- | `--scope user` | ग्लोबल सेटिंग्स से हटाएँ (डिफ़ॉल्ट) |
19
- | `--scope project` | प्रोजेक्ट सेटिंग्स से हटाएँ |
20
- | `--scope local` | लोकल सेटिंग्स से हटाएँ |
21
- | `--scope all` | एक साथ सभी स्कोप से हटाएँ |
18
+ | `--scope user` | वैश्विक सेटिंग्स से हटाएं (डिफ़ॉल्ट) |
19
+ | `--scope project` | प्रोजेक्ट सेटिंग्स से हटाएं |
20
+ | `--scope local` | स्थानीय सेटिंग्स से हटाएं |
21
+ | `--scope all` | सभी स्कोप्स से एक साथ हटाएं |
22
22
  | `--custom` / `-c` | कॉन्फ़िग से `customPoliciesPath` को साफ़ करें |
23
- | `--beta` | कॉन्फ़िग से केवल बीटा पॉलिसीज़ को हटाएँ |
24
23
 
25
24
  ## व्यवहार
26
25
 
27
- - **कोई पॉलिसी नाम नहीं** - सेटिंग्स फ़ाइल से सभी failproofai hook entries को हटाता है
28
- - **विशिष्ट नाम** - उन पॉलिसीज़ को अक्षम करता है लेकिन hooks को इंस्टॉल रखता है
26
+ - **कोई नीति का नाम नहीं** - सेटिंग्स फाइल से सभी failproofai हुक एंट्रीज़ को हटाता है
27
+ - **विशिष्ट नाम** - उन नीतियों को अक्षम करता है लेकिन हुक्स इंस्टॉल रखता है
29
28
 
30
29
  ## उदाहरण
31
30
 
32
31
  ```bash
33
- # सभी hooks को ग्लोबली हटाएँ
32
+ # सभी हुक्स को वैश्विक रूप से हटाएं
34
33
  failproofai policies --uninstall
35
34
 
36
- # एक विशिष्ट पॉलिसी को अक्षम करें (hooks को इंस्टॉल रखता है)
35
+ # एक विशिष्ट नीति को अक्षम करें (हुक्स इंस्टॉल रखता है)
37
36
  failproofai policies --uninstall block-sudo
38
37
 
39
- # हर स्कोप से hooks हटाएँ
38
+ # हर स्कोप से हुक्स को हटाएं
40
39
  failproofai policies --uninstall --scope all
41
40
 
42
- # कस्टम पॉलिसीज़ पाथ साफ़ करें
41
+ # कस्टम नीतियों का पथ साफ़ करें
43
42
  failproofai policies --uninstall --custom
44
43
  ```
@@ -1,37 +1,37 @@
1
1
  ---
2
- title: Criteri predefiniti
3
- description: "Tutti i 30 criteri predefiniti che catturano i comuni modi di guasto degli agenti"
2
+ title: Politiche integrate
3
+ description: "Tutte le 30 politiche integrate che rilevano le modalità di errore comuni degli agenti"
4
4
  icon: shield
5
5
  ---
6
6
 
7
- failproofai viene fornito con 30 criteri predefiniti che catturano i comuni modi di guasto degli agenti. Ogni criterio si attiva su un tipo di evento hook specifico e un nome di strumento. Nove criteri accettano parametri che ti permettono di regolarne il comportamento senza scrivere codice. Quattro criteri di workflow in versione beta applicano una pipeline commit → push → PR → CI prima che Claude si fermi.
7
+ failproofai è dotato di 30 politiche integrate che rilevano le modalità di errore comuni degli agenti. Ogni politica si attiva su un tipo di evento hook e un nome di strumento specifici. Nove politiche accettano parametri che ti consentono di regolarne il comportamento senza scrivere codice. Quattro politiche di workflow applicano una pipeline commit → push → PR → CI prima che Claude si fermi.
8
8
 
9
9
  ---
10
10
 
11
11
  ## Panoramica
12
12
 
13
- I criteri sono raggruppati in categorie:
13
+ Le politiche sono raggruppate in categorie:
14
14
 
15
- | Categoria | Criteri | Tipo di hook |
16
- |----------|---------|-----------|
15
+ | Categoria | Politiche | Tipo di hook |
16
+ |----------|----------|-----------|
17
17
  | [Comandi pericolosi](#comandi-pericolosi) | block-sudo, block-rm-rf, block-curl-pipe-sh, block-failproofai-commands | PreToolUse |
18
- | [Segreti (sanitizzatori)](#segreti-sanitizzatori) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
18
+ | [Segreti (sanitizer)](#segreti-sanitizer) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
19
19
  | [Ambiente](#ambiente) | block-env-files, protect-env-vars | PreToolUse |
20
20
  | [Accesso ai file](#accesso-ai-file) | block-read-outside-cwd, block-secrets-write | PreToolUse |
21
21
  | [Git](#git) | block-push-master, block-work-on-main, block-force-push, warn-git-amend, warn-git-stash-drop, warn-all-files-staged | PreToolUse |
22
22
  | [Database](#database) | warn-destructive-sql, warn-schema-alteration | PreToolUse |
23
23
  | [Avvisi](#avvisi) | warn-large-file-write, warn-package-publish, warn-background-process, warn-global-package-install | PreToolUse |
24
- | [Workflow (beta)](#workflow-beta) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
24
+ | [Workflow](#workflow) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
25
25
 
26
- - **`block-`** — impedisce all'agente di procedere.
27
- - **`warn-`** — fornisce all'agente contesto aggiuntivo per auto-correggersi.
26
+ - **`block-`** — ferma l'agente dal procedere.
27
+ - **`warn-`** — fornisce all'agente contesto aggiuntivo per autocorreggersi.
28
28
  - **`sanitize-`** — rimuove i dati sensibili dall'output dello strumento prima che l'agente li veda.
29
- - **`require-`** — blocca l'evento Stop fino al soddisfacimento delle condizioni.
29
+ - **`require-`** — blocca l'evento Stop fino a quando le condizioni non sono soddisfatte.
30
30
 
31
31
  ---
32
32
 
33
33
  <Tip>
34
- Ogni criterio supporta un campo `hint` opzionale in `policyParams`. L'hint viene aggiunto al messaggio deny o instruct che Claude vede, fornendo una guida pratica senza modificare il codice del criterio. Funziona con criteri predefiniti, personalizzati e per convenzione. Vedi [Configurazione → hint](/it/configuration#hint-cross-cutting) per i dettagli.
34
+ Ogni politica supporta un campo `hint` opzionale in `policyParams`. L'hint viene aggiunto al messaggio di negazione o istruzione che Claude vede, fornendo indicazioni attuabili senza modificare il codice della politica. Funziona con le politiche integrate, personalizzate e di convenzione. Vedi [Configurazione → hint](/it/configuration#hint-cross-cutting) per i dettagli.
35
35
  </Tip>
36
36
 
37
37
  ---
@@ -43,15 +43,15 @@ Impedisci agli agenti di eseguire operazioni difficili da annullare o che potreb
43
43
  ### `block-sudo`
44
44
 
45
45
  **Evento:** PreToolUse (Bash)
46
- **Impostazione predefinita:** Nega qualsiasi comando `sudo`.
46
+ **Default:** Nega qualsiasi comando `sudo`.
47
47
 
48
- Blocca le invocazioni che includono la parola chiave `sudo`. La corrispondenza del pattern viene eseguita sui token di comando analizzati, non sulla stringa grezza, per prevenire il bypass tramite iniezione di operatori della shell.
48
+ Blocca le invocazioni che includono la parola chiave `sudo`. L'abbinamento del pattern viene eseguito su token di comando analizzati, non sulla stringa grezza, per prevenire il bypass tramite iniezione di operatori shell.
49
49
 
50
50
  **Parametri:**
51
51
 
52
- | Parametro | Tipo | Impostazione predefinita | Descrizione |
52
+ | Param | Tipo | Default | Descrizione |
53
53
  |-------|------|---------|-------------|
54
- | `allowPatterns` | `string[]` | `[]` | Prefissi di comandi esatti che sono consentiti. Ogni voce viene confrontata con i token argv analizzati. |
54
+ | `allowPatterns` | `string[]` | `[]` | Prefissi di comando esatti che sono consentiti. Ogni voce viene confrontata con i token argv analizzati. |
55
55
 
56
56
  **Esempio:**
57
57
 
@@ -68,7 +68,7 @@ Blocca le invocazioni che includono la parola chiave `sudo`. La corrispondenza d
68
68
  Con questa configurazione, `sudo systemctl status nginx` è consentito, ma `sudo rm /etc/hosts` è negato.
69
69
 
70
70
  <Note>
71
- I pattern vengono confrontati con i token analizzati, non con la stringa di comando grezza. Questo previene il bypass tramite operatori della shell aggiunti (ad es. `sudo systemctl status x; rm -rf /` non corrisponde a `sudo systemctl status *`).
71
+ I pattern vengono abbinati ai token analizzati, non alla stringa di comando grezza. Questo previene il bypass tramite operatori shell aggiunti (ad es. `sudo systemctl status x; rm -rf /` non corrisponde a `sudo systemctl status *`).
72
72
  </Note>
73
73
 
74
74
  ---
@@ -76,13 +76,13 @@ I pattern vengono confrontati con i token analizzati, non con la stringa di coma
76
76
  ### `block-rm-rf`
77
77
 
78
78
  **Evento:** PreToolUse (Bash)
79
- **Impostazione predefinita:** Nega `rm -rf`, `rm -fr` e forme simili di eliminazione ricorsiva.
79
+ **Default:** Nega `rm -rf`, `rm -fr` e forme simili di eliminazione ricorsiva.
80
80
 
81
81
  **Parametri:**
82
82
 
83
- | Parametro | Tipo | Impostazione predefinita | Descrizione |
83
+ | Param | Tipo | Default | Descrizione |
84
84
  |-------|------|---------|-------------|
85
- | `allowPaths` | `string[]` | `[]` | Percorsi che è sicuro eliminare ricorsivamente (ad es. `/tmp`). |
85
+ | `allowPaths` | `string[]` | `[]` | Percorsi che sono sicuri da eliminare ricorsivamente (ad es. `/tmp`). |
86
86
 
87
87
  **Esempio:**
88
88
 
@@ -101,7 +101,7 @@ I pattern vengono confrontati con i token analizzati, non con la stringa di coma
101
101
  ### `block-curl-pipe-sh`
102
102
 
103
103
  **Evento:** PreToolUse (Bash)
104
- **Impostazione predefinita:** Nega `curl <url> | bash`, `curl <url> | sh`, `wget <url> | bash` e pattern simili.
104
+ **Default:** Nega `curl <url> | bash`, `curl <url> | sh`, `wget <url> | bash` e pattern simili.
105
105
 
106
106
  Nessun parametro.
107
107
 
@@ -110,20 +110,20 @@ Nessun parametro.
110
110
  ### `block-failproofai-commands`
111
111
 
112
112
  **Evento:** PreToolUse (Bash)
113
- **Impostazione predefinita:** Nega i comandi che disinstallerebbero o disabiliterebbero failproofai stesso (ad es. `npm uninstall failproofai`, `failproofai policies --uninstall`).
113
+ **Default:** Nega comandi che disinstallerebbero o disabiliterebbero failproofai stesso (ad es. `npm uninstall failproofai`, `failproofai policies --uninstall`).
114
114
 
115
115
  Nessun parametro.
116
116
 
117
117
  ---
118
118
 
119
- ## Segreti (sanitizzatori)
119
+ ## Segreti (sanitizer)
120
120
 
121
- Impedisci agli agenti di far trapelare credenziali nel loro contesto o output. I criteri di sanitizzazione si attivano su eventi **PostToolUse**. Quando Claude esegue un comando Bash, legge un file o chiama qualsiasi strumento, questi criteri ispezionano l'output prima di essere restituito a Claude. Se viene rilevato un pattern di segreto, il criterio restituisce una decisione di deny che impedisce che l'output venga passato indietro.
121
+ Impedisci agli agenti di divulgare credenziali nel loro contesto o output. Le politiche sanitizer si attivano su eventi **PostToolUse**. Quando Claude esegue un comando Bash, legge un file o chiama qualsiasi strumento, queste politiche ispezionano l'output prima che venga restituito a Claude. Se viene rilevato un pattern di segreto, la politica restituisce una decisione di negazione che impedisce all'output di essere ripassato.
122
122
 
123
123
  ### `sanitize-jwt`
124
124
 
125
125
  **Evento:** PostToolUse (tutti gli strumenti)
126
- **Impostazione predefinita:** Oscura i token JWT (tre segmenti base64url separati da `.`).
126
+ **Default:** Redige i token JWT (tre segmenti base64url separati da `.`).
127
127
 
128
128
  Nessun parametro.
129
129
 
@@ -132,11 +132,11 @@ Nessun parametro.
132
132
  ### `sanitize-api-keys`
133
133
 
134
134
  **Evento:** PostToolUse (tutti gli strumenti)
135
- **Impostazione predefinita:** Oscura i formati comuni di chiavi API: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PATs (`ghp_`), chiavi di accesso AWS (`AKIA`), chiavi Stripe (`sk_live_`, `sk_test_`) e chiavi API Google (`AIza`).
135
+ **Default:** Redige i formati comuni di chiavi API: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PAT (`ghp_`), chiavi di accesso AWS (`AKIA`), chiavi Stripe (`sk_live_`, `sk_test_`), e chiavi API Google (`AIza`).
136
136
 
137
137
  **Parametri:**
138
138
 
139
- | Parametro | Tipo | Impostazione predefinita | Descrizione |
139
+ | Param | Tipo | Default | Descrizione |
140
140
  |-------|------|---------|-------------|
141
141
  | `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | Pattern regex aggiuntivi da trattare come segreti. |
142
142
 
@@ -160,7 +160,7 @@ Nessun parametro.
160
160
  ### `sanitize-connection-strings`
161
161
 
162
162
  **Evento:** PostToolUse (tutti gli strumenti)
163
- **Impostazione predefinita:** Oscura le stringhe di connessione al database che contengono credenziali incorporate (ad es. `postgresql://user:password@host/db`).
163
+ **Default:** Redige le stringhe di connessione al database che contengono credenziali incorporate (ad es. `postgresql://user:password@host/db`).
164
164
 
165
165
  Nessun parametro.
166
166
 
@@ -169,7 +169,7 @@ Nessun parametro.
169
169
  ### `sanitize-private-key-content`
170
170
 
171
171
  **Evento:** PostToolUse (tutti gli strumenti)
172
- **Impostazione predefinita:** Oscura i blocchi PEM (`-----BEGIN PRIVATE KEY-----`, `-----BEGIN RSA PRIVATE KEY-----`, ecc.).
172
+ **Default:** Redige i blocchi PEM (`-----BEGIN PRIVATE KEY-----`, `-----BEGIN RSA PRIVATE KEY-----`, ecc.).
173
173
 
174
174
  Nessun parametro.
175
175
 
@@ -178,7 +178,7 @@ Nessun parametro.
178
178
  ### `sanitize-bearer-tokens`
179
179
 
180
180
  **Evento:** PostToolUse (tutti gli strumenti)
181
- **Impostazione predefinita:** Oscura le intestazioni `Authorization: Bearer <token>` dove il token è di 20 o più caratteri.
181
+ **Default:** Redige le intestazioni `Authorization: Bearer <token>` dove il token ha 20 o più caratteri.
182
182
 
183
183
  Nessun parametro.
184
184
 
@@ -186,14 +186,14 @@ Nessun parametro.
186
186
 
187
187
  ## Ambiente
188
188
 
189
- Proteggi la configurazione dell'ambiente sensibile dall'essere letta o esposta dagli agenti.
189
+ Proteggi la configurazione sensibile dell'ambiente dalla lettura o dall'esposizione da parte degli agenti.
190
190
 
191
191
  ### `block-env-files`
192
192
 
193
193
  **Evento:** PreToolUse (Bash, Read)
194
- **Impostazione predefinita:** Nega la lettura dei file `.env` tramite `cat .env`, chiamate dello strumento `Read` con `.env` come percorso del file, ecc.
194
+ **Default:** Nega la lettura di file `.env` tramite `cat .env`, chiamate dello strumento `Read` con `.env` come percorso del file, ecc.
195
195
 
196
- Non blocca `.envrc` o altri file adiacenti all'ambiente - solo file denominati esattamente `.env`.
196
+ Non blocca `.envrc` o altri file correlati all'ambiente - solo file denominati esattamente `.env`.
197
197
 
198
198
  Nessun parametro.
199
199
 
@@ -202,7 +202,7 @@ Nessun parametro.
202
202
  ### `protect-env-vars`
203
203
 
204
204
  **Evento:** PreToolUse (Bash)
205
- **Impostazione predefinita:** Nega i comandi che stampano le variabili d'ambiente: `printenv`, `env`, `echo $VAR`.
205
+ **Default:** Nega comandi che stampano variabili di ambiente: `printenv`, `env`, `echo $VAR`.
206
206
 
207
207
  Nessun parametro.
208
208
 
@@ -210,18 +210,18 @@ Nessun parametro.
210
210
 
211
211
  ## Accesso ai file
212
212
 
213
- Mantieni gli agenti che lavorano all'interno dei confini del progetto e lontani dai file sensibili.
213
+ Mantieni gli agenti al lavoro entro i confini del progetto e lontani dai file sensibili.
214
214
 
215
215
  ### `block-read-outside-cwd`
216
216
 
217
217
  **Evento:** PreToolUse (Read, Bash)
218
- **Impostazione predefinita:** Nega la lettura di file al di fuori della directory di lavoro corrente (la radice del progetto).
218
+ **Default:** Nega la lettura di file al di fuori della directory di lavoro corrente (root del progetto).
219
219
 
220
220
  **Parametri:**
221
221
 
222
- | Parametro | Tipo | Impostazione predefinita | Descrizione |
222
+ | Param | Tipo | Default | Descrizione |
223
223
  |-------|------|---------|-------------|
224
- | `allowPaths` | `string[]` | `[]` | Prefissi di percorsi assoluti consentiti anche se al di fuori di cwd. |
224
+ | `allowPaths` | `string[]` | `[]` | Prefissi di percorso assoluto consentiti anche se esterni a cwd. |
225
225
 
226
226
  **Esempio:**
227
227
 
@@ -240,11 +240,11 @@ Mantieni gli agenti che lavorano all'interno dei confini del progetto e lontani
240
240
  ### `block-secrets-write`
241
241
 
242
242
  **Evento:** PreToolUse (Write, Edit)
243
- **Impostazione predefinita:** Nega le scritture su file comunemente utilizzati per chiavi private e certificati: `id_rsa`, `id_ed25519`, `*.key`, `*.pem`, `*.p12`, `*.pfx`.
243
+ **Default:** Nega le scritture su file comunemente utilizzati per chiavi private e certificati: `id_rsa`, `id_ed25519`, `*.key`, `*.pem`, `*.p12`, `*.pfx`.
244
244
 
245
245
  **Parametri:**
246
246
 
247
- | Parametro | Tipo | Impostazione predefinita | Descrizione |
247
+ | Param | Tipo | Default | Descrizione |
248
248
  |-------|------|---------|-------------|
249
249
  | `additionalPatterns` | `string[]` | `[]` | Pattern di nome file aggiuntivi (stile glob) da bloccare. |
250
250
 
@@ -264,18 +264,18 @@ Mantieni gli agenti che lavorano all'interno dei confini del progetto e lontani
264
264
 
265
265
  ## Git
266
266
 
267
- Impedisci i push accidentali, i force-push e gli errori di branch che sono difficili da annullare.
267
+ Previeni push accidentali, force-push e errori di branch difficili da annullare.
268
268
 
269
269
  ### `block-push-master`
270
270
 
271
271
  **Evento:** PreToolUse (Bash)
272
- **Impostazione predefinita:** Nega `git push origin main` e `git push origin master`.
272
+ **Default:** Nega `git push origin main` e `git push origin master`.
273
273
 
274
274
  **Parametri:**
275
275
 
276
- | Parametro | Tipo | Impostazione predefinita | Descrizione |
276
+ | Param | Tipo | Default | Descrizione |
277
277
  |-------|------|---------|-------------|
278
- | `protectedBranches` | `string[]` | `["main", "master"]` | Nomi dei branch che non possono essere pushed direttamente. |
278
+ | `protectedBranches` | `string[]` | `["main", "master"]` | Nomi dei branch che non possono essere pushati direttamente. |
279
279
 
280
280
  **Esempio:**
281
281
 
@@ -290,7 +290,7 @@ Impedisci i push accidentali, i force-push e gli errori di branch che sono diffi
290
290
  ```
291
291
 
292
292
  <Tip>
293
- Per consentire il push su tutti i branch (disabilitando efficacemente questo criterio senza rimuoverlo da `enabledPolicies`), imposta `protectedBranches: []`.
293
+ Per consentire il push su tutti i branch (disabilitando effettivamente questa politica senza rimuoverla da `enabledPolicies`), imposta `protectedBranches: []`.
294
294
  </Tip>
295
295
 
296
296
  ---
@@ -298,22 +298,22 @@ Per consentire il push su tutti i branch (disabilitando efficacemente questo cri
298
298
  ### `block-work-on-main`
299
299
 
300
300
  **Evento:** PreToolUse (Bash)
301
- **Impostazione predefinita:** Nega il checkout diretto dei branch `main` o `master`.
301
+ **Default:** Nega il checkout diretto dei branch `main` o `master`.
302
302
 
303
303
  **Parametri:**
304
304
 
305
- | Parametro | Tipo | Impostazione predefinita | Descrizione |
305
+ | Param | Tipo | Default | Descrizione |
306
306
  |-------|------|---------|-------------|
307
- | `protectedBranches` | `string[]` | `["main", "master"]` | Nomi dei branch che non possono essere checked out direttamente. |
307
+ | `protectedBranches` | `string[]` | `["main", "master"]` | Nomi dei branch che non possono essere sottoposti a checkout direttamente. |
308
308
 
309
309
  ---
310
310
 
311
311
  ### `block-force-push`
312
312
 
313
313
  **Evento:** PreToolUse (Bash)
314
- **Impostazione predefinita:** Nega `git push --force` e `git push -f`.
314
+ **Default:** Nega `git push --force` e `git push -f`.
315
315
 
316
- Nessun parametro specifico del criterio. Usa l'[`hint`](/it/configuration#hint-cross-cutting) trasversale per suggerire alternative:
316
+ Nessun parametro specifico della politica. Usa l'hint cross-cutting [`hint`](/it/configuration#hint-cross-cutting) per suggerire alternative:
317
317
 
318
318
  ```json
319
319
  {
@@ -330,7 +330,7 @@ Nessun parametro specifico del criterio. Usa l'[`hint`](/it/configuration#hint-c
330
330
  ### `warn-git-amend`
331
331
 
332
332
  **Evento:** PreToolUse (Bash)
333
- **Impostazione predefinita:** Istruisce Claude a procedere con cautela quando esegue `git commit --amend`. Non blocca il comando.
333
+ **Default:** Istruisce Claude a procedere con cautela quando esegue `git commit --amend`. Non blocca il comando.
334
334
 
335
335
  Nessun parametro.
336
336
 
@@ -339,7 +339,7 @@ Nessun parametro.
339
339
  ### `warn-git-stash-drop`
340
340
 
341
341
  **Evento:** PreToolUse (Bash)
342
- **Impostazione predefinita:** Istruisce Claude a confermare prima di eseguire `git stash drop`. Non blocca il comando.
342
+ **Default:** Istruisce Claude a confermare prima di eseguire `git stash drop`. Non blocca il comando.
343
343
 
344
344
  Nessun parametro.
345
345
 
@@ -348,7 +348,7 @@ Nessun parametro.
348
348
  ### `warn-all-files-staged`
349
349
 
350
350
  **Evento:** PreToolUse (Bash)
351
- **Impostazione predefinita:** Istruisce Claude a esaminare ciò che sta mettendo in stage quando esegue `git add -A` o `git add .`. Non blocca il comando.
351
+ **Default:** Istruisce Claude a esaminare ciò che sta preparando quando esegue `git add -A` o `git add .`. Non blocca il comando.
352
352
 
353
353
  Nessun parametro.
354
354
 
@@ -356,12 +356,12 @@ Nessun parametro.
356
356
 
357
357
  ## Database
358
358
 
359
- Cattura le operazioni SQL distruttive prima che vengano eseguite sul tuo database.
359
+ Rileva le operazioni SQL distruttive prima che vengono eseguite nel tuo database.
360
360
 
361
361
  ### `warn-destructive-sql`
362
362
 
363
363
  **Evento:** PreToolUse (Bash)
364
- **Impostazione predefinita:** Istruisce Claude a confermare prima di eseguire SQL contenente `DROP TABLE`, `DROP DATABASE` o `DELETE` senza una clausola `WHERE`.
364
+ **Default:** Istruisce Claude a confermare prima di eseguire SQL contenente `DROP TABLE`, `DROP DATABASE` o `DELETE` senza una clausola `WHERE`.
365
365
 
366
366
  Nessun parametro.
367
367
 
@@ -370,7 +370,7 @@ Nessun parametro.
370
370
  ### `warn-schema-alteration`
371
371
 
372
372
  **Evento:** PreToolUse (Bash)
373
- **Impostazione predefinita:** Istruisce Claude a confermare prima di eseguire istruzioni `ALTER TABLE`.
373
+ **Default:** Istruisce Claude a confermare prima di eseguire istruzioni `ALTER TABLE`.
374
374
 
375
375
  Nessun parametro.
376
376
 
@@ -383,11 +383,11 @@ Fornisci agli agenti contesto extra prima di operazioni potenzialmente rischiose
383
383
  ### `warn-large-file-write`
384
384
 
385
385
  **Evento:** PreToolUse (Write)
386
- **Impostazione predefinita:** Istruisce Claude a confermare prima di scrivere file più grandi di 1024 KB.
386
+ **Default:** Istruisce Claude a confermare prima di scrivere file più grandi di 1024 KB.
387
387
 
388
388
  **Parametri:**
389
389
 
390
- | Parametro | Tipo | Impostazione predefinita | Descrizione |
390
+ | Param | Tipo | Default | Descrizione |
391
391
  |-------|------|---------|-------------|
392
392
  | `thresholdKb` | `number` | `1024` | Soglia di dimensione del file in kilobyte al di sopra della quale viene emesso un avviso. |
393
393
 
@@ -404,7 +404,7 @@ Fornisci agli agenti contesto extra prima di operazioni potenzialmente rischiose
404
404
  ```
405
405
 
406
406
  <Note>
407
- Il gestore dell'hook applica un limite stdin di 1 MB sui payload. Per testare questo criterio con contenuto piccolo, imposta `thresholdKb` a un valore ben al di sotto di 1024.
407
+ Il gestore dell'hook applica un limite stdin di 1 MB sui payload. Per testare questa politica con contenuto piccolo, imposta `thresholdKb` su un valore ben inferiore a 1024.
408
408
  </Note>
409
409
 
410
410
  ---
@@ -412,7 +412,7 @@ Il gestore dell'hook applica un limite stdin di 1 MB sui payload. Per testare qu
412
412
  ### `warn-package-publish`
413
413
 
414
414
  **Evento:** PreToolUse (Bash)
415
- **Impostazione predefinita:** Istruisce Claude a confermare prima di eseguire `npm publish`.
415
+ **Default:** Istruisce Claude a confermare prima di eseguire `npm publish`.
416
416
 
417
417
  Nessun parametro.
418
418
 
@@ -421,7 +421,7 @@ Nessun parametro.
421
421
  ### `warn-background-process`
422
422
 
423
423
  **Evento:** PreToolUse (Bash)
424
- **Impostazione predefinita:** Istruisce Claude a stare attento quando avvia processi in background via `nohup`, `&`, `disown` o `screen`.
424
+ **Default:** Istruisce Claude a prestare attenzione quando avvia processi in background tramite `nohup`, `&`, `disown` o `screen`.
425
425
 
426
426
  Nessun parametro.
427
427
 
@@ -430,35 +430,35 @@ Nessun parametro.
430
430
  ### `warn-global-package-install`
431
431
 
432
432
  **Evento:** PreToolUse (Bash)
433
- **Impostazione predefinita:** Istruisce Claude a confermare prima di eseguire `npm install -g`, `yarn global add` o `pip install` senza un ambiente virtuale.
433
+ **Default:** Istruisce Claude a confermare prima di eseguire `npm install -g`, `yarn global add` o `pip install` senza un ambiente virtuale.
434
434
 
435
435
  Nessun parametro.
436
436
 
437
437
  ---
438
438
 
439
- ## Comportamento dell'IA
439
+ ## Comportamento AI
440
440
 
441
- Rileva quando gli agenti si bloccano o si comportano in modo inatteso.
441
+ Rileva quando gli agenti si bloccano o si comportano in modo inaspettato.
442
442
 
443
443
  ### `warn-repeated-tool-calls`
444
444
 
445
445
  **Evento:** PreToolUse (tutti gli strumenti)
446
- **Impostazione predefinita:** Istruisce Claude a riconsiderare quando lo stesso strumento è chiamato 3+ volte con parametri identici - un segno comune che l'agente è bloccato in un loop.
446
+ **Default:** Istruisce Claude a riconsiderare quando lo stesso strumento viene chiamato 3+ volte con parametri identici - un segno comune che l'agente è bloccato in un loop.
447
447
 
448
448
  Nessun parametro.
449
449
 
450
450
  ---
451
451
 
452
- ## Workflow (beta)
452
+ ## Workflow
453
453
 
454
- Applica un disciplinato workflow di fine sessione. Questi criteri si attivano sull'evento **Stop** e negano a Claude di fermarsi fino al soddisfacimento di ciascuna condizione. Seguono una catena di dipendenza naturale: commit → push → PR → CI. Se un criterio nega, i criteri successivi nella catena vengono saltati (deny short-circuit).
454
+ Applica un disciplinato workflow di fine sessione. Queste politiche si attivano sull'evento **Stop** e negano a Claude di fermarsi fino a quando ogni condizione non è soddisfatta. Seguono una naturale catena di dipendenza: commit → push → PR → CI. Se una politica nega, le politiche successive nella catena vengono saltate (la negazione cortocircuita).
455
455
 
456
- Tutti i criteri di workflow sono **fail-open**: se lo strumento richiesto non è disponibile (ad es. `gh` non installato, nessun git remote), il criterio consente con un messaggio informativo che spiega perché il controllo è stato saltato.
456
+ Tutte le politiche di workflow sono **fail-open**: se lo strumento richiesto non è disponibile (ad es. `gh` non installato, nessun git remote), la politica consente con un messaggio informativo che spiega perché il controllo è stato saltato.
457
457
 
458
458
  ### `require-commit-before-stop`
459
459
 
460
460
  **Evento:** Stop
461
- **Impostazione predefinita:** Nega l'arresto quando ci sono modifiche non commitmate (file modificati, staged o non tracciati). Restituisce un messaggio informativo quando la directory di lavoro è pulita.
461
+ **Default:** Nega l'arresto quando ci sono modifiche non salvate (file modificati, preparati o non tracciati). Restituisce un messaggio informativo quando la directory di lavoro è pulita.
462
462
 
463
463
  Nessun parametro.
464
464
 
@@ -467,13 +467,13 @@ Nessun parametro.
467
467
  ### `require-push-before-stop`
468
468
 
469
469
  **Evento:** Stop
470
- **Impostazione predefinita:** Nega l'arresto quando ci sono commit non pushati o quando il branch corrente non ha un branch di tracciamento remoto. Suggerisce `git push -u` per creare un branch di tracciamento se necessario. Fail-open se nessun remote è configurato.
470
+ **Default:** Nega l'arresto quando ci sono commit non pushati o quando il branch corrente non ha alcun branch di tracciamento remoto. Suggerisce `git push -u` per creare un branch di tracciamento se necessario. Fallisce aperto se nessun remote è configurato.
471
471
 
472
472
  **Parametri:**
473
473
 
474
- | Parametro | Tipo | Impostazione predefinita | Descrizione |
474
+ | Param | Tipo | Default | Descrizione |
475
475
  |-------|------|---------|-------------|
476
- | `remote` | `string` | `"origin"` | Nome del remote verso cui fare il push. |
476
+ | `remote` | `string` | `"origin"` | Nome del remote su cui eseguire il push. |
477
477
 
478
478
  **Esempio:**
479
479
 
@@ -492,14 +492,14 @@ Nessun parametro.
492
492
  ### `require-pr-before-stop`
493
493
 
494
494
  **Evento:** Stop
495
- **Impostazione predefinita:** Nega l'arresto quando non esiste una pull request per il branch corrente o quando la PR esistente è chiusa/merged. Istruisce Claude a creare una PR con `gh pr create`.
495
+ **Default:** Nega l'arresto quando non esiste alcuna pull request per il branch corrente, o quando la PR esistente è chiusa/merged. Istruisce Claude a creare una PR con `gh pr create`.
496
496
 
497
497
  Nessun parametro.
498
498
 
499
499
  <Note>
500
- Questo criterio richiede che [GitHub CLI](https://cli.github.com/) (`gh`) sia installato e autenticato.
501
- Esegui `gh auth login` con un token di accesso personale che ha scope `repo` per l'accesso in lettura
502
- alle pull request. Se `gh` non è installato o non autenticato, il criterio fail-open e segnala il motivo a Claude.
500
+ Questa politica richiede l'installazione di [GitHub CLI](https://cli.github.com/) (`gh`) e l'autenticazione.
501
+ Esegui `gh auth login` con un personal access token che ha ambito `repo` per l'accesso in lettura alle
502
+ pull request. Se `gh` non è installato o non è autenticato, la politica fallisce aperta e comunica il motivo a Claude.
503
503
  </Note>
504
504
 
505
505
  ---
@@ -507,50 +507,23 @@ alle pull request. Se `gh` non è installato o non autenticato, il criterio fail
507
507
  ### `require-ci-green-before-stop`
508
508
 
509
509
  **Evento:** Stop
510
- **Impostazione predefinita:** Nega l'arresto quando i controlli CI sono in fallimento o ancora in esecuzione sul branch corrente. Controlla sia i workflow run di GitHub Actions che i controlli di bot di terze parti (ad es. CodeRabbit, SonarCloud, Codecov). Tratta le conclusioni `skipped` come successo. Restituisce un messaggio informativo quando tutti i controlli passano.
510
+ **Default:** Nega l'arresto quando i controlli CI stanno fallendo o sono ancora in esecuzione sul branch corrente. Controlla sia i workflow run GitHub Actions che i controlli bot di terze parti (ad es. CodeRabbit, SonarCloud, Codecov). Tratta le conclusioni `skipped` come successo. Restituisce un messaggio informativo quando tutti i controlli passano.
511
511
 
512
512
  Nessun parametro.
513
513
 
514
514
  <Note>
515
- Questo criterio richiede che [GitHub CLI](https://cli.github.com/) (`gh`) sia installato e autenticato.
516
- Esegui `gh auth login` con un token di accesso personale che ha scope `repo` per l'accesso in lettura
517
- ai workflow run di Actions e all'API Checks. Se `gh` non è installato o non autenticato, il criterio fail-open e segnala il motivo a Claude.
515
+ Questa politica richiede l'installazione di [GitHub CLI](https://cli.github.com/) (`gh`) e l'autenticazione.
516
+ Esegui `gh auth login` con un personal access token che ha ambito `repo` per l'accesso in lettura ai
517
+ workflow run di Actions e all'API Checks. Se `gh` non è installato o non è autenticato, la politica fallisce aperta e comunica il motivo a Claude.
518
518
  </Note>
519
519
 
520
520
  ---
521
521
 
522
- ## Criteri beta
523
-
524
- Alcuni criteri sono marcati `beta` e non vengono installati per impostazione predefinita. I criteri beta possono avere problemi o generare falsi positivi. Vengono graduati a stabile nelle versioni future.
525
-
526
- **Criteri beta attuali:**
527
-
528
- - `require-commit-before-stop` — committa tutti i cambiamenti prima di fermarsi
529
- - `require-push-before-stop` — pusha tutti i commit in remoto
530
- - `require-pr-before-stop` — assicura che esista una PR per il branch
531
- - `require-ci-green-before-stop` — tutti i controlli CI devono passare
532
-
533
- Insieme, questi applicano un workflow **commit → push → PR → CI**.
534
-
535
- Per installare tutti i criteri beta:
536
-
537
- ```bash
538
- failproofai policies --install --beta
539
- ```
540
-
541
- Oppure installa criteri di workflow specifici:
542
-
543
- ```bash
544
- failproofai policies --install require-commit-before-stop require-push-before-stop require-pr-before-stop require-ci-green-before-stop
545
- ```
546
-
547
- Esegui `failproofai policies` per vedere quali criteri portano il flag beta.
548
-
549
522
  ---
550
523
 
551
- ## Disabilitazione di criteri individuali
524
+ ## Disabilitazione di politiche individuali
552
525
 
553
- Rimuovi uno specifico criterio da `enabledPolicies` nella tua configurazione, o disattivalo nella scheda Policies del dashboard.
526
+ Rimuovi una politica specifica da `enabledPolicies` nella tua configurazione, o disattivala nella scheda Politiche del dashboard.
554
527
 
555
528
  ```json
556
529
  {
@@ -561,4 +534,4 @@ Rimuovi uno specifico criterio da `enabledPolicies` nella tua configurazione, o
561
534
  }
562
535
  ```
563
536
 
564
- I criteri non elencati in `enabledPolicies` non vengono eseguiti, anche se esistono voci `policyParams` per loro.
537
+ Le politiche non elencate in `enabledPolicies` non vengono eseguite, anche se esistono voci `policyParams` per esse.