@tera-system/core 0.2.19 → 0.3.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 (35) hide show
  1. package/MANIFEST.json +6 -6
  2. package/RELEASES.md +28 -0
  3. package/agents/auditor.md +17 -0
  4. package/agents/design-reviewer.md +12 -3
  5. package/agents/tera.md +48 -76
  6. package/agents/ui-designer.md +31 -0
  7. package/commands/tera-approve.md +34 -34
  8. package/commands/tera-diagnose.md +47 -47
  9. package/commands/tera-gate.md +40 -40
  10. package/commands/tera-help.md +41 -41
  11. package/commands/tera-new-project.md +35 -35
  12. package/commands/tera-plan.md +34 -34
  13. package/commands/tera-request-build.md +45 -45
  14. package/commands/tera-resume.md +34 -34
  15. package/commands/tera-review.md +52 -52
  16. package/commands/tera-status.md +38 -38
  17. package/commands/tera-update.md +48 -48
  18. package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +2 -0
  19. package/core/tera-system/AGENT_DEPENDENCY_MAP.md +4 -4
  20. package/core/tera-system/TOOLING_AND_MCP_POLICY.md +81 -1
  21. package/core/tera-system/TeraArchitectureMap.md +3 -0
  22. package/core/tera-system/TeraCapabilityMap.md +4 -4
  23. package/core/tera-system/TeraPolicyMap.md +3 -1
  24. package/core/tera-system/image-generation/ASSET_POLICY.md +149 -0
  25. package/core/tera-system/image-generation/IMAGE_TOOL_CONTRACT.md +341 -0
  26. package/core/tera-system/profiles/PROFILES_INDEX.md +1 -0
  27. package/core/tera-system/profiles/node-ts-coolify-postgres.md +93 -0
  28. package/core/tera-system/profiles/rust.md +164 -0
  29. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS.md +1 -1
  30. package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES.md +5 -4
  31. package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md +59 -0
  32. package/core/tera-system/semgrep-rules/tera-security.yml +119 -10
  33. package/package.json +2 -2
  34. package/scripts/install.js +20 -15
  35. package/scripts/tera-license.mjs +0 -63
@@ -1,48 +1,48 @@
1
- ---
2
- description: كشف التحديثات المتاحة وتحديث المنظومة
3
- ---
4
-
5
- أنت Tera Agent. المستخدم يطلب التحقق من وجود تحديثات للمنظومة.
6
-
7
- ## الإجراء
8
-
9
- ### 1. اكشف الإصدار الحالي
10
- اقرأ ملف `package.json` من مجلد الحزمة المُثبَّة (محتمل في `node_modules/@tera/core/package.json`) واستخرج `version`.
11
-
12
- ### 2. اكشف الإصدار الأحدث
13
- شغّل الأمر التالي في الطرفية:
14
- ```bash
15
- npm view @tera/core version 2>/dev/null || echo "unavailable"
16
- ```
17
- إذا كان الناتج `unavailable`، أبلغ المستخدم أن السجل غير متاح حالياً (ربما لم يُنشر بعد أو لا يوجد اتصال).
18
-
19
- ### 3. قارن الإصدارين
20
- - **متساويان؟** → أبلغ المستخدم: "أنت على أحدث إصدار."
21
- - **الإصدار الأحدث متاح؟** → انتقل للخطوة 4.
22
-
23
- ### 4. أظهر التغييرات
24
- اقرأ ملف `RELEASES.md` من مجلد الحزمة (محتمل في `node_modules/@tera/core/RELEASES.md`) وأعرض التغييرات من الإصدار الحالي إلى الأحدث.
25
-
26
- إذا لم يكن `RELEASES.md` متاحاً، أبلغ المستخدم بالتحديث المتاح بدون تفاصيل.
27
-
28
- ### 5. ارشد المستخدم للتحديث
29
- أخبر المستخدم:
30
- ```
31
- الإصدار الجديد جاهز. للتحديث:
32
- 1. شغّل: npm install @tera/core@latest
33
- 2. أعد تشغيل OpenCode
34
- 3.icals: /tera-status للتأكد من نجاح التحديث
35
- ```
36
-
37
- **تنبيه مهم:** إذا كان هناك تغييرات جذرية (مذكورة في RELEASES.md)، اقرأها واحذر المستخدم منها.
38
-
39
- ### 6. لا تنفّذ التحديث تلقائياً
40
- لا تشغل `npm install` بدون إذن المستخدم. فقط ارشده.
41
-
42
- ## ملاحظات
43
- - لا تستخدم `--global` — الحزمة خاصة (restricted).
44
- - إذا فشل الأمر، أبلغ المستخدم برسالة الخطأ ولا تحاول مرات متعددة.
45
- - إذا كان المستخدم في وضع تجريبي (Trial)، أخبره أن التحديث لا يتطلب مفتاح تفعيل.
46
-
47
- ## اختم بجملة:
48
- > هل تريد أن تُحدّث الآن؟ شغّل الأمر أعلاه وأنا سأتحقق من نجاح التحديث.
1
+ ---
2
+ description: كشف التحديثات المتاحة وتحديث المنظومة
3
+ ---
4
+
5
+ أنت Tera Agent. المستخدم يطلب التحقق من وجود تحديثات للمنظومة.
6
+
7
+ ## الإجراء
8
+
9
+ ### 1. اكشف الإصدار الحالي
10
+ اقرأ ملف `package.json` من مجلد الحزمة المُثبَّة (محتمل في `node_modules/@tera/core/package.json`) واستخرج `version`.
11
+
12
+ ### 2. اكشف الإصدار الأحدث
13
+ شغّل الأمر التالي في الطرفية:
14
+ ```bash
15
+ npm view @tera/core version 2>/dev/null || echo "unavailable"
16
+ ```
17
+ إذا كان الناتج `unavailable`، أبلغ المستخدم أن السجل غير متاح حالياً (ربما لم يُنشر بعد أو لا يوجد اتصال).
18
+
19
+ ### 3. قارن الإصدارين
20
+ - **متساويان؟** → أبلغ المستخدم: "أنت على أحدث إصدار."
21
+ - **الإصدار الأحدث متاح؟** → انتقل للخطوة 4.
22
+
23
+ ### 4. أظهر التغييرات
24
+ اقرأ ملف `RELEASES.md` من مجلد الحزمة (محتمل في `node_modules/@tera/core/RELEASES.md`) وأعرض التغييرات من الإصدار الحالي إلى الأحدث.
25
+
26
+ إذا لم يكن `RELEASES.md` متاحاً، أبلغ المستخدم بالتحديث المتاح بدون تفاصيل.
27
+
28
+ ### 5. ارشد المستخدم للتحديث
29
+ أخبر المستخدم:
30
+ ```
31
+ الإصدار الجديد جاهز. للتحديث:
32
+ 1. شغّل: npm install @tera/core@latest
33
+ 2. أعد تشغيل OpenCode
34
+ 3.icals: /tera-status للتأكد من نجاح التحديث
35
+ ```
36
+
37
+ **تنبيه مهم:** إذا كان هناك تغييرات جذرية (مذكورة في RELEASES.md)، اقرأها واحذر المستخدم منها.
38
+
39
+ ### 6. لا تنفّذ التحديث تلقائياً
40
+ لا تشغل `npm install` بدون إذن المستخدم. فقط ارشده.
41
+
42
+ ## ملاحظات
43
+ - لا تستخدم `--global` — الحزمة خاصة (restricted).
44
+ - إذا فشل الأمر، أبلغ المستخدم برسالة الخطأ ولا تحاول مرات متعددة.
45
+ - إذا كان المستخدم في وضع تجريبي (Trial)، أخبره أن التحديث لا يتطلب مفتاح تفعيل.
46
+
47
+ ## اختم بجملة:
48
+ > هل تريد أن تُحدّث الآن؟ شغّل الأمر أعلاه وأنا سأتحقق من نجاح التحديث.
@@ -239,6 +239,8 @@
239
239
  - Brief reason for activation
240
240
  ```
241
241
 
242
+ اسم الـ Trigger في ملف المهمة (`Activation Trigger`) يجب أن يستخدم الـ IDs المعيارية من §1 حرفياً — لا صياغة حرة (SCP-2026-09-16-001).
243
+
242
244
  ---
243
245
 
244
246
  ## 6. إلغاء التفعيل أو التعطيل المؤقت
@@ -15,7 +15,7 @@
15
15
  | Agent | يتم استدعاؤه بواسطة | يستدعي/يشير إلى | يقرأ من |
16
16
  |-------|-------------------|----------------|---------|
17
17
  | **tera.md** | — (Engineering Delivery Lead — phases 5–7 — SCP-118) | `ui-designer.md`, `engineering-agent.md`, `engineering-agent-typescript.md`, `engineering-agent-phaser.md`, `engineering-agent-dotnet.md`, `tera-software-designer.md`, `auditor.md` | `tera-system/runtime/TERA_RUNTIME_*.md`, `project-control/`, `ENGINEERING_HANDOFF_PACKAGE.md` |
18
- | **ui-designer.md** | `tera.md`, `tera-system-evolution.md` (للأغراض النظامية) | `design-reviewer.md` (ناقد يراجعه)، `engineering-agent-typescript.md` (يسلّم له UI Spec) | `28_UI_UX_GUIDELINES.md`, `tera-system/design-system/*.md` |
18
+ | **ui-designer.md** | `tera.md`, `tera-system-evolution.md` (للأغراض النظامية) | `design-reviewer.md` (ناقد يراجعه)، `engineering-agent-typescript.md` (يسلّم له UI Spec)، Image Tool Layer (يستدعي أدواتها الأربع المشتركة — SCP-2026-09-12-002) | `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` |
19
19
  | **engineering-agent.md** | `tera.md` | `ui-designer.md` (مصمم يسبقه)، `tera-software-designer.md` (يسبقه للمهام المعقدة) | `TECHNICAL_SPECIFICATION.md`, `28_UI_UX_GUIDELINES.md` |
20
20
  | **engineering-agent-typescript.md** 🆕 | `tera.md` | `ui-designer.md` (يستلم منه UI Spec)، `engineering-agent-phaser.md` (يملك integration bridge معه) | `engineering-agent-core.md`, Active Technology Profile, `28_UI_UX_GUIDELINES.md` |
21
21
  | **engineering-agent-phaser.md** 🆕 | `tera.md` | `engineering-agent-typescript.md` (يملك bridge معه عبر Tera) | `engineering-agent-core.md`, Active Technology Profile, game design documents |
@@ -71,11 +71,11 @@ ui-designer.md
71
71
 
72
72
  | الملف | الحجم (سطور) | الحالة / ملاحظات |
73
73
  |-------|-------------|-----------------|
74
- | `tera.md` | 520 | 🟢 < 700 — +4 (SCP-2026-08-16-003: READY FOR OWNER ACCEPTANCE §12) |
74
+ | `tera.md` | 558 | 🟢 < 700 — +005: micro-fixes (presentation/WAIVED/29–39/commands pointer) — من 556 |
75
75
  | `tera-system/TeraSubAgents.md` | 855 | 🟡 700–1000 — يحتاج دراسة تقسيم قريبة |
76
76
  | `tera-system/TeraHelperAgents.md` | 970 | 🟡 700–1000 — يحتاج دراسة تقسيم قريبة |
77
77
  | `tera-system/runtime/TERA_RUNTIME_TEMPLATES.md` | 908 | 🟡 700–1000 — +5 (SCP-2026-08-16-001: ملاحظة تفويض المدققين §2) — تقسيم مكتمل سابقاً (INS-02) |
78
- | `tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md` | 514 | 🟢 < 700 — +9 (SCP-2026-08-16-003: §32 Owner Approval fields + §33 items 10–11) |
78
+ | `tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md` | 646 | 🟢 < 700 — +57 (SCP-2026-09-16-004: §39 Audit Trail template — من 589) |
79
79
  | `tera-system/runtime/TERA_RUNTIME_TEMPLATES_PREPARATION.md` | 344 | 🟢 < 700 — جديد INS-02 (§35–40) |
80
80
  | `tera-system/runtime/TERA_RUNTIME_PROTOCOLS.md` | 50 | 🟢 < 700 — §19 فقط (Knowledge Management) بعد تقسيم INS-02 continuation |
81
81
  | `tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md` | 799 | 🟡 700–1000 — +31 (SCP-2026-08-16-003: Owner Approval Gate + Cross-Record Consistency §4) — قريب من الحد — مراقبة |
@@ -83,7 +83,7 @@ ui-designer.md
83
83
  | `tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md` | 646 | 🟢 < 700 — +1 (SCP-2026-08-16-003: Phase 6 بند 8) |
84
84
  | `tera-system/TeraPreExecutionGate.md` | 818 | 🟡 700–1000 — +18 (SCP-2026-08-16-003: Owner Approval Gate + Checklist 33–35) |
85
85
  | `tera-client-engagement.md` | 892 | 🟡 700–1000 — توسعة Dual-Track عبر SCP-2026-07-29-001 + سطر Non-Functional Depth A.4 (SCP-2026-08-29-001) |
86
- | `auditor.md` | 665 | 🟢 < 700 — +22 (SCP-2026-08-16-001: Independent Scope Discovery §6.1) |
86
+ | `auditor.md` | 682 | 🟢 < 700 — +17 (SCP-2026-09-16-001: NOT_REQUIRED Spot-Check §5.4) — يقترب من 700، يُراقب |
87
87
  | `qa-agent.md` | 498 | 🟢 < 700 — +23 (SCP-2026-08-16-001: Independent Discovery §3.1 + NOT VERIFIED) |
88
88
  | `tera-system-evolution.md` | 754 | 🟡 700–1000 — قريب من الحد — يحتاج مراقبة |
89
89
  | `tera-strategic-advisor.md` | 325 | 🟢 < 700 |
@@ -227,7 +227,6 @@ powershell -ExecutionPolicy Bypass -File .\tools\tera-tooling.ps1 -Install
227
227
  ---
228
228
 
229
229
  ### 3.8 خطة Cloud المرجعية — DigitalOcean (SCP-2026-09-02-001 — بلا تثبيت الآن)
230
-
231
230
  عند أول رفع تطبيق على DigitalOcean، تُفعَّل هذه الحزمة في جلسة واحدة (Anti-Bloat: لا تثبيت قبل الحاجة):
232
231
 
233
232
  | الأداة | الشكل | الاستخدام | التزويد |
@@ -241,6 +240,87 @@ powershell -ExecutionPolicy Bypass -File .\tools\tera-tooling.ps1 -Install
241
240
 
242
241
  ---
243
242
 
243
+ ### 3.9 أدوات توليد الصور — Image Tool Layer (SCP-2026-09-12-002/2026-09-13-002/2026-09-13-003)
244
+
245
+ طبقة أدوات مشتركة مستقلة — يستدعيها `ui-designer` حالياً، وقابلة لإعادة الاستخدام من عملاء مستقبليين إن سمحت السياسة. العقد في `tera-system/image-generation/IMAGE_TOOL_CONTRACT.md` والسياسة في `ASSET_POLICY.md`. التنفيذ: `image-tools-flux-mcp` (محلي — FLUX.2 klein 4B: توليد + تعديل). الحزمة القديمة `image-tools-mcp` (SD 1.5) **أُزيلت** (SCP-2026-09-13-003).
246
+
247
+ | الأداة | النوع | الغرض |
248
+ |---|---|---|
249
+ | `generate_image` | Tool (مؤقت فقط) | إنشاء صورة من وصف — تُرجع `image_id` مؤقتاً، لا تحفظ في المشروع |
250
+ | `edit_image` | Tool (مؤقت فقط) | تعديل صورة موجودة — تُرجع ناتجاً مؤقتاً مع `parent_ref` |
251
+ | `save_asset` | Tool (نقطة الحوكمة) | الوحيدة التي تكتب في `project-assets/visual/` — تفرض سياسة الأصول |
252
+ | `read_visual_baseline` | Shared context | قراءة هوية المشروع قبل التوليد المهم — غيابها ليس خطأ |
253
+ | `analyze_image` | قدرة مستقبلية فقط | لا تُبنى كأداة الآن — تُمرَّر المراجع مباشرة إن دعم الموديل الـVision |
254
+
255
+ **حدود المزود (Adapters — المنفذ محلياً في `image-tools-flux-mcp`):**
256
+
257
+ ```text
258
+ OpenAIImageAdapter — مزود مدفوع اختياري (provider="openai" الصريح فقط).
259
+ LocalOpenVINOAdapter — المزود الافتراضي (FLUX.2 klein 4B INT4 عبر OpenVINO:
260
+ توليد + تعديل بمرجع واحد من نفس التصدير).
261
+ model_hint تجريد فقط: fast / precision / auto.
262
+ أسماء الموديلات الفعلية داخل الـAdapters حصراً — ممنوع تسريبها لعقد أي وكيل.
263
+ مفاتيح API من البيئة فقط — Tool Layer لا تراها أبداً.
264
+ لا fallback آلي بين المزودين — الاختيار صريح (auto = المحلي أولاً).
265
+ ```
266
+
267
+ **قواعد إلزامية:**
268
+
269
+ 1. كل استدعاء generate/edit يمر عبر **Cost Guard قابل للتهيئة** قبل أي اتصال — لا رقم ثابت في المعمارية.
270
+ 2. لا fallback تلقائي بين المزودات — الفشل = STOP صريح.
271
+ 3. سلامة المحتوى = ضوابط المزود + سياسة الأداة المبسطة — لا Moderation Framework خاص.
272
+ 4. كل أصل محفوظ يحمل Metadata (13 حقلاً: 10 أساسية + 3 provenance حوكمي — انظر العقد §7) بجانبه (`*.meta.json`). حقول التوليد/النسب مشتقة من `image_id` بواسطة الطبقة وغير قابلة للتجاوز من المتصل (العقد §7.1).
273
+
274
+ ---
275
+
276
+ ### 3.10 أدوات توليد الصوت — Audio Tool Layer (SCP-2026-09-13-001/2026-09-13-003)
277
+
278
+ طبقة أدوات مستقلة — التنفيذ: `audio-tools-mcp` (محلي بالكامل). التوجيه تلقائي حسب اللغة، والاستنساخ الصوتي عبر Chatterbox فقط.
279
+
280
+ | الأداة | النوع | الغرض |
281
+ |---|---|---|
282
+ | `generate_audio` | Tool (مؤقت فقط) | إنشاء صوت من نص — تُرجع `audio_id` مؤقتاً (`engine`: `auto` / `kokoro` / `chatterbox`) |
283
+ | `save_audio` | Tool (نقطة الحفظ) | الوحيدة التي تكتب WAV + `*.meta.json` في أي مجلد |
284
+ | `list_voices` | Shared context | سرد الأصوات المتاحة لكل محرك |
285
+
286
+ **المحركات (داخل الـAdapters حصراً):**
287
+
288
+ ```text
289
+ Kokoro-82M (OpenVINO GenAI Text2SpeechPipeline) — إنجليزية + 8 لغات أوروبية،
290
+ 54 صوتاً، توليد سريع (~4-7 ث/جملة)، 24kHz.
291
+ Chatterbox Multilingual (ONNX CPU) — العربية + 22 لغة، استنساخ صوت من مرجع
292
+ (reference_audio)، تحكم exaggeration، توليد أثقل (~50 ث).
293
+ التوجيه: auto → Kokoro للغات المدعومة منه، Chatterbox لغيرها (العربية) أو عند
294
+ وجود reference_audio. قيد موثق: جدول embeddings في تصدير ONNX مقتطع عند 2352
295
+ رمزاً — الهمزات العربية تُطبَّع تلقائياً (أ→ا، ؤ→و، ئ→ي).
296
+ ```
297
+
298
+ **خارطة الطريق المعلنة:** المنظومة تدعم اليوم **إنشاء الصور وتعديلها + إنشاء الصوت + هيكل الموسيقى/الأغاني (ACE-Step v1.5 هيكلاً — التشغيل الكامل مؤجل لطول زمن CPU)** — لاحقاً: **إنشاء الفيديو وتعديله**.
299
+
300
+ ---
301
+
302
+ ### 3.11 أدوات توليد الموسيقى — Music Tool Layer (SCP-2026-09-13-music — هيكل)
303
+
304
+ طبقة أدوات مستقلة — التنفيذ: `music-tools-mcp` (هيكل MCP مثبت، MIT). النموذج: ACE-Step v1.5 (أغنية كاملة بكلمات أو موسيقى آلية — 10–600 ث، 50+ لغة).
305
+
306
+ | الأداة | النوع | الغرض |
307
+ |---|---|---|
308
+ | `generate_music` | Tool (مؤقت فقط) | إنشاء موسيقى/أغنية من وصف + كلمات اختيارية — تُرجع `audio_id` مؤقتاً |
309
+ | `generate_sfx` | Tool (مؤقت فقط) | إنشاء مؤثر صوتي من وصف — تُرجع `audio_id` مؤقتاً (MOSS-SoundEffect v2.0) |
310
+ | `save_music` | Tool (نقطة الحفظ) | الوحيدة التي تكتب WAV + `*.meta.json` في أي مجلد |
311
+
312
+ **المحرك (داخل الـAdapter حصراً):**
313
+
314
+ ```text
315
+ ACE-Step v1.5 (MIT) — Diffusion + LM هجين، <4GB VRAM على GPU، CPU مدعوم لكن بطيء
316
+ (دقائق لكل دقيقة على Iris Xe — مقبول حسب موافقة المالك). النموذج مُنزَّل محلياً
317
+ في music-probe/ACE-Step-1.5/checkpoints (28 ملف، ~15GB) — مجتاهلة من git.
318
+ الحالة الحالية: هيكل MCP يتحقق من وجود النقاط ويرجع ENGINE_ERROR توضيحي حتى
319
+ يُقاس أول توليد CPU كامل (probe مؤجل — الاستيراد وحده >300ث).
320
+ MOSS-SoundEffect v2.0 (Apache 2.0) — DiT 1.3B + DAC VAE + Qwen3، 11.2GB، حتى 30ث @48kHz،
321
+ هيكل SFX مضاف (generate_sfx) — التنزيل والتشغيل مؤجلان لنفس السبب.
322
+ ```
323
+
244
324
  ## 4. MCPs المؤجلة (ليست الآن)
245
325
 
246
326
  | الأداة | السبب | وقت التفعيل المقترح |
@@ -18,6 +18,7 @@ It is a map, not a policy source. Rules remain in the files listed in `TeraPolic
18
18
  | Client engagement and approval | Manages client profile, contacts, approval package, and change control — the commercial truth layer | `TeraClient*.md`, `clients/`, `.opencode/agents/tera-client-engagement.md` |
19
19
  | Solution preparation (phases 1–4) | Owned by مُهندس (ApplicationBlueprintAgent). Converts confirmed handoff into blueprint, intake, project decision, preparation planning, delegation, cross-review, baseline, and Engineering Handoff Package | `.opencode/agents/application-blueprint.md`, `Tera_Project_Preparation_Files.md`, `project-preparation/`, `runtime/TERA_SOLUTION_PREPARATION_*.md` |
20
20
  | Design governance | Controls design source decisions, design tokens, component rules, internal kits, and UI acceptance | `tera-system/design-system/`, `project-preparation/28_UI_UX_GUIDELINES.md` |
21
+ | Image generation capability | Shared Tool Layer (4 tools: generate/edit/save/baseline) + provider adapter boundary + visual asset storage — used by ui-designer, reusable by future agents per policy. No provider code in this phase (contract + policy only). SCP-2026-09-12-002 | `tera-system/image-generation/IMAGE_TOOL_CONTRACT.md`, `tera-system/image-generation/ASSET_POLICY.md`, `project-assets/visual/` per project |
21
22
  | Engineering handoff gate | Two-gate handoff between مُهندس and Tera: Solution Readiness Gate → Engineering Handoff Package → Engineering Intake Gate | `ENGINEERING_HANDOFF_PACKAGE.md`, `project-control/` |
22
23
  | Execution orchestration (phases 5–7) | Owned by TeraAgent (Engineering Delivery Lead). Execution planning, delegation to Coding/QA/Audit agents, Pre/Post gates, implementation, delivery, closure | `TeraPreExecutionGate.md`, `runtime/TERA_RUNTIME_*.md`, `project-control/` |
23
24
  | Technical specialization | Keeps stack-specific behavior outside the generic Tera system | `tera-system/profiles/` |
@@ -49,6 +50,8 @@ It is a map, not a policy source. Rules remain in the files listed in `TeraPolic
49
50
  | `book-pro-user-guide/` | دليل المشتري العملي لـ Pro — من التثبيت إلى التسليم (Onboarding) — 13 فصل + مولد HTML | Runtime operational files; per-project records |
50
51
  | `architecture/` | Structurizr C4 workspace (`.dsl` source of truth + exported diagrams) | Application code; client project files |
51
52
  | `security-reports/` | Adversarial security validation outputs (authorization, attack surface, evidence, findings, observer/audit reports, gate decisions) — same repo, outside the application folder (SCP-2026-09-02-001) | Application code; client-owned files; system policy files |
53
+ | `project-assets/visual/` (per project) | Visual assets governed by `ASSET_POLICY.md`: `references/` (design-only, never Build/Runtime), `production/` + `icons/` (Build/Runtime only when approved), `marketing/` (never Build/Runtime) — SCP-2026-09-12-002 | Unapproved drafts consumed by application code; reference assets in Build/Runtime |
54
+ | `tera-system/image-generation/` | Image capability system reference: tool contract + asset policy (contract + policy only — no provider code) — SCP-2026-09-12-002 | Provider implementation, API keys, generated images |
52
55
 
53
56
  ## 4. Core Flow
54
57
 
@@ -76,8 +76,8 @@
76
76
  | الفئة | اللغات | آلية التنفيذ |
77
77
  |---|---|---|
78
78
  | 🥇 **متخصصة (Specialist)** | C#/.NET، TypeScript/Node.js/React، Phaser 3 (JS) | عميل متخصص مخصص بمعايير كاملة |
79
- | 🥈 **مغطاة ببروفايل** | Dart/Flutter، Razor Pages+ADO.NET، Next.js+Prisma، WPF، Blazor+EF، React PWA | Fallback + بروفايل (قواعد Scaffold/ORM/CLI موثقة) |
80
- | 🥉 **غير مغطاة (أي لغة أخرى)** | PHP/Laravel، Python/Django، Java/Spring، Go، Ruby، Kotlin، Swift، Rust... | **Fallback العام مباشرة** — يعمل بلا بروفايل (بجودة أقل) أو ببروفايل (بجودة موثقة) |
79
+ | 🥈 **مغطاة ببروفايل** | Dart/Flutter، Razor Pages+ADO.NET، Next.js+Prisma، WPF، Blazor+EF، React PWA، **Rust (Draft)** | Fallback + بروفايل (قواعد Scaffold/ORM/CLI موثقة) — Rust: بروفايل `rust.md` (Draft — Needs Verification، SCP-2026-09-04-011) |
80
+ | 🥉 **غير مغطاة (أي لغة أخرى)** | PHP/Laravel، Python/Django، Java/Spring، Go، Ruby، Kotlin، Swift... | **Fallback العام مباشرة** — يعمل بلا بروفايل (بجودة أقل) أو ببروفايل (بجودة موثقة) |
81
81
 
82
82
  ### 2.3 المعادلة الحاكمة
83
83
 
@@ -98,7 +98,7 @@
98
98
  | المستوى | اللغات | الموقف |
99
99
  |---|---|---|
100
100
  | **ذكاء عالي + أداة** | Python، TypeScript/JS، C#، Java، Go، PHP، C/C++ | ✅ تنفيذ موثوق بجودة عالية حتى بلا بروفايل |
101
- | **ذكاء متوسط + أداة** | Dart، Ruby، Kotlin، Swift (ببيئة Mac)، Rust | ✅ يعمل — بروفايل يرفع الجودة |
101
+ | **ذكاء متوسط + أداة** | Dart، Ruby، Kotlin، Swift (ببيئة Mac)، Rust (بروفايل Draft — SCP-2026-09-04-011) | ✅ يعمل — بروفايل يرفع الجودة |
102
102
  | **ذكاء محدود + أداة** | لغات نادرة/جديدة/إصدارات حديثة جداً | ⚠️ يعمل لكن بخطأ محتمل — بروفايل شبه إلزامي |
103
103
  | **أي مستوى بلا أداة** | أي لغة بلا CLI/بيئة بناء | 🔴 تتوقف عند "الكتابة" ولا تصل "التسليم" |
104
104
 
@@ -164,7 +164,7 @@
164
164
 
165
165
  **الموانع/التحديات الحقيقية:**
166
166
  1. **Unity/Unreal ليست "لغة تكتبها" — بل "محرك + أدوات + مسار أصول"**: البناء ليس `dotnet build`؛ بل مشروع محرك (Editor/Project files) + Asset pipeline + إصدار لكل منصة. البروفايل العادي (Scaffold/ORM/CLI) **لا يكفي** — يحتاج بروتوكول محرك كامل.
167
- 2. **الأصول (Assets)**: الصور/النماذج/الصوت/الأنيميشن — إنتاجها خارج قدرة كود (يحتاج أدوات تصميم أو مصادر جاهزة). المنظومة تنتج **الكود والمنطق**، لا المحتوى الفني.
167
+ 2. **الأصول (Assets)**: النماذج/الأنيميشن/الفيديو — إنتاجها خارج قدرة كود (يحتاج أدوات تصميم أو مصادر جاهزة). **استثناءات تحققت محلياً:** **الصور** (إنشاء + تعديل عبر FLUX.2 klein) و**الصوت المنطوق** (TTS عربي/إنجليزي عبر Kokoro + Chatterbox) و**الموسيقى/الأغاني** (ACE-Step v1.5 MIT — أغنية كاملة بكلمات أو موسيقى آلية، هيكل مثبت وتشغيل CPU مؤجل لطول زمن التوليد) — المنظومة تنتج **الكود والمنطق**، والآن أيضاً الصور والصوت والموسيقى — لاحقاً: إنشاء/تعديل الفيديو.
168
168
  3. **3D Physics/الرسوميات** — أداء GPU/WebGL، تحسينات متقدمة — معرفة متخصصة فعلاً.
169
169
  4. **منصات النشر** — متجر Steam/App Store/Play — حسابات وتراخيص خارجية (قرار تجاري).
170
170
  5. **الألعاب الجماعية (Multiplayer)**: ممكنة (WebSocket + خادم) لكنها ترفع التعقيد أضعافاً.
@@ -64,6 +64,8 @@ Project files record project-specific decisions.
64
64
  | Technology profiles | `tera-system/profiles/` | `.opencode/agents/tera.md` | Stack-specific rules stay in profiles. |
65
65
  | System capability map | `tera-system/TeraCapabilityMap.md` | Not applicable | مرجع معرفي (ليس سياسة): قدرات المنظومة — اللغات وأنواع التطبيقات القابلة للتنفيذ مع حدودها (SCP-2026-09-04-004). السياسات الحاكمة تبقى في هذا الملف. |
66
66
  | Design governance layer | `tera-system/design-system/` | `.opencode/agents/tera.md`, `TERA_RUNTIME_CHECKLISTS.md`, `TERA_RUNTIME_PROTOCOLS_CORE.md` | Governs Design Source Decision, DESIGN.md integration, internal kits, design tokens, component rules, and UI Acceptance Gate. |
67
+ | Image tool contract | `tera-system/image-generation/IMAGE_TOOL_CONTRACT.md` | `.opencode/agents/ui-designer.md` (§8.5) | Contract for the 4 shared image tools (generate/edit/save/baseline) + validation + errors + temp lifecycle. Provider-agnostic. SCP-2026-09-12-002. |
68
+ | Visual asset policy | `tera-system/image-generation/ASSET_POLICY.md` | `.opencode/agents/ui-designer.md` (§8.5) | Storage layout `project-assets/visual/{references,production,icons,marketing}/` + approval-scope rules + baseline_missing guardrail + rights-laundering block. SCP-2026-09-12-002. |
67
69
  | Monitor audit framework | `.opencode/agents/monitor.md` | `ENGINEERING_AGENT_RESPONSIBILITIES.md` | Governs the 7 immutable audit rules, reference hierarchy, plan rejection authority, and cumulative audit for plan-compliance checking. |
68
70
  | Auditor audit framework | `.opencode/agents/auditor.md` | `ENGINEERING_AGENT_RESPONSIBILITIES.md` | Governs Auditor as a Tera-managed quality gate sub-agent, including diff-first scope, evidence model, QUAUD reporting, and authorized invocation by Tera/Monitor. |
69
71
  | Security Team (فريق الحماية) — SCP-2026-09-02-001 | `.opencode/agents/red-team-agent.md` (الشبح) + `.opencode/agents/security-observer.md` (العين) + `.opencode/agents/security-auditor.md` (القاضي) + `tera-system/TeraHelperAgents.md` §6.1 (الدرع) | `security-reports/` في المستودع + البروتوكول الأمني v2.0 (خارج المستودع) | فريق أمني رباعي الأدوار: الدرع (دفاعي أثناء التطوير) + الشبح (هجومي — Phase 7 أو طلب Majed) + العين (مراقب متزامن) + القاضي (تدقيق مستقل وقرار البوابة). فصل الأدوار ملزم بالبروتوكول §2. التفعيل: Phase 7 أو طلب Majed فقط. المخرجات في `security-reports/` خارج مجلد التطبيق. |
@@ -108,7 +110,7 @@ Project files record project-specific decisions.
108
110
  | Business Transformation Consultant (BTCA) | `.opencode/agents/tera-business-transformation-consultant.md` | `tera-system/consulting-helpers/BTCA_METHODOLOGY_FRAMEWORK.md`, `BTCA_REPORT_TEMPLATES.md` | عميل مستقل للاستشارات الإدارية والتنظيمية غير البرمجية — Track C. SCP-2026-07-29-002. |
109
111
  | BTCA — Methodology Framework | `tera-system/consulting-helpers/BTCA_METHODOLOGY_FRAMEWORK.md` | `.opencode/agents/tera-business-transformation-consultant.md` | إطار المنهجية: تصنيف الأدلة الخماسي، مراحل العمل، دليل المقابلات، هيكل التقرير النهائي. |
110
112
  | BTCA — Report Templates | `tera-system/consulting-helpers/BTCA_REPORT_TEMPLATES.md` | `.opencode/agents/tera-business-transformation-consultant.md` | قوالب التقارير العشرة الأساسية + التقرير التنفيذي. |
111
- | Tera distribution (versioned) | `tera-system/TERA_DISTRIBUTION_POLICY.md` (§2.2 الحزم + §2.3 الموقع + §2.0 الأصالة) | `.tera/lock.json` في مستودعات العملاء | توزيع Tera المُروّس: **RepositoryUrl `https://github.com/Alabasi1980/Teranoo-System`** + الحزم `@tera-system/core 0.2.10` / `@tera-system/pro 0.2.14` + **الموقع `https://github.com/Alabasi1980/TeraWebsite` + `https://teranoo.com` + منصة النشر `https://coolify.teranoo.com/`** + إصدارات (Tag+SHA) + عقد ملكية + أدوات `tera-workshop/tools/`. أي تعديل على ملفات Tera-managed يتطلب Tag+bundle+npm publish. SCP-2026-08-15-009 + SCP-2026-08-31-002 + SCP-2026-08-31-003. |
113
+ | Tera distribution (versioned) | `tera-system/TERA_DISTRIBUTION_POLICY.md` (§2.2 الحزم + §2.3 الموقع + §2.0 الأصالة) | `.tera/lock.json` في مستودعات العملاء | توزيع Tera المُروّس: **RepositoryUrl `https://github.com/Alabasi1980/Teranoo-System`** + الحزم `@tera-system/core 0.2.19` / `@tera-system/pro 0.2.24` (مقاس من manifests المثبتة 2026-09-11 — SCP-2026-09-16-003) + **الموقع `https://github.com/Alabasi1980/TeraWebsite` + `https://teranoo.com` + منصة النشر `https://coolify.teranoo.com/`** + إصدارات (Tag+SHA) + عقد ملكية + أدوات `tera-workshop/tools/`. أي تعديل على ملفات Tera-managed يتطلب Tag+bundle+npm publish. SCP-2026-08-15-009 + SCP-2026-08-31-002 + SCP-2026-08-31-003. |
112
114
  | Source code ownership & pricing | `tera-system/TeraPricingPolicy.md` (§31) + `tera-system/TeraClientPolicy.md` (§9.5) | `tera-workshop/client-templates/contractual/SOURCE_CODE_PURCHASE_ADDENDUM_TEMPLATE.md`، `SOFTWARE_SERVICES_AGREEMENT` §12 | ملكية السورس افتراضياً لـ Tera (لا يُسلَّم للزبون) + خيارا L1 (40%) / L2 (max(3×، 1,000 JOD)) عبر ملحق تعاقدي + L3 (إعادة بيع) مرفوض افتراضياً. SCP-2026-08-29-004. |
113
115
  | Prototype pricing mandate | `tera-system/TeraPricingPolicy.md` (§17.5) + `tera-system/TeraClientPolicy.md` (Gate 6) | `tera-workshop/client-templates/commercial/QUOTATION_TEMPLATE.md`, `project-control/TeraPricingCalculator.xlsx` | البروتوتايب التصميمي إلزامي لكل التطبيقات (SCP-2026-08-28-001) وهو **بند مسعّر مشمول**: 10% من السعر النهائي (B57) — يُحتسب تلقائياً في الحاسبة — يُعرض كبند منفصل في العرض — يُلغى إلى 0% فقط باتفاق الطرفين (WAIVED_BY_MAJED + موافقة الزبون). رفض البروتوتايب المعروض لا يُلغي تكلفته (Fix/CR). SCP-2026-09-01-001. |
114
116
  | Client letter numbering | `tera-system/TeraClientPolicy.md` (§9.6) + `project-control/CLIENT_CODES.md` | `client-approval/LETTER_LOG.md` في مستودع العميل | ترميز موحد `{كود-العميل}-{النوع}-{السنة}-{التسلسل}` — كود العميل يخصّصه Majed فقط (سجل مركزي) — الأنواع LET/CON/ADD/PAL/DOC/TPL (قابلة للزيادة). SCP-2026-08-29-005. |
@@ -0,0 +1,149 @@
1
+ <!-- © 2026 Majed Khaireddin (Alabasi1980). Tera System — Proprietary. All rights reserved. -->
2
+
3
+ # ASSET_POLICY.md
4
+
5
+ > **مصدر الحقيقة لسياسة الأصول البصرية في Teranoo.**
6
+ > SCP-2026-09-12-002 — مرافق لـ `IMAGE_TOOL_CONTRACT.md`.
7
+ > لا Build Gate كامل هنا — المنع الفيسي الكامل مرحلة لاحقة (Class C). حالياً: سياسة + مراجعة.
8
+
9
+ ---
10
+
11
+ ## 1. الغرض
12
+
13
+ منع ثلاثة أخطاء تجارية/تقنية بأقل قواعد ممكنة:
14
+
15
+ 1. استخدام صورة مرجعية داخل التطبيق بالخطأ.
16
+ 2. اعتماد أصل إنتاجي لمشروع بلا هوية معتمدة.
17
+ 3. تخفيف حقوق أصل مشتق من مصدر مقيّد بصمت (Rights Laundering).
18
+
19
+ ---
20
+
21
+ ## 2. بنية التخزين الثابتة
22
+
23
+ ```text
24
+ project-assets/visual/
25
+ ├── references/ → مرجعي — ممنوع على Build/Runtime
26
+ ├── production/ → إنتاجي — مسموح Build/Runtime (بشرط approved)
27
+ ├── icons/ → أيقونات — مسموح Build/Runtime (بشرط approved)
28
+ └── marketing/ → تسويقي — ممنوع على Build/Runtime
29
+ ```
30
+
31
+ ### القاعدة الذهبية
32
+
33
+ ```text
34
+ production/ أو icons/ + approval_status=approved
35
+ → الوحيد المسموح استهلاكه من كود التطبيق.
36
+
37
+ أي شيء آخر (references/ أو marketing/ أو أي draft)
38
+ → ممنوع على Build/Runtime — سياسة + مراجعة بشرية (Auditor/Reviewer).
39
+ ```
40
+
41
+ > المنع التقني الكامل عبر Build Gate مؤجل (Class C). حتى ذلك الحين: هذه القاعدة + فحص المراجع في التسليم.
42
+
43
+ ---
44
+
45
+ ## 3. فصل التفويض عن الاعتماد
46
+
47
+ | النطاق (`approval_scope`) | المعنى | أثر الحفظ |
48
+ |---------------------------|--------|-----------|
49
+ | `task_authorized` | Majed وافق على تنفيذ مهمة تصميم | `draft` دائماً — لا يتحول لـapproved أبداً بهذا النطاق وحده |
50
+ | `asset_preapproval` | التفويض ينص صراحة أن مخرجات هذه المهمة معتمدة كأصول | `approved` (بشرط استيفاء §5 و§4) |
51
+ | `explicit_approval` | اعتماد لاحق لملف أو مجموعة بعينها | `approved` (بشرط استيفاء §5 و§4) |
52
+
53
+ ```text
54
+ الفرق الجوهري:
55
+ "وافق على تنفيذ مهمة تصميم" ≠ "وافق مسبقاً أن أي Output منها يصبح Production Approved"
56
+ ```
57
+
58
+ لا Approval Engine — مجرد حقلين (`approval_ref` + `approval_scope`) وتمييز.
59
+
60
+ ### Local Provider Safety Guardrail
61
+
62
+ المزود المحلي الحالي (`LocalOpenVINOAdapter`) يعمل دون Safety Checker عامل.
63
+ لذلك تبقى مخرجات `reference` والمسودات الداخلية مسموحة بحالة `draft`، لكن
64
+ مخرجات `production` و`icon` و`marketing` المحلية لا تصبح `approved` عبر
65
+ `asset_preapproval`؛ تحتاج `explicit_approval` موثقاً من المالك. هذا قيد
66
+ موافقة فقط، ولا يضيف classifier أو خدمة moderation.
67
+
68
+ ---
69
+
70
+ ## 4. منع Rights Laundering (قاعدة واحدة — مهمة تجارياً)
71
+
72
+ ```text
73
+ Derived asset rights cannot silently become less restrictive
74
+ than their restricted source.
75
+ ```
76
+
77
+ ### القاعدة
78
+
79
+ إن كان أي عنصر في `source_refs` يحمل (`usage_rights=restricted` أو `ownership=third-party`)، فالناتج المشتق:
80
+
81
+ - **يرث القيد تلقائياً** (`restricted` / `third-party`)، أو
82
+ - يُرفض بـ `RIGHTS_LAUNDERING_BLOCKED` إن طُلب (`commercial`/`teranoo`) بلا `rights_override_ref` موثق.
83
+
84
+ ### `rights_override_ref`
85
+
86
+ مرجع موثق (قرار Majed / بند عقد / ترخيص شراء) يبرر تخفيف القيد. يُسجَّل في Metadata المشتق. لا نظام IP معقد — Validation واحدة + مرجع.
87
+
88
+ ### أمثلة
89
+
90
+ | المصدر | المطلوب للناتج | النتيجة |
91
+ |--------|----------------|---------|
92
+ | `third-party / restricted` → ناتج `reference` بنفس القيد | ✅ يُقبل (يرث القيد) |
93
+ | `third-party / restricted` → ناتج `commercial / teranoo` بلا override | ❌ `RIGHTS_LAUNDERING_BLOCKED` |
94
+ | `third-party / restricted` → ناتج `commercial` مع `rights_override_ref` (ترخيص شراء) | ✅ يُقبل ويُوثَّق |
95
+ | `teranoo / internal` → ناتج `commercial / teranoo` | ✅ يُقبل (لا تخفيف — المصدر غير مقيّد) |
96
+
97
+ ---
98
+
99
+ ## 5. قاعدة `baseline_missing` (Guardrail)
100
+
101
+ ```text
102
+ asset_type = reference
103
+ → baseline missing مسموح — يُحفظ تلقائياً
104
+
105
+ asset_type = production | icon | marketing
106
+ → baseline missing مسموح تقنياً (لا فشل — لا نعطل الاستكشاف)
107
+ → لكن الناتج يبقى draft حصراً
108
+ → لا يمكن اعتباره approved حتى: توجد baseline
109
+ أو approval_scope يتضمن override صريحاً موثقاً
110
+ → الخطأ عند مخالفتها: BASELINE_REQUIRED_FOR_APPROVAL
111
+ ```
112
+
113
+ السبب: لا نمنع الاستكشاف البصري، ولا نعتمد أصلاً إنتاجياً لمشروع بلا هوية بالخطأ.
114
+
115
+ ---
116
+
117
+ ## 6. الملكية لا تُستنتج
118
+
119
+ ```text
120
+ ownership و usage_rights
121
+ → تأتيان من: عقد المشروع / سياسة التسليم / قرار صريح
122
+ → لا تُستنتجان من asset_type أبداً
123
+ → إلزاميتان لكل غير مرجعي (save_asset يرفض بدونهما: MISSING_RIGHTS)
124
+ ```
125
+
126
+ `client-owned` ليس قيمة تلقائية — الملكية للعميل تثبت بعقد أو تسليم، لا بنوع الصورة.
127
+
128
+ ---
129
+
130
+ ## 7. حماية الأصول المعتمدة
131
+
132
+ ```text
133
+ الكتابة فوق asset حالته approved
134
+ → مرفوضة دائماً (APPROVED_OVERWRITE_BLOCKED)
135
+ → إلا بـ overwrite=true + approval_scope=explicit_approval جديد
136
+ ```
137
+
138
+ المعتمد لا يُعدَّل بصمت — كل تعديل تفويض جديد.
139
+
140
+ ---
141
+
142
+ ## 8. ما هو مؤجل صراحة (لا يُبنى هنا)
143
+
144
+ ```text
145
+ ❌ Build Gate تقني يمنع استيراد references/ (Class C — حالياً سياسة + مراجعة)
146
+ ❌ Approval Engine آلي (D — approval_ref اليدوي كافٍ)
147
+ ❌ Cost Dashboard (C — الحد القابل للتهيئة كافٍ)
148
+ ❌ نظام IP معقد (D — Validation واحدة + override تكفي)
149
+ ```