failproofai 0.0.6-beta.2 → 0.0.6-beta.4

package/.next/standalone/docs/hi/cli/install-policies.mdx

@@ -1,47 +0,0 @@
----
-title: नीतियों को इंस्टॉल करें
-description: "नीतियों को सक्षम करें ताकि वे हर agent tool call पर चलें"
----
-
-```bash
-failproofai policies --install [policy-names...] [options]
-```
-
-Claude Code के `settings.json` में hook entries लिखता है ताकि failproofai tool calls को intercept कर सके।
-
-उपनाम: `failproofai p -i`
-
-## विकल्प
-
-| Flag | विवरण |
-|------|-------------|
-| `--scope user` | `~/.claude/settings.json` में इंस्टॉल करें (डिफ़ॉल्ट - सभी सत्र) |
-| `--scope project` | वर्तमान निर्देशिका में `.claude/settings.json` में इंस्टॉल करें |
-| `--scope local` | वर्तमान निर्देशिका में `.claude/settings.local.json` में इंस्टॉल करें |
-| `--custom <path>` / `-c` | कस्टम hook policies वाली JS फाइल का पाथ |
-
-## व्यवहार
-
-- **कोई नीति नाम नहीं** - नीतियों का चयन करने के लिए एक इंटरैक्टिव prompt खोलता है
-- **विशिष्ट नाम** - उन नीतियों को सक्षम करता है (पहले से सक्षम किए गए किसी भी नीति में जोड़ा जाता है)
-- **`all`** - हर उपलब्ध नीति को सक्षम करता है
-
-इंस्टॉलेशन additive है: `--install` को फिर से चलाने से नई नीतियां जोड़ी जाती हैं बिना मौजूदा नीतियों को हटाए।
-
-## उदाहरण
-
-```bash
-# सभी डिफ़ॉल्ट नीतियों को विश्व स्तर पर इंस्टॉल करें (इंटरैक्टिव)
-failproofai policies --install
-
-# वर्तमान प्रोजेक्ट के लिए विशिष्ट नीतियों को इंस्टॉल करें
-failproofai policies --install block-sudo sanitize-api-keys --scope project
-
-# एक बार में सभी नीतियों को सक्षम करें
-failproofai policies --install all
-
-# कस्टम policies फाइल के साथ इंस्टॉल करें
-failproofai policies --install --custom ./my-policies.js
-```
-
-जब `--custom <path>` प्रदान किया जाता है, तो फाइल तुरंत सत्यापित की जाती है - इसे कम से कम एक बार `customPolicies.add()` को कॉल करना चाहिए। Resolved पाथ `policies-config.json` में `customPoliciesPath` के रूप में सहेजा जाता है।

package/.next/standalone/docs/hi/cli/list-policies.mdx

@@ -1,31 +0,0 @@
----
-title: नीतियों की सूची
-description: "देखें कि कौन सी नीतियां सक्षम हैं, उनके पैरामीटर और कस्टम नीतियां"
----
-
-```bash
-failproofai policies
-```
-
-सभी नीतियों को उनकी स्थिति, कॉन्फ़िगर किए गए पैरामीटर और कस्टम नीतियों के साथ दिखाता है।
-
-## नमूना आउटपुट
-
-```text
-Failproof AI Hook Policies (user)
-
-  Status  Name                          Description
-  ──────  ──────────────────────────────────────────────────────────────
-  ✓       block-sudo                    Block sudo commands
-            allowPatterns: ["sudo systemctl status"]
-  ✓       block-rm-rf                   Block recursive deletions
-  ✗       block-curl-pipe-sh            Block curl|bash patterns
-  ✓       sanitize-api-keys             Redact API keys from output
-            additionalPatterns: [{ regex: "MY_TOKEN_...", label: "..." }]
-
-  ── Custom Policies (/home/alice/myproject/my-policies.js) ──────────────
-  ✓       require-jira-ticket           Block commits without ticket
-  ✓       approval-gate                 Approval gate for destructive ops
-```
-
-`policyParams` में अज्ञात कुंजियों को यहां फ़्लैग किया जाता है ताकि आप टाइपो को जल्दी पकड़ सकें।

package/.next/standalone/docs/hi/cli/remove-policies.mdx

@@ -1,43 +0,0 @@
----
-title: नीतियों को अनइंस्टॉल करें
-description: "Claude Code की सेटिंग्स से हुक एंट्रीज़ को हटाएं"
----
-
-```bash
-failproofai policies --uninstall [policy-names...] [options]
-```
-
-Claude Code की `settings.json` से failproofai हुक एंट्रीज़ को हटाता है।
-
-उपनाम: `failproofai p -u`
-
-## विकल्प
-
-| फ्लैग | विवरण |
-|------|-------------|
-| `--scope user` | वैश्विक सेटिंग्स से हटाएं (डिफ़ॉल्ट) |
-| `--scope project` | प्रोजेक्ट सेटिंग्स से हटाएं |
-| `--scope local` | स्थानीय सेटिंग्स से हटाएं |
-| `--scope all` | सभी स्कोप्स से एक साथ हटाएं |
-| `--custom` / `-c` | कॉन्फ़िग से `customPoliciesPath` को साफ़ करें |
-
-## व्यवहार
-
-- **कोई नीति का नाम नहीं** - सेटिंग्स फाइल से सभी failproofai हुक एंट्रीज़ को हटाता है
-- **विशिष्ट नाम** - उन नीतियों को अक्षम करता है लेकिन हुक्स इंस्टॉल रखता है
-
-## उदाहरण
-
-```bash
-# सभी हुक्स को वैश्विक रूप से हटाएं
-failproofai policies --uninstall
-
-# एक विशिष्ट नीति को अक्षम करें (हुक्स इंस्टॉल रखता है)
-failproofai policies --uninstall block-sudo
-
-# हर स्कोप से हुक्स को हटाएं
-failproofai policies --uninstall --scope all
-
-# कस्टम नीतियों का पथ साफ़ करें
-failproofai policies --uninstall --custom
-```

package/.next/standalone/docs/hi/cli/version.mdx

@@ -1,12 +0,0 @@
----
-title: संस्करण की जांच करें
-description: "स्थापित failproofai संस्करण को प्रिंट करें"
----
-
-```bash
-failproofai --version
-# or
-failproofai -v
-```
-
-स्थापित संस्करण संख्या को प्रिंट करता है।

package/.next/standalone/docs/hi/configuration.mdx

@@ -1,222 +0,0 @@
----
-title: कॉन्फ़िगरेशन
-description: "कॉन्फ़िग फाइल प्रारूप, तीन-स्कोप सिस्टम, और मर्ज नियम"
-icon: gear
----
-
-failproofai JSON कॉन्फ़िगरेशन फाइलों का उपयोग करता है यह नियंत्रित करने के लिए कि कौन सी नीतियां सक्रिय हैं, वे कैसे व्यवहार करती हैं, और कस्टम नीतियां कहां से लोड की जाती हैं। कॉन्फ़िगरेशन आपकी टीम के साथ साझा करना आसान बनाने के लिए डिज़ाइन किया गया है - इसे आपके रिपॉजिटरी में कमिट करें और हर डेवलपर को एक ही एजेंट सेफ्टी नेट मिलता है।
-
----
-
-## कॉन्फ़िगरेशन स्कोप
-
-तीन कॉन्फ़िगरेशन स्कोप हैं, प्राथमिकता क्रम में मूल्यांकन किए गए:
-
-| स्कोप | फाइल पथ | उद्देश्य |
-|-------|-----------|---------|
-| **project** | `.failproofai/policies-config.json` | प्रति-रिपॉजिटरी सेटिंग्स, संस्करण नियंत्रण के लिए कमिट की गई |
-| **local** | `.failproofai/policies-config.local.json` | व्यक्तिगत प्रति-रिपॉजिटरी ओवरराइड, gitignored |
-| **global** | `~/.failproofai/policies-config.json` | सभी प्रोजेक्ट्स में उपयोगकर्ता-स्तर की डिफ़ॉल्ट सेटिंग्स |
-
-जब failproofai को एक हुक इवेंट प्राप्त होता है, तो यह वर्तमान कार्य निर्देशिका के लिए सभी तीन फाइलों को लोड और मर्ज करता है।
-
-### मर्ज नियम
-
-**`enabledPolicies`** - सभी तीन स्कोप का संघ। कोई भी नीति जो किसी भी स्तर पर सक्षम है, सक्रिय है।
-
-```text
-project:  ["block-sudo"]
-local:    ["block-rm-rf"]
-global:   ["block-sudo", "sanitize-api-keys"]
-
-resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← deduplicated union
-```
-
-**`policyParams`** - पहला स्कोप जो किसी दी गई नीति के लिए पैरामीटर परिभाषित करता है, पूरी तरह से जीत जाता है। नीति के पैरामीटर के भीतर कोई गहरा मर्जिंग नहीं होता है।
-
-```text
-project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo apt-get update"] }   ← project wins, global ignored
-```
-
-```text
-project:  (no block-sudo entry)
-local:    (no block-sudo entry)
-global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
-
-resolved: { allowPatterns: ["sudo systemctl status"] }  ← falls through to global
-```
-
-**`customPoliciesPath`** - पहला स्कोप जो इसे परिभाषित करता है, जीत जाता है।
-
-**`llm`** - पहला स्कोप जो इसे परिभाषित करता है, जीत जाता है।
-
----
-
-## कॉन्फ़िग फाइल प्रारूप
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "sanitize-jwt",
-    "block-env-files",
-    "block-read-outside-cwd"
-  ],
-  "policyParams": {
-    "block-sudo": {
-      "allowPatterns": ["sudo systemctl status", "sudo journalctl"]
-    },
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "prod"]
-    },
-    "block-rm-rf": {
-      "allowPaths": ["/tmp"]
-    },
-    "block-read-outside-cwd": {
-      "allowPaths": ["/shared/data", "/opt/company"]
-    },
-    "sanitize-api-keys": {
-      "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
-      ]
-    },
-    "warn-large-file-write": {
-      "thresholdKb": 512
-    }
-  },
-  "customPoliciesPath": "/home/alice/myproject/my-policies.js"
-}
-```
-
----
-
-## फील्ड संदर्भ
-
-### `enabledPolicies`
-
-प्रकार: `string[]`
-
-सक्षम करने के लिए नीति के नामों की सूची। नाम `failproofai policies` द्वारा दिखाई गई नीति पहचानकर्ता से बिल्कुल मेल खाना चाहिए। पूरी सूची के लिए [Built-in Policies](/hi/built-in-policies) देखें।
-
-`enabledPolicies` में न होने वाली नीतियां निष्क्रिय हैं, भले ही उनके पास `policyParams` में प्रविष्टियां हों।
-
-### `policyParams`
-
-प्रकार: `Record<string, Record<string, unknown>>`
-
-प्रति-नीति पैरामीटर ओवरराइड। बाहरी कुंजी नीति का नाम है; आंतरिक कुंजियां नीति-विशिष्ट हैं। प्रत्येक नीति [Built-in Policies](/hi/built-in-policies) में अपने उपलब्ध पैरामीटर का दस्तावेज़ देती है।
-
-यदि किसी नीति के पास पैरामीटर हैं लेकिन आप उन्हें निर्दिष्ट नहीं करते हैं, तो नीति की बिल्ट-इन डिफ़ॉल्ट का उपयोग किया जाता है। जो उपयोगकर्ता `policyParams` को बिल्कुल भी कॉन्फ़िगर नहीं करते हैं, वे पिछले संस्करणों के समान व्यवहार प्राप्त करते हैं।
-
-नीति के पैरामीटर ब्लॉक के अंदर अज्ञात कुंजियां हुक-फायर समय पर चुप्पी से अनदेखी की जाती हैं लेकिन जब आप `failproofai policies` चलाते हैं तो चेतावनी के रूप में फ़्लैग की जाती हैं।
-
-#### `hint` (cross-cutting)
-
-प्रकार: `string` (वैकल्पिक)
-
-एक संदेश जो कारण में जोड़ा जाता है जब कोई नीति `deny` या `instruct` देता है। इसका उपयोग Claude को कार्रवाई योग्य मार्गदर्शन देने के लिए करें, बिना नीति को स्वयं संशोधित किए।
-
-किसी भी नीति प्रकार के साथ काम करता है — बिल्ट-इन, कस्टम (`custom/`), प्रोजेक्ट सम्मेलन (`.failproofai-project/`), या उपयोगकर्ता सम्मेलन (`.failproofai-user/`)।
-
-```json
-{
-  "policyParams": {
-    "block-force-push": {
-      "hint": "Try creating a fresh branch instead."
-    },
-    "block-sudo": {
-      "allowPatterns": ["sudo apt-get"],
-      "hint": "Use apt-get directly without sudo."
-    },
-    "custom/my-policy": {
-      "hint": "Ask the user for approval first."
-    }
-  }
-}
-```
-
-जब `block-force-push` इनकार करता है, तो Claude देखता है: *"Force-pushing is blocked. Try creating a fresh branch instead."*
-
-गैर-स्ट्रिंग मान और खाली स्ट्रिंग्स चुप्पी से अनदेखी की जाती हैं। यदि `hint` सेट नहीं है, तो व्यवहार अपरिवर्तित है (पिछड़े-संगत)।
-
-### `customPoliciesPath`
-
-प्रकार: `string` (पूर्ण पथ)
-
-कस्टम हुक नीतियों वाली JavaScript फाइल का पथ। यह `failproofai policies --install --custom <path>` द्वारा स्वचालित रूप से सेट किया जाता है (पथ को स्टोर करने से पहले निरपेक्ष में हल किया जाता है)।
-
-फाइल हर हुक इवेंट पर ताज़ी लोड की जाती है - कोई कैशिंग नहीं है। लेखन विवरण के लिए [Custom Policies](/hi/custom-policies) देखें।
-
-### सम्मेलन-आधारित नीतियां
-
-स्पष्ट `customPoliciesPath` के अलावा, failproofai `.failproofai/policies/` निर्देशिकाओं से नीति फाइलें स्वचालित रूप से खोजता और लोड करता है:
-
-| स्तर | निर्देशिका | स्कोप |
-|-------|-----------|-------|
-| Project | `.failproofai/policies/` | संस्करण नियंत्रण के माध्यम से टीम के साथ साझा किया गया |
-| User | `~/.failproofai/policies/` | व्यक्तिगत, सभी प्रोजेक्ट्स पर लागू होता है |
-
-**फाइल मिलान:** केवल `*policies.{js,mjs,ts}` से मेल खाने वाली फाइलें लोड की जाती हैं (जैसे `security-policies.mjs`, `workflow-policies.js`)। निर्देशिका में अन्य फाइलें अनदेखी की जाती हैं।
-
-**कोई कॉन्फ़िगरेशन आवश्यक नहीं:** सम्मेलन नीतियों के लिए `policies-config.json` में कोई प्रविष्टियां आवश्यक नहीं हैं। बस निर्देशिका में फाइलें डालें और वे अगली हुक इवेंट पर उठाई जाएंगी।
-
-**संघ लोडिंग:** प्रोजेक्ट और उपयोगकर्ता दोनों सम्मेलन निर्देशिकाओं को स्कैन किया जाता है। दोनों स्तरों से सभी मेल खाने वाली फाइलें लोड की जाती हैं (`customPoliciesPath` के विपरीत जो पहली-स्कोप-जीत का उपयोग करता है)।
-
-अधिक विवरण और उदाहरणों के लिए [Custom Policies](/hi/custom-policies) देखें।
-
-### `llm`
-
-प्रकार: `object` (वैकल्पिक)
-
-AI कॉल करने वाली नीतियों के लिए LLM क्लाइंट कॉन्फ़िगरेशन। अधिकांश सेटअप के लिए आवश्यक नहीं है।
-
-```json
-{
-  "llm": {
-    "model": "claude-sonnet-4-6",
-    "apiKey": "sk-ant-..."
-  }
-}
-```
-
----
-
-## CLI से कॉन्फ़िगरेशन प्रबंधित करना
-
-`policies --install` और `policies --uninstall` कमांड Claude Code के `settings.json` (हुक प्रविष्टि बिंदु) में लिखते हैं, जबकि `policies-config.json` वह फाइल है जिसे आप सीधे प्रबंधित करते हैं। दोनों अलग हैं:
-
-- **`settings.json`** - Claude Code को हर टूल यूज पर `failproofai --hook <event>` को कॉल करने के लिए बताता है
-- **`policies-config.json`** - failproofai को बताता है कि कौन सी नीतियों का मूल्यांकन करना है और किन पैरामीटर के साथ
-
-आप किसी भी समय `policies-config.json` को सीधे संपादित कर सकते हैं; परिवर्तन पुनः आरंभ की आवश्यकता के बिना अगली हुक इवेंट पर तुरंत प्रभावी होते हैं।
-
----
-
-## उदाहरण: टीम डिफ़ॉल्ट्स के साथ प्रोजेक्ट-स्तर का कॉन्फ़िगरेशन
-
-`.failproofai/policies-config.json` को अपने रिपॉजिटरी में कमिट करें:
-
-```json
-{
-  "enabledPolicies": [
-    "block-sudo",
-    "block-rm-rf",
-    "block-push-master",
-    "sanitize-api-keys",
-    "block-env-files"
-  ],
-  "policyParams": {
-    "block-push-master": {
-      "protectedBranches": ["main", "release", "hotfix"]
-    }
-  }
-}
-```
-
-प्रत्येक डेवलपर फिर व्यक्तिगत ओवरराइड के लिए `.failproofai/policies-config.local.json` (gitignored) बना सकता है, बिना टीममेट्स को प्रभावित किए।