test: add reproducible live agent workspace smoke check

SovereignAI-Starter/README.md

@@ -78,6 +78,14 @@ python -m uvicorn app.main:app --reload --host 127.0.0.1 --port 8000
 - `POST /v1/chat/completions` يمرر الطلب إلى الخادم المحلي عند ضبط المتغيرين أعلاه.
 - يمكن التبديل في Swagger بين النموذجين بإضافة `model` إلى جسم الطلب، مثل `gemma4:e2b`.
 
+للتحقق الحي من دورة تسجيل مجلد اختبار، وقراءة ملف عبر الوكيل، وإنشاء معاينة تعديل دون تطبيقها:
+
+```powershell
+.\scripts\verify_agent_workspace_live.ps1
+```
+
+يتطلب هذا التحقق أن يكون FastAPI وOllama والنموذج المحلي يعملون. ينشئ السكريبت ملفات مؤقتة، ثم يلغي تسجيل المشروع والجلسة ويحذف مجلد الاختبار؛ ولا يطبق معاينة التعديل.
+
 تثبيت OCR المحلي الاختياري للصور وPDFات الممسوحة:
 
 ```powershell