(manual census reporting) add CLI subcommand and API endpoint for census utilization

[sujay-hashicorp]

Description

• Added subcommand operator utilization to generate and send utilization report bundle.
• Added new API endpoint and Handler to fetch the bundle and respond.
• Both require enterprise build hence added a guardrail to ensure operation happens with enterprise build.

Testing & Reproduction steps

Run consul agent -dev to start consul server in dev mode and to monitor logs

CLI Command

API Call

Logs

2025-09-26T20:40:16.213+0530 [ERROR] agent.http: Request error: method=GET url=/v1/operator/utilization from=127.0.0.1:54505 error="operator utilization requires Consul Enterprise"
2025-09-26T20:40:16.213+0530 [DEBUG] agent.http: Request finished: method=GET url=/v1/operator/utilization from=127.0.0.1:54505 latency="114.583µs"

Links

PR Checklist

• updated test coverage
• external facing docs updated
• appropriate backport labels added
• not a security concern

PCI review checklist

• I have documented a clear reason for, and description of, the change I am making.

• If applicable, I've documented a plan to revert these changes if they require more than reverting the pull request.

• If applicable, I've documented the impact of any changes to security controls.

  Examples of changes to security controls include using new access control methods, adding or removing logging pipelines, etc.