@tera-system/core 0.2.2 → 0.2.4

package/MANIFEST.json

@@ -1,6 +1,6 @@
 {
   "name": "@tera-system/core",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Build manifest for the Tera System OpenCode Plugin component.",
   "compatibleEnvironments": [
     "opencode"
@@ -11,14 +11,16 @@
     "commands": 11,
     "coreFiles": 111,
     "tools": 7,
-    "projectControlTemplates": 1
+    "projectControlTemplates": 1,
+    "assets": 28
   },
   "sha256": {
-    "agents": "a1c1f61699a9adf389a4655faf2e8d4815265f7b9f6601f4b03b969954be6424",
+    "agents": "0dbd18c2289ef40f0c1a24b6a85d42a4aa02be4228ed5060b4e471cd422943de",
     "commands": "a2520ceef3a3f4e9cec2e4c070aeecd41a215ed12438f81d45111e6c801f9ec2",
-    "core/tera-system": "76129cb2dc6235cf8336f2c52b53453a90d88985310ee4773e1a977e1978016b",
+    "core/tera-system": "9d73d60f1b10460fb5e52ac2b80bd87fd224a6a63354d33268c2a8feb5a10805",
     "tools": "1f96a2de662c50c5c0a4c62d27ec583671c690163a0b35add036bfdd2b3a1f1a",
-    "core/project-control": "cb979181d50e54c9b9b9173ffc890ca021bfaefe9678b1cad4a2f67ceac3dfdd"
+    "core/project-control": "cb979181d50e54c9b9b9173ffc890ca021bfaefe9678b1cad4a2f67ceac3dfdd",
+    "assets": "46e250f6540a6e59f171bc3b34e661185e7c1ad981bca6322bf242c2985651f8"
   },
   "builtAt": "2026-08-28"
 }

package/README.md

@@ -10,6 +10,18 @@ npm install @tera-system/core
 
 عند التثبيت، يعمل سكربت `postinstall` تلقائياً على مساحة العمل (المجلد الذي نُفّذ فيه `npm install`).
 
+> **⚠️ npm 11+ — السماح للسكربت:** إذا ظهر تحذير `allow-scripts` ولم تُنشأ ملفات `.opencode/`، شغّل:
+> ```bash
+> npm approve-scripts @tera-system/core
+> npm install @tera-system/core --force
+> ```
+> أو مباشرة بدون موافقة:
+> ```bash
+> npx tera-restore
+> # أو
+> node node_modules/@tera-system/core/scripts/install.js
+> ```
+
 يمكن ضبط الوجهة صراحةً:
 
 ```bash
@@ -30,6 +42,20 @@ node scripts/install.js --target /path/to/workspace
 | أدوات التوزيع (7 سكربتات) | `tools/` |
 | سجل الملكية | `.opencode/tera-core.manifest.json` |
 
+## الاستعادة عند الحذف بالخطأ
+
+إذا حذفت بالخطأ `.opencode/agents/` أو أي مجلد تابع للحزمة، لا تُعد التثبيت عبر `npm update` فقط — شغّل:
+
+```bash
+npx tera-restore
+# أو
+node node_modules/@tera-system/core/scripts/install.js
+# أو
+npx tera-core-restore --target "D:\My Projects\MyApp"
+```
+
+المثبّت سيعيد فقط الملفات المفقودة المملوكة للحزمة دون المساس بملفاتك.
+
 ## سلوك المثبّت (غير مدمر + واعٍ بالملكية)
 
 - **لا يحذف أي شيء أبداً.**

package/RELEASES.md

@@ -4,6 +4,38 @@
 
 ---
 
+## 0.2.4 (2026-08-29)
+
+### إصلاح فجوة التغليف: شحن الحاسبة + قوالب المراسلات (SCP-2026-08-29-002)
+
+**ما تغيّر:**
+- **مجموعة `assets/` جديدة في الحزمة** — تُثبَّت دائماً (لا تُتخطى كـ skeleton):
+  - `project-control/TeraPricingCalculator.xlsx` — الحاسبة الرسمية ("الأداة الوحيدة المعتمدة" للتسعير عند Level 2)
+  - `tera-workshop/client-templates/**` — 27 قالباً رسمياً (branding 5، commercial 7، contractual 5، handover 3، pre-contract 7) — منها `letterhead-master-fixed-print.html` الإلزامي لكل عروض وعقود وخطابات
+- إصلاح مرجع قديم: `tera-workshop/APPLICATION_PROPOSAL_TEMPLATE.html` (غير موجود) → `tera-workshop/client-templates/commercial/APPLICATION_PROPOSAL_TEMPLATE.md` في `TeraClientPolicy.md` + `TERA_RUNTIME_TEMPLATES.md`
+- توحيد مسارات أدوات التوزيع: `tera-workshop/tools/` → `tools/` في `TERA_DISTRIBUTION_POLICY.md` + `TeraArchitectureMap.md` + `TeraPolicyMap.md` (الأدوات تُثبَّت فعلياً في `tools/` — الأوامر الموثقة أصبحت تعمل في المستودعات المثبتة عبر npm)
+- تصحيح مرجع قالب المهام: `project-control/tasks/TASK_TEMPLATE.md` → `project-control/templates/TASK_TEMPLATE.md` في `VERSION_LIFECYCLE_PROTOCOL.md` + `TeraPolicyMap.md`
+- تنظيف 35 ملف `.tera-bak-*` من مصدر النظام الحي (بقايا عمليات تثبيت — لا علاقة لها بالحزمة)
+
+**لماذا هذا التحديث:**
+- مستودعات العملاء (مثل Omar) كانت تستلم الحزمة ناقصة رغم أن السياسات تفرض هذه الملفات كإلزامية — فجوة تغليف نظامية اكتُشفت عبر تقرير عميل TCEA في مستودع Omar
+
+---
+
+## 0.2.3 (2026-08-28)
+
+### حل الاستعادة عند الحذف بالخطأ + توافق npm 11
+
+**ما تغيّر:**
+- إضافة `bin` جديد: `tera-restore` و `tera-core-restore` — يعيد `.opencode/agents` حتى لو حُذفت بالخطأ و `postinstall` محجوب
+- توثيق `npm approve-scripts @tera-system/core` كحل لنظام الأمان الجديد في npm 11
+- قسم جديد في README: "الاستعادة عند الحذف بالخطأ" + ملاحظة في WELCOME.md
+
+**لماذا هذا التحديث:**
+- `npm install --force` لم يعد يشغّل `postinstall` تلقائياً بدون موافقة — الحذف بالخطأ كان يتطلب حلاً صريحاً
+
+---
+
 ## 0.2.2 (2026-08-28)
 
 ### آلية البروتوتايب الإلزامي + مزامنة المنظومة

package/WELCOME.md

@@ -30,6 +30,13 @@
 ## ماذا لو توقفت أو حارت؟
 اكتب `/tera-status` (أين أنت) أو `/tera-diagnose` (فحص ذاتي) — أو سلّم النظام جملة بالعربية تصف مقصدك وسيقودك.
 
+## هل حذفت ملفات بالخطأ؟
+إذا اختفت ملفات `.opencode/agents/` بعد `npm install` ولم تظهر، شغّل:
+```bash
+npx tera-restore
+```
+ثم أعد فتح OpenCode.
+
 ---
 
 **خلاصة:** أنت لست بحاجة لفهم بنية Tera. شغّل الأوامر الأربعة، وافق، وراجع. هذا كل شيء.

package/agents/tera-client-engagement.md

@@ -213,6 +213,7 @@ Majed يفتحك ← حوار استكشافي ← Websearch عن التطبيق
 ← **تحديد Application Status (A1):** هل هذا تطبيق جديد `[New]` أم تطوير تطبيق قائم `[Existing]`؟ — اسأل Majed صراحة. هذه المعلومة تؤثر على عمق Discovery في Domain 10 (Technical).
 ← إذا طلب Majed تقديراً مبكراً بعد أول مقابلة: يجوز **Level 1 Preliminary Estimate** كنطاق سعري تقريبي غير ملزم فقط — مع تحذير واضح أنه ليس عرض سعر ولا يحتاج B.1/B.2/B.4 أو الحاسبة
 ← تغطية الـ 13 Discovery Domains بعمق متناسب مع حجم المشروع
+← **قبل إغلاق Discovery (Non-Functional Depth — SCP-2026-08-29-001):** غطِّ التصميم والمحتوى والتقنية من وجهة نظر الزبون — مراجع بصرية، ألوان/نبرة، شكل العرض الرئيسي، حقول الشاشات، منطقة الاستضافة (المجالات 4/6/9/10 — Minimum Coverage في discovery-domains.md) — إلزامي قبل إنتاج DISCOVERY_COVERAGE_SUMMARY.md
 ← **إذا كان `[Existing]` (A2):** في Domain 10، أضف أسئلة عن: (1) قاعدة الكود الحالية — التقنيات، الهيكل، (2) Tech Debt Assessment — نقاط الضعف المعروفة، (3) قيود التكامل مع الأنظمة الحالية، (4) متطلبات الترحيل (Data Migration). راجع `discovery-domains.md` لتوجيهات إضافية.
 ← لكل Domain: طبق Self-Check Protocol (A.6.1) قبل إعلان Complete
 ← إذا كان هناك عدم يقين: طبق Uncertainty Protocol (A.6.2) — أخرج قالب STOP — UNCERTAINTY BLOCK