Skip to content

Clean up stale multi-level mDNS remnants across the workspace #111

Description

@mairas

Context

The multi-level mDNS subdomain approach (cockpit.<host>.local, etc.) was retired in favor of path-based routing and the multi-hostname plan (already implemented in halos-core-containers). Two pockets of stale references survive and actively mislead readers — both human and AI — into reasoning about a feature that no longer exists.

This was surfaced during a design discussion where an AI assistant repeatedly built wrong mental models from the stale code before realizing the deployed system worked differently. The cost of leaving these in place compounds with every reader.

Scope

1. Workspace AGENTS.md (this repo)

AGENTS.md:79 lists halos-mdns-publisher/ in the Structure section, even though that repo is archived. Remove the line.

Possibly worth a wider audit of the Structure section vs. ./run's REPOS map — they diverge (Structure lists 19 entries, REPOS lists 11). Out of scope for this issue; flagged for a follow-up if it bites someone.

2. container-packaging-tools — stale halos-core-containers/ subtree

Tracked separately: halos-org/container-packaging-tools#204

The container-packaging-tools/halos-core-containers/ subtree contains pre-multi-hostname-plan templates (Traefik Host(cockpit.${HALOS_DOMAIN}) rules, wildcard *.${HALOS_DOMAIN} SAN, halos.subdomain label emission) that no longer match the active halos-core-containers repo. Confirmed container-packaging-tools does not regenerate halos-core-containers — it only references it as a version constraint — so the subtree is dead fixture, not a generation source.

Verification done

  • git remote -v → workspace is halos-org/halos
  • ./run REPOS map — no halos-mdns-publisher entry (already clean)
  • grep -rn 'halos.subdomain\|cockpit\.\${HALOS\|\*\.\${HALOS_DOMAIN}' halos-core-containers/ (real repo, excluding debian/ build output) — zero results, fully clean
  • Multi-hostname plan implementation confirmed: halos-core-containers/prestart.sh:35 calls halos_load_hostnames, SAN list at :106-117 is halos_all_hostnames-driven (no wildcard), Cockpit routing at :163-214 is path-based (/cockpit/ redirects to :9090)

Out of scope

  • Wider AGENTS.md/REPOS divergence audit
  • Refactoring or improvements to container-packaging-tools's real surface area
  • Anything in archived repos themselves

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions