@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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tera-system/core",
3
- "version": "0.2.19",
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": 118,
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": "a2520ceef3a3f4e9cec2e4c070aeecd41a215ed12438f81d45111e6c801f9ec2",
20
- "core/tera-system": "23e3c729a393c532f563cffd63e520435dd21c23a8744026fcb7b0740ac31752",
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)
@@ -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.
@@ -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**: أخبرني بالسبب المحدد فقط وانتظر قراري.
@@ -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
+ ```
@@ -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، انتظر كلمة موافقة صريحة قبل أي تنفيذ.
@@ -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 غير موجود، هذا مشروع جديد — أخبرني وانتظر التعليمات.
@@ -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).
@@ -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
+ - إذا كانت الملفات غير موجودة، أخبرني بذلك مباشرة.
@@ -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، Rust... | **Fallback العام مباشرة** — يعمل بلا بروفايل (بجودة أقل) أو ببروفايل (بجودة موثقة) |
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.19",
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",
@@ -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
- try {
230
- const stateFile = path.join(target, ".tera", "license.state.json");
231
- let licenseKey = (readLicenseState(stateFile) || {}).licenseKey;
232
- if (!licenseKey) licenseKey = process.env.TERA_LICENSE_KEY || undefined;
233
- const state = assessLicenseState(licenseKey);
234
- writeLicenseState(stateFile, {
235
- state: state.state,
236
- reason: state.reason,
237
- licenseKey: licenseKey || null,
238
- expiresAt: state.expiresAt || null,
239
- checkedAt: new Date().toISOString(),
240
- });
241
- console.log(` [license ] state=${state.state} (${state.reason})`);
242
- } catch (err) {
243
- console.log(` [license ] skipped (${err.message}) — install continues`);
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:");
@@ -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
- }