@agent-native/core 0.79.26 → 0.80.0

package/corpus/core/docs/content/locales/ar-SA/observational-memory.mdx

@@ -19,13 +19,53 @@ description: "ضغط الخلفية ثلاثي الطبقات (الخام الأ
 | **الملاحظات**               | إدخالات كثيفة ومؤرخة تدمج مجموعة من الرسائل الأولية في سجل مضغوط لما حدث.                              |
 | **الرسائل الأولية الأخيرة** | يتم الاحتفاظ بآخر المنعطفات N **حرفيًا** — ولا يتم طيها مطلقًا — بحيث يرى الوكيل دائمًا السياق الأحدث. |
 
-```an-diagram title="ثلاث طبقات، مقطرة إلى الأخيرة" summary="تُطوى البادئة الأقدم إلى ملاحظات مؤرخة وانعكاس قوس طويل؛ فقط أحدث المنعطفات تبقى حرفية."
-{
-  "html": "<div class=\"om\"><div class=\"diagram-card\"><span class=\"diagram-pill\">تأملات</span><small class=\"diagram-muted\">ملخص طويل المدى مكثف من سجل الملاحظات</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&uarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">ملاحظات</span><small class=\"diagram-muted\">إدخالات مؤرخة ومكثفة تطوي مقاطع من الرسائل الخام</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&uarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">الرسائل الخام الأخيرة</span><small class=\"diagram-muted\">last N turns, kept <strong>verbatim</strong> — لا تُطوى أبدًا</small></div></div>",
-  "css": ".om{display:flex;flex-direction:column-reverse;align-items:stretch;gap:8px}.om .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px}.om .diagram-arrow{text-align:center;font-size:20px;line-height:1}"
+<Diagram id="doc-block-17ct5do" title={"ثلاث طبقات، مقطرة إلى الأخيرة"} summary={"تُطوى البادئة الأقدم إلى ملاحظات مؤرخة وانعكاس قوس طويل؛ فقط أحدث المنعطفات تبقى حرفية."}>
+
+```html
+<div class="om">
+  <div class="diagram-card">
+    <span class="diagram-pill">تأملات</span
+    ><small class="diagram-muted">ملخص طويل المدى مكثف من سجل الملاحظات</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&uarr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill accent">ملاحظات</span
+    ><small class="diagram-muted"
+      >إدخالات مؤرخة ومكثفة تطوي مقاطع من الرسائل الخام</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&uarr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill ok">الرسائل الخام الأخيرة</span
+    ><small class="diagram-muted"
+      >last N turns, kept <strong>verbatim</strong> — لا تُطوى أبدًا</small
+    >
+  </div>
+</div>
+```
+
+```css
+.om {
+  display: flex;
+  flex-direction: column-reverse;
+  align-items: stretch;
+  gap: 8px;
+}
+.om .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 12px 16px;
+}
+.om .diagram-arrow {
+  text-align: center;
+  font-size: 20px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 في كل دورة، يقوم جانب القراءة بتجميع هذه العناصر في كتلة `[Observational Memory]` واحدة ذاتية التسمية والتي تحل محل البادئة القديمة الأولية، وتحافظ على نافذة الخام الحديثة سليمة، وتطلب من النموذج التعامل مع السجل المضغوط باعتباره موثوقًا (لا تقم بإعادة العمل المكتمل، وثق في القرارات والأسماء والتواريخ والحالة المسجلة).
 
 ## كيفية عمل الضغط {#compaction}
@@ -35,13 +75,52 @@ description: "ضغط الخلفية ثلاثي الطبقات (الخام الأ
 1. **المراقب** — بمجرد أن تتجاوز رسائل سلسلة المحادثات _unobserved_ عتبة رمز الملاحظة، يتم دمجها في إدخال مراقبة كثيف واحد.
 2. **العاكس** — بمجرد أن يتجاوز سجل المراقبة المستمرة حد رمز الانعكاس، يتم تكثيف الملاحظات في انعكاس عالي المستوى.
 
-```an-diagram title="تمريرتان من أفضل المحاولات بعد منعطف نظيف" summary="كل تمريرة محظورة أقل من عتبتها، لذا فإن تشغيل الضاغط في كل دورة يعد رخيصًا. يتم ابتلاع الفشل ولا يضيف الكمون أبدًا."
-{
-  "html": "<div class=\"om-pass\"><div class=\"diagram-node\">ينتهي الدور النظيف<br><small class=\"diagram-muted\">fire-and-forget</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Observer</span><small class=\"diagram-muted\">unobserved tokens &gt; 30k? &rarr; fold into one observation</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">Reflector</span><small class=\"diagram-muted\">observation log &gt; 40k? &rarr; condense into a reflection</small></div></div>",
-  "css": ".om-pass{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.om-pass .diagram-node,.om-pass .diagram-card{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.om-pass .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-wbj94q" title={"تمريرتان من أفضل المحاولات بعد منعطف نظيف"} summary={"كل تمريرة محظورة أقل من عتبتها، لذا فإن تشغيل الضاغط في كل دورة يعد رخيصًا. يتم ابتلاع الفشل ولا يضيف الكمون أبدًا."}>
+
+```html
+<div class="om-pass">
+  <div class="diagram-node">
+    ينتهي الدور النظيف<br /><small class="diagram-muted">fire-and-forget</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill accent">Observer</span
+    ><small class="diagram-muted"
+      >unobserved tokens &gt; 30k? &rarr; fold into one observation</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill accent">Reflector</span
+    ><small class="diagram-muted"
+      >observation log &gt; 40k? &rarr; condense into a reflection</small
+    >
+  </div>
+</div>
+```
+
+```css
+.om-pass {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.om-pass .diagram-node,
+.om-pass .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+  padding: 10px 14px;
+}
+.om-pass .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 كلاهما يمر بفترة عدم تنفيذ أقل من الحدود الخاصة بهما، لذا فإن استدعاء الضاغط بعد كل دورة يعد أمرًا رخيصًا. نظرًا لأن OM يستبدل البادئة الأولية المتطايرة بنص مضغوط ثابت، فإنه يحافظ أيضًا على المطالبة **ثابتة في ذاكرة التخزين المؤقت** عبر دورات سلسلة طويلة.
 
 تعيش بيانات OM في قاعدة بيانات SQL الخاصة بالتطبيق، والتي يتم تحديد نطاقها للمالك (والمؤسسة عند وجودها) - وهو نفس نموذج تحديد النطاق مثل بقية إطار العمل. ولا تتم مشاركته مطلقًا بين المستخدمين.

package/corpus/core/docs/content/locales/ar-SA/onboarding.mdx

@@ -10,13 +10,54 @@ description: "قائمة التحقق من الإعداد للتهيئة الت
 إلى دردشة الوكيل: قم بتوصيل محرك الذكاء الاصطناعي، واختياريًا قم بتوجيه التطبيق إلى مشترك
 البنية الأساسية، وأضف مقدمي الخدمة فقط عندما تحتاج إليهم.
 
-```an-diagram title="قائمة التحقق من الإعداد" summary="مطلوب فقط توصيل محرك AI. تقوم اللوحة بتتبع الإكمال والإخفاء التلقائي بمجرد الانتهاء من كل ما هو مطلوب."
-{
-  "html": "<div class=\"ob\"><div class=\"diagram-card\"><span class=\"diagram-pill warn\">required</span><strong>وصل محرك AI</strong><small class=\"diagram-muted\">Connect Builder (one click) or paste an LLM key</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">optional</span><strong>Database</strong><small class=\"diagram-muted\">set <code>DATABASE_URL</code></small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">optional</span><strong>Authentication</strong><small class=\"diagram-muted\">OAuth / access token</small></div><div class=\"diagram-card\"><span class=\"diagram-pill\">optional</span><strong>تسليم البريد الإلكتروني</strong><small class=\"diagram-muted\">Resend / SendGrid</small></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">all required done &rarr; panel auto-hides</div></div>",
-  "css": ".ob{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.ob .diagram-card{display:flex;flex-direction:column;gap:3px;padding:12px 14px}.ob .diagram-arrow{font-size:22px}"
+<Diagram id="doc-block-f2r0l0" title={"قائمة التحقق من الإعداد"} summary={"مطلوب فقط توصيل محرك AI. تقوم اللوحة بتتبع الإكمال والإخفاء التلقائي بمجرد الانتهاء من كل ما هو مطلوب."}>
+
+```html
+<div class="ob">
+  <div class="diagram-card">
+    <span class="diagram-pill warn">required</span><strong>وصل محرك AI</strong
+    ><small class="diagram-muted"
+      >Connect Builder (one click) or paste an LLM key</small
+    >
+  </div>
+  <div class="diagram-card">
+    <span class="diagram-pill">optional</span><strong>Database</strong
+    ><small class="diagram-muted">set <code>DATABASE_URL</code></small>
+  </div>
+  <div class="diagram-card">
+    <span class="diagram-pill">optional</span><strong>Authentication</strong
+    ><small class="diagram-muted">OAuth / access token</small>
+  </div>
+  <div class="diagram-card">
+    <span class="diagram-pill">optional</span
+    ><strong>تسليم البريد الإلكتروني</strong
+    ><small class="diagram-muted">Resend / SendGrid</small>
+  </div>
+  <div class="diagram-arrow diagram-accent" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box ok">all required done &rarr; panel auto-hides</div>
+</div>
+```
+
+```css
+.ob {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.ob .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 3px;
+  padding: 12px 14px;
+}
+.ob .diagram-arrow {
+  font-size: 22px;
 }
 ```
 
+</Diagram>
+
 ## للمستخدمين النهائيين
 
 ### ما ستراه

package/corpus/core/docs/content/locales/ar-SA/plan-plugin.mdx

@@ -14,13 +14,70 @@ description: "قم بتثبيت خطة Agent-Native skills (/visual-plan، /visu
 - **اثنان skills** — `/visual-plan` (نقطة الدخول الأساسية) و`/visual-recap`.
 - **موصل Plan MCP** — مسجل في التطبيق المستضاف على `https://plan.agent-native.com` (نقطة نهاية MCP `https://plan.agent-native.com/_agent-native/mcp`، اسم الخادم `plan`).
 
-```an-diagram title="ثلاث طرق، حزمة واحدة" summary="يقوم كل من المكون الإضافي CLI، وClaude Code، والمكون الإضافي Codex بتثبيت نفس المهارتين بالإضافة إلى موصل الخطة المستضاف."
-{
-  "html": "<div class=\"diagram-routes\"><div class=\"diagram-col\"><div class=\"diagram-node\">Universal CLI<br><small class=\"diagram-muted\">skills add visual-plan</small></div><div class=\"diagram-node\">إضافة Claude Code<br><small class=\"diagram-muted\">/plugin install</small></div><div class=\"diagram-node\">إضافة Codex<br><small class=\"diagram-muted\">codex plugin add</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">/visual-plan</span><span class=\"diagram-pill accent\">/visual-recap</span><small class=\"diagram-muted\">two skills</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">Plan MCP connector<br><small class=\"diagram-muted\">plan.agent-native.com/_agent-native/mcp</small></div></div>",
-  "css": ".diagram-routes{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-routes .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-routes .diagram-arrow{font-size:22px;line-height:1}.diagram-routes .center{display:flex;flex-direction:column;align-items:center;gap:4px;text-align:center}.diagram-routes .center .diagram-pill{margin:2px}"
+<Diagram id="doc-block-10bw7bb" title={"ثلاث طرق، حزمة واحدة"} summary={"يقوم كل من المكون الإضافي CLI، وClaude Code، والمكون الإضافي Codex بتثبيت نفس المهارتين بالإضافة إلى موصل الخطة المستضاف."}>
+
+```html
+<div class="diagram-routes">
+  <div class="diagram-col">
+    <div class="diagram-node">
+      Universal CLI<br /><small class="diagram-muted"
+        >skills add visual-plan</small
+      >
+    </div>
+    <div class="diagram-node">
+      إضافة Claude Code<br /><small class="diagram-muted"
+        >/plugin install</small
+      >
+    </div>
+    <div class="diagram-node">
+      إضافة Codex<br /><small class="diagram-muted">codex plugin add</small>
+    </div>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel center">
+    <span class="diagram-pill accent">/visual-plan</span
+    ><span class="diagram-pill accent">/visual-recap</span
+    ><small class="diagram-muted">two skills</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box">
+    Plan MCP connector<br /><small class="diagram-muted"
+      >plan.agent-native.com/_agent-native/mcp</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-routes {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.diagram-routes .diagram-col {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+.diagram-routes .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-routes .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
+  text-align: center;
+}
+.diagram-routes .center .diagram-pill {
+  margin: 2px;
 }
 ```
 
+</Diagram>
+
 افتراضيًا، يقوم كل من skills بالنشر على تطبيق الخطة المستضاف - حيث يقومان بإنشاء خطة عبر
 موصل MCP ويسلمك رابطًا أو خطة مضمنة للمراجعة. إنهم لا يتخلصون أبدًا
 خطة Markdown/ASCII المضمنة في الدردشة باعتبارها التسليم. إذا كانت أداة الخطة
@@ -82,13 +139,47 @@ npx @agent-native/core@latest plan local serve --dir plans/<slug> --kind plan --
 لن تكون التعليقات ولقطات الشاشة وسجل الخطة متاحة إلا إذا قمت بذلك صراحةً
 النشر لاحقًا.
 
-```an-diagram title="وضع الملفات المستضافة مقابل وضع الملفات المحلية" summary="بشكل افتراضي، يتم نشر المهارات من خلال الموصل؛ يقوم وضع الملفات المحلية بكتابة MDX على القرص ومعاينته عبر جسر مضيف محلي بدلاً من ذلك."
-{
-  "html": "<div class=\"diagram-modes\"><div class=\"diagram-card\"><span class=\"diagram-pill accent\">افتراضي · مستضاف</span><strong>النشر إلى تطبيق Plan</strong><small class=\"diagram-muted\">MCP connector &rarr; hosted DB &rarr; share links, comments, history, screenshots</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">خصوصية الملفات المحلية</span><strong>اكتب MDX إلى القرص</strong><small class=\"diagram-muted\">plan.mdx + canvas.mdx + prototype.mdx &rarr; localhost bridge &rarr; hosted Plan UI reads local source. No كتابة في قاعدة البياناتs until <code>publish-visual-plan</code>.</small></div></div>",
-  "css": ".diagram-modes{display:flex;gap:14px;flex-wrap:wrap}.diagram-modes .diagram-card{flex:1 1 260px;display:flex;flex-direction:column;gap:6px;padding:16px 18px}"
+<Diagram id="doc-block-1t4cmtn" title={"وضع الملفات المستضافة مقابل وضع الملفات المحلية"} summary={"بشكل افتراضي، يتم نشر المهارات من خلال الموصل؛ يقوم وضع الملفات المحلية بكتابة MDX على القرص ومعاينته عبر جسر مضيف محلي بدلاً من ذلك."}>
+
+```html
+<div class="diagram-modes">
+  <div class="diagram-card">
+    <span class="diagram-pill accent">افتراضي · مستضاف</span
+    ><strong>النشر إلى تطبيق Plan</strong
+    ><small class="diagram-muted"
+      >MCP connector &rarr; hosted DB &rarr; share links, comments, history,
+      screenshots</small
+    >
+  </div>
+  <div class="diagram-card">
+    <span class="diagram-pill warn">خصوصية الملفات المحلية</span
+    ><strong>اكتب MDX إلى القرص</strong
+    ><small class="diagram-muted"
+      >plan.mdx + canvas.mdx + prototype.mdx &rarr; localhost bridge &rarr;
+      hosted Plan UI reads local source. No كتابة في قاعدة البياناتs until
+      <code>publish-visual-plan</code>.</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-modes {
+  display: flex;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-modes .diagram-card {
+  flex: 1 1 260px;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 16px 18px;
 }
 ```
 
+</Diagram>
+
 يحتوي Agent Native Desktop على مسار مزامنة ملف محلي منفصل للخطط المستضافة:
 يمكن لتطبيق سطح المكتب عكس خطة مستضافة لملفات MDX المحلية واستيراد التعديلات مرة أخرى
 بدون استنساخ تطبيق الخطة أو تشغيل CLI. يحافظ سير العمل هذا على الاستضافة

package/corpus/core/docs/content/locales/ar-SA/pr-visual-recap.mdx

@@ -24,13 +24,72 @@ PR Visual Recap هو إجراء GitHub يحول كل طلب سحب إلى **مر
 7. يرفع تعليق علاقات عامة ثابتًا واحدًا يتضمن لقطات الشاشة **مضمنة** مع عنصر `<picture>` (يتم تقديمه من خلال وكيل صورة التمويه الخاص بـ GitHub) بجوار رابط الملخص التفاعلي.
 8. يكمل فحص `Visual Recap` بنجاح، أو تم تخطيه، أو محايد.
 
-```an-diagram title="ماذا يحدث في كل دفعة للعلاقات العامة" summary="يغذي الفرق المحدود وكيل ترميز حقيقي، والذي يقوم بتأليف ملخص؛ يقوم سير العمل بالتقاط لقطات شاشة له وإدراج تعليق واحد ثابت."
-{
-  "html": "<div class=\"diagram-recap\"><div class=\"diagram-node\">دفع PR<br><small class=\"diagram-muted\">bounded base&hellip;head diff</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">وكيل البرمجة<br><small class=\"diagram-muted\">Claude Code / Codex يقرأ diff</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">create-visual-recap</span><small class=\"diagram-muted\">publishes recap plan</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\">Chrome بلا واجهة<br><small class=\"diagram-muted\">light + dark screenshots</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">تعليق PR ثابت واحد<br><small class=\"diagram-muted\">inline screenshot + plan link</small></div></div><div class=\"diagram-foot diagram-muted\">Plus an informational <span class=\"diagram-pill\">Visual Recap</span> check &mdash; non-blocking, never required.</div>",
-  "css": ".diagram-recap{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-recap .diagram-arrow{font-size:20px;line-height:1}.diagram-recap .center{display:flex;flex-direction:column;align-items:center;gap:4px;text-align:center}.diagram-recap .diagram-foot{flex-basis:100%;margin-top:10px;font-size:13px}"
+<Diagram id="doc-block-1cylk7g" title={"ماذا يحدث في كل دفعة للعلاقات العامة"} summary={"يغذي الفرق المحدود وكيل ترميز حقيقي، والذي يقوم بتأليف ملخص؛ يقوم سير العمل بالتقاط لقطات شاشة له وإدراج تعليق واحد ثابت."}>
+
+```html
+<div class="diagram-recap">
+  <div class="diagram-node">
+    دفع PR<br /><small class="diagram-muted"
+      >bounded base&hellip;head diff</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node">
+    وكيل البرمجة<br /><small class="diagram-muted"
+      >Claude Code / Codex يقرأ diff</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel center">
+    <span class="diagram-pill accent">create-visual-recap</span
+    ><small class="diagram-muted">publishes recap plan</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node">
+    Chrome بلا واجهة<br /><small class="diagram-muted"
+      >light + dark screenshots</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box">
+    تعليق PR ثابت واحد<br /><small class="diagram-muted"
+      >inline screenshot + plan link</small
+    >
+  </div>
+</div>
+<div class="diagram-foot diagram-muted">
+  Plus an informational <span class="diagram-pill">Visual Recap</span> check
+  &mdash; non-blocking, never required.
+</div>
+```
+
+```css
+.diagram-recap {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.diagram-recap .diagram-arrow {
+  font-size: 20px;
+  line-height: 1;
+}
+.diagram-recap .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
+  text-align: center;
+}
+.diagram-recap .diagram-foot {
+  flex-basis: 100%;
+  margin-top: 10px;
+  font-size: 13px;
 }
 ```
 
+</Diagram>
+
 تعمل إعادة الدفع على تحديث نفس الخطة ونفس التعليق الثابت الموجود - لا توجد خطط معزولة، ولا توجد تعليقات غير مرغوب فيها.
 
 ## تثبيته
@@ -157,13 +216,71 @@ npx @agent-native/core@latest recap setup
 
 لتثبيته، انسخ الملف من [BuilderIO/agent-native](https://github.com/BuilderIO/agent-native/blob/main/.github/workflows/pr-visual-recap-fork.yml) إلى دليل `.github/workflows/` الخاص بالمستودع الخاص بك إلى جانب `pr-visual-recap.yml` الموجود. تنطبق نفس الأسرار (`PLAN_RECAP_TOKEN`، `ANTHROPIC_API_KEY`).
 
-```an-diagram title="بوابة موافقة Fork PR" summary="لا يحصل ممثلو العلاقات العامة في Fork على أي أسرار بشكل افتراضي؛ يعمل المؤلفون الموثوق بهم تلقائيًا، ويتطلب المساهمون الخارجيون ملصقًا جديدًا لملخص المشرف."
-{
-  "html": "<div class=\"diagram-fork\"><div class=\"diagram-node\">تم فتح PR من fork<br><small class=\"diagram-muted\">main workflow has no secrets</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">مؤلف موثوق</span><small class=\"diagram-muted\">OWNER أو MEMBER أو COLLABORATOR يعمل تلقائيًا</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">مساهم خارجي</span><small class=\"diagram-muted\">يراجع المشرف diff ثم يطبقه <code>recap</code></small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\">فحوصات البوابة<br><small class=\"diagram-muted\">fork PR? &amp; trusted or fresh label?</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box ok\">تشغيلات الملخص<br><small class=\"diagram-muted\">كود base-repo فقط · diff من fork هو إدخال نصي</small></div></div>",
-  "css": ".diagram-fork{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-fork .diagram-arrow{font-size:20px;line-height:1}.diagram-fork .center{display:flex;flex-direction:column;align-items:center;gap:4px;text-align:center}.diagram-fork .diagram-card{display:flex;flex-direction:column;gap:6px;padding:12px 14px}"
+<Diagram id="doc-block-1ez4ofk" title={"بوابة موافقة Fork PR"} summary={"لا يحصل ممثلو العلاقات العامة في Fork على أي أسرار بشكل افتراضي؛ يعمل المؤلفون الموثوق بهم تلقائيًا، ويتطلب المساهمون الخارجيون ملصقًا جديدًا لملخص المشرف."}>
+
+```html
+<div class="diagram-fork">
+  <div class="diagram-node">
+    تم فتح PR من fork<br /><small class="diagram-muted"
+      >main workflow has no secrets</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-card">
+    <span class="diagram-pill ok">مؤلف موثوق</span
+    ><small class="diagram-muted"
+      >OWNER أو MEMBER أو COLLABORATOR يعمل تلقائيًا</small
+    >
+  </div>
+  <div class="diagram-card">
+    <span class="diagram-pill warn">مساهم خارجي</span
+    ><small class="diagram-muted"
+      >يراجع المشرف diff ثم يطبقه <code>recap</code></small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel center">
+    فحوصات البوابة<br /><small class="diagram-muted"
+      >fork PR? &amp; trusted or fresh label?</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-box ok">
+    تشغيلات الملخص<br /><small class="diagram-muted"
+      >كود base-repo فقط · diff من fork هو إدخال نصي</small
+    >
+  </div>
+</div>
+```
+
+```css
+.diagram-fork {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  flex-wrap: wrap;
+}
+.diagram-fork .diagram-arrow {
+  font-size: 20px;
+  line-height: 1;
+}
+.diagram-fork .center {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
+  text-align: center;
+}
+.diagram-fork .diagram-card {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 12px 14px;
 }
 ```
 
+</Diagram>
+
 ### كيفية عمل بوابة التصنيف
 
 1. يفتح المساهم في الشوكة PR. يتم تخطي سير عمل `pull_request` العادي لأن GitHub يحجب الأسرار عن عمليات الشوكة.

package/corpus/core/docs/content/locales/ar-SA/processors.mdx

@@ -7,13 +7,50 @@ description: "حلقة المراقبة الداخلية/خطافات الدرا
 
 `Processor` عبارة عن حلقة داخلية **مراقب/حاجز حماية** لتشغيل الوكيل. فهو يراقب إخراج النموذج المتدفق وتستدعيه الأداة طلبات _مع تقدم التشغيل_، ويحتفظ بحالة التسويد الخاصة به، ويمكنه **إجهاض** التشغيل قبل المطالبة بـ "تم". هذا هو الشرط الهيكلي الأساسي لحواجز الحماية في الوقت الفعلي (حظر الإخراج غير المسموح به في منتصف الدفق) وبوابة إثبات التنفيذ/التغطية (فحص ما على وشك القيام به النموذج وإيقافه).
 
-```an-diagram title="حيث تطلق الخطافات الثلاثة أثناء الركض" summary="يراقب processOutputStream كل قطعة، وتستدعي أداة البوابات processOutputStep كل استجابة، ويسجل processOutputResult حكمًا في النهاية. يمكن إحباط أي خطاف باستخدام TripWire."
-{
-  "html": "<div class=\"diagram-proc\"><div class=\"diagram-node\" data-rough>stream chunks<br><small class=\"diagram-muted\">processOutputStream</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>per model response<br><small class=\"diagram-muted\">processOutputStep — يضبط استدعاءات الأدوات</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-node\" data-rough>run end<br><small class=\"diagram-muted\">processOutputResult — الحكم</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-pill warn\">abort() &rarr; TripWire &rarr; tripwire event</div></div>",
-  "css": ".diagram-proc{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-proc .diagram-arrow{font-size:22px;line-height:1}.diagram-proc .diagram-pill{flex-basis:100%}"
+<Diagram id="doc-block-18d4lyv" title={"حيث تطلق الخطافات الثلاثة أثناء الركض"} summary={"يراقب processOutputStream كل قطعة، وتستدعي أداة البوابات processOutputStep كل استجابة، ويسجل processOutputResult حكمًا في النهاية. يمكن إحباط أي خطاف باستخدام TripWire."}>
+
+```html
+<div class="diagram-proc">
+  <div class="diagram-node" data-rough>
+    stream chunks<br /><small class="diagram-muted">processOutputStream</small>
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node" data-rough>
+    per model response<br /><small class="diagram-muted"
+      >processOutputStep — يضبط استدعاءات الأدوات</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-node" data-rough>
+    run end<br /><small class="diagram-muted"
+      >processOutputResult — الحكم</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
+  <div class="diagram-pill warn">
+    abort() &rarr; TripWire &rarr; tripwire event
+  </div>
+</div>
+```
+
+```css
+.diagram-proc {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.diagram-proc .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
+}
+.diagram-proc .diagram-pill {
+  flex-basis: 100%;
 }
 ```
 
+</Diagram>
+
 > [!WARNING]
 > المعالج هو **تكوين**، وليس أداة، وليس إجراءً، وليس تأليفًا DSL. تقوم المعالجات فقط بمراقبة وتعديل حالة نطاق الدفق الخاصة بها و`abort()`. ولا تحدد أبدًا سلوك التطبيق، أو تستبدل actions, أو تظهر للنموذج. تنتمي عمليات التطبيق إلى [actions](/docs/actions).
 

package/corpus/core/docs/content/locales/ar-SA/progress.mdx

@@ -41,13 +41,55 @@ await completeRun(run.id, run.owner, "succeeded");
 | `failed`    | خطأ في المحطة                      |
 | `cancelled` | تمت مقاطعة المستخدم                |
 
-```an-diagram title="تشغيل دورة الحياة" summary="startRun يفتح صفًا قيد التشغيل؛ updateRunProgress يصححه؛ completeRun ينقله إلى حالة طرفية واحدة ويختم completed_at."
-{
-  "html": "<div class=\"diagram-run\"><div class=\"diagram-box\" data-rough>startRun()</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel running\" data-rough><span class=\"diagram-pill accent\">running</span><small class=\"diagram-muted\">updateRunProgress() &#8635; percent + step</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col terminal\"><span class=\"diagram-pill ok\">succeeded</span><span class=\"diagram-pill warn\">failed</span><span class=\"diagram-pill\">cancelled</span><small class=\"diagram-muted\">completeRun() &rarr; sets completed_at</small></div></div>",
-  "css": ".diagram-run{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-run .diagram-panel{display:flex;flex-direction:column;gap:6px;padding:12px 16px}.diagram-run .terminal{display:flex;flex-direction:column;gap:6px;align-items:flex-start}.diagram-run .diagram-arrow{font-size:22px;line-height:1}"
+<Diagram id="doc-block-e8kdpo" title={"تشغيل دورة الحياة"} summary={"startRun يفتح صفًا قيد التشغيل؛ updateRunProgress يصححه؛ completeRun ينقله إلى حالة طرفية واحدة ويختم completed_at."}>
+
+```html
+<div class="diagram-run">
+  <div class="diagram-box" data-rough>startRun()</div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-panel running" data-rough>
+    <span class="diagram-pill accent">running</span
+    ><small class="diagram-muted"
+      >updateRunProgress() &#8635; percent + step</small
+    >
+  </div>
+  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
+  <div class="diagram-col terminal">
+    <span class="diagram-pill ok">succeeded</span
+    ><span class="diagram-pill warn">failed</span
+    ><span class="diagram-pill">cancelled</span
+    ><small class="diagram-muted">completeRun() &rarr; sets completed_at</small>
+  </div>
+</div>
+```
+
+```css
+.diagram-run {
+  display: flex;
+  align-items: center;
+  gap: 14px;
+  flex-wrap: wrap;
+}
+.diagram-run .diagram-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  padding: 12px 16px;
+}
+.diagram-run .terminal {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  align-items: flex-start;
+}
+.diagram-run .diagram-arrow {
+  font-size: 22px;
+  line-height: 1;
 }
 ```
 
+</Diagram>
+
 تم ضبط الحالات الطرفية على `completed_at`. يعرض درج UI صفوف `running` فقط؛ تبقى الصفوف المكتملة في قاعدة البيانات لاستعلامات `action=list`.
 
 ## API {#api}