@tera-system/core 0.3.0 → 0.3.1

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.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "Build manifest for the Tera System OpenCode Plugin component.",
5
5
  "compatibleEnvironments": [
6
6
  "opencode"
@@ -17,7 +17,7 @@
17
17
  "sha256": {
18
18
  "agents": "5d8ba0df7c8de48ff66e2d905fbef9b6fe25414af14faded3cbfd94bec611c26",
19
19
  "commands": "6298a28e323c5d9d38aaef99582b43e54c4b00ad5b1421231ec2d6e712f972e2",
20
- "core/tera-system": "9baedeacb4f9e1f425f272cf65891feeeb10e56a1dc97497550b80b616e53e2e",
20
+ "core/tera-system": "eb0b703304e7a1556736048a96492ae5352b0078ea68d3d1dc1b951bf2e4a73a",
21
21
  "tools": "cea993304a3664ceac13685fbfd0bb0e51936236661689fa1fe603a14537ce5e",
22
22
  "core/project-control": "cb979181d50e54c9b9b9173ffc890ca021bfaefe9678b1cad4a2f67ceac3dfdd",
23
23
  "assets": "307e660c8156ceda8da5e53460d3f5c82a91c04085dddb648494da57bf8f2072"
@@ -50,6 +50,7 @@ If the stack is still unclear, do not activate a final profile yet.
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
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) |
53
+ | `bun-ts-monorepo-sqlite` | TypeScript + Bun 1.3.14 + Turbo monorepo + SQLite | **Draft — Needs Verification** | منتج مستقل (APP-TERA_CODE) فوق Baseline موروث — CLI/TUI + Web محلي (127.0.0.1) + Desktop Shell؛ الحقول غير المتحققة موسومة `[Needs Verification — Phase A]`؛ الترقية لـ Available بعد Baseline Comprehension + تجربة تحقق (SCP-2026-09-18-001) |
53
54
 
54
55
  ## Placeholder Candidates
55
56
 
@@ -0,0 +1,164 @@
1
+ # Technology Profile: bun-ts-monorepo-sqlite
2
+
3
+ > **Status: Draft — Needs Verification** (SCP-2026-09-18-001)
4
+ > أُنشئ لمشروع **APP-TERA_CODE** (منتج مستقل — وكيل برمجة AI ذو حوكمة) — معتمد من Majed، بطلب من ApplicationBlueprintAgent (مُهندس).
5
+ > مبني على **قرارات المشروع المعتمدة + بيئة تحقق مؤكدة** فقط (`bun --version` = 1.3.14، `node --version` = v22.22.2 `[Verified]`).
6
+ > **لم يُتحقق ميدانياً من المستودع الموروث بعد.** كل حقل غير مؤكد موسوم `[Needs Verification — Phase A]` ويُستخرج عبر **Baseline Comprehension** المعتمدة في المشروع — **لا يُقدَّر ولا يُخمَّن**. ترقية الحالة إلى `Available` بعد تجربة تحقق فعلية (انظر §10).
7
+
8
+ ## 1. Profile Identity
9
+
10
+ - Profile ID: `bun-ts-monorepo-sqlite`
11
+ - Language: TypeScript
12
+ - Framework: Turbo monorepo (Baseline موروث) + Provider Adapter Layer (OpenAI / Anthropic / مزود ثانٍ / Ollama) + Web محلي (bind `127.0.0.1` فقط) + Desktop Shell (Unsigned)
13
+ - Database: SQLite (محرك موروث)
14
+ - ORM: `[Needs Verification — Phase A]` — طبقة الوصول للبيانات مصمَّمة **منخفضة الاقتران (decoupled)**؛ الـ ORM/طبقة الاستعلام الفعلية غير متحققة
15
+ - Package Manager / CLI: **Bun 1.3.14** `[Verified: bun --version]` + Node **v22.22.2** `[Verified: node --version]`
16
+ - Default Project Type: TypeScript monorepo — CLI/TUI + Web محلي + Desktop Shell (منتج حوكمي مستقل فوق Baseline موروث)
17
+
18
+ ## 2. Applicability
19
+
20
+ يُستخدم هذا البروفايل عندما:
21
+
22
+ - المشروع TypeScript monorepo يُدار بـ **Bun** وبناءً على **Turbo**.
23
+ - التخزين **SQLite** (محرك موروث أو جديد).
24
+ - الواجهات متعددة: CLI/TUI + Web محلي (loopback فقط) + Desktop Shell.
25
+ - العمل يجري **داخل مستودع موروث كبير** يستلزم استيعاباً انتقائياً لا Pull/Merge.
26
+ - منتج حوكمي/وكيل ذو طبقة مزوّدين (Provider Adapter) لا تطبيق CRUD.
27
+
28
+ **لا يُستخدم:** لتطبيقات ويب خضراء (استخدم `nextjs-prisma`) · ألعاب (استخدم `phaser-react-node`) · .NET (استخدم بروفايلات .NET) · مشاريع لا تحتوي monorepo أو SQLite.
29
+
30
+ **لا يُستخدم كبديل للبروفايل الملغى:** `effect-bun-opencode` ملغى (2026-08-15) ومحتواه مرجع معرفي فقط.
31
+
32
+ ## 3. Default Execution Order
33
+
34
+ ```text
35
+ 0. Baseline Comprehension (إلزامي — انظر §4): خريطة المستودع + استخراج الحقائق غير المتحققة
36
+ 1. أثبت الـ toolchain: bun --version + node --version (يطابقان 1.3.14 / v22.22.2)
37
+ 2. حدّد الـ package الحدودي الأصغر (أقرب نقطة تكامل) — بلا لمس Core الموروث
38
+ 3. types / schemas / contracts قبل السلوك التشغيلي
39
+ 4. أدنى مسار تشغيلي يحقق المهمة — مع إبقاء طبقة التخزين خلف واجهة منخفضة الاقتران
40
+ 5. إن لزم تعديل Core الموروث → CORE-PATCH مسجل فقط (سجل + سبب + قابلية إزالة)
41
+ 6. طبقة البيانات عند الحاجة فقط: SQLite + migration approach الموروث (جدول/جداول `tera_*` معزولة بملكية schema)
42
+ 7. تحقق محلي على نطاق الـ package (typecheck / test / build) — بالأوامر المستخرجة لا المفترضة
43
+ 8. تقرير: ملفات متغيرة + أوامر فعلية + نتائج تحقق
44
+ ```
45
+
46
+ ## 4. First Task Rule
47
+
48
+ أول مهمة تنفيذية لأي مشروع على هذا البروفايل: **Baseline Comprehension — لا كود منطقي قبلها.**
49
+
50
+ ```text
51
+ 1. أثبت الـ toolchain: bun --version && node --version (بلا افتراض)
52
+ 2. ابنِ خريطة المستودع: workspaces + turbo.json + حدود الـ packages
53
+ 3. استخرج وسجّل صراحةً (لا تقدير):
54
+ - أوامر build / test / typecheck الحقيقية
55
+ - Protected Paths + أسطح Plugin/SDK
56
+ - طبقة الوصول للبيانات / ORM الفعلية
57
+ - إطار الـ Desktop Shell
58
+ - إصدارات الحزم المقفلة (lockfile checksum)
59
+ 4. شغّل تحققاً ضيقاً واحداً (typecheck أو build لـ package واحد) — بالأمر المستخرج
60
+ 5. أي خطوة فشلت → STOP. لا تبنِ فوق Baseline غير متحقق. وثّق السبب في الـ handback.
61
+ ```
62
+
63
+ **لا تُعبّأ الحقول غير المتحققة تقديراً في أي مرحلة.**
64
+
65
+ ## 5. Scaffold Rules
66
+
67
+ - **ممنوع** إنشاء تطبيق جديد (`bun init` / `bun create`) — المستودع موروث.
68
+ - **ممنوع** إضافة framework جديد.
69
+ - **ممنوع** إضافة تبعية runtime جديدة دون حاجة مؤكدة وموافقة صريحة.
70
+ - **ممنوع** إنشاء package جديد في الـ monorepo دون موافقة.
71
+ - فضّل أنماط المستودع القائمة (modules / exports / schemas / registration).
72
+ - أبقِ الملفات قريبة من حدود الـ package المعني.
73
+ - **ممنوع Pull/Merge من upstream** — استيعاب انتقائي فقط (`ADOPT` / `REIMPLEMENT` / `REJECT`) موثّق لكل عنصر.
74
+
75
+ ## 6. ORM / Database Rules
76
+
77
+ - **المحرك:** SQLite — إعادة استخدام بنية الـ infra والـ migration approach الموروثة. `[Needs Verification — Phase A: أداة الترحيل الفعلية]`
78
+ - **عزل الجداول:** جداول `tera_*` معزولة بملكية schema واضحة — لا خلط مع جداول المستودع الموروث.
79
+ - **الاقتران المنخفض:** الوصول للبيانات خلف واجهة (interface/repository) — لا استعلامات موزعة في UI/CLI.
80
+ - **Parameterized queries إلزامي** — ممنوع string interpolation في SQL (SQL Injection — OWASP).
81
+ - **⛔ ممنوع تحويل قواعد إدارة الحالة / قواعد العمل إلى قيود قاعدة بيانات** (لا `CHECK`/`trigger` لتشفير state machines أو قواعد العمل) — تُنفَّذ في طبقة التطبيق.
82
+ - **أي migration أو تغيير schema = بوابة موافقة صريحة** (مثل سياسة migrations في المنظومة).
83
+ - النسخ الاحتياطي و WAL والاستبقاء: `[Needs Verification — Phase A]`.
84
+
85
+ ## 7. CLI Side Effects
86
+
87
+ | الأمر | الأثر | بوابة؟ |
88
+ |-------|-------|--------|
89
+ | `bun --version` / `node --version` | قراءة فقط | لا |
90
+ | `bun install` | يثبّت تبعيات + يكتب lockfile | نعم (تغيير تبعيات) |
91
+ | `bun run <script>` | حسب السكربت (قد يبني/يشغّل/يختبر) | حسب الأثر |
92
+ | `bun test` | يشغّل الاختبارات | لا |
93
+ | `bunx <pkg>` | يشغّل حزمة مؤقتة — **قناة خارجية** | نعم (ضمن Allowlist فقط) |
94
+ | `bun build` | ينتج مخرجات بناء | لا |
95
+ | `bun run migrate` (الاسم الفعلي غير متحقق) | **يغيّر قاعدة البيانات** | **نعم — صريحة** |
96
+ | تشغيل خادم Web محلي | يجب أن يبقى على `127.0.0.1` | نعم إن خرج عن loopback |
97
+ | `git pull` / `git merge` من upstream | **ممنوع منعاً مطلقاً** | ممنوع |
98
+
99
+ **القاعدة:** أي أمر يغيّر قاعدة بيانات، أو ينفّذ كوداً من مصدر خارجي، أو يفتح منفذاً خارج loopback = بوابة موافقة.
100
+
101
+ ## 8. Forbidden Defaults
102
+
103
+ ```text
104
+ ❌ Pull/Merge من upstream — استيعاب انتقائي فقط (ADOPT / REIMPLEMENT / REJECT)
105
+ ❌ تعديل Core الموروث خارج CORE-PATCH مسجل (سجل + سبب + قابلية إزالة)
106
+ ❌ أي outbound غير معروف — blocked افتراضياً؛ Allowlist صريح فقط
107
+ ❌ auto-update · telemetry · أي قناة قياس/إحصاء صامتة
108
+ ❌ أسرار plaintext في الكود/الملفات — Env vars أو تخزين آمن بالنظام + Redaction في السجلات
109
+ ❌ ترميز قواعد العمل/الحالة كقيود قاعدة بيانات (CHECK/trigger)
110
+ ❌ String interpolation في SQL — parameterized فقط
111
+ ❌ فتح خادم Web على غير 127.0.0.1 دون موافقة صريحة
112
+ ❌ إضافة تبعية runtime / framework / package جديد بلا موافقة
113
+ ❌ تجاوز ميزانية صيانة upstream (> 25% من وقت المشروع)
114
+ ❌ تعبئة حقل `[Needs Verification — Phase A]` بتقدير أو اختراع
115
+ ❌ رفع حالة البروفايل إلى Available قبل تحقق فعلي
116
+ ❌ واجهة عربية-أولاً — English-first إلزامي، والعربية جاهزية لا أساس
117
+ ```
118
+
119
+ ## 9. Pre-Execution Gate Additions
120
+
121
+ إضافات هذا البروفايل على `TeraPreExecutionGate.md`:
122
+
123
+ | # | الفحص قبل التنفيذ |
124
+ |---|-------------------|
125
+ | 1 | `bun --version` = 1.3.14 و `node --version` = v22.22.2 (أو انحراف موثّق بموافقة)؟ إن لا → STOP |
126
+ | 2 | هل Baseline Comprehension مكتملة والحقول غير المتحققة مستخرجة (لا مقدّرة)؟ |
127
+ | 3 | هل نطاق المهمة داخل package unit محدد — بلا لمس Core موروث؟ |
128
+ | 4 | إن لمس Core: هل يوجد CORE-PATCH مسجل (سبب + قابلية إزالة)؟ |
129
+ | 5 | هل كل outbound مخطط داخل Allowlist صريح (Provider Adapter / update / telemetry)؟ |
130
+ | 6 | هل الأسرار من Env/OS-secure؟ وهل Redaction مُعدّ للسجلات؟ |
131
+ | 7 | هل المهمة تلمس schema/migrations؟ إن نعم → موافقة صريحة + عدم ترميز قواعد عمل في DB |
132
+ | 8 | هل خادم الـ Web مقيّد بـ 127.0.0.1؟ |
133
+ | 9 | هل الأوامر المستخدمة هي المستخرجة فعلاً (لا مفترضة)؟ |
134
+ | 10 | إن ظهرت حاجة لتقنية جديدة/مزوّد جديد → STOP واطلب قرار Majed |
135
+
136
+ ## 10. Acceptance Criteria Patterns
137
+
138
+ ```text
139
+ ✅ typecheck يمر بالأمر المستخرج من المستودع (لا المفترض)
140
+ ✅ اختبارات الـ package المعني تمر (نطاق package — لا repo-wide بلا سبب)
141
+ ✅ build ينجح إن كان للمهمة مخرج بناء
142
+ ✅ لا تعديل على Core الموروث خارج CORE-PATCH مسجل
143
+ ✅ صفر Pull/Merge من upstream + كل استيعاب موثّق ADOPT/REIMPLEMENT/REJECT
144
+ ✅ صفر outbound خارج Allowlist · صفر telemetry · صفر auto-update
145
+ ✅ صفر أسرار plaintext + Redaction فعّال في مخرجات السجل
146
+ ✅ صفر قواعد عمل/حالة مشفّرة كقيود قاعدة بيانات
147
+ ✅ SQL parameterized فقط + migrations قابلة للتراجع
148
+ ✅ استمرارية الواجهة: English-first + جاهزية عربية (RTL) لا تتضرر
149
+ ✅ تقرير التسليم: ملفات متغيرة + أوامر فعلية + نتائج تحقق + أي حقل ما زال [Needs Verification]
150
+ ```
151
+
152
+ ### مسار الترقية إلى Available (خطوات التحقق المتبقية — Phase A)
153
+
154
+ ```text
155
+ 1. إكمال Baseline Comprehension واستخراج الحقول الستة غير المتحققة (أوامر/ORM/Protected Paths/Shell/lockfile)
156
+ 2. تجربة تحقق فعلية واحدة: typecheck + test + build لـ package حقيقي → PASS
157
+ 3. تحديث هذا الملف: تعبئة الحقول الموسومة + رفع §1 Status من Draft → Available
158
+ 4. تحديث الحالة في PROFILES_INDEX + TeraCapabilityMap (نفس نمط rust)
159
+ 5. موافقة Majed على الترقية
160
+ ```
161
+
162
+ ---
163
+
164
+ *أُنشئ: TeraSystemEvolutionAgent (حارس) — 2026-09-18 · SCP-2026-09-18-001 · مبني على قرارات مشروع APP-TERA_CODE المعتمدة + بيئة تحقق مؤكدة · **Draft حتى Baseline Comprehension وتجربة تحقق فعلية**.*
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tera-system/core",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "Tera System OpenCode Plugin — governance core, 23 agents, 11 commands, distribution tools (personal edition)",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "type": "module",
@@ -1,243 +0,0 @@
1
- # OpenHands — مرجع معماري للدراسة المستقبلية
2
-
3
- > **أنشئ:** 2026-07-26
4
- > **المصدر:** https://github.com/OpenHands/OpenHands (82.2k★)
5
- > **الغرض:** ملف مرجعي لدراسة OpenHands لاحقاً وتطبيق مفاهيمه على Tera
6
- > **حالة الدراسة:** ⏳ لم تبدأ بعد — أنشئ للرجوع إليه
7
-
8
- ---
9
-
10
- ## 1. ما هو OpenHands؟
11
-
12
- منصة **مفتوحة المصدر** لتشغيل وإدارة العملاء البرمجيين (Coding Agents) على نطاق واسع.
13
- ليست مجرد IDE أو CLI — بل **نظام تشغيل كامل للعملاء**.
14
-
15
- ### الإحصائيات
16
- - ⭐ 82.2k★
17
- - 🍴 10.5k Fork
18
- - 📝 7,082 Commit
19
- - 📜 Apache 2.0 License
20
-
21
- ---
22
-
23
- ## 2. المكونات المعمارية الأساسية
24
-
25
- ```
26
- ┌────────────────────────────────────────────────────────────┐
27
- │ OpenHands System │
28
- ├────────────────────────────────────────────────────────────┤
29
- │ │
30
- │ ┌───────────────────────┐ │
31
- │ │ Agent Canvas │ ← واجهة تحكم Frontend (UI) │
32
- │ │ @openhands/agent- │ تبوك: localhost:8000 │
33
- │ │ canvas │ تشغيل محلي أو سحابي │
34
- │ └──────────┬────────────┘ │
35
- │ │ HTTP/REST │
36
- │ ┌──────────▼────────────┐ │
37
- │ │ Agent Server │ ← REST API لتشغيل العملاء │
38
- │ │ (software-agent-sdk) │ • يشغّل عدة عملاء على Server │
39
- │ │ │ • يمكن تشغيل Servers متعددة │
40
- │ └──────────┬────────────┘ • Local / Docker / VM / Cloud│
41
- │ │ │
42
- │ ┌──────────▼────────────┐ │
43
- │ │ Automation Server │ ← تشغيل مجدول + أحداث │
44
- │ │ (github.com/ │ • Cron jobs │
45
- │ │ OpenHands/ │ • Webhooks (GitHub, Linear) │
46
- │ │ automation) │ • تكامل Slack, Discord │
47
- │ └────────────────────────┘ │
48
- │ │
49
- │ ┌────────────────────────┐ │
50
- │ │ ACP (Agent-Client │ ← بروتوكول تواصل موحّد │
51
- │ │ Protocol) │ • أي عميل (Claude, Codex, │
52
- │ │ │ Gemini, OpenHands) │
53
- │ │ │ • يتواصل مع أي Server │
54
- │ └────────────────────────┘ │
55
- │ │
56
- └────────────────────────────────────────────────────────────┘
57
- ```
58
-
59
- ---
60
-
61
- ## 3. Agent Canvas بالتفصيل
62
-
63
- | الخاصية | الوصف |
64
- |----------|--------|
65
- | **التركيب** | `npm install -g @openhands/agent-canvas` |
66
- | **التشغيل** | `agent-canvas` → localhost:8000 |
67
- | **التقسيم** | `--frontend-only` لواجهة فقط، `--backend-only` لخادم فقط |
68
- | **الغرض** | واجهة مرئية لعرض وتشغيل ومراقبة العملاء |
69
-
70
- ### الميزات
71
- - تشغيل عدة عملاء بالتوازي
72
- - Dashboard لكل عميل (حالته، مخرجاته، سجلاته)
73
- - التبديل بين Backends مختلفة دون فقدان السياق
74
- - إضافة Backends جديدة من الواجهة نفسها
75
-
76
- ---
77
-
78
- ## 4. Agent Server بالتفصيل
79
-
80
- ```
81
- Agent Canvas → HTTP REST → Agent Server → Agent (OpenHands/Claude/Codex)
82
- ```
83
-
84
- | الخاصية | الوصف |
85
- |----------|--------|
86
- | **التشغيل** | محلي، Docker، VM، Mac Mini، سحابة |
87
- | **اللغة** | Python (uv) |
88
- | **REST API** | نعم — endpoints لتشغيل وإدارة العملاء |
89
- | **Multi-Server** | يمكن التبديل بين Servers متعددة |
90
- | **Sandbox** | اختياري — Docker isolation |
91
-
92
- ### أين يُشغّل؟
93
- - مباشرة على اللابتوب (⚠️ وصول كامل للملفات)
94
- - على Mac Mini مخصص
95
- - على VM في السحابة
96
- - داخل Docker (موصى به)
97
- - OpenHands Cloud (تجاري)
98
-
99
- ---
100
-
101
- ## 5. Automation Server
102
-
103
- | الخاصية | الوصف |
104
- |----------|--------|
105
- | **الجدولة** | Cron — مجدولة زمنياً |
106
- | **الأحداث** | Webhooks — GitHub, Linear, Slack |
107
- | **التكاملات** | Slack, GitHub, Notion, Datadog |
108
- | **الغرض** | تشغيل العملاء دون تدخل يدوي |
109
-
110
- ### أمثلة
111
- - "كل صباح: راجع الـ PRs المفتوحة وقدم ملخصاً"
112
- - "عند إغلاق Issue → حلل السبب الجذري"
113
- - "عند Push إلى main → شغّل اختبارات الأمان"
114
-
115
- ---
116
-
117
- ## 6. ACP — Agent-Client Protocol
118
-
119
- **هذا أهم ما في OpenHands معمارياً.**
120
-
121
- ```
122
- [Agent Client Protocol - ACP]
123
- ┌─────────┐ ┌──────────────┐
124
- │ Claude │ │ OpenHands │
125
- │ Code │←────→│ Agent │
126
- └─────────┘ └──────────────┘
127
- ┌─────────┐ ┌──────────────┐
128
- │ Codex │←────→│ Agent │
129
- └─────────┘ └──────────────┘
130
- ┌─────────┐ ┌──────────────┐
131
- │ Gemini │←────→│ Agent │
132
- └─────────┘ └──────────────┘
133
- ```
134
-
135
- - بروتوكول REST موحّد
136
- - أي عميل يتوافق مع ACP يعمل مع أي Server يدعم ACP
137
- - يسمح بالتبديل بين العملاء دون تغيير البنية التحتية
138
- - **يذكّرني بـ TeraSubAgents.md لكن كبروتوكول رسمي**
139
-
140
- ---
141
-
142
- ## 7. مقارنة مع Tera — الوضع الحالي
143
-
144
- | المفهوم | OpenHands | Tera (حالياً) |
145
- |---------|-----------|---------------|
146
- | **واجهة تحكم** | Agent Canvas (UI) | ❌ لا يوجد |
147
- | **تشغيل العملاء** | Agent Server (REST) | ✅ task tool + .opencode/agents/ |
148
- | **أتمتة مجدولة** | Automation Server (Cron) | ❌ يدوي بالكامل |
149
- | **بروتوكول موحّد** | ACP | 🟡 TeraSubAgents.md (نصي) |
150
- | **عزل العملاء** | Sandbox (Docker) | ❌ لا يوجد |
151
- | **Multi-Backend** | Local + Docker + VM + Cloud | ❌ جهاز واحد |
152
- | **تكامل خارجي** | Slack, GitHub, Linear, Notion | ❌ لا يوجد |
153
- | **التوسع** | أفقي (Servers متعددة) | 🟡 عمودي (عملاء أكثر) |
154
-
155
- ---
156
-
157
- ## 8. ما يمكن استلهامه لتطوير Tera
158
-
159
- ### 8.1 ACP → TeraSubAgents.md v2
160
- تحويل TeraSubAgents.md من "ملف تعريف" إلى "بروتوكول اتصال" يحدد:
161
- - كيف يستدعي عميل عميلاً آخر
162
- - ما هي Request/Response format
163
- - كيف يُدار السياق بين العملاء
164
-
165
- ### 8.2 Agent Canvas → Tera Dashboard
166
- لوحة تحكم لـ Majed:
167
- - يرى كل العملاء (TeraAgent, Engineering, UI, QA...)
168
- - حالة كل عميل (شغال؟ منتظر؟ مكتمل؟)
169
- - سجلات ومخرجات كل عميل
170
-
171
- ### 8.3 Automation Server → Tera Scheduler
172
- تشغيل مهام دورية:
173
- - "افحص جميع المشاريع بـ Trivy كل أسبوع"
174
- - "أرسل تقرير الجودة كل يوم جمعة"
175
- - "راقب تحديثات الأمان في dependencies"
176
-
177
- ### 8.4 Agent Server → Tera Execution Layer
178
- فصل "من يقرر" عن "من ينفذ":
179
- - TeraAgent يقرر فقط (كما هو الآن)
180
- - Execution Layer جديد يشغّل العملاء (مثل Agent Server)
181
- - يمكن تشغيل Execution Layer على Docker أو VM
182
-
183
- ---
184
-
185
- ## 9. سيناريو التطبيق الجذري (نسخة أخرى من Tera)
186
-
187
- ```
188
- ┌──────────────────────────────────────────────┐
189
- │ Tera v2 (مقترح) │
190
- ├──────────────────────────────────────────────┤
191
- │ │
192
- │ ┌──────────────────────┐ │
193
- │ │ Tera Dashboard │ ← UI لإدارة العملاء │
194
- │ ├──────────────────────┤ │
195
- │ │ Tera Execution │ ← REST API Layer │
196
- │ │ Server │ لتشغيل العملاء │
197
- │ ├──────────────────────┤ │
198
- │ │ Tera Protocol │ ← ACP-like protocol│
199
- │ │ (TP-1) │ للتواصل بين │
200
- │ │ │ العملاء │
201
- │ ├──────────────────────┤ │
202
- │ │ Tera Scheduler │ ← Cron + Events │
203
- │ ├──────────────────────┤ │
204
- │ │ Sandbox Manager │ ← Docker isolation │
205
- │ └──────────────────────┘ │
206
- │ │
207
- │ ════════════════════════════════════════ │
208
- │ │
209
- │ يبقى Tera v1 (الحالي) كما هو للإنتاج. │
210
- │ Tera v2 يُبنى بالتوازي كإعادة هيكلة. │
211
- │ │
212
- └──────────────────────────────────────────────┘
213
- ```
214
-
215
- ---
216
-
217
- ## 10. روابط مهمة للدراسة
218
-
219
- | الرابط | الوصف |
220
- |--------|--------|
221
- | https://github.com/OpenHands/OpenHands | المستودع الرئيسي |
222
- | https://github.com/OpenHands/software-agent-sdk | الـ SDK الرسمي للـ Agent و Agent Server |
223
- | https://github.com/OpenHands/agent-canvas | واجهة التحكم الأمامية |
224
- | https://github.com/OpenHands/automation | سيرفر الأتمتة |
225
- | https://docs.openhands.dev/overview/introduction | التوثيق الرسمي |
226
- | https://docs.openhands.dev/openhands/usage/agent-canvas/acp-agents | ACP Protocol specs |
227
- | https://docs.openhands.dev/openhands/usage/agent-canvas/backend-setup/vm | دليل Self-Hosting |
228
-
229
- ---
230
-
231
- ## 11. حالة الدراسة
232
-
233
- - [ ] قراءة ACP Specifications
234
- - [ ] تحليل Agent Server Architecture
235
- - [ ] تحليل Agent Canvas Architecture
236
- - [ ] دراسة Automation Server
237
- - [ ] مقارنة مع TeraSubAgents.md
238
- - [ ] إنتاج SYSTEM_CHANGE_PROPOSAL للتحسينات المستوحاة
239
- - [ ] بدء Tera v2 بالتوازي (اختياري)
240
-
241
- ---
242
-
243
- > **ملاحظة:** هذا الملف مرجعي بحت. أي دراسة أو تطبيق يتطلب الرجوع إلى المصادر الأصلية والموافقة على SYSTEM_CHANGE_PROPOSAL قبل التنفيذ.