@tera-system/core 0.2.9 → 0.2.11

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.
@@ -236,9 +236,9 @@
236
236
  | tera-software-designer (SoftwareDesignerAgent) | `SOFTWARE_DESIGNER_AGENT` | `WRITE_DOCS` | إلى `PLAN_ONLY` إذا ما زالت الخطة غير ناضجة | يجهز Technical Specification للمهام فقط |
237
237
  | QualityReviewCoordinatorAgent | `QUALITY_REVIEW_COORDINATOR_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم تقرير فقط | ينسق المراجعة فقط |
238
238
  | PlanComplianceReviewAgent | `PLAN_COMPLIANCE_REVIEW_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التقرير فقط | يراجع توافق الخطة فقط |
239
- | DomainResearchAgent | `DOMAIN_RESEARCH_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التقرير | يبحث فقط |
240
- | DomainExpertAgent | `DOMAIN_EXPERT_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التحليل | يحلل فقط |
241
- | ProductionERPExpert | `PRODUCTION_ERP_EXPERT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم تحليل أو أسئلة أو مراجعة Blueprint ضمن Allowed Write Targets | مستشار Production ERP؛ لا يكتب كوداً ولا يقرر النطاق أو التكلفة النهائية |
239
+ | DomainResearchAgent | `DOMAIN_RESEARCH_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التقرير + حفظ DRAFT في `../Teranoo-Research/{domain}/` عند Score≥3 (SCP-2026-08-31-001) | يبحث فقط + يقرأ `../Teranoo-Research/00_INDEX.md` (Reuse-First) |
240
+ | DomainExpertAgent | `DOMAIN_EXPERT_AGENT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم التحليل | يحلل فقط + يقرأ `../Teranoo-Research/00_INDEX.md` عند الحاجة |
241
+ | ProductionERPExpert | `PRODUCTION_ERP_EXPERT` | `READ_ONLY` | إلى `WRITE_DOCS` عند تسليم تحليل أو أسئلة أو مراجعة Blueprint ضمن Allowed Write Targets | مستشار Production ERP؛ لا يكتب كوداً ولا يقرر النطاق أو التكلفة النهائية — يقرأ `../Teranoo-Research/00_INDEX.md` عند الحاجة |
242
242
 
243
243
  ### 3.3 عملاء التعامل مع العملاء الخارجيين
244
244
 
@@ -333,6 +333,16 @@ EngineeringAgent يُستخدم لمراجعة كود فقط → يخفض إلى
333
333
  يمكن رفعه إلى `WRITE_DOCS` فقط لتسليم التقرير.
334
334
  ```
335
335
 
336
+ ### 5.6 صلاحية المكتبة البحثية (SCP-2026-08-31-001)
337
+
338
+ ```
339
+ المسار `../Teranoo-Research/**` (خارج Teranoo-System):
340
+ - القراءة: مسموحة لـ DomainResearchAgent / DomainExpertAgent / ProductionERPExpert (Reuse-First)
341
+ - الكتابة: مسموحة فقط لـ DomainResearchAgent لحفظ DRAFT عند Score≥3 في `../Teranoo-Research/{domain}/`
342
+ - الترقية DRAFT→READY: بيد Majed فقط (تعديل 00_INDEX.md)
343
+ - لا يُوزع للزبائن — مستثنى من core-bundle
344
+ ```
345
+
336
346
  ---
337
347
 
338
348
  ## 6. الملخص — قاعدة الصلاحية الذهبية
@@ -59,7 +59,28 @@ Release Package (ملفات Tera-managed + SHA256SUMS + TERA_RELEASE_MANIFEST.js
59
59
  | التثبيت | كل عميل يُثبَّت على Tag محدد بوعي؛ عميل يبقى على `tera-v2.0.0` وآخر ينتقل لـ `tera-v2.5.0` |
60
60
  | المنع المطلق | **لا تتبع تلقائي لـ `main` أو `develop` في أي مستودع عميل** |
61
61
 
62
- ### 2.2 Lockfile — `.tera/lock.json`
62
+ ### 2.2 الحزم الرسمية (npm) — المصدر الموثوق للحزم
63
+
64
+ | الحزمة | الاسم (npm) | الإصدار الحالي | الوصف | الملفات الموزعة ضمن الحزمة |
65
+ |---|---|---|---|---|
66
+ | core | `@tera-system/core` | 0.2.10 | OpenCode Plugin — core governance (20 agents, 11 commands, distribution tools) | `agents/`, `commands/`, `core/`, `assets/`, `tools/`, `scripts/` |
67
+ | pro | `@tera-system/pro` | 0.2.14 | Commercial edition — signed bundle + license gate + heartbeat | `scripts/`, `core/project-control`, `MANIFEST.json`, `opencode.tera.example.json`, `WELCOME.md`, `README.md` |
68
+
69
+ **المستودع الرسمي:** `https://github.com/Alabasi1980/Teranoo-System` — هو `RepositoryUrl` الوحيد المعتمد لـ `tera-fetch.ps1` و `tera-schedule.ps1`
70
+ **Tags:** `tera-vX.Y.Z` — الـ Lockfile يحفظ `Commit SHA` كحقيقة، والقنوات `stable`/`beta`
71
+ > **قاعدة الحزم:** أي تعديل على ملفات `Tera-managed` (`.opencode/`, `tera-system/`, `tera-workshop/tools`) يتطلب Tag جديد + bundle + `npm publish` (core/pro) — وإلا يبقى الزبائن على النسخة القديمة. تعديلات `Teranoo-Research/` أو `project-control/` أو `clients/` لا تتطلب bump.
72
+
73
+ ### 2.3 موقع المنظومة ومنصة النشر (TeraWebsite + Coolify) — SCP-2026-08-31-003
74
+
75
+ | البند | القيمة |
76
+ |---|---|
77
+ | مستودع الموقع | `https://github.com/Alabasi1980/TeraWebsite` (خاص — أول عميل إنتاجي، `book/20_DISTRIBUTION.md` §20.6) |
78
+ | الدومين | `https://teranoo.com` — يقدّم `GET /api/tera-system/bundle` (الحزمة الموقعة) + `POST /api/license/*` (verify/activate) |
79
+ | منصة النشر | `https://coolify.teranoo.com/` — لوحة تحكم نشر/تحديث الموقع (Coolify) — وصول للتعديل والنشر |
80
+ | دور الموقع | 1) ترويج وشرح المنظومة 2) مساعد إصدار الحزم (استضافة bundle + واجهة ترخيص) |
81
+ | العلاقة بالحزم | `tera-sync` و `tera-license` تتصل بـ `teranoo.com` افتراضياً — أي bundle جديد يُنشر على الموقع عبر Coolify ثم يُسحب عبر `tera-sync` |
82
+
83
+ ### 2.4 Lockfile — `.tera/lock.json`
63
84
 
64
85
  في جذر كل مستودع عميل:
65
86
 
@@ -122,13 +143,13 @@ Release Package (ملفات Tera-managed + SHA256SUMS + TERA_RELEASE_MANIFEST.js
122
143
 
123
144
  ```powershell
124
145
  # عرض الإصدارات المتاحة في المستودع الأصلي
125
- pwsh .\tools\tera-fetch.ps1 -RepositoryUrl "https://github.com/Alabasi1980/TeraSystem" -List
146
+ pwsh .\tools\tera-fetch.ps1 -RepositoryUrl "https://github.com/Alabasi1980/Teranoo-System" -List
126
147
 
127
148
  # فحص: هل يوجد إصدار أحدث من المثبت حالياً؟ (قراءة فقط — لا يعدّل شيئاً)
128
- pwsh .\tools\tera-fetch.ps1 -RepositoryUrl "https://github.com/Alabasi1980/TeraSystem" -Check -RepoPath "D:\My Projects\TeraWebsite"
149
+ pwsh .\tools\tera-fetch.ps1 -RepositoryUrl "https://github.com/Alabasi1980/Teranoo-System" -Check -RepoPath "D:\My Projects\TeraWebsite"
129
150
 
130
151
  # بناء حزمة إصدار موثقة من المستودع الأصلي
131
- pwsh .\tools\tera-fetch.ps1 -RepositoryUrl "https://github.com/Alabasi1980/TeraSystem" -Version tera-v2.5.0 -Channel stable -OutPath "C:\TeraReleases\tera-v2.5.0"
152
+ pwsh .\tools\tera-fetch.ps1 -RepositoryUrl "https://github.com/Alabasi1980/Teranoo-System" -Version tera-v2.5.0 -Channel stable -OutPath "C:\TeraReleases\tera-v2.5.0"
132
153
  ```
133
154
 
134
155
  **وضع Check:** يقارن الإصدار المثبت في `lock.json` بأحدث إصدار في الأصل، ويخبرك بما يلي:
@@ -145,7 +166,7 @@ pwsh .\tools\tera-fetch.ps1 -RepositoryUrl "https://github.com/Alabasi1980/TeraS
145
166
  ```powershell
146
167
  # تسجيل مهمة Windows Task Scheduler (عند تسجيل الدخول + كل 6 ساعات)
147
168
  pwsh .\tools\tera-schedule.ps1 `
148
- -RepositoryUrl "https://github.com/Alabasi1980/TeraSystem.git" `
169
+ -RepositoryUrl "https://github.com/Alabasi1980/Teranoo-System.git" `
149
170
  -RepoPath "D:\My Projects\TeraWebsite"
150
171
 
151
172
  # إزالة المهمة
@@ -176,6 +176,28 @@ docker run -d --rm -p 8081:8080 -v "%CD%\architecture:/usr/local/structurizr" st
176
176
 
177
177
  ---
178
178
 
179
+ ### 3.6 المعيار الخماسي والتزويد (SCP-2026-08-29-012)
180
+
181
+ | الأداة | الشكل | ضمان التوفر |
182
+ |---|---|---|
183
+ | **Playwright** | MCP (`npx @playwright/mcp`) | يُفعَّل تلقائياً في `opencode.json` — المتصفحات: `npx playwright install chromium` |
184
+ | **Semgrep** | MCP + CLI | `pip install semgrep` — قواعد Tera في `tera-system/semgrep-rules/` |
185
+ | **Structurizr** | MCP (uv + Docker) | `structurizr-mcp/` يُشحن مع الحزمة — يتطلب uv + Docker (بدونه: قراءة/كتابة DSL فقط) |
186
+ | **Gitleaks** | CLI | `winget install Gitleaks.Gitleaks` |
187
+ | **Trivy** | CLI | `winget install AquaSecurity.Trivy` |
188
+
189
+ **التزويد — في أي مستودع، قبل بدء العمل:**
190
+ ```powershell
191
+ powershell -ExecutionPolicy Bypass -File .\tools\tera-tooling.ps1 -Install
192
+ ```
193
+
194
+ **القواعد:**
195
+ 1. لا يُقبل `SKIPPED (tool not installed)` بعد التزويد إلا بسبب موثق في handback (نقص إنترنت/صلاحيات).
196
+ 2. بعد تثبيت winget: أعد فتح الشل (PATH) — وDocker يتطلب إعادة تشغيل الجهاز.
197
+ 3. غياب Docker لا يعطل structurizr كلياً — القراءة/الكتابة تعمل، والتصدير/التحقق يتوقفان فقط.
198
+
199
+ ---
200
+
179
201
  ## 4. MCPs المؤجلة (ليست الآن)
180
202
 
181
203
  | الأداة | السبب | وقت التفعيل المقترح |
@@ -25,7 +25,7 @@ It is a map, not a policy source. Rules remain in the files listed in `TeraPolic
25
25
  | Sub-agent lifecycle | Defines, generates, narrows, activates, and reviews specialized agents | `TeraSubAgents.md`, `AGENT_GENERATION_TEMPLATE.md`, `generated-agents/` |
26
26
  | Delivery, handoff, and closure | Produces final delivery readiness, release notes, client handover material, acceptance records, and closure reports | `project-control/DELIVERY_READINESS_REPORT.md`, `project-control/PROJECT_CLOSURE_REPORT.md`, `clients/.../delivery/` |
27
27
  | Project implementation knowledge | Maintains concise current-state operational knowledge per screen/module/service | `project-knowledge/` داخل كل تطبيق |
28
- | Tera distribution and versioning | Builds releases and distributes Tera to client repositories in a versioned, verifiable way; clients derive updates from the origin repository (RepositoryUrl) via fetch + verified release packages (Tag + Manifest + SHA lockfile + updater tools); ownership contract separates Tera-managed from client-owned files | `tera-system/TERA_DISTRIBUTION_POLICY.md`, `tera-workshop/tools/tera-fetch.ps1`, `tera-workshop/tools/tera-release.ps1`, `tera-workshop/tools/tera-update.ps1`, `.tera/lock.json` داخل مستودعات العملاء |
28
+ | Tera distribution and versioning | Builds releases and distributes Tera to client repositories in a versioned, verifiable way; clients derive updates from the origin repository (`https://github.com/Alabasi1980/Teranoo-System`) via fetch + verified release packages (Tag `tera-vX.Y.Z` + Manifest + SHA lockfile + updater tools); npm packages `@tera-system/core 0.2.10` + `@tera-system/pro 0.2.14`; website `https://github.com/Alabasi1980/TeraWebsite` hosts bundle at `https://teranoo.com` and is deployed via `https://coolify.teranoo.com/`; ownership contract separates Tera-managed from client-owned files | `tera-system/TERA_DISTRIBUTION_POLICY.md` (§2.2 الحزم + §2.3 الموقع + §2.0 الأصالة), `tera-workshop/tools/tera-fetch.ps1`, `tera-workshop/tools/tera-release.ps1`, `tera-workshop/tools/tera-update.ps1`, `.tera/lock.json` داخل مستودعات العملاء |
29
29
 
30
30
  ## 3. Folder Roles
31
31
 
@@ -45,6 +45,7 @@ It is a map, not a policy source. Rules remain in the files listed in `TeraPolic
45
45
  | `tera-workshop/` | System development and tooling files | Core policy or project files |
46
46
  | `tera-workshop/tools/` | Official Tera updater tooling (tera-update.ps1 + batch updater) used to pin/upgrade Tera in client repositories | Client application code; replacing client-owned files |
47
47
  | `book/` | Comprehensive user-facing documentation and guides (Quick Start, Vision, Quality, Policies) | Runtime operational files; per-project records |
48
+ | `book-pro-user-guide/` | دليل المشتري العملي لـ Pro — من التثبيت إلى التسليم (Onboarding) — 13 فصل + مولد HTML | Runtime operational files; per-project records |
48
49
  | `architecture/` | Structurizr C4 workspace (`.dsl` source of truth + exported diagrams) | Application code; client project files |
49
50
 
50
51
  ## 4. Core Flow
@@ -57,6 +57,7 @@ Project files record project-specific decisions.
57
57
  | 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
58
  | 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. |
59
59
  | Domain Intelligence protocol | `tera-system/runtime/DOMAIN_INTELLIGENCE_PROTOCOL.md` | `TERA_RUNTIME_PROTOCOLS_CLIENT.md` (Section 12 → reference) | Extracted from §12 of Runtime Protocols; covers research, No-Guessing Rule, Source Policy. |
60
+ | Reusable Research Library | `Teranoo-Research/00_INDEX.md` (الفهرس — مصدر الحقيقة) + `tera-system/runtime/DOMAIN_INTELLIGENCE_PROTOCOL.md` §10 (السلوك) | `.opencode/agents/domain-research-agent.md` §6.2 / §7 + `tera-system/AGENT_PERMISSION_MODEL.md` §5.6 | مكتبة بحوث مركزية مستقلة (Private Repo خارج Teranoo-System) — Reuse-First + تقييم Score≥3 → DRAFT → ترقية بيد Majed لـ READY. مستثناة من core-bundle. SCP-2026-08-31-001. |
60
61
  | Runtime templates | `tera-system/runtime/TERA_RUNTIME_TEMPLATES.md` | Not applicable | Formal output formats only. |
61
62
  | Runtime checklists | `tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md` | `.opencode/agents/tera.md` | Checklists stay outside runtime. |
62
63
  | MVP classification | `tera-system/runtime/MVP_DEFINITION_PROTOCOL.md` | `.opencode/agents/tera.md` | Runtime references when to load it. |
@@ -104,10 +105,11 @@ Project files record project-specific decisions.
104
105
  | 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. |
105
106
  | BTCA — Methodology Framework | `tera-system/consulting-helpers/BTCA_METHODOLOGY_FRAMEWORK.md` | `.opencode/agents/tera-business-transformation-consultant.md` | إطار المنهجية: تصنيف الأدلة الخماسي، مراحل العمل، دليل المقابلات، هيكل التقرير النهائي. |
106
107
  | BTCA — Report Templates | `tera-system/consulting-helpers/BTCA_REPORT_TEMPLATES.md` | `.opencode/agents/tera-business-transformation-consultant.md` | قوالب التقارير العشرة الأساسية + التقرير التنفيذي. |
107
- | Tera distribution (versioned) | `tera-system/TERA_DISTRIBUTION_POLICY.md` | `.tera/lock.json` في مستودعات العملاء | توزيع Tera المُروّس على مستودعات العملاء: استمداد من المستودع الأصلي (`tera-fetch.ps1` + RepositoryUrl)، إصدارات (Tag+SHA)، عقد ملكية، أدوات `tera-workshop/tools/`. SCP-2026-08-15-009. |
108
+ | 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`** + الحزم `@tera-system/core 0.2.10` / `@tera-system/pro 0.2.14` + **الموقع `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. |
108
109
  | 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. |
109
110
  | 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. |
110
- | Payment/Receipt vouchers | `tera-workshop/client-templates/financial/VOUCHER_DESIGN_SPEC.md` + `tera-system/TeraPricingPolicy.md` (§21) | `VOUCHER_RECEIPT_TEMPLATE.html` + `VOUCHER_PAYMENT_TEMPLATE.html` | سند قبض + سند صرف مستقلان (210×156مم، سند واحد في كل ملف، صورة الترويسة كاملة بعرض 210مم وارتفاعها الطبيعي) — `V2.png` للقبض و`V1.png` للصرف — ترقيم مالي مستقل `{السنة}-{تسلسل}` + حقل مرجع يربط بترميز خطابات العميل. SCP-2026-08-29-006/007/008/009/010/011. |
111
+ | Payment/Receipt vouchers | `tera-workshop/client-templates/financial/VOUCHER_DESIGN_SPEC.md` + `tera-system/TeraPricingPolicy.md` (§21) | `VOUCHER_RECEIPT_TEMPLATE.html` + `VOUCHER_PAYMENT_TEMPLATE.html` | سند قبض + سند صرف مستقلان (210×156مم، سند واحد في كل ملف، صورة الترويسة كاملة بعرض 210مم وارتفاعها الطبيعي) — `V2.png` للقبض و`V1.png` للصرف — ترقيم مالي مستقل `{السنة}-{تسلسل}` + حقل مرجع يربط بترميز خطابات العميل. SCP-2026-08-29-006/007/008/009/010/011. |
112
+ | Pro User Guide (Onboarding) | `book-pro-user-guide/` (13 فصل + فهرس + مولد HTML) | `WELCOME.md` في الحزم (ملخص) | دليل المشتري العملي لـ `@tera-system/pro` — من `npm install` إلى التسليم. مكمل لـ `book/` الداخلي. لغة عربية + مصطلحات إنجليزية. SCP-2026-08-30-003. |
111
113
 
112
114
  ## 4. Duplication Policy
113
115
 
@@ -17,6 +17,7 @@ Check:
17
17
  - Will this affect `.opencode/agents/tera.md` runtime behavior?
18
18
  - Will agent roles or relationships documented in `book/` change? If yes, plan a `book/` sync pass in the same batch (SCP-2026-08-28-002).
19
19
  - Does this require updating `TeraPolicyMap.md` or `TeraArchitectureMap.md`?
20
+ - Does this change touch Tera-managed distributed files (`.opencode/`, `tera-system/`, `tera-workshop/tools`)? If yes → plan package bump: new Tag `tera-vX.Y.Z` + bundle + `npm publish` for `@tera-system/core` / `@tera-system/pro` (see `TERA_DISTRIBUTION_POLICY.md` §2.2). If only `Teranoo-Research/` or `project-control/` → no bump needed.
20
21
 
21
22
  ## 3. During Editing
22
23
 
@@ -47,6 +48,13 @@ Sync `.opencode/agents/tera.md` only if the change affects:
47
48
 
48
49
  If synced, update `Last Synced` in `.opencode/agents/tera.md`.
49
50
 
51
+ ## 4.1 Package Version Bump Check (SCP-2026-08-31-002)
52
+
53
+ Check if package bump is needed (see `TERA_DISTRIBUTION_POLICY.md` §2.2):
54
+
55
+ - **Needs bump:** any change to Tera-managed distributed files (`.opencode/`, `tera-system/`, `tera-workshop/tools`) → plan Tag `tera-vX.Y.Z` + bundle + `npm publish` (`@tera-system/core` / `@tera-system/pro`) — batch multiple changes into one release when possible.
56
+ - **No bump:** changes only to `Teranoo-Research/`, `project-control/` (logs), `clients/`, `project-preparation/`, `book/` (if not in `files` list) → no publish needed.
57
+
50
58
  ## 5. Anti-Bloat Check
51
59
 
52
60
  Before finishing, verify:
@@ -121,4 +121,46 @@ Every research-backed recommendation must include:
121
121
 
122
122
  ---
123
123
 
124
+ ---
125
+
126
+ ## 10. Reusable Research Library Protocol — بروتوكول المكتبة البحثية القابلة لإعادة الاستخدام (SCP-2026-08-31-001)
127
+
128
+ **المستودع:** `Teranoo-Research` (Private — خارج `Teranoo-System`، مستثنى من حزمة التوزيع)
129
+ **الفهرس:** `Teranoo-Research/00_INDEX.md` — مصدر الحقيقة الوحيد
130
+ **القالب:** `Teranoo-Research/_templates/RESEARCH_ENTRY_TEMPLATE.md`
131
+
132
+ ### 10.1 Reuse-First Rule
133
+
134
+ ```text
135
+ قبل أي websearch، يجب على DomainResearchAgent فحص الفهرس أولاً.
136
+ إذا وجد بحث مطابق (نفس Topic + Status READY + غير منتهي Expiry + Tier1/2) → يستخدمه مباشرة.
137
+ إذا المسار غير موجود محلياً → يتجاوز الخطوة ويبحث مباشرة (لا يفشل).
138
+ ```
139
+
140
+ البحث مطابق = نفس الكلمات المفتاحية الرئيسية أو نفس Domain + Topic.
141
+
142
+ ### 10.2 تقييم قابلية إعادة الاستخدام (إلزامي بعد كل بحث)
143
+
144
+ | السؤال | نعم=1 / لا=0 |
145
+ |---|---|
146
+ | 1. قابل للاستخدام في مشروعين مختلفين على الأقل؟ | |
147
+ | 2. المصادر Tier1 أو Tier2؟ | |
148
+ | 3. معلومة عامة وليست سر زبون؟ | |
149
+ | 4. بحث مكتمل (ليس Gap Notice)؟ | |
150
+
151
+ - **Score ≥3 → يحفظ تلقائياً كـ DRAFT** في `Teranoo-Research/{domain}/YYYY-MM-DD_Topic_TierX.md` + يسجل في `00_INDEX.md` (Status DRAFT, Expiry +6-12 شهر)
152
+ - **Score ≤2 → لا يحفظ في المكتبة** (يبقى في `project-preparation/` فقط)
153
+
154
+ ### 10.3 التسمية والتصنيف
155
+
156
+ - **التسمية:** `YYYY-MM-DD_Topic_TierX.md` — تولد تلقائياً
157
+ - **المجلدات المسموحة:** `erp/`, `payments/`, `ai-automation/`, `ecommerce/`, `manufacturing/`, `general/` — أي دومين جديد يقترح بوسم `[New Domain Proposal]` ولا يُنشأ دون موافقة Majed
158
+ - **الحالة:** `DRAFT` (يحفظه الباحث) → `READY` (ترقية بيد Majed فقط) → `DEPRECATED` (بعد Expiry)
159
+
160
+ ### 10.4 قاعدة السرية
161
+
162
+ لا يُحفظ أي بحث يحتوي سر زبون أو بيانات حساسة — حتى لو Score≥3.
163
+
164
+ ---
165
+
124
166
  *هذا الملف مقتبس من §12 من `TERA_RUNTIME_PROTOCOLS_CLIENT.md` (النسخة الأصلية) بعد اختصار الإجراءات التفصيلية والإحالة لتعريفات العملاء.*
@@ -20,9 +20,9 @@
20
20
  "structurizr-mcp",
21
21
  "structurizr-mcp"
22
22
  ],
23
- "enabled": false,
24
- "env": {
25
- "STRUCTURIZR_WORKSPACE_DIR": "../architecture",
23
+ "enabled": true,
24
+ "environment": {
25
+ "STRUCTURIZR_WORKSPACE_DIR": "architecture",
26
26
  "STRUCTURIZR_URL": "http://localhost:8081"
27
27
  }
28
28
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tera-system/core",
3
- "version": "0.2.9",
3
+ "version": "0.2.11",
4
4
  "description": "Tera System OpenCode Plugin أ¢â‚¬â€‌ governance core, 20 agents, 11 commands, distribution tools (personal edition)",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "type": "module",
@@ -0,0 +1,128 @@
1
+ <#
2
+ =============================================================================
3
+ tera-tooling.ps1 - Tera 5-Tool Standard provisioning (SCP-2026-08-29-012)
4
+ =============================================================================
5
+ Verifies (and optionally installs) the five approved Tera tools so every
6
+ repository has a guaranteed, consistent toolchain:
7
+
8
+ Tool Kind Installer used
9
+ -------------- ---------- --------------------------------
10
+ Playwright MCP (npx) npx @playwright/mcp + browsers
11
+ Semgrep MCP + CLI pip install semgrep
12
+ Structurizr MCP (uv) uv (Astral) + Docker (validate/export)
13
+ Gitleaks CLI winget install Gitleaks.Gitleaks
14
+ Trivy CLI winget install AquaSecurity.Trivy
15
+
16
+ Usage:
17
+ powershell -ExecutionPolicy Bypass -File .\tools\tera-tooling.ps1 # report only
18
+ powershell -ExecutionPolicy Bypass -File .\tools\tera-tooling.ps1 -Install # install missing
19
+ powershell -ExecutionPolicy Bypass -File .\tools\tera-tooling.ps1 -Quiet # no banner
20
+
21
+ Exit codes:
22
+ 0 all required tools present
23
+ 1 Node.js/npx missing (required) or fatal error
24
+ 2 optional tool missing (and -Install could not complete it)
25
+ =============================================================================
26
+ #>
27
+ [CmdletBinding()]
28
+ param(
29
+ [switch]$Install, # attempt to install missing tools
30
+ [switch]$Quiet # suppress banner
31
+ )
32
+
33
+ Set-StrictMode -Version 5
34
+ $ErrorActionPreference = 'Continue'
35
+
36
+ function Test-Command([string]$Name, [string]$Arg = '--version') {
37
+ $cmd = Get-Command $Name -ErrorAction SilentlyContinue
38
+ if (-not $cmd) { return $false }
39
+ try {
40
+ $null = & $cmd.Source $Arg 2>$null
41
+ return $true
42
+ } catch { return $true } # binary exists even if version flag differs
43
+ }
44
+
45
+ function Invoke-BestEffort([string]$Label, [scriptblock]$Block) {
46
+ try { & $Block; return $true } catch { Write-Host " ! $Label failed: $($_.Exception.Message)"; return $false }
47
+ }
48
+
49
+ if (-not $Quiet) {
50
+ Write-Host ""
51
+ Write-Host "Tera 5-Tool Standard - provisioning (SCP-2026-08-29-012)"
52
+ if ($Install) { Write-Host "Mode: INSTALL missing tools" } else { Write-Host "Mode: REPORT only (use -Install to install)" }
53
+ Write-Host ""
54
+ }
55
+
56
+ # ---- 1. Required base: Node.js / npx --------------------------------------
57
+ $nodeOk = Test-Command 'node' '--version'
58
+ $npxOk = Test-Command 'npx' '--version'
59
+ if (-not $nodeOk -or -not $npxOk) {
60
+ Write-Host 'ERROR: Node.js / npx not found - required for Playwright MCP and Semgrep MCP.'
61
+ Write-Host ' Install Node.js LTS from https://nodejs.org and re-run.'
62
+ exit 1
63
+ }
64
+
65
+ # ---- Tool status table ------------------------------------------------------
66
+ $rows = [System.Collections.Generic.List[object]]::new()
67
+
68
+ function Add-Row([string]$Tool, [string]$Kind, [bool]$Present, [string]$Action) {
69
+ $status = 'OK'
70
+ if (-not $Present) { $status = 'MISSING' }
71
+ $rows.Add([pscustomobject]@{ Tool = $Tool; Kind = $Kind; Status = $status; Action = $Action })
72
+ }
73
+
74
+ # 2. Semgrep (Python)
75
+ $semgrepOk = Test-Command 'semgrep' '--version'
76
+ if (-not $semgrepOk -and $Install) { $semgrepOk = Invoke-BestEffort 'Semgrep install' { python -m pip install --quiet semgrep } }
77
+ Add-Row 'Semgrep' 'MCP+CLI' $semgrepOk 'pip install semgrep'
78
+
79
+ # 3. Gitleaks (Go binary via winget)
80
+ $gitleaksOk = Test-Command 'gitleaks' 'version'
81
+ if (-not $gitleaksOk -and $Install) { $gitleaksOk = Invoke-BestEffort 'Gitleaks install' { winget install --id Gitleaks.Gitleaks -e --silent --accept-package-agreements --accept-source-agreements | Out-Null } }
82
+ Add-Row 'Gitleaks' 'CLI' $gitleaksOk 'winget install Gitleaks.Gitleaks'
83
+
84
+ # 4. Trivy (Go binary via winget)
85
+ $trivyOk = Test-Command 'trivy' '--version'
86
+ if (-not $trivyOk -and $Install) { $trivyOk = Invoke-BestEffort 'Trivy install' { winget install --id AquaSecurity.Trivy -e --silent --accept-package-agreements --accept-source-agreements | Out-Null } }
87
+ Add-Row 'Trivy' 'CLI' $trivyOk 'winget install AquaSecurity.Trivy'
88
+
89
+ # 5. uv (Astral - Structurizr MCP runner)
90
+ $uvOk = Test-Command 'uv' '--version'
91
+ if (-not $uvOk -and $Install) { $uvOk = Invoke-BestEffort 'uv install' { python -m pip install --quiet uv } }
92
+ Add-Row 'uv (Structurizr)' 'MCP runner' $uvOk 'pip install uv'
93
+
94
+ # 6. Docker (Structurizr validate/export)
95
+ $dockerOk = Test-Command 'docker' '--version'
96
+ if (-not $dockerOk -and $Install) { $dockerOk = Invoke-BestEffort 'Docker install' { winget install --id Docker.DockerDesktop -e --silent --accept-package-agreements --accept-source-agreements | Out-Null } }
97
+ Add-Row 'Docker (Structurizr)' 'runtime' $dockerOk 'winget install Docker.DockerDesktop'
98
+
99
+ # 7. Playwright MCP + browsers (npx - resolves on first use)
100
+ $pwMCP = Test-Command 'npx' '--version' # npx itself; the MCP resolves via npx on first opencode start
101
+ if (-not $Quiet) { Write-Host ' Playwright MCP: auto-resolves via npx on first opencode start.' }
102
+ if ($Install -and $pwMCP) {
103
+ Write-Host ' Installing Playwright Chromium browsers (first run ~300MB)...'
104
+ Invoke-BestEffort 'Playwright browsers' { npx -y playwright install chromium | Out-Null }
105
+ }
106
+ Add-Row 'Playwright' 'MCP' $pwMCP 'npx @playwright/mcp (auto)'
107
+
108
+ # ---- Report ----------------------------------------------------------------
109
+ Write-Host ""
110
+ Write-Host ("{0,-22} {1,-10} {2,-8} {3}" -f 'Tool', 'Kind', 'Status', 'Action')
111
+ Write-Host ("{0,-22} {1,-10} {2,-8} {3}" -f ('-' * 22), ('-' * 10), ('-' * 8), ('-' * 40))
112
+ foreach ($r in $rows) { Write-Host ("{0,-22} {1,-10} {2,-8} {3}" -f $r.Tool, $r.Kind, $r.Status, $r.Action) }
113
+
114
+ $missing = @($rows | Where-Object { $_.Status -eq 'MISSING' })
115
+ $optional = @($missing | Where-Object { $_.Tool -notin @('Playwright') })
116
+ Write-Host ""
117
+ if ($missing.Count -eq 0) {
118
+ Write-Host 'RESULT: All tools present. Toolchain ready.'
119
+ exit 0
120
+ } elseif ($optional.Count -eq 0) {
121
+ Write-Host 'RESULT: All required tools present (Playwright resolves on first use).'
122
+ exit 0
123
+ } else {
124
+ Write-Host "RESULT: $($optional.Count) optional tool(s) missing. Re-run with -Install, or install manually:"
125
+ foreach ($m in $optional) { Write-Host " - $($m.Tool): $($m.Action)" }
126
+ if ($Install) { Write-Host ' Some installs may need a new shell (PATH) or a machine restart (Docker).' }
127
+ exit 2
128
+ }