Skip to content

DET001 - Family Mismatch

Description

The user-supplied --target (or --to) family contradicts the family that the detection layer inferred from the payload itself.

Category

Detection Errors

Severity

error

When emitted

Surfaced from validators/detection.py during the routing phase that runs before any layered validator. The CLI translates DET001 into exit code EXIT_FAMILY_MISMATCH (3) so wrapper scripts can branch on it without parsing error messages — see ADR 0005.

Common causes

  • Running dppvalidator validate --target untp <cirpass-payload>.json on a payload whose @context resolves to the CIRPASS namespace.
  • Migrating the wrong direction: migrate --to cirpass-1.3 against a payload that already declares CIRPASS shape.
  • A pipeline that hard-codes --target while feeding it mixed-family fixtures.

How to fix

  • Drop the --target / --to flag and let detection auto-route, or
  • Pass the family that matches the payload's declared @context / shape, or
  • If you intentionally want the cross-family pathway, use dppvalidator migrate rather than validate.

See also