/**
* Runtime validation for skill-rules.json structure
*
* Provides basic runtime validation to catch configuration errors early.
* Full schema validation happens in pre-commit hooks via Python + jsonschema.
*/
export interface ValidationResult {
valid: boolean;
errors: string[];
}
/**
* Validate skill-rules.json structure at runtime
*
* @param skillRules - The parsed skill rules configuration object
* @returns Validation result with any errors found
*
* @example
* const rules = JSON.parse(readFileSync('skill-rules.json', 'utf-8'));
* const result = validateSkillRules(rules);
* if (!result.valid) {
* console.error('Validation errors:', result.errors);
* }
*/
export function validateSkillRules(skillRules: any): ValidationResult {
const errors: string[] = [];
if (!skillRules.version) {
errors.push("Missing required field: version");
}
if (!skillRules.skills || typeof skillRules.skills !== "object") {
errors.push("Missing or invalid field: skills (must be object)");
return { valid: false, errors };
}
for (const [skillName, config] of Object.entries(skillRules.skills)) {
const skill = config as any;
// Validate required fields
if (!skill.type || !["guardrail", "domain"].includes(skill.type)) {
errors.push(
`${skillName}: Invalid or missing 'type' (must be 'guardrail' or 'domain')`
);
}
// autoInject is optional (defaults to true), but if present must be boolean
if (
skill.autoInject !== undefined &&
typeof skill.autoInject !== "boolean"
) {
errors.push(
`${skillName}: Invalid 'autoInject' (must be boolean if provided)`
);
}
// Validate affinity if present
if (skill.affinity) {
if (!Array.isArray(skill.affinity)) {
errors.push(`${skillName}: affinity must be array`);
} else if (skill.affinity.length > 2) {
errors.push(`${skillName}: affinity can have max 2 skills`);
}
}
}
return { valid: errors.length === 0, errors };
}
