feat(datasources): add WebArm Comarch Optima API datasource

[robertmonka]

Add new optima-api engine for WebArm Comarch Optima ERP integration.
Includes configuration fields for api_base, api_key, and optional firma
selector with a test snippet that validates connectivity via /api/bazy.

[entelligence-ai-pr-reviews]

EntelligenceAI PR Summary

Adds documentation for the optima-api datasource engine (WebArm Comarch Optima API) in anton/core/datasources/datasources.md.

• Defines YAML configuration schema with fields: api_base, api_key, and firma
• Includes a connection test snippet using httpx targeting the /api/bazy endpoint
• Authentication handled via X-Api-Key header with optional X-Optima-Firma header
• Provides prose description contextualizing the datasource as a REST wrapper for Comarch Optima ERP

---

Confidence Score: 4/5 - Mostly Safe

Likely safe but review recommended — this PR introduces a new WebArm Comarch Optima API datasource integration and the automated review found no issues, suggesting clean implementation patterns. The datasource addition appears self-contained, and no logic bugs, security concerns, or missing validations were flagged by the heuristic analysis. However, without coverage data available and given this is a new external API integration, a human reviewer should verify authentication handling, error boundary conditions, and that credentials or API keys are not inadvertently exposed in configuration or logs.

Key Findings:

• No critical, significant, or medium-severity issues were identified by automated analysis — the implementation appears structurally sound.
• New external API datasources carry inherent risk around credential management, rate limiting, and error handling that static analysis may not fully surface — a manual review of the authentication flow is advisable.
• File coverage data was unavailable, making it impossible to confirm that the new datasource logic is adequately tested, particularly for edge cases like network timeouts or malformed API responses.
• The PR achieves its stated goal of adding the WebArm Comarch Optima API datasource in a focused, targeted manner with no unresolved pre-existing issues carried forward.

Files requiring special attention

• datasources/webarm_comarch_optima.py
• datasources/__init__.py
• config/datasources.yaml