@tera-system/core 0.2.15 → 0.2.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/MANIFEST.json +5 -5
  2. package/README.md +3 -3
  3. package/RELEASES.md +318 -308
  4. package/agents/application-blueprint.md +4 -4
  5. package/agents/domain-expert-agent.md +3 -3
  6. package/agents/domain-research-agent.md +4 -4
  7. package/agents/engineering-agent-typescript.md +1 -1
  8. package/agents/production-erp-expert.md +2 -2
  9. package/agents/red-team-agent.md +1 -1
  10. package/agents/tera-client-engagement.md +1 -1
  11. package/agents/tera-system-evolution.md +2 -1
  12. package/agents/tera.md +1 -0
  13. package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +275 -277
  14. package/core/tera-system/AGENT_DEPENDENCY_MAP.md +2 -2
  15. package/core/tera-system/AGENT_PERMISSION_MODEL.md +39 -26
  16. package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +2 -2
  17. package/core/tera-system/TERA_PROJECT_DECISION.md +14 -12
  18. package/core/tera-system/TOOLING_AND_MCP_POLICY.md +1 -1
  19. package/core/tera-system/TeraCapabilityMap.md +327 -0
  20. package/core/tera-system/TeraHelperAgents.md +13 -10
  21. package/core/tera-system/TeraPolicyMap.md +2 -1
  22. package/core/tera-system/TeraPreExecutionGate.md +1 -1
  23. package/core/tera-system/TeraPreparationDocumentationGovernance.md +1 -1
  24. package/core/tera-system/TeraSubAgents.md +312 -868
  25. package/core/tera-system/TeraTokenPolicy.md +1 -1
  26. package/core/tera-system/design-system/DESIGN_SOURCE_PROTOCOL.md +2 -2
  27. package/core/tera-system/design-system/FIGMA_INTEGRATION.md +3 -3
  28. package/core/tera-system/design-system/UI_ACCEPTANCE_GATE.md +1 -1
  29. package/core/tera-system/engineering-governance/ENGINEERING_AGENT_RESPONSIBILITIES.md +4 -2
  30. package/core/tera-system/engineering-governance/ENGINEERING_REVIEW_CHECKLIST.md +1 -1
  31. package/core/tera-system/engineering-governance/QUALITY_GATE_THRESHOLDS.md +1 -1
  32. package/core/tera-system/profiles/PROFILES_INDEX.md +2 -0
  33. package/core/tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md +3 -3
  34. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CLIENT.md +2 -2
  35. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +5 -5
  36. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +1 -1
  37. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +4 -4
  38. package/package.json +1 -1
@@ -29,9 +29,9 @@
29
29
  | **production-erp-expert.md** | Majed مباشرة، `tera.md`, `tera-client-engagement.md`, `application-blueprint.md`؛ وEngineering/QA فقط عبر Tera-approved task scope | `domain-research-agent.md` عند نقص المعرفة وبقرار المستدعي | `tera-system/knowledge-base/manufacturing/`, ملفات discovery/blueprint المحددة |
30
30
  | **tera-system-evolution.md** | — (مستقل — يستدعيه Majed) | `ui-designer.md`, `domain-research-agent.md`, `domain-expert-agent.md` (للأغراض النظامية) | `tera-system/*.md`, `.opencode/agents/*.md` |
31
31
  | **tera-strategic-advisor.md** | — (مستقل — يستدعيه Majed فقط) | لا يستدعي عملاء ولا يديرهم؛ قد يوصي Majed بالرجوع إلى TeraAgent أو حارس أو غيرهم | ملفات وسياقات القرار فقط، مصادر خارجية عند الحاجة |
32
- | **auditor.md** | `tera.md`؛ و`monitor.md` فقط عند طلب Majed | يراجع مخرجات `tera.md`, `engineering-agent.md`؛ يحيل findings إلى `SecurityAgent`, `DesignReviewer`, `QAAndAcceptanceAgent`, أو `ProjectControlAgent` عبر الوكيل المستدعي | `project-control/*.md`, `project-control/audit-reports/`, `tera-system/engineering-governance/*.md`, الملفات المعدلة |
32
+ | **auditor.md** | `tera.md`؛ و`monitor.md` فقط عند طلب Majed | يراجع مخرجات `tera.md`, `engineering-agent.md`؛ يحيل findings إلى `SecurityAgent`, `DesignReviewer`, `qa-agent`, أو `ProjectControlAgent` عبر الوكيل المستدعي | `project-control/*.md`, `project-control/audit-reports/`, `tera-system/engineering-governance/*.md`, الملفات المعدلة |
33
33
  | **monitor.md** | — (مستقل — يستدعيه Majed) | يراجع مخرجات `tera.md`, `engineering-agent.md`; قد يستدعي `auditor.md` فقط عندما يطلب Majed تحدي/تحقق جودة مستقل | `project-control/*.md`, `tera-system/*.md` |
34
- | **qa-agent.md** (الاسم المنطقي: QAAndAcceptanceAgent) | `tera.md` (يُفعّله Tera) | لا يستدعي عملاء آخرين | ملفات التحضير، ملفات المهمة، logs، مخرجات CLI، `project-control/test-reports/` |
34
+ | **qa-agent.md** (الاسم المنطقي: qa-agent) | `tera.md` (يُفعّله Tera) | لا يستدعي عملاء آخرين | ملفات التحضير، ملفات المهمة، logs، مخرجات CLI، `project-control/test-reports/` |
35
35
  | **red-team-agent.md** 🆕 (الشبح — SCP-2026-09-02-001) | `tera.md` (Phase 7 Security Gate)؛ Majed مباشرة | `security-observer.md` (العين يراقبه بالتزامن)، `security-auditor.md` (القاضي يدقق أدلته)؛ يستلم `defense-handoff.md` من الدرع عبر Tera | `security-reports/[ROUND-ID]/`, البروتوكول الأمني v2.0, `tera-system/TOOLING_AND_MCP_POLICY.md` |
36
36
  | **security-observer.md** 🆕 (العين — SCP-2026-09-02-001) | `tera.md` (بالتزامن مع Red Team)؛ Majed مباشرة | يراقب أثر `red-team-agent.md` (الشبح) — لا يهاجم ولا يصلح | `security-reports/[ROUND-ID]/`, سجلات التطبيق والموارد، تقرير الشبح |
37
37
  | **security-auditor.md** 🆕 (القاضي — SCP-2026-09-02-001) | `tera.md` (بعد Red Team + Observer + Retest)؛ Majed مباشرة | يدقق أدلة `red-team-agent.md` (الشبح) + تقرير `security-observer.md` (العين) — يرفض الادعاءات بلا دليل | `security-reports/[ROUND-ID]/audit/`, ASVS 5.0 L2, WSTG, تقارير الشبح والعين |
@@ -115,7 +115,7 @@
115
115
  | تشغيل اختبارات | ❌ ممنوع |
116
116
  | إنشاء ملفات جديدة | ✅ ضمن `Allowed Write Targets` فقط |
117
117
 
118
- **متى يستخدم:** للعملاء الذين ينتجون توثيقًا أو تصميمًا أو تحضيرًا، مثل UIVisualDesignerAgent, DocumentationHandoverAgent.
118
+ **متى يستخدم:** للعملاء الذين ينتجون توثيقًا أو تصميمًا أو تحضيرًا، مثل ui-designer (Design Tokens) وعملاء توثيق التسليم (عبر tera.md).
119
119
 
120
120
  ---
121
121
 
@@ -131,7 +131,7 @@
131
131
  | تشغيل أدوات | ❌ ممنوع |
132
132
  | إنشاء ملفات جديدة | ✅ فقط داخل `project-knowledge/` |
133
133
 
134
- **متى يستخدم:** حصريًا لـ ProjectKnowledgeAgent لتحديث ذاكرة المشروع التنفيذية بعد قبول المهام المؤثرة.
134
+ **متى يستخدم:** حصريًا لـ `project-knowledge-agent` لتحديث ذاكرة المشروع التنفيذية بعد قبول المهام المؤثرة.
135
135
 
136
136
  ---
137
137
 
@@ -206,29 +206,43 @@
206
206
 
207
207
  ## 3. مصفوفة الصلاحية الافتراضية لكل عميل
208
208
 
209
- ### 3.1 العملاء الأساسيون
209
+ ### 3.1 العملاء الأساسيون (الـ 23 الرسميون)
210
+
211
+ > **المرجع المعياري (SCP-2026-09-04-001):** العملاء الرسميون بالأسماء الحديثة — راجع `TeraSubAgents.md` §5.
210
212
 
211
213
  | العميل | المعرف | الصلاحية الافتراضية | هل يمكن رفعها؟ | ملاحظة |
212
214
  |---|---|---|---|---|
213
- | RequirementsScopeAgent | `REQ_SCOPE_AGENT` | `WRITE_DOCS` | إلى PLAN_ONLY إذا كان التحليل فقط | يكتب ملفات النطاق والمتطلبات فقط |
214
- | BusinessWorkflowAgent | `BUSINESS_WORKFLOW_AGENT` | `WRITE_DOCS` | — | يكتب ملفات سير العمل فقط |
215
- | UIUXStructureAgent | `UI_UX_STRUCTURE_AGENT` | `WRITE_DOCS` | — | يكتب هيكل الشاشات فقط |
216
- | UIVisualDesignerAgent | `UI_VISUAL_DESIGNER_AGENT` | `WRITE_DOCS` | إلى READ_ONLY إذا كان مراجعة فقط | يكتب دليل التصميم والتوكينز فقط |
217
- | DataDesignAgent | `DATA_DESIGN_AGENT` | `WRITE_DOCS` | — | يكتب نموذج البيانات فقط |
218
- | SolutionArchitectureAgent | `SOLUTION_ARCH_AGENT` | `WRITE_DOCS` | إلى PLAN_ONLY إذا كان تحليلًا فقط | يكتب المعمارية فقط |
219
- | EngineeringAgent | `ENGINEERING_AGENT` | `WRITE_CODE` | إلى READ_ONLY إذا كانت مراجعة كود فقط | مستوى عالٍ، يجب مراقبته |
220
- | qa-agent | `QA_ACCEPTANCE_AGENT` | `RUN_TESTS` | إلى READ_ONLY إذا كان مراجعة فقط | **Planning Mode:** `WRITE_DOCS` — يكتب خطط الاختبار ومعايير القبول. **Execution Mode:** `RUN_TESTS` + bash — يشغّل أوامر CLI (dotnet build/test/run) ويكتب تقارير اختبار رسمية |
221
- | DocumentationHandoverAgent | `DOC_HANDOVER_AGENT` | `WRITE_DOCS` | — | يكتب وثائق التسليم فقط |
222
- | ProjectKnowledgeAgent | `PROJECT_KNOWLEDGE_AGENT` | `WRITE_KNOWLEDGE` | — | يكتب معرفة تشغيلية فقط داخل project-knowledge/ |
223
-
224
- ### 3.2 العملاء المشروطون
215
+ | tera (TeraAgent) | `TERA` | `WRITE_CONTROL` + `WRITE_DOCS` | — | يدير المشروع ويسجل السجلات؛ لا يكتب كوداً (يفوّض Coding Agents) |
216
+ | application-blueprint (مهندس) | `APPLICATION_BLUEPRINT_AGENT` | `WRITE_DOCS` + `WRITE_CONTROL` | — | Solution Preparation Authority (1–4): ملفات التحضير + Engineering Handoff؛ لا يكتب كوداً |
217
+ | engineering-agent | `ENGINEERING_AGENT` | `WRITE_CODE` | إلى READ_ONLY إذا كانت مراجعة كود فقط | مستوى عالٍ، يجب مراقبته |
218
+ | engineering-agent-typescript | `ENGINEERING_AGENT_TS` | `WRITE_CODE` | — | كود TypeScript/Node.js/React وظيفي |
219
+ | engineering-agent-phaser | `ENGINEERING_AGENT_PHASER` | `WRITE_CODE` | — | كود Phaser 3 Web Games |
220
+ | engineering-agent-dotnet | `ENGINEERING_AGENT_DOTNET` | `WRITE_CODE` | — | كود .NET/C# |
221
+ | ui-designer | `UI_VISUAL_DESIGNER_AGENT` | `WRITE_DOCS` | إلى READ_ONLY إذا كان مراجعة فقط | يكتب Design Tokens / Component Rules / Layout Rules داخل `28_UI_UX_GUIDELINES.md` |
222
+ | tera-software-designer | `SOFTWARE_DESIGNER_AGENT` | `WRITE_DOCS` | إلى `PLAN_ONLY` إذا ما زالت الخطة غير ناضجة | يجهز Technical Specification للمهام فقط |
223
+ | qa-agent | `QA_ACCEPTANCE_AGENT` | `RUN_TESTS` | إلى READ_ONLY إذا كان مراجعة فقط | **Planning Mode:** `WRITE_DOCS` — خطط الاختبار ومعايير القبول. **Execution Mode:** `RUN_TESTS` + bash — تشغيل CLI + تقارير اختبار رسمية |
224
+ | auditor | `AUDITOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند كتابة تقرير التدقيق | تدقيق Diff-first بعد التنفيذ؛ لا يعدّل كوداً |
225
+ | design-reviewer | `DESIGN_REVIEWER` | `READ_ONLY` | إلى `WRITE_DOCS` عند تقرير المراجعة | مراجعة بصرية مستقلة؛ لا يبني ولا يعدّل |
226
+ | monitor | `MONITOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند تقارير الامتثال | يراقب الامتثال؛ يستدعي auditor بطلب Majed |
227
+ | tera-client-engagement | `TCEA` | `WRITE_DOCS` (ضمن client/) | — | Discovery + Scoping + Proposals للعملاء الخارجيين |
228
+ | tera-business-transformation-consultant | `BTCA` | `WRITE_DOCS` (ضمن client/) | — | تحول مؤسسي (Track C) عبر TCEA |
229
+ | tera-strategic-advisor | `STRATEGIC_ADVISOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند التقرير | استشارة استراتيجية — Majed فقط |
230
+ | domain-research-agent | `DOMAIN_RESEARCH_AGENT` | `WRITE_DOCS` | — | يكتب Domain Research Report في Allowed Write Targets + يحفظ DRAFT في `../Teranoo-Research/{domain}/` عند Score≥3 + يحدّث `00_INDEX.md` (Reuse-First, SCP-2026-08-31-001). لا يكتب كوداً، لا يتحكم في project-control. ترقية DRAFT→READY بيد Majed فقط (SCP-2026-09-04-008) |
231
+ | domain-expert-agent | `DOMAIN_EXPERT_AGENT` | `WRITE_DOCS` | — | يكتب Domain Intelligence Report / Knowledge Structure / Gap Analysis في Allowed Write Targets. لا يعدّل ملفات قائمة (edit: deny)، لا يكتب كوداً، لا يتحكم في project-control (SCP-2026-09-04-008) |
232
+ | production-erp-expert | `PRODUCTION_ERP_EXPERT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم تحليل/أسئلة/مراجعة Blueprint ضمن Allowed Write Targets | مستشار Production ERP؛ لا يكتب كوداً ولا يقرر النطاق |
233
+ | project-knowledge-agent | `PROJECT_KNOWLEDGE_AGENT` | `WRITE_KNOWLEDGE` | — | يكتب معرفة تشغيلية فقط داخل project-knowledge/ |
234
+ | tera-system-evolution | `TERA_SYSTEM_EVOLUTION` | `WRITE_DOCS` (نظامية بموافقة Majed) | — | حوكمة وتطوير منظومة Tera؛ تعديلات بعد SCP وموافقة |
235
+ | red-team-agent (الشبح) | `RED_TEAM_AGENT` | `EXECUTE_ATTACKS` (ضمن تفويض مكتوب) + `WRITE_EVIDENCE` في security-reports فقط | لا يُرفع — التفويض يحدد النطاق لا الصلاحية | يهاجم فقط ما فُوّض له؛ لا يكتب كوداً؛ لا يصلح أثناء الجولة (SCP-2026-09-02-001) |
236
+ | security-observer (العين) | `SECURITY_OBSERVER` | `READ_ONLY` | إلى `WRITE_DOCS` عند تقرير المراقب في security-reports/observer | يراقب فقط — لا يهاجم، لا يصلح، لا يحكم (SCP-2026-09-02-001) |
237
+ | security-auditor (القاضي) | `SECURITY_AUDITOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند تقرير التدقيق + قرار البوابة في security-reports/audit | يدقق فقط — لا يهاجم، لا يصلح، لا يثق بلا دليل (SCP-2026-09-02-001) |
238
+
239
+ ### 3.2 العملاء المشروطون (Helper Agents + Preparation Roles)
240
+
241
+ > **تصحيح (SCP-2026-09-04-001):** العملاء المشروطون هنا هم **Helper Agents** مُولَّدون عند الحاجة (مثل Integration/DevOps/Performance...). الأدوار التحضيرية القديمة (RequirementsScope/DataDesign...) ليست عملاءً — مسؤوليتها مملوكة لـ `application-blueprint` (راجع `TeraSubAgents.md` §5.9).
225
242
 
226
243
  | العميل | المعرف | الصلاحية الافتراضية | هل يمكن رفعها؟ | ملاحظة |
227
244
  |---|---|---|---|---|
228
245
  | SecurityAgent (الدرع) | `SECURITY_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند توثيق findings + كتابة `defense-handoff.md` و`fix-review.md` في security-reports | لا يكتب كودًا أبدًا. دفاعي فقط — لا ينفذ هجمات (SCP-2026-09-02-001) |
229
- | RedTeamAgent (الشبح) 🆕 | `RED_TEAM_AGENT` | `EXECUTE_ATTACKS` (ضمن تفويض مكتوب) + `WRITE_EVIDENCE` في security-reports فقط | لا يُرفع — التفويض يحدد النطاق، لا الصلاحية | يهاجم فقط ما فُوّض له كتابياً؛ لا يكتب كوداً؛ لا يصلح الثغرات أثناء الجولة (SCP-2026-09-02-001) |
230
- | SecurityObserver (العين) 🆕 | `SECURITY_OBSERVER` | `READ_ONLY` | إلى `WRITE_DOCS` عند كتابة تقرير المراقب في security-reports/observer | يراقب فقط — لا يهاجم، لا يصلح، لا يحكم (SCP-2026-09-02-001) |
231
- | SecurityAuditor (القاضي) 🆕 | `SECURITY_AUDITOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند كتابة تقرير التدقيق + قرار البوابة في security-reports/audit | يدقق فقط — لا يهاجم، لا يصلح، لا يثق بالادعاءات بلا دليل (SCP-2026-09-02-001) |
232
246
  | IntegrationAgent | `INTEGRATION_AGENT` | `WRITE_DOCS` | إلى `WRITE_CODE` لتعديل كود التكامل فقط إذا فوضه Tera صراحة | يوثق التكاملات |
233
247
  | DevOpsDeploymentAgent | `DEVOPS_DEPLOYMENT_AGENT` | `WRITE_CODE` | إلى `DEPLOY_WITH_APPROVAL` عند النشر | يتطلب موافقة لكل نشر |
234
248
  | PerformanceAgent | `PERFORMANCE_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند توثيق التوصيات | يحلل فقط |
@@ -236,12 +250,8 @@
236
250
  | ReportingAnalyticsAgent | `REPORTING_ANALYTICS_AGENT` | `WRITE_DOCS` | — | يوثق متطلبات التقارير |
237
251
  | MaintenanceMigrationAgent | `MAINTENANCE_MIGRATION_AGENT` | `WRITE_DOCS` | — | يخطط للترحيل |
238
252
  | ProjectControlAgent | `PROJECT_CONTROL_AGENT` | `WRITE_CONTROL` | — | يتحكم في سجلات المشروع فقط |
239
- | tera-software-designer (SoftwareDesignerAgent) | `SOFTWARE_DESIGNER_AGENT` | `WRITE_DOCS` | إلى `PLAN_ONLY` إذا ما زالت الخطة غير ناضجة | يجهز Technical Specification للمهام فقط |
240
253
  | QualityReviewCoordinatorAgent | `QUALITY_REVIEW_COORDINATOR_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم تقرير فقط | ينسق المراجعة فقط |
241
- | PlanComplianceReviewAgent | `PLAN_COMPLIANCE_REVIEW_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التقرير فقط | يراجع توافق الخطة فقط |
242
- | DomainResearchAgent | `DOMAIN_RESEARCH_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التقرير + حفظ DRAFT في `../Teranoo-Research/{domain}/` عند Score≥3 (SCP-2026-08-31-001) | يبحث فقط + يقرأ `../Teranoo-Research/00_INDEX.md` (Reuse-First) |
243
- | DomainExpertAgent | `DOMAIN_EXPERT_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التحليل | يحلل فقط + يقرأ `../Teranoo-Research/00_INDEX.md` عند الحاجة |
244
- | ProductionERPExpert | `PRODUCTION_ERP_EXPERT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم تحليل أو أسئلة أو مراجعة Blueprint ضمن Allowed Write Targets | مستشار Production ERP؛ لا يكتب كوداً ولا يقرر النطاق أو التكلفة النهائية — يقرأ `../Teranoo-Research/00_INDEX.md` عند الحاجة |
254
+ | PlanComplianceReviewAgent | `PLAN_COMPLIANCE_REVIEW_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التقرير فقط | يراجع توافق الخطة فقط |
245
255
 
246
256
  ### 3.3 عملاء التعامل مع العملاء الخارجيين
247
257
 
@@ -332,16 +342,19 @@ EngineeringAgent يُستخدم لمراجعة كود فقط → يخفض إلى
332
342
 
333
343
  ```
334
344
  للعملاء الذين يحتاجون قراءة فقط ولا يملكون أي صلاحية كتابة.
335
- مطبق افتراضيًا على DomainResearchAgent و DomainExpertAgent و QualityReviewCoordinatorAgent.
345
+ مطبق افتراضيًا على `quality-review-coordinator-agent`.
336
346
  يمكن رفعه إلى `WRITE_DOCS` فقط لتسليم التقرير.
347
+
348
+ ملاحظة (SCP-2026-09-04-008): `domain-research-agent` و `domain-expert-agent`
349
+ أصبحا `WRITE_DOCS` افتراضياً بقرار Majed — لم يعودا تحت NO_WRITE.
337
350
  ```
338
351
 
339
352
  ### 5.6 صلاحية المكتبة البحثية (SCP-2026-08-31-001)
340
353
 
341
354
  ```
342
355
  المسار `../Teranoo-Research/**` (خارج Teranoo-System):
343
- - القراءة: مسموحة لـ DomainResearchAgent / DomainExpertAgent / ProductionERPExpert (Reuse-First)
344
- - الكتابة: مسموحة فقط لـ DomainResearchAgent لحفظ DRAFT عند Score≥3 في `../Teranoo-Research/{domain}/`
356
+ - القراءة: مسموحة لـ `domain-research-agent` / `domain-expert-agent` / `production-erp-expert` (Reuse-First)
357
+ - الكتابة: مسموحة فقط لـ `domain-research-agent` لحفظ DRAFT عند Score≥3 في `../Teranoo-Research/{domain}/`
345
358
  - الترقية DRAFT→READY: بيد Majed فقط (تعديل 00_INDEX.md)
346
359
  - لا يُوزع للزبائن — مستثنى من core-bundle
347
360
  ```
@@ -63,8 +63,8 @@ Release Package (ملفات Tera-managed + SHA256SUMS + TERA_RELEASE_MANIFEST.js
63
63
 
64
64
  | الحزمة | الاسم (npm) | الإصدار الحالي | الوصف | الملفات الموزعة ضمن الحزمة |
65
65
  |---|---|---|---|---|
66
- | core | `@tera-system/core` | 0.2.10 | OpenCode Plugin — core governance (20 agents, 11 commands, distribution tools) | `agents/`, `commands/`, `core/`, `assets/`, `tools/`, `scripts/` |
67
- | pro | `@tera-system/pro` | 0.2.14 | Commercial edition — signed bundle + license gate + heartbeat | `scripts/`, `core/project-control`, `MANIFEST.json`, `opencode.tera.example.json`, `WELCOME.md`, `README.md` |
66
+ | core | `@tera-system/core` | 0.2.15 | OpenCode Plugin — core governance (23 agents, 11 commands, distribution tools, security team) | `agents/`, `commands/`, `core/`, `assets/`, `tools/`, `scripts/` |
67
+ | pro | `@tera-system/pro` | 0.2.20 | Commercial edition — signed bundle + license gate + heartbeat | `scripts/`, `core/project-control`, `MANIFEST.json`, `opencode.tera.example.json`, `WELCOME.md`, `README.md` |
68
68
 
69
69
  **المستودع الرسمي:** `https://github.com/Alabasi1980/Teranoo-System` — هو `RepositoryUrl` الوحيد المعتمد لـ `tera-fetch.ps1` و `tera-schedule.ps1`
70
70
  **Tags:** `tera-vX.Y.Z` — الـ Lockfile يحفظ `Commit SHA` كحقيقة، والقنوات `stable`/`beta`
@@ -139,9 +139,9 @@
139
139
 
140
140
  | الملف | السبب | العميل الفرعي المتوقع |
141
141
  |---|---|---|
142
- | `01_PROJECT_BRIEF.md` | `[REASON]` | `RequirementsScopeAgent` |
143
- | `02_SCOPE_AND_BOUNDARIES.md` | `[REASON]` | `RequirementsScopeAgent` |
144
- | `03_MODULES_AND_FEATURES.md` | `[REASON]` | `RequirementsScopeAgent` |
142
+ | `01_PROJECT_BRIEF.md` | `[REASON]` | `application-blueprint` (Prep Role: Scope) |
143
+ | `02_SCOPE_AND_BOUNDARIES.md` | `[REASON]` | `application-blueprint` (Prep Role: Scope) |
144
+ | `03_MODULES_AND_FEATURES.md` | `[REASON]` | `application-blueprint` (Prep Role: Scope) |
145
145
  | ... | ... | ... |
146
146
 
147
147
  ### مشروط (Conditional)
@@ -165,17 +165,19 @@
165
165
 
166
166
  ---
167
167
 
168
- ## 9. Suggested Sub-Agents
168
+ ## 9. Suggested Sub-Agents
169
+
170
+ > **SCP-2026-09-04-001:** الأدوار التحضيرية (RequirementsScope / BusinessWorkflow / DataDesign / UIUXStructure / SolutionArchitecture) **ليست عملاءً ثابتين** — مسؤوليتها يملكها `application-blueprint` (مهندس الحل) وتُنفَّذ عبر `TASK-PREP-*`. `ui-designer` عميل فعلي للتصميم البصري. (راجع `TeraSubAgents.md` §5.9)
169
171
 
170
- | العميل الفرعي | الحاجة | متى؟ | السبب |
172
+ | العميل/الدور | الحاجة | متى؟ | السبب |
171
173
  |---|---|---|---|
172
- | `RequirementsScopeAgent` | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
173
- | `BusinessWorkflowAgent` | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
174
- | `DataDesignAgent` | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
175
- | `UIUXStructureAgent` | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
176
- | `UIVisualDesignerAgent` | Required / Conditional / Not Needed | عند وجود واجهة أو مصدر تصميم يحتاج تحويل إلى Tokens/Component Rules | `[REASON]` |
177
- | `SolutionArchitectureAgent` | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
178
- | `SecurityAgent` | Required / Conditional / Not Needed | حسب الحساسية | `[REASON]` |
174
+ | Prep Role: Requirements & Scope (يملكه application-blueprint) | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
175
+ | Prep Role: Business Workflow (يملكه application-blueprint) | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
176
+ | Prep Role: Data Design (يملكه application-blueprint) | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
177
+ | Prep Role: UI/UX Structure (يملكه application-blueprint) | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
178
+ | `ui-designer` | Required / Conditional / Not Needed | عند وجود واجهة أو مصدر تصميم يحتاج تحويل إلى Tokens/Component Rules | `[REASON]` |
179
+ | Prep Role: Solution Architecture (يملكه application-blueprint / tera-software-designer) | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
180
+ | `SecurityAgent` (الدرع) | Required / Conditional / Not Needed | حسب الحساسية | `[REASON]` |
179
181
  | `IntegrationAgent` | Required / Conditional / Not Needed | حسب التكاملات | `[REASON]` |
180
182
  | `DevOpsDeploymentAgent` | Required / Conditional / Not Needed | حسب الحاجة | `[REASON]` |
181
183
 
@@ -248,7 +248,7 @@ powershell -ExecutionPolicy Bypass -File .\tools\tera-tooling.ps1 -Install
248
248
  | **API Testing MCP** | متاحة حالياً عبر curl/webfetch + Bruno CLI — لا حاجة لخادم MCP. | عند الحاجة لاستعلام تفاعلي متكرر من العملاء من نتائج API مباشرة. |
249
249
  | **Git / GitHub MCP** | Git CLI الحالية تغطي القراءة والكتابة (بموافقة). | عند اعتماد GitHub سير عمل PRs بكثافة. |
250
250
  | **Database Read-Only MCP** | الوصول الحالي عبر CLI/استعلامات مصرّح بها. | عند وجود مشروع يتطلب فحص قواعد بيانات متكرراً من عدة عملاء. |
251
- | **Figma MCP** | البروتوكول الحالي FIGMA_INTEGRATION.md + UIVisualDesignerAgent يكفي الآن. MCP Figma سيضيف تعقيدًا قبل الحاجة الفعلية. | عند وجود مشروع يعتمد على Figma بانتظام وتتعدد مهام التصميم. |
251
+ | **Figma MCP** | البروتوكول الحالي FIGMA_INTEGRATION.md + ui-designer يكفي الآن. MCP Figma سيضيف تعقيدًا قبل الحاجة الفعلية. | عند وجود مشروع يعتمد على Figma بانتظام وتتعدد مهام التصميم. |
252
252
  | **Deployment / Cloud MCPs** | النشر ليس محورًا حاليًا. DevOpsDeploymentAgent الحالي يغطي التخطيط والتحضير. | عند وجود مشروع يتطلب نشر فعلي متكرر CI/CD. |
253
253
  | **Production DB Write Tools** | خطرة جدًا وتحتاج ضوابط أمنية متقدمة. | عند وجود مشروع يتطلب وصول كتابي إلى قاعدة بيانات Production مع خطة rollback موثقة. |
254
254
  | **Email / Calendar MCPs** | غير ضرورية حاليًا لمنظومة Tera. | عند الحاجة لجدولة مواعيد أو إرسال اتصالات آلية. |
@@ -0,0 +1,327 @@
1
+ <!-- © 2026 Majed Khaireddin (Alabasi1980). Tera System — Proprietary. All rights reserved. -->
2
+
3
+ # TeraCapabilityMap.md — خريطة قدرات المنظومة
4
+
5
+ > **الغرض:** المرجع النظامي الموحد لما تستطيع منظومة Tera تنفيذه — اللغات وأنواع التطبيقات — مع حدودها وموانعها الحقيقية.
6
+ > **الطبيعة:** وثيقة **مرجعية معرفية** (Capability Reference) — **ليست سياسة** ولا مصدر قرار ملزم. السياسات تبقى في `TeraPolicyMap.md`.
7
+ > **المبدأ الحاكم:** لا تتحدث عن "الجاهز الحالي فقط" — بل عن **القدرة القابلة للتجهيز** (حتى لو لم تكن جاهزة اليوم): أي نوع تطبيق يمكن تجهيز المنظومة لتنفيذه إذا توفرت الأدوات والبروفايلات والبيئة.
8
+ > **المصدر:** جلسة تحليلية معتمدة مع Majed (2026-09-04) — محتوى متفق عليه. SCP-2026-09-04-004.
9
+ > **المستخدمون المستهدفون:** TeraAgent، TCEA، application-blueprint، tera-strategic-advisor، حارس — ولأغراض القرار التجاري والمعماري.
10
+
11
+ ---
12
+
13
+ ## 1. معادلة القدرة العامة
14
+
15
+ ```text
16
+ إمكان تنفيذ أي نوع تطبيق =
17
+ (1) لغة/إطار → يتوفر عبر بروفايل + عميل (fallback أو متخصص)
18
+ (2) أدوات بناء → تُثبَّت في البيئة
19
+ (3) منصة/بيئة تشغيل → القيد الحاسم (مثال: iOS يحتاج macOS)
20
+ (4) معرفة المجال → بروفايل/بروتوكول/خبراء (domain)
21
+ (5) بوابات تحقق → قابلة للتشغيل في البيئة (build/test/run)
22
+
23
+ أي نوع يفي بالخمسة = قابل للتنفيذ بجودة موثقة.
24
+ النوع الذي يتعثر عند (3) فقط = "مؤجل بيئياً" وليس مستحيلاً تقنياً.
25
+ ```
26
+
27
+ ---
28
+
29
+ ## 2. قدرات اللغات
30
+
31
+ ### 2.0 الخلاصة المتفق عليها (2026-09-04)
32
+
33
+ ```text
34
+ 1. منظومة Tera محايدة تقنياً (Technology-Neutral): فصل كامل بين بنية
35
+ المنظومة والتقنيات — القواعد التقنية تعيش في البروفايلات، لا في العملاء.
36
+
37
+ 2. عملاء التنفيذ الستة ثابتون مهما تنوعت التقنيات:
38
+ engineering-agent (عام/fallback) + dotnet + typescript + phaser
39
+ + ui-designer + tera-software-designer — لا يُنشأ عميل لأي لغة.
40
+
41
+ 3. لا توجد أي لغة برمجة ممنوعة في المنظومة — الـ fallback العام يغطي
42
+ أي لغة لا يوجد لها متخصص أو بروفايل.
43
+
44
+ 4. معادلة القدرة:
45
+ القدرة = ذكاء نموذج حديث + بروفايلات موثقة + أدوات/بيئة بناء
46
+ توفر الثلاثة = تنفيذ أي لغة بجودة موثقة.
47
+
48
+ 5. البروفايل = معرفة مُتحقَّق منها (تُكتب بعد بناء/اختبار فعلي أو من خبير)،
49
+ قالب موحد خفيف (47 سطراً)، واحد لكل عائلة تقنية رئيسية — يُملأ عند الحاجة
50
+ وليس لكل مشروع، وهو ما يحوّل "ذكاء عام" إلى "معرفة متخصصة موثوقة"
51
+ ويعالج حد القطع المعرفي للنموذج.
52
+
53
+ 6. القيد الوحيد المتبقي بيئي وليس معرفياً أو لغوياً:
54
+ أي لغة تعمل أدواتها في البيئة → تُنفَّذ. لغة تحتاج منصة بناء غير متوفرة
55
+ (مثل iOS/Swift على Windows) → لا تُنفَّذ مهما كان النموذج أو البروفايل.
56
+
57
+ 7. الخلاصة: نموذج حديث + منظومة مجهزة (أدوات + بروفايلات)
58
+ = قدرة على أي لغة، مع استثناء بيئي واحد فقط.
59
+ ```
60
+
61
+ ---
62
+
63
+ ### 2.1 المبدأ
64
+
65
+ ```text
66
+ ❌ لا توجد أي لغة برمجة "ممنوعة" في منظومة Tera — لا قائمة محظورة ولا نص يقيّد لغة.
67
+ ✅ الـ Fallback العام (engineering-agent) يغطي أي لغة لا يوجد لها متخصص.
68
+ ```
69
+
70
+ الدليل الحرفي من `engineering-agent.md` §1:
71
+
72
+ > "When no specialist matches, you (the general fallback) may implement the task."
73
+
74
+ ### 2.2 تصنيف اللغات حسب طريقة عمل Tera معها
75
+
76
+ | الفئة | اللغات | آلية التنفيذ |
77
+ |---|---|---|
78
+ | 🥇 **متخصصة (Specialist)** | C#/.NET، TypeScript/Node.js/React، Phaser 3 (JS) | عميل متخصص مخصص بمعايير كاملة |
79
+ | 🥈 **مغطاة ببروفايل** | Dart/Flutter، Razor Pages+ADO.NET، Next.js+Prisma، WPF، Blazor+EF، React PWA | Fallback + بروفايل (قواعد Scaffold/ORM/CLI موثقة) |
80
+ | 🥉 **غير مغطاة (أي لغة أخرى)** | PHP/Laravel، Python/Django، Java/Spring، Go، Ruby، Kotlin، Swift، Rust... | **Fallback العام مباشرة** — يعمل بلا بروفايل (بجودة أقل) أو ببروفايل (بجودة موثقة) |
81
+
82
+ ### 2.3 المعادلة الحاكمة
83
+
84
+ ```text
85
+ القدرة = ذكاء نموذج حديث + بروفايلات موثقة + أدوات/بيئة بناء
86
+
87
+ - لا موانع تنظيمية/هيكلية → أي لغة تدخل النظام وتُنفَّذ.
88
+ - الأداة هي بوابة "إتمام الدورة" (build/test/deliver) — لا "الكتابة" فقط.
89
+ - البروفايل = معرفة مُتحقَّق منها (تُكتب بعد بناء/اختبار فعلي أو من خبير) — قالب موحد
90
+ خفيف (47 سطراً)، واحد لكل عائلة تقنية رئيسية — يُملأ عند الحاجة وليس لكل مشروع.
91
+ - القيد الوحيد المتبقي **بيئي وليس معرفياً أو لغوياً**:
92
+ أي لغة تعمل أدواتها في البيئة → تُنفَّذ. لغة تحتاج منصة بناء غير متوفرة
93
+ (مثل iOS/Swift على Windows) → لا تُنفَّذ مهما كان النموذج أو البروفايل.
94
+ ```
95
+
96
+ ### 2.4 تصنيف عملي للغات
97
+
98
+ | المستوى | اللغات | الموقف |
99
+ |---|---|---|
100
+ | **ذكاء عالي + أداة** | Python، TypeScript/JS، C#، Java، Go، PHP، C/C++ | ✅ تنفيذ موثوق بجودة عالية حتى بلا بروفايل |
101
+ | **ذكاء متوسط + أداة** | Dart، Ruby، Kotlin، Swift (ببيئة Mac)، Rust | ✅ يعمل — بروفايل يرفع الجودة |
102
+ | **ذكاء محدود + أداة** | لغات نادرة/جديدة/إصدارات حديثة جداً | ⚠️ يعمل لكن بخطأ محتمل — بروفايل شبه إلزامي |
103
+ | **أي مستوى بلا أداة** | أي لغة بلا CLI/بيئة بناء | 🔴 تتوقف عند "الكتابة" ولا تصل "التسليم" |
104
+
105
+ > **ملاحظة الصدق الفكري:** تبقى دقيقة واحدة صحيحة حتى مع أحدث النماذج — **حد القطع المعرفي** (النموذج يعرف حتى تاريخ تدريبه). البروفايل يعالجها لأنها معرفة موثقة خارجية، لا ذاكرة.
106
+
107
+ ---
108
+
109
+ ## 3. أنواع التطبيقات القابلة للتنفيذ
110
+
111
+ > التصنيفات أدناه تصف **القدرة بعد التجهيز** (أدوات + بروفايلات + بيئة)، مع التمييز الدائم بين "جاهز اليوم" و"قابل للتجهيز".
112
+
113
+ ### 3.1 تطبيقات الويب — الأوسع تغطية
114
+
115
+ | التصنيف | الوصف | الإمكان بعد التجهيز |
116
+ |---|---|---|
117
+ | **SPA** | تطبيق صفحة واحدة (React/Vue/Angular) | ✅ عالي جداً — أقوى ما تملكه المنظومة |
118
+ | **PWA** | تطبيق ويب يعمل دون اتصال + قابل للتثبيت | ✅ عالي — بروفايل `react-pwa` موجود فعلاً |
119
+ | **SSR** | عرض من الخادم (Next.js/Nuxt) | ✅ عالي — بروفايل `nextjs-prisma` |
120
+ | **Static/SSG** | مواقع ثابتة (Astro/Eleventy) | ✅ عالي |
121
+ | **MPA تقليدية** | صفحات خادم متعددة (Razor Pages/PHP) | ✅ عالي — بروفايل `dotnet-razorpages-adonet` |
122
+ | **لوحات تحكم/داشبورد** | Admin panels، KPI، تقارير | ✅ عالي — يوجد teranoo-ui + Reporting |
123
+ | **متاجر إلكترونية** | كتالوج + سلة + دفع | ✅ عالي — تكاملات دفع متاحة |
124
+ | **بوابات/منصات** | مواقع خدمات متعددة المستخدمين | ✅ عالي |
125
+
126
+ **الموانع/التحديات:**
127
+ - التوافق مع المتصفحات القديمة → قرار نطاق (لا مانع تقنياً، مانع قرار).
128
+ - SEO لـ SPA الخالصة → تحتاج SSR أو pre-render (حل معروف).
129
+ - الأداء مع بيانات ضخمة → يحتاج PerformanceAgent + فهارس (موجود).
130
+ - الأمان (Auth/صلاحيات/دفع) → بوابة الدرع (SecurityAgent) قائمة.
131
+ - RTL/عربية → المنظومة مصممة عليه أصلاً (قوة، ليست تحدياً).
132
+
133
+ **الخلاصة:** الويب هي "البيت الآمن" للمنظومة — أي إطار ويب = بروفايل + عقد مع fallback.
134
+
135
+ ### 3.2 الواجهات الخلفية والـ APIs — نوع مستقل وقوي
136
+
137
+ | التصنيف | الإمكان |
138
+ |---|---|
139
+ | REST APIs | ✅ عالي — Node/.NET/Python/Go/PHP حسب البروفايل |
140
+ | GraphQL | ✅ عالي — بروفايل واحد |
141
+ | WebSocket / Real-time | ✅ عالي — دردشة، إشعارات، تتبع مباشر |
142
+ | Auth/هوية | ✅ عالي — JWT/OAuth مع قواعد أمان موثقة |
143
+ | مهام مجدولة/Queues | ✅ عالي — خلفيات، إشعارات، معالجة دفعات |
144
+ | Microservices | ✅ عالي — لكن يحتاج قراراً معمارياً |
145
+ | تكاملات خارجية | ✅ عالي — IntegrationAgent موجود (دفع، SMS، ويبهوك) |
146
+
147
+ **الموانع/التحديات:**
148
+ - قواعد بيانات ضخمة/أداء → يحتاج PerformanceAgent (موجود).
149
+ - اتساق البيانات في Microservices → قرار معماري (لا تبدأ Microservices إلا لمبرر حقيقي — Anti-Bloat).
150
+ - مراقبة Production (Sentry/Logging) → مؤجلة حتى أول Production (سياسة معتمدة).
151
+ - أمان متقدم (OWASP) → فريق الحماية الكامل جاهز في Phase 7.
152
+
153
+ ### 3.3 الألعاب — هنا تظهر الفجوات الحقيقية
154
+
155
+ | التصنيف | الإمكان بعد التجهيز | الوضع |
156
+ |---|---|---|
157
+ | **2D ويب (Phaser 3)** | ✅ عالي جداً — عميل متخصص `engineering-agent-phaser` + بروفايل معتمد | **جاهز اليوم** |
158
+ | **2D ويب بمحركات أخرى** (PixiJS/Canvas خام) | ✅ عالي — عبر fallback + بروفايل | قابل للتجهيز |
159
+ | **3D ويب (Three.js/Babylon.js)** | 🟡 متوسط→عالي — عبر fallback + بروفايل 3D جديد | **فجوة: لا بروفايل ولا متخصص حالياً** |
160
+ | **ألعاب موبايل (Flutter Game/Engines)** | 🟡 متوسط — عبر fallback + بروفايل Flutter + محرك ألعاب Flutter | قابل للتجهيز |
161
+ | **Unity (C#)** | 🟡 متوسط — عبر engineering-agent-dotnet + معرفة Unity | **تحدٍّ حقيقي** |
162
+ | **Godot** | 🟡 متوسط — GDScript عبر fallback | قابل |
163
+ | **Unreal (C++)** | 🟠 منخفض→متوسط | تحدٍّ كبير |
164
+
165
+ **الموانع/التحديات الحقيقية:**
166
+ 1. **Unity/Unreal ليست "لغة تكتبها" — بل "محرك + أدوات + مسار أصول"**: البناء ليس `dotnet build`؛ بل مشروع محرك (Editor/Project files) + Asset pipeline + إصدار لكل منصة. البروفايل العادي (Scaffold/ORM/CLI) **لا يكفي** — يحتاج بروتوكول محرك كامل.
167
+ 2. **الأصول (Assets)**: الصور/النماذج/الصوت/الأنيميشن — إنتاجها خارج قدرة كود (يحتاج أدوات تصميم أو مصادر جاهزة). المنظومة تنتج **الكود والمنطق**، لا المحتوى الفني.
168
+ 3. **3D Physics/الرسوميات** — أداء GPU/WebGL، تحسينات متقدمة — معرفة متخصصة فعلاً.
169
+ 4. **منصات النشر** — متجر Steam/App Store/Play — حسابات وتراخيص خارجية (قرار تجاري).
170
+ 5. **الألعاب الجماعية (Multiplayer)**: ممكنة (WebSocket + خادم) لكنها ترفع التعقيد أضعافاً.
171
+
172
+ **الخلاصة:** الألعاب 2D = بيت آمن. 3D ومحركات ثقيلة = ممكنة عبر التجهيز، لكنها **أعلى تحدٍّ من أي نوع آخر** — والسبب ليس الذكاء، بل طبيعة المحرك والأصول.
173
+
174
+ ### 3.4 برامج ويندوز
175
+
176
+ | التصنيف | الإمكان | الجودة المتوقعة |
177
+ |---|---|---|
178
+ | **WPF** | ✅ عالي جداً — بروفايل `dotnet-wpf-sqlite` معتمد + متخصص .NET | **الأعلى في المنظومة** |
179
+ | **WinForms** | ✅ قابل — عبر engineering-agent-dotnet | 🟡 **جودة أقل من WPF** |
180
+ | **Console / Tools** | ✅ عالي | عالية |
181
+ | **Windows Services** | ✅ عالي | عالية |
182
+ | **WinUI 3 / UWP** | 🟡 قابل | يحتاج بروفايل |
183
+
184
+ **لماذا WinForms أقل جودة من WPF؟**
185
+ ```text
186
+ السبب ليس "WinForms صعب" — بل:
187
+ 1. WPF لديه بروفايل كامل موثق (Scaffold + MVVM + SQLite + قواعد) + خبرة
188
+ مشروع تجريبي سابق في المنظومة.
189
+ 2. WinForms بلا بروفايل → fallback يعمل بمعرفة عامة "غير متأكدة".
190
+ 3. WinForms نفسه تقنية قديمة (أقل أنماطاً حديثة: لا MVVM أصلي، قيود
191
+ تخصيص الواجهة) → النتيجة الطبيعية: جودة متوسطة مقارنة بـ WPF.
192
+
193
+ لكن مع بروفايل WinForms جديد + تجربة تحقق → ترتفع جودته بشكل ملحوظ.
194
+ الفرق الجوهري بين "قابل للتنفيذ" و"منتج بجودة معيارية" هو البروفايل دائماً.
195
+ ```
196
+
197
+ **الموانع:**
198
+ - التوزيع (MSIX/Installer/ClickOnce) → قرار + أداة تثبيت.
199
+ - توافق أنظمة Windows قديمة → قرار نطاق.
200
+ - واجهات متقدمة (فيديو/GPU) → حد تقني عام (قدرة التطبيق نفسه).
201
+
202
+ ### 3.5 تطبيقات الموبايل
203
+
204
+ **الجواب الصادق المكوّن من جزأين:**
205
+ ```text
206
+ من ناحية "الكود والمنطق والواجهة": نعم — لا يوجد نوع تطبيق موبايل يستعصي
207
+ على المنظومة من ناحية البرمجة (المتاجر اليوم مليئة بأنواع يمكن كتابتها).
208
+
209
+ من ناحية "قدرات الجهاز الحقيقية": القيد ليس البرمجة، بل ما يلي.
210
+ ```
211
+
212
+ | نوع التطبيق | الإمكان | المتطلبات/الحدود الحقيقية |
213
+ |---|---|---|
214
+ | **بوابة موظف** (رواتب/إجازات/مهام) | ✅ عالي جداً | خادم + API + أمان — كلها متاحة |
215
+ | **تطبيق دردشة** | ✅ عالي | WebSocket + إشعارات + تخزين — متاح |
216
+ | **متجر إلكتروني** | ✅ عالي | دفع + كتالوج + إشعارات — متاح |
217
+ | **تطبيق حماية للجهاز** (Antivirus/تصلب) | 🟠 **محدود جداً** | يتطلب امتيازات نظام عميقة + وصول مستوى OS + توقيعات — **خارج نطاق تطوير التطبيقات العادية** (يحتاج شركاء OS/هاردوير) |
218
+ | **تطبيق خرائط** | 🟡 متوسط | الأساس (خريطة + GPS) سهل؛ **الخرائط بمحركك الخاص = مشروع ضخم** (بيانات جغرافية + توجيه + أوفلاين) — تحتاج SDK جاهز (Google Maps/Mapbox) |
219
+ | **تطبيق هاتف/رسائل (Dialer/SMS)** | 🟠 محدود | iOS يمنع، Android يسمح بقيود صارمة + أذونات حساسة + سياسات متاجر — قابل جزئياً فقط |
220
+ | **كاميرا/تصوير متقدم** | 🟡 متوسط | الأساس سهل؛ معالجة صور متقدمة = معرفة CV مخصصة |
221
+ | **تطبيقات النظام الداخلية** (System apps) | 🔴 خارج النطاق | تحتاج ROM مخصص/توقيع OEM |
222
+ | **تطبيقات إنترنت الأشياء (IoT)** | 🟡 متوسط | ممكن مع بلوتوث + شبكات — قيود الجهاز |
223
+
224
+ **الموانع القاطعة في الموبايل:**
225
+ ```text
226
+ 🔴 #1: iOS = لا يمكن بناؤه على Windows إطلاقاً (يتطلب macOS + Xcode).
227
+ حل: بناء عبر خدمة CI سحابية (GitHub Actions macOS) — متاح كتجهيز.
228
+ 🟠 #2: قدرات النظام العميقة (حماية، نظام) — خارج نطاق تطبيقات المتاجر.
229
+ 🟠 #3: الحسابات التجارية (Google Play/App Store) + التوقيعات + السياسات.
230
+ 🟡 #4: التطبيقات المعتمدة على بيانات عالمية ضخمة (خرائط/توجيه) — تحتاج
231
+ مزود SDK جاهز، وليس تطويراً محضاً.
232
+ 🟡 #5: كفاءة الأداء على أجهزة ضعيفة — يحتاج تحسين مستمر.
233
+ ```
234
+
235
+ **الخلاصة:** المنظومة قادرة على **معظم** أنواع تطبيقات المتاجر (بوابات، تجارة، دردشة، محتوى، إدارة، خدمات) — بشرط: بيئة بناء (أو CI لماك للـ iOS)، SDKs للمزايا المتقدمة، وحسابات النشر. القيود الثلاثة الحقيقية ليست "برمجة" بل: **منصة بناء، قدرات OS عميقة، وبيانات/خدمات خارجية**.
236
+
237
+ ### 3.6 تطبيقات سطح المكتب عبر المنصات
238
+
239
+ | التصنيف | الإمكان | ملاحظات |
240
+ |---|---|---|
241
+ | **Electron** (ويب + سطح مكتب) | ✅ عالي — عبر engineering-agent-typescript | طبيعي للمنظومة (React + Node) |
242
+ | **Tauri** (Rust + ويب) | 🟡 متوسط | يحتاج Rust toolchain — قابل |
243
+ | **Qt (C++/Python)** | 🟡 متوسط | يحتاج بروفايل C++ |
244
+ | **Flutter Desktop** | 🟡 متوسط | بروفايل Flutter يمتد له |
245
+
246
+ **الموانع:** التغليف/التوزيع (Installers لكل OS)، حجم التطبيق (Electron ثقيل)، والوصول لنظام OS العميق. كلها قرارات وتجهيز، لا موانع جوهرية.
247
+
248
+ ### 3.7 أنظمة الأعمال (ERP/إدارة/صيانة)
249
+
250
+ | التصنيف | الإمكان | ملاحظة |
251
+ |---|---|---|
252
+ | **ERP تصنيعي** | ✅ عالي جداً — `production-erp-expert` + قاعدة معرفة تصنيع كاملة (14 ملفاً) | أقوى تخصص Domain في المنظومة |
253
+ | **صيانة/مخازن** | ✅ عالي — معايير منتجات موثقة (maintenance-apps) | جاهز |
254
+ | **محاسبة/مبيعات/مشتريات** | ✅ عالي | قابل |
255
+ | **HR/رواتب** | ✅ عالي | قابل |
256
+ | **CRM** | ✅ عالي | قابل |
257
+
258
+ **الموانع:** ترحيل البيانات من أنظمة قديمة (يتطلب MaintenanceMigrationAgent)، تكاملات (محاسبة/بنوك)، والتعقيد التنظيمي (قرارات نطاق). هذه أنظمة **تخصصية بالمعرفة** — والمنظومة تملك البنية لهذه المعرفة.
259
+
260
+ ### 3.8 أدوات CLI / سكربتات / أوتوميشن
261
+
262
+ | التصنيف | الإمكان |
263
+ |---|---|
264
+ | أدوات معالجة بيانات | ✅ عالي |
265
+ | سكربتات Migrations/Backup | ✅ عالي |
266
+ | أدوات DevOps (CI/Docker) | ✅ عالي — DevOpsDeploymentAgent |
267
+ | Bots / RPA خفيف | ✅ عالي |
268
+
269
+ **الموانع:** شبه معدومة — النوع الأسهل والأقل تحدياً. القيد الوحيد: بيئة تشغيل الأداة.
270
+
271
+ ### 3.9 أصناف إضافية (توسع)
272
+
273
+ | الصنف | الإمكان | الحد |
274
+ |---|---|---|
275
+ | **تطبيقات مدمجة (Embedded/Microcontrollers)** | 🟡 قابل (C/C++/Arduino) | يحتاج toolchains عتاد محددة + وصول فعلي للعتاد |
276
+ | **أنظمة معالجة بيانات/Pipelines** | ✅ عالي (Python/Go) | موارد حسابية |
277
+ | **AI/ML تطبيقات** | 🟡 متوسط | يحتاج نماذج/خدمات (API أو محلي) — معرفة + بنية تحتية |
278
+ | **تطبيقات بلوك تشين/Web3** | 🟡 متوسط | SDKs + عقود — قابل لكن مجال متخصص |
279
+ | **تطبيقات صوت/فيديو** | 🟡 متوسط | ترميز + بث — SDKs خارجية |
280
+ | **تطبيقات الواقع المعزز (AR)** | 🟠 منخفض | يحتاج محركات AR متخصصة + عتاد — تحدي عالٍ |
281
+
282
+ ---
283
+
284
+ ## 4. المصفوفة الختامية — القيود الحقيقية عبر الأنواع
285
+
286
+ ```text
287
+ ما الذي يمنع فعلاً (وليس البرمجة)؟
288
+
289
+ 1. منصة بناء غير متوفرة → iOS على Windows (الحل: CI سحابي ماك)
290
+ 2. قدرات OS عميقة/امتيازات → تطبيقات حماية النظام، System apps
291
+ 3. محتوى/أصول فنية ضخمة → ألعاب 3D كاملة، خرائط بمحرك خاص
292
+ 4. خدمات/بيانات خارجية → خرائط عالمية، دفع، SMS (SDKs)
293
+ 5. حسابات تجارية وتراخيص → متاجر النشر، تراخيص المحركات
294
+ 6. عتاد مادي غير متوفر → Embedded حقيقي، IoT فعلي
295
+
296
+ كل ما عدا ذلك = قابل للتنفيذ عبر: بروفايل + أدوات + بيئة + بوابات تحقق.
297
+ "غير الجاهز اليوم" ≠ "غير ممكن" — بل "يحتاج تجهيزاً ضمن مراحل:
298
+ بروفايل → تجربة تحقق → موافقة → تنفيذ."
299
+ ```
300
+
301
+ ---
302
+
303
+ ## 5. علاقة الوثيقة بملفات المنظومة
304
+
305
+ | الملف | العلاقة |
306
+ |---|---|
307
+ | `tera-system/TeraArchitectureMap.md` | البنية المعمارية والطبقات — هذه الوثيقة تصف **القدرات** فوق تلك البنية |
308
+ | `tera-system/profiles/PROFILES_INDEX.md` | البروفايلات المتاحة — العمود الفقري التقني لقدرات التنفيذ |
309
+ | `tera-system/AGENT_ACTIVATION_MATRIX.md` | متى يُفعَّل كل عميل — بما فيها عملاء التنفيذ الستة |
310
+ | `tera-system/engineering-helpers/engineering-agent-core.md` | العقد التشغيلي المشترك لعملاء التنفيذ |
311
+ | `tera-system/TOOLING_AND_MCP_POLICY.md` | الأدوات والبوابات — شرط (2) في معادلة القدرة |
312
+ | `tera-system/TeraPolicyMap.md` | مصدر الحقيقة للسياسات — هذه الوثيقة معرفية وليست سياسة |
313
+ | `tera-system/knowledge-base/` | معرفة المجالات (مثل التصنيع) — شرط (4) في معادلة القدرة |
314
+
315
+ ---
316
+
317
+ ## 6. قواعد الاستخدام
318
+
319
+ 1. **لا تُستخدم هذه الوثيقة كوعود تجارية** — كل حالة تحمل مستوى جاهزية (✅/🟡/⚠️/🔴) يجب أن يُترجم في العروض بدقة.
320
+ 2. **لا تُعدَّل كسياسة** — أي تعديل جوهرى في المحتوى يُسجَّل كـ SCP.
321
+ 3. **عند تضارب مع سياسة** — السياسة في `TeraPolicyMap.md` هي الحاكم، وهذه الوثيقة تُحدَّث لتعكسها.
322
+ 4. **التصنيف الفكري** — المعلومات هنا تُصنَّف: `[Verified]` (من ملفات) / `[Inferred]` (استنتاج منطقي) / `[Speculative]` (تقدير مهني) — وكل جدول يحمل هذه العلامات ضمن سياقه.
323
+ 5. **التحديث الدوري** — تُراجع مع كل تغيير في العملاء أو البروفايلات أو الأدوات.
324
+
325
+ ---
326
+
327
+ *أنشأها: TeraSystemEvolutionAgent (حارس) — 2026-09-04 · SCP-2026-09-04-004 · محتوى متفق عليه مع Majed.*
@@ -6,7 +6,8 @@
6
6
  تم تقسيم الملف لتخفيف الحجم (كان 1721 سطراً).
7
7
 
8
8
  > القواعد العامة والمبادئ: tera-system/TeraSubAgents.md sections 1-4
9
- > العملاء الأساسيون: tera-system/TeraSubAgents.md section 5
9
+ > العملاء الأساسيون (السجل الرسمي — 23 عميلاً): tera-system/TeraSubAgents.md section 5
10
+ > العملاء المشروطون هنا (Integration, DevOps, Performance...) هم **عملاء مساعدون مُولَّدون عند الحاجة** — وليست جزءاً من الـ 23 الرسميين.
10
11
 
11
12
  ---
12
13
 
@@ -346,7 +347,7 @@ project-control/tasks/
346
347
  - مراجعات الاتساق تشمل السجلات التي كتبها Tera نفسه ولا تستثنيها.
347
348
  - يفحص تسلسل وعدم تكرار `TASK-ID` و`LOG-ID` و`ISSUE-ID` و`DEC-ID` قبل أي تحديث جديد.
348
349
  - يفحص اتساق حالة المهمة بين `TASK_REGISTRY.md` وملف المهمة نفسه.
349
- - يحول findings المؤجلة من `SecurityAgent` أو `QAAndAcceptanceAgent` إلى `Issues` رسمية عند الحاجة وبقرار Tera.
350
+ - يحول findings المؤجلة من `SecurityAgent` أو `qa-agent` إلى `Issues` رسمية عند الحاجة وبقرار Tera.
350
351
  - يحدث `PROJECT_STATE.md` و`TERA_ACTIVE_CONTEXT.md` عند إغلاق مهمة مهمة أو تغير حالة تشغيلية مؤثرة.
351
352
  - يمكنه تحديث `project-control/SUB_AGENT_STATUS.md` فقط عندما يطلب Tera ذلك صراحةً، دون أن يصدر حكمًا إداريًا بنفسه.
352
353
 
@@ -354,12 +355,14 @@ project-control/tasks/
354
355
 
355
356
  ## 6.9 SoftwareDesignerAgent
356
357
 
358
+ > **ملاحظة (SCP-2026-09-04-001):** `tera-software-designer` هو **أحد العملاء الرسميين الـ 23** (Coding — تصميم تقني). يُدرج هنا ضمن Helper Agents فقط للتوثيق المركزي لعلاقته بالعملاء المساعدين؛ تفعيله عبر `AGENT_ACTIVATION_MATRIX.md` §2.1 وليس كعميل مُولَّد.
359
+
357
360
  | البند | القيمة |
358
361
  |---|---|
359
362
  | اسم العميل | Software Designer Agent |
360
363
  | اللقب | مُصمم |
361
364
  | المعرّف | `SOFTWARE_DESIGNER_AGENT` |
362
- | الفئة | مشروط / تصميم تقني |
365
+ | الفئة | أساسي (من الـ 23) / تصميم تقني |
363
366
  | ملف العميل | `.opencode/agents/tera-software-designer.md` |
364
367
  | شرط الاستدعاء | للمهام ذات الأثر: DB, API, Business Logic, Security, Permissions, Workflow, Cross-module, Architecture, Migration, UI Structure, Financial/Inventory Logic |
365
368
 
@@ -428,7 +431,7 @@ project-control/tasks/[TASK-ID].md عند ربط المراجعة بمهمة أ
428
431
  - لا يستبدل العملاء المختصين.
429
432
  - لا يفوض العملاء الآخرين مباشرة من نفسه؛ Tera يبقى صاحب قرار الاستدعاء.
430
433
  - لا يحول findings إلى `Issues` أو `Tasks` أو `Deferred` من نفسه؛ يرفع التوصية فقط.
431
- - لا يراجع acceptance task-by-task بدل `QAAndAcceptanceAgent`.
434
+ - لا يراجع acceptance task-by-task بدل `qa-agent`.
432
435
  - لا يقرر أن التوصية يجب تنفيذها الآن؛ هذا قرار Tera.
433
436
 
434
437
  ### التقرير المطلوب
@@ -522,7 +525,7 @@ project-control/tasks/[TASK-ID].md عند ربط المراجعة بدفعة أ
522
525
  - لا يفتح Tasks أو Issues أو Decisions من تلقاء نفسه.
523
526
  - لا يغلق Tasks أو Issues أو Phases.
524
527
  - لا يستبدل `ProjectControlAgent`.
525
- - لا يستبدل `QAAndAcceptanceAgent`.
528
+ - لا يستبدل `qa-agent`.
526
529
  - لا يستبدل `QualityReviewCoordinatorAgent`.
527
530
  - لا يعتبر البنود المؤجلة أو الملغاة أو الخارجة عن النطاق "مفقودة".
528
531
  - لا يقرر القبول النهائي؛ Tera وحده يقرر.
@@ -531,7 +534,7 @@ project-control/tasks/[TASK-ID].md عند ربط المراجعة بدفعة أ
531
534
 
532
535
  - مع `Tera`: يرفع تقريرًا وتوصيات فقط، وTera يبقى Decision Owner.
533
536
  - مع `ProjectControlAgent`: قد يعتمد على سجلاته ويطلب Tera منه توثيق النتائج بعد القرار.
534
- - مع `QAAndAcceptanceAgent`: `QAAndAcceptanceAgent` يراجع قبول المهمة أو الشاشة، بينما `PlanComplianceReviewAgent` يراجع توافق التنفيذ مع الخطة.
537
+ - مع `qa-agent`: `qa-agent` يراجع قبول المهمة أو الشاشة، بينما `PlanComplianceReviewAgent` يراجع توافق التنفيذ مع الخطة.
535
538
  - مع `QualityReviewCoordinatorAgent`: `QualityReviewCoordinatorAgent` يراجع الجودة متعددة المجالات، بينما `PlanComplianceReviewAgent` يراجع roadmap compliance.
536
539
 
537
540
  ### التقرير المطلوب
@@ -844,10 +847,10 @@ Documentation Status:
844
847
 
845
848
  ```text
846
849
  /agents
847
- RequirementsScopeAgent.md
848
- DataDesignAgent.md
849
- SecurityAgent.md
850
- DevOpsDeploymentAgent.md
850
+ requirements-scope-agent.md
851
+ data-design-agent.md
852
+ security-agent.md
853
+ devops-deployment-agent.md
851
854
  ```
852
855
 
853
856
  ---