@agent-native/core 0.76.5 → 0.76.6

package/docs/content/locales/ar-SA/template-content.md

@@ -0,0 +1,402 @@
+---
+title: "المحتوى"
+description: "Obsidian مفتوح المصدر لـ MDX: قم بتحرير ملفات Markdown/MDX المحلية، وقم بإنشاء كتل مخصصة تفاعلية غنية، والكتابة باستخدام وكيل AI."
+---
+
+# المحتوى
+
+المحتوى عبارة عن Obsidian مفتوح المصدر لـ MDX: مستند صديق للملفات المحلية
+مساحة عمل يمكن للوكيل من خلالها قراءة الصفحات وكتابتها وإعادة تنظيمها ونشرها لـ
+أنت. افتح مستندًا، واطلب "إعادة كتابة هذه الفقرة لتكون أكثر إيجازًا" أو "إنشاء
+صفحة تسمى تخطيط الربع الرابع مع صفحات فرعية للأهداف والمقاييس والمخاطر" - نفس الشيء
+النتيجة سواء قمت بذلك بنفسك أو طلبت ذلك.
+
+```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 المحلية مثل Obsidian.** استخدم طريقة العرض `/local-files`
+  لتصدير مساحة العمل الخاصة بك إلى الملفات، قم بتحريرها باستخدام أدواتك الخاصة، ثم قم بالمعاينة
+  التغييرات، ثم قم باستيرادها مرة أخرى. في وضع الملف المحلي، تتم كتابة المحتوى مباشرة إلى
+  الملف `.md` أو `.mdx` المحدد.
+- **إنشاء كتل مخصصة تفاعلية غنية.** تسجيل مكونات React المحلية،
+  أدخلها كـ MDX، واسمح للوكيل بإنشاء أو تحديث ملفات المكونات لـ
+  مستنداتك.
+- **المزامنة مع Notion.** ربط مستند محلي بصفحة Notion وسحب المحتوى أو دفعه في أي من الاتجاهين. تتم مزامنة التعليقات في كلا الاتجاهين أيضًا.
+- **التعاون في الوقت الفعلي.** يمكن لعدة أشخاص (والوكيل) تعديل نفس المستند في نفس الوقت.
+- **مشاركة المستندات** مع أعضاء الفريق أو جعلها عامة — خاصة بشكل افتراضي، مع أدوار المشاهد/المحرر/المشرف.
+- **اطلب من الوكيل أي شيء**: "أعد كتابة هذه الفقرة." "أضف TL;DR في الأعلى." "البحث عن كافة ملاحظات الاجتماع الخاصة بي من الأسبوع الماضي." "اجعل هذه النغمة أكثر رسمية."
+
+## البدء
+
+عرض توضيحي مباشر: [content.agent-native.com](https://content.agent-native.com).
+
+عند فتح التطبيق، انقر فوق **+ صفحة جديدة** في الشريط الجانبي، وأعطها عنوانًا، وابدأ في الكتابة. لاستخدام الوكيل، اكتب في الشريط الجانبي:
+
+- "أنشئ صفحة باسم Onboarding وأضف ثلاث صفحات فرعية تحتها."
+- "أعد كتابة هذه الفقرة لتكون أكثر إيجازًا." (مع صفحة مفتوحة)
+- "أضف قسمًا حول التسعير بثلاث نقاط."
+- "تلخيص هذا المستند في TL;DR في الأعلى."
+- "سحب الأحدث من Notion." (بعد ربط صفحة Notion)
+
+حدد نصًا واضغط على Cmd+I لتركيز الوكيل مع هذا التحديد الذي تم تحميله مسبقًا - "اجعل هذا أكثر قوة" ثم يعمل على ما حددته بالضبط.
+
+## ملفات Markdown/MDX المحلية {#local-files}
+
+يمكن للمحتوى نقل المستندات ذهابًا وإيابًا عبر الملفات المحلية دون استنساخها أو تشغيلها
+تطبيق المحتوى محليًا. يبدو الأمر أشبه بـ Obsidian بالنسبة لـ 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. استخدم هذا لمستندات الريبو الأولى،
+المدونات أو مكتبات الموارد أو المحتوى الشخصي بنمط Obsidian الذي يعمل بنظام MDX
+المكونات؛ قم بالتبديل مرة أخرى إلى وضع قاعدة البيانات عندما تريد التعاون المستضاف و
+المشاركة المدعومة بـ SQL. راجع [Local File Mode](/docs/local-file-mode) لمعرفة
+تخطيط الريبو المستقل، التكوين، مكونات MDX المخصصة، المحلية
+أدوات `extensions/` ودليل سلامة الإنتاج.
+
+لتثبيت مهارة ملفات المحتوى المحلية في الريبو الحالي:
+
+```bash
+npx @agent-native/core@latest skills add content --mode local-files --scope project
+```
+
+يقوم المثبت بنسخ مهارة `content` لوكيل الترميز الخاص بك ويقوم بكتابة أو
+تحديثات `agent-native.json` بجذور المحتوى لـ `docs/`، و`blog/`، و`content/`،
+و `resources/`. عندما يكون تطبيق المحتوى المحلي، أو Agent Native Desktop، أو موثوقًا به
+الجسر المحلي قيد التشغيل، ويجب على الوكلاء استخدام المحتوى 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` وأنشئ صفحتك الأولى. ثم اطلب من الوكيل "إنشاء صفحة تسمى Onboarding وإضافة ثلاث صفحات فرعية تحتها".
+
+### الميزات الرئيسية {#key-features}
+
+**الصفحات المتداخلة.** تشكل المستندات شجرة قابلة للسحب تحتوي على المفضلة والرموز والترتيب والمشاركة على مستوى الصفحة.
+
+**محرر MDX الغني.** يعمل Tiptap على تشغيل العناوين والقوائم والجداول وكتل التعليمات البرمجية والصور والروابط وأوامر الشرطة المائلة وأشرطة أدوات التحديد ومكونات React المحلية.
+
+**التعاون المباشر.** يحتفظ Yjs بالعديد من المحررين وتعديلات الوكيل بشكل متزامن دون التشويش على بعضهم البعض.
+
+**البحث والتعليقات.** يتم تضمين البحث عن النص الكامل والتعليقات المرتبطة وسجل الإصدارات وتدفقات الاستعادة في سطح المستند.
+
+**أسطح المزامنة.** يمكن مزامنة المستندات مع مجلدات Notion أو مجلدات Markdown/MDX المحلية، حيث تعمل SQL كطبقة ذاكرة التخزين المؤقت/السجل التعاونية.
+
+### مزامنة الملفات المحلية
+
+يستخدم مسار `/local-files` المحمي الوصول إلى نظام الملفات في المتصفح API، أو
+جسر المجلد الأصلي المحمي داخل Agent Native Desktop، للقراءة والكتابة
+ملفات Markdown/MDX من مجلد اختاره المستخدم. بعد ربط المجلد و
+تم استيراده، ويتم التعامل مع الملف المحدد باعتباره المرجع: يتم قراءة فتح الصفحة
+الملف، ويقوم المحرر العادي بحفظ الملف أولاً. يتم بعد ذلك تحديث SQL باعتباره
+طبقة ذاكرة التخزين المؤقت/السجل للمستند الحالي UI والبحث ولوحة الإصدار، وليس
+كمصدر للحقيقة. تعرض قائمة الصفحة العلوية اليمنى مسار المصدر المحلي:
+المسار النسبي متاح دائمًا، والمسار المطلق متاح في ملف محلي حقيقي
+وAgent Native Desktop والكشف في Finder من خلال
+جسر سطح المكتب أو وضع الملف المحلي المدعوم من الخادم.
+
+يستدعي مسار المزامنة المجمعة:
+
+- `export-content-source` — يقرأ شجرة المستندات التي يمكن الوصول إليها ويعيد
+  حزمة الملفات الحتمية `content/`.
+- `import-content-source` — التحقق من صحة الملفات، وإنشاء مستندات خاصة جديدة،
+  يقوم بتحديث المستندات التي يتمتع المتصل بإمكانية وصول المحرر إليها، ويحتفظ بالنسخة
+  السجل، ويرفض الدورات الأصلية غير الصالحة.
+
+التنسيق المصدر موجود في `shared/content-source.ts`. احتفظ بهذا الملف باسم
+عقد واحد لأسماء الملفات والجزء الأمامي والتحليل والتسلسل.
+
+يمكن لمساحات عمل الملفات المحلية أيضًا توفير مكونات React المحلية من خلال
+مجلد `components` الذي تم تكوينه. يستورد خادم تطوير المحتوى PascalCase
+يصدر من تلك الملفات، ويعرض علامات MDX المطابقة مثل `<ImpactCounter />`
+داخل المحرر، ويعرضها في القائمة المائلة ضمن المكونات المحلية.
+هذه هي طبقة "Obsidian for 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 Desktop حتى يتمكن مسار مساحة العمل المحدد من العمل
+يتم تسجيله في خادم تطوير المحتوى المحلي. يقوم 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 في نموذج البيانات، يشحن القالب `export-document` لتحويل الصفحة إلى Markdown أو HTML، و`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_comment_id` الاختياري لمزامنة Notion ثنائية الاتجاه.
+- **`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" }
+  ]
+}
+```
+
+يتم تخزين المحتوى كتخفيض. يقوم المحرر بالتحويل من وإلى نموذج Tiptap JSON في الذاكرة؛ يتم دائمًا تخفيض الصف SQL بحيث يمكن تشغيل actions والبحث ومزامنة Notion بتنسيق أساسي واحد.
+
+تتضمن جميع الجداول القابلة للتملك `owner_email` و`org_id` عبر `ownableColumns()`، بحيث يتم تحديد نطاق كل صف للمستخدم الذي قام بتسجيل الدخول (ومؤسسته النشطة بشكل اختياري) منذ لحظة إنشائه.
+
+### تخصيصه
+
+الأماكن الأربعة التي يجب البحث فيها عند تغيير السلوك:
+
+- **`actions/`** — كل عملية يمكن للوكيل أو UI تنفيذها. أضف ملفًا جديدًا مثل `actions/publish-to-wordpress.ts` باستخدام `defineAction` وسيحصل عليه الطرفان مجانًا. مفتاح 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/`** — محرر Tiptap. أضف نوع عقدة جديد ضمن `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 وكتابة الإجراء.

package/docs/content/locales/ar-SA/template-design.md

@@ -0,0 +1,173 @@
+---
+title: "التصميم"
+description: "استوديو نماذج أولية HTML للوكيل - يمكنك إنشاء تصميمات Alpine/Tailwind التفاعلية وتحسينها ومعاينتها وتصديرها مع الوكيل."
+---
+
+# التصميم
+
+التصميم عبارة عن استوديو نماذج أولية تابع للوكيل HTML. بدلاً من لوحة رسم ذات طبقات، يقوم الوكيل بإنشاء نماذج Alpine/Tailwind HTML كاملة ومستقلة بذاتها، ويعرضها في إطار iframe، ويتيح لك تحسين النتيجة باستخدام المطالبات وعناصر التحكم.
+
+```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'>Product launch page</h1><span class='wf-pill accent'>Desktop</span><span class='wf-pill'>Tablet</span><span class='wf-pill'>Mobile</span><div style='flex:1'></div><button>Preview</button><button class='primary'>Export code</button></div><div class='wf-card' style='flex:1;display:grid;grid-template-rows:auto 1fr auto;gap:12px'><div style='display:flex;gap:8px'><span class='wf-pill accent'>Hero</span><span class='wf-pill'>Pricing</span><span class='wf-pill'>FAQ</span></div><div class='wf-box' style='display:flex;align-items:center;justify-content:center;min-height:230px'><strong>Generated HTML prototype</strong></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span class='wf-muted'>Make the hero denser and the CTA clearer.</span><div style='flex:1'></div><button class='primary'>Apply revision</button></div></div></div>"
+}
+```
+
+عند فتح التطبيق، يكون النموذج الأولي الذي تم إنشاؤه هو مركز مساحة العمل، مع وجود أوضاع المعاينة والمراجعات السريعة وعناصر التحكم في التصدير في متناول اليد. كل ما ينتجه الوكيل هو HTML حقيقي ويمكنك تحسينه أو تصديره أو تسليمه.
+
+```an-diagram title="One artifact, no translation" summary="The agent generates standalone Alpine/Tailwind HTML; the iframe, the editable source, and every export all read the same files. A linked design system feeds tokens into each pass."
+{
+  "html": "<div class=\"diagram-design\"><div class=\"diagram-col\"><div class=\"diagram-node\">Prompt<br><small class=\"diagram-muted\">describe screen / page</small></div><div class=\"diagram-pill\">Design system</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill accent\">Agent generate</span><small class=\"diagram-muted\">standalone HTML / JSX files</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>iframe preview<br><small class=\"diagram-muted\">tweak knobs · Cmd+I refine</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill ok\">Export</span><small class=\"diagram-muted\">HTML · ZIP · PDF · handoff</small></div></div>",
+  "css": ".diagram-design{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-design .diagram-col{display:flex;flex-direction:column;gap:8px;align-items:flex-start}.diagram-design .diagram-box{display:flex;flex-direction:column;gap:4px}.diagram-design .diagram-arrow{font-size:20px;line-height:1}.diagram-design .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## متى يتم اختياره
+
+- **أنت تريد مفهومًا مصقولًا للصفحة المقصودة، أو اتجاه منتج UI، أو استكشاف العلامة التجارية** التي يمكن أن تترك الأداة كـ HTML حقيقية — وليست لوحة رسم متعددة الطبقات.
+- **أنت تريد نموذجًا أوليًا تفاعليًا فعالاً**، مع تصميم Alpine interactions وTailwind، بدلاً من النماذج الثابتة.
+- **تريد مقارنة الاتجاهات بسرعة** وإنشاء بعض المتغيرات واختيار الأقوى والاستمرار في التحسين.
+- **تريد مخرجات تصميم خاصة بك** — قم بتصدير HTML، أو ZIP، أو PDF، أو قم بتسليم النموذج الأولي إلى أداة البرمجة.
+
+## ما يمكنك فعله به
+
+- **إنشاء نماذج أولية كاملة.** قم بوصف الشاشة أو الصفحة التي تحتاجها وسيقوم الوكيل بإنشاء مستند HTML صالح مع تصميم Tailwind وAlpine interactions.
+- **مقارنة المتغيرات.** ابدأ باتجاهات متعددة، واختر الاتجاه الأقوى، ثم تابع التحسين.
+- **التعديل بشكل مرئي.** استخدم عناصر التحكم في التعديل المضمنة لإجراء التغييرات الشائعة، أو اطلب من الوكيل تحديثات النسخ والتخطيط واللون والتباعد والتفاعل.
+- **تطبيق أنظمة التصميم.** يمكنك حفظ تفضيلات نظام التصميم وإعادة استخدامها حتى يظل العمل الذي يتم إنشاؤه أقرب إلى علامتك التجارية.
+- **استيراد المراجع.** قم بإحضار HTML أو المواد المرجعية الحالية كسياق لبطاقة التصميم الجديدة.
+- **تصدير ملفات حقيقية.** تصدير HTML أو ZIP أو PDF من النموذج الأولي الذي تم إنشاؤه.
+
+## البدء
+
+عرض توضيحي مباشر: [design.agent-native.com](https://design.agent-native.com).
+
+1. **وصف العنصر.** اطلب الشاشة أو التدفق أو الصفحة المقصودة أو العناصر المرئية
+   الاتجاه الذي تريده. قم بتضمين الجمهور والنغمة وأي قيود على المنتج.
+2. **مقارنة الاتجاهات.** أنشئ بعض المتغيرات، واختر الأقوى منها، ثم
+   استمر في التحسين بدلاً من البدء من جديد.
+3. **اضبط التفاصيل.** استخدم أدوات التحكم القابلة للتعديل لإجراء تغييرات مرئية شائعة، أو اسأل
+   وكيل تغييرات التخطيط والنسخ والاستجابة والتفاعل.
+4. **قم بالتصدير عندما يكون ذلك مفيدًا.** قم بتنزيل HTML أو ZIP أو PDF بمجرد النموذج الأولي
+   جاهز لتسليمه إلى أداة أخرى أو إلى زميل في الفريق.
+
+### مطالبات مفيدة
+
+- "إنشاء ثلاثة اتجاهات للصفحة المقصودة لمنتج التحليلات الفنية."
+- "اجعل لوحة المعلومات هذه أكثر كثافة وأسهل في الفحص لفريق العمليات."
+- "تطبيق نظام التصميم المحفوظ لدينا وتبسيط تخطيط الهاتف المحمول."
+- "قم بتصدير هذا النموذج الأولي كـ ZIP بمجرد تحديد المتغير النهائي."
+- "تحويل HTML إلى صفحة تسعير أقوى دون تغيير ألوان العلامة التجارية."
+
+## للمطورين
+
+باقي هذا المستند مخصص لأي شخص يقوم بتعديل قالب التصميم أو توسيعه.
+
+### بداية سريعة
+
+```bash
+npx @agent-native/core@latest create my-design --standalone --template design
+cd my-design
+pnpm install
+pnpm dev
+```
+
+### نموذج البيانات
+
+تعيش جميع البيانات في SQL عبر Drizzle ORM. المخطط: `templates/design/server/db/schema.ts`. تحمل التصميمات وأنظمة التصميم معيار `ownableColumns` وجدول مشاركات إطار عمل مطابق، بحيث يتم إدراجها في نموذج المشاركة لكل مستخدم / لكل مؤسسة.
+
+| الجدول                                   | ما يحمله                                                                                                                                |
+| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `designs`                                | مشروع تصميم — `title`، و`description`، و`project_type` (`prototype` / `other`)، و`data` JSON، ورابط `design_system_id` الاختياري        |
+| `design_files`                           | الملفات الفردية التي تنتمي إلى التصميم (`filename`، `content`، `file_type` الافتراضية هي `html`)                                        |
+| `design_versions`                        | `snapshot` في الوقت المناسب لتصميم مع `label` اختياري، للتاريخ والتراجع                                                                 |
+| `design_systems`                         | رموز العلامة التجارية القابلة لإعادة الاستخدام - `data` (الألوان/الطباعة/التباعد)، `assets`، `custom_instructions`، وعلامة `is_default` |
+| `design_shares` / `design_system_shares` | يشارك إطار العمل الجداول التي تحدد المبادئ الأساسية (المستخدمين أو المؤسسات) للأدوار (العارض، المحرر، المسؤول)                          |
+
+```an-schema title="Design data model" summary="A design owns its files and versioned snapshots, and optionally links a reusable design system. Both designs and systems are ownable, each with a framework shares table."
+{
+  "entities": [
+    { "id": "designs", "name": "designs", "note": "A design project (ownable)", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "title", "type": "text" },
+      { "name": "description", "type": "text", "nullable": true },
+      { "name": "project_type", "type": "text", "note": "prototype / other" },
+      { "name": "data", "type": "json", "note": "starts as {}" },
+      { "name": "design_system_id", "type": "id", "fk": "design_systems.id", "nullable": true }
+    ] },
+    { "id": "files", "name": "design_files", "note": "Files in a design", "fields": [
+      { "name": "design_id", "type": "id", "fk": "designs.id" },
+      { "name": "filename", "type": "text" },
+      { "name": "content", "type": "text" },
+      { "name": "file_type", "type": "text", "note": "defaults to html" }
+    ] },
+    { "id": "versions", "name": "design_versions", "note": "History / rollback", "fields": [
+      { "name": "design_id", "type": "id", "fk": "designs.id" },
+      { "name": "snapshot", "type": "json" },
+      { "name": "label", "type": "text", "nullable": true }
+    ] },
+    { "id": "systems", "name": "design_systems", "note": "Reusable brand tokens (ownable)", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "data", "type": "json", "note": "colors / typography / spacing" },
+      { "name": "assets", "type": "json", "nullable": true },
+      { "name": "custom_instructions", "type": "text", "nullable": true },
+      { "name": "is_default", "type": "boolean" }
+    ] },
+    { "id": "design_shares", "name": "design_shares", "note": "Framework shares table", "fields": [
+      { "name": "design_id", "type": "id", "fk": "designs.id" },
+      { "name": "role", "type": "text", "note": "viewer / editor / admin" }
+    ] },
+    { "id": "system_shares", "name": "design_system_shares", "note": "Framework shares table", "fields": [
+      { "name": "design_system_id", "type": "id", "fk": "design_systems.id" },
+      { "name": "role", "type": "text", "note": "viewer / editor / admin" }
+    ] }
+  ],
+  "relations": [
+    { "from": "designs", "to": "files", "kind": "1-n" },
+    { "from": "designs", "to": "versions", "kind": "1-n" },
+    { "from": "systems", "to": "designs", "kind": "1-n", "label": "applied to" },
+    { "from": "designs", "to": "design_shares", "kind": "1-n" },
+    { "from": "systems", "to": "system_shares", "kind": "1-n" }
+  ]
+}
+```
+
+يظل مشروع التصميم عبارة عن غلاف حتى يحتوي على محتوى: يقوم `create-design` بإنشاء صف فارغ (`data: "{}"`)، ثم يكتب `generate-design` ملفات HTML/JSX المستقلة الفعلية. تأتي العناصر التي تم إنشاؤها والمصدر القابل للتحرير وكل عملية تصدير من نفس HTML، لذلك لا يوجد تنسيق منفصل "نموذج بالحجم الطبيعي" لترجمته. يوفر نظام التصميم المرتبط الرموز المميزة و`custom_instructions` التي يكرمها الوكيل في كل تذكرة جيل.
+
+توجد المسارات في UI ضمن `templates/design/app/routes/`: `_index.tsx` (قائمة)، `design.$id.tsx` (محرر)، `present.$id.tsx` (عرض تقديمي)، `design-systems.tsx` و`design-systems_.setup.tsx`، `templates.tsx`، `examples.tsx`، بالإضافة إلى `settings.tsx` و `team.tsx`.
+
+### مفتاح actions
+
+كل عملية قابلة للاستدعاء للوكيل هي ملف TypeScript في `templates/design/actions/`، مثبت تلقائيًا في `POST /_agent-native/actions/:name` وقابل للتشغيل من CLI كـ `pnpm action <name>`. المجموعات:
+
+- **التصميمات** — `create-design` (صدفة فارغة)، `generate-design` (كتابة محتوى HTML/JSX)، `update-design`، `get-design`، `list-designs`، `duplicate-design`، `delete-design`، و`apply-tweaks` لاستمرار مقبض القرص المباشر القيم (لون التمييز، والكثافة، وما إلى ذلك).
+- **الملفات** — `create-file`، `update-file`، `list-files`، `delete-file` للملفات الموجودة داخل مشروع التصميم.
+- **أنظمة التصميم** — `create-design-system`، و`update-design-system`، و`get-design-system`، و`list-design-systems`، و`delete-design-system`، و`set-default-design-system`، و`analyze-brand-assets` لجمع بيانات العلامة التجارية قبل التحليل.
+- **استيراد** — `import-code`، و`import-figma`، و`import-github`، و`import-from-url`، و`import-document` (DOCX/PPTX/PDF/XLSX)، و`import-design-project` لرفع نظام التصميم من مشروع حالي.
+- **التصدير والتسليم** — `export-html`، و`export-pdf`، و`export-svg`، و`export-zip`، و`export-coding-handoff` لتحويل التصميم إلى تسليم لأداة البرمجة.
+- **السياق والتنقل** — `view-screen` (التصميم الحالي، ملف مفتوح، عرض، سؤال معلق أو شبكة متغيرة)، `get-design-snapshot` (الحالة الحالية للوكيل الخارجي للمتابعة منها)، و`navigate`.
+
+### العمل مع الوكيل
+
+يعرف الوكيل دائمًا ما قمت بفتحه. يتم إرجاع التصميم الحالي والملف المفتوح والعرض النشط وأي سؤال معلق أو شبكة متغيرة بواسطة `view-screen` ويتم إدخالها في كل رسالة، بحيث يمكنك قول "اجعل هذا أكثر كثافة" أو "قم بتصدير هذا المتغير" بدون تسمية التصميم.
+
+نظرًا لأن التصميم هو مجرد ملفات HTML/JSX مستقلة، يقوم الوكيل بتحرير نفس المصدر الذي يعرضه iframe ويأتي منه كل تصدير - لا يوجد تنسيق "AI mockup" منفصل لترجمته. يوفر نظام التصميم المرتبط الرموز المميزة ويكرم الوكيل `custom_instructions` في كل تذكرة جيل. حدد نصًا أو منطقة في المعاينة واضغط على Cmd+I لتركيز الوكيل على هذا الجزء بالضبط.
+
+### تخصيصه
+
+التصميم عبارة عن قالب كامل وقابل للاستنساخ. بعض الأفكار الإضافية العملية:
+
+- "أضف نظام تصميم للتجارة الإلكترونية قابل لإعادة الاستخدام باستخدام الرموز المميزة وعينات المكونات."
+- "أضف خطوة تصدير لتحميل ZIP إلى نظام المراجعة الداخلية الخاص بنا."
+- "اسمح لي بلصق الصفحة المقصودة الحالية HTML وأطلب من الوكيل ثلاثة إصدارات أقوى."
+- "أضف مكتبة مطالبات محفوظة لصفحة المنتج ولوحة التحكم وملخصات شاشة الإعداد."
+- "أضف إعدادًا مسبقًا للتصدير PDF مخصص لمراجعة أصحاب المصلحة."
+
+يقوم الوكيل بتحرير المسارات والمكونات والنماذج المدعومة actions وSQL حسب الحاجة. راجع [Templates](/docs/cloneable-saas) للاطلاع على الاستنساخ الكامل والتخصيص والنشر و[Getting Started](/docs/getting-started) إذا كان هذا هو أول قالب أصلي للوكيل.
+
+## ما هي الخطوة التالية
+
+- [**Templates**](/docs/cloneable-saas) — نموذج الاستنساخ والتملك
+- [**Context Awareness**](/docs/context-awareness) — كيف يعرف الوكيل ما يشاهده المستخدم
+- [**Creating Templates**](/docs/creating-templates) — أنماط البناء الحالية لقوالب الوكيل الأصلية