failproofai 0.0.6-beta.0 → 0.0.6-beta.2

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

@@ -2,17 +2,17 @@
 
 ---
 title: उदाहरण
-description: "Claude Code और Agents SDK के लिए hooks सेट अप करना"
+description: "Claude Code और Agents SDK के लिए hooks को सेट अप करने का तरीका"
 icon: book-open
 ---
 
-सामान्य परिस्थितियों के लिए तुरंत उपयोग के लिए तैयार उदाहरण। प्रत्येक दिखाता है कि कैसे इंस्टॉल करें और क्या उम्मीद करें।
+सामान्य परिस्थितियों के लिए तुरंत उपयोग के लिए तैयार उदाहरण। प्रत्येक उदाहरण दिखाता है कि इंस्टॉल कैसे करें और क्या उम्मीद करें।
 
 ---
 
 ## Claude Code के लिए hooks सेट अप करना
 
-Failproof AI Claude Code के साथ अपनी [hooks system](https://docs.anthropic.com/en/docs/claude-code/hooks) के माध्यम से एकीकृत होता है। जब आप `failproofai policies --install` चलाते हैं, तो यह Claude Code के `settings.json` में hook commands को रजिस्टर करता है जो हर tool call पर चलते हैं।
+Failproof AI, Claude Code के साथ अपने [hooks system](https://docs.anthropic.com/en/docs/claude-code/hooks) के माध्यम से एकीकृत होता है। जब आप `failproofai policies --install` चलाते हैं, तो यह Claude Code के `settings.json` में hook commands को रजिस्टर करता है जो हर tool call पर फायर होते हैं।
 
 <Steps>
   <Step title="failproofai इंस्टॉल करें">
@@ -20,24 +20,24 @@ Failproof AI Claude Code के साथ अपनी [hooks system](https://do
     npm install -g failproofai
     ```
   </Step>
-  <Step title="सभी built-in policies सक्षम करें">
+  <Step title="सभी बिल्ट-इन policies को सक्षम करें">
     ```bash
     failproofai policies --install
     ```
   </Step>
-  <Step title="verify करें कि hooks रजिस्टर हैं">
+  <Step title="सत्यापित करें कि hooks रजिस्टर हैं">
     ```bash
     cat ~/.claude/settings.json | grep failproofai
     ```
 
-    आपको `PreToolUse`, `PostToolUse`, `Notification`, और `Stop` events के लिए hook entries दिखाई देने चाहिए।
+    आपको `PreToolUse`, `PostToolUse`, `Notification`, और `Stop` events के लिए hook entries दिखनी चाहिए।
   </Step>
   <Step title="Claude Code चलाएं">
     ```bash
     claude
     ```
 
-    अब policies हर tool call पर स्वचालित रूप से चलती हैं। Claude से `sudo rm -rf /` चलाने के लिए कहने का प्रयास करें - यह block हो जाएगा।
+    Policies अब हर tool call पर स्वचालित रूप से चलती हैं। Claude से `sudo rm -rf /` चलाने के लिए कहने का प्रयास करें - यह अवरुद्ध होगा।
   </Step>
 </Steps>
 
@@ -45,23 +45,23 @@ Failproof AI Claude Code के साथ अपनी [hooks system](https://do
 
 ## Agents SDK के लिए hooks सेट अप करना
 
-यदि आप [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk) के साथ निर्माण कर रहे हैं, तो आप प्रोग्राम के माध्यम से उसी hook system का उपयोग कर सकते हैं।
+यदि आप [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk) के साथ निर्माण कर रहे हैं, तो आप समान hook system को प्रोग्रामेटिक रूप से उपयोग कर सकते हैं।
 
 <Steps>
-  <Step title="अपनी project में failproofai इंस्टॉल करें">
+  <Step title="अपने प्रोजेक्ट में failproofai इंस्टॉल करें">
     ```bash
     npm install failproofai
     ```
   </Step>
-  <Step title="अपने agent में hooks configure करें">
-    अपने agent process को बनाते समय hook commands pass करें। hooks Claude Code की तरह ही चलते हैं - stdin/stdout JSON के माध्यम से:
+  <Step title="अपने agent में hooks कॉन्फ़िगर करें">
+    अपने agent process को बनाते समय hook commands को पास करें। Hooks उसी तरह फायर होते हैं जैसे Claude Code में - stdin/stdout JSON के माध्यम से:
 
     ```bash
-    failproofai --hook PreToolUse   # हर tool से पहले call होता है
-    failproofai --hook PostToolUse  # हर tool के बाद call होता है
+    failproofai --hook PreToolUse   # हर tool से पहले कहा जाता है
+    failproofai --hook PostToolUse  # हर tool के बाद कहा जाता है
     ```
   </Step>
-  <Step title="अपने agent के लिए एक custom policy लिखें">
+  <Step title="अपने agent के लिए एक कस्टम policy लिखें">
     ```javascript
     import { customPolicies, allow, deny } from "failproofai";
 
@@ -79,7 +79,7 @@ Failproof AI Claude Code के साथ अपनी [hooks system](https://do
     });
     ```
   </Step>
-  <Step title="custom policy इंस्टॉल करें">
+  <Step title="कस्टम policy इंस्टॉल करें">
     ```bash
     failproofai policies --install --custom ./my-agent-policies.js
     ```
@@ -88,37 +88,37 @@ Failproof AI Claude Code के साथ अपनी [hooks system](https://do
 
 ---
 
-## विनाशकारी commands को block करें
+## विनाशकारी commands को ब्लॉक करें
 
-सबसे सामान्य सेटअप - agents को अपरिवर्तनीय क्षति से रोकें।
+सबसे सामान्य सेटअप - agents को अपरिवर्तनीय नुकसान करने से रोकें।
 
 ```bash
 failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
 ```
 
 यह क्या करता है:
-- `block-sudo` - सभी `sudo` commands को block करता है
-- `block-rm-rf` - recursive file deletion को block करता है
-- `block-force-push` - `git push --force` को block करता है
-- `block-curl-pipe-sh` - remote scripts को shell में piping करने को block करता है
+- `block-sudo` - सभी `sudo` commands को ब्लॉक करता है
+- `block-rm-rf` - recursive file deletion को ब्लॉक करता है
+- `block-force-push` - `git push --force` को ब्लॉक करता है
+- `block-curl-pipe-sh` - remote scripts को shell में pipe करने को ब्लॉक करता है
 
 ---
 
-## secret leakage को रोकें
+## गुप्त जानकारी का लीक होना रोकें
 
-Agents को tool output में credentials को देखने या लीक करने से रोकें।
+Agents को tool output में credentials देखने या लीक करने से रोकें।
 
 ```bash
 failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
 ```
 
-ये `PostToolUse` पर चलते हैं - एक tool चलने के बाद, वे output को agent के सामने आने से पहले साफ कर देते हैं।
+ये `PostToolUse` पर फायर होते हैं - एक tool चलने के बाद, ये agent को देखने से पहले output को साफ करते हैं।
 
 ---
 
-## जब agents को ध्यान देने की आवश्यकता हो तो Slack alerts प्राप्त करें
+## जब agents को ध्यान की आवश्यकता हो तो Slack alerts प्राप्त करें
 
-Notification hook का उपयोग करके idle alerts को Slack में भेजें।
+notification hook का उपयोग करके idle alerts को Slack पर फॉरवर्ड करें।
 
 ```javascript
 import { customPolicies, allow, instruct } from "failproofai";
@@ -144,7 +144,7 @@ customPolicies.add({
         signal: AbortSignal.timeout(5000),
       });
     } catch {
-      // Slack अगर पहुंचने योग्य नहीं है तो कभी भी agent को block न करें
+      // अगर Slack अनुपलब्ध है तो agent को कभी ब्लॉक न करें
     }
 
     return allow();
@@ -152,7 +152,7 @@ customPolicies.add({
 });
 ```
 
-इंस्टॉल करें:
+इसे इंस्टॉल करें:
 
 ```bash
 SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
@@ -162,7 +162,7 @@ SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --c
 
 ## Agents को एक branch पर रखें
 
-Agents को branches को switch करने या protected ones में push करने से रोकें।
+Agents को branches स्विच करने या protected ones पर push करने से रोकें।
 
 ```javascript
 import { customPolicies, allow, deny } from "failproofai";
@@ -184,9 +184,9 @@ customPolicies.add({
 
 ---
 
-## Commits से पहले tests की आवश्यकता करें
+## Commits से पहले tests की आवश्यकता है
 
-Agents को commit करने से पहले tests चलाने की याद दिलाएं।
+Agents को commit करने से पहले tests चलाने के लिए याद दिलाएं।
 
 ```javascript
 import { customPolicies, allow, instruct } from "failproofai";
@@ -208,9 +208,9 @@ customPolicies.add({
 
 ---
 
-## एक production repo को lock down करें
+## Production repo को लॉक डाउन करें
 
-एक project-level config को commit करें ताकि आपकी टीम के हर developer को समान policies मिलें।
+एक project-level config commit करें ताकि आपकी team का हर developer समान policies प्राप्त करे।
 
 अपने repo में `.failproofai/policies-config.json` बनाएं:
 
@@ -240,16 +240,70 @@ git add .failproofai/policies-config.json
 git commit -m "Add failproofai team policies"
 ```
 
-जिस भी टीम member के पास failproofai installed है वह स्वचालित रूप से ये rules को pick up करेगा।
+हर team member जिसके पास failproofai इंस्टॉल है, ये नियम स्वचालित रूप से ले लेंगे।
+
+---
+
+## Convention policies के साथ एक org-wide quality standard बनाएं
+
+सबसे प्रभावशाली सेटअप: अपने repo में `.failproofai/policies/` को commit करें जिसमें आपके प्रोजेक्ट के लिए तैयार किए गए policies हों। हर team member को ये स्वचालित रूप से मिल जाते हैं — कोई install commands नहीं, कोई config changes नहीं।
+
+<Steps>
+  <Step title="directory बनाएं और policies जोड़ें">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    // अपनी team की पसंदीदा package manager को लागू करें
+    // (या इसके बजाय बिल्ट-इन prefer-package-manager policy को सक्षम करें)
+    customPolicies.add({
+      name: "enforce-bun",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        const cmd = String(ctx.toolInput?.command ?? "");
+        if (/\bnpm\b/.test(cmd)) return deny("Use bun instead of npm.");
+        return allow();
+      },
+    });
+
+    // Agent को commit करने से पहले tests चलाने की याद दिलाएं
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Git में commit करें">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+  </Step>
+  <Step title="सुधार जारी रखें">
+    जब आपकी team को नई असफलताओं का सामना हो, तो policies जोड़ें और push करें। हर कोई अपने अगले `git pull` पर अपडेट प्राप्त करेगा। ये policies एक जीवंत quality standard बन जाते हैं जो आपकी team के साथ बढ़ता है।
+  </Step>
+</Steps>
 
 ---
 
 ## अधिक उदाहरण
 
-Repo में [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) directory में शामिल हैं:
+Repo में [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) directory में शामिल है:
 
 | File | यह क्या दिखाता है |
 |------|---------------|
-| `policies-basic.js` | Starter policies - production writes, force-push, piped scripts को block करें |
+| `policies-basic.js` | Starter policies - production writes, force-push, piped scripts को ब्लॉक करें |
 | `policies-notification.js` | Idle notifications और session end के लिए Slack alerts |
 | `policies-advanced/index.js` | Transitive imports, async hooks, PostToolUse output scrubbing, Stop event handling |

package/.next/standalone/docs/hi/getting-started.mdx

@@ -1,13 +1,14 @@
 ---
+---
 title: शुरुआत करें
-description: "failproofai इंस्टॉल करें, policies सक्षम करें, और अपने agents को विश्वसनीयता से चलाएं"
+description: "failproofai को इंस्टॉल करें, policies को सक्षम करें, और अपने agents को विश्वसनीयता से चलाएं"
 icon: rocket
 ---
 
 ## आवश्यकताएं
 
 - **Node.js** >= 20.9.0
-- **Bun** >= 1.3.0 (वैकल्पिक - केवल स्रोत से बनाने के लिए आवश्यक)
+- **Bun** >= 1.3.0 (वैकल्पिक - केवल स्रोत से बिल्ड करने के लिए आवश्यक)
 
 ---
 
@@ -30,74 +31,126 @@ bun add -g failproofai
 ## त्वरित शुरुआत
 
 <Steps>
-  <Step title="Policies सक्षम करें">
-    Policies ऐसे नियम हैं जो हर agent tool call से पहले और बाद में चलते हैं। ये विनाशकारी कमांड, गुप्त लीकेज, और अन्य विफलता मोड को नुकसान पहुंचाने से पहले पकड़ते हैं।
+  <Step title="Policies को सक्षम करें">
+    Policies ऐसे नियम हैं जो हर agent tool call से पहले और बाद में चलते हैं। वे विनाशकारी commands, secret leakage, और अन्य failure modes को नुकसान पहुंचाने से पहले रोक देते हैं।
 
     ```bash
     failproofai policies --install
     ```
 
-    यह Claude Code की `settings.json` में hook entries लिखता है। आप एकल project के लिए या विशिष्ट policies चुनकर भी इंस्टॉल कर सकते हैं:
+    यह Claude Code के `settings.json` में hook entries लिखता है। आप एक single project के लिए भी इंस्टॉल कर सकते हैं या specific policies चुन सकते हैं:
 
     ```bash
     failproofai policies --install --scope project
     failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
     ```
   </Step>
-  <Step title="सत्यापन करें">
+  <Step title="सत्यापित करें">
     ```bash
     failproofai policies
     ```
 
-    प्रत्येक policy दिखाता है कि वह सक्षम है या नहीं, और कोई भी कॉन्फ़िगर किए गए पैरामीटर।
+    हर policy दिखाता है, चाहे वह सक्षम हो, और कोई भी configured parameters।
   </Step>
   <Step title="डैशबोर्ड लॉन्च करें">
     ```bash
     failproofai
     ```
 
-    `http://localhost:8020` पर एक स्थानीय डैशबोर्ड खोलता है जहां आप sessions ब्राउज़ कर सकते हैं, tool calls का निरीक्षण कर सकते हैं, और policies प्रबंधित कर सकते हैं।
+    `http://localhost:8020` पर एक local dashboard खोलता है जहां आप sessions को browse कर सकते हैं, tool calls का inspection कर सकते हैं, और policies को manage कर सकते हैं।
   </Step>
   <Step title="अपने agent को चलाएं">
-    Claude Code को सामान्य तरीके से शुरू करें। यदि agent कुछ जोखिम भरा करने का प्रयास करता है, तो failproofai इसे स्वचालित रूप से रोक देता है। इसे unattended चलने दें और डैशबोर्ड में देखें कि क्या हुआ।
+    Claude Code को सामान्य तरीके से शुरू करें। यदि agent कुछ जोखिम भरा करने की कोशिश करता है, तो failproofai इसे स्वचालित रूप से रोक देता है। इसे unattended चलने दें और डैशबोर्ड में देखें कि क्या हुआ।
   </Step>
 </Steps>
 
 ---
 
-## Policies कैसे काम करती हैं
+## Policies कैसे काम करते हैं
 
-हर बार जब एक agent एक tool चलाता है, Claude Code failproofai को एक subprocess के रूप में कॉल करता है:
+हर बार जब कोई agent एक tool चलाता है, Claude Code failproofai को एक subprocess के रूप में कॉल करता है:
 
 ```text
-Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON पढ़ता है
-                                                  policies का मूल्यांकन करता है
-                                                  stdout के लिए निर्णय लिखता है
+Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON को पढ़ता है
+                                                 policies का मूल्यांकन करता है
+                                                 निर्णय को stdout में लिखता है
 ```
 
-प्रत्येक policy तीन निर्णयों में से एक देता है:
+प्रत्येक policy तीन निर्णयों में से एक लौटाता है:
 
 - **allow** - agent सामान्य रूप से आगे बढ़ता है
-- **deny** - कार्रवाई को ब्लॉक किया जाता है, agent को बताया जाता है कि क्यों
-- **instruct** - agent के prompt में अतिरिक्त context जोड़ा जाता है
+- **deny** - action को ब्लॉक किया जाता है, agent को कारण बताया जाता है
+- **instruct** - agent के prompt में extra context जोड़ा जाता है
 
 <Note>
-Policies आपकी स्थानीय प्रक्रिया में चलती हैं। कुछ भी किसी दूरस्थ सेवा को नहीं भेजा जाता है।
+Policies आपकी local process में चलती हैं। कोई भी चीज़ remote service को नहीं भेजी जाती है।
 </Note>
 
 ---
 
-## डेटा स्टोरेज
+## Convention-based policies के साथ team policies सेट अप करें
+
+अपनी पूरी team में quality standards स्थापित करने का सबसे तेज़ तरीका `.failproofai/policies/` convention है। इस directory में policy files drop करें और वे स्वचालित रूप से load हो जाती हैं — कोई flags नहीं, कोई config changes नहीं, कोई install commands नहीं।
+
+<Steps>
+  <Step title="Policies directory बनाएं">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+  </Step>
+  <Step title="Policy files जोड़ें">
+    Starter examples को copy करें या अपने खुद के लिखें:
+
+    ```bash
+    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
+    ```
+
+    या एक नया बनाएं:
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Git में commit करें">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+
+    हर team member जिसके पास failproofai installed है, ये policies स्वचालित रूप से pick up कर लेता है। कोई per-developer setup की आवश्यकता नहीं है।
+  </Step>
+</Steps>
+
+<Tip>
+`.failproofai/policies/` को अपने repo में commit करें ताकि पूरी team एक ही standards साझा करे। जैसे-जैसे आपकी team नई failure modes discover करती है, policies जोड़ें और push करें — हर किसी को अपने अगले `git pull` पर update मिलेगा। समय के साथ ये policies एक living quality standard बन जाती हैं जो लगातार improve होती हैं।
+</Tip>
+
+---
+
+## डेटा storage
 
-सभी configuration और logs आपकी मशीन पर रहते हैं:
+सभी configuration और logs आपकी machine पर रहते हैं:
 
-| पाथ | यह क्या संग्रहीत करता है |
+| Path | क्या store करता है |
 |------|----------------|
 | `~/.failproofai/policies-config.json` | Global policy config |
 | `~/.failproofai/hook-activity.jsonl` | Hook execution history |
-| `~/.failproofai/hook.log` | Custom hook errors के लिए डीबग log |
+| `~/.failproofai/hook.log` | Custom hook errors के लिए debug log |
 | `.failproofai/policies-config.json` | Per-project config (committed) |
-| `.failproofai/policies-config.local.json` | व्यक्तिगत overrides (gitignored) |
+| `.failproofai/policies-config.local.json` | Personal overrides (gitignored) |
 
 ---
 
@@ -107,7 +160,7 @@ Policies आपकी स्थानीय प्रक्रिया मे
 failproofai policies --uninstall
 ```
 
-`~/.claude/settings.json` से hook entries को हटाता है। `~/.failproofai/` में config files रखी जाती हैं।
+`~/.claude/settings.json` से hook entries को हटाता है। `~/.failproofai/` में config files रहती हैं।
 
 ---
 
@@ -120,15 +173,15 @@ failproofai policies --uninstall
 </Card>
 
 <Card title="Built-in policies" icon="shield" href="/hi/built-in-policies">
-  सभी 26 policies के साथ parameters
+  सभी 26 policies with parameters
 </Card>
 
 <Card title="Custom policies" icon="code" href="/hi/custom-policies">
-  JavaScript में अपनी policies लिखें
+  JavaScript में अपनी खुद की policies लिखें
 </Card>
 
 <Card title="Agent monitor" icon="chart-line" href="/hi/dashboard">
-  Sessions की निगरानी करें और policy activity की समीक्षा करें
+  Sessions को monitor करें और policy activity की समीक्षा करें
 </Card>
 
 </CardGroup>