Skip to content

docs: update network specification and architecture table with BitChat and Dispatch details #36

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
fredporter merged 1 commit into from
Sep 14, 2026
Merged

docs: update network specification and architecture table with BitChat and Dispatch details #36

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
13 changes: 7 additions & 6 deletions docs/UCORE_NETWORK_SPEC_2026.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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/<binder>/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`).

---

Expand Down
Loading