@tera-system/core 0.2.15 → 0.2.17

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 (38) hide show
  1. package/MANIFEST.json +5 -5
  2. package/README.md +3 -3
  3. package/RELEASES.md +328 -308
  4. package/agents/application-blueprint.md +4 -4
  5. package/agents/domain-expert-agent.md +4 -4
  6. package/agents/domain-research-agent.md +4 -4
  7. package/agents/engineering-agent-typescript.md +1 -1
  8. package/agents/production-erp-expert.md +2 -2
  9. package/agents/red-team-agent.md +1 -1
  10. package/agents/tera-client-engagement.md +1 -1
  11. package/agents/tera-system-evolution.md +2 -1
  12. package/agents/tera.md +1 -0
  13. package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +275 -277
  14. package/core/tera-system/AGENT_DEPENDENCY_MAP.md +2 -2
  15. package/core/tera-system/AGENT_PERMISSION_MODEL.md +39 -26
  16. package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +2 -2
  17. package/core/tera-system/TERA_PROJECT_DECISION.md +14 -12
  18. package/core/tera-system/TOOLING_AND_MCP_POLICY.md +1 -1
  19. package/core/tera-system/TeraCapabilityMap.md +327 -0
  20. package/core/tera-system/TeraHelperAgents.md +13 -10
  21. package/core/tera-system/TeraPolicyMap.md +2 -1
  22. package/core/tera-system/TeraPreExecutionGate.md +1 -1
  23. package/core/tera-system/TeraPreparationDocumentationGovernance.md +1 -1
  24. package/core/tera-system/TeraSubAgents.md +312 -868
  25. package/core/tera-system/TeraTokenPolicy.md +1 -1
  26. package/core/tera-system/design-system/DESIGN_SOURCE_PROTOCOL.md +2 -2
  27. package/core/tera-system/design-system/FIGMA_INTEGRATION.md +3 -3
  28. package/core/tera-system/design-system/UI_ACCEPTANCE_GATE.md +1 -1
  29. package/core/tera-system/engineering-governance/ENGINEERING_AGENT_RESPONSIBILITIES.md +4 -2
  30. package/core/tera-system/engineering-governance/ENGINEERING_REVIEW_CHECKLIST.md +1 -1
  31. package/core/tera-system/engineering-governance/QUALITY_GATE_THRESHOLDS.md +1 -1
  32. package/core/tera-system/profiles/PROFILES_INDEX.md +2 -0
  33. package/core/tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md +3 -3
  34. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CLIENT.md +2 -2
  35. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +5 -5
  36. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +1 -1
  37. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +4 -4
  38. package/package.json +1 -1
package/RELEASES.md CHANGED
@@ -1,308 +1,328 @@
1
- # @tera-system/core — سجل الإصدارات (Releases)
2
-
3
- > هذا الملف يُحمَّل مع الحزمة ويُعرض لـ `/tera-update`.
4
-
5
- ---
6
-
7
- ## 0.2.15 (2026-09-03)
8
-
9
- ### ترقية نزاهة فريق الأمان — بعد مراجعة خبير خارجي (SCP-2026-09-03-005)
10
-
11
- **ما تغيّر (6 نقاط من مراجعة الخبير):**
12
- - **عزل Black Box تقني** — Phase A: الهجوم عبر URL فقط، ممنوع قراءة كود المصدر (تقنياً وليس نصياً) — Phase B تُفتح بعد إغلاق A. أي اكتشاف تطلب معرفة الكود أثناء Black Box غير صالح.
13
- - **SECURITY_TARGET_SNAPSHOT.md** — لقطة الهدف قبل/بعد الجولة (Commit SHA + Working Tree + Build + DB seed + Runtime). تغيّر الهدف أثناء الجولة = INVALID.
14
- - **EVIDENCE_MANIFEST.md** — SHA256 لكل ملف أدلة + Freeze Timestamp. بعد التجميد لا تعديل للأدلة الأصلية — الإضافات في evidence-addendum/.
15
- - **Surface Reconciliation (A∪B∪C)** — القاضي يبنيها مستقلاً: مكتشف الشبح + Runtime (العين) + Source-declared. يمنع إخفاء endpoints غير مكتشفة.
16
- - **فصل كتابة صارم** — الشبح لا يكتب observer/ أو audit/.
17
- - **Retest ثنائي المسار** — Track A (Retest بمعرفة الثغرات + bypass) + Track B (Fresh Attack Clean-Room بلا أي معرفة سابقة). القاضي يدمج.
18
-
19
- **لماذا:** مراجعة خبير أمني خارجي: "الفريق أصبح ناضجاً" + 6 ملاحظات جوهرية على نزاهة التجربة (Black Box، نسخة الهدف، حماية الأدلة، الاستقلالية في سطح الهجوم، فصل الكتابة، الجولة الثانية).
20
-
21
- ---
22
-
23
-
24
-
25
- ## 0.2.14 (2026-09-03)
26
-
27
- ### ترقية فريق الأمان — Evidence Discipline + Coverage Matrices + Discovery Rounds (SCP-2026-09-03-004)
28
-
29
- **ما تغيّر:**
30
- - **قاعدة Evidence Pack الإلزامية** — كل استغلال ناجح: metadata + request + response (+ tool-output + screenshot). بلا Pack = Finding مرفوض. قاعدة إعادة البناء: القاضي يعيد بناء الاستنتاج من الأدلة وحدها.
31
- - **مصفوفات التغطية المعيارية** — قوالب جديدة _TEMPLATE_MATRIX_ASVS_L2.md + _TEMPLATE_MATRIX_WSTG.md + _TEMPLATE_MATRIX_API_TOP10.md (إلزامية لكل جولة — PASS/FAIL/N/A/NOT TESTED لكل بند).
32
- - **بروتوكول Discovery Rounds** — جولات ثغرات مخفية (5-7 في تطبيق سليم) لقياس Discovery Rate مقابل الاستغلال.
33
- - **تصنيف ثلاثي للخطورة** — Technical Severity / Business Impact / Exploit Chain Severity (البوابة تعتمد على السلسلة — لا تضخيم).
34
- - **تحديث عملاء الفريق** — red-team-agent (Evidence §8 + Matrices §7 + Discovery §10.1 + Severity §9)، security-observer (Blue Team/Detection Engineering §3.2 + §7.2)، security-auditor (رفض بلا Evidence Pack + مراجعة ثلاثية + مصفوفات).
35
-
36
- **لماذا هذا التحديث:**
37
- - تقييم Majed للجولة الأولى: أدلة 7/13 ناقصة، تغطية معيارية بالاسم فقط، لم يُختبر اكتشاف الثغرات المخفية، تصنيف خطورة متضخم.
38
-
39
- ---
40
-
41
-
42
-
43
- ## 0.2.13 (2026-09-03)
44
-
45
- ### ميثاق فريق الأمان — SECURITY_TEAM_CHARTER (نسخة الجوهر المُوزَّعة)
46
-
47
- **ما تغيّر:**
48
- - **NEW `tera-system/SECURITY_TEAM_CHARTER.md`** — الميثاق الرسمي لفريق الأمان (فريق الهاكرز): الهوية (الدرع/الشبح/العين/القاضي)، الهدف والغاية، المنهجية (13 حملة + 12 أداة)، القواعد التسع، سجل النتائج والتطور. نسخة الجوهر الثابتة الموزعة — المصدر الكامل في `security-reports/` بالمستودع الأصلي.
49
- - **الغرض:** أي مستودع يثبّت الحزمة يجد الميثاق جاهزاً (كان غائباً عن مستودعات العملاء — فجوة نظامية كشفها TeraAgent في جلسة التطبيق)
50
- - **ترسانة الأدوات §6.3** — سياسة تطوير الترسانة (إضافة/استبدال/إزالة الأدوات + معايير قبول)
51
-
52
- **لماذا هذا التحديث:**
53
- - الفريق يجب أن يكون معروفاً وموثقاً في كل جلسة/تطبيق — المرجع يصل الآن مع الحزمة نفسها
54
-
55
- ---
56
-
57
- ## 0.2.12 (2026-09-02)
58
-
59
- ### فريق الحماية — Security Team (SCP-2026-09-02-001)
60
-
61
- **ما تغيّر:**
62
- - **3 عملاء جدد بشخصيات هاكرز محترفين** — `red-team-agent` (الشبح — هجومي)، `security-observer` (العين — مراقب متزامن)، `security-auditor` (القاضي — مدقق مستقل يصدر قرار البوابة: PASS/CONDITIONAL PASS/FAIL/INCOMPLETE)
63
- - **`SecurityAgent` (الدرع) مطوَّر** — أصبح عضواً دفاعياً في الفريق: يحضّر `defense-handoff.md` + يراجع الإصلاحات `fix-review.md`
64
- - **بروتوكول الهجوم** — Teranoo Adversarial Protocol v2.0 (OWASP ASVS 5.0 L2 + WSTG + API Top 10): 13 حملة إلزامية + فصل صارم للأدوار (المهاجم لا يدقق)
65
- - **الأدوات الهجومية** — سياسة §3.7 (Burp/ZAP/Nmap/ffuf/Nuclei/sqlmap/dalfox/Metasploit/John/Hydra/Wireshark/k6) + خطة Cloud §3.8 (DigitalOcean — مؤجلة)
66
- - **بوابة الأمن Phase 7** — لا تسليم تطبيق بلا قرار القاضي (Critical/High مفتوحة = لا تسليم)
67
- - **مخرجات موحدة** — `security-reports/` (خارج مجلد التطبيق): تفويض + سطح هجوم + سجل اختبارات + Findings + تقرير مراقب + قرار تدقيق + إعادة اختبار + أدلة
68
- - **قاعدة الصدق الفكري §20** — تصنيفات إلزامية [Verified]/[Inferred]/[Speculative]/[Unknown]/[Needs Decision] لكل معلومة
69
-
70
- **لماذا هذا التحديث:**
71
- - الحاجة لاختبار أمني حقيقي (هجمات فعلية مصرح بها لا ماسحات) قبل تسليم أي تطبيق — بمنهجية معيارية عالمية وأدلة قابلة للمراجعة
72
- - العملاء (23 الآن): 6 Coding + 3 Quality + 3 Management/Engagement + 4 Security + 3 Research/Knowledge + 4 Support
73
-
74
- ---
75
-
76
- ## 0.2.11 (2026-08-31)
77
-
78
- ### Research library + package/website info persistence (SCP-2026-08-31-001/002/003)
79
-
80
- **ما تغيّر:**
81
- - **Reusable Research Library (SCP-2026-08-31-001)** — `domain-research-agent` يطبّق Reuse-First (فحص `../Teranoo-Research/00_INDEX.md` قبل أي websearch) + بوابة تقييم إلزامية من 4 أسئلة (Score≥3 → حفظ DRAFT في مستودع `Teranoo-Research` الخاص؛ الترقية DRAFT→READY بيد Majed فقط). المكتبة مستودع خاص مستقل **خارج الحزمة** — لا تُوزَّع.
82
- - **تثبيت معلومات الحزم والموقع (SCP-2026-08-31-002/003)** — `TERA_DISTRIBUTION_POLICY.md` يوثق الآن: الحزم الرسمية (`@tera-system/core`, `@tera-system/pro`)، المستودع الأصلي `https://github.com/Alabasi1980/Teranoo-System`، مستودع الموقع `https://github.com/Alabasi1980/TeraWebsite`، ولوحة النشر `https://coolify.teranoo.com/`. تصحيح `RepositoryUrl` الخاطئ + تذكير bump في الـ Checklist.
83
-
84
- ## 0.2.10 (2026-08-29)
85
-
86
- ### ضمان الأداة الخماسية في كل مستودع — Tooling Provisioning (SCP-2026-08-29-012)
87
-
88
- **ما تغيّر:**
89
- - **`tools/tera-tooling.ps1` جديد** — سكربت تزويد/تحقق موحّد للأدوات الخمس: Playwright (MCP)، Semgrep (MCP+CLI)، Structurizr (MCP)، Gitleaks (CLI)، Trivy (CLI) — وضع Report أو `-Install` (winget/pip/npx) + جدول حالة + exit code
90
- - **تفعيل Structurizr MCP** في `opencode.tera.example.json` (`enabled: true`) + تصحيح `STRUCTURIZR_WORKSPACE_DIR` → `architecture` (كان `../architecture` خارج المستودع)
91
- - **شحن `structurizr-mcp/` (12 ملفاً) + `architecture/` (starter)** في الأصول → يُثبَّتان في جذر أي مستودع (assets 36→49)
92
- - **السياسة §3.6** — المعيار الخماسي + قاعدة: لا `SKIPPED (tool not installed)` صامت بعد التزويد
93
-
94
- **لماذا هذا التحديث:**
95
- - الأدوات الخمس معتمدة في البوابات (SEMGREP_SANITY_CHECK، Trivy/Gitleaks قبل التسليم) لكن توفرها كان "إن وُجد" — السكربت يحوّلها إلى مضمونة بأمر واحد
96
- - Structurizr كان معطلاً لأن خادمه لا يصل للمستودعات — الآن يُشحن مع الحزمة
97
-
98
- ---
99
-
100
- ## 0.2.9 (2026-08-29)
101
-
102
- ### إعادة تصميم محتوى سندات القبض والصرف وتحديث الترويسة
103
-
104
- **التحديث:**
105
- - اعتماد بنية المحتوى المعاد تصميمها: بطاقات رقم السند والتاريخ، بطاقات المبلغ كتابةً ورقماً، حقول المرجع والغرض، خيارات الدفع، والتوقيعات.
106
- - سند واحد فقط في كل ملف HTML.
107
- - استخدام `V2.png` لسند القبض و`V1.png` لسند الصرف بعرض 210مم.
108
- - تضمين جميع أصول مجلد `financial` المطلوبة للتثبيت، بما فيها صور الترويسة.
109
- - تحديث مقاس السند إلى 210×156مم.
110
-
111
- ---
112
-
113
- ## 0.2.8 (2026-08-29)
114
-
115
- ### سندات القبض والصرف — استخدام شعار Teranoo الرسمي
116
-
117
- **التحديث:**
118
- - استُبدلت علامة "T" النصية في ترويسة السندات بـ **شعار Teranoo الرسمي** (مضمّن base64 — ذاتي الاحتواء، يعمل عند الطباعة من أي مكان).
119
- - الملفان: `financial/VOUCHER_RECEIPT_TEMPLATE.html` + `financial/VOUCHER_PAYMENT_TEMPLATE.html` — 3 سندات لكل A4 (1/3 A4) بخطوط قص.
120
-
121
- ---
122
-
123
- ## 0.2.7 (2026-08-29)
124
-
125
- ### سندات القبض والصرف — تصميم معتمد ومنجز (SCP-2026-08-29-006)
126
-
127
- **الجديد:**
128
- - **`financial/VOUCHER_RECEIPT_TEMPLATE.html`** + **`VOUCHER_PAYMENT_TEMPLATE.html`** — سندات قبض/صرف بحجم دفاتر السندات المتعارف (1/3 A4 — 210×99مم، **3 سندات لكل صفحة A4**) مع خطوط قص متقطعة.
129
- - الحقول المعتمدة: ترويسة Teranoo + رقم السند (تسلسل مالي `{السنة}-{تسلسل}`) + التاريخ + المستلم/المستفيد + المبلغ كتابةً وأرقاماً + **حقل المرجع (يربط بترميز خطابات العميل)** + طريقة الدفع + التوقيعات (مستلم/أمين صندوق/معتمد) + النسخ (أصل/صورة).
130
- - `financial/VOUCHER_DESIGN_SPEC.md` — وثيقة التصميم المعتمدة.
131
- - `TeraPricingPolicy §21` قاعدة 5 — توثيق الدفعات بسند قبض والمصروفات بسند صرف.
132
- - assets 29→32.
133
-
134
- ---
135
-
136
- ## 0.2.6 (2026-08-29)
137
-
138
- ### نظام ترميز الخطابات الصادرة للزبون (SCP-2026-08-29-005)
139
-
140
- **الجديد:**
141
- - **صيغة رسمية موحدة:** `{كود-العميل}-{النوع}-{السنة}-{التسلسل}` (مثال: NPB-LET-2026-004) — عبر كل المشاريع والمستودعات.
142
- - **كود العميل من Majed فقط** — سجل مركزي `project-control/CLIENT_CODES.md` (المصدر الوحيد)، وحارس يرفع طلب كود لكل عميل جديد — الفريدية بنيوية (لا تكرار عبر المستودعات).
143
- - **أنواع وثائق رسمية** (قابلة للزيادة بقرار Majed): LET / CON / ADD / PAL / DOC / TPL.
144
- - **سجل خطابات العميل** `client-approval/LETTER_LOG.md` إلزامي — مصدر التسلسل المحلي، يُسجَّل قبل الإرسال.
145
- - القاعدة في تدفق TCEA (A.4) + TeraClientPolicy §9.6 + خريطة السياسات.
146
-
147
- ---
148
-
149
- ## 0.2.5 (2026-08-29)
150
-
151
- ### ملكية السورس كود + سياسة التسعير (SCP-2026-08-29-004)
152
-
153
- **الجديد:**
154
- - **قاعدة ملكية السورس:** السورس كود حق ملكية Tera — لا يُسلَّم للزبون افتراضياً (TeraPricingPolicy §31 + TeraClientPolicy §9.5 + العقد §12).
155
- - **خيارا شراء:** L1 (Source Access — 40% من سعر المشروع) و L2 (ملكية داخلية — max(3×، 1,000 JOD)) عبر ملحق تعاقدي — وإعادة البيع مرفوضة افتراضياً (L3 = اتفاقية منفصلة بموافقة Majed).
156
- - **اكتشاف مبكر:** سؤال توقع السورس إلزامي في Domain 13 قبل التسعير (بنك الأسئلة QS.1–QS.4).
157
- - **نموذج جديد:** `tera-workshop/client-templates/contractual/SOURCE_CODE_PURCHASE_ADDENDUM_TEMPLATE.md` (assets 28→29).
158
- - **قوالب محدثة:** العقد §8/§12، الاقتباسان (DRAFT + QUOTATION)، تقرير الهاندوف، حزمة تسليم العميل، خريطتا السياسات والمعمارية، مساعد التسعير A.8.6.
159
-
160
- ---
161
-
162
- ## 0.2.4 (2026-08-29)
163
-
164
- ### إصلاح فجوة التغليف: شحن الحاسبة + قوالب المراسلات (SCP-2026-08-29-002)
165
-
166
- **ما تغيّر:**
167
- - **مجموعة `assets/` جديدة في الحزمة** — تُثبَّت دائماً (لا تُتخطى كـ skeleton):
168
- - `project-control/TeraPricingCalculator.xlsx` — الحاسبة الرسمية ("الأداة الوحيدة المعتمدة" للتسعير عند Level 2)
169
- - `tera-workshop/client-templates/**` — 27 قالباً رسمياً (branding 5، commercial 7، contractual 5، handover 3، pre-contract 7) — منها `letterhead-master-fixed-print.html` الإلزامي لكل عروض وعقود وخطابات
170
- - إصلاح مرجع قديم: `tera-workshop/APPLICATION_PROPOSAL_TEMPLATE.html` (غير موجود) → `tera-workshop/client-templates/commercial/APPLICATION_PROPOSAL_TEMPLATE.md` في `TeraClientPolicy.md` + `TERA_RUNTIME_TEMPLATES.md`
171
- - توحيد مسارات أدوات التوزيع: `tera-workshop/tools/` → `tools/` في `TERA_DISTRIBUTION_POLICY.md` + `TeraArchitectureMap.md` + `TeraPolicyMap.md` (الأدوات تُثبَّت فعلياً في `tools/` — الأوامر الموثقة أصبحت تعمل في المستودعات المثبتة عبر npm)
172
- - تصحيح مرجع قالب المهام: `project-control/tasks/TASK_TEMPLATE.md` → `project-control/templates/TASK_TEMPLATE.md` في `VERSION_LIFECYCLE_PROTOCOL.md` + `TeraPolicyMap.md`
173
- - تنظيف 35 ملف `.tera-bak-*` من مصدر النظام الحي (بقايا عمليات تثبيت — لا علاقة لها بالحزمة)
174
-
175
- **لماذا هذا التحديث:**
176
- - مستودعات العملاء (مثل Omar) كانت تستلم الحزمة ناقصة رغم أن السياسات تفرض هذه الملفات كإلزامية — فجوة تغليف نظامية اكتُشفت عبر تقرير عميل TCEA في مستودع Omar
177
-
178
- ---
179
-
180
- ## 0.2.3 (2026-08-28)
181
-
182
- ### حل الاستعادة عند الحذف بالخطأ + توافق npm 11
183
-
184
- **ما تغيّر:**
185
- - إضافة `bin` جديد: `tera-restore` و `tera-core-restore` — يعيد `.opencode/agents` حتى لو حُذفت بالخطأ و `postinstall` محجوب
186
- - توثيق `npm approve-scripts @tera-system/core` كحل لنظام الأمان الجديد في npm 11
187
- - قسم جديد في README: "الاستعادة عند الحذف بالخطأ" + ملاحظة في WELCOME.md
188
-
189
- **لماذا هذا التحديث:**
190
- - `npm install --force` لم يعد يشغّل `postinstall` تلقائياً بدون موافقة — الحذف بالخطأ كان يتطلب حلاً صريحاً
191
-
192
- ---
193
-
194
- ## 0.2.2 (2026-08-28)
195
-
196
- ### آلية البروتوتايب الإلزامي + مزامنة المنظومة
197
-
198
- **ما تغيّر:**
199
- - **البروتوتايب إلزامي لكل تطبيق** (SCP-2026-08-28-001) — الاستثناء الوحيد `WAIVED_BY_MAJED` موثق من Majed
200
- - بناء البروتوتايب كأول مهمة `TASK-PROTO-*` في `project-control/prototypes/` بواسطة Coding Agents
201
- - مراجعة البروتوتايب بواسطة `ناقد (DesignReviewer)` — تحول إلى `Tera-managed sub-agent` مع الدروع الثلاثة (حياد/تصعيد/استدعاء مزدوج)
202
- - خطاب اعتماد رسمي `PROTOTYPE_APPROVAL_LETTER_TEMPLATE.md` — Gate 6 دليل قانوني يربط التعديلات اللاحقة بـ Change Request
203
- - سلسلة إنفاذ 5 نقاط: `PreExecutionGate #23` + `tera.md Intake` + `Blueprint Readiness` + `Client Protocols` + `Activation Matrix`
204
- - مزامنة خرائط النظام وتقسيم دليل التحضير (SCP-2026-08-28-003) + إصلاح المراجع التشغيلية (SCP-2026-08-28-004)
205
-
206
- **لماذا هذا التحديث:**
207
- - منع اعتراض الزبون على الشاشات بعد التنفيذ الكامل — التصحيح المبكر رخيص، المتأخر مكلف
208
- - سد ثغرة تفعيل ناقد — Tera يستطيع استدعاءه في التوقيت الصحيح مع الحفاظ على حياده
209
-
210
- ---
211
-
212
- ---
213
-
214
- ## 0.2.0 (2026-08-21)
215
-
216
- ### النسخة الشخصية النظيفة (Personal Edition)
217
-
218
- **ما تغيّر:**
219
- - إزالة كل بوابات الترخيص من الوكلاء والأوامر — هذه النسخة للاستخدام الشخصي الحر
220
- - إزالة ملفات الحماية (license-gate, integrity, preflight)
221
- - استعادة `install.js` للنسخة البسيطة الأصلية (تسجيل حالة ترخيص غير مُلزم)
222
- - الفصل عن الحزمة التجارية: `@tera-system/pro`
223
-
224
- **لماذا هذا التحديث:**
225
- - `@tera-system/core` = نسخة شخصية للمالك (Majed) تستخدم في مشاريعه بحرية
226
- - الحماية التجارية (الترخيص، sync من السيرفر، heartbeat) تنتقل إلى `@tera-system/pro`
227
-
228
- ---
229
-
230
- ## 0.1.5 (2026-08-21)
231
-
232
- ### ترقية: التحقق من الترخيص عبر API (أونلاين) مع fallback أوفلاين
233
-
234
- **ما تم تحسينه:**
235
- - **التحقق الأونلاين أولاً:** المُثبِّت يحاول الاتصال بـ API التحقق أولاً
236
- - **Fallback أوفلاين:** إذا فشل الاتصال، يتحقق محلياً بـ Ed25519
237
- - **لا يُوقف التثبيت:** التحقق لا يُوقف التثبيت أبداً
238
- - **dıagnostic واضح:** يُظهر مصدر التحقق (☁️ API / 🔒 Offline / 🔄 Fallback)
239
-
240
- **المتغيرات البيئية الجديدة:**
241
- | المتغير | الوصف | القيمة الافتراضية |
242
- |---------|-------|-------------------|
243
- | `TERA_LICENSE_API` | رابط API التحقق | `https://teranoo.com/api/license` |
244
- | `TERA_OFFLINE_ONLY` | تعطيل التحقق الأونلاين | `0` (مفعّل) |
245
-
246
- **لماذا هذا التحديث:**
247
- - التحقق الأونلاين يمنع التkey lowering
248
- - Fallback يضمن عمل التثبيت حتى بدون إنترنت
249
- - استعداد للعميل الذي يُنفّذ API التحقق
250
-
251
- **ملاحظات:**
252
- - API التحقق بانتظار تنفيذ العميل
253
- - التحقق الأوفلاين يعمل بشكل مستقل حتى بدون API
254
-
255
- ---
256
-
257
- ## 0.1.4 (2026-08-21)
258
-
259
- ### إصلاح: تغيير حالة الترخيص عبر npm
260
-
261
- **ما تم إصلاحه:**
262
- - تحديث حالة الترخيص من "Active" إلى "Unlicensed" عبر npm
263
- - توثيق حالة الترخيص في LICENSE.md
264
-
265
- **ملاحظات:**
266
- - هذا إصلاح طارئ بعد النشر
267
-
268
- ---
269
-
270
- ## 0.1.1 (2026-08-21)
271
-
272
- ### تحديث: توضيح الترخيص والتوثيق
273
-
274
- **ما تم تحسينه:**
275
- - تحديث `LICENSE.md` — توضيح نموذج "كود مفتوح + ترخيص مدفوع"
276
- - تحديث `README.md` — جدولة الترخيص والتفعيل والاستخدام
277
- - إضافة `tera-update` command — كشف التحديثات وإرشاد العميل
278
- - إضافة `RELEASES.md` — سجل التغييرات (هذا الملف)
279
- - تغيير الاسم: `@tera/core` → `@tera-system/core`
280
-
281
- **لماذا هذا التحديث:**
282
- - العملاء يحتاجون لتوضيح ما المسموح وما الممنوع
283
- - آلية التحديث يجب أن تكون واضحة ومُوثّقة
284
-
285
- ---
286
-
287
- ## 0.1.0 (2026-08-20)
288
-
289
- ### الإصدار الأول
290
-
291
- **ما تم تضمينه:**
292
- - نظام حوكمة كامل (`tera-system/` — 110 ملف)
293
- - 20 وكيلاً ذكياً متخصصاً (Coding / Quality / Management / Research / Knowledge)
294
- - 11 أمراً تفاعلياً (جديد/متابعة/تخطيط/مراجعة/تقرير/تفعيل/موافقة/طلب بناء/.diagnose/مساعدة/تحديث)
295
- - أدوات توزيع (`tools/`)
296
- - مُثبِّت غير تدميري (يحفظ بيانات المستخدم)
297
- - آلية ترخيص (Ed25519 — تحقق دون اتصال)
298
- - `WELCOME.md` — دليل أول 5 دقائق
299
-
300
- **ماذا يتغير عند التثبيت:**
301
- - يُنشئ `tera-system/` في جذر المشروع
302
- - يُنشئ `.opencode/agents/` و`.opencode/commands/` إذا لم تكن موجودة
303
- - لا يحذف أي ملف موجود أبداً
304
- - لا يلمس `project-control/` إذا كان موجوداً (بيانات المستخدم)
305
-
306
- **ملاحظات:**
307
- - الإصدار الأول — لا توجد مقارنة سابقة
308
- - آليات التحديث (`tera-update`) مُضافة في هذا الإصدار
1
+ # @tera-system/core — سجل الإصدارات (Releases)
2
+
3
+ > هذا الملف يُحمَّل مع الحزمة ويُعرض لـ `/tera-update`.
4
+
5
+ ---
6
+
7
+ ## 0.2.17 (2026-09-09)
8
+
9
+ ### تحديث: تفعيل edit للوكيل domain-expert (SCP-2026-09-04-008 follow-up)
10
+
11
+ - رفع صلاحية `edit` من `deny` إلى `allow` للوكيل `domain-expert-agent` (مطابقة لـ domain-research)
12
+ - السبب: فحص Runtime أظهر أن `edit:deny` يحجب سلسلة أدوات الملفات كاملة عند opencode — القرار بموافقة Majed
13
+ - Frontmatter أصبح متطابقاً عبر source/core/pro (فرق License Guard في pro مقصود)
14
+
15
+ ---
16
+
17
+ ## 0.2.16 (2026-09-04)
18
+
19
+ ### تحديث: تسمية الدرع + النظرة التنفيذية + صلاحيات البحث (SCP-2026-09-04-005 → 008)
20
+
21
+ - تسمية "الدرع" (The Shield) في كل مكان + النظرة التنفيذية (Executive Overview) مع تحسينات الطباعة A4 (SCP-006/007)
22
+ - تفعيل WRITE_DOCS لوكلاء البحث (domain-research-agent / domain-expert-agent) — SCP-2026-09-04-008
23
+ - إصلاح فجوة MANIFEST في SCP-004
24
+
25
+ ---
26
+
27
+ ## 0.2.15 (2026-09-03)
28
+
29
+ ### ترقية نزاهة فريق الأمان — بعد مراجعة خبير خارجي (SCP-2026-09-03-005)
30
+
31
+ **ما تغيّر (6 نقاط من مراجعة الخبير):**
32
+ - **عزل Black Box تقني** — Phase A: الهجوم عبر URL فقط، ممنوع قراءة كود المصدر (تقنياً وليس نصياً) — Phase B تُفتح بعد إغلاق A. أي اكتشاف تطلب معرفة الكود أثناء Black Box غير صالح.
33
+ - **SECURITY_TARGET_SNAPSHOT.md** — لقطة الهدف قبل/بعد الجولة (Commit SHA + Working Tree + Build + DB seed + Runtime). تغيّر الهدف أثناء الجولة = INVALID.
34
+ - **EVIDENCE_MANIFEST.md** — SHA256 لكل ملف أدلة + Freeze Timestamp. بعد التجميد لا تعديل للأدلة الأصلية — الإضافات في evidence-addendum/.
35
+ - **Surface Reconciliation (A∪B∪C)** — القاضي يبنيها مستقلاً: مكتشف الشبح + Runtime (العين) + Source-declared. يمنع إخفاء endpoints غير مكتشفة.
36
+ - **فصل كتابة صارم** — الشبح لا يكتب observer/ أو audit/.
37
+ - **Retest ثنائي المسار** — Track A (Retest بمعرفة الثغرات + bypass) + Track B (Fresh Attack Clean-Room بلا أي معرفة سابقة). القاضي يدمج.
38
+
39
+ **لماذا:** مراجعة خبير أمني خارجي: "الفريق أصبح ناضجاً" + 6 ملاحظات جوهرية على نزاهة التجربة (Black Box، نسخة الهدف، حماية الأدلة، الاستقلالية في سطح الهجوم، فصل الكتابة، الجولة الثانية).
40
+
41
+ ---
42
+
43
+
44
+
45
+ ## 0.2.14 (2026-09-03)
46
+
47
+ ### ترقية فريق الأمان — Evidence Discipline + Coverage Matrices + Discovery Rounds (SCP-2026-09-03-004)
48
+
49
+ **ما تغيّر:**
50
+ - **قاعدة Evidence Pack الإلزامية** — كل استغلال ناجح: metadata + request + response (+ tool-output + screenshot). بلا Pack = Finding مرفوض. قاعدة إعادة البناء: القاضي يعيد بناء الاستنتاج من الأدلة وحدها.
51
+ - **مصفوفات التغطية المعيارية** — قوالب جديدة _TEMPLATE_MATRIX_ASVS_L2.md + _TEMPLATE_MATRIX_WSTG.md + _TEMPLATE_MATRIX_API_TOP10.md (إلزامية لكل جولة — PASS/FAIL/N/A/NOT TESTED لكل بند).
52
+ - **بروتوكول Discovery Rounds** — جولات ثغرات مخفية (5-7 في تطبيق سليم) لقياس Discovery Rate مقابل الاستغلال.
53
+ - **تصنيف ثلاثي للخطورة** — Technical Severity / Business Impact / Exploit Chain Severity (البوابة تعتمد على السلسلة — لا تضخيم).
54
+ - **تحديث عملاء الفريق** — red-team-agent (Evidence §8 + Matrices §7 + Discovery §10.1 + Severity §9)، security-observer (Blue Team/Detection Engineering §3.2 + §7.2)، security-auditor (رفض بلا Evidence Pack + مراجعة ثلاثية + مصفوفات).
55
+
56
+ **لماذا هذا التحديث:**
57
+ - تقييم Majed للجولة الأولى: أدلة 7/13 ناقصة، تغطية معيارية بالاسم فقط، لم يُختبر اكتشاف الثغرات المخفية، تصنيف خطورة متضخم.
58
+
59
+ ---
60
+
61
+
62
+
63
+ ## 0.2.13 (2026-09-03)
64
+
65
+ ### ميثاق فريق الأمان — SECURITY_TEAM_CHARTER (نسخة الجوهر المُوزَّعة)
66
+
67
+ **ما تغيّر:**
68
+ - **NEW `tera-system/SECURITY_TEAM_CHARTER.md`** — الميثاق الرسمي لفريق الأمان (فريق الهاكرز): الهوية (الدرع/الشبح/العين/القاضي)، الهدف والغاية، المنهجية (13 حملة + 12 أداة)، القواعد التسع، سجل النتائج والتطور. نسخة الجوهر الثابتة الموزعة — المصدر الكامل في `security-reports/` بالمستودع الأصلي.
69
+ - **الغرض:** أي مستودع يثبّت الحزمة يجد الميثاق جاهزاً (كان غائباً عن مستودعات العملاء — فجوة نظامية كشفها TeraAgent في جلسة التطبيق)
70
+ - **ترسانة الأدوات §6.3** — سياسة تطوير الترسانة (إضافة/استبدال/إزالة الأدوات + معايير قبول)
71
+
72
+ **لماذا هذا التحديث:**
73
+ - الفريق يجب أن يكون معروفاً وموثقاً في كل جلسة/تطبيق — المرجع يصل الآن مع الحزمة نفسها
74
+
75
+ ---
76
+
77
+ ## 0.2.12 (2026-09-02)
78
+
79
+ ### فريق الحماية — Security Team (SCP-2026-09-02-001)
80
+
81
+ **ما تغيّر:**
82
+ - **3 عملاء جدد بشخصيات هاكرز محترفين** — `red-team-agent` (الشبح — هجومي)، `security-observer` (العين — مراقب متزامن)، `security-auditor` (القاضي — مدقق مستقل يصدر قرار البوابة: PASS/CONDITIONAL PASS/FAIL/INCOMPLETE)
83
+ - **`SecurityAgent` (الدرع) مطوَّر** — أصبح عضواً دفاعياً في الفريق: يحضّر `defense-handoff.md` + يراجع الإصلاحات `fix-review.md`
84
+ - **بروتوكول الهجوم** — Teranoo Adversarial Protocol v2.0 (OWASP ASVS 5.0 L2 + WSTG + API Top 10): 13 حملة إلزامية + فصل صارم للأدوار (المهاجم لا يدقق)
85
+ - **الأدوات الهجومية** — سياسة §3.7 (Burp/ZAP/Nmap/ffuf/Nuclei/sqlmap/dalfox/Metasploit/John/Hydra/Wireshark/k6) + خطة Cloud §3.8 (DigitalOcean — مؤجلة)
86
+ - **بوابة الأمن Phase 7** — لا تسليم تطبيق بلا قرار القاضي (Critical/High مفتوحة = لا تسليم)
87
+ - **مخرجات موحدة** — `security-reports/` (خارج مجلد التطبيق): تفويض + سطح هجوم + سجل اختبارات + Findings + تقرير مراقب + قرار تدقيق + إعادة اختبار + أدلة
88
+ - **قاعدة الصدق الفكري §20** — تصنيفات إلزامية [Verified]/[Inferred]/[Speculative]/[Unknown]/[Needs Decision] لكل معلومة
89
+
90
+ **لماذا هذا التحديث:**
91
+ - الحاجة لاختبار أمني حقيقي (هجمات فعلية مصرح بها لا ماسحات) قبل تسليم أي تطبيق — بمنهجية معيارية عالمية وأدلة قابلة للمراجعة
92
+ - العملاء (23 الآن): 6 Coding + 3 Quality + 3 Management/Engagement + 4 Security + 3 Research/Knowledge + 4 Support
93
+
94
+ ---
95
+
96
+ ## 0.2.11 (2026-08-31)
97
+
98
+ ### Research library + package/website info persistence (SCP-2026-08-31-001/002/003)
99
+
100
+ **ما تغيّر:**
101
+ - **Reusable Research Library (SCP-2026-08-31-001)** — `domain-research-agent` يطبّق Reuse-First (فحص `../Teranoo-Research/00_INDEX.md` قبل أي websearch) + بوابة تقييم إلزامية من 4 أسئلة (Score≥3 → حفظ DRAFT في مستودع `Teranoo-Research` الخاص؛ الترقية DRAFT→READY بيد Majed فقط). المكتبة مستودع خاص مستقل **خارج الحزمة** — لا تُوزَّع.
102
+ - **تثبيت معلومات الحزم والموقع (SCP-2026-08-31-002/003)** — `TERA_DISTRIBUTION_POLICY.md` يوثق الآن: الحزم الرسمية (`@tera-system/core`, `@tera-system/pro`)، المستودع الأصلي `https://github.com/Alabasi1980/Teranoo-System`، مستودع الموقع `https://github.com/Alabasi1980/TeraWebsite`، ولوحة النشر `https://coolify.teranoo.com/`. تصحيح `RepositoryUrl` الخاطئ + تذكير bump في الـ Checklist.
103
+
104
+ ## 0.2.10 (2026-08-29)
105
+
106
+ ### ضمان الأداة الخماسية في كل مستودع — Tooling Provisioning (SCP-2026-08-29-012)
107
+
108
+ **ما تغيّر:**
109
+ - **`tools/tera-tooling.ps1` جديد** — سكربت تزويد/تحقق موحّد للأدوات الخمس: Playwright (MCP)، Semgrep (MCP+CLI)، Structurizr (MCP)، Gitleaks (CLI)، Trivy (CLI) — وضع Report أو `-Install` (winget/pip/npx) + جدول حالة + exit code
110
+ - **تفعيل Structurizr MCP** في `opencode.tera.example.json` (`enabled: true`) + تصحيح `STRUCTURIZR_WORKSPACE_DIR` → `architecture` (كان `../architecture` خارج المستودع)
111
+ - **شحن `structurizr-mcp/` (12 ملفاً) + `architecture/` (starter)** في الأصول → يُثبَّتان في جذر أي مستودع (assets 36→49)
112
+ - **السياسة §3.6** — المعيار الخماسي + قاعدة: لا `SKIPPED (tool not installed)` صامت بعد التزويد
113
+
114
+ **لماذا هذا التحديث:**
115
+ - الأدوات الخمس معتمدة في البوابات (SEMGREP_SANITY_CHECK، Trivy/Gitleaks قبل التسليم) لكن توفرها كان "إن وُجد" — السكربت يحوّلها إلى مضمونة بأمر واحد
116
+ - Structurizr كان معطلاً لأن خادمه لا يصل للمستودعات — الآن يُشحن مع الحزمة
117
+
118
+ ---
119
+
120
+ ## 0.2.9 (2026-08-29)
121
+
122
+ ### إعادة تصميم محتوى سندات القبض والصرف وتحديث الترويسة
123
+
124
+ **التحديث:**
125
+ - اعتماد بنية المحتوى المعاد تصميمها: بطاقات رقم السند والتاريخ، بطاقات المبلغ كتابةً ورقماً، حقول المرجع والغرض، خيارات الدفع، والتوقيعات.
126
+ - سند واحد فقط في كل ملف HTML.
127
+ - استخدام `V2.png` لسند القبض و`V1.png` لسند الصرف بعرض 210مم.
128
+ - تضمين جميع أصول مجلد `financial` المطلوبة للتثبيت، بما فيها صور الترويسة.
129
+ - تحديث مقاس السند إلى 210×156مم.
130
+
131
+ ---
132
+
133
+ ## 0.2.8 (2026-08-29)
134
+
135
+ ### سندات القبض والصرف — استخدام شعار Teranoo الرسمي
136
+
137
+ **التحديث:**
138
+ - استُبدلت علامة "T" النصية في ترويسة السندات بـ **شعار Teranoo الرسمي** (مضمّن base64 — ذاتي الاحتواء، يعمل عند الطباعة من أي مكان).
139
+ - الملفان: `financial/VOUCHER_RECEIPT_TEMPLATE.html` + `financial/VOUCHER_PAYMENT_TEMPLATE.html` — 3 سندات لكل A4 (1/3 A4) بخطوط قص.
140
+
141
+ ---
142
+
143
+ ## 0.2.7 (2026-08-29)
144
+
145
+ ### سندات القبض والصرف — تصميم معتمد ومنجز (SCP-2026-08-29-006)
146
+
147
+ **الجديد:**
148
+ - **`financial/VOUCHER_RECEIPT_TEMPLATE.html`** + **`VOUCHER_PAYMENT_TEMPLATE.html`** — سندات قبض/صرف بحجم دفاتر السندات المتعارف (1/3 A4 — 210×99مم، **3 سندات لكل صفحة A4**) مع خطوط قص متقطعة.
149
+ - الحقول المعتمدة: ترويسة Teranoo + رقم السند (تسلسل مالي `{السنة}-{تسلسل}`) + التاريخ + المستلم/المستفيد + المبلغ كتابةً وأرقاماً + **حقل المرجع (يربط بترميز خطابات العميل)** + طريقة الدفع + التوقيعات (مستلم/أمين صندوق/معتمد) + النسخ (أصل/صورة).
150
+ - `financial/VOUCHER_DESIGN_SPEC.md` — وثيقة التصميم المعتمدة.
151
+ - `TeraPricingPolicy §21` قاعدة 5 — توثيق الدفعات بسند قبض والمصروفات بسند صرف.
152
+ - assets 29→32.
153
+
154
+ ---
155
+
156
+ ## 0.2.6 (2026-08-29)
157
+
158
+ ### نظام ترميز الخطابات الصادرة للزبون (SCP-2026-08-29-005)
159
+
160
+ **الجديد:**
161
+ - **صيغة رسمية موحدة:** `{كود-العميل}-{النوع}-{السنة}-{التسلسل}` (مثال: NPB-LET-2026-004) — عبر كل المشاريع والمستودعات.
162
+ - **كود العميل من Majed فقط** — سجل مركزي `project-control/CLIENT_CODES.md` (المصدر الوحيد)، وحارس يرفع طلب كود لكل عميل جديد — الفريدية بنيوية (لا تكرار عبر المستودعات).
163
+ - **أنواع وثائق رسمية** (قابلة للزيادة بقرار Majed): LET / CON / ADD / PAL / DOC / TPL.
164
+ - **سجل خطابات العميل** `client-approval/LETTER_LOG.md` إلزامي — مصدر التسلسل المحلي، يُسجَّل قبل الإرسال.
165
+ - القاعدة في تدفق TCEA (A.4) + TeraClientPolicy §9.6 + خريطة السياسات.
166
+
167
+ ---
168
+
169
+ ## 0.2.5 (2026-08-29)
170
+
171
+ ### ملكية السورس كود + سياسة التسعير (SCP-2026-08-29-004)
172
+
173
+ **الجديد:**
174
+ - **قاعدة ملكية السورس:** السورس كود حق ملكية Tera — لا يُسلَّم للزبون افتراضياً (TeraPricingPolicy §31 + TeraClientPolicy §9.5 + العقد §12).
175
+ - **خيارا شراء:** L1 (Source Access — 40% من سعر المشروع) و L2 (ملكية داخلية — max(3×، 1,000 JOD)) عبر ملحق تعاقدي — وإعادة البيع مرفوضة افتراضياً (L3 = اتفاقية منفصلة بموافقة Majed).
176
+ - **اكتشاف مبكر:** سؤال توقع السورس إلزامي في Domain 13 قبل التسعير (بنك الأسئلة QS.1–QS.4).
177
+ - **نموذج جديد:** `tera-workshop/client-templates/contractual/SOURCE_CODE_PURCHASE_ADDENDUM_TEMPLATE.md` (assets 28→29).
178
+ - **قوالب محدثة:** العقد §8/§12، الاقتباسان (DRAFT + QUOTATION)، تقرير الهاندوف، حزمة تسليم العميل، خريطتا السياسات والمعمارية، مساعد التسعير A.8.6.
179
+
180
+ ---
181
+
182
+ ## 0.2.4 (2026-08-29)
183
+
184
+ ### إصلاح فجوة التغليف: شحن الحاسبة + قوالب المراسلات (SCP-2026-08-29-002)
185
+
186
+ **ما تغيّر:**
187
+ - **مجموعة `assets/` جديدة في الحزمة** — تُثبَّت دائماً (لا تُتخطى كـ skeleton):
188
+ - `project-control/TeraPricingCalculator.xlsx` — الحاسبة الرسمية ("الأداة الوحيدة المعتمدة" للتسعير عند Level 2)
189
+ - `tera-workshop/client-templates/**` — 27 قالباً رسمياً (branding 5، commercial 7، contractual 5، handover 3، pre-contract 7) — منها `letterhead-master-fixed-print.html` الإلزامي لكل عروض وعقود وخطابات
190
+ - إصلاح مرجع قديم: `tera-workshop/APPLICATION_PROPOSAL_TEMPLATE.html` (غير موجود) → `tera-workshop/client-templates/commercial/APPLICATION_PROPOSAL_TEMPLATE.md` في `TeraClientPolicy.md` + `TERA_RUNTIME_TEMPLATES.md`
191
+ - توحيد مسارات أدوات التوزيع: `tera-workshop/tools/` → `tools/` في `TERA_DISTRIBUTION_POLICY.md` + `TeraArchitectureMap.md` + `TeraPolicyMap.md` (الأدوات تُثبَّت فعلياً في `tools/` — الأوامر الموثقة أصبحت تعمل في المستودعات المثبتة عبر npm)
192
+ - تصحيح مرجع قالب المهام: `project-control/tasks/TASK_TEMPLATE.md` → `project-control/templates/TASK_TEMPLATE.md` في `VERSION_LIFECYCLE_PROTOCOL.md` + `TeraPolicyMap.md`
193
+ - تنظيف 35 ملف `.tera-bak-*` من مصدر النظام الحي (بقايا عمليات تثبيت — لا علاقة لها بالحزمة)
194
+
195
+ **لماذا هذا التحديث:**
196
+ - مستودعات العملاء (مثل Omar) كانت تستلم الحزمة ناقصة رغم أن السياسات تفرض هذه الملفات كإلزامية — فجوة تغليف نظامية اكتُشفت عبر تقرير عميل TCEA في مستودع Omar
197
+
198
+ ---
199
+
200
+ ## 0.2.3 (2026-08-28)
201
+
202
+ ### حل الاستعادة عند الحذف بالخطأ + توافق npm 11
203
+
204
+ **ما تغيّر:**
205
+ - إضافة `bin` جديد: `tera-restore` و `tera-core-restore` — يعيد `.opencode/agents` حتى لو حُذفت بالخطأ و `postinstall` محجوب
206
+ - توثيق `npm approve-scripts @tera-system/core` كحل لنظام الأمان الجديد في npm 11
207
+ - قسم جديد في README: "الاستعادة عند الحذف بالخطأ" + ملاحظة في WELCOME.md
208
+
209
+ **لماذا هذا التحديث:**
210
+ - `npm install --force` لم يعد يشغّل `postinstall` تلقائياً بدون موافقة — الحذف بالخطأ كان يتطلب حلاً صريحاً
211
+
212
+ ---
213
+
214
+ ## 0.2.2 (2026-08-28)
215
+
216
+ ### آلية البروتوتايب الإلزامي + مزامنة المنظومة
217
+
218
+ **ما تغيّر:**
219
+ - **البروتوتايب إلزامي لكل تطبيق** (SCP-2026-08-28-001) — الاستثناء الوحيد `WAIVED_BY_MAJED` موثق من Majed
220
+ - بناء البروتوتايب كأول مهمة `TASK-PROTO-*` في `project-control/prototypes/` بواسطة Coding Agents
221
+ - مراجعة البروتوتايب بواسطة `ناقد (DesignReviewer)` — تحول إلى `Tera-managed sub-agent` مع الدروع الثلاثة (حياد/تصعيد/استدعاء مزدوج)
222
+ - خطاب اعتماد رسمي `PROTOTYPE_APPROVAL_LETTER_TEMPLATE.md` — Gate 6 دليل قانوني يربط التعديلات اللاحقة بـ Change Request
223
+ - سلسلة إنفاذ 5 نقاط: `PreExecutionGate #23` + `tera.md Intake` + `Blueprint Readiness` + `Client Protocols` + `Activation Matrix`
224
+ - مزامنة خرائط النظام وتقسيم دليل التحضير (SCP-2026-08-28-003) + إصلاح المراجع التشغيلية (SCP-2026-08-28-004)
225
+
226
+ **لماذا هذا التحديث:**
227
+ - منع اعتراض الزبون على الشاشات بعد التنفيذ الكامل — التصحيح المبكر رخيص، المتأخر مكلف
228
+ - سد ثغرة تفعيل ناقد — Tera يستطيع استدعاءه في التوقيت الصحيح مع الحفاظ على حياده
229
+
230
+ ---
231
+
232
+ ---
233
+
234
+ ## 0.2.0 (2026-08-21)
235
+
236
+ ### النسخة الشخصية النظيفة (Personal Edition)
237
+
238
+ **ما تغيّر:**
239
+ - إزالة كل بوابات الترخيص من الوكلاء والأوامر — هذه النسخة للاستخدام الشخصي الحر
240
+ - إزالة ملفات الحماية (license-gate, integrity, preflight)
241
+ - استعادة `install.js` للنسخة البسيطة الأصلية (تسجيل حالة ترخيص غير مُلزم)
242
+ - الفصل عن الحزمة التجارية: `@tera-system/pro`
243
+
244
+ **لماذا هذا التحديث:**
245
+ - `@tera-system/core` = نسخة شخصية للمالك (Majed) تستخدم في مشاريعه بحرية
246
+ - الحماية التجارية (الترخيص، sync من السيرفر، heartbeat) تنتقل إلى `@tera-system/pro`
247
+
248
+ ---
249
+
250
+ ## 0.1.5 (2026-08-21)
251
+
252
+ ### ترقية: التحقق من الترخيص عبر API (أونلاين) مع fallback أوفلاين
253
+
254
+ **ما تم تحسينه:**
255
+ - **التحقق الأونلاين أولاً:** المُثبِّت يحاول الاتصال بـ API التحقق أولاً
256
+ - **Fallback أوفلاين:** إذا فشل الاتصال، يتحقق محلياً بـ Ed25519
257
+ - **لا يُوقف التثبيت:** التحقق لا يُوقف التثبيت أبداً
258
+ - **dıagnostic واضح:** يُظهر مصدر التحقق (☁️ API / 🔒 Offline / 🔄 Fallback)
259
+
260
+ **المتغيرات البيئية الجديدة:**
261
+ | المتغير | الوصف | القيمة الافتراضية |
262
+ |---------|-------|-------------------|
263
+ | `TERA_LICENSE_API` | رابط API التحقق | `https://teranoo.com/api/license` |
264
+ | `TERA_OFFLINE_ONLY` | تعطيل التحقق الأونلاين | `0` (مفعّل) |
265
+
266
+ **لماذا هذا التحديث:**
267
+ - التحقق الأونلاين يمنع التkey lowering
268
+ - Fallback يضمن عمل التثبيت حتى بدون إنترنت
269
+ - استعداد للعميل الذي يُنفّذ API التحقق
270
+
271
+ **ملاحظات:**
272
+ - API التحقق بانتظار تنفيذ العميل
273
+ - التحقق الأوفلاين يعمل بشكل مستقل حتى بدون API
274
+
275
+ ---
276
+
277
+ ## 0.1.4 (2026-08-21)
278
+
279
+ ### إصلاح: تغيير حالة الترخيص عبر npm
280
+
281
+ **ما تم إصلاحه:**
282
+ - تحديث حالة الترخيص من "Active" إلى "Unlicensed" عبر npm
283
+ - توثيق حالة الترخيص في LICENSE.md
284
+
285
+ **ملاحظات:**
286
+ - هذا إصلاح طارئ بعد النشر
287
+
288
+ ---
289
+
290
+ ## 0.1.1 (2026-08-21)
291
+
292
+ ### تحديث: توضيح الترخيص والتوثيق
293
+
294
+ **ما تم تحسينه:**
295
+ - تحديث `LICENSE.md` — توضيح نموذج "كود مفتوح + ترخيص مدفوع"
296
+ - تحديث `README.md` — جدولة الترخيص والتفعيل والاستخدام
297
+ - إضافة `tera-update` command — كشف التحديثات وإرشاد العميل
298
+ - إضافة `RELEASES.md` — سجل التغييرات (هذا الملف)
299
+ - تغيير الاسم: `@tera/core` → `@tera-system/core`
300
+
301
+ **لماذا هذا التحديث:**
302
+ - العملاء يحتاجون لتوضيح ما المسموح وما الممنوع
303
+ - آلية التحديث يجب أن تكون واضحة ومُوثّقة
304
+
305
+ ---
306
+
307
+ ## 0.1.0 (2026-08-20)
308
+
309
+ ### الإصدار الأول
310
+
311
+ **ما تم تضمينه:**
312
+ - نظام حوكمة كامل (`tera-system/` — 110 ملف)
313
+ - 20 وكيلاً ذكياً متخصصاً (Coding / Quality / Management / Research / Knowledge)
314
+ - 11 أمراً تفاعلياً (جديد/متابعة/تخطيط/مراجعة/تقرير/تفعيل/موافقة/طلب بناء/.diagnose/مساعدة/تحديث)
315
+ - أدوات توزيع (`tools/`)
316
+ - مُثبِّت غير تدميري (يحفظ بيانات المستخدم)
317
+ - آلية ترخيص (Ed25519 — تحقق دون اتصال)
318
+ - `WELCOME.md` — دليل أول 5 دقائق
319
+
320
+ **ماذا يتغير عند التثبيت:**
321
+ - يُنشئ `tera-system/` في جذر المشروع
322
+ - يُنشئ `.opencode/agents/` و`.opencode/commands/` إذا لم تكن موجودة
323
+ - لا يحذف أي ملف موجود أبداً
324
+ - لا يلمس `project-control/` إذا كان موجوداً (بيانات المستخدم)
325
+
326
+ **ملاحظات:**
327
+ - الإصدار الأول — لا توجد مقارنة سابقة
328
+ - آليات التحديث (`tera-update`) مُضافة في هذا الإصدار