{
  "slug": "datadog-ci-sourcemaps-find-locates-local-maps-by-debug-id-94ac6d4081cf",
  "title": "datadog-ci sourcemaps find locates local maps by debug ID",
  "tools": [
    "datadog-ci"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-09-11T07:53:18.000Z",
  "announced_at": "2026-09-11T07:53:18.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When a sourcemap is missing from the Datadog UI, locate local `*.js.map` files by top-level `debug_id` or find maps without that field. Run `datadog-ci sourcemaps find` with the build directory and the appropriate query flag; it only inspects local files.",
    "examples": [
      "datadog-ci sourcemaps find ./build --debug-id 12345678-1234-1234-1234-123456789abc",
      "datadog-ci sourcemaps find ./build --missing-debug-id"
    ],
    "gotchas": [
      "Version: v5.24.0",
      "directory (required): Directory to scan recursively for `*.js.map` files.",
      "--debug-id <uuid> (required): Selects sourcemaps with the specified top-level `debug_id`; use this query or `--missing-debug-id`.",
      "--missing-debug-id (required): Selects sourcemaps without a top-level `debug_id`; use this query or `--debug-id`.",
      "--json: Enables machine-readable output.",
      "--max-concurrency: Controls concurrent sourcemap inspection.",
      "The command scans `*.js.map` files recursively and reports matching sourcemap paths.",
      "It only examines local files and does not verify whether Datadog received an artifact.",
      "It does not inspect minified JavaScript bundles or compare bundle and sourcemap IDs."
    ]
  },
  "why_it_matters": "Troubleshoot a sourcemap missing from the Datadog UI by locating matching artifacts in a local build directory.",
  "sources": [
    "https://github.com/DataDog/datadog-ci/releases/tag/v5.24.0",
    "https://github.com/DataDog/datadog-ci/pull/2471",
    "https://github.com/DataDog/datadog-ci/blob/v5.24.0/packages/base/src/commands/sourcemaps/README.md"
  ],
  "rank": 0.99035,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave2a-20261017",
    "verdict_id": "wave2a-20261017:wave2a-20261017-755de16d3865e730-1:gate",
    "evidence_hash": "a5eef9e998efe997cfa7b1427ab50514a9ab5a95a7e84d6781c63e618af0b6d3"
  },
  "review": {
    "draft_hash": "ec9451c34186c3c79be286f3037da6151ec8e351cbd2dc619ee29329dc6d6aad",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave2a-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.99 >= 0.9; 2 needed) and Jev gave 0.79 (>= 0.6 needed)."
  }
}