@tera-system/pro 0.1.0

package/LICENSE.md

@@ -0,0 +1,59 @@
+# License
+
+© 2026 Majed Khaireddin — Tera System. All rights reserved.
+
+## النموذج: كود مفتوح + ترخيص مدفوع
+
+هذا الحزمة (`@tera-system/core`) مفتوحة المصدر لكنها **خاضعة لترخيص تجاري**.
+
+### ماذا يعني ذلك عملياً:
+
+| ما هو مسموح | ما هو ممنوع |
+|-------------|-------------|
+| قراءة الكود | إعادة بيع الحزمة كمنتج مستقل |
+| تثبيت الحزمة على مشاريعك | نسخ المحتوى (الوكلاء/الأوامر/الحوكمة) لمنتج منافس |
+| استخدامها في مشاريعك الخاصة | توزيعها دون اتفاق ترخيص |
+| تعديلها لاحتياجاتك | استخدام اسم "Tera" في منتجاتك |
+
+### الحماية:
+
+1. **ترخيص برنامج** — هذا العقد يحدد استخدامك للحزمة
+2. **مفتاح تفعيل** — Ed25519 (تحقق بدون اتصال) — المفتاح الخاص عند المالك فقط
+3. **اشتراك سنوي لكل مشروع** — Pricing model محدد
+
+### للاستخدام الكامل:
+
+- **بدون مفتاح**: تعمل في **وضع تجريبي** (Trial)
+- **مع مفتاح**: تعمل بالكامل (Active/Grace/Expired)
+
+### التفعيل:
+
+```bash
+# توليد رخصة (المالك فقط)
+node scripts/tera-license.mjs gen --tier premium --project <name> --expires 2027-08-18
+
+# تحقق (العميل — بلا اتصال)
+node scripts/tera-license.mjs check --key <key>
+```
+
+### الشروط:
+
+- **المفتاح الخاص** (`production-private-key.pem`) محفوظ عند المالك فقط
+- **المفتاح العام** مدمج في الحزمة (للتحقق)
+- **لا يمكن توليد رخصة** بدون المفتاح الخاص
+- **الاشتراك**: سنوي لكل مشروع — يتجدد تلقائياً
+
+### الإنهاء:
+
+- ينتهي الاشتراك → تنتهي الصلاحيات
+- فترات السماح: 7 أيام بعد انتهاء الاشتراك
+- بعد انتهاء السماح: التحديثات تتوقف
+
+### القانون الحاكم:
+
+هذا الترخيص خاضع لقوانين المملكة الأردنية الهاشمية.
+
+---
+
+> **للتواصل حول الترخيص والأسعار:**
+> teranoo.com@gmail.com

package/MANIFEST.json

@@ -0,0 +1,24 @@
+{
+  "name": "@tera-system/pro",
+  "version": "0.1.0",
+  "description": "Build manifest for the Tera System Pro commercial plugin component.",
+  "compatibleEnvironments": [
+    "opencode"
+  ],
+  "minOpencodeVersion": "1.18.16",
+  "content": {
+    "agents": 20,
+    "commands": 11,
+    "coreFiles": 111,
+    "tools": 7,
+    "projectControlTemplates": 1
+  },
+  "builtAt": "2026-08-21",
+  "sha256": {
+    "agents": "47b8b7ffc92563a66d3566b52f60e8021fbf8a00e1364bcfe1909eb9b9f17975",
+    "commands": "312591ee2d37b5bc11efc659aa58e88b2a5366e1f2f479ab9207c60c4dc9d8f8",
+    "core/tera-system": "55e26d50d797a546ee69327339581f3b2631f24c3c039b8910f1f912e369fe60",
+    "tools": "1f96a2de662c50c5c0a4c62d27ec583671c690163a0b35add036bfdd2b3a1f1a",
+    "core/project-control": "cb979181d50e54c9b9b9173ffc890ca021bfaefe9678b1cad4a2f67ceac3dfdd"
+  }
+}

package/README.md

@@ -0,0 +1,190 @@
+# @tera-system/pro
+
+**Tera System Pro (ط§ظ„ط­ط²ظ…ط© ط§ظ„طھط¬ط§ط±ظٹط©)** — ظ…ظƒظˆظ‘ظ† (Component) ظٹط­ظ…ظ„ ظ…ظ†ط¸ظˆظ…ط© Tera ظƒط§ظ…ظ„ط© + **ظ†ط¸ط§ظ… طھط±ط®ظٹطµ ط¥ظ„ط²ط§ظ…ظٹ** + ظ…ط²ط§ظ…ظ†ط© ظ…ظ† ط§ظ„ط³ظٹط±ظپط± + ط­ظ…ط§ظٹط© ظ…ظ† ط§ظ„طھظ„ط§ط¹ط¨.
+
+> âڑ ï¸ڈ **ظ‡ط°ظ‡ ط§ظ„ط­ط²ظ…ط© ط§ظ„طھط¬ط§ط±ظٹط© طھطھط·ظ„ط¨ ظ…ظپطھط§ط­ طھط±ط®ظٹطµ طµط§ظ„ط­.** ط¨ط¯ظˆظ† ظ…ظپطھط§ط­طŒ ظ„ط§ طھط¹ظ…ظ„ ط§ظ„ظˆظƒظ„ط§ط، ظˆظ„ط§ ط§ظ„ط£ظˆط§ظ…ط±.
+> ظ„ظ„ط­طµظˆظ„ ط¹ظ„ظ‰ ظ…ظپطھط§ط­: `https://teranoo.com/pricing`
+
+## ط§ظ„طھط«ط¨ظٹطھ (ط£ظ…ط± ظˆط§ط­ط¯)
+
+```bash
+npm install @tera-system/pro
+```
+
+ط¹ظ†ط¯ ط§ظ„طھط«ط¨ظٹطھطŒ ظٹط¹ظ…ظ„ ط³ظƒط±ط¨طھ `postinstall` طھظ„ظ‚ط§ط¦ظٹط§ظ‹ ط¹ظ„ظ‰ ظ…ط³ط§ط­ط© ط§ظ„ط¹ظ…ظ„ (ط§ظ„ظ…ط¬ظ„ط¯ ط§ظ„ط°ظٹ ظ†ظڈظپظ‘ط° ظپظٹظ‡ `npm install`).
+
+ظٹظ…ظƒظ† ط¶ط¨ط· ط§ظ„ظˆط¬ظ‡ط© طµط±ط§ط­ط©ظ‹:
+
+```bash
+TERA_TARGET_DIR=/path/to/workspace npm install @tera-system/pro
+# ط£ظˆ ظ…ط¨ط§ط´ط±ط© ظ…ظ† ط§ظ„ظ…طµط¯ط±:
+node scripts/install.js --target /path/to/workspace
+```
+
+## ط§ظ„طھظ†ط´ظٹط· (Activation)
+
+ط¨ط¹ط¯ ط§ظ„طھط«ط¨ظٹطھطŒ ظپط¹ظ‘ظ„ ط§ظ„ظ…ظپطھط§ط­:
+
+```bash
+TERA_LICENSE_KEY=your-key npm run tera-license  # ط£ظˆ
+npm run tera-sync
+```
+
+ط§ظ„طھط­ظ‚ظ‚ ظٹط¹ظ…ظ„ ط¹ط¨ط±: API ط§ظ„ط³ظٹط±ظپط± → fallback ط£ظˆظپظ„ط§ظٹظ† (Ed25519) → ظ†ط¨ط¶ ظ‚ظ„ط¨ ظƒظ„ 3 ط£ظٹط§ظ….
+
+## ظ…ط§ط°ط§ ظٹظڈط«ط¨ظژظ‘طھ ظˆط£ظٹظ†
+
+| ط§ظ„ظ…ط­طھظˆظ‰ | ط§ظ„ظˆط¬ظ‡ط© (ظ†ط³ط¨ط© ط¥ظ„ظ‰ ط¬ط°ط± ظ…ط³ط§ط­ط© ط§ظ„ط¹ظ…ظ„) |
+|---|---|
+| 20 ط¹ظ…ظٹظ„ط§ظ‹ | `.opencode/agents/` |
+| 11 ط£ظˆط§ظ…ط± `tera-*` | `.opencode/commands/` |
+| طھظƒظˆظٹظ† MCP (ظ‚ط§ظ„ط¨) | `.opencode/opencode.json` *(ظپظ‚ط· ط¥ظ† ظ„ظ… ظٹظˆط¬ط¯)* + ظ†ط³ط®ط© ظ…ط±ط¬ط¹ظٹط© `opencode.tera.example.json` ط¯ط§ط¦ظ…ط§ظ‹ |
+| ط§ظ„ظ†ظˆط§ط© ط§ظ„ط­ظˆظƒظ…ظٹط© (110 ظ…ظ„ظپط§ظ‹) | `tera-system/` |
+| ظ‡ظٹظƒظ„ `project-control/` (ظ‚ظˆط§ظ„ط¨) | `project-control/` *(ظپظ‚ط· ط¥ظ† ظ„ظ… ظٹظˆط¬ط¯ — ط­ط§ظ„ط© ط®ط§طµط© ط¨ظƒظ„ ط¹ظ…ظٹظ„)* |
+| ط£ط¯ظˆط§طھ ط§ظ„طھظˆط²ظٹط¹ (7 ط³ظƒط±ط¨طھط§طھ) | `tools/` |
+| ط³ط¬ظ„ ط§ظ„ظ…ظ„ظƒظٹط© | `.opencode/tera-core.manifest.json` |
+
+## ط³ظ„ظˆظƒ ط§ظ„ظ…ط«ط¨ظ‘طھ (ط؛ظٹط± ظ…ط¯ظ…ط± + ظˆط§ط¹ظچ ط¨ط§ظ„ظ…ظ„ظƒظٹط©)
+
+- **ظ„ط§ ظٹط­ط°ظپ ط£ظٹ ط´ظٹط، ط£ط¨ط¯ط§ظ‹.**
+- **ظ„ط§ ظٹظƒطھط¨ ظپظˆظ‚ ط£ظٹ ظ…ظ„ظپ ط؛ظٹط± ظ…ظ…ظ„ظˆظƒ ظ„ظ‡:** ط£ظٹ ظ…ظ„ظپ ظ…ظˆط¬ظˆط¯ ط¨ط§ط³ظ… ظٹطھط¹ط§ط±ط¶ ظ…ط¹ ط­ط²ظ…ط© `@tera-system/pro` (ظˆظ„ظ… طھط«ط¨ظ‘طھظ‡ ط§ظ„ط­ط²ظ…ط© ط³ط§ط¨ظ‚ط§ظ‹) ظٹظڈطھط±ظƒ ظƒظ…ط§ ظ‡ظˆ ظˆظٹظڈط³ط¬ظژظ‘ظ„ ظƒظ€ `CONFLICT` ظپظٹ طھظ‚ط±ظٹط± ط§ظ„طھط±ظƒظٹط¨.
+- **ظٹظپط±ظ‘ظ‚ ط¨ظٹظ† ظ…ظ„ظپط§طھظ‡ ظˆظ…ظ„ظپط§طھ ط§ظ„ظ…ط³طھط®ط¯ظ…** ط¹ط¨ط± ط³ط¬ظ„ ط§ظ„ظ…ظ„ظƒظٹط© `.opencode/tera-core.manifest.json`.
+- **ط§ظ„ظ…ظ„ظپط§طھ ط§ظ„ظ…ظ…ظ„ظˆظƒط© ظ„ظ„ط­ط²ظ…ط© ظپظ‚ط·** طھظڈط­ط¯ظژظ‘ط« ط¹ظ†ط¯ ط§ط®طھظ„ط§ظپظ‡ط§طŒ ظ…ط¹ **ظ†ط³ط®ط© ط§ط­طھظٹط§ط·ظٹط©** (`*.tera-bak-<ts>`) ظ‚ط¨ظ„ ط£ظٹ طھط­ط¯ظٹط«.
+- **ط¥ط¹ط§ط¯ط© ط§ظ„طھط´ط؛ظٹظ„ ط¢ظ…ظ†ط© (idempotent):** ط§ظ„ظ…ظ„ظپط§طھ ط§ظ„ظ…طھط·ط§ط¨ظ‚ط© طھظڈطھط®ط·ظ‘ظ‰.
+- `opencode.json` ط§ظ„ظ…ظˆط¬ظˆط¯ ظ„ط¯ظ‰ ط§ظ„ظ…ط³طھط®ط¯ظ… **ظ„ط§ ظٹظڈظ„ظ…ط³ ط£ط¨ط¯ط§ظ‹** — طھظڈظˆط¶ط¹ ظ†ط³ط®ط© ظ…ط±ط¬ط¹ظٹط© ظپظ‚ط· ظˆطھط¸ظ‡ط± ط§ظ„طھط¹ظ„ظٹظ…ط§طھ ظپظٹ ط§ظ„طھظ‚ط±ظٹط±.
+
+## ط¥ظ„ط؛ط§ط، ط§ظ„طھط«ط¨ظٹطھ (ظٹط¯ظˆظٹ — ط؛ظٹط± ظ…ط¯ظ…ط±)
+
+1. ط§ط­ط°ظپ ط§ظ„ظ…ظ„ظپط§طھ ط§ظ„ظ…ط³ط¬ظ‘ظ„ط© ظپظٹ `.opencode/tera-core.manifest.json` (`files`).
+2. ط§ط­ط°ظپ `.opencode/tera-core.manifest.json` ظ†ظپط³ظ‡.
+3. ط§ط­طھظپط¸ ط¨ط£ظٹ `*.tera-bak-*` ط£ظˆ ظ…ظ„ظپط§طھظƒ ط§ظ„ط´ط®طµظٹط© ظƒظ…ط§ ظ‡ظٹ.
+
+## ط§ظ„طھط­ظ‚ظ‚ ظ…ظ† ط§ظ„ظ†ط²ط§ظ‡ط©
+
+طھط¬ط²ظٹط¦ط§طھ SHA256 ظ„ظƒظ„ ظ…ط¬ظ…ظˆط¹ط© ظ…ط­طھظˆظ‰ ظپظٹ `MANIFEST.json` (agents / commands / core/tera-system / tools / project-control).
+
+---
+
+## ط§ظ„طھط±ط®ظٹطµ ظˆط§ظ„طھظپط¹ظٹظ„
+
+### ط§ظ„ظ†ظ…ظˆط°ط¬: ظƒظˆط¯ ظ…ظپطھظˆط­ + طھط±ط®ظٹطµ ظ…ط¯ظپظˆط¹
+
+| ظ…ط§ ظ‡ظˆ ظ…ط³ظ…ظˆط­ | ظ…ط§ ظ‡ظˆ ظ…ظ…ظ†ظˆط¹ |
+|-------------|-------------|
+| ظ‚ط±ط§ط،ط© ط§ظ„ظƒظˆط¯ | ط¥ط¹ط§ط¯ط© ط¨ظٹط¹ ط§ظ„ط­ط²ظ…ط© ظƒظ…ظ†طھط¬ ظ…ط³طھظ‚ظ„ |
+| طھط«ط¨ظٹطھ ط§ظ„ط­ط²ظ…ط© ط¹ظ„ظ‰ ظ…ط´ط§ط±ظٹط¹ظƒ | ظ†ط³ط® ط§ظ„ظ…ط­طھظˆظ‰ ظ„ظ…ظ†طھط¬ ظ…ظ†ط§ظپط³ |
+| ط§ط³طھط®ط¯ط§ظ…ظ‡ط§ ظپظٹ ظ…ط´ط§ط±ظٹط¹ظƒ | طھظˆط²ظٹط¹ظ‡ط§ ط¯ظˆظ† ط§طھظپط§ظ‚ طھط±ط®ظٹطµ |
+
+---
+
+## ظƒظٹظپظٹط© طھظپط¹ظٹظ„ ط§ظ„ط±ط®طµط© (ظ„ظ„ط¹ظ…ظ„ط§ط،)
+
+### ط§ظ„ط®ط·ظˆط© 1: ط§ظ„طھط«ط¨ظٹطھ
+
+```bash
+npm install @tera-system/pro
+```
+
+ط¹ظ†ط¯ ط§ظ„طھط«ط¨ظٹطھ ط§ظ„ط£ظˆظ„طŒ طھط¹ظ…ظ„ ط§ظ„ط­ط²ظ…ط© ظپظٹ **ظˆط¶ط¹ طھط¬ط±ظٹط¨ظٹ** (Trial). ظٹظ…ظƒظ†ظƒ ط§ط³طھط®ط¯ط§ظ…ظ‡ط§ ظ„ظƒظ† ط¨ط¹ط¶ ط§ظ„ظ…ظٹط²ط§طھ ظ‚ط¯ طھظƒظˆظ† ظ…ط­ط¯ظˆط¯ط©.
+
+### ط§ظ„ط®ط·ظˆط© 2: ط´ط±ط§ط، ط§ظ„ط±ط®طµط©
+
+طھظˆط§طµظ„ ظ…ط¹ظ†ط§ ظ„ظ„ط­طµظˆظ„ ط¹ظ„ظ‰ ظ…ظپطھط§ط­ ط§ظ„طھظپط¹ظٹظ„:
+
+> **ط§ظ„ط¨ط±ظٹط¯:** teranoo.com@gmail.com
+
+ط³ظ†ط±ط³ظ„ ظ„ظƒ ظ…ظپطھط§ط­ط§ظ‹ ظپط±ظٹط¯ط§ظ‹ ظٹط­طھظˆظٹ ط¹ظ„ظ‰:
+- **ط§ظ„ظ…ط³طھظˆظ‰** (Basic / Premium)
+- **ط§ط³ظ… ط§ظ„ظ…ط´ط±ظˆط¹**
+- **طھط§ط±ظٹط® ط§ظ„ط§ظ†طھظ‡ط§ط،**
+- **ط¹ط¯ط¯ ط§ظ„ظ…ظ‚ط§ط¹ط¯**
+
+### ط§ظ„ط®ط·ظˆط© 3: طھظپط¹ظٹظ„ ط§ظ„ظ…ظپطھط§ط­
+
+#### ط§ظ„ط·ط±ظٹظ‚ط© 1: ط¹ط¨ط± ظ…طھط؛ظٹط± ط§ظ„ط¨ظٹط¦ط© (ظ…ظڈظˆطµظ‰ ط¨ظ‡)
+
+```bash
+# Windows PowerShell
+$env:TERA_LICENSE_KEY = "ط§ظ„ظ…ظپطھط§ط­_ط§ظ„ط°ظٹ_طھظ„ظ‚ظٹظ†ط§ظ‡"
+
+# ط«ظ… ط£ط¹ط¯ ط§ظ„طھط«ط¨ظٹطھ
+npm install @tera-system/pro
+```
+
+#### ط§ظ„ط·ط±ظٹظ‚ط© 2: ط¹ط¨ط± ظ…ظ„ظپ ط¥ط¹ط¯ط§ط¯ط§طھ
+
+ط£ظ†ط´ط¦ ظ…ظ„ظپ `.tera/license.json` ظپظٹ ط¬ط°ط± ظ…ط´ط±ظˆط¹ظƒ:
+
+```json
+{
+  "licenseKey": "ط§ظ„ظ…ظپطھط§ط­_ط§ظ„ط°ظٹ_طھظ„ظ‚ظٹظ†ط§ظ‡"
+}
+```
+
+ط«ظ… ط´ط؛ظ‘ظ„:
+
+```bash
+node scripts/tera-license.mjs check --key "ط§ظ„ظ…ظپطھط§ط­_ط§ظ„ط°ظٹ_طھظ„ظ‚ظٹظ†ط§ظ‡"
+```
+
+### ط§ظ„ط®ط·ظˆط© 4: ط§ظ„طھط­ظ‚ظ‚
+
+```bash
+# طھط­ظ‚ظ‚ ظ…ظ† ط­ط§ظ„ط© ط§ظ„ط±ط®طµط©
+node scripts/tera-license.mjs check --key "ط§ظ„ظ…ظپطھط§ط­_ط§ظ„ط°ظٹ_طھظ„ظ‚ظٹظ†ط§ظ‡"
+```
+
+**ط§ظ„ظ†طھظٹط¬ط© ط§ظ„ظ…طھظˆظ‚ط¹ط©:**
+
+```json
+{
+  "state": "Active",
+  "reason": "valid",
+  "payload": {
+    "tier": "premium",
+    "project": "ط§ط³ظ…_ظ…ط´ط±ظˆط¹ظƒ",
+    "expiresAt": "2027-08-21T00:00:00.000Z"
+  }
+}
+```
+
+---
+
+## ط­ط§ظ„ط§طھ ط§ظ„ط±ط®طµط©
+
+| ط§ظ„ط­ط§ظ„ط© | ط§ظ„ظ…ط¹ظ†ظ‰ | ظ…ط§ط°ط§ ظٹط­ط¯ط« |
+|--------|--------|-----------|
+| `Active` | ط±ط®طµط© طµط§ظ„ط­ط© | ظٹط¹ظ…ظ„ ط¨ط§ظ„ظƒط§ظ…ظ„ ✅ |
+| `Grace` | ظ…ظ†طھظ‡ظٹط© (ط¶ظ…ظ† 7 ط£ظٹط§ظ…) | ظٹط¹ظ…ظ„ ظ…ط¹ طھط­ط°ظٹط± âڑ ï¸ڈ |
+| `Expired` | ظ…ظ†طھظ‡ظٹط© (ط®ط§ط±ط¬ ط§ظ„ط³ظ…ط§ط­) | ظٹطھظˆظ‚ظپ ط¹ظ† ط§ظ„ط¹ظ…ظ„ â‌Œ |
+| `Invalid` | ظ…ظپطھط§ط­ ط®ط§ط·ط¦ | ظ„ط§ ظٹط¹ظ…ظ„ â‌Œ |
+| `Unlicensed` | ط¨ط¯ظˆظ† ظ…ظپطھط§ط­ | ظˆط¶ط¹ طھط¬ط±ظٹط¨ظٹ ًں”“ |
+
+---
+
+## طھط­ط¯ظٹط« ط§ظ„ط±ط®طµط©
+
+### ظ„ظ„ط­طµظˆظ„ ط¹ظ„ظ‰ ط¥طµط¯ط§ط± ط£ط­ط¯ط«:
+
+```bash
+npm install @tera-system/pro@latest
+```
+
+### ظ„طھط¬ط¯ظٹط¯ ط§ظ„ط§ط´طھط±ط§ظƒ:
+
+طھظˆط§طµظ„ ظ…ط¹ظ†ط§ ظ‚ط¨ظ„ ط§ظ†طھظ‡ط§ط، ط§ظ„ط±ط®طµط© ظˆط³ظ†ط±ط³ظ„ ظ…ظپطھط§ط­ط§ظ‹ ط¬ط¯ظٹط¯ط§ظ‹.
+
+---
+
+## ط§ظ„ط¯ط¹ظ…
+
+- **ط§ظ„ظˆط«ط§ط¦ظ‚**: `tera-system/TERA_USER_GUIDE.md`
+- **ط§ظ„ط£ظˆط§ظ…ط±**: `tera-help`
+- **ط§ظ„ظ…ط´ظƒظ„ط§طھ**: `tera-diagnose`
+- **ط§ظ„طھط­ط¯ظٹط«ط§طھ**: `tera-update`
+
+---
+
+> **ظ„ظ„طھظˆط§طµظ„ ط­ظˆظ„ ط§ظ„طھط±ط®ظٹطµ ظˆط§ظ„ط£ط³ط¹ط§ط±:**
+> teranoo.com@gmail.com
+

package/RELEASES.md

@@ -0,0 +1,44 @@
+# @tera-system/pro — سجل الإصدارات (Releases)
+
+> **الحزمة التجارية** — تحوي نظام ترخيص إلزامي + مزامنة من السيرفر.
+
+---
+
+## 0.1.0 (2026-08-22)
+
+### الإصدار التجاري الأول — الحماية الكاملة
+
+**ما تم تضمينه:**
+- **بوابة ترخيص إلزامية** في كل وكيل (20) وكل أمر (11) — لا عمل بدون مفتاح صالح
+- **`TERA_LICENSE_GUARD.md`** — قاعدة أولوية مطلقة تمنع أي استجابة بدون ترخيص
+- **كشف التلاعب** (`integrity.mjs`) — أي تعديل على الملفات → تعطيل فوري
+- **حماية الملفات الحرجة** (`license-gate.mjs`) — تعديل البوابة نفسها → تعطيل
+- **مزامنة من السيرفر** (`tera-sync`) — تنزيل الحزمة الموقعة والتحقق من التوقيع
+- **توقيع الحزمة** (Ed25519) — الحزمة موقّعة بمفتاح الإنتاج، لا يمكن انتحالها
+- **نبض القلب** (`tera-heartbeat`) — تحقق من السيرفر كل 3 أيام + كشف الإلغاءات
+- **شفاء ذاتي** — عند التلاعب، يعيد sync الملفات الأصلية من السيرفر
+- **Mock Server** (`scripts/dev/mock-server.mjs`) — اختبار محلي بدون موقع
+
+**المتغيرات البيئية:**
+| المتغير | الوصف | الافتراضي |
+|---------|-------|-----------|
+| `TERA_LICENSE_API` | رابط API الترخيص | `https://teranoo.com/api/license` |
+| `TERA_SYNC_URL` | رابط الحزمة الموقعة | `https://teranoo.com/api/tera-system/bundle` |
+| `TERA_LICENSE_KEY` | مفتاح الترخيص | — |
+| `TERA_OFFLINE_ONLY` | تعطيل التحقق الأونلاين | `0` |
+
+**الأوامر:**
+```bash
+npm run tera-license    # إصدار/فحص مفتاح
+npm run tera-sync       # مزامنة من السيرفر
+npm run tera-heartbeat  # نبض القلب (3 أيام)
+npm run tera-preflight  # فحص البوابة
+npm run tera-bundle     # بناء الحزمة الموقعة
+```
+
+**ملاحظات:**
+- النسخة الحالية "سميكة" — تحوي الملفات + الحماية
+- عند جاهزية الموقع: نسخة "رقيقة" تُحذف منها الملفات الأساسية ويُجلب كل شيء من السيرفر
+- مفتاح الإنتاج الخاص لا يُشحن — فقط المفتاح العام للتحقق
+
+---

package/WELCOME.md

@@ -0,0 +1,35 @@
+# أول 5 دقائق — ابدأ دون أن تغرق
+
+> هذا هو دليلك الوحيد للبدء. **لا تفتح أي مجلد آخر ولا تقرأ أي ملفات داخل** `tera-system/` أو `project-control/` أو `tools/` — فهي تعمل في الخلفية ولا تحتاجها.
+
+## ما ستراه بعد التثبيت (ولا تحتاج للاهتمام به)
+- مجلدات كثيرة (`tera-system`, `project-control`, `tools`) — **تجاهلها**. هي وقود النظام، لا جزء من عملك.
+- أوامر كثيرة تبدأ بـ `tera-` — ستحتاج فعلياً 4 منها فقط.
+
+## المهمة الوحيدة الآن
+افتح هذا المجلد في **OpenCode Desktop**، وفي نافذة المحادثة اكتب:
+
+```
+/tera-help
+```
+
+ثم اتبع الترتيب التالي — ولا تفعل شيئاً آخر:
+
+| الخطوة | الأمر | ماذا يحدث |
+|---|---|---|
+| 1 | `/tera-new-project` | يسألك عن فكرتك (أجب ببساطة) |
+| 2 | `/tera-plan` | ينتج خطة منظمة (راجعها ووافق عليها) |
+| 3 | (اتبع التوجيه) | وكلاء متخصصون ينفّذون — **أنت توافق فقط** |
+| 4 | `/tera-review` | مراجعة الجودة للنتيجة |
+
+## ثلاث قواعد ذهبية للمستخدم الجديد
+1. **لا تقرأ الملفات الداخلية** — أجب عن أسئلة النظام فقط.
+2. **لا تختار الوكيل** — النظام يوجّه المتخصص المناسب تلقائياً.
+3. **لا تتجاوز الموافقات** — كل خطوة يُطلب موافقتك؛ وافق أو اطلب تعديلاً.
+
+## ماذا لو توقفت أو حارت؟
+اكتب `/tera-status` (أين أنت) أو `/tera-diagnose` (فحص ذاتي) — أو سلّم النظام جملة بالعربية تصف مقصدك وسيقودك.
+
+---
+
+**خلاصة:** أنت لست بحاجة لفهم بنية Tera. شغّل الأوامر الأربعة، وافق، وراجع. هذا كل شيء.