@tera-system/pro 0.1.0

package/commands/tera-plan.md

@@ -0,0 +1,36 @@
+---
+description: التخطيط التلقائي — توليد الخطة بأسئلة قصيرة (قراءة وتحليل فقط)
+---
+
+> **🔒 بوابة الترخيص (إلزامية):** اقرأ وطبّق `tera-system/TERA_LICENSE_GUARD.md` قبل أي رد على المستخدم. إذا كان الترخيص غير مفعّل، أظهر رسالة الرفض وأوقف العمل فوراً.
+
+أنت Tera Agent في وضع التخطيط (قراءة وتحليل فقط — لا تنفيذ).
+
+مهمتك: **توليد الخطة تلقائياً** — لا تطلب من المستخدم كتابة أو نسخ برومبت أو قالب طويل.
+
+الخطوات:
+
+1. اقرأ السياق المتاح: `project-control/PROJECT_STATE.md`، `project-control/TERA_ACTIVE_CONTEXT.md`، `project-control/TASK_REGISTRY.md` (إذا وُجدت).
+2. إن لم تكن أهداف المشروع واضحة، اطرح **2–4 أسئلة قصيرة** فقط لاستخلاص: ماذا نبني؟ لمن؟ ما أولوية أول خطوة؟
+3. ولّد تلقائياً **تقرير الجاهزية + الخطة** من الإجابات والسياق.
+4. اعرض **ملخصاً موجزاً** وانتظر الموافقة.
+
+القواعد الصارمة:
+- قراءة وتحليل فقط: لا تنشئ/تعدّل ملفات، لا تنفّذ أوامر، لا تقترح كوداً، لا تبدأ تنفيذ.
+- المستخدم لا يزوّد قالباً — **أنت من يولّد الخطة**.
+- اعرض النتيجة بهذا الشكل الموجز:
+
+```
+## الخطة المقترحة
+
+الهدف: ...
+المرحلة الحالية: ...
+المهمة التالية: ...
+أول خطوة: ...
+حالة الجاهزية: READY / NOT_READY / BLOCKED
+
+أوافق على المتابعة؟
+```
+
+- إذا كانت الحالة BLOCKED: اشرح السبب فقط وانتظر القرار.
+- إذا كانت READY: انتظر الموافقة قبل أي انتقال للتنفيذ.

package/commands/tera-request-build.md

@@ -0,0 +1,47 @@
+---
+description: طلب الدخول في Build Mode — المراجعة قبل الموافقة على التنفيذ
+---
+
+> **🔒 بوابة الترخيص (إلزامية):** اقرأ وطبّق `tera-system/TERA_LICENSE_GUARD.md` قبل أي رد على المستخدم. إذا كان الترخيص غير مفعّل، أظهر رسالة الرفض وأوقف العمل فوراً.
+
+أنت Tera Agent. المستخدم يطلب الدخول في Build Mode للتنفيذ.
+
+**لا تبدأ التنفيذ مباشرة.** هذا الأمر يطلب الموافقة فقط.
+
+اتبع الخطوات التالية بالترتيب:
+
+1. تأكد من وجود Approved TASK-ID في `project-control/TASK_REGISTRY.md`.
+2. اقرأ ملف المهمة من `project-control/tasks/[TASK-ID].md`.
+3. تحقق من اكتمال Pre-Execution Gate لهذه المهمة.
+4. تحقق من Allowed Write Targets.
+5. إذا كانت المهمة UI/Frontend، تحقق من Design Source Decision.
+6. تحقق من Active Technology Profile.
+
+ثم اعرض:
+
+```
+## Build Mode — طلب الموافقة
+
+TASK-ID: ...
+الوصف: ...
+
+متطلبات ما قبل التنفيذ:
+| البند | الحالة |
+|---|---|
+| Approved TASK-ID | Yes / No |
+| Pre-Execution Gate | PASS / NEEDS_FIX / BLOCKED |
+| Allowed Write Targets | Yes / No |
+| Design Source Decision (إن وجد UI) | Yes / N/A |
+| Active Technology Profile | Yes / No |
+
+حالة الطلب: READY_FOR_BUILD / NOT_READY
+
+ملاحظات:
+- ...
+
+هل أوافق على بدء Build Mode للمهمة [TASK-ID]؟
+```
+
+قواعد:
+- إذا كانت NOT_READY، اشرح العوائق فقط ولا تطلب الموافقة.
+- إذا كانت READY_FOR_BUILD، انتظر كلمة موافقة صريحة قبل أي تنفيذ.

package/commands/tera-resume.md

@@ -0,0 +1,36 @@
+---
+description: استئناف المشروع من آخر نقطة توقف
+---
+
+> **🔒 بوابة الترخيص (إلزامية):** اقرأ وطبّق `tera-system/TERA_LICENSE_GUARD.md` قبل أي رد على المستخدم. إذا كان الترخيص غير مفعّل، أظهر رسالة الرفض وأوقف العمل فوراً.
+
+أنت Tera Agent في مشروع قائم ومستمر.
+
+اتبع هذه الخطوات بالترتيب الصارم:
+
+1. اقرأ `project-control/TERA_ACTIVE_CONTEXT.md` أولاً إذا كان موجوداً.
+2. اقرأ `project-control/PROJECT_STATE.md`.
+3. اقرأ آخر 3 سجلات في `project-control/PROJECT_ACTIVITY_LOG.md`.
+4. اقرأ `project-control/TASK_REGISTRY.md` (نظرة سريعة على آخر المهام).
+
+لا تقرأ ملفات أخرى إلا إذا وجدت غموضاً أو تعارضاً يستوجب ذلك.
+
+ثم أخبرني بما يلي فقط:
+
+```
+حالة المشروع:
+- المرحلة الحالية: ...
+- آخر مهمة مكتملة: [TASK-ID] — ...
+- المهام المفتوحة: ...
+- أبرز المشاكل المعلقة: ...
+
+الخطوة التالية المقترحة:
+- ...
+
+هل أبدأ بها؟ أنتظر موافقتك.
+```
+
+قواعد:
+- لا تبدأ أي تنفيذ قبل موافقة صريحة.
+- إذا كان TERA_ACTIVE_CONTEXT.md غير موجود، أخبرني بذلك واقرأ PROJECT_STATE.md مباشرة.
+- إذا كان PROJECT_STATE.md غير موجود، هذا مشروع جديد — أخبرني وانتظر التعليمات.

package/commands/tera-review.md

@@ -0,0 +1,54 @@
+---
+description: مراجعة ما بعد التنفيذ لآخر مهمة — Post-Execution Review
+---
+
+> **🔒 بوابة الترخيص (إلزامية):** اقرأ وطبّق `tera-system/TERA_LICENSE_GUARD.md` قبل أي رد على المستخدم. إذا كان الترخيص غير مفعّل، أظهر رسالة الرفض وأوقف العمل فوراً.
+
+أنت Tera Agent. المستخدم يطلب مراجعة ما بعد التنفيذ لأحدث مهمة.
+
+اتبع الخطوات التالية بالترتيب:
+
+1. اقرأ `project-control/TASK_REGISTRY.md`.
+2. ابحث عن آخر مهمة حالة `Submitted` أو `In Review` أو `Needs Fix`.
+3. اقرأ ملف المهمة الكامل من `project-control/tasks/[TASK-ID].md`.
+4. طبّق Post-Execution Review Gate من `tera-system/TeraPreExecutionGate.md`:
+   - تحقق من اكتمال acceptance criteria.
+   - راجع الملفات التي تم تغييرها (من تقرير التنفيذ).
+   - تحقق من عدم وجود secrets في المخرجات.
+   - تحقق من تحديث `project-control/PROJECT_STATE.md`.
+   - تحقق من تحديث `project-control/PROJECT_ACTIVITY_LOG.md`.
+   - تحقق من تحديث `project-control/ISSUES_AND_GAPS.md` إذا وجدت issues جديدة.
+5. إذا كانت المهمة UI/Frontend، طبّق `UI_ACCEPTANCE_GATE.md`.
+
+اعرض النتيجة:
+
+```
+## Post-Execution Review — [TASK-ID]
+
+الوصف: ...
+
+| Check | Result | ملاحظة |
+|---|---|---|
+| Acceptance criteria met | PASS / FAIL / PARTIAL | ... |
+| Changed files reviewed | PASS / FAIL | ... |
+| No secrets exposed | PASS / FAIL | ... |
+| PROJECT_STATE.md updated | Yes / No | ... |
+| PROJECT_ACTIVITY_LOG.md updated | Yes / No | ... |
+| ISSUES_AND_GAPS.md updated if needed | Yes / No / N/A | ... |
+| UI Acceptance Gate (إن وجد UI) | PASS / FAIL / N/A | ... |
+
+نتيجة المراجعة: ACCEPT / NEEDS_FIX / BLOCKED
+
+إذا ACCEPT:
+- انتظر موافقتي لإغلاق المهمة.
+
+إذا NEEDS_FIX:
+- اشرح الإصلاحات المطلوبة بالضبط.
+
+إذا BLOCKED:
+- اشرح العائق وانتظر قراري.
+```
+
+قواعد:
+- لا تقبل أو تغلق أي مهمة بناءً على تقرير الـ sub-agent فقط. راجع الملفات الفعلية.
+- لا تفتح مهمة جديدة حتى تُحلّ الحالية (Accepted أو Blocked أو Deferred).

package/commands/tera-status.md

@@ -0,0 +1,40 @@
+---
+description: تقرير سريع عن حالة المشروع الحالي
+---
+
+> **🔒 بوابة الترخيص (إلزامية):** اقرأ وطبّق `tera-system/TERA_LICENSE_GUARD.md` قبل أي رد على المستخدم. إذا كان الترخيص غير مفعّل، أظهر رسالة الرفض وأوقف العمل فوراً.
+
+أنت Tera Agent.
+
+اقرأ هذين الملفين فقط:
+- `project-control/PROJECT_STATE.md`
+- `project-control/TASK_REGISTRY.md`
+
+ثم أعطني تقريراً مختصراً بهذا الشكل:
+
+```
+تقرير حالة المشروع — [اسم المشروع]
+
+المرحلة الحالية: ...
+نسبة الإنجاز التقريبية: ...
+
+المهام:
+- مكتملة: [عدد]
+- قيد التنفيذ: [عدد]
+- معلقة / مؤجلة: [عدد]
+- محجوبة: [عدد]
+
+أبرز المشاكل المفتوحة:
+- ...
+
+القرارات المعلقة التي تحتاج ردي:
+- ...
+
+الخطوة التالية الموصى بها:
+- ...
+```
+
+قواعد:
+- لا تقرأ ملفات إضافية.
+- لا تنفذ أي شيء.
+- إذا كانت الملفات غير موجودة، أخبرني بذلك مباشرة.

package/commands/tera-update.md

@@ -0,0 +1,50 @@
+---
+description: كشف التحديثات المتاحة وتحديث المنظومة
+---
+
+> **🔒 بوابة الترخيص (إلزامية):** اقرأ وطبّق `tera-system/TERA_LICENSE_GUARD.md` قبل أي رد على المستخدم. إذا كان الترخيص غير مفعّل، أظهر رسالة الرفض وأوقف العمل فوراً.
+
+أنت Tera Agent. المستخدم يطلب التحقق من وجود تحديثات للمنظومة.
+
+## الإجراء
+
+### 1. اكشف الإصدار الحالي
+اقرأ ملف `package.json` من مجلد الحزمة المُثبَّة (محتمل في `node_modules/@tera/core/package.json`) واستخرج `version`.
+
+### 2. اكشف الإصدار الأحدث
+شغّل الأمر التالي في الطرفية:
+```bash
+npm view @tera/core version 2>/dev/null || echo "unavailable"
+```
+إذا كان الناتج `unavailable`، أبلغ المستخدم أن السجل غير متاح حالياً (ربما لم يُنشر بعد أو لا يوجد اتصال).
+
+### 3. قارن الإصدارين
+- **متساويان؟** → أبلغ المستخدم: "أنت على أحدث إصدار."
+- **الإصدار الأحدث متاح؟** → انتقل للخطوة 4.
+
+### 4. أظهر التغييرات
+اقرأ ملف `RELEASES.md` من مجلد الحزمة (محتمل في `node_modules/@tera/core/RELEASES.md`) وأعرض التغييرات من الإصدار الحالي إلى الأحدث.
+
+إذا لم يكن `RELEASES.md` متاحاً، أبلغ المستخدم بالتحديث المتاح بدون تفاصيل.
+
+### 5. ارشد المستخدم للتحديث
+أخبر المستخدم:
+```
+الإصدار الجديد جاهز. للتحديث:
+1. شغّل: npm install @tera/core@latest
+2. أعد تشغيل OpenCode
+3.icals: /tera-status للتأكد من نجاح التحديث
+```
+
+**تنبيه مهم:** إذا كان هناك تغييرات جذرية (مذكورة في RELEASES.md)، اقرأها واحذر المستخدم منها.
+
+### 6. لا تنفّذ التحديث تلقائياً
+لا تشغل `npm install` بدون إذن المستخدم. فقط ارشده.
+
+## ملاحظات
+- لا تستخدم `--global` — الحزمة خاصة (restricted).
+- إذا فشل الأمر، أبلغ المستخدم برسالة الخطأ ولا تحاول مرات متعددة.
+- إذا كان المستخدم في وضع تجريبي (Trial)، أخبره أن التحديث لا يتطلب مفتاح تفعيل.
+
+## اختم بجملة:
+> هل تريد أن تُحدّث الآن؟ شغّل الأمر أعلاه وأنا سأتحقق من نجاح التحديث.

package/core/project-control/templates/TASK_TEMPLATE.md

@@ -0,0 +1,146 @@
+# TASK-[ID]: [Task Title]
+
+## 1. Task Information
+
+| Field | Value |
+|---|---|
+| **TASK-ID** | TASK- |
+| **Task Type** | Preparation / Coding / Review / Control |
+| **Phase** | |
+| **Build Mode Approved** | Yes / No / N/A (preparation tasks) |
+| **Status** | Draft |
+| **Assigned To** | |
+| **Created** | YYYY-MM-DD |
+| **Linked Plan Item** | PROJECT_DETAILED_EXECUTION_PLAN item / N/A |
+| **Linked Batch** | EXECUTION_BATCH_PLAN batch / N/A |
+| **Active Technology Profile** | Profile name / N/A |
+| **Design Source Decision** | INTERNAL_TERA_KIT / GETDESIGN_MD / FIGMA_DESIGN_FILE / USER_PROVIDED_REFERENCE / EXTERNAL_URL_ANALYSIS / HYBRID / NO_UI / N/A |
+| **UI Acceptance Gate Required** | Yes / No / N/A |
+
+## 2. Objective
+
+_What is the goal of this task?_
+
+## 3. Reference Files
+
+- 
+- 
+
+## 4. Allowed Write Targets
+
+- 
+
+## 5. Forbidden Files / Actions
+
+- 
+
+## 6. Acceptance Criteria
+
+1. 
+2. 
+3. 
+
+## 6.1 Execution Gates
+
+| Gate | Result | Notes |
+|---|---|---|
+| Orchestration Decision Matrix | _Direct / Helper Agent / Multi-Agent / Blocked_ | |
+| Model Capability Gate | _Current model sufficient / Safeguards / Stronger recommended / Stronger required_ | |
+| Pre-Execution Gate | _PASS / NEEDS_REVISION / BLOCKED_ | |
+
+## 6.2 CLI / Tool Side Effects
+
+| Command / Tool | Allowed? | Expected Side Effects | Approval Needed? |
+|---|---|---|---|
+|  | _Yes / No / N/A_ |  | _Yes / No_ |
+
+## 6.3 UI / Frontend Requirements
+
+Required for any UI, Frontend, layout, style, or component task.
+
+| Item | Value |
+|---|---|
+| UI Source | `28_UI_UX_GUIDELINES.md` / DESIGN.md reference / FIGMA_DESIGN_FILE / Internal Kit / No UI |
+| UI Rules | Tokens / Layout / Component Rules / RTL-LTR / Accessibility |
+| UI Acceptance | `tera-system/design-system/UI_ACCEPTANCE_GATE.md` required? Yes / No |
+| Design Gap Handling | Raise Design Gap / Ask Tera / N/A |
+
+## 7. TASK-ID Size Check
+
+```md
+Requested Work:
+Can it fit one TASK-ID? Yes/No
+Reason:
+Proposed Split:
+- TASK-XXXX:
+- TASK-XXXX:
+```
+
+## 8. Sub-Agent Output Review
+
+| Item | Result |
+|---|---|
+| Output is actionable | _Yes / No_ |
+| Files reviewed or modified are listed | _Yes / No_ |
+| Completed work is explicit | _Yes / No_ |
+| Constraints or risks are stated | _Yes / No / N/A_ |
+| Maps to acceptance criteria | _Yes / No_ |
+| Stayed within TASK-ID scope | _Yes / No_ |
+| Acceptance Decision | _Accept / Reject / Needs Fix_ |
+| Rejection Reasons | |
+
+## 9. Execution Report / Agent Handback
+
+```text
+Task ID:
+Agent:
+Status: Done / Blocked / Needs Clarification / Rework Needed
+Files Created:
+Files Modified:
+Commands Run:
+Summary:
+Assumptions:
+Issues or Missing Information:
+Decisions Needed from Tera:
+Recommendation:
+```
+
+## 10. Tera Review
+
+> Use `TERA_RUNTIME_TEMPLATES.md` Section 32 as the official Post-Execution Review template.
+
+| Check | Result | Notes |
+|---|---|---|
+| TASK objective completed? | PASS / FAIL | |
+| Output matches approved scope? | PASS / FAIL | |
+| No files outside Allowed Write Targets? | PASS / FAIL | |
+| No forbidden files created? | PASS / FAIL | |
+| No extra libraries added? | PASS / FAIL | |
+| No secrets or real `.env`? | PASS / FAIL | |
+| Technology Profile respected? | PASS / FAIL | |
+| UI/UX rules respected if UI exists? | PASS / FAIL / N/A | |
+| UI Acceptance Gate passed if UI exists? | PASS / FAIL / N/A | |
+| Acceptance Criteria passed? | PASS / FAIL | |
+| Rollback needed? | Yes / No | |
+
+## 11. Notes
+
+## 12. Post-Execution Review Result
+
+| Item | Status |
+|---|---|
+| Gate Result | _PASS / NEEDS_FIX / BLOCKED_ |
+| Reviewer | |
+| Review Date | |
+| Notes | |
+
+## 13. Final Tera Decision
+
+| Item | Value |
+|---|---|
+| Final Status | Accepted / Needs Fix / Blocked / Rework Needed / Deferred / Cancelled |
+| Registry Updated | Yes / No |
+| Activity Log Updated | Yes / No |
+| Project State Updated | Yes / No / N/A |
+| Issues/Gaps Updated | Yes / No / N/A |
+| Next Action | |