APX-116: Update validation docs to reflect native Go validators for Avro, JSON Schema, Parquet

Replace stale avro-tools/json-schema-diff references in validation-commands.md
and publishing/validation.md with accurate tool names (Native Go / jsonschema-diff).

Author: daniel-garcia

docs/cli-reference/validation-commands.md

@@ -24,9 +24,9 @@ If `path` is omitted, APX detects schema directories from `module_roots` in `apx
 |--------|------|----------------|
 | Protocol Buffers | `buf lint` | Naming conventions, package structure, field numbering, service definitions |
 | OpenAPI | Spectral | Schema structure, endpoint definitions, response formats |
-| Avro | avro-tools | Record structure, field defaults, type compatibility |
-| JSON Schema | json-schema-diff | Schema validity, reference resolution |
-| Parquet | built-in | Column definitions, type constraints |
+| Avro | Native Go | Record structure, field type validity, required `name`/`fields` presence |
+| JSON Schema | Native Go | JSON syntax, `$schema` URI, `type`, `properties`, `required` |
+| Parquet | Native Go | Message-notation syntax, physical type validity, repetition levels |
 
 For protobuf, APX also runs `go_package` validation — warning if the `go_package` option doesn't match the canonical import path.
 
@@ -87,9 +87,9 @@ apx breaking --against abc1234
 |--------|------|---------------------------|
 | Protocol Buffers | `buf breaking` | Field removal/renumbering, type changes, service/method removal |
 | OpenAPI | `oasdiff breaking` | Endpoint removal, required field additions, response type changes |
-| Avro | avro-tools | Field removal, type narrowing, default changes |
-| JSON Schema | json-schema-diff | Property removal, type restriction, required additions |
-| Parquet | built-in | Column removal, type changes |
+| Avro | Native Go | New fields without defaults, type changes (BACKWARD/FORWARD/FULL/NONE modes) |
+| JSON Schema | `jsonschema-diff` | Property removal, type restriction, required additions |
+| Parquet | Native Go | New required columns, removed columns, type/annotation changes, optional→required promotion |
 
 ### Examples
 

docs/publishing/validation.md

@@ -25,9 +25,9 @@ Runs format-specific linting on all schema files:
 |--------|------|--------|
 | Protocol Buffers | `buf lint` | Naming conventions, package structure, field numbering |
 | OpenAPI | Spectral | Endpoint definitions, response formats, schema structure |
-| Avro | avro-tools | Record structure, field defaults |
-| JSON Schema | json-schema-diff | Schema validity, reference resolution |
-| Parquet | built-in | Column definitions, type constraints |
+| Avro | Native Go | Record structure, type validity, required fields |
+| JSON Schema | Native Go | JSON syntax, `$schema` URI, `type`, `properties`, `required` |
+| Parquet | Native Go | Message-notation syntax, physical type validity, repetition levels |
 
 ### Breaking Changes
 
@@ -37,9 +37,9 @@ Detects backward-incompatible changes:
 |--------|------|---------|
 | Protocol Buffers | `buf breaking` | Field removal/renumbering, type changes, service removal |
 | OpenAPI | `oasdiff breaking` | Endpoint removal, required field additions |
-| Avro | avro-tools | Field removal, type narrowing |
-| JSON Schema | json-schema-diff | Property removal, type restrictions |
-| Parquet | built-in | Column removal, type changes |
+| Avro | Native Go | New fields without defaults, type changes (configurable compatibility mode) |
+| JSON Schema | `jsonschema-diff` | Property removal, type restrictions, required additions |
+| Parquet | Native Go | New required columns, removed columns, type/annotation changes |
 
 ---