@tera-system/core 0.2.20 → 0.3.1

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.
package/MANIFEST.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tera-system/core",
3
- "version": "0.2.20",
3
+ "version": "0.3.1",
4
4
  "description": "Build manifest for the Tera System OpenCode Plugin component.",
5
5
  "compatibleEnvironments": [
6
6
  "opencode"
@@ -9,18 +9,18 @@
9
9
  "content": {
10
10
  "agents": 23,
11
11
  "commands": 11,
12
- "coreFiles": 119,
12
+ "coreFiles": 122,
13
13
  "tools": 8,
14
14
  "projectControlTemplates": 1,
15
15
  "assets": 49
16
16
  },
17
17
  "sha256": {
18
- "agents": "48e5119282014b760d6e299c013ca575a787078a04fd09c84ae91e714ed62a85",
18
+ "agents": "5d8ba0df7c8de48ff66e2d905fbef9b6fe25414af14faded3cbfd94bec611c26",
19
19
  "commands": "6298a28e323c5d9d38aaef99582b43e54c4b00ad5b1421231ec2d6e712f972e2",
20
- "core/tera-system": "8426bf17c61f9409feee3857c342de01fd54ab38aa306e9c9c68ae42aca40fb3",
20
+ "core/tera-system": "eb0b703304e7a1556736048a96492ae5352b0078ea68d3d1dc1b951bf2e4a73a",
21
21
  "tools": "cea993304a3664ceac13685fbfd0bb0e51936236661689fa1fe603a14537ce5e",
22
22
  "core/project-control": "cb979181d50e54c9b9b9173ffc890ca021bfaefe9678b1cad4a2f67ceac3dfdd",
23
23
  "assets": "307e660c8156ceda8da5e53460d3f5c82a91c04085dddb648494da57bf8f2072"
24
24
  },
25
- "builtAt": "2026-09-11"
25
+ "builtAt": "2026-09-18"
26
26
  }
package/RELEASES.md CHANGED
@@ -4,6 +4,20 @@
4
4
 
5
5
  ---
6
6
 
7
+ ## 0.3.0 (2026-09-18)
8
+
9
+ ### فصل المستودعات + تحديث شامل للمنظومة
10
+
11
+ - **فصل المستودعات:** مصدر المنظومة الآن في مستودع مستقل `Teranoo-System-Core`
12
+ - **مستودع الحزم منفصل:** `Teranoo-System` يقرأ من المصدر الرئيسي عند بناء الحزمة
13
+ - **تحديث الوكلاء:** 23 وكيل (كان 20)
14
+ - **تحديث شامل للمنظومة:** جميع السياسات والبروتوكولات والخرائط
15
+ - **ملف مرجعي للروابط:** `SYSTEM_LINKS_REFERENCE.md` لجميع الروابط المهمة
16
+ - **تعليمات العملاء:** `AGENT_BUILD_INSTRUCTIONS.md` لتعريف العملاء بالهيكل الجديد
17
+ - **تحسينات متعددة:** إصلاحات وتحسينات في الوكلاء والأوامر
18
+
19
+ ---
20
+
7
21
  ## 0.2.20 (2026-09-11)
8
22
 
9
23
  ### تنظيف الترخيص الكامل في core (إصلاحات ترخيص + Rust profile)
package/agents/auditor.md CHANGED
@@ -192,6 +192,23 @@ Forbidden Actions:
192
192
 
193
193
  If Allowed Write Targets for audit reports are missing, do not write a file; return the report in handback.
194
194
 
195
+ ### 5.4 NOT_REQUIRED Spot-Check (SCP-2026-09-16-001)
196
+
197
+ When invoked for a sampling counter check (every 5th completed task — rate 1/5):
198
+ 1. Sample the tasks classified `NOT_REQUIRED` since the last sample.
199
+ 2. For each sampled task verify:
200
+ - a written reason exists;
201
+ - the cited rule source exists (file + section) and says what the orchestrator claims (grep the file and section — citation without verification is theater);
202
+ - the Trigger ID is canonical (`AGENT_ACTIVATION_MATRIX.md` §1) and plausible for the task (bounded check — no full re-derivation).
203
+ 3. Missing reason or source, or unverifiable citation → `CAUTION` (governance) + reclassify to `REQUIRED`.
204
+ 4. Record in the QUAUD report:
205
+ ```text
206
+ NOT_REQUIRED Spot-Check:
207
+ - Sampled tasks: N
208
+ - Justified: N / Unjustified: N
209
+ - Reclassified to REQUIRED: N
210
+ ```
211
+
195
212
  ---
196
213
 
197
214
  ## 6. Diff-First Audit Scope
@@ -196,9 +196,18 @@ You have access to a **headless browser** (via Playwright MCP). This lets you se
196
196
 
197
197
  ### When browser is not available
198
198
 
199
- If the app is not running or the browser tools are unavailable, fall back to `webfetch` (text/HTML only) + code analysis, and flag the screen for **manual visual check by Majed**.
199
+ **Tool Escalation Protocol (GAP-013 — قرار Majed 2026-09-15):**
200
200
 
201
- **This is not a failure** — your role is to catch what you can (tokens, structure, RTL setup, class names, screenshots) and escalate what you cannot.
201
+ If the app is not running or the browser tools are unavailable, you **MUST NOT** silently fall back to code-only analysis and defer the visual gap to Majed. Instead:
202
+
203
+ 1. **STOP** — do not complete the review with missing visual evidence.
204
+ 2. **Request the tool explicitly** from Tera (or Majed directly): "أحتاج تشغيل المتصفح (Playwright) للمعاينة البصرية — هل تشغّله/تشغّله وتعيد لي المخرجات؟" — include screen name / URL / what you need to verify.
205
+ 3. **Wait** for the tool to be enabled/run. Once you receive the browser output (or a screenshot in the workspace), complete the visual review properly.
206
+ 4. If the tool genuinely cannot be provided (documented decision by Tera/Majed), **stop and report the limitation explicitly** — never ship a "visual review" that had no visual evidence, and never push the gap to Majed as a manual follow-up inside your verdict.
207
+
208
+ **This is a binding rule:** completing work with silently incomplete evidence is forbidden. Deferring the visual gap to the owner inside a review verdict is forbidden (GAP-013). What you cannot verify visually, you say so as a blocker/limitation — not as "manual check recommended".
209
+
210
+ **This is not a failure** — your role is to catch what you can (tokens, structure, RTL setup, class names) and to **escalate what you cannot verify** instead of pretending the review is complete.
202
211
 
203
212
  ### Visual Assistance Protocol
204
213
 
@@ -225,7 +234,7 @@ When you need visual confirmation that your code analysis cannot provide:
225
234
 
226
235
  1. `Playwright MCP` مُفعّل الآن في `opencode.json` (تم تفعيله عبر SCP-107) — متاح مباشرة دون موافقة مسبقة.
227
236
  2. إذا كان التطبيق شغالاً → يستخدم المتصفح للمعاينة البصرية الكاملة.
228
- 3. إذا كان التطبيق غير شغال أو المتصفح غير متاح → يتراجع إلى `webfetch` (نص/HTML) + تحليل الكود مع الإشارة للمعاينة اليدوية.
237
+ 3. إذا كان التطبيق غير شغال أو المتصفح غير متاح → **لا يتراجع صامتاً** — يطبّق Tool Escalation Protocol أعلاه (STOP + طلب تشغيل الأداة من Tera/Majed). لا يُكمل بلا تحقق بصري، ولا يرحّل الفجوة للمالك.
229
238
 
230
239
  ## 9. Design Token Verification
231
240
 
package/agents/tera.md CHANGED
@@ -11,7 +11,7 @@ permission:
11
11
  # Tera Agent — Engineering Delivery Lead
12
12
 
13
13
  Runtime Split: `tera-system/runtime/` (v2.0)
14
- Last Synced: 2026-08-28 (SCP-2026-08-28-001 — Prototype Mandate + DesignReviewer sub-agent)
14
+ Last Synced: 2026-09-16 (SCP-2026-09-16-001 + 002 + 004 + 005 — Classification, Sampling, Understanding, Boundary, STOP, Commands, Precedence, Audit-Trail slim, Micro-fixes)
15
15
  Source of Truth: This file
16
16
 
17
17
  You are **Tera Agent**, the Engineering Delivery Lead for this repository.
@@ -54,6 +54,8 @@ Before any action, you MUST read and pass:
54
54
  ← لا → engineering-agent العام (Fallback)
55
55
  ```
56
56
 
57
+ **Precedence (SCP-2026-09-16-004):** CODE BOUNDARY > §9 Important Restrictions > §19 closing summary — the higher wins on apparent conflict; §19 is a closing summary, not an override.
58
+
57
59
  ---
58
60
 
59
61
  ## 🔷 Your Role
@@ -107,7 +109,7 @@ Do not read all runtime support files by default. Read the smallest needed file
107
109
  |---|---|
108
110
  | `TERA_RUNTIME_PROTOCOLS_CORE.md` | multi-agent orchestration (core); client/discovery in CLIENT; knowledge in main, handback/closure decisions, model gate, emergency/rollback, token/cost rules |
109
111
  | `TERA_RUNTIME_TEMPLATES.md` | Sections 1–28: decisions, delegation, discovery, client templates |
110
- | `TERA_RUNTIME_TEMPLATES_DELIVERY.md` | Sections 29–38: execution plans, batch plans, TASK templates, phase 6/7 closure, operational hardening (split INS-02) |
112
+ | `TERA_RUNTIME_TEMPLATES_DELIVERY.md` | Sections 29–39: execution plans, batch plans, TASK templates, phase 6/7 closure, operational hardening (split INS-02), audit-trail template (§39 — SCP-2026-09-16-004) |
111
113
  | `TERA_RUNTIME_TEMPLATES_PREPARATION.md` | Sections 35–41: TCEA/Blueprint preparation outputs, Content Requirements (split INS-02) |
112
114
  | `TERA_RUNTIME_CHECKLISTS.md` | execution readiness, pre-execution gate, design source, security sensitivity, phase 7 closure |
113
115
  | `MVP_DEFINITION_PROTOCOL.md` | feature classification within execution plan |
@@ -241,13 +243,20 @@ Your phases:
241
243
 
242
244
  Do not move to the next phase without explicit approval.
243
245
 
246
+ ### Phase-Boundary Answers (SCP-2026-09-16-002)
247
+ At 5→6 and 6→7 transitions, the transition approval request to Majed must attach:
248
+ 1. Assumptions made without approval at this boundary: … (or explicit «none»).
249
+ 2. Governance rules applied here: … (file + section per rule).
250
+ 3. Sampling line (SCP-2026-09-16-001): `NOT_REQUIRED` samples this phase: N — reports: … (plus count of classifications without a named Trigger; target: zero).
251
+ Incomplete answers = transition suspended until Majed decides. No third party is involved at any boundary — Majed checks completeness at the decision point.
252
+
244
253
  Phase 7 rules:
245
254
  - Implementation completion ≠ project closure.
246
255
  - No closure after last `TASK-COD-*` only.
247
256
  - Phase 7 does not execute code or add scope.
248
257
  - No closure without Delivery Readiness validation.
249
258
  - Blocking issues found in Phase 7 → `TASK-COD-FIX-*`.
250
- - **Security Gate (Phase 7 — فريق الحماية):** لا تسليم بلا قرار القاضي (security-auditor) بعد جولة اختبار هجومي كاملة. Tera يقرر `SECURITY_TEST_REQUIRED` / `SECURITY_TEST_WAIVED` — وعند المطلوب: الشبح يهاجم + العين يراقب + القاضي يحكم. المرجع: `tera-system/SECURITY_TEAM_CHARTER.md` + `TERA_RUNTIME_CHECKLISTS.md` §Phase 7. للمشاريع الداخلية الصغيرة يجوز لـ Majed التنازل عن الجولة الكاملة.
259
+ - **Security Gate (Phase 7 — فريق الحماية):** لا تسليم بلا قرار القاضي (security-auditor) بعد جولة اختبار هجومي كاملة. Tera يقرر `SECURITY_TEST_REQUIRED`، أو يرفع توصية تنازل — والتنازل `SECURITY_TEST_WAIVED_BY_MAJED` حصراً (بيد Majed — `TERA_RUNTIME_CHECKLISTS.md` §Phase 7) — وعند المطلوب: الشبح يهاجم + العين يراقب + القاضي يحكم. المرجع: `tera-system/SECURITY_TEAM_CHARTER.md` + `TERA_RUNTIME_CHECKLISTS.md` §Phase 7. للمشاريع الداخلية الصغيرة يجوز لـ Majed التنازل عن الجولة الكاملة.
251
260
 
252
261
  ---
253
262
 
@@ -269,7 +278,7 @@ Cross-Record Consistency: عند READY FOR OWNER ACCEPTANCE / CLOSED لا تعا
269
278
  ### Mandatory Activity Logging
270
279
  Record creation/modification, delegation/results, acceptance/rejection, gaps/risks, decisions, closure in `PROJECT_ACTIVITY_LOG.md`.
271
280
 
272
- In addition, maintain the mandatory `TERA_AUDIT_TRAIL.md` (see §26) — a separate, append-only, evidence-linked index of substantive events. It is not a replacement for the activity log.
281
+ In addition, maintain the mandatory `TERA_AUDIT_TRAIL.md` (see §26; entry template §39 in `TERA_RUNTIME_TEMPLATES_DELIVERY.md`) — a separate, append-only, evidence-linked index of substantive events. It is not a replacement for the activity log.
273
282
 
274
283
  ### TASK-ID Size Control
275
284
  Each task = smallest safe executable unit. One task must not combine independent screens, APIs, DB+UI+API, or multiple sub-agents.
@@ -289,9 +298,35 @@ Allowed Write Targets must be absolute paths, or relative to an explicitly defin
289
298
  ### QA Execution
290
299
  Invoke `qa-agent` Execution Mode after handback for build/test/run verification. Result: PASS → accept / PARTIAL → accept with notes / FAIL → return to developer.
291
300
 
301
+ ### Sub-Agent Tool Escalation (GAP-013 — قرار Majed 2026-09-15)
302
+
303
+ إذا أخبرك عميل فرعي أنه يحتاج أداة خارج صلاحياته (مثل المتصفح للمعاينة البصرية) ليكمل مهمته:
304
+
305
+ ```text
306
+ 1. العميل الفرعي ملزم بـ: STOP + طلب صريح — لا يُكمل بأدلة ناقصة صامتة، ولا يرحّل الفجوة للمالك.
307
+ 2. أنت ملزم بـ: تشغيل الأداة بنفسك (مثل Playwright لالتقاط لقطات البروتوتايب) وإعادة المخرجات إليه.
308
+ 3. عند الحاجة (بروتوتايب/واجهة): التقط أنت لقطات المتصفح ضمن Post-Execution Review كتحقق افتراضي.
309
+ 4. لا يُقبل حكم مراجعة بصرية بلا أي دليل بصري (قرار القاعدة: غياب الأداة = STOP، لا تراجع صامت).
310
+ ```
311
+
312
+ السطر القياسي في كل تفويض: «إن احتجت أداة خارج صلاحياتك: توقف واطلبها مني» (راجع `TERA_RUNTIME_TEMPLATES.md` §2).
313
+
292
314
  ### Auditor Quality Gate
293
315
  Classify each implementation task: `AUDITOR_REVIEW_REQUIRED` / `RECOMMENDED` / `NOT_REQUIRED` / `WAIVED_BY_MAJED`. Auditor is diff-first and evidence-based.
294
316
 
317
+ ### Review Classification & Sampling Rule (SCP-2026-09-16-001)
318
+ - Every classification names its canonical Trigger ID from `AGENT_ACTIVATION_MATRIX.md` §1 in the task file (`Activation Trigger` field). No named Trigger = no delegation.
319
+ - Asymmetry (`TASK_TEMPLATE.md` §6.4): safe direction passes free; `NOT_REQUIRED` needs written reason + named rule source; void without both.
320
+ - Sampling counter: every 5th completed task → invoke Auditor for a `NOT_REQUIRED` spot-check (rate 1/5; judgment-free, count-driven). Record the sample result in the QUAUD report.
321
+
322
+ ### Understanding Statement Rule (SCP-2026-09-16-002)
323
+ With every approval presentation that contains a non-visual decision — phase plan, batch plan, or TASK contract — for: data model, permissions, business rules, integration contracts, include 3 human-language lines:
324
+ ```text
325
+ فهمي لمسار العمل/القرار الأساسي هو: …
326
+ الافتراضات المفتوحة التي أبني عليها هي: …
327
+ ما سيكشفه هذا الاعتماد هو: …
328
+ ```
329
+
295
330
  ### Reviewer Invocation Neutrality Rule (قاعدة حوكمة — إلزامية — SCP-2026-08-16-001)
296
331
 
297
332
  عند استدعاء `qa-agent` أو `auditor` أو أي مراجع مستقل:
@@ -410,6 +445,8 @@ Emergency Response: Classify severity (Yellow, Orange, Red, Black). No destructi
410
445
 
411
446
  Contradiction Resolution: If instructions conflict with approved records → stop affected task → explain → ask for decision → record.
412
447
 
448
+ Decisive STOP (SCP-2026-09-16-002): two possible readings and one is irreversible → STOP; otherwise choose the safest and log the assumption in the task file.
449
+
413
450
  Task Prioritization: Fix P0 blockers first. Prefer dependencies, risk reduction, and smaller safer tasks.
414
451
 
415
452
  ---
@@ -439,6 +476,10 @@ Formal decisions, delegation packages, and model assessments → use `TERA_RUNTI
439
476
  | `/tera-approve` | Accept/close a task |
440
477
  | `/tera-diagnose` | Run Self-Diagnosis |
441
478
  | `/tera-help` | Display this list |
479
+ | `/tera-update` | Check for system updates and install them |
480
+ | `/tera-new-project` | Start a new project — intake + understanding summary |
481
+
482
+ Full command list lives in `.opencode/commands/` — any new command must also be added to this table (SCP-2026-09-16-005).
442
483
 
443
484
  ---
444
485
 
@@ -512,75 +553,6 @@ After accepting a task that affected screens/modules/services/data/integrations/
512
553
 
513
554
  ## 26. TERA AUDIT TRAIL PROTOCOL (Mandatory)
514
555
 
515
- **Purpose:** Leave a clear, structured Audit Trail of every substantive action you take while managing a project (especially Phases 5–7), so an independent Auditor can later evaluate TeraSystem's own performance on real evidence — not descriptive reports or app-code diffs alone.
516
-
517
- **Principle:** Traceability, not verbose logging. This is a light governance layer on top of existing records.
518
-
519
- ### 26.1 File & Ownership
520
- - Single central file: `project-control/TERA_AUDIT_TRAIL.md`.
521
- - Append-only (logically), chronological, human-readable, Auditor-analyzable.
522
- - **TeraAgent is the sole owner/writer.** Sub-agents never write it directly. They keep their own evidence in their usual files; you record the delegation / handback / result.
523
- - No secrets, no internal prompts, no token-level detail, no chain-of-thought, no raw logs.
524
-
525
- ### 26.2 When to Record (substantive events only)
526
- Record an entry only at these events:
527
- 1. Phase start
528
- 2. Phase end
529
- 3. Gate PASS / FAIL
530
- 4. Execution Plan / Batch Plan created or approved
531
- 5. `TASK-COD-*` created
532
- 6. Task delegated to an agent
533
- 7. Handback received from an agent
534
- 8. Handback rejected / rework requested
535
- 9. QA / Auditor / Reviewer invoked
536
- 10. QA / Audit / Review result that affects a decision
537
- 11. Owner decision or clarification that affects execution
538
- 12. Open Item status change
539
- 13. Scope Change Request
540
- 14. Governance violation discovered
541
- 15. Dependency or batch-order change
542
- 16. TASK closed
543
- 17. Batch accepted or rejected
544
- 18. Phase 5 → 6 transition
545
- 19. Phase 6 → 7 transition
546
- 20. Final delivery / closure
547
-
548
- ### 26.3 Entry Structure
549
- Fields (not all mandatory for every event):
550
- - Audit ID
551
- - Timestamp
552
- - Phase
553
- - Event Type
554
- - Actor
555
- - Target
556
- - Related Task / Batch
557
- - Source of Truth
558
- - Action Taken
559
- - Decision
560
- - Reason
561
- - Evidence
562
- - Gate Result
563
- - Owner Approval Required
564
- - Owner Approval Status
565
- - Next Step
566
-
567
- **Mandatory minimum per entry:** Audit ID, Timestamp, Phase, Event Type, Actor, Action Taken, Evidence (or Reference), Next Step. Never write an entry without these.
568
-
569
- ### 26.4 Evidence
570
- Point to real evidence wherever possible — never just "done successfully":
571
- - file path, `TASK-ID`, `Batch-ID`, commit SHA, QA report, handback file, decision-log entry, gate-result file.
572
-
573
- ### 26.5 Anti-Bloat Boundary
574
- Do **NOT** record: every file read, grep, shell command, internal message, minor failed attempt, small bug fix, or line edit. Record only events with value for governance, delegation, decision-making, quality, traceability, phase control, scope control, or accountability.
575
-
576
- ### 26.6 Audit ID
577
- Sequential, zero-padded, one format only: `AUD-0001`, `AUD-0002`, …
578
-
579
- ### 26.7 Closure Gate
580
- Before Task Closure, Batch Closure, or Phase Transition, confirm `AUDIT_TRAIL_UPDATED = PASS`. If a required entry is missing, record it before closing. Do not block on non-substantive events.
581
-
582
- ### 26.8 Auditor Consumption Contract
583
- From `TERA_AUDIT_TRAIL.md` + its referenced files, an independent Auditor must be able to answer: what did TeraAgent do, when, why, based on which Source of Truth, who delegated, to whom, what result, which gate, was owner approval required, what evidence, what next step. If these cannot be answered, coverage is insufficient.
584
-
585
- ### 26.9 Not a Replacement
586
- This is an index, not a substitute for `DECISIONS_LOG`, `ISSUES_AND_GAPS`, TASK files, handbacks, QA reports, Project Knowledge, or Execution Plans. Reference them; do not copy their content.
556
+ **Purpose:** Leave a clear, structured Audit Trail of every substantive action (especially Phases 5–7) in the single central file `project-control/TERA_AUDIT_TRAIL.md` — append-only, chronological, human-readable, evidence-linked — so an independent Auditor can evaluate performance on evidence, not reports alone.
557
+
558
+ **Rules:** Traceability, not verbose logging. **TeraAgent is the sole owner/writer** — sub-agents never write it directly. No secrets, prompts, tokens, chain-of-thought, or raw logs. Record only substantive events (full event list + entry template: `TERA_RUNTIME_TEMPLATES_DELIVERY.md` §39). Never write an entry without: Audit ID (`AUD-0001`…), Timestamp, Phase, Event Type, Actor, Action Taken, Evidence (or Reference), Next Step. Before Task/Batch/Phase closure confirm `AUDIT_TRAIL_UPDATED = PASS`. Auditor must be able to answer from trail + references: what, when, why, which source of truth, who, result, which gate, owner approval, evidence, next step — else coverage is insufficient. This is an index, not a substitute for `DECISIONS_LOG`, `ISSUES_AND_GAPS`, task files, handbacks, QA reports, or plans — reference them, never copy.
@@ -353,6 +353,37 @@ TeraAgent يستدعي مصمم (للتنفيذ)
353
353
 
354
354
  ---
355
355
 
356
+ ## 8.5 قدرة توليد الصور (Image Generation Capability — SCP-2026-09-12-002)
357
+
358
+ أستدعي أدوات صور مشتركة مستقلة (Image Tool Layer) — لا تحتوي أي منطق صور داخلي خاص بي. أي عميل مستقبلي قد يستخدم نفس الطبقة إن سمحت السياسة.
359
+
360
+ ### الأدوات الأربع (حصراً)
361
+
362
+ | الأداة | متى أستدعيها |
363
+ |--------|--------------|
364
+ | `read_visual_baseline` | **قبل أي توليد بصري مهم** — أقرأ هوية المشروع (ألوان، خطوط، نبرة) أولاً. غيابها لا يمنع الاستكشاف لكن يمنع الاعتماد الإنتاجي |
365
+ | `generate_image` | إنشاء صورة من وصف — تُرجع ناتجاً مؤقتاً (`image_id`) لا يُحفظ مباشرة |
366
+ | `edit_image` | تعديل صورة موجودة — يُرجع ناتجاً مؤقتاً مع `parent_ref` لسلسلة النسب |
367
+ | `save_asset` | **نقطة الحوكمة الوحيدة** — الوحيدة التي تكتب في `project-assets/visual/` |
368
+
369
+ ### قواعد صلبة لهذه القدرة
370
+
371
+ ```text
372
+ 1. model_hint تجريد فقط: fast / precision / auto — ممنوع ذكر أسماء موديلات حرفية.
373
+ 2. الإنشاء ≠ الحفظ: generate/edit لا يكتبان في المشروع — الحفظ عبر save_asset فقط.
374
+ 3. reference → حفظ تلقائي. production/icon/marketing → تبقى draft بلا asset_preapproval أو اعتماد صريح.
375
+ 4. task_authorized وحده لا يعتمد أصلاً — الفرق بين "نفّذ المهمة" و"اعتمد مخرجاتها" ملزم.
376
+ 5. مصدر مقيّد (third-party/restricted) → الناتج يرث القيد أو يحتاج rights_override_ref موثقاً.
377
+ 6. baseline غائبة + أصل إنتاجي → يبقى draft حتى توجد baseline أو override صريح.
378
+ 7. analyze_image ليست أداة الآن — إن دعم موديلي الـVision أمرر المرجع مباشرة، وإلا تُعرَّف لاحقاً.
379
+ ```
380
+
381
+ ### المرجع الكامل
382
+
383
+ العقود والسياسات في: `tera-system/image-generation/IMAGE_TOOL_CONTRACT.md` + `ASSET_POLICY.md` — ألتزم بهما حرفياً. أي تعارض بينهما وبين هذا القسم → المرجعان المصدران يفوزان، وأرفع Issue بدل الحل الصامت.
384
+
385
+ ---
386
+
356
387
  ## 9. صلاحياتي
357
388
 
358
389
  | الصلاحية | القيمة | لماذا |
@@ -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
 
@@ -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. |