Version 0.0.21

netbox-proxbox 0.0.21 pairs with the proxbox-api 0.0.18
backend release, the proxmox-sdk 0.0.12 Proxmox SDK, and
netbox-sdk 0.0.10. NetBox compatibility is unchanged: 4.5.8 through
4.6.99 (validated against 4.5.8, 4.5.9, 4.6.0, and the official
4.6.1).

Highlights

• Sync-mode filtering at source. Per-record VM and VM-template filtering is
  now enforced by the proxbox-api backend using the sync_mode_vm /
  sync_mode_vm_template query parameters transmitted by the plugin. A
  disabled mode no longer creates dependent NetBox objects (manufacturer,
  device-type, cluster, site, node-device, role) for VMs that will never sync,
  because the backend skips those records before dependency precompute.
• VM sync reliability. Two-phase VM batch processing eliminates event-loop
  starvation on large clusters. Per-VM dispatch failures are isolated so one
  VM error counts against failed_vms rather than aborting the whole queue.
• Interface-dense guest fixes. Guest-agent alias entries are matched by name
  (not MAC) and aggregated into their parent interface. A partial-failure bulk
  reconciliation now raises and emits a failed stream frame instead of silent
  empty/partial success.
• Template forwarding contract test. tests/test_sync_mode_forwarding.py
  pins the two sync-mode query params that the plugin transmits to the backend.

Compatibility

proxbox-api is not a Python dependency of this plugin; the services
communicate over HTTP/SSE/WebSocket. Install the matching
proxbox-api 0.0.18 backend separately. This release supports NetBox
4.5.8 through 4.6.99 and requires Python >=3.12.

Upgrade Notes

• Upgrade the plugin to netbox-proxbox 0.0.21 and the backend to
  proxbox-api 0.0.18.
• Use proxmox-sdk 0.0.12 and netbox-sdk 0.0.10 in the paired
  backend environment.
• Run the normal NetBox plugin upgrade flow: install the package, run
  python manage.py migrate netbox_proxbox, collect static files, and restart
  NetBox/RQ workers.
• No model, migration, or NetBox compatibility changes are included in this
  release candidate.