@tera-system/core 0.2.20 → 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.
- package/MANIFEST.json +5 -5
- package/RELEASES.md +14 -0
- package/agents/auditor.md +17 -0
- package/agents/design-reviewer.md +12 -3
- package/agents/tera.md +48 -76
- package/agents/ui-designer.md +31 -0
- package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +2 -0
- package/core/tera-system/AGENT_DEPENDENCY_MAP.md +4 -4
- package/core/tera-system/TOOLING_AND_MCP_POLICY.md +81 -1
- package/core/tera-system/TeraArchitectureMap.md +3 -0
- package/core/tera-system/TeraCapabilityMap.md +1 -1
- package/core/tera-system/TeraPolicyMap.md +3 -1
- package/core/tera-system/image-generation/ASSET_POLICY.md +149 -0
- package/core/tera-system/image-generation/IMAGE_TOOL_CONTRACT.md +341 -0
- package/core/tera-system/profiles/node-ts-coolify-postgres.md +93 -0
- package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS.md +1 -1
- package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES.md +5 -4
- package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md +59 -0
- package/core/tera-system/semgrep-rules/tera-security.yml +119 -10
- package/package.json +2 -2
package/MANIFEST.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tera-system/core",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
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":
|
|
12
|
+
"coreFiles": 122,
|
|
13
13
|
"tools": 8,
|
|
14
14
|
"projectControlTemplates": 1,
|
|
15
15
|
"assets": 49
|
|
16
16
|
},
|
|
17
17
|
"sha256": {
|
|
18
|
-
"agents": "
|
|
18
|
+
"agents": "5d8ba0df7c8de48ff66e2d905fbef9b6fe25414af14faded3cbfd94bec611c26",
|
|
19
19
|
"commands": "6298a28e323c5d9d38aaef99582b43e54c4b00ad5b1421231ec2d6e712f972e2",
|
|
20
|
-
"core/tera-system": "
|
|
20
|
+
"core/tera-system": "9baedeacb4f9e1f425f272cf65891feeeb10e56a1dc97497550b80b616e53e2e",
|
|
21
21
|
"tools": "cea993304a3664ceac13685fbfd0bb0e51936236661689fa1fe603a14537ce5e",
|
|
22
22
|
"core/project-control": "cb979181d50e54c9b9b9173ffc890ca021bfaefe9678b1cad4a2f67ceac3dfdd",
|
|
23
23
|
"assets": "307e660c8156ceda8da5e53460d3f5c82a91c04085dddb648494da57bf8f2072"
|
|
24
24
|
},
|
|
25
|
-
"builtAt": "2026-09-
|
|
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
|
-
|
|
199
|
+
**Tool Escalation Protocol (GAP-013 — قرار Majed 2026-09-15):**
|
|
200
200
|
|
|
201
|
-
|
|
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. إذا كان التطبيق غير شغال أو المتصفح غير متاح → يتراجع
|
|
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-
|
|
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–
|
|
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`
|
|
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
|
|
516
|
-
|
|
517
|
-
**
|
|
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.
|
package/agents/ui-designer.md
CHANGED
|
@@ -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
|
| الصلاحية | القيمة | لماذا |
|
|
@@ -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` |
|
|
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` |
|
|
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` |
|
|
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.
|
|
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. |
|