Implement comprehensive schema validation for blurbs

[highvoltag3]

Description

This PR implements comprehensive schema validation for blurbs to ensure data quality and consistency across all users. The implementation includes JSON schema validation, custom validation logic, CLI tools, and integration with the CoverLetterAgent.

Type of Change

• New feature
• Bug fix
• Breaking change
• Documentation update

Key Features Implemented

JSON Schema Definition ()

• Validates required sections: , ,
• Enforces field requirements: uid=501(darionovoa) gid=20(staff) groups=20(staff),12(everyone),61(localaccounts),79(_appserverusr),80(admin),81(_appserveradm),98(_lpadmin),33(_appstore),100(_lpoperator),204(_developer),250(_analyticsusers),395(com.apple.access_ftp),398(com.apple.access_screensharing),399(com.apple.access_ssh),400(com.apple.access_remote_ae), ,
• Validates ID and tag patterns (allows numbers at start)
• Supports optional sections: , ,
• Handles metadata and additional properties

Schema Validator Class ()

• Loads and validates JSON schemas
• Custom validation for duplicate IDs and field formats
• Detailed error reporting with file paths
• Handles empty files gracefully

CLI Validation Tool ()

• Validate specific users:
• Validate all users:
• Verbose output:
• JSON export:
• Exit codes for CI integration

Integration with Cover Letter Agent

• Schema validation runs when loading blurbs
• Graceful error handling with detailed messages
• Maintains backward compatibility

Comprehensive Test Suite ()

• 19 test cases covering all validation scenarios
• Tests for valid/invalid data, edge cases, and integration
• All tests passing ✅

GitHub Actions Workflow ()

• Automated validation on pull requests
• Runs validation for all users
• Provides detailed error reporting

Testing

• Unit tests pass (19/19 tests passing)
• Integration tests pass
• Manual testing completed
• CLI tool tested with all users
• CoverLetterAgent integration verified

Checklist

• Code follows style guidelines
• Self-review completed
• Documentation updated
• No breaking changes (backward compatible)
• All existing users pass validation
• Empty file handling implemented
• Error messages are clear and actionable

Current Status

✅ All users pass validation (except test_empty_yaml which is intentionally empty)
✅ All tests passing (19/19)
✅ Integration with CoverLetterAgent working
✅ CLI tool functional
✅ GitHub Actions workflow ready

This implementation addresses Issue #11 and provides a robust foundation for data quality assurance.

Closes #11

[highvoltag3]

I need to fix CI... but feel free to review.