{
  "slug": "vercel-flags-evaluations-displays-feature-flag-evaluation-charts-and-bucket-data-7ac9eefd03ae",
  "title": "vercel flags evaluations displays feature-flag evaluation charts and bucket data",
  "tools": [
    "vercel"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-07-20T14:56:07.000Z",
  "announced_at": "2026-07-20T14:56:07.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When reviewing a flag’s evaluation distribution, run `vercel flags evaluations <flag>` to view per-variant metrics and charts. Use `--since` and `--granularity` to select the range and bucket size, or `--json` for bucket data and truncation metadata.",
    "examples": [
      "vercel flags evaluations <flag>",
      "vercel flags evaluations <flag> --since 24h --granularity 1h",
      "vercel flags evaluations <flag> --since 24h --json"
    ],
    "gotchas": [
      "Version: 56.4.0",
      "<flag> (required): Feature flag slug or ID.",
      "--since <TIME>: Start time as a relative duration or ISO 8601 timestamp; defaults to `1h`.",
      "--granularity <SIZE>: Time bucket size: `1m`, `5m`, `15m`, `1h`, `4h`, or `1d`; defaults to automatic.",
      "--json: Output exact bucket data as JSON instead of a human-readable summary.",
      "Prerequisite: Use an installed, authenticated Vercel CLI and target a project; the command defaults to the linked project. CLI installation: `pnpm i -g vercel`.",
      "Prerequisite: The command was added in Vercel CLI 56.4.0."
    ]
  },
  "why_it_matters": "Inspect a feature flag’s evaluation distribution while debugging or reviewing its behavior.",
  "sources": [
    "https://github.com/vercel/vercel/releases/tag/vercel%4056.4.0",
    "https://vercel.com/docs/cli/flags",
    "https://github.com/vercel/flags/blob/main/skills/flags-sdk/references/providers.md"
  ],
  "rank": 0.96025,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "backfill-20261007",
    "verdict_id": "backfill-20261007:backfill-20261007-3f54f034ceebb02e-0:gate",
    "evidence_hash": "647a8a6f21e3c71c1649f60dde970b03df62799eaf83aa39adb2e83c12c4f7d7"
  },
  "review": {
    "draft_hash": "a29be9efb8f90a272b08b8d1c11a40cbe12fec5f340da1b49da1398ba2200a52",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "backfill-20261007:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.96 >= 0.9; 2 needed) and Jev gave 0.76 (>= 0.6 needed)."
  }
}