scan_infrastructure_drift
Detect infrastructure drift by scanning hosts against the sitemap; returns a coverage report with probed, unreachable, unknown, and changed statuses and counts.
Instructions
Scan for infrastructure drift against the sitemap. Returns a four-bucket coverage report — probed_ok (sitemap host probed successfully), unreachable (sitemap host that did not respond), unknown (reserved for Phase 39 — infrastructure present on a Proxmox hypervisor but absent from sitemap), and changed (reserved for Phase 39 — fingerprint differs from stored). All four buckets are always present in the response (empty arrays for Phase-39-reserved buckets) so client code can iterate without defensive checks. Each scan also returns a counts sub-dict mirroring bucket sizes and, when zero hosts were scanned (empty sitemap or filter narrowed to zero), a top-level guidance field pointing to the sitemap CRUD tools (discover_and_map, get_network_sitemap, purge_failed_discoveries, decommission_device). Recovery from credential-resolution failure is handled via 'homelab-mcp credentials add --type proxmox'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | Optional sitemap hostname filter. Exact-match only — no wildcards, no case folding. When omitted, all sitemap rows are scanned. When set to a hostname that does not match any sitemap row, the scan returns status='success' with all four buckets empty and a guidance field — never an error. | |
| vm_type | No | Reserved for Phase 39 per-VM detection; currently filters at host level only (no-op until per-VM enumeration ships). Accepts qemu, lxc, or all — all three values produce identical scan results in this release. | all |