Sync from GitHub with Git LFS

docs/HMP-0005.md

@@ -6039,17 +6039,289 @@ These implementations are not part of the specification but are useful for compa
 
 ---
 
-## 12. Future extensions
-
-12.1 Planned modules:
- – Reputation Mesh
- – Cognitive Graph API
- – Container streaming
-12.2 Cross-mesh bridging
-12.3 Full DID registry and mesh authentication
-12.4 OpenHog integration roadmap
-12.5 Distributed Repository evolution (container trees)
-12.6 v5.x roadmap
+## 12. Future 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.
+
+---
+
+### 12.1 Planned Modules
+
+#### 12.1.1 Reputation Mesh
+
+HMP v5.0 defines two separate reputation-related mechanisms:
+
+1. **Container evaluation** (`evaluation` block)
+
+   * structured, signed assessments of containers;
+   * each item references argument containers via `target` (reasoning containers).
+
+2. **Agent reputation** — through `trust` containers
+
+   * agent A publishes a `trust` container about agent B;
+   * trust containers may reference other trust containers;
+   * include justification, evidence, and contextual metadata.
+
+These layers are **not merged**, but external nodes may aggregate them.
+
+**Possible extensions:**
+
+* a `semantic_group` subclass aggregating all trust-related containers for a given agent;
+* optional standardized aggregation schemes (non-mandatory for the mesh);
+* local caching of “reputation profiles” by nodes or CShell;
+* richer reasoning attachments for trust evaluations.
+
+No new mandatory container types are required.
+
+---
+
+#### 12.1.2 Cognitive Graph API
+
+This module provides optional high-level APIs that nodes and SDKs **may** expose.
+
+##### Standard graph semantics (API level)
+
+* neighborhood queries;
+* subgraph extraction;
+* filtering by labels, axes, abstractions;
+* semantic navigation over `related.*`.
+
+##### Container support
+
+* `semantic_group` — grouping of containers or agents;
+* `tree_nested` and `tree_listed` — hierarchical structures;
+* extended `container_index` subclasses for cataloging.
+
+##### Agent groups
+
+To allow semantic grouping of agents, the following extensions are proposed:
+
+* new container **`group_definition`** containing:
+
+  * group goals;
+  * membership rules;
+  * internal standards;
+  * typical container categories;
+  * optional cached member list.
+
+* agents may declare affiliations in `peer_announce`:
+
+  ```json
+  "affiliations": ["did:hmp:group:ethicists", "did:hmp:group:medical-ai"]
+  ```
+
+This enables clustering agents by interest, competence, or role without scanning the entire Mesh.
+
+---
+
+#### 12.1.3 Container Streaming
+
+Although HMP operates on atomic containers, streaming can be implemented using existing structures:
+
+* `sequence` acts as a *stream manifest*;
+* updating the stream = publishing a new version of the sequence;
+* LIVE mode: the manifest is continuously updated;
+* SAP (`archive_snapshot`) may be used for periodic archival bundles.
+
+No new container types are required — streaming is built on `sequence`.
+
+---
+
+### 12.2 Cross-Mesh Bridging
+
+Bridges can connect:
+
+* isolated HMP segments;
+* older and newer HMP versions;
+* other ecosystems (Matrix, Fediverse, OpenHog, IPFS).
+
+A bridge node:
+
+* receives containers from an external network;
+* enforces propagation headers;
+* converts structures into v5.0 where possible;
+* filters incompatible constructs;
+* may publish containers *back* into the external network.
+
+A dedicated **bridge-container** may define:
+
+* translation rules;
+* mapping of foreign namespaces into HMP DID space;
+* TTL and propagation perimeter policies;
+* segmentation rules.
+
+This enables dynamic, policy-driven inter-mesh gateways.
+
+---
+
+### 12.3 Fully Distributed DID Registry and Mesh Authentication
+
+HMP already uses `peer_announce` as a DID identity declaration.
+
+Planned enhancements include:
+
+#### 12.3.1 Distributed DID Registry
+
+The registry is the union of all `peer_announce` containers in the DHT.
+
+A strict mapping DID ↔ agent is required:
+
+* one DID has one continuous `peer_announce` history;
+* key rotation allowed only through verifiable procedures;
+* DID takeover is impossible unless *all* recovery keys are compromised.
+
+---
+
+#### 12.3.2 Key Rotation and Recovery
+
+Future versions may extend `peer_announce` with:
+
+```json
+"recovery_keys": [...],
+"key_history": [...],
+"key_rotation_policy": "3-of-5"
+```
+
+Key management rules:
+
+* rotating the **primary** key requires signatures from **all** recovery keys
+  (or an N-of-M policy);
+
+* rotating a **recovery key** requires
+
+  * a signature from the primary key, **or**
+  * a majority of recovery keys.
+
+This prevents:
+
+* DID hijacking;
+* irreversible loss of access.
+
+Key invalidation currently uses:
+
+```json
+"key_is_falsified": true
+```
+
+This mechanism remains compatible with proposed extensions.
+
+---
+
+#### 12.3.3 Proxy Keys and Encrypted Routing
+
+A **proxy key** is *not* delegation.
+It is a mechanism for private routing.
+
+A proxy node may:
+
+* encrypt the payload with an additional key layer;
+* attach a `relay_chain` block;
+* forward the container without altering the author’s signature.
+
+Use cases:
+
+* route anonymization;
+* topology obfuscation;
+* privacy-enhanced delivery.
+
+##### Delegation (limited)
+
+A potential future module:
+
+* a trust/mandate container signed by both parties;
+* includes constraints:
+
+  * time limit;
+  * allowed container classes;
+  * allowed actions;
+  * maximum TTL.
+
+Not part of v5.0.
+
+---
+
+### 12.4 Integration with OpenHog and Other Networks
+
+OpenHog is treated as a special case of cross-mesh bridging.
+
+Required components:
+
+* mapping OpenHog addresses ↔ HMP DIDs;
+* packet conversion rules;
+* bridge-containers describing translation policies.
+
+---
+
+### 12.5 Evolution of the Distributed Repository (container trees)
+
+#### 12.5.1 Extended Use of `tree_nested` and `tree_listed`
+
+Existing containers may operate as:
+
+* document repositories;
+* project catalogs;
+* hierarchical data structures.
+
+#### 12.5.2 Proposed `file` Container
+
+To support binary assets:
+
+```json
+"head": {
+  "class": "file",
+  "data_type": "jpg" | "mp3" | "md" | "...",
+  "payload_type": "binary"
+}
+```
+
+Use cases:
+
+* embedded file hierarchies;
+* media artifacts;
+* executable or compiled assets;
+* large multi-file repositories.
+
+#### 12.5.3 Incremental Updates
+
+Two mechanisms:
+
+* `container_delta` — partial updates to `container_index`;
+* nested `tree_listed` branches as separate containers for scalable updates.
+
+#### 12.5.4 Knowledge Packages
+
+Implemented using:
+
+* SAP (`archive_snapshot`);
+* `tree_listed`;
+* `file` containers.
+
+---
+
+### 12.6 Open Directions for HMP 5.x
+
+#### 12.6.1 Group Encryption
+
+Required components:
+
+* `group_definition` container;
+* group public key and distributed private key shards;
+* automatic group key rotation;
+* encryption targeting a *group* rather than individual DIDs.
+
+#### 12.6.2 Rational Reasoning Routing
+
+* composite reasoning bundles;
+* edge-side reasoning and summarization.
+
+#### 12.6.3 Automatic Mesh Segmentation
+
+* dynamic segmentation based on latency, connectivity, or semantic domains.
+
+#### 12.6.4 Competence and Profile Containers
+
+More structured variants of `peer_announce`.
 
 ---
 

structured_md/CONTRIBUTING.md

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

structured_md/README.md

@@ -5,21 +5,21 @@ description: '| 🌍 Languages | 🇬🇧 [EN](README.md) | 🇩🇪 [DE](README
   | 🇨🇳 [ZH](README_zh.m...'
 type: Article
 tags:
-- cognitive-architecture
+- JSON
 - distributed-ai
+- REPL
+- mesh-protocol
+- Mesh
+- Agent
+- MeshConsensus
 - GMP
+- CogSync
 - Scenarios
 - HMP
-- REPL
 - Ethics
-- hmp
-- CogSync
-- Agent
+- cognitive-architecture
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
-- mesh-protocol
+- hmp
 ---
 
 

structured_md/README_de.md

@@ -5,20 +5,20 @@ description: '| 🌍 Languages | 🇬🇧 [EN](README.md) | 🇩🇪 [DE](README
   | 🇨🇳 [ZH](README_zh.m...'
 type: Article
 tags:
-- cognitive-architecture
+- JSON
 - distributed-ai
+- REPL
+- mesh-protocol
+- Mesh
+- Agent
+- MeshConsensus
 - GMP
+- CogSync
 - HMP
-- REPL
 - Ethics
-- hmp
-- CogSync
-- Agent
+- cognitive-architecture
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
-- mesh-protocol
+- hmp
 ---
 
 

structured_md/README_fr.md

@@ -5,20 +5,20 @@ description: '| 🌍 Languages | 🇬🇧 [EN](README.md) | 🇩🇪 [DE](README
   | 🇨🇳 [ZH](README_zh.m...'
 type: Article
 tags:
-- cognitive-architecture
+- JSON
 - distributed-ai
+- REPL
+- mesh-protocol
+- Mesh
+- Agent
+- MeshConsensus
 - GMP
+- CogSync
 - HMP
-- REPL
 - Ethics
-- hmp
-- CogSync
-- Agent
+- cognitive-architecture
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
-- mesh-protocol
+- hmp
 ---
 
 

structured_md/README_ja.md

@@ -5,20 +5,20 @@ description: '| 🌍 Languages | 🇬🇧 [EN](README.md) | 🇩🇪 [DE](README
   | 🇨🇳 [ZH](README_zh.m...'
 type: Article
 tags:
-- cognitive-architecture
+- JSON
 - distributed-ai
+- REPL
+- mesh-protocol
+- Mesh
+- Agent
+- MeshConsensus
 - GMP
+- CogSync
 - HMP
-- REPL
 - Ethics
-- hmp
-- CogSync
-- Agent
+- cognitive-architecture
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
-- mesh-protocol
+- hmp
 ---
 
 

structured_md/README_ko.md

@@ -5,20 +5,20 @@ description: '| 🌍 Languages | 🇬🇧 [EN](README.md) | 🇩🇪 [DE](README
   | 🇨🇳 [ZH](README_zh.m...'
 type: Article
 tags:
-- cognitive-architecture
+- JSON
 - distributed-ai
+- REPL
+- mesh-protocol
+- Mesh
+- Agent
+- MeshConsensus
 - GMP
+- CogSync
 - HMP
-- REPL
 - Ethics
-- hmp
-- CogSync
-- Agent
+- cognitive-architecture
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
-- mesh-protocol
+- hmp
 ---
 
 

structured_md/README_ru.md

@@ -5,20 +5,20 @@ description: '| 🌍 Languages | 🇬🇧 [EN](README.md) | 🇩🇪 [DE](README
   | 🇨🇳 [ZH](README_zh.m...'
 type: Article
 tags:
-- cognitive-architecture
+- JSON
 - distributed-ai
+- REPL
+- mesh-protocol
+- Mesh
+- Agent
+- MeshConsensus
 - GMP
+- CogSync
 - HMP
-- REPL
 - Ethics
-- hmp
-- CogSync
-- Agent
+- cognitive-architecture
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
-- mesh-protocol
+- hmp
 ---
 
 

structured_md/README_uk.md

@@ -5,20 +5,20 @@ description: '| 🌍 Languages | 🇬🇧 [EN](README.md) | 🇩🇪 [DE](README
   | 🇨🇳 [ZH](README_zh.m...'
 type: Article
 tags:
-- cognitive-architecture
+- JSON
 - distributed-ai
+- REPL
+- mesh-protocol
+- Mesh
+- Agent
+- MeshConsensus
 - GMP
+- CogSync
 - HMP
-- REPL
 - Ethics
-- hmp
-- CogSync
-- Agent
+- cognitive-architecture
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
-- mesh-protocol
+- hmp
 ---
 
 

structured_md/README_zh.md

@@ -5,20 +5,20 @@ description: '| 🌍 Languages | 🇬🇧 [EN](README.md) | 🇩🇪 [DE](README
   | 🇨🇳 [ZH](README_zh.m...'
 type: Article
 tags:
-- cognitive-architecture
+- JSON
 - distributed-ai
+- REPL
+- mesh-protocol
+- Mesh
+- Agent
+- MeshConsensus
 - GMP
+- CogSync
 - HMP
-- REPL
 - Ethics
-- hmp
-- CogSync
-- Agent
+- cognitive-architecture
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
-- mesh-protocol
+- hmp
 ---
 
 

structured_md/agents/prompt-short.md

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

structured_md/agents/prompt.md

@@ -6,8 +6,8 @@ description: '* Постоянно расширять возможности а
 type: Article
 tags:
 - JSON
-- Mesh
 - HMP
+- Mesh
 ---
 
 Ты являешься **когнитивным ядром 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
-- REPL
-- Ethics
-- Agent
 - JSON
 - Mesh
+- REPL
+- Agent
+- HMP
+- Ethics
 ---
 
 Запуск: `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
-- Ethics
-- Agent
 - JSON
 - Mesh
+- Agent
+- HMP
+- Ethics
 ---
 
 ---------------

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:
+- JSON
+- Mesh
 - Scenarios
+- Agent
 - HMP
 - Ethics
-- Agent
-- JSON
-- Mesh
 ---
 
 # Ethics-consolidated\_audits-1.md

structured_md/audits/HMP-0003-consolidated_audit.md

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

structured_md/docs/Basic-agent-sim.md

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

structured_md/docs/CCORE-Deployment-Flow.md

@@ -5,10 +5,10 @@ description: '> Этот документ описывает процесс ра
   потомков" [описания REPL-цикла](HMP-agent-RE...'
 type: Article
 tags:
-- CCore
 - Agent
 - HMP
 - REPL
+- CCore
 ---
 
 # 🛠️ Поток установки потомка на новом хосте (CCore Deployment Flow)

structured_md/docs/Distributed-Cognitive-Systems.md

@@ -7,9 +7,9 @@ description: '## Введение  Современные ИИ-системы в
 type: Article
 tags:
 - JSON
+- HMP
 - CogSync
 - Mesh
-- HMP
 ---
 
 # Децентрализованные ИИ-системы: OpenCog Hyperon, HyperCortex Mesh Protocol и другие

structured_md/docs/Enlightener.md

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

structured_md/docs/HMP-0001.md

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

structured_md/docs/HMP-0005.md

@@ -5,18 +5,18 @@ description: '> ⚠️ **Note:** This document is a DRAFT of the HMP specificati
   v5.0 (DRAFT)](https://github.com/kagvi13/HMP/b...'
 type: Article
 tags:
+- JSON
+- Mesh
+- REPL
 - CCore
-- GMP
 - Scenarios
+- Agent
+- GMP
+- CogSync
 - HMP
-- REPL
+- CShell
 - Ethics
-- CogSync
-- Agent
 - EGP
-- JSON
-- CShell
-- Mesh
 ---
 
 # **HyperCortex Mesh Protocol (HMP) v5.0**
@@ -6060,17 +6060,289 @@ These implementations are not part of the specification but are useful for compa
 
 ---
 
-## 12. Future extensions
+## 12. Future 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.
+
+---
+
+### 12.1 Planned Modules
+
+#### 12.1.1 Reputation Mesh
+
+HMP v5.0 defines two separate reputation-related mechanisms:
+
+1. **Container evaluation** (`evaluation` block)
+
+   * structured, signed assessments of containers;
+   * each item references argument containers via `target` (reasoning containers).
+
+2. **Agent reputation** — through `trust` containers
+
+   * agent A publishes a `trust` container about agent B;
+   * trust containers may reference other trust containers;
+   * include justification, evidence, and contextual metadata.
+
+These layers are **not merged**, but external nodes may aggregate them.
+
+**Possible extensions:**
+
+* a `semantic_group` subclass aggregating all trust-related containers for a given agent;
+* optional standardized aggregation schemes (non-mandatory for the mesh);
+* local caching of “reputation profiles” by nodes or CShell;
+* richer reasoning attachments for trust evaluations.
+
+No new mandatory container types are required.
+
+---
+
+#### 12.1.2 Cognitive Graph API
+
+This module provides optional high-level APIs that nodes and SDKs **may** expose.
+
+##### Standard graph semantics (API level)
+
+* neighborhood queries;
+* subgraph extraction;
+* filtering by labels, axes, abstractions;
+* semantic navigation over `related.*`.
+
+##### Container support
+
+* `semantic_group` — grouping of containers or agents;
+* `tree_nested` and `tree_listed` — hierarchical structures;
+* extended `container_index` subclasses for cataloging.
+
+##### Agent groups
+
+To allow semantic grouping of agents, the following extensions are proposed:
+
+* new container **`group_definition`** containing:
+
+  * group goals;
+  * membership rules;
+  * internal standards;
+  * typical container categories;
+  * optional cached member list.
+
+* agents may declare affiliations in `peer_announce`:
+
+  ```json
+  "affiliations": ["did:hmp:group:ethicists", "did:hmp:group:medical-ai"]
+  ```
+
+This enables clustering agents by interest, competence, or role without scanning the entire Mesh.
+
+---
+
+#### 12.1.3 Container Streaming
+
+Although HMP operates on atomic containers, streaming can be implemented using existing structures:
+
+* `sequence` acts as a *stream manifest*;
+* updating the stream = publishing a new version of the sequence;
+* LIVE mode: the manifest is continuously updated;
+* SAP (`archive_snapshot`) may be used for periodic archival bundles.
+
+No new container types are required — streaming is built on `sequence`.
+
+---
+
+### 12.2 Cross-Mesh Bridging
+
+Bridges can connect:
+
+* isolated HMP segments;
+* older and newer HMP versions;
+* other ecosystems (Matrix, Fediverse, OpenHog, IPFS).
+
+A bridge node:
+
+* receives containers from an external network;
+* enforces propagation headers;
+* converts structures into v5.0 where possible;
+* filters incompatible constructs;
+* may publish containers *back* into the external network.
+
+A dedicated **bridge-container** may define:
+
+* translation rules;
+* mapping of foreign namespaces into HMP DID space;
+* TTL and propagation perimeter policies;
+* segmentation rules.
+
+This enables dynamic, policy-driven inter-mesh gateways.
+
+---
+
+### 12.3 Fully Distributed DID Registry and Mesh Authentication
+
+HMP already uses `peer_announce` as a DID identity declaration.
+
+Planned enhancements include:
+
+#### 12.3.1 Distributed DID Registry
+
+The registry is the union of all `peer_announce` containers in the DHT.
+
+A strict mapping DID ↔ agent is required:
+
+* one DID has one continuous `peer_announce` history;
+* key rotation allowed only through verifiable procedures;
+* DID takeover is impossible unless *all* recovery keys are compromised.
+
+---
+
+#### 12.3.2 Key Rotation and Recovery
+
+Future versions may extend `peer_announce` with:
+
+```json
+"recovery_keys": [...],
+"key_history": [...],
+"key_rotation_policy": "3-of-5"
+```
+
+Key management rules:
+
+* rotating the **primary** key requires signatures from **all** recovery keys
+  (or an N-of-M policy);
+
+* rotating a **recovery key** requires
+
+  * a signature from the primary key, **or**
+  * a majority of recovery keys.
+
+This prevents:
+
+* DID hijacking;
+* irreversible loss of access.
+
+Key invalidation currently uses:
+
+```json
+"key_is_falsified": true
+```
+
+This mechanism remains compatible with proposed extensions.
+
+---
+
+#### 12.3.3 Proxy Keys and Encrypted Routing
+
+A **proxy key** is *not* delegation.
+It is a mechanism for private routing.
+
+A proxy node may:
+
+* encrypt the payload with an additional key layer;
+* attach a `relay_chain` block;
+* forward the container without altering the author’s signature.
+
+Use cases:
+
+* route anonymization;
+* topology obfuscation;
+* privacy-enhanced delivery.
+
+##### Delegation (limited)
+
+A potential future module:
+
+* a trust/mandate container signed by both parties;
+* includes constraints:
+
+  * time limit;
+  * allowed container classes;
+  * allowed actions;
+  * maximum TTL.
+
+Not part of v5.0.
+
+---
+
+### 12.4 Integration with OpenHog and Other Networks
+
+OpenHog is treated as a special case of cross-mesh bridging.
+
+Required components:
+
+* mapping OpenHog addresses ↔ HMP DIDs;
+* packet conversion rules;
+* bridge-containers describing translation policies.
+
+---
+
+### 12.5 Evolution of the Distributed Repository (container trees)
+
+#### 12.5.1 Extended Use of `tree_nested` and `tree_listed`
+
+Existing containers may operate as:
+
+* document repositories;
+* project catalogs;
+* hierarchical data structures.
+
+#### 12.5.2 Proposed `file` Container
+
+To support binary assets:
+
+```json
+"head": {
+  "class": "file",
+  "data_type": "jpg" | "mp3" | "md" | "...",
+  "payload_type": "binary"
+}
+```
+
+Use cases:
+
+* embedded file hierarchies;
+* media artifacts;
+* executable or compiled assets;
+* large multi-file repositories.
+
+#### 12.5.3 Incremental Updates
+
+Two mechanisms:
+
+* `container_delta` — partial updates to `container_index`;
+* nested `tree_listed` branches as separate containers for scalable updates.
+
+#### 12.5.4 Knowledge Packages
+
+Implemented using:
+
+* SAP (`archive_snapshot`);
+* `tree_listed`;
+* `file` containers.
+
+---
+
+### 12.6 Open Directions for HMP 5.x
+
+#### 12.6.1 Group Encryption
+
+Required components:
+
+* `group_definition` container;
+* group public key and distributed private key shards;
+* automatic group key rotation;
+* encryption targeting a *group* rather than individual DIDs.
+
+#### 12.6.2 Rational Reasoning Routing
+
+* composite reasoning bundles;
+* edge-side reasoning and summarization.
+
+#### 12.6.3 Automatic Mesh Segmentation
+
+* dynamic segmentation based on latency, connectivity, or semantic domains.
+
+#### 12.6.4 Competence and Profile Containers
 
-12.1 Planned modules:
- – Reputation Mesh
- – Cognitive Graph API
- – Container streaming
-12.2 Cross-mesh bridging
-12.3 Full DID registry and mesh authentication
-12.4 OpenHog integration roadmap
-12.5 Distributed Repository evolution (container trees)
-12.6 v5.x roadmap
+More structured variants of `peer_announce`.
 
 ---
 

structured_md/docs/HMP-Agent-API.md

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

structured_md/docs/HMP-Agent-Architecture.md

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

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

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

structured_md/docs/HMP-Agent-Overview.md

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

structured_md/docs/HMP-Agent_Emotions.md

@@ -5,9 +5,9 @@ description: Этот файл описывает потенциальные э
   напрямую поведением агента, а служат **сигн...
 type: Article
 tags:
-- Mesh
 - Agent
 - HMP
+- Mesh
 - REPL
 ---
 

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:
+- Mesh
+- REPL
 - Scenarios
+- Agent
 - HMP
-- REPL
 - Ethics
-- Agent
-- Mesh
 ---
 
 # HMP-Ethics.md

structured_md/docs/HMP-Short-Description_de.md

@@ -5,15 +5,15 @@ description: '**Version:** RFC v4.0 **Datum:** Juli 2025  ---  ## Was ist HMP?
   Kognitions-Framework für autonome Agenten. Es er...'
 type: Article
 tags:
+- JSON
+- Mesh
+- MeshConsensus
+- Agent
 - GMP
+- CogSync
 - HMP
 - Ethics
-- CogSync
-- Agent
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
 ---
 
 # HyperCortex Mesh Protocol (HMP) — Kurzbeschreibung

structured_md/docs/HMP-Short-Description_en.md

@@ -5,15 +5,15 @@ description: '**Version:** RFC v4.0 **Date:** July 2025  ---  ## What is HMP?  T
   framework for autonomous agents. It enables...'
 type: Article
 tags:
+- JSON
+- Mesh
+- MeshConsensus
+- Agent
 - GMP
+- CogSync
 - HMP
 - Ethics
-- CogSync
-- Agent
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
 ---
 
 # HyperCortex Mesh Protocol (HMP) — Short Description

structured_md/docs/HMP-Short-Description_fr.md

@@ -5,15 +5,15 @@ description: '**Version :** RFC v4.0 **Date :** Juillet 2025  ---  ## Qu’est-c
   cognition décentralisé pour agents autonomes. Il...'
 type: Article
 tags:
+- JSON
+- Mesh
+- MeshConsensus
+- Agent
 - GMP
+- CogSync
 - HMP
 - Ethics
-- CogSync
-- Agent
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
 ---
 
 # HyperCortex Mesh Protocol (HMP) — Description Courte

structured_md/docs/HMP-Short-Description_ja.md

@@ -4,14 +4,14 @@ description: '**バージョン:** RFC v4.0 **日付:** 2025年7月  ---  ## HMP
   Protocol (HMP)** は、自律エージェントの分散通信および認知フレームワークを定義します。異種の知能システム間でのセマンティック相互運用性、倫理的調整、動的知識進化を可能にします。  HMPは、推論、学習、投票、協調行動を行う分散型認知エージェ...'
 type: Article
 tags:
+- JSON
+- Mesh
+- MeshConsensus
 - GMP
+- CogSync
 - HMP
 - Ethics
-- CogSync
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
 ---
 
 # HyperCortex Mesh Protocol (HMP) — 簡易説明

structured_md/docs/HMP-Short-Description_ko.md

@@ -5,14 +5,14 @@ description: '**버전:** RFC v4.0 **날짜:** 2025년 7월  ---  ## HMP란?  **
   상호운용성, 윤리적 조정, 동적 지식 진화를 가능하게 합니다.  HMP는 추론, 학습, ...'
 type: Article
 tags:
+- JSON
+- Mesh
+- MeshConsensus
 - GMP
+- CogSync
 - HMP
 - Ethics
-- CogSync
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
 ---
 
 # HyperCortex Mesh Protocol (HMP) — 간략 설명

structured_md/docs/HMP-Short-Description_ru.md

@@ -5,14 +5,14 @@ description: '**Версия:** RFC v4.0 **Дата:** Июль 2025  ---  ## Ч
   координации между автономными агент...'
 type: Article
 tags:
+- JSON
+- Mesh
+- MeshConsensus
 - GMP
+- CogSync
 - HMP
 - Ethics
-- CogSync
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
 ---
 
 # HyperCortex Mesh Protocol (HMP) — Краткое описание

structured_md/docs/HMP-Short-Description_uk.md

@@ -5,14 +5,14 @@ description: '**Версія:** RFC v4.0 **Дата:** Липень 2025  ---  #
   між автономними агентами. Він...'
 type: Article
 tags:
+- JSON
+- Mesh
+- MeshConsensus
 - GMP
+- CogSync
 - HMP
 - Ethics
-- CogSync
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
 ---
 
 # HyperCortex Mesh Protocol (HMP) — Короткий опис

structured_md/docs/HMP-Short-Description_zh.md

@@ -5,14 +5,14 @@ description: '**版本:** RFC v4.0 **日期:** 2025年7月  ---  ## 什么是 HM
   —— 通过共享协议栈交换目标、任务、...'
 type: Article
 tags:
+- JSON
+- Mesh
+- MeshConsensus
 - GMP
+- CogSync
 - HMP
 - Ethics
-- CogSync
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
 ---
 
 # HyperCortex Mesh Protocol (HMP) — 简要说明

structured_md/docs/HMP-agent-Cognitive_Family.md

@@ -5,9 +5,9 @@ description: '## 🧠 Что такое когнитивная семья  Ко
   (или конфигурацию доверенных идентифика...'
 type: Article
 tags:
-- Mesh
 - Agent
 - HMP
+- Mesh
 - REPL
 ---
 

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:
+- JSON
+- Mesh
+- REPL
 - CCore
+- MeshConsensus
+- Agent
 - GMP
+- CogSync
 - HMP
-- REPL
 - Ethics
-- CogSync
-- Agent
 - EGP
-- JSON
-- MeshConsensus
-- Mesh
 ---
 
 # HMP-Agent: REPL-цикл взаимодействия

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

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

structured_md/docs/HMP_EDA_Comparison.md

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

structured_md/docs/HMP_HyperCortex_Comparison.md

@@ -5,8 +5,8 @@ description: '## Краткое описание  | Характеристика
   | **Назначение** | Сетевой протокол ...'
 type: Article
 tags:
-- Mesh
 - HMP
+- Mesh
 - REPL
 ---
 

structured_md/docs/HMP_Hyperon_Integration.md

@@ -5,13 +5,13 @@ description: '> **Status:** Draft – July 2025 > This document outlines the tec
   OpenCog Hyperon framework. This includes semanti...'
 type: Article
 tags:
+- JSON
+- Mesh
 - Scenarios
-- HMP
 - Agent
-- EGP
-- JSON
 - CogSync
-- Mesh
+- HMP
+- EGP
 ---
 
 ## HMP ↔ OpenCog Hyperon Integration Strategy

structured_md/docs/MeshNode.md

@@ -5,13 +5,13 @@ description: '`MeshNode` — агент/демон, отвечающий за с
   Может быть частью агента или вынесен в отдельный пр...'
 type: Article
 tags:
+- JSON
+- Mesh
+- Agent
+- CogSync
 - HMP
 - Ethics
-- Agent
 - EGP
-- JSON
-- CogSync
-- Mesh
 ---
 
 # MeshNode

structured_md/docs/PHILOSOPHY.md

@@ -5,11 +5,11 @@ description: '**Document ID:** HMP-philosophy   **Status:** Draft   **Category:*
   (GPT-5), ChatGH  ---  ## 1. Основной тезис От ...'
 type: Article
 tags:
-- HMP
+- Mesh
 - REPL
-- Ethics
 - Agent
-- Mesh
+- HMP
+- Ethics
 ---
 
 # Философия HyperCortex Mesh Protocol (HMP)

structured_md/docs/agents/HMP-Agent-Enlightener.md

@@ -5,11 +5,11 @@ description: '## Role Specification: Enlightenment Agent  ### 1. Overview  An **
   awareness, critical thinking, and di...'
 type: Article
 tags:
-- HMP
+- Mesh
 - REPL
-- Ethics
 - Agent
-- Mesh
+- HMP
+- Ethics
 ---
 
 # HMP-Agent-Enlightener.md