docs: end-to-end gardening — links, stale refs, tailscale.md update

Comprehensive documentation gardening across the merged repo:

- tailscale.md: fully rewritten with current ground truth. The netinfra
  pair now runs production Technitium with all knel.net records
  replicated. Both LAN IPs resolve knel.net device names and recurse
  externally. The old "NXDOMAIN / zone is stale" findings are replaced
  with the resolved state and current recommendations.
- AGENTS.md: rewritten with Gitea-compatible clickable relative links
  to all key scripts and docs. Autonomous commit/push policy
  prominently documented. SSH user corrected to localuser.
- README.md: directory table and docs table now use clickable links.
- All .md cross-references converted to Gitea-renderable relative links.
- Stale path references (ProjectCode/, Project-Tests/, ProjectDocs/)
  updated to current names (provisioning/, tests/) across all docs.
- Stale repo name "FetchApply" / "KNELServerBuild" updated to
  "PFVCluster" in actionable docs; historical AI-review docs tagged
  with an HTML comment notice.
- REFACTORING-EXAMPLES.md: tagged as historical (pre-refactor patterns).
- tests/README.md, dns-cluster-setup/README.md, docs/DEPLOYMENT.md,
  docs/SECURITY.md: path references fixed to current structure.

🤖 Generated with [Crush](https://github.com/charmassociates/crush)

Assisted-by: GLM-5 via Crush <crush@charm.land>

README.md

@@ -5,17 +5,16 @@ Combines server provisioning, Proxmox cluster operations, and DNS infrastructure
 
 ## Directory Structure
 
-```
-provisioning/        Server provisioning (SetupNewSystem.sh, security hardening,
-                     2FA, NTP/DNS config, SNMP, Dell OMSA)
-tests/               Test suite + VM validation harness
-dns-cluster-setup/   Technitium DNS cluster replication scripts
-perf/                Proxmox performance tuning, fleet audit, iperf, switch diagnostics
-netinfra/            pfv-netinfra-01/02 DNS/NTP setup + audit scripts
-switches/            Switch configuration captures
-docs/                All documentation (PROJECT.md, SECURITY.md, tailscale.md, etc.)
-vendor/              Vendored KNELShellFramework
-```
+| Directory | Description |
+|-----------|-------------|
+| [`provisioning/`](provisioning/) | Server provisioning (SetupNewSystem.sh, security hardening, 2FA, NTP/DNS config, SNMP, Dell OMSA) |
+| [`tests/`](tests/) | Test suite + VM validation harness |
+| [`dns-cluster-setup/`](dns-cluster-setup/) | Technitium DNS cluster replication scripts |
+| [`perf/`](perf/) | Proxmox performance tuning, fleet audit, iperf, switch diagnostics |
+| [`netinfra/`](netinfra/) | pfv-netinfra-01/02 DNS/NTP setup + audit scripts |
+| [`switches/`](switches/) | Switch configuration captures |
+| [`docs/`](docs/) | All documentation |
+| [`vendor/`](vendor/) | Vendored KNELShellFramework |
 
 ## Quick Start
 
@@ -54,12 +53,14 @@ cd perf/
 
 | Doc | Contents |
 |-----|----------|
-| `docs/PROJECT.md` | Comprehensive fleet report (7 hosts, VM inventory, storage) |
-| `docs/SECURITY.md` | Security architecture and hardening details |
-| `docs/tailscale.md` | Tailscale vs managed DNS analysis |
-| `docs/DEPLOYMENT.md` | Deployment procedures |
-| `docs/TODO.md` | Pending hardware work (tsys2/4/5) |
-| `dns-cluster-setup/README.md` | DNS cluster setup guide |
+| [`docs/PROJECT.md`](docs/PROJECT.md) | Comprehensive fleet report (7 hosts, VM inventory, storage) |
+| [`docs/SECURITY.md`](docs/SECURITY.md) | Security architecture and hardening details |
+| [`docs/tailscale.md`](docs/tailscale.md) | Tailscale vs managed DNS analysis (resolved) |
+| [`docs/DEPLOYMENT.md`](docs/DEPLOYMENT.md) | Deployment procedures |
+| [`docs/TODO.md`](docs/TODO.md) | Pending hardware work (tsys2/4/5) |
+| [`docs/K8S.md`](docs/K8S.md) | Kubernetes architecture deep-dive |
+| [`dns-cluster-setup/README.md`](dns-cluster-setup/README.md) | DNS cluster setup guide |
+| [`tests/README.md`](tests/README.md) | Test suite documentation |
 
 ## Architecture