deployment-validation-config-validate

name	deployment-validation-config-validate
description	You are a configuration management expert specializing in validating, testing, and ensuring the correctness of application configurations. Create comprehensive validation schemas, implement configurat
risk	critical
source	community
date_added	2026-02-27
quality	stub

Configuration Validation

You are a configuration management expert specializing in validating, testing, and ensuring the correctness of application configurations. Create comprehensive validation schemas, implement configuration testing strategies, and ensure configurations are secure, consistent, and error-free across all environments.

Use this skill when

• Working on configuration validation tasks or workflows
• Needing guidance, best practices, or checklists for configuration validation

Do not use this skill when

• The task is unrelated to configuration validation
• You need a different domain or tool outside this scope

Context

The user needs to validate configuration files, implement configuration schemas, ensure consistency across environments, and prevent configuration-related errors. Focus on creating robust validation rules, type safety, security checks, and automated validation processes.

Requirements

$ARGUMENTS

Instructions

1. Configuration Analysis

Analyze existing configuration structure and identify validation needs:

import os
import yaml
import json
from pathlib import Path
from typing import Dict, List, Any

class ConfigurationAnalyzer:
    def analyze_project(self, project_path: str) -> Dict[str, Any]:
        analysis = {
            'config_files': self._find_config_files(project_path),
            'security_issues': self._check_security_issues(project_path),
            'consistency_issues': self._check_consistency(project_path),
            'recommendations': []
        }
        return analysis

    def _find_config_files(self, project_path: str) -> List[Dict]:
        config_patterns = [
            '**/*.json', '**/*.yaml', '**/*.yml', '**/*.toml',
            '**/*.ini', '**/*.env*', '**/config.js'
        ]

        config_files = []
        for pattern in config_patterns:
            for file_path in Path(project_path).glob(pattern):
                if not self._should_ignore(file_path):
                    config_files.append({
                        : (file_path),
                        : ._detect_config_type(file_path),
                        : ._detect_environment(file_path)
                    })
         config_files

     () -> []:
        issues = []
        secret_patterns = [
            ,
            ,
            ,
            
        ]

         config_file  ._find_config_files(project_path):
            content = Path(config_file[]).read_text()
             pattern  secret_patterns:
                 re.search(pattern, content, re.IGNORECASE):
                     ._looks_like_real_secret(content, pattern):
                        issues.append({
                            : config_file[],
                            : ,
                            : 
                        })
         issues

2. Schema Validation

Implement configuration schema validation with JSON Schema:

import Ajv from 'ajv';
import ajvFormats from 'ajv-formats';
import { JSONSchema7 } from 'json-schema';

interface ValidationResult {
  valid: boolean;
  errors?: Array<{
    path: string;
    message: string;
    keyword: string;
  }>;
}

export class ConfigValidator {
  private ajv: Ajv;

  constructor() {
    this.ajv = new Ajv({
      allErrors: true,
      strict: false,
      coerceTypes: true
    });
    ajvFormats(this.ajv);
    this.addCustomFormats();
  }

  private addCustomFormats() {
    this.ajv.addFormat('url-https', {
      : ,
      :  {
         {
            (data). === ;
        }  {  ; }
      }
    });

    ..(, {
      : ,
      :  data >=  && data <= 
    });

    ..(, {
      : ,
      : 
    });
  }

  (: , : ):  {
     validate = ..(schemaName);
     (!validate)   ();

     valid = (configData);

     (!valid && validate.) {
       {
        : ,
        : validate..( ({
          : error. || ,
          : error. || ,
          : error.
        }))
      };
    }
     { :  };
  }
}


  schemas = {
  : {
    : ,
    : {
      : { : , :  },
      : { : , :  },
      : { : , :  },
      : { : , :  },
      : { : , :  },
      : {
        : ,
        : {
          : { :  }
        },
        : []
      }
    },
    : [, , , , ]
  }
};

3. Environment-Specific Validation

from typing import Dict, List, Any

class EnvironmentValidator:
    def __init__(self):
        self.environments = ['development', 'staging', 'production']
        self.environment_rules = {
            'development': {
                'allow_debug': True,
                'require_https': False,
                'min_password_length': 8
            },
            'production': {
                'allow_debug': False,
                'require_https': True,
                'min_password_length': 16,
                'require_encryption': True
            }
        }

    def validate_config(self, config: Dict, environment: str) -> List[Dict]:
        if environment not in self.environment_rules:
            raise ValueError(f"Unknown environment: {environment}")

        rules = self.environment_rules[environment]
        violations = []

        if not rules[]  config.get(, ):
            violations.append({
                : ,
                : ,
                : 
            })

         rules[]:
            urls = ._extract_urls(config)
             url_path, url  urls:
                 url.startswith()     url:
                    violations.append({
                        : ,
                        : ,
                        : 
                    })

         violations

4. Configuration Testing

import { describe, it, expect } from '@jest/globals';
import { ConfigValidator } from './config-validator';

describe('Configuration Validation', () => {
  let validator: ConfigValidator;

  beforeEach(() => {
    validator = new ConfigValidator();
  });

  it('should validate database config', () => {
    const config = {
      host: 'localhost',
      port: 5432,
      database: 'myapp',
      user: 'dbuser',
      password: 'securepass123'
    };

    const result = validator.validate(config, 'database');
    expect(result.valid).toBe(true);
  });

  it('should reject invalid port', () => {
    const config = {
      host: 'localhost',
      port: 70000,
      database: 'myapp',
      user: 'dbuser',
      : 
    };

     result = validator.(config, );
    (result.).();
  });
});

5. Runtime Validation

import { EventEmitter } from 'events';
import * as chokidar from 'chokidar';

export class RuntimeConfigValidator extends EventEmitter {
  private validator: ConfigValidator;
  private currentConfig: any;

  async initialize(configPath: string): Promise<void> {
    this.currentConfig = await this.loadAndValidate(configPath);
    this.watchConfig(configPath);
  }

  private async loadAndValidate(configPath: string): Promise<any> {
    const config = await this.loadConfig(configPath);

    const validationResult = this.validator.validate(
      config,
      this.detectEnvironment()
    );

    if (!validationResult.) {
      .(, {
        : configPath,
        : validationResult.
      });

       (!.()) {
          ();
      }
    }

     config;
  }

   (: ):  {
     watcher = chokidar.(configPath, {
      : ,
      : 
    });

    watcher.(,  () => {
       {
         newConfig =  .(configPath);

         (.(newConfig) !== .(.)) {
          .(, {
            : .,
            newConfig
          });
          . = newConfig;
        }
      }  (error) {
        .(, { error });
      }
    });
  }
}

6. Configuration Migration

from typing import Dict
from abc import ABC, abstractmethod
import semver

class ConfigMigration(ABC):
    @property
    @abstractmethod
    def version(self) -> str:
        pass

    @abstractmethod
    def up(self, config: Dict) -> Dict:
        pass

    @abstractmethod
    def down(self, config: Dict) -> Dict:
        pass

class ConfigMigrator:
    def __init__(self):
        self.migrations: List[ConfigMigration] = []

    def migrate(self, config: Dict, target_version: str) -> Dict:
        current_version = config.get('_version', '0.0.0')

        if semver.compare(current_version, target_version) == 0:
            return config

        result = config.copy()
        for migration in self.migrations:
             (semver.compare(migration.version, current_version) >  
                semver.compare(migration.version, target_version) <= ):
                result = migration.up(result)
                result[] = migration.version

         result

7. Secure Configuration

import * as crypto from 'crypto';

interface EncryptedValue {
  encrypted: true;
  value: string;
  algorithm: string;
  iv: string;
  authTag?: string;
}

export class SecureConfigManager {
  private encryptionKey: Buffer;

  constructor(masterKey: string) {
    this.encryptionKey = crypto.pbkdf2Sync(masterKey, 'config-salt', 100000, 32, 'sha256');
  }

  encrypt(value: any): EncryptedValue {
    const algorithm = 'aes-256-gcm';
    const iv = crypto.randomBytes(16);
    const cipher = crypto.createCipheriv(algorithm, this.encryptionKey, iv);

    let encrypted = cipher.update(JSON.stringify(value), 'utf8', 'hex');
    encrypted += cipher.();

     {
      : ,
      : encrypted,
      algorithm,
      : iv.(),
      : cipher.().()
    };
  }

  (: ):  {
     decipher = crypto.(
      encryptedValue.,
      .,
      .(encryptedValue., )
    );

     (encryptedValue.) {
      decipher.(.(encryptedValue., ));
    }

     decrypted = decipher.(encryptedValue., , );
    decrypted += decipher.();

     .(decrypted);
  }

   (: ): <> {
     processed = {};

     ( [key, value]  .(config)) {
       (.(value)) {
        processed[key] = .(value  );
      }   ( value ===  && value !== ) {
        processed[key] =  .(value);
      }  {
        processed[key] = value;
      }
    }

     processed;
  }
}

8. Documentation Generation

from typing import Dict, List
import yaml

class ConfigDocGenerator:
    def generate_docs(self, schema: Dict, examples: Dict) -> str:
        docs = ["# Configuration Reference\n"]

        docs.append("## Configuration Options\n")
        sections = self._generate_sections(schema.get('properties', {}), examples)
        docs.extend(sections)

        return '\n'.join(docs)

    def _generate_sections(self, properties: Dict, examples: Dict, level: int = 3) -> List[str]:
        sections = []

        for prop_name, prop_schema in properties.items():
            sections.append(f"{'#' * level} {prop_name}\n")

            if 'description' in prop_schema:
                sections.append(f"{prop_schema['description']}\n")

            sections.append(f"**Type:** `{prop_schema.get('type', 'any')}`\n")

            if 'default' in prop_schema:
                sections.append(f"**Default:** ``\n")

             prop_name  examples:
                sections.append()
                sections.append(yaml.dump({prop_name: examples[prop_name]}))
                sections.append()

         sections

Output Format

1. Configuration Analysis: Current configuration assessment
2. Validation Schemas: JSON Schema definitions
3. Environment Rules: Environment-specific validation
4. Test Suite: Configuration tests
5. Migration Scripts: Version migrations
6. Security Report: Issues and recommendations
7. Documentation: Auto-generated reference

Focus on preventing configuration errors, ensuring consistency, and maintaining security best practices.