@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 +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/PROFILES_INDEX.md +1 -0
- package/core/tera-system/profiles/bun-ts-monorepo-sqlite.md +164 -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/core/tera-system/knowledge-base/OPENHANDS_ARCHITECTURE_REFERENCE.md +0 -243
|
@@ -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
|
+
```
|
|
@@ -0,0 +1,341 @@
|
|
|
1
|
+
<!-- © 2026 Majed Khaireddin (Alabasi1980). Tera System — Proprietary. All rights reserved. -->
|
|
2
|
+
|
|
3
|
+
# IMAGE_TOOL_CONTRACT.md
|
|
4
|
+
|
|
5
|
+
> **مصدر الحقيقة لعقد أدوات توليد الصور في Teranoo.**
|
|
6
|
+
> SCP-2026-09-12-002 — النطاق: تعريفات وحدود فقط. صفر كود مزود، صفر API wiring.
|
|
7
|
+
> أي نقطة تتطلب قراراً جديداً أو تغيّر المعمارية: STOP وارفعها كـIssue بدل حلها بصمت.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## 1. القاعدة الذهبية للفصل
|
|
12
|
+
|
|
13
|
+
```text
|
|
14
|
+
Adapter يعرف المزود فقط.
|
|
15
|
+
Tool Layer تعرف المشروع والسياسة فقط.
|
|
16
|
+
الوكيل يعرف النية فقط.
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
| المسؤولية | Tool Layer | Provider Adapter |
|
|
20
|
+
|-----------|-----------|------------------|
|
|
21
|
+
| التحقق من المدخلات | ✅ | ❌ |
|
|
22
|
+
| Cost Guard | ✅ | ❌ (يبلّغ التكلفة فقط إن توفرت) |
|
|
23
|
+
| سياسة الأصول | ✅ (انظر `ASSET_POLICY.md`) | ❌ |
|
|
24
|
+
| `prompt_hash` + `prompt_ref` | ✅ | ❌ |
|
|
25
|
+
| كتابة Metadata JSON | ✅ | ❌ |
|
|
26
|
+
| إدارة المؤقتات (`temp_uri` lifecycle) | ✅ | ❌ |
|
|
27
|
+
| ترجمة الأخطاء لرموز موحدة | ✅ | يرفع خطأ مزود خام فقط |
|
|
28
|
+
| مفاتيح API / أسرار | ❌ (لا يراها أبداً) | ✅ (من البيئة فقط) |
|
|
29
|
+
| ترجمة hints لقيم المزود | ❌ | ✅ |
|
|
30
|
+
| استدعاء HTTP للمزود | ❌ | ✅ (تعريف حدود فقط في هذه المرحلة — لا تنفيذ) |
|
|
31
|
+
| معرفة مسارات المشروع أو الـapproval | ❌ | ❌ (ممنوع) |
|
|
32
|
+
|
|
33
|
+
---
|
|
34
|
+
|
|
35
|
+
## 2. `generate_image`
|
|
36
|
+
|
|
37
|
+
**الغرض:** إنشاء صورة جديدة من وصف نصي. تُرجع ناتجاً مؤقتاً فقط — لا تحفظ في المشروع مباشرة.
|
|
38
|
+
|
|
39
|
+
### Input
|
|
40
|
+
|
|
41
|
+
| الحقل | إلزامي؟ | القاعدة |
|
|
42
|
+
|-------|---------|---------|
|
|
43
|
+
| `prompt` | ✅ | نص غير فارغ، 10–2000 حرف. التطبيع قبل الـhash (trim + توحيد المسافات) |
|
|
44
|
+
| `asset_type` | ✅ | واحد من: `reference / production / icon / marketing` — نية الاستخدام، لا مسار الحفظ |
|
|
45
|
+
| `project_path` | ✅ | مسار مشروع موجود — للـCost Guard والـMetadata فقط |
|
|
46
|
+
| `model_hint` | اختياري (`auto`) | `fast / precision / auto` فقط. **ممنوع ذكر أسماء موديلات حرفية هنا — تبقى داخل الـAdapter** |
|
|
47
|
+
| `size_hint` | اختياري (`auto`) | `square / landscape / portrait / auto` — تُترجم داخل الـAdapter |
|
|
48
|
+
| `quality_hint` | اختياري (`auto`) | `draft / standard / high` — تُترجم داخل الـAdapter |
|
|
49
|
+
| `use_baseline` | اختياري (`true`) | إن كان `true` يُستدعى `read_visual_baseline` أولاً ويُرفق مرجعه |
|
|
50
|
+
| `provider` | اختياري (`auto`) | `auto / local / openai` — اختيار صريح فقط، بلا fallback آلي. `auto` = المحلي أولاً (مجاني). ضروري لتمرير الاختيار بشكل مجرد — لا أسماء موديلات هنا |
|
|
51
|
+
|
|
52
|
+
### Output
|
|
53
|
+
|
|
54
|
+
```text
|
|
55
|
+
image_id opaque temporary ID — ليس file path — له expires_at
|
|
56
|
+
provider اسم المزود ("openai")
|
|
57
|
+
model_used الاسم الفعلي الذي استخدمه الـAdapter (يُسجَّل هنا فقط، لا يُطلب به)
|
|
58
|
+
width / height / format
|
|
59
|
+
temp_uri internal only — لا يُعتمد كمسار مشروع
|
|
60
|
+
prompt_hash sha256 النص المطبّع
|
|
61
|
+
expires_at UTC ISO8601 — بعدها save_asset يرفض بـ EXPIRED_IMAGE_ID
|
|
62
|
+
created_at UTC ISO8601
|
|
63
|
+
cost_estimate إن توفر من المزود، وإلا "unknown"
|
|
64
|
+
baseline_missing true/false — هل وُجدت baseline عند التوليد
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### Validation (قبل أي اتصال بالمزود)
|
|
68
|
+
|
|
69
|
+
1. `prompt` ضمن الطول وغير فارغ.
|
|
70
|
+
2. `asset_type` من القائمة المغلقة.
|
|
71
|
+
3. `project_path` موجود.
|
|
72
|
+
4. **Cost Guard** يسمح — وإلا رفض قبل الاتصال.
|
|
73
|
+
5. `use_baseline=true` ولا baseline → **لا فشل** — المتابعة مع `baseline_missing=true` (قاعدة الاعتماد في §6 تمنع تحويله لـapproved لاحقاً).
|
|
74
|
+
|
|
75
|
+
### Errors
|
|
76
|
+
|
|
77
|
+
| الكود | المعنى | السلوك |
|
|
78
|
+
|-------|--------|--------|
|
|
79
|
+
| `INVALID_INPUT` | حقل مرفوض | لا اتصال بالمزود |
|
|
80
|
+
| `COST_GUARD_BLOCKED` | الحد يمنع | STOP — لا fallback |
|
|
81
|
+
| `PROVIDER_REJECTED_PROMPT` | رفض سلامة من المزود | تُمرَّر رسالة المزود كما هي — لا إعادة تلقائية |
|
|
82
|
+
| `PROVIDER_UNAVAILABLE` | عطل/Timeout | STOP — لا fallback تلقائي لمزود آخر |
|
|
83
|
+
| `TIMEOUT` | تجاوز المهلة | كـ `PROVIDER_UNAVAILABLE` |
|
|
84
|
+
|
|
85
|
+
> لا إعادة محاولة تلقائية. لا fallback تلقائي. أي إعادة قرار صريح من الوكيل أو Majed.
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## 3. `edit_image`
|
|
90
|
+
|
|
91
|
+
**الغرض:** تعديل صورة موجودة بتعليمات نصية. تُرجع ناتجاً مؤقتاً (مثل generate).
|
|
92
|
+
|
|
93
|
+
### Input
|
|
94
|
+
|
|
95
|
+
| الحقل | إلزامي؟ | القاعدة |
|
|
96
|
+
|-------|---------|---------|
|
|
97
|
+
| `source_ref` | ✅ | `image_id` مؤقت صالح أو مسار asset موجود داخل المشروع |
|
|
98
|
+
| `edit_prompt` | ✅ | نفس قواعد `prompt` (10–2000) |
|
|
99
|
+
| `asset_type` | ✅ | نية ناتج التعديل (قد تختلف عن المصدر) |
|
|
100
|
+
| `project_path` | ✅ | كما في generate |
|
|
101
|
+
| `model_hint` | اختياري (`precision`) | التعديل الدقيق يميل للدقة افتراضياً |
|
|
102
|
+
| `provider` | اختياري (`auto`) | `auto / local / openai` — كما في generate، بلا fallback |
|
|
103
|
+
|
|
104
|
+
### Output
|
|
105
|
+
|
|
106
|
+
نفس Output الـgenerate + حقل إضافي:
|
|
107
|
+
|
|
108
|
+
```text
|
|
109
|
+
parent_ref الـsource_ref الأصلي — سلسلة النسب
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Validation
|
|
113
|
+
|
|
114
|
+
1. `source_ref` موجود وقابل للقراءة.
|
|
115
|
+
2. الصيغة من: `png / jpg / webp` فقط (الباقي لاحقاً — Class C).
|
|
116
|
+
3. حد حجم المصدر يُحدَّد في الـAdapter (لا يُثبَّت هنا).
|
|
117
|
+
4. Cost Guard قبل الاتصال.
|
|
118
|
+
5. **قاعدة المصدر المقيّد:** مصدر (`ownership=third-party` أو `usage_rights=restricted`) → الناتج `reference` فقط. تحويله لـ`production/icon/marketing` يتطلب `rights_override_ref` موثقاً (انظر `ASSET_POLICY.md` §4).
|
|
119
|
+
|
|
120
|
+
### Errors
|
|
121
|
+
|
|
122
|
+
نفس أخطاء generate +:
|
|
123
|
+
|
|
124
|
+
| الكود | المعنى |
|
|
125
|
+
|-------|--------|
|
|
126
|
+
| `SOURCE_NOT_FOUND` | المرجع غير موجود |
|
|
127
|
+
| `UNSUPPORTED_FORMAT` | صيغة غير مدعومة |
|
|
128
|
+
| `RESTRICTED_SOURCE` | مصدر مقيّد لا يقبل التحويل لإنتاج بلا override |
|
|
129
|
+
| `EXPIRED_IMAGE_ID` | `image_id` مؤقت منتهي (إن كان المصدر مؤقتاً) |
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## 4. `save_asset`
|
|
134
|
+
|
|
135
|
+
**الغرض:** الوحيدة التي تكتب داخل `project-assets/`. الفصل بين الإنشاء والحفظ مقصود — هذه نقطة الحوكمة الحقيقية.
|
|
136
|
+
|
|
137
|
+
### Input
|
|
138
|
+
|
|
139
|
+
| الحقل | إلزامي؟ | القاعدة |
|
|
140
|
+
|-------|---------|---------|
|
|
141
|
+
| `image_id` | ✅ | ناتج generate/edit صالح وغير منتهي |
|
|
142
|
+
| `project_path` | ✅ | |
|
|
143
|
+
| `asset_type` | ✅ | يحدد المجلد الفرعي حصراً (انظر `ASSET_POLICY.md` §2) |
|
|
144
|
+
| `filename` | اختياري | إن غاب يُولَّد اسم آمن. التطهير إلزامي: `[a-z0-9-_]` + امتداد ثابت — أي `../` أو مسار مطلق = `PATH_TRAVERSAL` |
|
|
145
|
+
| `overwrite` | اختياري (`false`) | |
|
|
146
|
+
| `usage_rights` | مشروط | **إلزامي إن كان `asset_type ≠ reference`** — `internal / commercial / restricted` |
|
|
147
|
+
| `ownership` | مشروط | **إلزامي إن كان `asset_type ≠ reference`** — `teranoo / client / third-party`. لا تُستنتج من النوع أبداً |
|
|
148
|
+
| `approval_ref` | اختياري | مرجع تفويض — انظر §6 (لا يكفي وحده) |
|
|
149
|
+
| `approval_scope` | مشروط | **إلزامي مع `approval_ref`** — `task_authorized / asset_preapproval / explicit_approval` (انظر §6) |
|
|
150
|
+
| `rights_override_ref` | مشروط | إلزامي عند تخفيف قيود مصدر مقيّد (انظر `ASSET_POLICY.md` §4) |
|
|
151
|
+
|
|
152
|
+
### Output
|
|
153
|
+
|
|
154
|
+
```text
|
|
155
|
+
final_path داخل project-assets/visual/{type}/ حصراً
|
|
156
|
+
metadata_path ملف JSON بجانب الصورة (نفس الاسم + .meta.json)
|
|
157
|
+
approval_status draft / approved (حسب §6 فقط)
|
|
158
|
+
```
|
|
159
|
+
|
|
160
|
+
### Validation
|
|
161
|
+
|
|
162
|
+
1. `image_id` صالح وغير منتهي — وإلا `EXPIRED_IMAGE_ID`.
|
|
163
|
+
2. المجلد الهدف واحد من الأربعة المعتمدة فقط.
|
|
164
|
+
3. `filename` مطهّر.
|
|
165
|
+
4. `overwrite=false` والملف موجود = `ASSET_EXISTS`.
|
|
166
|
+
5. **حماية المعتمد:** الكتابة فوق asset حالته `approved` مرفوضة دائماً إلا بـ `overwrite=true` + `approval_scope=explicit_approval` جديد.
|
|
167
|
+
6. `usage_rights` + `ownership` إلزاميان لغير المرجعي — وإلا `MISSING_RIGHTS`.
|
|
168
|
+
7. قاعدة Rights Laundering (انظر `ASSET_POLICY.md` §4).
|
|
169
|
+
|
|
170
|
+
### Errors
|
|
171
|
+
|
|
172
|
+
| الكود | المعنى |
|
|
173
|
+
|-------|--------|
|
|
174
|
+
| `ASSET_EXISTS` | الملف موجود و `overwrite=false` |
|
|
175
|
+
| `APPROVED_OVERWRITE_BLOCKED` | كتابة فوق معتمد بدون تفويض صريح جديد |
|
|
176
|
+
| `PATH_TRAVERSAL` | اسم ملف غير آمن |
|
|
177
|
+
| `MISSING_RIGHTS` | `usage_rights/ownership` ناقصة لغير المرجعي |
|
|
178
|
+
| `INVALID_ASSET_TYPE` | نوع خارج القائمة |
|
|
179
|
+
| `EXPIRED_IMAGE_ID` | المعرف المؤقت منتهي |
|
|
180
|
+
| `RIGHTS_LAUNDERING_BLOCKED` | تخفيف قيود بلا override موثق |
|
|
181
|
+
| `BASELINE_REQUIRED_FOR_APPROVAL` | إنتاجي بلا baseline وبلا override (انظر §6) |
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
## 5. `read_visual_baseline`
|
|
186
|
+
|
|
187
|
+
**الغرض:** أداة سياق مشروع مشتركة (وليست Image Tool حرفياً). تُستدعى قبل أي توليد بصري مهم.
|
|
188
|
+
|
|
189
|
+
### Input
|
|
190
|
+
|
|
191
|
+
| الحقل | إلزامي؟ |
|
|
192
|
+
|-------|---------|
|
|
193
|
+
| `project_path` | ✅ |
|
|
194
|
+
|
|
195
|
+
### Output (الحد الأدنى — لا توسعة)
|
|
196
|
+
|
|
197
|
+
```text
|
|
198
|
+
exists true / false
|
|
199
|
+
colors
|
|
200
|
+
typography
|
|
201
|
+
icon_direction
|
|
202
|
+
visual_tone
|
|
203
|
+
approved_assets قائمة مراجع
|
|
204
|
+
style_guide_path إن وجد
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
### السلوك
|
|
208
|
+
|
|
209
|
+
غياب الـbaseline **ليس خطأ** — يُرجع `exists=false` وحقولاً فارغة. الـgenerate يتابع مع `baseline_missing=true`، وقاعدة §6 تمنع الاعتماد.
|
|
210
|
+
|
|
211
|
+
### Errors
|
|
212
|
+
|
|
213
|
+
`PROJECT_NOT_FOUND` فقط.
|
|
214
|
+
|
|
215
|
+
---
|
|
216
|
+
|
|
217
|
+
## 6. قواعد الاعتماد (Approval Rules)
|
|
218
|
+
|
|
219
|
+
```text
|
|
220
|
+
reference
|
|
221
|
+
→ auto-save
|
|
222
|
+
→ approval_status = draft (لا يحتاج approval أصلاً)
|
|
223
|
+
|
|
224
|
+
production / icon / marketing
|
|
225
|
+
→ تُحفظ دائماً كـ draft أولاً
|
|
226
|
+
→ تصبح approved فقط بإحدى:
|
|
227
|
+
(أ) approval_scope = asset_preapproval ضمن مهمة مخولة
|
|
228
|
+
(ب) approval_scope = explicit_approval لاحق (ملف أو مجموعة)
|
|
229
|
+
→ approval_scope = task_authorized وحده لا يكفي أبداً
|
|
230
|
+
→ baseline_missing=true تمنع الـapproved حتى: توجد baseline
|
|
231
|
+
أو approval_scope يتضمن override صريحاً موثقاً
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
> Tool Layer **لا تعتمد بنفسها** — تثبت الحالة حسب النطاق المقدَّم. لا Approval Engine في هذه المرحلة.
|
|
235
|
+
|
|
236
|
+
---
|
|
237
|
+
|
|
238
|
+
## 7. عقد Metadata (13 حقلاً: 10 أساسية + 3 provenance حوكمي)
|
|
239
|
+
|
|
240
|
+
```json
|
|
241
|
+
{
|
|
242
|
+
"asset_type": "reference | production | icon | marketing",
|
|
243
|
+
"provider": "openai",
|
|
244
|
+
"model": "gpt-image-2.5-flare",
|
|
245
|
+
"created_at": "2026-09-12T14:30:00Z",
|
|
246
|
+
"prompt_hash": "sha256:...",
|
|
247
|
+
"prompt_ref": "prompts/2026-09-12/abc123.txt",
|
|
248
|
+
"source_refs": ["wireframe-v1.png"],
|
|
249
|
+
"approval_status": "draft | approved | rejected",
|
|
250
|
+
"usage_rights": "internal | commercial | restricted",
|
|
251
|
+
"ownership": "teranoo | client | third-party",
|
|
252
|
+
|
|
253
|
+
"approval_ref": null,
|
|
254
|
+
"approval_scope": null,
|
|
255
|
+
"rights_override_ref": null
|
|
256
|
+
}
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
- `prompt_ref` اختياري — مسار سجل النص الكامل (لا يُخزَّن النص الحساس داخل كل Metadata).
|
|
260
|
+
- الحقول الثلاثة الأخيرة **nullable/optional** — provenance حوكمي يوثّق *لماذا* اعتُمد الأصل أو خُفف قيده. ليست Audit Framework — مجرد أدلة القرار ملتصقة بالأصل نفسه.
|
|
261
|
+
- لغير المرجعي: `usage_rights` + `ownership` إلزاميان.
|
|
262
|
+
- للمرجعي: افتراضي `internal / teranoo` (أو `third-party` إن كان المصدر خارجياً).
|
|
263
|
+
|
|
264
|
+
### 7.1 مصدر كل حقل: النظام أم المتصل (قاعدة صريحة — أمنية)
|
|
265
|
+
|
|
266
|
+
```text
|
|
267
|
+
Provider/model/prompt/lineage/temp-generation metadata
|
|
268
|
+
is system-derived from image_id and cannot be overridden by the caller.
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
| الحقل | المصدر | هل يقبله `save_asset` من المتصل؟ |
|
|
272
|
+
|-------|--------|----------------------------------|
|
|
273
|
+
| `provider`, `model`, `created_at` | النظام — من سجل `image_id` المؤقت | ❌ مرفوض (`INVALID_INPUT`) إن قُدِّم |
|
|
274
|
+
| `prompt_hash`, `prompt_ref` | النظام — من سجل `image_id` المؤقت | ❌ مرفوض إن قُدِّم |
|
|
275
|
+
| `source_refs` (النسب) | النظام — من `parent_ref`/سلسلة المصدر | ❌ مرفوض إن قُدِّم — يمنع حذف النسب وإظهار الأصل غير مشتق |
|
|
276
|
+
| `baseline_missing` | النظام — من لحظة التوليد | ❌ لا يُمرَّر أصلاً |
|
|
277
|
+
| `approval_status` | النظام — محسوب من `approval_scope` + القواعد (§6) | ❌ المتصل يقدّم `approval_ref/scope` فقط، والحالة تُحسب |
|
|
278
|
+
| `asset_type`, `filename` | المتصل — قرار نية/تسمية | ✅ |
|
|
279
|
+
| `usage_rights`, `ownership` | المتصل — قرار تجاري/حوكمي | ✅ (إلزاميان لغير المرجعي) |
|
|
280
|
+
| `approval_ref`, `approval_scope` | المتصل — دليل التفويض | ✅ (النطاق إلزامي مع المرجع) |
|
|
281
|
+
| `rights_override_ref` | المتصل — دليل تخفيف القيد | ✅ (مشروط — انظر `ASSET_POLICY.md` §4) |
|
|
282
|
+
|
|
283
|
+
> السبب: وكيل سيئ أو مخطئ لا يستطيع تزوير المزوّد أو حذف `source_refs` ليُظهر الأصل غير مشتق — هذه الحماية هي ما يجعل قاعدة Rights Laundering فعّالة فعلاً لا نظرياً.
|
|
284
|
+
|
|
285
|
+
---
|
|
286
|
+
|
|
287
|
+
## 8. دورة حياة المؤقتات (Temp Lifecycle Contract)
|
|
288
|
+
|
|
289
|
+
```text
|
|
290
|
+
image_id → opaque temporary ID — مرتبط بجلسة/عملية — ليس file path — له expires_at
|
|
291
|
+
temp_uri → internal only — لا يُعتمد كمسار مشروع — يُحذف بعد expiry/session cleanup
|
|
292
|
+
save_asset(expired image_id) → EXPIRED_IMAGE_ID
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
المدة الزمنية Configuration لاحقاً — لا تُثبَّت هنا.
|
|
296
|
+
|
|
297
|
+
---
|
|
298
|
+
|
|
299
|
+
## 9. `analyze_image` — قدرة مستقبلية فقط (ليست Tool الآن)
|
|
300
|
+
|
|
301
|
+
```text
|
|
302
|
+
إن دعم موديل OpenCode الـVision مباشرة → يُمرَّر المرجع للنموذج (صفر أدوات).
|
|
303
|
+
وإلا → تُعرَّف analyze_image لاحقاً (image_ref → description).
|
|
304
|
+
```
|
|
305
|
+
|
|
306
|
+
التصنيف: **C — Future Consideration.** المفهوم محفوظ، البناء مؤجل.
|
|
307
|
+
|
|
308
|
+
---
|
|
309
|
+
|
|
310
|
+
## 10. حدود صريحة (ممنوع في هذه المرحلة)
|
|
311
|
+
|
|
312
|
+
```text
|
|
313
|
+
❌ Provider implementation أو API wiring — الـAdapter تعريف حدود فقط
|
|
314
|
+
❌ Agent جديد — التوسيع على ui-designer حصراً
|
|
315
|
+
❌ Approval Engine / Cost Dashboard / Build Gate كامل
|
|
316
|
+
❌ أدواتBeyond الأربع (resize/crop/convert/bg_remove/svg) — كلها Class C
|
|
317
|
+
❌ تسريب أسماء الموديلات لعقد الوكيل — model_hint تجريد فقط
|
|
318
|
+
❌ Automatic fallback بين المزودات
|
|
319
|
+
❌ رقم Cost Guard ثابت في المعمارية — قابل للتهيئة فقط
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
---
|
|
323
|
+
|
|
324
|
+
## 11. مرجع المزود الأول (تعريف حدود — لا تنفيذ)
|
|
325
|
+
|
|
326
|
+
```text
|
|
327
|
+
OpenAIImageAdapter
|
|
328
|
+
├─ model_hint=fast → موديل سريع للمهام اليومية (داخل الـAdapter فقط)
|
|
329
|
+
└─ model_hint=precision → موديل دقيق للتعديل والأصول النهائية (داخل الـAdapter فقط)
|
|
330
|
+
```
|
|
331
|
+
|
|
332
|
+
```text
|
|
333
|
+
LocalOpenVINOAdapter (المزود الافتراضي — قرار تنفيذي معتمد)
|
|
334
|
+
├─ Stable Diffusion 1.5 INT8 عبر OpenVINO (optimum-intel)
|
|
335
|
+
├─ الجهاز من TERA_IMAGE_LOCAL_DEVICE (الافتراضي GPU — هدف Intel Iris Xe)
|
|
336
|
+
├─ model_hint يُقبل ويُتجاهل بالتصميم (موديل واحد محلياً)
|
|
337
|
+
├─ provider=openai الصريح فقط يوجّه للمدفوع — لا fallback آلي أبداً
|
|
338
|
+
└─ cost_estimate = "free-local" — لا يحتاج مفتاحاً
|
|
339
|
+
```
|
|
340
|
+
|
|
341
|
+
أسماء الموديلات الفعلية لا تظهر في أي عقد وكيل أو Tool Layer — تبقى داخل الـAdapters ليعزل تغيّرها لاحقاً. (أسماء المزودين `local/openai` مجردة ومسموحة على السطح — ليست أسماء موديلات.)
|
|
@@ -50,6 +50,7 @@ If the stack is still unclear, do not activate a final profile yet.
|
|
|
50
50
|
| `flutter-mobile` | Flutter + Dart | Available | موبايل — يُحمَّل عند تصنيف المنتج موبايل (MVP_DEFINITION_PROTOCOL + MOBILE_UI_UX_STANDARDS) — (SCP-2026-09-04-003) |
|
|
51
51
|
| `dotnet-razorpages-adonet` | .NET Razor Pages + ADO.NET | Available | تطبيقات أعمال داخلية + تكامل بيانات — (SCP-2026-09-04-003) |
|
|
52
52
|
| `rust` | Rust (cargo/rustc) — 2024 edition, Axum/Tauri/SQLx | **Draft — Needs Verification** | عام: CLI، خدمات عالية الأداء، Tauri، WebAssembly — لا متخصص، يعمل عبر engineering-agent (fallback)؛ الترقية لـ Available بعد تجربة تحقق (SCP-2026-09-04-011) |
|
|
53
|
+
| `bun-ts-monorepo-sqlite` | TypeScript + Bun 1.3.14 + Turbo monorepo + SQLite | **Draft — Needs Verification** | منتج مستقل (APP-TERA_CODE) فوق Baseline موروث — CLI/TUI + Web محلي (127.0.0.1) + Desktop Shell؛ الحقول غير المتحققة موسومة `[Needs Verification — Phase A]`؛ الترقية لـ Available بعد Baseline Comprehension + تجربة تحقق (SCP-2026-09-18-001) |
|
|
53
54
|
|
|
54
55
|
## Placeholder Candidates
|
|
55
56
|
|
|
@@ -0,0 +1,164 @@
|
|
|
1
|
+
# Technology Profile: bun-ts-monorepo-sqlite
|
|
2
|
+
|
|
3
|
+
> **Status: Draft — Needs Verification** (SCP-2026-09-18-001)
|
|
4
|
+
> أُنشئ لمشروع **APP-TERA_CODE** (منتج مستقل — وكيل برمجة AI ذو حوكمة) — معتمد من Majed، بطلب من ApplicationBlueprintAgent (مُهندس).
|
|
5
|
+
> مبني على **قرارات المشروع المعتمدة + بيئة تحقق مؤكدة** فقط (`bun --version` = 1.3.14، `node --version` = v22.22.2 `[Verified]`).
|
|
6
|
+
> **لم يُتحقق ميدانياً من المستودع الموروث بعد.** كل حقل غير مؤكد موسوم `[Needs Verification — Phase A]` ويُستخرج عبر **Baseline Comprehension** المعتمدة في المشروع — **لا يُقدَّر ولا يُخمَّن**. ترقية الحالة إلى `Available` بعد تجربة تحقق فعلية (انظر §10).
|
|
7
|
+
|
|
8
|
+
## 1. Profile Identity
|
|
9
|
+
|
|
10
|
+
- Profile ID: `bun-ts-monorepo-sqlite`
|
|
11
|
+
- Language: TypeScript
|
|
12
|
+
- Framework: Turbo monorepo (Baseline موروث) + Provider Adapter Layer (OpenAI / Anthropic / مزود ثانٍ / Ollama) + Web محلي (bind `127.0.0.1` فقط) + Desktop Shell (Unsigned)
|
|
13
|
+
- Database: SQLite (محرك موروث)
|
|
14
|
+
- ORM: `[Needs Verification — Phase A]` — طبقة الوصول للبيانات مصمَّمة **منخفضة الاقتران (decoupled)**؛ الـ ORM/طبقة الاستعلام الفعلية غير متحققة
|
|
15
|
+
- Package Manager / CLI: **Bun 1.3.14** `[Verified: bun --version]` + Node **v22.22.2** `[Verified: node --version]`
|
|
16
|
+
- Default Project Type: TypeScript monorepo — CLI/TUI + Web محلي + Desktop Shell (منتج حوكمي مستقل فوق Baseline موروث)
|
|
17
|
+
|
|
18
|
+
## 2. Applicability
|
|
19
|
+
|
|
20
|
+
يُستخدم هذا البروفايل عندما:
|
|
21
|
+
|
|
22
|
+
- المشروع TypeScript monorepo يُدار بـ **Bun** وبناءً على **Turbo**.
|
|
23
|
+
- التخزين **SQLite** (محرك موروث أو جديد).
|
|
24
|
+
- الواجهات متعددة: CLI/TUI + Web محلي (loopback فقط) + Desktop Shell.
|
|
25
|
+
- العمل يجري **داخل مستودع موروث كبير** يستلزم استيعاباً انتقائياً لا Pull/Merge.
|
|
26
|
+
- منتج حوكمي/وكيل ذو طبقة مزوّدين (Provider Adapter) لا تطبيق CRUD.
|
|
27
|
+
|
|
28
|
+
**لا يُستخدم:** لتطبيقات ويب خضراء (استخدم `nextjs-prisma`) · ألعاب (استخدم `phaser-react-node`) · .NET (استخدم بروفايلات .NET) · مشاريع لا تحتوي monorepo أو SQLite.
|
|
29
|
+
|
|
30
|
+
**لا يُستخدم كبديل للبروفايل الملغى:** `effect-bun-opencode` ملغى (2026-08-15) ومحتواه مرجع معرفي فقط.
|
|
31
|
+
|
|
32
|
+
## 3. Default Execution Order
|
|
33
|
+
|
|
34
|
+
```text
|
|
35
|
+
0. Baseline Comprehension (إلزامي — انظر §4): خريطة المستودع + استخراج الحقائق غير المتحققة
|
|
36
|
+
1. أثبت الـ toolchain: bun --version + node --version (يطابقان 1.3.14 / v22.22.2)
|
|
37
|
+
2. حدّد الـ package الحدودي الأصغر (أقرب نقطة تكامل) — بلا لمس Core الموروث
|
|
38
|
+
3. types / schemas / contracts قبل السلوك التشغيلي
|
|
39
|
+
4. أدنى مسار تشغيلي يحقق المهمة — مع إبقاء طبقة التخزين خلف واجهة منخفضة الاقتران
|
|
40
|
+
5. إن لزم تعديل Core الموروث → CORE-PATCH مسجل فقط (سجل + سبب + قابلية إزالة)
|
|
41
|
+
6. طبقة البيانات عند الحاجة فقط: SQLite + migration approach الموروث (جدول/جداول `tera_*` معزولة بملكية schema)
|
|
42
|
+
7. تحقق محلي على نطاق الـ package (typecheck / test / build) — بالأوامر المستخرجة لا المفترضة
|
|
43
|
+
8. تقرير: ملفات متغيرة + أوامر فعلية + نتائج تحقق
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## 4. First Task Rule
|
|
47
|
+
|
|
48
|
+
أول مهمة تنفيذية لأي مشروع على هذا البروفايل: **Baseline Comprehension — لا كود منطقي قبلها.**
|
|
49
|
+
|
|
50
|
+
```text
|
|
51
|
+
1. أثبت الـ toolchain: bun --version && node --version (بلا افتراض)
|
|
52
|
+
2. ابنِ خريطة المستودع: workspaces + turbo.json + حدود الـ packages
|
|
53
|
+
3. استخرج وسجّل صراحةً (لا تقدير):
|
|
54
|
+
- أوامر build / test / typecheck الحقيقية
|
|
55
|
+
- Protected Paths + أسطح Plugin/SDK
|
|
56
|
+
- طبقة الوصول للبيانات / ORM الفعلية
|
|
57
|
+
- إطار الـ Desktop Shell
|
|
58
|
+
- إصدارات الحزم المقفلة (lockfile checksum)
|
|
59
|
+
4. شغّل تحققاً ضيقاً واحداً (typecheck أو build لـ package واحد) — بالأمر المستخرج
|
|
60
|
+
5. أي خطوة فشلت → STOP. لا تبنِ فوق Baseline غير متحقق. وثّق السبب في الـ handback.
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
**لا تُعبّأ الحقول غير المتحققة تقديراً في أي مرحلة.**
|
|
64
|
+
|
|
65
|
+
## 5. Scaffold Rules
|
|
66
|
+
|
|
67
|
+
- **ممنوع** إنشاء تطبيق جديد (`bun init` / `bun create`) — المستودع موروث.
|
|
68
|
+
- **ممنوع** إضافة framework جديد.
|
|
69
|
+
- **ممنوع** إضافة تبعية runtime جديدة دون حاجة مؤكدة وموافقة صريحة.
|
|
70
|
+
- **ممنوع** إنشاء package جديد في الـ monorepo دون موافقة.
|
|
71
|
+
- فضّل أنماط المستودع القائمة (modules / exports / schemas / registration).
|
|
72
|
+
- أبقِ الملفات قريبة من حدود الـ package المعني.
|
|
73
|
+
- **ممنوع Pull/Merge من upstream** — استيعاب انتقائي فقط (`ADOPT` / `REIMPLEMENT` / `REJECT`) موثّق لكل عنصر.
|
|
74
|
+
|
|
75
|
+
## 6. ORM / Database Rules
|
|
76
|
+
|
|
77
|
+
- **المحرك:** SQLite — إعادة استخدام بنية الـ infra والـ migration approach الموروثة. `[Needs Verification — Phase A: أداة الترحيل الفعلية]`
|
|
78
|
+
- **عزل الجداول:** جداول `tera_*` معزولة بملكية schema واضحة — لا خلط مع جداول المستودع الموروث.
|
|
79
|
+
- **الاقتران المنخفض:** الوصول للبيانات خلف واجهة (interface/repository) — لا استعلامات موزعة في UI/CLI.
|
|
80
|
+
- **Parameterized queries إلزامي** — ممنوع string interpolation في SQL (SQL Injection — OWASP).
|
|
81
|
+
- **⛔ ممنوع تحويل قواعد إدارة الحالة / قواعد العمل إلى قيود قاعدة بيانات** (لا `CHECK`/`trigger` لتشفير state machines أو قواعد العمل) — تُنفَّذ في طبقة التطبيق.
|
|
82
|
+
- **أي migration أو تغيير schema = بوابة موافقة صريحة** (مثل سياسة migrations في المنظومة).
|
|
83
|
+
- النسخ الاحتياطي و WAL والاستبقاء: `[Needs Verification — Phase A]`.
|
|
84
|
+
|
|
85
|
+
## 7. CLI Side Effects
|
|
86
|
+
|
|
87
|
+
| الأمر | الأثر | بوابة؟ |
|
|
88
|
+
|-------|-------|--------|
|
|
89
|
+
| `bun --version` / `node --version` | قراءة فقط | لا |
|
|
90
|
+
| `bun install` | يثبّت تبعيات + يكتب lockfile | نعم (تغيير تبعيات) |
|
|
91
|
+
| `bun run <script>` | حسب السكربت (قد يبني/يشغّل/يختبر) | حسب الأثر |
|
|
92
|
+
| `bun test` | يشغّل الاختبارات | لا |
|
|
93
|
+
| `bunx <pkg>` | يشغّل حزمة مؤقتة — **قناة خارجية** | نعم (ضمن Allowlist فقط) |
|
|
94
|
+
| `bun build` | ينتج مخرجات بناء | لا |
|
|
95
|
+
| `bun run migrate` (الاسم الفعلي غير متحقق) | **يغيّر قاعدة البيانات** | **نعم — صريحة** |
|
|
96
|
+
| تشغيل خادم Web محلي | يجب أن يبقى على `127.0.0.1` | نعم إن خرج عن loopback |
|
|
97
|
+
| `git pull` / `git merge` من upstream | **ممنوع منعاً مطلقاً** | ممنوع |
|
|
98
|
+
|
|
99
|
+
**القاعدة:** أي أمر يغيّر قاعدة بيانات، أو ينفّذ كوداً من مصدر خارجي، أو يفتح منفذاً خارج loopback = بوابة موافقة.
|
|
100
|
+
|
|
101
|
+
## 8. Forbidden Defaults
|
|
102
|
+
|
|
103
|
+
```text
|
|
104
|
+
❌ Pull/Merge من upstream — استيعاب انتقائي فقط (ADOPT / REIMPLEMENT / REJECT)
|
|
105
|
+
❌ تعديل Core الموروث خارج CORE-PATCH مسجل (سجل + سبب + قابلية إزالة)
|
|
106
|
+
❌ أي outbound غير معروف — blocked افتراضياً؛ Allowlist صريح فقط
|
|
107
|
+
❌ auto-update · telemetry · أي قناة قياس/إحصاء صامتة
|
|
108
|
+
❌ أسرار plaintext في الكود/الملفات — Env vars أو تخزين آمن بالنظام + Redaction في السجلات
|
|
109
|
+
❌ ترميز قواعد العمل/الحالة كقيود قاعدة بيانات (CHECK/trigger)
|
|
110
|
+
❌ String interpolation في SQL — parameterized فقط
|
|
111
|
+
❌ فتح خادم Web على غير 127.0.0.1 دون موافقة صريحة
|
|
112
|
+
❌ إضافة تبعية runtime / framework / package جديد بلا موافقة
|
|
113
|
+
❌ تجاوز ميزانية صيانة upstream (> 25% من وقت المشروع)
|
|
114
|
+
❌ تعبئة حقل `[Needs Verification — Phase A]` بتقدير أو اختراع
|
|
115
|
+
❌ رفع حالة البروفايل إلى Available قبل تحقق فعلي
|
|
116
|
+
❌ واجهة عربية-أولاً — English-first إلزامي، والعربية جاهزية لا أساس
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
## 9. Pre-Execution Gate Additions
|
|
120
|
+
|
|
121
|
+
إضافات هذا البروفايل على `TeraPreExecutionGate.md`:
|
|
122
|
+
|
|
123
|
+
| # | الفحص قبل التنفيذ |
|
|
124
|
+
|---|-------------------|
|
|
125
|
+
| 1 | `bun --version` = 1.3.14 و `node --version` = v22.22.2 (أو انحراف موثّق بموافقة)؟ إن لا → STOP |
|
|
126
|
+
| 2 | هل Baseline Comprehension مكتملة والحقول غير المتحققة مستخرجة (لا مقدّرة)؟ |
|
|
127
|
+
| 3 | هل نطاق المهمة داخل package unit محدد — بلا لمس Core موروث؟ |
|
|
128
|
+
| 4 | إن لمس Core: هل يوجد CORE-PATCH مسجل (سبب + قابلية إزالة)؟ |
|
|
129
|
+
| 5 | هل كل outbound مخطط داخل Allowlist صريح (Provider Adapter / update / telemetry)؟ |
|
|
130
|
+
| 6 | هل الأسرار من Env/OS-secure؟ وهل Redaction مُعدّ للسجلات؟ |
|
|
131
|
+
| 7 | هل المهمة تلمس schema/migrations؟ إن نعم → موافقة صريحة + عدم ترميز قواعد عمل في DB |
|
|
132
|
+
| 8 | هل خادم الـ Web مقيّد بـ 127.0.0.1؟ |
|
|
133
|
+
| 9 | هل الأوامر المستخدمة هي المستخرجة فعلاً (لا مفترضة)؟ |
|
|
134
|
+
| 10 | إن ظهرت حاجة لتقنية جديدة/مزوّد جديد → STOP واطلب قرار Majed |
|
|
135
|
+
|
|
136
|
+
## 10. Acceptance Criteria Patterns
|
|
137
|
+
|
|
138
|
+
```text
|
|
139
|
+
✅ typecheck يمر بالأمر المستخرج من المستودع (لا المفترض)
|
|
140
|
+
✅ اختبارات الـ package المعني تمر (نطاق package — لا repo-wide بلا سبب)
|
|
141
|
+
✅ build ينجح إن كان للمهمة مخرج بناء
|
|
142
|
+
✅ لا تعديل على Core الموروث خارج CORE-PATCH مسجل
|
|
143
|
+
✅ صفر Pull/Merge من upstream + كل استيعاب موثّق ADOPT/REIMPLEMENT/REJECT
|
|
144
|
+
✅ صفر outbound خارج Allowlist · صفر telemetry · صفر auto-update
|
|
145
|
+
✅ صفر أسرار plaintext + Redaction فعّال في مخرجات السجل
|
|
146
|
+
✅ صفر قواعد عمل/حالة مشفّرة كقيود قاعدة بيانات
|
|
147
|
+
✅ SQL parameterized فقط + migrations قابلة للتراجع
|
|
148
|
+
✅ استمرارية الواجهة: English-first + جاهزية عربية (RTL) لا تتضرر
|
|
149
|
+
✅ تقرير التسليم: ملفات متغيرة + أوامر فعلية + نتائج تحقق + أي حقل ما زال [Needs Verification]
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
### مسار الترقية إلى Available (خطوات التحقق المتبقية — Phase A)
|
|
153
|
+
|
|
154
|
+
```text
|
|
155
|
+
1. إكمال Baseline Comprehension واستخراج الحقول الستة غير المتحققة (أوامر/ORM/Protected Paths/Shell/lockfile)
|
|
156
|
+
2. تجربة تحقق فعلية واحدة: typecheck + test + build لـ package حقيقي → PASS
|
|
157
|
+
3. تحديث هذا الملف: تعبئة الحقول الموسومة + رفع §1 Status من Draft → Available
|
|
158
|
+
4. تحديث الحالة في PROFILES_INDEX + TeraCapabilityMap (نفس نمط rust)
|
|
159
|
+
5. موافقة Majed على الترقية
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
*أُنشئ: TeraSystemEvolutionAgent (حارس) — 2026-09-18 · SCP-2026-09-18-001 · مبني على قرارات مشروع APP-TERA_CODE المعتمدة + بيئة تحقق مؤكدة · **Draft حتى Baseline Comprehension وتجربة تحقق فعلية**.*
|