{
  "generated": "2026-10-14",
  "tool": "driftpipe",
  "version": "0.9.4",
  "count": 14,
  "limitations": [
    {
      "id": "lim-input-json",
      "area": "input",
      "title": "Only JSON records",
      "detail": "Newline-delimited JSON, a JSON array of objects, concatenated objects, optionally gzipped - nothing else. Columnar and binary formats carry their own schema in the file header, so comparing two headers is a different and much easier program than this one.",
      "status": "not planned"
    },
    {
      "id": "lim-no-csv",
      "area": "input",
      "title": "No CSV",
      "detail": "CSV has no types and no nesting; structural drift in a CSV is a changed header line, which diff already handles better than a type lattice would.",
      "status": "not planned"
    },
    {
      "id": "lim-no-network",
      "area": "input",
      "title": "No network input",
      "detail": "A file path or standard input only. Pipe a consumer into it for live data, which keeps credentials, offsets and retries in the tool that already knows about them.",
      "status": "not planned"
    },
    {
      "id": "lim-head-sample",
      "area": "sampling",
      "title": "The sample is the first N records",
      "detail": "This is head bias and it is the sharpest edge in the tool: a field that appears only after the cut is invisible, and a dump sorted by anything correlated with the schema will hide drift.",
      "status": "open - use --sample 0 where correctness matters"
    },
    {
      "id": "lim-array-collapse",
      "area": "structure",
      "title": "Arrays are collapsed to one element shape",
      "detail": "items[0] and items[7] are the same path and their types are merged, so a tuple-shaped array is reported as a union across all positions.",
      "status": "not planned"
    },
    {
      "id": "lim-depth",
      "area": "structure",
      "title": "Depth is limited to 8 by default",
      "detail": "Below the limit a subtree is reported once as depth_exceeded and not expanded, so drift inside it is invisible; raising --max-depth costs memory linearly in distinct paths.",
      "status": "open"
    },
    {
      "id": "lim-keys-literal",
      "area": "structure",
      "title": "Keys are compared literally",
      "detail": "userId, userid and user_id are three unrelated paths; there is no case folding, because a producer that changes the case of a key has changed the key.",
      "status": "not planned"
    },
    {
      "id": "lim-dup-keys",
      "area": "structure",
      "title": "Duplicate keys in one object: last wins, silently",
      "detail": "This matches the decoder's behaviour and the duplication itself is not reported; detecting it needs a custom decoding path and a major version.",
      "status": "open"
    },
    {
      "id": "lim-num-syntax",
      "area": "types",
      "title": "Numbers are classified by syntax",
      "detail": "1 is int; 1.0 and 1e3 are float, even though both are mathematically integral, so a switch from 1000 to 1e3 is reported as widening.",
      "status": "not planned"
    },
    {
      "id": "lim-strings-opaque",
      "area": "types",
      "title": "Strings are opaque",
      "detail": "A timestamp, a UUID, an email and a base64 blob are all string; format inference is a guess, and a guess ends up frozen in a committed lock.",
      "status": "not planned"
    },
    {
      "id": "lim-no-values",
      "area": "types",
      "title": "No value-level checks of any kind",
      "detail": "No ranges, enums, regular expressions, uniqueness, cross-field constraints or row counts - values are never read, which is what lets a lock be committed publicly.",
      "status": "not planned"
    },
    {
      "id": "lim-jsonschema",
      "area": "interop",
      "title": "The lock is not JSON Schema, and conversion is lossy",
      "detail": "Outgoing, the lock cannot express required faithfully; incoming, oneOf, patternProperties, conditionals and formats have no representation here.",
      "status": "open"
    },
    {
      "id": "lim-no-plugins",
      "area": "interop",
      "title": "No plugins, no scripting, no rule language",
      "detail": "Six classes, three severities and a path pattern syntax; a policy that does not fit reads --format json with the tool of your choice.",
      "status": "not planned"
    },
    {
      "id": "lim-symlinks",
      "area": "platform",
      "title": "Symlinks are not followed",
      "detail": "On any platform, for both input and lock; a symlinked lock is read, but snapshot --force replaces the link rather than writing through it.",
      "status": "by design"
    }
  ]
}
