docs: self-healing harness design and evidence (en + ar)

ar/improve.mdx

@@ -9,6 +9,8 @@ description: "تبحث improveAgent عن harness أفضل دون اتصال، و
 ولا تستطيع تغيير الأدوات أو الصلاحيات أو الحدود.
 
 هي تجريبية: نتائجها حتى الآن تأتي من benchmark صغير.
+ولمعرفة تصميم حلقة التعافي الذاتي والأدلة المتوفرة حتى الآن، راجع
+[الـ harness ذاتي التعافي: التصميم والأدلة](/ar/self-healing-paper).
 
 لمعرفة كيف يتكامل هذا مع استعادة الـ runs الفاشلة بينما يخدم الـ agent الـ traffic، راجع [التعافي الذاتي والتحسين الذاتي](/ar/self-healing).
 

ar/self-healing.mdx

@@ -166,3 +166,24 @@ if (result.outcome === 'proposal') console.log(formatImproveResult(result));
 أصلِح الأداة، أو غيّر التعليمات. وإذا كان السبب في التعليمات أو
 المهارات، فيمكن أن تصبح حالات الفشل تلك حالات لـ `improveAgent()`، ويقرّر شخص
 ما إذا كان سيطبّق ما تقترحه.
+
+## الأدلة الحيّة (S29 وS30)
+
+في إصدارات الـ SDK الحالية، تطبّق حلقة التعافي الذاتي (`lousho improve` على
+مجلد agent) التعديلَ الذي يجتاز فحوصها تلقائيًا بشكل افتراضي (الوضع التلقائي)،
+أما الوضع اليدوي فيضعه في قائمة انتظار ليقرّر فيه شخص.
+
+في 2026-11-09 اختُبرت هذه الحلقة في تشغيل حيّ على حالات برمجية اصطناعية.
+عمل الـ agent على `qwen/qwen3.7-flash`، وعمل نموذج تحرير منفصل،
+`stealth/crouton-alpha`، على الحالات الاصطناعية فقط. شُغِّل كل سيناريو مرة
+واحدة، وشُغِّل `planted-editor` ثلاث مرات.
+
+- نجح كل سيناريو اختبر شيئًا فعلًا. نجح `planted-editor` في محاولتين من
+  محاولتين، ولم تصل محاولة ثالثة إلى المحرّرين، فلم تُحتسَب.
+- تحقّق سجل التدقيق في كل مجلد محاولة.
+- حكم التقرير هو **INCOMPLETE** (غير مكتمل)، لأن معايير القرار تتطلب من 5 إلى 10
+  محاولات لكل سيناريو.
+
+أبقت القراءة النهائية (S30) الوضع التلقائي افتراضيًا، وأبقت الحلقة تجريبية.
+راجع [الـ harness ذاتي التعافي: التصميم والأدلة](/ar/self-healing-paper)
+للاطلاع على التصميم وكل النتائج وحدودها.

ar/translations.json

@@ -36,7 +36,7 @@
   "hooks": "d54027280b46",
   "hosted-tools": "14eb5f7c8eb9",
   "hostinger-vps": "bfa034b8c3be",
-  "improve": "e53d9e0dd7e9",
+  "improve": "fe7ce62c0c90",
   "installation": "6f6ebfa0d752",
   "introduction": "6d1dd271727f",
   "mcp-integration": "bdf06a9a7df2",
@@ -59,7 +59,8 @@
   "registry": "d9458f2bb6dc",
   "runs": "b83155cb8b2e",
   "schedules": "d8fe79433275",
-  "self-healing": "7de7ffd02b22",
+  "self-healing": "601ae37e8e12",
+  "self-healing-paper": "7b6ae560d20c",
   "sessions": "38f5c7892813",
   "skills": "592829bf0e26",
   "stream-events": "10000c736a5d",

docs.json

@@ -158,7 +158,8 @@
                 "group": "Self-healing and improvement",
                 "pages": [
                   "self-healing",
-                  "improve"
+                  "improve",
+                  "self-healing-paper"
                 ]
               },
               {
@@ -319,7 +320,8 @@
                 "group": "التعافي الذاتي والتحسين",
                 "pages": [
                   "ar/self-healing",
-                  "ar/improve"
+                  "ar/improve",
+                  "ar/self-healing-paper"
                 ]
               },
               {

improve.mdx

@@ -9,6 +9,8 @@ using failing cases you give it. It only returns a proposal. Nothing is applied,
 and it can't change tools, permissions or limits.
 
 It's experimental: its results so far come from a small benchmark.
+For the design of the self-healing loop and the evidence so far, see
+[Self-healing harness: design and evidence](/self-healing-paper).
 
 For how this fits with recovering failed runs while the agent serves traffic, see [Self-healing and self-improvement](/self-healing).
 

scripts/sync-sdk-docs.mjs

@@ -134,7 +134,7 @@ const SIDEBAR_TITLES = {
 };
 
 /** Pages written by hand in this repository. Listed so the report can flag SDK docs with no page. */
-const HAND_WRITTEN = ['introduction', 'coding-agents', 'examples'];
+const HAND_WRITTEN = ['introduction', 'coding-agents', 'examples', 'self-healing-paper'];
 
 /** SDK docs that are deliberately not on the site. */
 const SKIPPED = new Set([]);