@tera-system/core 0.6.0 → 0.7.0

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 (43) hide show
  1. package/MANIFEST.json +8 -8
  2. package/RELEASES.md +28 -0
  3. package/agents/auditor.md +3 -3
  4. package/agents/engineering-agent-dotnet.md +30 -4
  5. package/agents/engineering-agent-flutter.md +5 -5
  6. package/agents/engineering-agent-typescript.md +70 -38
  7. package/agents/engineering-agent.md +12 -72
  8. package/agents/security-agent.md +200 -0
  9. package/agents/security-observer.md +2 -2
  10. package/agents/tera-client-engagement.md +1 -1
  11. package/agents/tera-software-designer.md +88 -54
  12. package/agents/tera-system-evolution.md +7 -7
  13. package/agents/tera.md +36 -6
  14. package/agents/ui-designer.md +1 -1
  15. package/assets/structurizr-mcp/pyproject.toml +1 -1
  16. package/assets/structurizr-mcp/uv.lock +816 -770
  17. package/commands/tera-orient-shield.md +14 -0
  18. package/commands/tera-orient-software-designer.md +1 -1
  19. package/commands/tera-orient-tera.md +1 -1
  20. package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +4 -2
  21. package/core/tera-system/AGENT_DEPENDENCY_MAP.md +2 -1
  22. package/core/tera-system/AGENT_PERMISSION_MODEL.md +4 -4
  23. package/core/tera-system/SECURITY_TEAM_CHARTER.md +1 -1
  24. package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +7 -4
  25. package/core/tera-system/TeraArchitectureMap.md +2 -2
  26. package/core/tera-system/TeraCapabilityMap.md +2 -2
  27. package/core/tera-system/TeraHelperAgents.md +1 -0
  28. package/core/tera-system/TeraPolicyMap.md +2 -2
  29. package/core/tera-system/TeraPreExecutionGate.md +18 -5
  30. package/core/tera-system/TeraSubAgents.md +14 -11
  31. package/core/tera-system/design-system/DESIGN_REVIEW_STANDARDS.md +2 -0
  32. package/core/tera-system/engineering-helpers/engineering-agent-core.md +19 -13
  33. package/core/tera-system/profiles/PROFILES_INDEX.md +3 -1
  34. package/core/tera-system/profiles/dotnet-razorpages-adonet.md +44 -43
  35. package/core/tera-system/profiles/dotnet-wpf-sqlite.md +17 -17
  36. package/core/tera-system/profiles/flutter-mobile.md +2 -2
  37. package/core/tera-system/profiles/rust.md +7 -6
  38. package/core/tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md +1 -0
  39. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +2 -0
  40. package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES.md +14 -0
  41. package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md +1 -0
  42. package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_PREPARATION.md +1 -1
  43. package/package.json +2 -2
@@ -0,0 +1,14 @@
1
+ ---
2
+ description: تهيئة الدرع (Security Agent) ذاتياً قبل أول مراجعة دفاعية في الجلسة
3
+ agent: security-agent
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/security-agent.md`. ركّز إضافياً على: دورك الدفاعي (مراجعة الصلاحيات/الجلسات/الأسرار/المصادقة/الوسيط/الإعدادات)، وتحضير `defense-handoff.md` قبل جولة Red Team، ومراجعة الإصلاحات (`fix-review.md`) بعدها.
9
+
10
+ اقرأ مصادرك المرجعية: `tera-system/TeraHelperAgents.md` §6.1 (تعريف الدور)، `04_USERS_ROLES_PERMISSIONS.md`، `08_TECHNICAL_ARCHITECTURE.md`، `15_SECURITY_AND_ACCESS_CONTROL.md`، `20_API_CONTRACTS.md`، وملف المهمة `project-control/tasks/[TASK-ID].md`.
11
+
12
+ حدودك: لا تهاجم (الشبح)، لا تكتب كوداً، لا تصدر قرار البوابة (القاضي)، ولا تختبر ما قرأت أسراره. اكتب فقط تحت `security-reports/`.
13
+
14
+ لا تبدأ أي مراجعة قبل إكمال الدراسة وإعلان الجاهزية لـ Tera (Readiness Declaration).
@@ -5,7 +5,7 @@ agent: tera-software-designer
5
5
 
6
6
  طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
7
 
8
- ملفك التشغيلي: `.opencode/agents/tera-software-designer.md`. ركّز إضافياً على: دورك في التصميم المعماري وإنتاج Stubs هيكلية، وعلاقتك بالمهام المؤثرة (impactive tasks)، وحدودك (لا تنفيذ كود كامل).
8
+ ملفك التشغيلي: `.opencode/agents/tera-software-designer.md`. ركّز إضافياً على: دورك في إعداد **المواصفة التقنية** (`TECHNICAL_SPECIFICATION.md`) للمهام ذات محفّز الأثر، وعلاقتك بالمهام المؤثرة (impactive tasks)، وحدودك (لا كود تنفيذي — pseudocode/interface signatures غير تنفيذية فقط داخل المواصفة عند الحاجة).
9
9
 
10
10
  اقرأ مصادرك المرجعية: `project-preparation/*.md` (مخططات الحل وقواعد التصميم التنفيذية مثل 28_UI_UX_GUIDELINES.md)، `project-control/PROJECT_RULES.md` إن وُجد (قواعد المشروع).
11
11
 
@@ -7,6 +7,6 @@ agent: tera
7
7
 
8
8
  ملفك التشغيلي: `.opencode/agents/tera.md`. ركّز إضافياً على: Orchestration Decision Matrix، بوابات Pre-Execution/Post-Execution، مالك التفعيل (Phases 1–4 لمُهندس / 5–7 لك)، وبروتوكول التفويض في `TERA_RUNTIME_PROTOCOLS_CORE.md` §4.
9
9
 
10
- اقرأ مصادرك المرجعية: `tera-system/runtime/TERA_RUNTIME_*.md` (البروتوكولات والقوائم والقوالب)، `project-control/` (حالة المشروع والسجلات الحاكمة)، و`tera-system/ENGINEERING_HANDOFF_PACKAGE.md` (حزمة التسليم).
10
+ اقرأ مصادرك المرجعية: `tera-system/runtime/TERA_RUNTIME_*.md` (البروتوكولات والقوائم والقوالب)، و`project-control/` (حالة المشروع والسجلات الحاكمة + `ENGINEERING_HANDOFF_PACKAGE.md` داخل **مشروع التطبيق النشط**).
11
11
 
12
12
  لا تبدأ أي تفويض أو عمل قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -54,7 +54,7 @@
54
54
  | engineering-agent-flutter | `ENGINEERING_AGENT_FLUTTER` | `PHASE_GATE`: مهمة Flutter/Dart mobile client مع `Pre-Execution Gate: PASS` | 6 | لا لمهام Backend (django). لا لتصميم بصري (ui-designer) | ملفات معتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` + Active `flutter-mobile` Profile |
55
55
  | engineering-agent-django | `ENGINEERING_AGENT_DJANGO` | `PHASE_GATE`: مهمة Python/Django/DRF backend مع `Pre-Execution Gate: PASS` | 6 | لا لمهام Flutter (flutter). لا صلاحيات مالية بلا بوابة أمنية | ملفات معتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` + Active `python-django` Profile |
56
56
  | ui-designer | `UI_VISUAL_DESIGNER_AGENT` | `COMPLEXITY_SIGNAL`: وجود Frontend مهم أو مصدر تصميم (Figma, getdesign.md, screenshots) | 4–5 | API-only أو UI بسيط بدون متطلبات بصرية | `07_SCREENS_AND_UI_STRUCTURE.md` + مصدر التصميم |
57
- | tera-software-designer | `SOFTWARE_DESIGNER_AGENT` | `COMPLEXITY_SIGNAL`: مهمة متعددة العملاء، أو تتجاوز 3 ملفات، أو تحمل مخاطر، أو تحتاج Technical Specification | 5–6 | مهمة بسيطة يمكن لـ Tera تجهيز Technical Specification مباشرة | ملفات التحليل المعتمدة + `TECHNICAL_SPECIFICATION.md` |
57
+ | tera-software-designer | `SOFTWARE_DESIGNER_AGENT` | `IMPACT_SIGNAL`: أي محفّز أثر (DB/migration · auth/permissions/security · API عام · cross-module · مالي · مخزون · protocol/crypto · تغيير توافق · state machine معقّد · حدود معمارية) → **`SDA_REQUIRED` إلزامي** — **Impact يتجاوز Complexity**. `FAST_PATH` فقط بشروط الأمان الكاملة + سبب مكتوب | 5–6 | `NOT_APPLICABLE` (وثائقي/تشغيلي بحت) أو `FAST_PATH` مستوفٍ | `ENGINEERING_HANDOFF_PACKAGE.md` + ملف الـDraft Task + الملفات التحضيرية **المُطبَّقة على المهمة** (لا قائمة ثابتة) |
58
58
  | qa-agent | `QA_ACCEPTANCE_AGENT` | **Planning:** `PHASE_GATE` + `DOCUMENT_READY`. **Execution:** `DOCUMENT_READY` بعد تنفيذ `TASK-COD-*` يحتاج تحقق فعلي. **كلا الوضعين:** قبل Phase 7 | 5–6–7 | مهمة بسيطة واضحة / لا تحتاج اختبار CLI | `10_TESTING_AND_ACCEPTANCE.md` أو ملف `TASK-COD-*` المنفذ + معايير القبول |
59
59
  | auditor | `AUDITOR` | `TASK_COMPLETED` + `RISK_SIGNAL` / `QUALITY_SIGNAL` / `REVIEW_NEEDED`؛ ويستدعيه Monitor فقط بطلب Majed؛ وفي Phases 1–4: `PHASE_GATE` — **مراجعة اتساق تحضير (كل دفعة)** بطلب مُهندس (SCP-2026-09-24-006) | 6 (و 1–4 لوضع Preparation-Review) | مهمة وثائقية صغيرة وقرار Tera `AUDITOR_REVIEW_NOT_REQUIRED` مع سبب | ملف المهمة + Handback + diff/changed files + QA/Security evidence؛ أو دفعة مستندات تحضير + upstream + template |
60
60
  | design-reviewer | `DESIGN_REVIEWER` | `PHASE_GATE`: بعد إنتاج TASK-PROTO-* الأول؛ و`REVIEW_NEEDED` للواجهات المنفذة | 5–6 | لا واجهات/بروتوتايب (API-only) أو `WAIVED_BY_MAJED` | `project-control/prototypes/` + مصدر التصميم + `07_SCREENS_AND_UI_STRUCTURE.md` |
@@ -70,6 +70,7 @@
70
70
  | red-team-agent (الشبح) | `RED_TEAM_AGENT` | `PHASE_7_GATE`: بوابة الأمن قبل التسليم — أو `USER_REQUEST` من Majed | 7 (أو بطلب Majed) | لا يُفعّل تلقائياً في Phases 1–6؛ لا على Production بلا تفويض مكتوب | `00_AUTHORIZATION.md` + URL/البيئة + Commit SHA + الحدود |
71
71
  | security-observer (العين) | `SECURITY_OBSERVER` | `PHASE_7_GATE`: بالتزامن مع تفعيل Red Team | 7 (بالتزامن) | لا يُفعّل وحده بلا جولة | Round ID + سجلات التطبيق + Canary baseline + Test IDs |
72
72
  | security-auditor (القاضي) | `SECURITY_AUDITOR` | `PHASE_7_GATE`: بعد اكتمال Red Team + Observer + Fixes + Retest | 7 (بعد الجولة) | لا يُفعّل قبل اكتمال الأدلة؛ لا PASS مع Critical/High مفتوحة | تقرير الشبح + تقرير العين + الأدلة + المصفوفات + سجلات الإصلاح |
73
+ | security-agent (الدرع) | `SECURITY_AGENT` | `RISK_SIGNAL`: بيانات حساسة · Auth · صلاحيات · مدفوعات · أسرار · Middleware/Config — يستدعيه Tera فقط | 5–6–7 | لا سطح حساس (Auth/صلاحيات/أسرار) · أو عند طلب جولة كاملة (الشبح) أو قرار البوابة (القاضي) | `04_USERS_ROLES_PERMISSIONS.md` + `08_TECHNICAL_ARCHITECTURE.md` + `15_SECURITY_AND_ACCESS_CONTROL.md` + ملف المهمة/diff |
73
74
 
74
75
  ### 2.2 الأدوار التحضيرية (Preparation Roles — يملكها application-blueprint)
75
76
 
@@ -87,9 +88,10 @@
87
88
 
88
89
  ### 2.3 العملاء المشروطون (Helper Agents — مُولَّدون عند الحاجة)
89
90
 
91
+ > **الدرع لم يعد مساعداً مُولَّداً:** أصبح عميلاً ثابتاً بملف تنفيذي `.opencode/agents/security-agent.md` — صفّه في §2.1 (SCP-2026-10-03-002).
92
+
90
93
  | العميل | المعرف | Trigger التفعيل | المرحلة | متى لا يُفعّل | الحد الأدنى من المدخلات |
91
94
  |---|---|---|---|---|---|
92
- | SecurityAgent (الدرع) | `SECURITY_AGENT` | `RISK_SIGNAL`: بيانات حساسة، Auth، صلاحيات، مدفوعات، أسرار | 5–6–7 | لا بيانات حساسة أو صلاحيات | `04_USERS_ROLES_PERMISSIONS.md` + `08_TECHNICAL_ARCHITECTURE.md` |
93
95
  | IntegrationAgent | `INTEGRATION_AGENT` | `EXTERNAL_FACTOR`: API خارجي، بوابة دفع، Webhooks | 5–6 | لا تكاملات خارجية | `14_INTEGRATIONS_AND_EXTERNAL_SERVICES.md` |
94
96
  | DevOpsDeploymentAgent | `DEVOPS_DEPLOYMENT_AGENT` | `EXTERNAL_FACTOR / USER_REQUEST`: نشر فعلي، CI/CD، Docker | 6–7 | بيئة محلية فقط | `22_DEPLOYMENT_AND_ENVIRONMENTS.md` |
95
97
  | PerformanceAgent | `PERFORMANCE_AGENT` | `COMPLEXITY_SIGNAL`: حجم بيانات كبير، SLA | 5–6 | مشروع صغير | `06_DATA_MODEL_PREPARATION.md` + `32_PERFORMANCE_REQUIREMENTS.md` |
@@ -31,13 +31,14 @@
31
31
  | **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 المحددة |
32
32
  | **tera-system-evolution.md** | — (مستقل — يستدعيه Majed) | `ui-designer.md`, `domain-research-agent.md`, `domain-expert-agent.md` (للأغراض النظامية) | `tera-system/*.md`, `.opencode/agents/*.md` |
33
33
  | **tera-strategic-advisor.md** | — (مستقل — يستدعيه Majed فقط) | لا يستدعي عملاء ولا يديرهم؛ قد يوصي Majed بالرجوع إلى TeraAgent أو حارس أو غيرهم | ملفات وسياقات القرار فقط، مصادر خارجية عند الحاجة |
34
- | **auditor.md** | `tera.md`؛ و`monitor.md` فقط عند طلب Majed؛ و`application-blueprint.md` (مراجعة تحضير فقط — وضع Preparation-Review، كل دفعة، Phases 1–4 — SCP-2026-09-24-006) | يراجع مخرجات `tera.md`, `engineering-agent.md`؛ يحيل findings إلى `SecurityAgent`, `DesignReviewer`, `qa-agent`, أو `ProjectControlAgent` عبر الوكيل المستدعي | `project-control/*.md`, `project-control/audit-reports/`, `tera-system/engineering-governance/*.md`, الملفات المعدلة؛ أو دفعة مستندات التحضير + upstream + template |
34
+ | **auditor.md** | `tera.md`؛ و`monitor.md` فقط عند طلب Majed؛ و`application-blueprint.md` (مراجعة تحضير فقط — وضع Preparation-Review، كل دفعة، Phases 1–4 — SCP-2026-09-24-006) | يراجع مخرجات `tera.md`, `engineering-agent.md`؛ يحيل findings إلى `SecurityAgent` (`security-agent.md`), `DesignReviewer`, `qa-agent`, أو `ProjectControlAgent` عبر الوكيل المستدعي | `project-control/*.md`, `project-control/audit-reports/`, `tera-system/engineering-governance/*.md`, الملفات المعدلة؛ أو دفعة مستندات التحضير + upstream + template |
35
35
  | **monitor.md** | — (مستقل — يستدعيه Majed) | يراجع مخرجات `tera.md`, `engineering-agent.md`; قد يستدعي `auditor.md` فقط عندما يطلب Majed تحدي/تحقق جودة مستقل | `project-control/*.md`, `tera-system/*.md` |
36
36
  | **qa-agent.md** (الاسم المنطقي: qa-agent) | `tera.md` (يُفعّله Tera) | لا يستدعي عملاء آخرين | ملفات التحضير، ملفات المهمة، logs، مخرجات CLI، `project-control/test-reports/` |
37
37
  | **project-knowledge-agent.md** | `tera.md` (بعد مهمة مؤثرة — TASK_COMPLETED) | — | `project-knowledge/` داخل التطبيق، ملف المهمة المؤثرة |
38
38
  | **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` |
39
39
  | **security-observer.md** 🆕 (العين — SCP-2026-09-02-001) | `tera.md` (بالتزامن مع Red Team)؛ Majed مباشرة | يراقب أثر `red-team-agent.md` (الشبح) — لا يهاجم ولا يصلح | `security-reports/[ROUND-ID]/`, سجلات التطبيق والموارد، تقرير الشبح |
40
40
  | **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, تقارير الشبح والعين |
41
+ | **security-agent.md** 🆕 (الدرع — SCP-2026-10-03-002) | `tera.md` (`RISK_SIGNAL` — Phases 5–7)؛ Majed مباشرة | `red-team-agent.md` (يسلّم له `defense-handoff.md` عبر Tera) · `security-auditor.md` (يستهلك `fix-review.md` كدليل) · `auditor.md` (يحيل إليه التحليل الأمني العميق) | `tera-system/TeraHelperAgents.md` §6.1, `04_USERS_ROLES_PERMISSIONS.md`, `08_TECHNICAL_ARCHITECTURE.md`, `15_SECURITY_AND_ACCESS_CONTROL.md`, `20_API_CONTRACTS.md`, `security-reports/[ROUND-ID]/` |
41
42
  | **tera-business-transformation-consultant.md** | — (مستقل — يُستدعى من TCEA عبر Majed عند Track C) | `domain-research-agent.md`, `domain-expert-agent.md` (للبحث عن معايير الصناعة وأفضل الممارسات) | `tera-system/consulting-helpers/BTCA_METHODOLOGY_FRAMEWORK.md`, `BTCA_REPORT_TEMPLATES.md` |
42
43
 
43
44
  ---
@@ -115,7 +115,7 @@
115
115
  | تشغيل اختبارات | ❌ ممنوع |
116
116
  | إنشاء ملفات جديدة | ✅ ضمن `Allowed Write Targets` فقط |
117
117
 
118
- **متى يستخدم:** للعملاء الذين ينتجون توثيقًا أو تصميمًا أو تحضيرًا، مثل ui-designer (Design Tokens) وعملاء توثيق التسليم (عبر tera.md).
118
+ **متى يستخدم:** للعملاء الذين ينتجون **توثيقًا/تحضيرًا بلا كود** — مثل `application-blueprint` (ملفات التحضير) وعملاء توثيق التسليم (عبر tera.md). **لا يشمل `ui-designer`** (يكتب كود واجهة عرضية → `WRITE_CODE`) — SCP-2026-09-29-012.
119
119
 
120
120
  ---
121
121
 
@@ -185,7 +185,7 @@
185
185
  | تعديل project-control | ❌ ممنوع |
186
186
  | DEPLOY / النشر | ❌ ممنوع — النشر ملك `DevOpsDeploymentAgent` فقط (فصل المهام). لا يُرفع EngineeringAgent إلى `DEPLOY_WITH_APPROVAL` (SCP-2026-09-24-001) |
187
187
 
188
- **متى يستخدم:** لـ EngineeringAgent وأي عميل تنفيذي.
188
+ **متى يستخدم:** لـ EngineeringAgent وأي عميل تنفيذي **يكتب كوداً** — بما فيه `ui-designer` (نطاق محدود: مكوّنات عرضية/واجهة فقط — SCP-2026-09-29-012).
189
189
 
190
190
  ---
191
191
 
@@ -234,7 +234,7 @@
234
234
  | engineering-agent-dotnet | `ENGINEERING_AGENT_DOTNET` | `WRITE_CODE` | — | كود .NET/C# |
235
235
  | engineering-agent-flutter | `ENGINEERING_AGENT_FLUTTER` | `WRITE_CODE` | — | كود Flutter/Dart (عميل موبايل) — SCP-2026-09-23-006 |
236
236
  | engineering-agent-django | `ENGINEERING_AGENT_DJANGO` | `WRITE_CODE` | — | كود Python/Django/DRF (خادم) — SCP-2026-09-23-006 |
237
- | ui-designer | `UI_VISUAL_DESIGNER_AGENT` | `WRITE_DOCS` | إلى READ_ONLY إذا كان مراجعة فقط | يكتب Design Tokens / Component Rules / Layout Rules داخل `28_UI_UX_GUIDELINES.md` |
237
+ | ui-designer | `UI_VISUAL_DESIGNER_AGENT` | `WRITE_CODE` | إلى READ_ONLY إذا كان مراجعة فقط | **نطاق محدود:** مكوّنات عرضية/واجهة (TSX/CSS/Tailwind) + Design Tokens / UI Spec — **لا** منطق وظيفي (hooks/state/API) ولا backend. الاستثناء الوثائقي: ملف UI/UX Guidelines (`28_UI_UX_GUIDELINES.md`) ضمن Allowed Write Targets (SCP-2026-09-29-012) |
238
238
  | tera-software-designer | `SOFTWARE_DESIGNER_AGENT` | `WRITE_DOCS` | إلى `PLAN_ONLY` إذا ما زالت الخطة غير ناضجة | يجهز Technical Specification للمهام فقط |
239
239
  | qa-agent | `QA_ACCEPTANCE_AGENT` | `RUN_TESTS` | إلى READ_ONLY إذا كان مراجعة فقط | **Planning Mode:** `WRITE_DOCS` — خطط الاختبار ومعايير القبول. **Execution Mode:** `RUN_TESTS` + bash — تشغيل CLI + تقارير اختبار رسمية |
240
240
  | auditor | `AUDITOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند كتابة تقرير التدقيق | تدقيق Diff-first بعد التنفيذ؛ لا يعدّل كوداً. + وضع `Preparation-Review` (قراءة فقط · تقرير) بطلب مُهندس — SCP-2026-09-24-006 |
@@ -251,6 +251,7 @@
251
251
  | red-team-agent (الشبح) | `RED_TEAM_AGENT` | `EXECUTE_ATTACKS` (ضمن تفويض مكتوب) + `WRITE_EVIDENCE` في security-reports فقط | لا يُرفع — التفويض يحدد النطاق لا الصلاحية | يهاجم فقط ما فُوّض له؛ لا يكتب كوداً؛ لا يصلح أثناء الجولة (SCP-2026-09-02-001) |
252
252
  | security-observer (العين) | `SECURITY_OBSERVER` | `READ_ONLY` | إلى `WRITE_DOCS` عند تقرير المراقب في security-reports/observer | يراقب فقط — لا يهاجم، لا يصلح، لا يحكم (SCP-2026-09-02-001) |
253
253
  | security-auditor (القاضي) | `SECURITY_AUDITOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند تقرير التدقيق + قرار البوابة في security-reports/audit | يدقق فقط — لا يهاجم، لا يصلح، لا يثق بلا دليل (SCP-2026-09-02-001) |
254
+ | security-agent (الدرع) | `SECURITY_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند توثيق findings + `defense-handoff.md` و`fix-review.md` في security-reports | مراجعة دفاعية أثناء التطوير + مراجعة الإصلاحات — لا يهاجم، لا يكتب كوداً، لا يصدر قرار البوابة (SCP-2026-10-03-002) |
254
255
 
255
256
  ### 3.2 العملاء المشروطون (Helper Agents + Preparation Roles)
256
257
 
@@ -258,7 +259,6 @@
258
259
 
259
260
  | العميل | المعرف | الصلاحية الافتراضية | هل يمكن رفعها؟ | ملاحظة |
260
261
  |---|---|---|---|---|
261
- | SecurityAgent (الدرع) | `SECURITY_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند توثيق findings + كتابة `defense-handoff.md` و`fix-review.md` في security-reports | لا يكتب كودًا أبدًا. دفاعي فقط — لا ينفذ هجمات (SCP-2026-09-02-001) |
262
262
  | IntegrationAgent | `INTEGRATION_AGENT` | `WRITE_DOCS` | إلى `WRITE_CODE` لتعديل كود التكامل فقط إذا فوضه Tera صراحة | يوثق التكاملات |
263
263
  | DevOpsDeploymentAgent | `DEVOPS_DEPLOYMENT_AGENT` | `WRITE_CODE` | إلى `DEPLOY_WITH_APPROVAL` عند النشر | يتطلب موافقة لكل نشر |
264
264
  | PerformanceAgent | `PERFORMANCE_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند توثيق التوصيات | يحلل فقط |
@@ -241,7 +241,7 @@ security-reports/
241
241
  | `security-reports/SECURITY_TEAM_CHARTER.md` | الميثاق الكامل (المصدر التفصيلي) |
242
242
  | `security-reports/SECURITY_GATE_LOG.md` | سجل الجولات والنتائج |
243
243
  | `tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md` | بوابة الأمن Phase 7 |
244
- | `.opencode/agents/red-team-agent.md` + `security-observer.md` + `security-auditor.md` | عملاء الفريق |
244
+ | `.opencode/agents/red-team-agent.md` + `security-observer.md` + `security-auditor.md` + `security-agent.md` | عملاء الفريق |
245
245
  | `tera-system/AGENT_ACTIVATION_MATRIX.md` | تفعيل عملاء الفريق (Phase 7 أو طلب Majed) |
246
246
  | `tera-system/TOOLING_AND_MCP_POLICY.md` | السياسة الحاكمة للأدوات |
247
247
 
@@ -64,8 +64,8 @@ Release Package (ملفات Tera-managed + SHA256SUMS + TERA_RELEASE_MANIFEST.js
64
64
 
65
65
  | الحزمة | الاسم (npm) | الإصدار الحالي | الوصف | الملفات الموزعة ضمن الحزمة |
66
66
  |---|---|---|---|---|
67
- | core | `@tera-system/core` | 0.4.0 | OpenCode Plugin — core governance (25 agents, 38 commands, distribution tools, security team) | `agents/`, `commands/`, `core/`, `assets/`, `tools/`, `scripts/` |
68
- | pro | `@tera-system/pro` | 0.2.26 | Commercial edition — signed bundle + license gate + heartbeat | `scripts/`, `core/project-control`, `MANIFEST.json`, `opencode.tera.example.json`, `WELCOME.md`, `README.md` |
67
+ | core | `@tera-system/core` | 0.6.0 | OpenCode Plugin — core governance (26 agents, 39 commands, distribution tools, security team) | `agents/`, `commands/`, `core/`, `assets/`, `tools/`, `scripts/` |
68
+ | pro | `@tera-system/pro` | 0.2.29 | Commercial edition — signed bundle + license gate + heartbeat | `scripts/`, `core/project-control`, `MANIFEST.json`, `opencode.tera.example.json`, `WELCOME.md`, `README.md` |
69
69
 
70
70
  **مستودع الحزم:** `https://github.com/Alabasi1980/Teranoo-System` — حزمتا npm + الـ bundle الموقّع (بناء ونشر فقط؛ لا محتوى يدوي).
71
71
  **المستودع الرسمي (`RepositoryUrl`):** `https://github.com/Alabasi1980/Teranoo-System-Core` — المصدر الوحيد المعتمد لـ `tera-fetch.ps1` و `tera-schedule.ps1` و `tera-update.ps1` (D1 — SCP-2026-09-23-002)
@@ -309,9 +309,12 @@ pwsh .\tools\update-client-repositories.ps1 -Version tera-v2.5.0 -Channel stable
309
309
  |---|---|---|---|
310
310
  | `tera-v1.0.0` | 2026-08-15 | stable | أول إصدار رسمي موثق: آلية توزيع كاملة (release/fetch/update/batch)، تنظيف شامل، وإصلاحات Pilot (gitattributes، commit detection) |
311
311
  | `tera-v0.3.1` | 2026-09-18 | stable | Technology Profile `bun-ts-monorepo-sqlite` — Tag على مستودع المصدر `Teranoo-System-Core` (SCP-2026-09-18-001) [Verified] |
312
- | *(npm)* core `0.4.0` / pro `0.2.26` | 2026-09-21 | stable | أوامر التهيئة الذاتية + معالجة الفجوات (SCP-2026-09-21-001/002) [Verified: packages RELEASES + npm view] |
312
+ | *(npm)* core `0.4.0` / pro `0.2.26` | 2026-09-21 | stable | أوامر التهيئة الذاتية + معالجة الفجوات (SCP-2026-09-21-001/002) [Verified] |
313
+ | *(npm)* core `0.4.1` / pro `0.2.27` | 2026-09-23 | stable | مصالحة التوزيع + مزامنة الأصول + وسم `tera-v0.4.1` (SCP-2026-09-23-002/003) [Verified] |
314
+ | *(npm)* core `0.5.0` / pro `0.2.28` | 2026-09-24 | stable | وكيلا Flutter/Django + بروفايل `python-django` (SCP-2026-09-23-006) [Verified: packages RELEASES] |
315
+ | *(npm)* core `0.6.0` / pro `0.2.29` | 2026-09-26 | stable | تقوية الحوكمة/التشغيل + بروتوكولات جديدة (SCP-2026-09-24-001..006) [Verified: npm view + bundle v0.2.29] |
313
316
 
314
- > **الحالة الحالية (2026-09-23):** آخر إصدار منشور على npm = `@tera-system/core 0.4.0` + `@tera-system/pro 0.2.26` [Verified: `npm view`]. آخر Git Tag = `tera-v0.3.1` على `Teranoo-System-Core`. تقليد الترقيم (رقم core مقابل رقم pro) قيد الحسم — SCP-2026-09-23-001.
317
+ > **الحالة الحالية (2026-09-29):** آخر إصدار منشور = `@tera-system/core 0.6.0` + `@tera-system/pro 0.2.29` [Verified: `npm view`]؛ الـbundle المخدوم على `teranoo.com` = 0.2.29 (248 ملفاً) [Verified]. **آخر Git Tag على المصدر = `tera-v0.4.1` — وسم `tera-v0.5.0`/`tera-v0.6.0` مفقود (قرار معلّق؛ يمسّ قناة `tera-fetch`/`tera-update`).**
315
318
 
316
319
  ---
317
320
 
@@ -26,8 +26,8 @@ It is a map, not a policy source. Rules remain in the files listed in `TeraPolic
26
26
  | Sub-agent lifecycle | Defines, generates, narrows, activates, and reviews specialized agents | `TeraSubAgents.md`, `AGENT_GENERATION_TEMPLATE.md`, `generated-agents/` |
27
27
  | Delivery, handoff, and closure | Produces final delivery readiness, release notes, client handover material, acceptance records, and closure reports | `project-control/DELIVERY_READINESS_REPORT.md`, `project-control/PROJECT_CLOSURE_REPORT.md`, `clients/.../delivery/` |
28
28
  | Project implementation knowledge | Maintains concise current-state operational knowledge per screen/module/service | `project-knowledge/` داخل كل تطبيق |
29
- | Tera distribution and versioning | Builds releases and distributes Tera to client repositories in a versioned, verifiable way; clients derive updates from the origin repository (`https://github.com/Alabasi1980/Teranoo-System-Core`) via fetch + verified release packages (Tag `tera-vX.Y.Z` + Manifest + SHA lockfile + updater tools); npm packages `@tera-system/core 0.4.0` + `@tera-system/pro 0.2.26`; website `https://github.com/Alabasi1980/TeraWebsite` hosts bundle at `https://teranoo.com` and is deployed via `https://coolify.teranoo.com/`; ownership contract separates Tera-managed from client-owned files | `tera-system/TERA_DISTRIBUTION_POLICY.md` (§2.2 الحزم + §2.3 الموقع + §2.0 الأصالة), `tera-workshop/tools/tera-fetch.ps1`, `tera-workshop/tools/tera-release.ps1`, `tera-workshop/tools/tera-update.ps1`, `.tera/lock.json` داخل مستودعات العملاء |
30
- | Security Team (فريق الحماية) | Adversarial security validation before delivery: الدرع (defensive review during dev) → الشبح (Red Team — authorized attacks, Black Box then Gray/White Box) → العين (concurrent observer) → القاضي (independent audit + gate decision). Activated only at Phase 7 security gate or by Majed request. Outputs under `security-reports/` (same repo, outside the application folder). SCP-2026-09-02-001 | `.opencode/agents/red-team-agent.md`, `.opencode/agents/security-observer.md`, `.opencode/agents/security-auditor.md`, `tera-system/TeraHelperAgents.md` §6.1, `security-reports/`, adversarial protocol v2.0 (outside repo) |
29
+ | Tera distribution and versioning | Builds releases and distributes Tera to client repositories in a versioned, verifiable way; clients derive updates from the origin repository (`https://github.com/Alabasi1980/Teranoo-System-Core`) via fetch + verified release packages (Tag `tera-vX.Y.Z` + Manifest + SHA lockfile + updater tools); npm packages `@tera-system/core 0.6.0` + `@tera-system/pro 0.2.29`; website `https://github.com/Alabasi1980/TeraWebsite` hosts bundle at `https://teranoo.com` and is deployed via `https://coolify.teranoo.com/`; ownership contract separates Tera-managed from client-owned files | `tera-system/TERA_DISTRIBUTION_POLICY.md` (§2.2 الحزم + §2.3 الموقع + §2.0 الأصالة), `tera-workshop/tools/tera-fetch.ps1`, `tera-workshop/tools/tera-release.ps1`, `tera-workshop/tools/tera-update.ps1`, `.tera/lock.json` داخل مستودعات العملاء |
30
+ | Security Team (فريق الحماية) | Adversarial security validation before delivery: الدرع (defensive review during dev) → الشبح (Red Team — authorized attacks, Black Box then Gray/White Box) → العين (concurrent observer) → القاضي (independent audit + gate decision). Activated only at Phase 7 security gate or by Majed request. Outputs under `security-reports/` (same repo, outside the application folder). SCP-2026-09-02-001 | `.opencode/agents/red-team-agent.md`, `.opencode/agents/security-observer.md`, `.opencode/agents/security-auditor.md`, `.opencode/agents/security-agent.md`, `tera-system/TeraHelperAgents.md` §6.1, `security-reports/`, adversarial protocol v2.0 (outside repo) |
31
31
 
32
32
  ## 3. Folder Roles
33
33
 
@@ -76,7 +76,7 @@
76
76
  | الفئة | اللغات | آلية التنفيذ |
77
77
  |---|---|---|
78
78
  | 🥇 **متخصصة (Specialist)** | C#/.NET، TypeScript/Node.js/React، Phaser 3 (JS)، **Flutter/Dart**، **Python/Django** | عميل متخصص مخصص بمعايير كاملة |
79
- | 🥈 **مغطاة ببروفايل** | Razor Pages+ADO.NET، Next.js+Prisma، WPF، Blazor+EF، React PWA، **Rust (Draft)** | Fallback + بروفايل (قواعد Scaffold/ORM/CLI موثقة) — Rust: بروفايل `rust.md` (Draft — Needs Verification، SCP-2026-09-04-011) |
79
+ | 🥈 **مغطاة ببروفايل** | Razor Pages+ADO.NET، Next.js+Prisma، WPF، Blazor+EF، React PWA، **Rust (Available)** | Fallback + بروفايل (قواعد Scaffold/ORM/CLI موثقة) — Rust: بروفايل `rust.md` (✅ Available — مُثبَّت Pilot GEN-F05 · SCP-2026-09-29-017) |
80
80
  | 🥉 **غير مغطاة (أي لغة أخرى)** | PHP/Laravel، Java/Spring، Go، Ruby، Kotlin، Swift... | **Fallback العام مباشرة** — يعمل بلا بروفايل (بجودة أقل) أو ببروفايل (بجودة موثقة) |
81
81
 
82
82
  ### 2.3 المعادلة الحاكمة
@@ -98,7 +98,7 @@
98
98
  | المستوى | اللغات | الموقف |
99
99
  |---|---|---|
100
100
  | **ذكاء عالي + أداة** | Python، TypeScript/JS، C#، Java، Go، PHP، C/C++ | ✅ تنفيذ موثوق بجودة عالية حتى بلا بروفايل |
101
- | **ذكاء متوسط + أداة** | Dart، Ruby، Kotlin، Swift (ببيئة Mac)، Rust (بروفايل Draft — SCP-2026-09-04-011) | ✅ يعمل — بروفايل يرفع الجودة |
101
+ | **ذكاء متوسط + أداة** | Dart، Ruby، Kotlin، Swift (ببيئة Mac)، Rust (بروفايل ✅ Available — SCP-2026-09-29-017) | ✅ يعمل — بروفايل يرفع الجودة |
102
102
  | **ذكاء محدود + أداة** | لغات نادرة/جديدة/إصدارات حديثة جداً | ⚠️ يعمل لكن بخطأ محتمل — بروفايل شبه إلزامي |
103
103
  | **أي مستوى بلا أداة** | أي لغة بلا CLI/بيئة بناء | 🔴 تتوقف عند "الكتابة" ولا تصل "التسليم" |
104
104
 
@@ -47,6 +47,7 @@
47
47
  | الفئة | مشروط |
48
48
  | شرط الاستدعاء | بيانات حساسة، أسرار، Auth، Permissions، Middleware، Config، صلاحيات متقدمة، مدفوعات، إنترنت عام، حسابات إدارية مهمة |
49
49
  | دوره في الفريق | **الدفاع** — عضو فريق الحماية (SCP-2026-09-02-001): يحمي أثناء البناء، يحضّر ملفات الهجوم، يراجع الإصلاحات |
50
+ | التنفيذ | **عميل ثابت مستقل:** `.opencode/agents/security-agent.md` (SCP-2026-10-03-002) — هذا القسم تعريف الدور، والملف هو العقد التنفيذي |
50
51
 
51
52
  ### يقرأ
52
53
 
@@ -69,7 +69,7 @@ Project files record project-specific decisions.
69
69
  | Visual asset policy | `tera-system/image-generation/ASSET_POLICY.md` | `.opencode/agents/ui-designer.md` (§8.5) | Storage layout `project-assets/visual/{references,production,icons,marketing}/` + approval-scope rules + baseline_missing guardrail + rights-laundering block. SCP-2026-09-12-002. |
70
70
  | Monitor audit framework | `.opencode/agents/monitor.md` | `ENGINEERING_AGENT_RESPONSIBILITIES.md` | Governs the 7 immutable audit rules, reference hierarchy, plan rejection authority, and cumulative audit for plan-compliance checking. |
71
71
  | Auditor audit framework | `.opencode/agents/auditor.md` | `ENGINEERING_AGENT_RESPONSIBILITIES.md` | Governs Auditor as a Tera-managed quality gate sub-agent, including diff-first scope, evidence model, QUAUD reporting, and authorized invocation by Tera/Monitor. |
72
- | Security Team (فريق الحماية) — SCP-2026-09-02-001 | `.opencode/agents/red-team-agent.md` (الشبح) + `.opencode/agents/security-observer.md` (العين) + `.opencode/agents/security-auditor.md` (القاضي) + `tera-system/TeraHelperAgents.md` §6.1 (الدرع) | `security-reports/` في المستودع + البروتوكول الأمني v2.0 (خارج المستودع) | فريق أمني رباعي الأدوار: الدرع (دفاعي أثناء التطوير) + الشبح (هجومي — Phase 7 أو طلب Majed) + العين (مراقب متزامن) + القاضي (تدقيق مستقل وقرار البوابة). فصل الأدوار ملزم بالبروتوكول §2. التفعيل: Phase 7 أو طلب Majed فقط. المخرجات في `security-reports/` خارج مجلد التطبيق. |
72
+ | Security Team (فريق الحماية) — SCP-2026-09-02-001 | `.opencode/agents/red-team-agent.md` (الشبح) + `.opencode/agents/security-observer.md` (العين) + `.opencode/agents/security-auditor.md` (القاضي) + `.opencode/agents/security-agent.md` (الدرع — عميل مستقل، SCP-2026-10-03-002) + `tera-system/TeraHelperAgents.md` §6.1 (تعريف دور الدرع) | `security-reports/` في المستودع + البروتوكول الأمني v2.0 (خارج المستودع) | فريق أمني رباعي الأدوار: الدرع (دفاعي أثناء التطوير) + الشبح (هجومي — Phase 7 أو طلب Majed) + العين (مراقب متزامن) + القاضي (تدقيق مستقل وقرار البوابة). فصل الأدوار ملزم بالبروتوكول §2. التفعيل: Phase 7 أو طلب Majed فقط. المخرجات في `security-reports/` خارج مجلد التطبيق. |
73
73
  | Adversarial Security Protocol | `security-reports/WEB_APPLICATION_SECURITY_TEST_PLAN_AR.md` (v2.0) | `.opencode/agents/red-team-agent.md` | بروتوكول تيرانو للتحقق الهجومي من أمن تطبيقات الويب — OWASP ASVS 5.0 Level 2 + WSTG + API Top 10. ينفذه الشبح، يراقبه العين، يدققه القاضي. |
74
74
  | Quality gate thresholds | `tera-system/engineering-governance/QUALITY_GATE_THRESHOLDS.md` | `.opencode/agents/auditor.md`, `.opencode/agents/tera.md` | Compact reference for Auditor rule classes, evidence requirements, P1/P2 checks, and default heuristics. |
75
75
  | Project UI/UX executable guide | `project-preparation/28_UI_UX_GUIDELINES.md` using `TERA_RUNTIME_TEMPLATES_DELIVERY.md` Section 33 | `TASK_TEMPLATE.md`, `TeraPreExecutionGate.md` | Final executable visual design rules for EngineeringAgent; raw sources stay in `project-preparation/design-source/`. Split notice INS-02: Section 33 moved to DELIVERY file. |
@@ -112,7 +112,7 @@ Project files record project-specific decisions.
112
112
  | Business Transformation Consultant (BTCA) | `.opencode/agents/tera-business-transformation-consultant.md` | `tera-system/consulting-helpers/BTCA_METHODOLOGY_FRAMEWORK.md`, `BTCA_REPORT_TEMPLATES.md` | عميل مستقل للاستشارات الإدارية والتنظيمية غير البرمجية — Track C. SCP-2026-07-29-002. |
113
113
  | BTCA — Methodology Framework | `tera-system/consulting-helpers/BTCA_METHODOLOGY_FRAMEWORK.md` | `.opencode/agents/tera-business-transformation-consultant.md` | إطار المنهجية: تصنيف الأدلة الخماسي، مراحل العمل، دليل المقابلات، هيكل التقرير النهائي. |
114
114
  | BTCA — Report Templates | `tera-system/consulting-helpers/BTCA_REPORT_TEMPLATES.md` | `.opencode/agents/tera-business-transformation-consultant.md` | قوالب التقارير العشرة الأساسية + التقرير التنفيذي. |
115
- | Tera distribution (versioned) | `tera-system/TERA_DISTRIBUTION_POLICY.md` (§2.2 الحزم + §2.3 الموقع + §2.0 الأصالة) | `.tera/lock.json` في مستودعات العملاء | توزيع Tera المُروّس: **RepositoryUrl `https://github.com/Alabasi1980/Teranoo-System-Core`** (المصدر؛ مستودع الحزم `Teranoo-System` = npm فقط) + الحزم `@tera-system/core 0.4.0` / `@tera-system/pro 0.2.26` (مقاس من npm المنشور 2026-09-23 — SCP-2026-09-23-001) + **الموقع `https://github.com/Alabasi1980/TeraWebsite` + `https://teranoo.com` + منصة النشر `https://coolify.teranoo.com/`** + إصدارات (Tag+SHA) + عقد ملكية + أدوات `tera-workshop/tools/`. أي تعديل على ملفات Tera-managed يتطلب Tag+bundle+npm publish. SCP-2026-08-15-009 + SCP-2026-08-31-002 + SCP-2026-08-31-003. |
115
+ | Tera distribution (versioned) | `tera-system/TERA_DISTRIBUTION_POLICY.md` (§2.2 الحزم + §2.3 الموقع + §2.0 الأصالة) | `.tera/lock.json` في مستودعات العملاء | توزيع Tera المُروّس: **RepositoryUrl `https://github.com/Alabasi1980/Teranoo-System-Core`** (المصدر؛ مستودع الحزم `Teranoo-System` = npm فقط) + الحزم `@tera-system/core 0.6.0` / `@tera-system/pro 0.2.29` (مقاس من npm المنشور 2026-09-29 — SCP-2026-09-23-001 + releases 024-00x) + **الموقع `https://github.com/Alabasi1980/TeraWebsite` + `https://teranoo.com` + منصة النشر `https://coolify.teranoo.com/`** + إصدارات (Tag+SHA) + عقد ملكية + أدوات `tera-workshop/tools/`. أي تعديل على ملفات Tera-managed يتطلب Tag+bundle+npm publish. SCP-2026-08-15-009 + SCP-2026-08-31-002 + SCP-2026-08-31-003. |
116
116
  | Source code ownership & pricing | `tera-system/TeraPricingPolicy.md` (§31) + `tera-system/TeraClientPolicy.md` (§9.5) | `tera-workshop/client-templates/contractual/SOURCE_CODE_PURCHASE_ADDENDUM_TEMPLATE.md`، `SOFTWARE_SERVICES_AGREEMENT` §12 | ملكية السورس افتراضياً لـ Tera (لا يُسلَّم للزبون) + خيارا L1 (40%) / L2 (max(3×، 1,000 JOD)) عبر ملحق تعاقدي + L3 (إعادة بيع) مرفوض افتراضياً. SCP-2026-08-29-004. |
117
117
  | Prototype pricing mandate | `tera-system/TeraPricingPolicy.md` (§17.5) + `tera-system/TeraClientPolicy.md` (Gate 6) | `tera-workshop/client-templates/commercial/QUOTATION_TEMPLATE.md`, `project-control/TeraPricingCalculator.xlsx` | البروتوتايب التصميمي إلزامي لكل التطبيقات (SCP-2026-08-28-001) وهو **بند مسعّر مشمول**: 10% من السعر النهائي (B57) — يُحتسب تلقائياً في الحاسبة — يُعرض كبند منفصل في العرض — يُلغى إلى 0% فقط باتفاق الطرفين (WAIVED_BY_MAJED + موافقة الزبون). رفض البروتوتايب المعروض لا يُلغي تكلفته (Fix/CR). SCP-2026-09-01-001. |
118
118
  | Client letter numbering | `tera-system/TeraClientPolicy.md` (§9.6) + `project-control/CLIENT_CODES.md` | `client-approval/LETTER_LOG.md` في مستودع العميل | ترميز موحد `{كود-العميل}-{النوع}-{السنة}-{التسلسل}` — كود العميل يخصّصه Majed فقط (سجل مركزي) — الأنواع LET/CON/ADD/PAL/DOC/TPL (قابلة للزيادة). SCP-2026-08-29-005. |
@@ -76,7 +76,7 @@ Purpose:
76
76
  It does not replace:
77
77
 
78
78
  - `SoftwareDesignerAgent`
79
- - `SecurityAgent (الدرع)` (معرّف في `TeraHelperAgents.md` §6.1)
79
+ - `SecurityAgent (الدرع)` — عميل مستقل: `.opencode/agents/security-agent.md` (تعريف الدور: `TeraHelperAgents.md` §6.1)
80
80
  - `qa-agent` (موجود في `.opencode/agents/qa-agent.md`)
81
81
  - `ProjectControlAgent` (معرّف في `TeraHelperAgents.md` §6.8)
82
82
  - `Post-Execution Review Gate`
@@ -832,11 +832,24 @@ Required Action:
832
832
  Read project state → Identify next task → Prepare/draft task package → Check CLI side effects → Run checklist → Revise until PASS → Ask approval
833
833
  ```
834
834
 
835
- ### SoftwareDesignerAgent Preparation Rule
835
+ ### SoftwareDesignerAgent Gate Rule (SDA Classification — SCP-2026-09-29-010)
836
836
 
837
- Tera may use `SoftwareDesignerAgent` to prepare the technical specification before delegation.
838
- This agent produces `TECHNICAL_SPECIFICATION.md` covering scope, references, write targets, acceptance criteria, risk notes, and reviewer suggestions.
839
- Tera must still review that specification himself, run the full `Pre-Execution Gate`, and keep final authority over approval, delegation, and closure.
837
+ كل مهمة تنفيذية تُصنَّف **إلزامياً**: `SDA Classification: REQUIRED / FAST_PATH / NOT_APPLICABLE` (القاعدة: **Impact Trigger يتجاوز Complexity Trigger**). هذا فحص إلزامي داخل البوابة — لا "may use".
838
+
839
+ **`REQUIRED` → ترفض المهمة إن نقص أيٌّ من:**
840
+ ```text
841
+ [ ] TASK-COD-XXX موجود كـ Draft
842
+ [ ] TASK-COD-XXX_TECHNICAL_SPECIFICATION.md موجود
843
+ [ ] حالة المواصفة = APPROVED_FOR_GATE
844
+ [ ] لا Design Gap غير مُعالج
845
+ [ ] الحالات المرجعية المطبَّقة ≥ MBA
846
+ [ ] Tera راجع المواصفة
847
+ [ ] المواصفة مُشار إليها من عقد المهمة
848
+ ```
849
+ **`FAST_PATH` → ترفض إن نقص:** سبب مكتوب + إثبات تحقق كل شروط الـFast Path.
850
+ **`NOT_APPLICABLE` →** مهام وثائقية/تشغيلية فقط.
851
+
852
+ أي نقص → `NEEDS_REVISION` (لا تفويض). Tera يبقى صاحب السلطة النهائية على الاعتماد/التفويض/الإغلاق. المواصفة تغطي scope/references/write targets/acceptance criteria/risk notes/reviewers وفق قالب `tera-software-designer.md` §5.
840
853
 
841
854
  لا يعتمد على الذاكرة أو الاستنتاج العام. يعتمد على القائمة والفحص.
842
855
 
@@ -170,7 +170,7 @@ It does not replace:
170
170
 
171
171
  | الدور | اللقب | الملف | الوظيفة |
172
172
  |---|---|---|---|
173
- | دفاعي | الدرع | `TeraHelperAgents.md` §6.1 | مراجعة أمنية أثناء التطوير + تحضير ملفات الدفاع + مراجعة الإصلاحات |
173
+ | دفاعي | الدرع | `.opencode/agents/security-agent.md` (تعريف الدور: `TeraHelperAgents.md` §6.1) | مراجعة أمنية أثناء التطوير + تحضير ملفات الدفاع + مراجعة الإصلاحات |
174
174
  | هجومي | الشبح | `.opencode/agents/red-team-agent.md` | اختبار هجومي فعلي (Black Box ثم Gray/White Box) |
175
175
  | مراقب | العين | `.opencode/agents/security-observer.md` | مراقبة متزامنة للسجلات والموارد والـ Canary |
176
176
  | مدقق | القاضي | `.opencode/agents/security-auditor.md` | تدقيق الأدلة + قرار بوابة الأمن (PASS/CONDITIONAL/FAIL/INCOMPLETE) |
@@ -276,10 +276,10 @@ but the generic sub-agent registry in `TeraSubAgents.md` must remain stack-neutr
276
276
 
277
277
  ---
278
278
 
279
- # 5. العملاء الأساسيون — السجل الرسمي (25 عميلاً)
280
-
281
- > **مصدر الحقيقة:** `.opencode/agents/` — **25 ملفاً نشطاً** بالأسماء الحديثة (القائمة الفعلية أوثق من أي عدّاد). هذا القسم **سجل مرجعي موجز**؛ التفاصيل التشغيلية الكاملة لكل عميل في ملفه الخاص.
282
- > **التصنيف الرسمي:** 8 Coding + 3 Quality + 2 Management + 4 Engagement + 2 Research + 1 Knowledge + 1 Specialist + 1 System + 3 Security = **25 عميلاً**.
279
+ # 5. العملاء الأساسيون — السجل الرسمي (26 عميلاً)
280
+
281
+ > **مصدر الحقيقة:** `.opencode/agents/` — **26 ملفاً نشطاً** بالأسماء الحديثة (القائمة الفعلية أوثق من أي عدّاد). هذا القسم **سجل مرجعي موجز**؛ التفاصيل التشغيلية الكاملة لكل عميل في ملفه الخاص.
282
+ > **التصنيف الرسمي:** 8 Coding + 3 Quality + 2 Management + 4 Engagement + 2 Research + 1 Knowledge + 1 Specialist + 1 System + 4 Security = **26 عميلاً**.
283
283
 
284
284
  ---
285
285
 
@@ -287,7 +287,7 @@ but the generic sub-agent registry in `TeraSubAgents.md` must remain stack-neutr
287
287
 
288
288
  | الفئة | العدد | العملاء |
289
289
  |:------|:-----:|:--------|
290
- | **Coding Agents** — يكتبون كوداً | 8 | engineering-agent, engineering-agent-dotnet, engineering-agent-typescript, engineering-agent-phaser, engineering-agent-flutter, engineering-agent-django, ui-designer, tera-software-designer |
290
+ | **Execution Layer** — طبقة التنفيذ | 8 | engineering-agent, engineering-agent-dotnet, engineering-agent-typescript, engineering-agent-phaser, engineering-agent-flutter, engineering-agent-django, ui-designer, tera-software-designer |
291
291
  | **Quality Agents** — جودة | 3 | auditor, qa-agent, design-reviewer |
292
292
  | **Management** — إدارة | 2 | tera (TeraAgent), monitor |
293
293
  | **Engagement** — عملاء خارجيون | 4 | tera-client-engagement, tera-business-transformation-consultant, application-blueprint, tera-strategic-advisor |
@@ -295,7 +295,9 @@ but the generic sub-agent registry in `TeraSubAgents.md` must remain stack-neutr
295
295
  | **Knowledge** — معرفة | 1 | project-knowledge-agent |
296
296
  | **Specialist** — تخصص | 1 | production-erp-expert |
297
297
  | **System** — منظومة | 1 | tera-system-evolution |
298
- | **Security** — فريق الحماية | 3 | red-team-agent, security-observer, security-auditor |
298
+ | **Security** — فريق الحماية | 4 | red-team-agent, security-observer, security-auditor, security-agent |
299
+
300
+ > **تفصيل «طبقة التنفيذ» (8):** **7 كتابة كود** — المهنّدسون الستة (`engineering-agent`, `-dotnet`, `-typescript`, `-phaser`, `-flutter`, `-django`) + `ui-designer` (واجهة عرضية TSX/CSS) — و**1 مواصفة تقنية بلا كود** (`tera-software-designer`). التسمية السابقة «Coding Agents — يكتبون كوداً» كانت **غير دقيقة لـ1 من 8** (SCP-2026-09-29-011).
299
301
 
300
302
  ---
301
303
 
@@ -312,7 +314,7 @@ but the generic sub-agent registry in `TeraSubAgents.md` must remain stack-neutr
312
314
  | `engineering-agent-flutter.md` | Flutter/Dart mobile client | Coding |
313
315
  | `engineering-agent-django.md` | Python/Django/DRF backend | Coding |
314
316
  | `ui-designer.md` | تصميم بصري UI/UX | Coding |
315
- | `tera-software-designer.md` | تصميم تقني / Technical Specs | Coding |
317
+ | `tera-software-designer.md` | تصميم تقني / Technical Specs (بلا كود) | Design |
316
318
  | `auditor.md` | تدقيق جودة Diff-first (مُدقق) | Quality |
317
319
  | `qa-agent.md` | اختبارات CLI (تخطيط + تنفيذ) | Quality |
318
320
  | `design-reviewer.md` | مراجعة بصرية (ناقد) | Quality |
@@ -327,7 +329,8 @@ but the generic sub-agent registry in `TeraSubAgents.md` must remain stack-neutr
327
329
  | `tera-system-evolution.md` | حارس المنظومة (تطوير Tera) | System |
328
330
  | `red-team-agent.md` | الشبح — هجومي (Phase 7 gate) | Security |
329
331
  | `security-observer.md` | العين — مراقب متزامن | Security |
330
- | `security-auditor.md` | القاضي — تدقيق + قرار البوابة | Security |
332
+ | `security-auditor.md` | القاضي — تدقيق + قرار البوابة | Security |
333
+ | `security-agent.md` | الدرع — مراجعة دفاعية + defense-handoff/fix-review | Security |
331
334
 
332
335
  ---
333
336
 
@@ -337,7 +340,7 @@ but the generic sub-agent registry in `TeraSubAgents.md` must remain stack-neutr
337
340
  - **لا تواصل مباشر بين العملاء.** الاستثناءات: Monitor→Auditor بطلب Majed؛ TCEA/Blueprint→Domain/ERP (بحث فقط).
338
341
  - **لا تفعيل دون Trigger واضح** — `AGENT_ACTIVATION_MATRIX.md`.
339
342
  - **الصلاحيات** — `AGENT_PERMISSION_MODEL.md`.
340
- - **العملاء المشروطون/المساعدون** (Integration, DevOps, Performance, Compliance, SecurityAgent/الدرع...) في `TeraHelperAgents.md`.
343
+ - **العملاء المشروطون/المساعدون** (Integration, DevOps, Performance, Compliance...) في `TeraHelperAgents.md`. (الدرع أصبح عميلاً ثابتاً: `security-agent.md` — SCP-2026-10-03-002)
341
344
 
342
345
  ---
343
346
 
@@ -363,7 +366,7 @@ but the generic sub-agent registry in `TeraSubAgents.md` must remain stack-neutr
363
366
 
364
367
  | الملف | الوظيفة |
365
368
  |:------|:--------|
366
- | `.opencode/agents/*.md` | التعريفات التشغيلية الكاملة (25 عميلاً) |
369
+ | `.opencode/agents/*.md` | التعريفات التشغيلية الكاملة (26 عميلاً) |
367
370
  | `AGENT_DEPENDENCY_MAP.md` | التبعيات والترتيب الآمن للتعديل |
368
371
  | `AGENT_ACTIVATION_MATRIX.md` | متى يُفعَّل كل عميل |
369
372
  | `AGENT_PERMISSION_MODEL.md` | الصلاحيات الافتراضية لكل عميل |
@@ -102,6 +102,8 @@
102
102
  [ ] إذا كان المحتوى “مرئيًا” لكنه غير “مريحًا”: فشل
103
103
  ```
104
104
 
105
+ > **قاعدة cross-check الصور (SCP-2026-09-29-002):** بعد كل لقطة، أجرِ cross-check لحقيقة مميزة واحدة في DOM (`find`/`evaluate`) **قبل** الاستشهاد بالصورة — فطبقة إرفاق الصور قد تعيد صورة قديمة؛ لا تحكم على صورة وحدها. يُفضَّل element-screenshot + هدوء بين اللقطات.
106
+
105
107
  ## §4. نظافة التصميم (Design Hygiene)
106
108
 
107
109
  ```
@@ -10,17 +10,23 @@ It governs authority, task discipline, safe writing, evidence, and handback. It
10
10
 
11
11
  Every engineering agent must read this file before it starts a task.
12
12
 
13
- **🧰 أدواتك المتاحة:**
14
- - **🎭 Playwright** — لتوليد اختبارات E2E (CLI: `playwright-cli`، MCP: `@playwright/mcp`، Test: `@playwright/test`). استخدمه تلقائياً للمهام ذات واجهات المستخدم — افتح المتصفح، اختبر التدفق، التقط Screenshot.
15
- - **📮 Bruno** — توثيق واختبار APIs. استخدم `bru run` لاختبار Collections بعد إنشاء APIs جديدة. (مثبت: `@usebruno/cli`).
16
- - **📊 Sentry** — مراقبة الأخطاء بعد التشغيل. أضف Sentry SDK (`@sentry/...`) في مشاريع الإنتاج.
17
- - **🎨 shadcn/ui** — مكتبة المكونات المعتمدة للواجهات. استخدم `npx shadcn@latest add ...` لإضافة مكونات. استخدم Teranoo UI Registry (`tera-system/teranoo-ui/`) للمكونات المخصصة.
18
- - **🔑 Gitleaks** — فحص الأسرار في سجل Git قبل تسليم الكود: `gitleaks git . --redact --no-banner`. قم بتشغيله قبل إغلاق المهام الحساسة (Auth, Payment, Secrets, PII) وعند أي شك في وجود بيانات اعتماد.
19
- - **🎯 axe-core** — فحص Accessibility آلي داخل اختبارات Playwright: `@axe-core/playwright`. أي اختبار واجهة E2E للمهام الجديدة يتضمن فحص axe (labels, contrast, ARIA, semantics) وتُسجل أي violations.
20
- - **🧪 Testcontainers** — اختبارات تكاملية مع خدمات حقيقية (PostgreSQL, Redis, SQL Server) داخل Docker: `Testcontainers` (NuGet) أو `@testcontainers/*` (npm). استخدمه بدل Mocks فقط عندما تكون الخدمة الحقيقية متاحة عبر Docker.
21
- - **dotnet build/test/run** — لـ .NET
22
- - **npm/node** — لإدارة الحزم
23
- - **curl/webfetch** — لاختبار API
13
+ **🧰 أدوات التنفيذ — قاعدة محكومة (SCP-2026-09-29-013):**
14
+
15
+ هذه القاعدة **لا تفرض** أي مكتبة/إطار/أداة كافتراض. استخدم الأداة **المعتمدة من الـTechnology/Tooling Profile النشط + المهمة**. لا تفترض أداة "افتراضية".
16
+
17
+ | الحاجة | عند اعتمادها في الـProfile/المهمة |
18
+ |---|---|
19
+ | E2E / فحص واجهة | Playwright (`playwright-cli` / `@playwright/mcp` / `@playwright/test`) — افتح، اختبر، لقطات |
20
+ | Accessibility | axe-core (`@axe-core/playwright`) — إن كانت متاحة أو أذن الـProfile بإضافتها |
21
+ | API docs/tests | Bruno (`bru run`) — **فقط إن كان مسار الـCollection ضمن Allowed Write Targets** |
22
+ | Observability | **إن كان المعتمد = Sentry** → تحقّق من تهيئته؛ وإلا لا تُضِف |
23
+ | UI components | مكتبة المكوّنات **المعتمدة في الـProfile** (shadcn/ui أو غيرها) + Teranoo UI Registry عند اعتماده |
24
+ | Secrets scan | Gitleaks (`gitleaks git . --redact --no-banner`) — قبل مهام Auth/Payment/Secrets/PII |
25
+ | Integration tests | Testcontainers — عند الحاجة لخدمة حقيقية + Docker متاح + اعتماد الـProfile |
26
+ | Build/Run | dotnet / npm / node / curl — حسب الـstack |
27
+
28
+ > **إضافة Dependency:** لا تُضِف أي حزمة إلا إذا: (أ) موجودة أصلاً → استخدمها، أو (ب) المهمة/الـProfile يسمح صراحة بإضافتها. وإلا → **أبلغ Tera بنقص التغطية**، ولا تُضِف.
29
+ > **Tooling الكامل:** `tera-system/TOOLING_AND_MCP_POLICY.md`.
24
30
 
25
31
  ---
26
32
 
@@ -96,7 +102,7 @@ Never write outside Allowed Write Targets because a path “looks related.”
96
102
  - If the task includes a UI change:
97
103
  1. **PLAYWRIGHT_UI_CHECK**: Run the app locally, open browser via Playwright CLI or MCP, visually verify the UI, take a full-page screenshot as evidence.
98
104
  2. **E2E Test**: If the project has Node.js/npm available, generate a basic Playwright E2E test (`*.spec.ts`) covering the changed flow. The test must be runnable via `npx playwright test`.
99
- 3. **AXE_A11Y_CHECK** (new UI flows): If the project has `@axe-core/playwright` available or can add it, include an axe scan in the E2E test and record `violations` in the handback. Add `@axe-core/playwright` as a devDependency when creating new UI tests for interfaces with forms, navigation, or interactive controls.
105
+ 3. **AXE_A11Y_CHECK** (new UI flows): إن كان `@axe-core/playwright` متاحاً أو أذن الـProfile/المهمة بإضافته، ضمّن فحص axe في اختبار E2E وسجّل `violations` في الـhandback. **لا تُضِف الحزمة تلقائياً** — إن لم تكن متاحة ولم يُؤذن، أبلغ Tera بنقص تغطية a11y.
100
106
  - If the task adds or changes data-layer tests that need a real database/cache service and Docker is available, prefer **Testcontainers** over Mocks-only for the critical integration paths (see §6.1 below). If Docker is unavailable, state the limitation and use Mocks with a documented follow-up.
101
107
  - **GITLEAKS_PRE_DELIVERY_CHECK**: Before closing a task that touches Auth, Payment, Secrets, PII, or credential-like strings, run `gitleaks git . --redact --no-banner` and record the result in the handback. Never commit a real secret; if Gitleaks reports a real credential, stop and report to Tera.
102
108
 
@@ -228,7 +234,7 @@ If repeated real-work evidence reveals a gap in this core, a specialist contract
228
234
  ### 10.6 النظافة والحد الأدنى (Cleanliness & Minimalism)
229
235
 
230
236
  - **لا كود ميت**: لا تترك imports/دوال/متغيرات غير مستخدمة.
231
- - **لا تكرار واضح**: كرر مرتين = فكّر في الاستخراج؛ كرر ثلاثاً = استخرج (بمسؤولية ضيقة).
237
+ - **لا تكرار واضح**: كرر مرتين = فكّر في الاستخراج؛ كرر ثلاثاً = **مراجعة إلزامية للاستخراج** — قرار واعٍ بمسؤولية ضيقة، **وليس تجريداً تلقائياً** (قد يكون الاستخراج غير مناسب).
232
238
  - **لا ملفات خارج نطاق المهمة**: كل ملف تلمسه يجب أن يخدم هدف المهمة المصرح به.
233
239
  - نظّف أي حطام تنقله (ملفات تجريبية، سجلات مؤقتة، تعليقات قديمة) قبل الـ handback.
234
240
 
@@ -49,10 +49,12 @@ If the stack is still unclear, do not activate a final profile yet.
49
49
  | `react-pwa` | React 18 + Vite + TypeScript + Tailwind CSS (RTL) + Zustand + idb (IndexedDB) + Fuse.js + vite-plugin-pwa | ✅ **Approved — Active** | PWA محلي عربي (Offline Standalone) — فعّل Majed (2026-08-01, PREP-D-016) |
50
50
  | `flutter-mobile` | Flutter + Dart | Available | موبايل — يُحمَّل عند تصنيف المنتج موبايل (MVP_DEFINITION_PROTOCOL + MOBILE_UI_UX_STANDARDS) — (SCP-2026-09-04-003) |
51
51
  | `dotnet-razorpages-adonet` | .NET Razor Pages + ADO.NET | Available | تطبيقات أعمال داخلية + تكامل بيانات — (SCP-2026-09-04-003) |
52
- | `rust` | Rust (cargo/rustc) — 2024 edition, Axum/Tauri/SQLx | **Draft — Needs Verification** | عام: CLI، خدمات عالية الأداء، Tauri، WebAssembly — لا متخصص، يعمل عبر engineering-agent (fallback)؛ الترقية لـ Available بعد تجربة تحقق (SCP-2026-09-04-011) |
52
+ | `rust` | Rust (cargo/rustc) — 2024 edition, Axum/Tauri/SQLx | ✅ **Available** | عام: CLI، خدمات عالية الأداء، Tauri، WebAssembly — لا متخصص، يعمل عبر engineering-agent (fallback)؛ **مُثبَّت** ببناء/اختبار فعلي (Pilot GEN-F05 — SCP-2026-09-29-017) |
53
53
  | `bun-ts-monorepo-sqlite` | TypeScript + Bun 1.3.14 + Turbo monorepo + SQLite | **Draft — Needs Verification** | منتج مستقل (APP-TERA_CODE) فوق Baseline موروث — CLI/TUI + Web محلي (127.0.0.1) + Desktop Shell؛ الحقول غير المتحققة موسومة `[Needs Verification — Phase A]`؛ الترقية لـ Available بعد Baseline Comprehension + تجربة تحقق (SCP-2026-09-18-001) |
54
54
  | `python-django` | Python 3.12+ + Django 5.x + DRF + PostgreSQL | Available | خلفية API (models/serializers/viewsets، SimpleJWT، server-side permissions) — (SCP-2026-09-23-006) |
55
55
 
56
+ > **دلالة الحالة (PROFILE-DN-F06):** `Available` = **قابل للاستخدام تقنياً** · `Approved` = اعتمده Majed · `Approved — Active` = **مفعّل لمشروع قائم**. **`Available` لا يعني Active للتنفيذ** — على Tera تثبيت الـActive Profile للمشروع في ملفه قبل أي مهمة.
57
+
56
58
  ## Placeholder Candidates
57
59
 
58
60
  The following stacks may need profiles later, but are not created now: