Fail on columns in another order than declared, when the schema says so

[markhm]

Fixes #1723.

Builds on #1725: the first commit is that PR, and this PR's own change is the last commit. Once #1725 is merged I'll rebase, and the diff shrinks to that commit.

Problem

A contract cannot say that the columns of a file must be in the declared order. Swapped columns pass unnoticed, and in a CSV file without a reliable header that hides a real error. ODCS v3.2.0 has no field for this.

What this changes

A schema opts in with a custom property:

schema:
  - name: orders
    customProperties:
      - property: propertyOrder
        value: strict

• The schema then gets a check, "Check that the fields of orders are in the order of the contract" (type model_property_order, dimension conformity). It fails with the expected and the actual order: Fields in another order: expected order_id, quantity, amount; found order_id, amount, quantity, with expected_order and actual_order in the diagnostics.
• It compares only the declared columns it finds. A missing column is left to the field presence check, and an extra one to additionalProperties: false from Fail on columns the contract does not declare, when the schema says so #1725. So the two settings together pin a file to exactly the declared columns, in order. They are separate because some exchanges care about the set of columns but not their order.
• Like Fail on columns the contract does not declare, when the schema says so #1725, it reads only the column names, compares them case-insensitively, also runs with --metadata-only, and works on every server read through ibis.
• Without the custom property nothing changes.

Tests

tests/test_test_property_order.py: 9 tests, covering the declared order, another order, a missing column, an extra column, case, no custom property, both settings together, --metadata-only, and a JSON file. uv run pytest: all pass. ruff: clean.

Docs

schema.md: a row in the checks table and a section on the setting. CHANGELOG entry under Added.

• Tests pass (uv run pytest)
• Code formatted (uv run ruff check --fix && uv run ruff format)
• Docs updated (if relevant)
• CHANGELOG.md entry added

🤖 Generated with Claude Code