Add OpenAPI schema validator with @seriousme/openapi-schema-validator

[Copilot]

This PR adds OpenAPI schema validation to the project using @seriousme/openapi-schema-validator as requested in the issue.

Changes Made

• Added dependency: Installed @seriousme/openapi-schema-validator as a dev dependency
• Added validation script: Created npm run validate command that validates dist/schema.json
• Updated CI workflow: Added schema generation and validation steps to the GitHub Actions workflow
• Added comprehensive tests: Created test suite to verify the validation functionality works correctly

Workflow Integration

The CI workflow now includes these steps in order:

1. Check code formatting
2. Build project
3. Generate OpenAPI schema
4. Validate OpenAPI schema ← New step
5. Run tests

Usage

# Generate the schema
npm run generate

# Validate the generated schema
npm run validate

Notes

The validation currently identifies real schema issues in the OAuth2 security scheme configuration that should be addressed in a future PR. The validator is working correctly and will fail CI builds when schema validation errors exist, ensuring schema quality going forward.

Example validation output:

{
  "valid": false,
  "errors": [
    {
      "instancePath": "/components/securitySchemes/OAuth2",
      "message": "must have required property 'flows'"
    }
  ]
}

Fixes #26.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[abraham]

Run npm run validate and fix the issues

[Copilot]

Run npm run validate and fix the issues

Fixed the OAuth2 security scheme validation issues by adding the required flows property with proper authorizationCode and clientCredentials flows as supported by Mastodon. The OAuth2 validation now passes. Commit: c774902

[abraham]

run format command

[Copilot]

run format command

Format command has been run successfully. The code has been formatted according to prettier configuration. Commit: 54648cc

[abraham]

Fix the schema generation so the validation succeeds

[Copilot]

Fix the schema generation so the validation succeeds

Fixed the schema generation issues. The validation now succeeds with {"valid": true}. Key improvements:

• Enhanced EntityParser to handle multiple entity definitions within single files (Field, CredentialAccount, MutedAccount, etc.)
• Fixed type parsing to avoid creating invalid references for documentation links
• Added support for nested entity definitions like Announcement::Account
• Now generates 85 entities (up from 64) with proper schema validation

Commit: 967ef98