failproofai 0.0.5 → 0.0.6-beta.0

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

@@ -1,10 +1,10 @@
 ---
 title: कॉन्फ़िगरेशन
-description: "कॉन्फ़िग फ़ाइल प्रारूप, तीन-स्कोप सिस्टम, और विलय नियम"
+description: "कॉन्फ़िग फाइल प्रारूप, तीन-स्कोप सिस्टम, और मर्ज नियम"
 icon: gear
 ---
 
-failproofai JSON कॉन्फ़िगरेशन फ़ाइलों का उपयोग करके यह नियंत्रित करता है कि कौन सी नीतियां सक्रिय हैं, वे कैसे व्यवहार करती हैं, और कस्टम नीतियां कहां से लोड की जाती हैं। कॉन्फ़िगरेशन को आपकी टीम के साथ साझा करना आसान बनाया गया है - इसे अपने रिपॉजिटरी में कमिट करें और हर डेवलपर को एक ही एजेंट सुरक्षा नेट मिलेगा।
+failproofai JSON कॉन्फ़िगरेशन फाइलों का उपयोग करता है यह नियंत्रित करने के लिए कि कौन सी नीतियां सक्रिय हैं, वे कैसे व्यवहार करती हैं, और कस्टम नीतियां कहां से लोड की जाती हैं। कॉन्फ़िगरेशन आपकी टीम के साथ साझा करना आसान बनाने के लिए डिज़ाइन किया गया है - इसे आपके रिपॉजिटरी में कमिट करें और हर डेवलपर को एक ही एजेंट सेफ्टी नेट मिलता है।
 
 ---
 
@@ -12,17 +12,17 @@ failproofai JSON कॉन्फ़िगरेशन फ़ाइलों क
 
 तीन कॉन्फ़िगरेशन स्कोप हैं, प्राथमिकता क्रम में मूल्यांकन किए गए:
 
-| स्कोप | फ़ाइल पथ | उद्देश्य |
+| स्कोप | फाइल पथ | उद्देश्य |
 |-------|-----------|---------|
-| **project** | `.failproofai/policies-config.json` | प्रति-रिपॉजिटरी सेटिंग्स, संस्करण नियंत्रण में कमिट की गई |
+| **project** | `.failproofai/policies-config.json` | प्रति-रिपॉजिटरी सेटिंग्स, संस्करण नियंत्रण के लिए कमिट की गई |
 | **local** | `.failproofai/policies-config.local.json` | व्यक्तिगत प्रति-रिपॉजिटरी ओवरराइड, gitignored |
-| **global** | `~/.failproofai/policies-config.json` | सभी परियोजनाओं में उपयोगकर्ता-स्तर की डिफ़ॉल्ट सेटिंग्स |
+| **global** | `~/.failproofai/policies-config.json` | सभी प्रोजेक्ट्स में उपयोगकर्ता-स्तर की डिफ़ॉल्ट सेटिंग्स |
 
-जब failproofai को एक हुक इवेंट प्राप्त होता है, तो यह वर्तमान कार्यशील निर्देशिका के लिए सभी तीन फ़ाइलों को लोड और विलय करता है।
+जब failproofai को एक हुक इवेंट प्राप्त होता है, तो यह वर्तमान कार्य निर्देशिका के लिए सभी तीन फाइलों को लोड और मर्ज करता है।
 
-### विलय नियम
+### मर्ज नियम
 
-**`enabledPolicies`** - सभी तीन स्कोप का संघ। किसी भी स्तर पर सक्षम की गई नीति सक्रिय है।
+**`enabledPolicies`** - सभी तीन स्कोप का संघ। कोई भी नीति जो किसी भी स्तर पर सक्षम है, सक्रिय है।
 
 ```text
 project:  ["block-sudo"]
@@ -32,7 +32,7 @@ global:   ["block-sudo", "sanitize-api-keys"]
 resolved: ["block-sudo", "block-rm-rf", "sanitize-api-keys"]  ← deduplicated union
 ```
 
-**`policyParams`** - किसी दिए गए नीति के लिए पैरामीटर को परिभाषित करने वाला पहला स्कोप पूरी तरह जीत जाता है। किसी नीति के पैरामीटर के भीतर मानों का कोई गहरा विलय नहीं है।
+**`policyParams`** - पहला स्कोप जो किसी दी गई नीति के लिए पैरामीटर परिभाषित करता है, पूरी तरह से जीत जाता है। नीति के पैरामीटर के भीतर कोई गहरा मर्जिंग नहीं होता है।
 
 ```text
 project:  block-sudo → { allowPatterns: ["sudo apt-get update"] }
@@ -49,13 +49,13 @@ global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
 resolved: { allowPatterns: ["sudo systemctl status"] }  ← falls through to global
 ```
 
-**`customPoliciesPath`** - इसे परिभाषित करने वाला पहला स्कोप जीतता है।
+**`customPoliciesPath`** - पहला स्कोप जो इसे परिभाषित करता है, जीत जाता है।
 
-**`llm`** - इसे परिभाषित करने वाला पहला स्कोप जीतता है।
+**`llm`** - पहला स्कोप जो इसे परिभाषित करता है, जीत जाता है।
 
 ---
 
-## कॉन्फ़िग फ़ाइल प्रारूप
+## कॉन्फ़िग फाइल प्रारूप
 
 ```json
 {
@@ -96,33 +96,33 @@ resolved: { allowPatterns: ["sudo systemctl status"] }  ← falls through to glo
 
 ---
 
-## फ़ील्ड संदर्भ
+## फील्ड संदर्भ
 
 ### `enabledPolicies`
 
 प्रकार: `string[]`
 
-सक्षम करने के लिए नीति नामों की सूची। नाम `failproofai policies` द्वारा दिखाए गए नीति पहचानकर्ताओं से बिल्कुल मेल खाने चाहिए। पूरी सूची के लिए [Built-in Policies](/hi/built-in-policies) देखें।
+सक्षम करने के लिए नीति के नामों की सूची। नाम `failproofai policies` द्वारा दिखाई गई नीति पहचानकर्ता से बिल्कुल मेल खाना चाहिए। पूरी सूची के लिए [Built-in Policies](/hi/built-in-policies) देखें।
 
-`enabledPolicies` में न होने वाली नीतियां निष्क्रिय हैं, भले ही `policyParams` में उनके प्रविष्टियां हों।
+`enabledPolicies` में न होने वाली नीतियां निष्क्रिय हैं, भले ही उनके पास `policyParams` में प्रविष्टियां हों।
 
 ### `policyParams`
 
 प्रकार: `Record<string, Record<string, unknown>>`
 
-प्रति-नीति पैरामीटर ओवरराइड। बाहरी कुंजी नीति का नाम है; आंतरिक कुंजियां नीति-विशिष्ट हैं। प्रत्येक नीति [Built-in Policies](/hi/built-in-policies) में अपने उपलब्ध पैरामीटर को दस्तावेज़ित करती है।
+प्रति-नीति पैरामीटर ओवरराइड। बाहरी कुंजी नीति का नाम है; आंतरिक कुंजियां नीति-विशिष्ट हैं। प्रत्येक नीति [Built-in Policies](/hi/built-in-policies) में अपने उपलब्ध पैरामीटर का दस्तावेज़ देती है।
 
-यदि किसी नीति के पैरामीटर हैं लेकिन आप उन्हें निर्दिष्ट नहीं करते हैं, तो नीति की बिल्ट-इन डिफ़ॉल्ट का उपयोग किया जाता है। जो उपयोगकर्ता `policyParams` को बिल्कुल कॉन्फ़िगर नहीं करते हैं उन्हें पिछले संस्करणों के समान व्यवहार मिलता है।
+यदि किसी नीति के पास पैरामीटर हैं लेकिन आप उन्हें निर्दिष्ट नहीं करते हैं, तो नीति की बिल्ट-इन डिफ़ॉल्ट का उपयोग किया जाता है। जो उपयोगकर्ता `policyParams` को बिल्कुल भी कॉन्फ़िगर नहीं करते हैं, वे पिछले संस्करणों के समान व्यवहार प्राप्त करते हैं।
 
-नीति के पैरामीटर ब्लॉक के अंदर अज्ञात कुंजियां हुक-फायर समय पर चुप्पी से अनदेखी की जाती हैं लेकिन जब आप `failproofai policies` चलाते हैं तो चेतावनी के रूप में फ्लैग की जाती हैं।
+नीति के पैरामीटर ब्लॉक के अंदर अज्ञात कुंजियां हुक-फायर समय पर चुप्पी से अनदेखी की जाती हैं लेकिन जब आप `failproofai policies` चलाते हैं तो चेतावनी के रूप में फ़्लैग की जाती हैं।
 
 #### `hint` (cross-cutting)
 
 प्रकार: `string` (वैकल्पिक)
 
-एक संदेश जो तब जोड़ा जाता है जब कोई नीति `deny` या `instruct` लौटाती है। इसे Claude को कार्रवाई योग्य मार्गदर्शन देने के लिए उपयोग करें बिना नीति को संशोधित किए।
+एक संदेश जो कारण में जोड़ा जाता है जब कोई नीति `deny` या `instruct` देता है। इसका उपयोग Claude को कार्रवाई योग्य मार्गदर्शन देने के लिए करें, बिना नीति को स्वयं संशोधित किए।
 
-किसी भी नीति प्रकार के साथ काम करता है — बिल्ट-इन, कस्टम (`custom/`), प्रोजेक्ट कन्वेंशन (`.failproofai-project/`), या उपयोगकर्ता कन्वेंशन (`.failproofai-user/`)।
+किसी भी नीति प्रकार के साथ काम करता है — बिल्ट-इन, कस्टम (`custom/`), प्रोजेक्ट सम्मेलन (`.failproofai-project/`), या उपयोगकर्ता सम्मेलन (`.failproofai-user/`)।
 
 ```json
 {
@@ -141,32 +141,32 @@ resolved: { allowPatterns: ["sudo systemctl status"] }  ← falls through to glo
 }
 ```
 
-जब `block-force-push` अस्वीकार करता है, Claude को यह दिखता है: *"Force-pushing is blocked. Try creating a fresh branch instead."*
+जब `block-force-push` इनकार करता है, तो Claude देखता है: *"Force-pushing is blocked. Try creating a fresh branch instead."*
 
-गैर-स्ट्रिंग मानों और खाली स्ट्रिंग को चुप्पी से अनदेखा किया जाता है। यदि `hint` सेट नहीं है, तो व्यवहार अपरिवर्तित है (पिछड़े-संगत)।
+गैर-स्ट्रिंग मान और खाली स्ट्रिंग्स चुप्पी से अनदेखी की जाती हैं। यदि `hint` सेट नहीं है, तो व्यवहार अपरिवर्तित है (पिछड़े-संगत)।
 
 ### `customPoliciesPath`
 
-प्रकार: `string` (निरपेक्ष पथ)
+प्रकार: `string` (पूर्ण पथ)
 
-कस्टम हुक नीतियों वाली JavaScript फ़ाइल का पथ। यह `failproofai policies --install --custom <path>` द्वारा स्वचालित रूप से सेट किया जाता है (पथ को संग्रहीत करने से पहले निरपेक्ष में हल किया जाता है)।
+कस्टम हुक नीतियों वाली JavaScript फाइल का पथ। यह `failproofai policies --install --custom <path>` द्वारा स्वचालित रूप से सेट किया जाता है (पथ को स्टोर करने से पहले निरपेक्ष में हल किया जाता है)।
 
-फ़ाइल प्रत्येक हुक इवेंट पर ताजी लोड की जाती है - कोई कैशिंग नहीं है। लेखन विवरण के लिए [Custom Policies](/hi/custom-policies) देखें।
+फाइल हर हुक इवेंट पर ताज़ी लोड की जाती है - कोई कैशिंग नहीं है। लेखन विवरण के लिए [Custom Policies](/hi/custom-policies) देखें।
 
-### कन्वेंशन-आधारित नीतियां
+### सम्मेलन-आधारित नीतियां
 
-स्पष्ट `customPoliciesPath` के अतिरिक्त, failproofai `.failproofai/policies/` निर्देशिकाओं से नीति फ़ाइलों को स्वचालित रूप से खोज निकालता है:
+स्पष्ट `customPoliciesPath` के अलावा, failproofai `.failproofai/policies/` निर्देशिकाओं से नीति फाइलें स्वचालित रूप से खोजता और लोड करता है:
 
 | स्तर | निर्देशिका | स्कोप |
 |-------|-----------|-------|
-| Project | `.failproofai/policies/` | टीम के साथ संस्करण नियंत्रण के माध्यम से साझा |
-| User | `~/.failproofai/policies/` | व्यक्तिगत, सभी परियोजनाओं पर लागू |
+| Project | `.failproofai/policies/` | संस्करण नियंत्रण के माध्यम से टीम के साथ साझा किया गया |
+| User | `~/.failproofai/policies/` | व्यक्तिगत, सभी प्रोजेक्ट्स पर लागू होता है |
 
-**फ़ाइल मिलान:** केवल `*policies.{js,mjs,ts}` से मेल खाने वाली फ़ाइलें लोड की जाती हैं (जैसे `security-policies.mjs`, `workflow-policies.js`)। निर्देशिका में अन्य फ़ाइलें अनदेखी की जाती हैं।
+**फाइल मिलान:** केवल `*policies.{js,mjs,ts}` से मेल खाने वाली फाइलें लोड की जाती हैं (जैसे `security-policies.mjs`, `workflow-policies.js`)। निर्देशिका में अन्य फाइलें अनदेखी की जाती हैं।
 
-**कोई कॉन्फ़िग आवश्यक नहीं:** कन्वेंशन नीतियों को `policies-config.json` में कोई प्रविष्टि की आवश्यकता नहीं है। केवल निर्देशिका में फ़ाइलें रखें और वे अगले हुक इवेंट पर चुन ली जाएंगी।
+**कोई कॉन्फ़िगरेशन आवश्यक नहीं:** सम्मेलन नीतियों के लिए `policies-config.json` में कोई प्रविष्टियां आवश्यक नहीं हैं। बस निर्देशिका में फाइलें डालें और वे अगली हुक इवेंट पर उठाई जाएंगी।
 
-**यूनियन लोडिंग:** प्रोजेक्ट और उपयोगकर्ता दोनों कन्वेंशन निर्देशिकाओं को स्कैन किया जाता है। दोनों स्तरों से सभी मेल खाने वाली फ़ाइलें लोड की जाती हैं (`customPoliciesPath` के विपरीत जो पहले-स्कोप-जीतता-है का उपयोग करता है)।
+**संघ लोडिंग:** प्रोजेक्ट और उपयोगकर्ता दोनों सम्मेलन निर्देशिकाओं को स्कैन किया जाता है। दोनों स्तरों से सभी मेल खाने वाली फाइलें लोड की जाती हैं (`customPoliciesPath` के विपरीत जो पहली-स्कोप-जीत का उपयोग करता है)।
 
 अधिक विवरण और उदाहरणों के लिए [Custom Policies](/hi/custom-policies) देखें।
 
@@ -174,7 +174,7 @@ resolved: { allowPatterns: ["sudo systemctl status"] }  ← falls through to glo
 
 प्रकार: `object` (वैकल्पिक)
 
-ऐसी नीतियों के लिए LLM क्लाइंट कॉन्फ़िगरेशन जो AI कॉल करती हैं। अधिकांश सेटअप के लिए आवश्यक नहीं है।
+AI कॉल करने वाली नीतियों के लिए LLM क्लाइंट कॉन्फ़िगरेशन। अधिकांश सेटअप के लिए आवश्यक नहीं है।
 
 ```json
 {
@@ -189,16 +189,16 @@ resolved: { allowPatterns: ["sudo systemctl status"] }  ← falls through to glo
 
 ## CLI से कॉन्फ़िगरेशन प्रबंधित करना
 
-`policies --install` और `policies --uninstall` कमांड Claude Code के `settings.json` (हुक प्रविष्टि बिंदु) में लिखते हैं, जबकि `policies-config.json` वह फ़ाइल है जिसे आप सीधे प्रबंधित करते हैं। ये दोनों अलग हैं:
+`policies --install` और `policies --uninstall` कमांड Claude Code के `settings.json` (हुक प्रविष्टि बिंदु) में लिखते हैं, जबकि `policies-config.json` वह फाइल है जिसे आप सीधे प्रबंधित करते हैं। दोनों अलग हैं:
 
-- **`settings.json`** - Claude Code को प्रत्येक टूल उपयोग पर `failproofai --hook <event>` को कॉल करने के लिए बताता है
-- **`policies-config.json`** - failproofai को बताता है कि कौन सी नीतियों का मूल्यांकन करें और किन पैरामीटर के साथ
+- **`settings.json`** - Claude Code को हर टूल यूज पर `failproofai --hook <event>` को कॉल करने के लिए बताता है
+- **`policies-config.json`** - failproofai को बताता है कि कौन सी नीतियों का मूल्यांकन करना है और किन पैरामीटर के साथ
 
-आप किसी भी समय `policies-config.json` को सीधे संपादित कर सकते हैं; परिवर्तन तुरंत अगले हुक इवेंट पर प्रभावी होते हैं, कोई पुनरारंभ की आवश्यकता नहीं है।
+आप किसी भी समय `policies-config.json` को सीधे संपादित कर सकते हैं; परिवर्तन पुनः आरंभ की आवश्यकता के बिना अगली हुक इवेंट पर तुरंत प्रभावी होते हैं।
 
 ---
 
-## उदाहरण: टीम डिफ़ॉल्ट के साथ प्रोजेक्ट-स्तर कॉन्फ़िगरेशन
+## उदाहरण: टीम डिफ़ॉल्ट्स के साथ प्रोजेक्ट-स्तर का कॉन्फ़िगरेशन
 
 `.failproofai/policies-config.json` को अपने रिपॉजिटरी में कमिट करें:
 
@@ -219,4 +219,4 @@ resolved: { allowPatterns: ["sudo systemctl status"] }  ← falls through to glo
 }
 ```
 
-प्रत्येक डेवलपर फिर `.failproofai/policies-config.local.json` (gitignored) बना सकता है व्यक्तिगत ओवरराइड के लिए बिना सहकर्मियों को प्रभावित किए।
+प्रत्येक डेवलपर फिर व्यक्तिगत ओवरराइड के लिए `.failproofai/policies-config.local.json` (gitignored) बना सकता है, बिना टीममेट्स को प्रभावित किए।

package/.next/standalone/docs/hi/custom-policies.mdx

@@ -1,14 +1,14 @@
 ---
 title: कस्टम पॉलिसीज़
-description: "JavaScript में अपने नियम लिखें - कन्वेंशन्स को लागू करें, ड्रिफ़्ट को रोकें, विफलताओं का पता लगाएं, बाहरी सिस्टम्स के साथ इंटीग्रेट करें"
+description: "JavaScript में अपने स्वयं के पॉलिसीज़ लिखें - सम्मेलन लागू करें, विचलन रोकें, विफलताओं का पता लगाएं, बाहरी सिस्टम के साथ एकीकरण करें"
 icon: code
 ---
 
-कस्टम पॉलिसीज़ आपको किसी भी एजेंट व्यवहार के लिए नियम लिखने देती हैं: प्रोजेक्ट कन्वेंशन्स को लागू करें, ड्रिफ़्ट को रोकें, विनाशकारी ऑपरेशन्स को गेट करें, स्टक एजेंट्स का पता लगाएं, या Slack, अनुमोदन वर्कफ़्लो और बहुत कुछ के साथ इंटीग्रेट करें। वे built-in पॉलिसीज़ के समान हुक इवेंट सिस्टम और `allow`, `deny`, `instruct` डिसीजन्स का उपयोग करते हैं।
+कस्टम पॉलिसीज़ आपको किसी भी एजेंट व्यवहार के लिए नियम लिखने देती हैं: प्रोजेक्ट सम्मेलन लागू करें, विचलन रोकें, विनाशकारी ऑपरेशन को गेट करें, फंसे हुए एजेंटों का पता लगाएं, या Slack, स्वीकृति वर्कफ़्लो और बहुत कुछ के साथ एकीकृत करें। ये बिल्ट-इन पॉलिसीज़ के समान हुक इवेंट सिस्टम और `allow`, `deny`, `instruct` निर्णयों का उपयोग करते हैं।
 
 ---
 
-## क्विक उदाहरण
+## त्वरित उदाहरण
 
 ```js
 // my-policies.js
@@ -41,56 +41,56 @@ failproofai policies --install --custom ./my-policies.js
 
 ### विकल्प 1: कन्वेंशन-आधारित (अनुशंसित)
 
-`.failproofai/policies/` में `*policies.{js,mjs,ts}` फ़ाइलें ड्रॉप करें और वे स्वचालित रूप से लोड हो जाती हैं — कोई फ़्लैग या कॉन्फ़िग परिवर्तन की आवश्यकता नहीं है। यह git hooks की तरह काम करता है: एक फ़ाइल ड्रॉप करें, यह बस काम करता है।
+`*policies.{js,mjs,ts}` फाइलों को `.failproofai/policies/` में डालें और वे स्वचालित रूप से लोड हो जाती हैं — कोई फ्लैग या कॉन्फ़िगरेशन परिवर्तन की आवश्यकता नहीं। यह git हुक्स की तरह काम करता है: एक फाइल डालें, यह काम करता है।
 
 ```
 # प्रोजेक्ट स्तर — git में कमिट किया गया, टीम के साथ साझा किया गया
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
-# यूजर स्तर — व्यक्तिगत, सभी प्रोजेक्ट्स पर लागू
+# उपयोगकर्ता स्तर — व्यक्तिगत, सभी प्रोजेक्ट्स पर लागू होता है
 ~/.failproofai/policies/my-policies.mjs
 ```
 
 **यह कैसे काम करता है:**
-- प्रोजेक्ट और यूजर दोनों डायरेक्टरीज़ को स्कैन किया जाता है (यूनियन — पहला स्कोप-जीत नहीं)
-- फ़ाइलें प्रत्येक डायरेक्टरी के भीतर वर्णक्रम के अनुसार लोड की जाती हैं। क्रम को नियंत्रित करने के लिए `01-`, `02-` के साथ प्रीफ़िक्स करें
-- केवल `*policies.{js,mjs,ts}` से मेल खाने वाली फ़ाइलें लोड की जाती हैं; अन्य फ़ाइलों को अनदेखा किया जाता है
-- प्रत्येक फ़ाइल स्वतंत्र रूप से लोड की जाती है (प्रति फ़ाइल fail-open)
-- स्पष्ट `--custom` और built-in पॉलिसीज़ के साथ काम करता है
+- प्रोजेक्ट और उपयोगकर्ता दोनों निर्देशिकाएं स्कैन की जाती हैं (संघ — पहले-दायरा-जीत नहीं)
+- फाइलें प्रत्येक निर्देशिका में वर्णमाला के अनुसार लोड की जाती हैं। क्रम नियंत्रित करने के लिए `01-`, `02-` से शुरू करें
+- केवल `*policies.{js,mjs,ts}` से मेल खाने वाली फाइलें लोड की जाती हैं; अन्य फाइलें अनदेखी की जाती हैं
+- प्रत्येक फाइल स्वतंत्र रूप से लोड की जाती है (फाइल प्रति फेल-ओपन)
+- स्पष्ट `--custom` और बिल्ट-इन पॉलिसीज़ के साथ साथ काम करता है
 
 <Tip>
-कन्वेंशन पॉलिसीज़ एक टीम के साथ पॉलिसीज़ साझा करने का सबसे आसान तरीका हैं। `.failproofai/policies/` को git में कमिट करें और हर टीम मेंबर को वे स्वचालित रूप से मिलते हैं।
+कन्वेंशन पॉलिसीज़ एक टीम में पॉलिसीज़ साझा करने का सबसे आसान तरीका है। `.failproofai/policies/` को git में कमिट करें और प्रत्येक टीम सदस्य को वह स्वचालित रूप से मिल जाएगा।
 </Tip>
 
-### विकल्प 2: स्पष्ट फ़ाइल पाथ
+### विकल्प 2: स्पष्ट फाइल पथ
 
 ```bash
-# कस्टम पॉलिसीज़ फ़ाइल के साथ इंस्टॉल करें
+# कस्टम पॉलिसीज़ फाइल के साथ इंस्टॉल करें
 failproofai policies --install --custom ./my-policies.js
 
-# पॉलिसीज़ फ़ाइल पाथ को बदलें
+# पॉलिसीज़ फाइल पथ बदलें
 failproofai policies --install --custom ./new-policies.js
 
-# कॉन्फ़िग से कस्टम पॉलिसीज़ पाथ को हटाएं
+# कॉन्फ़िग से कस्टम पॉलिसीज़ पथ हटाएं
 failproofai policies --uninstall --custom
 ```
 
-रिज़ॉल्व किया गया निरपेक्ष पाथ `policies-config.json` में `customPoliciesPath` के रूप में संग्रहीत होता है। फ़ाइल हर हुक इवेंट पर ताज़ा लोड की जाती है - इवेंट्स के बीच कोई कैशिंग नहीं होती है।
+हल किया गया पूर्ण पथ `policies-config.json` में `customPoliciesPath` के रूप में संग्रहीत है। फाइल हर हुक इवेंट पर ताज़ी लोड की जाती है - इवेंट्स के बीच कोई कैशिंग नहीं है।
 
 ### दोनों को एक साथ उपयोग करना
 
-कन्वेंशन पॉलिसीज़ और स्पष्ट `--custom` फ़ाइल एक साथ मौजूद हो सकते हैं। लोड ऑर्डर:
+कन्वेंशन पॉलिसीज़ और स्पष्ट `--custom` फाइल एक साथ मौजूद हो सकती हैं। लोड क्रम:
 
-1. स्पष्ट `customPoliciesPath` फ़ाइल (यदि कॉन्फ़िगर किया गया हो)
-2. प्रोजेक्ट कन्वेंशन फ़ाइलें (`{cwd}/.failproofai/policies/`, वर्णक्रम)
-3. यूजर कन्वेंशन फ़ाइलें (`~/.failproofai/policies/`, वर्णक्रम)
+1. स्पष्ट `customPoliciesPath` फाइल (यदि कॉन्फ़िगर किया गया है)
+2. प्रोजेक्ट कन्वेंशन फाइलें (`{cwd}/.failproofai/policies/`, वर्णमाला के अनुसार)
+3. उपयोगकर्ता कन्वेंशन फाइलें (`~/.failproofai/policies/`, वर्णमाला के अनुसार)
 
 ---
 
 ## API
 
-### इंपोर्ट
+### आयात
 
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
@@ -98,46 +98,45 @@ import { customPolicies, allow, deny, instruct } from "failproofai";
 
 ### `customPolicies.add(hook)`
 
-एक पॉलिसी को रजिस्टर करता है। एक ही फ़ाइल में कई पॉलिसीज़ के लिए आवश्यकतानुसार इसे कॉल करें।
+एक पॉलिसी को रजिस्टर करता है। एक ही फाइल में कई पॉलिसीज़ के लिए आवश्यकतानुसार कई बार कॉल करें।
 
 ```ts
 customPolicies.add({
   name: string;                         // आवश्यक - अद्वितीय पहचानकर्ता
   description?: string;                 // `failproofai policies` आउटपुट में दिखाया गया
-  match?: { events?: HookEventType[] }; // इवेंट प्रकार द्वारा फ़िल्टर करें; सभी से मेल खाने के लिए छोड़ दें
+  match?: { events?: HookEventType[] }; // इवेंट प्रकार द्वारा फ़िल्टर करें; सभी से मेल खाने के लिए छोड़ें
   fn: (ctx: PolicyContext) => PolicyResult | Promise<PolicyResult>;
 });
 ```
 
-### डिसीजन हेल्पर्स
+### निर्णय सहायक
 
-| फंक्शन | प्रभाव | कब उपयोग करें |
+| फ़ंक्शन | प्रभाव | कब उपयोग करें |
 |----------|--------|----------|
-| `allow()` | ऑपरेशन को चुप से अनुमति दें | कार्रवाई सुरक्षित है, कोई संदेश की आवश्यकता नहीं |
+| `allow()` | ऑपरेशन को स्पष्ट रूप से अनुमति दें | कार्रवाई सुरक्षित है, कोई संदेश आवश्यक नहीं |
 | `deny(message)` | ऑपरेशन को ब्लॉक करें | एजेंट को यह कार्रवाई नहीं करनी चाहिए |
 | `instruct(message)` | बिना ब्लॉक किए संदर्भ जोड़ें | एजेंट को ट्रैक पर रहने के लिए अतिरिक्त संदर्भ दें |
 
-`deny(message)` - संदेश Claude को `"Blocked by failproofai:"` के साथ प्रीफ़िक्स किया गया दिखाई देता है। एक एकल `deny` सभी आगे के मूल्यांकन को शॉर्ट-सर्किट करता है।
+`deny(message)` - संदेश Claude को `"Blocked by failproofai:"` से पहले दिखाई देता है। एक एकल `deny` सभी आगे के मूल्यांकन को शॉर्ट-सर्किट करता है।
 
-`instruct(message)` - संदेश वर्तमान टूल कॉल के लिए Claude के संदर्भ में जोड़ा जाता है। सभी `instruct` संदेश एकत्रित किए जाते हैं और एक साथ डिलीवर किए जाते हैं।
+`instruct(message)` - संदेश वर्तमान टूल कॉल के लिए Claude के संदर्भ में जोड़ा जाता है। सभी `instruct` संदेश जमा किए जाते हैं और एक साथ वितरित किए जाते हैं।
 
 <Tip>
-`policyParams` में `hint` फ़ील्ड जोड़कर किसी भी `deny` या `instruct` संदेश के लिए अतिरिक्त निर्देश जोड़ सकते हैं — कोई कोड परिवर्तन की आवश्यकता नहीं है। यह कस्टम (`custom/`), प्रोजेक्ट कन्वेंशन (`.failproofai-project/`), और यूजर कन्वेंशन (`.failproofai-user/`) पॉलिसीज़ के लिए भी काम करता है। विवरण के लिए [कॉन्फ़िगरेशन → hint](/hi/configuration#hint-cross-cutting) देखें।
+आप `policyParams` में `hint` फील्ड जोड़कर किसी भी `deny` या `instruct` संदेश में अतिरिक्त मार्गदर्शन जोड़ सकते हैं — कोई कोड परिवर्तन आवश्यक नहीं। यह कस्टम (`custom/`), प्रोजेक्ट कन्वेंशन (`.failproofai-project/`), और उपयोगकर्ता कन्वेंशन (`.failproofai-user/`) पॉलिसीज़ के लिए भी काम करता है। विवरण के लिए [कॉन्फ़िगरेशन → hint](/hi/configuration#hint-cross-cutting) देखें।
 </Tip>
 
 ### सूचनात्मक allow संदेश
 
+`allow(message)` ऑपरेशन की अनुमति देता है **और** Claude को एक सूचनात्मक संदेश भेजता है। संदेश हुक हैंडलर के stdout प्रतिक्रिया में `additionalContext` के रूप में वितरित किया जाता है — `instruct` द्वारा उपयोग किया जाने वाला समान तंत्र, लेकिन शब्दार्थ से अलग: यह एक चेतावनी नहीं, बल्कि एक स्थिति अपडेट है।
 
-`allow(message)` ऑपरेशन को अनुमति देता है **और** Claude को एक सूचनात्मक संदेश भेजता है। संदेश हुक हैंडलर के stdout प्रतिक्रिया में `additionalContext` के रूप में डिलीवर किया जाता है — `instruct` द्वारा उपयोग किया जाने वाला समान तंत्र, लेकिन शब्दार्थ रूप से अलग: यह एक सतर्कता नहीं, एक स्थिति अपडेट है।
-
-| फंक्शन | प्रभाव | कब उपयोग करें |
+| फ़ंक्शन | प्रभाव | कब उपयोग करें |
 |----------|--------|----------|
-| `allow(message)` | अनुमति दें और Claude को संदर्भ भेजें | एक जांच पास होने की पुष्टि करें, या बताएं कि जांच को क्यों छोड़ा गया |
+| `allow(message)` | अनुमति दें और Claude को संदर्भ भेजें | एक जांच पास होने की पुष्टि करें, या एक जांच छोड़े जाने का कारण समझाएं |
 
 उपयोग के मामले:
-- **स्थिति पुष्टिकरण:** `allow("All CI checks passed.")` — Claude को बताता है कि सब कुछ हरा है
-- **Fail-open व्याख्याएं:** `allow("GitHub CLI not installed, skipping CI check.")` — Claude को बताता है कि जांच को क्यों छोड़ा गया ताकि इसके पास पूरा संदर्भ हो
-- **कई संदेश जमा होते हैं:** यदि कई पॉलिसीज़ प्रत्येक `allow(message)` रिटर्न करते हैं, तो सभी संदेश नई लाइनों के साथ जुड़ते हैं और एक साथ डिलीवर होते हैं
+- **स्थिति पुष्टि:** `allow("All CI checks passed.")` — Claude को बताएं कि सब कुछ हरा है
+- **फेल-ओपन व्याख्या:** `allow("GitHub CLI not installed, skipping CI check.")` — Claude को बताएं कि एक जांच क्यों छोड़ी गई थी ताकि उसके पास पूरा संदर्भ हो
+- **कई संदेश जमा होते हैं:** यदि कई पॉलिसीज़ प्रत्येक `allow(message)` लौटाती हैं, तो सभी संदेश नई पंक्तियों के साथ जुड़े जाते हैं और एक साथ वितरित किए जाते हैं
 
 ```js
 customPolicies.add({
@@ -162,8 +161,8 @@ customPolicies.add({
 |-------|------|-------------|
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
 | `toolName` | `string \| undefined` | कॉल किया जा रहा टूल (जैसे `"Bash"`, `"Write"`, `"Read"`) |
-| `toolInput` | `Record<string, unknown> \| undefined` | टूल के इनपुट पैरामीटर्स |
-| `payload` | `Record<string, unknown>` | Claude Code से पूर्ण raw इवेंट पेलोड |
+| `toolInput` | `Record<string, unknown> \| undefined` | टूल के इनपुट पैरामीटर |
+| `payload` | `Record<string, unknown>` | Claude Code से संपूर्ण कच्चा इवेंट पेलोड |
 | `session` | `SessionMetadata \| undefined` | सेशन संदर्भ (नीचे देखें) |
 
 ### `SessionMetadata` फील्ड्स
@@ -171,8 +170,8 @@ customPolicies.add({
 | फील्ड | प्रकार | विवरण |
 |-------|------|-------------|
 | `sessionId` | `string` | Claude Code सेशन पहचानकर्ता |
-| `cwd` | `string` | Claude Code सेशन की वर्किंग डायरेक्टरी |
-| `transcriptPath` | `string` | सेशन की JSONL ट्रांस्क्रिप्ट फ़ाइल का पाथ |
+| `cwd` | `string` | Claude Code सेशन की कार्य निर्देशिका |
+| `transcriptPath` | `string` | सेशन की JSONL ट्रांसक्रिप्ट फाइल का पथ |
 
 ### इवेंट प्रकार
 
@@ -180,7 +179,7 @@ customPolicies.add({
 |-------|--------------|----------------------|
 | `PreToolUse` | Claude एक टूल चलाने से पहले | टूल का इनपुट (जैसे Bash के लिए `{ command: "..." }`) |
 | `PostToolUse` | एक टूल पूरा होने के बाद | टूल का इनपुट + `tool_result` (आउटपुट) |
-| `Notification` | जब Claude एक नोटिफिकेशन भेजता है | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - हुक्स को हमेशा `allow()` रिटर्न करना चाहिए, वे नोटिफिकेशन्स को ब्लॉक नहीं कर सकते |
+| `Notification` | जब Claude एक सूचना भेजता है | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - हुक्स को हमेशा `allow()` लौटाना चाहिए, वे सूचनाओं को ब्लॉक नहीं कर सकते |
 | `Stop` | जब Claude सेशन समाप्त होता है | खाली |
 
 ---
@@ -189,20 +188,20 @@ customPolicies.add({
 
 पॉलिसीज़ का मूल्यांकन इस क्रम में किया जाता है:
 
-1. Built-in पॉलिसीज़ (परिभाषा क्रम में)
+1. बिल्ट-इन पॉलिसीज़ (परिभाषा क्रम में)
 2. `customPoliciesPath` से स्पष्ट कस्टम पॉलिसीज़ (`.add()` क्रम में)
-3. प्रोजेक्ट `.failproofai/policies/` से कन्वेंशन पॉलिसीज़ (फ़ाइलें वर्णक्रम, प्रत्येक के भीतर `.add()` क्रम)
-4. यूजर `~/.failproofai/policies/` से कन्वेंशन पॉलिसीज़ (फ़ाइलें वर्णक्रम, प्रत्येक के भीतर `.add()` क्रम)
+3. प्रोजेक्ट `.failproofai/policies/` से कन्वेंशन पॉलिसीज़ (फाइलें वर्णमाला के अनुसार, `.add()` क्रम के भीतर)
+4. उपयोगकर्ता `~/.failproofai/policies/` से कन्वेंशन पॉलिसीज़ (फाइलें वर्णमाला के अनुसार, `.add()` क्रम के भीतर)
 
 <Note>
-पहला `deny` सभी बाद की पॉलिसीज़ को शॉर्ट-सर्किट करता है। सभी `instruct` संदेश एकत्रित किए जाते हैं और एक साथ डिलीवर किए जाते हैं।
+पहला `deny` सभी बाद की पॉलिसीज़ को शॉर्ट-सर्किट करता है। सभी `instruct` संदेश जमा किए जाते हैं और एक साथ वितरित किए जाते हैं।
 </Note>
 
 ---
 
-## ट्रांसिटिव इंपोर्ट्स
+## पारगमन आयात
 
-कस्टम पॉलिसी फ़ाइलें रिलेटिव पाथ्स का उपयोग करके स्थानीय मॉड्यूल्स को इंपोर्ट कर सकती हैं:
+कस्टम पॉलिसी फाइलें सापेक्ष पथों का उपयोग करके स्थानीय मॉड्यूल को आयात कर सकती हैं:
 
 ```js
 // my-policies.js
@@ -219,21 +218,21 @@ customPolicies.add({
 });
 ```
 
-एंट्री फ़ाइल से पहुंचने योग्य सभी रिलेटिव इंपोर्ट्स को रिज़ॉल्व किया जाता है। यह `from "failproofai"` इंपोर्ट्स को वास्तविक dist पाथ में फिर से लिखकर और ESM संगतता सुनिश्चित करने के लिए अस्थायी `.mjs` फ़ाइलें बनाकर लागू किया जाता है।
+एंट्री फाइल से सभी सापेक्ष आयात हल किए जाते हैं। यह `from "failproofai"` आयात को वास्तविक dist पथ में फिर से लिखकर और ESM संगतता सुनिश्चित करने के लिए अस्थायी `.mjs` फाइलें बनाकर लागू किया जाता है।
 
 ---
 
-## इवेंट टाइप फ़िल्टरिंग
+## इवेंट प्रकार फ़िल्टरिंग
 
-`match.events` का उपयोग करके यह सीमित करें कि कब एक पॉलिसी फायर होती है:
+किसी पॉलिसी को फायर करने के समय को सीमित करने के लिए `match.events` का उपयोग करें:
 
 ```js
 customPolicies.add({
   name: "require-summary-on-stop",
   match: { events: ["Stop"] },
   fn: async (ctx) => {
-    // केवल तब फायर होता है जब सेशन समाप्त होता है
-    // ctx.session.transcriptPath में पूरा सेशन लॉग होता है
+    // केवल तभी फायर होता है जब सेशन समाप्त होता है
+    // ctx.session.transcriptPath में संपूर्ण सेशन लॉग होता है
     return allow();
   },
 });
@@ -243,22 +242,22 @@ customPolicies.add({
 
 ---
 
-## त्रुटि हैंडलिंग और विफलता मोड्स
+## त्रुटि हैंडलिंग और विफलता के तरीके
 
-कस्टम पॉलिसीज़ **fail-open** हैं: त्रुटियां कभी built-in पॉलिसीज़ को ब्लॉक नहीं करती हैं या हुक हैंडलर को क्रैश नहीं करती हैं।
+कस्टम पॉलिसीज़ **फेल-ओपन** हैं: त्रुटियां कभी भी बिल्ट-इन पॉलिसीज़ को ब्लॉक नहीं करती हैं या हुक हैंडलर को क्रैश नहीं करती हैं।
 
 | विफलता | व्यवहार |
 |---------|----------|
-| `customPoliciesPath` सेट नहीं है | कोई स्पष्ट कस्टम पॉलिसीज़ नहीं चलती हैं; कन्वेंशन पॉलिसीज़ और built-ins सामान्य रूप से जारी रहते हैं |
-| फ़ाइल नहीं मिली | `~/.failproofai/hook.log` में चेतावनी लॉग की जाती है; built-ins जारी रहते हैं |
-| सिंटैक्स/इंपोर्ट त्रुटि (स्पष्ट) | `~/.failproofai/hook.log` में त्रुटि लॉग की जाती है; स्पष्ट कस्टम पॉलिसीज़ छोड़ दी जाती हैं |
-| सिंटैक्स/इंपोर्ट त्रुटि (कन्वेंशन) | त्रुटि लॉग की जाती है; वह फ़ाइल छोड़ दी जाती है, अन्य कन्वेंशन फ़ाइलें अभी भी लोड होती हैं |
-| `fn` रनटाइम पर throw करता है | त्रुटि लॉग की जाती है; वह हुक `allow` के रूप में माना जाता है; अन्य हुक्स जारी रहते हैं |
-| `fn` 10s से अधिक समय लेता है | टाइमआउट लॉग किया जाता है; `allow` के रूप में माना जाता है |
-| कन्वेंशन डायरेक्टरी नहीं मिली | कोई कन्वेंशन पॉलिसीज़ नहीं चलती हैं; कोई त्रुटि नहीं |
+| `customPoliciesPath` सेट नहीं है | कोई स्पष्ट कस्टम पॉलिसीज़ चलाई नहीं जाती हैं; कन्वेंशन पॉलिसीज़ और बिल्ट-इन सामान्य रूप से जारी रहते हैं |
+| फाइल नहीं मिली | `~/.failproofai/hook.log` में चेतावनी दर्ज की गई; बिल्ट-इन जारी रहते हैं |
+| सिंटैक्स/आयात त्रुटि (स्पष्ट) | `~/.failproofai/hook.log` में त्रुटि दर्ज की गई; स्पष्ट कस्टम पॉलिसीज़ छोड़ी गई हैं |
+| सिंटैक्स/आयात त्रुटि (कन्वेंशन) | दर्ज की गई त्रुटि; वह फाइल छोड़ी गई, अन्य कन्वेंशन फाइलें अभी भी लोड होती हैं |
+| `fn` रनटाइम पर फेंकता है | दर्ज की गई त्रुटि; वह हुक `allow` के रूप में माना जाता है; अन्य हुक्स जारी रहते हैं |
+| `fn` 10 सेकंड से अधिक समय लेता है | दर्ज किया गया टाइमआउट; `allow` के रूप में माना जाता है |
+| कन्वेंशन निर्देशिका गायब | कोई कन्वेंशन पॉलिसीज़ चलाई नहीं जाती हैं; कोई त्रुटि नहीं |
 
 <Tip>
-कस्टम पॉलिसी त्रुटियों को डिबग करने के लिए, लॉग फ़ाइल को देखें:
+कस्टम पॉलिसी त्रुटियों को डीबग करने के लिए, लॉग फाइल देखें:
 
 ```bash
 tail -f ~/.failproofai/hook.log
@@ -267,13 +266,13 @@ tail -f ~/.failproofai/hook.log
 
 ---
 
-## पूरा उदाहरण: कई पॉलिसीज़
+## पूर्ण उदाहरण: कई पॉलिसीज़
 
 ```js
 // my-policies.js
 import { customPolicies, allow, deny, instruct } from "failproofai";
 
-// एजेंट को secrets/ डायरेक्टरी में लिखने से रोकें
+// एजेंट को secrets/ निर्देशिका में लिखने से रोकें
 customPolicies.add({
   name: "block-secrets-dir",
   description: "Prevent agent from writing to secrets/ directory",
@@ -286,7 +285,7 @@ customPolicies.add({
   },
 });
 
-// एजेंट को ट्रैक पर रखें: कमिट करने से पहले टेस्ट्स सत्यापित करें
+// एजेंट को ट्रैक पर रखें: कमिट करने से पहले टेस्ट सत्यापित करें
 customPolicies.add({
   name: "remind-test-before-commit",
   description: "Keep the agent on track: verify tests pass before committing",
@@ -301,7 +300,7 @@ customPolicies.add({
   },
 });
 
-// फ्रीज़ अवधि के दौरान अनियोजित निर्भरता परिवर्तन को रोकें
+// फ्रीज अवधि के दौरान अनियोजित निर्भरता परिवर्तनों को रोकें
 customPolicies.add({
   name: "dependency-freeze",
   description: "Prevent unplanned dependency changes during freeze period",
@@ -324,31 +323,31 @@ export { customPolicies };
 
 ## उदाहरण
 
-`examples/` डायरेक्टरी में तैयार-से-चलाने योग्य पॉलिसी फ़ाइलें होती हैं:
+`examples/` निर्देशिका में चलने के लिए तैयार पॉलिसी फाइलें हैं:
 
-| फ़ाइल | सामग्री |
+| फाइल | सामग्री |
 |------|----------|
-| `examples/policies-basic.js` | पांच स्टार्टर पॉलिसीज़ जो सामान्य एजेंट विफलता मोड को कवर करती हैं |
-| `examples/policies-advanced/index.js` | उन्नत पैटर्न: ट्रांसिटिव इंपोर्ट्स, async कॉल्स, आउटपुट स्क्रबिंग, और सेशन-एंड हुक्स |
-| `examples/convention-policies/security-policies.mjs` | कन्वेंशन-आधारित सुरक्षा पॉलिसीज़ (.env राइट्स को ब्लॉक करें, git इतिहास को फिर से लिखने से रोकें) |
-| `examples/convention-policies/workflow-policies.mjs` | कन्वेंशन-आधारित वर्कफ़्लो पॉलिसीज़ (टेस्ट रिमाइंडर्स, ऑडिट फ़ाइल राइट्स) |
+| `examples/policies-basic.js` | पांच स्टार्टर पॉलिसीज़ जो सामान्य एजेंट विफलता तरीकों को कवर करती हैं |
+| `examples/policies-advanced/index.js` | उन्नत पैटर्न: पारगमन आयात, async कॉल, आउटपुट स्क्रबिंग, और सेशन-अंत हुक्स |
+| `examples/convention-policies/security-policies.mjs` | कन्वेंशन-आधारित सुरक्षा पॉलिसीज़ (.env लेखन ब्लॉक करें, git इतिहास फिर से लिखने को रोकें) |
+| `examples/convention-policies/workflow-policies.mjs` | कन्वेंशन-आधारित वर्कफ़्लो पॉलिसीज़ (टेस्ट रिमाइंडर, ऑडिट फाइल लेखन) |
 
-### स्पष्ट फ़ाइल उदाहरण्स का उपयोग करना
+### स्पष्ट फाइल उदाहरणों का उपयोग करना
 
 ```bash
 failproofai policies --install --custom ./examples/policies-basic.js
 ```
 
-### कन्वेंशन-आधारित उदाहरण्स का उपयोग करना
+### कन्वेंशन-आधारित उदाहरणों का उपयोग करना
 
 ```bash
 # प्रोजेक्ट स्तर पर कॉपी करें
 mkdir -p .failproofai/policies
 cp examples/convention-policies/*.mjs .failproofai/policies/
 
-# या यूजर स्तर पर कॉपी करें
+# या उपयोगकर्ता स्तर पर कॉपी करें
 mkdir -p ~/.failproofai/policies
 cp examples/convention-policies/*.mjs ~/.failproofai/policies/
 ```
 
-कोई इंस्टॉल कमांड की आवश्यकता नहीं है — फ़ाइलें अगली हुक इवेंट पर स्वचालित रूप से लोड हो जाती हैं।
+कोई इंस्टॉल कमांड की आवश्यकता नहीं — फाइलें अगली हुक इवेंट पर स्वचालित रूप से उठाई जाती हैं।