failproofai 0.0.2 → 0.0.3

package/.next/standalone/docs/i18n/README.hi.md

@@ -0,0 +1,307 @@
+> **⚠️** This is an auto-generated translation. For the latest version, see the [English README](../../README.md). Community corrections welcome!
+
+[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt-br.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇷🇺 Русский](README.ru.md) | **🇮🇳 हिन्दी** | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇹 Italiano](README.it.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇱 עברית](README.he.md)
+
+---
+
+```
+    ______      _ __                       ____   ___    ____
+   / ____/___ _(_) /___  _________  ____  / __/  /   |  /  _/
+  / /_  / __ `/ / / __ \/ ___/ __ \/ __ \/ /_   / /| |  / /
+ / __/ / /_/ / / / /_/ / /  / /_/ / /_/ / __/  / ___ |_/ /
+/_/    \__,_/_/_/ .___/_/   \____/\____/_/    /_/  |_/___/
+               /_/
+```
+
+# Failproof AI
+
+[![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://befailproof.ai)
+[![npm](https://img.shields.io/npm/v/failproofai?style=flat-square&color=CB3837)](https://www.npmjs.com/package/failproofai)
+[![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/exospherehost/failproofai/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/exospherehost/failproofai/actions)
+[![Slack](https://img.shields.io/badge/Slack-join%20us-4A154B?style=flat-square&logo=slack)](https://join.slack.com/t/failproofai/shared_invite/zt-3v63b7k5e-O3NBHmj8X6n9gZSGDx6ggQ)
+
+**अनुवाद**: [简体中文](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)
+
+आपके AI एजेंट्स को विश्वसनीय, केंद्रित और स्वायत्त रूप से चलाने वाली नीतियों को प्रबंधित करने का सबसे आसान तरीका - **Claude Code** और **Agents SDK** के लिए।
+
+- **30 बिल्ट-इन नीतियाँ** - आम एजेंट की विफलता के तरीकों को पहले से ही पकड़ें। विनाशकारी कमांड को ब्लॉक करें, गुप्त सूचना के रिसाव को रोकें, एजेंट्स को प्रोजेक्ट की सीमाओं के अंदर रखें, लूप्स का पता लगाएं, और बहुत कुछ।
+- **कस्टम नीतियाँ** - JavaScript में अपनी स्वयं की विश्वसनीयता नियम लिखें। सम्मेलनों को लागू करने, विचलन को रोकने, संचालन को नियंत्रित करने, या बाहरी सिस्टम के साथ एकीकृत करने के लिए `allow`/`deny`/`instruct` API का उपयोग करें।
+- **आसान कॉन्फ़िगरेशन** - कोड लिखे बिना किसी भी नीति को ट्यून करें। प्रति-प्रोजेक्ट या विश्व स्तर पर अनुमति सूचियाँ, संरक्षित शाखाएँ, थ्रेशहोल्ड सेट करें। तीन-स्कोप कॉन्फ़िगरेशन स्वचालित रूप से विलय होता है।
+- **एजेंट मॉनिटर** - देखें कि आपके एजेंट्स आपके दूर रहते हुए क्या करते थे। सत्रों को ब्राउज़ करें, प्रत्येक टूल कॉल का निरीक्षण करें, और देखें कि नीतियाँ कहाँ कार्य करती हैं।
+
+सभी कुछ स्थानीय रूप से चलता है - कोई डेटा आपकी मशीन से बाहर नहीं जाता है।
+
+---
+
+## आवश्यकताएँ
+
+- Node.js >= 20.9.0
+- Bun >= 1.3.0 (वैकल्पिक - केवल विकास / स्रोत से निर्माण के लिए आवश्यक)
+
+---
+
+## इंस्टॉल करें
+
+```bash
+npm install -g failproofai
+# या
+bun add -g failproofai
+```
+
+---
+
+## त्वरित प्रारंभ
+
+### 1. नीतियों को विश्व स्तर पर सक्षम करें
+
+```bash
+failproofai policies --install
+```
+
+`~/.claude/settings.json` में हुक एंट्रीज़ लिखता है। Claude Code अब प्रत्येक टूल कॉल से पहले और बाद में failproofai को आमंत्रित करेगा।
+
+### 2. डैशबोर्ड लॉन्च करें
+
+```bash
+failproofai
+```
+
+`http://localhost:8020` खोलता है - सत्रों को ब्राउज़ करें, लॉग्स का निरीक्षण करें, नीतियों को प्रबंधित करें।
+
+### 3. जाँचें कि क्या सक्रिय है
+
+```bash
+failproofai policies
+```
+
+---
+
+## नीति स्थापना
+
+### स्कोप्स
+
+| स्कोप | कमांड | जहाँ यह लिखता है |
+|-------|---------|-----------------|
+| विश्व (डिफ़ॉल्ट) | `failproofai policies --install` | `~/.claude/settings.json` |
+| प्रोजेक्ट | `failproofai policies --install --scope project` | `.claude/settings.json` |
+| स्थानीय | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
+
+### विशिष्ट नीतियों को स्थापित करें
+
+```bash
+failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
+```
+
+### नीतियों को हटाएं
+
+```bash
+failproofai policies --uninstall
+# या किसी विशेष स्कोप के लिए:
+failproofai policies --uninstall --scope project
+```
+
+---
+
+## कॉन्फ़िगरेशन
+
+नीति कॉन्फ़िगरेशन `~/.failproofai/policies-config.json` (विश्व स्तर) या आपके प्रोजेक्ट में `.failproofai/policies-config.json` (प्रति-प्रोजेक्ट) में रहता है।
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "sanitize-api-keys",
+    "block-push-master",
+    "block-env-files",
+    "block-read-outside-cwd"
+  ],
+  "policyParams": {
+    "block-sudo": {
+      "allowPatterns": ["sudo systemctl status", "sudo journalctl"],
+      "hint": "sudo के बिना सीधे apt-get का उपयोग करें।"
+    },
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "prod"],
+      "hint": "इसके बजाय एक ताज़ी शाखा बनाने का प्रयास करें।"
+    },
+    "sanitize-api-keys": {
+      "additionalPatterns": [
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
+      ]
+    },
+    "warn-large-file-write": {
+      "thresholdKb": 512
+    }
+  }
+}
+```
+
+**तीन कॉन्फ़िगरेशन स्कोप्स** स्वचालित रूप से विलय होते हैं (प्रोजेक्ट → स्थानीय → विश्व)। पूर्ण विलय नियमों के लिए [docs/configuration.mdx](docs/configuration.mdx) देखें।
+
+---
+
+## बिल्ट-इन नीतियाँ
+
+| नीति | विवरण | कॉन्फ़िगरेबल |
+|--------|-------------|:---:|
+| `block-sudo` | एजेंट्स को विशेषाधिकार प्राप्त सिस्टम कमांड चलाने से रोकें | `allowPatterns` |
+| `block-rm-rf` | आकस्मिक पुनरावर्ती फ़ाइल विलोपन को रोकें | `allowPaths` |
+| `block-curl-pipe-sh` | एजेंट्स को अविश्वसनीय स्क्रिप्ट को शेल में पाइप करने से रोकें | |
+| `block-failproofai-commands` | स्व-स्थापना को हटाने से रोकें | |
+| `sanitize-jwt` | JWT टोकन को एजेंट संदर्भ में रिसाव से रोकें | |
+| `sanitize-api-keys` | API कुंजियों को एजेंट संदर्भ में रिसाव से रोकें | `additionalPatterns` |
+| `sanitize-connection-strings` | डेटाबेस क्रेडेंशियल्स को एजेंट संदर्भ में रिसाव से रोकें | |
+| `sanitize-private-key-content` | आउटपुट से PEM निजी कुंजी ब्लॉक को संपादित करें | |
+| `sanitize-bearer-tokens` | आउटपुट से प्राधिकरण Bearer टोकन को संपादित करें | |
+| `block-env-files` | एजेंट्स को .env फ़ाइलें पढ़ने से रोकें | |
+| `protect-env-vars` | एजेंट्स को पर्यावरण चर प्रिंट करने से रोकें | |
+| `block-read-outside-cwd` | एजेंट्स को प्रोजेक्ट की सीमाओं के अंदर रखें | `allowPaths` |
+| `block-secrets-write` | निजी कुंजी और प्रमाणपत्र फ़ाइलों में लेखन को रोकें | `additionalPatterns` |
+| `block-push-master` | मुख्य/मास्टर में आकस्मिक पुश को रोकें | `protectedBranches` |
+| `block-work-on-main` | एजेंट्स को संरक्षित शाखाओं से दूर रखें | `protectedBranches` |
+| `block-force-push` | `git push --force` को रोकें | |
+| `warn-git-amend` | कमिट को संशोधित करने से पहले एजेंट्स को याद दिलाएं | |
+| `warn-git-stash-drop` | स्टैश को छोड़ने से पहले एजेंट्स को याद दिलाएं | |
+| `warn-all-files-staged` | आकस्मिक `git add -A` को पकड़ें | |
+| `warn-destructive-sql` | DROP/DELETE SQL को निष्पादन से पहले पकड़ें | |
+| `warn-schema-alteration` | निष्पादन से पहले ALTER TABLE को पकड़ें | |
+| `warn-large-file-write` | अप्रत्याशित रूप से बड़ी फ़ाइल लेखन को पकड़ें | `thresholdKb` |
+| `warn-package-publish` | आकस्मिक `npm publish` को पकड़ें | |
+| `warn-background-process` | अनपेक्षित पृष्ठभूमि प्रक्रिया लॉन्च को पकड़ें | |
+| `warn-global-package-install` | अनपेक्षित वैश्विक पैकेज इंस्टॉल को पकड़ें | |
+| …और बहुत कुछ | | |
+
+पूर्ण नीति विवरण और पैरामीटर संदर्भ: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
+
+---
+
+## कस्टम नीतियाँ
+
+एजेंट्स को विश्वसनीय और केंद्रित रखने के लिए अपनी नीतियाँ लिखें:
+
+```js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "no-production-writes",
+  description: "'production' युक्त पथों में लेखन को ब्लॉक करें",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("production")) return deny("उत्पादन पथों में लेखन अवरुद्ध है");
+    return allow();
+  },
+});
+```
+
+इसके साथ स्थापित करें:
+
+```bash
+failproofai policies --install --custom ./my-policies.js
+```
+
+### निर्णय सहायक
+
+| कार्य | प्रभाव |
+|----------|--------|
+| `allow()` | संचालन की अनुमति दें |
+| `allow(message)` | अनुमति दें और Claude को सूचनात्मक संदर्भ भेजें *(बीटा)* |
+| `deny(message)` | संचालन को ब्लॉक करें; संदेश Claude को दिखाया जाता है |
+| `instruct(message)` | Claude के प्रॉम्प्ट में संदर्भ जोड़ें; ब्लॉक नहीं करता है |
+
+### संदर्भ ऑब्जेक्ट (`ctx`)
+
+| क्षेत्र | प्रकार | विवरण |
+|-------|------|-------------|
+| `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
+| `toolName` | `string` | बुलाया जा रहा टूल (`"Bash"`, `"Write"`, `"Read"`, …) |
+| `toolInput` | `object` | टूल के इनपुट पैरामीटर |
+| `payload` | `object` | संपूर्ण कच्ची ईवेंट पेलोड |
+| `session.cwd` | `string` | Claude Code सत्र की कार्य निर्देशिका |
+| `session.sessionId` | `string` | सत्र पहचानकर्ता |
+| `session.transcriptPath` | `string` | सत्र प्रतिलेख फ़ाइल का पथ |
+
+कस्टम हुक्स सकर्मक स्थानीय आयातों, async/await, और `process.env` के लिए पहुंच का समर्थन करते हैं। त्रुटियाँ fail-open हैं (लॉग किए गए `~/.failproofai/hook.log` में, बिल्ट-इन नीतियाँ जारी रहती हैं)। संपूर्ण गाइड के लिए [docs/custom-hooks.mdx](docs/custom-hooks.mdx) देखें।
+
+### कन्वेंशन-आधारित नीतियाँ (v0.0.2-beta.7+)
+
+`.failproofai/policies/` में `*policies.{js,mjs,ts}` फ़ाइलें छोड़ें और वे स्वचालित रूप से लोड होते हैं — कोई `--custom` फ्लैग या कॉन्फ़िगरेशन परिवर्तन की आवश्यकता नहीं। यह git हुक्स की तरह काम करता है: एक फ़ाइल छोड़ें, यह बस काम करता है।
+
+```text
+# प्रोजेक्ट स्तर — git में प्रतिबद्ध, टीम के साथ साझा किया गया
+.failproofai/policies/security-policies.mjs
+.failproofai/policies/workflow-policies.mjs
+
+# उपयोगकर्ता स्तर — व्यक्तिगत, सभी प्रोजेक्ट्स पर लागू होता है
+~/.failproofai/policies/my-policies.mjs
+```
+
+दोनों स्तर लोड होते हैं (मिलन)। फ़ाइलें प्रत्येक निर्देशिका के भीतर वर्णानुक्रम में लोड होती हैं। क्रम को नियंत्रित करने के लिए `01-`, `02-`, आदि से उपसर्ग करें। तुरंत उपयोग के लिए उदाहरणों के लिए [examples/convention-policies/](examples/convention-policies/) देखें।
+
+---
+
+## टेलीमेट्री
+
+Failproof AI PostHog के माध्यम से गुमनाम उपयोग टेलीमेट्री एकत्र करता है ताकि सुविधा उपयोग को समझा जा सके। कोई सत्र सामग्री, फ़ाइल नाम, टूल इनपुट, या व्यक्तिगत जानकारी कभी नहीं भेजी जाती है।
+
+इसे अक्षम करें:
+
+```bash
+FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
+```
+
+---
+
+## दस्तावेज़
+
+| गाइड | विवरण |
+|-------|-------------|
+| [प्रारंभ करना](docs/getting-started.mdx) | स्थापना और पहले कदम |
+| [बिल्ट-इन नीतियाँ](docs/built-in-policies.mdx) | सभी 30 बिल्ट-इन नीतियाँ और पैरामीटर |
+| [कस्टम नीतियाँ](docs/custom-policies.mdx) | अपनी स्वयं की नीतियाँ लिखें |
+| [कॉन्फ़िगरेशन](docs/configuration.mdx) | कॉन्फ़िगरेशन फ़ाइल प्रारूप और स्कोप विलय |
+| [डैशबोर्ड](docs/dashboard.mdx) | सत्रों की निगरानी करें और नीति गतिविधि की समीक्षा करें |
+| [आर्किटेक्चर](docs/architecture.mdx) | हुक सिस्टम कैसे काम करता है |
+| [परीक्षण](docs/testing.mdx) | परीक्षण चलाएं और नए परीक्षण लिखें |
+
+### दस्तावेज़ को स्थानीय रूप से चलाएं
+
+```bash
+docker build -f Dockerfile.docs -t failproofai-docs .
+docker run --rm -p 3000:3000 failproofai-docs
+```
+
+Mintlify दस्तावेज़ साइट को `http://localhost:3000` पर खोलता है। यदि आप दस्तावेज़ निर्देशिका को माउंट करते हैं तो कंटेनर परिवर्तनों को देखता है:
+
+```bash
+docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
+```
+
+---
+
+## failproofai योगदानकर्ताओं के लिए नोट
+
+इस रिपो की `.claude/settings.json` मानक `npx -y failproofai` कमांड के बजाय `bun ./bin/failproofai.mjs --hook <EventType>` का उपयोग करता है। ऐसा इसलिए है क्योंकि failproofai प्रोजेक्ट के अंदर `npx -y failproofai` चलाने से आत्म-संदर्भी विरोध उत्पन्न होता है।
+
+अन्य सभी रिपो के लिए, अनुशंसित दृष्टिकोण `npx -y failproofai` है, जिसे इसके माध्यम से स्थापित किया जाता है:
+
+```bash
+failproofai policies --install --scope project
+```
+
+## योगदान देना
+
+[CONTRIBUTING.md](CONTRIBUTING.md) देखें।
+
+---
+
+## लाइसेंस
+
+[LICENSE](LICENSE) देखें।
+
+---
+
+**ExosphereHost: आपके एजेंट्स के लिए विश्वसनीयता अनुसंधान लैब** द्वारा निर्मित और रक्षरक्षरक्ष। हम अपने स्वयं के एजेंट्स, सॉफ्टवेयर और विशेषज्ञता के माध्यम से उद्यमों और स्टार्टअप को अपने AI एजेंट्स की विश्वसनीयता में सुधार करने में मदद करते हैं। [exosphere.host](https://exosphere.host) पर अधिक जानें।

package/.next/standalone/docs/i18n/README.it.md

@@ -0,0 +1,307 @@
+> **⚠️** This is an auto-generated translation. For the latest version, see the [English README](../../README.md). Community corrections welcome!
+
+[🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt-br.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇷🇺 Русский](README.ru.md) | [🇮🇳 हिन्दी](README.hi.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | **🇮🇹 Italiano** | [🇸🇦 العربية](README.ar.md) | [🇮🇱 עברית](README.he.md)
+
+---
+
+```
+    ______      _ __                       ____   ___    ____
+   / ____/___ _(_) /___  _________  ____  / __/  /   |  /  _/
+  / /_  / __ `/ / / __ \/ ___/ __ \/ __ \/ /_   / /| |  / /
+ / __/ / /_/ / / / /_/ / /  / /_/ / /_/ / __/  / ___ |_/ /
+/_/    \__,_/_/_/ .___/_/   \____/\____/_/    /_/  |_/___/
+               /_/
+```
+
+# Failproof AI
+
+[![Docs](https://img.shields.io/badge/docs-befailproof.ai-002CA7?style=flat-square)](https://befailproof.ai)
+[![npm](https://img.shields.io/npm/v/failproofai?style=flat-square&color=CB3837)](https://www.npmjs.com/package/failproofai)
+[![License](https://img.shields.io/badge/license-MIT%20%2B%20Commons%20Clause-blue?style=flat-square)](LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/exospherehost/failproofai/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/exospherehost/failproofai/actions)
+[![Slack](https://img.shields.io/badge/Slack-join%20us-4A154B?style=flat-square&logo=slack)](https://join.slack.com/t/failproofai/shared_invite/zt-3v63b7k5e-O3NBHmj8X6n9gZSGDx6ggQ)
+
+**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)
+
+Il modo più semplice per gestire i criteri che mantengono i tuoi agenti AI affidabili, focalizzati e autonomi - per **Claude Code** e **Agents SDK**.
+
+- **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.
+- **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.
+- **Configurazione Facile** - Personalizza qualsiasi criterio senza scrivere codice. Imposta allowlist, rami protetti, soglie per progetto o globalmente. Tre ambiti di configurazione si uniscono automaticamente.
+- **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.
+
+Tutto funziona localmente - nessun dato esce dalla tua macchina.
+
+---
+
+## Requisiti
+
+- Node.js >= 20.9.0
+- Bun >= 1.3.0 (opzionale - necessario solo per lo sviluppo / compilazione da sorgente)
+
+---
+
+## Installazione
+
+```bash
+npm install -g failproofai
+# o
+bun add -g failproofai
+```
+
+---
+
+## Guida veloce
+
+### 1. Abilita i criteri globalmente
+
+```bash
+failproofai policies --install
+```
+
+Scrive voci di hook in `~/.claude/settings.json`. Claude Code ora invocherà failproofai prima e dopo ogni chiamata di tool.
+
+### 2. Avvia il dashboard
+
+```bash
+failproofai
+```
+
+Apre `http://localhost:8020` - sfoglia le sessioni, ispeziona i log, gestisci i criteri.
+
+### 3. Controlla cosa è attivo
+
+```bash
+failproofai policies
+```
+
+---
+
+## Installazione dei criteri
+
+### Ambiti
+
+| Ambito | Comando | Dove scrive |
+|--------|---------|-------------|
+| Globale (predefinito) | `failproofai policies --install` | `~/.claude/settings.json` |
+| Progetto | `failproofai policies --install --scope project` | `.claude/settings.json` |
+| Locale | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
+
+### Installa criteri specifici
+
+```bash
+failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
+```
+
+### Rimuovi i criteri
+
+```bash
+failproofai policies --uninstall
+# oppure per un ambito specifico:
+failproofai policies --uninstall --scope project
+```
+
+---
+
+## Configurazione
+
+La configurazione dei criteri si trova in `~/.failproofai/policies-config.json` (globale) o `.failproofai/policies-config.json` nel tuo progetto (per progetto).
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "sanitize-api-keys",
+    "block-push-master",
+    "block-env-files",
+    "block-read-outside-cwd"
+  ],
+  "policyParams": {
+    "block-sudo": {
+      "allowPatterns": ["sudo systemctl status", "sudo journalctl"],
+      "hint": "Usa apt-get direttamente senza sudo."
+    },
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "prod"],
+      "hint": "Prova a creare un nuovo ramo invece."
+    },
+    "sanitize-api-keys": {
+      "additionalPatterns": [
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
+      ]
+    },
+    "warn-large-file-write": {
+      "thresholdKb": 512
+    }
+  }
+}
+```
+
+**Tre ambiti di configurazione** si uniscono automaticamente (progetto → locale → globale). Vedi [docs/configuration.mdx](docs/configuration.mdx) per le regole di unione complete.
+
+---
+
+## Criteri integrati
+
+| Criterio | Descrizione | Configurabile |
+|----------|-------------|:---:|
+| `block-sudo` | Previeni gli agenti dall'eseguire comandi di sistema privilegiati | `allowPatterns` |
+| `block-rm-rf` | Previeni l'eliminazione ricorsiva accidentale di file | `allowPaths` |
+| `block-curl-pipe-sh` | Previeni gli agenti dal piping di script non attendibili nella shell | |
+| `block-failproofai-commands` | Previeni l'auto-disinstallazione | |
+| `sanitize-jwt` | Impedisci ai token JWT di trapelare nel contesto dell'agente | |
+| `sanitize-api-keys` | Impedisci alle chiavi API di trapelare nel contesto dell'agente | `additionalPatterns` |
+| `sanitize-connection-strings` | Impedisci alle credenziali del database di trapelare nel contesto dell'agente | |
+| `sanitize-private-key-content` | Redigi i blocchi di chiave privata PEM dall'output | |
+| `sanitize-bearer-tokens` | Redigi i token Authorization Bearer dall'output | |
+| `block-env-files` | Impedisci agli agenti di leggere i file .env | |
+| `protect-env-vars` | Previeni gli agenti dal stampare variabili di ambiente | |
+| `block-read-outside-cwd` | Mantieni gli agenti all'interno dei confini del progetto | `allowPaths` |
+| `block-secrets-write` | Previeni le scritture su file di chiave privata e certificato | `additionalPatterns` |
+| `block-push-master` | Previeni i push accidentali su main/master | `protectedBranches` |
+| `block-work-on-main` | Mantieni gli agenti fuori dai rami protetti | `protectedBranches` |
+| `block-force-push` | Previeni `git push --force` | |
+| `warn-git-amend` | Ricorda agli agenti prima di modificare i commit | |
+| `warn-git-stash-drop` | Ricorda agli agenti prima di eliminare gli stash | |
+| `warn-all-files-staged` | Rileva `git add -A` accidentale | |
+| `warn-destructive-sql` | Rileva DROP/DELETE SQL prima dell'esecuzione | |
+| `warn-schema-alteration` | Rileva ALTER TABLE prima dell'esecuzione | |
+| `warn-large-file-write` | Rileva le scritture di file inaspettatamente grandi | `thresholdKb` |
+| `warn-package-publish` | Rileva `npm publish` accidentale | |
+| `warn-background-process` | Rileva i lanci di processi in background indesiderati | |
+| `warn-global-package-install` | Rileva le installazioni di pacchetti globali indesiderate | |
+| …e altri | | |
+
+Dettagli completi dei criteri e riferimento dei parametri: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
+
+---
+
+## Criteri personalizzati
+
+Scrivi i tuoi criteri per mantenere gli agenti affidabili e focalizzati:
+
+```js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "no-production-writes",
+  description: "Block writes to paths containing 'production'",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("production")) return deny("Writes to production paths are blocked");
+    return allow();
+  },
+});
+```
+
+Installa con:
+
+```bash
+failproofai policies --install --custom ./my-policies.js
+```
+
+### Helper di decisione
+
+| Funzione | Effetto |
+|----------|--------|
+| `allow()` | Consenti l'operazione |
+| `allow(message)` | Consenti e invia contesto informativo a Claude *(beta)* |
+| `deny(message)` | Blocca l'operazione; messaggio mostrato a Claude |
+| `instruct(message)` | Aggiungi contesto al prompt di Claude; non blocca |
+
+### Oggetto contesto (`ctx`)
+
+| Campo | Tipo | Descrizione |
+|-------|------|-------------|
+| `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
+| `toolName` | `string` | Tool in via di invocazione (`"Bash"`, `"Write"`, `"Read"`, …) |
+| `toolInput` | `object` | Parametri di input del tool |
+| `payload` | `object` | Payload di evento grezzo completo |
+| `session.cwd` | `string` | Directory di lavoro della sessione Claude Code |
+| `session.sessionId` | `string` | Identificatore della sessione |
+| `session.transcriptPath` | `string` | Percorso del file di trascrizione della sessione |
+
+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.
+
+### Criteri basati su convenzione (v0.0.2-beta.7+)
+
+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.
+
+```text
+# Livello di progetto — committato su git, condiviso con il team
+.failproofai/policies/security-policies.mjs
+.failproofai/policies/workflow-policies.mjs
+
+# Livello utente — personale, si applica a tutti i progetti
+~/.failproofai/policies/my-policies.mjs
+```
+
+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.
+
+---
+
+## Telemetria
+
+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.
+
+Disabilitalo:
+
+```bash
+FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
+```
+
+---
+
+## Documentazione
+
+| Guida | Descrizione |
+|-------|-------------|
+| [Getting Started](docs/getting-started.mdx) | Installazione e primi passi |
+| [Built-in Policies](docs/built-in-policies.mdx) | Tutti i 30 criteri integrati con parametri |
+| [Custom Policies](docs/custom-policies.mdx) | Scrivi i tuoi criteri |
+| [Configuration](docs/configuration.mdx) | Formato del file di configurazione e unione degli ambiti |
+| [Dashboard](docs/dashboard.mdx) | Monitora le sessioni e rivedi l'attività dei criteri |
+| [Architecture](docs/architecture.mdx) | Come funziona il sistema di hook |
+| [Testing](docs/testing.mdx) | Eseguire test e scrivere nuovi test |
+
+### Esegui la documentazione localmente
+
+```bash
+docker build -f Dockerfile.docs -t failproofai-docs .
+docker run --rm -p 3000:3000 failproofai-docs
+```
+
+Apre il sito della documentazione Mintlify su `http://localhost:3000`. Il contenitore controlla le modifiche se monti la directory dei documenti:
+
+```bash
+docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
+```
+
+---
+
+## Nota per i contributori di failproofai
+
+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.
+
+Per tutti gli altri repo, l'approccio consigliato è `npx -y failproofai`, installato tramite:
+
+```bash
+failproofai policies --install --scope project
+```
+
+## Contribuire
+
+Vedi [CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## Licenza
+
+Vedi [LICENSE](LICENSE).
+
+---
+
+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).