This commit introduces several improvements to ensure the API works seamlessly across Zabbix 6.0, 6.4, and 7.0+, while also optimizing data fetching performance.
Key changes:
- Zabbix Version Compatibility:
- Added Zabbix version detection and static caching in ZabbixAPI.
- Implemented name-based fallback for host/template group permissions to support Zabbix 6.0 (which lacks UUIDs for host groups).
- Added manual host group expansion for Zabbix versions < 6.2.0 during user group import.
- Added version-based guards for history.push (7.0+) and hostgroup.propagate (6.2+).
- Updated documentation with detailed version compatibility notes.
- Added src/test/zabbix_6_0_compatibility.test.ts to verify compatibility logic.
- Query Optimization:
- Implemented dynamic output selection in ZabbixRequest to fetch only fields requested in GraphQL queries.
- Added GraphqlParamsToNeededZabbixOutput to map GraphQL selections to Zabbix API output parameters.
- Moved "Query Optimization" to achieved milestones in roadmap.md.
- Other:
- Updated various tests to support the new version-aware logic.
- Optimized imports and synchronized IDE settings.
- **Optimization**: Implemented automatic Zabbix parameter optimization by analyzing GraphQL selection sets.
- **ZabbixRequest**: Added optimizeZabbixParams with support for skippable parameters and implied field dependencies (e.g., state -> items).
- **Resolvers**: Updated allHosts, allDevices, allHostGroups, and templates to pass requested fields to data sources.
- **Data Sources**: Optimized ZabbixQueryHostsGenericRequest and ZabbixQueryTemplatesRequest to skip unnecessary Zabbix API calls.
- **Regression Tests**: Enhanced RegressionTestExecutor with new tests for optimization (REG-OPT, REG-OPT-NEG), state retrieval (REG-STATE), dependent items (REG-DEP), and empty results (REG-EMPTY).
- **Documentation**: Created query_optimization.md How-To guide and updated roadmap.md, README.md, and tests.md.
- **Bug Fixes**: Fixed deviceType tag assignment during host import and corrected ZabbixCreateHostRequest to support tags.
This commit introduces several improvements to the project's documentation,
roadmap, and AI agent integration (MCP).
Key changes:
- Created and styled roadmap.md to track project milestones and future plans.
- Updated .junie/guidelines.md with strict documentation style standards.
- Automated GraphQL schema concatenation for the MCP server using a schema-gen init-container.
- Updated MCP setup recipes in cookbook.md and mcp.md to reflect the new automation.
- Added .ai/mcp/mcp.json for connecting to existing MCP services via HTTP.
- Improved development workflow by updating package.json to watch .graphql files.
- Cleaned up the root directory by moving schema.graphql to .gitignore and removing redundant files.
- Standardized visual style and formatting across all markdown files.
