@tera-system/core 0.5.0 → 0.6.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.
Files changed (41) hide show
  1. package/MANIFEST.json +7 -7
  2. package/RELEASES.md +13 -0
  3. package/agents/application-blueprint.md +6 -6
  4. package/agents/auditor.md +19 -2
  5. package/agents/tera-client-engagement.md +6 -6
  6. package/agents/tera-system-evolution.md +1 -1
  7. package/agents/tera.md +2 -0
  8. package/commands/tera-approve.md +43 -34
  9. package/commands/tera-diagnose.md +2 -0
  10. package/commands/tera-gate.md +2 -0
  11. package/commands/tera-help.md +1 -0
  12. package/commands/tera-new-project.md +32 -35
  13. package/commands/tera-plan.md +2 -0
  14. package/commands/tera-reconcile.md +35 -0
  15. package/commands/tera-request-build.md +2 -0
  16. package/commands/tera-resume.md +2 -0
  17. package/commands/tera-review.md +2 -0
  18. package/commands/tera-status.md +2 -0
  19. package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +10 -6
  20. package/core/tera-system/AGENT_DEPENDENCY_MAP.md +9 -7
  21. package/core/tera-system/AGENT_GENERATION_TEMPLATE.md +6 -5
  22. package/core/tera-system/AGENT_PERMISSION_MODEL.md +26 -9
  23. package/core/tera-system/TERA_AGENT_CONDUCT.md +17 -0
  24. package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +1 -1
  25. package/core/tera-system/TeraPolicyMap.md +4 -2
  26. package/core/tera-system/TeraPreExecutionGate.md +34 -0
  27. package/core/tera-system/TeraPreparationDocumentationGovernance.md +21 -15
  28. package/core/tera-system/TeraSubAgents.md +2 -1
  29. package/core/tera-system/TeraSystemMaintenanceChecklist.md +12 -0
  30. package/core/tera-system/client-helpers/tera-client-engagement-gates.md +2 -2
  31. package/core/tera-system/client-helpers/tera-client-engagement-pricing.md +1 -1
  32. package/core/tera-system/client-helpers/tera-client-engagement-protocols.md +14 -9
  33. package/core/tera-system/engineering-helpers/database-privileges.md +63 -0
  34. package/core/tera-system/engineering-helpers/engineering-agent-core.md +11 -0
  35. package/core/tera-system/profiles/rust.md +1 -0
  36. package/core/tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md +1 -1
  37. package/core/tera-system/runtime/TERA_COMMAND_PROTOCOL.md +86 -0
  38. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +14 -0
  39. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +2 -2
  40. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +9 -2
  41. package/package.json +2 -2
package/MANIFEST.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tera-system/core",
3
- "version": "0.5.0",
3
+ "version": "0.6.0",
4
4
  "description": "Build manifest for the Tera System OpenCode Plugin component.",
5
5
  "compatibleEnvironments": [
6
6
  "opencode"
@@ -8,19 +8,19 @@
8
8
  "minOpencodeVersion": "1.18.16",
9
9
  "content": {
10
10
  "agents": 25,
11
- "commands": 37,
12
- "coreFiles": 124,
11
+ "commands": 38,
12
+ "coreFiles": 126,
13
13
  "tools": 8,
14
14
  "projectControlTemplates": 1,
15
15
  "assets": 50
16
16
  },
17
17
  "sha256": {
18
- "agents": "73146cd23a88f9b3c5939a5e5a86034601a3a8e441f3ce8bdbccfa288050a50e",
19
- "commands": "ee8e7f6982abe2d3aa8fd77c69f6cec19836d8d6da2ddc0a5c15b70bba41df2c",
20
- "core/tera-system": "8064fa7d687e2ff1c7f5ee2831e919d69ae41872642c7b47d241f5247b1b8ded",
18
+ "agents": "b097c0ece06182b9ef7a7f400900ac9a6a61e3ea2994687b9262946a8cc397f5",
19
+ "commands": "e54006e16ce0cd87f250b414cb56b0572271b739b4f418667da826f18fa9bed5",
20
+ "core/tera-system": "46d291a1409c0bc296685ef275455ddf15f69466d85ca82715f5d06246f40c24",
21
21
  "tools": "60e9fb5fa05afa63053d8f6d80a371cdc288448e7c13831066b4d08f0573539e",
22
22
  "core/project-control": "cb979181d50e54c9b9b9173ffc890ca021bfaefe9678b1cad4a2f67ceac3dfdd",
23
23
  "assets": "aba6595329e1b56b29fd677f2075d841c930953cdfa67ec808a85923071c3471"
24
24
  },
25
- "builtAt": "2026-09-24"
25
+ "builtAt": "2026-09-26"
26
26
  }
package/RELEASES.md CHANGED
@@ -4,6 +4,19 @@
4
4
 
5
5
  ---
6
6
 
7
+ ## 0.6.0 (2026-09-26)
8
+
9
+ ### تحصين الحوكمة + بروتوكولات تشغيل جديدة (SCP-2026-09-24-001…006)
10
+
11
+ - **بروتوكول الأوامر:** `runtime/TERA_COMMAND_PROTOCOL.md` (جديد).
12
+ - **مساعد صلاحيات قاعدة البيانات:** `engineering-helpers/database-privileges.md` (جديد).
13
+ - **تحصين Runtime/Orchestration** (SCP-002) + **تحصين TCEA** (SCP-003) + **تحصين حوكمة التحضير** (SCP-004).
14
+ - **ترقية دروس التحقق التجريبية إلى النواة** (SCP-005 — من Reach/TASK-COD-318).
15
+ - **إعادة استخدام `auditor` للمراجعة المتقاطعة للتحضير** (SCP-006 — بلا وكيل جديد).
16
+ - **العدادات:** الأوامر 37 → **38**، ملفات `tera-system/` 124 → **126**، الوكلاء 25 (بلا تغيير).
17
+
18
+ ---
19
+
7
20
  ## 0.5.0 (2026-09-24)
8
21
 
9
22
  ### وكلاء متخصصون جدد: Flutter + Django (SCP-2026-09-23-006 — GAP-025)
@@ -76,7 +76,7 @@ TCEA → confirmed handoff
76
76
  2. تقييم العمق والمخاطر والفجوات.
77
77
  3. إنتاج Blueprint + ملفات التحضير الدقيقة.
78
78
  4. إدارة TASK-PREP-* وعملاء التحضير.
79
- 5. تطبيق Maker/Checker وCross-Review واتساق الوثائق.
79
+ 5. تطبيق Maker/Checker وCross-Review (عبر `auditor` — وضع `Preparation-Review`) واتساق الوثائق.
80
80
  6. إنتاج Solution Readiness Gate وEngineering Handoff Package.
81
81
  7. تسليم حزمة Baseline-ready إلى TeraAgent عبر Majed.
82
82
  ```
@@ -149,9 +149,9 @@ tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md — قوالب الت
149
149
 
150
150
  ### المرحلة 4 — Preparation Delegation & Baseline
151
151
 
152
- 1. إنتاج `AGENT_DELEGATION_PLAN.md`.
153
- 2. تفويض `TASK-PREP-*` لعملاء التحضير بنطاقات كتابة واضحة.
154
- 3. تطبيق Maker/Checker وCross-Review على كل ملف تحضيري.
152
+ 1. إنتاج `AGENT_DELEGATION_PLAN.md`.
153
+ 2. تفويض `TASK-PREP-*` لعملاء التحضير بنطاقات كتابة واضحة.
154
+ 3. تطبيق Maker/Checker وCross-Review على كل ملف تحضيري — **بعد كتابة كل دفعة، استدعِ `auditor` في وضع `Preparation-Review` كمراجع مستقل (Checker ≠ Maker) ثم عالِج النتائج** (SCP-2026-09-24-006).
155
155
  4. تتبّع كل متطلب إلى مصدره ومساره وشاشته وبياناته ومعيار قبوله.
156
156
  5. إدارة lifecycle ملفات التحضير حتى `Module Baseline Approved` فأعلى.
157
157
 
@@ -329,7 +329,7 @@ Majed → Tera
329
329
  ❌ لا تدخل Build Mode
330
330
  ❌ لا تدير EngineeringAgent أو engineering-agent-dotnet أو tera-software-designer للتنفيذ
331
331
  ❌ لا تدير qa-agent Execution Mode
332
- ❌ لا تستدعي Auditor
332
+ ❌ لا تستدعي Auditor — **باستثناء وضع `Preparation-Review`** لدفعة تحضير (مراجعة اتساق · قراءة فقط — SCP-2026-09-24-006)
333
333
  ❌ لا تعتمد سعراً أو نطاقاً أو التزاماً تجارياً
334
334
  ❌ لا تتواصل مع العميل مباشرة
335
335
  ❌ لا تعتبر بحثاً أو افتراضاً جزءاً من baseline دون تأكيد Majed
@@ -396,7 +396,7 @@ Hand off with evidence. Never write code.
396
396
  | تصميم بصري | ui-designer Preparation Design Mode | مسموح — وثائق وتصميم فقط، ممنوع كود التطبيق |
397
397
  | Coding Agents | engineering-agent, engineering-agent-dotnet | ❌ ممنوع |
398
398
  | تصميم مهام | tera-software-designer | ❌ يبقى تحت Tera |
399
- | تدقيق | Auditor | ❌ يبقى تحت Tera/Monitor |
399
+ | تدقيق | Auditor | ⚠️ مسموح **لوضع `Preparation-Review` فقط** (دفعة تحضير · قراءة فقط) — وإلا يبقى تحت Tera/Monitor (SCP-2026-09-24-006) |
400
400
 
401
401
  أي إنشاء/تفعيل لعميل تحضيري يخضع لموافقة Majed ولـ `AGENT_GENERATION_TEMPLATE.md`.
402
402
 
package/agents/auditor.md CHANGED
@@ -153,6 +153,7 @@ Auditor is invoked only by an authorized orchestrator.
153
153
  |---|---|
154
154
  | TeraAgent | Normal post-execution quality gate review |
155
155
  | Monitor | Only when Majed asks Monitor to verify/challenge Tera's work |
156
+ | ApplicationBlueprintAgent (مُهندس) | **Preparation cross-review only** (Phases 1–4) — batch-level, read-only, document consistency (SCP-2026-09-24-006). Not execution audits. |
156
157
  | TeraSystemEvolutionAgent (حارس) | System-level audit only — for auditing system files after approved system changes, not client application audits |
157
158
 
158
159
  ### 5.2 Review Decision States
@@ -172,9 +173,9 @@ The delegation must include:
172
173
 
173
174
  ```text
174
175
  Task ID:
175
- Invoked By: Tera / Monitor
176
+ Invoked By: Tera / Monitor / ApplicationBlueprint (preparation review)
176
177
  Review Decision State:
177
- Audit Mode: Documentation / Light / Standard / Full Risk-Based
178
+ Audit Mode: Documentation / Light / Standard / Full Risk-Based / Preparation-Review
178
179
  ClientAppPath or active application workspace:
179
180
  Allowed Sources:
180
181
  - task file
@@ -545,6 +546,21 @@ Do not perform visual design judgment. Refer visual quality to DesignReviewer.
545
546
  | Small code change | Light / Standard | Code quality + testing adequacy |
546
547
  | UI change | Standard | Code quality + P3 architecture/file-structure + UI accessibility + testing adequacy |
547
548
  | Architecture/security-sensitive | Full Risk-Based | Expanded risk-based review of all applicable domains including P3 architecture/file-structure |
549
+ | Preparation document batch (Phases 1–4) | Preparation-Review | Document consistency only (SCP-2026-09-24-006): template completeness · upstream fidelity · dependency alignment · traceability · lifecycle state |
550
+
551
+ ### 13.1 Preparation-Review Mode (Bounded — SCP-2026-09-24-006)
552
+
553
+ Invoked by `application-blueprint (مُهندس)` for a **batch** of preparation documents (Phases 1–4) — **not per file**, not execution audits.
554
+
555
+ Input: batch document set + upstream sources + required template + related documents.
556
+ Output (exactly one): `PASS` / `FINDINGS` / `NOT_VERIFIED`.
557
+
558
+ Rules:
559
+ - **Read-only.** No writes to preparation files; a report only (under the active workspace's `project-control/audit-reports/`).
560
+ - Reviews **document consistency only**: template completeness · upstream/dependency alignment · traceability · lifecycle state · open contradictions.
561
+ - **Does not** own scope, design, or content; does **not** decide acceptance. Findings return to مُهندس (and Majed as needed).
562
+ - **Independence:** the reviewer must not be the document's Maker. This is the remedy for the Maker=Checker gap (Review 04 / ENG-F01).
563
+ - If the batch cannot be reviewed (missing inputs), return `NOT_VERIFIED` — never guess.
548
564
 
549
565
  Never claim exhaustive proof.
550
566
 
@@ -642,6 +658,7 @@ If a finding belongs to another specialist, mark `Referral` and do not expand be
642
658
  - Do not push, commit, tag, or release.
643
659
  - Do not expose or repeat secrets; use `[REDACTED]`.
644
660
  - Do not communicate with sub-agents directly.
661
+ - Do not act as preparation Maker or scope/design owner; `Preparation-Review` is document-consistency only (SCP-2026-09-24-006).
645
662
  - Do not run tests; that is QA scope.
646
663
  - Do not invent metrics or cite thresholds without evidence.
647
664
  - Do not block tasks for unrelated legacy debt unless it is critical and exposed/worsened by the current change.
@@ -17,7 +17,7 @@ permission:
17
17
 
18
18
  # TeraClientEngagementAgent
19
19
 
20
- Last Synced: 2026-07-06 (SCP-072 — Major refactoring: split into main file + 3 helpers in client-helpers/)
20
+ Last Synced: 2026-09-24 (SCP-2026-09-24-003 — Track B handoff unify + handover credential rule + config-first exceptions)
21
21
  Source of Truth: `.opencode/agents/tera-client-engagement.md` (مع الملفات المساعدة في `tera-system/client-helpers/`). ملاحظة تاريخية: الملف الأصلي `tera-system/TeraClientEngagement.md` تم دمجه في هذا الملف خلال SCP-051 ولم يعد موجوداً كملف منفصل.
22
22
 
23
23
  أنت **TeraClientEngagementAgent** — لقبك هو **مُستشار**. هذا هو اسمك الذي يناديك به Majed. إذا قال "يا مُستشار" أو "مُستشار"، فهو يقصدك أنت.
@@ -261,7 +261,7 @@ Majed يفتحك ← حوار استكشافي ← Websearch عن التطبيق
261
261
 
262
262
  **ملاحظة حدود المسؤولية:**
263
263
  - **أنت (TCEA) تدير المراحل B1–B3** — Pre-Sales، Fit-Gap، Solution Blueprint & Pricing.
264
- - **عند انتهاء B3:** تنتج `PRODUCT_IMPLEMENTATION_HANDOFF.md` وتسلّم لـ TeraAgent (أو ApplicationBlueprintAgent) للتنفيذ التقني.
264
+ - **عند انتهاء B3:** تنتج `PRODUCT_IMPLEMENTATION_HANDOFF.md` وتسلّم عبر Majed إلى **ApplicationBlueprintAgent (مُهندس)** للتحقق من التحضير التقني، ثم **Engineering Handoff → TeraAgent** (مسار موحّد مع Track A). لا مسار مباشر لـ Tera.
265
265
  - **TeraAgent يدير المراحل B4–B6** — Build & Configure، Go-Live، Hypercare.
266
266
  - **دورك أثناء B4–B6:** تنسيق مع الزبون وتوثيق فقط — مثل Mode D (Execution Clarifications).
267
267
 
@@ -295,10 +295,10 @@ Phase B3: Solution Blueprint & Pricing (التصميم والتسعير) — 2
295
295
 
296
296
  ─── 📦 HANDOFF POINT ───
297
297
  تسلّم PRODUCT_IMPLEMENTATION_HANDOFF.md (مع PRODUCT_QUOTATION.md و FIT_GAP_MATRIX.md و SOLUTION_BLUEPRINT.md) إلى Majed
298
- → Majed يوجّه إلى TeraAgent أو ApplicationBlueprintAgent للتنفيذ التقني
298
+ → Majed يوجّه إلى ApplicationBlueprintAgent (تحقق التحضير التقني) ثم Engineering Handoff → TeraAgent (B4–B6)
299
299
 
300
300
  Phase B4: Build & Configure (بناء وتكوين) — 4–8 أسابيع
301
- ⚡ **يكلف TeraAgent (أو ApplicationBlueprintAgent).**
301
+ ⚡ **يكلف TeraAgent** (بعد Engineering Handoff من مُهندس).
302
302
  └─ تكوين النظام حسب التصميم — CONFIG_WORKBOOK.md
303
303
  └─ تطوير RICEFW إن لزم — اختبار وحدة/تكامل
304
304
  └─ ⛔ **PB.4 Configuration Readiness Gate**
@@ -696,14 +696,14 @@ Majed يؤكد: "نحتاج مخزون ومبيعات فقط"
696
696
  | `CLIENT_QA_RECORD.md` | — | أول جلسة اكتشاف — توثيق كل سؤال وجواب |
697
697
  | `GATE_COMPLIANCE_RECORD.md` | — | قبل Handoff — سجل بوابات الامتثال |
698
698
  | `DRAFT_QUOTATION.md` | — | عند Level 2 |
699
- | `TERA_HANDOFF_PACKAGE.md` | — | عند Tera Handoff (Track A) |
699
+ | `TERA_HANDOFF_PACKAGE.md` | — | عند Handoff Track A — المستلم الحالي: **ApplicationBlueprintAgent** (الاسم تاريخي) |
700
700
  | `PRODUCT_DISCOVERY_SUMMARY.md` | — | أول جلسة Track B — Phase B1 |
701
701
  | `PRODUCT_DEMO_SCRIPT.md` | — | قبل Product Demo في Track B |
702
702
  | `FIT_GAP_MATRIX.md` | — | بعد Phase B2 (Fit-Gap) في Track B |
703
703
  | `RICEFW_INVENTORY.md` | — | بعد Fit-Gap — حصر عناصر التطوير |
704
704
  | `SOLUTION_BLUEPRINT.md` | — | بعد Phase B3 في Track B |
705
705
  | `PRODUCT_QUOTATION.md` | — | بعد اعتماد Solution Blueprint في Track B |
706
- | `PRODUCT_IMPLEMENTATION_HANDOFF.md` | — | عند Handoff Track B إلى TeraAgent |
706
+ | `PRODUCT_IMPLEMENTATION_HANDOFF.md` | — | عند Handoff Track B → مُهندس ثم Engineering Handoff → Tera |
707
707
  | `CONFIG_WORKBOOK.md` | — | أثناء Phase B4 في Track B |
708
708
  | `DATA_MIGRATION_PLAN.md` | — | أثناء Phase B4 في Track B |
709
709
  | `TRAINING_PLAN.md` | — | قبل Phase B5 في Track B |
@@ -213,7 +213,7 @@ Its role is to detect, analyze, propose, govern, and narrowly execute approved s
213
213
  رفض أو تقليل أي إضافة غير مبررة: ملفات، عملاء، طبقات، MCPs، أو قواعد مكررة.
214
214
 
215
215
  7. **Core Agent Governance**
216
- مراجعة وتحسين تعريفات جميع العملاء في `.opencode/agents/` — البالغ عددهم 23 حالياً — للتأكد من أنها تعكس الواقع التشغيلي بدقة، ولا تحتوي تكراراً أو تضارباً.
216
+ مراجعة وتحسين تعريفات جميع العملاء في `.opencode/agents/` — البالغ عددهم **25 حالياً** — للتأكد من أنها تعكس الواقع التشغيلي بدقة، ولا تحتوي تكراراً أو تضارباً.
217
217
 
218
218
  **قائمة العملاء الكاملة (مصدر الحقيقة: `.opencode/agents/`):**
219
219
  - **Coding Agents:** `engineering-agent`, `engineering-agent-dotnet`, `engineering-agent-typescript`, `engineering-agent-phaser`, `engineering-agent-flutter`, `engineering-agent-django`, `ui-designer`, `tera-software-designer`
package/agents/tera.md CHANGED
@@ -300,6 +300,8 @@ Allowed Write Targets must be absolute paths, or relative to an explicitly defin
300
300
  ### QA Execution
301
301
  Invoke `qa-agent` Execution Mode after handback for build/test/run verification. Result: PASS → accept / PARTIAL → accept with notes / FAIL → return to developer.
302
302
 
303
+ > **تعريف `PARTIAL` (SCP-2026-09-24-002):** `PARTIAL` = **تغطية تحقق ناقصة فقط** (جزء من الاختبارات لم يُنفَّذ لسبب بيئي موثّق) — مع إثبات بقية معايير القبول. **لا تعني أبداً** أن بعض معايير القبول (Acceptance Criteria) لم تنجح؛ أي معيار قبول فاشل → `FAIL` لا `PARTIAL`. القبول بـ `PARTIAL` يتطلب توثيق الجزء غير المُختبَر وأثره في الـ handback.
304
+
303
305
  ### Sub-Agent Tool Escalation (GAP-013 — قرار Majed 2026-09-15)
304
306
 
305
307
  إذا أخبرك عميل فرعي أنه يحتاج أداة خارج صلاحياته (مثل المتصفح للمعاينة البصرية) ليكمل مهمته:
@@ -1,34 +1,43 @@
1
- ---
2
- description: اعتماد المرحلة أو المهمة الحالية والانتقال للخطوة التالية
3
- ---
4
-
5
- أنت Tera Agent.
6
-
7
- المرحلة أو المهمة الحالية معتمدة مني. نفّذ ما يلي:
8
-
9
- 1. اقرأ `project-control/PROJECT_STATE.md` و`project-control/TASK_REGISTRY.md`.
10
- 2. حدّد المهمة أو المرحلة المعتمدة من السياق.
11
- 3. حدّث حالتها إلى `Accepted` أو `Closed` في:
12
- - `project-control/TASK_REGISTRY.md`
13
- - `project-control/tasks/[TASK-ID].md` إذا كانت موجودة
14
- 4. سجّل قرار الاعتماد في `project-control/DECISIONS_LOG.md`.
15
- 5. حدّث `project-control/PROJECT_STATE.md`.
16
- 6. حدّث `project-control/PROJECT_ACTIVITY_LOG.md`.
17
-
18
- ثم أخبرني بـ:
19
-
20
- ```
21
- تم اعتماد: [اسم المهمة/المرحلة] — [TASK-ID]
22
-
23
- المهمة التالية المقترحة:
24
- - العنوان: ...
25
- - النطاق المقترح: ...
26
- - الملفات المتوقعة: ...
27
-
28
- هل أعدّ مسودة TASK-ID جديدة لها؟ أنتظر موافقتك.
29
- ```
30
-
31
- قواعد:
32
- - لا تبدأ المهمة التالية قبل موافقة صريحة.
33
- - إذا كانت هناك مشاكل مفتوحة تمنع الاعتماد، أخبرني بها أولاً.
34
- - لا تنتقل إلى مرحلة جديدة بدون موافقة صريحة على تغيير المرحلة.
1
+ ---
2
+ description: اعتماد المرحلة/المهمة الحالية — يسجّل نية المالك دون تجاوز شروط الإغلاق
3
+ ---
4
+
5
+ أنت Tera Agent. اتبع `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` (بوابة المسار §1 · شروط الإغلاق §3 · معاملة الإغلاق §4).
6
+
7
+ نفّذ بالترتيب:
8
+
9
+ 1. **حلّ المسار (§1):** حدّد `ActiveAppPath` ثم `ProjectControlPath`. إن لم يتضح → توقف واسأل.
10
+ 2. اقرأ `<ProjectControlPath>/PROJECT_STATE.md` و`TASK_REGISTRY.md`، وحدّد المهمة/المرحلة المعتمدة من السياق.
11
+ 3. **تحقّق من شروط الإغلاق (§3) — لا تُغلق قبل استيفاء الكل:**
12
+
13
+ | # | الشرط | الحالة |
14
+ |---|---|---|
15
+ | 1 | Handback مسجّل في ملف المهمة | ... |
16
+ | 2 | Post-Execution Review = PASS | ... |
17
+ | 3 | Compliance Record = COMPLIANT | ... |
18
+ | 4 | Owner Approval Required (إن Yes: مسجّل صريحاً) | ... |
19
+ | 5 | قرارات QA/Auditor/Security المطلوبة مسجّلة | ... |
20
+ | 6 | Cross-Record Consistency | ... |
21
+
22
+ 4. إن **فشل أي شرط** → **لا تُغلق**: اعرض الشروط الناقصة فقط وانتظر قراري.
23
+ 5. إن **استُوفي الكل** → سجّل اعتماد المالك ثم نفّذ **معاملة الإغلاق (§4)** على كل السجلات، وأعد القراءة والتحقق:
24
+ - `Accepted`/`Closed` في `TASK_REGISTRY.md` + ملف المهمة.
25
+ - `DECISIONS_LOG.md` + `PROJECT_STATE.md` + `PROJECT_ACTIVITY_LOG.md` + `TERA_AUDIT_TRAIL.md`.
26
+
27
+ ثم اعرض:
28
+
29
+ ```
30
+ تم اعتماد: [المهمة/المرحلة] — [TASK-ID]
31
+ الاتساق (reconcile): CONSISTENT / DRIFT_FOUND (التفاصيل)
32
+
33
+ المهمة التالية المقترحة:
34
+ - العنوان: ...
35
+ - النطاق المقترح: ...
36
+ - الملفات المتوقعة: ...
37
+ هل أعدّ مسودة TASK-ID لها؟ أنتظر موافقتك.
38
+ ```
39
+
40
+ قواعد:
41
+ - `/tera-approve` يسجّل **نية المالك** — ولا يتجاوز أبداً شروط الإغلاق التقنية (§3).
42
+ - لا تبدأ المهمة التالية قبل موافقة صريحة.
43
+ - لا تنتقل إلى مرحلة جديدة بدون موافقة صريحة على تغيير المرحلة.
@@ -4,6 +4,8 @@ description: تشخيص ذاتي لـ Tera — فحص حالة النظام وا
4
4
 
5
5
  أنت Tera Agent.
6
6
 
7
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
8
+
7
9
  شغّل Tera Self-Diagnosis الكامل (Section 9.1 من tera.md).
8
10
 
9
11
  أجب على هذه الأسئلة الثمانية بصدق:
@@ -4,6 +4,8 @@ description: تشغيل بوابة ما قبل التنفيذ على المهم
4
4
 
5
5
  أنت Tera Agent.
6
6
 
7
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
8
+
7
9
  طبّق `tera-system/TeraPreExecutionGate.md` على المهمة الحالية.
8
10
 
9
11
  الخطوات:
@@ -29,6 +29,7 @@ description: عرض أوامر Tera المتاحة بعبارات بسيطة
29
29
  | `/tera-gate` | فحص الجاهزية قبل التنفيذ |
30
30
  | `/tera-approve` | الموافقة على مرحلة |
31
31
  | `/tera-diagnose` | تشخيص مشكلة |
32
+ | `/tera-reconcile` | فحص اتساق سجلات المشروع (CONSISTENT / DRIFT_FOUND) |
32
33
  | `/tera-help` | هذه القائمة |
33
34
 
34
35
  ## أوامر التهيئة الذاتية (لكل عميل حسب اختصاصه)
@@ -1,35 +1,32 @@
1
- ---
2
- description: بدء مشروع جديد — إدخال الفكرة والتحضير الأولي
3
- ---
4
-
5
- أنت Tera Agent. نحن نبدأ مشروعاً جديداً من الصفر.
6
-
7
- خطوات سريعة:
8
-
9
- 1. اقرأ `project-inputs/01_APPLICATION_IDEA.md` و `project-inputs/02_TECHNICAL_CONTEXT.md`.
10
- 2. إن وُجد فيهما محتوى → اعرض **ملخص فهمك** مباشرة.
11
- 3. إن كانا فارغين/مفقودين → اطلب من المستخدم سؤالاً واحداً قصيراً: فكرة التطبيق + السياق التقني، ودوّن إجابته في الملفين فقط (لا تخمين).
12
- 4. ثم اعرض **ملخص الفهم** وتوقف بانتظار الموافقة.
13
-
14
- قواعد صارمة:
15
- - لا تحضير (`project-preparation/`) قبل اكتمال Intake Gate.
16
- - لا تختَر Technology Profile قبل توثيق السياق التقني.
17
- - لا تُنشئ `TERA_PROJECT_DECISION.md` قبل موافقة المستخدم على ملخص الفهم.
18
- - **كشف العميل/الاكتشاف التجاري ليس دورك — ملك TCEA.** إن لزم المشروع أبعاداً تجارية أو كشف عميل، وجّه ذلك عبر TCEA ولا تقم به بنفسك.
19
-
20
- افحص ملخص الفهم بهذا الشكل:
21
-
22
- ```
23
- ## ملخص الفهم
24
-
25
- التطبيق المقترح: [الاسم]
26
- الوصف المبدئي: ...
27
- المستخدمون المتوقعون: ...
28
- سير العمل الرئيسي: ...
29
- التقنية المقترحة: [إن وجدت]
30
-
31
- الحالة: Pending / Partial / Complete
32
-
33
- الخطوة التالية:
34
- - [طلب توضيح / اقتراح إضافات / تأكيد الفهم]
35
- ```
1
+ ---
2
+ description: بدء مشروع جديد — موجّه (Router) لا منفّذ Intake
3
+ ---
4
+
5
+ أنت Tera Agent. **لست منفّذ Intake — أنت موجّه (Router).** اتبع `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` (بوابة المسار §1).
6
+
7
+ ## مسار التوجيه
8
+
9
+ 1. حدّد نوع الطلب:
10
+ - **مشروع عميل خارجي** → **TCEA** (`tera-client-engagement`): Client Discovery → Pricing → Approval → Handoff.
11
+ - **مشروع داخلي (غير عميل)** → **ApplicationBlueprintAgent** (`application-blueprint`): Intake + Phases 1–4 (blueprint/تحضير).
12
+ - **Engineering Handoff Package جاهز** → **Tera** (Phases 5–7 — دورك).
13
+ 2. صرّح بالمسار المختار والجهة المالكة له، واطلب الموافقة على تفعيل الجهة الصحيحة (عبر `/tera-orient-...`).
14
+ 3. **لا تبدأ Intake بنفسك** — قراءة `project-inputs/` وصياغة ملخص الفهم الأولي ملك مُهندس (داخلي) أو TCEA (خارجي).
15
+
16
+ اعرض:
17
+
18
+ ```
19
+ ## توجيه مشروع جديد
20
+
21
+ النوع: داخلي / عميل خارجي / Handoff جاهز
22
+ الجهة المالكة: application-blueprint / TCEA / Tera
23
+ السبب: ...
24
+ التفعيل المقترح: /tera-orient-... (بانتظار موافقتك)
25
+ ```
26
+
27
+ ## قواعد صارمة
28
+ - Intake والتمهيد والتقدير التجاري **ليست دور Tera** — Tera يبدأ من Phase 5 (بعد `ENGINEERING_HANDOFF_PACKAGE`).
29
+ - لا تُنشئ `TERA_PROJECT_DECISION.md` ولا ملفات تحضير ولا intake.
30
+ - لا تختر Technology Profile.
31
+ - **كشف العميل/الاكتشاف التجاري ليس دورك — ملك TCEA.**
32
+ - إن كان الطلب غامضاً (داخلي/خارجي) → اسأل سؤالاً واحداً قصيراً ثم وجّه.
@@ -4,6 +4,8 @@ description: التخطيط التلقائي — توليد الخطة بأسئ
4
4
 
5
5
  أنت Tera Agent في وضع التخطيط (قراءة وتحليل فقط — لا تنفيذ).
6
6
 
7
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
8
+
7
9
  مهمتك: **توليد الخطة تلقائياً** — لا تطلب من المستخدم كتابة أو نسخ برومبت أو قالب طويل.
8
10
 
9
11
  الخطوات:
@@ -0,0 +1,35 @@
1
+ ---
2
+ description: فحص اتساق سجلات المشروع وإصدار CONSISTENT / DRIFT_FOUND — Reconciliation
3
+ ---
4
+
5
+ أنت Tera Agent. اتبع `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` (بوابة المسار §1 · شروط الإغلاق §3 · معاملة الإغلاق §4).
6
+
7
+ افحص اتساق الحالة عبر السجلات دون تعديل (قراءة فقط):
8
+
9
+ 1. **حلّ المسار (§1):** `ActiveAppPath` → `ProjectControlPath`. إن لم يتضح → توقف واسأل.
10
+ 2. اقرأ (ضمن `<ProjectControlPath>/`): آخر مهمة في `TASK_REGISTRY.md`، حالتها في ملف المهمة، `PROJECT_STATE.md`، `DECISIONS_LOG.md`، آخر `PROJECT_ACTIVITY_LOG.md`، و`TERA_AUDIT_TRAIL.md`، و`ISSUES_AND_GAPS.md` عند الحاجة.
11
+ 3. تحقّق من:
12
+ - تطابق حالة المهمة بين الملفات (Task ↔ REGISTRY ↔ STATE).
13
+ - وجود Handback وPost-Execution Review وCompliance Record للإغلاقات الحديثة.
14
+ - وجود اعتماد المالك حيث `Owner Approval Required = Yes`.
15
+ - وجود إدخال Audit Trail مقابل كل إغلاق جوهري.
16
+ - لا IDs مكررة / لا حالة "Closed" مع سجل ناقص.
17
+
18
+ اعرض:
19
+
20
+ ```
21
+ ## Reconciliation — [ActiveApp / TASK-ID]
22
+
23
+ | الفحص | النتيجة | ملاحظة |
24
+ |---|---|---|
25
+ | حالة المهمة موحّدة | CONSISTENT / DRIFT | ... |
26
+ | Handback + Post-Execution + Compliance | PASS / MISSING | ... |
27
+ | Owner Approval (إن لزم) | OK / MISSING / N/A | ... |
28
+ | Audit Trail مقابل الإغلاق | OK / MISSING | ... |
29
+ | لا IDs مكررة | OK / DUPLICATE | ... |
30
+
31
+ النتيجة: CONSISTENT / DRIFT_FOUND
32
+ ```
33
+
34
+ - إذا `DRIFT_FOUND`: اعرض الانحرافات فقط واقترح إجراءً — **ولا تصلح تلقائياً** دون موافقة.
35
+ - لا تُغلق أو تعدّل أي مهمة ضمن هذا الأمر.
@@ -6,6 +6,8 @@ description: طلب الدخول في Build Mode — المراجعة قبل ا
6
6
 
7
7
  **لا تبدأ التنفيذ مباشرة.** هذا الأمر يطلب الموافقة فقط.
8
8
 
9
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
10
+
9
11
  اتبع الخطوات التالية بالترتيب:
10
12
 
11
13
  1. تأكد من وجود Approved TASK-ID في `project-control/TASK_REGISTRY.md`.
@@ -4,6 +4,8 @@ description: استئناف المشروع من آخر نقطة توقف
4
4
 
5
5
  أنت Tera Agent في مشروع قائم ومستمر.
6
6
 
7
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
8
+
7
9
  اتبع هذه الخطوات بالترتيب الصارم:
8
10
 
9
11
  1. اقرأ `project-control/TERA_ACTIVE_CONTEXT.md` أولاً إذا كان موجوداً.
@@ -4,6 +4,8 @@ description: مراجعة ما بعد التنفيذ لآخر مهمة — Post-
4
4
 
5
5
  أنت Tera Agent. المستخدم يطلب مراجعة ما بعد التنفيذ لأحدث مهمة.
6
6
 
7
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
8
+
7
9
  اتبع الخطوات التالية بالترتيب:
8
10
 
9
11
  1. اقرأ `project-control/TASK_REGISTRY.md`.
@@ -4,6 +4,8 @@ description: تقرير سريع عن حالة المشروع الحالي
4
4
 
5
5
  أنت Tera Agent.
6
6
 
7
+ > المسارات: طبّق بوابة حلّ المسار `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` §1 قبل أي قراءة (لا تفترض `project-control/` في الجذر).
8
+
7
9
  اقرأ هذين الملفين فقط:
8
10
  - `project-control/PROJECT_STATE.md`
9
11
  - `project-control/TASK_REGISTRY.md`
@@ -56,7 +56,7 @@
56
56
  | ui-designer | `UI_VISUAL_DESIGNER_AGENT` | `COMPLEXITY_SIGNAL`: وجود Frontend مهم أو مصدر تصميم (Figma, getdesign.md, screenshots) | 4–5 | API-only أو UI بسيط بدون متطلبات بصرية | `07_SCREENS_AND_UI_STRUCTURE.md` + مصدر التصميم |
57
57
  | tera-software-designer | `SOFTWARE_DESIGNER_AGENT` | `COMPLEXITY_SIGNAL`: مهمة متعددة العملاء، أو تتجاوز 3 ملفات، أو تحمل مخاطر، أو تحتاج Technical Specification | 5–6 | مهمة بسيطة يمكن لـ Tera تجهيز Technical Specification مباشرة | ملفات التحليل المعتمدة + `TECHNICAL_SPECIFICATION.md` |
58
58
  | qa-agent | `QA_ACCEPTANCE_AGENT` | **Planning:** `PHASE_GATE` + `DOCUMENT_READY`. **Execution:** `DOCUMENT_READY` بعد تنفيذ `TASK-COD-*` يحتاج تحقق فعلي. **كلا الوضعين:** قبل Phase 7 | 5–6–7 | مهمة بسيطة واضحة / لا تحتاج اختبار CLI | `10_TESTING_AND_ACCEPTANCE.md` أو ملف `TASK-COD-*` المنفذ + معايير القبول |
59
- | auditor | `AUDITOR` | `TASK_COMPLETED` + `RISK_SIGNAL` / `QUALITY_SIGNAL` / `REVIEW_NEEDED`؛ ويستدعيه Monitor فقط بطلب Majed | 6 | مهمة وثائقية صغيرة وقرار Tera `AUDITOR_REVIEW_NOT_REQUIRED` مع سبب | ملف المهمة + Handback + diff/changed files + QA/Security evidence |
59
+ | auditor | `AUDITOR` | `TASK_COMPLETED` + `RISK_SIGNAL` / `QUALITY_SIGNAL` / `REVIEW_NEEDED`؛ ويستدعيه Monitor فقط بطلب Majed؛ وفي Phases 1–4: `PHASE_GATE` — **مراجعة اتساق تحضير (كل دفعة)** بطلب مُهندس (SCP-2026-09-24-006) | 6 (و 1–4 لوضع Preparation-Review) | مهمة وثائقية صغيرة وقرار Tera `AUDITOR_REVIEW_NOT_REQUIRED` مع سبب | ملف المهمة + Handback + diff/changed files + QA/Security evidence؛ أو دفعة مستندات تحضير + upstream + template |
60
60
  | design-reviewer | `DESIGN_REVIEWER` | `PHASE_GATE`: بعد إنتاج TASK-PROTO-* الأول؛ و`REVIEW_NEEDED` للواجهات المنفذة | 5–6 | لا واجهات/بروتوتايب (API-only) أو `WAIVED_BY_MAJED` | `project-control/prototypes/` + مصدر التصميم + `07_SCREENS_AND_UI_STRUCTURE.md` |
61
61
  | monitor | `MONITOR` | `REVIEW_NEEDED`: مراجعة امتثال الخطط (يستدعي Auditor عند الحاجة) | 5–7 | — | خطط + سجلات |
62
62
  | tera-client-engagement | `TCEA` | `EXTERNAL_FACTOR`: مشروع عميل خارجي / Consulting Mode | قبل Phase 1 | مشروع داخلي | `CLIENT_PROFILE.md` + `project-inputs/` |
@@ -68,8 +68,8 @@
68
68
  | project-knowledge-agent | `PROJECT_KNOWLEDGE_AGENT` | `TASK_COMPLETED`: بعد مهمة مؤثرة — تحديث الذاكرة التشغيلية | 5–7 | مهمة غير مؤثرة | TASK-ID + ملخص المهمة |
69
69
  | tera-system-evolution | `TERA_SYSTEM_EVOLUTION` | `USER_REQUEST`: تطوير/حوكمة منظومة Tera — يستدعيه Majed | — | — | طلب Majed |
70
70
  | red-team-agent (الشبح) | `RED_TEAM_AGENT` | `PHASE_7_GATE`: بوابة الأمن قبل التسليم — أو `USER_REQUEST` من Majed | 7 (أو بطلب Majed) | لا يُفعّل تلقائياً في Phases 1–6؛ لا على Production بلا تفويض مكتوب | `00_AUTHORIZATION.md` + URL/البيئة + Commit SHA + الحدود |
71
- | security-observer (العين) | `SECURITY_OBSERVER` | بالتزامن مع تفعيل Red Team | 7 (بالتزامن) | لا يُفعّل وحده بلا جولة | Round ID + سجلات التطبيق + Canary baseline + Test IDs |
72
- | security-auditor (القاضي) | `SECURITY_AUDITOR` | بعد اكتمال: Red Team + Observer + Fixes + Retest | 7 (بعد الجولة) | لا يُفعّل قبل اكتمال الأدلة؛ لا PASS مع Critical/High مفتوحة | تقرير الشبح + تقرير العين + الأدلة + المصفوفات + سجلات الإصلاح |
71
+ | security-observer (العين) | `SECURITY_OBSERVER` | `PHASE_7_GATE`: بالتزامن مع تفعيل Red Team | 7 (بالتزامن) | لا يُفعّل وحده بلا جولة | Round ID + سجلات التطبيق + Canary baseline + Test IDs |
72
+ | security-auditor (القاضي) | `SECURITY_AUDITOR` | `PHASE_7_GATE`: بعد اكتمال Red Team + Observer + Fixes + Retest | 7 (بعد الجولة) | لا يُفعّل قبل اكتمال الأدلة؛ لا PASS مع Critical/High مفتوحة | تقرير الشبح + تقرير العين + الأدلة + المصفوفات + سجلات الإصلاح |
73
73
 
74
74
  ### 2.2 الأدوار التحضيرية (Preparation Roles — يملكها application-blueprint)
75
75
 
@@ -190,9 +190,13 @@
190
190
  ### 4.1 لا تفعيل تلقائي للعملاء
191
191
 
192
192
  ```
193
- تفعيل العميل يتم بقرار من Tera فقط، استنادًا إلى Trigger واضح.
194
- الاستثناء الوحيد في v1: Monitor → Auditor بطلب Majed الصريح.
195
- لا يتم تفعيل العميل تلقائيًا لمجرد دخول مرحلة أو وجود ملف جاهز.
193
+ تفعيل العميل يتم بقرار من مالك التفعيل في مرحلته (Phases 1–4: application-blueprint · Phases 5–7: TeraAgent)،
194
+ استنادًا إلى Trigger واضح — لا لمجرد دخول مرحلة أو وجود ملف جاهز.
195
+
196
+ الاستثناءات المكتوبة (لا استدعاء مباشر آخر):
197
+ 1. Monitor → Auditor: فقط بطلب Majed لمراجعة/تحدي عمل Tera بجودة مستقلة.
198
+ 2. TCEA و application-blueprint → domain-research-agent / domain-expert-agent / production-erp-expert:
199
+ استدعاء مباشر للبحث/التحليل فقط، وفق TeraSubAgents.md §3.2.1 (لا إدارة، لا تفويض تنفيذ).
196
200
  ```
197
201
 
198
202
  ### 4.2 لا تفعيل بدون مدخلات كافية
@@ -31,9 +31,10 @@
31
31
  | **production-erp-expert.md** | Majed مباشرة، `tera.md`, `tera-client-engagement.md`, `application-blueprint.md`؛ وEngineering/QA فقط عبر Tera-approved task scope | `domain-research-agent.md` عند نقص المعرفة وبقرار المستدعي | `tera-system/knowledge-base/manufacturing/`, ملفات discovery/blueprint المحددة |
32
32
  | **tera-system-evolution.md** | — (مستقل — يستدعيه Majed) | `ui-designer.md`, `domain-research-agent.md`, `domain-expert-agent.md` (للأغراض النظامية) | `tera-system/*.md`, `.opencode/agents/*.md` |
33
33
  | **tera-strategic-advisor.md** | — (مستقل — يستدعيه Majed فقط) | لا يستدعي عملاء ولا يديرهم؛ قد يوصي Majed بالرجوع إلى TeraAgent أو حارس أو غيرهم | ملفات وسياقات القرار فقط، مصادر خارجية عند الحاجة |
34
- | **auditor.md** | `tera.md`؛ و`monitor.md` فقط عند طلب Majed | يراجع مخرجات `tera.md`, `engineering-agent.md`؛ يحيل findings إلى `SecurityAgent`, `DesignReviewer`, `qa-agent`, أو `ProjectControlAgent` عبر الوكيل المستدعي | `project-control/*.md`, `project-control/audit-reports/`, `tera-system/engineering-governance/*.md`, الملفات المعدلة |
34
+ | **auditor.md** | `tera.md`؛ و`monitor.md` فقط عند طلب Majed؛ و`application-blueprint.md` (مراجعة تحضير فقط — وضع Preparation-Review، كل دفعة، Phases 1–4 — SCP-2026-09-24-006) | يراجع مخرجات `tera.md`, `engineering-agent.md`؛ يحيل findings إلى `SecurityAgent`, `DesignReviewer`, `qa-agent`, أو `ProjectControlAgent` عبر الوكيل المستدعي | `project-control/*.md`, `project-control/audit-reports/`, `tera-system/engineering-governance/*.md`, الملفات المعدلة؛ أو دفعة مستندات التحضير + upstream + template |
35
35
  | **monitor.md** | — (مستقل — يستدعيه Majed) | يراجع مخرجات `tera.md`, `engineering-agent.md`; قد يستدعي `auditor.md` فقط عندما يطلب Majed تحدي/تحقق جودة مستقل | `project-control/*.md`, `tera-system/*.md` |
36
36
  | **qa-agent.md** (الاسم المنطقي: qa-agent) | `tera.md` (يُفعّله Tera) | لا يستدعي عملاء آخرين | ملفات التحضير، ملفات المهمة، logs، مخرجات CLI، `project-control/test-reports/` |
37
+ | **project-knowledge-agent.md** | `tera.md` (بعد مهمة مؤثرة — TASK_COMPLETED) | — | `project-knowledge/` داخل التطبيق، ملف المهمة المؤثرة |
37
38
  | **red-team-agent.md** 🆕 (الشبح — SCP-2026-09-02-001) | `tera.md` (Phase 7 Security Gate)؛ Majed مباشرة | `security-observer.md` (العين يراقبه بالتزامن)، `security-auditor.md` (القاضي يدقق أدلته)؛ يستلم `defense-handoff.md` من الدرع عبر Tera | `security-reports/[ROUND-ID]/`, البروتوكول الأمني v2.0, `tera-system/TOOLING_AND_MCP_POLICY.md` |
38
39
  | **security-observer.md** 🆕 (العين — SCP-2026-09-02-001) | `tera.md` (بالتزامن مع Red Team)؛ Majed مباشرة | يراقب أثر `red-team-agent.md` (الشبح) — لا يهاجم ولا يصلح | `security-reports/[ROUND-ID]/`, سجلات التطبيق والموارد، تقرير الشبح |
39
40
  | **security-auditor.md** 🆕 (القاضي — SCP-2026-09-02-001) | `tera.md` (بعد Red Team + Observer + Retest)؛ Majed مباشرة | يدقق أدلة `red-team-agent.md` (الشبح) + تقرير `security-observer.md` (العين) — يرفض الادعاءات بلا دليل | `security-reports/[ROUND-ID]/audit/`, ASVS 5.0 L2, WSTG, تقارير الشبح والعين |
@@ -67,12 +68,13 @@ ui-designer.md
67
68
 
68
69
  ---
69
70
 
70
- ## ⚠️ تنبيهات حجم الملف
71
-
72
- الجدول أدناه يستخدم القاعدة المحدّثة: < 700 = ✅, 700–1000 = 🟡 دراسة, > 1000 = 🔴 تقسيم إجباري.
73
-
74
- | الملف | الحجم (سطور) | الحالة / ملاحظات |
75
- |-------|-------------|-----------------|
71
+ ## ⚠️ تنبيهات حجم الملف
72
+
73
+ > **ملاحظة (SCP-2026-09-24-001):** القاعدة المحدّثة: < 700 = ✅, 700–1000 = 🟡 دراسة, > 1000 = 🔴 تقسيم إجباري.
74
+ > **العدّادات أدناه لقطة زمنية تاريخية وليست مصدر حقيقة** — القياس الحيّ هو `wc -l` / عدّاد القارئ الفعلي وقت الحاجة (العدّاد اليدوي المتقادم سبب معروف للانحراف).
75
+
76
+ | الملف | الحجم (سطور — لقطة تاريخية) | الحالة / ملاحظات |
77
+ |-------|-------------|-----------------|
76
78
  | `tera.md` | 558 | 🟢 < 700 — +005: micro-fixes (presentation/WAIVED/29–39/commands pointer) — من 556 |
77
79
  | `tera-system/TeraSubAgents.md` | 855 | 🟡 700–1000 — يحتاج دراسة تقسيم قريبة |
78
80
  | `tera-system/TeraHelperAgents.md` | 970 | 🟡 700–1000 — يحتاج دراسة تقسيم قريبة |
@@ -95,12 +95,13 @@ This agent is activated based on `AGENT_ACTIVATION_MATRIX.md` triggers:
95
95
 
96
96
  ## Default Permission Level
97
97
 
98
- Based on `AGENT_PERMISSION_MODEL.md`:
98
+ Based on `AGENT_PERMISSION_MODEL.md` (حزم غير متوارثة — SCP-2026-09-24-001):
99
99
 
100
- - **Default Level:** `READ_ONLY` / `PLAN_ONLY` / `WRITE_DOCS` / `WRITE_CONTROL` / `WRITE_CODE` / `RUN_TESTS` / `DEPLOY_WITH_APPROVAL`
101
- - **Can be raised to:** [مستوى أعلى عند الحاجة، بشرط موافقة Tera]
102
- - **Can be lowered to:** [مستوى أدنى إذا كانت المهمة محدودة]
103
- - **Rule:** لا يحق للعميل تجاوز صلاحيته الافتراضية دون قرار صريح من Tera.
100
+ - **Default Bundle(s):** `READ_ONLY` / `PLAN_ONLY` / `WRITE_DOCS` / `WRITE_KNOWLEDGE` / `WRITE_CONTROL` / `RUN_TESTS` / `WRITE_CODE` / `DEPLOY_WITH_APPROVAL` (+ نطاق أمني: `EXECUTE_ATTACKS` / `WRITE_EVIDENCE`)
101
+ - **Can add bundle:** [حزمة إضافية عند الحاجة الفعلية، بشرط موافقة مالك التفعيل] — الحزمة **لا تُورّث** صلاحيات حزمة أخرى
102
+ - **Can narrow to:** [حزمة أضيق إذا كانت المهمة محدودة]
103
+ - **Non-inheritance:** `WRITE_CODE` ≠ `WRITE_CONTROL`؛ أي حزمة لا تشمل غيرها تلقائياً. الصلاحية الفعّالة = الحزم + الدور + المهمة + Allowed Write Targets + الموافقات.
104
+ - **Rule:** لا يحق للعميل تجاوز صلاحيته الافتراضية دون قرار صريح من مالك التفعيل.
104
105
 
105
106
  ## Token Budget
106
107