/sp-generate-network-map

/generate-network-map

Produce a human-readable PDF of the current topology, saved with a timestamp so historical snapshots accumulate.

Procedure

1. Read network/topology.yaml. Halt if absent.
2. Generate a Typst document at network/maps/YYYY-MM-DD-HHMM-network-map.typ containing:
   • Title: "Spotify Playback Network — "
   • Subtitle: subnet, last scan timestamp, total hosts.
   • A table of hosts: device name, IP, role, player, speaker, DSP preset, OS.
   • A grouped section highlighting the Snapcast topology (server + clients) if present.
   • A notes block pulling from context/from-human/household-access.md if it exists.
3. Compile with typst compile <file>.typ → .pdf in the same folder.
4. Keep the .typ source alongside the .pdf so the user can tweak styling later.
5. Print the path of the new PDF.

Typst style

• Use IBM Plex Sans if available, else system default.
• Monospaced font for IPs and sink names.
• Keep it on one page where possible; allow overflow only for very large networks.
• No logos, no chrome. It's a reference document, not a marketing asset.

Naming

network/maps/2026-04-18-1430-network-map.pdf. One timestamp = one snapshot; never overwrite.