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
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 inhalos-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:79listshalos-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— stalehalos-core-containers/subtreeTracked separately: halos-org/container-packaging-tools#204
The
container-packaging-tools/halos-core-containers/subtree contains pre-multi-hostname-plan templates (TraefikHost(cockpit.${HALOS_DOMAIN})rules, wildcard*.${HALOS_DOMAIN}SAN,halos.subdomainlabel emission) that no longer match the activehalos-core-containersrepo. Confirmedcontainer-packaging-toolsdoes not regeneratehalos-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 ishalos-org/halos./runREPOS map — nohalos-mdns-publisherentry (already clean)grep -rn 'halos.subdomain\|cockpit\.\${HALOS\|\*\.\${HALOS_DOMAIN}' halos-core-containers/(real repo, excludingdebian/build output) — zero results, fully cleanhalos-core-containers/prestart.sh:35callshalos_load_hostnames, SAN list at:106-117ishalos_all_hostnames-driven (no wildcard), Cockpit routing at:163-214is path-based (/cockpit/redirects to:9090)Out of scope
container-packaging-tools's real surface area