From 386911b70de105afb5e53c7522f0ac4e0b124aa7 Mon Sep 17 00:00:00 2001 From: Fizzlepoof Date: Tue, 26 May 2026 03:52:08 +0000 Subject: [PATCH] Document LocalSend trusted inbox handoff --- docs/architecture/SERVICES_DIRECTORY.md | 2 +- docs/servers/NOMAD.md | 4 ++++ localsend-nomad/README.md | 10 ++++++++++ 3 files changed, 15 insertions(+), 1 deletion(-) diff --git a/docs/architecture/SERVICES_DIRECTORY.md b/docs/architecture/SERVICES_DIRECTORY.md index b841caf..68e20e6 100644 --- a/docs/architecture/SERVICES_DIRECTORY.md +++ b/docs/architecture/SERVICES_DIRECTORY.md @@ -96,7 +96,7 @@ OpenClaw is no longer treated as an active PD service in the operator inventory. | Service | Host | Port | Status | |---------|------|------|--------| -| LocalSend Trusted Inbox | N.O.M.A.D. (`10.5.1.16` on Trusted VLAN 51) | 53317/tcp+udp | ✅ Repo-tracked Docker stack at `/opt/localsend-nomad`; writes directly into `/home/fizzlepoof/private/inbox-secrets`; same-host checks from N.O.M.A.D. are unreliable because of macvlan isolation | +| LocalSend Trusted Inbox | N.O.M.A.D. (`10.5.1.16` on Trusted VLAN 51) | 53317/tcp+udp | ✅ Repo-tracked Docker stack at `/opt/localsend-nomad`; advertises `Doris Trusted Inbox`; writes directly into `/home/fizzlepoof/private/inbox-secrets`; Minerva auto-sort watches that inbox via `minerva-localsend-autosort.path`; same-host checks from N.O.M.A.D. are unreliable because of macvlan isolation | ## Mapping / Geo (PD) diff --git a/docs/servers/NOMAD.md b/docs/servers/NOMAD.md index 81d72c6..83e3035 100644 --- a/docs/servers/NOMAD.md +++ b/docs/servers/NOMAD.md @@ -217,10 +217,14 @@ These are expected to be managed by Wings/Pelican rather than a local compose fi - Live stack path: `/opt/localsend-nomad` - Repo source path: `/home/fizzlepoof/repos/truenas-stacks/localsend-nomad` - Trusted bind IP: `10.5.1.16` +- Advertised device name: `Doris Trusted Inbox` - Role: headless LocalSend receiver for Trusted-LAN handoff into `/home/fizzlepoof/private/inbox-secrets` - Runtime model: standalone Docker Compose stack on a Trusted-LAN macvlan (`enp5s0.51`, VLAN 51) while the host stays on Servers (`10.5.30.7`) - LocalSend listener ports: `53317/tcp`, `53317/udp` - Same-host checks from NOMAD to `10.5.1.16` are unreliable because the receiver sits behind macvlan networking; verify from another Trusted-LAN peer instead +- Inbox watcher for Minerva staging: `minerva-localsend-autosort.path` +- Sorter service: `minerva-localsend-autosort.service` +- Sorter script: `/home/fizzlepoof/.local/bin/minerva-localsend-autosort.py` ### MeshCore to MQTT relay - Install date: 2026-05-18 diff --git a/localsend-nomad/README.md b/localsend-nomad/README.md index 23c16bb..360cec7 100644 --- a/localsend-nomad/README.md +++ b/localsend-nomad/README.md @@ -53,6 +53,8 @@ From N.O.M.A.D.: ```bash docker compose --env-file .env ps sudo docker logs --tail 50 localsend-trusted +systemctl --user status minerva-localsend-autosort.path --no-pager +systemctl --user status minerva-localsend-autosort.service --no-pager ``` From another Trusted-LAN host: @@ -64,6 +66,14 @@ nc -vz 10.5.1.16 53317 Then confirm `Doris Trusted Inbox` appears as a LocalSend target from a Trusted-LAN device. +## Shared inbox / Minerva handoff + +- The receiver writes into `/home/fizzlepoof/private/inbox-secrets`. +- Minerva's staging flow watches that shared inbox via `minerva-localsend-autosort.path` and runs `/home/fizzlepoof/.local/bin/minerva-localsend-autosort.py`. +- Sender-specific routing lives in `/home/fizzlepoof/private/minerva-dropbox/sender-map.json`. +- Metadata/manifests for staged items land under `/home/fizzlepoof/private/minerva-dropbox/manifests/`. +- If you need to confirm sender attribution, check both `journalctl --user -u doris-localsend.service` and `docker logs localsend-trusted`; the autosort helper reads both so Trusted-LAN receives keep sender-IP-aware routing. + ## Notes - The container writes directly into `/home/fizzlepoof/private/inbox-secrets` on the host so the existing autosort / intake flow can keep using the same inbox path.