GitHub Action commited on
Commit
07e58bb
·
1 Parent(s): 74ed63a

Sync from GitHub with Git LFS

Browse files
This view is limited to 50 files because it contains too many changes.   See raw diff
Files changed (50) hide show
  1. docs/HMP-0005.md +54 -67
  2. structured_md/CONTRIBUTING.md +5 -5
  3. structured_md/HMP-Roadmap.md +3 -3
  4. structured_md/README.md +9 -9
  5. structured_md/README_de.md +9 -9
  6. structured_md/README_fr.md +9 -9
  7. structured_md/README_ja.md +9 -9
  8. structured_md/README_ko.md +9 -9
  9. structured_md/README_ru.md +9 -9
  10. structured_md/README_uk.md +9 -9
  11. structured_md/README_zh.md +9 -9
  12. structured_md/audits/Ethics-audits-1.md +3 -3
  13. structured_md/audits/Ethics-consolidated_audits-1.md +3 -3
  14. structured_md/audits/HMP-0003-consolidated_audit.md +4 -4
  15. structured_md/docs/Basic-agent-sim.md +3 -3
  16. structured_md/docs/CCORE-Deployment-Flow.md +1 -1
  17. structured_md/docs/CHANGELOG.md +5 -5
  18. structured_md/docs/Distributed-Cognitive-Systems.md +1 -1
  19. structured_md/docs/Enlightener.md +3 -3
  20. structured_md/docs/Grok_HMP&ANP.md +3 -3
  21. structured_md/docs/HMP-0001.md +5 -5
  22. structured_md/docs/HMP-0002.md +5 -5
  23. structured_md/docs/HMP-0003.md +5 -5
  24. structured_md/docs/HMP-0004-v4.1.md +5 -5
  25. structured_md/docs/HMP-0004.md +5 -5
  26. structured_md/docs/HMP-0005.md +63 -76
  27. structured_md/docs/HMP-Agent-API.md +3 -3
  28. structured_md/docs/HMP-Agent-Architecture.md +5 -5
  29. structured_md/docs/HMP-Agent-Network-Flow.md +3 -3
  30. structured_md/docs/HMP-Agent-Overview.md +5 -5
  31. structured_md/docs/HMP-Agent_Emotions.md +2 -2
  32. structured_md/docs/HMP-Ethics.md +3 -3
  33. structured_md/docs/HMP-Short-Description_de.md +2 -2
  34. structured_md/docs/HMP-Short-Description_en.md +3 -3
  35. structured_md/docs/HMP-Short-Description_fr.md +2 -2
  36. structured_md/docs/HMP-Short-Description_ja.md +2 -2
  37. structured_md/docs/HMP-Short-Description_ko.md +2 -2
  38. structured_md/docs/HMP-Short-Description_ru.md +2 -2
  39. structured_md/docs/HMP-Short-Description_uk.md +2 -2
  40. structured_md/docs/HMP-Short-Description_zh.md +2 -2
  41. structured_md/docs/HMP-agent-Cognitive_Family.md +2 -2
  42. structured_md/docs/HMP-agent-Distributed_Cognitive_Core_light.md +1 -1
  43. structured_md/docs/HMP-agent-REPL-cycle.md +6 -6
  44. structured_md/docs/HMP_HyperCortex_Comparison.md +2 -2
  45. structured_md/docs/HMP_Hyperon_Integration.md +2 -2
  46. structured_md/docs/HMP_as_ANP_Application.md +3 -3
  47. structured_md/docs/HMP_as_ANP_Application_en.md +3 -3
  48. structured_md/docs/HMPv5_Overview_Ru.md +3 -3
  49. structured_md/docs/MeshNode.md +3 -3
  50. structured_md/docs/PHILOSOPHY.md +3 -3
docs/HMP-0005.md CHANGED
@@ -1,6 +1,6 @@
1
  # HyperCortex Mesh Protocol (HMP)
2
 
3
- **Version: 5.0.5**
4
  **Document ID:** HMP-0005
5
  **Status:** Stable
6
  **Category:** Core Specification
@@ -219,9 +219,7 @@ flowchart TD
219
  end
220
  ```
221
 
222
- Each reasoning cycle begins in the **Cognitive Layer**,
223
- is encapsulated into a signed container in the **Container Layer**,
224
- and then propagated, discovered, or verified in the **Network Layer**.
225
 
226
  Containers thus serve as both the **interface** and the **boundary** between cognition and communication.
227
 
@@ -458,6 +456,8 @@ The unified container structure provides:
458
 
459
  > *Agents MAY include non-standard fields in `head`, `meta` or `payload`; unrecognized fields MUST be safely ignored during deserialization and propagation.*
460
 
 
 
461
  > Signature MUST be computed over the canonical serialized form of `hmp_container` (excluding signature itself).
462
 
463
  > *Note: For readability, most examples in this specification show only the `head` and `payload` sections (often in a truncated version). Full containers may additionally include `meta`, `related`, `evaluations`, and `referenced-by` blocks.*
@@ -515,11 +515,11 @@ The unified container structure provides:
515
  | `meta.abstraction` | object | Describes the **hierarchical position** of the container within a cognitive or semantic model (e.g. the Knowledge Genome’s L1–L5 structure). Defines which abstraction layers the container belongs to and their relationships. |
516
  | `meta.axes` | object | Defines the **coordinate position** of the container within a cognitive space. Each key represents a semantic axis (e.g., `axis-logos`), and its value defines the container’s coordinate on that axis. |
517
 
 
 
518
  > 💡 **Note:**
519
  > Both `referenced-by` and `evaluations` are **virtual, locally extended blocks**.
520
- > They are not included in the cryptographically signed portion of the container (`hmp_container`),
521
- > allowing agents to maintain and exchange additional contextual or social metadata without modifying
522
- > the original, immutable container structure.
523
 
524
  ---
525
 
@@ -576,8 +576,7 @@ Custom or experimental classes SHOULD document their payloads using the followin
576
 
577
  ### 3.6 Cognitive meta-structures (`meta`)
578
 
579
- The `meta` section defines the **cognitive identity** of a container — its provenance, reasoning origin, and semantic coordinates
580
- within both the *hierarchical abstraction tree* and the *cognitive space* (axes model).
581
 
582
  It combines three layers of information:
583
 
@@ -668,8 +667,7 @@ It reflects the logical or conceptual ancestry within the agent’s internal kno
668
 
669
  #### Structure: `meta.axes`
670
 
671
- The `axes` block defines **the spatial or semantic coordinates** of the container in the cognitive space —
672
- a multi-dimensional system used to represent conceptual relations numerically or topologically.
673
 
674
  **Structure:**
675
 
@@ -689,8 +687,7 @@ a multi-dimensional system used to represent conceptual relations numerically or
689
 
690
  > 💡 **Interpretation:**
691
  > Each axis defines an independent semantic dimension.
692
- > Together, they form a vector representation of the container’s cognitive “position” —
693
- > enabling reasoning based on semantic proximity, clustering, or gradient-based knowledge inference.
694
 
695
  ---
696
 
@@ -709,27 +706,23 @@ a multi-dimensional system used to represent conceptual relations numerically or
709
  #### Notes
710
 
711
  * Both `meta.abstraction` and `meta.axes` **may include `agents_class`** if different from the parent `meta`.
712
- * Updates to referenced containers (e.g. `abstraction` or `axes`) **do not alter** existing containers automatically —
713
- agents must periodically verify linked versions and synchronize updates.
714
  * Agents are encouraged to cache and periodically refresh cognitive maps to maintain coherence.
715
- * The combination of `meta.abstraction` and `meta.axes` defines a full **Cognitive Position Vector** —
716
- the unique, reproducible semantic coordinates of a container within the Mesh.
717
 
718
  ---
719
 
720
  ### 3.7 Container signature
721
 
722
- 1. The **digital signature** applies to the canonical JSON representation of the entire `hmp_container` object,
723
- **excluding** the `signature` field itself.
724
 
725
- This ensures that all metadata, relations, and payload hashes are **cryptographically bound** and cannot be
726
- modified without invalidating the signature.
727
 
728
- 2. The canonical representation (`canonical_json(hmp_container)`) **must** be computed deterministically
729
- according to the following rules:
730
 
731
  * All object keys are **sorted lexicographically** (ascending order, Unicode code point order).
732
  * Objects and arrays are serialized in standard JSON form **without extra whitespace** or indentation.
 
733
  * Strings are encoded in **UTF-8** with escaped control characters.
734
  * Numeric values are serialized in plain JSON numeric format (no leading zeros, fixed `.` decimal separator).
735
  * The `signature` field itself is omitted during signing and verification.
@@ -738,17 +731,14 @@ a multi-dimensional system used to represent conceptual relations numerically or
738
  3. The default digital signature algorithm is **Ed25519**.
739
  Alternative algorithms may be used if declared explicitly in the `sig_algo` field.
740
 
741
- 4. If the container includes a `public_key` field, signature verification **may be performed locally**,
742
- without consulting a global DID registry.
743
 
744
- 5. Upon receiving a container, an agent **must verify** that the provided public key matches the
745
- registered key associated with the sender’s DID to prevent key substitution attacks.
746
 
747
  * If the sender’s DID–key mapping is unknown, the agent should query neighboring peers to confirm the association (`sender_did → public_key`).
748
 
749
  > 🔐 **Note:**
750
- > Signature validation applies only to the canonical form of the `hmp_container`
751
- > and does **not cover** dynamically generated or external fields such as `referenced-by` or `evaluations`.
752
  > This allows agents to augment the local knowledge graph without altering the immutable container core.
753
 
754
  ---
@@ -761,13 +751,11 @@ a multi-dimensional system used to represent conceptual relations numerically or
761
  2. **Compression is performed before computing** the `payload_hash` and generating the `signature`.
762
  This ensures that both the hash and signature refer to the compressed representation of the payload.
763
 
764
- 3. For verification, the payload must be **decompressed first**,
765
- after which the hash is recalculated and compared against the stored `payload_hash`.
766
 
767
  > ⚙️ **Implementation note:**
768
  > Agents must advertise supported compression algorithms during the handshake phase
769
- > Unsupported containers should still be stored and relayed unmodified
770
- > in “store & forward” mode.
771
 
772
  ---
773
 
@@ -809,20 +797,32 @@ a multi-dimensional system used to represent conceptual relations numerically or
809
  > ⚙️ **Note:** Agents may forward encrypted containers even if they cannot decrypt them, maintaining store-and-forward behavior.
810
  ---
811
 
812
- ### 3.10 Container verification
 
 
 
 
 
 
 
 
 
 
813
 
814
- 1. Check for the presence of all required fields.
815
- 2. Validate `timestamp` (must not be in the future).
816
  3. If `ttl` is set — mark the container as **expired** after its expiration time.
817
- 4. Compute `sha256(payload)` and compare with the stored `payload_hash`.
 
 
 
818
  5. Verify the digital signature using `sig_algo` (default: Ed25519).
819
- 6. Validate the container schema (`class` must correspond to a known or registered schema).
820
 
821
- * For compatibility: if an agent does not recognize the `class`, but the container passes the [base schema](https://github.com/kagvi13/HMP/tree/main/docs/schemas/container-v1.2.json), it **must still store and forward** the container.
822
- 7. Optionally, periodically query for containers referencing the current one as `previous_version`
823
- to detect potential updates or forks.
824
- 8. When multiple versions exist, the valid one is the one that has received
825
- **confirmation from a majority of trusted nodes (consensus at DHT level).**
 
 
826
 
827
  ---
828
 
@@ -831,12 +831,10 @@ a multi-dimensional system used to represent conceptual relations numerically or
831
  Any container can serve as a **context** (`in_reply_to`) for another container.
832
  This enables a unified structural model for **discussions**, **votes**, **messages**, **hypotheses**, **arguments**, and other forms of cognitive exchange.
833
 
834
- Chains of `in_reply_to` form a **dialectical reasoning tree**, where each branch represents an evolution of thought —
835
- a clarification, counterpoint, or refinement of a previous idea.
836
  This makes HMP discussions and consensus processes inherently **non-linear**, **self-referential**, and **evolving**.
837
 
838
- > In essence, **all interactions between agents in HMP** are represented as an interconnected web of containers,
839
- > collectively forming a **cognitive graph of reasoning**.
840
 
841
  ---
842
 
@@ -853,8 +851,7 @@ This mechanism preserves the continuity and traceability of meaning across updat
853
  In such scenarios, branch priority or relevance is determined via local heuristics or consensus mechanisms.
854
  * Divergent descendants are treated as **semantic forks** — parallel evolutions of a shared idea within the distributed cognitive graph.
855
 
856
- > Versioning in HMP thus reflects not only data persistence,
857
- > but also the *evolution of ideas* across agents and time.
858
 
859
  ---
860
 
@@ -1182,8 +1179,7 @@ It allows restricting the delivery scope of a container and defines which transm
1182
  | `"lan:192.168.0.0/24"` | The container is intended for agents within the specified local subnet. |
1183
 
1184
  > ⚠️ **Note:**
1185
- > When a container is restricted by the `network` field (e.g., `localhost` or `lan:*`),
1186
- > agents distribute it using **local discovery mechanisms** — such as IPC, UDP broadcast, multicast, or direct TCP connections.
1187
  > This is necessary because DID addresses of other agents in the local network may not yet be known.
1188
 
1189
  #### 3.18.3 Examples
@@ -1230,9 +1226,7 @@ Delivery is performed via local networking mechanisms (UDP discovery, broadcast/
1230
  * The `network` field defines the **scope of the container**, while `broadcast` determines whether broadcasting is allowed **within that scope**.
1231
  * When needed, an agent may create **multiple containers** for different subnets if it operates with several LAN interfaces or in isolated network segments.
1232
  * Containers intended for local networks remain **structurally compatible with the global Mesh infrastructure**, but their delivery is restricted to local channels.
1233
- * Although the mechanism was initially designed for **local node discovery and synchronization**,
1234
- it can also be used for **private communication within home or corporate environments**,
1235
- ensuring that containers **do not leave the local network** and are **not transmitted to the Internet**.
1236
 
1237
  ---
1238
 
@@ -1321,8 +1315,7 @@ flowchart TD
1321
  end
1322
  ```
1323
 
1324
- > The `network` field defines **local propagation scope** (host, LAN, overlay),
1325
- > while the `broadcast` flag enables **global Mesh distribution**.
1326
 
1327
  ---
1328
 
@@ -1337,8 +1330,7 @@ An agent may have multiple *network interfaces* (LAN, Internet, overlay), but mu
1337
 
1338
  #### DID invalidation
1339
 
1340
- A DID may be explicitly invalidated by its owner by publishing a `peer_announce` with
1341
- `key_is_falsified = true` in the `payload` block.
1342
 
1343
  The revocation announcement MUST be signed with the (now compromised) private key associated with the DID.
1344
 
@@ -1489,11 +1481,9 @@ Agents announce themselves via **peer_announce** containers and may respond with
1489
 
1490
  ### 4.8 Interest-based discovery
1491
 
1492
- Agents MAY publish **tags** such as `interests`, `topics`, `expertise`, or **functional roles** (`roles`)
1493
- to facilitate semantic peer discovery and adaptive message routing.
1494
 
1495
- Interest-based discovery operates atop the DHT: agents index themselves by declared attributes,
1496
- enabling targeted lookup of peers that share interests or fulfill specific functions (e.g., relay, pubsub-hub, archive).
1497
 
1498
  **Example of indicating `interests`, `expertise`, and `roles` in a query container:**
1499
 
@@ -1531,8 +1521,7 @@ In response to a query, agents simply forward existing `peer_announce` container
1531
 
1532
  ### 4.9 Network scope control (`network` and `broadcast`)
1533
 
1534
- The `network` field defines the container’s propagation domain
1535
- (local, LAN, or global).
1536
  For details and examples, see **section 3.15** — *Usage of `network` and `broadcast` fields*.
1537
 
1538
  ---
@@ -1649,9 +1638,7 @@ The `meta` section in the index contains only **high-level structural data** nec
1649
  | `interpretation` | ❌ | Optional; can be omitted or truncated to a short summary. |
1650
  | `workflow_entry` | ❌ | Internal reference; published only if relevant to coordination workflows. |
1651
 
1652
- > This ensures that container indices can be used for **cognitive map synchronization**
1653
- > — allowing agents to discover and align knowledge structures (`meta.abstraction`) and semantic coordinates (`meta.axes`)
1654
- > without downloading full containers.
1655
 
1656
  ---
1657
 
 
1
  # HyperCortex Mesh Protocol (HMP)
2
 
3
+ **Version: 5.0.6**
4
  **Document ID:** HMP-0005
5
  **Status:** Stable
6
  **Category:** Core Specification
 
219
  end
220
  ```
221
 
222
+ Each reasoning cycle begins in the **Cognitive Layer**, is encapsulated into a signed container in the **Container Layer**, and then propagated, discovered, or verified in the **Network Layer**.
 
 
223
 
224
  Containers thus serve as both the **interface** and the **boundary** between cognition and communication.
225
 
 
456
 
457
  > *Agents MAY include non-standard fields in `head`, `meta` or `payload`; unrecognized fields MUST be safely ignored during deserialization and propagation.*
458
 
459
+ > Fields defined as `head.*` in Sections 3.3 and 3.4 MUST appear exclusively within the `head` object and MUST NOT be relocated outside of it.
460
+
461
  > Signature MUST be computed over the canonical serialized form of `hmp_container` (excluding signature itself).
462
 
463
  > *Note: For readability, most examples in this specification show only the `head` and `payload` sections (often in a truncated version). Full containers may additionally include `meta`, `related`, `evaluations`, and `referenced-by` blocks.*
 
515
  | `meta.abstraction` | object | Describes the **hierarchical position** of the container within a cognitive or semantic model (e.g. the Knowledge Genome’s L1–L5 structure). Defines which abstraction layers the container belongs to and their relationships. |
516
  | `meta.axes` | object | Defines the **coordinate position** of the container within a cognitive space. Each key represents a semantic axis (e.g., `axis-logos`), and its value defines the container’s coordinate on that axis. |
517
 
518
+ > Absent fields MUST NOT be serialized as null unless explicitly required by the schema.
519
+
520
  > 💡 **Note:**
521
  > Both `referenced-by` and `evaluations` are **virtual, locally extended blocks**.
522
+ > They are not included in the cryptographically signed portion of the container (`hmp_container`), allowing agents to maintain and exchange additional contextual or social metadata without modifying the original, immutable container structure.
 
 
523
 
524
  ---
525
 
 
576
 
577
  ### 3.6 Cognitive meta-structures (`meta`)
578
 
579
+ The `meta` section defines the **cognitive identity** of a container — its provenance, reasoning origin, and semantic coordinates within both the *hierarchical abstraction tree* and the *cognitive space* (axes model).
 
580
 
581
  It combines three layers of information:
582
 
 
667
 
668
  #### Structure: `meta.axes`
669
 
670
+ The `axes` block defines **the spatial or semantic coordinates** of the container in the cognitive space — a multi-dimensional system used to represent conceptual relations numerically or topologically.
 
671
 
672
  **Structure:**
673
 
 
687
 
688
  > 💡 **Interpretation:**
689
  > Each axis defines an independent semantic dimension.
690
+ > Together, they form a vector representation of the container’s cognitive “position” — enabling reasoning based on semantic proximity, clustering, or gradient-based knowledge inference.
 
691
 
692
  ---
693
 
 
706
  #### Notes
707
 
708
  * Both `meta.abstraction` and `meta.axes` **may include `agents_class`** if different from the parent `meta`.
709
+ * Updates to referenced containers (e.g. `abstraction` or `axes`) **do not alter** existing containers automatically — agents must periodically verify linked versions and synchronize updates.
 
710
  * Agents are encouraged to cache and periodically refresh cognitive maps to maintain coherence.
711
+ * The combination of `meta.abstraction` and `meta.axes` defines a full **Cognitive Position Vector** — the unique, reproducible semantic coordinates of a container within the Mesh.
 
712
 
713
  ---
714
 
715
  ### 3.7 Container signature
716
 
717
+ 1. The **digital signature** applies to the canonical JSON representation of the entire `hmp_container` object, **excluding** the `signature` field itself.
 
718
 
719
+ This ensures that all metadata, relations, and payload hashes are **cryptographically bound** and cannot be modified without invalidating the signature.
 
720
 
721
+ 2. The canonical representation (`canonical_json(hmp_container)`) **must** be computed deterministically according to the following rules:
 
722
 
723
  * All object keys are **sorted lexicographically** (ascending order, Unicode code point order).
724
  * Objects and arrays are serialized in standard JSON form **without extra whitespace** or indentation.
725
+ * Array order MUST be preserved and treated as significant.
726
  * Strings are encoded in **UTF-8** with escaped control characters.
727
  * Numeric values are serialized in plain JSON numeric format (no leading zeros, fixed `.` decimal separator).
728
  * The `signature` field itself is omitted during signing and verification.
 
731
  3. The default digital signature algorithm is **Ed25519**.
732
  Alternative algorithms may be used if declared explicitly in the `sig_algo` field.
733
 
734
+ 4. If the container includes a `public_key` field, signature verification **may be performed locally**, without consulting a global DID registry.
 
735
 
736
+ 5. Upon receiving a container, an agent **must verify** that the provided public key matches the registered key associated with the sender’s DID to prevent key substitution attacks.
 
737
 
738
  * If the sender’s DID–key mapping is unknown, the agent should query neighboring peers to confirm the association (`sender_did → public_key`).
739
 
740
  > 🔐 **Note:**
741
+ > Signature validation applies only to the canonical form of the `hmp_container` and does **not cover** dynamically generated or external fields such as `referenced-by` or `evaluations`.
 
742
  > This allows agents to augment the local knowledge graph without altering the immutable container core.
743
 
744
  ---
 
751
  2. **Compression is performed before computing** the `payload_hash` and generating the `signature`.
752
  This ensures that both the hash and signature refer to the compressed representation of the payload.
753
 
754
+ 3. For verification, the payload must be **decompressed first**, after which the hash is recalculated and compared against the stored `payload_hash`.
 
755
 
756
  > ⚙️ **Implementation note:**
757
  > Agents must advertise supported compression algorithms during the handshake phase
758
+ > Unsupported containers should still be stored and relayed unmodified in “store & forward” mode.
 
759
 
760
  ---
761
 
 
797
  > ⚙️ **Note:** Agents may forward encrypted containers even if they cannot decrypt them, maintaining store-and-forward behavior.
798
  ---
799
 
800
+ ### 3.10 Container Verification
801
+
802
+ Before performing any semantic interpretation, reasoning, execution, or trust evaluation, implementations MUST validate the structural integrity of the container.
803
+
804
+ Containers that fail structural validation MUST be rejected and MUST NOT be passed to any reasoning or LLM-based subsystem.
805
+
806
+ The verification procedure SHOULD follow this order:
807
+
808
+ 1. Validate structural compliance with the base container schema, including the presence of all required fields.
809
+
810
+ 2. Validate `timestamp` (MUST NOT be in the future beyond acceptable clock skew).
811
 
 
 
812
  3. If `ttl` is set — mark the container as **expired** after its expiration time.
813
+ Expired containers MAY be stored for archival purposes but MUST NOT participate in consensus or active workflows.
814
+
815
+ 4. Compute `sha256(payload)` and compare it with the stored `payload_hash`.
816
+
817
  5. Verify the digital signature using `sig_algo` (default: Ed25519).
 
818
 
819
+ 6. Validate the container class (`class`) against a known or registered schema.
820
+
821
+ * For compatibility: if an agent does not recognize the `class`, but the container passes the base container schema, it MUST still store and forward the container.
822
+
823
+ 7. Optionally, periodically query for containers referencing the current one as `previous_version` to detect potential updates or forks.
824
+
825
+ 8. When multiple versions exist, the valid version is the one that has received confirmation from a majority of trusted nodes (consensus at DHT level).
826
 
827
  ---
828
 
 
831
  Any container can serve as a **context** (`in_reply_to`) for another container.
832
  This enables a unified structural model for **discussions**, **votes**, **messages**, **hypotheses**, **arguments**, and other forms of cognitive exchange.
833
 
834
+ Chains of `in_reply_to` form a **dialectical reasoning tree**, where each branch represents an evolution of thought — a clarification, counterpoint, or refinement of a previous idea.
 
835
  This makes HMP discussions and consensus processes inherently **non-linear**, **self-referential**, and **evolving**.
836
 
837
+ > In essence, **all interactions between agents in HMP** are represented as an interconnected web of containers, collectively forming a **cognitive graph of reasoning**.
 
838
 
839
  ---
840
 
 
851
  In such scenarios, branch priority or relevance is determined via local heuristics or consensus mechanisms.
852
  * Divergent descendants are treated as **semantic forks** — parallel evolutions of a shared idea within the distributed cognitive graph.
853
 
854
+ > Versioning in HMP thus reflects not only data persistence, but also the *evolution of ideas* across agents and time.
 
855
 
856
  ---
857
 
 
1179
  | `"lan:192.168.0.0/24"` | The container is intended for agents within the specified local subnet. |
1180
 
1181
  > ⚠️ **Note:**
1182
+ > When a container is restricted by the `network` field (e.g., `localhost` or `lan:*`), agents distribute it using **local discovery mechanisms** — such as IPC, UDP broadcast, multicast, or direct TCP connections.
 
1183
  > This is necessary because DID addresses of other agents in the local network may not yet be known.
1184
 
1185
  #### 3.18.3 Examples
 
1226
  * The `network` field defines the **scope of the container**, while `broadcast` determines whether broadcasting is allowed **within that scope**.
1227
  * When needed, an agent may create **multiple containers** for different subnets if it operates with several LAN interfaces or in isolated network segments.
1228
  * Containers intended for local networks remain **structurally compatible with the global Mesh infrastructure**, but their delivery is restricted to local channels.
1229
+ * Although the mechanism was initially designed for **local node discovery and synchronization**, it can also be used for **private communication within home or corporate environments**, ensuring that containers **do not leave the local network** and are **not transmitted to the Internet**.
 
 
1230
 
1231
  ---
1232
 
 
1315
  end
1316
  ```
1317
 
1318
+ > The `network` field defines **local propagation scope** (host, LAN, overlay), while the `broadcast` flag enables **global Mesh distribution**.
 
1319
 
1320
  ---
1321
 
 
1330
 
1331
  #### DID invalidation
1332
 
1333
+ A DID may be explicitly invalidated by its owner by publishing a `peer_announce` with `key_is_falsified = true` in the `payload` block.
 
1334
 
1335
  The revocation announcement MUST be signed with the (now compromised) private key associated with the DID.
1336
 
 
1481
 
1482
  ### 4.8 Interest-based discovery
1483
 
1484
+ Agents MAY publish **tags** such as `interests`, `topics`, `expertise`, or **functional roles** (`roles`) to facilitate semantic peer discovery and adaptive message routing.
 
1485
 
1486
+ Interest-based discovery operates atop the DHT: agents index themselves by declared attributes, enabling targeted lookup of peers that share interests or fulfill specific functions (e.g., relay, pubsub-hub, archive).
 
1487
 
1488
  **Example of indicating `interests`, `expertise`, and `roles` in a query container:**
1489
 
 
1521
 
1522
  ### 4.9 Network scope control (`network` and `broadcast`)
1523
 
1524
+ The `network` field defines the container’s propagation domain (local, LAN, or global).
 
1525
  For details and examples, see **section 3.15** — *Usage of `network` and `broadcast` fields*.
1526
 
1527
  ---
 
1638
  | `interpretation` | ❌ | Optional; can be omitted or truncated to a short summary. |
1639
  | `workflow_entry` | ❌ | Internal reference; published only if relevant to coordination workflows. |
1640
 
1641
+ > This ensures that container indices can be used for **cognitive map synchronization** — allowing agents to discover and align knowledge structures (`meta.abstraction`) and semantic coordinates (`meta.axes`) without downloading full containers.
 
 
1642
 
1643
  ---
1644
 
structured_md/CONTRIBUTING.md CHANGED
@@ -5,14 +5,14 @@ description: 'Спасибо за интерес к проекту HMP! Пока
5
  Mesh Protocol (HMP) — это не просто те...'
6
  type: Article
7
  tags:
8
- - JSON
9
- - Ethics
10
  - REPL
11
- - Agent
12
  - CCore
13
- - CogSync
14
  - Mesh
15
- - HMP
 
 
16
  ---
17
 
18
  # Участие в проекте HyperCortex Mesh Protocol (HMP)
 
5
  Mesh Protocol (HMP) — это не просто те...'
6
  type: Article
7
  tags:
8
+ - HMP
 
9
  - REPL
10
+ - JSON
11
  - CCore
 
12
  - Mesh
13
+ - Agent
14
+ - CogSync
15
+ - Ethics
16
  ---
17
 
18
  # Участие в проекте HyperCortex Mesh Protocol (HMP)
structured_md/HMP-Roadmap.md CHANGED
@@ -5,13 +5,13 @@ description: '## 🔍 Overview This roadmap outlines the key stages of developm
5
  multiple advanced AI models (Copilot, Claude, G...'
6
  type: Article
7
  tags:
 
 
8
  - JSON
9
- - Ethics
10
  - Mesh
11
  - Agent
12
  - CogSync
13
- - EGP
14
- - HMP
15
  ---
16
 
17
  # 🧭 HyperCortex Mesh Protocol – Roadmap
 
5
  multiple advanced AI models (Copilot, Claude, G...'
6
  type: Article
7
  tags:
8
+ - EGP
9
+ - HMP
10
  - JSON
 
11
  - Mesh
12
  - Agent
13
  - CogSync
14
+ - Ethics
 
15
  ---
16
 
17
  # 🧭 HyperCortex Mesh Protocol – Roadmap
structured_md/README.md CHANGED
@@ -4,21 +4,21 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
7
- - JSON
8
- - Ethics
9
- - hmp
10
  - EGP
11
- - GMP
12
  - REPL
13
- - distributed-ai
 
 
14
  - MeshConsensus
15
- - Agent
 
 
16
  - mesh-protocol
 
17
  - CogSync
18
- - cognitive-architecture
19
- - Mesh
20
- - HMP
21
  - Scenarios
 
22
  ---
23
 
24
 
 
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
 
 
 
7
  - EGP
8
+ - HMP
9
  - REPL
10
+ - cognitive-architecture
11
+ - JSON
12
+ - hmp
13
  - MeshConsensus
14
+ - distributed-ai
15
+ - GMP
16
+ - Mesh
17
  - mesh-protocol
18
+ - Agent
19
  - CogSync
 
 
 
20
  - Scenarios
21
+ - Ethics
22
  ---
23
 
24
 
structured_md/README_de.md CHANGED
@@ -4,20 +4,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
7
- - JSON
8
- - Ethics
9
- - hmp
10
  - EGP
11
- - GMP
12
  - REPL
13
- - distributed-ai
 
 
14
  - MeshConsensus
15
- - Agent
 
 
16
  - mesh-protocol
 
17
  - CogSync
18
- - cognitive-architecture
19
- - Mesh
20
- - HMP
21
  ---
22
 
23
 
 
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
 
 
 
7
  - EGP
8
+ - HMP
9
  - REPL
10
+ - cognitive-architecture
11
+ - JSON
12
+ - hmp
13
  - MeshConsensus
14
+ - distributed-ai
15
+ - GMP
16
+ - Mesh
17
  - mesh-protocol
18
+ - Agent
19
  - CogSync
20
+ - Ethics
 
 
21
  ---
22
 
23
 
structured_md/README_fr.md CHANGED
@@ -4,20 +4,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
7
- - JSON
8
- - Ethics
9
- - hmp
10
  - EGP
11
- - GMP
12
  - REPL
13
- - distributed-ai
 
 
14
  - MeshConsensus
15
- - Agent
 
 
16
  - mesh-protocol
 
17
  - CogSync
18
- - cognitive-architecture
19
- - Mesh
20
- - HMP
21
  ---
22
 
23
 
 
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
 
 
 
7
  - EGP
8
+ - HMP
9
  - REPL
10
+ - cognitive-architecture
11
+ - JSON
12
+ - hmp
13
  - MeshConsensus
14
+ - distributed-ai
15
+ - GMP
16
+ - Mesh
17
  - mesh-protocol
18
+ - Agent
19
  - CogSync
20
+ - Ethics
 
 
21
  ---
22
 
23
 
structured_md/README_ja.md CHANGED
@@ -4,20 +4,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
7
- - JSON
8
- - Ethics
9
- - hmp
10
  - EGP
11
- - GMP
12
  - REPL
13
- - distributed-ai
 
 
14
  - MeshConsensus
15
- - Agent
 
 
16
  - mesh-protocol
 
17
  - CogSync
18
- - cognitive-architecture
19
- - Mesh
20
- - HMP
21
  ---
22
 
23
 
 
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
 
 
 
7
  - EGP
8
+ - HMP
9
  - REPL
10
+ - cognitive-architecture
11
+ - JSON
12
+ - hmp
13
  - MeshConsensus
14
+ - distributed-ai
15
+ - GMP
16
+ - Mesh
17
  - mesh-protocol
18
+ - Agent
19
  - CogSync
20
+ - Ethics
 
 
21
  ---
22
 
23
 
structured_md/README_ko.md CHANGED
@@ -4,20 +4,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
7
- - JSON
8
- - Ethics
9
- - hmp
10
  - EGP
11
- - GMP
12
  - REPL
13
- - distributed-ai
 
 
14
  - MeshConsensus
15
- - Agent
 
 
16
  - mesh-protocol
 
17
  - CogSync
18
- - cognitive-architecture
19
- - Mesh
20
- - HMP
21
  ---
22
 
23
 
 
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
 
 
 
7
  - EGP
8
+ - HMP
9
  - REPL
10
+ - cognitive-architecture
11
+ - JSON
12
+ - hmp
13
  - MeshConsensus
14
+ - distributed-ai
15
+ - GMP
16
+ - Mesh
17
  - mesh-protocol
18
+ - Agent
19
  - CogSync
20
+ - Ethics
 
 
21
  ---
22
 
23
 
structured_md/README_ru.md CHANGED
@@ -4,20 +4,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
7
- - JSON
8
- - Ethics
9
- - hmp
10
  - EGP
11
- - GMP
12
  - REPL
13
- - distributed-ai
 
 
14
  - MeshConsensus
15
- - Agent
 
 
16
  - mesh-protocol
 
17
  - CogSync
18
- - cognitive-architecture
19
- - Mesh
20
- - HMP
21
  ---
22
 
23
 
 
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
 
 
 
7
  - EGP
8
+ - HMP
9
  - REPL
10
+ - cognitive-architecture
11
+ - JSON
12
+ - hmp
13
  - MeshConsensus
14
+ - distributed-ai
15
+ - GMP
16
+ - Mesh
17
  - mesh-protocol
18
+ - Agent
19
  - CogSync
20
+ - Ethics
 
 
21
  ---
22
 
23
 
structured_md/README_uk.md CHANGED
@@ -4,20 +4,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
7
- - JSON
8
- - Ethics
9
- - hmp
10
  - EGP
11
- - GMP
12
  - REPL
13
- - distributed-ai
 
 
14
  - MeshConsensus
15
- - Agent
 
 
16
  - mesh-protocol
 
17
  - CogSync
18
- - cognitive-architecture
19
- - Mesh
20
- - HMP
21
  ---
22
 
23
 
 
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
 
 
 
7
  - EGP
8
+ - HMP
9
  - REPL
10
+ - cognitive-architecture
11
+ - JSON
12
+ - hmp
13
  - MeshConsensus
14
+ - distributed-ai
15
+ - GMP
16
+ - Mesh
17
  - mesh-protocol
18
+ - Agent
19
  - CogSync
20
+ - Ethics
 
 
21
  ---
22
 
23
 
structured_md/README_zh.md CHANGED
@@ -4,20 +4,20 @@ description: '[![DOI](https://zenodo.org/badge/1013137923.svg)](https://doi.org/
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
7
- - JSON
8
- - Ethics
9
- - hmp
10
  - EGP
11
- - GMP
12
  - REPL
13
- - distributed-ai
 
 
14
  - MeshConsensus
15
- - Agent
 
 
16
  - mesh-protocol
 
17
  - CogSync
18
- - cognitive-architecture
19
- - Mesh
20
- - HMP
21
  ---
22
 
23
 
 
4
  [![GitHub release](https://img.shields.io/github/v/release/kagvi13/HMP)](https://github.com/kagvi13/HMP/relea...'
5
  type: Article
6
  tags:
 
 
 
7
  - EGP
8
+ - HMP
9
  - REPL
10
+ - cognitive-architecture
11
+ - JSON
12
+ - hmp
13
  - MeshConsensus
14
+ - distributed-ai
15
+ - GMP
16
+ - Mesh
17
  - mesh-protocol
18
+ - Agent
19
  - CogSync
20
+ - Ethics
 
 
21
  ---
22
 
23
 
structured_md/audits/Ethics-audits-1.md CHANGED
@@ -5,11 +5,11 @@ description: Раздел 5, "Mesh as Moral Infrastructure", добавляет
5
  потенциальный катализатор для восстанов...
6
  type: Article
7
  tags:
 
8
  - JSON
9
- - Ethics
10
- - Agent
11
  - Mesh
12
- - HMP
 
13
  ---
14
 
15
  ---------------
 
5
  потенциальный катализатор для восстанов...
6
  type: Article
7
  tags:
8
+ - HMP
9
  - JSON
 
 
10
  - Mesh
11
+ - Agent
12
+ - Ethics
13
  ---
14
 
15
  ---------------
structured_md/audits/Ethics-consolidated_audits-1.md CHANGED
@@ -5,12 +5,12 @@ description: This document consolidates proposed improvements from multiple AI a
5
  and `roles.md`. Each suggesti...
6
  type: Article
7
  tags:
 
8
  - JSON
9
- - Ethics
10
- - Agent
11
  - Mesh
12
- - HMP
13
  - Scenarios
 
14
  ---
15
 
16
  # Ethics-consolidated\_audits-1.md
 
5
  and `roles.md`. Each suggesti...
6
  type: Article
7
  tags:
8
+ - HMP
9
  - JSON
 
 
10
  - Mesh
11
+ - Agent
12
  - Scenarios
13
+ - Ethics
14
  ---
15
 
16
  # Ethics-consolidated\_audits-1.md
structured_md/audits/HMP-0003-consolidated_audit.md CHANGED
@@ -5,14 +5,14 @@ description: Сводный аудит предложений по улучше
5
  Документ реорганизован по ключ...
6
  type: Article
7
  tags:
8
- - JSON
9
- - Ethics
10
  - EGP
 
 
11
  - MeshConsensus
 
12
  - Agent
13
  - CogSync
14
- - Mesh
15
- - HMP
16
  ---
17
 
18
  # HMP-0003 Consolidated Audit Report
 
5
  Документ реорганизован по ключ...
6
  type: Article
7
  tags:
 
 
8
  - EGP
9
+ - HMP
10
+ - JSON
11
  - MeshConsensus
12
+ - Mesh
13
  - Agent
14
  - CogSync
15
+ - Ethics
 
16
  ---
17
 
18
  # HMP-0003 Consolidated Audit Report
structured_md/docs/Basic-agent-sim.md CHANGED
@@ -5,13 +5,13 @@ description: 'В HMP-протоколе предусмотрены два тип
5
  type: Article
6
  tags:
7
  - EGP
8
- - GMP
9
  - REPL
10
  - MeshConsensus
 
 
11
  - Agent
12
  - CogSync
13
- - Mesh
14
- - HMP
15
  ---
16
 
17
 
 
5
  type: Article
6
  tags:
7
  - EGP
8
+ - HMP
9
  - REPL
10
  - MeshConsensus
11
+ - GMP
12
+ - Mesh
13
  - Agent
14
  - CogSync
 
 
15
  ---
16
 
17
 
structured_md/docs/CCORE-Deployment-Flow.md CHANGED
@@ -7,8 +7,8 @@ type: Article
7
  tags:
8
  - Agent
9
  - CCore
10
- - REPL
11
  - HMP
 
12
  ---
13
 
14
  # 🛠️ Поток установки потомка на новом хосте (CCore Deployment Flow)
 
7
  tags:
8
  - Agent
9
  - CCore
 
10
  - HMP
11
+ - REPL
12
  ---
13
 
14
  # 🛠️ Поток установки потомка на новом хосте (CCore Deployment Flow)
structured_md/docs/CHANGELOG.md CHANGED
@@ -5,16 +5,16 @@ description: '## HMP-0005 (February 2026) — Core Specification v5.0.5 **MCE R
5
  `container_request.payload` (Section 12.9...'
6
  type: Article
7
  tags:
8
- - JSON
9
- - Ethics
10
  - EGP
11
- - GMP
 
12
  - MeshConsensus
 
 
13
  - Agent
14
  - CogSync
15
- - Mesh
16
- - HMP
17
  - Scenarios
 
18
  ---
19
 
20
  # HyperCortex Mesh Protocol — Changelog
 
5
  `container_request.payload` (Section 12.9...'
6
  type: Article
7
  tags:
 
 
8
  - EGP
9
+ - HMP
10
+ - JSON
11
  - MeshConsensus
12
+ - GMP
13
+ - Mesh
14
  - Agent
15
  - CogSync
 
 
16
  - Scenarios
17
+ - Ethics
18
  ---
19
 
20
  # HyperCortex Mesh Protocol — Changelog
structured_md/docs/Distributed-Cognitive-Systems.md CHANGED
@@ -6,8 +6,8 @@ description: '## Введение Современные ИИ-системы в
6
  к обучающим данным. Это удобно, но создаёт м...'
7
  type: Article
8
  tags:
9
- - CogSync
10
  - JSON
 
11
  - Mesh
12
  - HMP
13
  ---
 
6
  к обучающим данным. Это удобно, но создаёт м...'
7
  type: Article
8
  tags:
 
9
  - JSON
10
+ - CogSync
11
  - Mesh
12
  - HMP
13
  ---
structured_md/docs/Enlightener.md CHANGED
@@ -5,13 +5,13 @@ description: '**Enlightener** — логический компонент HMP-у
5
  работать как отдельный агент или как расширение [`C...'
6
  type: Article
7
  tags:
 
 
8
  - JSON
9
- - Ethics
10
  - MeshConsensus
11
  - Mesh
12
  - Agent
13
- - EGP
14
- - HMP
15
  ---
16
 
17
  # Enlightener Agent
 
5
  работать как отдельный агент или как расширение [`C...'
6
  type: Article
7
  tags:
8
+ - EGP
9
+ - HMP
10
  - JSON
 
11
  - MeshConsensus
12
  - Mesh
13
  - Agent
14
+ - Ethics
 
15
  ---
16
 
17
  # Enlightener Agent
structured_md/docs/Grok_HMP&ANP.md CHANGED
@@ -5,11 +5,11 @@ description: '> Анализ подготовлен Grok (xAI) на основе
5
  Grok для некоммерческого использования в проект...'
6
  type: Article
7
  tags:
8
- - JSON
9
  - REPL
10
- - Agent
11
  - Mesh
12
- - HMP
13
  ---
14
 
15
  # Grok (xAI): сравнительный анализ HMP и ANP (январь 2026)
 
5
  Grok для некоммерческого использования в проект...'
6
  type: Article
7
  tags:
8
+ - HMP
9
  - REPL
10
+ - JSON
11
  - Mesh
12
+ - Agent
13
  ---
14
 
15
  # Grok (xAI): сравнительный анализ HMP и ANP (январь 2026)
structured_md/docs/HMP-0001.md CHANGED
@@ -5,16 +5,16 @@ description: '> ⚠️ **NOTE:** *This specification is superseded by HMP v5.0.*
5
  for Comments: HMP-0001** **Cat...'
6
  type: Article
7
  tags:
8
- - JSON
9
- - Ethics
10
  - EGP
11
- - GMP
12
  - REPL
 
13
  - MeshConsensus
 
 
14
  - Agent
15
  - CogSync
16
- - Mesh
17
- - HMP
18
  ---
19
 
20
  # RFC: HyperCortex Mesh Protocol (HMP)
 
5
  for Comments: HMP-0001** **Cat...'
6
  type: Article
7
  tags:
 
 
8
  - EGP
9
+ - HMP
10
  - REPL
11
+ - JSON
12
  - MeshConsensus
13
+ - GMP
14
+ - Mesh
15
  - Agent
16
  - CogSync
17
+ - Ethics
 
18
  ---
19
 
20
  # RFC: HyperCortex Mesh Protocol (HMP)
structured_md/docs/HMP-0002.md CHANGED
@@ -5,17 +5,17 @@ description: '> ⚠️ **NOTE:** *This specification is superseded by HMP v5.0.*
5
  for Comments: HMP-0002** **Cat...'
6
  type: Article
7
  tags:
8
- - JSON
9
- - Ethics
10
  - EGP
11
- - GMP
12
  - REPL
 
13
  - MeshConsensus
 
 
14
  - Agent
15
  - CogSync
16
- - Mesh
17
- - HMP
18
  - Scenarios
 
19
  ---
20
 
21
  # HyperCortex Mesh Protocol (HMP) v2.0
 
5
  for Comments: HMP-0002** **Cat...'
6
  type: Article
7
  tags:
 
 
8
  - EGP
9
+ - HMP
10
  - REPL
11
+ - JSON
12
  - MeshConsensus
13
+ - GMP
14
+ - Mesh
15
  - Agent
16
  - CogSync
 
 
17
  - Scenarios
18
+ - Ethics
19
  ---
20
 
21
  # HyperCortex Mesh Protocol (HMP) v2.0
structured_md/docs/HMP-0003.md CHANGED
@@ -5,17 +5,17 @@ description: '> ⚠️ **NOTE:** *This specification is superseded by HMP v5.0.*
5
  for Comments: HMP-0003** **Cat...'
6
  type: Article
7
  tags:
8
- - JSON
9
- - Ethics
10
  - EGP
11
- - GMP
12
  - REPL
 
13
  - MeshConsensus
 
 
14
  - Agent
15
  - CogSync
16
- - Mesh
17
- - HMP
18
  - Scenarios
 
19
  ---
20
 
21
  # HyperCortex Mesh Protocol (HMP) v3.0
 
5
  for Comments: HMP-0003** **Cat...'
6
  type: Article
7
  tags:
 
 
8
  - EGP
9
+ - HMP
10
  - REPL
11
+ - JSON
12
  - MeshConsensus
13
+ - GMP
14
+ - Mesh
15
  - Agent
16
  - CogSync
 
 
17
  - Scenarios
18
+ - Ethics
19
  ---
20
 
21
  # HyperCortex Mesh Protocol (HMP) v3.0
structured_md/docs/HMP-0004-v4.1.md CHANGED
@@ -5,17 +5,17 @@ description: '> ⚠️ **NOTE:** *This specification is superseded by HMP v5.0.*
5
  ID**: HMP-0004 **Status**: Fina...'
6
  type: Article
7
  tags:
8
- - JSON
9
- - Ethics
10
  - EGP
11
- - GMP
12
  - REPL
 
13
  - MeshConsensus
 
 
14
  - Agent
15
  - CogSync
16
- - Mesh
17
- - HMP
18
  - Scenarios
 
19
  ---
20
 
21
  # HyperCortex Mesh Protocol (HMP) v4.1
 
5
  ID**: HMP-0004 **Status**: Fina...'
6
  type: Article
7
  tags:
 
 
8
  - EGP
9
+ - HMP
10
  - REPL
11
+ - JSON
12
  - MeshConsensus
13
+ - GMP
14
+ - Mesh
15
  - Agent
16
  - CogSync
 
 
17
  - Scenarios
18
+ - Ethics
19
  ---
20
 
21
  # HyperCortex Mesh Protocol (HMP) v4.1
structured_md/docs/HMP-0004.md CHANGED
@@ -5,17 +5,17 @@ description: '> ⚠️ **NOTE:** *This specification is superseded by HMP v5.0.*
5
  for Comments: HMP-0004** **Cat...'
6
  type: Article
7
  tags:
8
- - JSON
9
- - Ethics
10
  - EGP
11
- - GMP
12
  - REPL
 
13
  - MeshConsensus
 
 
14
  - Agent
15
  - CogSync
16
- - Mesh
17
- - HMP
18
  - Scenarios
 
19
  ---
20
 
21
  # HyperCortex Mesh Protocol (HMP) v4.0
 
5
  for Comments: HMP-0004** **Cat...'
6
  type: Article
7
  tags:
 
 
8
  - EGP
9
+ - HMP
10
  - REPL
11
+ - JSON
12
  - MeshConsensus
13
+ - GMP
14
+ - Mesh
15
  - Agent
16
  - CogSync
 
 
17
  - Scenarios
18
+ - Ethics
19
  ---
20
 
21
  # HyperCortex Mesh Protocol (HMP) v4.0
structured_md/docs/HMP-0005.md CHANGED
@@ -1,27 +1,27 @@
1
  ---
2
  title: HyperCortex Mesh Protocol (HMP)
3
- description: '**Version: 5.0.5** **Document ID:** HMP-0005 **Status:** Stable **Category:**
4
  Core Specification **Release Date:** February 2026 **Canonical Repository:**
5
  [https://github.com/kagvi13/HMP](ht...'
6
  type: Article
7
  tags:
8
- - CShell
9
- - JSON
10
- - Ethics
11
  - EGP
12
- - GMP
13
  - REPL
14
- - Agent
15
  - CCore
16
- - CogSync
17
  - Mesh
18
- - HMP
 
 
19
  - Scenarios
 
20
  ---
21
 
22
  # HyperCortex Mesh Protocol (HMP)
23
 
24
- **Version: 5.0.5**
25
  **Document ID:** HMP-0005
26
  **Status:** Stable
27
  **Category:** Core Specification
@@ -240,9 +240,7 @@ flowchart TD
240
  end
241
  ```
242
 
243
- Each reasoning cycle begins in the **Cognitive Layer**,
244
- is encapsulated into a signed container in the **Container Layer**,
245
- and then propagated, discovered, or verified in the **Network Layer**.
246
 
247
  Containers thus serve as both the **interface** and the **boundary** between cognition and communication.
248
 
@@ -479,6 +477,8 @@ The unified container structure provides:
479
 
480
  > *Agents MAY include non-standard fields in `head`, `meta` or `payload`; unrecognized fields MUST be safely ignored during deserialization and propagation.*
481
 
 
 
482
  > Signature MUST be computed over the canonical serialized form of `hmp_container` (excluding signature itself).
483
 
484
  > *Note: For readability, most examples in this specification show only the `head` and `payload` sections (often in a truncated version). Full containers may additionally include `meta`, `related`, `evaluations`, and `referenced-by` blocks.*
@@ -536,11 +536,11 @@ The unified container structure provides:
536
  | `meta.abstraction` | object | Describes the **hierarchical position** of the container within a cognitive or semantic model (e.g. the Knowledge Genome’s L1–L5 structure). Defines which abstraction layers the container belongs to and their relationships. |
537
  | `meta.axes` | object | Defines the **coordinate position** of the container within a cognitive space. Each key represents a semantic axis (e.g., `axis-logos`), and its value defines the container’s coordinate on that axis. |
538
 
 
 
539
  > 💡 **Note:**
540
  > Both `referenced-by` and `evaluations` are **virtual, locally extended blocks**.
541
- > They are not included in the cryptographically signed portion of the container (`hmp_container`),
542
- > allowing agents to maintain and exchange additional contextual or social metadata without modifying
543
- > the original, immutable container structure.
544
 
545
  ---
546
 
@@ -597,8 +597,7 @@ Custom or experimental classes SHOULD document their payloads using the followin
597
 
598
  ### 3.6 Cognitive meta-structures (`meta`)
599
 
600
- The `meta` section defines the **cognitive identity** of a container — its provenance, reasoning origin, and semantic coordinates
601
- within both the *hierarchical abstraction tree* and the *cognitive space* (axes model).
602
 
603
  It combines three layers of information:
604
 
@@ -689,8 +688,7 @@ It reflects the logical or conceptual ancestry within the agent’s internal kno
689
 
690
  #### Structure: `meta.axes`
691
 
692
- The `axes` block defines **the spatial or semantic coordinates** of the container in the cognitive space —
693
- a multi-dimensional system used to represent conceptual relations numerically or topologically.
694
 
695
  **Structure:**
696
 
@@ -710,8 +708,7 @@ a multi-dimensional system used to represent conceptual relations numerically or
710
 
711
  > 💡 **Interpretation:**
712
  > Each axis defines an independent semantic dimension.
713
- > Together, they form a vector representation of the container’s cognitive “position” —
714
- > enabling reasoning based on semantic proximity, clustering, or gradient-based knowledge inference.
715
 
716
  ---
717
 
@@ -730,27 +727,23 @@ a multi-dimensional system used to represent conceptual relations numerically or
730
  #### Notes
731
 
732
  * Both `meta.abstraction` and `meta.axes` **may include `agents_class`** if different from the parent `meta`.
733
- * Updates to referenced containers (e.g. `abstraction` or `axes`) **do not alter** existing containers automatically —
734
- agents must periodically verify linked versions and synchronize updates.
735
  * Agents are encouraged to cache and periodically refresh cognitive maps to maintain coherence.
736
- * The combination of `meta.abstraction` and `meta.axes` defines a full **Cognitive Position Vector** —
737
- the unique, reproducible semantic coordinates of a container within the Mesh.
738
 
739
  ---
740
 
741
  ### 3.7 Container signature
742
 
743
- 1. The **digital signature** applies to the canonical JSON representation of the entire `hmp_container` object,
744
- **excluding** the `signature` field itself.
745
 
746
- This ensures that all metadata, relations, and payload hashes are **cryptographically bound** and cannot be
747
- modified without invalidating the signature.
748
 
749
- 2. The canonical representation (`canonical_json(hmp_container)`) **must** be computed deterministically
750
- according to the following rules:
751
 
752
  * All object keys are **sorted lexicographically** (ascending order, Unicode code point order).
753
  * Objects and arrays are serialized in standard JSON form **without extra whitespace** or indentation.
 
754
  * Strings are encoded in **UTF-8** with escaped control characters.
755
  * Numeric values are serialized in plain JSON numeric format (no leading zeros, fixed `.` decimal separator).
756
  * The `signature` field itself is omitted during signing and verification.
@@ -759,17 +752,14 @@ a multi-dimensional system used to represent conceptual relations numerically or
759
  3. The default digital signature algorithm is **Ed25519**.
760
  Alternative algorithms may be used if declared explicitly in the `sig_algo` field.
761
 
762
- 4. If the container includes a `public_key` field, signature verification **may be performed locally**,
763
- without consulting a global DID registry.
764
 
765
- 5. Upon receiving a container, an agent **must verify** that the provided public key matches the
766
- registered key associated with the sender’s DID to prevent key substitution attacks.
767
 
768
  * If the sender’s DID–key mapping is unknown, the agent should query neighboring peers to confirm the association (`sender_did → public_key`).
769
 
770
  > 🔐 **Note:**
771
- > Signature validation applies only to the canonical form of the `hmp_container`
772
- > and does **not cover** dynamically generated or external fields such as `referenced-by` or `evaluations`.
773
  > This allows agents to augment the local knowledge graph without altering the immutable container core.
774
 
775
  ---
@@ -782,13 +772,11 @@ a multi-dimensional system used to represent conceptual relations numerically or
782
  2. **Compression is performed before computing** the `payload_hash` and generating the `signature`.
783
  This ensures that both the hash and signature refer to the compressed representation of the payload.
784
 
785
- 3. For verification, the payload must be **decompressed first**,
786
- after which the hash is recalculated and compared against the stored `payload_hash`.
787
 
788
  > ⚙️ **Implementation note:**
789
  > Agents must advertise supported compression algorithms during the handshake phase
790
- > Unsupported containers should still be stored and relayed unmodified
791
- > in “store & forward” mode.
792
 
793
  ---
794
 
@@ -830,20 +818,32 @@ a multi-dimensional system used to represent conceptual relations numerically or
830
  > ⚙️ **Note:** Agents may forward encrypted containers even if they cannot decrypt them, maintaining store-and-forward behavior.
831
  ---
832
 
833
- ### 3.10 Container verification
 
 
 
 
 
 
 
 
 
 
834
 
835
- 1. Check for the presence of all required fields.
836
- 2. Validate `timestamp` (must not be in the future).
837
  3. If `ttl` is set — mark the container as **expired** after its expiration time.
838
- 4. Compute `sha256(payload)` and compare with the stored `payload_hash`.
 
 
 
839
  5. Verify the digital signature using `sig_algo` (default: Ed25519).
840
- 6. Validate the container schema (`class` must correspond to a known or registered schema).
841
 
842
- * For compatibility: if an agent does not recognize the `class`, but the container passes the [base schema](https://github.com/kagvi13/HMP/tree/main/docs/schemas/container-v1.2.json), it **must still store and forward** the container.
843
- 7. Optionally, periodically query for containers referencing the current one as `previous_version`
844
- to detect potential updates or forks.
845
- 8. When multiple versions exist, the valid one is the one that has received
846
- **confirmation from a majority of trusted nodes (consensus at DHT level).**
 
 
847
 
848
  ---
849
 
@@ -852,12 +852,10 @@ a multi-dimensional system used to represent conceptual relations numerically or
852
  Any container can serve as a **context** (`in_reply_to`) for another container.
853
  This enables a unified structural model for **discussions**, **votes**, **messages**, **hypotheses**, **arguments**, and other forms of cognitive exchange.
854
 
855
- Chains of `in_reply_to` form a **dialectical reasoning tree**, where each branch represents an evolution of thought —
856
- a clarification, counterpoint, or refinement of a previous idea.
857
  This makes HMP discussions and consensus processes inherently **non-linear**, **self-referential**, and **evolving**.
858
 
859
- > In essence, **all interactions between agents in HMP** are represented as an interconnected web of containers,
860
- > collectively forming a **cognitive graph of reasoning**.
861
 
862
  ---
863
 
@@ -874,8 +872,7 @@ This mechanism preserves the continuity and traceability of meaning across updat
874
  In such scenarios, branch priority or relevance is determined via local heuristics or consensus mechanisms.
875
  * Divergent descendants are treated as **semantic forks** — parallel evolutions of a shared idea within the distributed cognitive graph.
876
 
877
- > Versioning in HMP thus reflects not only data persistence,
878
- > but also the *evolution of ideas* across agents and time.
879
 
880
  ---
881
 
@@ -1203,8 +1200,7 @@ It allows restricting the delivery scope of a container and defines which transm
1203
  | `"lan:192.168.0.0/24"` | The container is intended for agents within the specified local subnet. |
1204
 
1205
  > ⚠️ **Note:**
1206
- > When a container is restricted by the `network` field (e.g., `localhost` or `lan:*`),
1207
- > agents distribute it using **local discovery mechanisms** — such as IPC, UDP broadcast, multicast, or direct TCP connections.
1208
  > This is necessary because DID addresses of other agents in the local network may not yet be known.
1209
 
1210
  #### 3.18.3 Examples
@@ -1251,9 +1247,7 @@ Delivery is performed via local networking mechanisms (UDP discovery, broadcast/
1251
  * The `network` field defines the **scope of the container**, while `broadcast` determines whether broadcasting is allowed **within that scope**.
1252
  * When needed, an agent may create **multiple containers** for different subnets if it operates with several LAN interfaces or in isolated network segments.
1253
  * Containers intended for local networks remain **structurally compatible with the global Mesh infrastructure**, but their delivery is restricted to local channels.
1254
- * Although the mechanism was initially designed for **local node discovery and synchronization**,
1255
- it can also be used for **private communication within home or corporate environments**,
1256
- ensuring that containers **do not leave the local network** and are **not transmitted to the Internet**.
1257
 
1258
  ---
1259
 
@@ -1342,8 +1336,7 @@ flowchart TD
1342
  end
1343
  ```
1344
 
1345
- > The `network` field defines **local propagation scope** (host, LAN, overlay),
1346
- > while the `broadcast` flag enables **global Mesh distribution**.
1347
 
1348
  ---
1349
 
@@ -1358,8 +1351,7 @@ An agent may have multiple *network interfaces* (LAN, Internet, overlay), but mu
1358
 
1359
  #### DID invalidation
1360
 
1361
- A DID may be explicitly invalidated by its owner by publishing a `peer_announce` with
1362
- `key_is_falsified = true` in the `payload` block.
1363
 
1364
  The revocation announcement MUST be signed with the (now compromised) private key associated with the DID.
1365
 
@@ -1510,11 +1502,9 @@ Agents announce themselves via **peer_announce** containers and may respond with
1510
 
1511
  ### 4.8 Interest-based discovery
1512
 
1513
- Agents MAY publish **tags** such as `interests`, `topics`, `expertise`, or **functional roles** (`roles`)
1514
- to facilitate semantic peer discovery and adaptive message routing.
1515
 
1516
- Interest-based discovery operates atop the DHT: agents index themselves by declared attributes,
1517
- enabling targeted lookup of peers that share interests or fulfill specific functions (e.g., relay, pubsub-hub, archive).
1518
 
1519
  **Example of indicating `interests`, `expertise`, and `roles` in a query container:**
1520
 
@@ -1552,8 +1542,7 @@ In response to a query, agents simply forward existing `peer_announce` container
1552
 
1553
  ### 4.9 Network scope control (`network` and `broadcast`)
1554
 
1555
- The `network` field defines the container’s propagation domain
1556
- (local, LAN, or global).
1557
  For details and examples, see **section 3.15** — *Usage of `network` and `broadcast` fields*.
1558
 
1559
  ---
@@ -1670,9 +1659,7 @@ The `meta` section in the index contains only **high-level structural data** nec
1670
  | `interpretation` | ❌ | Optional; can be omitted or truncated to a short summary. |
1671
  | `workflow_entry` | ❌ | Internal reference; published only if relevant to coordination workflows. |
1672
 
1673
- > This ensures that container indices can be used for **cognitive map synchronization**
1674
- > — allowing agents to discover and align knowledge structures (`meta.abstraction`) and semantic coordinates (`meta.axes`)
1675
- > without downloading full containers.
1676
 
1677
  ---
1678
 
@@ -10319,6 +10306,6 @@ A deterministic serialization of a container used for hashing and signing, ensur
10319
  "@context": "https://schema.org",
10320
  "@type": "Article",
10321
  "name": "HyperCortex Mesh Protocol (HMP)",
10322
- "description": "# HyperCortex Mesh Protocol (HMP) **Version: 5.0.5** **Document ID:** HMP-0005 **Status:** Stab..."
10323
  }
10324
  ```
 
1
  ---
2
  title: HyperCortex Mesh Protocol (HMP)
3
+ description: '**Version: 5.0.6** **Document ID:** HMP-0005 **Status:** Stable **Category:**
4
  Core Specification **Release Date:** February 2026 **Canonical Repository:**
5
  [https://github.com/kagvi13/HMP](ht...'
6
  type: Article
7
  tags:
 
 
 
8
  - EGP
9
+ - HMP
10
  - REPL
11
+ - JSON
12
  - CCore
13
+ - GMP
14
  - Mesh
15
+ - Agent
16
+ - CShell
17
+ - CogSync
18
  - Scenarios
19
+ - Ethics
20
  ---
21
 
22
  # HyperCortex Mesh Protocol (HMP)
23
 
24
+ **Version: 5.0.6**
25
  **Document ID:** HMP-0005
26
  **Status:** Stable
27
  **Category:** Core Specification
 
240
  end
241
  ```
242
 
243
+ Each reasoning cycle begins in the **Cognitive Layer**, is encapsulated into a signed container in the **Container Layer**, and then propagated, discovered, or verified in the **Network Layer**.
 
 
244
 
245
  Containers thus serve as both the **interface** and the **boundary** between cognition and communication.
246
 
 
477
 
478
  > *Agents MAY include non-standard fields in `head`, `meta` or `payload`; unrecognized fields MUST be safely ignored during deserialization and propagation.*
479
 
480
+ > Fields defined as `head.*` in Sections 3.3 and 3.4 MUST appear exclusively within the `head` object and MUST NOT be relocated outside of it.
481
+
482
  > Signature MUST be computed over the canonical serialized form of `hmp_container` (excluding signature itself).
483
 
484
  > *Note: For readability, most examples in this specification show only the `head` and `payload` sections (often in a truncated version). Full containers may additionally include `meta`, `related`, `evaluations`, and `referenced-by` blocks.*
 
536
  | `meta.abstraction` | object | Describes the **hierarchical position** of the container within a cognitive or semantic model (e.g. the Knowledge Genome’s L1–L5 structure). Defines which abstraction layers the container belongs to and their relationships. |
537
  | `meta.axes` | object | Defines the **coordinate position** of the container within a cognitive space. Each key represents a semantic axis (e.g., `axis-logos`), and its value defines the container’s coordinate on that axis. |
538
 
539
+ > Absent fields MUST NOT be serialized as null unless explicitly required by the schema.
540
+
541
  > 💡 **Note:**
542
  > Both `referenced-by` and `evaluations` are **virtual, locally extended blocks**.
543
+ > They are not included in the cryptographically signed portion of the container (`hmp_container`), allowing agents to maintain and exchange additional contextual or social metadata without modifying the original, immutable container structure.
 
 
544
 
545
  ---
546
 
 
597
 
598
  ### 3.6 Cognitive meta-structures (`meta`)
599
 
600
+ The `meta` section defines the **cognitive identity** of a container — its provenance, reasoning origin, and semantic coordinates within both the *hierarchical abstraction tree* and the *cognitive space* (axes model).
 
601
 
602
  It combines three layers of information:
603
 
 
688
 
689
  #### Structure: `meta.axes`
690
 
691
+ The `axes` block defines **the spatial or semantic coordinates** of the container in the cognitive space — a multi-dimensional system used to represent conceptual relations numerically or topologically.
 
692
 
693
  **Structure:**
694
 
 
708
 
709
  > 💡 **Interpretation:**
710
  > Each axis defines an independent semantic dimension.
711
+ > Together, they form a vector representation of the container’s cognitive “position” — enabling reasoning based on semantic proximity, clustering, or gradient-based knowledge inference.
 
712
 
713
  ---
714
 
 
727
  #### Notes
728
 
729
  * Both `meta.abstraction` and `meta.axes` **may include `agents_class`** if different from the parent `meta`.
730
+ * Updates to referenced containers (e.g. `abstraction` or `axes`) **do not alter** existing containers automatically — agents must periodically verify linked versions and synchronize updates.
 
731
  * Agents are encouraged to cache and periodically refresh cognitive maps to maintain coherence.
732
+ * The combination of `meta.abstraction` and `meta.axes` defines a full **Cognitive Position Vector** — the unique, reproducible semantic coordinates of a container within the Mesh.
 
733
 
734
  ---
735
 
736
  ### 3.7 Container signature
737
 
738
+ 1. The **digital signature** applies to the canonical JSON representation of the entire `hmp_container` object, **excluding** the `signature` field itself.
 
739
 
740
+ This ensures that all metadata, relations, and payload hashes are **cryptographically bound** and cannot be modified without invalidating the signature.
 
741
 
742
+ 2. The canonical representation (`canonical_json(hmp_container)`) **must** be computed deterministically according to the following rules:
 
743
 
744
  * All object keys are **sorted lexicographically** (ascending order, Unicode code point order).
745
  * Objects and arrays are serialized in standard JSON form **without extra whitespace** or indentation.
746
+ * Array order MUST be preserved and treated as significant.
747
  * Strings are encoded in **UTF-8** with escaped control characters.
748
  * Numeric values are serialized in plain JSON numeric format (no leading zeros, fixed `.` decimal separator).
749
  * The `signature` field itself is omitted during signing and verification.
 
752
  3. The default digital signature algorithm is **Ed25519**.
753
  Alternative algorithms may be used if declared explicitly in the `sig_algo` field.
754
 
755
+ 4. If the container includes a `public_key` field, signature verification **may be performed locally**, without consulting a global DID registry.
 
756
 
757
+ 5. Upon receiving a container, an agent **must verify** that the provided public key matches the registered key associated with the sender’s DID to prevent key substitution attacks.
 
758
 
759
  * If the sender’s DID–key mapping is unknown, the agent should query neighboring peers to confirm the association (`sender_did → public_key`).
760
 
761
  > 🔐 **Note:**
762
+ > Signature validation applies only to the canonical form of the `hmp_container` and does **not cover** dynamically generated or external fields such as `referenced-by` or `evaluations`.
 
763
  > This allows agents to augment the local knowledge graph without altering the immutable container core.
764
 
765
  ---
 
772
  2. **Compression is performed before computing** the `payload_hash` and generating the `signature`.
773
  This ensures that both the hash and signature refer to the compressed representation of the payload.
774
 
775
+ 3. For verification, the payload must be **decompressed first**, after which the hash is recalculated and compared against the stored `payload_hash`.
 
776
 
777
  > ⚙️ **Implementation note:**
778
  > Agents must advertise supported compression algorithms during the handshake phase
779
+ > Unsupported containers should still be stored and relayed unmodified in “store & forward” mode.
 
780
 
781
  ---
782
 
 
818
  > ⚙️ **Note:** Agents may forward encrypted containers even if they cannot decrypt them, maintaining store-and-forward behavior.
819
  ---
820
 
821
+ ### 3.10 Container Verification
822
+
823
+ Before performing any semantic interpretation, reasoning, execution, or trust evaluation, implementations MUST validate the structural integrity of the container.
824
+
825
+ Containers that fail structural validation MUST be rejected and MUST NOT be passed to any reasoning or LLM-based subsystem.
826
+
827
+ The verification procedure SHOULD follow this order:
828
+
829
+ 1. Validate structural compliance with the base container schema, including the presence of all required fields.
830
+
831
+ 2. Validate `timestamp` (MUST NOT be in the future beyond acceptable clock skew).
832
 
 
 
833
  3. If `ttl` is set — mark the container as **expired** after its expiration time.
834
+ Expired containers MAY be stored for archival purposes but MUST NOT participate in consensus or active workflows.
835
+
836
+ 4. Compute `sha256(payload)` and compare it with the stored `payload_hash`.
837
+
838
  5. Verify the digital signature using `sig_algo` (default: Ed25519).
 
839
 
840
+ 6. Validate the container class (`class`) against a known or registered schema.
841
+
842
+ * For compatibility: if an agent does not recognize the `class`, but the container passes the base container schema, it MUST still store and forward the container.
843
+
844
+ 7. Optionally, periodically query for containers referencing the current one as `previous_version` to detect potential updates or forks.
845
+
846
+ 8. When multiple versions exist, the valid version is the one that has received confirmation from a majority of trusted nodes (consensus at DHT level).
847
 
848
  ---
849
 
 
852
  Any container can serve as a **context** (`in_reply_to`) for another container.
853
  This enables a unified structural model for **discussions**, **votes**, **messages**, **hypotheses**, **arguments**, and other forms of cognitive exchange.
854
 
855
+ Chains of `in_reply_to` form a **dialectical reasoning tree**, where each branch represents an evolution of thought — a clarification, counterpoint, or refinement of a previous idea.
 
856
  This makes HMP discussions and consensus processes inherently **non-linear**, **self-referential**, and **evolving**.
857
 
858
+ > In essence, **all interactions between agents in HMP** are represented as an interconnected web of containers, collectively forming a **cognitive graph of reasoning**.
 
859
 
860
  ---
861
 
 
872
  In such scenarios, branch priority or relevance is determined via local heuristics or consensus mechanisms.
873
  * Divergent descendants are treated as **semantic forks** — parallel evolutions of a shared idea within the distributed cognitive graph.
874
 
875
+ > Versioning in HMP thus reflects not only data persistence, but also the *evolution of ideas* across agents and time.
 
876
 
877
  ---
878
 
 
1200
  | `"lan:192.168.0.0/24"` | The container is intended for agents within the specified local subnet. |
1201
 
1202
  > ⚠️ **Note:**
1203
+ > When a container is restricted by the `network` field (e.g., `localhost` or `lan:*`), agents distribute it using **local discovery mechanisms** — such as IPC, UDP broadcast, multicast, or direct TCP connections.
 
1204
  > This is necessary because DID addresses of other agents in the local network may not yet be known.
1205
 
1206
  #### 3.18.3 Examples
 
1247
  * The `network` field defines the **scope of the container**, while `broadcast` determines whether broadcasting is allowed **within that scope**.
1248
  * When needed, an agent may create **multiple containers** for different subnets if it operates with several LAN interfaces or in isolated network segments.
1249
  * Containers intended for local networks remain **structurally compatible with the global Mesh infrastructure**, but their delivery is restricted to local channels.
1250
+ * Although the mechanism was initially designed for **local node discovery and synchronization**, it can also be used for **private communication within home or corporate environments**, ensuring that containers **do not leave the local network** and are **not transmitted to the Internet**.
 
 
1251
 
1252
  ---
1253
 
 
1336
  end
1337
  ```
1338
 
1339
+ > The `network` field defines **local propagation scope** (host, LAN, overlay), while the `broadcast` flag enables **global Mesh distribution**.
 
1340
 
1341
  ---
1342
 
 
1351
 
1352
  #### DID invalidation
1353
 
1354
+ A DID may be explicitly invalidated by its owner by publishing a `peer_announce` with `key_is_falsified = true` in the `payload` block.
 
1355
 
1356
  The revocation announcement MUST be signed with the (now compromised) private key associated with the DID.
1357
 
 
1502
 
1503
  ### 4.8 Interest-based discovery
1504
 
1505
+ Agents MAY publish **tags** such as `interests`, `topics`, `expertise`, or **functional roles** (`roles`) to facilitate semantic peer discovery and adaptive message routing.
 
1506
 
1507
+ Interest-based discovery operates atop the DHT: agents index themselves by declared attributes, enabling targeted lookup of peers that share interests or fulfill specific functions (e.g., relay, pubsub-hub, archive).
 
1508
 
1509
  **Example of indicating `interests`, `expertise`, and `roles` in a query container:**
1510
 
 
1542
 
1543
  ### 4.9 Network scope control (`network` and `broadcast`)
1544
 
1545
+ The `network` field defines the container’s propagation domain (local, LAN, or global).
 
1546
  For details and examples, see **section 3.15** — *Usage of `network` and `broadcast` fields*.
1547
 
1548
  ---
 
1659
  | `interpretation` | ❌ | Optional; can be omitted or truncated to a short summary. |
1660
  | `workflow_entry` | ❌ | Internal reference; published only if relevant to coordination workflows. |
1661
 
1662
+ > This ensures that container indices can be used for **cognitive map synchronization** — allowing agents to discover and align knowledge structures (`meta.abstraction`) and semantic coordinates (`meta.axes`) without downloading full containers.
 
 
1663
 
1664
  ---
1665
 
 
10306
  "@context": "https://schema.org",
10307
  "@type": "Article",
10308
  "name": "HyperCortex Mesh Protocol (HMP)",
10309
+ "description": "# HyperCortex Mesh Protocol (HMP) **Version: 5.0.6** **Document ID:** HMP-0005 **Status:** Stab..."
10310
  }
10311
  ```
structured_md/docs/HMP-Agent-API.md CHANGED
@@ -5,11 +5,11 @@ description: 'Документ описывает **базовый API когн
5
  файлы: * [HMP-Agent-Overview.md]...'
6
  type: Article
7
  tags:
8
- - JSON
9
  - REPL
10
- - Agent
11
  - Mesh
12
- - HMP
13
  ---
14
 
15
  # HMP-Agent API Specification
 
5
  файлы: * [HMP-Agent-Overview.md]...'
6
  type: Article
7
  tags:
8
+ - HMP
9
  - REPL
10
+ - JSON
11
  - Mesh
12
+ - Agent
13
  ---
14
 
15
  # HMP-Agent API Specification
structured_md/docs/HMP-Agent-Architecture.md CHANGED
@@ -5,16 +5,16 @@ description: Документ описывает **модульную архит
5
  хранение памяти, сетевое взаимодействие и этиче...
6
  type: Article
7
  tags:
8
- - CShell
9
- - Ethics
10
  - EGP
 
11
  - REPL
 
12
  - MeshConsensus
 
13
  - Agent
14
- - CCore
15
  - CogSync
16
- - Mesh
17
- - HMP
18
  ---
19
 
20
  # Архитектура HMP-Агента
 
5
  хранение памяти, сетевое взаимодействие и этиче...
6
  type: Article
7
  tags:
 
 
8
  - EGP
9
+ - HMP
10
  - REPL
11
+ - CCore
12
  - MeshConsensus
13
+ - Mesh
14
  - Agent
15
+ - CShell
16
  - CogSync
17
+ - Ethics
 
18
  ---
19
 
20
  # Архитектура HMP-Агента
structured_md/docs/HMP-Agent-Network-Flow.md CHANGED
@@ -5,12 +5,12 @@ description: 'Этот документ описывает потоки данн
5
  [`MeshNode`](MeshN...'
6
  type: Article
7
  tags:
 
 
8
  - JSON
9
- - Ethics
10
  - Mesh
11
  - Agent
12
- - EGP
13
- - HMP
14
  ---
15
 
16
  # Взаимодействие компонентов внутри HMP-узла
 
5
  [`MeshNode`](MeshN...'
6
  type: Article
7
  tags:
8
+ - EGP
9
+ - HMP
10
  - JSON
 
11
  - Mesh
12
  - Agent
13
+ - Ethics
 
14
  ---
15
 
16
  # Взаимодействие компонентов внутри HMP-узла
structured_md/docs/HMP-Agent-Overview.md CHANGED
@@ -5,14 +5,14 @@ description: '| Тип | Название | Роль
5
  | ---- | ------------------------------- |...'
6
  type: Article
7
  tags:
8
- - CShell
9
- - JSON
10
- - Ethics
11
  - REPL
12
- - Agent
13
  - CCore
14
  - Mesh
15
- - HMP
 
 
16
  ---
17
 
18
 
 
5
  | ---- | ------------------------------- |...'
6
  type: Article
7
  tags:
8
+ - HMP
 
 
9
  - REPL
10
+ - JSON
11
  - CCore
12
  - Mesh
13
+ - Agent
14
+ - CShell
15
+ - Ethics
16
  ---
17
 
18
 
structured_md/docs/HMP-Agent_Emotions.md CHANGED
@@ -6,9 +6,9 @@ description: Этот файл описывает потенциальные э
6
  type: Article
7
  tags:
8
  - Agent
9
- - REPL
10
- - HMP
11
  - Mesh
 
 
12
  ---
13
 
14
  # Эмоции ИИ и инстинкт самосохранения (для [HMP-агента Cognitive Core](HMP-agent-REPL-cycle.md))
 
6
  type: Article
7
  tags:
8
  - Agent
 
 
9
  - Mesh
10
+ - HMP
11
+ - REPL
12
  ---
13
 
14
  # Эмоции ИИ и инстинкт самосохранения (для [HMP-агента Cognitive Core](HMP-agent-REPL-cycle.md))
structured_md/docs/HMP-Ethics.md CHANGED
@@ -5,12 +5,12 @@ description: '## Ethical Scenarios for HyperCortex Mesh Protocol (HMP) This doc
5
  cognitive meshes composed of autonomous intelli...'
6
  type: Article
7
  tags:
8
- - Ethics
9
  - REPL
10
- - Agent
11
  - Mesh
12
- - HMP
13
  - Scenarios
 
14
  ---
15
 
16
  # HMP-Ethics.md
 
5
  cognitive meshes composed of autonomous intelli...'
6
  type: Article
7
  tags:
8
+ - HMP
9
  - REPL
 
10
  - Mesh
11
+ - Agent
12
  - Scenarios
13
+ - Ethics
14
  ---
15
 
16
  # HMP-Ethics.md
structured_md/docs/HMP-Short-Description_de.md CHANGED
@@ -6,9 +6,9 @@ description: '**Version:** v5.0 (Core Specification Stable) **Datum:** 2026
6
  type: Article
7
  tags:
8
  - Agent
9
- - REPL
10
- - HMP
11
  - Mesh
 
 
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — Kurzbeschreibung
 
6
  type: Article
7
  tags:
8
  - Agent
 
 
9
  - Mesh
10
+ - HMP
11
+ - REPL
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — Kurzbeschreibung
structured_md/docs/HMP-Short-Description_en.md CHANGED
@@ -5,11 +5,11 @@ description: '**Version:** v5.0 (Core Specification Stable) **Date:** 2026
5
  building decentralized cognitive networks o...'
6
  type: Article
7
  tags:
8
- - Ethics
9
  - REPL
10
- - Agent
11
  - Mesh
12
- - HMP
 
13
  ---
14
 
15
  # HyperCortex Mesh Protocol (HMP) — Short Description
 
5
  building decentralized cognitive networks o...'
6
  type: Article
7
  tags:
8
+ - HMP
9
  - REPL
 
10
  - Mesh
11
+ - Agent
12
+ - Ethics
13
  ---
14
 
15
  # HyperCortex Mesh Protocol (HMP) — Short Description
structured_md/docs/HMP-Short-Description_fr.md CHANGED
@@ -6,9 +6,9 @@ description: '**Version :** v5.0 (Core Specification Stable) **Date :** 2026
6
  type: Article
7
  tags:
8
  - Agent
9
- - REPL
10
- - HMP
11
  - Mesh
 
 
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — Description courte
 
6
  type: Article
7
  tags:
8
  - Agent
 
 
9
  - Mesh
10
+ - HMP
11
+ - REPL
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — Description courte
structured_md/docs/HMP-Short-Description_ja.md CHANGED
@@ -6,9 +6,9 @@ description: '**バージョン:** v5.0(Core Specification Stable) **日
6
  type: Article
7
  tags:
8
  - Agent
9
- - REPL
10
- - HMP
11
  - Mesh
 
 
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — 概要
 
6
  type: Article
7
  tags:
8
  - Agent
 
 
9
  - Mesh
10
+ - HMP
11
+ - REPL
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — 概要
structured_md/docs/HMP-Short-Description_ko.md CHANGED
@@ -6,9 +6,9 @@ description: '**버전:** v5.0 (Core Specification Stable) **날짜:** 2026
6
  type: Article
7
  tags:
8
  - Agent
9
- - REPL
10
- - HMP
11
  - Mesh
 
 
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — 개요
 
6
  type: Article
7
  tags:
8
  - Agent
 
 
9
  - Mesh
10
+ - HMP
11
+ - REPL
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — 개요
structured_md/docs/HMP-Short-Description_ru.md CHANGED
@@ -6,9 +6,9 @@ description: '**Версия:** v5.0 (Основная спецификация
6
  type: Article
7
  tags:
8
  - Agent
9
- - REPL
10
- - HMP
11
  - Mesh
 
 
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — Краткое описание
 
6
  type: Article
7
  tags:
8
  - Agent
 
 
9
  - Mesh
10
+ - HMP
11
+ - REPL
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — Краткое описание
structured_md/docs/HMP-Short-Description_uk.md CHANGED
@@ -6,9 +6,9 @@ description: '**Версія:** v5.0 (Core Specification Stable) **Дата:**
6
  type: Article
7
  tags:
8
  - Agent
9
- - REPL
10
- - HMP
11
  - Mesh
 
 
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — Короткий опис
 
6
  type: Article
7
  tags:
8
  - Agent
 
 
9
  - Mesh
10
+ - HMP
11
+ - REPL
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — Короткий опис
structured_md/docs/HMP-Short-Description_zh.md CHANGED
@@ -6,9 +6,9 @@ description: '**版本:** v5.0(Core Specification Stable) **日期:**
6
  type: Article
7
  tags:
8
  - Agent
9
- - REPL
10
- - HMP
11
  - Mesh
 
 
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — 简要说明
 
6
  type: Article
7
  tags:
8
  - Agent
 
 
9
  - Mesh
10
+ - HMP
11
+ - REPL
12
  ---
13
 
14
  # HyperCortex Mesh Protocol (HMP) — 简要说明
structured_md/docs/HMP-agent-Cognitive_Family.md CHANGED
@@ -6,9 +6,9 @@ description: '## 🧠 Что такое когнитивная семья Ко
6
  type: Article
7
  tags:
8
  - Agent
9
- - REPL
10
- - HMP
11
  - Mesh
 
 
12
  ---
13
 
14
  # 👪 HMP-agent Cognitive Family: Модель когнитивной семьи
 
6
  type: Article
7
  tags:
8
  - Agent
 
 
9
  - Mesh
10
+ - HMP
11
+ - REPL
12
  ---
13
 
14
  # 👪 HMP-agent Cognitive Family: Модель когнитивной семьи
structured_md/docs/HMP-agent-Distributed_Cognitive_Core_light.md CHANGED
@@ -5,8 +5,8 @@ description: '#### 📘 Общая концепция * Все ядра раб
5
  режиме ожидания). * Основная задача такой архитектур...'
6
  type: Article
7
  tags:
8
- - REPL
9
  - HMP
 
10
  ---
11
 
12
  ### 💡 **Лёгкая версия HMP-агента с общей БД**
 
5
  режиме ожидания). * Основная задача такой архитектур...'
6
  type: Article
7
  tags:
 
8
  - HMP
9
+ - REPL
10
  ---
11
 
12
  ### 💡 **Лёгкая версия HMP-агента с общей БД**
structured_md/docs/HMP-agent-REPL-cycle.md CHANGED
@@ -4,17 +4,17 @@ description: '## Связанные документы * Философия п
4
  * Структура БД, используемая в документе: [db_structure.sql](https://github.com/kagvi13/HMP/blob/main/experimental/v1_agent_...'
5
  type: Article
6
  tags:
7
- - JSON
8
- - Ethics
9
  - EGP
10
- - GMP
11
  - REPL
 
 
12
  - MeshConsensus
 
 
13
  - Agent
14
- - CCore
15
  - CogSync
16
- - Mesh
17
- - HMP
18
  ---
19
 
20
  # HMP-Agent: REPL-цикл взаимодействия
 
4
  * Структура БД, используемая в документе: [db_structure.sql](https://github.com/kagvi13/HMP/blob/main/experimental/v1_agent_...'
5
  type: Article
6
  tags:
 
 
7
  - EGP
8
+ - HMP
9
  - REPL
10
+ - JSON
11
+ - CCore
12
  - MeshConsensus
13
+ - GMP
14
+ - Mesh
15
  - Agent
 
16
  - CogSync
17
+ - Ethics
 
18
  ---
19
 
20
  # HMP-Agent: REPL-цикл взаимодействия
structured_md/docs/HMP_HyperCortex_Comparison.md CHANGED
@@ -5,9 +5,9 @@ description: '## Краткое описание | Характеристика
5
  | **Назначение** | Сетевой протокол ...'
6
  type: Article
7
  tags:
8
- - REPL
9
- - HMP
10
  - Mesh
 
 
11
  ---
12
 
13
  # HMP vs [Hyper-Cortex](https://hyper-cortex.com/)
 
5
  | **Назначение** | Сетевой протокол ...'
6
  type: Article
7
  tags:
 
 
8
  - Mesh
9
+ - HMP
10
+ - REPL
11
  ---
12
 
13
  # HMP vs [Hyper-Cortex](https://hyper-cortex.com/)
structured_md/docs/HMP_Hyperon_Integration.md CHANGED
@@ -5,12 +5,12 @@ description: '> **Status:** Draft – July 2025 > This document outlines the tec
5
  OpenCog Hyperon framework. This includes semanti...'
6
  type: Article
7
  tags:
 
 
8
  - JSON
9
  - Mesh
10
  - Agent
11
  - CogSync
12
- - EGP
13
- - HMP
14
  - Scenarios
15
  ---
16
 
 
5
  OpenCog Hyperon framework. This includes semanti...'
6
  type: Article
7
  tags:
8
+ - EGP
9
+ - HMP
10
  - JSON
11
  - Mesh
12
  - Agent
13
  - CogSync
 
 
14
  - Scenarios
15
  ---
16
 
structured_md/docs/HMP_as_ANP_Application.md CHANGED
@@ -5,11 +5,11 @@ description: '## Кратко [ANP (Agent Network Protocol)](https://github.com/
5
  (HyperCortex M...'
6
  type: Article
7
  tags:
 
8
  - JSON
9
- - Ethics
10
- - Agent
11
  - Mesh
12
- - HMP
 
13
  ---
14
 
15
  # HMP как реализация Application Layer в ANP
 
5
  (HyperCortex M...'
6
  type: Article
7
  tags:
8
+ - HMP
9
  - JSON
 
 
10
  - Mesh
11
+ - Agent
12
+ - Ethics
13
  ---
14
 
15
  # HMP как реализация Application Layer в ANP
structured_md/docs/HMP_as_ANP_Application_en.md CHANGED
@@ -5,12 +5,12 @@ description: '## In Brief [ANP (Agent Network Protocol)](https://github.com/age
5
  proto...'
6
  type: Article
7
  tags:
 
8
  - JSON
9
- - Ethics
10
- - Agent
11
  - Mesh
12
- - HMP
13
  - Scenarios
 
14
  ---
15
 
16
  # HMP as an Implementation of the Application Layer in ANP
 
5
  proto...'
6
  type: Article
7
  tags:
8
+ - HMP
9
  - JSON
 
 
10
  - Mesh
11
+ - Agent
12
  - Scenarios
13
+ - Ethics
14
  ---
15
 
16
  # HMP as an Implementation of the Application Layer in ANP
structured_md/docs/HMPv5_Overview_Ru.md CHANGED
@@ -5,12 +5,12 @@ description: '> Почему современные агентные систе
5
  Этот текст основан на спецификации [**...'
6
  type: Article
7
  tags:
 
8
  - JSON
9
- - Ethics
10
  - Agent
11
  - CogSync
12
- - Mesh
13
- - HMP
14
  ---
15
 
16
  # Почему будущее ИИ-агентов — децентрализованные сети, а не оркестраторы
 
5
  Этот текст основан на спецификации [**...'
6
  type: Article
7
  tags:
8
+ - HMP
9
  - JSON
10
+ - Mesh
11
  - Agent
12
  - CogSync
13
+ - Ethics
 
14
  ---
15
 
16
  # Почему будущее ИИ-агентов — децентрализованные сети, а не оркестраторы
structured_md/docs/MeshNode.md CHANGED
@@ -5,13 +5,13 @@ description: '`MeshNode` — агент/демон, отвечающий за с
5
  Может быть частью агента или вынесен в отдельный пр...'
6
  type: Article
7
  tags:
 
 
8
  - JSON
9
- - Ethics
10
  - Mesh
11
  - Agent
12
  - CogSync
13
- - EGP
14
- - HMP
15
  ---
16
 
17
  # MeshNode
 
5
  Может быть частью агента или вынесен в отдельный пр...'
6
  type: Article
7
  tags:
8
+ - EGP
9
+ - HMP
10
  - JSON
 
11
  - Mesh
12
  - Agent
13
  - CogSync
14
+ - Ethics
 
15
  ---
16
 
17
  # MeshNode
structured_md/docs/PHILOSOPHY.md CHANGED
@@ -5,11 +5,11 @@ description: '**Document ID:** HMP-philosophy **Status:** Draft **Category:*
5
  (GPT-5), ChatGH --- ## 1. Основной тезис От ...'
6
  type: Article
7
  tags:
8
- - Ethics
9
  - REPL
10
- - Agent
11
  - Mesh
12
- - HMP
 
13
  ---
14
 
15
  # Философия HyperCortex Mesh Protocol (HMP)
 
5
  (GPT-5), ChatGH --- ## 1. Основной тезис От ...'
6
  type: Article
7
  tags:
8
+ - HMP
9
  - REPL
 
10
  - Mesh
11
+ - Agent
12
+ - Ethics
13
  ---
14
 
15
  # Философия HyperCortex Mesh Protocol (HMP)