`exd telemetry coverage`

Flags evaluated zero times in the window. The "what's not getting traffic?" view.

Synopsis

exd telemetry coverage
    [--namespace <slug>] [--environment <env>]
    [--since <duration> | --from <ts> --to <ts>]
    [--source <uri>]...
    [--format human|json]
    [--limit <n>]
    [--fail-on-error]

See common flags for shared options.

Description

Reads the manifest to learn the full set of declared flags, joins against the evaluation records, and reports the difference: flags that were declared but had zero evaluations in the window.

Coverage vs. dead-flags. coverage shows flags with no traffic at all. dead-flags shows flags with traffic where every evaluation returned the catch-all variant. The former is "is anyone using this flag?"; the latter is "is anyone hitting a rule?"

Use cases

Periodic cleanup audit. Quarterly check: which flags can we retire?
```
exd telemetry coverage --since 30d
```
SDK-deployment verification. After rolling out a new SDK version, expected flags should start getting traffic within the SLA:
```
exd telemetry coverage --namespace marketing --since 1h --fail-on-error
```
Lifecycle-state cross-check. Combine with the lint warning W014 (retired flag with traffic) and this command's output to find flags ready to actually delete.

Subcommand-specific flags

None beyond the common-flag set.

Result fields (`--format json`)

result.uncovered is an array, sorted by last_evaluated_at ascending (oldest first):

Field	Type	Notes
`flag_key`	string	Flag key.
`namespace`	string	Namespace slug.
`last_evaluated_at`	RFC 3339 or null	Most recent evaluation observed anywhere in storage (not just the window). `null` means the flag has never been evaluated.
`lifecycle`	enum	`development`, `active`, or `retired`.

Diagnostics

T008 cold flag (one per uncovered entry)

Example

$ exd telemetry coverage --namespace marketing --since 30d
Flags with zero evaluations in last 30d (namespace 'marketing')

flag                       last_evaluated_at         lifecycle
legacy-experiment          never                     development     ← T008
old-promo-banner           2025-11-03T14:22:11Z      retired         ← T008
seasonal-q4-test           2025-12-31T23:59:42Z      active          ← T008

The seasonal-q4-test row is active — possibly worth retiring or re-enabling.

Exit codes

See telemetry exit codes.

Synopsis​

Description​

Use cases​

Subcommand-specific flags​

Result fields (--format json)​

Diagnostics​

Example​

Exit codes​

See also​