Implement JSON Schema support for ktmidi-ci module

[devin-ai-integration]

JSON Schema Support Implementation for ktmidi-ci

This PR implements comprehensive JSON Schema support for the ktmidi-ci module following the JSON Schema Draft 2020-12 specification.

🎯 Overview

Added a complete JSON Schema API in the dev.atsushieno.ktmidi.ci.jsonschema package that integrates seamlessly with the existing MIDI-CI property exchange system and device configuration.

🚀 Features Implemented

Core JSON Schema Classes

• JsonSchema: Main schema representation with support for all core validation keywords
• JsonSchemaValidator: Comprehensive validation engine with detailed error reporting
• JsonSchemaException: Error handling following existing patterns
• JsonSchemaIntegration: Integration utilities for MIDI-CI system

Supported Validation Keywords

• Type validation: null, boolean, object, array, number, string, integer
• Object validation: properties, required, additionalProperties, minProperties, maxProperties
• Array validation: items, minItems, maxItems, uniqueItems
• String validation: minLength, maxLength, pattern, format
• Numeric validation: minimum, maximum, exclusiveMinimum, exclusiveMaximum
• Value validation: enum, const
• Metadata: title, description, default, examples

🔧 Integration Points

Existing System Integration

• Leverages existing Json.JsonValue for schema representation and validation
• Integrates with MidiCIDeviceConfiguration.jsonSchemaString property
• Compatible with existing property exchange infrastructure
• Follows established patterns from JsonParserException and @Serializable classes

Usage Examples

// Parse schema from JSON string
val schema = JsonSchema.parse("""{
    "type": "object",
    "properties": {
        "name": {"type": "string"},
        "age": {"type": "number", "minimum": 0}
    },
    "required": ["name"]
}""")

// Validate data against schema
val validator = JsonSchemaValidator()
val data = Json.parse("""{"name": "John", "age": 30}""")
val result = validator.validate(schema, data)

if (result.isValid) {
    println("Validation passed!")
} else {
    result.errors.forEach { error ->
        println("Error: ${error.message} at ${error.instancePath}")
    }
}

// Integration with MIDI-CI device configuration
val config = MidiCIDeviceConfiguration()
config.jsonSchemaString = schemaJson
val validationResult = JsonSchemaIntegration.validateDeviceConfiguration(config, data)

🧪 Testing

Comprehensive Test Suite

• JsonSchemaTest: Unit tests for all validation keywords and edge cases
• JsonSchemaIntegrationTest: Integration tests with MIDI-CI system
• Tests cover type validation, constraint validation, error handling, and schema parsing
• All tests follow existing patterns from JsonTest.kt

Build Verification

• ✅ Successfully compiles with ./gradlew :ktmidi-ci:compileKotlinJvm
• ✅ No breaking changes to existing functionality
• ✅ Follows Kotlin multiplatform conventions

📁 File Structure

ktmidi-ci/src/commonMain/kotlin/dev/atsushieno/ktmidi/ci/jsonschema/
├── JsonSchema.kt                 # Main schema representation
├── JsonSchemaValidator.kt        # Validation engine
├── JsonSchemaException.kt        # Error handling
└── JsonSchemaIntegration.kt      # MIDI-CI integration

ktmidi-ci/src/commonTest/kotlin/dev/atsushieno/ktmidi/ci/jsonschema/
├── JsonSchemaTest.kt             # Unit tests
└── JsonSchemaIntegrationTest.kt  # Integration tests

🎨 Design Principles

• Consistency: Follows existing ktmidi-ci patterns and conventions
• Integration: Seamless integration with existing JSON and property systems
• Extensibility: Designed for future enhancements and additional vocabulary support
• Performance: Efficient validation with detailed error reporting
• Compatibility: Works with existing Json.JsonValue and serialization infrastructure

🔗 Related

• Implements JSON Schema Draft 2020-12 specification
• Integrates with existing property exchange system in PropertyCommonRules.kt
• Enhances MidiCIDeviceConfiguration schema validation capabilities
• Compatible with existing Json.kt parsing and serialization

---

Link to Devin run: https://app.devin.ai/sessions/cee16ac818b34fdd8a5db07189691483

Requested by: Atsushi Eno ([email protected])

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[devin-ai-integration]

Closing due to inactivity for more than 7 days. Configure here.