htm 0.0.14 → 0.0.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +33 -0
  3. data/README.md +269 -79
  4. data/db/migrate/00003_create_file_sources.rb +5 -0
  5. data/db/migrate/00004_create_nodes.rb +17 -0
  6. data/db/migrate/00005_create_tags.rb +7 -0
  7. data/db/migrate/00006_create_node_tags.rb +2 -0
  8. data/db/migrate/00007_create_robot_nodes.rb +7 -0
  9. data/db/schema.sql +41 -29
  10. data/docs/api/yard/HTM/Configuration.md +54 -0
  11. data/docs/api/yard/HTM/Database.md +13 -10
  12. data/docs/api/yard/HTM/EmbeddingService.md +5 -1
  13. data/docs/api/yard/HTM/LongTermMemory.md +18 -277
  14. data/docs/api/yard/HTM/PropositionError.md +18 -0
  15. data/docs/api/yard/HTM/PropositionService.md +66 -0
  16. data/docs/api/yard/HTM/QueryCache.md +88 -0
  17. data/docs/api/yard/HTM/RobotGroup.md +481 -0
  18. data/docs/api/yard/HTM/SqlBuilder.md +108 -0
  19. data/docs/api/yard/HTM/TagService.md +4 -0
  20. data/docs/api/yard/HTM/Telemetry/NullInstrument.md +13 -0
  21. data/docs/api/yard/HTM/Telemetry/NullMeter.md +15 -0
  22. data/docs/api/yard/HTM/Telemetry.md +109 -0
  23. data/docs/api/yard/HTM/WorkingMemoryChannel.md +176 -0
  24. data/docs/api/yard/HTM.md +11 -23
  25. data/docs/api/yard/index.csv +102 -25
  26. data/docs/api/yard-reference.md +8 -0
  27. data/docs/assets/images/multi-provider-failover.svg +51 -0
  28. data/docs/assets/images/robot-group-architecture.svg +65 -0
  29. data/docs/database/README.md +3 -3
  30. data/docs/database/public.file_sources.svg +29 -21
  31. data/docs/database/public.node_tags.md +2 -0
  32. data/docs/database/public.node_tags.svg +53 -41
  33. data/docs/database/public.nodes.md +2 -0
  34. data/docs/database/public.nodes.svg +52 -40
  35. data/docs/database/public.robot_nodes.md +2 -0
  36. data/docs/database/public.robot_nodes.svg +30 -22
  37. data/docs/database/public.robots.svg +16 -12
  38. data/docs/database/public.tags.md +3 -0
  39. data/docs/database/public.tags.svg +41 -33
  40. data/docs/database/schema.json +66 -0
  41. data/docs/database/schema.svg +60 -48
  42. data/docs/development/index.md +13 -0
  43. data/docs/development/rake-tasks.md +1068 -0
  44. data/docs/getting-started/quick-start.md +144 -155
  45. data/docs/guides/adding-memories.md +2 -3
  46. data/docs/guides/context-assembly.md +185 -184
  47. data/docs/guides/getting-started.md +154 -148
  48. data/docs/guides/index.md +7 -0
  49. data/docs/guides/long-term-memory.md +60 -92
  50. data/docs/guides/mcp-server.md +617 -0
  51. data/docs/guides/multi-robot.md +249 -345
  52. data/docs/guides/recalling-memories.md +153 -163
  53. data/docs/guides/robot-groups.md +604 -0
  54. data/docs/guides/search-strategies.md +61 -58
  55. data/docs/guides/working-memory.md +103 -136
  56. data/docs/index.md +30 -26
  57. data/examples/robot_groups/robot_worker.rb +1 -2
  58. data/examples/robot_groups/same_process.rb +1 -4
  59. data/lib/htm/robot_group.rb +721 -0
  60. data/lib/htm/version.rb +1 -1
  61. data/lib/htm/working_memory_channel.rb +250 -0
  62. data/lib/htm.rb +2 -0
  63. data/mkdocs.yml +2 -0
  64. metadata +18 -9
  65. data/db/migrate/00009_add_working_memory_to_robot_nodes.rb +0 -12
  66. data/db/migrate/00010_add_soft_delete_to_associations.rb +0 -29
  67. data/db/migrate/00011_add_performance_indexes.rb +0 -21
  68. data/db/migrate/00012_add_tags_trigram_index.rb +0 -18
  69. data/db/migrate/00013_enable_lz4_compression.rb +0 -43
  70. data/examples/robot_groups/lib/robot_group.rb +0 -419
  71. data/examples/robot_groups/lib/working_memory_channel.rb +0 -140
data/docs/database/public.node_tags.svg CHANGED
@@ -4,24 +4,28 @@
4
4
  <!-- Generated by graphviz version 12.1.2 (20240928.0832)
5
5
  -->
6
6
  <!-- Title: public.node_tags Pages: 1 -->
7
- <svg width="1460pt" height="1463pt"
8
- viewBox="0.00 0.00 1459.73 1462.80" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
9
- <g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 1458.8)">
7
+ <svg width="1460pt" height="1494pt"
8
+ viewBox="0.00 0.00 1459.73 1493.60" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
9
+ <g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 1489.6)">
10
10
  <title>public.node_tags</title>
11
- <polygon fill="white" stroke="none" points="-4,4 -4,-1458.8 1455.73,-1458.8 1455.73,4 -4,4"/>
11
+ <polygon fill="white" stroke="none" points="-4,4 -4,-1489.6 1455.73,-1489.6 1455.73,4 -4,4"/>
12
12
  <!-- public.node_tags -->
13
13
  <g id="node1" class="node">
14
14
  <title>public.node_tags</title>
15
- <polygon fill="#efefef" stroke="none" points="832.61,-1288.6 832.61,-1334.6 1301.83,-1334.6 1301.83,-1288.6 832.61,-1288.6"/>
16
- <polygon fill="none" stroke="black" points="832.61,-1288.6 832.61,-1334.6 1301.83,-1334.6 1301.83,-1288.6 832.61,-1288.6"/>
17
- <text text-anchor="start" x="943.74" y="-1312.4" font-family="Arial Bold" font-size="18.00">public.node_tags</text>
18
- <text text-anchor="start" x="1066.21" y="-1312.4" font-family="Arial" font-size="14.00">    </text>
19
- <text text-anchor="start" x="1097.33" y="-1312.4" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
20
- <text text-anchor="start" x="906.13" y="-1298" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting nodes to tags (many&#45;to&#45;many)</text>
15
+ <polygon fill="#efefef" stroke="none" points="832.61,-1319.4 832.61,-1365.4 1301.83,-1365.4 1301.83,-1319.4 832.61,-1319.4"/>
16
+ <polygon fill="none" stroke="black" points="832.61,-1319.4 832.61,-1365.4 1301.83,-1365.4 1301.83,-1319.4 832.61,-1319.4"/>
17
+ <text text-anchor="start" x="943.74" y="-1343.2" font-family="Arial Bold" font-size="18.00">public.node_tags</text>
18
+ <text text-anchor="start" x="1066.21" y="-1343.2" font-family="Arial" font-size="14.00">    </text>
19
+ <text text-anchor="start" x="1097.33" y="-1343.2" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
20
+ <text text-anchor="start" x="906.13" y="-1328.8" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting nodes to tags (many&#45;to&#45;many)</text>
21
+ <polygon fill="none" stroke="black" points="832.61,-1288.6 832.61,-1319.4 1301.83,-1319.4 1301.83,-1288.6 832.61,-1288.6"/>
22
+ <text text-anchor="start" x="839.61" y="-1300.8" font-family="Arial" font-size="14.00">created_at </text>
23
+ <text text-anchor="start" x="909.66" y="-1300.8" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
24
+ <text text-anchor="start" x="1075.38" y="-1300.8" font-family="Arial" font-size="14.00"> When this association was created</text>
21
25
  <polygon fill="none" stroke="black" points="832.61,-1257.8 832.61,-1288.6 1301.83,-1288.6 1301.83,-1257.8 832.61,-1257.8"/>
22
- <text text-anchor="start" x="839.61" y="-1270" font-family="Arial" font-size="14.00">created_at </text>
23
- <text text-anchor="start" x="909.66" y="-1270" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
24
- <text text-anchor="start" x="1075.38" y="-1270" font-family="Arial" font-size="14.00"> When this association was created</text>
26
+ <text text-anchor="start" x="839.61" y="-1270" font-family="Arial" font-size="14.00">deleted_at </text>
27
+ <text text-anchor="start" x="908.9" y="-1270" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
28
+ <text text-anchor="start" x="1074.62" y="-1270" font-family="Arial" font-size="14.00"> Soft delete timestamp</text>
25
29
  <polygon fill="none" stroke="black" points="832.61,-1227 832.61,-1257.8 1301.83,-1257.8 1301.83,-1227 832.61,-1227"/>
26
30
  <text text-anchor="start" x="839.61" y="-1239.2" font-family="Arial" font-size="14.00">id </text>
27
31
  <text text-anchor="start" x="854.4" y="-1239.2" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
@@ -33,7 +37,7 @@
33
37
  <text text-anchor="start" x="839.61" y="-1177.6" font-family="Arial" font-size="14.00">tag_id </text>
34
38
  <text text-anchor="start" x="881.65" y="-1177.6" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
35
39
  <text text-anchor="start" x="922.9" y="-1177.6" font-family="Arial" font-size="14.00"> ID of the tag being applied</text>
36
- <polygon fill="none" stroke="black" stroke-width="3" points="831.11,-1163.9 831.11,-1336.1 1303.33,-1336.1 1303.33,-1163.9 831.11,-1163.9"/>
40
+ <polygon fill="none" stroke="black" stroke-width="3" points="831.11,-1163.9 831.11,-1366.9 1303.33,-1366.9 1303.33,-1163.9 831.11,-1163.9"/>
37
41
  </g>
38
42
  <!-- public.nodes -->
39
43
  <g id="node2" class="node">
@@ -110,29 +114,33 @@
110
114
  <!-- public.tags -->
111
115
  <g id="node5" class="node">
112
116
  <title>public.tags</title>
113
- <polygon fill="#efefef" stroke="none" points="803.91,-750.6 803.91,-796.6 1408.53,-796.6 1408.53,-750.6 803.91,-750.6"/>
114
- <polygon fill="none" stroke="black" points="803.91,-750.6 803.91,-796.6 1408.53,-796.6 1408.53,-750.6 803.91,-750.6"/>
115
- <text text-anchor="start" x="1004.73" y="-774.4" font-family="Arial Bold" font-size="18.00">public.tags</text>
116
- <text text-anchor="start" x="1083.22" y="-774.4" font-family="Arial" font-size="14.00">    </text>
117
- <text text-anchor="start" x="1114.33" y="-774.4" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
118
- <text text-anchor="start" x="993.76" y="-760" font-family="Arial" font-size="14.00" fill="#333333">Unique tag names for categorization</text>
119
- <polygon fill="none" stroke="black" points="803.91,-719.8 803.91,-750.6 1408.53,-750.6 1408.53,-719.8 803.91,-719.8"/>
120
- <text text-anchor="start" x="810.91" y="-732" font-family="Arial" font-size="14.00">created_at </text>
121
- <text text-anchor="start" x="880.95" y="-732" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
122
- <text text-anchor="start" x="1046.68" y="-732" font-family="Arial" font-size="14.00"> When this tag was created</text>
123
- <polygon fill="none" stroke="black" points="803.91,-689 803.91,-719.8 1408.53,-719.8 1408.53,-689 803.91,-689"/>
124
- <text text-anchor="start" x="810.91" y="-701.2" font-family="Arial" font-size="14.00">id </text>
125
- <text text-anchor="start" x="825.69" y="-701.2" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
126
- <polygon fill="none" stroke="black" points="803.91,-658.2 803.91,-689 1408.53,-689 1408.53,-658.2 803.91,-658.2"/>
127
- <text text-anchor="start" x="810.91" y="-670.4" font-family="Arial" font-size="14.00">name </text>
128
- <text text-anchor="start" x="849.82" y="-670.4" font-family="Arial" font-size="14.00" fill="#666666">[text]</text>
129
- <text text-anchor="start" x="880.16" y="-670.4" font-family="Arial" font-size="14.00"> Hierarchical tag in format: root:level1:level2 (e.g., database:postgresql:timescaledb)</text>
117
+ <polygon fill="#efefef" stroke="none" points="803.91,-766 803.91,-812 1408.53,-812 1408.53,-766 803.91,-766"/>
118
+ <polygon fill="none" stroke="black" points="803.91,-766 803.91,-812 1408.53,-812 1408.53,-766 803.91,-766"/>
119
+ <text text-anchor="start" x="1004.73" y="-789.8" font-family="Arial Bold" font-size="18.00">public.tags</text>
120
+ <text text-anchor="start" x="1083.22" y="-789.8" font-family="Arial" font-size="14.00">    </text>
121
+ <text text-anchor="start" x="1114.33" y="-789.8" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
122
+ <text text-anchor="start" x="993.76" y="-775.4" font-family="Arial" font-size="14.00" fill="#333333">Unique tag names for categorization</text>
123
+ <polygon fill="none" stroke="black" points="803.91,-735.2 803.91,-766 1408.53,-766 1408.53,-735.2 803.91,-735.2"/>
124
+ <text text-anchor="start" x="810.91" y="-747.4" font-family="Arial" font-size="14.00">created_at </text>
125
+ <text text-anchor="start" x="880.95" y="-747.4" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
126
+ <text text-anchor="start" x="1046.68" y="-747.4" font-family="Arial" font-size="14.00"> When this tag was created</text>
127
+ <polygon fill="none" stroke="black" points="803.91,-704.4 803.91,-735.2 1408.53,-735.2 1408.53,-704.4 803.91,-704.4"/>
128
+ <text text-anchor="start" x="810.91" y="-716.6" font-family="Arial" font-size="14.00">deleted_at </text>
129
+ <text text-anchor="start" x="880.19" y="-716.6" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
130
+ <text text-anchor="start" x="1045.91" y="-716.6" font-family="Arial" font-size="14.00"> Soft delete timestamp</text>
131
+ <polygon fill="none" stroke="black" points="803.91,-673.6 803.91,-704.4 1408.53,-704.4 1408.53,-673.6 803.91,-673.6"/>
132
+ <text text-anchor="start" x="810.91" y="-685.8" font-family="Arial" font-size="14.00">id </text>
133
+ <text text-anchor="start" x="825.69" y="-685.8" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
134
+ <polygon fill="none" stroke="black" points="803.91,-642.8 803.91,-673.6 1408.53,-673.6 1408.53,-642.8 803.91,-642.8"/>
135
+ <text text-anchor="start" x="810.91" y="-655" font-family="Arial" font-size="14.00">name </text>
136
+ <text text-anchor="start" x="849.82" y="-655" font-family="Arial" font-size="14.00" fill="#666666">[text]</text>
137
+ <text text-anchor="start" x="880.16" y="-655" font-family="Arial" font-size="14.00"> Hierarchical tag in format: root:level1:level2 (e.g., database:postgresql:timescaledb)</text>
130
138
  </g>
131
139
  <!-- public.node_tags&#45;&gt;public.tags -->
132
140
  <g id="edge4" class="edge">
133
141
  <title>public.node_tags:tag_id&#45;&gt;public.tags:id</title>
134
- <path fill="none" stroke="black" d="M1067,-1154.03C1059.63,-979.93 865.44,-1011.32 803.91,-839.8 783.58,-783.16 742.73,-704.4 802.91,-704.4"/>
135
- <polygon fill="black" stroke="black" points="1067,-1154.07 1062.71,-1164.16 1067.11,-1159.4 1067.21,-1163.73 1067.21,-1163.73 1067.21,-1163.73 1067.11,-1159.4 1071.71,-1163.97 1067,-1154.07"/>
142
+ <path fill="none" stroke="black" d="M1066.99,-1154.07C1059.44,-985.4 865.54,-1021.1 803.91,-855.2 778.18,-785.96 729.04,-689 802.91,-689"/>
143
+ <polygon fill="black" stroke="black" points="1066.99,-1154.07 1062.71,-1164.16 1067.11,-1159.4 1067.2,-1163.73 1067.2,-1163.73 1067.2,-1163.73 1067.11,-1159.4 1071.71,-1163.97 1066.99,-1154.07"/>
136
144
  <text text-anchor="start" x="1074.22" y="-1174.4" font-family="Arial" font-size="10.00">FOREIGN KEY (tag_id) REFERENCES tags(id) ON DELETE CASCADE</text>
137
145
  </g>
138
146
  <!-- public.file_sources -->
@@ -188,15 +196,19 @@
188
196
  <!-- public.robot_nodes -->
189
197
  <g id="node3" class="node">
190
198
  <title>public.robot_nodes</title>
191
- <polygon fill="#efefef" stroke="none" points="56.48,-1365.6 56.48,-1411.6 685.96,-1411.6 685.96,-1365.6 56.48,-1365.6"/>
192
- <polygon fill="none" stroke="black" points="56.48,-1365.6 56.48,-1411.6 685.96,-1411.6 685.96,-1365.6 56.48,-1365.6"/>
193
- <text text-anchor="start" x="239.73" y="-1389.4" font-family="Arial Bold" font-size="18.00">public.robot_nodes</text>
194
- <text text-anchor="start" x="378.21" y="-1389.4" font-family="Arial" font-size="14.00">    </text>
195
- <text text-anchor="start" x="409.33" y="-1389.4" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
196
- <text text-anchor="start" x="203.91" y="-1375" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting robots to nodes (many&#45;to&#45;many)</text>
199
+ <polygon fill="#efefef" stroke="none" points="56.48,-1396.4 56.48,-1442.4 685.96,-1442.4 685.96,-1396.4 56.48,-1396.4"/>
200
+ <polygon fill="none" stroke="black" points="56.48,-1396.4 56.48,-1442.4 685.96,-1442.4 685.96,-1396.4 56.48,-1396.4"/>
201
+ <text text-anchor="start" x="239.73" y="-1420.2" font-family="Arial Bold" font-size="18.00">public.robot_nodes</text>
202
+ <text text-anchor="start" x="378.21" y="-1420.2" font-family="Arial" font-size="14.00">    </text>
203
+ <text text-anchor="start" x="409.33" y="-1420.2" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
204
+ <text text-anchor="start" x="203.91" y="-1405.8" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting robots to nodes (many&#45;to&#45;many)</text>
205
+ <polygon fill="none" stroke="black" points="56.48,-1365.6 56.48,-1396.4 685.96,-1396.4 685.96,-1365.6 56.48,-1365.6"/>
206
+ <text text-anchor="start" x="63.48" y="-1377.8" font-family="Arial" font-size="14.00">created_at </text>
207
+ <text text-anchor="start" x="133.52" y="-1377.8" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
197
208
  <polygon fill="none" stroke="black" points="56.48,-1334.8 56.48,-1365.6 685.96,-1365.6 685.96,-1334.8 56.48,-1334.8"/>
198
- <text text-anchor="start" x="63.48" y="-1347" font-family="Arial" font-size="14.00">created_at </text>
199
- <text text-anchor="start" x="133.52" y="-1347" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
209
+ <text text-anchor="start" x="63.48" y="-1347" font-family="Arial" font-size="14.00">deleted_at </text>
210
+ <text text-anchor="start" x="132.76" y="-1347" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
211
+ <text text-anchor="start" x="298.48" y="-1347" font-family="Arial" font-size="14.00"> Soft delete timestamp</text>
200
212
  <polygon fill="none" stroke="black" points="56.48,-1304 56.48,-1334.8 685.96,-1334.8 685.96,-1304 56.48,-1304"/>
201
213
  <text text-anchor="start" x="63.48" y="-1316.2" font-family="Arial" font-size="14.00">first_remembered_at </text>
202
214
  <text text-anchor="start" x="196.53" y="-1316.2" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
data/docs/database/public.nodes.md CHANGED
@@ -36,6 +36,8 @@ Core memory storage for conversation messages and context
36
36
  | Name | Definition |
37
37
  | ---- | ---------- |
38
38
  | idx_nodes_access_count | CREATE INDEX idx_nodes_access_count ON public.nodes USING btree (access_count) |
39
+ | idx_nodes_active | CREATE INDEX idx_nodes_active ON public.nodes USING btree (id) WHERE (deleted_at IS NULL) |
40
+ | idx_nodes_active_with_embedding | CREATE INDEX idx_nodes_active_with_embedding ON public.nodes USING btree (id) WHERE ((deleted_at IS NULL) AND (embedding IS NOT NULL)) |
39
41
  | idx_nodes_content_gin | CREATE INDEX idx_nodes_content_gin ON public.nodes USING gin (to_tsvector('english'::regconfig, content)) |
40
42
  | idx_nodes_content_hash_unique | CREATE UNIQUE INDEX idx_nodes_content_hash_unique ON public.nodes USING btree (content_hash) |
41
43
  | idx_nodes_content_trgm | CREATE INDEX idx_nodes_content_trgm ON public.nodes USING gin (content gin_trgm_ops) |
data/docs/database/public.nodes.svg CHANGED
@@ -4,11 +4,11 @@
4
4
  <!-- Generated by graphviz version 12.1.2 (20240928.0832)
5
5
  -->
6
6
  <!-- Title: public.nodes Pages: 1 -->
7
- <svg width="2106pt" height="1469pt"
8
- viewBox="0.00 0.00 2105.90 1468.80" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
9
- <g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 1464.8)">
7
+ <svg width="2106pt" height="1500pt"
8
+ viewBox="0.00 0.00 2105.90 1499.60" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
9
+ <g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 1495.6)">
10
10
  <title>public.nodes</title>
11
- <polygon fill="white" stroke="none" points="-4,4 -4,-1464.8 2101.9,-1464.8 2101.9,4 -4,4"/>
11
+ <polygon fill="white" stroke="none" points="-4,4 -4,-1495.6 2101.9,-1495.6 2101.9,4 -4,4"/>
12
12
  <!-- public.nodes -->
13
13
  <g id="node1" class="node">
14
14
  <title>public.nodes</title>
@@ -128,16 +128,20 @@
128
128
  <!-- public.node_tags -->
129
129
  <g id="node2" class="node">
130
130
  <title>public.node_tags</title>
131
- <polygon fill="#efefef" stroke="none" points="496.91,-1294.6 496.91,-1340.6 966.12,-1340.6 966.12,-1294.6 496.91,-1294.6"/>
132
- <polygon fill="none" stroke="black" points="496.91,-1294.6 496.91,-1340.6 966.12,-1340.6 966.12,-1294.6 496.91,-1294.6"/>
133
- <text text-anchor="start" x="608.03" y="-1318.4" font-family="Arial Bold" font-size="18.00">public.node_tags</text>
134
- <text text-anchor="start" x="730.51" y="-1318.4" font-family="Arial" font-size="14.00">    </text>
135
- <text text-anchor="start" x="761.62" y="-1318.4" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
136
- <text text-anchor="start" x="570.43" y="-1304" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting nodes to tags (many&#45;to&#45;many)</text>
131
+ <polygon fill="#efefef" stroke="none" points="496.91,-1325.4 496.91,-1371.4 966.12,-1371.4 966.12,-1325.4 496.91,-1325.4"/>
132
+ <polygon fill="none" stroke="black" points="496.91,-1325.4 496.91,-1371.4 966.12,-1371.4 966.12,-1325.4 496.91,-1325.4"/>
133
+ <text text-anchor="start" x="608.03" y="-1349.2" font-family="Arial Bold" font-size="18.00">public.node_tags</text>
134
+ <text text-anchor="start" x="730.51" y="-1349.2" font-family="Arial" font-size="14.00">    </text>
135
+ <text text-anchor="start" x="761.62" y="-1349.2" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
136
+ <text text-anchor="start" x="570.43" y="-1334.8" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting nodes to tags (many&#45;to&#45;many)</text>
137
+ <polygon fill="none" stroke="black" points="496.91,-1294.6 496.91,-1325.4 966.12,-1325.4 966.12,-1294.6 496.91,-1294.6"/>
138
+ <text text-anchor="start" x="503.91" y="-1306.8" font-family="Arial" font-size="14.00">created_at </text>
139
+ <text text-anchor="start" x="573.95" y="-1306.8" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
140
+ <text text-anchor="start" x="739.68" y="-1306.8" font-family="Arial" font-size="14.00"> When this association was created</text>
137
141
  <polygon fill="none" stroke="black" points="496.91,-1263.8 496.91,-1294.6 966.12,-1294.6 966.12,-1263.8 496.91,-1263.8"/>
138
- <text text-anchor="start" x="503.91" y="-1276" font-family="Arial" font-size="14.00">created_at </text>
139
- <text text-anchor="start" x="573.95" y="-1276" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
140
- <text text-anchor="start" x="739.68" y="-1276" font-family="Arial" font-size="14.00"> When this association was created</text>
142
+ <text text-anchor="start" x="503.91" y="-1276" font-family="Arial" font-size="14.00">deleted_at </text>
143
+ <text text-anchor="start" x="573.19" y="-1276" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
144
+ <text text-anchor="start" x="738.91" y="-1276" font-family="Arial" font-size="14.00"> Soft delete timestamp</text>
141
145
  <polygon fill="none" stroke="black" points="496.91,-1233 496.91,-1263.8 966.12,-1263.8 966.12,-1233 496.91,-1233"/>
142
146
  <text text-anchor="start" x="503.91" y="-1245.2" font-family="Arial" font-size="14.00">id </text>
143
147
  <text text-anchor="start" x="518.69" y="-1245.2" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
@@ -160,43 +164,51 @@
160
164
  <!-- public.tags -->
161
165
  <g id="node3" class="node">
162
166
  <title>public.tags</title>
163
- <polygon fill="#efefef" stroke="none" points="43.2,-753.6 43.2,-799.6 647.83,-799.6 647.83,-753.6 43.2,-753.6"/>
164
- <polygon fill="none" stroke="black" points="43.2,-753.6 43.2,-799.6 647.83,-799.6 647.83,-753.6 43.2,-753.6"/>
165
- <text text-anchor="start" x="244.02" y="-777.4" font-family="Arial Bold" font-size="18.00">public.tags</text>
166
- <text text-anchor="start" x="322.51" y="-777.4" font-family="Arial" font-size="14.00">    </text>
167
- <text text-anchor="start" x="353.63" y="-777.4" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
168
- <text text-anchor="start" x="233.06" y="-763" font-family="Arial" font-size="14.00" fill="#333333">Unique tag names for categorization</text>
169
- <polygon fill="none" stroke="black" points="43.2,-722.8 43.2,-753.6 647.83,-753.6 647.83,-722.8 43.2,-722.8"/>
170
- <text text-anchor="start" x="50.2" y="-735" font-family="Arial" font-size="14.00">created_at </text>
171
- <text text-anchor="start" x="120.25" y="-735" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
172
- <text text-anchor="start" x="285.97" y="-735" font-family="Arial" font-size="14.00"> When this tag was created</text>
173
- <polygon fill="none" stroke="black" points="43.2,-692 43.2,-722.8 647.83,-722.8 647.83,-692 43.2,-692"/>
174
- <text text-anchor="start" x="50.2" y="-704.2" font-family="Arial" font-size="14.00">id </text>
175
- <text text-anchor="start" x="64.99" y="-704.2" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
176
- <polygon fill="none" stroke="black" points="43.2,-661.2 43.2,-692 647.83,-692 647.83,-661.2 43.2,-661.2"/>
177
- <text text-anchor="start" x="50.2" y="-673.4" font-family="Arial" font-size="14.00">name </text>
178
- <text text-anchor="start" x="89.11" y="-673.4" font-family="Arial" font-size="14.00" fill="#666666">[text]</text>
179
- <text text-anchor="start" x="119.45" y="-673.4" font-family="Arial" font-size="14.00"> Hierarchical tag in format: root:level1:level2 (e.g., database:postgresql:timescaledb)</text>
167
+ <polygon fill="#efefef" stroke="none" points="43.2,-769 43.2,-815 647.83,-815 647.83,-769 43.2,-769"/>
168
+ <polygon fill="none" stroke="black" points="43.2,-769 43.2,-815 647.83,-815 647.83,-769 43.2,-769"/>
169
+ <text text-anchor="start" x="244.02" y="-792.8" font-family="Arial Bold" font-size="18.00">public.tags</text>
170
+ <text text-anchor="start" x="322.51" y="-792.8" font-family="Arial" font-size="14.00">    </text>
171
+ <text text-anchor="start" x="353.63" y="-792.8" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
172
+ <text text-anchor="start" x="233.06" y="-778.4" font-family="Arial" font-size="14.00" fill="#333333">Unique tag names for categorization</text>
173
+ <polygon fill="none" stroke="black" points="43.2,-738.2 43.2,-769 647.83,-769 647.83,-738.2 43.2,-738.2"/>
174
+ <text text-anchor="start" x="50.2" y="-750.4" font-family="Arial" font-size="14.00">created_at </text>
175
+ <text text-anchor="start" x="120.25" y="-750.4" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
176
+ <text text-anchor="start" x="285.97" y="-750.4" font-family="Arial" font-size="14.00"> When this tag was created</text>
177
+ <polygon fill="none" stroke="black" points="43.2,-707.4 43.2,-738.2 647.83,-738.2 647.83,-707.4 43.2,-707.4"/>
178
+ <text text-anchor="start" x="50.2" y="-719.6" font-family="Arial" font-size="14.00">deleted_at </text>
179
+ <text text-anchor="start" x="119.48" y="-719.6" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
180
+ <text text-anchor="start" x="285.21" y="-719.6" font-family="Arial" font-size="14.00"> Soft delete timestamp</text>
181
+ <polygon fill="none" stroke="black" points="43.2,-676.6 43.2,-707.4 647.83,-707.4 647.83,-676.6 43.2,-676.6"/>
182
+ <text text-anchor="start" x="50.2" y="-688.8" font-family="Arial" font-size="14.00">id </text>
183
+ <text text-anchor="start" x="64.99" y="-688.8" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
184
+ <polygon fill="none" stroke="black" points="43.2,-645.8 43.2,-676.6 647.83,-676.6 647.83,-645.8 43.2,-645.8"/>
185
+ <text text-anchor="start" x="50.2" y="-658" font-family="Arial" font-size="14.00">name </text>
186
+ <text text-anchor="start" x="89.11" y="-658" font-family="Arial" font-size="14.00" fill="#666666">[text]</text>
187
+ <text text-anchor="start" x="119.45" y="-658" font-family="Arial" font-size="14.00"> Hierarchical tag in format: root:level1:level2 (e.g., database:postgresql:timescaledb)</text>
180
188
  </g>
181
189
  <!-- public.node_tags&#45;&gt;public.tags -->
182
190
  <g id="edge2" class="edge">
183
191
  <title>public.node_tags:tag_id&#45;&gt;public.tags:id</title>
184
- <path fill="none" stroke="black" d="M485.73,-1186.43C291.39,-1171.48 868.87,-707.4 648.83,-707.4"/>
185
- <polygon fill="black" stroke="black" points="485.58,-1186.42 495.41,-1191.28 490.91,-1186.62 495.24,-1186.78 495.24,-1186.78 495.24,-1186.78 490.91,-1186.62 495.74,-1182.29 485.58,-1186.42"/>
192
+ <path fill="none" stroke="black" d="M486,-1183.8C476.71,-1175.05 491.34,-1148.83 496.91,-1128.2 532.7,-995.47 612.77,-991.13 647.83,-858.2 666.66,-786.77 722.69,-692 648.83,-692"/>
193
+ <polygon fill="black" stroke="black" points="486.02,-1183.81 494.28,-1191.01 491.12,-1185.35 495.27,-1186.61 495.27,-1186.61 495.27,-1186.61 491.12,-1185.35 496.89,-1182.4 486.02,-1183.81"/>
186
194
  <text text-anchor="start" x="166.05" y="-1196.8" font-family="Arial" font-size="10.00">FOREIGN KEY (tag_id) REFERENCES tags(id) ON DELETE CASCADE</text>
187
195
  </g>
188
196
  <!-- public.robot_nodes -->
189
197
  <g id="node4" class="node">
190
198
  <title>public.robot_nodes</title>
191
- <polygon fill="#efefef" stroke="none" points="1112.77,-1371.6 1112.77,-1417.6 1742.26,-1417.6 1742.26,-1371.6 1112.77,-1371.6"/>
192
- <polygon fill="none" stroke="black" points="1112.77,-1371.6 1112.77,-1417.6 1742.26,-1417.6 1742.26,-1371.6 1112.77,-1371.6"/>
193
- <text text-anchor="start" x="1296.03" y="-1395.4" font-family="Arial Bold" font-size="18.00">public.robot_nodes</text>
194
- <text text-anchor="start" x="1434.51" y="-1395.4" font-family="Arial" font-size="14.00">    </text>
195
- <text text-anchor="start" x="1465.63" y="-1395.4" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
196
- <text text-anchor="start" x="1260.2" y="-1381" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting robots to nodes (many&#45;to&#45;many)</text>
199
+ <polygon fill="#efefef" stroke="none" points="1112.77,-1402.4 1112.77,-1448.4 1742.26,-1448.4 1742.26,-1402.4 1112.77,-1402.4"/>
200
+ <polygon fill="none" stroke="black" points="1112.77,-1402.4 1112.77,-1448.4 1742.26,-1448.4 1742.26,-1402.4 1112.77,-1402.4"/>
201
+ <text text-anchor="start" x="1296.03" y="-1426.2" font-family="Arial Bold" font-size="18.00">public.robot_nodes</text>
202
+ <text text-anchor="start" x="1434.51" y="-1426.2" font-family="Arial" font-size="14.00">    </text>
203
+ <text text-anchor="start" x="1465.63" y="-1426.2" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
204
+ <text text-anchor="start" x="1260.2" y="-1411.8" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting robots to nodes (many&#45;to&#45;many)</text>
205
+ <polygon fill="none" stroke="black" points="1112.77,-1371.6 1112.77,-1402.4 1742.26,-1402.4 1742.26,-1371.6 1112.77,-1371.6"/>
206
+ <text text-anchor="start" x="1119.77" y="-1383.8" font-family="Arial" font-size="14.00">created_at </text>
207
+ <text text-anchor="start" x="1189.82" y="-1383.8" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
197
208
  <polygon fill="none" stroke="black" points="1112.77,-1340.8 1112.77,-1371.6 1742.26,-1371.6 1742.26,-1340.8 1112.77,-1340.8"/>
198
- <text text-anchor="start" x="1119.77" y="-1353" font-family="Arial" font-size="14.00">created_at </text>
199
- <text text-anchor="start" x="1189.82" y="-1353" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
209
+ <text text-anchor="start" x="1119.77" y="-1353" font-family="Arial" font-size="14.00">deleted_at </text>
210
+ <text text-anchor="start" x="1189.05" y="-1353" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
211
+ <text text-anchor="start" x="1354.77" y="-1353" font-family="Arial" font-size="14.00"> Soft delete timestamp</text>
200
212
  <polygon fill="none" stroke="black" points="1112.77,-1310 1112.77,-1340.8 1742.26,-1340.8 1742.26,-1310 1112.77,-1310"/>
201
213
  <text text-anchor="start" x="1119.77" y="-1322.2" font-family="Arial" font-size="14.00">first_remembered_at </text>
202
214
  <text text-anchor="start" x="1252.82" y="-1322.2" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
data/docs/database/public.robot_nodes.md CHANGED
@@ -9,6 +9,7 @@ Join table connecting robots to nodes (many-to-many)
9
9
  | Name | Type | Default | Nullable | Children | Parents | Comment |
10
10
  | ---- | ---- | ------- | -------- | -------- | ------- | ------- |
11
11
  | created_at | timestamp with time zone | CURRENT_TIMESTAMP | true | | | |
12
+ | deleted_at | timestamp with time zone | | true | | | Soft delete timestamp |
12
13
  | first_remembered_at | timestamp with time zone | CURRENT_TIMESTAMP | true | | | When this robot first remembered this content |
13
14
  | id | bigint | nextval('robot_nodes_id_seq'::regclass) | false | | | |
14
15
  | last_remembered_at | timestamp with time zone | CURRENT_TIMESTAMP | true | | | When this robot last tried to remember this content |
@@ -30,6 +31,7 @@ Join table connecting robots to nodes (many-to-many)
30
31
 
31
32
  | Name | Definition |
32
33
  | ---- | ---------- |
34
+ | idx_robot_nodes_deleted_at | CREATE INDEX idx_robot_nodes_deleted_at ON public.robot_nodes USING btree (deleted_at) |
33
35
  | idx_robot_nodes_last_remembered_at | CREATE INDEX idx_robot_nodes_last_remembered_at ON public.robot_nodes USING btree (last_remembered_at) |
34
36
  | idx_robot_nodes_node_id | CREATE INDEX idx_robot_nodes_node_id ON public.robot_nodes USING btree (node_id) |
35
37
  | idx_robot_nodes_robot_id | CREATE INDEX idx_robot_nodes_robot_id ON public.robot_nodes USING btree (robot_id) |
data/docs/database/public.robot_nodes.svg CHANGED
@@ -4,23 +4,27 @@
4
4
  <!-- Generated by graphviz version 12.1.2 (20240928.0832)
5
5
  -->
6
6
  <!-- Title: public.robot_nodes Pages: 1 -->
7
- <svg width="1721pt" height="1469pt"
8
- viewBox="0.00 0.00 1720.60 1468.80" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
9
- <g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 1464.8)">
7
+ <svg width="1721pt" height="1500pt"
8
+ viewBox="0.00 0.00 1720.60 1499.60" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
9
+ <g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 1495.6)">
10
10
  <title>public.robot_nodes</title>
11
- <polygon fill="white" stroke="none" points="-4,4 -4,-1464.8 1716.6,-1464.8 1716.6,4 -4,4"/>
11
+ <polygon fill="white" stroke="none" points="-4,4 -4,-1495.6 1716.6,-1495.6 1716.6,4 -4,4"/>
12
12
  <!-- public.robot_nodes -->
13
13
  <g id="node1" class="node">
14
14
  <title>public.robot_nodes</title>
15
- <polygon fill="#efefef" stroke="none" points="727.48,-1368.6 727.48,-1414.6 1356.96,-1414.6 1356.96,-1368.6 727.48,-1368.6"/>
16
- <polygon fill="none" stroke="black" points="727.48,-1368.6 727.48,-1414.6 1356.96,-1414.6 1356.96,-1368.6 727.48,-1368.6"/>
17
- <text text-anchor="start" x="910.73" y="-1392.4" font-family="Arial Bold" font-size="18.00">public.robot_nodes</text>
18
- <text text-anchor="start" x="1049.21" y="-1392.4" font-family="Arial" font-size="14.00">    </text>
19
- <text text-anchor="start" x="1080.33" y="-1392.4" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
20
- <text text-anchor="start" x="874.91" y="-1378" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting robots to nodes (many&#45;to&#45;many)</text>
15
+ <polygon fill="#efefef" stroke="none" points="727.48,-1399.4 727.48,-1445.4 1356.96,-1445.4 1356.96,-1399.4 727.48,-1399.4"/>
16
+ <polygon fill="none" stroke="black" points="727.48,-1399.4 727.48,-1445.4 1356.96,-1445.4 1356.96,-1399.4 727.48,-1399.4"/>
17
+ <text text-anchor="start" x="910.73" y="-1423.2" font-family="Arial Bold" font-size="18.00">public.robot_nodes</text>
18
+ <text text-anchor="start" x="1049.21" y="-1423.2" font-family="Arial" font-size="14.00">    </text>
19
+ <text text-anchor="start" x="1080.33" y="-1423.2" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
20
+ <text text-anchor="start" x="874.91" y="-1408.8" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting robots to nodes (many&#45;to&#45;many)</text>
21
+ <polygon fill="none" stroke="black" points="727.48,-1368.6 727.48,-1399.4 1356.96,-1399.4 1356.96,-1368.6 727.48,-1368.6"/>
22
+ <text text-anchor="start" x="734.48" y="-1380.8" font-family="Arial" font-size="14.00">created_at </text>
23
+ <text text-anchor="start" x="804.52" y="-1380.8" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
21
24
  <polygon fill="none" stroke="black" points="727.48,-1337.8 727.48,-1368.6 1356.96,-1368.6 1356.96,-1337.8 727.48,-1337.8"/>
22
- <text text-anchor="start" x="734.48" y="-1350" font-family="Arial" font-size="14.00">created_at </text>
23
- <text text-anchor="start" x="804.52" y="-1350" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
25
+ <text text-anchor="start" x="734.48" y="-1350" font-family="Arial" font-size="14.00">deleted_at </text>
26
+ <text text-anchor="start" x="803.76" y="-1350" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
27
+ <text text-anchor="start" x="969.48" y="-1350" font-family="Arial" font-size="14.00"> Soft delete timestamp</text>
24
28
  <polygon fill="none" stroke="black" points="727.48,-1307 727.48,-1337.8 1356.96,-1337.8 1356.96,-1307 727.48,-1307"/>
25
29
  <text text-anchor="start" x="734.48" y="-1319.2" font-family="Arial" font-size="14.00">first_remembered_at </text>
26
30
  <text text-anchor="start" x="867.53" y="-1319.2" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
@@ -51,7 +55,7 @@
51
55
  <text text-anchor="start" x="734.48" y="-1103.6" font-family="Arial" font-size="14.00">working_memory </text>
52
56
  <text text-anchor="start" x="844.95" y="-1103.6" font-family="Arial" font-size="14.00" fill="#666666">[boolean]</text>
53
57
  <text text-anchor="start" x="902.56" y="-1103.6" font-family="Arial" font-size="14.00"> True if this node is currently in the robot working memory</text>
54
- <polygon fill="none" stroke="black" stroke-width="3" points="725.98,-1089.9 725.98,-1416.1 1358.46,-1416.1 1358.46,-1089.9 725.98,-1089.9"/>
58
+ <polygon fill="none" stroke="black" stroke-width="3" points="725.98,-1089.9 725.98,-1446.9 1358.46,-1446.9 1358.46,-1089.9 725.98,-1089.9"/>
55
59
  </g>
56
60
  <!-- public.nodes -->
57
61
  <g id="node2" class="node">
@@ -210,16 +214,20 @@
210
214
  <!-- public.node_tags -->
211
215
  <g id="node3" class="node">
212
216
  <title>public.node_tags</title>
213
- <polygon fill="#efefef" stroke="none" points="136.61,-1291.6 136.61,-1337.6 605.83,-1337.6 605.83,-1291.6 136.61,-1291.6"/>
214
- <polygon fill="none" stroke="black" points="136.61,-1291.6 136.61,-1337.6 605.83,-1337.6 605.83,-1291.6 136.61,-1291.6"/>
215
- <text text-anchor="start" x="247.74" y="-1315.4" font-family="Arial Bold" font-size="18.00">public.node_tags</text>
216
- <text text-anchor="start" x="370.21" y="-1315.4" font-family="Arial" font-size="14.00">    </text>
217
- <text text-anchor="start" x="401.33" y="-1315.4" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
218
- <text text-anchor="start" x="210.13" y="-1301" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting nodes to tags (many&#45;to&#45;many)</text>
217
+ <polygon fill="#efefef" stroke="none" points="136.61,-1322.4 136.61,-1368.4 605.83,-1368.4 605.83,-1322.4 136.61,-1322.4"/>
218
+ <polygon fill="none" stroke="black" points="136.61,-1322.4 136.61,-1368.4 605.83,-1368.4 605.83,-1322.4 136.61,-1322.4"/>
219
+ <text text-anchor="start" x="247.74" y="-1346.2" font-family="Arial Bold" font-size="18.00">public.node_tags</text>
220
+ <text text-anchor="start" x="370.21" y="-1346.2" font-family="Arial" font-size="14.00">    </text>
221
+ <text text-anchor="start" x="401.33" y="-1346.2" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
222
+ <text text-anchor="start" x="210.13" y="-1331.8" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting nodes to tags (many&#45;to&#45;many)</text>
223
+ <polygon fill="none" stroke="black" points="136.61,-1291.6 136.61,-1322.4 605.83,-1322.4 605.83,-1291.6 136.61,-1291.6"/>
224
+ <text text-anchor="start" x="143.61" y="-1303.8" font-family="Arial" font-size="14.00">created_at </text>
225
+ <text text-anchor="start" x="213.66" y="-1303.8" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
226
+ <text text-anchor="start" x="379.38" y="-1303.8" font-family="Arial" font-size="14.00"> When this association was created</text>
219
227
  <polygon fill="none" stroke="black" points="136.61,-1260.8 136.61,-1291.6 605.83,-1291.6 605.83,-1260.8 136.61,-1260.8"/>
220
- <text text-anchor="start" x="143.61" y="-1273" font-family="Arial" font-size="14.00">created_at </text>
221
- <text text-anchor="start" x="213.66" y="-1273" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
222
- <text text-anchor="start" x="379.38" y="-1273" font-family="Arial" font-size="14.00"> When this association was created</text>
228
+ <text text-anchor="start" x="143.61" y="-1273" font-family="Arial" font-size="14.00">deleted_at </text>
229
+ <text text-anchor="start" x="212.9" y="-1273" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
230
+ <text text-anchor="start" x="378.62" y="-1273" font-family="Arial" font-size="14.00"> Soft delete timestamp</text>
223
231
  <polygon fill="none" stroke="black" points="136.61,-1230 136.61,-1260.8 605.83,-1260.8 605.83,-1230 136.61,-1230"/>
224
232
  <text text-anchor="start" x="143.61" y="-1242.2" font-family="Arial" font-size="14.00">id </text>
225
233
  <text text-anchor="start" x="158.4" y="-1242.2" font-family="Arial" font-size="14.00" fill="#666666">[bigint]</text>
data/docs/database/public.robots.svg CHANGED
@@ -4,11 +4,11 @@
4
4
  <!-- Generated by graphviz version 12.1.2 (20240928.0832)
5
5
  -->
6
6
  <!-- Title: public.robots Pages: 1 -->
7
- <svg width="1394pt" height="1017pt"
8
- viewBox="0.00 0.00 1393.60 1017.20" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
9
- <g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 1013.2)">
7
+ <svg width="1394pt" height="1048pt"
8
+ viewBox="0.00 0.00 1393.60 1048.00" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
9
+ <g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 1044)">
10
10
  <title>public.robots</title>
11
- <polygon fill="white" stroke="none" points="-4,4 -4,-1013.2 1389.6,-1013.2 1389.6,4 -4,4"/>
11
+ <polygon fill="white" stroke="none" points="-4,4 -4,-1044 1389.6,-1044 1389.6,4 -4,4"/>
12
12
  <!-- public.robots -->
13
13
  <g id="node1" class="node">
14
14
  <title>public.robots</title>
@@ -38,15 +38,19 @@
38
38
  <!-- public.robot_nodes -->
39
39
  <g id="node2" class="node">
40
40
  <title>public.robot_nodes</title>
41
- <polygon fill="#efefef" stroke="none" points="355.64,-920 355.64,-966 985.13,-966 985.13,-920 355.64,-920"/>
42
- <polygon fill="none" stroke="black" points="355.64,-920 355.64,-966 985.13,-966 985.13,-920 355.64,-920"/>
43
- <text text-anchor="start" x="538.9" y="-943.8" font-family="Arial Bold" font-size="18.00">public.robot_nodes</text>
44
- <text text-anchor="start" x="677.38" y="-943.8" font-family="Arial" font-size="14.00">    </text>
45
- <text text-anchor="start" x="708.5" y="-943.8" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
46
- <text text-anchor="start" x="503.07" y="-929.4" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting robots to nodes (many&#45;to&#45;many)</text>
41
+ <polygon fill="#efefef" stroke="none" points="355.64,-950.8 355.64,-996.8 985.13,-996.8 985.13,-950.8 355.64,-950.8"/>
42
+ <polygon fill="none" stroke="black" points="355.64,-950.8 355.64,-996.8 985.13,-996.8 985.13,-950.8 355.64,-950.8"/>
43
+ <text text-anchor="start" x="538.9" y="-974.6" font-family="Arial Bold" font-size="18.00">public.robot_nodes</text>
44
+ <text text-anchor="start" x="677.38" y="-974.6" font-family="Arial" font-size="14.00">    </text>
45
+ <text text-anchor="start" x="708.5" y="-974.6" font-family="Arial" font-size="14.00" fill="#666666">[BASE TABLE]</text>
46
+ <text text-anchor="start" x="503.07" y="-960.2" font-family="Arial" font-size="14.00" fill="#333333">Join table connecting robots to nodes (many&#45;to&#45;many)</text>
47
+ <polygon fill="none" stroke="black" points="355.64,-920 355.64,-950.8 985.13,-950.8 985.13,-920 355.64,-920"/>
48
+ <text text-anchor="start" x="362.64" y="-932.2" font-family="Arial" font-size="14.00">created_at </text>
49
+ <text text-anchor="start" x="432.69" y="-932.2" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
47
50
  <polygon fill="none" stroke="black" points="355.64,-889.2 355.64,-920 985.13,-920 985.13,-889.2 355.64,-889.2"/>
48
- <text text-anchor="start" x="362.64" y="-901.4" font-family="Arial" font-size="14.00">created_at </text>
49
- <text text-anchor="start" x="432.69" y="-901.4" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
51
+ <text text-anchor="start" x="362.64" y="-901.4" font-family="Arial" font-size="14.00">deleted_at </text>
52
+ <text text-anchor="start" x="431.92" y="-901.4" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
53
+ <text text-anchor="start" x="597.65" y="-901.4" font-family="Arial" font-size="14.00"> Soft delete timestamp</text>
50
54
  <polygon fill="none" stroke="black" points="355.64,-858.4 355.64,-889.2 985.13,-889.2 985.13,-858.4 355.64,-858.4"/>
51
55
  <text text-anchor="start" x="362.64" y="-870.6" font-family="Arial" font-size="14.00">first_remembered_at </text>
52
56
  <text text-anchor="start" x="495.69" y="-870.6" font-family="Arial" font-size="14.00" fill="#666666">[timestamp with time zone]</text>
data/docs/database/public.tags.md CHANGED
@@ -9,6 +9,7 @@ Unique tag names for categorization
9
9
  | Name | Type | Default | Nullable | Children | Parents | Comment |
10
10
  | ---- | ---- | ------- | -------- | -------- | ------- | ------- |
11
11
  | created_at | timestamp with time zone | CURRENT_TIMESTAMP | true | | | When this tag was created |
12
+ | deleted_at | timestamp with time zone | | true | | | Soft delete timestamp |
12
13
  | id | bigint | nextval('tags_id_seq'::regclass) | false | [public.node_tags](public.node_tags.md) | | |
13
14
  | name | text | | false | | | Hierarchical tag in format: root:level1:level2 (e.g., database:postgresql:timescaledb) |
14
15
 
@@ -22,7 +23,9 @@ Unique tag names for categorization
22
23
 
23
24
  | Name | Definition |
24
25
  | ---- | ---------- |
26
+ | idx_tags_deleted_at | CREATE INDEX idx_tags_deleted_at ON public.tags USING btree (deleted_at) |
25
27
  | idx_tags_name_pattern | CREATE INDEX idx_tags_name_pattern ON public.tags USING btree (name text_pattern_ops) |
28
+ | idx_tags_name_trgm | CREATE INDEX idx_tags_name_trgm ON public.tags USING gin (name gin_trgm_ops) |
26
29
  | idx_tags_name_unique | CREATE UNIQUE INDEX idx_tags_name_unique ON public.tags USING btree (name) |
27
30
  | tags_pkey | CREATE UNIQUE INDEX tags_pkey ON public.tags USING btree (id) |
28
31