@tera-system/pro 0.2.1 → 0.2.10

package/MANIFEST.json

@@ -1,6 +1,6 @@
 {
   "name": "@tera-system/pro",
-  "version": "0.2.1",
+  "version": "0.2.10",
   "description": "Build manifest for the Tera System Pro commercial plugin component (THIN mode — content served from teranoo.com signed bundle).",
   "compatibleEnvironments": [
     "opencode"
@@ -11,10 +11,11 @@
     "agents": 20,
     "commands": 11,
     "coreFiles": 112,
-    "tools": 7,
-    "projectControlTemplates": 1
+    "tools": 8,
+    "projectControlTemplates": 1,
+    "assets": 49
   },
-  "bundleRef": "core-bundle-v0.1.4.signed.json (SHA256 4C87BAB833AEC0ACE184A790819B51D58427C51F29124CE2B02DA3AAE98C3F13)",
+  "bundleRef": "core-bundle-v0.2.10.signed.json (SHA256 4F776E78BC2CA99725DD320B9B9EC2C4F05200B52ED7B857BEE487A5F8FD4B13)",
   "builtAt": "2026-08-28",
   "sha256": {
     "agents": "9769b3acc15e44e8ae56e4d585f7b965f6c30eafceea509edd0dfe3ce1d83270",

package/README.md

@@ -5,13 +5,25 @@
 > âڑ ï¸ڈ **ظ‡ط°ظ‡ ط§ظ„ط­ط²ظ…ط© ط§ظ„طھط¬ط§ط±ظٹط© طھطھط·ظ„ط¨ ظ…ظپطھط§ط­ طھط±ط®ظٹطµ طµط§ظ„ط­.** ط¨ط¯ظˆظ† ظ…ظپطھط§ط­طŒ ظ„ط§ طھط¹ظ…ظ„ ط§ظ„ظˆظƒظ„ط§ط، ظˆظ„ط§ ط§ظ„ط£ظˆط§ظ…ط±.
 > ظ„ظ„ط­طµظˆظ„ ط¹ظ„ظ‰ ظ…ظپطھط§ط­: `https://teranoo.com/pricing`
 
-## ط§ظ„طھط«ط¨ظٹطھ (ط£ظ…ط± ظˆط§ط­ط¯)
-
-```bash
-npm install @tera-system/pro
-```
-
-ط¹ظ†ط¯ ط§ظ„طھط«ط¨ظٹطھطŒ ظٹط¹ظ…ظ„ ط³ظƒط±ط¨طھ `postinstall` طھظ„ظ‚ط§ط¦ظٹط§ظ‹ ط¹ظ„ظ‰ ظ…ط³ط§ط­ط© ط§ظ„ط¹ظ…ظ„ (ط§ظ„ظ…ط¬ظ„ط¯ ط§ظ„ط°ظٹ ظ†ظڈظپظ‘ط° ظپظٹظ‡ `npm install`).
+## التثبيت (أمر واحد)
+
+```bash
+npm install @tera-system/pro
+```
+
+عند التثبيت، يعمل سكربت `postinstall` تلقائياً على مساحة العمل (المجلد الذي نُفّذ فيه `npm install`).
+
+> **⚠️ npm 11+ — السماح للسكربت:** إذا ظهر تحذير `allow-scripts` ولم تُنشأ ملفات `.opencode/`، شغّل:
+> ```bash
+> npm approve-scripts @tera-system/pro
+> npm install @tera-system/pro --force
+> ```
+> أو مباشرة بدون موافقة:
+> ```bash
+> npx tera-restore
+> # أو
+> node node_modules/@tera-system/pro/scripts/install.js
+> ```
 
 ظٹظ…ظƒظ† ط¶ط¨ط· ط§ظ„ظˆط¬ظ‡ط© طµط±ط§ط­ط©ظ‹:
 

package/RELEASES.md

@@ -4,6 +4,33 @@
 
 ---
 
+
+## 0.2.10 (2026-08-29)
+
+### First-sale readiness: full content sync with core 0.2.10 + license gates
+
+**What changed:**
+- Synced all content from core 0.2.10: 20 agents, 11 commands, tera-system (112 files), tools (8), opencode.tera.example.json (structurizr enabled)
+- License gates preserved/re-injected: every agent has its LICENSE GATE section, every command its license-gate line (verified 1-per-file)
+- Bundle rebuilt with production key (core-bundle-v0.2.10.signed.json) - 200 files incl. assets (pricing calculator v4.3, 35 client templates, structurizr-mcp, architecture) - binary-safe
+
+**Why:**
+- First commercial sale prep - client must receive the current system (source ownership SCP-004, calculator v4.3, 5-tool standard SCP-012, voucher templates, etc.)
+
+## 0.2.2 (2026-08-28)
+
+### حل الاستعادة عند الحذف بالخطأ + توافق npm 11
+
+**ما تغيّر:**
+- إضافة `bin` جديد: `tera-restore` و `tera-pro-restore` — نفس حل core لكن للحزمة التجارية
+- توثيق `npm approve-scripts @tera-system/pro` كحل لأمان npm 11
+- قسم "الاستعادة عند الحذف بالخطأ" في README
+
+**لماذا هذا التحديث:**
+- نفس مشكلة core — حذف `.opencode/agents` بالخطأ كان يحتاج أمراً صريحاً لا يعتمد على `postinstall`
+
+---
+
 ## 0.2.1 (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/opencode.tera.example.json

@@ -20,9 +20,9 @@
         "structurizr-mcp",
         "structurizr-mcp"
       ],
-      "enabled": false,
-      "env": {
-        "STRUCTURIZR_WORKSPACE_DIR": "../architecture",
+      "enabled": true,
+      "environment": {
+        "STRUCTURIZR_WORKSPACE_DIR": "architecture",
         "STRUCTURIZR_URL": "http://localhost:8081"
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tera-system/pro",
-  "version": "0.2.1",
+  "version": "0.2.10",
   "description": "Tera System Pro — commercial edition (thin): system files are fetched from teranoo.com as a signed bundle; enforced license gate + heartbeat",
   "license": "SEE LICENSE IN LICENSE.md",
   "type": "module",
@@ -17,6 +17,10 @@
     "LICENSE.md",
     "RELEASES.md"
   ],
+  "bin": {
+    "tera-restore": "scripts/install.js",
+    "tera-pro-restore": "scripts/install.js"
+  },
   "scripts": {
     "postinstall": "node scripts/install.js",
     "tera-license": "node scripts/tera-license.mjs",

package/scripts/build-bundle.mjs

@@ -1,12 +1,16 @@
 #!/usr/bin/env node
 /**
- * @tera-system/pro — Signed Core Bundle Builder
+ * @tera-system/pro — Signed Core Bundle Builder (SCP-2026-08-29-013)
  * --------------------------------------------------------------
  * Generates a signed bundle of all core content (agents, commands,
- * tera-system, tools) that the remote server will host as a static
+ * tera-system, tools, assets) that the remote server hosts as a static
  * artifact. The installer/sync module downloads it, verifies the
  * Ed25519 signature, validates hashes, and applies files.
  *
+ * Binary-safe: every file is read as raw bytes and embedded as
+ * base64url — the pricing calculator (.xlsx) and images survive
+ * byte-for-byte.
+ *
  * Usage:
  *   node scripts/build-bundle.mjs [--out artifacts/core-bundle.json]
  *
@@ -52,26 +56,29 @@ function loadPrivateKey() {
   throw new Error("Private key not found. Set TERA_PRIVATE_KEY_PATH.");
 }
 
+// Bundle groups. `assets` is binary-safe and installs to the repo root
+// (project-control/, tera-workshop/, structurizr-mcp/, architecture/).
 const groups = [
   { name: "agents", relDir: "agents" },
   { name: "commands", relDir: "commands" },
   { name: "tera-system", relDir: "core/tera-system" },
   { name: "tools", relDir: "tools" },
+  { name: "assets", relDir: "assets" },
 ];
 
-// Collect all bundle files
+// Collect all bundle files — keep raw Buffer (binary-safe)
 const files = [];
 for (const g of groups) {
   const srcDir = path.join(ROOT, g.relDir);
   for (const f of walkFiles(srcDir)) {
-    files.push({ path: `${g.name}/${f.rel}`, content: fs.readFileSync(f.abs, "utf8") });
+    files.push({ path: `${g.name}/${f.rel}`, buf: fs.readFileSync(f.abs) });
   }
 }
 
-// Build manifest of hashes
+// Build manifest of hashes (over raw bytes)
 const manifest = {};
 for (const f of files) {
-  manifest[f.path] = createHash("sha256").update(f.content).digest("hex");
+  manifest[f.path] = createHash("sha256").update(f.buf).digest("hex");
 }
 
 // Canonical payload to sign: sorted manifest lines
@@ -91,7 +98,7 @@ const bundle = {
   packageVersion: pkg.version,
   createdAt: new Date().toISOString(),
   contentSha256: canonicalHash,
-  files: files.map((f) => ({ path: f.path, data: Buffer.from(f.content, "utf8").toString("base64url") })),
+  files: files.map((f) => ({ path: f.path, data: f.buf.toString("base64url") })),
   manifest,
   signature,
 };
@@ -115,4 +122,4 @@ console.log(`  contentSha256 : ${canonicalHash}`);
 console.log(`  signature     : ${signature.slice(0, 40)}...`);
 console.log(`  full          : ${outPath}`);
 console.log(`  compact       : ${compactPath}`);
-console.log(`  size(full)    : ${(fs.statSync(outPath).size / 1024).toFixed(1)} KB`);
+console.log(`  size(full)    : ${(fs.statSync(outPath).size / 1024).toFixed(1)} KB`);

package/scripts/lib/bundle.mjs

@@ -80,6 +80,7 @@ export function verifyBundle(bundle) {
  *   - .opencode/commands/
  *   - tera-system/
  *   - tools/
+ *   - project-control/, tera-workshop/, structurizr-mcp/, architecture/ (assets group)
  */
 export function applyBundle(bundle, target, { dryRun = false } = {}) {
   if (!Array.isArray(bundle.files)) return { applied: 0, errors: [] };
@@ -89,6 +90,7 @@ export function applyBundle(bundle, target, { dryRun = false } = {}) {
     commands: path.join(target, ".opencode", "commands"),
     "tera-system": path.join(target, "tera-system"),
     tools: path.join(target, "tools"),
+    assets: path.join(target, "."), // calculator, client templates, structurizr-mcp, architecture
   };
 
   let applied = 0;