{
  "slug": "datadog-ci-synthetics-run-tests-adds-dry-run-api-and-flag-bb7aafe834bf",
  "title": "datadog-ci synthetics run-tests adds dry-run API and flag",
  "tools": [
    "datadog-ci"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-03-30T16:24:42.000Z",
  "announced_at": "2026-03-30T16:24:42.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When you need to inspect which Synthetics tests would be triggered without running them, invoke `datadog-ci synthetics run-tests` with `--dry-run`; it prints a plan summary. The `planDryRun` library API resolves the test plan without executing tests.",
    "examples": [
      "datadog-ci synthetics run-tests --dry-run"
    ],
    "gotchas": [
      "Version: v5.10.0",
      "--dry-run: On `run-tests`, calls `planDryRun` and prints a human-readable summary; does not run tests.",
      "Prerequisite: Configure Datadog API and application keys using a global config file, `DD_API_KEY` and `DD_APP_KEY`, or CLI options.",
      "Prerequisite: Install `@datadog/datadog-ci` and the Synthetics plugin (`datadog-ci plugin install synthetics`)."
    ]
  },
  "why_it_matters": "Prepare a Synthetics `run-tests` invocation without running tests.",
  "sources": [
    "https://github.com/DataDog/datadog-ci/releases/tag/v5.10.0",
    "https://github.com/DataDog/datadog-ci/pull/2165",
    "https://github.com/DataDog/datadog-ci/blob/v5.10.0/packages/plugin-synthetics/README.md"
  ],
  "rank": 0.98013,
  "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-941ef3630ae84ef1-2:gate",
    "evidence_hash": "d84ff53f4bdbf6b768e95f0e06660b49c6f52b9f0ab16042af86438acf9b6b2a"
  },
  "review": {
    "draft_hash": "5687fa368aa41c1b2690a63b33b11222cfa4e4ed04fa8934eb0b877f62237902",
    "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.98 >= 0.9; 2 needed) and Jev gave 0.77 (>= 0.6 needed)."
  }
}