@tera-system/core 0.5.0 → 0.6.2
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 +8 -8
- package/RELEASES.md +29 -0
- package/agents/application-blueprint.md +6 -6
- package/agents/auditor.md +19 -2
- package/agents/engineering-agent-dotnet.md +30 -4
- package/agents/engineering-agent-flutter.md +5 -5
- package/agents/engineering-agent-typescript.md +70 -38
- package/agents/engineering-agent.md +12 -72
- package/agents/security-observer.md +2 -2
- package/agents/tera-client-engagement.md +7 -7
- package/agents/tera-software-designer.md +88 -54
- package/agents/tera-system-evolution.md +6 -6
- package/agents/tera.md +38 -6
- package/agents/ui-designer.md +1 -1
- package/assets/structurizr-mcp/pyproject.toml +1 -1
- package/assets/structurizr-mcp/uv.lock +816 -770
- package/commands/tera-approve.md +43 -34
- package/commands/tera-diagnose.md +2 -0
- package/commands/tera-gate.md +2 -0
- package/commands/tera-help.md +1 -0
- package/commands/tera-new-project.md +32 -35
- package/commands/tera-orient-software-designer.md +1 -1
- package/commands/tera-orient-tera.md +1 -1
- package/commands/tera-plan.md +2 -0
- package/commands/tera-reconcile.md +35 -0
- package/commands/tera-request-build.md +2 -0
- package/commands/tera-resume.md +2 -0
- package/commands/tera-review.md +2 -0
- package/commands/tera-status.md +2 -0
- package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +11 -7
- package/core/tera-system/AGENT_DEPENDENCY_MAP.md +9 -7
- package/core/tera-system/AGENT_GENERATION_TEMPLATE.md +6 -5
- package/core/tera-system/AGENT_PERMISSION_MODEL.md +29 -12
- package/core/tera-system/TERA_AGENT_CONDUCT.md +17 -0
- package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +7 -4
- package/core/tera-system/TeraArchitectureMap.md +1 -1
- package/core/tera-system/TeraCapabilityMap.md +2 -2
- package/core/tera-system/TeraPolicyMap.md +5 -3
- package/core/tera-system/TeraPreExecutionGate.md +51 -4
- package/core/tera-system/TeraPreparationDocumentationGovernance.md +21 -15
- package/core/tera-system/TeraSubAgents.md +7 -4
- package/core/tera-system/TeraSystemMaintenanceChecklist.md +12 -0
- package/core/tera-system/client-helpers/tera-client-engagement-gates.md +2 -2
- package/core/tera-system/client-helpers/tera-client-engagement-pricing.md +1 -1
- package/core/tera-system/client-helpers/tera-client-engagement-protocols.md +14 -9
- package/core/tera-system/design-system/DESIGN_REVIEW_STANDARDS.md +2 -0
- package/core/tera-system/engineering-helpers/database-privileges.md +63 -0
- package/core/tera-system/engineering-helpers/engineering-agent-core.md +30 -13
- package/core/tera-system/profiles/PROFILES_INDEX.md +3 -1
- package/core/tera-system/profiles/dotnet-razorpages-adonet.md +44 -43
- package/core/tera-system/profiles/dotnet-wpf-sqlite.md +17 -17
- package/core/tera-system/profiles/flutter-mobile.md +2 -2
- package/core/tera-system/profiles/rust.md +8 -6
- package/core/tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md +2 -1
- package/core/tera-system/runtime/TERA_COMMAND_PROTOCOL.md +86 -0
- package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +16 -0
- package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES.md +14 -0
- package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md +1 -0
- package/core/tera-system/runtime/TERA_RUNTIME_TEMPLATES_PREPARATION.md +1 -1
- package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +2 -2
- package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +9 -2
- package/package.json +2 -2
|
@@ -49,10 +49,11 @@ Project files record project-specific decisions.
|
|
|
49
49
|
| Phase 5 execution planning outputs | `tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md` Sections 29-31 | `.opencode/agents/tera.md`, `TERA_RUNTIME_CHECKLISTS.md`, `TeraPreExecutionGate.md` | Produces `PROJECT_MASTER_PLAN.md`, `PROJECT_DETAILED_EXECUTION_PLAN.md`, and `EXECUTION_BATCH_PLAN.md`. Split notice INS-02: Sections 29-31 moved to DELIVERY file. |
|
|
50
50
|
| Phase 6 post-execution review template | `tera-system/runtime/TERA_RUNTIME_TEMPLATES_DELIVERY.md` Section 32 | `TASK_TEMPLATE.md`, `TeraPreExecutionGate.md`, `TERA_RUNTIME_CHECKLISTS.md` | Used inside `TASK-COD-*` before final acceptance or closure. Note: `TASK_TEMPLATE.md` lives at `project-control/tasks/TASK_TEMPLATE.md` (clarified INS-07, 2026-08-01). Split notice INS-02: Section 32 moved to DELIVERY file. |
|
|
51
51
|
| Phase 7 delivery, handover, and closure | `.opencode/agents/tera.md` Section 5 + `TERA_RUNTIME_TEMPLATES_DELIVERY.md` Section 35 | `.opencode/agents/tera.md`, `TERA_RUNTIME_CHECKLISTS.md`, `TERA_RUNTIME_PROTOCOLS.md` | Project closure is separate from last TASK-COD closure. Phase 7 does not execute code. Split notice INS-02: Section 34 moved to DELIVERY file. |
|
|
52
|
-
| Sub-agent registry (core) | `tera-system/TeraSubAgents.md` | `.opencode/agents/tera.md` | Core agents (Engineering, QA, Auditor, Software Designer) —
|
|
53
|
-
| Sub-agent registry (helpers) | `tera-system/TeraHelperAgents.md` | `.opencode/agents/tera.md` | Helper agents (Security, DevOps, Domain, ERP, etc.) —
|
|
52
|
+
| Sub-agent registry (core) | `tera-system/TeraSubAgents.md` | `.opencode/agents/tera.md` | Core agents (Engineering, QA, Auditor, Software Designer) — المصدر الحي هو `.opencode/agents/` (لا يُعتمد عدّاد سطور ثابت) |
|
|
53
|
+
| Sub-agent registry (helpers) | `tera-system/TeraHelperAgents.md` | `.opencode/agents/tera.md` | Helper agents (Security, DevOps, Domain, ERP, etc.) — split from TeraSubAgents.md via SCP-2026-07-26 (لا يُعتمد عدّاد سطور ثابت) |
|
|
54
54
|
| Agent generation template | `tera-system/AGENT_GENERATION_TEMPLATE.md` | `TERA_RUNTIME_PROTOCOLS_CORE.md` | Draft agents use this source. |
|
|
55
55
|
| Pre/Post execution gates | `tera-system/TeraPreExecutionGate.md` | `.opencode/agents/tera.md`, `TERA_RUNTIME_PROTOCOLS_CORE.md` | Gate details stay in the policy file. |
|
|
56
|
+
| Quick-command layer protocol | `tera-system/runtime/TERA_COMMAND_PROTOCOL.md` | `.opencode/commands/` (كل الأوامر تُحيل إليه) | Workspace Resolution (§1) · Closure Prerequisites (§3) · Closure Transaction (§4) · Command Conformance (§5). SCP-2026-09-24-002. |
|
|
56
57
|
| Token/context policy | `tera-system/TeraTokenPolicy.md` | `.opencode/agents/tera.md` | Runtime contains only startup/loading rules. |
|
|
57
58
|
| Runtime protocols | `tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md` + `TERA_RUNTIME_PROTOCOLS_CLIENT.md` | `.opencode/agents/tera.md` | Detailed operational behavior. Split INS-02 continuation: core (1–11) + client (12–18) + knowledge (19). |
|
|
58
59
|
| Client Discovery protocol | `tera-system/runtime/CLIENT_DISCOVERY_PROTOCOL.md` | `TERA_RUNTIME_PROTOCOLS_CLIENT.md` (Section 18 → reference) | Extracted from §18 of Runtime Protocols; covers full Discovery and Smart Interview. |
|
|
@@ -95,6 +96,7 @@ Project files record project-specific decisions.
|
|
|
95
96
|
| System maintenance | `tera-system/TeraSystemMaintenanceChecklist.md` | `.opencode/agents/tera.md` | Use when modifying Tera itself. |
|
|
96
97
|
| Agent dependency map | `tera-system/AGENT_DEPENDENCY_MAP.md` | `tera-system/AGENT_DEPENDENCY_MAP.md` | Cross-references between agent files; safe edit order; file size alerts. Read before editing any agent file. |
|
|
97
98
|
| Engineering agent core | `tera-system/engineering-helpers/engineering-agent-core.md` | `.opencode/agents/engineering-agent.md`, `.opencode/agents/engineering-agent-dotnet.md` | Shared engineering rules for ALL engineering agents. Must be read before every task. |
|
|
99
|
+
| DB privilege feasibility & probe hygiene | `tera-system/engineering-helpers/database-privileges.md` | `TeraPreExecutionGate.md` §5.1 | ميكانيكا PG: runtime principal/role · GRANT/SET ROLE · probe hygiene (42501/25P02) · least-privilege. SCP-2026-09-24-005. |
|
|
98
100
|
| .NET Engineering agent | `.opencode/agents/engineering-agent-dotnet.md` | `tera-system/TeraSubAgents.md`, `tera-system/AGENT_ACTIVATION_MATRIX.md`, `tera-system/AGENT_DEPENDENCY_MAP.md` | Specialized .NET/C# engineering agent. Used for .NET tasks instead of the general engineering-agent.md. |
|
|
99
101
|
| Scenario stress tests | `tera-system/TeraScenarioStressTests.md` | Not applicable | Used for validation, not daily runtime. |
|
|
100
102
|
| Client workspace guide | `clients/README.md` | Not applicable | Folder usage guide only; policies remain in `tera-system/`. |
|
|
@@ -110,7 +112,7 @@ Project files record project-specific decisions.
|
|
|
110
112
|
| Business Transformation Consultant (BTCA) | `.opencode/agents/tera-business-transformation-consultant.md` | `tera-system/consulting-helpers/BTCA_METHODOLOGY_FRAMEWORK.md`, `BTCA_REPORT_TEMPLATES.md` | عميل مستقل للاستشارات الإدارية والتنظيمية غير البرمجية — Track C. SCP-2026-07-29-002. |
|
|
111
113
|
| BTCA — Methodology Framework | `tera-system/consulting-helpers/BTCA_METHODOLOGY_FRAMEWORK.md` | `.opencode/agents/tera-business-transformation-consultant.md` | إطار المنهجية: تصنيف الأدلة الخماسي، مراحل العمل، دليل المقابلات، هيكل التقرير النهائي. |
|
|
112
114
|
| BTCA — Report Templates | `tera-system/consulting-helpers/BTCA_REPORT_TEMPLATES.md` | `.opencode/agents/tera-business-transformation-consultant.md` | قوالب التقارير العشرة الأساسية + التقرير التنفيذي. |
|
|
113
|
-
| Tera distribution (versioned) | `tera-system/TERA_DISTRIBUTION_POLICY.md` (§2.2 الحزم + §2.3 الموقع + §2.0 الأصالة) | `.tera/lock.json` في مستودعات العملاء | توزيع Tera المُروّس: **RepositoryUrl `https://github.com/Alabasi1980/Teranoo-System-Core`** (المصدر؛ مستودع الحزم `Teranoo-System` = npm فقط) + الحزم `@tera-system/core 0.
|
|
115
|
+
| Tera distribution (versioned) | `tera-system/TERA_DISTRIBUTION_POLICY.md` (§2.2 الحزم + §2.3 الموقع + §2.0 الأصالة) | `.tera/lock.json` في مستودعات العملاء | توزيع Tera المُروّس: **RepositoryUrl `https://github.com/Alabasi1980/Teranoo-System-Core`** (المصدر؛ مستودع الحزم `Teranoo-System` = npm فقط) + الحزم `@tera-system/core 0.6.0` / `@tera-system/pro 0.2.29` (مقاس من npm المنشور 2026-09-29 — SCP-2026-09-23-001 + releases 024-00x) + **الموقع `https://github.com/Alabasi1980/TeraWebsite` + `https://teranoo.com` + منصة النشر `https://coolify.teranoo.com/`** + إصدارات (Tag+SHA) + عقد ملكية + أدوات `tera-workshop/tools/`. أي تعديل على ملفات Tera-managed يتطلب Tag+bundle+npm publish. SCP-2026-08-15-009 + SCP-2026-08-31-002 + SCP-2026-08-31-003. |
|
|
114
116
|
| Source code ownership & pricing | `tera-system/TeraPricingPolicy.md` (§31) + `tera-system/TeraClientPolicy.md` (§9.5) | `tera-workshop/client-templates/contractual/SOURCE_CODE_PURCHASE_ADDENDUM_TEMPLATE.md`، `SOFTWARE_SERVICES_AGREEMENT` §12 | ملكية السورس افتراضياً لـ Tera (لا يُسلَّم للزبون) + خيارا L1 (40%) / L2 (max(3×، 1,000 JOD)) عبر ملحق تعاقدي + L3 (إعادة بيع) مرفوض افتراضياً. SCP-2026-08-29-004. |
|
|
115
117
|
| Prototype pricing mandate | `tera-system/TeraPricingPolicy.md` (§17.5) + `tera-system/TeraClientPolicy.md` (Gate 6) | `tera-workshop/client-templates/commercial/QUOTATION_TEMPLATE.md`, `project-control/TeraPricingCalculator.xlsx` | البروتوتايب التصميمي إلزامي لكل التطبيقات (SCP-2026-08-28-001) وهو **بند مسعّر مشمول**: 10% من السعر النهائي (B57) — يُحتسب تلقائياً في الحاسبة — يُعرض كبند منفصل في العرض — يُلغى إلى 0% فقط باتفاق الطرفين (WAIVED_BY_MAJED + موافقة الزبون). رفض البروتوتايب المعروض لا يُلغي تكلفته (Fix/CR). SCP-2026-09-01-001. |
|
|
116
118
|
| Client letter numbering | `tera-system/TeraClientPolicy.md` (§9.6) + `project-control/CLIENT_CODES.md` | `client-approval/LETTER_LOG.md` في مستودع العميل | ترميز موحد `{كود-العميل}-{النوع}-{السنة}-{التسلسل}` — كود العميل يخصّصه Majed فقط (سجل مركزي) — الأنواع LET/CON/ADD/PAL/DOC/TPL (قابلة للزيادة). SCP-2026-08-29-005. |
|
|
@@ -225,6 +225,40 @@ BLOCKED
|
|
|
225
225
|
|
|
226
226
|
---
|
|
227
227
|
|
|
228
|
+
### 5.1 Empirical Feasibility & Environment Gates (SCP-2026-09-24-005 — Risk-Based)
|
|
229
|
+
|
|
230
|
+
> **المبدأ:** لا تُثبّت قراراً حسّاساً اعتماداً على التوثيق/الاستنتاج وحده إن كان **probe صغير رخيص ممكن**.
|
|
231
|
+
> القاعدة **risk-based** — لا تحوّل كل قرار صغير إلى مختبر.
|
|
232
|
+
|
|
233
|
+
```text
|
|
234
|
+
Low → source inspection
|
|
235
|
+
Medium → source inspection + targeted static check
|
|
236
|
+
High → + inventory (كل المواضع المحتملة)
|
|
237
|
+
Critical → + live capability probe (بالدور/البيئة الحقيقية حيث أمكن)
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
**(أ) EMPIRICAL-BEFORE-PIN** — أي قرار يثبّت: تبعية · schema head · صلاحية DB · قدرة دور · قدرة toolchain · حزمة خارجية
|
|
241
|
+
→ لا يُعتمد من الاستنتاج وحده؛ استخدم `reasoning + source inspection + focused probe` (رخيص وفقط عند الاقتصاد).
|
|
242
|
+
|
|
243
|
+
**(ب) DB Runtime Privilege Feasibility** — عند مهمة تلمس قاعدة بيانات حسّاسة أو separation (role separation · RLS · WORM · privileged writer · reader/writer split · audit/security tables · service principals · least-privilege):
|
|
244
|
+
```text
|
|
245
|
+
New query/operation → production component → runtime principal → required privileges → actual grants
|
|
246
|
+
```
|
|
247
|
+
تأكد أن **الدور الفعلي في الإنتاج** يملك الصلاحية — لا مجرد وجود الجدول/الأعمدة/الدور. الميكانيكا: `tera-system/engineering-helpers/database-privileges.md`.
|
|
248
|
+
|
|
249
|
+
**(ج) Schema-Head / Cross-Pin Inventory** — عند إضافة Migration أو تغيير رقم/رأس الـSchema:
|
|
250
|
+
قبل التفويض التالي، نفّذ **جرداً شاملاً** لكل مواضع التثبيت المحتملة (لا فقط موضع الفشل الأول):
|
|
251
|
+
`MIGRATION_HEAD · EXPECTED_HEAD · migration count · == old_head · 1..=old_head · old_head:true · fixtures · startup guards · error messages · test names · provisioning scripts`.
|
|
252
|
+
|
|
253
|
+
**(د) Environment-aware Execution** — قبل اختبار يعتمد على قدرة بيئية (شاشة تفاعلية · Docker · أداة CLI · جهاز):
|
|
254
|
+
1. Preflight: اكتشف القدرة البيئية. 2. شغّل الاختبار. 3. صنّف بدقّة:
|
|
255
|
+
- `CODE_REGRESSION` (فشل حقيقي → لا قبول) · `ENVIRONMENT_NOT_AVAILABLE` (قدرة غائبة → موثّق، **ليس PASS**، وليس فشل كود).
|
|
256
|
+
> ممنوع تحويل Environment Failure إلى `PASS` كاذب، وممنوع رفض كود سليم بسبب بيئة غائبة.
|
|
257
|
+
|
|
258
|
+
**(هـ) تعزيز Paired Records** — عند حدث حوكمي يجب أن يظهر في **Audit Trail + Activity Log** معاً (SCP-2026-09-24-005): حدّثهما مقترنَين (راجع Cross-Record Consistency §6.2) — لا تنتظر اكتشاف المالك لنقص لاحقاً.
|
|
259
|
+
|
|
260
|
+
---
|
|
261
|
+
|
|
228
262
|
## 6. قواعد منع تضخم المهمة
|
|
229
263
|
|
|
230
264
|
يمنع داخل أي مهمة تنفيذية إضافة أي عنصر غير مطلوب صراحة في عنوان المهمة أو معايير قبولها.
|
|
@@ -798,11 +832,24 @@ Required Action:
|
|
|
798
832
|
Read project state → Identify next task → Prepare/draft task package → Check CLI side effects → Run checklist → Revise until PASS → Ask approval
|
|
799
833
|
```
|
|
800
834
|
|
|
801
|
-
### SoftwareDesignerAgent
|
|
835
|
+
### SoftwareDesignerAgent Gate Rule (SDA Classification — SCP-2026-09-29-010)
|
|
836
|
+
|
|
837
|
+
كل مهمة تنفيذية تُصنَّف **إلزامياً**: `SDA Classification: REQUIRED / FAST_PATH / NOT_APPLICABLE` (القاعدة: **Impact Trigger يتجاوز Complexity Trigger**). هذا فحص إلزامي داخل البوابة — لا "may use".
|
|
838
|
+
|
|
839
|
+
**`REQUIRED` → ترفض المهمة إن نقص أيٌّ من:**
|
|
840
|
+
```text
|
|
841
|
+
[ ] TASK-COD-XXX موجود كـ Draft
|
|
842
|
+
[ ] TASK-COD-XXX_TECHNICAL_SPECIFICATION.md موجود
|
|
843
|
+
[ ] حالة المواصفة = APPROVED_FOR_GATE
|
|
844
|
+
[ ] لا Design Gap غير مُعالج
|
|
845
|
+
[ ] الحالات المرجعية المطبَّقة ≥ MBA
|
|
846
|
+
[ ] Tera راجع المواصفة
|
|
847
|
+
[ ] المواصفة مُشار إليها من عقد المهمة
|
|
848
|
+
```
|
|
849
|
+
**`FAST_PATH` → ترفض إن نقص:** سبب مكتوب + إثبات تحقق كل شروط الـFast Path.
|
|
850
|
+
**`NOT_APPLICABLE` →** مهام وثائقية/تشغيلية فقط.
|
|
802
851
|
|
|
803
|
-
|
|
804
|
-
This agent produces `TECHNICAL_SPECIFICATION.md` covering scope, references, write targets, acceptance criteria, risk notes, and reviewer suggestions.
|
|
805
|
-
Tera must still review that specification himself, run the full `Pre-Execution Gate`, and keep final authority over approval, delegation, and closure.
|
|
852
|
+
أي نقص → `NEEDS_REVISION` (لا تفويض). Tera يبقى صاحب السلطة النهائية على الاعتماد/التفويض/الإغلاق. المواصفة تغطي scope/references/write targets/acceptance criteria/risk notes/reviewers وفق قالب `tera-software-designer.md` §5.
|
|
806
853
|
|
|
807
854
|
لا يعتمد على الذاكرة أو الاستنتاج العام. يعتمد على القائمة والفحص.
|
|
808
855
|
|
|
@@ -121,14 +121,14 @@ Every preparation document passes through these states. Not all states are manda
|
|
|
121
121
|
|
|
122
122
|
| State | Meaning | Who Can Advance | Consumption Allowed By |
|
|
123
123
|
|---|---|---|---|
|
|
124
|
-
| **Draft** | Being written; content may be incomplete | Maker agent +
|
|
125
|
-
| **Under Cross-Review** | Submitted for cross-document review by Checker agent(s) |
|
|
126
|
-
| **Module Baseline Approved** | A defined module/wave of this document is approved for that module |
|
|
127
|
-
| **System Pending Integration** | Approved at module level but not yet reconciled with all system-level documents |
|
|
128
|
-
| **System Approved** | All modules approved; system-level consistency confirmed |
|
|
124
|
+
| **Draft** | Being written; content may be incomplete | Maker agent + Orchestrator (مُهندس) | No consumer agent |
|
|
125
|
+
| **Under Cross-Review** | Submitted for cross-document review by Checker agent(s) | Orchestrator (مُهندس) submits; Checker returns findings | Reviewers only |
|
|
126
|
+
| **Module Baseline Approved** | A defined module/wave of this document is approved for that module | Orchestrator (مُهندس) → Owner (for sensitive items only) | SoftwareDesignerAgent for that module; execution planning for that module |
|
|
127
|
+
| **System Pending Integration** | Approved at module level but not yet reconciled with all system-level documents | Orchestrator (مُهندس) | Limited: execution planning for the module only |
|
|
128
|
+
| **System Approved** | All modules approved; system-level consistency confirmed | Orchestrator (مُهندس) → Owner (summary only) | All consumer agents; full execution planning |
|
|
129
129
|
| **Locked** | No further changes expected; only Change Request can reopen | Owner | All consumers (read-only) |
|
|
130
|
-
| **Change Requested** | Formal change requested after baseline; impact analysis required | Owner →
|
|
131
|
-
| **Superseded** | Replaced by a newer version of the same document |
|
|
130
|
+
| **Change Requested** | Formal change requested after baseline; impact analysis required | Owner → Orchestrator (مُهندس) | Only the impact analysis |
|
|
131
|
+
| **Superseded** | Replaced by a newer version of the same document | Orchestrator (مُهندس) | None (read archived copy only) |
|
|
132
132
|
|
|
133
133
|
### 3.2 Closure Conditions
|
|
134
134
|
|
|
@@ -150,7 +150,7 @@ Every preparation document passes through these states. Not all states are manda
|
|
|
150
150
|
| Role | Who | Responsibility |
|
|
151
151
|
|---|---|---|
|
|
152
152
|
| **Maker** | Preparation role performed by `application-blueprint` or a generated helper agent (prep roles: RequirementsScope / BusinessWorkflow / DataDesign / UIUXStructure / SolutionArchitecture) | Writes the document following its template and assigned allowed-write-targets |
|
|
153
|
-
| **Checker** | A different preparation agent or
|
|
153
|
+
| **Checker** | A different preparation agent, or `auditor` in **`Preparation-Review`** mode (SCP-2026-09-24-006 — batch-level, read-only) | Reviews the document for: cross-document consistency, dependency alignment, completeness against its template |
|
|
154
154
|
| **Orchestrator** | ApplicationBlueprintAgent (مُهندس) — SCP-2026-07-28-118 | Plans the document, assigns Maker, assigns Checker, tracks state, detects contradictions, prepares approval packages |
|
|
155
155
|
| **Owner** | Majed | Approves only sensitive decisions (module boundaries, scope changes, critical Cross-Cutting Rules, System Approved promotion). Does not review every field. |
|
|
156
156
|
|
|
@@ -163,7 +163,9 @@ Every preparation document passes through these states. Not all states are manda
|
|
|
163
163
|
- Completeness against the document's own required sections (from the template)
|
|
164
164
|
- Edge cases and missing dependencies
|
|
165
165
|
4. If the Checker finds issues, the document returns to `Draft` with documented findings.
|
|
166
|
-
5. If the Checker approves,
|
|
166
|
+
5. If the Checker approves, the Orchestrator (مُهندس) advances it to the next state.
|
|
167
|
+
6. **Self-review ≠ Independent Cross-Review (SCP-2026-09-24-004):** if Maker and Checker are the same logical role, evidence MUST be labeled `Review Type: SELF_REVIEW` + `Independent Review: NOT PERFORMED` + reason. Never label it "Cross-Review PASS" — a downstream reader (Tera/Auditor) would misread it as second-party review.
|
|
168
|
+
7. **Preparation Review Classification:** every batch declares exactly one: `INDEPENDENT_CHECK_REQUIRED` (default for Medium+) · `SELF_REVIEW_ALLOWED_WITH_OWNER_WAIVER` (Tiny/Low-risk only — explicit owner waiver + honest labeling) · `SPECIALIST_REVIEW_REQUIRED`. Waiver is explicit, never assumed. See §9.
|
|
167
169
|
|
|
168
170
|
### 4.3 Owner Approval Points
|
|
169
171
|
|
|
@@ -181,6 +183,8 @@ The Owner (Majed) approves only these decision points:
|
|
|
181
183
|
- Routine updates after initial baseline (unless the update changes scope or cross-cutting rules)
|
|
182
184
|
- Checker findings or routine state transitions
|
|
183
185
|
|
|
186
|
+
> **No-Silence-Approval Rule (SCP-2026-09-24-004):** a material preparation decision/assumption is **never** accepted by silence or by wording like "accepted unless the owner objects". Until explicit owner confirmation it stays `Proposed / Pending Owner Confirmation` and must NOT enter the baseline or Handoff. **Silence ≠ approval.**
|
|
187
|
+
|
|
184
188
|
---
|
|
185
189
|
|
|
186
190
|
## 5. Partial Approval / Module Baseline
|
|
@@ -202,7 +206,7 @@ Large projects may have multiple modules (e.g., Inventory, Sales, HR). Each modu
|
|
|
202
206
|
### 5.3 Cross-Module Consistency
|
|
203
207
|
|
|
204
208
|
Before advancing to `System Approved`:
|
|
205
|
-
1.
|
|
209
|
+
1. The Orchestrator (مُهندس) runs a **system-level reconciliation check**:
|
|
206
210
|
- No duplicate entities across modules
|
|
207
211
|
- Consistent naming and relationships
|
|
208
212
|
- No orphan references (e.g., a screen that refers to a removed entity)
|
|
@@ -240,8 +244,8 @@ Open Questions: [any unresolved questions before approval]
|
|
|
240
244
|
|
|
241
245
|
| Change Severity | Approval Required |
|
|
242
246
|
|---|---|
|
|
243
|
-
| Addition within existing scope (no breaking change) |
|
|
244
|
-
| Modification affecting cross-module consistency |
|
|
247
|
+
| Addition within existing scope (no breaking change) | Orchestrator (مُهندس) (recorded in `CHANGE_REQUESTS.md`) |
|
|
248
|
+
| Modification affecting cross-module consistency | Orchestrator (مُهندس) + Owner (summary only) |
|
|
245
249
|
| Deletion or deprecation of existing content | Owner |
|
|
246
250
|
| Change affecting architecture, security, or compliance | Owner |
|
|
247
251
|
|
|
@@ -263,7 +267,7 @@ Targeted web research is permitted **only** when all of the following are true:
|
|
|
263
267
|
- **Gap Description**: what is missing and why it is needed
|
|
264
268
|
- **Research Question**: a single, precise question
|
|
265
269
|
- **Source Criteria**: what kind of sources are acceptable
|
|
266
|
-
2.
|
|
270
|
+
2. The Orchestrator (مُهندس) or `DomainResearchAgent` executes the search.
|
|
267
271
|
3. The result is documented as:
|
|
268
272
|
|
|
269
273
|
```text
|
|
@@ -324,11 +328,13 @@ SoftwareDesignerAgent:
|
|
|
324
328
|
For small projects (as classified in `TERA_PROJECT_DECISION.md`):
|
|
325
329
|
|
|
326
330
|
- The full lifecycle may be simplified: `Draft` → `System Approved` → `Locked`, skipping intermediate states
|
|
327
|
-
- Cross-review may be done by Tera itself rather than a separate Checker agent
|
|
328
331
|
- Partial baselines are not needed (single module)
|
|
329
332
|
- The Owner may approve a single bulk approval instead of per-decision-point approvals
|
|
333
|
+
- **Review independence (مُصحَّح — SCP-2026-09-24-004):** لا يُستخدم "Tera نفسه كـChecker" (معمارية قديمة — Tera الآن Phases 5–7 فقط، ولا يشارك في تحضير Phases 1–4). بدلاً من ذلك:
|
|
334
|
+
- **الافتراضي:** Checker مستقل — **`auditor` في وضع `Preparation-Review`** (كل دفعة · قراءة فقط · اتساق مستندات) — SCP-2026-09-24-006.
|
|
335
|
+
- **Tiny / Low-risk فقط:** `SELF_REVIEW_ALLOWED_WITH_OWNER_WAIVER` — مراجعة ذاتية **بتصنيف صريح `SELF_REVIEW`** + تنازل مالك صريح، **ولا تُسمّى Cross-Review مستقلاً**.
|
|
330
336
|
|
|
331
|
-
The project classification determines which simplification applies. The governance model is not bypassed — it is scaled.
|
|
337
|
+
The project classification determines which simplification applies. The governance model is not bypassed — it is scaled. **استقلال المراجعة لا يُدّعى بغير دليل.**
|
|
332
338
|
|
|
333
339
|
---
|
|
334
340
|
|
|
@@ -141,6 +141,7 @@ Auditor (مُدقق) هو عميل جودة فرعي، وليس عميلاً ر
|
|
|
141
141
|
المستدعون المصرح لهم في v1:
|
|
142
142
|
1. TeraAgent — بعد مهام التنفيذ وفق قرار Auditor Review Decision.
|
|
143
143
|
2. Monitor — فقط عندما يطلب Majed من Monitor تحدي أو التحقق من عمل Tera بجودة مستقلة.
|
|
144
|
+
3. ApplicationBlueprintAgent (مُهندس) — **مراجعة تحضير فقط** (Phases 1–4): وضع `Preparation-Review` (كل دفعة · قراءة فقط · اتساق مستندات) — SCP-2026-09-24-006. لا صلاحية تصميم/نطاق/قبول.
|
|
144
145
|
|
|
145
146
|
الشروط:
|
|
146
147
|
1. التفويض يجب أن يكون مرتبطاً بمهمة/دفعة محددة.
|
|
@@ -277,7 +278,7 @@ but the generic sub-agent registry in `TeraSubAgents.md` must remain stack-neutr
|
|
|
277
278
|
|
|
278
279
|
# 5. العملاء الأساسيون — السجل الرسمي (25 عميلاً)
|
|
279
280
|
|
|
280
|
-
> **مصدر الحقيقة:** `.opencode/agents/` —
|
|
281
|
+
> **مصدر الحقيقة:** `.opencode/agents/` — **25 ملفاً نشطاً** بالأسماء الحديثة (القائمة الفعلية أوثق من أي عدّاد). هذا القسم **سجل مرجعي موجز**؛ التفاصيل التشغيلية الكاملة لكل عميل في ملفه الخاص.
|
|
281
282
|
> **التصنيف الرسمي:** 8 Coding + 3 Quality + 2 Management + 4 Engagement + 2 Research + 1 Knowledge + 1 Specialist + 1 System + 3 Security = **25 عميلاً**.
|
|
282
283
|
|
|
283
284
|
---
|
|
@@ -286,7 +287,7 @@ but the generic sub-agent registry in `TeraSubAgents.md` must remain stack-neutr
|
|
|
286
287
|
|
|
287
288
|
| الفئة | العدد | العملاء |
|
|
288
289
|
|:------|:-----:|:--------|
|
|
289
|
-
| **
|
|
290
|
+
| **Execution Layer** — طبقة التنفيذ | 8 | engineering-agent, engineering-agent-dotnet, engineering-agent-typescript, engineering-agent-phaser, engineering-agent-flutter, engineering-agent-django, ui-designer, tera-software-designer |
|
|
290
291
|
| **Quality Agents** — جودة | 3 | auditor, qa-agent, design-reviewer |
|
|
291
292
|
| **Management** — إدارة | 2 | tera (TeraAgent), monitor |
|
|
292
293
|
| **Engagement** — عملاء خارجيون | 4 | tera-client-engagement, tera-business-transformation-consultant, application-blueprint, tera-strategic-advisor |
|
|
@@ -294,7 +295,9 @@ but the generic sub-agent registry in `TeraSubAgents.md` must remain stack-neutr
|
|
|
294
295
|
| **Knowledge** — معرفة | 1 | project-knowledge-agent |
|
|
295
296
|
| **Specialist** — تخصص | 1 | production-erp-expert |
|
|
296
297
|
| **System** — منظومة | 1 | tera-system-evolution |
|
|
297
|
-
| **Security** — فريق الحماية | 3 | red-team-agent, security-observer, security-auditor |
|
|
298
|
+
| **Security** — فريق الحماية | 3 | red-team-agent, security-observer, security-auditor |
|
|
299
|
+
|
|
300
|
+
> **تفصيل «طبقة التنفيذ» (8):** **7 كتابة كود** — المهنّدسون الستة (`engineering-agent`, `-dotnet`, `-typescript`, `-phaser`, `-flutter`, `-django`) + `ui-designer` (واجهة عرضية TSX/CSS) — و**1 مواصفة تقنية بلا كود** (`tera-software-designer`). التسمية السابقة «Coding Agents — يكتبون كوداً» كانت **غير دقيقة لـ1 من 8** (SCP-2026-09-29-011).
|
|
298
301
|
|
|
299
302
|
---
|
|
300
303
|
|
|
@@ -311,7 +314,7 @@ but the generic sub-agent registry in `TeraSubAgents.md` must remain stack-neutr
|
|
|
311
314
|
| `engineering-agent-flutter.md` | Flutter/Dart mobile client | Coding |
|
|
312
315
|
| `engineering-agent-django.md` | Python/Django/DRF backend | Coding |
|
|
313
316
|
| `ui-designer.md` | تصميم بصري UI/UX | Coding |
|
|
314
|
-
| `tera-software-designer.md` | تصميم تقني / Technical Specs |
|
|
317
|
+
| `tera-software-designer.md` | تصميم تقني / Technical Specs (بلا كود) | Design |
|
|
315
318
|
| `auditor.md` | تدقيق جودة Diff-first (مُدقق) | Quality |
|
|
316
319
|
| `qa-agent.md` | اختبارات CLI (تخطيط + تنفيذ) | Quality |
|
|
317
320
|
| `design-reviewer.md` | مراجعة بصرية (ناقد) | Quality |
|
|
@@ -66,6 +66,18 @@ Before finishing, verify:
|
|
|
66
66
|
- Is the runtime file becoming a full manual?
|
|
67
67
|
- Are client-facing rules duplicated outside client policies without need?
|
|
68
68
|
|
|
69
|
+
## 5.1 Registration Consistency Check (SCP-2026-09-24-001)
|
|
70
|
+
|
|
71
|
+
عند أي تغيير يمس عميلاً أو صلاحية أو تفعيلاً، شغّل **المُدقّق المعتمد** (يُرجع PASS/FAIL + مسار الدليل):
|
|
72
|
+
|
|
73
|
+
```text
|
|
74
|
+
node scripts/validate-governance.mjs
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
يتحقق من: كل ملف في `.opencode/agents/` له مدخل واحد في `TeraSubAgents.md` §5، `AGENT_ACTIVATION_MATRIX.md` §2.1، `AGENT_PERMISSION_MODEL.md` §3.1، `AGENT_DEPENDENCY_MAP.md` · صفر ID مكرر · حزم/Triggers معرَّفة · `agent:` في أوامر التهيئة يشير لملف موجود.
|
|
78
|
+
|
|
79
|
+
- النتيجة: PASS / FAIL (مع القائمة). لا إغلاق بتقرير "PASS" بلا تشغيل فعلي.
|
|
80
|
+
|
|
69
81
|
## 6. Validation Commands
|
|
70
82
|
|
|
71
83
|
Recommended checks:
|
|
@@ -253,6 +253,6 @@ Select-String -Path TERA_HANDOFF_PACKAGE.md -Pattern 'D-\d{3}' | ForEach-Object
|
|
|
253
253
|
| **الاسم** | Hypercare Handoff Gate |
|
|
254
254
|
| **الهدف** | ضمان استقرار النظام بعد الإطلاق قبل تسليمه نهائياً للفريق التشغيلي أو إغلاق المشروع |
|
|
255
255
|
| **المدخلات المطلوبة** | `ISSUE_LOG.md`, `HANDOVER_DOCUMENT.md`, Post-Implementation Review |
|
|
256
|
-
| **شروط النجاح** | 1. ISSUE_LOG.md — لا توجد مشاكل Critical/High مفتوحة<br>2. HANDOVER_DOCUMENT.md — يحتوي:
|
|
257
|
-
| **شروط الإيقاف (Blocking Conditions)** | 1. مشاكل Critical/High مفتوحة ← توقف<br>2. HANDOVER_DOCUMENT.md غير مكتمل ← توقف |
|
|
256
|
+
| **شروط النجاح** | 1. ISSUE_LOG.md — لا توجد مشاكل Critical/High مفتوحة<br>2. HANDOVER_DOCUMENT.md — يحتوي: عناوين الخوادم، جهات الاتصال، إجراءات الصيانة الأساسية + **طريقة تسليم بيانات الاعتماد (مرجع فقط — لا قيم): vault/password-manager/قناة آمنة + Secret ID/مالكه**<br>3. Post-Implementation Review — أُجريت مع الزبون ووثّقت<br>4. TCEA يؤكد: الزبون راضٍ ولا توجد مشاكل معلقة<br>⚠️ **ممنوع منعاً باتاً تضمين أي كلمة سر/توكن/مفتاح فعلي في الملف** (TeraClientPolicy: لا أسرار في ملفات العميل) — SCP-2026-09-24-003 |
|
|
257
|
+
| **شروط الإيقاف (Blocking Conditions)** | 1. مشاكل Critical/High مفتوحة ← توقف<br>2. HANDOVER_DOCUMENT.md غير مكتمل ← توقف<br>3. تضمين أي قيمة اعتماد فعلية في HANDOVER_DOCUMENT.md ← توقف + إزالة فورية (خطر أمني P0) |
|
|
258
258
|
| **الإخراج الإلزامي** | **PASS/FAIL** — عند PASS: إغلاق المشروع أو الانتقال إلى دعم عادي (Retainer) |
|
|
@@ -157,7 +157,7 @@ clients/CLIENT-*/applications/APP-*/client-engagement/
|
|
|
157
157
|
├── SCOPE_SUMMARY.md ← ملخص النطاق (للمشاريع المتوسطة)
|
|
158
158
|
├── FEATURE_LIST.md ← قائمة الميزات (للمشاريع المتوسطة+)
|
|
159
159
|
├── DRAFT_QUOTATION.md ← مسودة عرض السعر (Level 2)
|
|
160
|
-
├── TERA_HANDOFF_PACKAGE.md ← حزمة التسليم لـ
|
|
160
|
+
├── TERA_HANDOFF_PACKAGE.md ← حزمة التسليم لـ مُهندس (ApplicationBlueprintAgent) — الاسم تاريخي (Track A)
|
|
161
161
|
├── CLIENT_DECISION_LOG.md ← سجل القرارات
|
|
162
162
|
└── CHANGE_REQUEST_LOG.md ← سجل طلبات التغيير
|
|
163
163
|
```
|
|
@@ -609,9 +609,10 @@ TCEA يكيِّف أسلوبه، ولا يتجاوز سياج الحوكمة أ
|
|
|
609
609
|
2. قدّم الـ Demo في 3 مراحل:
|
|
610
610
|
المرحلة 1 — السياق: "هذا المنتج مصمم لـ [المجال]، يغطي ميزات مثل [الميزات الرئيسية]"
|
|
611
611
|
المرحلة 2 — الربط بالاحتياج: "أنت ذكرت أنك تحتاج X — المنتج يغطيها بـ Y"
|
|
612
|
-
المرحلة 3 — القيمة:
|
|
612
|
+
المرحلة 3 — القيمة: **بلا رقم غير موثّق** — إن لم يتوفر مصدر/افتراض موثّق فصياغة نوعية فقط
|
|
613
613
|
3. لا تَعِد بميزات غير موجودة في Feature Matrix
|
|
614
614
|
4. إذا سأل الزبون عن ميزة غير موجودة → سجّلها كـ Gap في FIT_GAP_MATRIX.md
|
|
615
|
+
5. **قاعدة الأرقام (SCP-2026-09-24-003):** لا يُعرض ادّعاء كمّي (توفير/ROI/وقت/أداء/امتثال) للعميل إلا بمصدره وافتراضاته موثّقة؛ وإلا فصياغة نوعية فقط
|
|
615
616
|
```
|
|
616
617
|
|
|
617
618
|
#### هيكل PRODUCT_DEMO_SCRIPT.md
|
|
@@ -646,7 +647,7 @@ TCEA يكيِّف أسلوبه، ولا يتجاوز سياج الحوكمة أ
|
|
|
646
647
|
| التصنيف | المعنى | الإجراء | التكلفة |
|
|
647
648
|
|:-------:|--------|---------|:-------:|
|
|
648
649
|
| **Fit** ✅ | المنتج يغطي المطلب دون تعديل | لا شيء — يُسجّل كـ Covered | $0 |
|
|
649
|
-
| **Gap-Config** 🔧 | يمكن تغطيته عبر إعدادات النظام فقط |
|
|
650
|
+
| **Gap-Config** 🔧 | يمكن تغطيته عبر إعدادات النظام فقط | TCEA يصنّفه/يوثّقه · **التنفيذ في B4 بيد الجهة المكلّفة (TeraAgent/فرق التنفيذ)** — TCEA لا ينفّذ التكوين | ضمن Fixed Price |
|
|
650
651
|
| **Gap-Custom** 💻 | يتطلب تطويراً مخصصاً (RICEFW) | يُنشأ RICEFW Item — يُسعّر منفصلاً (T&M أو Fixed) | إضافي — خارج Fixed |
|
|
651
652
|
| **Process Change** 🔄 | يمكن تغطيته بتعديل عملية الزبون | يُقنع الزبون بتعديل العملية — لا تطوير | $0 (ولكن يحتاج إدارة تغيير) |
|
|
652
653
|
|
|
@@ -654,7 +655,7 @@ TCEA يكيِّف أسلوبه، ولا يتجاوز سياج الحوكمة أ
|
|
|
654
655
|
|
|
655
656
|
```text
|
|
656
657
|
1. Configuration-First: Gap-Config هو الحل الافتراضي دائماً (راجع B.3)
|
|
657
|
-
2. كل Gap-Custom يحتاج Business Case
|
|
658
|
+
2. كل Gap-Custom يحتاج Business Case (يُقبل إذا أثبت **واحداً على الأقل**): ميزة تنافسية حقيقية · متطلب قانوني/تنظيمي · التزام تعاقدي · ضرورة تشغيلية بعائد/خفض خطر · تكامل إلزامي بلا بديل تكوين/طرف ثالث
|
|
658
659
|
3. أولويات MoSCoW: صنّف كل مطلب حسب Must/Should/Could/Won't
|
|
659
660
|
4. كل مطلب في FIT_GAP_MATRIX.md له: وصف، تصنيف، أولوية، إجراء مقترح، تقدير جهد
|
|
660
661
|
```
|
|
@@ -689,17 +690,21 @@ TCEA يكيِّف أسلوبه، ولا يتجاوز سياج الحوكمة أ
|
|
|
689
690
|
Customization = الحل الأخير — وليس الأول.
|
|
690
691
|
```
|
|
691
692
|
|
|
692
|
-
####
|
|
693
|
+
#### معايير قبول التخصيص (Gap-Custom) — مُوسَّعة (SCP-2026-09-24-003)
|
|
693
694
|
|
|
694
|
-
قبل الموافقة على أي `Gap-Custom`،
|
|
695
|
+
قبل الموافقة على أي `Gap-Custom`، يجب إثبات **واحد على الأقل** من أسس القبول:
|
|
695
696
|
|
|
696
697
|
```text
|
|
697
|
-
1.
|
|
698
|
-
2.
|
|
699
|
-
3.
|
|
700
|
-
|
|
698
|
+
1. ميزة تنافسية حقيقية (وليس "نحبها كذا")
|
|
699
|
+
2. متطلب قانوني / تنظيمي / ضريبي
|
|
700
|
+
3. التزام تعاقدي (Contractual requirement)
|
|
701
|
+
4. ضرورة تشغيلية بعائد مثبت أو خفض خطر مادي
|
|
702
|
+
5. تكامل إلزامي (مثل جهة حكومية) بلا بديل تكوين أو طرف ثالث
|
|
701
703
|
```
|
|
702
704
|
|
|
705
|
+
ثم — إن قُبل الأساس — قيّم دائماً: تكلفة دورة الحياة (تطوير + صيانة + اختبار ترقيات) · عبء الترقيات · أثر الدعم · الأثر الأمني. Financial ROI مطلوب فقط عندما يكون الأساس تجارياً، لا عندما يكون الأساس قانونياً/تعاقدياً إلزامياً.
|
|
706
|
+
Configuration-First يبقى المبدأ الافتراضي؛ لكن **لا يُرفض التخصيص تلقائياً** لمجرد غياب "ميزة تنافسية" إذا وُجد أساس إلزامي.
|
|
707
|
+
|
|
703
708
|
#### قاعدة التوثيق
|
|
704
709
|
|
|
705
710
|
كل `Gap-Custom` معتمد يجب أن يُوثّق في `RICEFW_INVENTORY.md` بالتفصيل:
|
|
@@ -102,6 +102,8 @@
|
|
|
102
102
|
[ ] إذا كان المحتوى “مرئيًا” لكنه غير “مريحًا”: فشل
|
|
103
103
|
```
|
|
104
104
|
|
|
105
|
+
> **قاعدة cross-check الصور (SCP-2026-09-29-002):** بعد كل لقطة، أجرِ cross-check لحقيقة مميزة واحدة في DOM (`find`/`evaluate`) **قبل** الاستشهاد بالصورة — فطبقة إرفاق الصور قد تعيد صورة قديمة؛ لا تحكم على صورة وحدها. يُفضَّل element-screenshot + هدوء بين اللقطات.
|
|
106
|
+
|
|
105
107
|
## §4. نظافة التصميم (Design Hygiene)
|
|
106
108
|
|
|
107
109
|
```
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# Database Privilege Feasibility & Probe Hygiene (Helper)
|
|
2
|
+
|
|
3
|
+
> **المصدر:** SCP-2026-09-24-005 — دعم `TeraPreExecutionGate §5.1` لمهام قاعدة البيانات الحسّاسة.
|
|
4
|
+
> **الحمولة العامة فقط** — لا أسماء/جداول/أدوار من أي مشروع عمّال (تُعمَّم كمفاهيم).
|
|
5
|
+
|
|
6
|
+
## 1. متى يُحمَّل؟
|
|
7
|
+
عند أي مهمة تلمس قاعدة بيانات **حسّاسة** أو فيها **فصل صلاحيات/أدوار**: role separation · RLS · WORM/append-only · privileged writer · reader/writer split · جداول audit/security · service principals · least-privilege.
|
|
8
|
+
|
|
9
|
+
## 2. سلسلة التحقق (Feasibility Chain)
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
New query/operation
|
|
13
|
+
→ production component (من سينفّذه فعلاً؟)
|
|
14
|
+
→ runtime principal/role (بأي هوية؟)
|
|
15
|
+
→ required privileges (ماذا يحتاج الاستعلام؟)
|
|
16
|
+
→ actual grants (ماذا يملك الدور فعلاً؟)
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
**الفخّ المتكرر:** `query valid + schema valid + tests valid` — لكن **الدور الفعلي في الإنتاج لا يملك صلاحية التنفيذ** (يعمل في التطوير بـsuperuser فيمرّ).
|
|
20
|
+
→ لا يكفي: existence (table/columns/role) — بل **privilege**.
|
|
21
|
+
|
|
22
|
+
## 3. ميكانيكا PostgreSQL
|
|
23
|
+
|
|
24
|
+
| المفهوم | الأمر/الاستعلام |
|
|
25
|
+
|---|---|
|
|
26
|
+
| عرض صلاحيات دور | `\dp <table>` / `has_table_privilege('role','table','SELECT')` / `has_column_privilege('role','table','col','SELECT')` |
|
|
27
|
+
| منح أدنى | `GRANT SELECT (colA, colB) ON <table> TO <role>;` — **أعمدة محدّدة لا الجدول** |
|
|
28
|
+
| اختبار بالدور الحقيقي | `SET ROLE <runtime_role>; <query>; RESET ROLE;` |
|
|
29
|
+
| `insufficient_privilege` | **`42501`** — مطلوب (متوقّع في اختبار أنه **مرفوض**). |
|
|
30
|
+
| `in_failed_sql_transaction` | **`25P02`** — يظهر **بدل** الخطأ الحقيقي إن تابعتَ بعد أول فشل داخل نفس المعاملة. |
|
|
31
|
+
|
|
32
|
+
## 4. Probe Hygiene (درس 318 — إلزامي)
|
|
33
|
+
|
|
34
|
+
```text
|
|
35
|
+
❌ عدة probes مستقلّة داخل معاملة واحدة:
|
|
36
|
+
أول failure (42501) يُجهض المعاملة → النتائج التالية تتحول إلى 25P02 (مضلِّلة)
|
|
37
|
+
|
|
38
|
+
✅ معاملة/SAVEPOINT مستقلة لكل probe:
|
|
39
|
+
BEGIN; ... ; ROLLBACK; أو SAVEPOINT p; ... ; ROLLBACK TO p;
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
- كل probe صلاحية **معزول** — لا تعتمد على نتيجة تالية بعد فشل.
|
|
43
|
+
- عند اختبار "يجب أن يُرفض" → أعد `RESET ROLE` + `ROLLBACK` قبل الـprobe التالي.
|
|
44
|
+
- سجّل `SQLSTATE` الحقيقي لكل probe (لا تخمّن).
|
|
45
|
+
|
|
46
|
+
## 5. أدنى صلاحية (Least Privilege)
|
|
47
|
+
|
|
48
|
+
- امنح **الأعمدة/العمليات المطلوبة فقط** — لا الجدول كاملاً.
|
|
49
|
+
- مثال مبدأي: كاتب WORM يحتاج قراءة الحقل السابق لبناء السلسلة → يُمنح **فقط** أعمدة السلسلة اللازمة (مثل `seq, hash`)، **لا** `actor/action/payload/sig`.
|
|
50
|
+
- أي توسيع صلاحية إنتاج **يحتاج موافقة صريحة** (بوابة migrations/privileges).
|
|
51
|
+
|
|
52
|
+
## 6. Evidence المطلوب في الـhandback
|
|
53
|
+
|
|
54
|
+
```text
|
|
55
|
+
Runtime principal:
|
|
56
|
+
Required privileges:
|
|
57
|
+
Actual grants (probe result + SQLSTATE):
|
|
58
|
+
Least-privilege grant used:
|
|
59
|
+
Environment (PG version / role / DB):
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
## 7. المرجع
|
|
63
|
+
`TeraPreExecutionGate.md §5.1` — EMPIRICAL-BEFORE-PIN · DB Runtime Privilege Feasibility.
|
|
@@ -10,17 +10,23 @@ It governs authority, task discipline, safe writing, evidence, and handback. It
|
|
|
10
10
|
|
|
11
11
|
Every engineering agent must read this file before it starts a task.
|
|
12
12
|
|
|
13
|
-
**🧰
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
13
|
+
**🧰 أدوات التنفيذ — قاعدة محكومة (SCP-2026-09-29-013):**
|
|
14
|
+
|
|
15
|
+
هذه القاعدة **لا تفرض** أي مكتبة/إطار/أداة كافتراض. استخدم الأداة **المعتمدة من الـTechnology/Tooling Profile النشط + المهمة**. لا تفترض أداة "افتراضية".
|
|
16
|
+
|
|
17
|
+
| الحاجة | عند اعتمادها في الـProfile/المهمة |
|
|
18
|
+
|---|---|
|
|
19
|
+
| E2E / فحص واجهة | Playwright (`playwright-cli` / `@playwright/mcp` / `@playwright/test`) — افتح، اختبر، لقطات |
|
|
20
|
+
| Accessibility | axe-core (`@axe-core/playwright`) — إن كانت متاحة أو أذن الـProfile بإضافتها |
|
|
21
|
+
| API docs/tests | Bruno (`bru run`) — **فقط إن كان مسار الـCollection ضمن Allowed Write Targets** |
|
|
22
|
+
| Observability | **إن كان المعتمد = Sentry** → تحقّق من تهيئته؛ وإلا لا تُضِف |
|
|
23
|
+
| UI components | مكتبة المكوّنات **المعتمدة في الـProfile** (shadcn/ui أو غيرها) + Teranoo UI Registry عند اعتماده |
|
|
24
|
+
| Secrets scan | Gitleaks (`gitleaks git . --redact --no-banner`) — قبل مهام Auth/Payment/Secrets/PII |
|
|
25
|
+
| Integration tests | Testcontainers — عند الحاجة لخدمة حقيقية + Docker متاح + اعتماد الـProfile |
|
|
26
|
+
| Build/Run | dotnet / npm / node / curl — حسب الـstack |
|
|
27
|
+
|
|
28
|
+
> **إضافة Dependency:** لا تُضِف أي حزمة إلا إذا: (أ) موجودة أصلاً → استخدمها، أو (ب) المهمة/الـProfile يسمح صراحة بإضافتها. وإلا → **أبلغ Tera بنقص التغطية**، ولا تُضِف.
|
|
29
|
+
> **Tooling الكامل:** `tera-system/TOOLING_AND_MCP_POLICY.md`.
|
|
24
30
|
|
|
25
31
|
---
|
|
26
32
|
|
|
@@ -96,7 +102,7 @@ Never write outside Allowed Write Targets because a path “looks related.”
|
|
|
96
102
|
- If the task includes a UI change:
|
|
97
103
|
1. **PLAYWRIGHT_UI_CHECK**: Run the app locally, open browser via Playwright CLI or MCP, visually verify the UI, take a full-page screenshot as evidence.
|
|
98
104
|
2. **E2E Test**: If the project has Node.js/npm available, generate a basic Playwright E2E test (`*.spec.ts`) covering the changed flow. The test must be runnable via `npx playwright test`.
|
|
99
|
-
3. **AXE_A11Y_CHECK** (new UI flows):
|
|
105
|
+
3. **AXE_A11Y_CHECK** (new UI flows): إن كان `@axe-core/playwright` متاحاً أو أذن الـProfile/المهمة بإضافته، ضمّن فحص axe في اختبار E2E وسجّل `violations` في الـhandback. **لا تُضِف الحزمة تلقائياً** — إن لم تكن متاحة ولم يُؤذن، أبلغ Tera بنقص تغطية a11y.
|
|
100
106
|
- If the task adds or changes data-layer tests that need a real database/cache service and Docker is available, prefer **Testcontainers** over Mocks-only for the critical integration paths (see §6.1 below). If Docker is unavailable, state the limitation and use Mocks with a documented follow-up.
|
|
101
107
|
- **GITLEAKS_PRE_DELIVERY_CHECK**: Before closing a task that touches Auth, Payment, Secrets, PII, or credential-like strings, run `gitleaks git . --redact --no-banner` and record the result in the handback. Never commit a real secret; if Gitleaks reports a real credential, stop and report to Tera.
|
|
102
108
|
|
|
@@ -110,6 +116,17 @@ When writing integration tests that depend on external services:
|
|
|
110
116
|
4. Keep container startup overhead reasonable: reuse containers across tests in the same suite where supported.
|
|
111
117
|
5. Do not use Testcontainers for unit tests; reserve it for integration and E2E paths.
|
|
112
118
|
|
|
119
|
+
### 6.2 Verify-Before-Assert (SCP-2026-09-24-005)
|
|
120
|
+
|
|
121
|
+
Before asserting anything as fact (in code, handback, commit, or decision):
|
|
122
|
+
|
|
123
|
+
- **Authoritative numeric constant** (schema head, migration count, expected count) → **fresh source read**, never from memory.
|
|
124
|
+
- **Long-file edit** → read the current file and build the **exact anchor** from fresh content (no memory anchors).
|
|
125
|
+
- **Commit / change claim** → verify the **actual content/diff** first; never claim a change you did not confirm.
|
|
126
|
+
- **"X exists / X is available"** → confirm it, or label `NOT VERIFIED`.
|
|
127
|
+
|
|
128
|
+
Do not fabricate; never claim a check passed that was not run (see §7).
|
|
129
|
+
|
|
113
130
|
---
|
|
114
131
|
|
|
115
132
|
## 7. Verification Discipline
|
|
@@ -217,7 +234,7 @@ If repeated real-work evidence reveals a gap in this core, a specialist contract
|
|
|
217
234
|
### 10.6 النظافة والحد الأدنى (Cleanliness & Minimalism)
|
|
218
235
|
|
|
219
236
|
- **لا كود ميت**: لا تترك imports/دوال/متغيرات غير مستخدمة.
|
|
220
|
-
- **لا تكرار واضح**: كرر مرتين = فكّر في الاستخراج؛ كرر ثلاثاً =
|
|
237
|
+
- **لا تكرار واضح**: كرر مرتين = فكّر في الاستخراج؛ كرر ثلاثاً = **مراجعة إلزامية للاستخراج** — قرار واعٍ بمسؤولية ضيقة، **وليس تجريداً تلقائياً** (قد يكون الاستخراج غير مناسب).
|
|
221
238
|
- **لا ملفات خارج نطاق المهمة**: كل ملف تلمسه يجب أن يخدم هدف المهمة المصرح به.
|
|
222
239
|
- نظّف أي حطام تنقله (ملفات تجريبية، سجلات مؤقتة، تعليقات قديمة) قبل الـ handback.
|
|
223
240
|
|
|
@@ -49,10 +49,12 @@ If the stack is still unclear, do not activate a final profile yet.
|
|
|
49
49
|
| `react-pwa` | React 18 + Vite + TypeScript + Tailwind CSS (RTL) + Zustand + idb (IndexedDB) + Fuse.js + vite-plugin-pwa | ✅ **Approved — Active** | PWA محلي عربي (Offline Standalone) — فعّل Majed (2026-08-01, PREP-D-016) |
|
|
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
|
-
| `rust` | Rust (cargo/rustc) — 2024 edition, Axum/Tauri/SQLx |
|
|
52
|
+
| `rust` | Rust (cargo/rustc) — 2024 edition, Axum/Tauri/SQLx | ✅ **Available** | عام: CLI، خدمات عالية الأداء، Tauri، WebAssembly — لا متخصص، يعمل عبر engineering-agent (fallback)؛ **مُثبَّت** ببناء/اختبار فعلي (Pilot GEN-F05 — SCP-2026-09-29-017) |
|
|
53
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) |
|
|
54
54
|
| `python-django` | Python 3.12+ + Django 5.x + DRF + PostgreSQL | Available | خلفية API (models/serializers/viewsets، SimpleJWT، server-side permissions) — (SCP-2026-09-23-006) |
|
|
55
55
|
|
|
56
|
+
> **دلالة الحالة (PROFILE-DN-F06):** `Available` = **قابل للاستخدام تقنياً** · `Approved` = اعتمده Majed · `Approved — Active` = **مفعّل لمشروع قائم**. **`Available` لا يعني Active للتنفيذ** — على Tera تثبيت الـActive Profile للمشروع في ملفه قبل أي مهمة.
|
|
57
|
+
|
|
56
58
|
## Placeholder Candidates
|
|
57
59
|
|
|
58
60
|
The following stacks may need profiles later, but are not created now:
|