docs: verify live agent project registration flow

This commit is contained in:
Hamza Ayed
2026-10-04 15:46:28 +03:00
parent dc9b1183d9
commit 435259e6c4
+2
View File
@@ -213,6 +213,8 @@
- [x] توضيح إضافة المشروع في واجهة Windows/الويب (2026-10-04): على المساحات الواسعة يظهر زر نصّي «إضافة مجلد مشروع»، وفي القائمة الجانبية صار الإجراء «إضافة مجلد مشروع موجود» لتوضيح أنه يسجل مجلدًا موجودًا ولا ينشئ مشروعًا من الصفر. بقي الزر ظاهرًا عند إخفاء القائمة الجانبية؛ اجتازت اختبارات Flutter السبعة وتحليل Flutter بلا ملاحظات، وبُني Windows Debug من نسخة `%LOCALAPPDATA%` بنجاح خلال 71.3 ثانية. هذا تحسين للواجهة فقط: الوكيل ما زال يقرأ ويبحث ويقترح تعديلًا بموافقة المستخدم، ولا يشغّل أوامر المشروع أو اختباراته حتى يكتمل العزل المطلوب.
- [x] إصلاح بدء نافذة Windows Debug (2026-10-04): كان `main()` ينتظر تهيئة الإشعارات قبل `runApp()`، فيمكن أن تبقى نافذة Flutter مخفية إذا تعثر plugin الإشعارات. صار `runApp()` يسبق التهيئة وتعمل الإشعارات بالخلفية مع تسجيل الخطأ. بعد بناء 74.5 ثانية بدأت العملية PID 11484 بنافذة Windows فعلية بعنوان `Mithqal AI` ومقبض نافذة غير صفري، وكانت مستجيبة؛ أعاد `/health` على 8000 و8100 HTTP 200 مع Gemma4 E2B وSQLite والوكيل. اجتازت اختبارات Flutter السبعة وتحليل Flutter. التهيئة الفاشلة قد تعطل الإشعارات وحدها ولا توقف الواجهة.
- [x] اختبار قراءة مشروع فعلي عبر الوكيل (2026-10-04): أُنشئت جلسة API محلية مؤقتة، ثم استُخدم `/v1/agent/run` على مساحة `SovereignAI-Starter` مع الملف المحدد `start-api.ps1` ومهارة «شرح الكود». أعاد الوكيل `tool=local-llm` و`model=gemma4:e2b` واستشهد باسم الملف، وذكر قيمة `LOCAL_MODEL` الافتراضية الصحيحة؛ أُلغيت الجلسة بعد الطلب ولم تتغير ملفات المشروع.
- [x] اختبار حي لدورة تسجيل المشروع وقراءته على API 8000 (2026-10-04): أُنشئ مشروع تجريبي داخل `tmp/`، وسُجل عبر `/v1/agent/projects` (201)، وأظهر `/v1/agent/workspace/files` الملف `README.md`. قرأ وكيل Gemma 4 الملف المحدد بمهارة `code_explain` وأعاد رمز التحقق `WORKSPACE_SENTINEL_AR_582` حرفيًا خلال 25.3 ثانية. بعده أُلغي تسجيل المشروع، وانتهت جلسة المصادقة، وحُذف مجلد الاختبار؛ `git status` لا يعرض ملفات اختبار متبقية. هذا يثبت تكامل API والتخزين/القراءة فقط؛ لا يحل محل اختبار اختيار المجلد من نافذة Flutter.
## ترتيب التنفيذ القادم
1. [x] التحقق من إجراءات المحادثة الجديدة على Windows Debug (2026-10-01): تشغيل API وGemma وGroq، اختبار صوت من الميكروفون حتى التفريغ والرد والحفظ في SQLite، نجاح اختبار الواجهة على نافذة 800px ونجاح `flutter analyze`.