Skip to content

Guardian LAN/mDNS self-advertisement #488

Description

@itlackey

Spun out of #436 (Part 2) and #432 (Phase 6). Network partitioning landed in 0.12.0; the mDNS self-advertisement piece is deferred to 0.13.0.

Scope

When LAN access is explicitly enabled (via OP_BIND_ADDRESS, #395), the guardian and (optionally) the assistant advertise themselves on the local network over mDNS:

  • Guardian advertises as <assistant-name>-guardian.local.
  • When assistant LAN access is enabled, assistant advertises as <assistant-name>.local.

Notes / current state (0.12.0)

  • mDNS is currently scaffolded but default-off; the sidecar uses apk add at container boot rather than a baked image — replace with a baked image / a tiny Bun responder (the guardian is a Bun process, not an OpenCode process, so OpenCode --mdns does not apply).
  • Must stay off by default; only advertises when LAN exposure is explicitly opted in. Never public without explicit opt-in.

Acceptance

  • mDNS responder baked (no boot-time apk add).
  • Advertises only when LAN access is enabled; loopback-only default emits nothing.
  • Admin UI surfaces the .local name when enabled.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions