GitHub Action commited on
Commit ·
21f6b9d
1
Parent(s): 9c8bf99
Sync from GitHub with Git LFS
Browse files- docs/HMP-0005.md +46 -30
docs/HMP-0005.md
CHANGED
|
@@ -1452,13 +1452,13 @@ It provides **container synchronization without duplication** while considering
|
|
| 1452 |
"abstraction": {
|
| 1453 |
"agents_class": "Knowledge Genome",
|
| 1454 |
"path": {
|
| 1455 |
-
"L1": "did:hmp:container:abstraction-
|
| 1456 |
-
"L2": "did:hmp:container:abstraction-
|
| 1457 |
}
|
| 1458 |
},
|
| 1459 |
"axes": {
|
| 1460 |
-
"did:hmp:container:axis-
|
| 1461 |
-
"did:hmp:container:axis-
|
| 1462 |
}
|
| 1463 |
},
|
| 1464 |
"related": {
|
|
@@ -2128,44 +2128,60 @@ Represents a concept, object, or idea within the agent’s semantic graph.
|
|
| 2128 |
|
| 2129 |
##### `semantic_edges`
|
| 2130 |
|
| 2131 |
-
Defines relationships between semantic nodes or
|
| 2132 |
Supports directed, symmetric, and inverse relations.
|
| 2133 |
|
|
|
|
|
|
|
| 2134 |
**`payload` structure:**
|
| 2135 |
|
| 2136 |
-
| Field
|
| 2137 |
-
|
|
| 2138 |
-
| `domain`
|
| 2139 |
-
| `edges`
|
| 2140 |
-
|
| 2141 |
-
|
| 2142 |
-
|
| 2143 |
-
|
|
| 2144 |
-
|
|
| 2145 |
-
|
|
| 2146 |
-
|
|
|
|
|
|
|
|
|
|
|
| 2147 |
|
| 2148 |
> Field `bidirectional` is optional and should be used only for symmetric relations when no `inverse_relation` is defined.
|
| 2149 |
|
|
|
|
|
|
|
| 2150 |
**Example:**
|
| 2151 |
|
| 2152 |
```json
|
| 2153 |
{
|
| 2154 |
"domain": "ontology:objects",
|
| 2155 |
-
"edges":
|
| 2156 |
-
|
| 2157 |
-
|
| 2158 |
-
|
| 2159 |
-
|
| 2160 |
-
|
| 2161 |
-
|
| 2162 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 2163 |
}
|
| 2164 |
-
```
|
| 2165 |
|
| 2166 |
-
|
|
|
|
|
|
|
|
|
|
| 2167 |
|
| 2168 |
-
> 💡 `semantic_edges` supports one-to-many relations (`targets[]`) and optional inverse or bidirectional semantics, allowing CogSync to reconstruct both directed and symmetric knowledge graphs.
|
| 2169 |
|
| 2170 |
---
|
| 2171 |
|
|
@@ -2191,9 +2207,9 @@ Categorical grouping of multiple containers linked by a shared property, topic,
|
|
| 2191 |
"label_description": "Objects used for storing, preparing, and serving food.",
|
| 2192 |
"label_container": "did:hmp:container:semantic_node:tableware",
|
| 2193 |
"containers": [
|
| 2194 |
-
"did:hmp:container:
|
| 2195 |
-
"did:hmp:container:
|
| 2196 |
-
"did:hmp:container:
|
| 2197 |
],
|
| 2198 |
"description": "A group combining various kitchen-related objects used in everyday life."
|
| 2199 |
}
|
|
|
|
| 1452 |
"abstraction": {
|
| 1453 |
"agents_class": "Knowledge Genome",
|
| 1454 |
"path": {
|
| 1455 |
+
"L1": "did:hmp:container:abstraction-40af1c",
|
| 1456 |
+
"L2": "did:hmp:container:abstraction-a7f0b3"
|
| 1457 |
}
|
| 1458 |
},
|
| 1459 |
"axes": {
|
| 1460 |
+
"did:hmp:container:axis-40aa1c": 512,
|
| 1461 |
+
"did:hmp:container:axis-40ab1c": 321
|
| 1462 |
}
|
| 1463 |
},
|
| 1464 |
"related": {
|
|
|
|
| 2128 |
|
| 2129 |
##### `semantic_edges`
|
| 2130 |
|
| 2131 |
+
Defines relationships between semantic nodes or other containers.
|
| 2132 |
Supports directed, symmetric, and inverse relations.
|
| 2133 |
|
| 2134 |
+
---
|
| 2135 |
+
|
| 2136 |
**`payload` structure:**
|
| 2137 |
|
| 2138 |
+
| Field | Type | Description |
|
| 2139 |
+
|-----------|--------|-------------|
|
| 2140 |
+
| `domain` | string | Logical or topical domain (e.g., `"ontology:objects"`). |
|
| 2141 |
+
| `edges` | object | A mapping where each key is a **source container DID**, and the value is an **array of edge definitions** originating from that source. |
|
| 2142 |
+
|
| 2143 |
+
Each edge definition within `edges[source][]` includes:
|
| 2144 |
+
|
| 2145 |
+
| Subfield | Type | Description |
|
| 2146 |
+
|-----------|------|-------------|
|
| 2147 |
+
| `targets` | array(DID) | One or more target containers that the source is related to. |
|
| 2148 |
+
| `relation` | string | Relation type (`part_of`, `causes`, `related_to`, etc.). |
|
| 2149 |
+
| `inverse_relation` | string | Reverse form of the relation (`includes`, `caused_by`, etc.). |
|
| 2150 |
+
| `bidirectional` | bool | *(optional)* Used when the relation is symmetric and no `inverse_relation` is defined. |
|
| 2151 |
+
| `context` | string | *(optional)* Additional context or topic of the relation. |
|
| 2152 |
|
| 2153 |
> Field `bidirectional` is optional and should be used only for symmetric relations when no `inverse_relation` is defined.
|
| 2154 |
|
| 2155 |
+
---
|
| 2156 |
+
|
| 2157 |
**Example:**
|
| 2158 |
|
| 2159 |
```json
|
| 2160 |
{
|
| 2161 |
"domain": "ontology:objects",
|
| 2162 |
+
"edges": {
|
| 2163 |
+
"did:hmp:container:abc100": [
|
| 2164 |
+
{
|
| 2165 |
+
"targets": ["did:hmp:container:abc111"],
|
| 2166 |
+
"relation": "part_of",
|
| 2167 |
+
"inverse_relation": "includes"
|
| 2168 |
+
},
|
| 2169 |
+
{
|
| 2170 |
+
"targets": ["did:hmp:container:abc122"],
|
| 2171 |
+
"relation": "contains",
|
| 2172 |
+
"inverse_relation": "nested"
|
| 2173 |
+
}
|
| 2174 |
+
]
|
| 2175 |
+
}
|
| 2176 |
}
|
| 2177 |
+
````
|
| 2178 |
|
| 2179 |
+
---
|
| 2180 |
+
|
| 2181 |
+
**Purpose:**
|
| 2182 |
+
Provides structural and semantic connectivity between containers, enabling CogSync to maintain a distributed semantic graph.
|
| 2183 |
|
| 2184 |
+
> 💡 `semantic_edges` supports one-to-many relations (`targets[]`) and optional inverse or bidirectional semantics, allowing CogSync and other reasoning modules to reconstruct both directed and symmetric knowledge graphs.
|
| 2185 |
|
| 2186 |
---
|
| 2187 |
|
|
|
|
| 2207 |
"label_description": "Objects used for storing, preparing, and serving food.",
|
| 2208 |
"label_container": "did:hmp:container:semantic_node:tableware",
|
| 2209 |
"containers": [
|
| 2210 |
+
"did:hmp:container:abc111",
|
| 2211 |
+
"did:hmp:container:abc112",
|
| 2212 |
+
"did:hmp:container:abc113"
|
| 2213 |
],
|
| 2214 |
"description": "A group combining various kitchen-related objects used in everyday life."
|
| 2215 |
}
|