@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.
|
|
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": "
|
|
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,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 قبل التنفيذ.
|