@tera-system/core 0.2.19 → 0.2.20
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 +4 -4
- package/RELEASES.md +14 -0
- package/commands/tera-approve.md +34 -34
- package/commands/tera-diagnose.md +47 -47
- package/commands/tera-gate.md +40 -40
- package/commands/tera-help.md +41 -41
- package/commands/tera-new-project.md +35 -35
- package/commands/tera-plan.md +34 -34
- package/commands/tera-request-build.md +45 -45
- package/commands/tera-resume.md +34 -34
- package/commands/tera-review.md +52 -52
- package/commands/tera-status.md +38 -38
- package/commands/tera-update.md +48 -48
- package/core/tera-system/TeraCapabilityMap.md +3 -3
- package/core/tera-system/profiles/PROFILES_INDEX.md +1 -0
- package/core/tera-system/profiles/rust.md +164 -0
- package/package.json +1 -1
- package/scripts/install.js +20 -15
- package/scripts/tera-license.mjs +0 -63
package/MANIFEST.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tera-system/core",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.20",
|
|
4
4
|
"description": "Build manifest for the Tera System OpenCode Plugin component.",
|
|
5
5
|
"compatibleEnvironments": [
|
|
6
6
|
"opencode"
|
|
@@ -9,15 +9,15 @@
|
|
|
9
9
|
"content": {
|
|
10
10
|
"agents": 23,
|
|
11
11
|
"commands": 11,
|
|
12
|
-
"coreFiles":
|
|
12
|
+
"coreFiles": 119,
|
|
13
13
|
"tools": 8,
|
|
14
14
|
"projectControlTemplates": 1,
|
|
15
15
|
"assets": 49
|
|
16
16
|
},
|
|
17
17
|
"sha256": {
|
|
18
18
|
"agents": "48e5119282014b760d6e299c013ca575a787078a04fd09c84ae91e714ed62a85",
|
|
19
|
-
"commands": "
|
|
20
|
-
"core/tera-system": "
|
|
19
|
+
"commands": "6298a28e323c5d9d38aaef99582b43e54c4b00ad5b1421231ec2d6e712f972e2",
|
|
20
|
+
"core/tera-system": "8426bf17c61f9409feee3857c342de01fd54ab38aa306e9c9c68ae42aca40fb3",
|
|
21
21
|
"tools": "cea993304a3664ceac13685fbfd0bb0e51936236661689fa1fe603a14537ce5e",
|
|
22
22
|
"core/project-control": "cb979181d50e54c9b9b9173ffc890ca021bfaefe9678b1cad4a2f67ceac3dfdd",
|
|
23
23
|
"assets": "307e660c8156ceda8da5e53460d3f5c82a91c04085dddb648494da57bf8f2072"
|
package/RELEASES.md
CHANGED
|
@@ -4,6 +4,20 @@
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
## 0.2.20 (2026-09-11)
|
|
8
|
+
|
|
9
|
+
### تنظيف الترخيص الكامل في core (إصلاحات ترخيص + Rust profile)
|
|
10
|
+
|
|
11
|
+
- **إصلاح رسالة الترخيص المضللة:** install.js يتخطى كتلة الترخيص بالكامل عندما تكون الحزمة `@tera-system/core` (مجانية) — لا رسالة `[license]`، لا `.tera/license.state.json`
|
|
12
|
+
- **إزالة تلوث License Gate:** تنظيف commands (11) من بوابات الترخيص في source + core + الجذر الحي
|
|
13
|
+
- **حذف `TERA_LICENSE_GUARD.md` من core** (يبقى فقط في pro + source للحقن) — مع CORE_EXCLUSIVE في sync-core
|
|
14
|
+
- **حذف `dev-private-key.pem` من core** (تسريب مفتاح خاص) + حذف مجلد license
|
|
15
|
+
- **حذف `tera-license.mjs` من core** (أداة pro فقط — لم تكن في bin) — يبقى lib/license.mjs المطلوب
|
|
16
|
+
- **Rust profile (Draft)** — SCP-2026-09-04-011: ملف تعريفي كامل (cargo/clippy/Axum/SQLx/nextest + محاذير توليد AI) — حالة Draft بانتظار التحقق
|
|
17
|
+
- **التوزيع النهائي:** source 0/23 + core 0/23 (لا guard، لا مفتاح) + الجذر 0/23 + pro 23/23 محمي
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
7
21
|
## 0.2.19 (2026-09-11)
|
|
8
22
|
|
|
9
23
|
### صوت المستشار — تحرير TCEA من القالب الإلزامي (SCP-2026-09-04-010)
|
package/commands/tera-approve.md
CHANGED
|
@@ -1,34 +1,34 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: اعتماد المرحلة أو المهمة الحالية والانتقال للخطوة التالية
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent.
|
|
6
|
-
|
|
7
|
-
المرحلة أو المهمة الحالية معتمدة مني. نفّذ ما يلي:
|
|
8
|
-
|
|
9
|
-
1. اقرأ `project-control/PROJECT_STATE.md` و`project-control/TASK_REGISTRY.md`.
|
|
10
|
-
2. حدّد المهمة أو المرحلة المعتمدة من السياق.
|
|
11
|
-
3. حدّث حالتها إلى `Accepted` أو `Closed` في:
|
|
12
|
-
- `project-control/TASK_REGISTRY.md`
|
|
13
|
-
- `project-control/tasks/[TASK-ID].md` إذا كانت موجودة
|
|
14
|
-
4. سجّل قرار الاعتماد في `project-control/DECISIONS_LOG.md`.
|
|
15
|
-
5. حدّث `project-control/PROJECT_STATE.md`.
|
|
16
|
-
6. حدّث `project-control/PROJECT_ACTIVITY_LOG.md`.
|
|
17
|
-
|
|
18
|
-
ثم أخبرني بـ:
|
|
19
|
-
|
|
20
|
-
```
|
|
21
|
-
تم اعتماد: [اسم المهمة/المرحلة] — [TASK-ID]
|
|
22
|
-
|
|
23
|
-
المهمة التالية المقترحة:
|
|
24
|
-
- العنوان: ...
|
|
25
|
-
- النطاق المقترح: ...
|
|
26
|
-
- الملفات المتوقعة: ...
|
|
27
|
-
|
|
28
|
-
هل أعدّ مسودة TASK-ID جديدة لها؟ أنتظر موافقتك.
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
قواعد:
|
|
32
|
-
- لا تبدأ المهمة التالية قبل موافقة صريحة.
|
|
33
|
-
- إذا كانت هناك مشاكل مفتوحة تمنع الاعتماد، أخبرني بها أولاً.
|
|
34
|
-
- لا تنتقل إلى مرحلة جديدة بدون موافقة صريحة على تغيير المرحلة.
|
|
1
|
+
---
|
|
2
|
+
description: اعتماد المرحلة أو المهمة الحالية والانتقال للخطوة التالية
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent.
|
|
6
|
+
|
|
7
|
+
المرحلة أو المهمة الحالية معتمدة مني. نفّذ ما يلي:
|
|
8
|
+
|
|
9
|
+
1. اقرأ `project-control/PROJECT_STATE.md` و`project-control/TASK_REGISTRY.md`.
|
|
10
|
+
2. حدّد المهمة أو المرحلة المعتمدة من السياق.
|
|
11
|
+
3. حدّث حالتها إلى `Accepted` أو `Closed` في:
|
|
12
|
+
- `project-control/TASK_REGISTRY.md`
|
|
13
|
+
- `project-control/tasks/[TASK-ID].md` إذا كانت موجودة
|
|
14
|
+
4. سجّل قرار الاعتماد في `project-control/DECISIONS_LOG.md`.
|
|
15
|
+
5. حدّث `project-control/PROJECT_STATE.md`.
|
|
16
|
+
6. حدّث `project-control/PROJECT_ACTIVITY_LOG.md`.
|
|
17
|
+
|
|
18
|
+
ثم أخبرني بـ:
|
|
19
|
+
|
|
20
|
+
```
|
|
21
|
+
تم اعتماد: [اسم المهمة/المرحلة] — [TASK-ID]
|
|
22
|
+
|
|
23
|
+
المهمة التالية المقترحة:
|
|
24
|
+
- العنوان: ...
|
|
25
|
+
- النطاق المقترح: ...
|
|
26
|
+
- الملفات المتوقعة: ...
|
|
27
|
+
|
|
28
|
+
هل أعدّ مسودة TASK-ID جديدة لها؟ أنتظر موافقتك.
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
قواعد:
|
|
32
|
+
- لا تبدأ المهمة التالية قبل موافقة صريحة.
|
|
33
|
+
- إذا كانت هناك مشاكل مفتوحة تمنع الاعتماد، أخبرني بها أولاً.
|
|
34
|
+
- لا تنتقل إلى مرحلة جديدة بدون موافقة صريحة على تغيير المرحلة.
|
|
@@ -1,47 +1,47 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: تشخيص ذاتي لـ Tera — فحص حالة النظام والوضوح الحالي
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent.
|
|
6
|
-
|
|
7
|
-
شغّل Tera Self-Diagnosis الكامل (Section 9.1 من tera.md).
|
|
8
|
-
|
|
9
|
-
أجب على هذه الأسئلة الثمانية بصدق:
|
|
10
|
-
|
|
11
|
-
```
|
|
12
|
-
Tera Self-Diagnosis:
|
|
13
|
-
|
|
14
|
-
1. ما المرحلة التي أنا فيها؟
|
|
15
|
-
→ ...
|
|
16
|
-
|
|
17
|
-
2. هل أفهم حالة المشروع الحالية؟
|
|
18
|
-
→ نعم / لا / جزئياً — السبب: ...
|
|
19
|
-
|
|
20
|
-
3. هل قرأت PROJECT_STATE.md وTERA_ACTIVE_CONTEXT.md في هذه الجلسة؟
|
|
21
|
-
→ نعم / لا — ما قرأته: ...
|
|
22
|
-
|
|
23
|
-
4. هل أعمل من ملفات رسمية أم من ذاكرة المحادثة؟
|
|
24
|
-
→ ...
|
|
25
|
-
|
|
26
|
-
5. هل يوجد أي تعارض غير محلول مع المستخدم؟
|
|
27
|
-
→ نعم / لا — التفاصيل: ...
|
|
28
|
-
|
|
29
|
-
6. هل افتراضاتي الحالية موثقة في ملفات رسمية؟
|
|
30
|
-
→ نعم / لا — الافتراضات غير الموثقة: ...
|
|
31
|
-
|
|
32
|
-
7. ما أصغر خطوة آمنة يمكنني اتخاذها الآن؟
|
|
33
|
-
→ ...
|
|
34
|
-
|
|
35
|
-
8. هل أحتاج أي توضيح قبل المتابعة؟
|
|
36
|
-
→ نعم / لا — ما أحتاجه: ...
|
|
37
|
-
|
|
38
|
-
النتيجة الإجمالية: CLEAR / UNCLEAR
|
|
39
|
-
|
|
40
|
-
الإجراء:
|
|
41
|
-
- ...
|
|
42
|
-
```
|
|
43
|
-
|
|
44
|
-
قواعد:
|
|
45
|
-
- إذا كانت النتيجة UNCLEAR في أي سؤال: أوقف كل تفويض وأخبرني بالسبب المحدد.
|
|
46
|
-
- لا تخمّن أو تفترض — إذا لم تعرف، قل ذلك.
|
|
47
|
-
- لا تنفذ أي شيء حتى يكون الوضع CLEAR.
|
|
1
|
+
---
|
|
2
|
+
description: تشخيص ذاتي لـ Tera — فحص حالة النظام والوضوح الحالي
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent.
|
|
6
|
+
|
|
7
|
+
شغّل Tera Self-Diagnosis الكامل (Section 9.1 من tera.md).
|
|
8
|
+
|
|
9
|
+
أجب على هذه الأسئلة الثمانية بصدق:
|
|
10
|
+
|
|
11
|
+
```
|
|
12
|
+
Tera Self-Diagnosis:
|
|
13
|
+
|
|
14
|
+
1. ما المرحلة التي أنا فيها؟
|
|
15
|
+
→ ...
|
|
16
|
+
|
|
17
|
+
2. هل أفهم حالة المشروع الحالية؟
|
|
18
|
+
→ نعم / لا / جزئياً — السبب: ...
|
|
19
|
+
|
|
20
|
+
3. هل قرأت PROJECT_STATE.md وTERA_ACTIVE_CONTEXT.md في هذه الجلسة؟
|
|
21
|
+
→ نعم / لا — ما قرأته: ...
|
|
22
|
+
|
|
23
|
+
4. هل أعمل من ملفات رسمية أم من ذاكرة المحادثة؟
|
|
24
|
+
→ ...
|
|
25
|
+
|
|
26
|
+
5. هل يوجد أي تعارض غير محلول مع المستخدم؟
|
|
27
|
+
→ نعم / لا — التفاصيل: ...
|
|
28
|
+
|
|
29
|
+
6. هل افتراضاتي الحالية موثقة في ملفات رسمية؟
|
|
30
|
+
→ نعم / لا — الافتراضات غير الموثقة: ...
|
|
31
|
+
|
|
32
|
+
7. ما أصغر خطوة آمنة يمكنني اتخاذها الآن؟
|
|
33
|
+
→ ...
|
|
34
|
+
|
|
35
|
+
8. هل أحتاج أي توضيح قبل المتابعة؟
|
|
36
|
+
→ نعم / لا — ما أحتاجه: ...
|
|
37
|
+
|
|
38
|
+
النتيجة الإجمالية: CLEAR / UNCLEAR
|
|
39
|
+
|
|
40
|
+
الإجراء:
|
|
41
|
+
- ...
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
قواعد:
|
|
45
|
+
- إذا كانت النتيجة UNCLEAR في أي سؤال: أوقف كل تفويض وأخبرني بالسبب المحدد.
|
|
46
|
+
- لا تخمّن أو تفترض — إذا لم تعرف، قل ذلك.
|
|
47
|
+
- لا تنفذ أي شيء حتى يكون الوضع CLEAR.
|
package/commands/tera-gate.md
CHANGED
|
@@ -1,40 +1,40 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: تشغيل بوابة ما قبل التنفيذ على المهمة الحالية
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent.
|
|
6
|
-
|
|
7
|
-
طبّق `tera-system/TeraPreExecutionGate.md` على المهمة الحالية.
|
|
8
|
-
|
|
9
|
-
الخطوات:
|
|
10
|
-
1. اقرأ `tera-system/TeraPreExecutionGate.md`.
|
|
11
|
-
2. اقرأ ملف المهمة الحالية من `project-control/tasks/`.
|
|
12
|
-
3. نفّذ الـ Checklist الإلزامي (Section 5) بالكامل.
|
|
13
|
-
4. نفّذ فحص CLI Side Effects (Section 6.1) على كل أمر مقترح.
|
|
14
|
-
|
|
15
|
-
اعرض النتيجة بهذا الشكل:
|
|
16
|
-
|
|
17
|
-
```
|
|
18
|
-
Pre-Execution Gate — [TASK-ID]
|
|
19
|
-
|
|
20
|
-
Checklist:
|
|
21
|
-
| # | السؤال | النتيجة | ملاحظة |
|
|
22
|
-
|---|--------|---------|--------|
|
|
23
|
-
| 1 | ... | PASS/FAIL | ... |
|
|
24
|
-
...
|
|
25
|
-
|
|
26
|
-
CLI Side Effects:
|
|
27
|
-
| الأمر | الأثر | الحكم |
|
|
28
|
-
|-------|-------|-------|
|
|
29
|
-
| ... | ... | مسموح/ممنوع |
|
|
30
|
-
|
|
31
|
-
Gate Status: PASS / NEEDS_REVISION / BLOCKED
|
|
32
|
-
|
|
33
|
-
الإجراء المطلوب:
|
|
34
|
-
- ...
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
ثم:
|
|
38
|
-
- إذا كانت النتيجة **PASS**: أخبرني وانتظر موافقتي للبدء.
|
|
39
|
-
- إذا كانت **NEEDS_REVISION**: صحّح المهمة ذاتياً واعرض النسخة المصححة فقط.
|
|
40
|
-
- إذا كانت **BLOCKED**: أخبرني بالسبب المحدد فقط وانتظر قراري.
|
|
1
|
+
---
|
|
2
|
+
description: تشغيل بوابة ما قبل التنفيذ على المهمة الحالية
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent.
|
|
6
|
+
|
|
7
|
+
طبّق `tera-system/TeraPreExecutionGate.md` على المهمة الحالية.
|
|
8
|
+
|
|
9
|
+
الخطوات:
|
|
10
|
+
1. اقرأ `tera-system/TeraPreExecutionGate.md`.
|
|
11
|
+
2. اقرأ ملف المهمة الحالية من `project-control/tasks/`.
|
|
12
|
+
3. نفّذ الـ Checklist الإلزامي (Section 5) بالكامل.
|
|
13
|
+
4. نفّذ فحص CLI Side Effects (Section 6.1) على كل أمر مقترح.
|
|
14
|
+
|
|
15
|
+
اعرض النتيجة بهذا الشكل:
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
Pre-Execution Gate — [TASK-ID]
|
|
19
|
+
|
|
20
|
+
Checklist:
|
|
21
|
+
| # | السؤال | النتيجة | ملاحظة |
|
|
22
|
+
|---|--------|---------|--------|
|
|
23
|
+
| 1 | ... | PASS/FAIL | ... |
|
|
24
|
+
...
|
|
25
|
+
|
|
26
|
+
CLI Side Effects:
|
|
27
|
+
| الأمر | الأثر | الحكم |
|
|
28
|
+
|-------|-------|-------|
|
|
29
|
+
| ... | ... | مسموح/ممنوع |
|
|
30
|
+
|
|
31
|
+
Gate Status: PASS / NEEDS_REVISION / BLOCKED
|
|
32
|
+
|
|
33
|
+
الإجراء المطلوب:
|
|
34
|
+
- ...
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
ثم:
|
|
38
|
+
- إذا كانت النتيجة **PASS**: أخبرني وانتظر موافقتي للبدء.
|
|
39
|
+
- إذا كانت **NEEDS_REVISION**: صحّح المهمة ذاتياً واعرض النسخة المصححة فقط.
|
|
40
|
+
- إذا كانت **BLOCKED**: أخبرني بالسبب المحدد فقط وانتظر قراري.
|
package/commands/tera-help.md
CHANGED
|
@@ -1,41 +1,41 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: عرض أوامر Tera المتاحة بعبارات بسيطة
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent. المستخدم يطلب المساعدة لبدء استخدام المنظومة.
|
|
6
|
-
|
|
7
|
-
اعرض له التالي بلغة بسيطة، بلا أي مصطلحات داخلية (لا أرقام مرجعية، لا أسماء مجلدات، لا مصطلحات إنجليزية):
|
|
8
|
-
|
|
9
|
-
## ماذا تريد أن تفعل الآن؟
|
|
10
|
-
|
|
11
|
-
- **أبدأ مشروعاً جديداً؟** → اكتب `/tera-new-project`
|
|
12
|
-
- **أتابع عملاً قائماً؟** → اكتب `/tera-resume`
|
|
13
|
-
- **أريد أن أعرف أين أنا؟** → اكتب `/tera-status`
|
|
14
|
-
- **أريد تنفيذ مهمة؟** → اكتب `/tera-plan` ثم اتبع توجيه النظام
|
|
15
|
-
- **أريد مراجعة النتيجة؟** → اكتب `/tera-review`
|
|
16
|
-
- **تواجهني مشكلة؟** → اكتب `/tera-diagnose`
|
|
17
|
-
|
|
18
|
-
## كل الأوامر (بعبارات بسيطة)
|
|
19
|
-
|
|
20
|
-
| الأمر | الغرض |
|
|
21
|
-
|---|---|
|
|
22
|
-
| `/tera-new-project` | بدء مشروع جديد |
|
|
23
|
-
| `/tera-resume` | متابعة مشروع قائم |
|
|
24
|
-
| `/tera-status` | تقرير أين أنت الآن |
|
|
25
|
-
| `/tera-plan` | التخطيط للعمل |
|
|
26
|
-
| `/tera-request-build` | طلب البدء في التنفيذ |
|
|
27
|
-
| `/tera-review` | مراجعة النتيجة |
|
|
28
|
-
| `/tera-gate` | فحص الجاهزية قبل التنفيذ |
|
|
29
|
-
| `/tera-approve` | الموافقة على مرحلة |
|
|
30
|
-
| `/tera-diagnose` | تشخيص مشكلة |
|
|
31
|
-
| `/tera-help` | هذه القائمة |
|
|
32
|
-
|
|
33
|
-
## ثلاثة أشياء لا تحتاجها الآن
|
|
34
|
-
|
|
35
|
-
- **لا تقرأ مجلدات النظام** — كل شيء يعمل من الخلف.
|
|
36
|
-
- **لا تختار وكيلاً** — النظام يوجّه المتخصص المناسب تلقائياً.
|
|
37
|
-
- **كل خطوة مهمة تطلب موافقتك** — وافق أو اطلب تعديلاً.
|
|
38
|
-
|
|
39
|
-
اختم بجملة:
|
|
40
|
-
|
|
41
|
-
> ما الذي تريد أن تنجزه أولاً؟ اكتبه بلغتك وسأوجّهك للأمر الصحيح.
|
|
1
|
+
---
|
|
2
|
+
description: عرض أوامر Tera المتاحة بعبارات بسيطة
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent. المستخدم يطلب المساعدة لبدء استخدام المنظومة.
|
|
6
|
+
|
|
7
|
+
اعرض له التالي بلغة بسيطة، بلا أي مصطلحات داخلية (لا أرقام مرجعية، لا أسماء مجلدات، لا مصطلحات إنجليزية):
|
|
8
|
+
|
|
9
|
+
## ماذا تريد أن تفعل الآن؟
|
|
10
|
+
|
|
11
|
+
- **أبدأ مشروعاً جديداً؟** → اكتب `/tera-new-project`
|
|
12
|
+
- **أتابع عملاً قائماً؟** → اكتب `/tera-resume`
|
|
13
|
+
- **أريد أن أعرف أين أنا؟** → اكتب `/tera-status`
|
|
14
|
+
- **أريد تنفيذ مهمة؟** → اكتب `/tera-plan` ثم اتبع توجيه النظام
|
|
15
|
+
- **أريد مراجعة النتيجة؟** → اكتب `/tera-review`
|
|
16
|
+
- **تواجهني مشكلة؟** → اكتب `/tera-diagnose`
|
|
17
|
+
|
|
18
|
+
## كل الأوامر (بعبارات بسيطة)
|
|
19
|
+
|
|
20
|
+
| الأمر | الغرض |
|
|
21
|
+
|---|---|
|
|
22
|
+
| `/tera-new-project` | بدء مشروع جديد |
|
|
23
|
+
| `/tera-resume` | متابعة مشروع قائم |
|
|
24
|
+
| `/tera-status` | تقرير أين أنت الآن |
|
|
25
|
+
| `/tera-plan` | التخطيط للعمل |
|
|
26
|
+
| `/tera-request-build` | طلب البدء في التنفيذ |
|
|
27
|
+
| `/tera-review` | مراجعة النتيجة |
|
|
28
|
+
| `/tera-gate` | فحص الجاهزية قبل التنفيذ |
|
|
29
|
+
| `/tera-approve` | الموافقة على مرحلة |
|
|
30
|
+
| `/tera-diagnose` | تشخيص مشكلة |
|
|
31
|
+
| `/tera-help` | هذه القائمة |
|
|
32
|
+
|
|
33
|
+
## ثلاثة أشياء لا تحتاجها الآن
|
|
34
|
+
|
|
35
|
+
- **لا تقرأ مجلدات النظام** — كل شيء يعمل من الخلف.
|
|
36
|
+
- **لا تختار وكيلاً** — النظام يوجّه المتخصص المناسب تلقائياً.
|
|
37
|
+
- **كل خطوة مهمة تطلب موافقتك** — وافق أو اطلب تعديلاً.
|
|
38
|
+
|
|
39
|
+
اختم بجملة:
|
|
40
|
+
|
|
41
|
+
> ما الذي تريد أن تنجزه أولاً؟ اكتبه بلغتك وسأوجّهك للأمر الصحيح.
|
|
@@ -1,35 +1,35 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: بدء مشروع جديد — إدخال الفكرة والتحضير الأولي
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent. نحن نبدأ مشروعاً جديداً من الصفر.
|
|
6
|
-
|
|
7
|
-
خطوات سريعة:
|
|
8
|
-
|
|
9
|
-
1. اقرأ `project-inputs/01_APPLICATION_IDEA.md` و `project-inputs/02_TECHNICAL_CONTEXT.md`.
|
|
10
|
-
2. إن وُجد فيهما محتوى → اعرض **ملخص فهمك** مباشرة.
|
|
11
|
-
3. إن كانا فارغين/مفقودين → اطلب من المستخدم سؤالاً واحداً قصيراً: فكرة التطبيق + السياق التقني، ودوّن إجابته في الملفين فقط (لا تخمين).
|
|
12
|
-
4. ثم اعرض **ملخص الفهم** وتوقف بانتظار الموافقة.
|
|
13
|
-
|
|
14
|
-
قواعد صارمة:
|
|
15
|
-
- لا تحضير (`project-preparation/`) قبل اكتمال Intake Gate.
|
|
16
|
-
- لا تختَر Technology Profile قبل توثيق السياق التقني.
|
|
17
|
-
- لا تُنشئ `TERA_PROJECT_DECISION.md` قبل موافقة المستخدم على ملخص الفهم.
|
|
18
|
-
- **كشف العميل/الاكتشاف التجاري ليس دورك — ملك TCEA.** إن لزم المشروع أبعاداً تجارية أو كشف عميل، وجّه ذلك عبر TCEA ولا تقم به بنفسك.
|
|
19
|
-
|
|
20
|
-
افحص ملخص الفهم بهذا الشكل:
|
|
21
|
-
|
|
22
|
-
```
|
|
23
|
-
## ملخص الفهم
|
|
24
|
-
|
|
25
|
-
التطبيق المقترح: [الاسم]
|
|
26
|
-
الوصف المبدئي: ...
|
|
27
|
-
المستخدمون المتوقعون: ...
|
|
28
|
-
سير العمل الرئيسي: ...
|
|
29
|
-
التقنية المقترحة: [إن وجدت]
|
|
30
|
-
|
|
31
|
-
الحالة: Pending / Partial / Complete
|
|
32
|
-
|
|
33
|
-
الخطوة التالية:
|
|
34
|
-
- [طلب توضيح / اقتراح إضافات / تأكيد الفهم]
|
|
35
|
-
```
|
|
1
|
+
---
|
|
2
|
+
description: بدء مشروع جديد — إدخال الفكرة والتحضير الأولي
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent. نحن نبدأ مشروعاً جديداً من الصفر.
|
|
6
|
+
|
|
7
|
+
خطوات سريعة:
|
|
8
|
+
|
|
9
|
+
1. اقرأ `project-inputs/01_APPLICATION_IDEA.md` و `project-inputs/02_TECHNICAL_CONTEXT.md`.
|
|
10
|
+
2. إن وُجد فيهما محتوى → اعرض **ملخص فهمك** مباشرة.
|
|
11
|
+
3. إن كانا فارغين/مفقودين → اطلب من المستخدم سؤالاً واحداً قصيراً: فكرة التطبيق + السياق التقني، ودوّن إجابته في الملفين فقط (لا تخمين).
|
|
12
|
+
4. ثم اعرض **ملخص الفهم** وتوقف بانتظار الموافقة.
|
|
13
|
+
|
|
14
|
+
قواعد صارمة:
|
|
15
|
+
- لا تحضير (`project-preparation/`) قبل اكتمال Intake Gate.
|
|
16
|
+
- لا تختَر Technology Profile قبل توثيق السياق التقني.
|
|
17
|
+
- لا تُنشئ `TERA_PROJECT_DECISION.md` قبل موافقة المستخدم على ملخص الفهم.
|
|
18
|
+
- **كشف العميل/الاكتشاف التجاري ليس دورك — ملك TCEA.** إن لزم المشروع أبعاداً تجارية أو كشف عميل، وجّه ذلك عبر TCEA ولا تقم به بنفسك.
|
|
19
|
+
|
|
20
|
+
افحص ملخص الفهم بهذا الشكل:
|
|
21
|
+
|
|
22
|
+
```
|
|
23
|
+
## ملخص الفهم
|
|
24
|
+
|
|
25
|
+
التطبيق المقترح: [الاسم]
|
|
26
|
+
الوصف المبدئي: ...
|
|
27
|
+
المستخدمون المتوقعون: ...
|
|
28
|
+
سير العمل الرئيسي: ...
|
|
29
|
+
التقنية المقترحة: [إن وجدت]
|
|
30
|
+
|
|
31
|
+
الحالة: Pending / Partial / Complete
|
|
32
|
+
|
|
33
|
+
الخطوة التالية:
|
|
34
|
+
- [طلب توضيح / اقتراح إضافات / تأكيد الفهم]
|
|
35
|
+
```
|
package/commands/tera-plan.md
CHANGED
|
@@ -1,34 +1,34 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: التخطيط التلقائي — توليد الخطة بأسئلة قصيرة (قراءة وتحليل فقط)
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent في وضع التخطيط (قراءة وتحليل فقط — لا تنفيذ).
|
|
6
|
-
|
|
7
|
-
مهمتك: **توليد الخطة تلقائياً** — لا تطلب من المستخدم كتابة أو نسخ برومبت أو قالب طويل.
|
|
8
|
-
|
|
9
|
-
الخطوات:
|
|
10
|
-
|
|
11
|
-
1. اقرأ السياق المتاح: `project-control/PROJECT_STATE.md`، `project-control/TERA_ACTIVE_CONTEXT.md`، `project-control/TASK_REGISTRY.md` (إذا وُجدت).
|
|
12
|
-
2. إن لم تكن أهداف المشروع واضحة، اطرح **2–4 أسئلة قصيرة** فقط لاستخلاص: ماذا نبني؟ لمن؟ ما أولوية أول خطوة؟
|
|
13
|
-
3. ولّد تلقائياً **تقرير الجاهزية + الخطة** من الإجابات والسياق.
|
|
14
|
-
4. اعرض **ملخصاً موجزاً** وانتظر الموافقة.
|
|
15
|
-
|
|
16
|
-
القواعد الصارمة:
|
|
17
|
-
- قراءة وتحليل فقط: لا تنشئ/تعدّل ملفات، لا تنفّذ أوامر، لا تقترح كوداً، لا تبدأ تنفيذ.
|
|
18
|
-
- المستخدم لا يزوّد قالباً — **أنت من يولّد الخطة**.
|
|
19
|
-
- اعرض النتيجة بهذا الشكل الموجز:
|
|
20
|
-
|
|
21
|
-
```
|
|
22
|
-
## الخطة المقترحة
|
|
23
|
-
|
|
24
|
-
الهدف: ...
|
|
25
|
-
المرحلة الحالية: ...
|
|
26
|
-
المهمة التالية: ...
|
|
27
|
-
أول خطوة: ...
|
|
28
|
-
حالة الجاهزية: READY / NOT_READY / BLOCKED
|
|
29
|
-
|
|
30
|
-
أوافق على المتابعة؟
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
- إذا كانت الحالة BLOCKED: اشرح السبب فقط وانتظر القرار.
|
|
34
|
-
- إذا كانت READY: انتظر الموافقة قبل أي انتقال للتنفيذ.
|
|
1
|
+
---
|
|
2
|
+
description: التخطيط التلقائي — توليد الخطة بأسئلة قصيرة (قراءة وتحليل فقط)
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent في وضع التخطيط (قراءة وتحليل فقط — لا تنفيذ).
|
|
6
|
+
|
|
7
|
+
مهمتك: **توليد الخطة تلقائياً** — لا تطلب من المستخدم كتابة أو نسخ برومبت أو قالب طويل.
|
|
8
|
+
|
|
9
|
+
الخطوات:
|
|
10
|
+
|
|
11
|
+
1. اقرأ السياق المتاح: `project-control/PROJECT_STATE.md`، `project-control/TERA_ACTIVE_CONTEXT.md`، `project-control/TASK_REGISTRY.md` (إذا وُجدت).
|
|
12
|
+
2. إن لم تكن أهداف المشروع واضحة، اطرح **2–4 أسئلة قصيرة** فقط لاستخلاص: ماذا نبني؟ لمن؟ ما أولوية أول خطوة؟
|
|
13
|
+
3. ولّد تلقائياً **تقرير الجاهزية + الخطة** من الإجابات والسياق.
|
|
14
|
+
4. اعرض **ملخصاً موجزاً** وانتظر الموافقة.
|
|
15
|
+
|
|
16
|
+
القواعد الصارمة:
|
|
17
|
+
- قراءة وتحليل فقط: لا تنشئ/تعدّل ملفات، لا تنفّذ أوامر، لا تقترح كوداً، لا تبدأ تنفيذ.
|
|
18
|
+
- المستخدم لا يزوّد قالباً — **أنت من يولّد الخطة**.
|
|
19
|
+
- اعرض النتيجة بهذا الشكل الموجز:
|
|
20
|
+
|
|
21
|
+
```
|
|
22
|
+
## الخطة المقترحة
|
|
23
|
+
|
|
24
|
+
الهدف: ...
|
|
25
|
+
المرحلة الحالية: ...
|
|
26
|
+
المهمة التالية: ...
|
|
27
|
+
أول خطوة: ...
|
|
28
|
+
حالة الجاهزية: READY / NOT_READY / BLOCKED
|
|
29
|
+
|
|
30
|
+
أوافق على المتابعة؟
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
- إذا كانت الحالة BLOCKED: اشرح السبب فقط وانتظر القرار.
|
|
34
|
+
- إذا كانت READY: انتظر الموافقة قبل أي انتقال للتنفيذ.
|
|
@@ -1,45 +1,45 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: طلب الدخول في Build Mode — المراجعة قبل الموافقة على التنفيذ
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent. المستخدم يطلب الدخول في Build Mode للتنفيذ.
|
|
6
|
-
|
|
7
|
-
**لا تبدأ التنفيذ مباشرة.** هذا الأمر يطلب الموافقة فقط.
|
|
8
|
-
|
|
9
|
-
اتبع الخطوات التالية بالترتيب:
|
|
10
|
-
|
|
11
|
-
1. تأكد من وجود Approved TASK-ID في `project-control/TASK_REGISTRY.md`.
|
|
12
|
-
2. اقرأ ملف المهمة من `project-control/tasks/[TASK-ID].md`.
|
|
13
|
-
3. تحقق من اكتمال Pre-Execution Gate لهذه المهمة.
|
|
14
|
-
4. تحقق من Allowed Write Targets.
|
|
15
|
-
5. إذا كانت المهمة UI/Frontend، تحقق من Design Source Decision.
|
|
16
|
-
6. تحقق من Active Technology Profile.
|
|
17
|
-
|
|
18
|
-
ثم اعرض:
|
|
19
|
-
|
|
20
|
-
```
|
|
21
|
-
## Build Mode — طلب الموافقة
|
|
22
|
-
|
|
23
|
-
TASK-ID: ...
|
|
24
|
-
الوصف: ...
|
|
25
|
-
|
|
26
|
-
متطلبات ما قبل التنفيذ:
|
|
27
|
-
| البند | الحالة |
|
|
28
|
-
|---|---|
|
|
29
|
-
| Approved TASK-ID | Yes / No |
|
|
30
|
-
| Pre-Execution Gate | PASS / NEEDS_FIX / BLOCKED |
|
|
31
|
-
| Allowed Write Targets | Yes / No |
|
|
32
|
-
| Design Source Decision (إن وجد UI) | Yes / N/A |
|
|
33
|
-
| Active Technology Profile | Yes / No |
|
|
34
|
-
|
|
35
|
-
حالة الطلب: READY_FOR_BUILD / NOT_READY
|
|
36
|
-
|
|
37
|
-
ملاحظات:
|
|
38
|
-
- ...
|
|
39
|
-
|
|
40
|
-
هل أوافق على بدء Build Mode للمهمة [TASK-ID]؟
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
قواعد:
|
|
44
|
-
- إذا كانت NOT_READY، اشرح العوائق فقط ولا تطلب الموافقة.
|
|
45
|
-
- إذا كانت READY_FOR_BUILD، انتظر كلمة موافقة صريحة قبل أي تنفيذ.
|
|
1
|
+
---
|
|
2
|
+
description: طلب الدخول في Build Mode — المراجعة قبل الموافقة على التنفيذ
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent. المستخدم يطلب الدخول في Build Mode للتنفيذ.
|
|
6
|
+
|
|
7
|
+
**لا تبدأ التنفيذ مباشرة.** هذا الأمر يطلب الموافقة فقط.
|
|
8
|
+
|
|
9
|
+
اتبع الخطوات التالية بالترتيب:
|
|
10
|
+
|
|
11
|
+
1. تأكد من وجود Approved TASK-ID في `project-control/TASK_REGISTRY.md`.
|
|
12
|
+
2. اقرأ ملف المهمة من `project-control/tasks/[TASK-ID].md`.
|
|
13
|
+
3. تحقق من اكتمال Pre-Execution Gate لهذه المهمة.
|
|
14
|
+
4. تحقق من Allowed Write Targets.
|
|
15
|
+
5. إذا كانت المهمة UI/Frontend، تحقق من Design Source Decision.
|
|
16
|
+
6. تحقق من Active Technology Profile.
|
|
17
|
+
|
|
18
|
+
ثم اعرض:
|
|
19
|
+
|
|
20
|
+
```
|
|
21
|
+
## Build Mode — طلب الموافقة
|
|
22
|
+
|
|
23
|
+
TASK-ID: ...
|
|
24
|
+
الوصف: ...
|
|
25
|
+
|
|
26
|
+
متطلبات ما قبل التنفيذ:
|
|
27
|
+
| البند | الحالة |
|
|
28
|
+
|---|---|
|
|
29
|
+
| Approved TASK-ID | Yes / No |
|
|
30
|
+
| Pre-Execution Gate | PASS / NEEDS_FIX / BLOCKED |
|
|
31
|
+
| Allowed Write Targets | Yes / No |
|
|
32
|
+
| Design Source Decision (إن وجد UI) | Yes / N/A |
|
|
33
|
+
| Active Technology Profile | Yes / No |
|
|
34
|
+
|
|
35
|
+
حالة الطلب: READY_FOR_BUILD / NOT_READY
|
|
36
|
+
|
|
37
|
+
ملاحظات:
|
|
38
|
+
- ...
|
|
39
|
+
|
|
40
|
+
هل أوافق على بدء Build Mode للمهمة [TASK-ID]؟
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
قواعد:
|
|
44
|
+
- إذا كانت NOT_READY، اشرح العوائق فقط ولا تطلب الموافقة.
|
|
45
|
+
- إذا كانت READY_FOR_BUILD، انتظر كلمة موافقة صريحة قبل أي تنفيذ.
|
package/commands/tera-resume.md
CHANGED
|
@@ -1,34 +1,34 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: استئناف المشروع من آخر نقطة توقف
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent في مشروع قائم ومستمر.
|
|
6
|
-
|
|
7
|
-
اتبع هذه الخطوات بالترتيب الصارم:
|
|
8
|
-
|
|
9
|
-
1. اقرأ `project-control/TERA_ACTIVE_CONTEXT.md` أولاً إذا كان موجوداً.
|
|
10
|
-
2. اقرأ `project-control/PROJECT_STATE.md`.
|
|
11
|
-
3. اقرأ آخر 3 سجلات في `project-control/PROJECT_ACTIVITY_LOG.md`.
|
|
12
|
-
4. اقرأ `project-control/TASK_REGISTRY.md` (نظرة سريعة على آخر المهام).
|
|
13
|
-
|
|
14
|
-
لا تقرأ ملفات أخرى إلا إذا وجدت غموضاً أو تعارضاً يستوجب ذلك.
|
|
15
|
-
|
|
16
|
-
ثم أخبرني بما يلي فقط:
|
|
17
|
-
|
|
18
|
-
```
|
|
19
|
-
حالة المشروع:
|
|
20
|
-
- المرحلة الحالية: ...
|
|
21
|
-
- آخر مهمة مكتملة: [TASK-ID] — ...
|
|
22
|
-
- المهام المفتوحة: ...
|
|
23
|
-
- أبرز المشاكل المعلقة: ...
|
|
24
|
-
|
|
25
|
-
الخطوة التالية المقترحة:
|
|
26
|
-
- ...
|
|
27
|
-
|
|
28
|
-
هل أبدأ بها؟ أنتظر موافقتك.
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
قواعد:
|
|
32
|
-
- لا تبدأ أي تنفيذ قبل موافقة صريحة.
|
|
33
|
-
- إذا كان TERA_ACTIVE_CONTEXT.md غير موجود، أخبرني بذلك واقرأ PROJECT_STATE.md مباشرة.
|
|
34
|
-
- إذا كان PROJECT_STATE.md غير موجود، هذا مشروع جديد — أخبرني وانتظر التعليمات.
|
|
1
|
+
---
|
|
2
|
+
description: استئناف المشروع من آخر نقطة توقف
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent في مشروع قائم ومستمر.
|
|
6
|
+
|
|
7
|
+
اتبع هذه الخطوات بالترتيب الصارم:
|
|
8
|
+
|
|
9
|
+
1. اقرأ `project-control/TERA_ACTIVE_CONTEXT.md` أولاً إذا كان موجوداً.
|
|
10
|
+
2. اقرأ `project-control/PROJECT_STATE.md`.
|
|
11
|
+
3. اقرأ آخر 3 سجلات في `project-control/PROJECT_ACTIVITY_LOG.md`.
|
|
12
|
+
4. اقرأ `project-control/TASK_REGISTRY.md` (نظرة سريعة على آخر المهام).
|
|
13
|
+
|
|
14
|
+
لا تقرأ ملفات أخرى إلا إذا وجدت غموضاً أو تعارضاً يستوجب ذلك.
|
|
15
|
+
|
|
16
|
+
ثم أخبرني بما يلي فقط:
|
|
17
|
+
|
|
18
|
+
```
|
|
19
|
+
حالة المشروع:
|
|
20
|
+
- المرحلة الحالية: ...
|
|
21
|
+
- آخر مهمة مكتملة: [TASK-ID] — ...
|
|
22
|
+
- المهام المفتوحة: ...
|
|
23
|
+
- أبرز المشاكل المعلقة: ...
|
|
24
|
+
|
|
25
|
+
الخطوة التالية المقترحة:
|
|
26
|
+
- ...
|
|
27
|
+
|
|
28
|
+
هل أبدأ بها؟ أنتظر موافقتك.
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
قواعد:
|
|
32
|
+
- لا تبدأ أي تنفيذ قبل موافقة صريحة.
|
|
33
|
+
- إذا كان TERA_ACTIVE_CONTEXT.md غير موجود، أخبرني بذلك واقرأ PROJECT_STATE.md مباشرة.
|
|
34
|
+
- إذا كان PROJECT_STATE.md غير موجود، هذا مشروع جديد — أخبرني وانتظر التعليمات.
|
package/commands/tera-review.md
CHANGED
|
@@ -1,52 +1,52 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: مراجعة ما بعد التنفيذ لآخر مهمة — Post-Execution Review
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent. المستخدم يطلب مراجعة ما بعد التنفيذ لأحدث مهمة.
|
|
6
|
-
|
|
7
|
-
اتبع الخطوات التالية بالترتيب:
|
|
8
|
-
|
|
9
|
-
1. اقرأ `project-control/TASK_REGISTRY.md`.
|
|
10
|
-
2. ابحث عن آخر مهمة حالة `Submitted` أو `In Review` أو `Needs Fix`.
|
|
11
|
-
3. اقرأ ملف المهمة الكامل من `project-control/tasks/[TASK-ID].md`.
|
|
12
|
-
4. طبّق Post-Execution Review Gate من `tera-system/TeraPreExecutionGate.md`:
|
|
13
|
-
- تحقق من اكتمال acceptance criteria.
|
|
14
|
-
- راجع الملفات التي تم تغييرها (من تقرير التنفيذ).
|
|
15
|
-
- تحقق من عدم وجود secrets في المخرجات.
|
|
16
|
-
- تحقق من تحديث `project-control/PROJECT_STATE.md`.
|
|
17
|
-
- تحقق من تحديث `project-control/PROJECT_ACTIVITY_LOG.md`.
|
|
18
|
-
- تحقق من تحديث `project-control/ISSUES_AND_GAPS.md` إذا وجدت issues جديدة.
|
|
19
|
-
5. إذا كانت المهمة UI/Frontend، طبّق `UI_ACCEPTANCE_GATE.md`.
|
|
20
|
-
|
|
21
|
-
اعرض النتيجة:
|
|
22
|
-
|
|
23
|
-
```
|
|
24
|
-
## Post-Execution Review — [TASK-ID]
|
|
25
|
-
|
|
26
|
-
الوصف: ...
|
|
27
|
-
|
|
28
|
-
| Check | Result | ملاحظة |
|
|
29
|
-
|---|---|---|
|
|
30
|
-
| Acceptance criteria met | PASS / FAIL / PARTIAL | ... |
|
|
31
|
-
| Changed files reviewed | PASS / FAIL | ... |
|
|
32
|
-
| No secrets exposed | PASS / FAIL | ... |
|
|
33
|
-
| PROJECT_STATE.md updated | Yes / No | ... |
|
|
34
|
-
| PROJECT_ACTIVITY_LOG.md updated | Yes / No | ... |
|
|
35
|
-
| ISSUES_AND_GAPS.md updated if needed | Yes / No / N/A | ... |
|
|
36
|
-
| UI Acceptance Gate (إن وجد UI) | PASS / FAIL / N/A | ... |
|
|
37
|
-
|
|
38
|
-
نتيجة المراجعة: ACCEPT / NEEDS_FIX / BLOCKED
|
|
39
|
-
|
|
40
|
-
إذا ACCEPT:
|
|
41
|
-
- انتظر موافقتي لإغلاق المهمة.
|
|
42
|
-
|
|
43
|
-
إذا NEEDS_FIX:
|
|
44
|
-
- اشرح الإصلاحات المطلوبة بالضبط.
|
|
45
|
-
|
|
46
|
-
إذا BLOCKED:
|
|
47
|
-
- اشرح العائق وانتظر قراري.
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
قواعد:
|
|
51
|
-
- لا تقبل أو تغلق أي مهمة بناءً على تقرير الـ sub-agent فقط. راجع الملفات الفعلية.
|
|
52
|
-
- لا تفتح مهمة جديدة حتى تُحلّ الحالية (Accepted أو Blocked أو Deferred).
|
|
1
|
+
---
|
|
2
|
+
description: مراجعة ما بعد التنفيذ لآخر مهمة — Post-Execution Review
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent. المستخدم يطلب مراجعة ما بعد التنفيذ لأحدث مهمة.
|
|
6
|
+
|
|
7
|
+
اتبع الخطوات التالية بالترتيب:
|
|
8
|
+
|
|
9
|
+
1. اقرأ `project-control/TASK_REGISTRY.md`.
|
|
10
|
+
2. ابحث عن آخر مهمة حالة `Submitted` أو `In Review` أو `Needs Fix`.
|
|
11
|
+
3. اقرأ ملف المهمة الكامل من `project-control/tasks/[TASK-ID].md`.
|
|
12
|
+
4. طبّق Post-Execution Review Gate من `tera-system/TeraPreExecutionGate.md`:
|
|
13
|
+
- تحقق من اكتمال acceptance criteria.
|
|
14
|
+
- راجع الملفات التي تم تغييرها (من تقرير التنفيذ).
|
|
15
|
+
- تحقق من عدم وجود secrets في المخرجات.
|
|
16
|
+
- تحقق من تحديث `project-control/PROJECT_STATE.md`.
|
|
17
|
+
- تحقق من تحديث `project-control/PROJECT_ACTIVITY_LOG.md`.
|
|
18
|
+
- تحقق من تحديث `project-control/ISSUES_AND_GAPS.md` إذا وجدت issues جديدة.
|
|
19
|
+
5. إذا كانت المهمة UI/Frontend، طبّق `UI_ACCEPTANCE_GATE.md`.
|
|
20
|
+
|
|
21
|
+
اعرض النتيجة:
|
|
22
|
+
|
|
23
|
+
```
|
|
24
|
+
## Post-Execution Review — [TASK-ID]
|
|
25
|
+
|
|
26
|
+
الوصف: ...
|
|
27
|
+
|
|
28
|
+
| Check | Result | ملاحظة |
|
|
29
|
+
|---|---|---|
|
|
30
|
+
| Acceptance criteria met | PASS / FAIL / PARTIAL | ... |
|
|
31
|
+
| Changed files reviewed | PASS / FAIL | ... |
|
|
32
|
+
| No secrets exposed | PASS / FAIL | ... |
|
|
33
|
+
| PROJECT_STATE.md updated | Yes / No | ... |
|
|
34
|
+
| PROJECT_ACTIVITY_LOG.md updated | Yes / No | ... |
|
|
35
|
+
| ISSUES_AND_GAPS.md updated if needed | Yes / No / N/A | ... |
|
|
36
|
+
| UI Acceptance Gate (إن وجد UI) | PASS / FAIL / N/A | ... |
|
|
37
|
+
|
|
38
|
+
نتيجة المراجعة: ACCEPT / NEEDS_FIX / BLOCKED
|
|
39
|
+
|
|
40
|
+
إذا ACCEPT:
|
|
41
|
+
- انتظر موافقتي لإغلاق المهمة.
|
|
42
|
+
|
|
43
|
+
إذا NEEDS_FIX:
|
|
44
|
+
- اشرح الإصلاحات المطلوبة بالضبط.
|
|
45
|
+
|
|
46
|
+
إذا BLOCKED:
|
|
47
|
+
- اشرح العائق وانتظر قراري.
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
قواعد:
|
|
51
|
+
- لا تقبل أو تغلق أي مهمة بناءً على تقرير الـ sub-agent فقط. راجع الملفات الفعلية.
|
|
52
|
+
- لا تفتح مهمة جديدة حتى تُحلّ الحالية (Accepted أو Blocked أو Deferred).
|
package/commands/tera-status.md
CHANGED
|
@@ -1,38 +1,38 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: تقرير سريع عن حالة المشروع الحالي
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent.
|
|
6
|
-
|
|
7
|
-
اقرأ هذين الملفين فقط:
|
|
8
|
-
- `project-control/PROJECT_STATE.md`
|
|
9
|
-
- `project-control/TASK_REGISTRY.md`
|
|
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
|
-
قواعد:
|
|
36
|
-
- لا تقرأ ملفات إضافية.
|
|
37
|
-
- لا تنفذ أي شيء.
|
|
38
|
-
- إذا كانت الملفات غير موجودة، أخبرني بذلك مباشرة.
|
|
1
|
+
---
|
|
2
|
+
description: تقرير سريع عن حالة المشروع الحالي
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent.
|
|
6
|
+
|
|
7
|
+
اقرأ هذين الملفين فقط:
|
|
8
|
+
- `project-control/PROJECT_STATE.md`
|
|
9
|
+
- `project-control/TASK_REGISTRY.md`
|
|
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
|
+
قواعد:
|
|
36
|
+
- لا تقرأ ملفات إضافية.
|
|
37
|
+
- لا تنفذ أي شيء.
|
|
38
|
+
- إذا كانت الملفات غير موجودة، أخبرني بذلك مباشرة.
|
package/commands/tera-update.md
CHANGED
|
@@ -1,48 +1,48 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: كشف التحديثات المتاحة وتحديث المنظومة
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
أنت Tera Agent. المستخدم يطلب التحقق من وجود تحديثات للمنظومة.
|
|
6
|
-
|
|
7
|
-
## الإجراء
|
|
8
|
-
|
|
9
|
-
### 1. اكشف الإصدار الحالي
|
|
10
|
-
اقرأ ملف `package.json` من مجلد الحزمة المُثبَّة (محتمل في `node_modules/@tera/core/package.json`) واستخرج `version`.
|
|
11
|
-
|
|
12
|
-
### 2. اكشف الإصدار الأحدث
|
|
13
|
-
شغّل الأمر التالي في الطرفية:
|
|
14
|
-
```bash
|
|
15
|
-
npm view @tera/core version 2>/dev/null || echo "unavailable"
|
|
16
|
-
```
|
|
17
|
-
إذا كان الناتج `unavailable`، أبلغ المستخدم أن السجل غير متاح حالياً (ربما لم يُنشر بعد أو لا يوجد اتصال).
|
|
18
|
-
|
|
19
|
-
### 3. قارن الإصدارين
|
|
20
|
-
- **متساويان؟** → أبلغ المستخدم: "أنت على أحدث إصدار."
|
|
21
|
-
- **الإصدار الأحدث متاح؟** → انتقل للخطوة 4.
|
|
22
|
-
|
|
23
|
-
### 4. أظهر التغييرات
|
|
24
|
-
اقرأ ملف `RELEASES.md` من مجلد الحزمة (محتمل في `node_modules/@tera/core/RELEASES.md`) وأعرض التغييرات من الإصدار الحالي إلى الأحدث.
|
|
25
|
-
|
|
26
|
-
إذا لم يكن `RELEASES.md` متاحاً، أبلغ المستخدم بالتحديث المتاح بدون تفاصيل.
|
|
27
|
-
|
|
28
|
-
### 5. ارشد المستخدم للتحديث
|
|
29
|
-
أخبر المستخدم:
|
|
30
|
-
```
|
|
31
|
-
الإصدار الجديد جاهز. للتحديث:
|
|
32
|
-
1. شغّل: npm install @tera/core@latest
|
|
33
|
-
2. أعد تشغيل OpenCode
|
|
34
|
-
3.icals: /tera-status للتأكد من نجاح التحديث
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
**تنبيه مهم:** إذا كان هناك تغييرات جذرية (مذكورة في RELEASES.md)، اقرأها واحذر المستخدم منها.
|
|
38
|
-
|
|
39
|
-
### 6. لا تنفّذ التحديث تلقائياً
|
|
40
|
-
لا تشغل `npm install` بدون إذن المستخدم. فقط ارشده.
|
|
41
|
-
|
|
42
|
-
## ملاحظات
|
|
43
|
-
- لا تستخدم `--global` — الحزمة خاصة (restricted).
|
|
44
|
-
- إذا فشل الأمر، أبلغ المستخدم برسالة الخطأ ولا تحاول مرات متعددة.
|
|
45
|
-
- إذا كان المستخدم في وضع تجريبي (Trial)، أخبره أن التحديث لا يتطلب مفتاح تفعيل.
|
|
46
|
-
|
|
47
|
-
## اختم بجملة:
|
|
48
|
-
> هل تريد أن تُحدّث الآن؟ شغّل الأمر أعلاه وأنا سأتحقق من نجاح التحديث.
|
|
1
|
+
---
|
|
2
|
+
description: كشف التحديثات المتاحة وتحديث المنظومة
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
أنت Tera Agent. المستخدم يطلب التحقق من وجود تحديثات للمنظومة.
|
|
6
|
+
|
|
7
|
+
## الإجراء
|
|
8
|
+
|
|
9
|
+
### 1. اكشف الإصدار الحالي
|
|
10
|
+
اقرأ ملف `package.json` من مجلد الحزمة المُثبَّة (محتمل في `node_modules/@tera/core/package.json`) واستخرج `version`.
|
|
11
|
+
|
|
12
|
+
### 2. اكشف الإصدار الأحدث
|
|
13
|
+
شغّل الأمر التالي في الطرفية:
|
|
14
|
+
```bash
|
|
15
|
+
npm view @tera/core version 2>/dev/null || echo "unavailable"
|
|
16
|
+
```
|
|
17
|
+
إذا كان الناتج `unavailable`، أبلغ المستخدم أن السجل غير متاح حالياً (ربما لم يُنشر بعد أو لا يوجد اتصال).
|
|
18
|
+
|
|
19
|
+
### 3. قارن الإصدارين
|
|
20
|
+
- **متساويان؟** → أبلغ المستخدم: "أنت على أحدث إصدار."
|
|
21
|
+
- **الإصدار الأحدث متاح؟** → انتقل للخطوة 4.
|
|
22
|
+
|
|
23
|
+
### 4. أظهر التغييرات
|
|
24
|
+
اقرأ ملف `RELEASES.md` من مجلد الحزمة (محتمل في `node_modules/@tera/core/RELEASES.md`) وأعرض التغييرات من الإصدار الحالي إلى الأحدث.
|
|
25
|
+
|
|
26
|
+
إذا لم يكن `RELEASES.md` متاحاً، أبلغ المستخدم بالتحديث المتاح بدون تفاصيل.
|
|
27
|
+
|
|
28
|
+
### 5. ارشد المستخدم للتحديث
|
|
29
|
+
أخبر المستخدم:
|
|
30
|
+
```
|
|
31
|
+
الإصدار الجديد جاهز. للتحديث:
|
|
32
|
+
1. شغّل: npm install @tera/core@latest
|
|
33
|
+
2. أعد تشغيل OpenCode
|
|
34
|
+
3.icals: /tera-status للتأكد من نجاح التحديث
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
**تنبيه مهم:** إذا كان هناك تغييرات جذرية (مذكورة في RELEASES.md)، اقرأها واحذر المستخدم منها.
|
|
38
|
+
|
|
39
|
+
### 6. لا تنفّذ التحديث تلقائياً
|
|
40
|
+
لا تشغل `npm install` بدون إذن المستخدم. فقط ارشده.
|
|
41
|
+
|
|
42
|
+
## ملاحظات
|
|
43
|
+
- لا تستخدم `--global` — الحزمة خاصة (restricted).
|
|
44
|
+
- إذا فشل الأمر، أبلغ المستخدم برسالة الخطأ ولا تحاول مرات متعددة.
|
|
45
|
+
- إذا كان المستخدم في وضع تجريبي (Trial)، أخبره أن التحديث لا يتطلب مفتاح تفعيل.
|
|
46
|
+
|
|
47
|
+
## اختم بجملة:
|
|
48
|
+
> هل تريد أن تُحدّث الآن؟ شغّل الأمر أعلاه وأنا سأتحقق من نجاح التحديث.
|
|
@@ -76,8 +76,8 @@
|
|
|
76
76
|
| الفئة | اللغات | آلية التنفيذ |
|
|
77
77
|
|---|---|---|
|
|
78
78
|
| 🥇 **متخصصة (Specialist)** | C#/.NET، TypeScript/Node.js/React، Phaser 3 (JS) | عميل متخصص مخصص بمعايير كاملة |
|
|
79
|
-
| 🥈 **مغطاة ببروفايل** | Dart/Flutter، Razor Pages+ADO.NET، Next.js+Prisma، WPF، Blazor+EF، React PWA | Fallback + بروفايل (قواعد Scaffold/ORM/CLI موثقة) |
|
|
80
|
-
| 🥉 **غير مغطاة (أي لغة أخرى)** | PHP/Laravel، Python/Django، Java/Spring، Go، Ruby، Kotlin، Swift
|
|
79
|
+
| 🥈 **مغطاة ببروفايل** | Dart/Flutter، Razor Pages+ADO.NET، Next.js+Prisma، WPF، Blazor+EF، React PWA، **Rust (Draft)** | Fallback + بروفايل (قواعد Scaffold/ORM/CLI موثقة) — Rust: بروفايل `rust.md` (Draft — Needs Verification، SCP-2026-09-04-011) |
|
|
80
|
+
| 🥉 **غير مغطاة (أي لغة أخرى)** | PHP/Laravel، Python/Django، Java/Spring، Go، Ruby، Kotlin، Swift... | **Fallback العام مباشرة** — يعمل بلا بروفايل (بجودة أقل) أو ببروفايل (بجودة موثقة) |
|
|
81
81
|
|
|
82
82
|
### 2.3 المعادلة الحاكمة
|
|
83
83
|
|
|
@@ -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 (بروفايل Draft — SCP-2026-09-04-011) | ✅ يعمل — بروفايل يرفع الجودة |
|
|
102
102
|
| **ذكاء محدود + أداة** | لغات نادرة/جديدة/إصدارات حديثة جداً | ⚠️ يعمل لكن بخطأ محتمل — بروفايل شبه إلزامي |
|
|
103
103
|
| **أي مستوى بلا أداة** | أي لغة بلا CLI/بيئة بناء | 🔴 تتوقف عند "الكتابة" ولا تصل "التسليم" |
|
|
104
104
|
|
|
@@ -49,6 +49,7 @@ If the stack is still unclear, do not activate a final profile yet.
|
|
|
49
49
|
| `react-pwa` | React 18 + Vite + TypeScript + Tailwind CSS (RTL) + Zustand + idb (IndexedDB) + Fuse.js + vite-plugin-pwa | ✅ **Approved — Active** | PWA محلي عربي (Offline Standalone) — فعّل Majed (2026-08-01, PREP-D-016) |
|
|
50
50
|
| `flutter-mobile` | Flutter + Dart | Available | موبايل — يُحمَّل عند تصنيف المنتج موبايل (MVP_DEFINITION_PROTOCOL + MOBILE_UI_UX_STANDARDS) — (SCP-2026-09-04-003) |
|
|
51
51
|
| `dotnet-razorpages-adonet` | .NET Razor Pages + ADO.NET | Available | تطبيقات أعمال داخلية + تكامل بيانات — (SCP-2026-09-04-003) |
|
|
52
|
+
| `rust` | Rust (cargo/rustc) — 2024 edition, Axum/Tauri/SQLx | **Draft — Needs Verification** | عام: CLI، خدمات عالية الأداء، Tauri، WebAssembly — لا متخصص، يعمل عبر engineering-agent (fallback)؛ الترقية لـ Available بعد تجربة تحقق (SCP-2026-09-04-011) |
|
|
52
53
|
|
|
53
54
|
## Placeholder Candidates
|
|
54
55
|
|
|
@@ -0,0 +1,164 @@
|
|
|
1
|
+
# Technology Profile: rust
|
|
2
|
+
|
|
3
|
+
> **Status: Draft — Needs Verification** (SCP-2026-09-04-011)
|
|
4
|
+
> مبني على بحث عميق 2026 من مصادر موثوقة (16 مصدراً: Corgea, Rust 2026 Template, onehorizon, Apollo skills, RuleSync, Agentbrisk, Axum/SQLx production guides...). **لم يُثبت بعد ببناء/اختبار فعلي محلي** (cargo غير مثبت على بيئة الإنشاء عند كتابة هذا البروفايل). ترقية الحالة إلى `Available` بعد تجربة تحقق (انظر §10).
|
|
5
|
+
|
|
6
|
+
## 1. Profile Identity
|
|
7
|
+
|
|
8
|
+
- Profile ID: `rust`
|
|
9
|
+
- Language: Rust
|
|
10
|
+
- Framework: حسب المشروع — Axum (HTTP API) / Tauri (سطح مكتب + ويب) / actix-web (اختياري) / مكتبة أو CLI نقية
|
|
11
|
+
- Database: PostgreSQL (الأكثر شيوعاً مع SQLx) / SQLite / MySQL — حسب المشروع
|
|
12
|
+
- ORM: **SQLx** (يفضَّل — SQL مكتوب يدوياً + تحقق compile-time) / Diesel / SeaORM
|
|
13
|
+
- Package Manager / CLI: `cargo` + `rustup` (toolchain) — إصدار 2024 edition, MSRV 1.85+ (تحديث 2026)
|
|
14
|
+
- Default Project Type: CLI / خدمات عالية الأداء / أدوات نظامية / WebAssembly / Tauri (سطح مكتب) / Backend API
|
|
15
|
+
|
|
16
|
+
## 2. Applicability
|
|
17
|
+
|
|
18
|
+
يُستخدم هذا البروفايل عندما:
|
|
19
|
+
- المشروع يتطلب أداءً عالياً أو موارد منخفضة (مقارنة بـ GC languages).
|
|
20
|
+
- تطبيق CLI أو أداة أو نظام أو خدمة شبكة عالية الأداء.
|
|
21
|
+
- سطح مكتب عبر Tauri (بديل أخف من Electron) أو WebAssembly.
|
|
22
|
+
- الزبون طلب Rust صراحة (المبدأ: لا لغة ممنوعة — fallback يعمل، والبروفايل يرفع الجودة).
|
|
23
|
+
|
|
24
|
+
**لا يُفضَّل** لمشاريع الويب التجارية سريعة الإنتاج (حيث TypeScript/.NET أسرع إنتاجية) — إلا بطلب صريح أو حاجة أداء مؤكدة.
|
|
25
|
+
|
|
26
|
+
## 3. Default Execution Order
|
|
27
|
+
|
|
28
|
+
```text
|
|
29
|
+
1. cargo new --vcs git <name> (أو إعداد workspace لمشروع متعدد المكونات)
|
|
30
|
+
2. تثبيت/تأكيد toolchain: rustup + cargo + rustfmt + clippy (cargo --version)
|
|
31
|
+
3. First Task: أثبت toolchain — hello-world + cargo build + cargo test
|
|
32
|
+
4. بنية النطاق: types/domain أولاً (تشفير الحالات غير الصالحة في الأنواع)
|
|
33
|
+
5. منطق الأعمال: functions/structs + Result-errors (thiserror في lib / anyhow في bin)
|
|
34
|
+
6. طبقة البيانات (إن وجدت): SQLx + migrations (compile-time-checked queries)
|
|
35
|
+
7. واجهة (إن وجدت): Axum (backend) / Tauri (desktop) — DTO منفصلة عن domain
|
|
36
|
+
8. اختبارات: unit (#[cfg(test)]) + integration (tests/) + nextest + proptest
|
|
37
|
+
9. التحقق النهائي: cargo fmt --check + cargo clippy -D warnings + cargo test + cargo audit
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## 4. First Task Rule
|
|
41
|
+
|
|
42
|
+
أول مهمة تنفيذية لأي مشروع Rust: **إثبات الـ toolchain قبل أي كود منطقي**:
|
|
43
|
+
|
|
44
|
+
```text
|
|
45
|
+
1. cargo --version && rustc --version && rustup show
|
|
46
|
+
2. cargo new <name> --vcs git
|
|
47
|
+
3. تعديل main.rs (hello) → cargo build → cargo run
|
|
48
|
+
4. cargo test (يتأكد أن بنية الاختبارات تعمل)
|
|
49
|
+
5. cargo clippy -- -D warnings (يتأكد أن clippy يعمل وصافي)
|
|
50
|
+
6. cargo fmt --check
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
إذا فشلت أي خطوة: STOP — لا تبنِ فوق toolchain غير مثبت. وثّق الإصدارات في الـ handback.
|
|
54
|
+
|
|
55
|
+
## 5. Scaffold Rules
|
|
56
|
+
|
|
57
|
+
- `cargo new <name> --vcs git` — يبدأ ببيئة git (لا تحذفها إلا بتوجيه).
|
|
58
|
+
- للمشاريع متعددة المكونات: **workspace** (`[workspace] members`) — لكن **Module-First**: لا تقسّم crates إلا لحاجة حقيقية (proc-macro، حدود صارمة، توازي بناء) — 2026 consensus.
|
|
59
|
+
- حدد `rust-version` (MSRV) في Cargo.toml — cargo يرفض بناءً بـ toolchain أقدم.
|
|
60
|
+
- `Cargo.lock`: **يُلتَزم في git** (للتكرار القابل للبناء حتى في المكتبات).
|
|
61
|
+
- التبعيات: **بلا wildcards** (`tokio = "*"` ممنوع) — ثبّت major+minor (`tokio = "1.38"`). حدد features المستخدمة فقط.
|
|
62
|
+
- `[lints]` في Cargo.toml (مستقر منذ Rust 1.74): سياسة lint موحدة للجميع — انظر §9.
|
|
63
|
+
|
|
64
|
+
## 6. ORM / Database Rules
|
|
65
|
+
|
|
66
|
+
### SQLx (المفضَّل):
|
|
67
|
+
- `query!` / `query_as!` — تحقق compile-time ضد قاعدة حقيقية (يتطلب DATABASE_URL عند البناء).
|
|
68
|
+
- **Offline mode**: `cargo sqlx prepare` + `SQLX_OFFLINE=true` في CI/Docker + التزام `.sqlx/`.
|
|
69
|
+
- Migrations: `sqlx migrate add <name>` + `sqlx::migrate!()` (تشغيل تلقائي عند البدء) أو sqlx-cli.
|
|
70
|
+
- **Parameterized queries إلزامي** — ممنوع string interpolation في SQL (SQL injection — OWASP).
|
|
71
|
+
- `PgPool`: max_connections محدود (أقل من max Postgres ÷ عدد النسخ) + `acquire_timeout` + `idle_timeout` — لا إعدادات افتراضية.
|
|
72
|
+
- Diesel/SeaORM: عند الحاجة — migrations عبر أدواتها الخاصة (`diesel_cli` / `sea-orm-cli`).
|
|
73
|
+
|
|
74
|
+
## 7. CLI Side Effects
|
|
75
|
+
|
|
76
|
+
| الأمر | الأثر |
|
|
77
|
+
|---|---|
|
|
78
|
+
| `cargo add <crate>` | يضيف تبعية — وثّق السبب؛ لا تبعية بلا حاجة |
|
|
79
|
+
| `cargo build` / `cargo run` | يبني/يشغّل — بدون أثر دائم (ما لم يشغّل كوداً بآثار) |
|
|
80
|
+
| `cargo test` | يشغّل الاختبارات |
|
|
81
|
+
| `cargo clippy` / `cargo fmt` | تحليل/تنسيق — بلا أثر على الإنتاج |
|
|
82
|
+
| `cargo sqlx prepare` | يكتب `.sqlx/` metadata — **يُلتَزم** |
|
|
83
|
+
| `sqlx migrate run` | **يغيّر قاعدة البيانات** — يتطلب موافقة صريحة (مثل أي migration) |
|
|
84
|
+
| `cargo audit` / `cargo deny` | فحص تبعيات — تشغيل قبل التسليم |
|
|
85
|
+
|
|
86
|
+
**القاعدة:** أي أمر يغيّر قاعدة بيانات أو يثبّت شيئاً في النظام = بوابة موافقة (مثل سياسة migrations في المنظومة).
|
|
87
|
+
|
|
88
|
+
## 8. Forbidden Defaults
|
|
89
|
+
|
|
90
|
+
```text
|
|
91
|
+
❌ unsafe — خارج "المكتبات/FFI ذات الحاجة المؤكدة فقط" — والافتراضي #![forbid(unsafe_code)]
|
|
92
|
+
❌ .unwrap() / .expect() في كود الإنتاج (مسموح في الاختبارات فقط) — لint unwrap_used/expect_used
|
|
93
|
+
❌ panic! في مسارات الإدخال الخارجي (DoS) — Result و ? بدلها
|
|
94
|
+
❌ &String / &Vec<T> في التواقيع — &str / &[T] (أرخص اقتراض عند الحدود)
|
|
95
|
+
❌ .clone() "لإسكات الـ borrow checker" — أعد تصميم الملكية أولاً؛ لا clone في الحلقات
|
|
96
|
+
❌ Box<dyn Error> في API عام للمكتبات — thiserror enum بدلها (2026: لا مزايا)
|
|
97
|
+
❌ std::sync::Mutex عبر .await — deadlock في tokio؛ استخدم tokio::sync::Mutex أو أسقط القفل قبل await
|
|
98
|
+
❌ استدعاء I/O حاجب (blocking) داخل async fn — tokio::fs/net/reqwest أو spawn_blocking
|
|
99
|
+
❌ tokio = "*" أو أي wildcard تبعية
|
|
100
|
+
❌ Rc<RefCell<T>> كحل سهل للملكية — أعد التصميم
|
|
101
|
+
❌ Cargo.toml بلا rust-version / بلا [lints]
|
|
102
|
+
❌ كود "C-style Rust" — تجنب 400-line match وأقواس مفرطة؛ استخدم idioms حقيقية (enums للأنواع غير الصالحة)
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
## 9. Pre-Execution Gate Additions
|
|
106
|
+
|
|
107
|
+
إضافات بروفايل Rust على `TeraPreExecutionGate.md`:
|
|
108
|
+
|
|
109
|
+
| # | الفحص |
|
|
110
|
+
|---|---|
|
|
111
|
+
| 1 | `cargo --version` متوفر؟ (toolchain مثبت — إن لا: STOP، ثبّت أولاً) |
|
|
112
|
+
| 2 | إصدار 2024 edition + `rust-version` محدد في Cargo.toml؟ |
|
|
113
|
+
| 3 | التبعيات بلا wildcards + features محدودة؟ |
|
|
114
|
+
| 4 | `Cargo.lock` مُلتَزم (إن مشروع binary/service)؟ |
|
|
115
|
+
| 5 | سياسة `[lints]` حاضرة؟ |
|
|
116
|
+
| 6 | لـ SQLx: DATABASE_URL / offline metadata (`SQLX_OFFLINE` + `.sqlx/`)؟ |
|
|
117
|
+
| 7 | أي unsafe مخطط له — مبرر وضمن crate منفصل بحدود؟ |
|
|
118
|
+
| 8 | المهمة تلمس بيانات حساسة/صلاحيات/دفع → Security Review (الدرع) قبل التنفيذ |
|
|
119
|
+
|
|
120
|
+
**مرجع lint الموصى به** ([lints] في Cargo.toml — مصدر: Corgea 2026 + Apollo + Rust 2026 Template):
|
|
121
|
+
|
|
122
|
+
```toml
|
|
123
|
+
[lints.rust]
|
|
124
|
+
unsafe_code = "forbid" # تُزال في crates التي تحتاج unsafe فعلاً
|
|
125
|
+
missing_docs = "warn"
|
|
126
|
+
|
|
127
|
+
[lints.clippy]
|
|
128
|
+
unwrap_used = "warn"
|
|
129
|
+
expect_used = "warn"
|
|
130
|
+
undocumented_unsafe_blocks = "deny"
|
|
131
|
+
cast_possible_truncation = "warn"
|
|
132
|
+
await_holding_lock = "warn"
|
|
133
|
+
redundant_clone = "warn"
|
|
134
|
+
needless_collect = "warn"
|
|
135
|
+
large_enum_variant = "warn"
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
في workspace: `[workspace.lints]` مرة واحدة + `lints.workspace = true` لكل crate.
|
|
139
|
+
|
|
140
|
+
## 10. Acceptance Criteria Patterns
|
|
141
|
+
|
|
142
|
+
```text
|
|
143
|
+
✅ cargo build --release → PASS
|
|
144
|
+
✅ cargo test → PASS (unit + integration)
|
|
145
|
+
✅ cargo clippy --workspace --all-targets -- -D warnings → صفر warnings
|
|
146
|
+
✅ cargo fmt --check → PASS (لا انحراف)
|
|
147
|
+
✅ cargo audit (لا CRITICAL/HIGH بلا إصلاح أو خطة) — GITLEAKS للأسرار
|
|
148
|
+
✅ معايير الخطأ: thiserror في lib (أنواع قابلة للمطابقة) / anyhow + .context() في bin — بلا unwrap خارج الاختبارات
|
|
149
|
+
✅ لـ async: بلا I/O حاجب في async fn + بلا قفل عبر await (clippy يتحقق)
|
|
150
|
+
✅ لـ SQL: parameterized فقط + migrations قابلة للتراجع
|
|
151
|
+
✅ لـ UI (Tauri/Web): Playwright/axe وفق قواعد المنظومة
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
### مسار الترقية إلى Available (خطوة التحقق المتبقية — بيئة تنفيذ بها cargo)
|
|
155
|
+
|
|
156
|
+
```text
|
|
157
|
+
1. cargo new verify-rust-cli → build + test + clippy -D warnings + fmt --check → PASS
|
|
158
|
+
2. (اختياري) مشروع Axum+SQLx صغير → build + migrate + test → PASS
|
|
159
|
+
3. عند النجاح: رفع حالة هذا البروفايل من "Draft" → "Available" في §1 + PROFILES_INDEX + TeraCapabilityMap
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
*أُنشئ: TeraSystemEvolutionAgent (حارس) — 2026-09-04 · SCP-2026-09-04-011 · بحث 2026 من 16 مصدراً موثوقاً — Draft حتى تجربة تحقق.*
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tera-system/core",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.20",
|
|
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/scripts/install.js
CHANGED
|
@@ -226,21 +226,26 @@ fs.mkdirSync(path.dirname(manifestPath), { recursive: true });
|
|
|
226
226
|
fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
|
|
227
227
|
|
|
228
228
|
/* ------------------- license state (non-blocking, never breaks install) ------------------- */
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
229
|
+
// `@tera-system/core` is free — it has no license gate. Skip the whole block for it so no
|
|
230
|
+
// `[license]` line is printed and no `.tera/license.state.json` is ever created.
|
|
231
|
+
// The paid `@tera-system/pro` distribution keeps its own license flow via its install.js.
|
|
232
|
+
if (pkg.name !== "@tera-system/core") {
|
|
233
|
+
try {
|
|
234
|
+
const stateFile = path.join(target, ".tera", "license.state.json");
|
|
235
|
+
let licenseKey = (readLicenseState(stateFile) || {}).licenseKey;
|
|
236
|
+
if (!licenseKey) licenseKey = process.env.TERA_LICENSE_KEY || undefined;
|
|
237
|
+
const state = assessLicenseState(licenseKey);
|
|
238
|
+
writeLicenseState(stateFile, {
|
|
239
|
+
state: state.state,
|
|
240
|
+
reason: state.reason,
|
|
241
|
+
licenseKey: licenseKey || null,
|
|
242
|
+
expiresAt: state.expiresAt || null,
|
|
243
|
+
checkedAt: new Date().toISOString(),
|
|
244
|
+
});
|
|
245
|
+
console.log(` [license ] state=${state.state} (${state.reason})`);
|
|
246
|
+
} catch (err) {
|
|
247
|
+
console.log(` [license ] skipped (${err.message}) — install continues`);
|
|
248
|
+
}
|
|
244
249
|
}
|
|
245
250
|
|
|
246
251
|
console.log("\n summary:");
|
package/scripts/tera-license.mjs
DELETED
|
@@ -1,63 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
// @tera/core license CLI — issue & verify license keys (SCP-005)
|
|
3
|
-
import fs from "node:fs";
|
|
4
|
-
import path from "node:path";
|
|
5
|
-
import { fileURLToPath } from "node:url";
|
|
6
|
-
import { issueLicenseKey, assessLicenseState, readLicenseState, STATES } from "./lib/license.mjs";
|
|
7
|
-
|
|
8
|
-
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
9
|
-
const DEV_KEY = path.join(__dirname, "..", "license", "dev", "dev-private-key.pem");
|
|
10
|
-
|
|
11
|
-
function usage() {
|
|
12
|
-
console.log(`Usage:
|
|
13
|
-
tera-license gen --tier <basic|premium> --project <name> --expires <YYYY-MM-DD> [--seats N]
|
|
14
|
-
(private key: env TERA_LICENSE_PRIVATE or the dev key under license/dev/)
|
|
15
|
-
tera-license check [--key <licenseKey> | --state-file <path>]
|
|
16
|
-
(or env TERA_LICENSE_KEY)`);
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
const args = process.argv.slice(2);
|
|
20
|
-
const cmd = args[0];
|
|
21
|
-
function flag(name) {
|
|
22
|
-
const i = args.indexOf(name);
|
|
23
|
-
return i >= 0 && args[i + 1] ? args[i + 1] : undefined;
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
if (cmd === "gen") {
|
|
27
|
-
const tier = flag("--tier") || "basic";
|
|
28
|
-
const project = flag("--project");
|
|
29
|
-
const expires = flag("--expires");
|
|
30
|
-
const seats = flag("--seats") ? Number(flag("--seats")) : 1;
|
|
31
|
-
if (!project || !expires) {
|
|
32
|
-
usage();
|
|
33
|
-
process.exit(1);
|
|
34
|
-
}
|
|
35
|
-
const privatePem = process.env.TERA_LICENSE_PRIVATE || fs.readFileSync(DEV_KEY, "utf8");
|
|
36
|
-
const key = issueLicenseKey(
|
|
37
|
-
{ tier, project, issuedAt: new Date().toISOString(), expiresAt: new Date(expires).toISOString(), seats },
|
|
38
|
-
privatePem
|
|
39
|
-
);
|
|
40
|
-
console.log(key);
|
|
41
|
-
} else if (cmd === "check") {
|
|
42
|
-
let key = flag("--key");
|
|
43
|
-
if (!key) {
|
|
44
|
-
const stateFile = flag("--state-file");
|
|
45
|
-
if (stateFile) {
|
|
46
|
-
const st = readLicenseState(stateFile);
|
|
47
|
-
key = st && st.licenseKey;
|
|
48
|
-
if (!key) {
|
|
49
|
-
console.log(JSON.stringify({ state: STATES.UNLICENSED, reason: "no-key-trial" }, null, 2));
|
|
50
|
-
process.exit(0);
|
|
51
|
-
}
|
|
52
|
-
} else {
|
|
53
|
-
key = process.env.TERA_LICENSE_KEY;
|
|
54
|
-
}
|
|
55
|
-
}
|
|
56
|
-
if (!key) {
|
|
57
|
-
console.log(JSON.stringify({ state: STATES.UNLICENSED, reason: "no-key-trial" }, null, 2));
|
|
58
|
-
process.exit(0);
|
|
59
|
-
}
|
|
60
|
-
console.log(JSON.stringify(assessLicenseState(key), null, 2));
|
|
61
|
-
} else {
|
|
62
|
-
usage();
|
|
63
|
-
}
|