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

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

@@ -1,309 +0,0 @@
----
-
----
-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="सभी बिल्ट-इन policies को सक्षम करें">
-    ```bash
-    failproofai policies --install
-    ```
-  </Step>
-  <Step title="सत्यापित करें कि 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 /` चलाने के लिए कहने का प्रयास करें - यह अवरुद्ध होगा।
-  </Step>
-</Steps>
-
----
-
-## Agents SDK के लिए hooks सेट अप करना
-
-यदि आप [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk) के साथ निर्माण कर रहे हैं, तो आप समान hook system को प्रोग्रामेटिक रूप से उपयोग कर सकते हैं।
-
-<Steps>
-  <Step title="अपने प्रोजेक्ट में failproofai इंस्टॉल करें">
-    ```bash
-    npm install failproofai
-    ```
-  </Step>
-  <Step title="अपने agent में hooks कॉन्फ़िगर करें">
-    अपने agent process को बनाते समय hook commands को पास करें। Hooks उसी तरह फायर होते हैं जैसे Claude Code में - stdin/stdout JSON के माध्यम से:
-
-    ```bash
-    failproofai --hook PreToolUse   # हर tool से पहले कहा जाता है
-    failproofai --hook PostToolUse  # हर tool के बाद कहा जाता है
-    ```
-  </Step>
-  <Step title="अपने agent के लिए एक कस्टम 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="कस्टम policy इंस्टॉल करें">
-    ```bash
-    failproofai policies --install --custom ./my-agent-policies.js
-    ```
-  </Step>
-</Steps>
-
----
-
-## विनाशकारी commands को ब्लॉक करें
-
-सबसे सामान्य सेटअप - agents को अपरिवर्तनीय नुकसान करने से रोकें।
-
-```bash
-failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
-```
-
-यह क्या करता है:
-- `block-sudo` - सभी `sudo` commands को ब्लॉक करता है
-- `block-rm-rf` - recursive file deletion को ब्लॉक करता है
-- `block-force-push` - `git push --force` को ब्लॉक करता है
-- `block-curl-pipe-sh` - remote scripts को shell में pipe करने को ब्लॉक करता है
-
----
-
-## गुप्त जानकारी का लीक होना रोकें
-
-Agents को tool output में credentials देखने या लीक करने से रोकें।
-
-```bash
-failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
-```
-
-ये `PostToolUse` पर फायर होते हैं - एक tool चलने के बाद, ये agent को देखने से पहले output को साफ करते हैं।
-
----
-
-## जब 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 को कभी ब्लॉक न करें
-    }
-
-    return allow();
-  },
-});
-```
-
-इसे इंस्टॉल करें:
-
-```bash
-SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
-```
-
----
-
-## Agents को एक branch पर रखें
-
-Agents को branches स्विच करने या 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 को लॉक डाउन करें
-
-एक project-level config commit करें ताकि आपकी team का हर 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"
-```
-
-हर 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 में शामिल है:
-
-| File | यह क्या दिखाता है |
-|------|---------------|
-| `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/for-agents.mdx

@@ -1,38 +0,0 @@
----
-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

@@ -1,187 +0,0 @@
----
----
-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 से पहले और बाद में चलते हैं। वे विनाशकारी commands, secret leakage, और अन्य failure modes को नुकसान पहुंचाने से पहले रोक देते हैं।
-
-    ```bash
-    failproofai policies --install
-    ```
-
-    यह 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="सत्यापित करें">
-    ```bash
-    failproofai policies
-    ```
-
-    हर policy दिखाता है, चाहे वह सक्षम हो, और कोई भी configured parameters।
-  </Step>
-  <Step title="डैशबोर्ड लॉन्च करें">
-    ```bash
-    failproofai
-    ```
-
-    `http://localhost:8020` पर एक local dashboard खोलता है जहां आप sessions को browse कर सकते हैं, tool calls का inspection कर सकते हैं, और policies को manage कर सकते हैं।
-  </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** - action को ब्लॉक किया जाता है, agent को कारण बताया जाता है
-- **instruct** - agent के prompt में extra context जोड़ा जाता है
-
-<Note>
-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 आपकी machine पर रहते हैं:
-
-| Path | क्या store करता है |
-|------|----------------|
-| `~/.failproofai/policies-config.json` | Global policy config |
-| `~/.failproofai/hook-activity.jsonl` | Hook execution history |
-| `~/.failproofai/hook.log` | Custom hook errors के लिए debug log |
-| `.failproofai/policies-config.json` | Per-project config (committed) |
-| `.failproofai/policies-config.local.json` | Personal 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 with 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 को monitor करें और policy activity की समीक्षा करें
-</Card>
-
-</CardGroup>

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

@@ -1,57 +0,0 @@
----
-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) गाइड देखें।