From 37a35eada1741984199a85aa5dddd5ee7d385e82 Mon Sep 17 00:00:00 2001 From: Fred Porter Date: Mon, 14 Sep 2026 22:47:54 +0800 Subject: [PATCH] docs: update network specification and architecture table with BitChat and Dispatch details --- README.md | 3 ++- docs/UCORE_NETWORK_SPEC_2026.md | 13 +++++++------ 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 34906fa..341fcf7 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,8 @@ It provides a calm Vue 3 UI shell, governed backend APIs, native Obsidian vault | **uFlow Engine** | `backend/app/flow/` | Built-in durable missions, tasks, daily routines, autonomy, and execution evidence | | **uKnowledge Library** | `backend/app/knowledge/` | Built-in filesystem-first vault discovery, indexing, search, and Obsidian baseline (`~/Vault`, `~/Shared`, `~/Public`) | | **Sovereign Identity** | `backend/app/identity/` | Local profiles, keys, and headless WordPress RBAC mapping (`wordpress_mapper.py`) | -| **Network & Privacy** | `uCore-Network` | Spec: Offline local portals, BitChat LAN P2P chat, and home privacy stack | +| **Sovereign Dispatch** | `backend/app/services/dispatch_*` | Ephemeral stories (`/p/:token`), Tri-Mode player, bulletproof email, and offline capsules | +| **Network & BitChat** | `backend/app/services/mesh_*`, `bitchat_*` | Local LAN subnet beacon discovery, zero-cloud BitChat P2P messaging, and binder bridges | | **Google & DreamBeans** | `uCore-Google` | Google Workspace bridge + DreamBeans autonomous morning briefing integration | Independent domain products (`SonicScrewdriver`, `Groovebox`, `uVector`, `HomeNest`) follow an uncoupled, independent release path. diff --git a/docs/UCORE_NETWORK_SPEC_2026.md b/docs/UCORE_NETWORK_SPEC_2026.md index 3779b4f..9dd9d6b 100644 --- a/docs/UCORE_NETWORK_SPEC_2026.md +++ b/docs/UCORE_NETWORK_SPEC_2026.md @@ -58,20 +58,21 @@ Lanes Replaced: Former Portal / Beacon / MeshCore research --- -## 3. BitChat: Local-First Private Communication +## 3. BitChat: Local-First Private Communication (Implemented) ### Purpose BitChat provides private, real-time messaging between household members or co-located teams without relying on third-party servers, telephone numbers, or cloud accounts. ### Protocol & Discovery -1. **Discovery**: Devices on the same subnet discover the uCore BitChat endpoint via **mDNS / Bonjour** service advertisement (`_bitchat._tcp.local.`). -2. **Transport**: Lightweight WebSocket connection (`/api/network/bitchat/ws`). +1. **Discovery**: Devices on the same subnet discover the uCore BitChat endpoint via **mDNS / Bonjour** service advertisement (`_bitchat._tcp.local.`) and standard library UDP broadcast beacons on port `53535` (`backend/app/services/mesh_transport.py`). +2. **Transport**: Lightweight WebSocket connection (`/api/network/bitchat/ws`) and fallback REST endpoints (`/api/network/bitchat/send`, `/api/network/bitchat/messages`). 3. **Identity**: Ephemeral or profile-based public-key identity (derived from `app.identity`). 4. **Encryption**: End-to-end encrypted message frames using standardlibs (NaCl / TweetNaCl / AES-GCM). -### uDos Integration: "Save to Binder" -* Discussions regarding project briefs, decisions, or research can be saved with one click. -* The selected chat thread is formatted as Markdown evidence and committed to the active binder under `evidence/chats/YYYY-MM-DD-thread.md`. +### uDos Integration: "Save to Binder" & "Convert to Task" +* **Save to Binder**: Discussions regarding project briefs, decisions, or research can be saved with one click. The selected chat thread is formatted as Markdown evidence and committed to the active binder under `~/Vault/binders//evidence/chats/YYYY-MM-DD-thread.md`. +* **Convert to Task**: Chat action items can be promoted directly to sovereign `.tasker` markdown tasks in `~/Vault/tasks/inbox/` with optional Apple Reminders synchronization. +* **Surface**: Live interactive UI available at `/bitchat` (`frontend-vue/src/surfaces/bitchat/BitChatSurface.vue`). ---