@tera-system/core 0.2.2 → 0.2.3

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 (5) hide show
  1. package/MANIFEST.json +1 -1
  2. package/README.md +26 -0
  3. package/RELEASES.md +14 -0
  4. package/WELCOME.md +7 -0
  5. package/package.json +5 -1
package/MANIFEST.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tera-system/core",
3
- "version": "0.2.2",
3
+ "version": "0.2.3",
4
4
  "description": "Build manifest for the Tera System OpenCode Plugin component.",
5
5
  "compatibleEnvironments": [
6
6
  "opencode"
package/README.md CHANGED
@@ -10,6 +10,18 @@ npm install @tera-system/core
10
10
 
11
11
  عند التثبيت، يعمل سكربت `postinstall` تلقائياً على مساحة العمل (المجلد الذي نُفّذ فيه `npm install`).
12
12
 
13
+ > **⚠️ npm 11+ — السماح للسكربت:** إذا ظهر تحذير `allow-scripts` ولم تُنشأ ملفات `.opencode/`، شغّل:
14
+ > ```bash
15
+ > npm approve-scripts @tera-system/core
16
+ > npm install @tera-system/core --force
17
+ > ```
18
+ > أو مباشرة بدون موافقة:
19
+ > ```bash
20
+ > npx tera-restore
21
+ > # أو
22
+ > node node_modules/@tera-system/core/scripts/install.js
23
+ > ```
24
+
13
25
  يمكن ضبط الوجهة صراحةً:
14
26
 
15
27
  ```bash
@@ -30,6 +42,20 @@ node scripts/install.js --target /path/to/workspace
30
42
  | أدوات التوزيع (7 سكربتات) | `tools/` |
31
43
  | سجل الملكية | `.opencode/tera-core.manifest.json` |
32
44
 
45
+ ## الاستعادة عند الحذف بالخطأ
46
+
47
+ إذا حذفت بالخطأ `.opencode/agents/` أو أي مجلد تابع للحزمة، لا تُعد التثبيت عبر `npm update` فقط — شغّل:
48
+
49
+ ```bash
50
+ npx tera-restore
51
+ # أو
52
+ node node_modules/@tera-system/core/scripts/install.js
53
+ # أو
54
+ npx tera-core-restore --target "D:\My Projects\MyApp"
55
+ ```
56
+
57
+ المثبّت سيعيد فقط الملفات المفقودة المملوكة للحزمة دون المساس بملفاتك.
58
+
33
59
  ## سلوك المثبّت (غير مدمر + واعٍ بالملكية)
34
60
 
35
61
  - **لا يحذف أي شيء أبداً.**
package/RELEASES.md CHANGED
@@ -4,6 +4,20 @@
4
4
 
5
5
  ---
6
6
 
7
+ ## 0.2.3 (2026-08-28)
8
+
9
+ ### حل الاستعادة عند الحذف بالخطأ + توافق npm 11
10
+
11
+ **ما تغيّر:**
12
+ - إضافة `bin` جديد: `tera-restore` و `tera-core-restore` — يعيد `.opencode/agents` حتى لو حُذفت بالخطأ و `postinstall` محجوب
13
+ - توثيق `npm approve-scripts @tera-system/core` كحل لنظام الأمان الجديد في npm 11
14
+ - قسم جديد في README: "الاستعادة عند الحذف بالخطأ" + ملاحظة في WELCOME.md
15
+
16
+ **لماذا هذا التحديث:**
17
+ - `npm install --force` لم يعد يشغّل `postinstall` تلقائياً بدون موافقة — الحذف بالخطأ كان يتطلب حلاً صريحاً
18
+
19
+ ---
20
+
7
21
  ## 0.2.2 (2026-08-28)
8
22
 
9
23
  ### آلية البروتوتايب الإلزامي + مزامنة المنظومة
package/WELCOME.md CHANGED
@@ -30,6 +30,13 @@
30
30
  ## ماذا لو توقفت أو حارت؟
31
31
  اكتب `/tera-status` (أين أنت) أو `/tera-diagnose` (فحص ذاتي) — أو سلّم النظام جملة بالعربية تصف مقصدك وسيقودك.
32
32
 
33
+ ## هل حذفت ملفات بالخطأ؟
34
+ إذا اختفت ملفات `.opencode/agents/` بعد `npm install` ولم تظهر، شغّل:
35
+ ```bash
36
+ npx tera-restore
37
+ ```
38
+ ثم أعد فتح OpenCode.
39
+
33
40
  ---
34
41
 
35
42
  **خلاصة:** أنت لست بحاجة لفهم بنية Tera. شغّل الأوامر الأربعة، وافق، وراجع. هذا كل شيء.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tera-system/core",
3
- "version": "0.2.2",
3
+ "version": "0.2.3",
4
4
  "description": "Tera System OpenCode Plugin — governance core, 20 agents, 11 commands, distribution tools (personal edition)",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "type": "module",
@@ -20,6 +20,10 @@
20
20
  "LICENSE.md",
21
21
  "RELEASES.md"
22
22
  ],
23
+ "bin": {
24
+ "tera-restore": "scripts/install.js",
25
+ "tera-core-restore": "scripts/install.js"
26
+ },
23
27
  "scripts": {
24
28
  "postinstall": "node scripts/install.js"
25
29
  },