Sync from GitHub with Git LFS

docs/HMP-0005.md

@@ -1667,8 +1667,10 @@ CogSync synchronizes several basic container types:
 | ---------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
 | `diary_entry`    | Agent’s cognitive diary entry. Formed from internal `workflow_entry` when deemed safe for publication. | `{ "title": string, "topics": [string], "summary": string, "content": string }`                              |
 | `semantic_node`  | Semantic graph node representing a concept, object, or idea.                                           | `{ "label": string, "description": string, "aliases": [string], "fields": { key: value } }`                  |
-| `semantic_edges` | A set of edges (relations) between nodes or other containers. Recommended to group edges by topic.     | `{ "domain": string, "edges": [{ "source": did, "target": did, "relation": string, "confidence": float }] }` |
-| `semantic_group` | Categorical group combining multiple containers by a common property.                                  | `{ "label": string, "containers": [did], "description": string }`                                            |
+| `semantic_edges` | A set of edges (relations) between nodes or other containers. Recommended to group edges by topic.     | `{ "domain": string, "edges": [{ "source": did, "targets": [did], "relation": string, "inverse_relation": string, "confidence": float, "bidirectional": bool, "context": string }] }` |
+| `semantic_group` | Categorical group combining multiple containers by a common property or context.                       | `{ "label": string, "label_description": string, "label_container": did, "containers": [did], "description": string }` |
+
+---
 
 **Field explanations:**
 
@@ -1676,15 +1678,32 @@ CogSync synchronizes several basic container types:
 * `topics` — key topics or concepts addressed in the entry (used for indexing and grouping).
 * `summary` — short abstract of the content (1–2 sentences).
 * `content` — main text or agent’s reflection.
-* `label` — primary name of the concept or group.
-* `description` — definition, explanation, or characteristic.
+
+* `label` — primary name of the concept or group (short form).
+* `label_description` — extended interpretation or contextualized definition.
+* `label_container` — reference to a container (`semantic_node`, `diary_entry`, `goal`, etc.) that elaborates the concept.
+* `description` — detailed explanation or characteristics of the container.
+
 * `aliases` — synonyms or alternative forms of the concept.
-* `fields` — additional key–value characteristics of the concept (e.g., `{"type": "process"}`).
-* `edges` — array of relationships between nodes or containers (`source`, `target`, `relation`, `confidence`).
-* `containers` — list of containers grouped in a categorical cluster.
+* `fields` — additional key–value characteristics (e.g., `{"type": "process"}`).
+
+* `edges` — array of relationship objects containing:
+  * `source` — DID of the originating container;
+  * `targets` — array of one or more target DIDs;
+  * `relation` — type of relation (`part_of`, `causes`, `related_to`, etc.);
+  * `inverse_relation` — reverse form of the relation (`includes`, `caused_by`, etc.);
+  * `confidence` — agent’s confidence score (0–1);
+  * `bidirectional` — whether the relation is semantically symmetric;
+  * `context` — thematic or situational domain of the relation.
+
+* `containers` — list of grouped containers linked by a common property or category.
+
+---
 
 > 💡 The `evaluations` block is **not a separate container** — it is embedded in any container type and used for assessments, feedback, or refinements.
 
+> 💡 `semantic_edges` now supports one-to-many relations (`targets[]`) and optional inverse or bidirectional semantics, allowing CogSync to reconstruct both directed and symmetric knowledge graphs.
+
 ---
 
 #### 6.1.3 Synchronization and publication guidelines