39 lines (31 loc) · 2.05 KB

Module and Navigation Reference

Module reference

Module	Name constant	Requires	Description
`net`	`NET_MODULE_NAME`	—	Networking foundation; bootstraps LAN service
`lan`	`LAN_MODULE_NAME`	`net`	LAN discovery via UDP; peer management; pairing
`surface`	`SURFACE_MODULE_NAME`	—	`surface.snapshot` and `surface.patch` host mirror channel
`remote-session`	`REMOTE_SESSION_MODULE_NAME`	`net`, `lan`	Routing gate for LAN command forwarding; no standalone verbs
`shell`	`SHELL_MODULE_NAME`	—	`shell.execute` (routable), `shell.internal` (REPL), PTY/TUI on Desktop
`shell-motd`	`SHELL_MOTD_MODULE_NAME`	`shell`	Fastfetch-style banner on shell open

LAN sub-system (`modules/lan/`)

Component	File	Purpose
Service entry	`mod.rs`	`start_service` / `stop_service`, command registry
Discovery	`discovery.rs`	Peer scan, node state tracking
Handlers	`handlers.rs`	`lan.scan`, `lan.node`, `lan.session_targets`, pairing approval
Config	`config.rs`	Approved peers persistence
Peers	`peers.rs`	Peer struct and list management
Protocol	`protocol.rs`	UDP `NODE_EXEC` and related definitions

Navigation reference

All 7 pages. Add new pages to PAGE_DEFINITIONS in navigation.rs — never to surface match arms.

Page ID	Title	Group	Required Module	Glyph	SF Symbol
`utility.shell`	Shell	`utilities`	`shell`	`terminal`	`terminal`
`global.dashboard`	Dashboard	(global)	—	`home`	`house`
`global.logs`	Logs	(global)	—	`logs`	`doc.text`
`global.settings`	Settings	(global)	—	`settings`	`gear`
`global.modules`	Modules	(global)	—	`modules`	`square.stack.3d.up`
`network.overview`	Network	`network`	`net`	`nodes`	`network`
`network.nodes`	Nodes	`network`	`lan`	`nodes`	`antenna.radiowaves.left.and.right`