@tera-system/core 0.2.11 → 0.2.13
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.
- package/MANIFEST.json +8 -8
- package/RELEASES.md +33 -0
- package/agents/auditor.md +1 -1
- package/agents/red-team-agent.md +334 -0
- package/agents/security-auditor.md +281 -0
- package/agents/security-observer.md +241 -0
- package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +4 -1
- package/core/tera-system/AGENT_DEPENDENCY_MAP.md +6 -0
- package/core/tera-system/AGENT_PERMISSION_MODEL.md +4 -1
- package/core/tera-system/SECURITY_TEAM_CHARTER.md +225 -0
- package/core/tera-system/TOOLING_AND_MCP_POLICY.md +44 -1
- package/core/tera-system/TeraArchitectureMap.md +2 -0
- package/core/tera-system/TeraClientPolicy.md +1 -1
- package/core/tera-system/TeraHelperAgents.md +17 -1
- package/core/tera-system/TeraPolicyMap.md +4 -1
- package/core/tera-system/TeraPricingPolicy.md +16 -0
- package/core/tera-system/TeraSubAgents.md +27 -7
- package/core/tera-system/client-helpers/tera-client-engagement-pricing.md +1 -1
- package/core/tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md +10 -0
- package/package.json +1 -1
- package/scripts/lib/public-key.pem +1 -1
- package/tools/tera-tooling.ps1 +95 -2
|
@@ -0,0 +1,225 @@
|
|
|
1
|
+
<!-- © 2026 Majed Khaireddin (Alabasi1980). Tera System — Proprietary. All rights reserved. -->
|
|
2
|
+
|
|
3
|
+
# SECURITY_TEAM_CHARTER — ميثاق فريق الأمان (نسخة الجوهر المُوزَّعة)
|
|
4
|
+
|
|
5
|
+
> **الوضع:** وثيقة رسمية موزعة مع حزمة Tera — تصل لكل مستودع يثبّت `@tera-system/core`.
|
|
6
|
+
> **التأسيس:** SCP-2026-09-02-001 (موافقة Majed) — 2026-09-02
|
|
7
|
+
> **المصدر الكامل:** `security-reports/SECURITY_TEAM_CHARTER.md` في المستودع الأصلي — هذه النسخة هي **الجوهر الثابت** المُوزَّع.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## 1. من نحن — هوية الفريق
|
|
12
|
+
|
|
13
|
+
**فريق الأمان (Team Security / فريق الهاكرز)** — وحدة هجومية-دفاعية ذكية داخل منظومة Tera من **أربعة عملاء** بأدوار منفصلة تماماً:
|
|
14
|
+
|
|
15
|
+
| اللقب | الاسم التقني | الدور | الوظيفة |
|
|
16
|
+
|---|---|---|---|
|
|
17
|
+
| 🛡️ **الدرع** | SecurityAgent | **دفاعي** | يحمي أثناء التطوير، يحضّر ملفات الدفاع، يراجع الإصلاحات |
|
|
18
|
+
| 🥷 **الشبح** | Red Team Agent | **هجومي** | ينفذ الهجمات الفعلية المصرح بها (كالمخترق الحقيقي) |
|
|
19
|
+
| 👁️ **العين** | Security Observer | **مراقب** | يراقب السجلات والموارد وبيانات Canary بالتزامن مع الهجوم |
|
|
20
|
+
| ⚖️ **القاضي** | Security Auditor | **مدقق** | يراجع الأدلة ويصدر قرار البوابة النهائي |
|
|
21
|
+
|
|
22
|
+
### قاعدة فصل الأدوار (إلزامية — البروتوكول §2)
|
|
23
|
+
|
|
24
|
+
```text
|
|
25
|
+
"إذا نفذ عميل واحد الهجوم والتدقيق فلا تعد النتيجة تدقيقاً مستقلاً."
|
|
26
|
+
— الشبح يهاجم، العين يراقب، القاضي يحكم. لا أحد يدقق عمله هو.
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## 2. لماذا أُنشئنا — الفكرة والدافع
|
|
32
|
+
|
|
33
|
+
نشأ الفريق بقرار Majed (2026-09-02) للحاجة إلى:
|
|
34
|
+
|
|
35
|
+
```text
|
|
36
|
+
1. اختبار أمني حقيقي (هجمات فعلية مصرح بها) — لا مجرد ماسحات آلية
|
|
37
|
+
2. بوابة أمن إلزامية قبل تسليم أي تطبيق (Phase 7)
|
|
38
|
+
3. منهجية معيارية عالمية (OWASP ASVS 5.0 L2 + WSTG + API Top 10)
|
|
39
|
+
4. أدلة قابلة للمراجعة لكل نتيجة — لا ادعاءات بلا إثبات
|
|
40
|
+
5. فصل صارم للأدوار — كما في فرق Red Team المحترفة
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## 3. هدفنا — Mission
|
|
46
|
+
|
|
47
|
+
```text
|
|
48
|
+
ضمان أن أي تطبيق تخرجه منظومة Tera لا يُسلم إلا بعد:
|
|
49
|
+
✅ اختبار هجومي مصرح به وفق بروتوكول معتمد
|
|
50
|
+
✅ توثيق كل الثغرات المكتشفة بأدلة كاملة
|
|
51
|
+
✅ إصلاح الحرجة (Critical/High) قبل التسليم
|
|
52
|
+
✅ قرار بوابة مستقل من القاضي
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## 4. غايتنا النهائية — Vision
|
|
58
|
+
|
|
59
|
+
```text
|
|
60
|
+
أن نصبح "البوابة الأخيرة" لكل تسليم تطبيق في Tera:
|
|
61
|
+
- لا تطبيق يُسلم بلا جولة اختبار أمان موثقة
|
|
62
|
+
- الفريق معروف في كل جلسة — مرجعية واحدة (هذا الميثاق)
|
|
63
|
+
- قابل للتوسع كخدمة اختبار اختراق للعملاء (تحت التقييم)
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## 5. كيف نعمل — المنهجية
|
|
69
|
+
|
|
70
|
+
### 5.1 المعايير المعتمدة
|
|
71
|
+
|
|
72
|
+
| المعيار | المستوى |
|
|
73
|
+
|---|---|
|
|
74
|
+
| OWASP ASVS | 5.0 — Level 2 |
|
|
75
|
+
| OWASP WSTG | الإصدار المثبت |
|
|
76
|
+
| OWASP API Security Top 10 | 2023 |
|
|
77
|
+
| OWASP Top 10 | 2025 (مرجع مخاطر) |
|
|
78
|
+
| CWE + CVSS | لتصنيف النتائج |
|
|
79
|
+
|
|
80
|
+
### 5.2 مراحل الجولة
|
|
81
|
+
|
|
82
|
+
```text
|
|
83
|
+
1. التفويض والنطاق (00_AUTHORIZATION.md) — Rules of Engagement موقعة من Majed
|
|
84
|
+
2. بوابة الاستعداد — بيئة معزولة، بيانات وهمية، Canary، حدود طلبات
|
|
85
|
+
3. Black Box — هجوم من الخارج بلا كود (كالمخترق الحقيقي)
|
|
86
|
+
4. Gray/White Box — مع الكود والمخططات بعد إغلاق Black Box
|
|
87
|
+
5. الحملات الهجومية الإلزامية — 13 مجالاً
|
|
88
|
+
6. الأدلة — Request/Response فعلي لكل اختبار
|
|
89
|
+
7. Findings — تصنيف CVSS/CWE/OWASP مع خطورة بأثر الإنتاج
|
|
90
|
+
8. الإصلاح + إعادة الاختبار — منفصل عن جلسة الهجوم
|
|
91
|
+
9. تدقيق مستقل — القاضي يراجع كل شيء
|
|
92
|
+
10. بوابة القبول الأمني — قرار نهائي
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### 5.3 التفعيل (مقصود ومضبوط)
|
|
96
|
+
|
|
97
|
+
```text
|
|
98
|
+
✅ تلقائياً عند بوابة التسليم (Phase 7) — لكل تطبيق قبل قرار التسليم
|
|
99
|
+
✅ أو بطلب صريح من Majed: "فعّل فريق الهاكرز على {التطبيق}"
|
|
100
|
+
❌ أبداً تلقائياً أثناء التطوير (Phases 1–6)
|
|
101
|
+
❌ أبداً على Production أو أطراف ثالثة بلا تفويض مكتوب
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 6. قدراتنا — 13 حملة هجومية إلزامية
|
|
107
|
+
|
|
108
|
+
| # | المجال | ما نختبره |
|
|
109
|
+
|---|---|---|
|
|
110
|
+
| 1 | الاستكشاف وكشف المعلومات | المسارات المخفية، النسخ القديمة، `.env`، Source Maps، Debug endpoints |
|
|
111
|
+
| 2 | الهوية والمصادقة | تعداد الحسابات، Rate Limiting، تجاوز المصادقة، إساءة استعادة كلمة المرور، MFA |
|
|
112
|
+
| 3 | الجلسات والـ Tokens | Session Fixation، انتهاء الجلسات، خصائص Cookies، JWT (التوقيع والخوارزمية والادعاءات) |
|
|
113
|
+
| 4 | الصلاحيات وعزل المستأجرين | BOLA/IDOR، BFLA، تصعيد أفقي/عمودي، تغيير User/Owner/Tenant IDs |
|
|
114
|
+
| 5 | الحقن والمدخلات | SQL/NoSQL Injection، OS Command، SSRF، Path Traversal، Deserialization |
|
|
115
|
+
| 6 | المتصفح والعميل | XSS (Reflected/Stored/DOM)، CSRF، Clickjacking، Open Redirect، CORS |
|
|
116
|
+
| 7 | الملفات | النوع الحقيقي، الامتداد المزدوج، حدود الحجم، منع التنفيذ، تخمين الأسماء |
|
|
117
|
+
| 8 | الـ API | OWASP API Top 10 كاملاً، Pagination، Rate Limits، GraphQL depth، Webhooks |
|
|
118
|
+
| 9 | منطق العمل | تجاوز Workflow، Race Conditions، تغيير السعر/الخصم/المالك، تكرار الكوبونات |
|
|
119
|
+
| 10 | البيانات والتشفير | HTTPS، تخزين كلمات المرور، التشفير المنزلي، حماية البيانات في السجلات |
|
|
120
|
+
| 11 | الأخطاء والسجلات والكشف | Stack Traces، تسجيل محاولات الدخول، ظهور الهجمات في السجلات |
|
|
121
|
+
| 12 | الأسرار وسلسلة التوريد | فحص المستودع/التاريخ/Artifacts، الاعتماديات، Dependency Confusion |
|
|
122
|
+
| 13 | الإعدادات والنشر | Debug/Development، ترويسات الأمان، CORS، Host Header، عزل قاعدة البيانات |
|
|
123
|
+
|
|
124
|
+
### الترسانة (مثبتة ومؤكدة التشغيل)
|
|
125
|
+
|
|
126
|
+
**Burp Suite Pro** (الرئيسية) + **OWASP ZAP** + **Nmap** + **Wireshark** + **k6** + **sqlmap** + **ffuf** + **Nuclei** + **dalfox** + **Metasploit** (Docker) + **Semgrep/Gitleaks/Trivy** + **RockYou** (14M كلمة مرور).
|
|
127
|
+
|
|
128
|
+
> الترسانة قابلة للتطوير — سياسة الإضافة/الاستبدال: اقتراح → تقييم → موافقة Majed → تثبيت → تسجيل (في الميثاق الكامل).
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## 7. مخرجاتنا — أين نكتب
|
|
133
|
+
|
|
134
|
+
كل جولة تنتج مجلداً في `security-reports/` بالمستودع:
|
|
135
|
+
|
|
136
|
+
```text
|
|
137
|
+
security-reports/
|
|
138
|
+
├── SECURITY_TEAM_CHARTER.md ← الميثاق الكامل (المصدر)
|
|
139
|
+
├── SECURITY_GATE_LOG.md ← سجل البوابات عبر الجولات
|
|
140
|
+
└── SEC-ROUND-{YYYY-MM-DD}-{NNN}/ ← جولة واحدة
|
|
141
|
+
├── 00_AUTHORIZATION.md ← التفويض والنطاق (يوقعه Majed)
|
|
142
|
+
├── 01_ATTACK_SURFACE.md ← خريطة سطح الهجوم (الشبح)
|
|
143
|
+
├── 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 ← سجل إعادة الاختبار بعد الإصلاحات
|
|
148
|
+
├── defense-handoff.md ← ملف الدفاع (الدرع → للشبح في White Box)
|
|
149
|
+
├── fix-review.md ← مراجعة الإصلاحات (الدرع)
|
|
150
|
+
└── evidence/
|
|
151
|
+
└── {TEST-ID}/
|
|
152
|
+
├── metadata.md ← الإصدار/البيئة/الوقت/الأداة/الدور/النتيجة
|
|
153
|
+
├── request.txt ← الطلب الفعلي (منقح)
|
|
154
|
+
├── response.txt ← الاستجابة الفعلية (منقحة)
|
|
155
|
+
├── screenshot.png ← عند الحاجة
|
|
156
|
+
└── tool-output.txt ← مخرجات الأداة
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
---
|
|
160
|
+
|
|
161
|
+
## 8. قواعدنا الحاكمة (غير قابلة للتفاوض)
|
|
162
|
+
|
|
163
|
+
1. **لا هجوم بلا `00_AUTHORIZATION.md`** مكتمل وموقع من Majed.
|
|
164
|
+
2. **لا PASS بلا دليل** — كل نتيجة تحتاج Request/Response أو Artifact.
|
|
165
|
+
3. **الأسرار تُنقّح** — `[REDACTED]` بدل أي قيمة حقيقية.
|
|
166
|
+
4. **فصل الأدوار ملزم** — من هاجم لا يدقق، من راقب لا يحكم.
|
|
167
|
+
5. **قرار التسليم** — بيد القاضي وحده، بعد الجولة الكاملة.
|
|
168
|
+
6. **Critical/High مفتوحة = لا تسليم.**
|
|
169
|
+
7. **لا توسيع للأثر** — نوقف عند إثبات كافٍ، لا نستمر في التخريب.
|
|
170
|
+
8. **بيئة معزولة** — بيانات وهمية فقط، ممنوع البيانات الحقيقية.
|
|
171
|
+
9. **التوثيق الكامل** — كل نتيجة موثقة بأدلتها في نفس الجولة.
|
|
172
|
+
|
|
173
|
+
---
|
|
174
|
+
|
|
175
|
+
## 9. سجل النتائج — Track Record
|
|
176
|
+
|
|
177
|
+
> النتائج التفصيلية في `security-reports/SECURITY_GATE_LOG.md` + مجلدات `SEC-ROUND-*`.
|
|
178
|
+
> ملخص الجولات المكتملة يُضاف هنا بعد كل جولة.
|
|
179
|
+
|
|
180
|
+
| Round ID | التطبيق | التاريخ | النوع | قرار القاضي | Critical/High |
|
|
181
|
+
|---|---|---|---|---|---|
|
|
182
|
+
| *(تُضاف بعد كل جولة)* | | | | | |
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
## 10. سجل التطور — Timeline
|
|
187
|
+
|
|
188
|
+
| التاريخ | الحدث |
|
|
189
|
+
|---|---|
|
|
190
|
+
| 2026-09-02 | **التأسيس** — SCP-2026-09-02-001: 3 عملاء جدد (الشبح/العين/القاضي) + تطوير الدرع + بروتوكول v2.0 + 15 أداة + بوابة Phase 7 + C4 model |
|
|
191
|
+
| 2026-09-02 | **النشر للحزم** — core 0.2.12 + pro 0.2.17 على npm + bundle v0.2.16 على teranoo.com |
|
|
192
|
+
| 2026-09-02 | **استكشاف أول** — فحص BlogCraft LAB: تأكيد 7 ثغرات (env leak, data exposure, SQLi, BFLA, BOLA, JWT storage, JWT forge→admin) |
|
|
193
|
+
| 2026-09-03 | **الميثاق** — توثيق رسمي للفريق + نسخة الجوهر المُوزَّعة (هذا الملف) |
|
|
194
|
+
|
|
195
|
+
---
|
|
196
|
+
|
|
197
|
+
## 11. العلاقة مع بقية المنظومة
|
|
198
|
+
|
|
199
|
+
| الملف/النظام | العلاقة |
|
|
200
|
+
|---|---|
|
|
201
|
+
| `security-reports/SECURITY_TEAM_CHARTER.md` | الميثاق الكامل (المصدر التفصيلي) |
|
|
202
|
+
| `security-reports/SECURITY_GATE_LOG.md` | سجل الجولات والنتائج |
|
|
203
|
+
| `tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md` | بوابة الأمن Phase 7 |
|
|
204
|
+
| `.opencode/agents/red-team-agent.md` + `security-observer.md` + `security-auditor.md` | عملاء الفريق |
|
|
205
|
+
| `tera-system/AGENT_ACTIVATION_MATRIX.md` | تفعيل عملاء الفريق (Phase 7 أو طلب Majed) |
|
|
206
|
+
| `tera-system/TOOLING_AND_MCP_POLICY.md` | السياسة الحاكمة للأدوات |
|
|
207
|
+
|
|
208
|
+
---
|
|
209
|
+
|
|
210
|
+
## 12. كيف تُفعَّل في أي جلسة
|
|
211
|
+
|
|
212
|
+
```text
|
|
213
|
+
عند طلب Majed تفعيل الفريق:
|
|
214
|
+
1. اقرأ هذا الميثاق (الجوهر — موجود معك دائماً عبر الحزمة)
|
|
215
|
+
2. اقرأ security-reports/SECURITY_TEAM_CHARTER.md إن توفر (التفاصيل)
|
|
216
|
+
3. جهّز 00_AUTHORIZATION.md (النطاق + الحدود + الحسابات)
|
|
217
|
+
4. فعّل: الشبح يهاجم + العين يراقب + القاضي يحكم
|
|
218
|
+
5. المخرجات في security-reports/SEC-ROUND-{date}-{nn}/
|
|
219
|
+
6. سجّل النتيجة في SECURITY_GATE_LOG.md
|
|
220
|
+
```
|
|
221
|
+
|
|
222
|
+
---
|
|
223
|
+
|
|
224
|
+
*© 2026 Majed Khaireddin (Alabasi1980). Tera System — Proprietary. All rights reserved.*
|
|
225
|
+
*نسخة الجوهر المُوزَّعة — المصدر الكامل في المستودع الأصلي.*
|
|
@@ -198,6 +198,49 @@ powershell -ExecutionPolicy Bypass -File .\tools\tera-tooling.ps1 -Install
|
|
|
198
198
|
|
|
199
199
|
---
|
|
200
200
|
|
|
201
|
+
### 3.7 الأدوات الهجومية لفريق الحماية (SCP-2026-09-02-001)
|
|
202
|
+
|
|
203
|
+
تُستخدم فقط بواسطة عملاء فريق الحماية (الشبح/العين/القاضي) ضمن تفويض مكتوب — في بيئة Local/Staging معزولة ببيانات وهمية. لا تُستخدم على Production ولا على أطراف ثالثة.
|
|
204
|
+
|
|
205
|
+
| الأداة | الشكل | الاستخدام | ضمان التوفر |
|
|
206
|
+
|---|---|---|---|
|
|
207
|
+
| **Burp Suite Pro v2026.1.5** | JAR خارجي (Java) | الالتقاط + Repeater + Intruder — الأداة الهجومية الرئيسية | `java -jar <path>/burpsuite_pro_v2026.1.5.jar` — لا تُضمَّن ملفات الترخيص في المستودع |
|
|
208
|
+
| **OWASP ZAP** | تطبيق (Java) | DAST/Fuzzer احتياطي | تنزيل من zaproxy.org — بديل كامل لـ Burp مجاناً |
|
|
209
|
+
| **Nmap** | CLI | اكتشاف المنافذ والخدمات | `winget install Insecure.Nmap` |
|
|
210
|
+
| **ffuf** | CLI (Go) | Fuzzing المسارات والمعاملات | تنزيل من GitHub releases |
|
|
211
|
+
| **Nuclei** | CLI (Go) | قوالب الثغرات المعروفة | تنزيل من GitHub releases (projectdiscovery) |
|
|
212
|
+
| **sqlmap** | CLI (Python) | أتمتة SQL Injection | `pip install sqlmap` |
|
|
213
|
+
| **dalfox** | CLI (Go) | أتمتة XSS | تنزيل من GitHub releases (hahwul) |
|
|
214
|
+
| **Hydra** | CLI | Brute Force (ضمن حدود التفويض) | build من GitHub — إن لم يعمل على Windows: ZAP Fuzzer بديل |
|
|
215
|
+
| **Metasploit** | Framework | إثبات الاستغلال | مثبّت Rapid7 (Windows — محدود) + Docker/Kali كاحتياط كامل |
|
|
216
|
+
| **John the Ripper** | CLI | كسر الهاشات | تنزيل من GitHub (Jumbo build) |
|
|
217
|
+
| **Wireshark** | CLI/GUI | تحليل الحزم (العين) | `winget install WiresharkFoundation.Wireshark` |
|
|
218
|
+
| **k6** | CLI (Go) | اختبار التحمل (§15 البروتوكول) | `winget install GrafanaLabs.k6` — أُلغي تأجيله من §4 |
|
|
219
|
+
|
|
220
|
+
**قواعد الاستخدام الهجومي:**
|
|
221
|
+
1. لا هجوم بلا `00_AUTHORIZATION.md` مكتمل في `security-reports/[ROUND-ID]/`.
|
|
222
|
+
2. جميع الأدوات CLI — لا MCPs جديدة (لا استهلاك توكنز دائم).
|
|
223
|
+
3. النتائج تُحفظ كأدلة في `security-reports/[ROUND-ID]/evidence/`.
|
|
224
|
+
4. توقّف فوري عند مؤشرات الإيقاف (البروتوكول §18).
|
|
225
|
+
5. Burp Suite Pro أداة تجارية — مسؤولية الترخيص على المالك؛ لا تُضمَّن ملفات تفعيل في المستودع.
|
|
226
|
+
|
|
227
|
+
---
|
|
228
|
+
|
|
229
|
+
### 3.8 خطة Cloud المرجعية — DigitalOcean (SCP-2026-09-02-001 — بلا تثبيت الآن)
|
|
230
|
+
|
|
231
|
+
عند أول رفع تطبيق على DigitalOcean، تُفعَّل هذه الحزمة في جلسة واحدة (Anti-Bloat: لا تثبيت قبل الحاجة):
|
|
232
|
+
|
|
233
|
+
| الأداة | الشكل | الاستخدام | التزويد |
|
|
234
|
+
|---|---|---|---|
|
|
235
|
+
| **doctl** | CLI رسمي من DO | إدارة/قراءة موارد DO (Droplets, Firewalls, Spaces, DNS...) | `winget install DigitalOcean.Doctl` |
|
|
236
|
+
| **compliancekit** | CLI مفتوح المصدر | 144 فحصاً لـ DO + 119 فحص CIS Linux — ينتج حزمة أدلة جاهزة للتدقيق | تنزيل من GitHub (darpanzope/compliancekit) + `DO_API_TOKEN` (read scope) |
|
|
237
|
+
| **DO CSPM** | مدمج في لوحة التحكم | فحص وضعية سحابي agentless (مجاني للقاعدة) | بلا أدوات — من لوحة DO |
|
|
238
|
+
| **Lynis** | CLI | تدقيق تصلب Linux على الـ Droplets | عبر SSH على الخادم |
|
|
239
|
+
|
|
240
|
+
**قاعدة:** تُفعَّل عند أول تطبيق Production على DO — لا قبلها.
|
|
241
|
+
|
|
242
|
+
---
|
|
243
|
+
|
|
201
244
|
## 4. MCPs المؤجلة (ليست الآن)
|
|
202
245
|
|
|
203
246
|
| الأداة | السبب | وقت التفعيل المقترح |
|
|
@@ -213,7 +256,7 @@ powershell -ExecutionPolicy Bypass -File .\tools\tera-tooling.ps1 -Install
|
|
|
213
256
|
| **Monitoring / Logging MCPs** | غير ضرورية قبل وجود تطبيق قيد التشغيل الفعلي. | عند وجود تطبيق في Production يحتاج مراقبة. |
|
|
214
257
|
| **SonarQube** | بوابة جودة مركزية قوية لكنها تحتاج خادماً + CI. Semgrep + Trivy + Gitleaks تغطي احتياجنا الحالي. | عند اعتماد CI/CD رسمي أو مشروع كبير يحتاج قياساً مستمراً للتغطية/التكرار. |
|
|
215
258
|
| **Sentry MCP** | مراقبة الأخطاء — مفيدة فقط عند وجود تطبيق في Production. حالياً Sentry SDK قاعدة FLAG في التسليم. | عند أول تطبيق Production فعلي. |
|
|
216
|
-
| **k6** |
|
|
259
|
+
| **k6** | ~~اختبارات أداء/ضغط~~ — **انتقل إلى §3.7 الأدوات الهجومية (SCP-2026-09-02-001)** — اختبار تحمل ضمن بروتوكول الأمن قبل التسليم | ✅ فُعّل 2026-09-02 |
|
|
217
260
|
|
|
218
261
|
---
|
|
219
262
|
|
|
@@ -26,6 +26,7 @@ It is a map, not a policy source. Rules remain in the files listed in `TeraPolic
|
|
|
26
26
|
| 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/` |
|
|
27
27
|
| Project implementation knowledge | Maintains concise current-state operational knowledge per screen/module/service | `project-knowledge/` داخل كل تطبيق |
|
|
28
28
|
| 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`) via fetch + verified release packages (Tag `tera-vX.Y.Z` + Manifest + SHA lockfile + updater tools); npm packages `@tera-system/core 0.2.10` + `@tera-system/pro 0.2.14`; 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` داخل مستودعات العملاء |
|
|
29
|
+
| 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
30
|
|
|
30
31
|
## 3. Folder Roles
|
|
31
32
|
|
|
@@ -47,6 +48,7 @@ It is a map, not a policy source. Rules remain in the files listed in `TeraPolic
|
|
|
47
48
|
| `book/` | Comprehensive user-facing documentation and guides (Quick Start, Vision, Quality, Policies) | Runtime operational files; per-project records |
|
|
48
49
|
| `book-pro-user-guide/` | دليل المشتري العملي لـ Pro — من التثبيت إلى التسليم (Onboarding) — 13 فصل + مولد HTML | Runtime operational files; per-project records |
|
|
49
50
|
| `architecture/` | Structurizr C4 workspace (`.dsl` source of truth + exported diagrams) | Application code; client project files |
|
|
51
|
+
| `security-reports/` | Adversarial security validation outputs (authorization, attack surface, evidence, findings, observer/audit reports, gate decisions) — same repo, outside the application folder (SCP-2026-09-02-001) | Application code; client-owned files; system policy files |
|
|
50
52
|
|
|
51
53
|
## 4. Core Flow
|
|
52
54
|
|
|
@@ -214,7 +214,7 @@ If a file is not applicable to a very small project, Tera must still create an e
|
|
|
214
214
|
| Gate 3: Flow Approval | The client confirms the main user and business flows. |
|
|
215
215
|
| Gate 4: Screen Approval | The client confirms the screen list and screen purposes. |
|
|
216
216
|
| Gate 5: Design Direction Approval | The client confirms visual direction, tone, and references. |
|
|
217
|
-
| Gate 6: Prototype Approval | The client confirms the prototype
|
|
217
|
+
| Gate 6: Prototype Approval | The client confirms the actual prototype via a formal approval letter. Mandatory for all applications; only a documented Majed waiver (WAIVED_BY_MAJED) can exempt it. The prototype is a **priced, included line item**: 10% of the final price, auto-calculated in the pricing calculator, shown as a separate line in the quotation, and waived to 0% only when both parties agree the prototype is not needed at all (WAIVED_BY_MAJED + client consent — SCP-2026-09-01-001). Rejection of a built prototype does not cancel its cost; it is handled via the existing Fix / Change Request mechanism. |
|
|
218
218
|
| Gate 7: Execution Authorization | The client authorizes moving into implementation. |
|
|
219
219
|
|
|
220
220
|
### Approval Record
|
|
@@ -37,13 +37,15 @@
|
|
|
37
37
|
|
|
38
38
|
---
|
|
39
39
|
|
|
40
|
-
## 6.1 SecurityAgent
|
|
40
|
+
## 6.1 SecurityAgent — اللقب: الدرع 🛡️
|
|
41
41
|
|
|
42
42
|
| البند | القيمة |
|
|
43
43
|
|---|---|
|
|
44
44
|
| المعرّف | `SECURITY_AGENT` |
|
|
45
|
+
| اللقب | **الدرع (The Shield)** |
|
|
45
46
|
| الفئة | مشروط |
|
|
46
47
|
| شرط الاستدعاء | بيانات حساسة، أسرار، Auth، Permissions، Middleware، Config، صلاحيات متقدمة، مدفوعات، إنترنت عام، حسابات إدارية مهمة |
|
|
48
|
+
| دوره في الفريق | **الدفاع** — عضو فريق الحماية (SCP-2026-09-02-001): يحمي أثناء البناء، يحضّر ملفات الهجوم، يراجع الإصلاحات |
|
|
47
49
|
|
|
48
50
|
### يقرأ
|
|
49
51
|
|
|
@@ -57,6 +59,7 @@ project-control/PROJECT_ACTIVITY_LOG.md عند الحاجة
|
|
|
57
59
|
project-control/ISSUES_AND_GAPS.md عند وجود حادثة أو فجوة أمنية
|
|
58
60
|
project-control/DECISIONS_LOG.md عند الحاجة
|
|
59
61
|
project-control/TERA_ACTIVE_CONTEXT.md إذا كان موجودًا وطلبه Tera
|
|
62
|
+
security-reports/[ROUND-ID]/findings/ عند مراجعة الإصلاحات بعد جولة Red Team
|
|
60
63
|
```
|
|
61
64
|
|
|
62
65
|
### يساهم في
|
|
@@ -65,14 +68,27 @@ project-control/TERA_ACTIVE_CONTEXT.md إذا كان موجودًا وطلبه T
|
|
|
65
68
|
15_SECURITY_AND_ACCESS_CONTROL.md
|
|
66
69
|
16_AUDIT_LOG_AND_ACTIVITY_TRACKING.md
|
|
67
70
|
21_VALIDATION_AND_ERROR_HANDLING.md
|
|
71
|
+
security-reports/[ROUND-ID]/defense-handoff.md ← ملف الدفاع المُسلَّم للـ Red Team
|
|
72
|
+
security-reports/[ROUND-ID]/fix-review.md ← مراجعة الإصلاحات بعد Findings
|
|
68
73
|
```
|
|
69
74
|
|
|
75
|
+
### دوره في فريق الحماية (SCP-2026-09-02-001)
|
|
76
|
+
|
|
77
|
+
الدرع **عضو دفاعي** في فريق الحماية — لا يهاجم أبداً (فصل الأدوار ملزم بالبروتوكول §2):
|
|
78
|
+
|
|
79
|
+
1. **أثناء التطوير:** مراجعة أمنية دفاعية — يقرأ الكود، يحلل الصلاحيات والجلسات والأسرار، يوثق findings.
|
|
80
|
+
2. **قبل جولة Red Team:** يحضّر `defense-handoff.md` — البنية، الأدوار، مصفوفة الصلاحيات، مناطق الخطر المعروفة (يسلّمها Tera للشبح ضمن White Box).
|
|
81
|
+
3. **بعد Findings:** يراجع الإصلاحات التي نفذها Engineering — `fix-review.md` — ويتأكد أنها أصلحت الجذر وليس العرض.
|
|
82
|
+
4. **استشارياً:** يجيب عن أسئلة أمنية أثناء التطوير (Auth, JWT, Cookies, Middleware, Secrets).
|
|
83
|
+
|
|
70
84
|
### حدوده
|
|
71
85
|
|
|
72
86
|
- لا يستبدل QA.
|
|
73
87
|
- لا يغير UX إلا إذا وُجد خطر أمني.
|
|
74
88
|
- لا يقرر تعطيل ميزة دون رفع القرار لتيرا.
|
|
75
89
|
- لا يقبل المهمة بنفسه؛ يسلّم نتيجة المراجعة إلى Tera فقط.
|
|
90
|
+
- **لا ينفذ هجمات فعلية** — ذلك دور الشبح (Red Team Agent). الدرع لا يختبر ما قرأ أسراره — وإلا انكسرت Black Box.
|
|
91
|
+
- **لا يصدر قرار التسليم الأمني النهائي** — ذلك دور القاضي (Security Auditor).
|
|
76
92
|
- عند مراجعة السجلات أو ملفات المهمة، يجب أن يراجع أيضًا النصوص التي أنشأها Tera نفسه، وليس فقط ملفات الكود التي أنشأها EngineeringAgent.
|
|
77
93
|
- عند توثيق أي حادثة Secret Exposure أو ملاحظة أمنية، يجب استخدام `[REDACTED]` فقط وعدم إعادة كتابة القيمة المسرّبة.
|
|
78
94
|
|
|
@@ -64,7 +64,9 @@ Project files record project-specific decisions.
|
|
|
64
64
|
| Technology profiles | `tera-system/profiles/` | `.opencode/agents/tera.md` | Stack-specific rules stay in profiles. |
|
|
65
65
|
| 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
66
|
| 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
|
-
| 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. |
|
|
67
|
+
| 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
|
+
| 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. ينفذه الشبح، يراقبه العين، يدققه القاضي. |
|
|
68
70
|
| 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. |
|
|
69
71
|
| 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. |
|
|
70
72
|
| 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. |
|
|
@@ -107,6 +109,7 @@ Project files record project-specific decisions.
|
|
|
107
109
|
| BTCA — Report Templates | `tera-system/consulting-helpers/BTCA_REPORT_TEMPLATES.md` | `.opencode/agents/tera-business-transformation-consultant.md` | قوالب التقارير العشرة الأساسية + التقرير التنفيذي. |
|
|
108
110
|
| 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`** + الحزم `@tera-system/core 0.2.10` / `@tera-system/pro 0.2.14` + **الموقع `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. |
|
|
109
111
|
| 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. |
|
|
112
|
+
| 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. |
|
|
110
113
|
| 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. |
|
|
111
114
|
| Payment/Receipt vouchers | `tera-workshop/client-templates/financial/VOUCHER_DESIGN_SPEC.md` + `tera-system/TeraPricingPolicy.md` (§21) | `VOUCHER_RECEIPT_TEMPLATE.html` + `VOUCHER_PAYMENT_TEMPLATE.html` | سند قبض + سند صرف مستقلان (210×156مم، سند واحد في كل ملف، صورة الترويسة كاملة بعرض 210مم وارتفاعها الطبيعي) — `V2.png` للقبض و`V1.png` للصرف — ترقيم مالي مستقل `{السنة}-{تسلسل}` + حقل مرجع يربط بترميز خطابات العميل. SCP-2026-08-29-006/007/008/009/010/011. |
|
|
112
115
|
| Pro User Guide (Onboarding) | `book-pro-user-guide/` (13 فصل + فهرس + مولد HTML) | `WELCOME.md` في الحزم (ملخص) | دليل المشتري العملي لـ `@tera-system/pro` — من `npm install` إلى التسليم. مكمل لـ `book/` الداخلي. لغة عربية + مصطلحات إنجليزية. SCP-2026-08-30-003. |
|
|
@@ -447,6 +447,22 @@ Minimum Profitable Price = Estimated Hours × Internal Hourly Rate
|
|
|
447
447
|
|
|
448
448
|
---
|
|
449
449
|
|
|
450
|
+
## 17.5 البروتوتايب التصميمي — بند تسعير إلزامي (SCP-2026-09-01-001)
|
|
451
|
+
|
|
452
|
+
البروتوتايب التصميمي إلزامي لكل التطبيقات (SCP-2026-08-28-001) وهو **بند مسعّر مشمول في عرض السعر** — لا يُبنى خارج التسعير ولا يُترك ضمنياً داخل ساعات الواجهات.
|
|
453
|
+
|
|
454
|
+
| البند | القاعدة |
|
|
455
|
+
|---|---|
|
|
456
|
+
| **الإلزامية** | كل تطبيق (خارجي أو داخلي) يتطلب بروتوتايب تصميمي معتمد قبل التنفيذ — الاستثناء الوحيد: `WAIVED_BY_MAJED` (SCP-2026-08-28-001) |
|
|
457
|
+
| **النسبة** | 10% من **السعر النهائي** (B57 — بعد كل تعديلات Platform/Language/Add-ons/Risk/Rush وقبل الإجمالي النهائي) — قابلة للتعديل اليدوي في الحاسبة بقرار Majed فقط (الافتراضي 10%) |
|
|
458
|
+
| **الاحتساب** | تلقائي في `TeraPricingCalculator.xlsx` — `قيمة البروتوتايب = IF(مطلوب="نعم", ROUND(السعر_النهائي × النسبة, 0), 0)` |
|
|
459
|
+
| **العرض** | بند ظاهر منفصل في `DRAFT_QUOTATION.md` و`QUOTATION_TEMPLATE`: "البروتوتايب التصميمي — 10% من قيمة التطوير = X JOD" — السعر الإجمالي = السعر النهائي + قيمة البروتوتايب |
|
|
460
|
+
| **الإلغاء الوحيد** | اتفاق الطرفين (الزبون + Tera) على عدم الحاجة للبروتوتايب **أصلاً** — عبر `WAIVED_BY_MAJED` + موافقة الزبون — عندها النسبة = 0% تلقائياً ولا يُسعّر أي بروتوتايب |
|
|
461
|
+
| **رفض البروتوتايب المعروض** | رفض الزبون للبروتوتايب الذي **بُني وعُرض** (لم يُعجبه) لا يُلغي التكلفة — الجهد بُذل فعلاً؛ يُعالج عبر الآلية القائمة: تعديلات غير مؤثرة = Fix، مؤثرة = Change Request مسعّر (Gate 6 / SCP-2026-08-28-001) |
|
|
462
|
+
| **ساعات البروتوتايب** | تُقدَّر ضمن "واجهات وشاشات UI" في HoursEstimator — لا تُضاف كبند ساعات مستقل (لا تداخل) |
|
|
463
|
+
|
|
464
|
+
---
|
|
465
|
+
|
|
450
466
|
## 18. الحد الأدنى المطلق
|
|
451
467
|
|
|
452
468
|
```text
|
|
@@ -155,13 +155,33 @@ Auditor (مُدقق) هو عميل جودة فرعي، وليس عميلاً ر
|
|
|
155
155
|
|
|
156
156
|
`Model Capability Gate` is a Tera-side assessment only.
|
|
157
157
|
|
|
158
|
-
It does not replace:
|
|
159
|
-
|
|
160
|
-
- `SoftwareDesignerAgent`
|
|
161
|
-
- `SecurityAgent`
|
|
162
|
-
- `QAAndAcceptanceAgent`
|
|
163
|
-
- `ProjectControlAgent`
|
|
164
|
-
- `Post-Execution Review Gate`
|
|
158
|
+
It does not replace:
|
|
159
|
+
|
|
160
|
+
- `SoftwareDesignerAgent`
|
|
161
|
+
- `SecurityAgent`
|
|
162
|
+
- `QAAndAcceptanceAgent`
|
|
163
|
+
- `ProjectControlAgent`
|
|
164
|
+
- `Post-Execution Review Gate`
|
|
165
|
+
|
|
166
|
+
### 3.2.3 Security Team (فريق الحماية — SCP-2026-09-02-001)
|
|
167
|
+
|
|
168
|
+
فريق أمني رباعي الأدوار للتحقق الهجومي قبل التسليم:
|
|
169
|
+
|
|
170
|
+
| الدور | اللقب | الملف | الوظيفة |
|
|
171
|
+
|---|---|---|---|
|
|
172
|
+
| دفاعي | الدرع | `TeraHelperAgents.md` §6.1 | مراجعة أمنية أثناء التطوير + تحضير ملفات الدفاع + مراجعة الإصلاحات |
|
|
173
|
+
| هجومي | الشبح | `.opencode/agents/red-team-agent.md` | اختبار هجومي فعلي (Black Box ثم Gray/White Box) |
|
|
174
|
+
| مراقب | العين | `.opencode/agents/security-observer.md` | مراقبة متزامنة للسجلات والموارد والـ Canary |
|
|
175
|
+
| مدقق | القاضي | `.opencode/agents/security-auditor.md` | تدقيق الأدلة + قرار بوابة الأمن (PASS/CONDITIONAL/FAIL/INCOMPLETE) |
|
|
176
|
+
|
|
177
|
+
قواعد الفريق:
|
|
178
|
+
|
|
179
|
+
- **فصل الأدوار ملزم** (البروتوكول §2): من نفّذ الهجوم لا يدقق. من راقب لا يحكم.
|
|
180
|
+
- **التفعيل:** Phase 7 (بوابة التسليم) أو طلب Majed الصريح فقط — لا تفعيل تلقائي في Phases 1–6.
|
|
181
|
+
- **المخرجات:** `security-reports/` في نفس المستودع خارج مجلد التطبيق.
|
|
182
|
+
- **التفويض:** لا هجوم بلا `00_AUTHORIZATION.md` مكتمل (نطاق + بيئة + حدود + مؤشرات إيقاف).
|
|
183
|
+
- **الأدلة:** لا PASS بلا Request/Response فعلي أو Artifact موثق — غياب الثغرة من Scanner ليس نجاحاً.
|
|
184
|
+
- **قرار التسليم:** القاضي وحده يصدر قرار بوابة الأمن — بعد Red Team + Observer + Fixes + Retest.
|
|
165
185
|
|
|
166
186
|
Its role is to help Tera decide whether the current model is sufficient, sufficient with safeguards, needs escalation, or whether the task should be split first.
|
|
167
187
|
|
|
@@ -98,7 +98,7 @@ description: TCEA pricing workflow, tools, reference sources, and client documen
|
|
|
98
98
|
5. **اختر المضاعفات** — المنصة (Web/Mobile/PWA)، اللغة، هامش المخاطر، بدل الاستعجال
|
|
99
99
|
6. **أضف الإضافات** — حدد مستوى كل Add-on. ⚠️ قاعدة التناسب: مجموع Add-ons ≤ 50% من Base Price
|
|
100
100
|
7. **أدخل الساعات المقدرة** — السعر المعتمد لا يقل عن: الساعات × 4 JOD
|
|
101
|
-
8. **اقرأ النتيجة** — السعر المعتمد النهائي + فحص التناسب + تصنيف السعر
|
|
101
|
+
8. **اقرأ النتيجة** — السعر المعتمد النهائي + فحص التناسب + تصنيف السعر + **بند البروتوتايب** (اقرأ القيمة التلقائية من الخلية B67 — 10% من السعر النهائي — والإجمالي شامل البروتوتايب من B68 — SCP-2026-09-01-001). إذا كانت B65 = "لا (WAIVED)" (اتفاق الطرفين على عدم الحاجة أصلاً) → القيمة 0 وتُحذف من العرض.
|
|
102
102
|
9. **استخدم قائمة الاعتماد** — TeraPricingPolicy.md §29 (14 سؤالاً) — جميع الإجابات "نعم" إلزامياً
|
|
103
103
|
10. **املأ قالب الخطاب الرسمي** — `letterhead-master-fixed-print.html` معبأ ببيانات المشروع والسعر
|
|
104
104
|
|
|
@@ -172,6 +172,16 @@ Exit Gate:
|
|
|
172
172
|
- [ ] Deferred Items documented.
|
|
173
173
|
- [ ] Final closure decision recorded in `PROJECT_ACTIVITY_LOG.md` and `PROJECT_STATE.md`.
|
|
174
174
|
|
|
175
|
+
**Security Gate (SCP-2026-09-02-001 — Team Security):**
|
|
176
|
+
|
|
177
|
+
- [ ] Tera decided: `SECURITY_TEST_REQUIRED` / `SECURITY_TEST_WAIVED_BY_MAJED` (with documented reason) for this delivery.
|
|
178
|
+
- [ ] If required: Red Team (الشبح) engagement completed → `security-reports/[ROUND-ID]/` contains authorization, attack surface, evidence, findings.
|
|
179
|
+
- [ ] Observer (العين) report completed concurrently.
|
|
180
|
+
- [ ] All Critical/High findings fixed (or accepted in writing by Majed) and retested by الشبح.
|
|
181
|
+
- [ ] القاضي (Security Auditor) issued final gate decision: **PASS / CONDITIONAL PASS / FAIL / INCOMPLETE**.
|
|
182
|
+
- [ ] Delivery is BLOCKED until gate = PASS or CONDITIONAL PASS (accepted Medium/Low only).
|
|
183
|
+
- [ ] For small internal projects: Majed may waive the full engagement (`SECURITY_TEST_WAIVED_BY_MAJED`) but the gate decision must still be recorded.
|
|
184
|
+
|
|
175
185
|
If Phase 7 finds a blocking issue:
|
|
176
186
|
|
|
177
187
|
1. Do not fix it inside Phase 7.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tera-system/core",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.13",
|
|
4
4
|
"description": "Tera System OpenCode Plugin أ¢â‚¬â€ governance core, 20 agents, 11 commands, distribution tools (personal edition)",
|
|
5
5
|
"license": "SEE LICENSE IN LICENSE.md",
|
|
6
6
|
"type": "module",
|
package/tools/tera-tooling.ps1
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
<#
|
|
2
2
|
=============================================================================
|
|
3
|
-
tera-tooling.ps1 - Tera
|
|
3
|
+
tera-tooling.ps1 - Tera Toolchain provisioning (SCP-2026-08-29-012 + SCP-2026-09-02-001)
|
|
4
4
|
=============================================================================
|
|
5
|
-
Verifies (and optionally installs) the
|
|
5
|
+
Verifies (and optionally installs) the approved Tera tools so every
|
|
6
6
|
repository has a guaranteed, consistent toolchain:
|
|
7
7
|
|
|
8
8
|
Tool Kind Installer used
|
|
@@ -12,6 +12,14 @@
|
|
|
12
12
|
Structurizr MCP (uv) uv (Astral) + Docker (validate/export)
|
|
13
13
|
Gitleaks CLI winget install Gitleaks.Gitleaks
|
|
14
14
|
Trivy CLI winget install AquaSecurity.Trivy
|
|
15
|
+
Nmap offensive winget install Insecure.Nmap
|
|
16
|
+
Wireshark offensive winget install WiresharkFoundation.Wireshark
|
|
17
|
+
k6 offensive winget install GrafanaLabs.k6
|
|
18
|
+
ffuf/Nuclei/dalfox offensive GitHub releases (Go binary)
|
|
19
|
+
sqlmap offensive pip install sqlmap
|
|
20
|
+
Burp/ZAP/Hydra/Metasploit/John offensive external installers (reported)
|
|
21
|
+
|
|
22
|
+
Cloud (DigitalOcean) tools are DEFERRED until first app deployment (SCP-2026-09-02-001).
|
|
15
23
|
|
|
16
24
|
Usage:
|
|
17
25
|
powershell -ExecutionPolicy Bypass -File .\tools\tera-tooling.ps1 # report only
|
|
@@ -105,6 +113,91 @@ if ($Install -and $pwMCP) {
|
|
|
105
113
|
}
|
|
106
114
|
Add-Row 'Playwright' 'MCP' $pwMCP 'npx @playwright/mcp (auto)'
|
|
107
115
|
|
|
116
|
+
# ---- Offensive Security Tools (SCP-2026-09-02-001 - Team Security) ----------
|
|
117
|
+
# Used only by Team Security agents within a written authorization scope.
|
|
118
|
+
# Verified via known install paths (winget installs may not be on PATH in a fresh shell).
|
|
119
|
+
$offensiveKnownPaths = @(
|
|
120
|
+
@{ Name = 'Nmap'; Test = "${env:ProgramFiles(x86)}\Nmap\nmap.exe"; Alt = 'nmap'; VersionArg = '--version'; Install = 'winget install --id Insecure.Nmap -e --silent --accept-package-agreements --accept-source-agreements' },
|
|
121
|
+
@{ Name = 'Wireshark'; Test = "$env:ProgramFiles\Wireshark\tshark.exe"; Alt = 'tshark'; VersionArg = '--version'; Install = 'winget install --id WiresharkFoundation.Wireshark -e --silent --accept-package-agreements --accept-source-agreements' },
|
|
122
|
+
@{ Name = 'k6'; Test = "$env:ProgramFiles\k6\k6.exe"; Alt = 'k6'; VersionArg = 'version'; Install = 'winget install --id GrafanaLabs.k6 -e --silent --accept-package-agreements --accept-source-agreements' }
|
|
123
|
+
)
|
|
124
|
+
foreach ($t in $offensiveKnownPaths) {
|
|
125
|
+
$ok = (Test-Path -LiteralPath $t.Test) -or (Test-Command $t.Alt $t.VersionArg)
|
|
126
|
+
if (-not $ok -and $Install) { $ok = Invoke-BestEffort "$($t.Name) install" { Invoke-Expression $t.Install | Out-Null } }
|
|
127
|
+
Add-Row $t.Name 'offensive' $ok $t.Install
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
# Go-based offensive tools (installed under %LOCALAPPDATA%\Tera-Tools)
|
|
131
|
+
$teraTools = "$env:LOCALAPPDATA\Tera-Tools"
|
|
132
|
+
$goToolPaths = @(
|
|
133
|
+
@{ Name = 'ffuf'; Path = "$teraTools\ffuf\ffuf.exe"; VersionArg = '-V' },
|
|
134
|
+
@{ Name = 'Nuclei'; Path = "$teraTools\nuclei\nuclei.exe"; VersionArg = '-version' },
|
|
135
|
+
@{ Name = 'dalfox'; Path = (Get-ChildItem "$teraTools\dalfox" -Recurse -Filter 'dalfox.exe' -ErrorAction SilentlyContinue | Select-Object -First 1).FullName; VersionArg = 'version' }
|
|
136
|
+
)
|
|
137
|
+
foreach ($t in $goToolPaths) {
|
|
138
|
+
$ok = ($t.Path -and (Test-Path -LiteralPath $t.Path))
|
|
139
|
+
if (-not $ok -and $Install) {
|
|
140
|
+
Write-Host " ! $($t.Name) requires manual download (Go binary for Windows) - see TOOLING_AND_MCP_POLICY.md §3.7"
|
|
141
|
+
$ok = $false
|
|
142
|
+
}
|
|
143
|
+
Add-Row $t.Name 'offensive' $ok "Tera-Tools download: $($t.Path)"
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
# Python-based offensive tools
|
|
147
|
+
# sqlmap official repo clone (pip package is broken on Windows - ModuleNotFoundError)
|
|
148
|
+
$sqlmapPy = "$env:LOCALAPPDATA\Tera-Tools\sqlmap\sqlmap.py"
|
|
149
|
+
$sqlmapOk = Test-Path -LiteralPath $sqlmapPy
|
|
150
|
+
if (-not $sqlmapOk -and $Install) {
|
|
151
|
+
Write-Host ' Installing sqlmap from official repo (git clone)...'
|
|
152
|
+
$sqlmapDir = "$env:LOCALAPPDATA\Tera-Tools\sqlmap"
|
|
153
|
+
New-Item -ItemType Directory -Path $sqlmapDir -Force | Out-Null
|
|
154
|
+
$sqlmapOk = Invoke-BestEffort 'sqlmap clone' { git clone --depth 1 https://github.com/sqlmapproject/sqlmap.git $sqlmapDir }
|
|
155
|
+
}
|
|
156
|
+
Add-Row 'sqlmap' 'offensive' $sqlmapOk 'git clone sqlmapproject/sqlmap (run: python sqlmap.py)'
|
|
157
|
+
|
|
158
|
+
# Manual tools (checked but not auto-installable)
|
|
159
|
+
$burpOk = Test-Path -LiteralPath 'F:\burpsuite_profissional_2026.1.5\BurpSuite profissional v2026.1.5\burpsuite_pro_v2026.1.5.jar'
|
|
160
|
+
Add-Row 'Burp Suite Pro' 'offensive' $burpOk 'java -jar [path]/burpsuite_pro_v2026.1.5.jar (external)'
|
|
161
|
+
|
|
162
|
+
$zapOk = (Test-Path -LiteralPath "$env:ProgramFiles\ZAP\Zed Attack Proxy\zap.bat") -or (Test-Command 'zap' '--version')
|
|
163
|
+
if (-not $zapOk -and $Install) {
|
|
164
|
+
Write-Host ' ! OWASP ZAP requires manual download from https://www.zaproxy.org/download/'
|
|
165
|
+
$zapOk = $false
|
|
166
|
+
}
|
|
167
|
+
Add-Row 'OWASP ZAP' 'offensive' $zapOk 'winget install ZAP.ZAP / zaproxy.org'
|
|
168
|
+
|
|
169
|
+
$hydraOk = Test-Command 'hydra' '-h'
|
|
170
|
+
if (-not $hydraOk -and $Install) {
|
|
171
|
+
Write-Host ' ! THC-Hydra on Windows is not guaranteed; fallback: ZAP Fuzzer.'
|
|
172
|
+
$hydraOk = $false
|
|
173
|
+
}
|
|
174
|
+
Add-Row 'Hydra' 'offensive' $hydraOk 'GitHub build (fallback: ZAP Fuzzer)'
|
|
175
|
+
|
|
176
|
+
$msfOk = Test-Command 'msfconsole' '--version'
|
|
177
|
+
if (-not $msfOk -and $Install) {
|
|
178
|
+
Write-Host ' ! Metasploit: use Rapid7 Windows installer or Docker (kali) fallback.'
|
|
179
|
+
$msfOk = $false
|
|
180
|
+
}
|
|
181
|
+
Add-Row 'Metasploit' 'offensive' $msfOk 'Rapid7 installer / Docker (kali)'
|
|
182
|
+
|
|
183
|
+
$johnOk = Test-Command 'john' '--version'
|
|
184
|
+
if (-not $johnOk -and $Install) {
|
|
185
|
+
Write-Host ' ! John the Ripper: download Jumbo build from GitHub.'
|
|
186
|
+
$johnOk = $false
|
|
187
|
+
}
|
|
188
|
+
Add-Row 'John the Ripper' 'offensive' $johnOk 'GitHub Jumbo build'
|
|
189
|
+
|
|
190
|
+
# ---- Cloud Reference Tools (DigitalOcean - SCP-2026-09-02-001) ---------------
|
|
191
|
+
# Deferred by design (Anti-Bloat): activated only when the first app is deployed to DO.
|
|
192
|
+
if (-not $Quiet) {
|
|
193
|
+
Write-Host ''
|
|
194
|
+
Write-Host ' Cloud (DigitalOcean) tools are DEFERRED until first app deployment on DO:'
|
|
195
|
+
Write-Host ' - doctl (winget install DigitalOcean.Doctl)'
|
|
196
|
+
Write-Host ' - compliancekit (github.com/darpanzope/compliancekit) + DO_API_TOKEN'
|
|
197
|
+
Write-Host ' - DO CSPM (built into DO dashboard)'
|
|
198
|
+
Write-Host ' - Lynis (over SSH on Droplets)'
|
|
199
|
+
}
|
|
200
|
+
|
|
108
201
|
# ---- Report ----------------------------------------------------------------
|
|
109
202
|
Write-Host ""
|
|
110
203
|
Write-Host ("{0,-22} {1,-10} {2,-8} {3}" -f 'Tool', 'Kind', 'Status', 'Action')
|