failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/hi/built-in-policies.mdx

@@ -0,0 +1,848 @@
+---
+title: बिल्ट-इन पॉलिसीज़
+description: "सभी 39 बिल्ट-इन पॉलिसीज़ जो एजेंट की आम विफलताओं को पकड़ते हैं"
+icon: shield
+---
+
+failproofai 39 बिल्ट-इन पॉलिसीज़ के साथ आता है जो एजेंट की आम विफलता मोड को पकड़ते हैं। प्रत्येक पॉलिसी एक विशिष्ट हुक इवेंट प्रकार और टूल नाम पर काम करती है। उन्नीस पॉलिसीज़ पैरामीटर स्वीकार करती हैं जो आपको कोड लिखे बिना उनके व्यवहार को ट्यून करने देते हैं। पाँच वर्कफ़्लो पॉलिसीज़ एक commit → push → PR → CI पाइपलाइन को लागू करती हैं जिससे पहले Claude रुक जाता है।
+
+---
+
+## अवलोकन
+
+पॉलिसीज़ को श्रेणियों में बाँटा गया है:
+
+| श्रेणी | पॉलिसीज़ | हुक प्रकार |
+|----------|----------|-----------|
+| [खतरनाक कमांड](#dangerous-commands) | block-sudo, block-rm-rf, block-curl-pipe-sh, block-failproofai-commands, block-self-pause | PreToolUse |
+| [इन्फ्रा कमांड](#infra-commands) | block-kubectl, block-terraform, block-aws-cli, block-gcloud, block-az-cli, block-helm, block-gh-pipeline | PreToolUse |
+| [सीक्रेट्स (सैनिटाइज़र)](#secrets-sanitizers) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
+| [पर्यावरण](#environment) | block-env-files, protect-env-vars | PreToolUse |
+| [फ़ाइल एक्सेस](#file-access) | block-read-outside-cwd, block-secrets-write | PreToolUse |
+| [Git](#git) | block-push-master, block-work-on-main, block-force-push, warn-git-amend, warn-git-stash-drop, warn-all-files-staged | PreToolUse |
+| [डेटाबेस](#database) | warn-destructive-sql, warn-schema-alteration | PreToolUse |
+| [चेतावनियाँ](#warnings) | warn-large-file-write, warn-package-publish, warn-background-process, warn-global-package-install | PreToolUse |
+| [पैकेज मैनेजर](#package-managers) | prefer-package-manager | PreToolUse |
+| [वर्कफ़्लो](#workflow) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-no-conflicts-before-stop, require-ci-green-before-stop | Stop |
+
+- **`block-`** — एजेंट को आगे बढ़ने से रोकता है।
+- **`warn-`** — एजेंट को अतिरिक्त संदर्भ देता है ताकि यह स्व-सुधार कर सके।
+- **`sanitize-`** — एजेंट को देखने से पहले टूल आउटपुट से संवेदनशील डेटा हटाता है।
+
+### नेमस्पेस
+
+प्रत्येक पॉलिसी एक `<namespace>/<name>` स्लॉट में रहती है। बिल्ट-इन पॉलिसीज़ **`failproofai/`** नेमस्पेस से संबंधित हैं — उदाहरण के लिए, `failproofai/sanitize-jwt`। नेमस्पेस तब टकराव को रोकता है जब आप समान छोटे नाम वाली कस्टम या तीसरे पक्ष की पॉलिसीज़ भी लोड करते हैं।
+
+आपके कॉन्फ़िग में आप एक बिल्ट-इन को या तो इसके छोटे नाम या योग्य नाम से संदर्भित कर सकते हैं; दोनों रूप एक ही पॉलिसी को हल करते हैं:
+
+```json
+{
+  "enabledPolicies": [
+    "sanitize-jwt",
+    "failproofai/block-rm-rf"
+  ]
+}
+```
+
+यदि किसी नाम में कोई `/` नहीं है, तो failproofai इसे डिफ़ॉल्ट नेमस्पेस `failproofai` के रूप में मानता है। नाम जिनमें पहले से `/` है (जैसे `myorg/foo`, `custom/my-hook`) वैसे ही रखे जाते हैं।
+- **`require-`** — Stop इवेंट को तब तक ब्लॉक करता है जब तक शर्तें पूरी न हों।
+
+---
+
+<Tip>
+प्रत्येक पॉलिसी `policyParams` में एक वैकल्पिक `hint` फील्ड का समर्थन करती है। hint को deny या instruct संदेश में जोड़ा जाता है जो Claude देखता है, पॉलिसी कोड में संशोधन किए बिना कार्रवाई योग्य मार्गदर्शन देता है। बिल्ट-इन, कस्टम और कन्वेंशन पॉलिसीज़ के साथ काम करता है। विवरण के लिए [कॉन्फ़िगरेशन → hint](/hi/configuration#hint-cross-cutting) देखें।
+</Tip>
+
+---
+
+## खतरनाक कमांड
+
+एजेंट को ऐसे ऑपरेशन चलाने से रोकें जो पूर्ववत करने में कठिन हों या जो होस्ट सिस्टम को नुकसान पहुँचा सकते हों।
+
+### `block-sudo`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** किसी भी `sudo` या `doas` कमांड को नकारता है।
+
+एक कमांड को ब्लॉक करता है जो **कमांड स्थिति** में एक elevation बाइनरी चलाता है। मिलान संरचनात्मक है पाठात्मक नहीं: कमांड को उन सेगमेंट में विभाजित किया जाता है जैसे एक शेल करेगा, उपसर्ग असाइनमेंट (`FOO=bar`), रीडायरेक्शन, और रनर अपने फ़्लैग्स (`env`, `nohup`, `timeout`, `xargs`, `sh -c`, …) के साथ हटा दिए जाते हैं, और परिणामी बाइनरी **basename** द्वारा तुलना की जाती है। तो `/usr/bin/sudo`, `env sudo`, `timeout 5 sudo`, `"sudo"`, `\sudo` और `bash -c "sudo …"` सभी को नकार दिया जाता है, और `doas` को एक अलग नाम के तहत एक ही क्षमता के रूप में माना जाता है।
+
+क्योंकि यह कमांड स्थिति पर लंगर डालता है शब्द कहीं भी दिखाई देने पर नहीं, यह **नहीं** कमांड पर काम करता है जो केवल इसका उल्लेख करते हैं — `grep -r sudo /etc`, `cat /etc/sudoers`, `git commit -m "fix sudo handling"`, या `grep` वैकल्पिकता युक्त शब्द सामान्य रूप से चलते हैं।
+
+<Warning>
+यह स्पष्ट प्रयास को रोकता है; यह श्रेणी को बंद नहीं करता। एक एजेंट जो मनमानी शेल चला सकता है अभी भी अप्रत्यक्ष रूप से elevation तक पहुँच सकता है — एक वेरिएबल (`S=sudo; $S …`), एक base64-डिकोडेड पाइप, या डिस्क पर एक रैपर स्क्रिप्ट के माध्यम से — क्योंकि एक भी कमांड स्ट्रिंग का कोई निरीक्षण उन का पालन नहीं कर सकता। इसे गलतियों और आकस्मिक स्केलिंग के विरुद्ध गार्ड के रूप में देखें, एक निर्धारित एजेंट के विरुद्ध सुरक्षा सीमा के रूप में नहीं। एक वास्तविक सीमा को शेल के नीचे लागू किया जाना चाहिए।
+</Warning>
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | अनुमत सटीक कमांड उपसर्ग। प्रत्येक प्रविष्टि को पार्स किए गए argv टोकन के विरुद्ध मिलाया जाता है। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "block-sudo": {
+      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
+    }
+  }
+}
+```
+
+इस कॉन्फ़िग के साथ, `sudo systemctl status nginx` अनुमत है, लेकिन `sudo rm /etc/hosts` नकार दिया जाता है।
+
+<Note>
+पैटर्न को पार्स किए गए टोकन के विरुद्ध मिलाया जाता है, कच्ची कमांड स्ट्रिंग के विरुद्ध नहीं। यह अंत में जोड़े गए शेल ऑपरेटर के माध्यम से बाईपास को रोकता है (उदा. `sudo systemctl status x; rm -rf /` `sudo systemctl status *` से मेल नहीं खाता)।
+</Note>
+
+---
+
+### `block-rm-rf`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** `rm -rf`, `rm -fr` और समान पुनरावर्ती विलोपन रूपों को नकारता है।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `allowPaths` | `string[]` | `[]` | पाथ जो पुनरावर्ती रूप से हटाने के लिए सुरक्षित हैं (उदा. `/tmp`)। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "block-rm-rf": {
+      "allowPaths": ["/tmp", "/var/cache"]
+    }
+  }
+}
+```
+
+---
+
+### `block-curl-pipe-sh`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** `curl <url> | bash`, `curl <url> | sh`, `wget <url> | bash` और समान पैटर्न को नकारता है।
+
+कोई पैरामीटर नहीं।
+
+---
+
+### `block-failproofai-commands`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** कमांड को नकारता है जो failproofai को स्वयं अनइंस्टॉल या अक्षम करेंगे (उदा. `npm uninstall failproofai`, `failproofai policies --uninstall`)।
+
+कोई पैरामीटर नहीं।
+
+---
+
+### `block-self-pause`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** `failproofai config --pause` को नकारता है, जो एक सेशन के लिए enforcement को निलंबित करता है। Pause एक मानव निर्णय है — एक एजेंट जो इसे चला सकता है एक ही कमांड से हर दूसरी पॉलिसी को बंद कर सकता है।
+
+[`block-failproofai-commands`](#block-failproofai-commands) की तुलना में संकीर्ण इरादे से, और इससे कवर नहीं है: वह पॉलिसी एक कमांड सीमा पर लंगर डालती है, तो `npx -y failproofai config --pause` इससे मेल नहीं खाता, और व्यापक होने के कारण अक्सर इसे बंद कर दिया जाता है ताकि एजेंट `failproofai audit` चला सकें। `--resume` और `--status` अनुमत हैं — न ही enforcement को हटाता है।
+
+यह सीधे प्रयास को रोकता है, पूरी श्रेणी को नहीं: एक एजेंट अभी भी एक alias या रैपर स्क्रिप्ट के माध्यम से एक ही स्थिति तक पहुँच सकता है। इसे पूरी तरह बंद करने के लिए pause को एक टूल कॉल से पूरी तरह अप्राप्य होना पड़ता है।
+
+कोई पैरामीटर नहीं।
+
+---
+
+## इन्फ्रा कमांड
+
+कोडिंग एजेंट को infrastructure CLIs चलाने या CI/CD पाइपलाइन ट्रिगर करने से रोकें। इस श्रेणी में सभी पॉलिसीज़ **opt-in** हैं (`defaultEnabled: false`) — एजेंट जिन्हें `kubectl`, `terraform`, आदि को कॉल करने की वैध आवश्यकता है व्यवधान से प्रभावित नहीं होंगे जब तक आप पॉलिसी सक्षम न करें। सक्षम होने पर, मिलान किए गए CLI की प्रत्येक invocation को नकार दिया जाता है जब तक कमांड `allowPatterns` में किसी प्रविष्टि से मेल नहीं खाता।
+
+पैटर्न व्याकरण [`block-sudo`](#block-sudo) जैसा है: टोकन को पार्स किए गए argv के विरुद्ध मिलाया जाता है, `*` एक टोकन के लिए wildcard है, और कोई भी कमांड जिसमें standalone शेल ऑपरेटर (`&&`, `||`, `|`, `;`) या embedded शेल metacharacters वाला टोकन है injection bypasses को रोकने के लिए allowlist मिलान से पहले अस्वीकार किया जाता है।
+
+### `block-kubectl`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** किसी भी `kubectl` invocation को नकारता है।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | kubectl कमांड उपसर्ग जो अनुमत हैं। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "block-kubectl": {
+      "allowPatterns": ["kubectl get *", "kubectl describe *", "kubectl logs *"]
+    }
+  }
+}
+```
+
+इस कॉन्फ़िग के साथ, `kubectl get pods` अनुमत है लेकिन `kubectl apply -f deploy.yaml` नकार दिया जाता है।
+
+---
+
+### `block-terraform`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** किसी भी `terraform` या `tofu` (OpenTofu) invocation को नकारता है।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | terraform/tofu कमांड उपसर्ग जो अनुमत हैं। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "block-terraform": {
+      "allowPatterns": ["terraform plan", "terraform validate", "terraform show *"]
+    }
+  }
+}
+```
+
+---
+
+### `block-aws-cli`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** किसी भी `aws` CLI invocation को नकारता है।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | aws CLI कमांड उपसर्ग जो अनुमत हैं। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "block-aws-cli": {
+      "allowPatterns": ["aws s3 ls *", "aws sts get-caller-identity"]
+    }
+  }
+}
+```
+
+---
+
+### `block-gcloud`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** किसी भी `gcloud` (Google Cloud) CLI invocation को नकारता है।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | gcloud कमांड उपसर्ग जो अनुमत हैं। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "block-gcloud": {
+      "allowPatterns": ["gcloud auth list", "gcloud config list"]
+    }
+  }
+}
+```
+
+---
+
+### `block-az-cli`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** किसी भी `az` (Azure) CLI invocation को नकारता है।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | az CLI कमांड उपसर्ग जो अनुमत हैं। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "block-az-cli": {
+      "allowPatterns": ["az account show", "az group list"]
+    }
+  }
+}
+```
+
+---
+
+### `block-helm`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** किसी भी `helm` invocation को नकारता है।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | helm कमांड उपसर्ग जो अनुमत हैं। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "block-helm": {
+      "allowPatterns": ["helm list", "helm status *"]
+    }
+  }
+}
+```
+
+---
+
+### `block-gh-pipeline`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** निम्नलिखित `gh` CLI subcommands को नकारता है जो स्थिति में परिवर्तन करते हैं या पाइपलाइन ट्रिगर करते हैं:
+
+- `gh workflow run`, `gh workflow enable`, `gh workflow disable`
+- `gh run rerun`, `gh run cancel`
+- `gh pr merge`
+- `gh release create`, `gh release delete`
+- `gh cache delete`
+- `gh secret set`, `gh secret delete`
+
+केवल-पढ़ने के लिए `gh` subcommands जैसे `gh pr view`, `gh pr list`, `gh run list`, `gh release view`, और `gh api repos/.../...` इस पॉलिसी से **मेल नहीं** खाते — वे वर्कफ़्लो जाँच के लिए नियमित रूप से आवश्यक हैं (failproofai के अपने `require-ci-green-before-stop` सहित)।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `allowPatterns` | `string[]` | `[]` | विशिष्ट स्क्रिप्ट invocations अनुमत करने के लिए भले ही वे अन्यथा नकार दिए जाएंगे। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "block-gh-pipeline": {
+      "allowPatterns": ["gh run rerun *"]
+    }
+  }
+}
+```
+
+---
+
+## सीक्रेट्स (सैनिटाइज़र)
+
+एजेंट को credentials को अपने संदर्भ में या आउटपुट में लीक करने से रोकें। सैनिटाइज़र पॉलिसीज़ **PostToolUse** इवेंट पर काम करती हैं। जब Claude एक Bash कमांड चलाता है, एक फ़ाइल पढ़ता है, या कोई भी टूल कॉल करता है, ये पॉलिसीज़ आउटपुट का निरीक्षण करती हैं इससे पहले कि यह Claude को वापस किया जाए। यदि एक सीक्रेट पैटर्न पाया जाता है, पॉलिसी एक नकार निर्णय लौटाती है जो आउटपुट को पास होने से रोकती है।
+
+### `sanitize-jwt`
+
+**इवेंट:** PostToolUse (सभी टूल्स)  
+**डिफ़ॉल्ट:** JWT टोकन को हटाता है (तीन base64url सेगमेंट `.` द्वारा अलग)।
+
+कोई पैरामीटर नहीं।
+
+---
+
+### `sanitize-api-keys`
+
+**इवेंट:** PostToolUse (सभी टूल्स)  
+**डिफ़ॉल्ट:** सामान्य API कुंजी प्रारूपों को हटाता है: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PATs (`ghp_`), AWS एक्सेस कुंजी (`AKIA`), Stripe कुंजी (`sk_live_`, `sk_test_`), और Google API कुंजी (`AIza`)।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | सीक्रेट के रूप में मानने के लिए अतिरिक्त regex पैटर्न। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "sanitize-api-keys": {
+      "additionalPatterns": [
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo internal API key" },
+        { "regex": "pat_[0-9a-f]{40}", "label": "Internal PAT" }
+      ]
+    }
+  }
+}
+```
+
+---
+
+### `sanitize-connection-strings`
+
+**इवेंट:** PostToolUse (सभी टूल्स)  
+**डिफ़ॉल्ट:** डेटाबेस कनेक्शन स्ट्रिंग को हटाता है जिनमें embedded credentials हैं (उदा. `postgresql://user:password@host/db`)।
+
+कोई पैरामीटर नहीं।
+
+---
+
+### `sanitize-private-key-content`
+
+**इवेंट:** PostToolUse (सभी टूल्स)  
+**डिफ़ॉल्ट:** PEM ब्लॉक को हटाता है (`-----BEGIN PRIVATE KEY-----`, `-----BEGIN RSA PRIVATE KEY-----`, आदि)।
+
+कोई पैरामीटर नहीं।
+
+---
+
+### `sanitize-bearer-tokens`
+
+**इवेंट:** PostToolUse (सभी टूल्स)  
+**डिफ़ॉल्ट:** `Authorization: Bearer <token>` हेडर को हटाता है जहाँ टोकन 20 या अधिक वर्ण है।
+
+कोई पैरामीटर नहीं।
+
+---
+
+## पर्यावरण
+
+संवेदनशील पर्यावरण कॉन्फ़िगरेशन को एजेंट द्वारा पढ़े जाने या exposed होने से सुरक्षित रखें।
+
+### `block-env-files`
+
+**इवेंट:** PreToolUse (Bash, Read)  
+**डिफ़ॉल्ट:** `.env` फ़ाइलें पढ़ने से इनकार करता है जैसे `cat .env`, फ़ाइल पाथ के रूप में `.env` के साथ Read टूल कॉल, आदि।
+
+`.envrc` या अन्य environment-संबंधी फ़ाइलों को ब्लॉक नहीं करता — केवल बिल्कुल `.env` नाम वाली फ़ाइलें।
+
+कोई पैरामीटर नहीं।
+
+---
+
+### `protect-env-vars`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** कमांड को नकारता है जो environment variables प्रिंट करते हैं: `printenv`, `env`, `echo $VAR`।
+
+कोई पैरामीटर नहीं।
+
+---
+
+## फ़ाइल एक्सेस
+
+एजेंट को प्रोजेक्ट सीमाओं के अंदर काम करने और संवेदनशील फ़ाइलों से दूर रखें।
+
+### `block-read-outside-cwd`
+
+**इवेंट:** PreToolUse (Read, Bash)  
+**डिफ़ॉल्ट:** प्रोजेक्ट रूट के बाहर फ़ाइलें पढ़ने से इनकार करता है। सीमा `CLAUDE_PROJECT_DIR` है (Claude Code द्वारा प्रति सेशन एक बार सेट), उस वेरिएबल अनसेट होने पर सेशन की वर्तमान कार्य निर्देशिका में fallback के साथ। live `cwd` के बजाय प्रोजेक्ट रूट का उपयोग करने का मतलब है कि सीमा स्थिर रहती है भले ही Claude किसी subdirectory में `cd` करे।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `allowPaths` | `string[]` | `[]` | Absolute पाथ उपसर्ग जो अनुमत हैं भले ही प्रोजेक्ट रूट के बाहर हों। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "block-read-outside-cwd": {
+      "allowPaths": ["/shared/data", "/opt/company/config"]
+    }
+  }
+}
+```
+
+---
+
+### `block-secrets-write`
+
+**इवेंट:** PreToolUse (Write, Edit)  
+**डिफ़ॉल्ट:** प्राइवेट कुंजी और certificates के लिए आमतौर पर उपयोग की जाने वाली फ़ाइलों में लिखने से इनकार करता है: `id_rsa`, `id_ed25519`, `*.key`, `*.pem`, `*.p12`, `*.pfx`।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `additionalPatterns` | `string[]` | `[]` | ब्लॉक करने के लिए अतिरिक्त फ़ाइलनाम पैटर्न (glob-शैली)। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "block-secrets-write": {
+      "additionalPatterns": [".token", ".secret"]
+    }
+  }
+}
+```
+
+---
+
+## Git
+
+आकस्मिक pushes, force-pushes, और ब्रांच गलतियों से बचें जो पूर्ववत करने में कठिन हों।
+
+### `block-push-master`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** `git push origin main` और `git push origin master` को नकारता है।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | ब्रांच नाम जो सीधे push नहीं किए जा सकते। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "master", "release", "prod"]
+    }
+  }
+}
+```
+
+<Tip>
+सभी ब्रांच को push करने की अनुमति देने के लिए (इसे `enabledPolicies` से हटाए बिना प्रभावी रूप से अक्षम करने के लिए), `protectedBranches: []` सेट करें।
+</Tip>
+
+---
+
+### `block-work-on-main`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** `git commit`, `git merge`, `git rebase`, और `git cherry-pick` को तब नकारता है जब कार्य ट्री `main` या `master` पर हो। ब्रांच creation और switching (`git checkout`, `git checkout -b`, `git switch`, `git switch -c`) प्रभावित नहीं हैं।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | ब्रांच नाम जिन पर commit/merge/rebase/cherry-pick से इनकार किया जाता है। |
+
+---
+
+### `block-force-push`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** `git push --force` और `git push -f` को नकारता है।
+
+कोई policy-विशिष्ट पैरामीटर नहीं। विकल्प सुझाने के लिए cross-cutting [`hint`](/hi/configuration#hint-cross-cutting) का उपयोग करें:
+
+```json
+{
+  "policyParams": {
+    "block-force-push": {
+      "hint": "अपने वर्तमान HEAD से एक नई ब्रांच बनाएँ (उदा. `git checkout -b <new-branch>`) और इसके बजाय उसे push करें।"
+    }
+  }
+}
+```
+
+---
+
+### `warn-git-amend`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** `git commit --amend` चलाते समय Claude को सावधानीपूर्वक आगे बढ़ने का निर्देश देता है। कमांड को ब्लॉक नहीं करता।
+
+कोई पैरामीटर नहीं।
+
+---
+
+### `warn-git-stash-drop`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** Claude को `git stash drop` चलाने से पहले पुष्टि करने का निर्देश देता है। कमांड को ब्लॉक नहीं करता।
+
+कोई पैरामीटर नहीं।
+
+---
+
+### `warn-all-files-staged`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** Claude को समीक्षा करने का निर्देश देता है कि जब यह `git add -A` या `git add .` चलाता है तो क्या stage कर रहा है। कमांड को ब्लॉक नहीं करता।
+
+कोई पैरामीटर नहीं।
+
+---
+
+## डेटाबेस
+
+destructive SQL operations को database के विरुद्ध निष्पादित होने से पहले पकड़ें।
+
+### `warn-destructive-sql`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** Claude को `DROP TABLE`, `DROP DATABASE`, या `WHERE` खंड के बिना `DELETE` युक्त SQL चलाने से पहले पुष्टि करने का निर्देश देता है।
+
+कोई पैरामीटर नहीं।
+
+---
+
+### `warn-schema-alteration`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** Claude को `ALTER TABLE` statements चलाने से पहले पुष्टि करने का निर्देश देता है।
+
+कोई पैरामीटर नहीं।
+
+---
+
+## चेतावनियाँ
+
+एजेंट को संभावित रूप से जोखिम भरे लेकिन non-destructive operations से पहले अतिरिक्त संदर्भ दें।
+
+### `warn-large-file-write`
+
+**इवेंट:** PreToolUse (Write)  
+**डिफ़ॉल्ट:** Claude को 1024 KB से बड़ी फ़ाइलें लिखने से पहले पुष्टि करने का निर्देश देता है।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `thresholdKb` | `number` | `1024` | फ़ाइल आकार threshold (kilobytes में) जिससे ऊपर चेतावनी दी जाती है। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "warn-large-file-write": {
+      "thresholdKb": 256
+    }
+  }
+}
+```
+
+<Note>
+हुक हैंडलर payloads पर 1 MB stdin limit लागू करता है। इस पॉलिसी को छोटी सामग्री के साथ परीक्षण करने के लिए, `thresholdKb` को 1024 से बहुत कम value पर सेट करें।
+</Note>
+
+---
+
+### `warn-package-publish`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** Claude को `npm publish` चलाने से पहले पुष्टि करने का निर्देश देता है।
+
+कोई पैरामीटर नहीं।
+
+---
+
+### `warn-background-process`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** Claude को `nohup`, `&`, `disown`, या `screen` के माध्यम से background processes लॉन्च करते समय सावधान रहने का निर्देश देता है।
+
+कोई पैरामीटर नहीं।
+
+---
+
+### `warn-global-package-install`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** Claude को `npm install -g`, `yarn global add`, या virtual environment के बिना `pip install` चलाने से पहले पुष्टि करने का निर्देश देता है।
+
+कोई पैरामीटर नहीं।
+
+---
+
+## पैकेज मैनेजर
+
+एजेंट को किस पैकेज मैनेजर का उपयोग करने की अनुमति है यह लागू करें।
+
+### `prefer-package-manager`
+
+**इवेंट:** PreToolUse (Bash)  
+**डिफ़ॉल्ट:** अक्षम। सक्षम होने पर, किसी भी पैकेज मैनेजर कमांड को ब्लॉक करता है जो `allowed` सूची में नहीं है और Claude को अनुमत मैनेजर का उपयोग करके कमांड को फिर से लिखने के लिए कहता है।
+
+पाता है: pip, pip3, python -m pip, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo।
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-----------|------|---------|-------------|
+| `allowed` | string[] | `[]` | अनुमत पैकेज मैनेजर नाम। इस सूची में नहीं कोई भी पाया गया मैनेजर ब्लॉक किया जाता है। जब खाली हो, पॉलिसी कोई संचालन नहीं करती। |
+| `blocked` | string[] | `[]` | built-in सूची से परे ब्लॉक करने के लिए अतिरिक्त मैनेजर नाम (उदा. `['pdm', 'pipx']`)। |
+
+Built-in ब्लॉक सूची कवर करती है: pip, pip3, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo। इस सूची में न पाए जाने वाले मैनेजर जोड़ने के लिए `blocked` का उपयोग करें।
+
+**उदाहरण कॉन्फ़िगरेशन:**
+
+```json
+{
+  "enabledPolicies": ["prefer-package-manager"],
+  "policyParams": {
+    "prefer-package-manager": {
+      "allowed": ["uv", "bun"],
+      "blocked": ["pdm", "pipx"]
+    }
+  }
+}
+```
+
+इस कॉन्फ़िग के साथ, `pip install flask` और `pdm install flask` दोनों नकार दिए जाते हैं Claude को बताते हुए कि `uv` या `bun` का उपयोग करें। `uv pip install flask` जैसी कमांड अनुमत हैं क्योंकि `uv` allowlist में है और पहले जाँचा जाता है।
+
+---
+
+## AI व्यवहार
+
+एजेंट को stuck होने या अप्रत्याशित व्यवहार करने के समय पहचानें।
+
+### `warn-repeated-tool-calls`
+
+**इवेंट:** PreToolUse (सभी टूल्स)  
+**डिफ़ॉल्ट:** Claude को reconsider करने का निर्देश देता है जब एक ही टूल समान parameters के साथ 3+ बार कॉल किया जाता है — एक सामान्य संकेत कि एजेंट loop में फँसा है।
+
+कोई पैरामीटर नहीं।
+
+---
+
+## वर्कफ़्लो
+
+एक अनुशासित end-of-session वर्कफ़्लो लागू करें। ये पॉलिसीज़ **Stop** इवेंट पर काम करती हैं और एजेंट को रोकते हैं जब तक प्रत्येक शर्त पूरी न हो। वे एक प्राकृतिक dependency chain का पालन करते हैं: commit → push → PR → CI। यदि कोई पॉलिसी नकार करती है, chain में बाद की पॉलिसीज़ छोड़ दी जाती हैं (deny short-circuits)।
+
+सभी वर्कफ़्लो पॉलिसीज़ **fail-open** हैं: यदि आवश्यक टूल उपलब्ध नहीं है (उदा. `gh` installed नहीं, कोई git remote नहीं), पॉलिसी informational संदेश के साथ allow करती है यह समझाते हुए कि check को skip क्यों किया गया।
+
+### Per-CLI Stop semantics
+
+Stop enforcement छह समर्थित CLIs में अलग-अलग दिखता है क्योंकि प्रत्येक एक अलग "agent finished" hook contract expose करता है। **outcome** समान है — एजेंट workflow gate fail होने पर stop नहीं हो सकता — लेकिन **mechanics** अलग हैं। नीचे की तालिका सारांशित करती है; केवल Pi के पास एक उपयोगकर्ता-दृश्यमान quirk है `require-*-before-stop` पॉलिसी सक्षम करने से पहले समझने योग्य।
+
+| CLI | Gate कब fires करता है | आप क्या देखते हैं |
+|---|---|---|
+| Claude Code | समान एजेंट loop, तुरंत | Claude काम करना जारी रखता है — समस्या को ठीक करता है, फिर फिर से समाप्त करने का प्रयास करता है। आपको कोई interruption दिखाई नहीं देता। |
+| Codex | समान एजेंट loop, तुरंत | Claude की तरह ही। |
+| GitHub Copilot CLI | समान एजेंट loop, तुरंत | Claude की तरह ही (Copilot के `{decision:"block", reason}` retry channel का उपयोग करता है — Copilot CLI 1.0.41 के विरुद्ध empirically verified)। |
+| Cursor Agent | समान एजेंट loop, तुरंत | Claude की तरह ही (Cursor के `{followup_message}` channel का उपयोग करता है — `loop_limit` पर capped, default 5 retries)। |
+| OpenCode | समान एजेंट loop, तुरंत | Claude की तरह ही (OpenCode के `client.session.prompt(...)` SDK कॉल का उपयोग करता है `hookSpecificOutput.additionalContext` के माध्यम से routed)। |
+| **Pi (pi-coding-agent)** | **अगली user turn** | **Pi visibly stops** जब gate fires — इसके एजेंट loop exit करते हैं और आप prompt पर लौटते हैं। Gate फिर अगली बार काम करता है जब आप एक prompt submit करते हैं: failproofai इस turn के system prompt में `MANDATORY ACTION REQUIRED` निर्देश prepend करता है, LLM को निर्देश देता है कि workflow step (commit, push, आदि) को complete करें इससे पहले कि आप जो कुछ भी पूछें। |
+
+<Note>
+**Pi limitation.** Pi की `AgentEndEvent` (Claude के `Stop` हुक के upstream equivalent) का कोई Result प्रकार नहीं है — जब तक यह fires होता है, Pi का एजेंट loop पहले से ही exit हो गया है। Pi को Claude / Copilot / Cursor / OpenCode की तरह एक ही loop को retry करने के लिए बाध्य नहीं किया जा सकता। failproofai gate को Pi के `before_agent_start` इवेंट (जो अगली user prompt के बाद fires होता है) में shift करता है ताकि workflow check अभी भी लागू हो, बस वर्तमान की बजाय अगली turn पर।
+
+**इसका व्यावहारिक अर्थ क्या है:**
+
+- Pi stop करने के बाद, deny reason को Pi session id द्वारा keyed in-memory में capture किया जाता है। आप same Pi process में जो भी अगला prompt submit करते हैं वह इसे drain करता है: LLM अपने system prompt के top पर `MANDATORY ACTION REQUIRED` निर्देश देखता है, commit करता है (या push / PR खोलता / CI के लिए waits करता है), और केवल तब आपके request के साथ continue करता है। Captured deny reason one-shot है — एक बार drain होने के बाद, gate स्पष्ट है।
+- Gate Pi के process lifetime से bounded है। यदि आप turns के बीच Pi को `Ctrl+C` करते हैं या quit करते हैं, in-memory entry process के साथ dropped होती है और gate missed हो जाता है। Claude, Copilot, Cursor, और OpenCode का same bound है (agent को kill करो और gate miss हो जाता है) — Pi बस इसे अधिक दृश्यमान बनाता है क्योंकि agent visibly exit करता है gate के पहले।
+- एक pending deny भी clear हो जाती है `session_shutdown` पर किसी भी कारण से (`new` / `resume` / `fork` / `quit`), तो prior session से एक stale gate same Pi process में शुरू की गई fresh session में leak नहीं कर सकता।
+
+यदि आपको Claude-शैली same-loop retry की आवश्यकता है, अन्य पाँच समर्थित CLIs में से किसी के तहत अपनी `Stop` पॉलिसीज़ चलाएँ। हम Pi को track कर रहे हैं upstream के लिए एक future Result प्रकार `AgentEndEvent` पर जो हमें इस gap को बंद करने देगा।
+</Note>
+
+### `require-commit-before-stop`
+
+**इवेंट:** Stop  
+**डिफ़ॉल्ट:** uncommitted changes (modified, staged, या untracked फ़ाइलें) होने पर stop को नकारता है। कार्य निर्देशिका clean होने पर informational संदेश लौटाता है।
+
+कोई पैरामीटर नहीं।
+
+---
+
+### `require-push-before-stop`
+
+**इवेंट:** Stop  
+**डिफ़ॉल्ट:** unpushed commits होने पर या जब वर्तमान ब्रांच के पास कोई remote tracking branch न हो तो stop को नकारता है। यदि आवश्यक हो तो `git push -u` का उपयोग करके एक tracking branch बनाने का सुझाव देता है। यदि कोई remote configured न हो तो fail open होता है।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `remote` | `string` | `"origin"` | Push करने के लिए remote नाम। |
+
+**उदाहरण:**
+
+```json
+{
+  "policyParams": {
+    "require-push-before-stop": {
+      "remote": "upstream"
+    }
+  }
+}
+```
+
+---
+
+### `require-pr-before-stop`
+
+**इवेंट:** Stop  
+**डिफ़ॉल्ट:** जब वर्तमान ब्रांच के लिए कोई pull request मौजूद न हो, या जब existing PR को merge किए बिना बंद किया जाए तो stop को नकारता है। Claude को `gh pr create` के साथ एक PR बनाने का निर्देश देता है। जब PR **merged** हो, पॉलिसी allow करती है (काम ship हो गया) और संदेश ब्रांच को switch off करने का संकेत देता है (`git checkout main && git pull`)।
+
+कोई पैरामीटर नहीं।
+
+<Note>
+इस पॉलिसी के लिए [GitHub CLI](https://cli.github.com/) (`gh`) को install और authenticate किया जाना आवश्यक है।
+`gh auth login` को एक personal access token के साथ चलाएँ जिसमें pull requests के read access के लिए `repo` scope हो। यदि `gh` install नहीं है या authenticate नहीं है, पॉलिसी fail open होती है और reason को Claude को report करती है।
+</Note>
+
+---
+
+### `require-no-conflicts-before-stop`
+
+**इवेंट:** Stop  
+**डिफ़ॉल्ट:** जब वर्तमान ब्रांच base branch में cleanly merge नहीं हो सकता तो stop को नकारता है। पॉलिसी पहले confirm करती है कि ब्रांच के लिए GitHub पर एक `OPEN` PR मौजूद है — बिना उसके, कोई merge target नहीं है enforce करने के लिए, तो पूरी पॉलिसी short-circuit करके allow करती है। एक बार `OPEN` PR confirm होने के बाद, दो independent probes चलते हैं:
+
+1. **Local** — `git merge-tree --write-tree --name-only origin/<baseBranch> HEAD`। Conflict पर, deny संदेश conflicted फ़ाइलों को नाम देता है ताकि Claude को ठीक करने के लिए क्या है यह पता हो।
+2. **GitHub** — `gh pr view --json mergeable,state` result को reuse करता है जो पहले से precheck में fetch किया गया है। Conflicts को पकड़ता है जो एक stale local `origin/<baseBranch>` miss करेगा (उदा. कोई conflicting PR को land किया `main` पर last fetch के बाद)। `CONFLICTING` result नकार करता है। `UNKNOWN` result भी नकार करता है और Claude को ~10 सेकंड wait करने और stop से पहले re-check करने का निर्देश देता है — यह false negatives को रोकता है जबकि GitHub recompute करता है।
+
+Skip करता है entirely (allow करता है) जब: `gh` install नहीं है, ब्रांच के लिए कोई PR मौजूद नहीं है, PR की state `OPEN` नहीं है (उदा. `MERGED`, `CLOSED`), या `gh pr view` unparseable आउटपुट लौटाता है। भी fail open होता है जब `origin/<baseBranch>` locally missing है या जब कोई commits base से आगे नहीं हैं — वो Layer 1 fall-throughs अभी भी allow करने से पहले cached PR mergeability को consult करते हैं।
+
+**पैरामीटर:**
+
+| पैरामीटर | प्रकार | डिफ़ॉल्ट | विवरण |
+|-------|------|---------|-------------|
+| `baseBranch` | `string` | `"main"` | Conflicts के लिए check करने के लिए base branch। |
+
+<Note>
+इस पॉलिसी के लिए GitHub CLI (`gh`) required है। पॉलिसी किसी भी conflict probe चलाने से पहले confirm करने के लिए `gh pr view` का उपयोग करती है कि एक `OPEN` PR मौजूद है — बिना `gh` के, पॉलिसी short-circuit करके allow करती है। `gh auth login` को एक personal access token के साथ चलाएँ जिसमें pull requests के read access के लिए `repo` scope हो।
+</Note>
+
+---
+
+### `require-ci-green-before-stop`
+
+**इवेंट:** Stop  
+**डिफ़ॉल्ट:** जब वर्तमान ब्रांच पर CI checks fail या run कर रहे हों तो stop को नकारता है। GitHub Actions workflow runs और third-party bot checks दोनों को check करता है (उदा. CodeRabbit, SonarCloud, Codecov)। `skipped`, `cancelled`, और `neutral` conclusions को non-failing के रूप में मानता है (latter cover करता है उदा. Socket Security alerts on outside contributor PRs, जहाँ app intentionally neutral rather than success/failure को report करता है)। सभी checks pass होने पर informational संदेश लौटाता है।
+
+कोई पैरामीटर नहीं।
+
+<Note>
+इस पॉलिसी के लिए [GitHub CLI](https://cli.github.com/) (`gh`) को install और authenticate किया जाना आवश्यक है।
+`gh auth login` को एक personal access token के साथ चलाएँ जिसमें Actions workflow runs और Checks API के read access के लिए `repo` scope हो। यदि `gh` install नहीं है या authenticate नहीं है, पॉलिसी fail open होती है और reason को report करती है।
+</Note>
+
+---
+
+---
+
+## व्यक्तिगत पॉलिसीज़ को अक्षम करना
+
+अपने कॉन्फ़िग में `enabledPolicies` से एक विशिष्ट पॉलिसी को हटाएँ, या dashboard के Policies tab में इसे toggle off करें।
+
+```json
+{
+  "enabledPolicies": [
+    "block-rm-rf",
+    "sanitize-api-keys"
+  ]
+}
+```
+
+`enabledPolicies` में सूचीबद्ध नहीं पॉलिसीज़ run नहीं होती, भले ही `policyParams` entries उनके लिए मौजूद हों।