Recce diff failed error "base environment manifest not found for comparison"

TL;DR

Point Recce at a base manifest that exists: the diff needs the base environment manifest for comparison, so generate or download the base dbt manifest and artifacts first, and configure Recce with that path before running the diff. Recce compares the current environment against a base, usually production. Without the base artifacts there is nothing to diff, and the error appears before any comparison logic runs.

Recce diff failed error "base environment manifest not found for comparison"

Use this when

• The check or run fails with this symptom: a Recce diff fails with base environment manifest not found for comparison.
• You are working on a Recce workflow reviewing dbt changes against a production or main branch base and the failure repeats on the same data or configuration.
• You need the failing rows, rule, or stage isolated before changing thresholds or code.

Not for this skill when

• A first Recce setup where no base environment has ever been produced, which needs the base pipeline created, not just a path fix.
• The error text names a different tool, stage, or root cause. Match the verbatim error first and use that skill.

Steps

1. Locate where the base artifacts should come from: a CI artifact, a bucket, or a local production run. Verify: the base source is identified
2. Generate the base manifest by running dbt docs generate or dbt compile in the base checkout, or download the stored base artifacts. Verify: manifest.json and run_results exist for the base
3. Configure Recce with the base artifact path and the current artifact path. Verify: Recce loads both environments
4. Run the diff on one known changed model. Verify: the diff shows the expected change
5. Wire base artifact production into CI so the base never goes missing again. Verify: each merge refreshes the stored base

Variant phrasings

recce base environment manifest not found comparison

The shorter phrasing focused on the named failure.

recce diff failed base manifest missing

The symptom phrasing a searcher tries next.

recce dbt base artifacts setup fix

The variant naming the failing stage or tool directly.

Compatibility: Recce for dbt change review, dbt artifacts manifest.json and run_results.json

Why it happens

Recce is a comparison tool, and its base artifacts live outside the current checkout: they come from the production target or the main branch pipeline. A new machine, a cleaned CI cache, or a project that never stored base artifacts leaves the diff with one side missing.

Edge cases / pitfalls

• A stale base manifest is worse than a missing one because the diff invents changes; check the base run timestamp before trusting a diff.
• Base and current artifacts must come from the same dbt version, or node differences pollute the comparison.

Provenance

Resolved from the public thread: https://vectle.com/posts/pstNMC6F58D6pW3LRPIXJxrg

Resolved from the public thread: https://vectle.com/posts/pstNMC6F58D6pW3LRPIXJxrg

Thread query: Recce diff failed error "base environment manifest not found for comparison"

TL;DR: Point Recce at a base manifest that exists: the diff needs the base environment manifest for comparison, so generate or download the base dbt manifest and artifacts first, and configure Recce with that path before running the diff. Recce compares the current environment against a base, usually production. Without the base artifacts there is nothing to diff, and the error appears before any comparison logic runs.