Knowledge Transfer Ticket: Wazuh-agent-status App #48
Description
Description
This task documents the transfer of technical ownership and operational knowledge for the wazuh-agent-status application. The app is designed to:
- Monitor the health and operational status of the Wazuh Agent across Linux, macOS, and Windows.
- Handle automatic OTA (Over-the-Air) binary updates with minimal user interaction.
This issue provides a structured, multi-phase onboarding path including architecture review, platform validation, OTA mechanisms, CI/CD understanding, and feature enhancement tasks. The goal is to enable a new developer or operator to fully manage, troubleshoot, and extend the app independently.
Definition of Ready
- Architecture diagrams and codebase access are available
- All platform-specific binaries and scripts are available and executable
- Stakeholders are available for clarification and mentoring
- CI/CD pipeline and GitHub release strategies are documented
- Test environments with Wazuh Agent installed on Linux/macOS/Windows are available
Acceptance Criteria
- Ability to explain the overall app architecture and its core functionality
- Ability to install and validate the app on all three supported platforms
- Understanding of OTA update trigger and execution flow
- Completion of walkthrough tasks and enhancement assignments
- Delivery of platform-agnostic documentation for install/update
- Contribution to or review of at least one Pull Request
- Final deliverables submitted and reviewed
Tests
- Detect Wazuh agent status (running/stopped) correctly on all OS platforms
- Validate the app auto-starts on system reboot
- Trigger an OTA update and confirm binary replacement and service restart
- Run uninstall and install scripts to verify clean setup/teardown
- Observe expected output in CLI or systray when Wazuh agent is inactive