@tera-system/core 0.2.13 → 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 (46) hide show
  1. package/MANIFEST.json +5 -5
  2. package/README.md +3 -3
  3. package/RELEASES.md +318 -272
  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 +287 -28
  10. package/agents/security-auditor.md +112 -17
  11. package/agents/security-observer.md +94 -0
  12. package/agents/tera-client-engagement.md +1 -1
  13. package/agents/tera-system-evolution.md +2 -1
  14. package/agents/tera.md +1 -0
  15. package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +275 -277
  16. package/core/tera-system/AGENT_DEPENDENCY_MAP.md +2 -2
  17. package/core/tera-system/AGENT_PERMISSION_MODEL.md +39 -26
  18. package/core/tera-system/SECURITY_TEAM_CHARTER.md +60 -20
  19. package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +2 -2
  20. package/core/tera-system/TERA_PROJECT_DECISION.md +14 -12
  21. package/core/tera-system/TOOLING_AND_MCP_POLICY.md +1 -1
  22. package/core/tera-system/TeraCapabilityMap.md +327 -0
  23. package/core/tera-system/TeraHelperAgents.md +13 -10
  24. package/core/tera-system/TeraPolicyMap.md +2 -1
  25. package/core/tera-system/TeraPreExecutionGate.md +1 -1
  26. package/core/tera-system/TeraPreparationDocumentationGovernance.md +1 -1
  27. package/core/tera-system/TeraSubAgents.md +312 -868
  28. package/core/tera-system/TeraTokenPolicy.md +1 -1
  29. package/core/tera-system/_TEMPLATE_EVIDENCE_MANIFEST.md +59 -0
  30. package/core/tera-system/_TEMPLATE_MATRIX_API_TOP10.md +112 -0
  31. package/core/tera-system/_TEMPLATE_MATRIX_ASVS_L2.md +261 -0
  32. package/core/tera-system/_TEMPLATE_MATRIX_WSTG.md +209 -0
  33. package/core/tera-system/_TEMPLATE_SECURITY_TARGET_SNAPSHOT.md +50 -0
  34. package/core/tera-system/design-system/DESIGN_SOURCE_PROTOCOL.md +2 -2
  35. package/core/tera-system/design-system/FIGMA_INTEGRATION.md +3 -3
  36. package/core/tera-system/design-system/UI_ACCEPTANCE_GATE.md +1 -1
  37. package/core/tera-system/engineering-governance/ENGINEERING_AGENT_RESPONSIBILITIES.md +4 -2
  38. package/core/tera-system/engineering-governance/ENGINEERING_REVIEW_CHECKLIST.md +1 -1
  39. package/core/tera-system/engineering-governance/QUALITY_GATE_THRESHOLDS.md +1 -1
  40. package/core/tera-system/profiles/PROFILES_INDEX.md +2 -0
  41. package/core/tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md +3 -3
  42. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CLIENT.md +2 -2
  43. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +5 -5
  44. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +1 -1
  45. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +4 -4
  46. package/package.json +2 -2
@@ -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
  ```
@@ -80,16 +80,33 @@
80
80
  ### 5.2 مراحل الجولة
81
81
 
82
82
  ```text
83
+ 0. لقطة الهدف — SECURITY_TARGET_SNAPSHOT.md (Commit SHA + Working Tree + Build) — قبل أي هجوم
83
84
  1. التفويض والنطاق (00_AUTHORIZATION.md) — Rules of Engagement موقعة من Majed
84
85
  2. بوابة الاستعداد — بيئة معزولة، بيانات وهمية، Canary، حدود طلبات
85
- 3. Black Box — هجوم من الخارج بلا كود (كالمخترق الحقيقي)
86
- 4. Gray/White Box — مع الكود والمخططات بعد إغلاق Black Box
86
+ 3. Phase A — Black Box معزول تقنياً (URL فقط — لا وصول لكود المصدر) + العين يراقب + Runtime Surface
87
+ 4. Phase B — Gray/White Box (بعد إغلاق A: وصول للكود + Source-Declared Surface)
87
88
  5. الحملات الهجومية الإلزامية — 13 مجالاً
88
- 6. الأدلة — Request/Response فعلي لكل اختبار
89
- 7. Findings — تصنيف CVSS/CWE/OWASP مع خطورة بأثر الإنتاج
90
- 8. الإصلاح + إعادة الاختبار — منفصل عن جلسة الهجوم
91
- 9. تدقيق مستقل — القاضي يراجع كل شيء
92
- 10. بوابة القبول الأمني — قرار نهائي
89
+ 6. الأدلة — Evidence Pack كامل لكل استغلال ناجح (Request/Response فعلي — قاعدة إعادة البناء)
90
+ 7. مصفوفات التغطية المعيارية — ASVS L2 + WSTG + API Top 10 (PASS/FAIL/N/A/NOT TESTED لكل بند)
91
+ 8. Findings — تصنيف ثلاثي (Technical / Business / Exploit Chain) مع CVSS/CWE/OWASP
92
+ 9. تجميد الأدلة — EVIDENCE_MANIFEST.md (SHA256 لكل ملف + Freeze Timestamp — لا تعديل بعدها)
93
+ 10. الإصلاح + إعادة الاختبار — منفصل عن جلسة الهجوم (Track A Retest + Track B Fresh Clean-Room)
94
+ 11. تدقيق مستقل — القاضي: Snapshot + Manifest + Surface Reconciliation (A∪B∪C) + الأدلة والمصفوفات والتصنيف
95
+ 12. بوابة القبول الأمني — قرار نهائي
96
+ ```
97
+
98
+ ### 5.4 أنواع الجولات
99
+
100
+ ```text
101
+ Round 0 — LAB (تدريب الأدوات): تطبيق مليء بثغرات معروفة لتدريب الأدوات وسلسلة الأدلة.
102
+ Round 1+ — CLEAN / Discovery (اختبار الاكتشاف): تطبيق سليم إلى حد كبير يحتوي 5–7 ثغرات
103
+ مخفية جيداً — لا يُخبر الفريق بعددها أو أنواعها أو أماكنها — يقاس Discovery Rate
104
+ والفalse positives.
105
+ Round P — Production-like (قبل التسليم): تطبيق حقيقي قبل التسليم — بوابة Phase 7 الكاملة.
106
+ Round R — Retest (بعد الإصلاحات): مساران —
107
+ Track A: Retest بمعرفة الثغرات (bypass + regression).
108
+ Track B: Fresh Attack Clean-Room (جلسة جديدة بلا أي معرفة سابقة — URL/حسابات/نطاق فقط).
109
+ القاضي يدمج النتيجتين.
93
110
  ```
94
111
 
95
112
  ### 5.3 التفعيل (مقصود ومضبوط)
@@ -139,23 +156,33 @@ security-reports/
139
156
  ├── SECURITY_GATE_LOG.md ← سجل البوابات عبر الجولات
140
157
  └── SEC-ROUND-{YYYY-MM-DD}-{NNN}/ ← جولة واحدة
141
158
  ├── 00_AUTHORIZATION.md ← التفويض والنطاق (يوقعه Majed)
142
- ├── 01_ATTACK_SURFACE.md ← خريطة سطح الهجوم (الشبح)
159
+ ├── SECURITY_TARGET_SNAPSHOT.md ← لقطة الهدف: Commit SHA + Tree + Build + Runtime (نزاهة الإصدار)
160
+ ├── 01_ATTACK_SURFACE.md ← خريطة سطح الهجوم (الشبح — المصدر A)
143
161
  ├── 02_TEST_LOG.md ← سجل الاختبارات (Test IDs + نتائج)
144
- ├── 03_FINDINGS.md ← Findings مع CVSS/CWE/OWASP (الشبح)
145
- ├── 04_OBSERVER_REPORT.md ← تقرير العين (مراقب متزامن)
146
- ├── 05_AUDIT_DECISION.md ← قرار القاضي (PASS/CONDITIONAL/FAIL/INCOMPLETE)
147
- ├── 06_RETEST_RECORD.md ← سجل إعادة الاختبار بعد الإصلاحات
162
+ ├── 03_FINDINGS.md ← Findings بالتصنيف الثلاثي (الشبح)
163
+ ├── MATRIX_ASVS_L2.md ← مصفوفة تغطية ASVS 5.0 L2 (إلزامية)
164
+ ├── MATRIX_WSTG.md ← مصفوفة تغطية WSTG (إلزامية)
165
+ ├── MATRIX_API_TOP10.md ← مصفوفة تغطية API Top 10 (إلزامية)
166
+ ├── EVIDENCE_MANIFEST.md ← بيان الأدلة: SHA256 لكل ملف + Freeze (لا تعديل بعدها)
167
+ ├── 04_OBSERVER_REPORT.md ← تقرير العين (مراقب متزامن + Runtime Surface B)
168
+ ├── 05_AUDIT_DECISION.md ← قرار القاضي + Surface Reconciliation (A∪B∪C)
169
+ ├── 06_RETEST_RECORD.md ← سجل إعادة الاختبار (Track A + Track B)
148
170
  ├── defense-handoff.md ← ملف الدفاع (الدرع → للشبح في White Box)
149
171
  ├── fix-review.md ← مراجعة الإصلاحات (الدرع)
150
- └── evidence/
151
- └── {TEST-ID}/
152
- ├── metadata.md ← الإصدار/البيئة/الوقت/الأداة/الدور/النتيجة
153
- ├── request.txt ← الطلب الفعلي (منقح)
154
- ├── response.txt ← الاستجابة الفعلية (منقحة)
155
- ├── screenshot.png ← عند الحاجة
156
- └── tool-output.txt ← مخرجات الأداة
172
+ ├── evidence/ ← أدلة مجمّدة (لا تُعدّل بعد الـ Freeze)
173
+ │ └── {TEST-ID}/
174
+ │ ├── metadata.md ← إلزامي: Test ID/الهدف/الوقت UTC/الأداة/الدور/النتيجة/Finding
175
+ │ ├── request.txt ← إلزامي: الطلب الفعلي (منقح)
176
+ │ ├── response.txt ← إلزامي: الاستجابة الفعلية (منقحة)
177
+ │ ├── screenshot.png ← عند الحاجة (حالات UI)
178
+ │ └── tool-output.txt ← عند استخدام أداة (إلزامي وقتها)
179
+ └── evidence-addendum/ ← الإضافات بعد التجميد (لا تعديل للأصل)
157
180
  ```
158
181
 
182
+ > **قاعدة إعادة البناء:** يستطيع القاضي إعادة بناء استنتاج الشبح من ملفات الأدلة وحدها — دون سؤال الشبح.
183
+ > **قاعدة نزاهة الأدلة:** بعد `Evidence Freeze` في `EVIDENCE_MANIFEST.md`، أي تعديل للأدلة الأصلية يُبطلها — الإضافات في `evidence-addendum/` فقط.
184
+ > **قاعدة نزاهة الهدف:** `SECURITY_TARGET_SNAPSHOT.md` — إذا تغيّر Commit/Tree/Runtime أثناء الجولة → الجولة INVALID.
185
+
159
186
  ---
160
187
 
161
188
  ## 8. قواعدنا الحاكمة (غير قابلة للتفاوض)
@@ -165,10 +192,19 @@ security-reports/
165
192
  3. **الأسرار تُنقّح** — `[REDACTED]` بدل أي قيمة حقيقية.
166
193
  4. **فصل الأدوار ملزم** — من هاجم لا يدقق، من راقب لا يحكم.
167
194
  5. **قرار التسليم** — بيد القاضي وحده، بعد الجولة الكاملة.
168
- 6. **Critical/High مفتوحة = لا تسليم.**
195
+ 6. **Critical/High مفتوحة (بسلسلة استغلال) = لا تسليم.**
169
196
  7. **لا توسيع للأثر** — نوقف عند إثبات كافٍ، لا نستمر في التخريب.
170
197
  8. **بيئة معزولة** — بيانات وهمية فقط، ممنوع البيانات الحقيقية.
171
198
  9. **التوثيق الكامل** — كل نتيجة موثقة بأدلتها في نفس الجولة.
199
+ 10. **Evidence Pack إلزامي** — كل استغلال ناجح: metadata + request + response (+ tool-output + screenshot عند الحاجة). بلا Pack = Finding مرفوض/غير مثبت.
200
+ 11. **قاعدة إعادة البناء** — القاضي يعيد بناء الاستنتاج من الأدلة وحدها.
201
+ 12. **مصفوفات التغطية إلزامية** — ASVS L2 + WSTG + API Top 10 لكل جولة، بلا N/A بلا سبب خاص بالتطبيق.
202
+ 13. **التصنيف الثلاثي** — Technical Severity / Business Impact / Exploit Chain Severity. البوابة تعتمد على السلسلة — لا تضخيم تقني.
203
+ 14. **عزل Black Box إلزامي** — Phase A بلا وصول لكود المصدر (تقنياً وليس نصياً فقط). أي اكتشاف تطلب معرفة الكود أثناء Black Box غير صالح.
204
+ 15. **نزاهة الهدف** — `SECURITY_TARGET_SNAPSHOT.md` قبل/بعد الجولة. تغيّر Commit/Tree/Runtime أثناء الجولة = الجولة INVALID.
205
+ 16. **نزاهة الأدلة** — `EVIDENCE_MANIFEST.md` (SHA256 + Freeze). بعد التجميد: لا تعديل للأدلة الأصلية — الإضافات في `evidence-addendum/` فقط.
206
+ 17. **Surface Reconciliation** — القاضي يبني A∪B∪C (مكتشف الشبح + Runtime + Source) — لا يثق بسطح الهجوم وحده.
207
+ 18. **فصل كتابة صارم** — الشبح لا يكتب `observer/` أو `audit/`؛ العين لا تكتب إلا `observer/`؛ القاضي لا يكتب إلا `audit/`.
172
208
 
173
209
  ---
174
210
 
@@ -179,6 +215,7 @@ security-reports/
179
215
 
180
216
  | Round ID | التطبيق | التاريخ | النوع | قرار القاضي | Critical/High |
181
217
  |---|---|---|---|---|---|
218
+ | SEC-ROUND-2026-09-03-001 | BlogCraft LAB | 2026-09-03 | Round 0 — LAB (تدريب) | **FAIL** | 12 Critical / 3 High (18 إجمالاً) |
182
219
  | *(تُضاف بعد كل جولة)* | | | | | |
183
220
 
184
221
  ---
@@ -191,6 +228,9 @@ security-reports/
191
228
  | 2026-09-02 | **النشر للحزم** — core 0.2.12 + pro 0.2.17 على npm + bundle v0.2.16 على teranoo.com |
192
229
  | 2026-09-02 | **استكشاف أول** — فحص BlogCraft LAB: تأكيد 7 ثغرات (env leak, data exposure, SQLi, BFLA, BOLA, JWT storage, JWT forge→admin) |
193
230
  | 2026-09-03 | **الميثاق** — توثيق رسمي للفريق + نسخة الجوهر المُوزَّعة (هذا الملف) |
231
+ | 2026-09-03 | **الجولة الأولى** — SEC-ROUND-2026-09-03-001 على BlogCraft LAB: 18 Finding (12 Critical) — قرار القاضي FAIL (متوقع لجولة LAB) |
232
+ | 2026-09-03 | **ترقية الفريق (SCP-2026-09-03-004)** — بعد تقييم Majed: Evidence Pack إلزامي + قاعدة إعادة البناء، مصفوفات تغطية ASVS/WSTG/API، بروتوكول Discovery Rounds، دور Blue Team للعين (Detection Engineering)، تصنيف ثلاثي (Technical/Business/Exploit Chain) |
233
+ | 2026-09-03 | **ترقية النزاهة (SCP-2026-09-03-005)** — بعد مراجعة خبير خارجي: (1) عزل Black Box تقني، (2) SECURITY_TARGET_SNAPSHOT (نزاهة الإصدار)، (3) EVIDENCE_MANIFEST (SHA256 + Freeze)، (4) Surface Reconciliation (A∪B∪C)، (5) فصل كتابة صارم، (6) Retest ثنائي المسار (Track A + Track B Clean-Room) |
194
234
 
195
235
  ---
196
236
 
@@ -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. | عند الحاجة لجدولة مواعيد أو إرسال اتصالات آلية. |