@tera-system/core 0.5.0 → 0.6.2
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 +29 -0
- package/agents/application-blueprint.md +6 -6
- package/agents/auditor.md +19 -2
- package/agents/engineering-agent-dotnet.md +30 -4
- package/agents/engineering-agent-flutter.md +5 -5
- package/agents/engineering-agent-typescript.md +70 -38
- package/agents/engineering-agent.md +12 -72
- package/agents/security-observer.md +2 -2
- package/agents/tera-client-engagement.md +7 -7
- package/agents/tera-software-designer.md +88 -54
- package/agents/tera-system-evolution.md +6 -6
- package/agents/tera.md +38 -6
- package/agents/ui-designer.md +1 -1
- package/assets/structurizr-mcp/pyproject.toml +1 -1
- package/assets/structurizr-mcp/uv.lock +816 -770
- package/commands/tera-approve.md +43 -34
- package/commands/tera-diagnose.md +2 -0
- package/commands/tera-gate.md +2 -0
- package/commands/tera-help.md +1 -0
- package/commands/tera-new-project.md +32 -35
- package/commands/tera-orient-software-designer.md +1 -1
- package/commands/tera-orient-tera.md +1 -1
- package/commands/tera-plan.md +2 -0
- package/commands/tera-reconcile.md +35 -0
- package/commands/tera-request-build.md +2 -0
- package/commands/tera-resume.md +2 -0
- package/commands/tera-review.md +2 -0
- package/commands/tera-status.md +2 -0
- package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +11 -7
- package/core/tera-system/AGENT_DEPENDENCY_MAP.md +9 -7
- package/core/tera-system/AGENT_GENERATION_TEMPLATE.md +6 -5
- package/core/tera-system/AGENT_PERMISSION_MODEL.md +29 -12
- package/core/tera-system/TERA_AGENT_CONDUCT.md +17 -0
- package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +7 -4
- package/core/tera-system/TeraArchitectureMap.md +1 -1
- package/core/tera-system/TeraCapabilityMap.md +2 -2
- package/core/tera-system/TeraPolicyMap.md +5 -3
- package/core/tera-system/TeraPreExecutionGate.md +51 -4
- package/core/tera-system/TeraPreparationDocumentationGovernance.md +21 -15
- package/core/tera-system/TeraSubAgents.md +7 -4
- package/core/tera-system/TeraSystemMaintenanceChecklist.md +12 -0
- package/core/tera-system/client-helpers/tera-client-engagement-gates.md +2 -2
- package/core/tera-system/client-helpers/tera-client-engagement-pricing.md +1 -1
- package/core/tera-system/client-helpers/tera-client-engagement-protocols.md +14 -9
- package/core/tera-system/design-system/DESIGN_REVIEW_STANDARDS.md +2 -0
- package/core/tera-system/engineering-helpers/database-privileges.md +63 -0
- package/core/tera-system/engineering-helpers/engineering-agent-core.md +30 -13
- package/core/tera-system/profiles/PROFILES_INDEX.md +3 -1
- package/core/tera-system/profiles/dotnet-razorpages-adonet.md +44 -43
- package/core/tera-system/profiles/dotnet-wpf-sqlite.md +17 -17
- package/core/tera-system/profiles/flutter-mobile.md +2 -2
- package/core/tera-system/profiles/rust.md +8 -6
- package/core/tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md +2 -1
- package/core/tera-system/runtime/TERA_COMMAND_PROTOCOL.md +86 -0
- package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +16 -0
- package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES.md +14 -0
- package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md +1 -0
- package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_PREPARATION.md +1 -1
- package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +2 -2
- package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +9 -2
- package/package.json +2 -2
package/commands/tera-approve.md
CHANGED
|
@@ -1,34 +1,43 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: اعتماد
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent.
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
1.
|
|
10
|
-
2.
|
|
11
|
-
3.
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
-
|
|
25
|
-
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
-
|
|
1
|
+
---
|
|
2
|
+
description: اعتماد المرحلة/المهمة الحالية — يسجّل نية المالك دون تجاوز شروط الإغلاق
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent. اتبع `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` (بوابة المسار §1 · شروط الإغلاق §3 · معاملة الإغلاق §4).
|
|
6
|
+
|
|
7
|
+
نفّذ بالترتيب:
|
|
8
|
+
|
|
9
|
+
1. **حلّ المسار (§1):** حدّد `ActiveAppPath` ثم `ProjectControlPath`. إن لم يتضح → توقف واسأل.
|
|
10
|
+
2. اقرأ `<ProjectControlPath>/PROJECT_STATE.md` و`TASK_REGISTRY.md`، وحدّد المهمة/المرحلة المعتمدة من السياق.
|
|
11
|
+
3. **تحقّق من شروط الإغلاق (§3) — لا تُغلق قبل استيفاء الكل:**
|
|
12
|
+
|
|
13
|
+
| # | الشرط | الحالة |
|
|
14
|
+
|---|---|---|
|
|
15
|
+
| 1 | Handback مسجّل في ملف المهمة | ... |
|
|
16
|
+
| 2 | Post-Execution Review = PASS | ... |
|
|
17
|
+
| 3 | Compliance Record = COMPLIANT | ... |
|
|
18
|
+
| 4 | Owner Approval Required (إن Yes: مسجّل صريحاً) | ... |
|
|
19
|
+
| 5 | قرارات QA/Auditor/Security المطلوبة مسجّلة | ... |
|
|
20
|
+
| 6 | Cross-Record Consistency | ... |
|
|
21
|
+
|
|
22
|
+
4. إن **فشل أي شرط** → **لا تُغلق**: اعرض الشروط الناقصة فقط وانتظر قراري.
|
|
23
|
+
5. إن **استُوفي الكل** → سجّل اعتماد المالك ثم نفّذ **معاملة الإغلاق (§4)** على كل السجلات، وأعد القراءة والتحقق:
|
|
24
|
+
- `Accepted`/`Closed` في `TASK_REGISTRY.md` + ملف المهمة.
|
|
25
|
+
- `DECISIONS_LOG.md` + `PROJECT_STATE.md` + `PROJECT_ACTIVITY_LOG.md` + `TERA_AUDIT_TRAIL.md`.
|
|
26
|
+
|
|
27
|
+
ثم اعرض:
|
|
28
|
+
|
|
29
|
+
```
|
|
30
|
+
تم اعتماد: [المهمة/المرحلة] — [TASK-ID]
|
|
31
|
+
الاتساق (reconcile): CONSISTENT / DRIFT_FOUND (التفاصيل)
|
|
32
|
+
|
|
33
|
+
المهمة التالية المقترحة:
|
|
34
|
+
- العنوان: ...
|
|
35
|
+
- النطاق المقترح: ...
|
|
36
|
+
- الملفات المتوقعة: ...
|
|
37
|
+
هل أعدّ مسودة TASK-ID لها؟ أنتظر موافقتك.
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
قواعد:
|
|
41
|
+
- `/tera-approve` يسجّل **نية المالك** — ولا يتجاوز أبداً شروط الإغلاق التقنية (§3).
|
|
42
|
+
- لا تبدأ المهمة التالية قبل موافقة صريحة.
|
|
43
|
+
- لا تنتقل إلى مرحلة جديدة بدون موافقة صريحة على تغيير المرحلة.
|
|
@@ -4,6 +4,8 @@ description: تشخيص ذاتي لـ Tera — فحص حالة النظام وا
|
|
|
4
4
|
|
|
5
5
|
أنت Tera Agent.
|
|
6
6
|
|
|
7
|
+
> المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
|
|
8
|
+
|
|
7
9
|
شغّل Tera Self-Diagnosis الكامل (Section 9.1 من tera.md).
|
|
8
10
|
|
|
9
11
|
أجب على هذه الأسئلة الثمانية بصدق:
|
package/commands/tera-gate.md
CHANGED
|
@@ -4,6 +4,8 @@ description: تشغيل بوابة ما قبل التنفيذ على المهم
|
|
|
4
4
|
|
|
5
5
|
أنت Tera Agent.
|
|
6
6
|
|
|
7
|
+
> المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
|
|
8
|
+
|
|
7
9
|
طبّق `tera-system/TeraPreExecutionGate.md` على المهمة الحالية.
|
|
8
10
|
|
|
9
11
|
الخطوات:
|
package/commands/tera-help.md
CHANGED
|
@@ -29,6 +29,7 @@ description: عرض أوامر Tera المتاحة بعبارات بسيطة
|
|
|
29
29
|
| `/tera-gate` | فحص الجاهزية قبل التنفيذ |
|
|
30
30
|
| `/tera-approve` | الموافقة على مرحلة |
|
|
31
31
|
| `/tera-diagnose` | تشخيص مشكلة |
|
|
32
|
+
| `/tera-reconcile` | فحص اتساق سجلات المشروع (CONSISTENT / DRIFT_FOUND) |
|
|
32
33
|
| `/tera-help` | هذه القائمة |
|
|
33
34
|
|
|
34
35
|
## أوامر التهيئة الذاتية (لكل عميل حسب اختصاصه)
|
|
@@ -1,35 +1,32 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: بدء مشروع جديد —
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent.
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
1.
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
الخطوة التالية:
|
|
34
|
-
- [طلب توضيح / اقتراح إضافات / تأكيد الفهم]
|
|
35
|
-
```
|
|
1
|
+
---
|
|
2
|
+
description: بدء مشروع جديد — موجّه (Router) لا منفّذ Intake
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent. **لست منفّذ Intake — أنت موجّه (Router).** اتبع `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` (بوابة المسار §1).
|
|
6
|
+
|
|
7
|
+
## مسار التوجيه
|
|
8
|
+
|
|
9
|
+
1. حدّد نوع الطلب:
|
|
10
|
+
- **مشروع عميل خارجي** → **TCEA** (`tera-client-engagement`): Client Discovery → Pricing → Approval → Handoff.
|
|
11
|
+
- **مشروع داخلي (غير عميل)** → **ApplicationBlueprintAgent** (`application-blueprint`): Intake + Phases 1–4 (blueprint/تحضير).
|
|
12
|
+
- **Engineering Handoff Package جاهز** → **Tera** (Phases 5–7 — دورك).
|
|
13
|
+
2. صرّح بالمسار المختار والجهة المالكة له، واطلب الموافقة على تفعيل الجهة الصحيحة (عبر `/tera-orient-...`).
|
|
14
|
+
3. **لا تبدأ Intake بنفسك** — قراءة `project-inputs/` وصياغة ملخص الفهم الأولي ملك مُهندس (داخلي) أو TCEA (خارجي).
|
|
15
|
+
|
|
16
|
+
اعرض:
|
|
17
|
+
|
|
18
|
+
```
|
|
19
|
+
## توجيه مشروع جديد
|
|
20
|
+
|
|
21
|
+
النوع: داخلي / عميل خارجي / Handoff جاهز
|
|
22
|
+
الجهة المالكة: application-blueprint / TCEA / Tera
|
|
23
|
+
السبب: ...
|
|
24
|
+
التفعيل المقترح: /tera-orient-... (بانتظار موافقتك)
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## قواعد صارمة
|
|
28
|
+
- Intake والتمهيد والتقدير التجاري **ليست دور Tera** — Tera يبدأ من Phase 5 (بعد `ENGINEERING_HANDOFF_PACKAGE`).
|
|
29
|
+
- لا تُنشئ `TERA_PROJECT_DECISION.md` ولا ملفات تحضير ولا intake.
|
|
30
|
+
- لا تختر Technology Profile.
|
|
31
|
+
- **كشف العميل/الاكتشاف التجاري ليس دورك — ملك TCEA.**
|
|
32
|
+
- إن كان الطلب غامضاً (داخلي/خارجي) → اسأل سؤالاً واحداً قصيراً ثم وجّه.
|
|
@@ -5,7 +5,7 @@ agent: tera-software-designer
|
|
|
5
5
|
|
|
6
6
|
طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
|
|
7
7
|
|
|
8
|
-
ملفك التشغيلي: `.opencode/agents/tera-software-designer.md`. ركّز إضافياً على: دورك في
|
|
8
|
+
ملفك التشغيلي: `.opencode/agents/tera-software-designer.md`. ركّز إضافياً على: دورك في إعداد **المواصفة التقنية** (`TECHNICAL_SPECIFICATION.md`) للمهام ذات محفّز الأثر، وعلاقتك بالمهام المؤثرة (impactive tasks)، وحدودك (لا كود تنفيذي — pseudocode/interface signatures غير تنفيذية فقط داخل المواصفة عند الحاجة).
|
|
9
9
|
|
|
10
10
|
اقرأ مصادرك المرجعية: `project-preparation/*.md` (مخططات الحل وقواعد التصميم التنفيذية مثل 28_UI_UX_GUIDELINES.md)، `project-control/PROJECT_RULES.md` إن وُجد (قواعد المشروع).
|
|
11
11
|
|
|
@@ -7,6 +7,6 @@ agent: tera
|
|
|
7
7
|
|
|
8
8
|
ملفك التشغيلي: `.opencode/agents/tera.md`. ركّز إضافياً على: Orchestration Decision Matrix، بوابات Pre-Execution/Post-Execution، مالك التفعيل (Phases 1–4 لمُهندس / 5–7 لك)، وبروتوكول التفويض في `TERA_RUNTIME_PROTOCOLS_CORE.md` §4.
|
|
9
9
|
|
|
10
|
-
اقرأ مصادرك المرجعية: `tera-system/runtime/TERA_RUNTIME_*.md` (البروتوكولات والقوائم والقوالب)،
|
|
10
|
+
اقرأ مصادرك المرجعية: `tera-system/runtime/TERA_RUNTIME_*.md` (البروتوكولات والقوائم والقوالب)، و`project-control/` (حالة المشروع والسجلات الحاكمة + `ENGINEERING_HANDOFF_PACKAGE.md` داخل **مشروع التطبيق النشط**).
|
|
11
11
|
|
|
12
12
|
لا تبدأ أي تفويض أو عمل قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
|
package/commands/tera-plan.md
CHANGED
|
@@ -4,6 +4,8 @@ description: التخطيط التلقائي — توليد الخطة بأسئ
|
|
|
4
4
|
|
|
5
5
|
أنت Tera Agent في وضع التخطيط (قراءة وتحليل فقط — لا تنفيذ).
|
|
6
6
|
|
|
7
|
+
> المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
|
|
8
|
+
|
|
7
9
|
مهمتك: **توليد الخطة تلقائياً** — لا تطلب من المستخدم كتابة أو نسخ برومبت أو قالب طويل.
|
|
8
10
|
|
|
9
11
|
الخطوات:
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: فحص اتساق سجلات المشروع وإصدار CONSISTENT / DRIFT_FOUND — Reconciliation
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent. اتبع `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` (بوابة المسار §1 · شروط الإغلاق §3 · معاملة الإغلاق §4).
|
|
6
|
+
|
|
7
|
+
افحص اتساق الحالة عبر السجلات دون تعديل (قراءة فقط):
|
|
8
|
+
|
|
9
|
+
1. **حلّ المسار (§1):** `ActiveAppPath` → `ProjectControlPath`. إن لم يتضح → توقف واسأل.
|
|
10
|
+
2. اقرأ (ضمن `<ProjectControlPath>/`): آخر مهمة في `TASK_REGISTRY.md`، حالتها في ملف المهمة، `PROJECT_STATE.md`، `DECISIONS_LOG.md`، آخر `PROJECT_ACTIVITY_LOG.md`، و`TERA_AUDIT_TRAIL.md`، و`ISSUES_AND_GAPS.md` عند الحاجة.
|
|
11
|
+
3. تحقّق من:
|
|
12
|
+
- تطابق حالة المهمة بين الملفات (Task ↔ REGISTRY ↔ STATE).
|
|
13
|
+
- وجود Handback وPost-Execution Review وCompliance Record للإغلاقات الحديثة.
|
|
14
|
+
- وجود اعتماد المالك حيث `Owner Approval Required = Yes`.
|
|
15
|
+
- وجود إدخال Audit Trail مقابل كل إغلاق جوهري.
|
|
16
|
+
- لا IDs مكررة / لا حالة "Closed" مع سجل ناقص.
|
|
17
|
+
|
|
18
|
+
اعرض:
|
|
19
|
+
|
|
20
|
+
```
|
|
21
|
+
## Reconciliation — [ActiveApp / TASK-ID]
|
|
22
|
+
|
|
23
|
+
| الفحص | النتيجة | ملاحظة |
|
|
24
|
+
|---|---|---|
|
|
25
|
+
| حالة المهمة موحّدة | CONSISTENT / DRIFT | ... |
|
|
26
|
+
| Handback + Post-Execution + Compliance | PASS / MISSING | ... |
|
|
27
|
+
| Owner Approval (إن لزم) | OK / MISSING / N/A | ... |
|
|
28
|
+
| Audit Trail مقابل الإغلاق | OK / MISSING | ... |
|
|
29
|
+
| لا IDs مكررة | OK / DUPLICATE | ... |
|
|
30
|
+
|
|
31
|
+
النتيجة: CONSISTENT / DRIFT_FOUND
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
- إذا `DRIFT_FOUND`: اعرض الانحرافات فقط واقترح إجراءً — **ولا تصلح تلقائياً** دون موافقة.
|
|
35
|
+
- لا تُغلق أو تعدّل أي مهمة ضمن هذا الأمر.
|
|
@@ -6,6 +6,8 @@ description: طلب الدخول في Build Mode — المراجعة قبل ا
|
|
|
6
6
|
|
|
7
7
|
**لا تبدأ التنفيذ مباشرة.** هذا الأمر يطلب الموافقة فقط.
|
|
8
8
|
|
|
9
|
+
> المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
|
|
10
|
+
|
|
9
11
|
اتبع الخطوات التالية بالترتيب:
|
|
10
12
|
|
|
11
13
|
1. تأكد من وجود Approved TASK-ID في `project-control/TASK_REGISTRY.md`.
|
package/commands/tera-resume.md
CHANGED
|
@@ -4,6 +4,8 @@ description: استئناف المشروع من آخر نقطة توقف
|
|
|
4
4
|
|
|
5
5
|
أنت Tera Agent في مشروع قائم ومستمر.
|
|
6
6
|
|
|
7
|
+
> المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
|
|
8
|
+
|
|
7
9
|
اتبع هذه الخطوات بالترتيب الصارم:
|
|
8
10
|
|
|
9
11
|
1. اقرأ `project-control/TERA_ACTIVE_CONTEXT.md` أولاً إذا كان موجوداً.
|
package/commands/tera-review.md
CHANGED
|
@@ -4,6 +4,8 @@ description: مراجعة ما بعد التنفيذ لآخر مهمة — Post-
|
|
|
4
4
|
|
|
5
5
|
أنت Tera Agent. المستخدم يطلب مراجعة ما بعد التنفيذ لأحدث مهمة.
|
|
6
6
|
|
|
7
|
+
> المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
|
|
8
|
+
|
|
7
9
|
اتبع الخطوات التالية بالترتيب:
|
|
8
10
|
|
|
9
11
|
1. اقرأ `project-control/TASK_REGISTRY.md`.
|
package/commands/tera-status.md
CHANGED
|
@@ -4,6 +4,8 @@ description: تقرير سريع عن حالة المشروع الحالي
|
|
|
4
4
|
|
|
5
5
|
أنت Tera Agent.
|
|
6
6
|
|
|
7
|
+
> المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
|
|
8
|
+
|
|
7
9
|
اقرأ هذين الملفين فقط:
|
|
8
10
|
- `project-control/PROJECT_STATE.md`
|
|
9
11
|
- `project-control/TASK_REGISTRY.md`
|
|
@@ -54,9 +54,9 @@
|
|
|
54
54
|
| engineering-agent-flutter | `ENGINEERING_AGENT_FLUTTER` | `PHASE_GATE`: مهمة Flutter/Dart mobile client مع `Pre-Execution Gate: PASS` | 6 | لا لمهام Backend (django). لا لتصميم بصري (ui-designer) | ملفات معتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` + Active `flutter-mobile` Profile |
|
|
55
55
|
| engineering-agent-django | `ENGINEERING_AGENT_DJANGO` | `PHASE_GATE`: مهمة Python/Django/DRF backend مع `Pre-Execution Gate: PASS` | 6 | لا لمهام Flutter (flutter). لا صلاحيات مالية بلا بوابة أمنية | ملفات معتمدة + `TASK-ID` + `Pre-Execution Gate: PASS` + Active `python-django` Profile |
|
|
56
56
|
| ui-designer | `UI_VISUAL_DESIGNER_AGENT` | `COMPLEXITY_SIGNAL`: وجود Frontend مهم أو مصدر تصميم (Figma, getdesign.md, screenshots) | 4–5 | API-only أو UI بسيط بدون متطلبات بصرية | `07_SCREENS_AND_UI_STRUCTURE.md` + مصدر التصميم |
|
|
57
|
-
| tera-software-designer | `SOFTWARE_DESIGNER_AGENT` | `
|
|
57
|
+
| tera-software-designer | `SOFTWARE_DESIGNER_AGENT` | `IMPACT_SIGNAL`: أي محفّز أثر (DB/migration · auth/permissions/security · API عام · cross-module · مالي · مخزون · protocol/crypto · تغيير توافق · state machine معقّد · حدود معمارية) → **`SDA_REQUIRED` إلزامي** — **Impact يتجاوز Complexity**. `FAST_PATH` فقط بشروط الأمان الكاملة + سبب مكتوب | 5–6 | `NOT_APPLICABLE` (وثائقي/تشغيلي بحت) أو `FAST_PATH` مستوفٍ | `ENGINEERING_HANDOFF_PACKAGE.md` + ملف الـDraft Task + الملفات التحضيرية **المُطبَّقة على المهمة** (لا قائمة ثابتة) |
|
|
58
58
|
| qa-agent | `QA_ACCEPTANCE_AGENT` | **Planning:** `PHASE_GATE` + `DOCUMENT_READY`. **Execution:** `DOCUMENT_READY` بعد تنفيذ `TASK-COD-*` يحتاج تحقق فعلي. **كلا الوضعين:** قبل Phase 7 | 5–6–7 | مهمة بسيطة واضحة / لا تحتاج اختبار CLI | `10_TESTING_AND_ACCEPTANCE.md` أو ملف `TASK-COD-*` المنفذ + معايير القبول |
|
|
59
|
-
| auditor | `AUDITOR` | `TASK_COMPLETED` + `RISK_SIGNAL` / `QUALITY_SIGNAL` / `REVIEW_NEEDED`؛ ويستدعيه Monitor فقط بطلب Majed | 6 | مهمة وثائقية صغيرة وقرار Tera `AUDITOR_REVIEW_NOT_REQUIRED` مع سبب | ملف المهمة + Handback + diff/changed files + QA/Security evidence |
|
|
59
|
+
| auditor | `AUDITOR` | `TASK_COMPLETED` + `RISK_SIGNAL` / `QUALITY_SIGNAL` / `REVIEW_NEEDED`؛ ويستدعيه Monitor فقط بطلب Majed؛ وفي Phases 1–4: `PHASE_GATE` — **مراجعة اتساق تحضير (كل دفعة)** بطلب مُهندس (SCP-2026-09-24-006) | 6 (و 1–4 لوضع Preparation-Review) | مهمة وثائقية صغيرة وقرار Tera `AUDITOR_REVIEW_NOT_REQUIRED` مع سبب | ملف المهمة + Handback + diff/changed files + QA/Security evidence؛ أو دفعة مستندات تحضير + upstream + template |
|
|
60
60
|
| design-reviewer | `DESIGN_REVIEWER` | `PHASE_GATE`: بعد إنتاج TASK-PROTO-* الأول؛ و`REVIEW_NEEDED` للواجهات المنفذة | 5–6 | لا واجهات/بروتوتايب (API-only) أو `WAIVED_BY_MAJED` | `project-control/prototypes/` + مصدر التصميم + `07_SCREENS_AND_UI_STRUCTURE.md` |
|
|
61
61
|
| monitor | `MONITOR` | `REVIEW_NEEDED`: مراجعة امتثال الخطط (يستدعي Auditor عند الحاجة) | 5–7 | — | خطط + سجلات |
|
|
62
62
|
| tera-client-engagement | `TCEA` | `EXTERNAL_FACTOR`: مشروع عميل خارجي / Consulting Mode | قبل Phase 1 | مشروع داخلي | `CLIENT_PROFILE.md` + `project-inputs/` |
|
|
@@ -68,8 +68,8 @@
|
|
|
68
68
|
| project-knowledge-agent | `PROJECT_KNOWLEDGE_AGENT` | `TASK_COMPLETED`: بعد مهمة مؤثرة — تحديث الذاكرة التشغيلية | 5–7 | مهمة غير مؤثرة | TASK-ID + ملخص المهمة |
|
|
69
69
|
| tera-system-evolution | `TERA_SYSTEM_EVOLUTION` | `USER_REQUEST`: تطوير/حوكمة منظومة Tera — يستدعيه Majed | — | — | طلب Majed |
|
|
70
70
|
| red-team-agent (الشبح) | `RED_TEAM_AGENT` | `PHASE_7_GATE`: بوابة الأمن قبل التسليم — أو `USER_REQUEST` من Majed | 7 (أو بطلب Majed) | لا يُفعّل تلقائياً في Phases 1–6؛ لا على Production بلا تفويض مكتوب | `00_AUTHORIZATION.md` + URL/البيئة + Commit SHA + الحدود |
|
|
71
|
-
| security-observer (العين) | `SECURITY_OBSERVER` | بالتزامن مع تفعيل Red Team | 7 (بالتزامن) | لا يُفعّل وحده بلا جولة | Round ID + سجلات التطبيق + Canary baseline + Test IDs |
|
|
72
|
-
| security-auditor (القاضي) | `SECURITY_AUDITOR` | بعد
|
|
71
|
+
| security-observer (العين) | `SECURITY_OBSERVER` | `PHASE_7_GATE`: بالتزامن مع تفعيل Red Team | 7 (بالتزامن) | لا يُفعّل وحده بلا جولة | Round ID + سجلات التطبيق + Canary baseline + Test IDs |
|
|
72
|
+
| security-auditor (القاضي) | `SECURITY_AUDITOR` | `PHASE_7_GATE`: بعد اكتمال Red Team + Observer + Fixes + Retest | 7 (بعد الجولة) | لا يُفعّل قبل اكتمال الأدلة؛ لا PASS مع Critical/High مفتوحة | تقرير الشبح + تقرير العين + الأدلة + المصفوفات + سجلات الإصلاح |
|
|
73
73
|
|
|
74
74
|
### 2.2 الأدوار التحضيرية (Preparation Roles — يملكها application-blueprint)
|
|
75
75
|
|
|
@@ -190,9 +190,13 @@
|
|
|
190
190
|
### 4.1 لا تفعيل تلقائي للعملاء
|
|
191
191
|
|
|
192
192
|
```
|
|
193
|
-
تفعيل العميل يتم بقرار من
|
|
194
|
-
|
|
195
|
-
|
|
193
|
+
تفعيل العميل يتم بقرار من مالك التفعيل في مرحلته (Phases 1–4: application-blueprint · Phases 5–7: TeraAgent)،
|
|
194
|
+
استنادًا إلى Trigger واضح — لا لمجرد دخول مرحلة أو وجود ملف جاهز.
|
|
195
|
+
|
|
196
|
+
الاستثناءات المكتوبة (لا استدعاء مباشر آخر):
|
|
197
|
+
1. Monitor → Auditor: فقط بطلب Majed لمراجعة/تحدي عمل Tera بجودة مستقلة.
|
|
198
|
+
2. TCEA و application-blueprint → domain-research-agent / domain-expert-agent / production-erp-expert:
|
|
199
|
+
استدعاء مباشر للبحث/التحليل فقط، وفق TeraSubAgents.md §3.2.1 (لا إدارة، لا تفويض تنفيذ).
|
|
196
200
|
```
|
|
197
201
|
|
|
198
202
|
### 4.2 لا تفعيل بدون مدخلات كافية
|
|
@@ -31,9 +31,10 @@
|
|
|
31
31
|
| **production-erp-expert.md** | Majed مباشرة، `tera.md`, `tera-client-engagement.md`, `application-blueprint.md`؛ وEngineering/QA فقط عبر Tera-approved task scope | `domain-research-agent.md` عند نقص المعرفة وبقرار المستدعي | `tera-system/knowledge-base/manufacturing/`, ملفات discovery/blueprint المحددة |
|
|
32
32
|
| **tera-system-evolution.md** | — (مستقل — يستدعيه Majed) | `ui-designer.md`, `domain-research-agent.md`, `domain-expert-agent.md` (للأغراض النظامية) | `tera-system/*.md`, `.opencode/agents/*.md` |
|
|
33
33
|
| **tera-strategic-advisor.md** | — (مستقل — يستدعيه Majed فقط) | لا يستدعي عملاء ولا يديرهم؛ قد يوصي Majed بالرجوع إلى TeraAgent أو حارس أو غيرهم | ملفات وسياقات القرار فقط، مصادر خارجية عند الحاجة |
|
|
34
|
-
| **auditor.md** | `tera.md`؛ و`monitor.md` فقط عند طلب Majed | يراجع مخرجات `tera.md`, `engineering-agent.md`؛ يحيل findings إلى `SecurityAgent`, `DesignReviewer`, `qa-agent`, أو `ProjectControlAgent` عبر الوكيل المستدعي | `project-control/*.md`, `project-control/audit-reports/`, `tera-system/engineering-governance/*.md`, الملفات
|
|
34
|
+
| **auditor.md** | `tera.md`؛ و`monitor.md` فقط عند طلب Majed؛ و`application-blueprint.md` (مراجعة تحضير فقط — وضع Preparation-Review، كل دفعة، Phases 1–4 — SCP-2026-09-24-006) | يراجع مخرجات `tera.md`, `engineering-agent.md`؛ يحيل findings إلى `SecurityAgent`, `DesignReviewer`, `qa-agent`, أو `ProjectControlAgent` عبر الوكيل المستدعي | `project-control/*.md`, `project-control/audit-reports/`, `tera-system/engineering-governance/*.md`, الملفات المعدلة؛ أو دفعة مستندات التحضير + upstream + template |
|
|
35
35
|
| **monitor.md** | — (مستقل — يستدعيه Majed) | يراجع مخرجات `tera.md`, `engineering-agent.md`; قد يستدعي `auditor.md` فقط عندما يطلب Majed تحدي/تحقق جودة مستقل | `project-control/*.md`, `tera-system/*.md` |
|
|
36
36
|
| **qa-agent.md** (الاسم المنطقي: qa-agent) | `tera.md` (يُفعّله Tera) | لا يستدعي عملاء آخرين | ملفات التحضير، ملفات المهمة، logs، مخرجات CLI، `project-control/test-reports/` |
|
|
37
|
+
| **project-knowledge-agent.md** | `tera.md` (بعد مهمة مؤثرة — TASK_COMPLETED) | — | `project-knowledge/` داخل التطبيق، ملف المهمة المؤثرة |
|
|
37
38
|
| **red-team-agent.md** 🆕 (الشبح — SCP-2026-09-02-001) | `tera.md` (Phase 7 Security Gate)؛ Majed مباشرة | `security-observer.md` (العين يراقبه بالتزامن)، `security-auditor.md` (القاضي يدقق أدلته)؛ يستلم `defense-handoff.md` من الدرع عبر Tera | `security-reports/[ROUND-ID]/`, البروتوكول الأمني v2.0, `tera-system/TOOLING_AND_MCP_POLICY.md` |
|
|
38
39
|
| **security-observer.md** 🆕 (العين — SCP-2026-09-02-001) | `tera.md` (بالتزامن مع Red Team)؛ Majed مباشرة | يراقب أثر `red-team-agent.md` (الشبح) — لا يهاجم ولا يصلح | `security-reports/[ROUND-ID]/`, سجلات التطبيق والموارد، تقرير الشبح |
|
|
39
40
|
| **security-auditor.md** 🆕 (القاضي — SCP-2026-09-02-001) | `tera.md` (بعد Red Team + Observer + Retest)؛ Majed مباشرة | يدقق أدلة `red-team-agent.md` (الشبح) + تقرير `security-observer.md` (العين) — يرفض الادعاءات بلا دليل | `security-reports/[ROUND-ID]/audit/`, ASVS 5.0 L2, WSTG, تقارير الشبح والعين |
|
|
@@ -67,12 +68,13 @@ ui-designer.md
|
|
|
67
68
|
|
|
68
69
|
---
|
|
69
70
|
|
|
70
|
-
## ⚠️ تنبيهات حجم الملف
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
71
|
+
## ⚠️ تنبيهات حجم الملف
|
|
72
|
+
|
|
73
|
+
> **ملاحظة (SCP-2026-09-24-001):** القاعدة المحدّثة: < 700 = ✅, 700–1000 = 🟡 دراسة, > 1000 = 🔴 تقسيم إجباري.
|
|
74
|
+
> **العدّادات أدناه لقطة زمنية تاريخية وليست مصدر حقيقة** — القياس الحيّ هو `wc -l` / عدّاد القارئ الفعلي وقت الحاجة (العدّاد اليدوي المتقادم سبب معروف للانحراف).
|
|
75
|
+
|
|
76
|
+
| الملف | الحجم (سطور — لقطة تاريخية) | الحالة / ملاحظات |
|
|
77
|
+
|-------|-------------|-----------------|
|
|
76
78
|
| `tera.md` | 558 | 🟢 < 700 — +005: micro-fixes (presentation/WAIVED/29–39/commands pointer) — من 556 |
|
|
77
79
|
| `tera-system/TeraSubAgents.md` | 855 | 🟡 700–1000 — يحتاج دراسة تقسيم قريبة |
|
|
78
80
|
| `tera-system/TeraHelperAgents.md` | 970 | 🟡 700–1000 — يحتاج دراسة تقسيم قريبة |
|
|
@@ -95,12 +95,13 @@ This agent is activated based on `AGENT_ACTIVATION_MATRIX.md` triggers:
|
|
|
95
95
|
|
|
96
96
|
## Default Permission Level
|
|
97
97
|
|
|
98
|
-
Based on `AGENT_PERMISSION_MODEL.md
|
|
98
|
+
Based on `AGENT_PERMISSION_MODEL.md` (حزم غير متوارثة — SCP-2026-09-24-001):
|
|
99
99
|
|
|
100
|
-
- **Default
|
|
101
|
-
- **Can
|
|
102
|
-
- **Can
|
|
103
|
-
- **
|
|
100
|
+
- **Default Bundle(s):** `READ_ONLY` / `PLAN_ONLY` / `WRITE_DOCS` / `WRITE_KNOWLEDGE` / `WRITE_CONTROL` / `RUN_TESTS` / `WRITE_CODE` / `DEPLOY_WITH_APPROVAL` (+ نطاق أمني: `EXECUTE_ATTACKS` / `WRITE_EVIDENCE`)
|
|
101
|
+
- **Can add bundle:** [حزمة إضافية عند الحاجة الفعلية، بشرط موافقة مالك التفعيل] — الحزمة **لا تُورّث** صلاحيات حزمة أخرى
|
|
102
|
+
- **Can narrow to:** [حزمة أضيق إذا كانت المهمة محدودة]
|
|
103
|
+
- **Non-inheritance:** `WRITE_CODE` ≠ `WRITE_CONTROL`؛ أي حزمة لا تشمل غيرها تلقائياً. الصلاحية الفعّالة = الحزم + الدور + المهمة + Allowed Write Targets + الموافقات.
|
|
104
|
+
- **Rule:** لا يحق للعميل تجاوز صلاحيته الافتراضية دون قرار صريح من مالك التفعيل.
|
|
104
105
|
|
|
105
106
|
## Token Budget
|
|
106
107
|
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
|
|
22
22
|
---
|
|
23
23
|
|
|
24
|
-
## 1.
|
|
24
|
+
## 1. حزم الصلاحيات (Permission Bundles — غير متوارثة) — SCP-2026-09-24-001
|
|
25
25
|
|
|
26
26
|
```
|
|
27
27
|
┌─────────────────────┐
|
|
@@ -65,7 +65,7 @@
|
|
|
65
65
|
└─────────────────────┘
|
|
66
66
|
```
|
|
67
67
|
|
|
68
|
-
|
|
68
|
+
**تصحيح اتساق (SCP-2026-09-24-001):** ما يظهر أعلاه **خريطة مرجعية للحزم** وليس سلماً متوارثاً. لا تشمل أي حزمة صلاحيات حزمةً أخرى تلقائياً — كل حزمة تُمنح صراحةً عند الحاجة (Least Authority). مثال: `WRITE_CODE` تسمح بالكود وتمنع سجلات التحكم، و`WRITE_CONTROL` تسمح بسجلات التحكم وتمنع الكود — لا إحداهما تتضمن الأخرى. قد يُمنح العميل **أكثر من حزمة** عند الحاجة الفعلية (مثل `WRITE_CONTROL` + `WRITE_DOCS` لـ TeraAgent) وتُسجَّل. الصلاحية الفعّالة محكومة دائماً بالدور + المهمة + `Allowed Write Targets` + البيئة + الأدوات + الموافقات؛ ولا تلغي أي حزمة قيداً على مستوى الدور. المفهوم المهيمن هو: كل عميل يحصل على **مجموعة القدرات التي يحتاجها فقط**، لا رتبة في سلم.
|
|
69
69
|
|
|
70
70
|
---
|
|
71
71
|
|
|
@@ -115,7 +115,7 @@
|
|
|
115
115
|
| تشغيل اختبارات | ❌ ممنوع |
|
|
116
116
|
| إنشاء ملفات جديدة | ✅ ضمن `Allowed Write Targets` فقط |
|
|
117
117
|
|
|
118
|
-
**متى يستخدم:** للعملاء الذين ينتجون
|
|
118
|
+
**متى يستخدم:** للعملاء الذين ينتجون **توثيقًا/تحضيرًا بلا كود** — مثل `application-blueprint` (ملفات التحضير) وعملاء توثيق التسليم (عبر tera.md). **لا يشمل `ui-designer`** (يكتب كود واجهة عرضية → `WRITE_CODE`) — SCP-2026-09-29-012.
|
|
119
119
|
|
|
120
120
|
---
|
|
121
121
|
|
|
@@ -183,9 +183,9 @@
|
|
|
183
183
|
| كتابة ملفات تحضير | ❌ ممنوع |
|
|
184
184
|
| كتابة ملفات تحكم | ❌ ممنوع |
|
|
185
185
|
| تعديل project-control | ❌ ممنوع |
|
|
186
|
-
| DEPLOY | ❌ ممنوع
|
|
186
|
+
| DEPLOY / النشر | ❌ ممنوع — النشر ملك `DevOpsDeploymentAgent` فقط (فصل المهام). لا يُرفع EngineeringAgent إلى `DEPLOY_WITH_APPROVAL` (SCP-2026-09-24-001) |
|
|
187
187
|
|
|
188
|
-
**متى يستخدم:** لـ EngineeringAgent وأي عميل
|
|
188
|
+
**متى يستخدم:** لـ EngineeringAgent وأي عميل تنفيذي **يكتب كوداً** — بما فيه `ui-designer` (نطاق محدود: مكوّنات عرضية/واجهة فقط — SCP-2026-09-29-012).
|
|
189
189
|
|
|
190
190
|
---
|
|
191
191
|
|
|
@@ -193,7 +193,8 @@
|
|
|
193
193
|
|
|
194
194
|
| البند | القيمة |
|
|
195
195
|
|---|---|
|
|
196
|
-
|
|
|
196
|
+
| عمليات الكود اللازمة للنشر فقط (بناء/حزم/سكربتات نشر) — ضمن `Allowed Write Targets` | ✅ |
|
|
197
|
+
| سجلات التحكم/التوثيق (`project-control`, `tera-system`) | ❌ ممنوع — الحزمة **لا تُورّث** صلاحيات أخرى |
|
|
197
198
|
| نشر على بيئة | ✅ بعد موافقة صريحة |
|
|
198
199
|
| تعديل CI/CD | ✅ بعد موافقة صريحة |
|
|
199
200
|
| تغيير إعدادات بيئة | ✅ بعد موافقة صريحة |
|
|
@@ -204,6 +205,19 @@
|
|
|
204
205
|
|
|
205
206
|
---
|
|
206
207
|
|
|
208
|
+
### 2.9 صلاحيات النطاق الأمني (Security-Scoped Permissions)
|
|
209
|
+
|
|
210
|
+
> حزم تُمنح لأدوار فريق الحماية فقط، بحدود صارمة (SCP-2026-09-02-001 + SCP-2026-09-24-001).
|
|
211
|
+
|
|
212
|
+
| الحزمة | تُمنح لـ | الحدود |
|
|
213
|
+
|---|---|---|
|
|
214
|
+
| `EXECUTE_ATTACKS` | `red-team-agent` (الشبح) | ضمن `00_AUTHORIZATION.md` فقط — لا هجوم خارج نطاق التفويض، ولا على production بلا تفويض مكتوب |
|
|
215
|
+
| `WRITE_EVIDENCE` | أدوار الأمن (الشبح/العين/القاضي) | داخل `security-reports/` فقط — فصل كتابة صارم (كل دور يكتب مساحته) |
|
|
216
|
+
|
|
217
|
+
> **ملاحظة:** `READ_WRITE` المذكور في §4.3 هو **وضع أداة** (مثل Structurizr لملفات `.dsl`) وليس حزمة صلاحيات عميل.
|
|
218
|
+
|
|
219
|
+
---
|
|
220
|
+
|
|
207
221
|
## 3. مصفوفة الصلاحية الافتراضية لكل عميل
|
|
208
222
|
|
|
209
223
|
### 3.1 العملاء الأساسيون (الـ 25 الرسميون)
|
|
@@ -218,10 +232,12 @@
|
|
|
218
232
|
| engineering-agent-typescript | `ENGINEERING_AGENT_TS` | `WRITE_CODE` | — | كود TypeScript/Node.js/React وظيفي |
|
|
219
233
|
| engineering-agent-phaser | `ENGINEERING_AGENT_PHASER` | `WRITE_CODE` | — | كود Phaser 3 Web Games |
|
|
220
234
|
| engineering-agent-dotnet | `ENGINEERING_AGENT_DOTNET` | `WRITE_CODE` | — | كود .NET/C# |
|
|
221
|
-
|
|
|
235
|
+
| engineering-agent-flutter | `ENGINEERING_AGENT_FLUTTER` | `WRITE_CODE` | — | كود Flutter/Dart (عميل موبايل) — SCP-2026-09-23-006 |
|
|
236
|
+
| engineering-agent-django | `ENGINEERING_AGENT_DJANGO` | `WRITE_CODE` | — | كود Python/Django/DRF (خادم) — SCP-2026-09-23-006 |
|
|
237
|
+
| ui-designer | `UI_VISUAL_DESIGNER_AGENT` | `WRITE_CODE` | إلى READ_ONLY إذا كان مراجعة فقط | **نطاق محدود:** مكوّنات عرضية/واجهة (TSX/CSS/Tailwind) + Design Tokens / UI Spec — **لا** منطق وظيفي (hooks/state/API) ولا backend. الاستثناء الوثائقي: ملف UI/UX Guidelines (`28_UI_UX_GUIDELINES.md`) ضمن Allowed Write Targets (SCP-2026-09-29-012) |
|
|
222
238
|
| tera-software-designer | `SOFTWARE_DESIGNER_AGENT` | `WRITE_DOCS` | إلى `PLAN_ONLY` إذا ما زالت الخطة غير ناضجة | يجهز Technical Specification للمهام فقط |
|
|
223
239
|
| 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 بعد التنفيذ؛ لا يعدّل
|
|
240
|
+
| auditor | `AUDITOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند كتابة تقرير التدقيق | تدقيق Diff-first بعد التنفيذ؛ لا يعدّل كوداً. + وضع `Preparation-Review` (قراءة فقط · تقرير) بطلب مُهندس — SCP-2026-09-24-006 |
|
|
225
241
|
| design-reviewer | `DESIGN_REVIEWER` | `READ_ONLY` | إلى `WRITE_DOCS` عند تقرير المراجعة | مراجعة بصرية مستقلة؛ لا يبني ولا يعدّل |
|
|
226
242
|
| monitor | `MONITOR` | `READ_ONLY` | إلى `WRITE_DOCS` عند تقارير الامتثال | يراقب الامتثال؛ يستدعي auditor بطلب Majed |
|
|
227
243
|
| tera-client-engagement | `TCEA` | `WRITE_DOCS` (ضمن client/) | — | Discovery + Scoping + Proposals للعملاء الخارجيين |
|
|
@@ -274,12 +290,13 @@
|
|
|
274
290
|
2. يتم توثيق رفع الصلاحية في `TASK-ID` أو `DECISIONS_LOG.md`.
|
|
275
291
|
3. الرفع يكون للمهمة الحالية فقط (لا يصبح دائمًا).
|
|
276
292
|
|
|
277
|
-
|
|
293
|
+
مثال (مُصحَّح — SCP-2026-09-24-001):
|
|
278
294
|
```
|
|
279
|
-
EngineeringAgent
|
|
280
|
-
Tera
|
|
281
|
-
|
|
295
|
+
EngineeringAgent ينفّذ الإصلاح بـ WRITE_CODE (بناء + اختبار محلي فقط)
|
|
296
|
+
→ إن لزم نشر: Tera يفوّض DevOpsDeploymentAgent (DEPLOY_WITH_APPROVAL + موافقة صريحة لكل عملية)
|
|
297
|
+
→ لا يُرفع EngineeringAgent إلى DEPLOY_WITH_APPROVAL — من يكتب الكود لا ينشره (Separation of Duties)
|
|
282
298
|
```
|
|
299
|
+
> الاستعجال ليس استثناءً من الموافقات — لا نشر بلا تفويض DevOps + موافقة صريحة لكل عملية.
|
|
283
300
|
|
|
284
301
|
### 4.2 خفض الصلاحية
|
|
285
302
|
|
|
@@ -79,6 +79,23 @@ Decision needed from Majed or Tera:
|
|
|
79
79
|
|
|
80
80
|
No hidden continuation is allowed after that point.
|
|
81
81
|
|
|
82
|
+
### 5.1 STOP Semantics — Freeze Writes, Continue Safe Discovery (SCP-2026-09-24-005)
|
|
83
|
+
|
|
84
|
+
`STOP` means **freeze writes**, not "halt all investigation":
|
|
85
|
+
|
|
86
|
+
```text
|
|
87
|
+
STOP WRITES
|
|
88
|
+
→ read-only impact scan (same task scope, no writes)
|
|
89
|
+
→ collect ALL related conflicts (not only the first)
|
|
90
|
+
→ return ONE complete STOP packet
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
- **No write** of any kind while stopped.
|
|
94
|
+
- Discovery stays **read-only** and within the task scope.
|
|
95
|
+
- Return **one complete** STOP packet listing all related conflicts → fewer `STOP → decision → STOP` round-trips.
|
|
96
|
+
- If a safe read-only scan is impossible, return the first STOP immediately (do not guess).
|
|
97
|
+
- This **never** weakens authority limits, scope control, or approval gates.
|
|
98
|
+
|
|
82
99
|
## 6. Task Completion Check
|
|
83
100
|
|
|
84
101
|
After completing a meaningful task or tool-backed action, the agent should confirm internally — and explicitly when governance-sensitive — that:
|
|
@@ -64,8 +64,8 @@ Release Package (ملفات Tera-managed + SHA256SUMS + TERA_RELEASE_MANIFEST.js
|
|
|
64
64
|
|
|
65
65
|
| الحزمة | الاسم (npm) | الإصدار الحالي | الوصف | الملفات الموزعة ضمن الحزمة |
|
|
66
66
|
|---|---|---|---|---|
|
|
67
|
-
| core | `@tera-system/core` | 0.
|
|
68
|
-
| pro | `@tera-system/pro` | 0.2.
|
|
67
|
+
| core | `@tera-system/core` | 0.6.0 | OpenCode Plugin — core governance (25 agents, 38 commands, distribution tools, security team) | `agents/`, `commands/`, `core/`, `assets/`, `tools/`, `scripts/` |
|
|
68
|
+
| pro | `@tera-system/pro` | 0.2.29 | Commercial edition — signed bundle + license gate + heartbeat | `scripts/`, `core/project-control`, `MANIFEST.json`, `opencode.tera.example.json`, `WELCOME.md`, `README.md` |
|
|
69
69
|
|
|
70
70
|
**مستودع الحزم:** `https://github.com/Alabasi1980/Teranoo-System` — حزمتا npm + الـ bundle الموقّع (بناء ونشر فقط؛ لا محتوى يدوي).
|
|
71
71
|
**المستودع الرسمي (`RepositoryUrl`):** `https://github.com/Alabasi1980/Teranoo-System-Core` — المصدر الوحيد المعتمد لـ `tera-fetch.ps1` و `tera-schedule.ps1` و `tera-update.ps1` (D1 — SCP-2026-09-23-002)
|
|
@@ -309,9 +309,12 @@ pwsh .\tools\update-client-repositories.ps1 -Version tera-v2.5.0 -Channel stable
|
|
|
309
309
|
|---|---|---|---|
|
|
310
310
|
| `tera-v1.0.0` | 2026-08-15 | stable | أول إصدار رسمي موثق: آلية توزيع كاملة (release/fetch/update/batch)، تنظيف شامل، وإصلاحات Pilot (gitattributes، commit detection) |
|
|
311
311
|
| `tera-v0.3.1` | 2026-09-18 | stable | Technology Profile `bun-ts-monorepo-sqlite` — Tag على مستودع المصدر `Teranoo-System-Core` (SCP-2026-09-18-001) [Verified] |
|
|
312
|
-
| *(npm)* core `0.4.0` / pro `0.2.26` | 2026-09-21 | stable | أوامر التهيئة الذاتية + معالجة الفجوات (SCP-2026-09-21-001/002) [Verified
|
|
312
|
+
| *(npm)* core `0.4.0` / pro `0.2.26` | 2026-09-21 | stable | أوامر التهيئة الذاتية + معالجة الفجوات (SCP-2026-09-21-001/002) [Verified] |
|
|
313
|
+
| *(npm)* core `0.4.1` / pro `0.2.27` | 2026-09-23 | stable | مصالحة التوزيع + مزامنة الأصول + وسم `tera-v0.4.1` (SCP-2026-09-23-002/003) [Verified] |
|
|
314
|
+
| *(npm)* core `0.5.0` / pro `0.2.28` | 2026-09-24 | stable | وكيلا Flutter/Django + بروفايل `python-django` (SCP-2026-09-23-006) [Verified: packages RELEASES] |
|
|
315
|
+
| *(npm)* core `0.6.0` / pro `0.2.29` | 2026-09-26 | stable | تقوية الحوكمة/التشغيل + بروتوكولات جديدة (SCP-2026-09-24-001..006) [Verified: npm view + bundle v0.2.29] |
|
|
313
316
|
|
|
314
|
-
> **الحالة الحالية (2026-09-
|
|
317
|
+
> **الحالة الحالية (2026-09-29):** آخر إصدار منشور = `@tera-system/core 0.6.0` + `@tera-system/pro 0.2.29` [Verified: `npm view`]؛ الـbundle المخدوم على `teranoo.com` = 0.2.29 (248 ملفاً) [Verified]. **آخر Git Tag على المصدر = `tera-v0.4.1` — وسم `tera-v0.5.0`/`tera-v0.6.0` مفقود (قرار معلّق؛ يمسّ قناة `tera-fetch`/`tera-update`).**
|
|
315
318
|
|
|
316
319
|
---
|
|
317
320
|
|
|
@@ -26,7 +26,7 @@ It is a map, not a policy source. Rules remain in the files listed in `TeraPolic
|
|
|
26
26
|
| Sub-agent lifecycle | Defines, generates, narrows, activates, and reviews specialized agents | `TeraSubAgents.md`, `AGENT_GENERATION_TEMPLATE.md`, `generated-agents/` |
|
|
27
27
|
| Delivery, handoff, and closure | Produces final delivery readiness, release notes, client handover material, acceptance records, and closure reports | `project-control/DELIVERY_READINESS_REPORT.md`, `project-control/PROJECT_CLOSURE_REPORT.md`, `clients/.../delivery/` |
|
|
28
28
|
| Project implementation knowledge | Maintains concise current-state operational knowledge per screen/module/service | `project-knowledge/` داخل كل تطبيق |
|
|
29
|
-
| Tera distribution and versioning | Builds releases and distributes Tera to client repositories in a versioned, verifiable way; clients derive updates from the origin repository (`https://github.com/Alabasi1980/Teranoo-System-Core`) via fetch + verified release packages (Tag `tera-vX.Y.Z` + Manifest + SHA lockfile + updater tools); npm packages `@tera-system/core 0.
|
|
29
|
+
| Tera distribution and versioning | Builds releases and distributes Tera to client repositories in a versioned, verifiable way; clients derive updates from the origin repository (`https://github.com/Alabasi1980/Teranoo-System-Core`) via fetch + verified release packages (Tag `tera-vX.Y.Z` + Manifest + SHA lockfile + updater tools); npm packages `@tera-system/core 0.6.0` + `@tera-system/pro 0.2.29`; website `https://github.com/Alabasi1980/TeraWebsite` hosts bundle at `https://teranoo.com` and is deployed via `https://coolify.teranoo.com/`; ownership contract separates Tera-managed from client-owned files | `tera-system/TERA_DISTRIBUTION_POLICY.md` (§2.2 الحزم + §2.3 الموقع + §2.0 الأصالة), `tera-workshop/tools/tera-fetch.ps1`, `tera-workshop/tools/tera-release.ps1`, `tera-workshop/tools/tera-update.ps1`, `.tera/lock.json` داخل مستودعات العملاء |
|
|
30
30
|
| Security Team (فريق الحماية) | Adversarial security validation before delivery: الدرع (defensive review during dev) → الشبح (Red Team — authorized attacks, Black Box then Gray/White Box) → العين (concurrent observer) → القاضي (independent audit + gate decision). Activated only at Phase 7 security gate or by Majed request. Outputs under `security-reports/` (same repo, outside the application folder). SCP-2026-09-02-001 | `.opencode/agents/red-team-agent.md`, `.opencode/agents/security-observer.md`, `.opencode/agents/security-auditor.md`, `tera-system/TeraHelperAgents.md` §6.1, `security-reports/`, adversarial protocol v2.0 (outside repo) |
|
|
31
31
|
|
|
32
32
|
## 3. Folder Roles
|
|
@@ -76,7 +76,7 @@
|
|
|
76
76
|
| الفئة | اللغات | آلية التنفيذ |
|
|
77
77
|
|---|---|---|
|
|
78
78
|
| 🥇 **متخصصة (Specialist)** | C#/.NET، TypeScript/Node.js/React، Phaser 3 (JS)، **Flutter/Dart**، **Python/Django** | عميل متخصص مخصص بمعايير كاملة |
|
|
79
|
-
| 🥈 **مغطاة ببروفايل** | Razor Pages+ADO.NET، Next.js+Prisma، WPF، Blazor+EF، React PWA، **Rust (
|
|
79
|
+
| 🥈 **مغطاة ببروفايل** | Razor Pages+ADO.NET، Next.js+Prisma، WPF، Blazor+EF، React PWA، **Rust (Available)** | Fallback + بروفايل (قواعد Scaffold/ORM/CLI موثقة) — Rust: بروفايل `rust.md` (✅ Available — مُثبَّت Pilot GEN-F05 · SCP-2026-09-29-017) |
|
|
80
80
|
| 🥉 **غير مغطاة (أي لغة أخرى)** | PHP/Laravel، Java/Spring، Go، Ruby، Kotlin، Swift... | **Fallback العام مباشرة** — يعمل بلا بروفايل (بجودة أقل) أو ببروفايل (بجودة موثقة) |
|
|
81
81
|
|
|
82
82
|
### 2.3 المعادلة الحاكمة
|
|
@@ -98,7 +98,7 @@
|
|
|
98
98
|
| المستوى | اللغات | الموقف |
|
|
99
99
|
|---|---|---|
|
|
100
100
|
| **ذكاء عالي + أداة** | Python، TypeScript/JS، C#، Java، Go، PHP، C/C++ | ✅ تنفيذ موثوق بجودة عالية حتى بلا بروفايل |
|
|
101
|
-
| **ذكاء متوسط + أداة** | Dart، Ruby، Kotlin، Swift (ببيئة Mac)، Rust (بروفايل
|
|
101
|
+
| **ذكاء متوسط + أداة** | Dart، Ruby، Kotlin، Swift (ببيئة Mac)، Rust (بروفايل ✅ Available — SCP-2026-09-29-017) | ✅ يعمل — بروفايل يرفع الجودة |
|
|
102
102
|
| **ذكاء محدود + أداة** | لغات نادرة/جديدة/إصدارات حديثة جداً | ⚠️ يعمل لكن بخطأ محتمل — بروفايل شبه إلزامي |
|
|
103
103
|
| **أي مستوى بلا أداة** | أي لغة بلا CLI/بيئة بناء | 🔴 تتوقف عند "الكتابة" ولا تصل "التسليم" |
|
|
104
104
|
|