@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.
- package/MANIFEST.json +5 -5
- package/README.md +3 -3
- package/RELEASES.md +318 -272
- package/agents/application-blueprint.md +4 -4
- package/agents/domain-expert-agent.md +3 -3
- package/agents/domain-research-agent.md +4 -4
- package/agents/engineering-agent-typescript.md +1 -1
- package/agents/production-erp-expert.md +2 -2
- package/agents/red-team-agent.md +287 -28
- package/agents/security-auditor.md +112 -17
- package/agents/security-observer.md +94 -0
- package/agents/tera-client-engagement.md +1 -1
- package/agents/tera-system-evolution.md +2 -1
- package/agents/tera.md +1 -0
- package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +275 -277
- package/core/tera-system/AGENT_DEPENDENCY_MAP.md +2 -2
- package/core/tera-system/AGENT_PERMISSION_MODEL.md +39 -26
- package/core/tera-system/SECURITY_TEAM_CHARTER.md +60 -20
- package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +2 -2
- package/core/tera-system/TERA_PROJECT_DECISION.md +14 -12
- package/core/tera-system/TOOLING_AND_MCP_POLICY.md +1 -1
- package/core/tera-system/TeraCapabilityMap.md +327 -0
- package/core/tera-system/TeraHelperAgents.md +13 -10
- package/core/tera-system/TeraPolicyMap.md +2 -1
- package/core/tera-system/TeraPreExecutionGate.md +1 -1
- package/core/tera-system/TeraPreparationDocumentationGovernance.md +1 -1
- package/core/tera-system/TeraSubAgents.md +312 -868
- package/core/tera-system/TeraTokenPolicy.md +1 -1
- package/core/tera-system/_TEMPLATE_EVIDENCE_MANIFEST.md +59 -0
- package/core/tera-system/_TEMPLATE_MATRIX_API_TOP10.md +112 -0
- package/core/tera-system/_TEMPLATE_MATRIX_ASVS_L2.md +261 -0
- package/core/tera-system/_TEMPLATE_MATRIX_WSTG.md +209 -0
- package/core/tera-system/_TEMPLATE_SECURITY_TARGET_SNAPSHOT.md +50 -0
- package/core/tera-system/design-system/DESIGN_SOURCE_PROTOCOL.md +2 -2
- package/core/tera-system/design-system/FIGMA_INTEGRATION.md +3 -3
- package/core/tera-system/design-system/UI_ACCEPTANCE_GATE.md +1 -1
- package/core/tera-system/engineering-governance/ENGINEERING_AGENT_RESPONSIBILITIES.md +4 -2
- package/core/tera-system/engineering-governance/ENGINEERING_REVIEW_CHECKLIST.md +1 -1
- package/core/tera-system/engineering-governance/QUALITY_GATE_THRESHOLDS.md +1 -1
- package/core/tera-system/profiles/PROFILES_INDEX.md +2 -0
- package/core/tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md +3 -3
- package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CLIENT.md +2 -2
- package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +5 -5
- package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +1 -1
- package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +4 -4
- package/package.json +2 -2
|
@@ -29,9 +29,9 @@
|
|
|
29
29
|
| **production-erp-expert.md** | Majed مباشرة، `tera.md`, `tera-client-engagement.md`, `application-blueprint.md`؛ وEngineering/QA فقط عبر Tera-approved task scope | `domain-research-agent.md` عند نقص المعرفة وبقرار المستدعي | `tera-system/knowledge-base/manufacturing/`, ملفات discovery/blueprint المحددة |
|
|
30
30
|
| **tera-system-evolution.md** | — (مستقل — يستدعيه Majed) | `ui-designer.md`, `domain-research-agent.md`, `domain-expert-agent.md` (للأغراض النظامية) | `tera-system/*.md`, `.opencode/agents/*.md` |
|
|
31
31
|
| **tera-strategic-advisor.md** | — (مستقل — يستدعيه Majed فقط) | لا يستدعي عملاء ولا يديرهم؛ قد يوصي Majed بالرجوع إلى TeraAgent أو حارس أو غيرهم | ملفات وسياقات القرار فقط، مصادر خارجية عند الحاجة |
|
|
32
|
-
| **auditor.md** | `tera.md`؛ و`monitor.md` فقط عند طلب Majed | يراجع مخرجات `tera.md`, `engineering-agent.md`؛ يحيل findings إلى `SecurityAgent`, `DesignReviewer`, `
|
|
32
|
+
| **auditor.md** | `tera.md`؛ و`monitor.md` فقط عند طلب Majed | يراجع مخرجات `tera.md`, `engineering-agent.md`؛ يحيل findings إلى `SecurityAgent`, `DesignReviewer`, `qa-agent`, أو `ProjectControlAgent` عبر الوكيل المستدعي | `project-control/*.md`, `project-control/audit-reports/`, `tera-system/engineering-governance/*.md`, الملفات المعدلة |
|
|
33
33
|
| **monitor.md** | — (مستقل — يستدعيه Majed) | يراجع مخرجات `tera.md`, `engineering-agent.md`; قد يستدعي `auditor.md` فقط عندما يطلب Majed تحدي/تحقق جودة مستقل | `project-control/*.md`, `tera-system/*.md` |
|
|
34
|
-
| **qa-agent.md** (الاسم المنطقي:
|
|
34
|
+
| **qa-agent.md** (الاسم المنطقي: qa-agent) | `tera.md` (يُفعّله Tera) | لا يستدعي عملاء آخرين | ملفات التحضير، ملفات المهمة، logs، مخرجات CLI، `project-control/test-reports/` |
|
|
35
35
|
| **red-team-agent.md** 🆕 (الشبح — SCP-2026-09-02-001) | `tera.md` (Phase 7 Security Gate)؛ Majed مباشرة | `security-observer.md` (العين يراقبه بالتزامن)، `security-auditor.md` (القاضي يدقق أدلته)؛ يستلم `defense-handoff.md` من الدرع عبر Tera | `security-reports/[ROUND-ID]/`, البروتوكول الأمني v2.0, `tera-system/TOOLING_AND_MCP_POLICY.md` |
|
|
36
36
|
| **security-observer.md** 🆕 (العين — SCP-2026-09-02-001) | `tera.md` (بالتزامن مع Red Team)؛ Majed مباشرة | يراقب أثر `red-team-agent.md` (الشبح) — لا يهاجم ولا يصلح | `security-reports/[ROUND-ID]/`, سجلات التطبيق والموارد، تقرير الشبح |
|
|
37
37
|
| **security-auditor.md** 🆕 (القاضي — SCP-2026-09-02-001) | `tera.md` (بعد Red Team + Observer + Retest)؛ Majed مباشرة | يدقق أدلة `red-team-agent.md` (الشبح) + تقرير `security-observer.md` (العين) — يرفض الادعاءات بلا دليل | `security-reports/[ROUND-ID]/audit/`, ASVS 5.0 L2, WSTG, تقارير الشبح والعين |
|
|
@@ -115,7 +115,7 @@
|
|
|
115
115
|
| تشغيل اختبارات | ❌ ممنوع |
|
|
116
116
|
| إنشاء ملفات جديدة | ✅ ضمن `Allowed Write Targets` فقط |
|
|
117
117
|
|
|
118
|
-
**متى يستخدم:** للعملاء الذين ينتجون توثيقًا أو تصميمًا أو تحضيرًا، مثل
|
|
118
|
+
**متى يستخدم:** للعملاء الذين ينتجون توثيقًا أو تصميمًا أو تحضيرًا، مثل ui-designer (Design Tokens) وعملاء توثيق التسليم (عبر tera.md).
|
|
119
119
|
|
|
120
120
|
---
|
|
121
121
|
|
|
@@ -131,7 +131,7 @@
|
|
|
131
131
|
| تشغيل أدوات | ❌ ممنوع |
|
|
132
132
|
| إنشاء ملفات جديدة | ✅ فقط داخل `project-knowledge/` |
|
|
133
133
|
|
|
134
|
-
**متى يستخدم:** حصريًا لـ
|
|
134
|
+
**متى يستخدم:** حصريًا لـ `project-knowledge-agent` لتحديث ذاكرة المشروع التنفيذية بعد قبول المهام المؤثرة.
|
|
135
135
|
|
|
136
136
|
---
|
|
137
137
|
|
|
@@ -206,29 +206,43 @@
|
|
|
206
206
|
|
|
207
207
|
## 3. مصفوفة الصلاحية الافتراضية لكل عميل
|
|
208
208
|
|
|
209
|
-
### 3.1 العملاء الأساسيون
|
|
209
|
+
### 3.1 العملاء الأساسيون (الـ 23 الرسميون)
|
|
210
|
+
|
|
211
|
+
> **المرجع المعياري (SCP-2026-09-04-001):** العملاء الرسميون بالأسماء الحديثة — راجع `TeraSubAgents.md` §5.
|
|
210
212
|
|
|
211
213
|
| العميل | المعرف | الصلاحية الافتراضية | هل يمكن رفعها؟ | ملاحظة |
|
|
212
214
|
|---|---|---|---|---|
|
|
213
|
-
|
|
|
214
|
-
|
|
|
215
|
-
|
|
|
216
|
-
|
|
|
217
|
-
|
|
|
218
|
-
|
|
|
219
|
-
|
|
|
220
|
-
|
|
|
221
|
-
|
|
|
222
|
-
|
|
|
223
|
-
|
|
224
|
-
|
|
215
|
+
| tera (TeraAgent) | `TERA` | `WRITE_CONTROL` + `WRITE_DOCS` | — | يدير المشروع ويسجل السجلات؛ لا يكتب كوداً (يفوّض Coding Agents) |
|
|
216
|
+
| application-blueprint (مهندس) | `APPLICATION_BLUEPRINT_AGENT` | `WRITE_DOCS` + `WRITE_CONTROL` | — | Solution Preparation Authority (1–4): ملفات التحضير + Engineering Handoff؛ لا يكتب كوداً |
|
|
217
|
+
| engineering-agent | `ENGINEERING_AGENT` | `WRITE_CODE` | إلى READ_ONLY إذا كانت مراجعة كود فقط | مستوى عالٍ، يجب مراقبته |
|
|
218
|
+
| engineering-agent-typescript | `ENGINEERING_AGENT_TS` | `WRITE_CODE` | — | كود TypeScript/Node.js/React وظيفي |
|
|
219
|
+
| engineering-agent-phaser | `ENGINEERING_AGENT_PHASER` | `WRITE_CODE` | — | كود Phaser 3 Web Games |
|
|
220
|
+
| engineering-agent-dotnet | `ENGINEERING_AGENT_DOTNET` | `WRITE_CODE` | — | كود .NET/C# |
|
|
221
|
+
| ui-designer | `UI_VISUAL_DESIGNER_AGENT` | `WRITE_DOCS` | إلى READ_ONLY إذا كان مراجعة فقط | يكتب Design Tokens / Component Rules / Layout Rules داخل `28_UI_UX_GUIDELINES.md` |
|
|
222
|
+
| tera-software-designer | `SOFTWARE_DESIGNER_AGENT` | `WRITE_DOCS` | إلى `PLAN_ONLY` إذا ما زالت الخطة غير ناضجة | يجهز Technical Specification للمهام فقط |
|
|
223
|
+
| qa-agent | `QA_ACCEPTANCE_AGENT` | `RUN_TESTS` | إلى READ_ONLY إذا كان مراجعة فقط | **Planning Mode:** `WRITE_DOCS` — خطط الاختبار ومعايير القبول. **Execution Mode:** `RUN_TESTS` + bash — تشغيل CLI + تقارير اختبار رسمية |
|
|
224
|
+
| auditor | `AUDITOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند كتابة تقرير التدقيق | تدقيق Diff-first بعد التنفيذ؛ لا يعدّل كوداً |
|
|
225
|
+
| design-reviewer | `DESIGN_REVIEWER` | `READ_ONLY` | إلى `WRITE_DOCS` عند تقرير المراجعة | مراجعة بصرية مستقلة؛ لا يبني ولا يعدّل |
|
|
226
|
+
| monitor | `MONITOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند تقارير الامتثال | يراقب الامتثال؛ يستدعي auditor بطلب Majed |
|
|
227
|
+
| tera-client-engagement | `TCEA` | `WRITE_DOCS` (ضمن client/) | — | Discovery + Scoping + Proposals للعملاء الخارجيين |
|
|
228
|
+
| tera-business-transformation-consultant | `BTCA` | `WRITE_DOCS` (ضمن client/) | — | تحول مؤسسي (Track C) عبر TCEA |
|
|
229
|
+
| tera-strategic-advisor | `STRATEGIC_ADVISOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند التقرير | استشارة استراتيجية — Majed فقط |
|
|
230
|
+
| domain-research-agent | `DOMAIN_RESEARCH_AGENT` | `WRITE_DOCS` | — | يكتب Domain Research Report في Allowed Write Targets + يحفظ DRAFT في `../Teranoo-Research/{domain}/` عند Score≥3 + يحدّث `00_INDEX.md` (Reuse-First, SCP-2026-08-31-001). لا يكتب كوداً، لا يتحكم في project-control. ترقية DRAFT→READY بيد Majed فقط (SCP-2026-09-04-008) |
|
|
231
|
+
| domain-expert-agent | `DOMAIN_EXPERT_AGENT` | `WRITE_DOCS` | — | يكتب Domain Intelligence Report / Knowledge Structure / Gap Analysis في Allowed Write Targets. لا يعدّل ملفات قائمة (edit: deny)، لا يكتب كوداً، لا يتحكم في project-control (SCP-2026-09-04-008) |
|
|
232
|
+
| production-erp-expert | `PRODUCTION_ERP_EXPERT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم تحليل/أسئلة/مراجعة Blueprint ضمن Allowed Write Targets | مستشار Production ERP؛ لا يكتب كوداً ولا يقرر النطاق |
|
|
233
|
+
| project-knowledge-agent | `PROJECT_KNOWLEDGE_AGENT` | `WRITE_KNOWLEDGE` | — | يكتب معرفة تشغيلية فقط داخل project-knowledge/ |
|
|
234
|
+
| tera-system-evolution | `TERA_SYSTEM_EVOLUTION` | `WRITE_DOCS` (نظامية بموافقة Majed) | — | حوكمة وتطوير منظومة Tera؛ تعديلات بعد SCP وموافقة |
|
|
235
|
+
| red-team-agent (الشبح) | `RED_TEAM_AGENT` | `EXECUTE_ATTACKS` (ضمن تفويض مكتوب) + `WRITE_EVIDENCE` في security-reports فقط | لا يُرفع — التفويض يحدد النطاق لا الصلاحية | يهاجم فقط ما فُوّض له؛ لا يكتب كوداً؛ لا يصلح أثناء الجولة (SCP-2026-09-02-001) |
|
|
236
|
+
| security-observer (العين) | `SECURITY_OBSERVER` | `READ_ONLY` | إلى `WRITE_DOCS` عند تقرير المراقب في security-reports/observer | يراقب فقط — لا يهاجم، لا يصلح، لا يحكم (SCP-2026-09-02-001) |
|
|
237
|
+
| security-auditor (القاضي) | `SECURITY_AUDITOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند تقرير التدقيق + قرار البوابة في security-reports/audit | يدقق فقط — لا يهاجم، لا يصلح، لا يثق بلا دليل (SCP-2026-09-02-001) |
|
|
238
|
+
|
|
239
|
+
### 3.2 العملاء المشروطون (Helper Agents + Preparation Roles)
|
|
240
|
+
|
|
241
|
+
> **تصحيح (SCP-2026-09-04-001):** العملاء المشروطون هنا هم **Helper Agents** مُولَّدون عند الحاجة (مثل Integration/DevOps/Performance...). الأدوار التحضيرية القديمة (RequirementsScope/DataDesign...) ليست عملاءً — مسؤوليتها مملوكة لـ `application-blueprint` (راجع `TeraSubAgents.md` §5.9).
|
|
225
242
|
|
|
226
243
|
| العميل | المعرف | الصلاحية الافتراضية | هل يمكن رفعها؟ | ملاحظة |
|
|
227
244
|
|---|---|---|---|---|
|
|
228
245
|
| SecurityAgent (الدرع) | `SECURITY_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند توثيق findings + كتابة `defense-handoff.md` و`fix-review.md` في security-reports | لا يكتب كودًا أبدًا. دفاعي فقط — لا ينفذ هجمات (SCP-2026-09-02-001) |
|
|
229
|
-
| RedTeamAgent (الشبح) 🆕 | `RED_TEAM_AGENT` | `EXECUTE_ATTACKS` (ضمن تفويض مكتوب) + `WRITE_EVIDENCE` في security-reports فقط | لا يُرفع — التفويض يحدد النطاق، لا الصلاحية | يهاجم فقط ما فُوّض له كتابياً؛ لا يكتب كوداً؛ لا يصلح الثغرات أثناء الجولة (SCP-2026-09-02-001) |
|
|
230
|
-
| SecurityObserver (العين) 🆕 | `SECURITY_OBSERVER` | `READ_ONLY` | إلى `WRITE_DOCS` عند كتابة تقرير المراقب في security-reports/observer | يراقب فقط — لا يهاجم، لا يصلح، لا يحكم (SCP-2026-09-02-001) |
|
|
231
|
-
| SecurityAuditor (القاضي) 🆕 | `SECURITY_AUDITOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند كتابة تقرير التدقيق + قرار البوابة في security-reports/audit | يدقق فقط — لا يهاجم، لا يصلح، لا يثق بالادعاءات بلا دليل (SCP-2026-09-02-001) |
|
|
232
246
|
| IntegrationAgent | `INTEGRATION_AGENT` | `WRITE_DOCS` | إلى `WRITE_CODE` لتعديل كود التكامل فقط إذا فوضه Tera صراحة | يوثق التكاملات |
|
|
233
247
|
| DevOpsDeploymentAgent | `DEVOPS_DEPLOYMENT_AGENT` | `WRITE_CODE` | إلى `DEPLOY_WITH_APPROVAL` عند النشر | يتطلب موافقة لكل نشر |
|
|
234
248
|
| PerformanceAgent | `PERFORMANCE_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند توثيق التوصيات | يحلل فقط |
|
|
@@ -236,12 +250,8 @@
|
|
|
236
250
|
| ReportingAnalyticsAgent | `REPORTING_ANALYTICS_AGENT` | `WRITE_DOCS` | — | يوثق متطلبات التقارير |
|
|
237
251
|
| MaintenanceMigrationAgent | `MAINTENANCE_MIGRATION_AGENT` | `WRITE_DOCS` | — | يخطط للترحيل |
|
|
238
252
|
| ProjectControlAgent | `PROJECT_CONTROL_AGENT` | `WRITE_CONTROL` | — | يتحكم في سجلات المشروع فقط |
|
|
239
|
-
| tera-software-designer (SoftwareDesignerAgent) | `SOFTWARE_DESIGNER_AGENT` | `WRITE_DOCS` | إلى `PLAN_ONLY` إذا ما زالت الخطة غير ناضجة | يجهز Technical Specification للمهام فقط |
|
|
240
253
|
| QualityReviewCoordinatorAgent | `QUALITY_REVIEW_COORDINATOR_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم تقرير فقط | ينسق المراجعة فقط |
|
|
241
|
-
| PlanComplianceReviewAgent | `PLAN_COMPLIANCE_REVIEW_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التقرير فقط | يراجع توافق الخطة فقط |
|
|
242
|
-
| DomainResearchAgent | `DOMAIN_RESEARCH_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التقرير + حفظ DRAFT في `../Teranoo-Research/{domain}/` عند Score≥3 (SCP-2026-08-31-001) | يبحث فقط + يقرأ `../Teranoo-Research/00_INDEX.md` (Reuse-First) |
|
|
243
|
-
| DomainExpertAgent | `DOMAIN_EXPERT_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التحليل | يحلل فقط + يقرأ `../Teranoo-Research/00_INDEX.md` عند الحاجة |
|
|
244
|
-
| ProductionERPExpert | `PRODUCTION_ERP_EXPERT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم تحليل أو أسئلة أو مراجعة Blueprint ضمن Allowed Write Targets | مستشار Production ERP؛ لا يكتب كوداً ولا يقرر النطاق أو التكلفة النهائية — يقرأ `../Teranoo-Research/00_INDEX.md` عند الحاجة |
|
|
254
|
+
| PlanComplianceReviewAgent | `PLAN_COMPLIANCE_REVIEW_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التقرير فقط | يراجع توافق الخطة فقط |
|
|
245
255
|
|
|
246
256
|
### 3.3 عملاء التعامل مع العملاء الخارجيين
|
|
247
257
|
|
|
@@ -332,16 +342,19 @@ EngineeringAgent يُستخدم لمراجعة كود فقط → يخفض إلى
|
|
|
332
342
|
|
|
333
343
|
```
|
|
334
344
|
للعملاء الذين يحتاجون قراءة فقط ولا يملكون أي صلاحية كتابة.
|
|
335
|
-
مطبق افتراضيًا على
|
|
345
|
+
مطبق افتراضيًا على `quality-review-coordinator-agent`.
|
|
336
346
|
يمكن رفعه إلى `WRITE_DOCS` فقط لتسليم التقرير.
|
|
347
|
+
|
|
348
|
+
ملاحظة (SCP-2026-09-04-008): `domain-research-agent` و `domain-expert-agent`
|
|
349
|
+
أصبحا `WRITE_DOCS` افتراضياً بقرار Majed — لم يعودا تحت NO_WRITE.
|
|
337
350
|
```
|
|
338
351
|
|
|
339
352
|
### 5.6 صلاحية المكتبة البحثية (SCP-2026-08-31-001)
|
|
340
353
|
|
|
341
354
|
```
|
|
342
355
|
المسار `../Teranoo-Research/**` (خارج Teranoo-System):
|
|
343
|
-
- القراءة: مسموحة لـ
|
|
344
|
-
- الكتابة: مسموحة فقط لـ
|
|
356
|
+
- القراءة: مسموحة لـ `domain-research-agent` / `domain-expert-agent` / `production-erp-expert` (Reuse-First)
|
|
357
|
+
- الكتابة: مسموحة فقط لـ `domain-research-agent` لحفظ DRAFT عند Score≥3 في `../Teranoo-Research/{domain}/`
|
|
345
358
|
- الترقية DRAFT→READY: بيد Majed فقط (تعديل 00_INDEX.md)
|
|
346
359
|
- لا يُوزع للزبائن — مستثنى من core-bundle
|
|
347
360
|
```
|
|
@@ -80,16 +80,33 @@
|
|
|
80
80
|
### 5.2 مراحل الجولة
|
|
81
81
|
|
|
82
82
|
```text
|
|
83
|
+
0. لقطة الهدف — SECURITY_TARGET_SNAPSHOT.md (Commit SHA + Working Tree + Build) — قبل أي هجوم
|
|
83
84
|
1. التفويض والنطاق (00_AUTHORIZATION.md) — Rules of Engagement موقعة من Majed
|
|
84
85
|
2. بوابة الاستعداد — بيئة معزولة، بيانات وهمية، Canary، حدود طلبات
|
|
85
|
-
3. Black Box —
|
|
86
|
-
4. Gray/White Box
|
|
86
|
+
3. Phase A — Black Box معزول تقنياً (URL فقط — لا وصول لكود المصدر) + العين يراقب + Runtime Surface
|
|
87
|
+
4. Phase B — Gray/White Box (بعد إغلاق A: وصول للكود + Source-Declared Surface)
|
|
87
88
|
5. الحملات الهجومية الإلزامية — 13 مجالاً
|
|
88
|
-
6. الأدلة — Request/Response فعلي
|
|
89
|
-
7.
|
|
90
|
-
8.
|
|
91
|
-
9.
|
|
92
|
-
10.
|
|
89
|
+
6. الأدلة — Evidence Pack كامل لكل استغلال ناجح (Request/Response فعلي — قاعدة إعادة البناء)
|
|
90
|
+
7. مصفوفات التغطية المعيارية — ASVS L2 + WSTG + API Top 10 (PASS/FAIL/N/A/NOT TESTED لكل بند)
|
|
91
|
+
8. Findings — تصنيف ثلاثي (Technical / Business / Exploit Chain) مع CVSS/CWE/OWASP
|
|
92
|
+
9. تجميد الأدلة — EVIDENCE_MANIFEST.md (SHA256 لكل ملف + Freeze Timestamp — لا تعديل بعدها)
|
|
93
|
+
10. الإصلاح + إعادة الاختبار — منفصل عن جلسة الهجوم (Track A Retest + Track B Fresh Clean-Room)
|
|
94
|
+
11. تدقيق مستقل — القاضي: Snapshot + Manifest + Surface Reconciliation (A∪B∪C) + الأدلة والمصفوفات والتصنيف
|
|
95
|
+
12. بوابة القبول الأمني — قرار نهائي
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
### 5.4 أنواع الجولات
|
|
99
|
+
|
|
100
|
+
```text
|
|
101
|
+
Round 0 — LAB (تدريب الأدوات): تطبيق مليء بثغرات معروفة لتدريب الأدوات وسلسلة الأدلة.
|
|
102
|
+
Round 1+ — CLEAN / Discovery (اختبار الاكتشاف): تطبيق سليم إلى حد كبير يحتوي 5–7 ثغرات
|
|
103
|
+
مخفية جيداً — لا يُخبر الفريق بعددها أو أنواعها أو أماكنها — يقاس Discovery Rate
|
|
104
|
+
والفalse positives.
|
|
105
|
+
Round P — Production-like (قبل التسليم): تطبيق حقيقي قبل التسليم — بوابة Phase 7 الكاملة.
|
|
106
|
+
Round R — Retest (بعد الإصلاحات): مساران —
|
|
107
|
+
Track A: Retest بمعرفة الثغرات (bypass + regression).
|
|
108
|
+
Track B: Fresh Attack Clean-Room (جلسة جديدة بلا أي معرفة سابقة — URL/حسابات/نطاق فقط).
|
|
109
|
+
القاضي يدمج النتيجتين.
|
|
93
110
|
```
|
|
94
111
|
|
|
95
112
|
### 5.3 التفعيل (مقصود ومضبوط)
|
|
@@ -139,23 +156,33 @@ security-reports/
|
|
|
139
156
|
├── SECURITY_GATE_LOG.md ← سجل البوابات عبر الجولات
|
|
140
157
|
└── SEC-ROUND-{YYYY-MM-DD}-{NNN}/ ← جولة واحدة
|
|
141
158
|
├── 00_AUTHORIZATION.md ← التفويض والنطاق (يوقعه Majed)
|
|
142
|
-
├──
|
|
159
|
+
├── SECURITY_TARGET_SNAPSHOT.md ← لقطة الهدف: Commit SHA + Tree + Build + Runtime (نزاهة الإصدار)
|
|
160
|
+
├── 01_ATTACK_SURFACE.md ← خريطة سطح الهجوم (الشبح — المصدر A)
|
|
143
161
|
├── 02_TEST_LOG.md ← سجل الاختبارات (Test IDs + نتائج)
|
|
144
|
-
├── 03_FINDINGS.md ← Findings
|
|
145
|
-
├──
|
|
146
|
-
├──
|
|
147
|
-
├──
|
|
162
|
+
├── 03_FINDINGS.md ← Findings بالتصنيف الثلاثي (الشبح)
|
|
163
|
+
├── MATRIX_ASVS_L2.md ← مصفوفة تغطية ASVS 5.0 L2 (إلزامية)
|
|
164
|
+
├── MATRIX_WSTG.md ← مصفوفة تغطية WSTG (إلزامية)
|
|
165
|
+
├── MATRIX_API_TOP10.md ← مصفوفة تغطية API Top 10 (إلزامية)
|
|
166
|
+
├── EVIDENCE_MANIFEST.md ← بيان الأدلة: SHA256 لكل ملف + Freeze (لا تعديل بعدها)
|
|
167
|
+
├── 04_OBSERVER_REPORT.md ← تقرير العين (مراقب متزامن + Runtime Surface B)
|
|
168
|
+
├── 05_AUDIT_DECISION.md ← قرار القاضي + Surface Reconciliation (A∪B∪C)
|
|
169
|
+
├── 06_RETEST_RECORD.md ← سجل إعادة الاختبار (Track A + Track B)
|
|
148
170
|
├── defense-handoff.md ← ملف الدفاع (الدرع → للشبح في White Box)
|
|
149
171
|
├── fix-review.md ← مراجعة الإصلاحات (الدرع)
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
172
|
+
├── evidence/ ← أدلة مجمّدة (لا تُعدّل بعد الـ Freeze)
|
|
173
|
+
│ └── {TEST-ID}/
|
|
174
|
+
│ ├── metadata.md ← إلزامي: Test ID/الهدف/الوقت UTC/الأداة/الدور/النتيجة/Finding
|
|
175
|
+
│ ├── request.txt ← إلزامي: الطلب الفعلي (منقح)
|
|
176
|
+
│ ├── response.txt ← إلزامي: الاستجابة الفعلية (منقحة)
|
|
177
|
+
│ ├── screenshot.png ← عند الحاجة (حالات UI)
|
|
178
|
+
│ └── tool-output.txt ← عند استخدام أداة (إلزامي وقتها)
|
|
179
|
+
└── evidence-addendum/ ← الإضافات بعد التجميد (لا تعديل للأصل)
|
|
157
180
|
```
|
|
158
181
|
|
|
182
|
+
> **قاعدة إعادة البناء:** يستطيع القاضي إعادة بناء استنتاج الشبح من ملفات الأدلة وحدها — دون سؤال الشبح.
|
|
183
|
+
> **قاعدة نزاهة الأدلة:** بعد `Evidence Freeze` في `EVIDENCE_MANIFEST.md`، أي تعديل للأدلة الأصلية يُبطلها — الإضافات في `evidence-addendum/` فقط.
|
|
184
|
+
> **قاعدة نزاهة الهدف:** `SECURITY_TARGET_SNAPSHOT.md` — إذا تغيّر Commit/Tree/Runtime أثناء الجولة → الجولة INVALID.
|
|
185
|
+
|
|
159
186
|
---
|
|
160
187
|
|
|
161
188
|
## 8. قواعدنا الحاكمة (غير قابلة للتفاوض)
|
|
@@ -165,10 +192,19 @@ security-reports/
|
|
|
165
192
|
3. **الأسرار تُنقّح** — `[REDACTED]` بدل أي قيمة حقيقية.
|
|
166
193
|
4. **فصل الأدوار ملزم** — من هاجم لا يدقق، من راقب لا يحكم.
|
|
167
194
|
5. **قرار التسليم** — بيد القاضي وحده، بعد الجولة الكاملة.
|
|
168
|
-
6. **Critical/High مفتوحة = لا تسليم.**
|
|
195
|
+
6. **Critical/High مفتوحة (بسلسلة استغلال) = لا تسليم.**
|
|
169
196
|
7. **لا توسيع للأثر** — نوقف عند إثبات كافٍ، لا نستمر في التخريب.
|
|
170
197
|
8. **بيئة معزولة** — بيانات وهمية فقط، ممنوع البيانات الحقيقية.
|
|
171
198
|
9. **التوثيق الكامل** — كل نتيجة موثقة بأدلتها في نفس الجولة.
|
|
199
|
+
10. **Evidence Pack إلزامي** — كل استغلال ناجح: metadata + request + response (+ tool-output + screenshot عند الحاجة). بلا Pack = Finding مرفوض/غير مثبت.
|
|
200
|
+
11. **قاعدة إعادة البناء** — القاضي يعيد بناء الاستنتاج من الأدلة وحدها.
|
|
201
|
+
12. **مصفوفات التغطية إلزامية** — ASVS L2 + WSTG + API Top 10 لكل جولة، بلا N/A بلا سبب خاص بالتطبيق.
|
|
202
|
+
13. **التصنيف الثلاثي** — Technical Severity / Business Impact / Exploit Chain Severity. البوابة تعتمد على السلسلة — لا تضخيم تقني.
|
|
203
|
+
14. **عزل Black Box إلزامي** — Phase A بلا وصول لكود المصدر (تقنياً وليس نصياً فقط). أي اكتشاف تطلب معرفة الكود أثناء Black Box غير صالح.
|
|
204
|
+
15. **نزاهة الهدف** — `SECURITY_TARGET_SNAPSHOT.md` قبل/بعد الجولة. تغيّر Commit/Tree/Runtime أثناء الجولة = الجولة INVALID.
|
|
205
|
+
16. **نزاهة الأدلة** — `EVIDENCE_MANIFEST.md` (SHA256 + Freeze). بعد التجميد: لا تعديل للأدلة الأصلية — الإضافات في `evidence-addendum/` فقط.
|
|
206
|
+
17. **Surface Reconciliation** — القاضي يبني A∪B∪C (مكتشف الشبح + Runtime + Source) — لا يثق بسطح الهجوم وحده.
|
|
207
|
+
18. **فصل كتابة صارم** — الشبح لا يكتب `observer/` أو `audit/`؛ العين لا تكتب إلا `observer/`؛ القاضي لا يكتب إلا `audit/`.
|
|
172
208
|
|
|
173
209
|
---
|
|
174
210
|
|
|
@@ -179,6 +215,7 @@ security-reports/
|
|
|
179
215
|
|
|
180
216
|
| Round ID | التطبيق | التاريخ | النوع | قرار القاضي | Critical/High |
|
|
181
217
|
|---|---|---|---|---|---|
|
|
218
|
+
| SEC-ROUND-2026-09-03-001 | BlogCraft LAB | 2026-09-03 | Round 0 — LAB (تدريب) | **FAIL** | 12 Critical / 3 High (18 إجمالاً) |
|
|
182
219
|
| *(تُضاف بعد كل جولة)* | | | | | |
|
|
183
220
|
|
|
184
221
|
---
|
|
@@ -191,6 +228,9 @@ security-reports/
|
|
|
191
228
|
| 2026-09-02 | **النشر للحزم** — core 0.2.12 + pro 0.2.17 على npm + bundle v0.2.16 على teranoo.com |
|
|
192
229
|
| 2026-09-02 | **استكشاف أول** — فحص BlogCraft LAB: تأكيد 7 ثغرات (env leak, data exposure, SQLi, BFLA, BOLA, JWT storage, JWT forge→admin) |
|
|
193
230
|
| 2026-09-03 | **الميثاق** — توثيق رسمي للفريق + نسخة الجوهر المُوزَّعة (هذا الملف) |
|
|
231
|
+
| 2026-09-03 | **الجولة الأولى** — SEC-ROUND-2026-09-03-001 على BlogCraft LAB: 18 Finding (12 Critical) — قرار القاضي FAIL (متوقع لجولة LAB) |
|
|
232
|
+
| 2026-09-03 | **ترقية الفريق (SCP-2026-09-03-004)** — بعد تقييم Majed: Evidence Pack إلزامي + قاعدة إعادة البناء، مصفوفات تغطية ASVS/WSTG/API، بروتوكول Discovery Rounds، دور Blue Team للعين (Detection Engineering)، تصنيف ثلاثي (Technical/Business/Exploit Chain) |
|
|
233
|
+
| 2026-09-03 | **ترقية النزاهة (SCP-2026-09-03-005)** — بعد مراجعة خبير خارجي: (1) عزل Black Box تقني، (2) SECURITY_TARGET_SNAPSHOT (نزاهة الإصدار)، (3) EVIDENCE_MANIFEST (SHA256 + Freeze)، (4) Surface Reconciliation (A∪B∪C)، (5) فصل كتابة صارم، (6) Retest ثنائي المسار (Track A + Track B Clean-Room) |
|
|
194
234
|
|
|
195
235
|
---
|
|
196
236
|
|
|
@@ -63,8 +63,8 @@ Release Package (ملفات Tera-managed + SHA256SUMS + TERA_RELEASE_MANIFEST.js
|
|
|
63
63
|
|
|
64
64
|
| الحزمة | الاسم (npm) | الإصدار الحالي | الوصف | الملفات الموزعة ضمن الحزمة |
|
|
65
65
|
|---|---|---|---|---|
|
|
66
|
-
| core | `@tera-system/core` | 0.2.
|
|
67
|
-
| pro | `@tera-system/pro` | 0.2.
|
|
66
|
+
| core | `@tera-system/core` | 0.2.15 | OpenCode Plugin — core governance (23 agents, 11 commands, distribution tools, security team) | `agents/`, `commands/`, `core/`, `assets/`, `tools/`, `scripts/` |
|
|
67
|
+
| pro | `@tera-system/pro` | 0.2.20 | Commercial edition — signed bundle + license gate + heartbeat | `scripts/`, `core/project-control`, `MANIFEST.json`, `opencode.tera.example.json`, `WELCOME.md`, `README.md` |
|
|
68
68
|
|
|
69
69
|
**المستودع الرسمي:** `https://github.com/Alabasi1980/Teranoo-System` — هو `RepositoryUrl` الوحيد المعتمد لـ `tera-fetch.ps1` و `tera-schedule.ps1`
|
|
70
70
|
**Tags:** `tera-vX.Y.Z` — الـ Lockfile يحفظ `Commit SHA` كحقيقة، والقنوات `stable`/`beta`
|
|
@@ -139,9 +139,9 @@
|
|
|
139
139
|
|
|
140
140
|
| الملف | السبب | العميل الفرعي المتوقع |
|
|
141
141
|
|---|---|---|
|
|
142
|
-
| `01_PROJECT_BRIEF.md` | `[REASON]` | `
|
|
143
|
-
| `02_SCOPE_AND_BOUNDARIES.md` | `[REASON]` | `
|
|
144
|
-
| `03_MODULES_AND_FEATURES.md` | `[REASON]` | `
|
|
142
|
+
| `01_PROJECT_BRIEF.md` | `[REASON]` | `application-blueprint` (Prep Role: Scope) |
|
|
143
|
+
| `02_SCOPE_AND_BOUNDARIES.md` | `[REASON]` | `application-blueprint` (Prep Role: Scope) |
|
|
144
|
+
| `03_MODULES_AND_FEATURES.md` | `[REASON]` | `application-blueprint` (Prep Role: Scope) |
|
|
145
145
|
| ... | ... | ... |
|
|
146
146
|
|
|
147
147
|
### مشروط (Conditional)
|
|
@@ -165,17 +165,19 @@
|
|
|
165
165
|
|
|
166
166
|
---
|
|
167
167
|
|
|
168
|
-
## 9. Suggested Sub-Agents
|
|
168
|
+
## 9. Suggested Sub-Agents
|
|
169
|
+
|
|
170
|
+
> **SCP-2026-09-04-001:** الأدوار التحضيرية (RequirementsScope / BusinessWorkflow / DataDesign / UIUXStructure / SolutionArchitecture) **ليست عملاءً ثابتين** — مسؤوليتها يملكها `application-blueprint` (مهندس الحل) وتُنفَّذ عبر `TASK-PREP-*`. `ui-designer` عميل فعلي للتصميم البصري. (راجع `TeraSubAgents.md` §5.9)
|
|
169
171
|
|
|
170
|
-
|
|
|
172
|
+
| العميل/الدور | الحاجة | متى؟ | السبب |
|
|
171
173
|
|---|---|---|---|
|
|
172
|
-
|
|
|
173
|
-
|
|
|
174
|
-
|
|
|
175
|
-
|
|
|
176
|
-
| `
|
|
177
|
-
|
|
|
178
|
-
| `SecurityAgent` | Required / Conditional / Not Needed | حسب الحساسية | `[REASON]` |
|
|
174
|
+
| Prep Role: Requirements & Scope (يملكه application-blueprint) | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
|
|
175
|
+
| Prep Role: Business Workflow (يملكه application-blueprint) | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
|
|
176
|
+
| Prep Role: Data Design (يملكه application-blueprint) | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
|
|
177
|
+
| Prep Role: UI/UX Structure (يملكه application-blueprint) | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
|
|
178
|
+
| `ui-designer` | Required / Conditional / Not Needed | عند وجود واجهة أو مصدر تصميم يحتاج تحويل إلى Tokens/Component Rules | `[REASON]` |
|
|
179
|
+
| Prep Role: Solution Architecture (يملكه application-blueprint / tera-software-designer) | Required / Conditional / Not Needed | الإعداد | `[REASON]` |
|
|
180
|
+
| `SecurityAgent` (الدرع) | Required / Conditional / Not Needed | حسب الحساسية | `[REASON]` |
|
|
179
181
|
| `IntegrationAgent` | Required / Conditional / Not Needed | حسب التكاملات | `[REASON]` |
|
|
180
182
|
| `DevOpsDeploymentAgent` | Required / Conditional / Not Needed | حسب الحاجة | `[REASON]` |
|
|
181
183
|
|
|
@@ -248,7 +248,7 @@ powershell -ExecutionPolicy Bypass -File .\tools\tera-tooling.ps1 -Install
|
|
|
248
248
|
| **API Testing MCP** | متاحة حالياً عبر curl/webfetch + Bruno CLI — لا حاجة لخادم MCP. | عند الحاجة لاستعلام تفاعلي متكرر من العملاء من نتائج API مباشرة. |
|
|
249
249
|
| **Git / GitHub MCP** | Git CLI الحالية تغطي القراءة والكتابة (بموافقة). | عند اعتماد GitHub سير عمل PRs بكثافة. |
|
|
250
250
|
| **Database Read-Only MCP** | الوصول الحالي عبر CLI/استعلامات مصرّح بها. | عند وجود مشروع يتطلب فحص قواعد بيانات متكرراً من عدة عملاء. |
|
|
251
|
-
| **Figma MCP** | البروتوكول الحالي FIGMA_INTEGRATION.md +
|
|
251
|
+
| **Figma MCP** | البروتوكول الحالي FIGMA_INTEGRATION.md + ui-designer يكفي الآن. MCP Figma سيضيف تعقيدًا قبل الحاجة الفعلية. | عند وجود مشروع يعتمد على Figma بانتظام وتتعدد مهام التصميم. |
|
|
252
252
|
| **Deployment / Cloud MCPs** | النشر ليس محورًا حاليًا. DevOpsDeploymentAgent الحالي يغطي التخطيط والتحضير. | عند وجود مشروع يتطلب نشر فعلي متكرر CI/CD. |
|
|
253
253
|
| **Production DB Write Tools** | خطرة جدًا وتحتاج ضوابط أمنية متقدمة. | عند وجود مشروع يتطلب وصول كتابي إلى قاعدة بيانات Production مع خطة rollback موثقة. |
|
|
254
254
|
| **Email / Calendar MCPs** | غير ضرورية حاليًا لمنظومة Tera. | عند الحاجة لجدولة مواعيد أو إرسال اتصالات آلية. |
|