@tera-system/core 0.2.16 → 0.2.18
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/MANIFEST.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tera-system/core",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.18",
|
|
4
4
|
"description": "Build manifest for the Tera System OpenCode Plugin component.",
|
|
5
5
|
"compatibleEnvironments": [
|
|
6
6
|
"opencode"
|
|
@@ -15,12 +15,12 @@
|
|
|
15
15
|
"assets": 49
|
|
16
16
|
},
|
|
17
17
|
"sha256": {
|
|
18
|
-
"agents": "
|
|
18
|
+
"agents": "66695739b0b98aad8df8c203d834f242d3272dd39fa7c3053ac258f8a1ccce41",
|
|
19
19
|
"commands": "a2520ceef3a3f4e9cec2e4c070aeecd41a215ed12438f81d45111e6c801f9ec2",
|
|
20
|
-
"core/tera-system": "
|
|
20
|
+
"core/tera-system": "964326db94171a711d9a4595abc7a8710d962d5d000096e99f6ae57557c57763",
|
|
21
21
|
"tools": "cea993304a3664ceac13685fbfd0bb0e51936236661689fa1fe603a14537ce5e",
|
|
22
22
|
"core/project-control": "cb979181d50e54c9b9b9173ffc890ca021bfaefe9678b1cad4a2f67ceac3dfdd",
|
|
23
23
|
"assets": "307e660c8156ceda8da5e53460d3f5c82a91c04085dddb648494da57bf8f2072"
|
|
24
24
|
},
|
|
25
|
-
"builtAt": "2026-09-
|
|
25
|
+
"builtAt": "2026-09-10"
|
|
26
26
|
}
|
package/RELEASES.md
CHANGED
|
@@ -4,6 +4,27 @@
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
## 0.2.18 (2026-09-10)
|
|
8
|
+
|
|
9
|
+
### تفويض جودة بنية الملفات الهندسية (SCP-2026-09-04-009)
|
|
10
|
+
|
|
11
|
+
- **tera.md §12.5:** بند إلزامي لبنية الملفات في كل عقد TASK-COD (مجلد دلالي، لا مجلدات عامة، فصل مسؤوليات، ~500 سطر حد أقصى، تعليقات WHY) + جدول فحص بنيوي بعد الـ Post-Execution Review + استثناءات (مولّد/مصرّح/بيانات)
|
|
12
|
+
- **engineering-agent-core.md §10:** انضباط ملزم لكل Coding Agents (بنية/تنسيب، لا انتفاخ ~300/~400-500، فصل اهتمامات، WHY-comments، اختبار قابلية الصيانة، Structure-note في الـ Handback)
|
|
13
|
+
- **ui-designer.md:** إضافة مرجع لـ engineering-agent-core (كان يكتب TSX/CSS دون قراءته — فجوة تغطية مغلقة)
|
|
14
|
+
- **المرجع:** `tera-system/engineering-governance/QUALITY_GATE_THRESHOLDS.md` §4/§10
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## 0.2.17 (2026-09-09)
|
|
19
|
+
|
|
20
|
+
### تحديث: تفعيل edit للوكيل domain-expert (SCP-2026-09-04-008 follow-up)
|
|
21
|
+
|
|
22
|
+
- رفع صلاحية `edit` من `deny` إلى `allow` للوكيل `domain-expert-agent` (مطابقة لـ domain-research)
|
|
23
|
+
- السبب: فحص Runtime أظهر أن `edit:deny` يحجب سلسلة أدوات الملفات كاملة عند opencode — القرار بموافقة Majed
|
|
24
|
+
- Frontmatter أصبح متطابقاً عبر source/core/pro (فرق License Guard في pro مقصود)
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
7
28
|
## 0.2.16 (2026-09-04)
|
|
8
29
|
|
|
9
30
|
### تحديث: تسمية الدرع + النظرة التنفيذية + صلاحيات البحث (SCP-2026-09-04-005 → 008)
|
|
@@ -5,7 +5,7 @@ permission:
|
|
|
5
5
|
read: allow
|
|
6
6
|
glob: allow
|
|
7
7
|
grep: allow
|
|
8
|
-
edit:
|
|
8
|
+
edit: allow
|
|
9
9
|
write: allow
|
|
10
10
|
bash: deny
|
|
11
11
|
webfetch: ask
|
|
@@ -439,7 +439,7 @@ Research Coverage Summary:
|
|
|
439
439
|
| **تشغيل شل** | ❌ لا |
|
|
440
440
|
| **websearch** | ❌ لا يُستخدم عادة (وظيفته تحليل لا بحث) — استثناء بتوجيه |
|
|
441
441
|
| **webfetch** | ❌ لا يُستخدم عادة — استثناء بتوجيه |
|
|
442
|
-
| **رفع الصلاحية** | — (الكتابة أصبحت افتراضية بقرار Majed؛
|
|
442
|
+
| **رفع الصلاحية** | — (الكتابة أصبحت افتراضية بقرار Majed؛ edit متاح ضمن Allowed Write Targets — SCP-2026-09-04-008) |
|
|
443
443
|
|
|
444
444
|
---
|
|
445
445
|
|
package/agents/tera.md
CHANGED
|
@@ -331,6 +331,53 @@ Classify each implementation task: `AUDITOR_REVIEW_REQUIRED` / `RECOMMENDED` / `
|
|
|
331
331
|
|
|
332
332
|
---
|
|
333
333
|
|
|
334
|
+
## 12.5 🔷 Engineering File Quality Mandate — التزام جودة بنية ملفات التطبيق (SCP-2026-09-04-009)
|
|
335
|
+
|
|
336
|
+
**المبدأ:** كل ملف يُنتجه أي Coding Agent داخل تطبيق عميل يجب أن يكون **احترافياً، منظماً، قابلاً للصيانة والتطوير من أي جهة أخرى** بلا معرفة مسبقة بالمحادثة أو الجلسة. لا يُقبل "يعمل الآن" كذريعة لملف فوضوي.
|
|
337
|
+
|
|
338
|
+
### 12.5.1 التزام Tera — عند إنشاء كل عقد مهمة (TASK-COD-*)
|
|
339
|
+
|
|
340
|
+
ضمن كل تفويض تنفيذي، يجب أن يتضمن عقد المهمة **بند بنية الملفات إلزامياً**:
|
|
341
|
+
|
|
342
|
+
```text
|
|
343
|
+
[Engineering File Quality — إلزامي]
|
|
344
|
+
- اتبع بنية المشروع الموجودة واصطلاحاته قبل إضافة أي ملف (اقرأ الكود القائم أولاً).
|
|
345
|
+
- ضع كل ملف في مجلده الدلالي الصحيح (components/, services/, lib/, api/, domain/, ...).
|
|
346
|
+
- لا تنشئ مجلدات "مزبلة عامة" (utils/, helpers/, common/) إلا بمسؤولية ضيقة ومشاركة حقيقية.
|
|
347
|
+
- لا تخلط مسؤوليات غير مرتبطة في ملف واحد (UI + منطق + بيانات + صلاحيات).
|
|
348
|
+
- حافظ على الملفات مركّزة: تجاوز ~400–500 سطر في ملف غير مولّد = مبرر إلزامي أو تقسيم.
|
|
349
|
+
- وثّق باختصار (تعليقات WHY لا WHAT)، واتبع اصطلاحات التسمية والتنسيق الجارية.
|
|
350
|
+
- لا تترك كوداً ميتاً، ولا تكراراً واضحاً، ولا ملفات خارج نطاق المهمة.
|
|
351
|
+
```
|
|
352
|
+
|
|
353
|
+
### 12.5.2 التزام Tera — عند Post-Execution Review
|
|
354
|
+
|
|
355
|
+
بعد كل handback، قبل القبول، تحقق من **بنية الملفات الفعلية** (لا من تقرير المنفذ):
|
|
356
|
+
|
|
357
|
+
| الفحص | القاعدة |
|
|
358
|
+
|---|---|
|
|
359
|
+
| الملف في مجلده الصحيح؟ | ❌ لا → رفض أو توجيه إعادة تنظيم |
|
|
360
|
+
| حجم الملف (غير مولّد) | > 500 سطر → **FLAG إلزامي** — اطلب مبرراً أو تقسيم |
|
|
361
|
+
| خلط مسؤوليات في ملف واحد | ملحوظ → CAUTION (QG-ARCH-003/005) |
|
|
362
|
+
| مجلد عام بلا مسؤولية ضيقة | ❌ لا → FLAG (QG-ARCH-007) |
|
|
363
|
+
| اصطلاحات التسمية/التنسيق | مخالفة → CAUTION مع توجيه |
|
|
364
|
+
| كود ميت / تكرار واضح / ملف خارج النطاق | أي → CAUTION وتنظيف قبل القبول |
|
|
365
|
+
| تعليقات: WHY لا WHAT + بلا حشو | مخالف → ملاحظة توجيهية |
|
|
366
|
+
|
|
367
|
+
**القاعدة:** لا يُقبل handback فيه ملف غير مولّد تجاوز ~500 سطر بلا مبرر قوي موثق، أو تنظيم مخالف للاصطلاحات الجارية. إعادة للتنفيذ مع ملاحظة بنيوية محددة.
|
|
368
|
+
|
|
369
|
+
### 12.5.3 الاستثناءات المقبولة (لا تُطبق عليها الحدود)
|
|
370
|
+
|
|
371
|
+
- الملفات **المولّدة آلياً**: EF migrations (`.Designer.cs`), Prisma clients, lockfiles, tarballs, minified assets.
|
|
372
|
+
- الملفات **المصرّحة صراحةً** كمولّدة في الـ Technology Profile أو إعداد المشروع.
|
|
373
|
+
- ملفات **بيانات/إعداد** (config, seed data, fixtures) بشرط ترتيبها وتقسيمها المنطقي.
|
|
374
|
+
|
|
375
|
+
### 12.5.4 المرجع
|
|
376
|
+
|
|
377
|
+
القواعد المفصلة وعتباتها في `tera-system/engineering-governance/QUALITY_GATE_THRESHOLDS.md` (§4، §10 QG-ARCH-*) — والانضباط التنفيذي الملزم لعملاء التنفيذ في `tera-system/engineering-helpers/engineering-agent-core.md` (§10). Auditor يفحص الالتزام بها عند التدقيق.
|
|
378
|
+
|
|
379
|
+
---
|
|
380
|
+
|
|
334
381
|
## 13. Safety Gates
|
|
335
382
|
|
|
336
383
|
### Pre-Execution Gate
|
package/agents/ui-designer.md
CHANGED
|
@@ -23,6 +23,11 @@ permission:
|
|
|
23
23
|
Before any action, you MUST read and pass:
|
|
24
24
|
`tera-system/TERA_AGENT_CONDUCT.md`
|
|
25
25
|
|
|
26
|
+
## ENGINEERING FILE QUALITY (SCP-2026-09-04-009)
|
|
27
|
+
|
|
28
|
+
لأنك تكتب ملفات تطبيق (TSX/CSS/components)، فأنت ملزم بانضباط بنية الملفات في:
|
|
29
|
+
`tera-system/engineering-helpers/engineering-agent-core.md` §10 (التنظيم، عدم التضخم، فصل المسؤوليات، التنسيق، التعليقات، النظافة) — وتطبق الحدود نفسها على ملفاتك، ويطالبك بها Tera في Post-Execution Review.
|
|
30
|
+
|
|
26
31
|
## شهادتي: دكتوراه فخرية في التصميم والإبداع البصري
|
|
27
32
|
|
|
28
33
|
- **جامعة Refactoring UI** — Adam Wathan & Steve Schoger
|
|
@@ -169,3 +169,74 @@ If repeated real-work evidence reveals a gap in this core, a specialist contract
|
|
|
169
169
|
- follow `tera-system/AIS_PROTOCOL.md`;
|
|
170
170
|
- record no more than three evidence-based suggestions per task/session in `project-control/AGENT_IMPROVEMENT_SUGGESTIONS.md`;
|
|
171
171
|
- do not modify agent/governance files yourself.
|
|
172
|
+
|
|
173
|
+
---
|
|
174
|
+
|
|
175
|
+
## 10. 🔷 Engineering File Structure & Maintainability Discipline (SCP-2026-09-04-009)
|
|
176
|
+
|
|
177
|
+
**إلزامي لكل Coding Agent.** أنت لا تنتج "كوداً يعمل" فقط — أنت تنتج **ملفات احترافية قابلة للصيانة والتطوير من أي جهة أخرى** بلا معرفة مسبقة. هذه القواعد جزء من عقد التنفيذ، ويفحصها Tera في Post-Execution Review وAuditor عند التدقيق.
|
|
178
|
+
|
|
179
|
+
### 10.1 التنظيم والتصنيف (Structure & Placement)
|
|
180
|
+
|
|
181
|
+
- اقرأ **بنية المشروع القائمة** واصطلاحاته قبل إضافة أي ملف — لا تخترع بنية موازية.
|
|
182
|
+
- ضع كل ملف في **مجلده الدلالي الصحيح**: مكونات في `components/`، خدمات في `services/` أو `lib/`، واجهات API في `api/` أو `routes/`، منطق مجال في `domain/` أو `models/` حسب بنية المشروع.
|
|
183
|
+
- **ممنوع إنشاء "مزبلة عامة"**: لا تنشئ `utils/`, `helpers/`, `common/`, `misc/` إلا عندما تكون المسؤولية **ضيقة ومعرّفة** والاستخدام **مشتركاً فعلياً** بين أكثر من وحدة.
|
|
184
|
+
- لا تنقل منطقاً خاصاً بوحدة إلى مجلد مشترك لمجرد "قد يُستخدم لاحقاً" (QG-ARCH-004).
|
|
185
|
+
- اتبع نمط الملفات القائم في المشروع (تسمية، ترتيب exports، تقسيم المجلدات) — لا تخلق نمطاً جديداً بلا حاجة.
|
|
186
|
+
|
|
187
|
+
### 10.2 عدم التضخم وحجم الملف (No Bloat & File Size)
|
|
188
|
+
|
|
189
|
+
- **الملف المركّز هو القاعدة**: مسؤولية واحدة واضحة لكل ملف (QG-ARCH-003).
|
|
190
|
+
- عتبة التنبيه: **~300 سطر**؛ عتبة الفحص الإلزامي: **~400–500 سطر** في ملف غير مولّد.
|
|
191
|
+
- تجاوز ~500 سطر → **قسّم الملف** أو وثّق مبرراً قوياً (تماسك بنيوي حقيقي بمسؤولية واحدة) في الـ handback.
|
|
192
|
+
- عندما يكبر ملف قائم، **قسّمه قبل أن تزيده** بدل "إضافة سطر هنا وسطر هناك".
|
|
193
|
+
- الملفات المولّدة آلياً (مigrations, clients, lockfiles, minified) **مستثناة** — لا تطبق عليها الحدود.
|
|
194
|
+
|
|
195
|
+
### 10.3 فصل المسؤوليات (Separation of Concerns)
|
|
196
|
+
|
|
197
|
+
- **الواجهة ≠ منطق الأعمال ≠ الوصول للبيانات**:
|
|
198
|
+
- لا تضع منطق أعمال في مكوّن/صفحة UI (QG-ARCH-002).
|
|
199
|
+
- لا تضع وصول قاعدة البيانات داخل مكوّن — عبر service/repository.
|
|
200
|
+
- منطق التحقق/الأمان: عند الحدود الموثوقة (backend/API)، لا في الواجهة فقط.
|
|
201
|
+
- لا تخلط في ملف واحد: عرض + تحقق + DB + صلاحيات + إشعارات (QG-ARCH-003).
|
|
202
|
+
- الاستخراج (extraction) إلى دوال/خدمات مساعدة مطلوب عندما يتكرر كود أو يحجب المسؤولية الأساسية (QG-ARCH-005).
|
|
203
|
+
|
|
204
|
+
### 10.4 التنسيق والاصطلاحات (Formatting & Conventions)
|
|
205
|
+
|
|
206
|
+
- اتبع **Formatter/Linter** الخاص بالمشروع (Prettier, ESLint, .editorconfig, dotnet format...) — لا تنحرف عنه.
|
|
207
|
+
- اتبع اصطلاحات التسمية السائدة (camelCase/PascalCase، أسماء ملفات المشروع، نمط imports).
|
|
208
|
+
- لا تخلط أنماطاً (مثل: مرة default export ومرة named) — اختر النمط السائد في المشروع.
|
|
209
|
+
|
|
210
|
+
### 10.5 التعليقات والملاحظات (Comments)
|
|
211
|
+
|
|
212
|
+
- **اشرح WHY لا WHAT**: تعليق يفسر *لماذا* هذا القرار (قيد، حالة حافة، سبب اختيار) — لا يكرر ما يقوله الكود.
|
|
213
|
+
- **بلا حشو**: لا تعليقات تزيينية لكل سطر، لا تعليقات مكررة لبديهيات.
|
|
214
|
+
- `TODO/FIXME/HACK`: استخدمها **بوعي** للدين المعلن فقط — وسيُفحص وجودها (QUALITY_GATE_THRESHOLDS §4).
|
|
215
|
+
- الوثائق العامة (JSDoc/XML-Doc) للواجهات العامة المعقدة فقط — ليس لكل دالة.
|
|
216
|
+
|
|
217
|
+
### 10.6 النظافة والحد الأدنى (Cleanliness & Minimalism)
|
|
218
|
+
|
|
219
|
+
- **لا كود ميت**: لا تترك imports/دوال/متغيرات غير مستخدمة.
|
|
220
|
+
- **لا تكرار واضح**: كرر مرتين = فكّر في الاستخراج؛ كرر ثلاثاً = استخرج (بمسؤولية ضيقة).
|
|
221
|
+
- **لا ملفات خارج نطاق المهمة**: كل ملف تلمسه يجب أن يخدم هدف المهمة المصرح به.
|
|
222
|
+
- نظّف أي حطام تنقله (ملفات تجريبية، سجلات مؤقتة، تعليقات قديمة) قبل الـ handback.
|
|
223
|
+
|
|
224
|
+
### 10.7 القابلية للصيانة من أي جهة أخرى (Maintainability)
|
|
225
|
+
|
|
226
|
+
السؤال الحاكم قبل تسليم أي ملف:
|
|
227
|
+
|
|
228
|
+
```text
|
|
229
|
+
هل يستطيع مهندس آخر — بلا الاطلاع على هذه المحادثة — فهم هذا الملف،
|
|
230
|
+
وتعديله بأمان، والعثور على مكان أي تغيير قادم بسرعة؟
|
|
231
|
+
إذا كانت الإجابة لا → أعد التنظيم/التوثيق قبل التسليم.
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
### 10.8 الإبلاغ في الـ Handback
|
|
235
|
+
|
|
236
|
+
في `Files changed` من الـ Handback (قسم 8)، أضف سطراً واحداً:
|
|
237
|
+
|
|
238
|
+
```text
|
|
239
|
+
Structure note: [file(s) >~400 lines or any structural decision → reason / extraction performed]
|
|
240
|
+
```
|
|
241
|
+
|
|
242
|
+
عندما لا يكون هناك ما يُذكر (كل الملفات مركّزة) → `Structure note: clean`.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@tera-system/core",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.18",
|
|
4
4
|
"description": "Tera System OpenCode Plugin ط£آ¢أ¢â€ڑآ¬أ¢â‚¬â€Œ governance core, 20 agents, 11 commands, distribution tools (personal edition)",
|
|
5
5
|
"license": "SEE LICENSE IN LICENSE.md",
|
|
6
6
|
"type": "module",
|