docs: align mother registry table name usb_nodes → hive_nodes #132

Closed
clawdie wants to merge 1 commit from docs-hive-nodes-rename into main
3 changed files with 7 additions and 7 deletions

View file

@ -44,7 +44,7 @@ bill-of-materials calculation. The obvious answer was Blender — it has
## Registering capabilities ## Registering capabilities
This comparison feeds into the mother node's PostgreSQL `usb_nodes` table. This comparison feeds into the mother node's PostgreSQL `hive_nodes` table.
When a node registers its hardware profile, the capability derivation trigger When a node registers its hardware profile, the capability derivation trigger
marks nodes that can run `geodesic-dome-mcp` (all of them — numpy + Pillow marks nodes that can run `geodesic-dome-mcp` (all of them — numpy + Pillow
are universal). Nodes that have Blender installed get an additional are universal). Nodes that have Blender installed get an additional

View file

@ -4,7 +4,7 @@
Connects a booted Clawdie USB to the mother node (OSA) via MCP over SSH. Connects a booted Clawdie USB to the mother node (OSA) via MCP over SSH.
After setup, `clawdie-hw-probe` runs on the USB, the hardware profile is After setup, `clawdie-hw-probe` runs on the USB, the hardware profile is
sent to mother, and stored in PostgreSQL `mother_hive.usb_nodes`. sent to mother, and stored in PostgreSQL `mother_hive.hive_nodes`.
## Hosts used in this guide ## Hosts used in this guide
@ -48,7 +48,7 @@ sent to mother, and stored in PostgreSQL `mother_hive.usb_nodes`.
│ colibri-mcp-ssh → strips forced-command wrapper │ │ colibri-mcp-ssh → strips forced-command wrapper │
│ → passes "tools" subcommand to colibri-mcp │ │ → passes "tools" subcommand to colibri-mcp │
│ │ │ │
│ PostgreSQL mother_hive.usb_nodes ← hw-probe JSON stored │ │ PostgreSQL mother_hive.hive_nodes ← hw-probe JSON stored │
│ │ │ │
└───────────────────────────────────────────────────────────────┘ └───────────────────────────────────────────────────────────────┘
``` ```
@ -203,13 +203,13 @@ echo "$HW_JSON" | python3.11 -m json.tool | head -15
# 3. Send to mother via MCP (once node_register tool exists on mother) # 3. Send to mother via MCP (once node_register tool exists on mother)
# For now: manual insert via SSH to mother # For now: manual insert via SSH to mother
echo "$HW_JSON" | ssh m0th3r 'cat - | sudo -u postgres psql -d mother_hive \ echo "$HW_JSON" | ssh m0th3r 'cat - | sudo -u postgres psql -d mother_hive \
-c "INSERT INTO usb_nodes (hostname, hw_profile, status) \ -c "INSERT INTO hive_nodes (hostname, hw_profile, status) \
VALUES ('\''$(hostname)'\'', '\''$(cat)'\''::jsonb, '\''online'\'') \ VALUES ('\''$(hostname)'\'', '\''$(cat)'\''::jsonb, '\''online'\'') \
ON CONFLICT (hostname) DO UPDATE SET hw_profile = EXCLUDED.hw_profile, last_seen = now();"' ON CONFLICT (hostname) DO UPDATE SET hw_profile = EXCLUDED.hw_profile, last_seen = now();"'
# 4. Verify on mother # 4. Verify on mother
ssh m0th3r 'sudo -u postgres psql -d mother_hive \ ssh m0th3r 'sudo -u postgres psql -d mother_hive \
-c "SELECT hostname, status, capabilities FROM usb_nodes;"' -c "SELECT hostname, status, capabilities FROM hive_nodes;"'
# Expected: both osa.smilepowered.org and clawdie-usb listed # Expected: both osa.smilepowered.org and clawdie-usb listed
``` ```

View file

@ -7,7 +7,7 @@
Boot the live USB, and the colibri-daemon automatically connects to mother Boot the live USB, and the colibri-daemon automatically connects to mother
(OSA) via MCP over SSH. The first action on autospawn: `clawdie-hw-probe` runs, (OSA) via MCP over SSH. The first action on autospawn: `clawdie-hw-probe` runs,
hardware profile is sent to mother via `colibri_external_mcp_call_tool`, and hardware profile is sent to mother via `colibri_external_mcp_call_tool`, and
mother stores it in PostgreSQL `mother_hive.usb_nodes`. mother stores it in PostgreSQL `mother_hive.hive_nodes`.
## Current state ## Current state
@ -135,7 +135,7 @@ HW_JSON=$(sudo clawdie-hw-probe 2>/dev/null)
# with the mother server registered) # with the mother server registered)
# 3. Verify on mother: # 3. Verify on mother:
sudo -u postgres psql -d mother_hive -c "SELECT hostname, status, capabilities FROM usb_nodes;" sudo -u postgres psql -d mother_hive -c "SELECT hostname, status, capabilities FROM hive_nodes;"
``` ```
Expected: the USB node appears in PostgreSQL with hardware profile and Expected: the USB node appears in PostgreSQL with hardware profile and