failproofai 0.0.2 → 0.0.4-beta.0

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

@@ -0,0 +1,357 @@
+---
+title: कस्टम पॉलिसीज़
+description: "JavaScript में अपने नियम लिखें - कन्वेंशन्स को लागू करें, ड्रिफ़्ट को रोकें, विफलताओं का पता लगाएं, बाहरी सिस्टम्स के साथ इंटीग्रेट करें"
+icon: code
+---
+
+कस्टम पॉलिसीज़ आपको किसी भी एजेंट व्यवहार के लिए नियम लिखने देती हैं: प्रोजेक्ट कन्वेंशन्स को लागू करें, ड्रिफ़्ट को रोकें, विनाशकारी ऑपरेशन्स को गेट करें, स्टक एजेंट्स का पता लगाएं, या Slack, अनुमोदन वर्कफ़्लो और बहुत कुछ के साथ इंटीग्रेट करें। वे built-in पॉलिसीज़ के समान हुक इवेंट सिस्टम और `allow`, `deny`, `instruct` डिसीजन्स का उपयोग करते हैं।
+
+---
+
+## क्विक उदाहरण
+
+```js
+// my-policies.js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "no-production-writes",
+  description: "Block writes to paths containing 'production'",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Write" && ctx.toolName !== "Edit") return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("production")) {
+      return deny("Writes to production paths are blocked");
+    }
+    return allow();
+  },
+});
+```
+
+इसे इंस्टॉल करें:
+
+```bash
+failproofai policies --install --custom ./my-policies.js
+```
+
+---
+
+## कस्टम पॉलिसीज़ लोड करने के दो तरीके
+
+### विकल्प 1: कन्वेंशन-आधारित (अनुशंसित, v0.0.2-beta.7+)
+
+`.failproofai/policies/` में `*policies.{js,mjs,ts}` फ़ाइलें ड्रॉप करें और वे स्वचालित रूप से लोड हो जाती हैं — कोई फ़्लैग या कॉन्फ़िग परिवर्तन की आवश्यकता नहीं है। यह git hooks की तरह काम करता है: एक फ़ाइल ड्रॉप करें, यह बस काम करता है।
+
+```
+# प्रोजेक्ट स्तर — 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 पॉलिसीज़ के साथ काम करता है
+
+<Tip>
+कन्वेंशन पॉलिसीज़ एक टीम के साथ पॉलिसीज़ साझा करने का सबसे आसान तरीका हैं। `.failproofai/policies/` को git में कमिट करें और हर टीम मेंबर को वे स्वचालित रूप से मिलते हैं।
+</Tip>
+
+### विकल्प 2: स्पष्ट फ़ाइल पाथ
+
+```bash
+# कस्टम पॉलिसीज़ फ़ाइल के साथ इंस्टॉल करें
+failproofai policies --install --custom ./my-policies.js
+
+# पॉलिसीज़ फ़ाइल पाथ को बदलें
+failproofai policies --install --custom ./new-policies.js
+
+# कॉन्फ़िग से कस्टम पॉलिसीज़ पाथ को हटाएं
+failproofai policies --uninstall --custom
+```
+
+रिज़ॉल्व किया गया निरपेक्ष पाथ `policies-config.json` में `customPoliciesPath` के रूप में संग्रहीत होता है। फ़ाइल हर हुक इवेंट पर ताज़ा लोड की जाती है - इवेंट्स के बीच कोई कैशिंग नहीं होती है।
+
+### दोनों को एक साथ उपयोग करना
+
+कन्वेंशन पॉलिसीज़ और स्पष्ट `--custom` फ़ाइल एक साथ मौजूद हो सकते हैं। लोड ऑर्डर:
+
+1. स्पष्ट `customPoliciesPath` फ़ाइल (यदि कॉन्फ़िगर किया गया हो)
+2. प्रोजेक्ट कन्वेंशन फ़ाइलें (`{cwd}/.failproofai/policies/`, वर्णक्रम)
+3. यूजर कन्वेंशन फ़ाइलें (`~/.failproofai/policies/`, वर्णक्रम)
+
+---
+
+## API
+
+### इंपोर्ट
+
+```js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+```
+
+### `customPolicies.add(hook)`
+
+एक पॉलिसी को रजिस्टर करता है। एक ही फ़ाइल में कई पॉलिसीज़ के लिए आवश्यकतानुसार इसे कॉल करें।
+
+```ts
+customPolicies.add({
+  name: string;                         // आवश्यक - अद्वितीय पहचानकर्ता
+  description?: string;                 // `failproofai policies` आउटपुट में दिखाया गया
+  match?: { events?: HookEventType[] }; // इवेंट प्रकार द्वारा फ़िल्टर करें; सभी से मेल खाने के लिए छोड़ दें
+  fn: (ctx: PolicyContext) => PolicyResult | Promise<PolicyResult>;
+});
+```
+
+### डिसीजन हेल्पर्स
+
+| फंक्शन | प्रभाव | कब उपयोग करें |
+|----------|--------|----------|
+| `allow()` | ऑपरेशन को चुप से अनुमति दें | कार्रवाई सुरक्षित है, कोई संदेश की आवश्यकता नहीं |
+| `deny(message)` | ऑपरेशन को ब्लॉक करें | एजेंट को यह कार्रवाई नहीं करनी चाहिए |
+| `instruct(message)` | बिना ब्लॉक किए संदर्भ जोड़ें | एजेंट को ट्रैक पर रहने के लिए अतिरिक्त संदर्भ दें |
+
+`deny(message)` - संदेश Claude को `"Blocked by failproofai:"` के साथ प्रीफ़िक्स किया गया दिखाई देता है। एक एकल `deny` सभी आगे के मूल्यांकन को शॉर्ट-सर्किट करता है।
+
+`instruct(message)` - संदेश वर्तमान टूल कॉल के लिए Claude के संदर्भ में जोड़ा जाता है। सभी `instruct` संदेश एकत्रित किए जाते हैं और एक साथ डिलीवर किए जाते हैं।
+
+<Tip>
+`policyParams` में `hint` फ़ील्ड जोड़कर किसी भी `deny` या `instruct` संदेश के लिए अतिरिक्त निर्देश जोड़ सकते हैं — कोई कोड परिवर्तन की आवश्यकता नहीं है। यह कस्टम (`custom/`), प्रोजेक्ट कन्वेंशन (`.failproofai-project/`), और यूजर कन्वेंशन (`.failproofai-user/`) पॉलिसीज़ के लिए भी काम करता है। विवरण के लिए [कॉन्फ़िगरेशन → hint](/hi/configuration#hint-cross-cutting) देखें।
+</Tip>
+
+### सूचनात्मक allow संदेश (बीटा)
+
+<Note>
+`allow(message)` एक बीटा फीचर है जो v0.0.2-beta.3 के बाद से उपलब्ध है। API भविष्य की रिलीज़ में बदल सकता है। पहली संस्करणें केवल बिना तर्क के `allow()` का समर्थन करती हैं।
+</Note>
+
+`allow(message)` ऑपरेशन को अनुमति देता है **और** Claude को एक सूचनात्मक संदेश भेजता है। संदेश हुक हैंडलर के stdout प्रतिक्रिया में `additionalContext` के रूप में डिलीवर किया जाता है — `instruct` द्वारा उपयोग किया जाने वाला समान तंत्र, लेकिन शब्दार्थ रूप से अलग: यह एक सतर्कता नहीं, एक स्थिति अपडेट है।
+
+| फंक्शन | प्रभाव | कब उपयोग करें |
+|----------|--------|----------|
+| `allow(message)` | अनुमति दें और Claude को संदर्भ भेजें | एक जांच पास होने की पुष्टि करें, या बताएं कि जांच को क्यों छोड़ा गया |
+
+उपयोग के मामले:
+- **स्थिति पुष्टिकरण:** `allow("All CI checks passed.")` — Claude को बताता है कि सब कुछ हरा है
+- **Fail-open व्याख्याएं:** `allow("GitHub CLI not installed, skipping CI check.")` — Claude को बताता है कि जांच को क्यों छोड़ा गया ताकि इसके पास पूरा संदर्भ हो
+- **कई संदेश जमा होते हैं:** यदि कई पॉलिसीज़ प्रत्येक `allow(message)` रिटर्न करते हैं, तो सभी संदेश नई लाइनों के साथ जुड़ते हैं और एक साथ डिलीवर होते हैं
+
+```js
+customPolicies.add({
+  name: "confirm-branch-status",
+  match: { events: ["Stop"] },
+  fn: async (ctx) => {
+    const cwd = ctx.session?.cwd;
+    if (!cwd) return allow("No working directory, skipping branch check.");
+
+    // ... check branch status ...
+    if (allPushed) {
+      return allow("Branch is up to date with remote.");
+    }
+    return deny("Unpushed changes detected.");
+  },
+});
+```
+
+### `PolicyContext` फील्ड्स
+
+| फील्ड | प्रकार | विवरण |
+|-------|------|-------------|
+| `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
+| `toolName` | `string \| undefined` | कॉल किया जा रहा टूल (जैसे `"Bash"`, `"Write"`, `"Read"`) |
+| `toolInput` | `Record<string, unknown> \| undefined` | टूल के इनपुट पैरामीटर्स |
+| `payload` | `Record<string, unknown>` | Claude Code से पूर्ण raw इवेंट पेलोड |
+| `session` | `SessionMetadata \| undefined` | सेशन संदर्भ (नीचे देखें) |
+
+### `SessionMetadata` फील्ड्स
+
+| फील्ड | प्रकार | विवरण |
+|-------|------|-------------|
+| `sessionId` | `string` | Claude Code सेशन पहचानकर्ता |
+| `cwd` | `string` | Claude Code सेशन की वर्किंग डायरेक्टरी |
+| `transcriptPath` | `string` | सेशन की JSONL ट्रांस्क्रिप्ट फ़ाइल का पाथ |
+
+### इवेंट प्रकार
+
+| इवेंट | कब फायर होता है | `toolInput` सामग्री |
+|-------|--------------|----------------------|
+| `PreToolUse` | Claude एक टूल चलाने से पहले | टूल का इनपुट (जैसे Bash के लिए `{ command: "..." }`) |
+| `PostToolUse` | एक टूल पूरा होने के बाद | टूल का इनपुट + `tool_result` (आउटपुट) |
+| `Notification` | जब Claude एक नोटिफिकेशन भेजता है | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - हुक्स को हमेशा `allow()` रिटर्न करना चाहिए, वे नोटिफिकेशन्स को ब्लॉक नहीं कर सकते |
+| `Stop` | जब Claude सेशन समाप्त होता है | खाली |
+
+---
+
+## मूल्यांकन क्रम
+
+पॉलिसीज़ का मूल्यांकन इस क्रम में किया जाता है:
+
+1. Built-in पॉलिसीज़ (परिभाषा क्रम में)
+2. `customPoliciesPath` से स्पष्ट कस्टम पॉलिसीज़ (`.add()` क्रम में)
+3. प्रोजेक्ट `.failproofai/policies/` से कन्वेंशन पॉलिसीज़ (फ़ाइलें वर्णक्रम, प्रत्येक के भीतर `.add()` क्रम)
+4. यूजर `~/.failproofai/policies/` से कन्वेंशन पॉलिसीज़ (फ़ाइलें वर्णक्रम, प्रत्येक के भीतर `.add()` क्रम)
+
+<Note>
+पहला `deny` सभी बाद की पॉलिसीज़ को शॉर्ट-सर्किट करता है। सभी `instruct` संदेश एकत्रित किए जाते हैं और एक साथ डिलीवर किए जाते हैं।
+</Note>
+
+---
+
+## ट्रांसिटिव इंपोर्ट्स
+
+कस्टम पॉलिसी फ़ाइलें रिलेटिव पाथ्स का उपयोग करके स्थानीय मॉड्यूल्स को इंपोर्ट कर सकती हैं:
+
+```js
+// my-policies.js
+import { isBlockedPath } from "./utils.js";
+import { checkApproval } from "./approval-client.js";
+
+customPolicies.add({
+  name: "approval-gate",
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const approved = await checkApproval(ctx.toolInput?.command, ctx.session?.sessionId);
+    return approved ? allow() : deny("Approval required for this command");
+  },
+});
+```
+
+एंट्री फ़ाइल से पहुंचने योग्य सभी रिलेटिव इंपोर्ट्स को रिज़ॉल्व किया जाता है। यह `from "failproofai"` इंपोर्ट्स को वास्तविक dist पाथ में फिर से लिखकर और ESM संगतता सुनिश्चित करने के लिए अस्थायी `.mjs` फ़ाइलें बनाकर लागू किया जाता है।
+
+---
+
+## इवेंट टाइप फ़िल्टरिंग
+
+`match.events` का उपयोग करके यह सीमित करें कि कब एक पॉलिसी फायर होती है:
+
+```js
+customPolicies.add({
+  name: "require-summary-on-stop",
+  match: { events: ["Stop"] },
+  fn: async (ctx) => {
+    // केवल तब फायर होता है जब सेशन समाप्त होता है
+    // ctx.session.transcriptPath में पूरा सेशन लॉग होता है
+    return allow();
+  },
+});
+```
+
+हर इवेंट प्रकार पर फायर करने के लिए `match` को पूरी तरह छोड़ दें।
+
+---
+
+## त्रुटि हैंडलिंग और विफलता मोड्स
+
+कस्टम पॉलिसीज़ **fail-open** हैं: त्रुटियां कभी built-in पॉलिसीज़ को ब्लॉक नहीं करती हैं या हुक हैंडलर को क्रैश नहीं करती हैं।
+
+| विफलता | व्यवहार |
+|---------|----------|
+| `customPoliciesPath` सेट नहीं है | कोई स्पष्ट कस्टम पॉलिसीज़ नहीं चलती हैं; कन्वेंशन पॉलिसीज़ और built-ins सामान्य रूप से जारी रहते हैं |
+| फ़ाइल नहीं मिली | `~/.failproofai/hook.log` में चेतावनी लॉग की जाती है; built-ins जारी रहते हैं |
+| सिंटैक्स/इंपोर्ट त्रुटि (स्पष्ट) | `~/.failproofai/hook.log` में त्रुटि लॉग की जाती है; स्पष्ट कस्टम पॉलिसीज़ छोड़ दी जाती हैं |
+| सिंटैक्स/इंपोर्ट त्रुटि (कन्वेंशन) | त्रुटि लॉग की जाती है; वह फ़ाइल छोड़ दी जाती है, अन्य कन्वेंशन फ़ाइलें अभी भी लोड होती हैं |
+| `fn` रनटाइम पर throw करता है | त्रुटि लॉग की जाती है; वह हुक `allow` के रूप में माना जाता है; अन्य हुक्स जारी रहते हैं |
+| `fn` 10s से अधिक समय लेता है | टाइमआउट लॉग किया जाता है; `allow` के रूप में माना जाता है |
+| कन्वेंशन डायरेक्टरी नहीं मिली | कोई कन्वेंशन पॉलिसीज़ नहीं चलती हैं; कोई त्रुटि नहीं |
+
+<Tip>
+कस्टम पॉलिसी त्रुटियों को डिबग करने के लिए, लॉग फ़ाइल को देखें:
+
+```bash
+tail -f ~/.failproofai/hook.log
+```
+</Tip>
+
+---
+
+## पूरा उदाहरण: कई पॉलिसीज़
+
+```js
+// my-policies.js
+import { customPolicies, allow, deny, instruct } from "failproofai";
+
+// एजेंट को secrets/ डायरेक्टरी में लिखने से रोकें
+customPolicies.add({
+  name: "block-secrets-dir",
+  description: "Prevent agent from writing to secrets/ directory",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
+    const path = ctx.toolInput?.file_path ?? "";
+    if (path.includes("secrets/")) return deny("Writing to secrets/ is not permitted");
+    return allow();
+  },
+});
+
+// एजेंट को ट्रैक पर रखें: कमिट करने से पहले टेस्ट्स सत्यापित करें
+customPolicies.add({
+  name: "remind-test-before-commit",
+  description: "Keep the agent on track: verify tests pass before committing",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = ctx.toolInput?.command ?? "";
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Verify all tests pass before committing. Run `bun test` if you haven't already.");
+    }
+    return allow();
+  },
+});
+
+// फ्रीज़ अवधि के दौरान अनियोजित निर्भरता परिवर्तन को रोकें
+customPolicies.add({
+  name: "dependency-freeze",
+  description: "Prevent unplanned dependency changes during freeze period",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = ctx.toolInput?.command ?? "";
+    const isInstall = /^(npm install|yarn add|bun add|pnpm add)\s+\S/.test(cmd);
+    if (isInstall && process.env.DEPENDENCY_FREEZE === "1") {
+      return deny("Package installs are frozen. Unset DEPENDENCY_FREEZE to allow.");
+    }
+    return allow();
+  },
+});
+
+export { customPolicies };
+```
+
+---
+
+## उदाहरण
+
+`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` | कन्वेंशन-आधारित वर्कफ़्लो पॉलिसीज़ (टेस्ट रिमाइंडर्स, ऑडिट फ़ाइल राइट्स) |
+
+### स्पष्ट फ़ाइल उदाहरण्स का उपयोग करना
+
+```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/
+```
+
+कोई इंस्टॉल कमांड की आवश्यकता नहीं है — फ़ाइलें अगली हुक इवेंट पर स्वचालित रूप से लोड हो जाती हैं।

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

@@ -0,0 +1,142 @@
+---
+title: डैशबोर्ड
+description: "एजेंट सेशन की निगरानी करें, टूल कॉल की समीक्षा करें, और नीतियों का प्रबंधन करें"
+icon: chart-line
+---
+
+failproofai डैशबोर्ड आपके AI एजेंट सेशन की निगरानी और नीतियों के प्रबंधन के लिए एक स्थानीय वेब एप्लिकेशन है। देखें कि आपके एजेंट आपके न होने के दौरान क्या करते थे।
+
+---
+
+## डैशबोर्ड शुरू करना
+
+```bash
+failproofai
+```
+
+`http://localhost:8020` पर खुलता है।
+
+डैशबोर्ड सीधे फाइलसिस्टम से पढ़ता है - आपके Claude Code प्रोजेक्ट फोल्डर और failproofai कॉन्फ़िगरेशन फाइलें। कोई भी डेटा दूरस्थ सेवा में नहीं लिखा जाता है।
+
+---
+
+## पृष्ठ
+
+### प्रोजेक्ट्स
+
+आपकी मशीन पर मिले सभी Claude Code प्रोजेक्ट्स को सूचीबद्ध करता है। प्रोजेक्ट्स `~/.claude/projects/` से खोजे जाते हैं (या `CLAUDE_PROJECTS_PATH` द्वारा सेट किए गए पथ से)।
+
+प्रत्येक प्रोजेक्ट दिखाता है:
+- प्रोजेक्ट का नाम (फोल्डर पथ से व्युत्पन्न)
+- सेशन की संख्या
+- सबसे हाल की सेशन गतिविधि की तारीख
+
+प्रोजेक्ट के सेशन देखने के लिए उस पर क्लिक करें।
+
+### सेशन्स
+
+एक प्रोजेक्ट के भीतर सभी सेशन्स को सूचीबद्ध करता है। प्रत्येक सेशन दिखाता है:
+- सेशन ID
+- शुरुआत और समाप्ति समय
+- टूल कॉल की संख्या
+- हुक गतिविधि गणना (नीतियां जो सक्रिय हुईं)
+
+सूची को कम करने के लिए दिनांक सीमा फ़िल्टर और सेशन ID खोज का उपयोग करें। सेशन्स पृष्ठांकित होते हैं।
+
+सेशन दर्शक खोलने के लिए एक सेशन पर क्लिक करें।
+
+### सेशन दर्शक
+
+सेशन दर्शक स्वायत्त एजेंट के लिए मुख्य प्रश्न का उत्तर देता है: एजेंट ने क्या किया, और क्या वह सही रास्ते पर रहा? यह एक सेशन में हुई हर चीज की समयरेखा दिखाता है:
+
+- **संदेश** - Claude के पाठ प्रतिक्रियाएं और उपयोगकर्ता संकेत
+- **टूल कॉल्स** - हर टूल जो Claude ने आह्वान किया, इसके इनपुट और आउटपुट के साथ
+- **नीति गतिविधि** - प्रत्येक टूल कॉल के लिए, कौन सी नीतियां सक्रिय हुईं और उन्होंने कौन सा निर्णय लौटाया
+
+शीर्ष पर सांख्यिकी पट्टी सेशन अवधि, कुल टूल कॉल्स, और हुक निर्णयों का सारांश (allow / deny / instruct गणना) दिखाती है।
+
+आप डाउनलोड बटन का उपयोग करके सेशन को ZIP या JSONL फाइल के रूप में निर्यात कर सकते हैं।
+
+### नीतियां
+
+नीतियों के प्रबंधन और गतिविधि की समीक्षा के लिए एक दो-टैब पृष्ठ।
+
+<Tabs>
+  <Tab title="नीतियां टैब">
+  - एक क्लिक के साथ व्यक्तिगत नीतियों को चालू या बंद करें (`~/.failproofai/policies-config.json` में लिखता है)
+  - किसी नीति को उसके पैरामीटर को कॉन्फ़िगर करने के लिए विस्तृत करें (नीतियों के लिए जो `policyParams` का समर्थन करते हैं)
+  - दिए गए स्कोप के लिए हुक्स को स्थापित या हटाएं
+  - एक कस्टम नीतियां फाइल पथ सेट करें
+  </Tab>
+  <Tab title="गतिविधि टैब">
+  - सभी सेशन्स में हर हुक घटना का पूर्ण पृष्ठांकित इतिहास जो सक्रिय हुई है
+  - नीति नाम, सेशन ID, टूल नाम, या निर्णय द्वारा खोजें
+  - प्रत्येक पंक्ति दिखाती है: समय, नीति नाम, निर्णय, टूल नाम, सेशन ID, और deny/instruct निर्णयों का कारण
+  </Tab>
+</Tabs>
+
+---
+
+## ऑटो-रीफ्रेश
+
+डैशबोर्ड के शीर्ष नेविगेशन में एक ऑटो-रीफ्रेश टॉगल है। जब सक्षम किया जाता है, तो वर्तमान पृष्ठ नई सेशन्स और नीति गतिविधि दिखाने के लिए समय-समय पर रीफ्रेश होता है। दीर्घकालीन स्वायत्त एजेंट सेशन्स की निगरानी के लिए आवश्यक है।
+
+---
+
+## पृष्ठों को अक्षम करना
+
+यदि आपको डैशबोर्ड के केवल कुछ हिस्सों की आवश्यकता है, तो `FAILPROOFAI_DISABLE_PAGES` को पृष्ठ नामों की अल्पविराम-सूची पर सेट करें:
+
+```bash
+FAILPROOFAI_DISABLE_PAGES=policies failproofai
+```
+
+मान्य मान: `policies`, `projects`.
+
+---
+
+## थीम
+
+डैशबोर्ड हल्के और गहरे मोड का समर्थन करता है। नेविगेशन बार में बटन के माध्यम से टॉगल करें। वरीयता आपके ब्राउज़र के स्थानीय भंडार में संग्रहीत होती है।
+
+---
+
+## प्रोजेक्ट्स पथ को कॉन्फ़िगर करना
+
+डिफ़ॉल्ट रूप से, डैशबोर्ड मानक Claude Code प्रोजेक्ट्स निर्देशिका से पढ़ता है। कस्टम सेटअप के लिए इसे ओवरराइड करें:
+
+```bash
+CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai
+```
+
+---
+
+## गैर-localhost होस्ट से पहुंचना
+
+जब **dev मोड** में डैशबोर्ड चल रहा है (`npm run dev`) और आप इसे `localhost` के अलावा किसी होस्टनाम से एक्सेस कर रहे हैं - उदाहरण के लिए, एक कस्टम डोमेन, एक दूरस्थ IP, या एक सुरंगबद्ध URL - आप इस तरह एक चेतावनी देख सकते हैं:
+
+```text
+⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
+```
+
+यह Next.js अपने HMR (hot module reload) वेबसॉकेट के लिए क्रॉस-ऑरिजिन पहुंच को ब्लॉक कर रहा है, जो एक dev-only फीचर है। अपने होस्ट को अनुमति देने के लिए, `--allowed-origins` फ्लैग का उपयोग करें:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com
+```
+
+कई होस्ट या IP के लिए, एक अल्पविराम-सूची पास करें:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
+```
+
+आप इसके बजाय `FAILPROOFAI_ALLOWED_DEV_ORIGINS` पर्यावरण चर सेट कर सकते हैं:
+
+```bash
+FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
+```
+
+<Note>
+यह केवल dev मोड पर लागू होता है। जब `failproofai` चल रहा है (production mode), कोई HMR वेबसॉकेट नहीं है और कोई क्रॉस-ऑरिजिन dev संसाधन समस्या नहीं है।
+</Note>