@agent-native/core 0.76.5 → 0.76.6

package/corpus/core/docs/content/locales/ar-SA/template-brain.md

@@ -0,0 +1,324 @@
+---
+title: "الدماغ"
+description: "دردشة نظيفة للشركة مدعومة بالذاكرة المؤسسية المستشهد بها، واستيعاب المصدر القابل للمراجعة، وعمليات تكامل مساحة العمل القابلة لإعادة الاستخدام."
+---
+
+# الدماغ
+
+Brain عبارة عن دردشة شركة نظيفة مدعومة بالذاكرة المؤسسية المستشهد بها. يسأل الناس
+أسئلة باللغة الإنجليزية البسيطة؛ إجابات الدماغ من معرفة الشركة المعتمدة مع
+روابط تعود إلى سلسلة Slack أو الاجتماع أو النص أو المشكلة أو التقاط خطاف الويب
+يدعم الإجابة.
+
+يستوعب Brain قنوات Slack المعتمدة وتسجيلات المقاطع ومساحة فريق Granola
+ملاحظات، وقضايا GitHub/PRs، وحمولات النص العام/خطاف الويب. يقوم بتخزين الخام
+يلتقط ويقطّر الحقائق/القرارات/العمليات الدائمة، ويوجه مسارات حساسة أو
+ذكريات منخفضة الثقة من خلال المراجعة قبل أن تصبح معرفة بالشركة.
+
+يظل سطح المنتج بسيطًا عن قصد: **اسأل** هي الدردشة الأساسية
+الخبرة، في حين أن **المصادر** و**المراجعة** و**المعرفة** هي المشرف/الدعم
+أسطح لتوصيل البيانات، والموافقة على المقترحات، وفحص الذاكرة المستشهد بها.
+
+```an-diagram title="From source to cited answer" summary="Brain ingests approved sources into raw captures, distills durable memory, gates it through review, and only then answers with citations."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Sources</span><small class=\"diagram-muted\">Slack · Granola · GitHub · Clips · webhooks</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Raw captures<br><small class=\"diagram-muted\">deduped, redacted</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Distill<br><small class=\"diagram-muted\">facts · decisions · processes</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">Review</span><small class=\"diagram-muted\">sensitive / low-confidence queue</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill ok\">Knowledge</span><small class=\"diagram-muted\">approved, atomic</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Ask</span><small class=\"diagram-muted\">cited answer</small></div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-flow .diagram-card{display:flex;flex-direction:column;gap:4px;padding:10px 12px}.diagram-flow .diagram-box{display:flex;flex-direction:column;gap:4px}.diagram-flow .diagram-arrow{font-size:20px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Ask company memory</h1><span class='wf-pill accent'>42 approved memories</span><span class='wf-pill'>3 sources</span><div style='flex:1'></div><button>Sources</button><button>Review</button></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span data-icon='search' aria-label='Search'></span><strong style='flex:1'>Why did we choose usage pricing?</strong><button class='primary'>Ask</button></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Answer</strong><p style='margin:0'>The team chose usage pricing after pilots showed seat counts undercounted automation value.</p><div style='display:flex;gap:8px;flex-wrap:wrap'><span class='wf-pill accent'>Pricing RFC</span><span class='wf-pill'>Launch retro</span><span class='wf-pill'>Sales notes</span></div></div><div class='wf-card' style='flex:1;display:flex;flex-direction:column;gap:8px'><strong>Source timeline</strong><div class='wf-box'>May 3 · Decision captured</div><div class='wf-box'>May 8 · Customer evidence added</div><div class='wf-box'>May 12 · Legal note approved</div></div></div>"
+}
+```
+
+عند فتح التطبيق، يكون **السؤال** في المقدمة والوسط — حيث تتم مراجعة الدردشة النظيفة
+ذاكرة الشركة. **المصادر**، و**المراجعة**، و**المعرفة** تقع بجانبها كـ
+أسطح الإدارة لربط البيانات والموافقة على المقترحات وفحص الاستشهادات
+الإدخالات.
+
+## متى يتم اختياره
+
+استخدم Brain عندما يريد فريقك من الوكلاء الإجابة على أسئلة مثل "لماذا قمنا بذلك
+هذا القرار بشأن المنتج؟"، أو "كيف تعمل هذه الميزة قيد التطوير؟"، أو "ماذا
+هل تغيرت في هذه العملية؟" مع روابط العودة إلى المحادثة المصدر، والاجتماع،
+أو المشكلة.
+
+Brain وDispatch متكاملان ولكنهما يؤديان وظائف مختلفة:
+
+- **يمتلك الدماغ ذاكرة الشركة.** فهو يستوعب المصادر، ويراجع اللقطات الأولية،
+  يستخلص الحقائق/القرارات/العمليات الدائمة، والإجابات من الأدلة المذكورة، و
+  كشف المعرفة المعتمدة للوكلاء.
+- **تمتلك Dispatch مستوى التحكم في مساحة العمل.** وتقوم بمركزية المراسلة،
+  الأسرار، والوظائف المتكررة، والموافقات، وتنسيق A2A، والتوزيع
+  والموافقة على الموارد على مستوى مساحة العمل.
+
+في مساحة عمل متعددة التطبيقات، يمكن لـ Dispatch توجيه سؤال إلى Brain عبر A2A و
+منح بيانات اعتماد موفر خدمة Brain المشترك. يظل الدماغ هو المتخصص في
+تمت الموافقة على استيعاب المصدر ومراجعته واسترجاعه والاستشهاد بإجابات الشركة.
+يكشف Brain عن إمكانية الاسترجاع للقراءة فقط والمدعومة بالاقتباسات كقدرة عامة على A2A
+حتى تتمكن تطبيقات Dispatch والتطبيقات الشقيقة من طرح أسئلة تتعلق بذاكرة الشركة - وكيل A2A
+البطاقة هي بيانات تعريف عامة للاكتشاف، بينما لا يزال استرجاعها يحدث داخل Brain's
+سطح عمل مصادق عليه.
+
+## ما يمكنك فعله به
+
+- **طرح الأسئلة المذكورة.** طرح الأسئلة هو السطح الرئيسي للمنتج: محادثة نظيفة
+  ذاكرة الشركة التي تمت مراجعتها، مع صحة المصدر وعدد المراجعات والمقترحات
+  تظل الأسئلة ثانوية. ترتبط كل إجابة بسلسلة رسائل Slack،
+  الاجتماع أو المشكلة أو الالتقاط الذي يدعمه.
+- **توصيل المصادر المعتمدة.** التهيئة اليدوية، وخطاف الويب العام، وClips، وSlack،
+  مصادر الجرانولا وGitHub. تتم مشاركة المصادر مع المؤسسة افتراضيًا وبالتالي تكون الشركة
+  الذاكرة مفيدة لمساحة العمل بأكملها.
+- **المراجعة قبل النشر.** تحصل الذكريات المقترحة على مسار مراجعة من الدرجة الأولى
+  حيث يقوم المراجعون بتحرير الصياغة، وفحص روابط الأدلة/المصادر، والموافقة عليها أو
+  رفض. يمكن نشر الإدخالات عالية الثقة وغير الحساسة على الفور؛
+  يتم وضع الإدخالات على مستوى الشركة أو الإدخالات الحساسة في قائمة الانتظار كمقترحات.
+- **فحص المعرفة المستشهد بها.** يعرض مسار المعرفة الذرة المقطرة
+  الإدخالات التي تحتوي على النوع والموضوع والكيانات والثقة والاقتباسات الدقيقة للأدلة و
+  يحل محل الروابط.
+- **إعادة استخدام عمليات تكامل مساحة العمل.** يمكن لمصادر الدماغ إعادة استخدام مساحة العمل المشتركة
+  منح الاتصال بدلاً من إعادة إدخال الرموز المميزة للموفر. صفحة المصادر
+  يُظهر سجلات مصدر الدماغ بجانب منح الاتصال القابلة لإعادة الاستخدام والموفر
+  الاستعداد.
+- **عكس الذاكرة المعتمدة كسياق محيط.** يمكن للإدخالات المعتمدة الأساسية
+  النسخ المطابق لموارد مساحة العمل ضمن `context/company-brain/...` وغير ذلك
+  يمكن للتطبيقات استخدامها كسياق. يقوم كلا التدفقين بمعاينة Markdown بالضبط قبل
+  تم كتابة المورد أو إزالته.
+
+## البدء
+
+عرض توضيحي مباشر: [brain.agent-native.com](https://brain.agent-native.com).
+
+1. **جرّب العرض التوضيحي.** افتح اسأل واختر **بدء العرض التوضيحي**. بذور المخ صغيرة
+   مجموعة قرارات المنتج، وإجراء عمليات التحقق من الثقة، وطرح سؤال مقتبس لذلك
+   يمكنك رؤية الإجابات والاستشهادات والمراجعة والسلوك الذي لم يتم العثور عليه قبل الإضافة
+   بيانات الشركة الحقيقية.
+2. **أضف مصدرًا واحدًا.** ابدأ بقناة Slack واحدة، Granola Team-space
+   خلاصة، أو مستودع GitHub، أو تصدير Clips، أو خطاف ويب عام للنص. احتفظ
+   النطاق صغير حتى تبدو جودة الاستشهادات والمراجعة صحيحة.
+3. **المراجعة قبل النشر.** استخدم المراجعة لفحص الأدلة وتحرير الصياغة
+   والموافقة على ذاكرة الشركة الدائمة فقط.
+4. **اسأل من المصدر.** استخدم "طرح" للأسئلة التي يجب أن ترتكز على
+   المعرفة المعتمدة، وليس سجلات الدردشة الأولية.
+
+بالنسبة للعرض التوضيحي العام، توضح المجموعة المصنفة استدعاء قرار المنتج،
+روابط الاقتباس، السلوك البديل، بوابة المراجعة، التنقيح، المحتوى الشخصي
+الاستبعاد والسلوك الصادق غير الموجود دون الاتصال بمساحة عمل حقيقية.
+
+### مطالبات مفيدة
+
+- "ما الذي قررناه بشأن التسعير السنوي، وأين تمت مناقشة ذلك؟"
+- "ابحث عن أحدث تغيير في عملية الإعداد واذكر المصدر."
+- "تلخيص ما تعنيه مناقشة GitHub لخطة الإطلاق."
+- "راجع مقترحات الذاكرة المعلقة وقم بوضع علامة على أي شيء غامض جدًا بحيث لا يمكن نشره."
+- "ما هي المصادر القديمة أو التي فشلت مزامنتها؟"
+
+## للمطورين
+
+باقي هذا المستند مخصص لأي شخص يقوم بتعديل قالب Brain أو توسيعه.
+
+### بداية سريعة
+
+```bash
+npx @agent-native/core@latest create my-brain --standalone --template brain
+cd my-brain
+pnpm install
+pnpm dev
+```
+
+افتح التطبيق واختر **بدء العرض التوضيحي** لرؤية الذاكرة المستشهد بها دون الاتصال بمساحة عمل حقيقية.
+
+### نموذج البيانات
+
+يستخدم Brain عمدًا البحث النصي SQL وتوسيع الاستعلام الوكيل — هناك
+لا توجد متطلبات لقاعدة بيانات متجهة، لذا يظل القالب قابلاً للنقل عبر SQLite،
+Postgres، وNeon، وD1، وTurso، والمضيفون المشابهون. تعكس حالة التطبيق
+المسار الحالي والمرشحات والمعرفات المحددة حتى يعرف الوكيل دائمًا المسار الحالي
+التنقل والاختيار.
+
+يعيش مخطط الدماغ في `templates/brain/server/db/schema.ts`. ثمانية جداول:
+
+| الجدول                   | ما يحمله                                                                                                                                                   |
+| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `brain_sources`          | تكوين الموصل - الموفر، القنوات/المستودعات المدرجة في القائمة المسموح بها، مؤشرات المزامنة، وضعية المراجعة، `ingest_token_hash`، `status`، `last_synced_at` |
+| `brain_source_shares`    | منح المشاركة لكل مصدر (المشاهد/المحرر/المسؤول)                                                                                                             |
+| `brain_raw_captures`     | النصوص وتصدير القنوات والملاحظات واستيراد خطاف الويب باستخدام مفتاح إزالة التكرار `external_id` و`content_hash` والنوع وحالة التقطير                       |
+| `brain_knowledge`        | المدخلات الذرية المقطرة - النوع (قرار / حقيقة / عملية / ...)، الموضوع، الكيانات، اقتباسات الأدلة، الثقة، `publish_tier`، الروابط محلها                     |
+| `brain_knowledge_shares` | منح مشاركة المعرفة                                                                                                                                         |
+| `brain_proposals`        | عناصر المراجعة المعلقة — الإنشاء/التحديث/الأرشفة المقترحة مع الأدلة وملاحظات المراجع                                                                       |
+| `brain_proposal_shares`  | منح الأسهم لكل اقتراح                                                                                                                                      |
+| `brain_sync_runs`        | سجل تدقيق المزامنة - الموفر، الحالة، الإحصائيات JSON، الخطأ، الطوابع الزمنية للبدء/الانتهاء                                                                |
+| `brain_ingest_queue`     | قائمة انتظار التقطير الخلفية - التشغيل، الحالة، الأولوية، عدد مرات إعادة المحاولة، `run_after`                                                             |
+
+```an-schema title="Brain data model" summary="Connectors produce raw captures; distillation turns captures into reviewable knowledge; proposals gate sensitive entries. Sync runs and the ingest queue track background work."
+{
+  "entities": [
+    { "id": "sources", "name": "brain_sources", "note": "Connector config", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "provider", "type": "text", "note": "slack / granola / github / clips / webhook" },
+      { "name": "ingest_token_hash", "type": "text" },
+      { "name": "status", "type": "text" },
+      { "name": "last_synced_at", "type": "timestamp", "nullable": true }
+    ] },
+    { "id": "source_shares", "name": "brain_source_shares", "note": "viewer / editor / admin", "fields": [
+      { "name": "source_id", "type": "id", "fk": "brain_sources.id" }
+    ] },
+    { "id": "captures", "name": "brain_raw_captures", "note": "Ingested raw payloads", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "source_id", "type": "id", "fk": "brain_sources.id" },
+      { "name": "external_id", "type": "text", "note": "dedupe key" },
+      { "name": "content_hash", "type": "text" },
+      { "name": "kind", "type": "text" }
+    ] },
+    { "id": "knowledge", "name": "brain_knowledge", "note": "Distilled atomic entries", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "kind", "type": "text", "note": "decision / fact / process" },
+      { "name": "topic", "type": "text" },
+      { "name": "entities", "type": "json" },
+      { "name": "confidence", "type": "real" },
+      { "name": "publish_tier", "type": "text" }
+    ] },
+    { "id": "knowledge_shares", "name": "brain_knowledge_shares", "fields": [
+      { "name": "knowledge_id", "type": "id", "fk": "brain_knowledge.id" }
+    ] },
+    { "id": "proposals", "name": "brain_proposals", "note": "Pending review items", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "op", "type": "text", "note": "create / update / archive" }
+    ] },
+    { "id": "proposal_shares", "name": "brain_proposal_shares", "fields": [
+      { "name": "proposal_id", "type": "id", "fk": "brain_proposals.id" }
+    ] },
+    { "id": "sync_runs", "name": "brain_sync_runs", "note": "Sync audit log", "fields": [
+      { "name": "source_id", "type": "id", "fk": "brain_sources.id" },
+      { "name": "status", "type": "text" },
+      { "name": "stats", "type": "json" }
+    ] },
+    { "id": "ingest_queue", "name": "brain_ingest_queue", "note": "Background distillation queue", "fields": [
+      { "name": "operation", "type": "text" },
+      { "name": "status", "type": "text" },
+      { "name": "priority", "type": "int" },
+      { "name": "run_after", "type": "timestamp", "nullable": true }
+    ] }
+  ],
+  "relations": [
+    { "from": "sources", "to": "captures", "kind": "1-n", "label": "ingested into" },
+    { "from": "knowledge", "to": "captures", "kind": "n-n", "label": "evidence" },
+    { "from": "knowledge", "to": "proposals", "kind": "1-n", "label": "gated by" },
+    { "from": "sources", "to": "sync_runs", "kind": "1-n", "label": "audited by" }
+  ]
+}
+```
+
+### مفتاح actions
+
+مجمعة حسب المنطقة (`templates/brain/actions/`):
+
+- **إدارة المصدر** — `create-source`، `update-source`، `delete-source`، `get-source`، `list-sources`، `sync-source`، `sync-due-sources`، `run-slack-pilot`، `test-slack-connection`
+- **التقاط العرض** — `import-capture`، `import-transcript`، `list-captures`، `get-capture`، `mark-capture-distilled`، `resanitize-captures`
+- **التقطير** — `enqueue-distillation`، `enqueue-captures-distillation`، `claim-distillation`، `retry-distillation`، `list-distillation-queue`
+- **المعرفة والمراجعة** — `write-knowledge`، `get-knowledge`، `list-knowledge`، `set-knowledge-canonical`، `preview-canonical-resource`، `list-proposals`، `review-proposal`، `approve-proposal`، `reject-proposal`، `update-proposal`
+- **البحث والاسترجاع** — `ask-brain`, `search-knowledge`, `search-everything`
+- **الإعدادات** — `get-brain-settings`، `update-brain-settings`، `set-settings`، `get-settings`
+- **التقييم والعرض التوضيحي** — `seed-demo-data`، `run-demo-eval`، `run-retrieval-eval`
+- **السياق والتنقل** — `view-screen`، `navigate`
+- **الموفر APIs** — `provider-api-catalog`، `provider-api-docs`، `provider-api-request`
+
+### توصيل المصادر
+
+يحل Brain بيانات اعتماد الموفر من اتصال مساحة العمل الممنوح أولاً،
+ثم من بيانات اعتماد مخزن الدماغ المحلي أو المسجلة المتوافقة مع الإصدارات السابقة.
+لا تعود بيانات اعتماد مصدر الدماغ إلى متغيرات البيئة على مستوى النشر.
+إذا كان الموفر المشترك موجودًا بالفعل، فامنح الوصول إلى Brain بدلاً من نسخ
+نفس السر في بيئة خاصة بالدماغ.
+
+**Slack.** قم بإنشاء مصدر محدد بمعرفات قناة محددة. الموصل
+التحقق من كل محادثة تم تكوينها، ورفض الرسائل المباشرة وMPIMs، وتخزين المؤشر
+بحيث يتم استئناف كل مزامنة من حيث توقفت آخر مزامنة. تدفق آمن للطرح على
+تتيح لك كل بطاقة مصدر Slack **اختبار** بيانات الاعتماد والقائمة المسموح بها بدون
+سجل القراءة، قم بتشغيل عينة صغيرة من **الطيار الآمن**، **مراجعة اللقطات**،
+والموافقة في **قائمة انتظار المراجعة** قبل أن يصبح أي شيء قابلاً للاستعلام عنه. منح
+روبوت فقط النطاقات التي يحتاجها المصدر (التحقق من صحة بيانات الاعتماد، القائمة المسموح بها
+التحقق، وسجل القنوات المسموح بها، والروابط الدائمة الدائمة).
+
+**Granola.** قم بإنشاء مصدر بنافذة اقتراع وحجم الصفحة. الجرانولا
+تكشف مفاتيح API الخاصة بالمؤسسة عن ملاحظات مساحة الفريق، وليس الملاحظات أو المجلدات الخاصة. الدماغ
+يخزن ملخص الملاحظة والنص والحاضرين وبيانات تعريف التقويم والمصدر
+URL كلتقطير خام قبل التقطير.
+
+**GitHub.** قم بإنشاء مصدر محدد للمستودعات المعتمدة. الموصل
+يستورد الإصدار المحدود وسياق طلب السحب بمصدر ثابت URL يمكنه
+يتم تقطيرها مثل Slack أو سياق الاجتماع. هذا هو استيعاب سياق الدماغ، وليس
+بديل لإعداد التقارير GitHub بنمط Analytics.
+
+**المقاطع وwebhooks العامة.** يكشف Brain عن خطاف ويب موقع للمقاطع و
+استيراد النسخ/الالتقاط العام في `/api/_agent-native/brain/ingest`. إنشاء
+مصدر به `sourceKey` لاستلام الرمز المميز لحامله، ثم أرسل
+`RawCapturePayload` مع `Authorization: Bearer <ingestToken>`. المصادر العامة
+استخدام نفس شكل الحمولة لنصوص المكالمات وأبحاث العملاء المستوردة
+الملاحظات، أو أي مصدر آخر يمكن أن ينتج التقاطًا محددًا.
+
+```an-api title="Signed ingest webhook" summary="Clips and generic transcript/capture imports post a RawCapturePayload with a per-source bearer token."
+{
+  "method": "POST",
+  "path": "/api/_agent-native/brain/ingest",
+  "summary": "Import a raw capture from Clips or a generic source",
+  "auth": "Bearer <ingestToken> issued per source via its sourceKey",
+  "request": {
+    "contentType": "application/json",
+    "example": "RawCapturePayload — bounded transcript / capture body"
+  },
+  "responses": [
+    { "status": "200", "description": "Capture accepted and queued for distillation" },
+    { "status": "401", "description": "Missing or invalid ingest bearer token" }
+  ]
+}
+```
+
+يمكن لمصادر Slack وGranola وGitHub تفعيل `autoSync` في الخلفية باستخدام
+إيقاع الاستطلاع بمجرد إثبات جودة المراجعة.
+
+### الخصوصية والبوابة
+
+تم تصميم الدماغ لذاكرة الشركة، وليس للمراقبة الشخصية:
+
+- تقرأ مزامنة Slack فقط القنوات التي تم تكوينها بشكل صريح وترفض الرسائل المباشرة/MPIMs.
+- تقرأ مزامنة Granola ملاحظات مساحة الفريق التي كشفها API من Granola، وليست خاصة
+  الملاحظات أو المجلدات الخاصة.
+- يتم تنقيح اللقطات الأولية من أسطح القائمة/البحث بشكل افتراضي؛ المراجعين
+  وتتطلب تدفقات التقطير معاينات أو محتوى خام فقط عند الحاجة.
+- يمكن أن تتطلب تكوينات المصدر المراجعة قبل أن تصبح المعرفة المقطرة متينة
+  ذاكرة الشركة.
+- تتحكم الإعدادات في طبقة النشر الافتراضية، سواء كانت المعرفة بطبقة الشركة تتطلب
+  الموافقة ومتطلبات الاقتباس وتنقيح البريد الإلكتروني وخطأ الموصل
+  الإشعارات.
+
+### تخصيصه
+
+يتبع Brain العقد المكون من أربع مناطق للوكيل الأصلي - قم بتغيير السلوك عن طريق التحرير
+منطقة المطابقة، ويمكن للوكيل إجراء هذه التعديلات نيابةً عنك:
+
+- `templates/brain/app/routes/` — سطح UI: اسأل، ابحث، معرفة،
+  المراجعة والمصادر والإعدادات ومسارات الفريق.
+- `templates/brain/actions/` — كل عملية يمكن استدعاءها بواسطة الوكيل (الواردات، المصدر
+  الإدارة، التقارير التجريبية، التقطير، مراجعة المقترحات، البحث المقتبس،
+  التنقل/السياق). أضف ملفًا جديدًا باستخدام `defineAction` لكشف
+  القدرة.
+- `templates/brain/.agents/skills/` — إرشادات خاصة بالدماغ للتقطير
+  واسترجاعها. قم بتحديث أو إضافة مهارة عندما تقوم بتعليم الوكيل سير عمل جديد.
+- `templates/brain/AGENTS.md` — دليل الوكيل عالي المستوى. قم بالتحديث عند إضافة التخصص
+  الميزات.
+- `templates/brain/server/db/schema.ts` — نموذج البيانات. عمليات الترحيل الإضافية فقط؛
+  عكس المسار والمرشحات والمعرفات المحددة في `application_state` للوكيل
+  السياق.
+
+اطلب من الوكيل إجراء تغييرات نيابةً عنك — يمكنه تعديل مصدره الخاص. انظر
+[Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
+
+## ما هي الخطوة التالية
+
+- [**Dispatch**](/docs/dispatch) — مستوى التحكم في مساحة العمل
+- [**Dispatch template**](/docs/template-dispatch) — تطبيق التنسيق المدعم
+- [**Workspace**](/docs/workspace) — الموارد المشتركة عبر التطبيقات
+- [**A2A Protocol**](/docs/a2a-protocol) — التفويض عبر التطبيقات

package/corpus/core/docs/content/locales/ar-SA/template-calendar.md

@@ -0,0 +1,194 @@
+---
+title: "التقويم"
+description: "تقويم مدعوم من الوكيل مع مزامنة Google Calendar وروابط الحجز بنمط Calendly. يمكنك الجدولة والعثور على المواعيد وإدارة التوفر من خلال اللغة الإنجليزية البسيطة."
+---
+
+# التقويم
+
+تطبيق تقويم مدعوم من الوكيل. قم بتوصيل Google Calendar الخاص بك وسيتمكن الوكيل من قراءة جدولك الزمني والعثور على فتحات مجانية وإنشاء أحداث وإدارة روابط الحجز على نمط Calendly - كل ذلك باللغة الإنجليزية البسيطة. فهو يستبدل مجموعة Google Calendar + Calendly بتطبيق واحد تملكه.
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px;padding:14px 18px;border-bottom:1.4px solid var(--wf-line)'><button>Week</button><button>Today</button><button>‹</button><button>›</button><div style='flex:1'></div><strong>May 3-9, 2026</strong><div style='flex:1'></div><button class='primary'>New Event</button></div><div style='display:grid;grid-template-columns:56px repeat(7,minmax(0,1fr));grid-template-rows:36px repeat(5,72px);gap:7px;padding:14px;flex:1'><div></div><strong>Sun 3</strong><strong>Mon 4</strong><strong>Tue 5</strong><strong>Wed 6</strong><strong>Thu 7</strong><strong>Fri 8</strong><strong>Sat 9</strong><small class='wf-muted'>7 AM</small><div class='wf-box' style='opacity:.45'></div><div></div><div></div><div></div><div></div><div></div><div></div><small class='wf-muted'>9 AM</small><div class='wf-box'>All-hands</div><div class='wf-box'>Eng standup</div><div class='wf-box'>Eng standup</div><div class='wf-box'>Eng standup</div><div></div><div class='wf-box'>Planning</div><div></div><small class='wf-muted'>11 AM</small><div class='wf-box'>Design review</div><div></div><div class='wf-box'>Design crit</div><div class='wf-box'>Roadmap</div><div class='wf-box'>Friday demo</div><div></div><div></div><small class='wf-muted'>1 PM</small><div></div><div class='wf-box'>1:1</div><div class='wf-box'>Focus block</div><div></div><div></div><div class='wf-box'>All-hands</div><div></div><small class='wf-muted'>3 PM</small><div></div><div></div><div></div><div class='wf-box'>Skip-level</div><div></div><div></div><div></div></div></div>"
+}
+```
+
+عند فتح التطبيق، يكون عرض التقويم النشط هو السطح الأساسي. لا يزال الوكيل يعرف اليوم أو الأسبوع أو الحدث الذي تتطلع إليه، لذا يمكنك أن تقول "حدد موعدًا لمكالمة مدتها 30 دقيقة مع Alex في هذا اليوم" دون توضيح كل شيء.
+
+```an-diagram title="How a scheduling request flows" summary="Whether you click in the calendar or ask the agent, the same actions read live from Google Calendar and write back to the same view."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">You click<br><small class=\"diagram-muted\">drag, toolbar, shortcuts</small></div><div class=\"diagram-node\">You ask the agent<br><small class=\"diagram-muted\">\"find a 1-hour slot next week\"</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">list-events · check-availability · create-event</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Google Calendar<br><small class=\"diagram-muted\">live, multi-account</small></div><div class=\"diagram-box\">SQL<br><small class=\"diagram-muted\">bookings · availability</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">Calendar view updates live</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}"
+}
+```
+
+## ما يمكنك فعله به
+
+- **شاهد Google Calendar** الحقيقي في عرض اليوم أو الأسبوع أو الشهر، مع تراكب حسابات متعددة.
+- **اشترك في خلاصات ICS** (إجازات الموارد البشرية، وجداول المؤتمرات، وتقويمات الفريق) — للقراءة فقط، ومختلطة في نفس العرض.
+- **تعيين التوفر الأسبوعي** مع دعم المنطقة الزمنية — يستخدم الوكيل هذا عند البحث عن فتحات مجانية.
+- **إنشاء روابط حجز عامة** على `/book/{slug}` لأشياء مثل "مقدمة مدتها 15 دقيقة" أو "عرض توضيحي مدته 30 دقيقة". قم بتكوين الفترات والحقول المخصصة وأداة المؤتمرات التي سيتم استخدامها.
+- **اسأل الوكيل عن أي شيء يتعلق بالجدول الزمني**: "هل أنا متفرغ بعد ظهر يوم الخميس؟" "ابحث عن فترة زمنية مدتها ساعة واحدة في الأسبوع المقبل، ثم ضع عبارة "التخطيط مع Alex" عليها." "إيقاف رابط الحجز التجريبي مؤقتًا."
+- **مشاركة روابط الحجز** مع أعضاء الفريق حتى يتمكنوا من إدارتها أيضًا.
+
+## البدء
+
+عرض توضيحي مباشر: [calendar.agent-native.com](https://calendar.agent-native.com).
+
+عند فتح التطبيق لأول مرة:
+
+1. انقر على **الإعدادات**.
+2. انقر فوق **Connect Google Calendar** ثم قم بالموافقة.
+3. (اختياري) قم بتوصيل المزيد من حسابات Google إذا كنت تريد تراكب الحسابات الشخصية والعملية.
+4. افتح العرض الرئيسي - سيتم تحميل التقويم الحقيقي الخاص بك.
+
+لإنشاء رابط الحجز الأول:
+
+1. انقر على **روابط الحجز** في الشريط الجانبي.
+2. انقر على **رابط حجز جديد**، وعيّن العنوان والمدة.
+3. مشاركة URL العامة - يختار الزائرون من الخانات المتاحة لديك.
+
+أو اسأل الوكيل فقط: "أنشئ رابط حجز تمهيدي مدته 15 دقيقة مع حقل الاسم."
+
+### مطالبات مفيدة
+
+- "ماذا يوجد في تقويمي اليوم؟"
+- "هل أنا متفرغ بعد ظهر الخميس لمدة 30 دقيقة؟"
+- "ابحث عن فترة زمنية مدتها ساعة واحدة في الأسبوع القادم وضع عليها عبارة "التخطيط مع Alex"."
+- "إعادة جدولة هذا الحدث إلى الجمعة الساعة 2 ظهرًا." (عند تحديد حدث)
+- "التبديل إلى عرض اليوم والانتقال إلى يوم الاثنين القادم."
+- "أنشئ رابط حجز يسمى "مقدمة مدتها 15 دقيقة" في 15 دقيقة مع حقل ملاحظة."
+- "إيقاف رابط الحجز التجريبي لمدة 30 دقيقة مؤقتًا."
+- "حظر فترات ما بعد الظهر يوم الجمعة عند توفري."
+- "ما هي الاجتماعات التي سأعقدها بشأن "الانطلاق" هذا الشهر؟"
+
+سيقوم الوكيل بالاستعلام عن Google Calendar مباشرة لأي سؤال يتعلق بالجدول الزمني - فهو لا يخمن أبدًا.
+
+## للمطورين
+
+باقي هذا المستند مخصص لأي شخص يقوم بتعديل قالب التقويم أو توسيعه.
+
+### بداية سريعة
+
+قم بإنشاء مساحة عمل جديدة باستخدام قالب التقويم:
+
+```bash
+npx @agent-native/core@latest create my-app --standalone --template calendar
+cd my-app
+pnpm install
+pnpm dev
+```
+
+افتح `http://localhost:8082` (منفذ تطوير التقويم الافتراضي).
+
+لربط Google Calendar في جهاز التطوير، افتح عرض الإعدادات، والصق `GOOGLE_CLIENT_ID` و`GOOGLE_CLIENT_SECRET` من [Google Cloud Console](https://console.cloud.google.com/)، ثم انقر فوق "Connect Google Calendar". إعادة توجيه OAuth URI هي `http://localhost:8082/_agent-native/google/callback` في التطوير. يتم تخزين الرموز المميزة في جدول `oauth_tokens` SQL ويتم تحديثها تلقائيًا.
+
+### الميزات الرئيسية
+
+**عروض التقويم المباشرة.** تتم قراءة طرق عرض اليوم والأسبوع والشهر مباشرة من حسابات Google المتصلة، مع خلاصات ICS الاختيارية للقراءة فقط والمدرجة في نفس الجدول.
+
+**التوفر والبحث في الفتحات المجانية.** تغذي قواعد التوفر الأسبوعية ودعم المنطقة الزمنية والأحداث الحالية نفس إجراء التوفر الذي يستخدمه UI والوكيل.
+
+**روابط الحجز.** تجمع صفحات `/book/{slug}` العامة الاسم والبريد الإلكتروني والحقول المخصصة وتفضيلات المؤتمرات والرموز المميزة للإلغاء/إعادة الجدولة.
+
+**إدارة قابلة للمشاركة.** تكون روابط الحجز خاصة بشكل افتراضي، ولكن يمكن مشاركتها مع أعضاء الفريق من خلال مشاركة إطار العمل actions.
+
+**معاينات الأحداث المضمنة.** يستطيع الوكيل تضمين بطاقات أحداث مضغوطة في الدردشة مع العنوان، والوقت، والموقع، والحاضرين، وزر الرجوع.
+
+### العمل مع الوكيل
+
+يرى الوكيل ما تنظر إليه. يتم تضمين عرض التقويم الحالي والتاريخ المحدد والحدث المحدد في كل رسالة ككتلة `current-screen`، لذا يمكنك أن تقول "هذا الحدث" أو "هذا اليوم" ويتم حلها بشكل صحيح.
+
+تحت الغطاء، يقوم الوكيل باستدعاء actions مثل `list-events`، و`check-availability`، و`create-event`، و`navigate`، و`update-availability`. نظرًا لأن الأحداث موجودة في Google Calendar، يقوم الوكيل دائمًا بالاستعلام عن API بدلاً من التخمين - ولن يقوم بإرجاع نتائج فارغة دون تشغيل البرنامج النصي أولاً.
+
+### نموذج البيانات
+
+محدد في `templates/calendar/server/db/schema.ts`. يتم تخزين البيانات غير المتعلقة بالحدث فقط محليًا:
+
+- `bookings` — المواعيد المؤكدة من صفحات الحجز العامة. اسم المتجر، والبريد الإلكتروني، والبداية، والنهاية، والارتباط الثابت، والملاحظات الاختيارية، واستجابات الحقول المخصصة، ورابط الاجتماع، وإدارة `cancelToken` للعامة URL، وحالة `confirmed` أو `cancelled`.
+- `booking_links` — تعريفات الارتباط بنمط Calendly. سبيكة، العنوان، الوصف، `duration` الأساسي، قائمة `durations` الاختيارية، `customFields`، `conferencing`، `color`، وعلامة `isActive`. يستخدم `ownableColumns` الخاص بإطار العمل حتى يتم تطبيق نظام المشاركة.
+- `booking_slug_redirects` — يتذكر الارتباطات الثابتة القديمة عند إعادة تسمية الرابط حتى تستمر URL العامة الموجودة في العمل.
+- `booking_link_shares` — مشاركة المنح لروابط الحجز.
+
+```an-schema title="Calendar data model" summary="Only non-event data is stored locally — events live in Google Calendar. Booking links use ownableColumns so the sharing system applies."
+{
+  "entities": [
+    {
+      "id": "booking_links",
+      "name": "booking_links",
+      "note": "Calendly-style link definitions (ownable)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "slug", "type": "string", "note": "public page at /book/{slug}" },
+        { "name": "title", "type": "string" },
+        { "name": "description", "type": "string", "nullable": true },
+        { "name": "duration", "type": "int", "note": "primary duration in minutes" },
+        { "name": "durations", "type": "json", "nullable": true, "note": "alternative durations" },
+        { "name": "customFields", "type": "json", "nullable": true },
+        { "name": "conferencing", "type": "string", "note": "Google Meet / Zoom / custom" },
+        { "name": "color", "type": "string", "nullable": true },
+        { "name": "isActive", "type": "bool", "note": "pause without deleting" }
+      ]
+    },
+    {
+      "id": "bookings",
+      "name": "bookings",
+      "note": "Confirmed appointments from public booking pages",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "slug", "type": "string", "fk": "booking_links.slug" },
+        { "name": "name", "type": "string" },
+        { "name": "email", "type": "string" },
+        { "name": "start", "type": "datetime" },
+        { "name": "end", "type": "datetime" },
+        { "name": "notes", "type": "string", "nullable": true },
+        { "name": "customFields", "type": "json", "nullable": true, "note": "custom field responses" },
+        { "name": "meetingLink", "type": "string", "nullable": true },
+        { "name": "cancelToken", "type": "string", "note": "powers /booking/manage/{token}" },
+        { "name": "status", "type": "enum", "note": "confirmed | cancelled" }
+      ]
+    },
+    {
+      "id": "booking_slug_redirects",
+      "name": "booking_slug_redirects",
+      "note": "Keeps old public URLs working after a link is renamed",
+      "fields": [
+        { "name": "oldSlug", "type": "string", "pk": true },
+        { "name": "linkId", "type": "id", "fk": "booking_links.id" }
+      ]
+    },
+    {
+      "id": "booking_link_shares",
+      "name": "booking_link_shares",
+      "note": "Share grants for booking links",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "linkId", "type": "id", "fk": "booking_links.id" },
+        { "name": "principal", "type": "string", "note": "user or org" },
+        { "name": "role", "type": "enum", "note": "viewer | editor | admin" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "booking_links", "to": "bookings", "kind": "1-n", "label": "has bookings" },
+    { "from": "booking_links", "to": "booking_slug_redirects", "kind": "1-n", "label": "has old slugs" },
+    { "from": "booking_links", "to": "booking_link_shares", "kind": "1-n", "label": "has share grants" }
+  ]
+}
+```
+
+توجد قواعد التوفر والتكوين لكل مستخدم في جدول الإعدادات، مع مفتاح `calendar-availability`. توجد رموز Google OAuth في جدول إطار العمل `oauth_tokens`. توجد حالة UI المؤقتة (العرض الحالي والتاريخ والحدث المحدد) في `application_state` تحت مفتاح `navigation`.
+
+### تخصيصه
+
+كل جزء من التطبيق هو مصدر قابل للتحرير. ابدأ هنا:
+
+- `templates/calendar/actions/` — كل عملية يمكن استدعاءها بواسطة الوكيل. أضف ملفًا جديدًا باستخدام `defineAction` لكشف الإمكانات الجديدة لكل من الوكيل والواجهة الأمامية. الملفات الرئيسية: `check-availability.ts`، `create-event.ts`، `list-events.ts`، `create-booking-link.ts`، `update-availability.ts`، `add-external-calendar.ts`، `navigate.ts`، `view-screen.ts`.
+- `templates/calendar/app/routes/` — UI. `_app._index.tsx` هو التقويم، و`_app.availability.tsx` هو محرر الجدول الزمني، و`_app.booking-links._index.tsx` و`_app.booking-links.$id.tsx` يديران روابط الحجز، و`_app.bookings.tsx` يسرد الحجوزات، و`_app.settings.tsx` هي الإعدادات، و`book.$slug.tsx` plus `meet.$username.$slug.tsx` هي صفحات الحجز العامة.
+- `templates/calendar/server/db/schema.ts` - إضافة أعمدة أو جداول باستخدام Drizzle. احتفظ باللهجة الرمزية حتى يتم تشغيل القالب على SQLite، وPostgres، وTurso، وD1، وNeon.
+- `templates/calendar/AGENTS.md` — تعليمات الوكيل. قم بتحديث هذا عندما تقوم بتعليم الوكيل إمكانيات أو اصطلاحات جديدة.
+- `templates/calendar/.agents/skills/` — الأنماط التفصيلية التي يتبعها الوكيل. skills ذات الصلة: `event-management`، `availability-booking`، `real-time-sync`، `storing-data`، `delegate-to-agent`، `frontend-design`.
+- `templates/calendar/shared/api.ts` — أنواع TypeScript المشتركة (`AvailabilityConfig`، `BookingLink`، `ExternalCalendar`، وما إلى ذلك) التي يستخدمها كل من الخادم والعميل.
+
+إذا قمت بإضافة ميزة، فتذكر تحديث جميع المجالات الأربعة: UI أو الإجراء أو المهارة أو إدخال AGENTS.md وأي حالة تطبيق يحتاج الوكيل إلى رؤيتها. وهذا ما يبقي الوكيل وUI على قدم المساواة.