@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
@@ -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
  ---
@@ -62,11 +62,12 @@ Project files record project-specific decisions.
62
62
  | Runtime checklists | `tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md` | `.opencode/agents/tera.md` | Checklists stay outside runtime. |
63
63
  | MVP classification | `tera-system/runtime/MVP_DEFINITION_PROTOCOL.md` | `.opencode/agents/tera.md` | Runtime references when to load it. |
64
64
  | Technology profiles | `tera-system/profiles/` | `.opencode/agents/tera.md` | Stack-specific rules stay in profiles. |
65
+ | System capability map | `tera-system/TeraCapabilityMap.md` | Not applicable | مرجع معرفي (ليس سياسة): قدرات المنظومة — اللغات وأنواع التطبيقات القابلة للتنفيذ مع حدودها (SCP-2026-09-04-004). السياسات الحاكمة تبقى في هذا الملف. |
65
66
  | Design governance layer | `tera-system/design-system/` | `.opencode/agents/tera.md`, `TERA_RUNTIME_CHECKLISTS.md`, `TERA_RUNTIME_PROTOCOLS_CORE.md` | Governs Design Source Decision, DESIGN.md integration, internal kits, design tokens, component rules, and UI Acceptance Gate. |
66
67
  | 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. |
67
68
  | 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. |
68
69
  | 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/` خارج مجلد التطبيق. |
69
- | Adversarial Security Protocol | `F:\Teranoo Work\OnGoing\Security test\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. ينفذه الشبح، يراقبه العين، يدققه القاضي. |
70
+ | 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. ينفذه الشبح، يراقبه العين، يدققه القاضي. |
70
71
  | 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. |
71
72
  | 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. |
72
73
  | Application proposal template | `tera-workshop/client-templates/commercial/APPLICATION_PROPOSAL_TEMPLATE.md` | `TERA_RUNTIME_TEMPLATES.md` (Section 26) | Formal proposal document. Generated after Client Discovery before formal preparation. |
@@ -76,7 +76,7 @@ Purpose:
76
76
  It does not replace:
77
77
 
78
78
  - `SoftwareDesignerAgent`
79
- - `SecurityAgent` (معرّف في `TeraHelperAgents.md` §6.1)
79
+ - `SecurityAgent (الدرع)` (معرّف في `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`
@@ -149,7 +149,7 @@ Every preparation document passes through these states. Not all states are manda
149
149
 
150
150
  | Role | Who | Responsibility |
151
151
  |---|---|---|
152
- | **Maker** | Specialized preparation agent (e.g., `DataDesignAgent`, `UIUXStructureAgent`) | Writes the document following its template and assigned allowed-write-targets |
152
+ | **Maker** | Preparation role performed by `application-blueprint` or a generated helper agent (prep roles: RequirementsScope / BusinessWorkflow / DataDesign / UIUXStructure / SolutionArchitecture) | Writes the document following its template and assigned allowed-write-targets |
153
153
  | **Checker** | A different preparation agent or coordination agent | Reviews the document for: cross-document consistency, dependency alignment, completeness against its template |
154
154
  | **Orchestrator** | ApplicationBlueprintAgent (مُهندس) — SCP-2026-07-28-118 | Plans the document, assigns Maker, assigns Checker, tracks state, detects contradictions, prepares approval packages |
155
155
  | **Owner** | Majed | Approves only sensitive decisions (module boundaries, scope changes, critical Cross-Cutting Rules, System Approved promotion). Does not review every field. |