failproofai 1.0.1-beta.0 → 1.0.1

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

@@ -0,0 +1,359 @@
+---
+---
+title: कस्टम पॉलिसीज
+description: "JavaScript में अपने नियम लिखें - प्रोजेक्ट कन्वेंशन लागू करें, ड्रिफ्ट रोकें, विफलताएं डिटेक्ट करें, बाहरी सिस्टम के साथ इंटीग्रेट करें"
+icon: code
+---
+
+कस्टम पॉलिसीज आपको किसी भी एजेंट व्यवहार के लिए नियम लिखने देती हैं: प्रोजेक्ट कन्वेंशन लागू करें, ड्रिफ्ट रोकें, विनाशकारी ऑपरेशन को गेट करें, फंसे हुए एजेंट्स को डिटेक्ट करें, या Slack, अनुमोदन वर्कफ़्लो और अधिक के साथ इंटीग्रेट करें। वे एक ही हुक इवेंट सिस्टम और `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: कन्वेंशन-आधारित (अनुशंसित)
+
+`.failproofai/policies/` में `*policies.{js,mjs,ts}` फाइलें ड्रॉप करें और वे स्वचालित रूप से लोड हो जाती हैं — कोई फ्लैग या कॉन्फ़िग परिवर्तन की आवश्यकता नहीं। यह git हुक्स की तरह काम करता है: एक फाइल ड्रॉप करें, और यह बस काम करता है।
+
+```
+# प्रोजेक्ट स्तर — git में प्रतिबद्ध, टीम के साथ साझा किया गया
+.failproofai/policies/security-policies.mjs
+.failproofai/policies/workflow-policies.mjs
+
+# यूजर स्तर — व्यक्तिगत, सभी प्रोजेक्ट्स पर लागू
+~/.failproofai/policies/my-policies.mjs
+```
+
+**यह कैसे काम करता है:**
+- प्रोजेक्ट और यूजर दोनों डायरेक्टरीज को स्कैन किया जाता है (यूनियन — पहले-स्कोप-जीत नहीं)
+- फाइलें प्रत्येक डायरेक्टरी में वर्णक्रम में लोड होती हैं। ऑर्डर नियंत्रित करने के लिए `01-`, `02-` से शुरू करें
+- केवल `*policies.{js,mjs,ts}` से मेल खाने वाली फाइलें लोड होती हैं; अन्य फाइलें अनदेखी की जाती हैं
+- प्रत्येक फाइल स्वतंत्र रूप से लोड होती है (प्रति फाइल फेल-ओपन)
+- स्पष्ट `--custom` और बिल्ट-इन पॉलिसीज के साथ साथ काम करता है
+
+<Tip>
+कन्वेंशन पॉलिसीज आपके ऑर्गेनाइजेशन के लिए गुणवत्ता मानक बनाने का सबसे आसान तरीका हैं। `.failproofai/policies/` को git में प्रतिबद्ध करें और हर टीम मेंबर को स्वचालित रूप से एक ही नियम मिलते हैं — कोई प्रति-डेवलपर सेटअप की आवश्यकता नहीं। जैसे-जैसे आपकी टीम नई विफलता के तरीके खोजती है, एक पॉलिसी जोड़ें और पुश करें। समय के साथ ये एक जीवंत गुणवत्ता मानक बन जाते हैं जो हर योगदान के साथ सुधरता रहता है।
+</Tip>
+
+### विकल्प 2: स्पष्ट फाइल पाथ
+
+```bash
+# कस्टम पॉलिसीज फाइल के साथ इंस्टॉल करें
+failproofai policies --install --custom ./my-policies.js
+
+# कस्टम पॉलिसी पाथ बदलें
+failproofai policies --install --custom ./new-policies.js
+
+# कई स्पष्ट फाइलें कॉन्फ़िगर करें (फ्लैग ऑर्डर में लोड)
+failproofai policies --install --custom ./security.js --custom ./workflow.js
+
+# कॉन्फ़िग से सभी स्पष्ट कस्टम पॉलिसी पाथ हटाएं
+failproofai policies --uninstall --custom
+```
+
+रिज़ॉल्व की गई निरपेक्ष पाथें `policies-config.json` में `customPoliciesPaths` के रूप में स्टोर की जाती हैं। कई फाइलें कॉन्फ़िगर करने के लिए `--custom` दोहराएं। लीगेसी `customPoliciesPath` फील्ड का उपयोग करने वाले मौजूदा कॉन्फ़िग्स काम करना जारी रखते हैं। फाइलें हर हुक इवेंट पर ताज़ी लोड होती हैं - इवेंट्स के बीच कोई कैशिंग नहीं है।
+
+प्रत्येक पंजीकृत पॉलिसी डैशबोर्ड में अपने स्वयं के टॉगल के साथ दिखाई देती है। एक पॉलिसी को बंद करने से इसके स्रोत-योग्य ID को `disabledCustomPolicies` में रिकॉर्ड किया जाता है; फाइल और इसकी अन्य पॉलिसीज लोड होना जारी रखती हैं, जबकि अक्षम पॉलिसी इवेंट मिलान से पहले बाहर निकाली जाती है। फाइलों में डुप्लिकेट पॉलिसी नामों के स्वतंत्र टॉगल होते हैं।
+
+### दोनों को एक साथ उपयोग करना
+
+कन्वेंशन पॉलिसीज और स्पष्ट `--custom` फाइलें एक साथ मौजूद हो सकती हैं। लोड ऑर्डर:
+
+1. स्पष्ट `customPoliciesPaths` फाइलें (कॉन्फ़िगर किए गए ऑर्डर में)
+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 संदेश
+
+`allow(message)` ऑपरेशन को अनुमति देता है **और** Claude को एक सूचनात्मक संदेश भेजता है। संदेश हुक हैंडलर के stdout प्रतिक्रिया में `additionalContext` के रूप में डिलीवर किया जाता है — `instruct` द्वारा उपयोग किया गया समान तंत्र, लेकिन अर्थपूर्ण रूप से भिन्न: यह एक चेतावनी नहीं, एक स्थिति अपडेट है।
+
+| फंक्शन | प्रभाव | कब उपयोग करें |
+|----------|--------|----------|
+| `allow(message)` | अनुमति दें और Claude को संदर्भ भेजें | एक चेक पास होने की पुष्टि करें, या समझाएं कि चेक को क्यों छोड़ा गया |
+
+उपयोग के मामले:
+- **स्थिति पुष्टि:** `allow("All CI checks passed.")` — Claude को बताता है कि सब कुछ हरा है
+- **फेल-ओपन व्याख्याएं:** `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.");
+
+    // ... 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. बिल्ट-इन पॉलिसीज (परिभाषा ऑर्डर में)
+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` को पूरी तरह से छोड़ें।
+
+---
+
+## त्रुटि हैंडलिंग और विफलता के तरीके
+
+कस्टम पॉलिसीज **फेल-ओपन** हैं: त्रुटियां कभी बिल्ट-इन पॉलिसीज को ब्लॉक नहीं करती हैं या हुक हैंडलर को क्रैश नहीं करती हैं।
+
+| विफलता | व्यवहार |
+|---------|----------|
+| `customPoliciesPath` सेट नहीं | कोई स्पष्ट कस्टम पॉलिसीज नहीं चलती; कन्वेंशन पॉलिसीज और बिल्ट-इन सामान्य रूप से जारी रहते हैं |
+| फाइल नहीं मिली | `~/.failproofai/hook.log` को चेतावनी लॉग की गई; बिल्ट-इन जारी रहते हैं |
+| सिंटैक्स/इम्पोर्ट त्रुटि (स्पष्ट) | `~/.failproofai/hook.log` को त्रुटि लॉग की गई; स्पष्ट कस्टम पॉलिसीज छोड़ी गई |
+| सिंटैक्स/इम्पोर्ट त्रुटि (कन्वेंशन) | त्रुटि लॉग की गई; वह फाइल छोड़ी गई, अन्य कन्वेंशन फाइलें अभी भी लोड होती हैं |
+| `fn` रनटाइम पर थ्रो होता है | त्रुटि लॉग की गई; वह हुक `allow` के रूप में माना जाता है; अन्य हुक्स जारी रहते हैं |
+| `fn` 10 सेकंड से अधिक समय लेता है | टाइमआउट लॉग किया गया; `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-old/hi/dashboard.mdx

@@ -0,0 +1,152 @@
+---
+---
+title: Dashboard
+description: "Agent सेशन को मॉनिटर करें, tool कॉल की समीक्षा करें, और policies को प्रबंधित करें"
+icon: chart-line
+---
+
+failproofai dashboard एक स्थानीय वेब एप्लिकेशन है जो आपके AI agent सेशन को मॉनिटर करने और policies को प्रबंधित करने के लिए है। देखें कि आपके agents आपके दूर रहते हुए क्या करते रहे।
+
+---
+
+## Dashboard को शुरू करना
+
+```bash
+failproofai
+```
+
+`http://localhost:8020` पर खुलता है।
+
+Dashboard स्थानीय project, session, और failproofai कॉन्फ़िगरेशन डेटा को सीधे फ़ाइल सिस्टम से पढ़ता है। वैकल्पिक प्रमाणित सुविधाएं, जैसे audit reminders और invitations, उन अनुरोधों के लिए आवश्यक जानकारी (ईमेल पते सहित) दूरस्थ API को भेजती हैं।
+
+---
+
+## पृष्ठ
+
+### Projects
+
+आपकी मशीन पर मिले सभी Claude Code, OpenAI Codex, GitHub Copilot CLI _(beta)_, Cursor Agent _(beta)_, OpenCode _(beta)_, Pi _(beta)_, Hermes, OpenClaw, Factory Droid, Devin, Antigravity, और Goose projects की सूची। Claude projects को `~/.claude/projects/` से खोजा जाता है (या `CLAUDE_PROJECTS_PATH` द्वारा सेट किए गए पथ से); Codex projects को `~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl` के तहत प्रत्येक transcript को स्कैन करके और प्रत्येक सेशन की पहली रिकॉर्ड में दर्ज `cwd` द्वारा समूहित करके खोजा जाता है; Copilot CLI projects को `~/.copilot/session-state/<sessionId>/workspace.yaml` को स्कैन करके (`COPILOT_HOME` के माध्यम से कॉन्फ़िगर करने योग्य) और उसके `cwd` फ़ील्ड द्वारा समूहित करके खोजा जाता है; Cursor Agent projects को `~/.cursor/agent-sessions/<sessionId>/` के तहत प्रति-सेशन मेटाडेटा को स्कैन करके (`CURSOR_HOME` के माध्यम से कॉन्फ़िगर करने योग्य, fallbacks के रूप में `conversations/` और `sessions/` की जांच की जाती है) `meta.json` / `session.json` / `workspace.yaml` में `cwd` scalar के लिए खोजा जाता है; OpenCode projects को `~/.local/share/opencode/opencode.db` पर SQLite DB को `opencode db --format json` के माध्यम से क्वेरी करके खोजा जाता है (हम `session` और `project` tables को पढ़ते हैं और `project_id` द्वारा समूहित करते हैं); Pi projects को `~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl` के तहत प्रति-सेशन JSONL transcripts को स्कैन करके (`PI_SESSIONS_DIR` के माध्यम से कॉन्फ़िगर करने योग्य) और प्रत्येक सेशन की पहली रिकॉर्ड से `cwd` को खींचकर खोजा जाता है; Hermes gateway सेशन को हर प्रोफ़ाइल के SQLite store से सीधे पढ़ा जाता है — `~/.hermes/state.db` साथ ही `~/.hermes/profiles/<name>/state.db` (`HERMES_HOME` द्वारा ओवरराइडेबल, या एकल डेटाबेस के लिए `HERMES_DB_PATH`) — और प्रोफ़ाइल और `source` (Slack/Telegram/cli/cron — gateway सेशन के पास कोई cwd नहीं) द्वारा `hermes-<profile>-<source>` projects में समूहित किए जाते हैं; OpenClaw gateway सेशन को `~/.openclaw/agents/<agentId>/sessions/*.jsonl` से पढ़ा जाता है और agent और channel द्वारा `openclaw-<agentId>-<channel>` projects में समूहित किए जाते हैं (साथ ही cwd-less); Factory Droid projects को `~/.factory/sessions/<encoded-cwd>/*.jsonl` पर JSONL transcripts से खोजा जाता है और cwd द्वारा समूहित किया जाता है; Devin projects इसके SQLite DB से `~/.local/share/devin/cli/sessions.db` पर (प्रत्येक सेशन के `working_directory` द्वारा समूहित); Antigravity projects `~/.gemini/antigravity-cli/brain/<conversationId>/…/transcript_full.jsonl` पर JSONL transcripts से और cwd द्वारा समूहित; और Goose projects इसके SQLite DB से `~/.local/share/goose/sessions/sessions.db` पर (प्रत्येक सेशन के `working_dir` द्वारा समूहित)। एक project जो कई CLIs द्वारा उपयोग किया गया है सभी मिलान badge के साथ एकल row के रूप में प्रदर्शित होता है। तालिका के ऊपर **CLI** ड्रॉपडाउन का उपयोग करके किसी विशिष्ट agent CLI द्वारा फ़िल्टर करें; URL आपके चयन को `?cli=claude|codex|copilot|cursor|opencode|pi|hermes|openclaw|factory|devin|antigravity|goose` के रूप में संरक्षित करता है।
+
+Hermes और OpenClaw user-scoped हैं और समूहित करने के लिए कोई working directory नहीं है, इसलिए वे **collapsible folder tree** के रूप में प्रदर्शित होते हैं — शीर्ष स्तर पर profile (या agent), इसके नीचे channels — जबकि प्रत्येक cwd-based CLI एक flat row रहता है। Folder rows उनके अंतर्गत सभी चीजों की session count और सबसे हाल की गतिविधि को रोल अप करते हैं, collapsed folders को visits के बीच याद रखा जाता है, और एक keyword search जो कुछ भी match करता है उसे expand करता है।
+
+प्रत्येक project दिखाता है:
+- Project name (फ़ोल्डर पथ से प्राप्त)
+- एक CLI badge — `Claude Code` (orange), `OpenAI Codex` (purple), `GitHub Copilot` (blue), `Cursor Agent` (emerald), `OpenCode` (amber), `Pi` (pink), और/या `Hermes` (indigo)
+- सबसे हाल की session activity की तारीख
+
+किसी project को इसके सेशन देखने के लिए क्लिक करें।
+
+### Sessions
+
+किसी project के भीतर सभी sessions की सूची। प्रत्येक session दिखाता है:
+- Session ID
+- शुरुआत और समाप्ति timestamps
+- Tool calls की संख्या
+- Hook activity count (policies जो fired हुई)
+
+सूची को सीमित करने के लिए date range filter और session ID search का उपयोग करें। Sessions paginated हैं।
+
+किसी session को session viewer खोलने के लिए क्लिक करें।
+
+### Session viewer
+
+Session viewer स्वायत्त agents के लिए मुख्य प्रश्न का उत्तर देता है: agent ने क्या किया, और क्या यह track पर रहा? Header के पास एक CLI badge यह दर्शाता है कि session Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin, Antigravity, या Goose transcript है। यह सेशन में घटी सभी चीजों का एक timeline दिखाता है:
+
+- **Messages** - Claude के text responses और user prompts
+- **Tool calls** - Claude द्वारा invoke किए गए हर tool, इसके input और output के साथ
+- **Policy activity** - प्रत्येक tool call के लिए, कौन सी policies fired हुई और उन्होंने क्या decision return किया
+
+शीर्ष पर stats bar session duration, total tool calls, और hook decisions का एक summary दिखाता है (allow / deny / instruct counts)।
+
+**Download Logs** button को क्लिक करके सेशन को export करें। Claude Code, Codex, Copilot, Cursor, और Pi sessions के लिए आपको original on-disk JSONL transcript byte-for-byte मिलता है; OpenCode (जिसके सेशन SQLite में live हैं, disk पर नहीं) के लिए आपको एक JSON document मिलता है जो अंतर्निहित `session` / `messages` / `parts` tables को mirror करता है।
+
+### Audit
+
+आपके agent के वास्तविक व्यवहार का एक personality-driven report पिछले सेशन में। `failproofai audit` CLI के समान scan को चलाता है लेकिन इसे एक single-screen shareable poster + चार below-the-fold sections के रूप में प्रस्तुत करता है:
+
+1. **Poster** — पहले viewport को भरता है। Self-contained PNG-capture region failproof_ai wordmark + audit label के साथ · archetype index (`№ NN of 08`) + audit date · numeric score (0–100) + percentile rank pill (`top 15%`) · archetype name (एक `the optimist`, `the cowboy`, `the explorer`, `the goldfish`, `the paranoid architect`, `the precision builder`, `the hammer`, `the ghost` में से) + 3-keyword strip · `// only N% of agents are this archetype` rarity line · 8×8 pixel sigil tile · `audit yours → failproof.ai` footer। Capture box के बाहर तीन share buttons हैं: `post your archetype` (X intent), `share on linkedin`, `download poster`। Capture `html-to-image` के माध्यम से चलता है इसलिए PNG on-screen render के साथ pixel-for-pixel मेल खाता है (dashed borders, SVG logo mask, gradients, font metrics — सभी preserved)।
+2. **Strengths** — calm ✓ row list आपके agent द्वारा पहले से किए जाने वाले व्यवहारों का, live audit data से प्राप्त (clean tool-call rate, main के लिए कोई direct push नहीं, zero credential leaks, zero retry storms) — प्रत्येक तब ही surfaced होता है जब संबंधित policy के पास audit window में clean record हो।
+3. **Quirks** — table जो फिसल गया, severity द्वारा ranked: `when · what slipped + the policy that would've caught it · severity pill · seen`, जहां recurrence `new` (एक बार), `N× seen` (2–9 times), या `recurring` (10+) को पढ़ता है।
+4. **How to improve** — calm row list, प्रत्येक prescribed policy के लिए एक: white में policy name, one-line description, install command + दाईं ओर copy button। Section header `enable all N → projected <score> · <tier>` को पढ़ता है (वह score जो आप हर fix को लागू करने के साथ प्राप्त करेंगे), और इसका `[install all]` button प्रत्येक prescribed policy के लिए संयुक्त `failproofai policy add a b c …` command को copy करता है।
+5. **Come back better** — दो side-by-side cards। Left: एक reminder सेट करें (`3d` / `7d` / `14d` / `30d` cadence picker; authed होने के बाद `/api/auth/reminder` के माध्यम से persist); Right: failproof perks unlock करें — `invite a friend` एक modal खोलता है जो comma/space/newline-separated friend emails की एक सूची लेता है (प्रति send max 10), उन्हें `/api/audit/invite` पर POST करता है, जो api-server के `POST /v0/invite` को forward करता है। Api-server `invite@failproof.ai` से प्रत्येक recipient को एक email भेजता है sender Cc के साथ और `Reply-To` सेट, इसलिए recipient देखता है कि किसने उन्हें invite किया और sender को अपने inbox में एक copy मिलता है। Anonymous users पहले `AuthDialog` के माध्यम से routed होते हैं ताकि invites के आउट जाने से पहले sender का email जाना जाए। Entitlement / perks fulfillment एक follow-up है।
+
+`failproofai audit` runtime द्वारा driven — अंतर्निहित scan engine, supported flags, और per-transcript cache invariants के लिए [Audit CLI](/hi/cli/audit) देखें। Dashboard सबसे हाल का result को `~/.failproofai/audit-dashboard.json` पर cache करता है (mode `0600`, single slot, new runs overwrite) ताकि revisits instant हों; **दोनों per-transcript और whole-result caches को read पर reject किया जाता है एक बार जब वे 7 days से पुरानी हों** ताकि dashboard कभी भी silently एक week-old result serve न करे — TTL के पास `/audit` अपनी empty state में गिरता है और एक fresh run के लिए prompt करता है। Report के निचले हिस्से के पास `[ re-audit now ]` को क्लिक करने से `/api/audit/run` पर `noCache: true` के साथ POST होता है — re-audit per-transcript cache को bypass करता है और silently cached result return करने के बजाय scratch से हर transcript को फिर से स्कैन करता है — और dashboard `/api/audit/status` को 1Hz पर poll करता है जब तक run समाप्त न हो जाए; एक sticky pink progress strip run के दौरान viewport के शीर्ष को pin करता है एक elapsed timer के साथ, और fresh result success पर जगह में swap होता है (कोई full-page reload नहीं; एक failed re-audit prior report को intact छोड़ता है)। Failure पर strip `RerunError.kind` (`timeout` / `network` / `post_failed`) से keyed copy के साथ red हो जाता है। Empty state (कोई cache नहीं या expired) और zero-sessions state (cache exists लेकिन scan को कोई transcripts नहीं मिले) को अलग से surface किया जाता है।
+
+### Policies
+
+नीतियों को प्रबंधित करने और गतिविधि की समीक्षा करने के लिए एक two-tab page।
+
+<Tabs>
+  <Tab title="Policies tab">
+  - एकल panel से multi-select करें कि failproofai कौन से agent CLIs को protect करता है — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi, और Hermes के सभी के पास install status (`Active` / `Detected` / `Inactive`), user-scope settings path, और एक brand-colored accent के साथ एक row है। उन CLIs को चेक या अनचेक करें जिन्हें आप चाहते हैं और एक ही step में install/uninstall diff को apply करने के लिए `Apply changes` को क्लिक करें। CLIs जिनका binary PATH पर detected है वे pre-checked हैं।
+  - एकल क्लिक के साथ individual policies को on या off toggle करें (`~/.failproofai/policies-config.json` को write करता है — हर installed CLI में shared)
+  - एक policy को expand करें इसके parameters को configure करने के लिए (उन policies के लिए जो `policyParams` को support करते हैं)
+  - एक custom policies file path सेट करें
+  </Tab>
+  <Tab title="Activity tab">
+  - सभी sessions में fired होने वाली हर hook event का पूरा paginated history
+  - Decision, event type, CLI (Claude Code / OpenAI Codex / GitHub Copilot _(beta)_ / Cursor Agent _(beta)_ / OpenCode _(beta)_ / Pi _(beta)_ / Hermes / OpenClaw / Factory Droid / Devin / Antigravity / Goose), policy name, या session ID द्वारा filter करें
+  - प्रत्येक row दिखाता है: timestamp, policy name, decision, CLI badge (orange = Claude Code, purple = OpenAI Codex, blue = GitHub Copilot, emerald = Cursor Agent, amber = OpenCode, pink = Pi, indigo = Hermes, teal = OpenClaw, rose = Factory Droid, violet = Devin, cyan = Antigravity, lime = Goose), tool name, session ID, और deny/instruct decisions के कारण
+  - अपना transcript खोलने के लिए किसी session ID को क्लिक करें — viewer auto-detect करता है कि कौन सा CLI hook को fired किया (Claude `~/.claude/projects/…`, Codex `~/.codex/sessions/…`, Copilot CLI `~/.copilot/session-state/<id>/events.jsonl`, Cursor Agent `~/.cursor/agent-sessions/<id>/events.jsonl`, OpenCode `~/.local/share/opencode/opencode.db`, Pi `~/.pi/agent/sessions/<encoded-cwd>/<id>.jsonl`, Hermes `~/.hermes/state.db`, OpenClaw `~/.openclaw/agents/<id>/sessions/*.jsonl`, Factory Droid `~/.factory/sessions/<encoded-cwd>/<id>.jsonl`, Devin `~/.local/share/devin/cli/sessions.db`, Antigravity `~/.gemini/antigravity-cli/brain/<id>/…/transcript_full.jsonl`, Goose `~/.local/share/goose/sessions/sessions.db`) और header में matching CLI badge को render करता है
+  </Tab>
+</Tabs>
+
+---
+
+## Auto-refresh
+
+Dashboard के top navigation में एक auto-refresh toggle है। जब enabled हो, तो current page periodically refresh होता है ताकि नए sessions और policy activity को दिखाया जा सके जैसे-जैसे वे appear होते हैं। Long-running autonomous agent सेशन को मॉनिटर करने के लिए आवश्यक।
+
+---
+
+## Pages को disable करना
+
+अगर आपको केवल dashboard के कुछ हिस्से चाहिए, तो `FAILPROOFAI_DISABLE_PAGES` को page names की comma-separated सूची में सेट करें:
+
+```bash
+FAILPROOFAI_DISABLE_PAGES=policies failproofai
+```
+
+Valid values: `policies`, `projects`, `audit`।
+
+---
+
+## Projects path को कॉन्फ़िगर करना
+
+डिफ़ॉल्ट रूप से, Dashboard standard Claude Code projects directory से पढ़ता है। Custom setups के लिए इसे override करें:
+
+```bash
+CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai
+```
+
+---
+
+## Non-localhost host से access करना
+
+जब Dashboard को **dev mode** में (`npm run dev`) चला रहे हों और इसे `localhost` के अलावा किसी अन्य hostname से access कर रहे हों - उदाहरण के लिए, एक custom domain, एक remote IP, या एक tunneled URL - आप एक warning देख सकते हैं जैसे:
+
+```text
+⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
+```
+
+यह Next.js अपनी HMR (hot module reload) websocket के लिए cross-origin access को block कर रहा है, जो एक dev-only feature है। अपने host को allow करने के लिए, `--allowed-origins` flag का उपयोग करें:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com
+```
+
+कई hosts या IPs के लिए, एक comma-separated सूची pass करें:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
+```
+
+आप `FAILPROOFAI_ALLOWED_DEV_ORIGINS` environment variable को इसके बजाय सेट कर सकते हैं:
+
+```bash
+FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
+```
+
+<Note>
+यह केवल dev mode पर लागू होता है। जब `failproofai` (production mode) को चला रहे हों, तो कोई HMR websocket नहीं है और कोई cross-origin dev resource issue नहीं है।
+</Note>