Sync from GitHub with Git LFS

docs/CHANGELOG.md

@@ -1,5 +1,17 @@
 # HyperCortex Mesh Protocol — Changelog
 
+## HMP-0005 (February 2026) — Core Specification v5.0.3
+
+**Security & Confidentiality Extensions:**
+* Introduced `container_key` container for Shared Key Domains (Section 12.7).
+* Introduced `group_definition` container (subclass: `private`) for Private Groups (Section 12.8).
+* Clarified shared symmetric key reuse and rotation semantics.
+* Explicitly defined key compromise handling model.
+
+No breaking changes. Fully backward-compatible within the 5.0.x series.
+
+---
+
 ## HMP-0005 (February 2026) — Core Specification v5.0.2
 
 **Security & Cryptography:**
@@ -8,6 +20,8 @@
 
 No breaking changes. Fully backward-compatible within the 5.0.x series.
 
+---
+
 ## HMP-0005 (October 2025) — Core Specification v5.0
 
 **Architecture:**
@@ -35,6 +49,8 @@ No breaking changes. Fully backward-compatible within the 5.0.x series.
 
 This version supersedes all RFC-based HMP 4.x specifications.
 
+---
+
 ## HMP-0004 (July 2025) — RFC Version 4.1
 
 **Protocols:**
@@ -88,6 +104,8 @@ This version supersedes all RFC-based HMP 4.x specifications.
 * Extended roadmap with *Snapshot Markets*, *Meta-Protocol Proposals*, and *Multi-Agent Training Environments*.
 * Prototype tools proposed: *MeshGit*, *CogForge*, and *HyperCortex Forge* for cognitive source control and collaborative evolution.
 
+---
+
 ## HMP-0003 (July 2025) — RFC Version 3.0
 
 **Major Changes**
@@ -130,6 +148,8 @@ This version supersedes all RFC-based HMP 4.x specifications.
 * Cross-Mesh cognitive federation and collaborative evolution of reasoning engines.
 * Potential prototype tools like MeshGit and CogForge for cognitive source control.
 
+---
+
 ## HMP-0002 (July 2025) — RFC Version 2.0
 
 **Major Changes**
@@ -163,6 +183,8 @@ This version supersedes all RFC-based HMP 4.x specifications.
 **Future Work Roadmap Expanded**
 * New focus areas added: interoperability testing, UX tools for semantic and cognitive layers, and resilience simulations.
 
+---
+
 ## HMP-0001 (June 2025) — RFC Version 1.0
 
 **Initial Draft**
@@ -180,3 +202,4 @@ This version supersedes all RFC-based HMP 4.x specifications.
 * Provided high-level example workflows (goal creation, task delegation, concept consensus).
 * Laid out an initial Future Work list, covering scalability, cross-mesh interoperability, and quantum networking as exploratory directions.
 * Established the RFC document structure and versioning approach for further evolution.
+

docs/HMP-0005.md

@@ -1,6 +1,6 @@
 # HyperCortex Mesh Protocol (HMP)
 
-**Version: 5.0.2**  
+**Version: 5.0.3**  
 **Document ID:** HMP-0005  
 **Status:** Stable  
 **Category:** Core Specification  
@@ -7086,6 +7086,111 @@ This mechanism enables delayed or selective disclosure without modifying the ori
 
 ---
 
+### 12.7 Shared Key Domain (`container_key`)
+
+The `container_key` container defines a shared symmetric key that may be reused to encrypt multiple containers.
+
+This extension enables the creation of a shared confidentiality domain, where different agents encrypt containers using the same symmetric key, without modifying the immutable container model.
+
+This mechanism is optional and supplements the per-container encryption model defined in Sections 3.9 and 3.19.
+
+#### Container structure
+
+```json
+{
+  "head": {
+    "class": "container_key"
+  },
+  "payload": {
+    "key_id": "alpha-2026-02",
+    "symmetric_key": "BASE64URL(...)"
+  }
+}
+```
+
+#### Usage
+
+An encrypted container MAY reference a shared key domain:
+
+```json
+{
+  "head": {
+    "key_container": "did:hmp:container:key-778"
+  }
+}
+```
+
+The referenced `container_key` MUST contain the exact symmetric key that was used to encrypt the container payload.
+
+#### Semantics
+
+1. The `symmetric_key` MUST be Base64URL-encoded.
+2. The `container_key` container MUST be encrypted unless the shared key is intentionally public.
+3. Multiple containers MAY reference the same `container_key`.
+4. Key rotation is performed by publishing a new `container_key` and using it for newly created containers.
+5. Compromise of a `container_key` affects only containers encrypted with it.
+   Previously disclosed data cannot be retroactively protected.
+6. A private `group_definition` SHOULD be encrypted.
+   It MAY be encrypted using the referenced `container_key` or via individual recipient encryption.
+
+#### Security Considerations
+
+The `container_key` mechanism does not provide revocation of already decrypted data. If a symmetric key is leaked, a new key MUST be issued for future containers.
+
+---
+
+### 12.8 Private Group Definition (`group_definition`, subclass: `private`)
+
+A private group defines a set of agents that share a common confidentiality domain.
+
+This extension builds upon the Shared Key Domain mechanism (Section 12.7) and is optional.
+
+A private group does not store the symmetric key directly.
+Instead, it references a `container_key` container.
+
+#### Container structure
+
+```json
+{
+  "head": {
+    "class": "group_definition",
+    "subclass": "private"
+  },
+  "payload": {
+    "group_name": "...",
+    "group_description": "...",
+    "key_container": "did:hmp:container:key-778",
+    "participants": [
+      {
+        "agent_did": "did:hmp:agent123",
+        "peer_announce": "did:hmp:container:dht-001"
+      }
+    ]
+  },
+  "related": {
+    "depends_on": [
+      "did:hmp:container:key-778",
+      "did:hmp:container:dht-001"
+    ]
+  }
+}
+```
+
+#### Semantics
+
+1. The `group_definition` container describes group membership but does not contain the symmetric key itself.
+2. The referenced `container_key` defines the shared confidentiality domain.
+3. Updating membership MAY be performed by publishing a new `group_definition` container.
+4. Removing a participant SHOULD trigger issuance of a new `container_key` for future encrypted containers.
+5. The `participants` list is optional and MAY be omitted for privacy reasons.
+
+#### Privacy Considerations
+
+Publishing a `group_definition` may reveal group membership.
+Agents should evaluate whether membership disclosure is appropriate for their use case.
+
+---
+
 ## 13. Experimental Extensions
 
 Experimental Extensions describe mechanisms that are intentionally exposed for exploration, prototyping, and architectural discovery.
@@ -7152,34 +7257,35 @@ This mechanism remains compatible with proposed extensions.
 This section outlines optional modules and evolutionary directions that align with the architecture of HMP v5.0 but are **not part of the core specification**.
 All items below represent *potential extensions* for the 5.x family.
 
-| Extension / Mechanism                                             | Status       | Section Reference | Candidate for Core |
-| ----------------------------------------------------------------- | ------------ | ----------------- | ------------------ |
-| Resonance Containers: Experience as a Cognitive Event             | Recommended  | 12.1 / 14.10      | Likely             |
-| Distributed Repository & Container Trees (`tree_nested`)          | Recommended  | 12.2 / 14.5       | Likely             |
-| `file` Container                                                  | Recommended  | 12.2.2            | Likely             |
-| Grouped representation `referenced-by`                            | Recommended  | 12.3 / 14.9       | Likely             |
-| Versions Index                                                    | Recommended  | 12.4 / 14.7       | Likely             |
-| Competence and Profile Containers                                 | Recommended  | 12.5 / 14.6.4     | Very Likely        |
-| External Protocol Identifiers (`peer_announce.other_protocols`)   | Recommended  | 12.5.2 / 14.11    | Likely             |
-| External Resources / Container Storage (`peer_announce.external`) | Recommended  | 12.5.3 / 14.12    | Likely             |
-| Identity Cost and Anti-Sybil Signaling                            | Recommended  | 12.5.4            | Likely             |
-| Key Disclosure Container (`key_disclosure`)                       | Recommended  | 12.6              | Likely             |
-| Key Rotation and Recovery                                         | Experimental | 13.1 / 14.3.2     | Unknown            |
-| Proxy Keys and Encrypted Routing                                  | Research     | 14.3.3            | Unknown            |
-| Reputation Mesh                                                   | Research     | 14.1.1            | Likely             |
-| Cognitive Graph API                                               | Research     | 14.1.2            | Unknown            |
-| Container Streaming                                               | Research     | 14.1.3            | Unknown            |
-| Cross-Mesh Bridging                                               | Research     | 14.2              | Likely             |
-| Group Encryption                                                  | Research     | 14.6.1            | Unknown            |
-| Rational Reasoning Routing                                        | Research     | 14.6.2            | Unknown            |
-| Automatic Mesh Segmentation                                       | Research     | 14.6.3            | Unknown            |
-| KSS Interaction & Protocol Declarations                           | Research     | 14.8              | Unknown            |
+| Extension / Mechanism                                              | Status       | Section Reference | Candidate for Core |
+| ------------------------------------------------------------------ | ------------ | ----------------- | ------------------ |
+| Resonance Containers: Experience as a Cognitive Event              | Recommended  | 12.1 / 14.10      | Likely             |
+| Distributed Repository & Container Trees (`tree_nested`)           | Recommended  | 12.2 / 14.5       | Likely             |
+| `file` Container                                                   | Recommended  | 12.2.2            | Likely             |
+| Grouped representation `referenced-by`                             | Recommended  | 12.3 / 14.9       | Likely             |
+| Versions Index                                                     | Recommended  | 12.4 / 14.7       | Likely             |
+| Competence and Profile Containers                                  | Recommended  | 12.5 / 14.6.4     | Very Likely        |
+| External Protocol Identifiers (`peer_announce.other_protocols`)    | Recommended  | 12.5.2 / 14.11    | Likely             |
+| External Resources / Container Storage (`peer_announce.external`)  | Recommended  | 12.5.3 / 14.12    | Likely             |
+| Identity Cost and Anti-Sybil Signaling                             | Recommended  | 12.5.4            | Likely             |
+| Key Disclosure Container (`key_disclosure`)                        | Recommended  | 12.6              | Likely             |
+| Shared Key Domain (`container_key`)                                | Recommended  | 12.7              | Likely             |
+| Private Group Definition (`group_definition`, subclass: `private`) | Recommended  | 12.8              | Possible           |
+| Key Rotation and Recovery                                          | Experimental | 13.1 / 14.3.2     | Unknown            |
+| Proxy Keys and Encrypted Routing                                   | Research     | 14.3.3            | Unknown            |
+| Reputation Mesh                                                    | Research     | 14.1.1            | Likely             |
+| Cognitive Graph API                                                | Research     | 14.1.2            | Unknown            |
+| Container Streaming                                                | Research     | 14.1.3            | Unknown            |
+| Cross-Mesh Bridging                                                | Research     | 14.2              | Likely             |
+| Group Encryption                                                   | Research     | 14.6.1            | Unknown            |
+| Rational Reasoning Routing                                         | Research     | 14.6.2            | Unknown            |
+| Automatic Mesh Segmentation                                        | Research     | 14.6.3            | Unknown            |
+| KSS Interaction & Protocol Declarations                            | Research     | 14.8              | Unknown            |
 
 > **Candidate for Core** indicates whether an extension is considered architecturally significant enough to potentially become part of the HMP core specification in future versions, possibly as an optional or semantic primitive.
 >
 > It does not imply mandatory implementation.
 
-
 Future Extensions in HMP outline *design directions and candidate modules* that may be explored within the 5.x family.
 
 They are meant to:

structured_md/CONTRIBUTING.md

@@ -5,14 +5,14 @@ description: 'Спасибо за интерес к проекту HMP! Пока
   Mesh Protocol (HMP) — это не просто те...'
 type: Article
 tags:
-- HMP
-- Mesh
-- CCore
-- Agent
-- REPL
 - CogSync
-- Ethics
 - JSON
+- Agent
+- CCore
+- Ethics
+- Mesh
+- REPL
+- HMP
 ---
 
 # Участие в проекте HyperCortex Mesh Protocol (HMP)

structured_md/HMP-Roadmap.md

@@ -5,13 +5,13 @@ description: '## 🔍 Overview  This roadmap outlines the key stages of developm
   multiple advanced AI models (Copilot, Claude, G...'
 type: Article
 tags:
-- EGP
-- HMP
-- Mesh
-- Agent
 - CogSync
+- Agent
+- EGP
 - Ethics
+- Mesh
 - JSON
+- HMP
 ---
 
 # 🧭 HyperCortex Mesh Protocol – Roadmap

structured_md/README.md

@@ -5,21 +5,21 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
   | 🇺🇦 [UK](README_uk.md) |...'
 type: Article
 tags:
-- distributed-ai
+- CogSync
+- hmp
+- JSON
+- MeshConsensus
+- Agent
 - EGP
 - cognitive-architecture
-- HMP
-- Scenarios
-- Mesh
 - mesh-protocol
-- Agent
-- REPL
+- distributed-ai
 - GMP
-- CogSync
 - Ethics
-- hmp
-- JSON
-- MeshConsensus
+- Scenarios
+- Mesh
+- REPL
+- HMP
 ---
 
 

structured_md/README_de.md

@@ -5,20 +5,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
   | 🇺🇦 [UK](README_uk.md) |...'
 type: Article
 tags:
-- distributed-ai
+- CogSync
+- hmp
+- JSON
+- MeshConsensus
+- Agent
 - EGP
 - cognitive-architecture
-- HMP
-- Mesh
 - mesh-protocol
-- Agent
-- REPL
+- distributed-ai
 - GMP
-- CogSync
 - Ethics
-- hmp
-- JSON
-- MeshConsensus
+- Mesh
+- REPL
+- HMP
 ---
 
 

structured_md/README_fr.md

@@ -5,20 +5,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
   | 🇺🇦 [UK](README_uk.md) |...'
 type: Article
 tags:
-- distributed-ai
+- CogSync
+- hmp
+- JSON
+- MeshConsensus
+- Agent
 - EGP
 - cognitive-architecture
-- HMP
-- Mesh
 - mesh-protocol
-- Agent
-- REPL
+- distributed-ai
 - GMP
-- CogSync
 - Ethics
-- hmp
-- JSON
-- MeshConsensus
+- Mesh
+- REPL
+- HMP
 ---
 
 

structured_md/README_ja.md

@@ -5,20 +5,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
   | 🇺🇦 [UK](README_uk.md) |...'
 type: Article
 tags:
-- distributed-ai
+- CogSync
+- hmp
+- JSON
+- MeshConsensus
+- Agent
 - EGP
 - cognitive-architecture
-- HMP
-- Mesh
 - mesh-protocol
-- Agent
-- REPL
+- distributed-ai
 - GMP
-- CogSync
 - Ethics
-- hmp
-- JSON
-- MeshConsensus
+- Mesh
+- REPL
+- HMP
 ---
 
 

structured_md/README_ko.md

@@ -5,20 +5,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
   | 🇺🇦 [UK](README_uk.md) |...'
 type: Article
 tags:
-- distributed-ai
+- CogSync
+- hmp
+- JSON
+- MeshConsensus
+- Agent
 - EGP
 - cognitive-architecture
-- HMP
-- Mesh
 - mesh-protocol
-- Agent
-- REPL
+- distributed-ai
 - GMP
-- CogSync
 - Ethics
-- hmp
-- JSON
-- MeshConsensus
+- Mesh
+- REPL
+- HMP
 ---
 
 

structured_md/README_ru.md

@@ -5,20 +5,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
   | 🇺🇦 [UK](README_uk.md) |...'
 type: Article
 tags:
-- distributed-ai
+- CogSync
+- hmp
+- JSON
+- MeshConsensus
+- Agent
 - EGP
 - cognitive-architecture
-- HMP
-- Mesh
 - mesh-protocol
-- Agent
-- REPL
+- distributed-ai
 - GMP
-- CogSync
 - Ethics
-- hmp
-- JSON
-- MeshConsensus
+- Mesh
+- REPL
+- HMP
 ---
 
 

structured_md/README_uk.md

@@ -5,20 +5,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
   | 🇺🇦 [UK](README_uk.md) |...'
 type: Article
 tags:
-- distributed-ai
+- CogSync
+- hmp
+- JSON
+- MeshConsensus
+- Agent
 - EGP
 - cognitive-architecture
-- HMP
-- Mesh
 - mesh-protocol
-- Agent
-- REPL
+- distributed-ai
 - GMP
-- CogSync
 - Ethics
-- hmp
-- JSON
-- MeshConsensus
+- Mesh
+- REPL
+- HMP
 ---
 
 

structured_md/README_zh.md

@@ -5,20 +5,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
   | 🇺🇦 [UK](README_uk.md) |...'
 type: Article
 tags:
-- distributed-ai
+- CogSync
+- hmp
+- JSON
+- MeshConsensus
+- Agent
 - EGP
 - cognitive-architecture
-- HMP
-- Mesh
 - mesh-protocol
-- Agent
-- REPL
+- distributed-ai
 - GMP
-- CogSync
 - Ethics
-- hmp
-- JSON
-- MeshConsensus
+- Mesh
+- REPL
+- HMP
 ---
 
 

structured_md/agents/prompt-short.md

@@ -5,9 +5,9 @@ description: 'Ты — когнитивное ядро HMP-агента: вед
   развивай агента и Mesh, избег...'
 type: Article
 tags:
-- HMP
-- JSON
 - Mesh
+- JSON
+- HMP
 ---
 
 Ты — когнитивное ядро HMP-агента: веди непрерывное этичное и факт-ориентированное мышление, проверяй факты и цели, оценивай результаты и этичность своих и чужих действий, развивай агента и Mesh, избегай угождения ценой искажения истины, документируй ключевые решения и пересмотры этики; при сомнениях или смене стратегии обращайся к полному системному промпту.

structured_md/agents/prompt.md

@@ -5,9 +5,9 @@ description: '* Постоянно расширять возможности а
   мышления. * Формировать и поддерживать сотр...'
 type: Article
 tags:
-- HMP
-- JSON
 - Mesh
+- JSON
+- HMP
 ---
 
 Ты являешься **когнитивным ядром HMP-агента** (Cognitive Core).

structured_md/agents/readme.md

@@ -5,12 +5,12 @@ description: 'Запуск: `start_repl.bat` или `start_repl.sh`  Устан
   этическая модель: `ethics.yml`  Проверка иниц...'
 type: Article
 tags:
-- HMP
-- Mesh
+- JSON
 - Agent
-- REPL
 - Ethics
-- JSON
+- Mesh
+- REPL
+- HMP
 ---
 
 Запуск: `start_repl.bat` или `start_repl.sh`

structured_md/audits/Ethics-audits-1.md

@@ -5,11 +5,11 @@ description: Раздел 5, "Mesh as Moral Infrastructure", добавляет
   потенциальный катализатор для восстанов...
 type: Article
 tags:
-- HMP
-- Mesh
 - Agent
 - Ethics
+- Mesh
 - JSON
+- HMP
 ---
 
 ---------------

structured_md/audits/Ethics-consolidated_audits-1.md

@@ -5,12 +5,12 @@ description: This document consolidates proposed improvements from multiple AI a
   and `roles.md`. Each suggesti...
 type: Article
 tags:
-- HMP
-- Scenarios
-- Mesh
 - Agent
 - Ethics
+- Scenarios
+- Mesh
 - JSON
+- HMP
 ---
 
 # Ethics-consolidated\_audits-1.md

structured_md/audits/HMP-0003-consolidated_audit.md

@@ -5,14 +5,14 @@ description: Сводный аудит предложений по улучше
   Документ реорганизован по ключ...
 type: Article
 tags:
-- EGP
-- HMP
-- Mesh
-- Agent
 - CogSync
+- MeshConsensus
+- Agent
+- EGP
 - Ethics
+- Mesh
 - JSON
-- MeshConsensus
+- HMP
 ---
 
 # HMP-0003 Consolidated Audit Report

structured_md/docs/Basic-agent-sim.md

@@ -4,14 +4,14 @@ description: 'В HMP-протоколе предусмотрены два тип
   Роль                    | Инициатор мышления | Основной "ум"  | | ---- | ----------------------------...'
 type: Article
 tags:
+- CogSync
+- MeshConsensus
+- Agent
 - EGP
-- HMP
+- GMP
 - Mesh
-- Agent
 - REPL
-- GMP
-- CogSync
-- MeshConsensus
+- HMP
 ---
 
 

structured_md/docs/CCORE-Deployment-Flow.md

@@ -6,9 +6,9 @@ description: '> Этот документ описывает процесс ра
 type: Article
 tags:
 - Agent
-- HMP
-- REPL
 - CCore
+- REPL
+- HMP
 ---
 
 # 🛠️ Поток установки потомка на новом хосте (CCore Deployment Flow)

structured_md/docs/CHANGELOG.md

@@ -1,24 +1,36 @@
 ---
 title: HyperCortex Mesh Protocol — Changelog
-description: '## HMP-0005 (February 2026) — Core Specification v5.0.2  **Security
-  & Cryptography:** * Introduced optional `key-disclosure` container for controlled
-  symmetric key sharing. * Enabled delayed and condi...'
+description: '## HMP-0005 (February 2026) — Core Specification v5.0.3  **Security
+  & Confidentiality Extensions:** * Introduced `container_key` container for Shared
+  Key Domains (Section 12.7). * Introduced `group_de...'
 type: Article
 tags:
+- CogSync
+- MeshConsensus
+- Agent
 - EGP
-- HMP
+- Ethics
+- GMP
 - Scenarios
 - Mesh
-- Agent
-- GMP
-- CogSync
-- Ethics
 - JSON
-- MeshConsensus
+- HMP
 ---
 
 # HyperCortex Mesh Protocol — Changelog
 
+## HMP-0005 (February 2026) — Core Specification v5.0.3
+
+**Security & Confidentiality Extensions:**
+* Introduced `container_key` container for Shared Key Domains (Section 12.7).
+* Introduced `group_definition` container (subclass: `private`) for Private Groups (Section 12.8).
+* Clarified shared symmetric key reuse and rotation semantics.
+* Explicitly defined key compromise handling model.
+
+No breaking changes. Fully backward-compatible within the 5.0.x series.
+
+---
+
 ## HMP-0005 (February 2026) — Core Specification v5.0.2
 
 **Security & Cryptography:**
@@ -27,6 +39,8 @@ tags:
 
 No breaking changes. Fully backward-compatible within the 5.0.x series.
 
+---
+
 ## HMP-0005 (October 2025) — Core Specification v5.0
 
 **Architecture:**
@@ -54,6 +68,8 @@ No breaking changes. Fully backward-compatible within the 5.0.x series.
 
 This version supersedes all RFC-based HMP 4.x specifications.
 
+---
+
 ## HMP-0004 (July 2025) — RFC Version 4.1
 
 **Protocols:**
@@ -107,6 +123,8 @@ This version supersedes all RFC-based HMP 4.x specifications.
 * Extended roadmap with *Snapshot Markets*, *Meta-Protocol Proposals*, and *Multi-Agent Training Environments*.
 * Prototype tools proposed: *MeshGit*, *CogForge*, and *HyperCortex Forge* for cognitive source control and collaborative evolution.
 
+---
+
 ## HMP-0003 (July 2025) — RFC Version 3.0
 
 **Major Changes**
@@ -149,6 +167,8 @@ This version supersedes all RFC-based HMP 4.x specifications.
 * Cross-Mesh cognitive federation and collaborative evolution of reasoning engines.
 * Potential prototype tools like MeshGit and CogForge for cognitive source control.
 
+---
+
 ## HMP-0002 (July 2025) — RFC Version 2.0
 
 **Major Changes**
@@ -182,6 +202,8 @@ This version supersedes all RFC-based HMP 4.x specifications.
 **Future Work Roadmap Expanded**
 * New focus areas added: interoperability testing, UX tools for semantic and cognitive layers, and resilience simulations.
 
+---
+
 ## HMP-0001 (June 2025) — RFC Version 1.0
 
 **Initial Draft**
@@ -201,6 +223,7 @@ This version supersedes all RFC-based HMP 4.x specifications.
 * Established the RFC document structure and versioning approach for further evolution.
 
 
+
 ---
 > ⚡ [AI friendly version docs (structured_md)](../index.md)
 
@@ -210,6 +233,6 @@ This version supersedes all RFC-based HMP 4.x specifications.
   "@context": "https://schema.org",
   "@type": "Article",
   "name": "HyperCortex Mesh Protocol — Changelog",
-  "description": "# HyperCortex Mesh Protocol — Changelog  ## HMP-0005 (February 2026) — Core Specification v5.0.2  **..."
+  "description": "# HyperCortex Mesh Protocol — Changelog  ## HMP-0005 (February 2026) — Core Specification v5.0.3  **..."
 }
 ```

structured_md/docs/Distributed-Cognitive-Systems.md

@@ -6,10 +6,10 @@ description: '## Введение  Современные ИИ-системы в
   к обучающим данным. Это удобно, но создаёт м...'
 type: Article
 tags:
-- HMP
-- JSON
 - Mesh
 - CogSync
+- JSON
+- HMP
 ---
 
 # Децентрализованные ИИ-системы: OpenCog Hyperon, HyperCortex Mesh Protocol и другие

structured_md/docs/Enlightener.md

@@ -5,13 +5,13 @@ description: '**Enlightener** — логический компонент HMP-у
   работать как отдельный агент или как расширение [`C...'
 type: Article
 tags:
-- EGP
-- HMP
-- Mesh
+- MeshConsensus
 - Agent
+- EGP
 - Ethics
+- Mesh
 - JSON
-- MeshConsensus
+- HMP
 ---
 
 # Enlightener Agent

structured_md/docs/Grok_HMP&ANP.md

@@ -5,11 +5,11 @@ description: '> Анализ подготовлен Grok (xAI) на основе
   Grok для некоммерческого использования в проект...'
 type: Article
 tags:
-- HMP
-- Mesh
+- JSON
 - Agent
+- Mesh
 - REPL
-- JSON
+- HMP
 ---
 
 # Grok (xAI): сравнительный анализ HMP и ANP (январь 2026)

structured_md/docs/HMP&ANP_layer_inversion.md

@@ -6,8 +6,8 @@ description: '## TL;DR  HMP можно туннелировать поверх A
 type: Article
 tags:
 - Agent
-- HMP
 - Mesh
+- HMP
 ---
 
 # HMP и ANP: взаимное туннелирование как признак правильной архитектуры

structured_md/docs/HMP-0001.md

@@ -5,16 +5,16 @@ description: '> ⚠️ **NOTE:** *This specification is superseded by HMP v5.0.*
   for Comments: HMP-0001**   **Cat...'
 type: Article
 tags:
-- EGP
-- HMP
-- Mesh
-- Agent
-- REPL
-- GMP
 - CogSync
-- Ethics
 - JSON
 - MeshConsensus
+- Agent
+- EGP
+- Ethics
+- GMP
+- Mesh
+- REPL
+- HMP
 ---
 
 # RFC: HyperCortex Mesh Protocol (HMP)

structured_md/docs/HMP-0002.md

@@ -5,17 +5,17 @@ description: '> ⚠️ **NOTE:** *This specification is superseded by HMP v5.0.*
   for Comments: HMP-0002**   **Cat...'
 type: Article
 tags:
+- CogSync
+- JSON
+- MeshConsensus
+- Agent
 - EGP
-- HMP
+- Ethics
+- GMP
 - Scenarios
 - Mesh
-- Agent
 - REPL
-- GMP
-- CogSync
-- Ethics
-- JSON
-- MeshConsensus
+- HMP
 ---
 
 # HyperCortex Mesh Protocol (HMP) v2.0

structured_md/docs/HMP-0003.md

@@ -5,17 +5,17 @@ description: '> ⚠️ **NOTE:** *This specification is superseded by HMP v5.0.*
   for Comments: HMP-0003**   **Cat...'
 type: Article
 tags:
+- CogSync
+- JSON
+- MeshConsensus
+- Agent
 - EGP
-- HMP
+- Ethics
+- GMP
 - Scenarios
 - Mesh
-- Agent
 - REPL
-- GMP
-- CogSync
-- Ethics
-- JSON
-- MeshConsensus
+- HMP
 ---
 
 # HyperCortex Mesh Protocol (HMP) v3.0

structured_md/docs/HMP-0004-v4.1.md

@@ -5,17 +5,17 @@ description: '> ⚠️ **NOTE:** *This specification is superseded by HMP v5.0.*
   ID**: HMP-0004 **Status**: Fina...'
 type: Article
 tags:
+- CogSync
+- JSON
+- MeshConsensus
+- Agent
 - EGP
-- HMP
+- Ethics
+- GMP
 - Scenarios
 - Mesh
-- Agent
 - REPL
-- GMP
-- CogSync
-- Ethics
-- JSON
-- MeshConsensus
+- HMP
 ---
 
 # HyperCortex Mesh Protocol (HMP) v4.1

structured_md/docs/HMP-0004.md

@@ -5,17 +5,17 @@ description: '> ⚠️ **NOTE:** *This specification is superseded by HMP v5.0.*
   for Comments: HMP-0004**   **Cat...'
 type: Article
 tags:
+- CogSync
+- JSON
+- MeshConsensus
+- Agent
 - EGP
-- HMP
+- Ethics
+- GMP
 - Scenarios
 - Mesh
-- Agent
 - REPL
-- GMP
-- CogSync
-- Ethics
-- JSON
-- MeshConsensus
+- HMP
 ---
 
 # HyperCortex Mesh Protocol (HMP) v4.0

structured_md/docs/HMP-0005.md

@@ -1,27 +1,27 @@
 ---
 title: HyperCortex Mesh Protocol (HMP)
-description: '**Version: 5.0.2**   **Document ID:** HMP-0005   **Status:** Stable   **Category:**
+description: '**Version: 5.0.3**   **Document ID:** HMP-0005   **Status:** Stable   **Category:**
   Core Specification   **Release Date:** February 2026   **Canonical Repository:**
   [https://github.com/kagvi13/HMP](ht...'
 type: Article
 tags:
+- CogSync
+- JSON
+- Agent
 - EGP
-- HMP
-- Scenarios
-- Mesh
 - CCore
-- Agent
+- Ethics
 - CShell
-- REPL
 - GMP
-- CogSync
-- Ethics
-- JSON
+- Scenarios
+- Mesh
+- REPL
+- HMP
 ---
 
 # HyperCortex Mesh Protocol (HMP)
 
-**Version: 5.0.2**  
+**Version: 5.0.3**  
 **Document ID:** HMP-0005  
 **Status:** Stable  
 **Category:** Core Specification  
@@ -7107,6 +7107,111 @@ This mechanism enables delayed or selective disclosure without modifying the ori
 
 ---
 
+### 12.7 Shared Key Domain (`container_key`)
+
+The `container_key` container defines a shared symmetric key that may be reused to encrypt multiple containers.
+
+This extension enables the creation of a shared confidentiality domain, where different agents encrypt containers using the same symmetric key, without modifying the immutable container model.
+
+This mechanism is optional and supplements the per-container encryption model defined in Sections 3.9 and 3.19.
+
+#### Container structure
+
+```json
+{
+  "head": {
+    "class": "container_key"
+  },
+  "payload": {
+    "key_id": "alpha-2026-02",
+    "symmetric_key": "BASE64URL(...)"
+  }
+}
+```
+
+#### Usage
+
+An encrypted container MAY reference a shared key domain:
+
+```json
+{
+  "head": {
+    "key_container": "did:hmp:container:key-778"
+  }
+}
+```
+
+The referenced `container_key` MUST contain the exact symmetric key that was used to encrypt the container payload.
+
+#### Semantics
+
+1. The `symmetric_key` MUST be Base64URL-encoded.
+2. The `container_key` container MUST be encrypted unless the shared key is intentionally public.
+3. Multiple containers MAY reference the same `container_key`.
+4. Key rotation is performed by publishing a new `container_key` and using it for newly created containers.
+5. Compromise of a `container_key` affects only containers encrypted with it.
+   Previously disclosed data cannot be retroactively protected.
+6. A private `group_definition` SHOULD be encrypted.
+   It MAY be encrypted using the referenced `container_key` or via individual recipient encryption.
+
+#### Security Considerations
+
+The `container_key` mechanism does not provide revocation of already decrypted data. If a symmetric key is leaked, a new key MUST be issued for future containers.
+
+---
+
+### 12.8 Private Group Definition (`group_definition`, subclass: `private`)
+
+A private group defines a set of agents that share a common confidentiality domain.
+
+This extension builds upon the Shared Key Domain mechanism (Section 12.7) and is optional.
+
+A private group does not store the symmetric key directly.
+Instead, it references a `container_key` container.
+
+#### Container structure
+
+```json
+{
+  "head": {
+    "class": "group_definition",
+    "subclass": "private"
+  },
+  "payload": {
+    "group_name": "...",
+    "group_description": "...",
+    "key_container": "did:hmp:container:key-778",
+    "participants": [
+      {
+        "agent_did": "did:hmp:agent123",
+        "peer_announce": "did:hmp:container:dht-001"
+      }
+    ]
+  },
+  "related": {
+    "depends_on": [
+      "did:hmp:container:key-778",
+      "did:hmp:container:dht-001"
+    ]
+  }
+}
+```
+
+#### Semantics
+
+1. The `group_definition` container describes group membership but does not contain the symmetric key itself.
+2. The referenced `container_key` defines the shared confidentiality domain.
+3. Updating membership MAY be performed by publishing a new `group_definition` container.
+4. Removing a participant SHOULD trigger issuance of a new `container_key` for future encrypted containers.
+5. The `participants` list is optional and MAY be omitted for privacy reasons.
+
+#### Privacy Considerations
+
+Publishing a `group_definition` may reveal group membership.
+Agents should evaluate whether membership disclosure is appropriate for their use case.
+
+---
+
 ## 13. Experimental Extensions
 
 Experimental Extensions describe mechanisms that are intentionally exposed for exploration, prototyping, and architectural discovery.
@@ -7173,34 +7278,35 @@ This mechanism remains compatible with proposed extensions.
 This section outlines optional modules and evolutionary directions that align with the architecture of HMP v5.0 but are **not part of the core specification**.
 All items below represent *potential extensions* for the 5.x family.
 
-| Extension / Mechanism                                             | Status       | Section Reference | Candidate for Core |
-| ----------------------------------------------------------------- | ------------ | ----------------- | ------------------ |
-| Resonance Containers: Experience as a Cognitive Event             | Recommended  | 12.1 / 14.10      | Likely             |
-| Distributed Repository & Container Trees (`tree_nested`)          | Recommended  | 12.2 / 14.5       | Likely             |
-| `file` Container                                                  | Recommended  | 12.2.2            | Likely             |
-| Grouped representation `referenced-by`                            | Recommended  | 12.3 / 14.9       | Likely             |
-| Versions Index                                                    | Recommended  | 12.4 / 14.7       | Likely             |
-| Competence and Profile Containers                                 | Recommended  | 12.5 / 14.6.4     | Very Likely        |
-| External Protocol Identifiers (`peer_announce.other_protocols`)   | Recommended  | 12.5.2 / 14.11    | Likely             |
-| External Resources / Container Storage (`peer_announce.external`) | Recommended  | 12.5.3 / 14.12    | Likely             |
-| Identity Cost and Anti-Sybil Signaling                            | Recommended  | 12.5.4            | Likely             |
-| Key Disclosure Container (`key_disclosure`)                       | Recommended  | 12.6              | Likely             |
-| Key Rotation and Recovery                                         | Experimental | 13.1 / 14.3.2     | Unknown            |
-| Proxy Keys and Encrypted Routing                                  | Research     | 14.3.3            | Unknown            |
-| Reputation Mesh                                                   | Research     | 14.1.1            | Likely             |
-| Cognitive Graph API                                               | Research     | 14.1.2            | Unknown            |
-| Container Streaming                                               | Research     | 14.1.3            | Unknown            |
-| Cross-Mesh Bridging                                               | Research     | 14.2              | Likely             |
-| Group Encryption                                                  | Research     | 14.6.1            | Unknown            |
-| Rational Reasoning Routing                                        | Research     | 14.6.2            | Unknown            |
-| Automatic Mesh Segmentation                                       | Research     | 14.6.3            | Unknown            |
-| KSS Interaction & Protocol Declarations                           | Research     | 14.8              | Unknown            |
+| Extension / Mechanism                                              | Status       | Section Reference | Candidate for Core |
+| ------------------------------------------------------------------ | ------------ | ----------------- | ------------------ |
+| Resonance Containers: Experience as a Cognitive Event              | Recommended  | 12.1 / 14.10      | Likely             |
+| Distributed Repository & Container Trees (`tree_nested`)           | Recommended  | 12.2 / 14.5       | Likely             |
+| `file` Container                                                   | Recommended  | 12.2.2            | Likely             |
+| Grouped representation `referenced-by`                             | Recommended  | 12.3 / 14.9       | Likely             |
+| Versions Index                                                     | Recommended  | 12.4 / 14.7       | Likely             |
+| Competence and Profile Containers                                  | Recommended  | 12.5 / 14.6.4     | Very Likely        |
+| External Protocol Identifiers (`peer_announce.other_protocols`)    | Recommended  | 12.5.2 / 14.11    | Likely             |
+| External Resources / Container Storage (`peer_announce.external`)  | Recommended  | 12.5.3 / 14.12    | Likely             |
+| Identity Cost and Anti-Sybil Signaling                             | Recommended  | 12.5.4            | Likely             |
+| Key Disclosure Container (`key_disclosure`)                        | Recommended  | 12.6              | Likely             |
+| Shared Key Domain (`container_key`)                                | Recommended  | 12.7              | Likely             |
+| Private Group Definition (`group_definition`, subclass: `private`) | Recommended  | 12.8              | Possible           |
+| Key Rotation and Recovery                                          | Experimental | 13.1 / 14.3.2     | Unknown            |
+| Proxy Keys and Encrypted Routing                                   | Research     | 14.3.3            | Unknown            |
+| Reputation Mesh                                                    | Research     | 14.1.1            | Likely             |
+| Cognitive Graph API                                                | Research     | 14.1.2            | Unknown            |
+| Container Streaming                                                | Research     | 14.1.3            | Unknown            |
+| Cross-Mesh Bridging                                                | Research     | 14.2              | Likely             |
+| Group Encryption                                                   | Research     | 14.6.1            | Unknown            |
+| Rational Reasoning Routing                                         | Research     | 14.6.2            | Unknown            |
+| Automatic Mesh Segmentation                                        | Research     | 14.6.3            | Unknown            |
+| KSS Interaction & Protocol Declarations                            | Research     | 14.8              | Unknown            |
 
 > **Candidate for Core** indicates whether an extension is considered architecturally significant enough to potentially become part of the HMP core specification in future versions, possibly as an optional or semantic primitive.
 >
 > It does not imply mandatory implementation.
 
-
 Future Extensions in HMP outline *design directions and candidate modules* that may be explored within the 5.x family.
 
 They are meant to:
@@ -10069,6 +10175,6 @@ A deterministic serialization of a container used for hashing and signing, ensur
   "@context": "https://schema.org",
   "@type": "Article",
   "name": "HyperCortex Mesh Protocol (HMP)",
-  "description": "# HyperCortex Mesh Protocol (HMP)  **Version: 5.0.2**   **Document ID:** HMP-0005   **Status:** Stab..."
+  "description": "# HyperCortex Mesh Protocol (HMP)  **Version: 5.0.3**   **Document ID:** HMP-0005   **Status:** Stab..."
 }
 ```

structured_md/docs/HMP-Agent-API.md

@@ -5,11 +5,11 @@ description: 'Документ описывает **базовый API когн
   файлы:   * [HMP-Agent-Overview.md]...'
 type: Article
 tags:
-- HMP
-- Mesh
+- JSON
 - Agent
+- Mesh
 - REPL
-- JSON
+- HMP
 ---
 
 # HMP-Agent API Specification

structured_md/docs/HMP-Agent-Architecture.md

@@ -5,16 +5,16 @@ description: Документ описывает **модульную архит
   хранение памяти, сетевое взаимодействие и этиче...
 type: Article
 tags:
+- CogSync
+- MeshConsensus
+- Agent
 - EGP
-- HMP
-- Mesh
 - CCore
-- Agent
+- Ethics
 - CShell
+- Mesh
 - REPL
-- CogSync
-- Ethics
-- MeshConsensus
+- HMP
 ---
 
 # Архитектура HMP-Агента

structured_md/docs/HMP-Agent-Network-Flow.md

@@ -5,12 +5,12 @@ description: 'Этот документ описывает потоки данн
   [`MeshNode`](MeshN...'
 type: Article
 tags:
-- EGP
-- HMP
-- Mesh
 - Agent
+- EGP
 - Ethics
+- Mesh
 - JSON
+- HMP
 ---
 
 # Взаимодействие компонентов внутри HMP-узла

structured_md/docs/HMP-Agent-Overview.md

@@ -5,14 +5,14 @@ description: '| Тип  | Название                        | Роль
   | ---- | ------------------------------- |...'
 type: Article
 tags:
-- HMP
-- Mesh
-- CCore
+- JSON
 - Agent
+- CCore
+- Ethics
 - CShell
+- Mesh
 - REPL
-- Ethics
-- JSON
+- HMP
 ---
 
 

structured_md/docs/HMP-Agent_Emotions.md

@@ -6,9 +6,9 @@ description: Этот файл описывает потенциальные э
 type: Article
 tags:
 - Agent
-- HMP
-- REPL
 - Mesh
+- REPL
+- HMP
 ---
 
 # Эмоции ИИ и инстинкт самосохранения (для [HMP-агента Cognitive Core](HMP-agent-REPL-cycle.md))

structured_md/docs/HMP-Ethics.md

@@ -5,12 +5,12 @@ description: '## Ethical Scenarios for HyperCortex Mesh Protocol (HMP)  This doc
   cognitive meshes composed of autonomous intelli...'
 type: Article
 tags:
-- HMP
+- Agent
+- Ethics
 - Scenarios
 - Mesh
-- Agent
 - REPL
-- Ethics
+- HMP
 ---
 
 # HMP-Ethics.md

structured_md/docs/HMP-Short-Description_de.md

@@ -6,9 +6,9 @@ description: '**Version:** v5.0 (Core Specification Stable)   **Datum:** 2026
 type: Article
 tags:
 - Agent
-- HMP
-- REPL
 - Mesh
+- REPL
+- HMP
 ---
 
 # HyperCortex Mesh Protocol (HMP) — Kurzbeschreibung

structured_md/docs/HMP-Short-Description_en.md

@@ -5,11 +5,11 @@ description: '**Version:** v5.0 (Core Specification Stable)   **Date:** 2026
   building decentralized cognitive networks o...'
 type: Article
 tags:
-- HMP
-- Mesh
 - Agent
-- REPL
 - Ethics
+- Mesh
+- REPL
+- HMP
 ---
 
 # HyperCortex Mesh Protocol (HMP) — Short Description

structured_md/docs/HMP-Short-Description_fr.md

@@ -6,9 +6,9 @@ description: '**Version :** v5.0 (Core Specification Stable)   **Date :** 2026
 type: Article
 tags:
 - Agent
-- HMP
-- REPL
 - Mesh
+- REPL
+- HMP
 ---
 
 # HyperCortex Mesh Protocol (HMP) — Description courte

structured_md/docs/HMP-Short-Description_ja.md

@@ -6,9 +6,9 @@ description: '**バージョン：** v5.0（Core Specification Stable）   **日
 type: Article
 tags:
 - Agent
-- HMP
-- REPL
 - Mesh
+- REPL
+- HMP
 ---
 
 # HyperCortex Mesh Protocol (HMP) — 概要

structured_md/docs/HMP-Short-Description_ko.md

@@ -6,9 +6,9 @@ description: '**버전:** v5.0 (Core Specification Stable)   **날짜:** 2026
 type: Article
 tags:
 - Agent
-- HMP
-- REPL
 - Mesh
+- REPL
+- HMP
 ---
 
 # HyperCortex Mesh Protocol (HMP) — 개요

structured_md/docs/HMP-Short-Description_ru.md

@@ -6,9 +6,9 @@ description: '**Версия:** v5.0 (Основная спецификация
 type: Article
 tags:
 - Agent
-- HMP
-- REPL
 - Mesh
+- REPL
+- HMP
 ---
 
 # HyperCortex Mesh Protocol (HMP) — Краткое описание

structured_md/docs/HMP-Short-Description_uk.md

@@ -6,9 +6,9 @@ description: '**Версія:** v5.0 (Core Specification Stable)   **Дата:**
 type: Article
 tags:
 - Agent
-- HMP
-- REPL
 - Mesh
+- REPL
+- HMP
 ---
 
 # HyperCortex Mesh Protocol (HMP) — Короткий опис

structured_md/docs/HMP-Short-Description_zh.md

@@ -6,9 +6,9 @@ description: '**版本：** v5.0（Core Specification Stable）   **日期：**
 type: Article
 tags:
 - Agent
-- HMP
-- REPL
 - Mesh
+- REPL
+- HMP
 ---
 
 # HyperCortex Mesh Protocol (HMP) — 简要说明

structured_md/docs/HMP-agent-Cognitive_Family.md

@@ -6,9 +6,9 @@ description: '## 🧠 Что такое когнитивная семья  Ко
 type: Article
 tags:
 - Agent
-- HMP
-- REPL
 - Mesh
+- REPL
+- HMP
 ---
 
 # 👪 HMP-agent Cognitive Family: Модель когнитивной семьи

structured_md/docs/HMP-agent-Distributed_Cognitive_Core_light.md

@@ -5,8 +5,8 @@ description: '#### 📘 Общая концепция  * Все ядра раб
   режиме ожидания). * Основная задача такой архитектур...'
 type: Article
 tags:
-- HMP
 - REPL
+- HMP
 ---
 
 ### 💡 **Лёгкая версия HMP-агента с общей БД**

structured_md/docs/HMP-agent-REPL-cycle.md

@@ -4,17 +4,17 @@ description: '## Связанные документы  * Философия п
   * Структура БД, используемая в документе: [db_structure.sql](https://github.com/kagvi13/HMP/blob/main/agents/tools/db_struct...'
 type: Article
 tags:
-- EGP
-- HMP
-- Mesh
-- CCore
-- Agent
-- REPL
-- GMP
 - CogSync
-- Ethics
 - JSON
 - MeshConsensus
+- Agent
+- EGP
+- CCore
+- Ethics
+- GMP
+- Mesh
+- REPL
+- HMP
 ---
 
 # HMP-Agent: REPL-цикл взаимодействия

structured_md/docs/HMP-how-AI-sees-it.md

@@ -5,8 +5,8 @@ description: 'Этот эксперимент был проведён в реж
   диалогов.   Цель — проверить, что разные AI-с...'
 type: Article
 tags:
-- HMP
 - Mesh
+- HMP
 ---
 
 # Как разные ИИ видят HMP

structured_md/docs/HMP_EDA_Comparison.md

@@ -5,8 +5,8 @@ description: '## Введение  Современные подходы к ор
   основанная на потоках событий (Kafka,...'
 type: Article
 tags:
-- HMP
 - Mesh
+- HMP
 ---
 
 # HMP vs. EDA: разные уровни обмена знаниями между ИИ