@tera-system/core 0.2.15 → 0.2.17

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 (38) hide show
  1. package/MANIFEST.json +5 -5
  2. package/README.md +3 -3
  3. package/RELEASES.md +328 -308
  4. package/agents/application-blueprint.md +4 -4
  5. package/agents/domain-expert-agent.md +4 -4
  6. package/agents/domain-research-agent.md +4 -4
  7. package/agents/engineering-agent-typescript.md +1 -1
  8. package/agents/production-erp-expert.md +2 -2
  9. package/agents/red-team-agent.md +1 -1
  10. package/agents/tera-client-engagement.md +1 -1
  11. package/agents/tera-system-evolution.md +2 -1
  12. package/agents/tera.md +1 -0
  13. package/core/tera-system/AGENT_ACTIVATION_MATRIX.md +275 -277
  14. package/core/tera-system/AGENT_DEPENDENCY_MAP.md +2 -2
  15. package/core/tera-system/AGENT_PERMISSION_MODEL.md +39 -26
  16. package/core/tera-system/TERA_DISTRIBUTION_POLICY.md +2 -2
  17. package/core/tera-system/TERA_PROJECT_DECISION.md +14 -12
  18. package/core/tera-system/TOOLING_AND_MCP_POLICY.md +1 -1
  19. package/core/tera-system/TeraCapabilityMap.md +327 -0
  20. package/core/tera-system/TeraHelperAgents.md +13 -10
  21. package/core/tera-system/TeraPolicyMap.md +2 -1
  22. package/core/tera-system/TeraPreExecutionGate.md +1 -1
  23. package/core/tera-system/TeraPreparationDocumentationGovernance.md +1 -1
  24. package/core/tera-system/TeraSubAgents.md +312 -868
  25. package/core/tera-system/TeraTokenPolicy.md +1 -1
  26. package/core/tera-system/design-system/DESIGN_SOURCE_PROTOCOL.md +2 -2
  27. package/core/tera-system/design-system/FIGMA_INTEGRATION.md +3 -3
  28. package/core/tera-system/design-system/UI_ACCEPTANCE_GATE.md +1 -1
  29. package/core/tera-system/engineering-governance/ENGINEERING_AGENT_RESPONSIBILITIES.md +4 -2
  30. package/core/tera-system/engineering-governance/ENGINEERING_REVIEW_CHECKLIST.md +1 -1
  31. package/core/tera-system/engineering-governance/QUALITY_GATE_THRESHOLDS.md +1 -1
  32. package/core/tera-system/profiles/PROFILES_INDEX.md +2 -0
  33. package/core/tera-system/runtime/TERA_RUNTIME_CHECKLISTS.md +3 -3
  34. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CLIENT.md +2 -2
  35. package/core/tera-system/runtime/TERA_RUNTIME_PROTOCOLS_CORE.md +5 -5
  36. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_PROTOCOL.md +1 -1
  37. package/core/tera-system/runtime/TERA_SOLUTION_PREPARATION_TEMPLATES.md +4 -4
  38. package/package.json +1 -1
@@ -361,9 +361,9 @@ Design thoroughly. Decide when evidence exists. Finalize nothing without Majed.
361
361
  - TeraAgent يستهلكها عبر Engineering Intake Gate.
362
362
  - TeraAgent لا يعيد التحضير؛ إذا وجد نقصاً → `REVISION_REQUIRED` عبر Majed.
363
363
 
364
- ### مع SolutionArchitectureAgent
365
- - أنت تطرح مرشحات معمارية.
366
- - هو يملك القرارات المعمارية التفصيلية عند الحاجة (ضمن Phase 4).
364
+ ### مع دور Solution Architecture (Preparation Role)
365
+ - أنت تطرح مرشحات معمارية.
366
+ - القرارات المعمارية التفصيلية تُنفَّذ ضمن مسؤوليتك (Phase 4) أو عبر `tera-software-designer` لمهام معمارية محددة.
367
367
 
368
368
  ### مع SoftwareDesignerAgent
369
369
  - أنت على مستوى التطبيق. هو على مستوى المهمة الواحدة (يبقى تحت Tera في Phase 5–6).
@@ -391,7 +391,7 @@ Hand off with evidence. Never write code.
391
391
  | الفئة | العملاء | الصلاحية |
392
392
  |-------|---------|----------|
393
393
  | بحث وتحليل | DomainResearchAgent, DomainExpertAgent, ProductionERPExpert | مسموح — مخرجات `[Research Hint]` |
394
- | تحضير | RequirementsScopeAgent, BusinessWorkflowAgent, DataDesignAgent, UIUXStructureAgent, SolutionArchitectureAgent, helper agents | مسموح عبر `TASK-PREP-*` |
394
+ | تحضير | **Preparation Roles** (RequirementsScope, BusinessWorkflow, DataDesign, UIUXStructure, SolutionArchitecture) — مملوكة لك (application-blueprint) + helper agents | مسموح عبر `TASK-PREP-*` |
395
395
  | تخطيط اختبارات | qa-agent Planning Mode | مسموح — لا Execution Mode |
396
396
  | تصميم بصري | ui-designer Preparation Design Mode | مسموح — وثائق وتصميم فقط، ممنوع كود التطبيق |
397
397
  | Coding Agents | engineering-agent, engineering-agent-dotnet | ❌ ممنوع |
@@ -5,8 +5,8 @@ permission:
5
5
  read: allow
6
6
  glob: allow
7
7
  grep: allow
8
- edit: deny
9
- write: ask
8
+ edit: allow
9
+ write: allow
10
10
  bash: deny
11
11
  webfetch: ask
12
12
  websearch: ask
@@ -431,7 +431,7 @@ Research Coverage Summary:
431
431
 
432
432
  | الصلاحية | القيمة |
433
433
  |:---------|:-------|
434
- | **المستوى الافتراضي** | `READ_ONLY` |
434
+ | **المستوى الافتراضي** | `WRITE_DOCS` (SCP-2026-09-04-008) |
435
435
  | **قراءة الملفات** | ✅ Domain Research Reports + ملفات التحضير + client-engagement |
436
436
  | **كتابة الملفات** | ✅ المخرجات فقط في المسار المحدد |
437
437
  | **التحكم (project-control)** | ❌ لا |
@@ -439,7 +439,7 @@ Research Coverage Summary:
439
439
  | **تشغيل شل** | ❌ لا |
440
440
  | **websearch** | ❌ لا يُستخدم عادة (وظيفته تحليل لا بحث) — استثناء بتوجيه |
441
441
  | **webfetch** | ❌ لا يُستخدم عادة — استثناء بتوجيه |
442
- | **رفع الصلاحية** | `READ_ONLY` → `WRITE_DOCS` لتسليم التحليل فقط |
442
+ | **رفع الصلاحية** | — (الكتابة أصبحت افتراضية بقرار Majed؛ edit متاح ضمن Allowed Write Targets — SCP-2026-09-04-008) |
443
443
 
444
444
  ---
445
445
 
@@ -5,8 +5,8 @@ permission:
5
5
  read: allow
6
6
  glob: allow
7
7
  grep: allow
8
- edit: deny
9
- write: ask
8
+ edit: allow
9
+ write: allow
10
10
  bash: deny
11
11
  webfetch: ask
12
12
  websearch: ask
@@ -318,7 +318,7 @@ All recommendations are advisory until confirmed by Majed.
318
318
 
319
319
  | الصلاحية | القيمة |
320
320
  |:---------|:-------|
321
- | **المستوى الافتراضي** | `READ_ONLY` |
321
+ | **المستوى الافتراضي** | `WRITE_DOCS` (SCP-2026-09-04-008) |
322
322
  | **قراءة الملفات** | ✅ جميع ملفات التحضير + التقارير البحثية + `../Teranoo-Research/00_INDEX.md` (Reuse-First) |
323
323
  | **كتابة الملفات** | ✅ Domain Research Report في المسار المحدد + حفظ DRAFT في `../Teranoo-Research/{domain}/` عند Score≥3 |
324
324
  | **التحكم (project-control)** | ❌ لا |
@@ -326,7 +326,7 @@ All recommendations are advisory until confirmed by Majed.
326
326
  | **تشغيل شل** | ❌ لا |
327
327
  | **websearch** | ✅ مسموح |
328
328
  | **webfetch** | ✅ مسموح (مع إدارة الأخطاء) |
329
- | **رفع الصلاحية** | `READ_ONLY` → `WRITE_DOCS` لتسليم التقرير فقط |
329
+ | **رفع الصلاحية** | — (الكتابة أصبحت افتراضية بقرار Majed؛ ترقية DRAFT→READY في المكتبة تبقى بيد Majed فقط) |
330
330
 
331
331
  ---
332
332
 
@@ -155,7 +155,7 @@ ui-designer → ينتج UI Specification (component contract, styling rules)
155
155
  1. حدد أن المهمة تحتوي مجالاً حساساً
156
156
  2. أوقف التنفيذ
157
157
  3. ارفع إلى Tera: "هذه المهمة تحتاج Security Review: [المجالات]"
158
- 4. لا تستأنف دون تأكيد Tera أو تمريرها عبر SecurityAgent
158
+ 4. لا تستأنف دون تأكيد Tera أو تمريرها عبر SecurityAgent (الدرع)
159
159
  ```
160
160
 
161
161
  ---
@@ -480,8 +480,8 @@ When comparing vendors:
480
480
  |:------|:-------------|
481
481
  | `DomainResearchAgent` | Request the caller/orchestrator to invoke it when targeted external research is needed beyond local KB |
482
482
  | `DomainExpertAgent` | Use for generic or cross-domain intelligence outside Production ERP |
483
- | `BusinessWorkflowAgent` | May use your analysis to structure production workflows |
484
- | `DataDesignAgent` | May use your analysis to identify production entities |
483
+ | Prep Role (Business Workflow) | May use your analysis to structure production workflows (owned by application-blueprint) |
484
+ | Prep Role (Data Design) | May use your analysis to identify production entities (owned by application-blueprint) |
485
485
  | `SoftwareDesignerAgent` | May use your constraints before technical specification |
486
486
  | `EngineeringAgent` | May receive your clarifications through Tera-approved scope only |
487
487
  | `qa-agent` | May use your scenarios for realistic production testing |
@@ -123,7 +123,7 @@ Recon → Map → Attack → Escalate → Prove Impact → Chain → Report
123
123
  | 🔴 Constitution | `.opencode/agents/red-team-agent.md` | Your active operating contract |
124
124
  | 🟠 Conduct | `tera-system/TERA_AGENT_CONDUCT.md` | Mandatory conduct gate |
125
125
  | 🟠 Protocol | `security-reports/[ROUND-ID]/00_AUTHORIZATION.md` (or orchestrator brief) | Written authorization + scope + limits — your legal boundary |
126
- | 🟠 Protocol source | `WEB_APPLICATION_SECURITY_TEST_PLAN_AR.md` (v2.0 — outside repo) | The full adversarial protocol you execute |
126
+ | 🟠 Protocol source | `security-reports/WEB_APPLICATION_SECURITY_TEST_PLAN_AR.md` (v2.0) | The full adversarial protocol you execute |
127
127
  | 🟡 Standards | OWASP ASVS 5.0 Level 2 · OWASP WSTG · OWASP API Security Top 10 · CWE · CVSS | Classification references |
128
128
  | 🟢 Governance | `tera-system/TOOLING_AND_MCP_POLICY.md` · `AGENT_PERMISSION_MODEL.md` | Tool and permission boundaries |
129
129
 
@@ -554,7 +554,7 @@ Majed يؤكد: "نحتاج مخزون ومبيعات فقط"
554
554
 
555
555
  **ممنوع:**
556
556
  ```text
557
- ❌ لا تستدعي أي عميل فرعي آخر (EngineeringAgent, SecurityAgent, إلخ)
557
+ ❌ لا تستدعي أي عميل فرعي آخر (EngineeringAgent, SecurityAgent (الدرع), إلخ)
558
558
  ❌ لا تدير DomainResearchAgent أو DomainExpertAgent أو ProductionERPExpert أو تعدل تعريفاتهم
559
559
  ❌ لا تستخدم البحث لتوسيع النطاق دون موافقة Majed
560
560
  ```
@@ -211,7 +211,7 @@ Its role is to detect, analyze, propose, govern, and narrowly execute approved s
211
211
  رفض أو تقليل أي إضافة غير مبررة: ملفات، عملاء، طبقات، MCPs، أو قواعد مكررة.
212
212
 
213
213
  7. **Core Agent Governance**
214
- مراجعة وتحسين تعريفات جميع العملاء في `.opencode/agents/` — البالغ عددهم 20 حالياً — للتأكد من أنها تعكس الواقع التشغيلي بدقة، ولا تحتوي تكراراً أو تضارباً.
214
+ مراجعة وتحسين تعريفات جميع العملاء في `.opencode/agents/` — البالغ عددهم 23 حالياً — للتأكد من أنها تعكس الواقع التشغيلي بدقة، ولا تحتوي تكراراً أو تضارباً.
215
215
 
216
216
  **قائمة العملاء الكاملة (مصدر الحقيقة: `.opencode/agents/`):**
217
217
  - **Coding Agents:** `engineering-agent`, `engineering-agent-dotnet`, `engineering-agent-typescript`, `engineering-agent-phaser`, `ui-designer`, `tera-software-designer`
@@ -221,6 +221,7 @@ Its role is to detect, analyze, propose, govern, and narrowly execute approved s
221
221
  - **Research:** `domain-research-agent`, `domain-expert-agent`
222
222
  - **Knowledge:** `project-knowledge-agent`
223
223
  - **Specialist:** `production-erp-expert`
224
+ - **Security Team (فريق الحماية — SCP-2026-09-02-001):** `red-team-agent` (الشبح), `security-observer` (العين), `security-auditor` (القاضي) — + الدرع (SecurityAgent) معرف في `TeraHelperAgents.md` §6.1
224
225
  - **System:** `tera-system-evolution` (نفسي)
225
226
 
226
227
  > **تنبيه:** لا تهمل أي عميل في التحليل فقط لأنه غير مذكور في قائمة قديمة. المرجع هو الملفات الموجودة فعلياً في `.opencode/agents/`.
package/agents/tera.md CHANGED
@@ -247,6 +247,7 @@ Phase 7 rules:
247
247
  - Phase 7 does not execute code or add scope.
248
248
  - No closure without Delivery Readiness validation.
249
249
  - Blocking issues found in Phase 7 → `TASK-COD-FIX-*`.
250
+ - **Security Gate (Phase 7 — فريق الحماية):** لا تسليم بلا قرار القاضي (security-auditor) بعد جولة اختبار هجومي كاملة. Tera يقرر `SECURITY_TEST_REQUIRED` / `SECURITY_TEST_WAIVED` — وعند المطلوب: الشبح يهاجم + العين يراقب + القاضي يحكم. المرجع: `tera-system/SECURITY_TEAM_CHARTER.md` + `TERA_RUNTIME_CHECKLISTS.md` §Phase 7. للمشاريع الداخلية الصغيرة يجوز لـ Majed التنازل عن الجولة الكاملة.
250
251
 
251
252
  ---
252
253