@agent-native/core 0.76.5 → 0.76.6

package/corpus/core/docs/content/locales/hi-IN/template-content.md

@@ -0,0 +1,402 @@
+---
+title: "सामग्री"
+description: "MDX के लिए ओपन-सोर्स ओब्सीडियन: स्थानीय Markdown/MDX फ़ाइलों को संपादित करें, समृद्ध इंटरैक्टिव कस्टम ब्लॉक बनाएं, और AI एजेंट के साथ लिखें।"
+---
+
+# सामग्री
+
+सामग्री MDX के लिए ओपन-सोर्स ओब्सीडियन है: एक स्थानीय-फ़ाइल-अनुकूल दस्तावेज़
+कार्यस्थान जहां एजेंट पढ़, लिख, पुनर्गठित कर सकता है और पृष्ठों को प्रकाशित कर सकता है
+आप. एक दस्तावेज़ खोलें, "अधिक संक्षिप्त होने के लिए इस पैराग्राफ को फिर से लिखें" या "एक बनाएं
+लक्ष्य, मेट्रिक्स और जोखिमों के लिए उप-पृष्ठों के साथ Q4 योजना नामक पृष्ठ" - वही
+परिणाम चाहे आप स्वयं करें या पूछें।
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:grid;grid-template-columns:210px 1fr;gap:14px;padding:16px;min-height:500px;box-sizing:border-box'><aside class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Content</strong><span class='wf-pill accent'>Q3 Roadmap</span><span class='wf-pill'>Goals</span><span class='wf-pill'>Metrics</span><span class='wf-pill'>Risks</span><hr/><span class='wf-pill'>Engineering wiki</span><span class='wf-pill'>Reading list</span><span class='wf-pill'>Weekly sync</span></aside><main style='display:flex;flex-direction:column;gap:12px;min-width:0;padding:8px 20px'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Q3 Roadmap</h1><div style='flex:1'></div><button>Share</button><button class='primary'>Publish</button></div><div class='wf-card' style='flex:1;display:flex;flex-direction:column;gap:12px;padding:22px'><h2 style='margin:0'>Launch goals</h2><p style='margin:0'>Ship the onboarding flow, reduce setup time, and document owner handoffs.</p><div class='wf-box'>At a glance · owner, window, status</div><div class='wf-box'>Top objectives</div><div class='wf-box'>Workstreams table</div></div></main></div>"
+}
+```
+
+जब आप ऐप खोलेंगे, तो आपको संपादक के बगल में एक पेज ट्री दिखाई देगा। एजेंट को हमेशा पता होता है कि आप कौन सा पृष्ठ देख रहे हैं और आपने कौन सा पाठ चुना है, इसलिए दस्तावेज़ संपादन वर्तमान पृष्ठ पर आधारित रह सकते हैं।
+
+```an-diagram title="One document, many editors" summary="You and the agent both write through the same Yjs pipeline. SQL is the canonical store; local files and Notion are optional sync surfaces."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">You type<br><small class=\"diagram-muted\">slash menu, toolbar</small></div><div class=\"diagram-node\">Agent edits<br><small class=\"diagram-muted\">edit-document find/replace</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Yjs CRDT</span><small class=\"diagram-muted\">live, conflict-free merge</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">documents (markdown)<br><small class=\"diagram-muted\">canonical SQL store</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&harr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Local .md / .mdx<br><small class=\"diagram-muted\">/local-files</small></div><div class=\"diagram-box\">Notion pages<br><small class=\"diagram-muted\">pull · push</small></div></div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## आप इसके साथ क्या कर सकते हैं
+
+- **शीर्षकों, सूचियों, तालिकाओं, कोड ब्लॉकों, छवियों और लिंक के साथ समृद्ध पाठ लिखें**। स्लैश कमांड (`/`) ब्लॉक डालें; टेक्स्ट का चयन करने से एक फ़ॉर्मेटिंग टूलबार पॉप अप हो जाता है।
+- **पेड़ों को एक पेड़ में व्यवस्थित करें** - असीमित रूप से घोंसला बनाएं, पुन: व्यवस्थित करने के लिए खींचें, पसंदीदा पृष्ठ जिनका आप अक्सर उपयोग करते हैं।
+- **सभी चीज़ों में खोजें** शीर्षकों और सामग्री में पूर्ण-पाठ खोज के साथ।
+- **ओब्सीडियन की तरह स्थानीय Markdown/MDX फ़ाइलों को संपादित करें।** `/local-files` दृश्य का उपयोग करें
+  अपने कार्यक्षेत्र को फ़ाइलों में निर्यात करने के लिए, उन्हें अपने टूल में संपादित करें, पूर्वावलोकन करें
+  परिवर्तन करें, और उन्हें वापस आयात करें। स्थानीय फ़ाइल मोड में, सामग्री सीधे
+  चयनित `.md` या `.mdx` फ़ाइल।
+- **समृद्ध इंटरैक्टिव कस्टम ब्लॉक उत्पन्न करें।** स्थानीय React घटकों को पंजीकृत करें,
+  उन्हें MDX के रूप में डालें, और एजेंट को घटक फ़ाइलें बनाने या अपडेट करने दें
+  आपके दस्तावेज़.
+- **Notion के साथ सिंक करें।** एक स्थानीय दस्तावेज़ को Notion पेज से लिंक करें और सामग्री को किसी भी दिशा में खींचें या पुश करें। टिप्पणियाँ भी दोनों तरह से सिंक होती हैं।
+- **वास्तविक समय में सहयोग करें।** कई लोग (और एजेंट) एक ही समय में एक ही दस्तावेज़ को संपादित कर सकते हैं।
+- **दस्तावेज़ साझा करें** टीम के साथियों के साथ या उन्हें सार्वजनिक करें - डिफ़ॉल्ट रूप से निजी, दर्शक/संपादक/व्यवस्थापक भूमिकाओं के साथ।
+- **एजेंट से कुछ भी पूछें**: "इस पैराग्राफ को फिर से लिखें।" "शीर्ष पर एक TL;DR जोड़ें।" "पिछले सप्ताह के मेरे सभी मीटिंग नोट्स ढूंढ़ें।" "इस स्वर को और अधिक औपचारिक बनाएं।"
+
+## आरंभ करना
+
+लाइव डेमो: [content.agent-native.com](https://content.agent-native.com).
+
+जब आप ऐप खोलते हैं, तो साइडबार में **+ नया पेज** पर क्लिक करें, इसे एक शीर्षक दें और लिखना शुरू करें। एजेंट का उपयोग करने के लिए, साइडबार में टाइप करें:
+
+- "ऑनबोर्डिंग नामक एक पेज बनाएं और उसके अंतर्गत तीन उप-पृष्ठ जोड़ें।"
+- "अधिक संक्षिप्त होने के लिए इस पैराग्राफ को फिर से लिखें।" (एक पेज खुला होने के साथ)
+- "तीन बुलेट बिंदुओं के साथ मूल्य निर्धारण के बारे में एक अनुभाग जोड़ें।"
+- "इस दस्तावेज़ को शीर्ष पर एक टीएल;डीआर में सारांशित करें।"
+- "Notion से नवीनतम खींचें।" (Notion पेज लिंक करने के बाद)
+
+टेक्स्ट का चयन करें और पहले से लोड किए गए उस चयन के साथ एजेंट पर ध्यान केंद्रित करने के लिए Cmd+I दबाएं - "इसे अधिक प्रभावी बनाएं" फिर ठीक उसी पर काम करता है जिसे आपने हाइलाइट किया है।
+
+## स्थानीय Markdown/MDX फ़ाइलें {#local-files}
+
+सामग्री बिना क्लोनिंग या रनिंग के स्थानीय फाइलों के माध्यम से दस्तावेजों को राउंड-ट्रिप कर सकती है
+स्थानीय रूप से सामग्री ऐप। यह MDX के लिए ओब्सीडियन जैसा लगता है: फ़ाइलें निरीक्षण योग्य रहती हैं
+और संपादन योग्य, जबकि ऐप आपको एक समृद्ध संपादक, एजेंट actions, साझाकरण और
+कस्टम ब्लॉक। `/local-files` खोलें, अपने ब्राउज़र या एजेंट
+नेटिव डेस्कटॉप, और वर्तमान दस्तावेज़ ट्री को Markdown/MDX के अंतर्गत निर्यात करें
+`content/`.
+
+प्रत्येक निर्यातित फ़ाइल में दस्तावेज़ मेटाडेटा (`id`, `title`,
+`parentId`, `position`, पसंदीदा/खोज/दृश्यता झंडे, और `updatedAt`) प्लस
+दस्तावेज़ का मुख्य भाग Markdown के रूप में। आप उन फ़ाइलों को अपने सामान्य संपादक में संपादित कर सकते हैं,
+फिर पूर्वावलोकन करने और सामग्री में परिवर्तनों को वापस आयात करने के लिए `/local-files` पर वापस लौटें।
+
+यह वर्कफ़्लो तब उपयोगी होता है जब आप स्रोत नियंत्रण में सामग्री चाहते हैं, बैच करना चाहते हैं
+स्थानीय उपकरणों के साथ दस्तावेज़ संपादित करें, या उन टीमों के लिए नो-क्लोन पथ चाहते हैं जो फ़ाइलें पसंद करते हैं
+समीक्षा सतह के रूप में। होस्ट किया गया ऐप साझा करने के लिए सत्य का स्रोत बना हुआ है,
+टिप्पणियाँ, अनुमतियाँ, और लाइव सहयोग; स्थानीय फ़ोल्डर एक स्पष्ट
+सिंक सतह।
+
+सामग्री **स्थानीय फ़ाइल मोड** में भी चल सकती है, जहाँ फ़ाइलें स्रोत हैं
+SQL दस्तावेज़ों के बजाय सत्य। रेपो में `agent-native.json` जोड़ें, सेट करें
+`mode: "local-files"`, और `docs/`, `blog/`, जैसे रूट कॉन्फ़िगर करें
+`content/`, और `resources/`। मानक सामग्री संपादक तब इसे पॉप्युलेट करता है
+उन स्थानीय `.md`/`.mdx` फ़ाइलों से बायाँ साइडबार और संपादन वापस लिखता है
+सामान्य दस्तावेज़ actions के माध्यम से चयनित फ़ाइल। रेपो-प्रथम दस्तावेज़ों के लिए इसका उपयोग करें,
+ब्लॉग, संसाधन लाइब्रेरी, या MDX-संचालित के साथ ओब्सीडियन-शैली की व्यक्तिगत सामग्री
+घटक; जब आप होस्टेड सहयोग चाहते हैं तो डेटाबेस मोड पर वापस जाएँ और
+SQL-backed sharing. See [Local File Mode](/docs/local-file-mode) for the
+स्टैंडअलोन रेपो लेआउट, कॉन्फ़िगरेशन, कस्टम MDX घटक, स्थानीय
+`extensions/` विजेट, और उत्पादन सुरक्षा गाइड।
+
+सामग्री स्थानीय-फ़ाइल कौशल को मौजूदा रेपो में स्थापित करने के लिए:
+
+```bash
+npx @agent-native/core@latest skills add content --mode local-files --scope project
+```
+
+इंस्टॉलर आपके कोडिंग एजेंट के लिए `content` कौशल की प्रतिलिपि बनाता है और लिखता है या
+`docs/`, `blog/`, `content/` के लिए कंटेंट रूट्स के साथ `agent-native.json` को अपडेट करता है
+और `resources/`। जब कोई स्थानीय सामग्री ऐप, Agent Native डेस्कटॉप, या विश्वसनीय
+स्थानीय ब्रिज चल रहा है, एजेंटों को सामग्री actions जैसे
+`list-documents`, `get-document`, `edit-document`, `update-document`, और
+`share-local-file-document` कच्चे फ़ाइल सिस्टम के बजाय लिखता है। उस लोकल के बिना
+ब्रिज, स्थापित कौशल अभी भी एजेंट को
+सुरक्षित Markdown/MDX संपादन।
+
+## डेवलपर्स के लिए
+
+इस दस्तावेज़ का शेष भाग सामग्री टेम्पलेट को बनाने या उसका विस्तार करने वाले किसी भी व्यक्ति के लिए है।
+
+### त्वरित शुरुआत
+
+सामग्री टेम्पलेट के साथ एक नया कार्यक्षेत्र तैयार करें:
+
+```bash
+npx @agent-native/core@latest create my-workspace --standalone --template content
+cd my-workspace
+pnpm install
+pnpm dev
+```
+
+`http://localhost:8083` खोलें और अपना पहला पेज बनाएं। फिर एजेंट से "ऑनबोर्डिंग नामक एक पेज बनाने और उसके अंतर्गत तीन उप-पृष्ठ जोड़ने" के लिए कहें।
+
+### मुख्य विशेषताएं {#key-features}
+
+**नेस्टेड पेज।** दस्तावेज़ पसंदीदा, आइकन, ऑर्डरिंग और पेज-स्तरीय साझाकरण के साथ एक खींचने योग्य पेड़ बनाते हैं।
+
+**रिच MDX संपादक।** टिपटैप शीर्षकों, सूचियों, तालिकाओं, कोड ब्लॉक, छवियों, लिंक, स्लैश कमांड, चयन टूलबार और स्थानीय React घटकों को शक्ति प्रदान करता है।
+
+**लाइव सहयोग।** Yjs कई संपादकों और एजेंट संपादनों को एक-दूसरे से चिपके बिना सिंक में रखता है।
+
+**खोज और टिप्पणियाँ।** पूर्ण-पाठ खोज, एंकर टिप्पणियाँ, संस्करण इतिहास और पुनर्स्थापना प्रवाह दस्तावेज़ की सतह में निर्मित होते हैं।
+
+**सिंक सतहें।** दस्तावेज़ Notion या स्थानीय Markdown/MDX फ़ोल्डरों के साथ सिंक हो सकते हैं, SQL सहयोगी कैश/इतिहास परत के रूप में कार्य करता है।
+
+### स्थानीय फ़ाइल समन्वयन
+
+संरक्षित `/local-files` मार्ग ब्राउज़र फ़ाइल सिस्टम एक्सेस API, या a
+पढ़ने और लिखने के लिए Agent Native डेस्कटॉप के अंदर संरक्षित देशी फ़ोल्डर ब्रिज
+उपयोगकर्ता द्वारा चुने गए फ़ोल्डर से Markdown/MDX फ़ाइलें। फोल्डर लिंक होने के बाद और
+आयातित, चयनित फ़ाइल को प्राधिकारी के रूप में माना जाता है: पृष्ठ खोलने पर पढ़ता है
+फ़ाइल, और सामान्य संपादक पहले फ़ाइल को सहेजता है। फिर SQL को एक
+मौजूदा दस्तावेज़ UI, खोज और संस्करण पैनल के लिए कैश/इतिहास परत, नहीं
+सत्य के स्रोत के रूप में। शीर्ष-दाएँ पृष्ठ मेनू स्थानीय स्रोत पथ को उजागर करता है:
+सापेक्ष पथ हमेशा उपलब्ध होता है, पूर्ण पथ वास्तविक स्थानीय-फ़ाइल में उपलब्ध होता है
+मोड और Agent Native डेस्कटॉप, और फाइंडर में खुलासा
+डेस्कटॉप ब्रिज या सर्वर-समर्थित स्थानीय-फ़ाइल मोड।
+
+बल्क सिंक रूट कॉल:
+
+- `export-content-source` - सुलभ दस्तावेज़ ट्री को पढ़ता है और एक लौटाता है
+  नियतात्मक `content/` फ़ाइल बंडल।
+- `import-content-source` - फ़ाइलों को मान्य करता है, नए निजी दस्तावेज़ बनाता है,
+  उन दस्तावेज़ों को अपडेट करता है जहां कॉल करने वाले के पास संपादक की पहुंच होती है, संस्करण को सुरक्षित रखता है
+  इतिहास, और अमान्य मूल चक्रों को अस्वीकार करता है।
+
+स्रोत प्रारूप `shared/content-source.ts` में रहता है। उस फ़ाइल को
+फ़ाइल नाम, फ्रंटमैटर, पार्सिंग और क्रमबद्धता के लिए एकल अनुबंध।
+
+स्थानीय फ़ाइल कार्यस्थान इसके माध्यम से रेपो-स्थानीय React घटक भी प्रदान कर सकते हैं
+कॉन्फ़िगर किया गया `components` फ़ोल्डर। कंटेंट डेव सर्वर पास्कलकेस
+उन फ़ाइलों से निर्यात, `<ImpactCounter />` जैसे मिलान वाले MDX टैग प्रस्तुत करता है
+संपादक के अंदर, और उन्हें स्थानीय घटकों के अंतर्गत स्लैश मेनू में प्रदर्शित करता है।
+यह "MDX के लिए ओब्सीडियन" परत है: कस्टम MDX ब्लॉक स्थानीय रहते हैं
+कार्यस्थान, लेकिन संपादक उन्हें प्रस्तुत कर सकता है और एजेंट उत्पन्न या अद्यतन कर सकता है
+सामग्री ऐप को क्लोन किए बिना उनका स्रोत। एक न्यूनतम कार्यक्षेत्र घटक
+होना:
+
+```tsx
+// components/ImpactCounter.tsx
+import { useState } from "react";
+
+export function ImpactCounter({
+  label = "points",
+  start = 3,
+}: {
+  label?: string;
+  start?: number;
+}) {
+  const [count, setCount] = useState(start);
+  return (
+    <button type="button" onClick={() => setCount(count + 1)}>
+      Impact: {count} {label}
+    </button>
+  );
+}
+
+export const ImpactCounterInputs = {
+  label: { type: "string", label: "Label", default: "points" },
+  start: { type: "number", label: "Starting count", default: 3 },
+};
+```
+
+इसे स्थानीय MDX में `<ImpactCounter />` के रूप में उपयोग करें, या संपादक स्लैश से डालें
+स्थानीय घटकों के अंतर्गत मेनू। जब इनपुट मेटाडेटा निर्यात किया जाता है, तो
+संपादक में घटक एक कोने में संपादन बटन दिखाता है जो MDX प्रॉप्स को फिर से लिखता है
+स्थानीय फ़ाइल में।
+
+ब्राउज़र **स्थानीय फ़ाइलें** पिकर `.md` और `.mdx` फ़ाइलों को पढ़ और लिख सकता है
+इसके अपने, लेकिन निष्पादन योग्य React घटक पूर्वावलोकन के लिए एक स्थानीय कंपाइलर की आवश्यकता होती है। चलाएँ
+सामग्री स्थानीय रूप से या Agent Native डेस्कटॉप का उपयोग करें ताकि चयनित कार्यक्षेत्र पथ हो सके
+स्थानीय सामग्री विकास सर्वर के साथ पंजीकृत होना चाहिए। Vite फिर आयात करता है
+`components/*.tsx`, हॉट रीलोड मौजूदा घटक फ़ाइलों में संपादन करता है, और पुनः लोड करता है
+जब फ़ाइलें जोड़ी या हटाई जाती हैं तो घटक रजिस्ट्री। एजेंट उपयोग कर सकते हैं
+`list-local-component-files` और `write-local-component-file` का निरीक्षण करें या
+पंजीकृत घटक फ़ाइलों को अपडेट करें जबकि संपादक उसी स्रोत से अपडेट करता है।
+
+### टिप्पणियाँ
+
+उद्धृत-पाठ एंकर, उत्तर और समाधान स्थिति के साथ दस्तावेज़ों पर थ्रेडेड टिप्पणियाँ। `document_comments` तालिका और `app/components/editor/CommentsSidebar.tsx` द्वारा समर्थित। Actions: `list-comments`, `add-comment`। Notion टिप्पणियाँ `sync-notion-comments` के माध्यम से दोनों तरीकों से सिंक हो सकती हैं।
+
+### संस्करण इतिहास
+
+प्रत्येक महत्वपूर्ण अद्यतन `document_versions` तालिका में एक पंक्ति का स्नैपशॉट लेता है। UI इन्हें `app/components/editor/VersionHistoryPanel.tsx` में प्रदर्शित करता है।
+
+### साझाकरण और दृश्यता
+
+दस्तावेज़ डिफ़ॉल्ट रूप से निजी होते हैं। आप दृश्यता को `org` या `public` में बदल सकते हैं, या प्रति-उपयोगकर्ता और प्रति-संगठन भूमिकाएँ (`viewer`, `editor`, `admin`) प्रदान कर सकते हैं। फ्रेमवर्क का ऑटो-माउंटेड शेयरिंग actions बॉक्स से बाहर काम करता है:
+
+- `share-resource --resourceType document --resourceId <id> --principalType user --principalId <email> --role editor`
+- `unshare-resource` / `list-resource-shares` / `set-resource-visibility`
+
+`sharing` कौशल देखें।
+
+### टीमें
+
+`/team` पर एक समर्पित टीम पेज (`app/routes/_app.team.tsx` देखें) संगठन बनाने और सदस्यों को प्रबंधित करने के लिए फ्रेमवर्क के `TeamPage` घटक का उपयोग करता है।
+
+### एजेंट के साथ काम करना
+
+क्योंकि एजेंट आपकी वर्तमान स्क्रीन देखता है, अधिकांश संकेतों के लिए आपको किसी दस्तावेज़ को स्पष्ट रूप से संदर्भित करने की आवश्यकता नहीं होती है। जब आपके पास कोई पेज खुला होता है, तो "इस" का मतलब वह पेज होता है।
+
+छोटे संपादनों के लिए, एजेंट `edit-document --find ... --replace ...` का उपयोग करता है इसलिए केवल परिवर्तित पाठ Yjs के माध्यम से प्रवाहित होता है - आप पूरे पृष्ठ को दोबारा प्रस्तुत करने के बजाय जगह में लागू अंतर देखेंगे। बड़े पुनर्लेखन के लिए यह `update-document --content ...` का उपयोग करता है।
+
+यदि आप पाठ का चयन करते हैं और Cmd+I दबाते हैं (या एजेंट पैनल पर ध्यान केंद्रित करते हैं), तो चयन संदर्भ के रूप में आपके अगले संदेश के साथ यात्रा करता है, इसलिए "इसे अधिक प्रभावी बनाएं" ठीक उसी पर काम करता है जिसे आपने हाइलाइट किया है।
+
+### डेटाबेस और गुण
+
+दस्तावेज़ इनलाइन डेटाबेस होस्ट कर सकते हैं - Notion-शैली तालिकाएँ जहाँ प्रत्येक पंक्ति स्वयं एक दस्तावेज़ है। एजेंट डेटाबेस बना सकता है, आइटम जोड़ सकता है, कॉलम परिभाषाएँ कॉन्फ़िगर कर सकता है, और actions के माध्यम से संपत्ति मान सेट कर सकता है: `create-content-database`, `add-database-item`, `set-document-property`। संपत्ति परिभाषाएँ (प्रकार, दृश्यता, विकल्प, स्थिति) `document_property_definitions` में रहती हैं; प्रति-पंक्ति मान `document_property_values` में रहते हैं।
+
+### अतिरिक्त actions
+
+डेटा मॉडल में CRUD सतह से परे, टेम्पलेट किसी पृष्ठ को Markdown या HTML में परिवर्तित करने के लिए `export-document`, किसी पृष्ठ पर एक प्रतिलेख संलग्न करने के लिए `transcribe-media` और पिछले स्नैपशॉट पर वापस लाने के लिए `restore-document-version` भेजता है।
+
+### डेटा मॉडल
+
+नौ तालिकाएँ, सभी `server/db/schema.ts` में परिभाषित:
+
+- **`documents`** — पेज ट्री। कॉलम: `id`, `parent_id`, `title`, `content` (मार्कडाउन), `icon`, `position`, `is_favorite`, `visibility`, `owner_email`, `org_id`, `created_at`, `updated_at`.
+- **`document_versions`** — संस्करण इतिहास के लिए शीर्षक और सामग्री का पूर्ण स्नैपशॉट। `restore-document-version` के साथ वापस रोल करें।
+- **`document_comments`** - `thread_id`, `parent_id`, `quoted_text`, `resolved` और द्विदिश Notion सिंक के लिए एक वैकल्पिक `notion_comment_id` के साथ थ्रेडेड टिप्पणियाँ।
+- **`document_sync_links`** - दूरस्थ पृष्ठ आईडी, अंतिम सिंक समय, विरोध स्थिति, सामग्री हैश और त्रुटियों को ट्रैक करने वाले Notion-लिंक्ड दस्तावेज़ प्रति एक पंक्ति।
+- **`document_property_definitions`** - इनलाइन डेटाबेस के लिए कॉलम परिभाषाएँ: नाम, प्रकार, दृश्यता, विकल्प और स्थिति।
+- **`content_databases`** - इनलाइन डेटाबेस ऑब्जेक्ट `document_id` से एक शीर्षक और व्यू कॉन्फिग JSON के साथ जुड़े हुए हैं।
+- **`content_database_items`** - एक इनलाइन डेटाबेस में पंक्तियाँ, प्रत्येक एक `database_id` को एक `document_id` से जोड़ती है।
+- **`document_property_values`** — प्रति-दस्तावेज़ संपत्ति मान (`property_id` → `value_json`).
+- **`document_shares`** - `createSharesTable` के माध्यम से प्रति-उपयोगकर्ता और प्रति-संगठन अनुदान बनाया गया।
+
+```an-schema title="Content data model" summary="Nine tables in server/db/schema.ts. documents is the page tree; the rest hang off it for versions, comments, Notion sync, inline databases, and sharing."
+{
+  "entities": [
+    {
+      "id": "documents",
+      "name": "documents",
+      "note": "The page tree (ownable, markdown body)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "parent_id", "type": "id", "fk": "documents.id", "nullable": true, "note": "infinite nesting" },
+        { "name": "title", "type": "string" },
+        { "name": "content", "type": "markdown" },
+        { "name": "icon", "type": "string", "nullable": true },
+        { "name": "position", "type": "int", "note": "sibling ordering" },
+        { "name": "is_favorite", "type": "bool" },
+        { "name": "visibility", "type": "enum", "note": "private | org | public" },
+        { "name": "owner_email", "type": "string" },
+        { "name": "org_id", "type": "id", "nullable": true }
+      ]
+    },
+    {
+      "id": "document_versions",
+      "name": "document_versions",
+      "note": "Full title/content snapshots for version history",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "document_id", "type": "id", "fk": "documents.id" },
+        { "name": "title", "type": "string" },
+        { "name": "content", "type": "markdown" }
+      ]
+    },
+    {
+      "id": "document_comments",
+      "name": "document_comments",
+      "note": "Threaded comments with quoted-text anchors",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "document_id", "type": "id", "fk": "documents.id" },
+        { "name": "thread_id", "type": "id" },
+        { "name": "parent_id", "type": "id", "fk": "document_comments.id", "nullable": true },
+        { "name": "quoted_text", "type": "string", "nullable": true },
+        { "name": "resolved", "type": "bool" },
+        { "name": "notion_comment_id", "type": "string", "nullable": true, "note": "bidirectional Notion sync" }
+      ]
+    },
+    {
+      "id": "document_sync_links",
+      "name": "document_sync_links",
+      "note": "One row per Notion-linked document",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "document_id", "type": "id", "fk": "documents.id" },
+        { "name": "notion_page_id", "type": "string" },
+        { "name": "conflict", "type": "bool" },
+        { "name": "content_hash", "type": "string" }
+      ]
+    },
+    {
+      "id": "content_databases",
+      "name": "content_databases",
+      "note": "Inline database objects attached to a document",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "document_id", "type": "id", "fk": "documents.id" },
+        { "name": "title", "type": "string" },
+        { "name": "view_config", "type": "json" }
+      ]
+    },
+    {
+      "id": "content_database_items",
+      "name": "content_database_items",
+      "note": "Rows in an inline database (each row is a document)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "database_id", "type": "id", "fk": "content_databases.id" },
+        { "name": "document_id", "type": "id", "fk": "documents.id" }
+      ]
+    },
+    {
+      "id": "document_property_definitions",
+      "name": "document_property_definitions",
+      "note": "Column definitions for inline databases",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "name", "type": "string" },
+        { "name": "type", "type": "string" },
+        { "name": "options", "type": "json", "nullable": true },
+        { "name": "position", "type": "int" }
+      ]
+    },
+    {
+      "id": "document_property_values",
+      "name": "document_property_values",
+      "note": "Per-document property values",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "document_id", "type": "id", "fk": "documents.id" },
+        { "name": "property_id", "type": "id", "fk": "document_property_definitions.id" },
+        { "name": "value_json", "type": "json" }
+      ]
+    },
+    {
+      "id": "document_shares",
+      "name": "document_shares",
+      "note": "Per-user and per-org grants (createSharesTable)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "document_id", "type": "id", "fk": "documents.id" },
+        { "name": "principal", "type": "string" },
+        { "name": "role", "type": "enum", "note": "viewer | editor | admin" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "documents", "to": "documents", "kind": "1-n", "label": "has children" },
+    { "from": "documents", "to": "document_versions", "kind": "1-n", "label": "has snapshots" },
+    { "from": "documents", "to": "document_comments", "kind": "1-n", "label": "has comments" },
+    { "from": "documents", "to": "document_sync_links", "kind": "1-1", "label": "links to Notion" },
+    { "from": "documents", "to": "content_databases", "kind": "1-n", "label": "hosts databases" },
+    { "from": "content_databases", "to": "content_database_items", "kind": "1-n", "label": "has rows" },
+    { "from": "document_property_definitions", "to": "document_property_values", "kind": "1-n", "label": "has values" },
+    { "from": "documents", "to": "document_shares", "kind": "1-n", "label": "has share grants" }
+  ]
+}
+```
+
+सामग्री को मार्कडाउन के रूप में संग्रहीत किया जाता है। संपादक टिपटैप JSON मॉडल को मेमोरी में कनवर्ट करता है; SQL पंक्ति हमेशा मार्कडाउन होती है इसलिए actions, खोज और Notion सिंक एकल कैनोनिकल प्रारूप पर काम कर सकते हैं।
+
+सभी स्वामित्व योग्य तालिकाओं में `ownableColumns()` के माध्यम से `owner_email` और `org_id` शामिल हैं, इसलिए प्रत्येक पंक्ति इसके निर्माण के क्षण से साइन-इन उपयोगकर्ता (और वैकल्पिक रूप से उनके सक्रिय संगठन) के दायरे में होती है।
+
+### इसे अनुकूलित करना
+
+व्यवहार बदलते समय ध्यान देने योग्य चार स्थान:
+
+- **`actions/`** - प्रत्येक ऑपरेशन एजेंट या UI कर सकता है। `defineAction` का उपयोग करके `actions/publish-to-wordpress.ts` जैसी एक नई फ़ाइल जोड़ें और दोनों पक्ष इसे निःशुल्क प्राप्त करते हैं। प्रमुख मौजूदा actions: `create-document.ts`, `edit-document.ts`, `update-document.ts`, `delete-document.ts`, `list-documents.ts`, `search-documents.ts`, `get-document.ts`, `pull-notion-page.ts`, `push-notion-page.ts`, `add-comment.ts`, `view-screen.ts`, `navigate.ts`.
+- **`app/routes/`** — पृष्ठ सतह। `_app.tsx` पथहीन लेआउट है जो साइडबार और एजेंट पैनल को माउंटेड रखता है; `_app._index.tsx` लैंडिंग दृश्य है; `_app.page.$id.tsx` संपादक मार्ग है; `_app.team.tsx` टीम सेटिंग पृष्ठ है।
+- **`app/components/editor/`** - टिपटैप संपादक। `extensions/` के अंतर्गत एक नया नोड प्रकार जोड़ें और इसे `DocumentEditor.tsx` में पंजीकृत करें। बबल टूलबार, स्लैश मेनू और होवर पूर्वावलोकन सभी घटक फ़ाइलें हैं जिन्हें आप संपादित कर सकते हैं।
+- **`.agents/skills/`** - मार्गदर्शन एजेंट कार्य करने से पहले पढ़ता है। यदि आप एक नई क्षमता (मान लीजिए, एक CMS प्रकाशन पाइपलाइन) जोड़ते हैं, तो एक `SKILL.md` को एक नए कौशल फ़ोल्डर में छोड़ दें ताकि एजेंट इसका सही ढंग से उपयोग कर सके। मौजूदा skills: `document-editing`, `notion-integration`, `real-time-sync`, `delegate-to-agent`, `storing-data`, `self-modifying-code`, `security`, `frontend-design`, `create-skill`, `capture-learnings`।
+- **`AGENTS.md`** - एक्शन चीटशीट और सामान्य-कार्य तालिका के साथ शीर्ष-स्तरीय एजेंट गाइड। जब भी आप कोई प्रमुख सुविधा जोड़ें तो इसे अपडेट करें ताकि एजेंट बिना खोजबीन किए उसे खोज सके।
+- **`server/db/schema.ts`** — डेटा मॉडल। यहां एक कॉलम या टेबल जोड़ें. सामग्री टेम्पलेट में कोई `db:push` स्क्रिप्ट नहीं है; यह स्टार्टअप पर चलने वाले सख्ती से एडिटिव माइग्रेशन पर निर्भर करता है। `server/db/schema.ts` संपादित करें, एक मिलान एडिटिव माइग्रेशन लिखें, और अगली बार ऐप बूट होने पर परिवर्तन लागू होता है - स्कीमा अपडेट को कभी भी मौजूदा तालिकाओं या कॉलमों को छोड़ना, नाम बदलना या विनाशकारी रूप से बदलना नहीं चाहिए (दिशानिर्देशों के लिए [Database](/docs/database#migrations) देखें)।
+- **`shared/notion-markdown.ts`** - मार्कडाउन-टू-Notion-ब्लॉक रूपांतरण। यदि आप नए ब्लॉक प्रकार जोड़ते हैं जिन्हें Notion के माध्यम से राउंड-ट्रिप करने की आवश्यकता होती है तो इसे बढ़ाएँ।
+
+एजेंट ये सभी परिवर्तन स्वयं कर सकता है - उसे "दस्तावेज़ों में एक टैग कॉलम जोड़ने और इसे साइडबार में प्रदर्शित करने" के लिए कहें और यह स्कीमा को अपडेट करेगा, माइग्रेट करेगा, UI को वायर करेगा और कार्रवाई लिखेगा।