GitHub Action commited on
Commit
21f6b9d
·
1 Parent(s): 9c8bf99

Sync from GitHub with Git LFS

Browse files
Files changed (1) hide show
  1. 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-root",
1456
- "L2": "did:hmp:container:abstraction-l2"
1457
  }
1458
  },
1459
  "axes": {
1460
- "did:hmp:container:axis-logos": 512,
1461
- "did:hmp:container:axis-telos": 321
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 any other containers.
2132
  Supports directed, symmetric, and inverse relations.
2133
 
 
 
2134
  **`payload` structure:**
2135
 
2136
- | Field | Type | Description |
2137
- | ------------------- | -------------- | ---------------------------------------------------------------------------------------------- |
2138
- | `domain` | string | Logical or topical domain (e.g., `"ontology:objects"`). |
2139
- | `edges` | [object] | Array of edge definitions. Each edge includes: |
2140
- | → `source` | DID | DID of the originating container. |
2141
- | → `targets` | array(DID) | One or more target containers. |
2142
- | → `relation` | string | Relation type (`part_of`, `causes`, `related_to`, etc.). |
2143
- | → `inverse_relation`| string | Reverse form of the relation (`includes`, `caused_by`, etc.). |
2144
- | → `confidence` | float | Confidence score (0–1) indicating the agent’s certainty about the relation. |
2145
- | → `bidirectional` | bool | Optional. Used only when the relation is symmetric and no `inverse_relation` is defined. |
2146
- | → `context` | string | Context or topic of the relation. |
 
 
 
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
- "source": "did:hmp:container:cup",
2158
- "targets": ["did:hmp:container:tableware"],
2159
- "relation": "part_of",
2160
- "inverse_relation": "includes"
2161
- }
2162
- ]
 
 
 
 
 
 
2163
  }
2164
- ```
2165
 
2166
- **Purpose:** Provides structural connectivity between containers, enabling CogSync to maintain a distributed semantic graph.
 
 
 
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:cup",
2195
- "did:hmp:container:plate",
2196
- "did:hmp:container:kettle"
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
  }