@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.
@@ -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 وتجربة تحقق فعلية**.*