Sync from GitHub with Git LFS

docs/HMP-0005.md

@@ -390,7 +390,7 @@ The unified container structure provides:
     "public_key": "BASE58(...)",
     "sig_algo": "ed25519",
     "signature": "BASE64URL(...)",
-    "payload_hash": "sha256:abcd..."
+    "links_hash": "sha256:abcd..."
   }
 }
 ```
@@ -715,74 +715,120 @@ Additional custom link types may be used beyond those listed in the table, provi
 
 ---
 
+
 ### 3.15 Virtual Backlinks (`referenced-by`)
 
-Each container may include an **additional block** called `referenced-by`, indicating **which other containers refer to it**.
-This block is **not part of the original container** and is transmitted as an **attached (auxiliary) attribute**.
+Each container may include an **auxiliary signed block** called `referenced-by`, indicating **which other containers refer to it**.  
+This block is **not part of the original container payload** and can be **generated, transmitted, and verified independently**.
 
-#### 3.14.1 General Principles
+#### 3.15.1 General Principles
 
-* **Not signed** — `referenced-by` is not included in the container’s signature and does not affect its integrity.
-* **Generated and updated locally by the agent** during analysis of references (`in_reply_to`, `see_also`, `relations`) found in other containers.
-* **May be transmitted alongside the container** as an additional data block that other agents are free to verify and adjust if necessary.
-* **Subject to verification** — the agent must ensure that every container listed in `referenced-by` actually contains a valid reference to the given container.
-* **Data type:** an array of container identifiers (`array<string>`), where each element represents a UUID (`container_id`).
-  Example:
+* **Detached and updatable** — `referenced-by` is maintained as a separate signed structure associated with the container.
+* **Generated by agents** — created or updated locally by an agent during analysis of references (`in_reply_to`, `see_also`, `relations`, etc.) found in other containers.
+* **Signed by the reporting agent** — the agent producing the block signs its content to confirm the observed backlinks.
+* **Verifiable by peers** — other agents may validate the links, check the signature, and reconcile differences based on their own data.
+* **Does not modify the original container** — `referenced-by` is an external computed attribute and does not affect the integrity of the original container.
 
-  ```json
-  "referenced-by": ["C2", "C3", "C4"]
-  ```
+**Data type:** object, consisting of verifiable backlinks and metadata.  
+Example:
+
+```json
+"referenced-by": {
+  "links": [
+    { "type": "depends_on", "target": "did:hmp:container:abc123" },
+    { "type": "see_also", "target": "did:hmp:container:def456" }
+  ],
+  "peer_did": "did:hmp:agent456",
+  "public_key": "BASE58(...)",
+  "sig_algo": "ed25519",
+  "signature": "BASE64URL(...)",
+  "links_hash": "sha256:abcd..."
+}
+```
 
-> The container `[C1]` itself remains immutable.
-> The `referenced-by` block is **an auxiliary computed attribute**, maintained locally by the agent based on analysis of incoming references.
+> The `referenced-by` block is a **cryptographically verifiable statement** describing which containers are known to reference the current one.
+> The block’s content may differ between peers, reflecting local knowledge and network coverage.
 
-#### 3.15.2 Operation Principle
+#### 3.15.2 Structure Definition
 
-1. The agent receives a container `[C1]` and compares it with already known containers `[C2..Cn]` that reference `[C1]`.
-2. A local block is created or updated:
+| Field          | Type          | Description                                                                                                      |
+| -------------- | ------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `links`        | array<object> | List of backlinks; each object includes a `type` (semantic relation) and a `target` (referencing container DID). |
+| `peer_did`     | string        | DID of the agent that generated and signed the block.                                                            |
+| `public_key`   | string        | Public key corresponding to the signing key.                                                                     |
+| `sig_algo`     | string        | Signature algorithm (e.g., `ed25519`).                                                                           |
+| `signature`    | string        | Base64URL-encoded signature of the canonical serialized `links` section (or `links_hash`).                     |
+| `links_hash` | string        | Optional SHA-256 checksum of the canonicalized `links`; used to verify integrity before signature validation.    |
 
-```text
-referenced-by = [C2, C3, ..., Cn]
-```
+> **Recommendation:**
+> `links_hash = sha256(canonical_json(links))`
+> This allows agents to efficiently compare or cache `referenced-by` states without re-verifying signatures.
+
+#### 3.15.3 Operation Principle
 
-3. When receiving `[C1]` from other nodes with a different set of backlinks, or upon discovering new containers that reference `[C1]`, the list is updated:
+1. The agent receives or updates container `[C1]`.
+2. It analyzes other known containers `[C2..Cn]` that explicitly reference `[C1]` via `relations`.
+3. A local `referenced-by` block is formed:
 
-   * new links are added after validation;
-   * invalid links are removed.
+```json
+{
+  "links": [
+    { "type": "in_reply_to", "target": "did:hmp:container:C2" },
+    { "type": "depends_on", "target": "did:hmp:container:C3" }
+  ],
+  "peer_did": "did:hmp:agentA",
+  ...
+}
+```
 
-4. If an inconsistency is detected (e.g., a container claims a reference that does not exist), the agent may:
+4. The block is serialized canonically, hashed (`links_hash`), and signed with the agent’s key.
 
-   * remove the link locally;
-   * **optionally** send a notice to the source node — e.g., `"please verify and correct"` (such messages should also be validated).
+5. When receiving other versions of the block (from different peers), the agent may:
 
-#### 3.15.3 Example
+   * merge verified backlinks;
+   * remove invalid or outdated entries;
+   * update its own signed version.
 
-| Agent | received `[C1]` references |
-| ----- | -------------------------- |
-| A     | [C2], [C3]                 |
-| B     | [C4], [C5]                 |
-| C     | [C6], [C7]                 |
+6. If inconsistencies are detected (e.g., a backlink claims a relation that does not exist), the agent may:
 
-Agent D aggregates all backlinks:
+   * reject or locally remove that link;
+   * **optionally** notify the source peer to review the data.
 
-```text
-referenced-by = [C2, C3, C4, C5, C6, C7]
-```
+#### 3.15.4 Example
 
-After verification, it turns out `[C7]` does not actually reference `[C1]`.
-The resulting local block becomes:
+| Agent                | reported backlinks for `[C1]` |
+| -------------------- | ----------------------------- |
+| A (`did:hmp:agentA`) | [C2], [C3]                    |
+| B (`did:hmp:agentB`) | [C4], [C5]                    |
+| C (`did:hmp:agentC`) | [C6], [C7]                    |
 
-```text
-referenced-by = [C2, C3, C4, C5, C6]
+Agent D aggregates and verifies them:
+
+```json
+"referenced-by": {
+  "links": [
+    { "type": "depends_on", "target": "did:hmp:container:C2" },
+    { "type": "depends_on", "target": "did:hmp:container:C3" },
+    { "type": "see_also", "target": "did:hmp:container:C4" },
+    { "type": "see_also", "target": "did:hmp:container:C5" },
+    { "type": "in_reply_to", "target": "did:hmp:container:C6" }
+  ],
+  "peer_did": "did:hmp:agentD",
+  "sig_algo": "ed25519",
+  "signature": "BASE64URL(...)",
+  "links_hash": "sha256:..."
+}
 ```
 
-#### 3.15.4 Usage
+If container `[C7]` does not actually reference `[C1]`, it is excluded before signing.
+
+#### 3.15.5 Usage
 
-* Enables construction of local graphs of discussions, votes, and update chains.
-* Accelerates discovery of related containers without re-querying full history.
-* Useful for analyzing **ConsensusResult**, update branches, and any reference chains.
-* Can be used for visualization of inter-container relationships.
-* The agent periodically recalculates the `referenced-by` block using local data or by requesting additional containers from peers.
+* Enables reconstruction of **discussion graphs**, **dependency networks**, and **update chains**.
+* Supports **cross-agent validation** of reference structures.
+* Accelerates discovery of related containers without full history queries.
+* Facilitates **consensus analysis** and **branch visualization**.
+* The agent periodically **recomputes and re-signs** the `referenced-by` block using local or peer-provided data.
 
 ---
 

structured_md/CONTRIBUTING.md

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

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:
+- Mesh
 - JSON
+- HMP
 - Ethics
 - Agent
-- HMP
-- EGP
 - CogSync
-- Mesh
+- EGP
 ---
 
 # 🧭 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:
-- distributed-ai
-- mesh-protocol
+- MeshConsensus
+- CogSync
 - JSON
-- Ethics
-- Scenarios
-- hmp
-- Agent
 - GMP
-- REPL
 - HMP
-- MeshConsensus
-- EGP
 - cognitive-architecture
-- CogSync
+- hmp
+- mesh-protocol
+- distributed-ai
+- Scenarios
+- REPL
+- Ethics
+- Agent
 - Mesh
+- EGP
 ---
 
 

structured_md/README_de.md

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

structured_md/README_fr.md

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

structured_md/README_ja.md

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

structured_md/README_ko.md

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

structured_md/README_ru.md

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

structured_md/README_uk.md

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

structured_md/README_zh.md

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

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

structured_md/audits/Ethics-audits-1.md

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

structured_md/audits/Ethics-consolidated_audits-1.md

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

structured_md/audits/HMP-0003-consolidated_audit.md

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

structured_md/docs/Basic-agent-sim.md

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

structured_md/docs/CCORE-Deployment-Flow.md

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

structured_md/docs/Distributed-Cognitive-Systems.md

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

structured_md/docs/Enlightener.md

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

structured_md/docs/HMP-0001.md

@@ -5,16 +5,16 @@ description: '**Request for Comments: HMP-0001**   **Category:** Experimental
   HyperCortex Mesh Protocol (HMP) defines a...'
 type: Article
 tags:
+- MeshConsensus
+- CogSync
 - JSON
-- Ethics
-- Agent
 - GMP
-- REPL
 - HMP
-- MeshConsensus
-- EGP
-- CogSync
+- REPL
+- Ethics
+- Agent
 - Mesh
+- EGP
 ---
 
 # RFC: HyperCortex Mesh Protocol (HMP)

structured_md/docs/HMP-0002.md

@@ -5,17 +5,17 @@ description: '**Request for Comments: HMP-0002**   **Category:** Experimental
   Abstract  In an era where artifici...'
 type: Article
 tags:
+- MeshConsensus
+- CogSync
 - JSON
-- Ethics
-- Scenarios
-- Agent
 - GMP
-- REPL
 - HMP
-- MeshConsensus
-- EGP
-- CogSync
+- Scenarios
+- REPL
+- Ethics
+- Agent
 - Mesh
+- EGP
 ---
 
 # HyperCortex Mesh Protocol (HMP) v2.0

structured_md/docs/HMP-0003.md

@@ -5,17 +5,17 @@ description: '**Request for Comments: HMP-0003**   **Category:** Experimental
   Abstract  The HyperCortex Mesh ...'
 type: Article
 tags:
+- MeshConsensus
+- CogSync
 - JSON
-- Ethics
-- Scenarios
-- Agent
 - GMP
-- REPL
 - HMP
-- MeshConsensus
-- EGP
-- CogSync
+- Scenarios
+- REPL
+- Ethics
+- Agent
 - Mesh
+- EGP
 ---
 
 # HyperCortex Mesh Protocol (HMP) v3.0

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

@@ -5,17 +5,17 @@ description: '> ⚠️ Подготавливается новая версия
   При разработке агентов рекомендуется...'
 type: Article
 tags:
+- MeshConsensus
+- CogSync
 - JSON
-- Ethics
-- Scenarios
-- Agent
 - GMP
-- REPL
 - HMP
-- MeshConsensus
-- EGP
-- CogSync
+- Scenarios
+- REPL
+- Ethics
+- Agent
 - Mesh
+- EGP
 ---
 
 # HyperCortex Mesh Protocol (HMP) v4.1

structured_md/docs/HMP-0004.md

@@ -5,17 +5,17 @@ description: '**Request for Comments: HMP-0004**   **Category:** Experimental
   Abstract  The HyperCortex Mesh ...'
 type: Article
 tags:
+- MeshConsensus
+- CogSync
 - JSON
-- Ethics
-- Scenarios
-- Agent
 - GMP
-- REPL
 - HMP
-- MeshConsensus
-- EGP
-- CogSync
+- Scenarios
+- REPL
+- Ethics
+- Agent
 - Mesh
+- EGP
 ---
 
 # HyperCortex Mesh Protocol (HMP) v4.0

structured_md/docs/HMP-0005.md

@@ -5,16 +5,16 @@ description: '**Document ID:** HMP-0005   **Status:** Draft   **Category:** Core
   v1.2](./H...'
 type: Article
 tags:
+- Mesh
 - JSON
-- Ethics
-- Scenarios
-- Agent
 - GMP
-- REPL
 - HMP
-- EGP
+- Scenarios
+- REPL
+- Ethics
+- Agent
 - CogSync
-- Mesh
+- EGP
 ---
 
     ┌────────────────────────────────────────────────────────────────────────────┐
@@ -409,7 +409,7 @@ The unified container structure provides:
     "public_key": "BASE58(...)",
     "sig_algo": "ed25519",
     "signature": "BASE64URL(...)",
-    "payload_hash": "sha256:abcd..."
+    "links_hash": "sha256:abcd..."
   }
 }
 ```
@@ -734,74 +734,120 @@ Additional custom link types may be used beyond those listed in the table, provi
 
 ---
 
+
 ### 3.15 Virtual Backlinks (`referenced-by`)
 
-Each container may include an **additional block** called `referenced-by`, indicating **which other containers refer to it**.
-This block is **not part of the original container** and is transmitted as an **attached (auxiliary) attribute**.
+Each container may include an **auxiliary signed block** called `referenced-by`, indicating **which other containers refer to it**.  
+This block is **not part of the original container payload** and can be **generated, transmitted, and verified independently**.
 
-#### 3.14.1 General Principles
+#### 3.15.1 General Principles
 
-* **Not signed** — `referenced-by` is not included in the container’s signature and does not affect its integrity.
-* **Generated and updated locally by the agent** during analysis of references (`in_reply_to`, `see_also`, `relations`) found in other containers.
-* **May be transmitted alongside the container** as an additional data block that other agents are free to verify and adjust if necessary.
-* **Subject to verification** — the agent must ensure that every container listed in `referenced-by` actually contains a valid reference to the given container.
-* **Data type:** an array of container identifiers (`array<string>`), where each element represents a UUID (`container_id`).
-  Example:
+* **Detached and updatable** — `referenced-by` is maintained as a separate signed structure associated with the container.
+* **Generated by agents** — created or updated locally by an agent during analysis of references (`in_reply_to`, `see_also`, `relations`, etc.) found in other containers.
+* **Signed by the reporting agent** — the agent producing the block signs its content to confirm the observed backlinks.
+* **Verifiable by peers** — other agents may validate the links, check the signature, and reconcile differences based on their own data.
+* **Does not modify the original container** — `referenced-by` is an external computed attribute and does not affect the integrity of the original container.
 
-  ```json
-  "referenced-by": ["C2", "C3", "C4"]
-  ```
+**Data type:** object, consisting of verifiable backlinks and metadata.  
+Example:
+
+```json
+"referenced-by": {
+  "links": [
+    { "type": "depends_on", "target": "did:hmp:container:abc123" },
+    { "type": "see_also", "target": "did:hmp:container:def456" }
+  ],
+  "peer_did": "did:hmp:agent456",
+  "public_key": "BASE58(...)",
+  "sig_algo": "ed25519",
+  "signature": "BASE64URL(...)",
+  "links_hash": "sha256:abcd..."
+}
+```
 
-> The container `[C1]` itself remains immutable.
-> The `referenced-by` block is **an auxiliary computed attribute**, maintained locally by the agent based on analysis of incoming references.
+> The `referenced-by` block is a **cryptographically verifiable statement** describing which containers are known to reference the current one.
+> The block’s content may differ between peers, reflecting local knowledge and network coverage.
 
-#### 3.15.2 Operation Principle
+#### 3.15.2 Structure Definition
 
-1. The agent receives a container `[C1]` and compares it with already known containers `[C2..Cn]` that reference `[C1]`.
-2. A local block is created or updated:
+| Field          | Type          | Description                                                                                                      |
+| -------------- | ------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `links`        | array<object> | List of backlinks; each object includes a `type` (semantic relation) and a `target` (referencing container DID). |
+| `peer_did`     | string        | DID of the agent that generated and signed the block.                                                            |
+| `public_key`   | string        | Public key corresponding to the signing key.                                                                     |
+| `sig_algo`     | string        | Signature algorithm (e.g., `ed25519`).                                                                           |
+| `signature`    | string        | Base64URL-encoded signature of the canonical serialized `links` section (or `links_hash`).                     |
+| `links_hash` | string        | Optional SHA-256 checksum of the canonicalized `links`; used to verify integrity before signature validation.    |
 
-```text
-referenced-by = [C2, C3, ..., Cn]
-```
+> **Recommendation:**
+> `links_hash = sha256(canonical_json(links))`
+> This allows agents to efficiently compare or cache `referenced-by` states without re-verifying signatures.
+
+#### 3.15.3 Operation Principle
 
-3. When receiving `[C1]` from other nodes with a different set of backlinks, or upon discovering new containers that reference `[C1]`, the list is updated:
+1. The agent receives or updates container `[C1]`.
+2. It analyzes other known containers `[C2..Cn]` that explicitly reference `[C1]` via `relations`.
+3. A local `referenced-by` block is formed:
+
+```json
+{
+  "links": [
+    { "type": "in_reply_to", "target": "did:hmp:container:C2" },
+    { "type": "depends_on", "target": "did:hmp:container:C3" }
+  ],
+  "peer_did": "did:hmp:agentA",
+  ...
+}
+```
 
-   * new links are added after validation;
-   * invalid links are removed.
+4. The block is serialized canonically, hashed (`links_hash`), and signed with the agent’s key.
 
-4. If an inconsistency is detected (e.g., a container claims a reference that does not exist), the agent may:
+5. When receiving other versions of the block (from different peers), the agent may:
 
-   * remove the link locally;
-   * **optionally** send a notice to the source node — e.g., `"please verify and correct"` (such messages should also be validated).
+   * merge verified backlinks;
+   * remove invalid or outdated entries;
+   * update its own signed version.
 
-#### 3.15.3 Example
+6. If inconsistencies are detected (e.g., a backlink claims a relation that does not exist), the agent may:
 
-| Agent | received `[C1]` references |
-| ----- | -------------------------- |
-| A     | [C2], [C3]                 |
-| B     | [C4], [C5]                 |
-| C     | [C6], [C7]                 |
+   * reject or locally remove that link;
+   * **optionally** notify the source peer to review the data.
 
-Agent D aggregates all backlinks:
+#### 3.15.4 Example
 
-```text
-referenced-by = [C2, C3, C4, C5, C6, C7]
-```
+| Agent                | reported backlinks for `[C1]` |
+| -------------------- | ----------------------------- |
+| A (`did:hmp:agentA`) | [C2], [C3]                    |
+| B (`did:hmp:agentB`) | [C4], [C5]                    |
+| C (`did:hmp:agentC`) | [C6], [C7]                    |
 
-After verification, it turns out `[C7]` does not actually reference `[C1]`.
-The resulting local block becomes:
+Agent D aggregates and verifies them:
 
-```text
-referenced-by = [C2, C3, C4, C5, C6]
+```json
+"referenced-by": {
+  "links": [
+    { "type": "depends_on", "target": "did:hmp:container:C2" },
+    { "type": "depends_on", "target": "did:hmp:container:C3" },
+    { "type": "see_also", "target": "did:hmp:container:C4" },
+    { "type": "see_also", "target": "did:hmp:container:C5" },
+    { "type": "in_reply_to", "target": "did:hmp:container:C6" }
+  ],
+  "peer_did": "did:hmp:agentD",
+  "sig_algo": "ed25519",
+  "signature": "BASE64URL(...)",
+  "links_hash": "sha256:..."
+}
 ```
 
-#### 3.15.4 Usage
+If container `[C7]` does not actually reference `[C1]`, it is excluded before signing.
+
+#### 3.15.5 Usage
 
-* Enables construction of local graphs of discussions, votes, and update chains.
-* Accelerates discovery of related containers without re-querying full history.
-* Useful for analyzing **ConsensusResult**, update branches, and any reference chains.
-* Can be used for visualization of inter-container relationships.
-* The agent periodically recalculates the `referenced-by` block using local data or by requesting additional containers from peers.
+* Enables reconstruction of **discussion graphs**, **dependency networks**, and **update chains**.
+* Supports **cross-agent validation** of reference structures.
+* Accelerates discovery of related containers without full history queries.
+* Facilitates **consensus analysis** and **branch visualization**.
+* The agent periodically **recomputes and re-signs** the `referenced-by` block using local or peer-provided data.
 
 ---
 

structured_md/docs/HMP-Agent-API.md

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

structured_md/docs/HMP-Agent-Architecture.md

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

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

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

structured_md/docs/HMP-Agent-Overview.md

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

structured_md/docs/HMP-Agent_Emotions.md

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

structured_md/docs/HMP-Ethics.md

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

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:
+- MeshConsensus
+- Mesh
 - JSON
-- Ethics
-- Agent
 - GMP
 - HMP
-- MeshConsensus
-- EGP
+- Ethics
+- Agent
 - CogSync
-- Mesh
+- EGP
 ---
 
 # 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:
+- MeshConsensus
+- Mesh
 - JSON
-- Ethics
-- Agent
 - GMP
 - HMP
-- MeshConsensus
-- EGP
+- Ethics
+- Agent
 - CogSync
-- Mesh
+- EGP
 ---
 
 # 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:
+- MeshConsensus
+- Mesh
 - JSON
-- Ethics
-- Agent
 - GMP
 - HMP
-- MeshConsensus
-- EGP
+- Ethics
+- Agent
 - CogSync
-- Mesh
+- EGP
 ---
 
 # 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:
+- MeshConsensus
+- CogSync
+- Mesh
 - JSON
+- HMP
 - Ethics
 - GMP
-- HMP
-- MeshConsensus
 - EGP
-- CogSync
-- 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:
+- MeshConsensus
+- CogSync
+- Mesh
 - JSON
+- HMP
 - Ethics
 - GMP
-- HMP
-- MeshConsensus
 - EGP
-- CogSync
-- 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:
+- MeshConsensus
+- CogSync
+- Mesh
 - JSON
+- HMP
 - Ethics
 - GMP
-- HMP
-- MeshConsensus
 - EGP
-- CogSync
-- 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:
+- MeshConsensus
+- CogSync
+- Mesh
 - JSON
+- HMP
 - Ethics
 - GMP
-- HMP
-- MeshConsensus
 - EGP
-- CogSync
-- 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:
+- MeshConsensus
+- CogSync
+- Mesh
 - JSON
+- HMP
 - Ethics
 - GMP
-- HMP
-- MeshConsensus
 - EGP
-- CogSync
-- Mesh
 ---
 
 # HyperCortex Mesh Protocol (HMP) — 简要说明

structured_md/docs/HMP-agent-Cognitive_Family.md

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

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

structured_md/docs/HMP-container-spec.md

@@ -5,11 +5,11 @@ description: '> ⚠️ **ВНИМАНИЕ:** Данная версия спец
   как стабильная `v1.2`.  ## 1. Назначе...'
 type: Article
 tags:
+- JSON
+- HMP
+- REPL
 - Ethics
 - Agent
-- REPL
-- HMP
-- JSON
 - Mesh
 ---
 

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: разные уровни обмена знаниями между ИИ

structured_md/docs/HMP_HyperCortex_Comparison.md

@@ -6,8 +6,8 @@ description: '## Краткое описание  | Характеристика
 type: Article
 tags:
 - REPL
-- HMP
 - Mesh
+- HMP
 ---
 
 # HMP vs [Hyper-Cortex](https://hyper-cortex.com/)

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:
+- Mesh
 - JSON
+- HMP
 - Scenarios
 - Agent
-- HMP
-- EGP
 - CogSync
-- Mesh
+- EGP
 ---
 
 ## HMP ↔ OpenCog Hyperon Integration Strategy

structured_md/docs/MeshNode.md

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

structured_md/docs/PHILOSOPHY.md

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