1#!/usr/bin/env python3
2"""
3Validation script for java-spring-boot skill.
4Category: general
5"""
6 
7import os
8import sys
9import yaml
10import json
11from pathlib import Path
12 
13 
14def validate_config(config_path: str) -> dict:
15    """
16    Validate skill configuration file.
17 
18    Args:
19        config_path: Path to config.yaml
20 
21    Returns:
22        dict: Validation result with 'valid' and 'errors' keys
23    """
24    errors = []
25 
26    if not os.path.exists(config_path):
27        return {"valid": False, "errors": ["Config file not found"]}
28 
29    try:
30        with open(config_path, 'r') as f:
31            config = yaml.safe_load(f)
32    except yaml.YAMLError as e:
33        return {"valid": False, "errors": [f"YAML parse error: {e}"]}
34 
35    # Validate required fields
36    if 'skill' not in config:
37        errors.append("Missing 'skill' section")
38    else:
39        if 'name' not in config['skill']:
40            errors.append("Missing skill.name")
41        if 'version' not in config['skill']:
42            errors.append("Missing skill.version")
43 
44    # Validate settings
45    if 'settings' in config:
46        settings = config['settings']
47        if 'log_level' in settings:
48            valid_levels = ['debug', 'info', 'warn', 'error']
49            if settings['log_level'] not in valid_levels:
50                errors.append(f"Invalid log_level: {settings['log_level']}")
51 
52    return {
53        "valid": len(errors) == 0,
54        "errors": errors,
55        "config": config if not errors else None
56    }
57 
58 
59def validate_skill_structure(skill_path: str) -> dict:
60    """
61    Validate skill directory structure.
62 
63    Args:
64        skill_path: Path to skill directory
65 
66    Returns:
67        dict: Structure validation result
68    """
69    required_dirs = ['assets', 'scripts', 'references']
70    required_files = ['SKILL.md']
71 
72    errors = []
73 
74    # Check required files
75    for file in required_files:
76        if not os.path.exists(os.path.join(skill_path, file)):
77            errors.append(f"Missing required file: {file}")
78 
79    # Check required directories
80    for dir in required_dirs:
81        dir_path = os.path.join(skill_path, dir)
82        if not os.path.isdir(dir_path):
83            errors.append(f"Missing required directory: {dir}/")
84        else:
85            # Check for real content (not just .gitkeep)
86            files = [f for f in os.listdir(dir_path) if f != '.gitkeep']
87            if not files:
88                errors.append(f"Directory {dir}/ has no real content")
89 
90    return {
91        "valid": len(errors) == 0,
92        "errors": errors,
93        "skill_name": os.path.basename(skill_path)
94    }
95 
96 
97def main():
98    """Main validation entry point."""
99    skill_path = Path(__file__).parent.parent
100 
101    print(f"Validating java-spring-boot skill...")
102    print(f"Path: {skill_path}")
103 
104    # Validate structure
105    structure_result = validate_skill_structure(str(skill_path))
106    print(f"\nStructure validation: {'PASS' if structure_result['valid'] else 'FAIL'}")
107    if structure_result['errors']:
108        for error in structure_result['errors']:
109            print(f"  - {error}")
110 
111    # Validate config
112    config_path = skill_path / 'assets' / 'config.yaml'
113    if config_path.exists():
114        config_result = validate_config(str(config_path))
115        print(f"\nConfig validation: {'PASS' if config_result['valid'] else 'FAIL'}")
116        if config_result['errors']:
117            for error in config_result['errors']:
118                print(f"  - {error}")
119    else:
120        print("\nConfig validation: SKIPPED (no config.yaml)")
121 
122    # Summary
123    all_valid = structure_result['valid']
124    print(f"\n==================================================")
125    print(f"Overall: {'VALID' if all_valid else 'INVALID'}")
126 
127    return 0 if all_valid else 1
128 
129 
130if __name__ == "__main__":
131    sys.exit(main())
132