failproofai 0.0.2 → 0.0.4-beta.0

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

@@ -0,0 +1,255 @@
+---
+
+---
+title: उदाहरण
+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 पर चलते हैं।
+
+<Steps>
+  <Step title="failproofai इंस्टॉल करें">
+    ```bash
+    npm install -g failproofai
+    ```
+  </Step>
+  <Step title="सभी built-in policies सक्षम करें">
+    ```bash
+    failproofai policies --install
+    ```
+  </Step>
+  <Step title="verify करें कि hooks रजिस्टर हैं">
+    ```bash
+    cat ~/.claude/settings.json | grep failproofai
+    ```
+
+    आपको `PreToolUse`, `PostToolUse`, `Notification`, और `Stop` events के लिए hook entries दिखाई देने चाहिए।
+  </Step>
+  <Step title="Claude Code चलाएं">
+    ```bash
+    claude
+    ```
+
+    अब policies हर tool call पर स्वचालित रूप से चलती हैं। Claude से `sudo rm -rf /` चलाने के लिए कहने का प्रयास करें - यह block हो जाएगा।
+  </Step>
+</Steps>
+
+---
+
+## Agents SDK के लिए hooks सेट अप करना
+
+यदि आप [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk) के साथ निर्माण कर रहे हैं, तो आप प्रोग्राम के माध्यम से उसी hook system का उपयोग कर सकते हैं।
+
+<Steps>
+  <Step title="अपनी project में failproofai इंस्टॉल करें">
+    ```bash
+    npm install failproofai
+    ```
+  </Step>
+  <Step title="अपने agent में hooks configure करें">
+    अपने agent process को बनाते समय hook commands pass करें। hooks Claude Code की तरह ही चलते हैं - stdin/stdout JSON के माध्यम से:
+
+    ```bash
+    failproofai --hook PreToolUse   # हर tool से पहले call होता है
+    failproofai --hook PostToolUse  # हर tool के बाद call होता है
+    ```
+  </Step>
+  <Step title="अपने agent के लिए एक custom policy लिखें">
+    ```javascript
+    import { customPolicies, allow, deny } from "failproofai";
+
+    customPolicies.add({
+      name: "limit-to-project-dir",
+      description: "Keep the agent inside the project directory",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        const path = String(ctx.toolInput?.file_path ?? "");
+        if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
+          return deny("Agent is restricted to the project directory");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="custom policy इंस्टॉल करें">
+    ```bash
+    failproofai policies --install --custom ./my-agent-policies.js
+    ```
+  </Step>
+</Steps>
+
+---
+
+## विनाशकारी commands को block करें
+
+सबसे सामान्य सेटअप - 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 करता है
+
+---
+
+## secret leakage को रोकें
+
+Agents को tool output में credentials को देखने या लीक करने से रोकें।
+
+```bash
+failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
+```
+
+ये `PostToolUse` पर चलते हैं - एक tool चलने के बाद, वे output को agent के सामने आने से पहले साफ कर देते हैं।
+
+---
+
+## जब agents को ध्यान देने की आवश्यकता हो तो Slack alerts प्राप्त करें
+
+Notification hook का उपयोग करके idle alerts को Slack में भेजें।
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "slack-on-idle",
+  description: "Alert Slack when the agent is waiting for input",
+  match: { events: ["Notification"] },
+  fn: async (ctx) => {
+    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
+    if (!webhookUrl) return allow();
+
+    const message = String(ctx.payload?.message ?? "Agent is waiting");
+    const project = ctx.session?.cwd ?? "unknown";
+
+    try {
+      await fetch(webhookUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          text: `*${message}*\nProject: \`${project}\``,
+        }),
+        signal: AbortSignal.timeout(5000),
+      });
+    } catch {
+      // Slack अगर पहुंचने योग्य नहीं है तो कभी भी agent को block न करें
+    }
+
+    return allow();
+  },
+});
+```
+
+इंस्टॉल करें:
+
+```bash
+SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
+```
+
+---
+
+## Agents को एक branch पर रखें
+
+Agents को branches को switch करने या protected ones में push करने से रोकें।
+
+```javascript
+import { customPolicies, allow, deny } from "failproofai";
+
+customPolicies.add({
+  name: "stay-on-branch",
+  description: "Prevent the agent from checking out other branches",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+checkout\s+(?!-b)/.test(cmd)) {
+      return deny("Stay on the current branch. Create a new branch with -b if needed.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## Commits से पहले tests की आवश्यकता करें
+
+Agents को commit करने से पहले tests चलाने की याद दिलाएं।
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "test-before-commit",
+  description: "Remind the agent to run tests before committing",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Run tests before committing. Use `npm test` or `bun test` first.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## एक production repo को lock down करें
+
+एक project-level config को commit करें ताकि आपकी टीम के हर developer को समान policies मिलें।
+
+अपने repo में `.failproofai/policies-config.json` बनाएं:
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-force-push",
+    "block-push-master",
+    "block-env-files",
+    "sanitize-api-keys",
+    "sanitize-jwt"
+  ],
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "production"]
+    }
+  }
+}
+```
+
+फिर इसे commit करें:
+
+```bash
+git add .failproofai/policies-config.json
+git commit -m "Add failproofai team policies"
+```
+
+जिस भी टीम member के पास failproofai installed है वह स्वचालित रूप से ये rules को pick up करेगा।
+
+---
+
+## अधिक उदाहरण
+
+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-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/for-agents.mdx

@@ -0,0 +1,38 @@
+---
+title: "एजेंटों के लिए"
+description: "एक कमांड में अपने कोडिंग एजेंट में Failproof AI नॉलेज जोड़ें। Claude Code, Cursor, Windsurf और अन्य के साथ काम करता है।"
+---
+
+एक कमांड में अपने कोडिंग एजेंट में संपूर्ण Failproof AI संदर्भ जोड़ें। Claude Code, Cursor, Windsurf और किसी भी अन्य एजेंट के साथ काम करता है जो कौशल का समर्थन करते हैं।
+
+```bash
+npx skills add https://docs.befailproof.ai
+```
+
+`npx skills` पता लगाता है कि आपके पास कौन से एजेंट स्थापित हैं और प्रत्येक के लिए सही प्रारूप में कौशल को स्वचालित रूप से जोड़ता है।
+
+## कौशल क्या कवर करता है
+
+| क्षेत्र | क्या शामिल है |
+|------|----------------|
+| नीतियां | निर्मित नीति के नाम, ईवेंट प्रकार, पैरामीटर, सक्षम/अक्षम |
+| कस्टम नीतियां | `customPolicies.add()`, मैच फ़िल्टर, `allow`/`deny`/`instruct` API |
+| संदर्भ ऑब्जेक्ट | `ctx.eventType`, `ctx.toolName`, `ctx.toolInput`, `ctx.session` |
+| कॉन्फ़िगरेशन | `policies-config.json` संरचना, स्कोप विलय, `policyParams` |
+| CLI | `failproofai policies --install`, `--uninstall`, `--custom`, स्कोप |
+| डैशबोर्ड | सेशन व्यूअर, नीति गतिविधि, पर्यावरण चर |
+| आर्किटेक्चर | हुक हैंडलर प्रवाह, निकास कोड, stdin/stdout अनुबंध |
+
+## क्या कौशल पूर्ण है?
+
+Mintlify नेविगेशन में सभी पृष्ठों से `llms.txt` उत्पन्न करता है। Failproof AI दस्तावेज़ पूर्ण API को कवर करते हैं - हर नीति, विकल्प और उदाहरण शामिल है। यदि आपको कुछ लापता लगता है, तो स्रोत `https://docs.befailproof.ai/llms-full.txt` पर है।
+
+लक्षित संदर्भ के लिए, किसी विशिष्ट पृष्ठ के लिए सीधे लिंक करें:
+
+```bash
+# केवल कस्टम नीतियां API
+npx skills add https://docs.befailproof.ai/custom-policies
+
+# केवल निर्मित नीतियां
+npx skills add https://docs.befailproof.ai/built-in-policies
+```

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

@@ -0,0 +1,134 @@
+---
+title: शुरुआत करें
+description: "failproofai इंस्टॉल करें, policies सक्षम करें, और अपने agents को विश्वसनीयता से चलाएं"
+icon: rocket
+---
+
+## आवश्यकताएं
+
+- **Node.js** >= 20.9.0
+- **Bun** >= 1.3.0 (वैकल्पिक - केवल स्रोत से बनाने के लिए आवश्यक)
+
+---
+
+## इंस्टॉलेशन
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+---
+
+## त्वरित शुरुआत
+
+<Steps>
+  <Step title="Policies सक्षम करें">
+    Policies ऐसे नियम हैं जो हर agent tool call से पहले और बाद में चलते हैं। ये विनाशकारी कमांड, गुप्त लीकेज, और अन्य विफलता मोड को नुकसान पहुंचाने से पहले पकड़ते हैं।
+
+    ```bash
+    failproofai policies --install
+    ```
+
+    यह Claude Code की `settings.json` में hook entries लिखता है। आप एकल project के लिए या विशिष्ट policies चुनकर भी इंस्टॉल कर सकते हैं:
+
+    ```bash
+    failproofai policies --install --scope project
+    failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
+    ```
+  </Step>
+  <Step title="सत्यापन करें">
+    ```bash
+    failproofai policies
+    ```
+
+    प्रत्येक policy दिखाता है कि वह सक्षम है या नहीं, और कोई भी कॉन्फ़िगर किए गए पैरामीटर।
+  </Step>
+  <Step title="डैशबोर्ड लॉन्च करें">
+    ```bash
+    failproofai
+    ```
+
+    `http://localhost:8020` पर एक स्थानीय डैशबोर्ड खोलता है जहां आप sessions ब्राउज़ कर सकते हैं, tool calls का निरीक्षण कर सकते हैं, और policies प्रबंधित कर सकते हैं।
+  </Step>
+  <Step title="अपने agent को चलाएं">
+    Claude Code को सामान्य तरीके से शुरू करें। यदि agent कुछ जोखिम भरा करने का प्रयास करता है, तो failproofai इसे स्वचालित रूप से रोक देता है। इसे unattended चलने दें और डैशबोर्ड में देखें कि क्या हुआ।
+  </Step>
+</Steps>
+
+---
+
+## Policies कैसे काम करती हैं
+
+हर बार जब एक agent एक tool चलाता है, Claude Code failproofai को एक subprocess के रूप में कॉल करता है:
+
+```text
+Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON पढ़ता है
+                                                  policies का मूल्यांकन करता है
+                                                  stdout के लिए निर्णय लिखता है
+```
+
+प्रत्येक policy तीन निर्णयों में से एक देता है:
+
+- **allow** - agent सामान्य रूप से आगे बढ़ता है
+- **deny** - कार्रवाई को ब्लॉक किया जाता है, agent को बताया जाता है कि क्यों
+- **instruct** - agent के prompt में अतिरिक्त context जोड़ा जाता है
+
+<Note>
+Policies आपकी स्थानीय प्रक्रिया में चलती हैं। कुछ भी किसी दूरस्थ सेवा को नहीं भेजा जाता है।
+</Note>
+
+---
+
+## डेटा स्टोरेज
+
+सभी configuration और logs आपकी मशीन पर रहते हैं:
+
+| पाथ | यह क्या संग्रहीत करता है |
+|------|----------------|
+| `~/.failproofai/policies-config.json` | Global policy config |
+| `~/.failproofai/hook-activity.jsonl` | Hook execution history |
+| `~/.failproofai/hook.log` | Custom hook errors के लिए डीबग log |
+| `.failproofai/policies-config.json` | Per-project config (committed) |
+| `.failproofai/policies-config.local.json` | व्यक्तिगत overrides (gitignored) |
+
+---
+
+## अनइंस्टॉल करना
+
+```bash
+failproofai policies --uninstall
+```
+
+`~/.claude/settings.json` से hook entries को हटाता है। `~/.failproofai/` में config files रखी जाती हैं।
+
+---
+
+## अगले कदम
+
+<CardGroup cols={2}>
+
+<Card title="Configuration" icon="gear" href="/hi/configuration">
+  Scopes और config file format
+</Card>
+
+<Card title="Built-in policies" icon="shield" href="/hi/built-in-policies">
+  सभी 26 policies के साथ parameters
+</Card>
+
+<Card title="Custom policies" icon="code" href="/hi/custom-policies">
+  JavaScript में अपनी policies लिखें
+</Card>
+
+<Card title="Agent monitor" icon="chart-line" href="/hi/dashboard">
+  Sessions की निगरानी करें और policy activity की समीक्षा करें
+</Card>
+
+</CardGroup>

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

@@ -0,0 +1,57 @@
+---
+title:  Failproof AI
+description: "हुकस और पॉलिसीज़ को प्रबंधित करें जो आपके AI एजेंटों को विश्वसनीय और स्वायत्त रूप से चलाते रहते हैं"
+---
+
+[![npm weekly downloads](https://img.shields.io/npm/dw/failproofai?style=flat-square&color=2ea44f)](https://www.npmjs.com/package/failproofai)
+
+हुकस और पॉलिसीज़ जो आपके AI एजेंटों को विश्वसनीय रखते हैं और स्वायत्त रूप से चलाते हैं - **Claude Code** और **Agents SDK** के लिए।
+
+AI एजेंट अनुमानित तरीकों से विफल होते हैं। वे विनाशकारी कमांड चलाते हैं, राज़ सिकोड़ते हैं, कार्य से भटकते हैं, लूप में फंसते हैं, या सीधे मुख्य शाखा में पुश करते हैं। अनुचर छोड़ने पर, छोटी विफलताएं बड़ी हो जाती हैं।
+
+Failproof AI इसे **पॉलिसीज़** के साथ हल करता है - नियम जो प्रत्येक एजेंट टूल कॉल में हुक करते हैं और **विफलताओं का पता लगा** सकते हैं, **उन्हें कम कर** सकते हैं (ब्लॉक करना, निर्देश देना, साफ़ करना), और **आपको सतर्क कर** सकते हैं जब कुछ ध्यान की जरूरत हो। एक स्थानीय डैशबोर्ड आपको बाद में सब कुछ समीक्षा करने देता है।
+
+सब कुछ स्थानीय रूप से चलता है। कोई डेटा आपकी मशीन से बाहर नहीं जाता।
+
+## शुरुआत करें
+
+<CardGroup cols={2}>
+
+<Card title="26 निर्मित पॉलिसीज़" icon="shield" href="/hi/built-in-policies">
+  विनाशकारी कमांड को ब्लॉक करें, राज़ का रिसाव रोकें, एजेंटों को प्रोजेक्ट सीमाओं के अंदर रखें, और बहुत कुछ - तुरंत ही उपलब्ध।
+</Card>
+
+<Card title="कस्टम पॉलिसीज़" icon="code" href="/hi/custom-policies">
+  JavaScript में अपने स्वयं के नियम लिखें एक सरल allow / deny / instruct API के साथ।
+</Card>
+
+<Card title="एजेंट मॉनिटर" icon="chart-line" href="/hi/dashboard">
+  देखें कि आपके एजेंटों ने जब आप दूर थे तब क्या किया। सेशन ब्राउज़ करें, टूल कॉल की जांच करें, समीक्षा करें कि पॉलिसीज़ कहां सक्रिय हुईं।
+</Card>
+
+<Card title="आसान कॉन्फ़िगरेशन" icon="gear" href="/hi/configuration">
+  किसी भी पॉलिसी को कोड के बिना ट्यून करें। अनुमतिसूचियां, संरक्षित शाखाएं, या प्रति-प्रोजेक्ट या वैश्विक रूप से सीमाएं सेट करें।
+</Card>
+
+</CardGroup>
+
+## त्वरित शुरुआत
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+```bash
+failproofai policies --install   # पॉलिसीज़ सक्षम करें
+failproofai                      # डैशबोर्ड लॉन्च करें
+```
+
+पूर्ण विस्तृत मार्गदर्शन के लिए [शुरुआत करना](/hi/getting-started) गाइड देखें।

package/.next/standalone/docs/hi/package-aliases.mdx

@@ -0,0 +1,82 @@
+---
+title: पैकेज एलियास
+description: "पंजीकृत typosquat-prevention एलियास और वे कैसे काम करते हैं"
+icon: copy
+---
+
+## आधिकारिक पैकेज
+
+canonical npm पैकेज **`failproofai`** है:
+
+```bash
+npm install -g failproofai
+# या
+bun add -g failproofai
+```
+
+---
+
+## हम एलियास नामों को क्यों मालिकाना करते हैं
+
+Typosquatting एक सामान्य supply-chain हमला है जहां एक दुर्भावनापूर्ण अभिनेता एक पैकेज नाम पंजीकृत करता है जो एक लोकप्रिय पैकेज से केवल एक कीस्ट्रोक दूर है। जो उपयोगकर्ता install कमांड को गलत तरीके से टाइप करते हैं, वे आक्रमणकारी-नियंत्रित कोड चलाते हुए समाप्त होते हैं जिसमें पूर्ण सिस्टम एक्सेस होता है - यह बिल्कुल वही खतरा है जिसके खिलाफ Failproof AI की रक्षा करने के लिए डिज़ाइन किया गया है।
+
+इस सतह को समाप्त करने के लिए, **हम `failproofai` के सभी सामान्य गलतियों और फॉर्मेटिंग वेरिएंट को npm पर proactively मालिकाना करते हैं**। इनमें से कोई भी नाम एक तीसरे पक्ष द्वारा पंजीकृत नहीं किया जा सकता। प्रत्येक एक पतला proxy है जो real `failproofai` पैकेज को install करता है और delegate करता है।
+
+---
+
+## पंजीकृत एलियास
+
+**फॉर्मेटिंग वेरिएंट** - "failproof ai" लिखने के विभिन्न तरीके:
+
+| पैकेज | स्थिति |
+|---------|--------|
+| `failproof` | ✅ Published |
+| `failproof-ai` | ⏳ npm समर्थन की प्रतीक्षा |
+| `fail-proof-ai` | ⏳ npm समर्थन की प्रतीक्षा |
+| `failproof_ai` | ⏳ npm समर्थन की प्रतीक्षा |
+| `fail_proof_ai` | ⏳ npm समर्थन की प्रतीक्षा |
+| `fail-proofai` | ⏳ npm समर्थन की प्रतीक्षा |
+
+**`failprof*` typos** - "proof" से एक `o` छूट गया:
+
+| पैकेज | स्थिति |
+|---------|--------|
+| `failprof` | ✅ Published |
+| `failprof-ai` | ✅ Published |
+| `failprofai` | ⏳ npm समर्थन की प्रतीक्षा |
+| `fail-prof-ai` | ⏳ npm समर्थन की प्रतीक्षा |
+| `failprof_ai` | ⏳ npm समर्थन की प्रतीक्षा |
+
+**`faliproof*` typos** - `a` और `i` को स्थानांतरित किया गया:
+
+| पैकेज | स्थिति |
+|---------|--------|
+| `faliproof` | ✅ Published |
+| `faliproof-ai` | ✅ Published |
+| `faliproofai` | ⏳ npm समर्थन की प्रतीक्षा |
+
+> **क्यों pending है?** npm की spam-prevention नीति उन नामों को ब्लॉक करती है जो punctuation को हटाने और similarity checks चलाने के बाद किसी existing पैकेज के समान normalize होते हैं। हमने इन नामों को anti-squatting उद्देश्यों के लिए आरक्षित करने के लिए npm समर्थन से संपर्क किया है। वे approval के बाद सक्रिय किए जाएंगे।
+
+आप किसी भी प्रकाशित alias को सत्यापित कर सकते हैं कि यह हमारे द्वारा मालिकाना है:
+
+```bash
+npm info failproof
+# देखें: maintainers फील्ड में "ExosphereHost Inc."
+```
+
+---
+
+## एलियास कैसे काम करते हैं
+
+प्रत्येक alias पैकेज:
+
+1. `failproofai` को एक dependency के रूप में सूचीबद्ध करता है - इसलिए real पैकेज (इसके `postinstall` hook setup सहित) install पर चलता है
+2. अपने स्वयं के नाम से मेल खाने वाला एक binary expose करता है (उदाहरण के लिए `failprof-ai`) जो सभी arguments को `failproofai` binary में proxy करता है
+
+proxy एक दो-पंक्ति Node स्क्रिप्ट है; कोई logic नहीं है, कोई network calls नहीं है, और `failproofai` स्वयं जो करता है उससे परे कोई data collection नहीं है।
+
+---
+
+## यदि आपको कोई नाम मिल जाता है जिसे हमने मिस किया है
+
+[exospherehost/failproofai](https://github.com/exospherehost/failproofai/issues) पर एक issue खोलें और हम इसे पंजीकृत करेंगे।