This repository contains essential scripts and configurations for maintaining the integrity and operational efficiency of enterprise-grade systems. The primary tool within this repository is platform-validator.ps1, a PowerShell script designed for comprehensive platform validation, patching, and healing.
platform-validator.ps1 is a robust PowerShell script that ensures the health and stability of the platform by performing various operations based on the specified mode. It is designed to be run in environments requiring high reliability and adherence to enterprise standards.
./platform-validator.ps1 -Mode <ModeName>- validate: Performs a comprehensive validation of Python files within the repository. It compiles Python scripts to identify syntax errors and reports them without making any modifications.
- patch: Identifies Python FastAPI applications that lack health and readiness endpoints (
/health,/ready) and automatically injects them. This ensures that services are properly discoverable and manageable within a microservices architecture. - heal: Quarantines malformed Python files by moving them to a designated quarantine directory. It also ensures the presence of critical directory structures (
services,services/agents,services/memory,.github,.github/workflows) and creates them if they are missing. - full: Executes all operations: validation, patching, and healing, in a sequential manner to provide a complete system health check and remediation.
The script includes error handling mechanisms to log issues and continue execution where possible. Malformed Python files are quarantined to prevent them from affecting the system, and detailed reports are generated for review.
This repository utilizes Pester for unit testing PowerShell scripts. A comprehensive test suite is located in the tests/ directory, ensuring high code coverage and reliability.
To run the Pester tests, navigate to the repository root and execute:
Invoke-Pester -Path ./testsContributions are welcome. Please ensure that all changes adhere to the established coding standards and are accompanied by appropriate tests and documentation updates.
MIT License (Placeholder - actual license file may vary)