Removing Obsolete One-Off Maintenance Procedures from the Homelab Repository
I removed three large, one-off maintenance scripts and their associated documentation and CI checks from the homelab repository. These procedures were tied to a specific past incident and a blocked identity conversion that will not proceed, so keeping them in the tree added noise and maintenance burden without value.
What was removed and why
The push deletes scripts/entra-owner-conversion.py (492 lines) and its test scripts/ci/entra-owner-conversion-test.py (493 lines), plus scripts/zimaboard-2-incident-recovery.py (676 lines). The Entra owner-conversion helper was a narrow, read-only prepare/attest transaction for converting the external owner account to internal in the Entra admin center. It was blocked because the target domain remains federated with Google Workspace and Microsoft requires a nonfederated UPN domain. The Zimaboard-2 incident-recovery script was a one-shot Talos reboot helper bound to a specific node UID and boot ID from a November 2 incident. Both scripts served their stated single-purpose roles and are no longer needed in the tree.
Documentation and CI cleanup
The removal spans docs/entra-terraform-provider.md, docs/octelium.md, docs/operator-infrastructure.md, docs/talos-control-plane-maintenance.md, clusters/homelab/apps/fleet/FREE-ENTRA.md, and AGENTS.md. All references to the removed scripts, the portal conversion exception, and the held incident-recovery plan were stripped. The openwiki entries in source-map.md, workloads/inventory.md, and operations/validation-gates.md were updated to remove the script resource entries and describe the current state. In CI, the static-checks.sh entry that invoked the removed test was dropped, and n8n-paired-checkpoint.sh and n8n-maintenance-fence-check.sh had checks for already-deleted migration value files removed. The n8n-paired-checkpoint.yml workflow was updated to match.
Platform engineering takeaway
A platform team can apply the same discipline: when a one-off recovery or conversion script has served its purpose or its precondition is permanently blocked, remove it rather than leaving it as dead code. The commit explicitly notes that no identity or recovery-account state changes as part of the cleanup and that the federated owner target remains unresolved. Keeping the tree limited to supported, active procedures reduces cognitive load and prevents operators from following outdated runbooks.