{
  "slug": "dagger-changeset-api-merges-changesets-388beb9a196f",
  "title": "Dagger Changeset API merges changesets",
  "tools": [
    "dagger"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-02-05T23:50:53.000Z",
  "announced_at": "2026-02-05T23:50:53.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When combining changesets from module functions, call `withChangeset` for one changeset or `withChangesets` for several. Choose a supported `onConflict` value when conflicts need handling; the plural method supports only `FAIL` and `FAIL_EARLY` in v0.19.11.",
    "examples": [
      "changeset.withChangeset(changes: <otherChangeset>, onConflict: <strategy>)",
      "changeset.withChangesets(changes: [<otherChangeset1>, <otherChangeset2>], onConflict: <pluralStrategy>)"
    ],
    "gotchas": [
      "Version: v0.19.11",
      "withChangeset.changes (required): Changeset to merge into the calling changeset.",
      "withChangeset.onConflict: Conflict strategy; defaults to `FAIL`. Allowed: `FAIL_EARLY`, `FAIL`, `LEAVE_CONFLICT_MARKERS`, `PREFER_OURS`, `PREFER_THEIRS`.",
      "withChangesets.changes (required): List of changesets to merge into the calling changeset.",
      "withChangesets.onConflict: Conflict strategy; defaults to `FAIL`. Allowed: `FAIL_EARLY` or `FAIL` only; the strategies are mutually exclusive enum values.",
      "Merging uses git under the hood.",
      "The linked description says conflicts raise an error by default; `onConflict` can be set to `fail`, `skip`, `preferSelf`, or `preferOther`.",
      "Docs conflict: The v0.19.11 schema documents `withChangeset` (singular) and `withChangesets` (plural); the card's `withChangset` spelling is not the documented method name.",
      "Docs conflict: `withChangesets` in v0.19.11 does not support all four card-listed strategies: its schema allows only `FAIL` and `FAIL_EARLY`. `withChangeset` uses the five values documented above."
    ]
  },
  "why_it_matters": "Combine changesets produced by module functions while resolving conflicting file changes.",
  "sources": [
    "https://github.com/dagger/dagger/releases/tag/v0.19.11",
    "https://github.com/dagger/dagger/pull/11577",
    "https://github.com/dagger/dagger/blob/v0.19.11/docs/docs-graphql/schema.graphqls"
  ],
  "rank": 0.97026,
  "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-454373f66e502c27-0:gate",
    "evidence_hash": "dcb281f002c1b9c67aedef0c68645f862ce8cfddb9419cd993190ce0596a32bf"
  },
  "review": {
    "draft_hash": "95e8e86a5c294c3e73dea3e57b18a17dea02fcd14ec3e1ca4230bd30ce72eca9",
    "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.97 >= 0.9; 2 needed) and Jev gave 0.74 (>= 0.6 needed)."
  }
}