@tera-system/core 0.4.1 → 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 (53) hide show
  1. package/MANIFEST.json +8 -8
  2. package/RELEASES.md +25 -0
  3. package/agents/application-blueprint.md +6 -6
  4. package/agents/auditor.md +19 -2
  5. package/agents/engineering-agent-django.md +216 -0
  6. package/agents/engineering-agent-flutter.md +257 -0
  7. package/agents/engineering-agent-typescript.md +2 -0
  8. package/agents/engineering-agent.md +4 -0
  9. package/agents/qa-agent.md +1 -1
  10. package/agents/tera-client-engagement.md +6 -6
  11. package/agents/tera-system-evolution.md +9 -7
  12. package/agents/tera.md +4 -0
  13. package/commands/tera-approve.md +43 -34
  14. package/commands/tera-diagnose.md +2 -0
  15. package/commands/tera-gate.md +2 -0
  16. package/commands/tera-help.md +3 -0
  17. package/commands/tera-new-project.md +32 -35
  18. package/commands/tera-orient-django.md +12 -0
  19. package/commands/tera-orient-flutter.md +12 -0
  20. package/commands/tera-plan.md +2 -0
  21. package/commands/tera-reconcile.md +35 -0
  22. package/commands/tera-request-build.md +2 -0
  23. package/commands/tera-resume.md +2 -0
  24. package/commands/tera-review.md +2 -0
  25. package/commands/tera-status.md +2 -0
  26. package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +15 -9
  27. package/core/tera-system/AGENT_DEPENDENCY_MAP.md +13 -9
  28. package/core/tera-system/AGENT_GENERATION_TEMPLATE.md +6 -5
  29. package/core/tera-system/AGENT_PERMISSION_MODEL.md +27 -10
  30. package/core/tera-system/TERA_AGENT_CONDUCT.md +17 -0
  31. package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +1 -1
  32. package/core/tera-system/TeraCapabilityMap.md +3 -3
  33. package/core/tera-system/TeraHelperAgents.md +2 -2
  34. package/core/tera-system/TeraPolicyMap.md +4 -2
  35. package/core/tera-system/TeraPreExecutionGate.md +34 -0
  36. package/core/tera-system/TeraPreparationDocumentationGovernance.md +21 -15
  37. package/core/tera-system/TeraSubAgents.md +9 -6
  38. package/core/tera-system/TeraSystemMaintenanceChecklist.md +12 -0
  39. package/core/tera-system/client-helpers/tera-client-engagement-gates.md +2 -2
  40. package/core/tera-system/client-helpers/tera-client-engagement-pricing.md +1 -1
  41. package/core/tera-system/client-helpers/tera-client-engagement-protocols.md +14 -9
  42. package/core/tera-system/engineering-helpers/database-privileges.md +63 -0
  43. package/core/tera-system/engineering-helpers/engineering-agent-core.md +11 -0
  44. package/core/tera-system/profiles/PROFILES_INDEX.md +1 -1
  45. package/core/tera-system/profiles/flutter-mobile.md +1 -0
  46. package/core/tera-system/profiles/python-django.md +222 -0
  47. package/core/tera-system/profiles/rust.md +1 -0
  48. package/core/tera-system/runtime/AGENT_SELF_ORIENTATION_PROTOCOL.md +1 -1
  49. package/core/tera-system/runtime/TERA_COMMAND_PROTOCOL.md +86 -0
  50. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +14 -0
  51. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +2 -2
  52. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +9 -2
  53. package/package.json +2 -2
@@ -0,0 +1,222 @@
1
+ # Python Django Technology Profile
2
+
3
+ ## 1. Purpose
4
+
5
+ This profile provides Python/Django/DRF-specific execution rules for backend API projects in the Tera system.
6
+
7
+ It is a **stack-specific Technology Profile** — loaded only when a project is classified as Backend with Django + Django REST Framework as the chosen stack.
8
+
9
+ ## 2. Identity
10
+
11
+ | Field | Value |
12
+ |---|---|
13
+ | Profile ID | `python-django` |
14
+ | Stack | Python 3.12+ + Django 5.x + Django REST Framework + PostgreSQL |
15
+ | Minimum Python | 3.12+ |
16
+ | Minimum Django | 5.0+ (DRF 3.14+) |
17
+ | Status | Available |
18
+ | Owner | Tera Agent (decision engine) / engineering-agent-django (execution) |
19
+
20
+ ## 3. When to Load This Profile
21
+
22
+ Load `python-django.md` when:
23
+
24
+ - Project classification = **Backend API**
25
+ - Technology stack confirmed as **Django + DRF + PostgreSQL**
26
+ - `project-control/PROJECT_STATE.md` or `project-preparation/08_TECHNICAL_ARCHITECTURE.md` records `Active Technology Profile: python-django`
27
+
28
+ ### Automatic activation triggers
29
+
30
+ | Trigger | Action |
31
+ |---|---|
32
+ | Project type = Backend AND Stack = Django/DRF | Load `python-django.md` as active profile |
33
+ | `PROJECT_STATE.md` sets `python-django` | Load immediately |
34
+ | Pre-Execution Gate detects Django + DRF | Verify profile is loaded; BLOCKED if not |
35
+
36
+ ## 4. Project Structure
37
+
38
+ Standard Django project layout:
39
+
40
+ ```
41
+ config/ # settings, urls, wsgi/asgi
42
+ settings/
43
+ base.py
44
+ development.py
45
+ production.py
46
+ apps/
47
+ {app_name}/
48
+ models.py
49
+ serializers.py
50
+ views.py # viewsets
51
+ urls.py # router registration
52
+ tests/
53
+ test_models.py
54
+ test_api.py
55
+ admin.py
56
+ migrations/
57
+ manage.py
58
+ requirements.txt (or pyproject.toml)
59
+ Dockerfile
60
+ ```
61
+
62
+ ### Rules
63
+
64
+ - One Django app per bounded domain — do not create a single `core` app holding everything.
65
+ - Settings must be split (`base`/`development`/`production`) — never a single `settings.py` with `if DEBUG`.
66
+ - `manage.py` stays at the root — do not move it.
67
+ - Tests live inside each app (`tests/`), never in a detached top-level folder.
68
+
69
+ ## 5. Architecture Guidance (DRF)
70
+
71
+ | Concern | Recommendation |
72
+ |---|---|
73
+ | Views | `ModelViewSet` / `GenericAPIView` + mixins — no fat function views for CRUD |
74
+ | Routing | DRF `DefaultRouter` registered per app `urls.py`, included from `config/urls.py` |
75
+ | Serializers | Explicit `fields` lists — never `fields = "__all__"`; nested writes only with explicit `create()`/`update()` |
76
+ | Validation | Serializer-level first; `validate_<field>` / `validate()`; never trust client payload shape |
77
+ | Filtering/Search/Ordering | `django-filter` `FilterSet` + DRF `SearchFilter` + `OrderingFilter` |
78
+ | Pagination | DRF pagination globally (`PageNumberPagination`, explicit `PAGE_SIZE`); never unbounded list endpoints |
79
+ | API docs | `drf-spectacular` — schema must generate cleanly (`spectacular --validate`) |
80
+ | Background work | Celery / django-q2 only when approved in scope; otherwise synchronous with timeouts |
81
+
82
+ ### Architecture rules
83
+
84
+ - Do not add Repository / Unit-of-Work / CQRS layers by default — Django ORM + serializers are the boundary.
85
+ - Do not expose the Django admin to end users unless explicitly in scope (staff-only, hardened).
86
+ - Every list endpoint must be paginated and every filter must be an explicit `FilterSet` field.
87
+ - `drf-spectacular` schema generation must pass without warnings on changed endpoints.
88
+
89
+ ## 6. Authentication (SimpleJWT)
90
+
91
+ | Item | Rule |
92
+ |---|---|
93
+ | Library | `djangorestframework-simplejwt` |
94
+ | Token pair | Short-lived access + rotating refresh; blacklist on logout (`rest_framework_simplejwt.token_blacklist`) |
95
+ | Storage guidance for clients | HttpOnly cookie or platform secure storage — never `localStorage` for web clients |
96
+ | Rotation | `ROTATE_REFRESH_TOKENS = True`, `BLACKLIST_AFTER_ROTATION = True` |
97
+
98
+ ## 7. Permissions — Server-Side Enforcement (Non-Negotiable)
99
+
100
+ ```text
101
+ لا يُعتمد أي endpoint بصلاحية client-side فقط.
102
+ الفرض دائماً server-side: permission_classes على كل view/viewset.
103
+ ```
104
+
105
+ | Rule | Notes |
106
+ |---|---|
107
+ | Default permission | `IsAuthenticated` globally (`DEFAULT_PERMISSION_CLASSES`); open endpoints only with explicit, documented `AllowAny` + reason |
108
+ | Object-level | `has_object_permission` for any row-scoped access; never filter only in the serializer |
109
+ | Financial / PII / admin actions | Explicit permission class + SecurityAgent review when sensitive (crosses to `tera-system/TeraPreExecutionGate.md` risk rules) |
110
+ | Throttling | DRF throttles on auth + write endpoints (`AnonRateThrottle`, `UserRateThrottle`, scoped rates for login/token) |
111
+
112
+ ## 8. Database (PostgreSQL)
113
+
114
+ | Item | Rule |
115
+ |---|---|
116
+ | Engine | PostgreSQL via `psycopg` — no SQLite in any shared/staging/production environment |
117
+ | Migrations | Review every generated migration + SQL (`sqlmigrate`) before applying; **never apply to shared/staging/production unless the task explicitly authorizes that environment** |
118
+ | Destructive ops | `DropModel` / `RemoveField` / narrowing / data transforms require an explicit, reviewed plan + backup note; `managed = False` tables require an explicit contract (read-only unless stated) |
119
+ | Query shape | `select_related` / `prefetch_related` for FK/M2M reads; bound/paginate; no N+1 in list endpoints |
120
+ | Transactions | `transaction.atomic()` only where multi-write atomicity is required — not a default wrapper |
121
+
122
+ ## 9. Testing
123
+
124
+ | Type | Tool | Notes |
125
+ |---|---|---|
126
+ | Unit / API tests | `pytest` + `pytest-django` | Models, serializers, permissions, endpoints |
127
+ | System check | `python manage.py check` | Must pass with zero errors |
128
+ | Migration check | `python manage.py makemigrations --check --dry-run` | Must report "No changes detected" on a clean tree |
129
+ | Schema check | `spectacular --validate` (via drf-spectacular) | Must pass on changed endpoints |
130
+
131
+ ### Rules
132
+
133
+ - `pytest` must pass with zero failures before handover.
134
+ - Every permission class must have a direct test (allowed / denied / object-level).
135
+ - Every changed endpoint must be tested for: success, validation failure, unauthenticated, forbidden.
136
+ - Do not test Django internals; test project code.
137
+
138
+ ## 10. Environment Verification
139
+
140
+ ```bash
141
+ # Python version
142
+ python --version
143
+
144
+ # Install / sync dependencies
145
+ pip install -r requirements.txt
146
+
147
+ # Django system check (zero errors required)
148
+ python manage.py check
149
+
150
+ # Pending migrations check (clean tree required)
151
+ python manage.py makemigrations --check --dry-run
152
+
153
+ # Run test suite
154
+ python -m pytest
155
+ ```
156
+
157
+ ## 11. Docker / Coolify
158
+
159
+ | Item | Rule |
160
+ |---|---|
161
+ | Image | `python:3.12-slim` base; multi-stage if the project requires compiled deps |
162
+ | Server | `gunicorn` (sync workers) or `uvicorn` (ASGI) — per approved architecture, not both |
163
+ | Static files | `collectstatic` at build; served by the platform/CDN, never by Django in production |
164
+ | Env | All secrets via environment (`django-environ`); no `.env` committed; `DEBUG = False` + explicit `ALLOWED_HOSTS` in production |
165
+
166
+ ## 12. Security (Reference Only)
167
+
168
+ Refer to existing Tera security policies:
169
+
170
+ - `project-preparation/15_SECURITY_AND_ACCESS_CONTROL.md`
171
+ - `tera-system/TeraPreExecutionGate.md` (secret handling rules)
172
+ - `project-preparation/PROJECT_RULES.md`
173
+
174
+ Django-specific security notes:
175
+
176
+ - Never hard-code `SECRET_KEY`, DB credentials, or API keys — env only (Semgrep `tera-no-hardcoded-secrets` python rules apply).
177
+ - `DEBUG = False` + `ALLOWED_HOSTS` set in any non-local environment.
178
+ - `SECURE_SSL_REDIRECT`, `SESSION_COOKIE_SECURE`, `CSRF_COOKIE_SECURE` in production.
179
+ - CORS: explicit allowlist (`django-cors-headers`) — never `CORS_ALLOW_ALL_ORIGINS = True` in production.
180
+ - Validate `X-Forwarded-*` only behind a trusted proxy.
181
+
182
+ ## 13. QA / Acceptance (Reference Only)
183
+
184
+ Refer to:
185
+
186
+ - `project-preparation/10_TESTING_AND_ACCEPTANCE.md`
187
+ - `tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md`
188
+
189
+ Django QA rules:
190
+
191
+ - Endpoint matrix per changed endpoint: success / validation failure / unauthenticated (401) / forbidden (403).
192
+ - Contract stability: `drf-spectacular` diff reviewed for breaking changes.
193
+ - Migration safety: `sqlmigrate` reviewed; destructive ops only with explicit authorization.
194
+ - Permission tests: direct allow/deny/object-level coverage.
195
+
196
+ ## 14. Known Django Limits (Document These)
197
+
198
+ | Limit | Notes |
199
+ |---|---|
200
+ | **Sync ORM in async views** | Use `sync_to_async` / async ORM carefully; do not mix casually |
201
+ | **Realtime** | Channels/WebSockets only when in scope; otherwise poll or document as deferred |
202
+ | **Heavy background** | Celery/queue only when approved; default to synchronous with timeouts |
203
+ | **managed = False** | Read-only unless an explicit contract says otherwise; schema changes need DBA coordination |
204
+
205
+ ## 15. References
206
+
207
+ | Topic | Source |
208
+ |---|---|
209
+ | Django docs | https://docs.djangoproject.com |
210
+ | DRF docs | https://www.django-rest-framework.org |
211
+ | SimpleJWT | https://django-rest-framework-simplejwt.readthedocs.io |
212
+ | django-filter | https://django-filter.readthedocs.io |
213
+ | drf-spectacular | https://drf-spectacular.readthedocs.io |
214
+ | Tera Pre-Execution Gate | `tera-system/TeraPreExecutionGate.md` |
215
+ | Tera QA/Acceptance | `tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md` |
216
+
217
+ ## 16. Profile Version
218
+
219
+ - **Current Profile Version:** 1.0.0
220
+ - **Created:** 2026-09-23 — SCP-2026-09-23-006 (prerequisite for `engineering-agent-django`)
221
+ - **Maintainer:** TeraSystemEvolutionAgent (حارس)
222
+ - **Django Baseline:** 5.x + DRF 3.14+ · **Python Baseline:** 3.12+ · **DB:** PostgreSQL
@@ -70,6 +70,7 @@
70
70
  - **Parameterized queries إلزامي** — ممنوع string interpolation في SQL (SQL injection — OWASP).
71
71
  - `PgPool`: max_connections محدود (أقل من max Postgres ÷ عدد النسخ) + `acquire_timeout` + `idle_timeout` — لا إعدادات افتراضية.
72
72
  - Diesel/SeaORM: عند الحاجة — migrations عبر أدواتها الخاصة (`diesel_cli` / `sea-orm-cli`).
73
+ - **Schema-Head / Migration Pins (SCP-2026-09-24-005):** عند إضافة migration يغيّر رقم/رأس الـSchema، نفّذ **جرداً شاملاً** لكل مواضع التثبيت المحتملة (MIGRATION_HEAD · EXPECTED_HEAD · migration count · startup guards · fixtures · error messages · test names) **قبل التفويض التالي** — راجع `TeraPreExecutionGate §5.1 (ج)`.
73
74
 
74
75
  ## 7. CLI Side Effects
75
76
 
@@ -31,7 +31,7 @@
31
31
  - ما مصادر الحقيقة الخاصة بي؟
32
32
 
33
33
  5. **تأكد من فهم العلاقات:**
34
- - لا تفعّل أي عميل ولا تطلب تفعيلك ذاتياً (مالك التفعيل محدد في `TERA_RUNTIME_PROTOCOLS_CORE.md` §1).
34
+ - لا تفعّل أي عميل ولا تطلب تفعيلك ذاتياً (مالك التفعيل محدد في `AGENT_ACTIVATION_MATRIX.md` «القاعدة الحاكمة» وفي `TeraSubAgents.md` §1).
35
35
  - اعرف من يستدعيك (المالك / TeraAgent / عميل آخر) ومتى.
36
36
 
37
37
  ## إقرار الجاهزية (READINESS DECLARATION)
@@ -0,0 +1,86 @@
1
+ # TERA_COMMAND_PROTOCOL.md — بروتوكول طبقة الأوامر السريعة
2
+
3
+ > **المصدر:** SCP-2026-09-24-002 (معالجة Review 02 — Runtime/Orchestration).
4
+ > كل أمر في `.opencode/commands/` **يلتزم** بهذا الملف. الأوامر طبقة دخول — لا تتجاوز Runtime Core.
5
+
6
+ ---
7
+
8
+ ## 1. Workspace Resolution Gate (إلزامي قبل أي قراءة/كتابة)
9
+
10
+ كل أمر يحدّد المسارات أولاً — لا يستخدم مساراً نسبياً غامضاً:
11
+
12
+ ```text
13
+ ActiveAppPath = مسار التطبيق النشط
14
+ ProjectControlPath = <ActiveAppPath>/project-control/
15
+ ProjectPreparationPath = <ActiveAppPath>/project-preparation/
16
+ ```
17
+
18
+ **مصدر `ActiveAppPath` (بالترتيب):**
19
+ 1. `project-control/SYSTEM_ACTIVE_CONTEXT.md` الجذري إن وُجد (حقل `ActiveAppPath`).
20
+ 2. سياق الجلسة/الطلب الصريح من Majed.
21
+ 3. إن لم يتضح → **توقف واسأل**: "أي تطبيق/مشروع؟" — لا تفترض.
22
+
23
+ **قواعد:**
24
+ - لمشروع تطبيق/عميل: اقرأ/اكتب تحت `<ActiveAppPath>/project-control/` — **لا** الجذر.
25
+ - ملفات الجذر `project-control/` = **System Templates فقط** (وفق `tera.md` Tier 1).
26
+ - لا تعتمد على أن الجذر يحتوي `TASK_REGISTRY.md`/`PROJECT_ACTIVITY_LOG.md` — هذه خاصة بكل تطبيق.
27
+ - إن اختلف `HostRepoPath` (مستودع كود خارجي) عن مسار المنظومة → صرّح به منفصلاً.
28
+
29
+ ---
30
+
31
+ ## 2. Quick Command Principles
32
+
33
+ - الأوامر **تُشغّل** الـRuntime القائم؛ لا تعرّفه من جديد ولا تتجاوزه.
34
+ - لا تنفيذ بلا موافقة صريحة (Plan ≠ Build).
35
+ - لا تفترض حالةً غير موجودة في السجلات الرسمية؛ إن غابت → أخبر المالك.
36
+
37
+ ---
38
+
39
+ ## 3. Closure Prerequisites (إلزامي قبل `Accepted`/`Closed`)
40
+
41
+ لا يُغلق أي TASK إلا بعد استيفاء **كل** ما يلي (بالترتيب):
42
+
43
+ | # | الشرط | المرجع |
44
+ |---|---|---|
45
+ | 1 | Handback مسجّل في ملف المهمة | Task file |
46
+ | 2 | `Post-Execution Review` = PASS | `TeraPreExecutionGate.md` §6.2 |
47
+ | 3 | `Compliance Record` = COMPLIANT | Task file |
48
+ | 4 | `Owner Approval Required`: إن Yes → اعتماد صريح مسجّل | Owner Approval Gate |
49
+ | 5 | قرارات QA / Auditor / Security المطلوبة مسجّلة | §6.2 Independent Review |
50
+ | 6 | Cross-Record Consistency: لا تعارض بين Task/REGISTRY/PROJECT_STATE/DECISIONS/ACTIVITY/AUDIT_TRAIL | CORE §4.0.1 |
51
+
52
+ **أي شرط فاشل → لا إغلاق.** أبلغ بالسبب المحدد وانتظر قرار Majed.
53
+ > `/tera-approve` يسجّل **نية المالك**؛ ولا يتجاوز أبداً الشروط التقنية أعلاه.
54
+
55
+ ---
56
+
57
+ ## 4. Closure Transaction & Reconciliation (منع Partial/Split State)
58
+
59
+ الإغلاق = **معاملة واحدة قابلة للتحقق**، لا writes متفرقة:
60
+
61
+ ```text
62
+ 1. حدّد كل السجلات المستهدفة (Task file, TASK_REGISTRY, PROJECT_STATE,
63
+ PROJECT_ACTIVITY_LOG, DECISIONS_LOG, TERA_AUDIT_TRAIL, ISSUES_AND_GAPS عند الحاجة).
64
+ 2. احسب الحالة النهائية المطلوبة في كلٍّ منها.
65
+ 3. طبّقها كلها.
66
+ 4. أعد قراءتها وتأكد من التطابق (reconcile).
67
+ 5. إن تعذّر الإكمال → لا تُعلن Closed؛ أبلغ بحالة جزئية + ما تبقّى، واقترح الإصلاح.
68
+ ```
69
+
70
+ - أمر **`/tera-reconcile`** يفحص الاتساق ويصدر `CONSISTENT` أو `DRIFT_FOUND`.
71
+ - لا `Closed` مع أي سجل غير متزامن.
72
+
73
+ ---
74
+
75
+ ## 5. Command Conformance Gate
76
+
77
+ أي تغيير نظامي يمس: **phase ownership · task lifecycle · approval · path rules · state records · role boundaries**
78
+ → ضمن الـSCP، يجب فحص `.opencode/commands/*.md` المتأثرة وتحديثها في نفس الدفعة.
79
+ (يمتد هذا إلى فحص `scripts/validate-governance.mjs` حيث ينطبق.)
80
+
81
+ ---
82
+
83
+ ## 6. Path Semantics (توضيح)
84
+
85
+ - المسارات في الأوامر **مُحلّة** عبر §1 — لا تُقرأ حرفياً من الجذر.
86
+ - `project-control/…` في أي أمر = `<ProjectControlPath>/…` بعد الحل.
@@ -333,6 +333,20 @@ No task may become `Accepted` or `Closed` without:
333
333
 
334
334
  Use `TERA_RUNTIME_TEMPLATES_DELIVERY.md` Section 33 for the official template format.
335
335
 
336
+ ### 4.0.2 Staleness Sweep (SCP-2026-09-24-005)
337
+
338
+ At each project boundary — **Task Accepted · Phase boundary · Batch closure · Session handoff** — run a consistency sweep over the state files **that actually exist in this project** (لا تفترض مجموعة ثابتة):
339
+
340
+ ```text
341
+ Master Plan · Detailed Plan · Batch Plan · PROJECT_STATE · TASK_REGISTRY ·
342
+ TERA_ACTIVE_CONTEXT · PROJECT_ACTIVITY_LOG · TERA_AUDIT_TRAIL
343
+ ```
344
+
345
+ - الغرض: كشف الخطط المتقادمة، وضَياع Paired-Records، وتعارض الحالة **قبل** التفويض التالي.
346
+ - تكيّف مع ملفات المشروع الفعلية (داخلي/عميل، موجود/غائب). ملف غائب = `N/A` لا فشل.
347
+ - قراءة فقط افتراضياً؛ أي تصحيح = تغيير حوكمي عادي (Allowed Write Targets + مراجعة).
348
+ - يقرن مع Paired Records: حدّث `TERA_AUDIT_TRAIL` و`PROJECT_ACTIVITY_LOG` **معاً**.
349
+
336
350
  ### 4.1 Roadmap and Detailed Plan Tracking
337
351
 
338
352
  For medium and large projects, the following files are mandatory operational references:
@@ -124,7 +124,7 @@
124
124
  ### 4.1 Maker / Checker Model
125
125
 
126
126
  - **Maker:** عميل تحضير متخصص يكتب الملف.
127
- - **Checker:** عميل تحضير مختلف يراجع الاتساق.
127
+ - **Checker:** عميل تحضير **مختلف** يراجع الاتساق (Checker ≠ Maker) — الافتراضي: `auditor` في وضع `Preparation-Review` (كل دفعة، قراءة فقط — SCP-2026-09-24-006).
128
128
  - **Orchestrator:** مُهندس يخطط ويدير lifecycle.
129
129
 
130
130
  ### 4.2 Document States
@@ -136,7 +136,7 @@ Draft → Under Cross-Review → Module Baseline Approved → System Pending Int
136
136
  ### 4.3 Cross-Review Rules
137
137
 
138
138
  1. كل ملف تحضيري يمر بـ Cross-Review قبل `Module Baseline Approved`.
139
- 2. الـ Checker يجب أن يكون مختلفاً عن الـ Maker.
139
+ 2. الـ Checker يجب أن يكون مختلفاً عن الـ Maker. إن تعذّر → التصنيف `SELF_REVIEW` صراحةً (لا "Cross-Review") + تنازل مالك للمشاريع Tiny/Low-risk (راجع Governance §4.2/§9 — SCP-2026-09-24-004).
140
140
  3. الـ Checker يراجع: اتساق مع upstream، اكتمال، حالات الحافة، التبعيات.
141
141
  4. Issues → يعاد الملف إلى Draft مع توثيق findings.
142
142
  5. موافقة Checker → مُهندس يرفع الحالة.
@@ -386,8 +386,15 @@ Approval status: Pending / Approved
386
386
  | 11 | No unresolved High/Critical item | PASS / FAIL | |
387
387
  | 12 | No Low Confidence section | PASS / FAIL | |
388
388
  | 13 | No Pending Approval blocking Phase 5 | PASS / FAIL | |
389
- | 14 | Technology Profile confirmed | PASS / FAIL | |
390
- | 15 | Recommended implementation sequence exists | PASS / FAIL | |
389
+ | 14 | Technology Profile: `CONFIRMED` **أو** `EXPLICITLY_DEFERRED_TO_ENGINEERING_INTAKE` مع قرار حاجب مسجّل | PASS / FAIL | |
390
+ | 15 | Review Evidence مفصول: Self-Review / Independent Review / Cross-Document Reconciliation — كلٌّ بنتيجته (SCP-2026-09-24-004) | PASS / FAIL | |
391
+ | 16 | Recommended implementation sequence exists | PASS / FAIL | |
392
+
393
+ ## Review Evidence (مفصول — SCP-2026-09-24-004)
394
+ - Review Type: `SELF_REVIEW` / `INDEPENDENT_REVIEW` / `MIXED`
395
+ - Self Verification: PASS / FAIL
396
+ - Independent Preparation Review: PASS / NOT_REQUIRED / WAIVED (reason)
397
+ - Cross-Document Reconciliation: PASS / FAIL
391
398
 
392
399
  ## Gate Result
393
400
  **PASS / REVISION_REQUIRED / BLOCKED**
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@tera-system/core",
3
- "version": "0.4.1",
4
- "description": "Tera System OpenCode Plugin — governance core, 23 agents, 35 commands, distribution tools (personal edition)",
3
+ "version": "0.6.0",
4
+ "description": "Tera System OpenCode Plugin — governance core, 25 agents, 38 commands, distribution tools (personal edition)",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "type": "module",
7
7
  "engines": {