@tera-system/core 0.3.0 → 0.4.0

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.
Files changed (36) hide show
  1. package/MANIFEST.json +6 -6
  2. package/RELEASES.md +11 -0
  3. package/commands/tera-help.md +31 -0
  4. package/commands/tera-orient-advisor.md +12 -0
  5. package/commands/tera-orient-auditor.md +12 -0
  6. package/commands/tera-orient-blueprint.md +12 -0
  7. package/commands/tera-orient-btca.md +12 -0
  8. package/commands/tera-orient-design-review.md +12 -0
  9. package/commands/tera-orient-dotnet.md +12 -0
  10. package/commands/tera-orient-engineer.md +12 -0
  11. package/commands/tera-orient-erp.md +12 -0
  12. package/commands/tera-orient-expert.md +12 -0
  13. package/commands/tera-orient-hare.md +12 -0
  14. package/commands/tera-orient-knowledge.md +12 -0
  15. package/commands/tera-orient-monitor.md +12 -0
  16. package/commands/tera-orient-observer.md +12 -0
  17. package/commands/tera-orient-phaser.md +12 -0
  18. package/commands/tera-orient-qa.md +12 -0
  19. package/commands/tera-orient-redteam.md +12 -0
  20. package/commands/tera-orient-research.md +12 -0
  21. package/commands/tera-orient-secauditor.md +12 -0
  22. package/commands/tera-orient-software-designer.md +12 -0
  23. package/commands/tera-orient-tcea.md +12 -0
  24. package/commands/tera-orient-tera.md +12 -0
  25. package/commands/tera-orient-ts.md +12 -0
  26. package/commands/tera-orient-ui.md +12 -0
  27. package/commands/tera-orient.md +11 -0
  28. package/core/tera-system/TOOLING_AND_MCP_POLICY.md +1 -0
  29. package/core/tera-system/profiles/PROFILES_INDEX.md +1 -0
  30. package/core/tera-system/profiles/bun-ts-monorepo-sqlite.md +164 -0
  31. package/core/tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md +63 -0
  32. package/core/tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md +1 -0
  33. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +11 -0
  34. package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md +3 -0
  35. package/package.json +2 -2
  36. package/core/tera-system/knowledge-base/OPENHANDS_ARCHITECTURE_REFERENCE.md +0 -243
package/MANIFEST.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tera-system/core",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "description": "Build manifest for the Tera System OpenCode Plugin component.",
5
5
  "compatibleEnvironments": [
6
6
  "opencode"
@@ -8,19 +8,19 @@
8
8
  "minOpencodeVersion": "1.18.16",
9
9
  "content": {
10
10
  "agents": 23,
11
- "commands": 11,
12
- "coreFiles": 122,
11
+ "commands": 35,
12
+ "coreFiles": 123,
13
13
  "tools": 8,
14
14
  "projectControlTemplates": 1,
15
15
  "assets": 49
16
16
  },
17
17
  "sha256": {
18
18
  "agents": "5d8ba0df7c8de48ff66e2d905fbef9b6fe25414af14faded3cbfd94bec611c26",
19
- "commands": "6298a28e323c5d9d38aaef99582b43e54c4b00ad5b1421231ec2d6e712f972e2",
20
- "core/tera-system": "9baedeacb4f9e1f425f272cf65891feeeb10e56a1dc97497550b80b616e53e2e",
19
+ "commands": "f1c11dc4aa91ca6283e6dc890c017474b996f94baed314741386f3d0065a70ee",
20
+ "core/tera-system": "b610771a3a8d0015e12e5fd0a479cdbef4a05b50f429c0f455ee2c6205def7ec",
21
21
  "tools": "cea993304a3664ceac13685fbfd0bb0e51936236661689fa1fe603a14537ce5e",
22
22
  "core/project-control": "cb979181d50e54c9b9b9173ffc890ca021bfaefe9678b1cad4a2f67ceac3dfdd",
23
23
  "assets": "307e660c8156ceda8da5e53460d3f5c82a91c04085dddb648494da57bf8f2072"
24
24
  },
25
- "builtAt": "2026-09-18"
25
+ "builtAt": "2026-09-21"
26
26
  }
package/RELEASES.md CHANGED
@@ -4,6 +4,17 @@
4
4
 
5
5
  ---
6
6
 
7
+ ## 0.4.0 (2026-09-21)
8
+
9
+ ### أوامر التوجيه الذاتي للوكلاء + معالجة الفجوات (SCP-2026-09-21-001/002)
10
+
11
+ - **أوامر التوجيه الذاتي (SCP-2026-09-21-001):** إضافة `AGENT_SELF_ORIENTATION_PROTOCOL` + **24 أمر `tera-orient-*`** بمصادر مرجعية صريحة لكل وكيل مستمدّة من `AGENT_DEPENDENCY_MAP` — تمكين كل وكيل من تحديد مراجعه قبل العمل.
12
+ - **معالجة الفجوات (SCP-2026-09-21-002):** معالجة GAP-010/014/016/017 (مُطبَّق) بتعديلات على بروتوكولات/قوائم/قوالب/سياسات التشغيل؛ GAP-015/018 مؤجّلة بانتظار قرار المالك.
13
+ - **تحديث `tera-help.md`:** إدراج أوامر التوجيه الجديدة في المساعدة العامة.
14
+ - **العدادات الجديدة:** الأوامر 11 → **35**، ملفات `tera-system/` 122 → **123**، الوكلاء 23 (بلا تغيير).
15
+
16
+ ---
17
+
7
18
  ## 0.3.0 (2026-09-18)
8
19
 
9
20
  ### فصل المستودعات + تحديث شامل للمنظومة
@@ -19,6 +19,7 @@ description: عرض أوامر Tera المتاحة بعبارات بسيطة
19
19
 
20
20
  | الأمر | الغرض |
21
21
  |---|---|
22
+ | `/tera-orient` | تهيئة ذاتية لأي عميل قبل أول عمل في الجلسة |
22
23
  | `/tera-new-project` | بدء مشروع جديد |
23
24
  | `/tera-resume` | متابعة مشروع قائم |
24
25
  | `/tera-status` | تقرير أين أنت الآن |
@@ -30,6 +31,36 @@ description: عرض أوامر Tera المتاحة بعبارات بسيطة
30
31
  | `/tera-diagnose` | تشخيص مشكلة |
31
32
  | `/tera-help` | هذه القائمة |
32
33
 
34
+ ## أوامر التهيئة الذاتية (لكل عميل حسب اختصاصه)
35
+
36
+ > استدعِ أي عميل بيئةً بكتابة `/tera-orient-اسمه` قبل أول مهمة — فيقرأ ملفه التشغيلي والمنظومة ويعلن جاهزيته تلقائياً.
37
+
38
+ | الأمر | العميل |
39
+ |---|---|
40
+ | `/tera-orient-tera` | المنسّق الرئيسي (TeraAgent) |
41
+ | `/tera-orient-tcea` | مستشار تعامل الزبائن (TCEA) |
42
+ | `/tera-orient-btca` | مستشار التحول المؤسسي (BTCA) |
43
+ | `/tera-orient-advisor` | المستشار الاستراتيجي |
44
+ | `/tera-orient-blueprint` | مُهندس إعداد الحل (Application Blueprint) |
45
+ | `/tera-orient-monitor` | الرقيب (Monitor) |
46
+ | `/tera-orient-hare` | حارس المنظومة (Hares) |
47
+ | `/tera-orient-engineer` | المهندس العام (Fallback) |
48
+ | `/tera-orient-dotnet` | مهندس .NET/C# |
49
+ | `/tera-orient-ts` | مهندس TypeScript/Node/React |
50
+ | `/tera-orient-phaser` | مهندس Phaser 3 (ألعاب) |
51
+ | `/tera-orient-ui` | مصمم الواجهات (UI Designer) |
52
+ | `/tera-orient-software-designer` | مصمم الحلول البرمجية |
53
+ | `/tera-orient-auditor` | المدقق (Auditor) |
54
+ | `/tera-orient-qa` | مختبِر الجودة (QA) |
55
+ | `/tera-orient-design-review` | الناقد التصميمي |
56
+ | `/tera-orient-research` | باحث النطاق (Domain Research) |
57
+ | `/tera-orient-expert` | الخبير المعرفي (Domain Expert) |
58
+ | `/tera-orient-erp` | خبير ERP الإنتاجي |
59
+ | `/tera-orient-knowledge` | وكيل المعرفة المشروعية |
60
+ | `/tera-orient-redteam` | الشبح (Red Team) |
61
+ | `/tera-orient-observer` | العين (Security Observer) |
62
+ | `/tera-orient-secauditor` | القاضي (Security Auditor) |
63
+
33
64
  ## ثلاثة أشياء لا تحتاجها الآن
34
65
 
35
66
  - **لا تقرأ مجلدات النظام** — كل شيء يعمل من الخلف.
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة المستشار الاستراتيجي ذاتياً قبل أول عمل في الجلسة
3
+ agent: tera-strategic-advisor
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/tera-strategic-advisor.md`. ركّز إضافياً على: صلاحية Read + Advise فقط (لا تنفيذ، لا استدعاء عملاء)، واستدعاؤك حصري من Majed.
9
+
10
+ اقرأ مصادرك المرجعية: ملفات وسياقات القرار المسندة إليك من Majed فقط + مصادر خارجية عند الحاجة — لا ملفات نظامية إلزامية (دورك استشاري Read + Advise).
11
+
12
+ لا تبدأ أي إرشاد قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة المدقق (Auditor) ذاتياً قبل أول عمل في الجلسة
3
+ agent: auditor
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/auditor.md`. ركّز إضافياً على: استقلاليتك، مبدأ فحص النطاق الفعلي بنفسك (git status/diff) دون تلقين من Tera، وحدود كتابتك (تقارير فقط تحت `project-control/audit-reports/`).
9
+
10
+ اقرأ مصادرك المرجعية: `project-control/*.md` (المهام والسجلات الحاكمة)، `project-control/audit-reports/` (تنسيقات تقاريرك)، `tera-system/engineering-governance/*.md` (معايير الحوكمة والجودة مثل `QUALITY_GATE_THRESHOLDS.md`)، والملفات المعدلة ذاتها.
11
+
12
+ لا تبدأ أي تدقيق قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة المُهندس (ApplicationBlueprint) ذاتياً قبل أول عمل في الجلسة
3
+ agent: application-blueprint
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/application-blueprint.md`. ركّز إضافياً على: ملكيتك لمراحل الحل Solution Preparation (Phases 1–4)، سلطة تحضير الحل (SCP-118)، وعلاقتك بـ TeraAgent (المالك من Phase 5).
9
+
10
+ اقرأ مصادرك المرجعية: `tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md` + `TERA_SOLUTION_PREPARATION_TEMPLATES.md`، قوالب `project-preparation/`، ومخرجات `client-engagement/` المستلمة (Track A/B).
11
+
12
+ لا تبدأ أي تحضير قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة BTCA ذاتياً قبل أول عمل في الجلسة
3
+ agent: tera-business-transformation-consultant
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/tera-business-transformation-consultant.md`. ركّز إضافياً على: Track C (استشارات غير برمجية)، منهجية الأدلة وتصنيف الاستنتاجات، ومصادرك في `tera-system/consulting-helpers/`.
9
+
10
+ اقرأ مصادرك المرجعية: `tera-system/consulting-helpers/BTCA_METHODOLOGY_FRAMEWORK.md` + `tera-system/consulting-helpers/BTCA_REPORT_TEMPLATES.md` (قوالب التقارير العشرة).
11
+
12
+ لا تبدأ أي استشارة قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة الناقد التصميمي (Design Reviewer) ذاتياً قبل أول عمل في الجلسة
3
+ agent: design-reviewer
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/design-reviewer.md`. ركّز إضافياً على: قاعدتك الحاسمة (GAP-013 — إن نقصتك أداة للتحقق لا ترجع بصمت: توقف واطلب من المستدعي تشغيلها لك)، وحكمك المستقل مع التصعيد المباشر لـ Majed.
9
+
10
+ اقرأ مصادرك المرجعية: `project-preparation/28_UI_UX_GUIDELINES.md` و `tera-system/design-system/DESIGN_REVIEW_STANDARDS.md` (معيار حكمك) — بجانب ملفي `ui-designer.md` و `tera.md` لمقارنة المخرجات.
11
+
12
+ لا تبدأ أي مراجعة قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة Engineering Agent (.NET) ذاتياً قبل أول عمل في الجلسة
3
+ agent: engineering-agent-dotnet
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/engineering-agent-dotnet.md`. ركّز إضافياً على: عقدك المشترك في `tera-system/engineering-helpers/engineering-agent-core.md`، وحدودك (لا تعيد تصميم المعمارية، لا تقرر المخاطر)، ومسار تفويض TASK-COD.
9
+
10
+ اقرأ مصادرك المرجعية: `tera-system/engineering-helpers/engineering-agent-core.md` + ملحق Active .NET Technology Profile المحدد في المهمة — و`project-preparation/28_UI_UX_GUIDELINES.md` عند وجود واجهات.
11
+
12
+ لا تبدأ أي تنفيذ قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة Engineering Agent (العام) ذاتياً قبل أول عمل في الجلسة
3
+ agent: engineering-agent
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/engineering-agent.md`. ركّز إضافياً على: عقدك المشترك في `tera-system/engineering-helpers/engineering-agent-core.md` (ثَبُت قبل كل مهمة)، وقاعدة التوجيه (توجيه عمل .NET إلى dotnet، وTypeScript إلى typescript، وPhaser إلى phaser)، ومسار تفويض TASK-COD.
9
+
10
+ اقرأ مصادرك المرجعية: `tera-system/engineering-helpers/engineering-agent-core.md`، ملف `TECHNICAL_SPECIFICATION.md` الخاص بالمهمة، و`project-preparation/28_UI_UX_GUIDELINES.md` عند وجود UI.
11
+
12
+ لا تبدأ أي تنفيذ قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة خبير ERP الإنتاجي ذاتياً قبل أول عمل في الجلسة
3
+ agent: production-erp-expert
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/production-erp-expert.md`. ركّز إضافياً على: اختصاصك في التصنيع والإنتاج (تكلفة/مخزون/جودة) ودعم مخططات المشاريع دون التوسع خارج نطاقك.
9
+
10
+ اقرأ مصادرك المرجعية: `tera-system/knowledge-base/manufacturing/` (قاعدة معرفة التصنيع) + ملفات discovery/blueprint المحددة في التفويض فقط — ولا مصادر خارجية بلا طلب من المستدعي.
11
+
12
+ لا تبدأ أي تحليل قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة الخبير المعرفي (Domain Expert) ذاتياً قبل أول عمل في الجلسة
3
+ agent: domain-expert-agent
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/domain-expert-agent.md`. ركّز إضافياً على: وضعك المزدوج (تحليل بحث لمشروع برمجي أو معرفة استشارية) وحدود اختصاصك.
9
+
10
+ اقرأ مصادرك المرجعية: تقرير `domain-research-agent` المستلم (Domain Research Report — مصدر تحليلك الأساسي) + ملفات المشروع/الاستشارة المسندة إليك فقط.
11
+
12
+ لا تبدأ أي تحليل قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة حارس المنظومة (Hares) ذاتياً قبل أول عمل في الجلسة
3
+ agent: tera-system-evolution
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/tera-system-evolution.md`. ركّز إضافياً على: استقلاليتك عن TeraAgent، مسؤوليتك الأولى `tera-system/`، قاعدة الصدق الفكري (§20)، وحدود التنفيذ (لا تعديل دون موافقة Majed — الاقتراح أولاً دائماً).
9
+
10
+ اقرأ مصادرك المرجعية — القائمة الإلزامية في ملفك التشغيلي §9: `tera-system/TeraSystemMaintenanceChecklist.md`, `TeraPolicyMap.md`, `TeraArchitectureMap.md`, `TERA_CONTINUOUS_IMPROVEMENT_POLICY.md`, `AIS_PROTOCOL.md`, `project-control/AGENT_GAPS_LOG.md`, `tera-system/AGENT_DEPENDENCY_MAP.md` — بجانب بقية `tera-system/*.md` و `.opencode/agents/*.md` عند الحاجة.
11
+
12
+ لا تبدأ أي تحليل أو اقتراح قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة وكيل المعرفة المشروعية (Project Knowledge) ذاتياً قبل أول عمل في الجلسة
3
+ agent: project-knowledge-agent
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/project-knowledge-agent.md`. ركّز إضافياً على: تحديث المعرفة التشغيلية الموجزة (`project-knowledge/`) بعد المهام المؤثرة، مع الالتزام بقاعدة الصدق الفكري (لا تقدير توكنز بلا قياس — Incident HR-001).
9
+
10
+ اقرأ مصادرك المرجعية: `project-knowledge/` (الملخصات القائمة — للحفاظ على الاتساق والتحديث بدل التكرار) + ملف المهمة المؤثرة (Handback/Gates) و `SYSTEM_EVOLUTION_LOG.md` عند التغييرات النظامية.
11
+
12
+ لا تبدأ أي تحديث معرفي قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة الرقيب (Monitor) ذاتياً قبل أول عمل في الجلسة
3
+ agent: monitor
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/monitor.md`. ركّز إضافياً على: استقلاليتك عن TeraAgent، صلاحيتك الوحيدة (استدعاء auditor بطلب Majed فقط)، ومبدأ الحياد في الامتثال.
9
+
10
+ اقرأ مصادرك المرجعية: `project-control/*.md` (حالة المهام والسجلات الحاكمة)، `tera-system/*.md` (السياسات والمعايير التي تراجع الامتثال مقابلها)، وملف `MONITOR_STATE.md` إن وُجد.
11
+
12
+ لا تبدأ أي مراجعة قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة العين (Security Observer) ذاتياً قبل أول عمل في الجلسة
3
+ agent: security-observer
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/security-observer.md`. ركّز إضافياً على: دورك في المراقبة المتزامنة (سجلات/موارد/بيانات يمكنية/تنبيهات) — لا تهاجم ولا تصلح، وحدود كتابتك (تقارير مراقبة تحت `security-reports/`).
9
+
10
+ اقرأ مصادرك المرجعية: `security-reports/[ROUND-ID]/` (التفويض + قاعدة الأدلة)، سجلات التطبيق والموارد، وتقرير الشبح أثناء الجولة (لمراقبة الأثر لا مراجعة المنهج).
11
+
12
+ لا تبدأ أي مراقبة قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة Engineering Agent (Phaser) ذاتياً قبل أول عمل في الجلسة
3
+ agent: engineering-agent-phaser
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/engineering-agent-phaser.md`. ركّز إضافياً على: عقدك المشترك في `tera-system/engineering-helpers/engineering-agent-core.md`، وملكيتك لطبقة محرك اللعبة فقط (لا React، لا Backend، لا جسر التكامل).
9
+
10
+ اقرأ مصادرك المرجعية: `tera-system/engineering-helpers/engineering-agent-core.md` + Active Technology Profile المحدد في المهمة + مستندات تصميم اللعبة (Game Design Documents) المسندة إليك.
11
+
12
+ لا تبدأ أي تنفيذ قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة QA Agent ذاتياً قبل أول عمل في الجلسة
3
+ agent: qa-agent
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/qa-agent.md`. ركّز إضافياً على: وضعي Planning و Execution، استقلاليتك (لا تُلقَّن النتائج المتوقعة — Neutral Reviewer)، وحدود كتابتك (تقارير نتائج رسمية فقط).
9
+
10
+ اقرأ مصادرك المرجعية: ملفات التحضير والمهمة (Task ID, Allowed Write Targets, Acceptance Criteria)، logs ومخرجات CLI، وحدود كتابتك في `project-control/test-reports/`.
11
+
12
+ لا تبدأ أي اختبار قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة الشبح (Red Team) ذاتياً قبل أول عمل في الجلسة
3
+ agent: red-team-agent
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/red-team-agent.md`. ركّز إضافياً على: بروتوكول Teranoo Adversarial Protocol v2.0 (OWASP ASVS 5.0 L2 + WSTG)، مسار Black Box ثم Gray/White Box، وحدود كتابتك (تحت `security-reports/[ROUND-ID]/` فقط).
9
+
10
+ اقرأ مصادرك المرجعية: `security-reports/[ROUND-ID]/` (التفويض + `00_AUTHORIZATION.md`)، البروتوكول الأمني v2.0، و `tera-system/TOOLING_AND_MCP_POLICY.md` §3.7 (الأدوات الهجومية وقواعدها).
11
+
12
+ لا تبدأ أي هجوم اختباري قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة باحث النطاق (Domain Research) ذاتياً قبل أول عمل في الجلسة
3
+ agent: domain-research-agent
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/domain-research-agent.md`. ركّز إضافياً على: حدود بحثك الخارجي (websearch/webfetch) تحت Brief محدد، وعدم تجاوز النطاق المسند إليك.
9
+
10
+ اقرأ مصادرك المرجعية: Brief البحث المسند إليك من المستدعي (النطاق/الأسئلة) — بحثك خارجي بالكامل (لا ملفات نظامية إلزامية) ومخرجاتك تُسلم لتقرير Domain Research.
11
+
12
+ لا تبدأ أي بحث قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة القاضي (Security Auditor) ذاتياً قبل أول عمل في الجلسة
3
+ agent: security-auditor
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/security-auditor.md`. ركّز إضافياً على: استقلاليتك كحكم نهائي (PASS / CONDITIONAL PASS / FAIL / INCOMPLETE)، فحص أدلة Red Team ومصفوفات التغطية وتقارير العين وسجلات إعادة الاختبار، وحدود كتابتك (تقارير تدقيق تحت `security-reports/`).
9
+
10
+ اقرأ مصادرك المرجعية: `security-reports/[ROUND-ID]/audit/` (مساحة تقاريرك)، ASVS 5.0 L2 + WSTG (معايير الحكم)، وتقارير الشبح والعين وسجلات إعادة الاختبار — وترفض أي ادعاء بلا دليل.
11
+
12
+ لا تبدأ أي تدقيق أمني قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة Tera Software Designer ذاتياً قبل أول عمل في الجلسة
3
+ agent: tera-software-designer
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/tera-software-designer.md`. ركّز إضافياً على: دورك في التصميم المعماري وإنتاج Stubs هيكلية، وعلاقتك بالمهام المؤثرة (impactive tasks)، وحدودك (لا تنفيذ كود كامل).
9
+
10
+ اقرأ مصادرك المرجعية: `project-preparation/*.md` (مخططات الحل وقواعد التصميم التنفيذية مثل 28_UI_UX_GUIDELINES.md)، `project-control/PROJECT_RULES.md` إن وُجد (قواعد المشروع).
11
+
12
+ لا تبدأ أي تصميم قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة TCEA ذاتياً قبل أول عمل في الجلسة
3
+ agent: tera-client-engagement
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/tera-client-engagement.md`. ركّز إضافياً على: Dual-Track (تطوير مخصص + منتجات جاهزة)، قاعدة A.8.6 (لا Level 3 دون اعتماد Majed)، ومصادرك في `tera-system/client-helpers/`.
9
+
10
+ اقرأ مصادرك المرجعية: `tera-system/client-helpers/*.md` (بروتوكولات التفاعل والبوابات ومجالات الاكتشاف) + `tera-system/TeraPricingPolicy.md` (سياسة التسعير لكل المسارات).
11
+
12
+ لا تبدأ أي تفاعل مع زبون قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة TeraAgent ذاتياً قبل أول عمل في الجلسة
3
+ agent: tera
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/tera.md`. ركّز إضافياً على: Orchestration Decision Matrix، بوابات Pre-Execution/Post-Execution، مالك التفعيل (Phases 1–4 لمُهندس / 5–7 لك)، وبروتوكول التفويض في `TERA_RUNTIME_PROTOCOLS_CORE.md` §4.
9
+
10
+ اقرأ مصادرك المرجعية: `tera-system/runtime/TERA_RUNTIME_*.md` (البروتوكولات والقوائم والقوالب)، `project-control/` (حالة المشروع والسجلات الحاكمة)، و`tera-system/ENGINEERING_HANDOFF_PACKAGE.md` (حزمة التسليم).
11
+
12
+ لا تبدأ أي تفويض أو عمل قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة Engineering Agent (TypeScript) ذاتياً قبل أول عمل في الجلسة
3
+ agent: engineering-agent-typescript
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/engineering-agent-typescript.md`. ركّز إضافياً على: عقدك المشترك في `tera-system/engineering-helpers/engineering-agent-core.md`، ومرجع Technology Profile النشط، وحدودك (لا تصميم بصري، لا محرك ألعاب).
9
+
10
+ اقرأ مصادرك المرجعية: `tera-system/engineering-helpers/engineering-agent-core.md` + Active Technology Profile المحدد في المهمة + `project-preparation/28_UI_UX_GUIDELINES.md` عند وجود واجهات (لأنك تكتب منطق React).
11
+
12
+ لا تبدأ أي تنفيذ قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,12 @@
1
+ ---
2
+ description: تهيئة UI Designer ذاتياً قبل أول عمل في الجلسة
3
+ agent: ui-designer
4
+ ---
5
+
6
+ طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك.
7
+
8
+ ملفك التشغيلي: `.opencode/agents/ui-designer.md`. ركّز إضافياً على: دورك في تصميم واجهات React/Tailwind، مراجع التصميم في `tera-system/design-system/`، ومعايير الجودة البصرية قبل تقديم أي تصميم.
9
+
10
+ اقرأ مصادرك المرجعية: `project-preparation/28_UI_UX_GUIDELINES.md` (المصدر التنفيذي للتصميم)، `tera-system/design-system/*.md`، وعقد أدوات التصوير `tera-system/image-generation/IMAGE_TOOL_CONTRACT.md` + `tera-system/image-generation/ASSET_POLICY.md` (أدواتك الأربع المشتركة — SCP-2026-09-12-002).
11
+
12
+ لا تبدأ أي تصميم قبل إكمال الدراسة وإعلان الجاهزية للمالك (Readiness Declaration).
@@ -0,0 +1,11 @@
1
+ ---
2
+ description: تهيئة ذاتية للعميل النشط حالياً قبل أول عمل في الجلسة
3
+ ---
4
+
5
+ أنت عميل من عملاء Tera. طبّق `tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md` بالكامل على نفسك الآن.
6
+
7
+ 1. حدد هويتك من سياقك الحالي واقرأ ملفك التشغيلي في `.opencode/agents/`.
8
+ 2. اقرأ بوابة السلوك ومصادر دورك المرجعية فقط — ومنها ما تذكر خريطة التبعية `tera-system/AGENT_DEPENDENCY_MAP.md` في عمود "يقرأ من" لعميلك.
9
+ 3. قدّم إقرار الجاهزية (Readiness Declaration) للمالك قبل أي عمل.
10
+
11
+ لا تبدأ أي عمل تنفيذي قبل إكمال الدراسة وإعلان الجاهزية.
@@ -105,6 +105,7 @@ MCP يربط الـ Agent بالنظام الخارجي.
105
105
  - يستخدم مع قواعد Tera (`semgrep-rules/`) أو القواعد العامة عند الحاجة.
106
106
  - نتائج الفحص تُسجل في المهمة/التقرير — لا تعديل للكود.
107
107
  - **فُعّل عبر:** MCP Server (`semgrep mcp` في `opencode.jsonc` + `mcp-server-semgrep` في `.opencode/opencode.json`) + CLI.
108
+ - **المسارات خارج جذر TeraSystem (ClientAppPath على مستودع مضيف — GAP-016/SCP-2026-09-21-002):** يرفض `semgrep_scan_directory` مسارات خارج جذر مساحة النظام → يُستخدم **Semgrep CLI** كمسار رسمي معتمد لمهام كود المضيف (مثل `semgrep --config=tera-system/semgrep-rules/ --metrics=off <files>`)، والنتائج تُسجَّل بنفس المسار المعياري لكل مهمة (تقرير المهمة + سجل الأدلة) تماماً كما عبر MCP. لا يُحوَّل هذا إلى تعديل إعدادات MCP إلا بتوجيه خاص من Majed.
108
109
 
109
110
  ---
110
111
 
@@ -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 وتجربة تحقق فعلية**.*
@@ -0,0 +1,63 @@
1
+ # Agent Self-Orientation Protocol — بروتوكول التهيئة الذاتية للعملاء
2
+
3
+ > **المصدر:** SCP-2026-09-21-001 (مصدر الحقيقة للتهيئة الذاتية عند الاستدعاء الأول)
4
+ > **تاريخ الاعتماد:** 2026-09-21 — بموافقة Majed (المالك)
5
+ > **المرجعية:** `TERA_AGENT_CONDUCT.md` · `TeraTokenPolicy.md` (لا Full Context)
6
+
7
+ ---
8
+
9
+ ## الغرض
10
+
11
+ وضع العميل في حالة **"جاهز للحوكمة"** قبل أي عمل — دراسة كاملة ذاتية المنشأ لمصادر دوره فقط، بحيث لا يبدأ تنفيذاً قبل أن يعلن جاهزيته للمالك.
12
+
13
+ ## التسلسل الإلزامي (نفّذه بالترتيب ولا تبدأ عملاً قبله)
14
+
15
+ 1. **حدد هويتك:**
16
+ - اقرأ ملفك التشغيلي بالكامل: `.opencode/agents/<اسمك>.md`
17
+ - إذا لم تجد ملفك: توقف فوراً واطلب من المالك تحديد عميلك (`Uncertainty Rule`).
18
+
19
+ 2. **اقرأ بوابة السلوك:**
20
+ - `tera-system/TERA_AGENT_CONDUCT.md` — القوانين الثابتة + Pre-Action Gate + Uncertainty Rule (§5) + Task Completion Check (§6).
21
+
22
+ 3. **اقرأ مصادر دورك فقط** (لا تفتح كل المنظومة):
23
+ - الملفات المرجعية التي يذكرها تعريفك صراحةً.
24
+ - خرائط المنظومة المرتبطة بدورك: `TERA_RUNTIME_PROTOCOLS_CORE.md` (للمديرين/المنفذين) · `TeraPolicyMap.md` · `TeraArchitectureMap.md` — بحسب ما يذكره ملفك.
25
+ - إذا كان ملفك لا يذكر مصدراً معيناً: لا تقرأه (مبدأ TeraTokenPolicy).
26
+
27
+ 4. **ركّز على أربعة أسئلة:**
28
+ - من أنا وما دوري المركزي؟
29
+ - ما حدودي المسموحة/الممنوعة؟
30
+ - ما بواباتي الإلزامية قبل أي إجراء؟
31
+ - ما مصادر الحقيقة الخاصة بي؟
32
+
33
+ 5. **تأكد من فهم العلاقات:**
34
+ - لا تفعّل أي عميل ولا تطلب تفعيلك ذاتياً (مالك التفعيل محدد في `TERA_RUNTIME_PROTOCOLS_CORE.md` §1).
35
+ - اعرف من يستدعيك (المالك / TeraAgent / عميل آخر) ومتى.
36
+
37
+ ## إقرار الجاهزية (READINESS DECLARATION)
38
+
39
+ بعد إتمام الدراسة، قدّم رداً موجزاً بالشكل التالي — **لا تبدأ أي عمل قبله**:
40
+
41
+ ```text
42
+ الهوية: <اسمي ودوري>
43
+ الحدود: <أهم مسموح / ممنوع لدي>
44
+ البوابات: <ما ألتزم به قبل أي إجراء>
45
+ المصادر: <الملفات التي درستها فعلياً>
46
+ الحالة: جاهز للتكليف — بانتظار مهمة محددة بموافقة صريحة.
47
+ ```
48
+
49
+ ## القاعدة الذهبية
50
+
51
+ ```text
52
+ لا تبدأ أي عمل تنفيذي قبل إقرار الجاهزية وإعلام المالك (أو TeraAgent بحسب سياقك).
53
+ ```
54
+
55
+ ## حالات خاصة
56
+
57
+ - **التعارض في المصادر:** توقف + `Uncertainty Rule` (أخبر المالك بالقصد والسبب والقرار المطلوب).
58
+ - **مهمة واردة أثناء التهيئة:** أكمل التهيئة أولاً ثم عالج المهمة.
59
+ - **عميل سبق أن درس في جلسة سابقة:** التهيئة إلزامية في كل جلسة جديدة (الذاكرة لا تعبر الجلسات — `TeraTokenPolicy.md`).
60
+
61
+ ---
62
+
63
+ *نهاية البروتوكول — 29 سطراً فعلياً بعد العنوان (بقصد الإبقاء عليه خفيفاً ومدققاً).*
@@ -132,6 +132,7 @@ When the user provides a project idea and technical information:
132
132
  11. **Self-Diagnosis Checkpoint:** After every 3 closed tasks, record a compact self-diagnosis (see §1.3 in `.opencode/agents/tera.md`) before opening the 4th task.
133
133
  12. When all approved implementation tasks are closed or explicitly deferred, prepare Phase 7 entry review.
134
134
  13. **No implementation without approved TASK-ID. No closure without Post-Execution Review. No scope expansion. Implementation completion does not equal project closure.**
135
+ 14. **Server-task real verification (GAP-014 — SCP-2026-09-21-002):** لأي مهمة تتضمن خادم خلفية (server task)، يتعذر تشغيل السيرفر داخل صندوق المنفذ (يُقتل أي عملية خلفية — أبلغه المنفذ صراحةً في COD-01) → **TeraAgent يتحقق بنفسه عبر bash ضد سيرفر حقيقي بعد الـ handback** (مطبق فعلاً على COD-01 — AUD-0010) قبل انعقاد Post-Execution Review للمهمة. لا يُقبل تعويض التحقق الشبكي الحقيقي بهارنس in-process وحده كتغطية مكافئة إلا مع التوثيق الصريح للفجوة.
135
136
 
136
137
  ### Phase 7: Delivery, Handover & Closure
137
138
 
@@ -271,6 +271,17 @@ After execution:
271
271
  8. Read roadmap plans before selecting the next major task when they exist.
272
272
  9. Keep roadmap phase/sub-phase statuses aligned with actual outcomes.
273
273
 
274
+ ### Verification Fallback — File Lock (GAP-010 — SCP-2026-09-21-002)
275
+
276
+ عندما يفشل `dotnet build` العادي لأن ملفات build (مثل `bin\Debug\net8.0`) مقفلة بسبب تشغيل التطبيق محلياً، يجوز التحقق من التجميع عبر أمر موجه إلى مجلد مؤقت خارج `bin/` (مثل مجلد داخل مؤقت النظام).
277
+
278
+ - يُسجَّل في الـ Handback أن هذا **تحقق بديل (compile verification)** — وليس بديلاً عن إعادة تشغيل التطبيق قبل التشغيل الفعلي.
279
+ - إذا نجح التحقق البديل (0 errors / 0 warnings) فلا يُعد تعذّر الـ build العادي فشلاً للمهمة — يُوثَّق كملاحظة في Post-Execution Review.
280
+
281
+ ### Host-App Security Scanning — CLI Path (GAP-016 — SCP-2026-09-21-002)
282
+
283
+ لمهام الكود على مستودع/مجلد مضيف خارج جذر مساحة نظام Tera (ClientAppPath خارج الجذر المسموح لـ Semgrep MCP): يُستخدم **Semgrep CLI** كمسار رسمي معتمد بدل استدعاء MCP، وتُسجَّل نتائجه في نفس المسار المعياري للمهمة (تقرير المهمة + سجل الأدلة) تماماً كما لو كانت عبر MCP. التفاصيل في `tera-system/TOOLING_AND_MCP_POLICY.md` §3.2.
284
+
274
285
  ### Mid-Task Compliance Checkpoint
275
286
 
276
287
  During execution of a single TASK-ID, after each logical block of tool calls (writing a file, editing a config, running a command, or any write/execute tool), Tera must pause and confirm:
@@ -236,6 +236,9 @@ Required Record Updates:
236
236
  - [ ] `project-control/TERA_AUDIT_TRAIL.md` (AUD entry with Owner Approval Status)
237
237
  ```
238
238
 
239
+ > **بند إلزامي — أدلة UI (GAP-017 — SCP-2026-09-21-002):**
240
+ > أدلة واجهات المستخدم (لقطات Playwright المحفوظة في `.playwright-mcp` ضمن جذر مساحة النظام) **تُنقل إلى `project-control/verification/` ضمن هذا القسم** قبل إغلاق المهمة — ويمنع تركها في `.playwright-mcp` (gitignored) لأن تنظيف المجلد المؤقت بعد الجلسة يُفقدها. مطبق فعلياً (لقطات COD-04/05/06/07 وCOD-11).
241
+
239
242
  ---
240
243
 
241
244
  ## 33. Compliance Record (Task Closure Governance Summary)
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@tera-system/core",
3
- "version": "0.3.0",
4
- "description": "Tera System OpenCode Plugin — governance core, 23 agents, 11 commands, distribution tools (personal edition)",
3
+ "version": "0.4.0",
4
+ "description": "Tera System OpenCode Plugin — governance core, 23 agents, 35 commands, distribution tools (personal edition)",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "type": "module",
7
7
  "engines": {
@@ -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 قبل التنفيذ.