Changelog¶
All notable changes to HermesX are documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[Unreleased]¶
No unreleased changes.
[2.0.0] - 2026-05-08¶
Major release: complete rebrand from Hermes to HermesX, combined with enterprise hardening Phase 1.
Added¶
- ExecutionReceipt API: auditable tool invocation records with idempotency deduplication and trace correlation
POST /v1/execution-receipts— create receipt viaDispatchWithReceipt()GET /v1/execution-receipts— list with pagination and filters (auditor role)GET /v1/execution-receipts/{id}— get by ID (auditor role)- Prometheus business metrics: 11+ custom metrics covering HTTP requests, LLM completions, tool executions, rate limiting, and store operations
- MiniMaxi Anthropic API mode: Anthropic API-compatible mode via MiniMaxi provider, including stress test validation
auditorRBAC role: read-only access to audit logs and execution receipts- Full OpenAPI specification: 22 documented endpoints with schemas, tags, and security schemes, available at
GET /v1/openapi - Production Docker compose:
docker-compose.prod.ymlwith PostgreSQL 16, Redis 7 (AOF + LRU), MinIO, OTel Collector, and Jaeger - Enterprise demo script: 11-step
./examples/enterprise-saas-demo/demo.shwalkthrough - Backup/restore scripts:
scripts/backup/backup.sh(pg_dump + gzip, 7-day retention) andscripts/backup/restore.sh(single-transaction restore)
Changed¶
- Project name: Hermes → HermesX — independent enterprise agent platform
- Binary name:
hermes→hermesx - Entry point:
cmd/hermes/→cmd/hermesx/ - GitHub repository:
https://github.com/Colin4k1024/hermesx.git - All internal references: package imports, variable names, comments, log messages, and environment variables updated from
hermes/HERMEStohermesx/HERMESX - Configuration files:
docker-compose.yml,.env.example, and CI workflow files updated - Documentation: all docs reflect HermesX branding and v2.0.0 version
Fixed¶
- CI RLS pool URL replacement: corrected credential substitution for
hermesx_testin CI environment (was failing lint and integration tests) - API key tenant boundary: tenant derivation is now strictly from credential context; body-supplied
tenant_idonly honored for admin role callers generateRawKey()hardening: explicit panic oncrypto/rand.Readfailure (previously silently returned partial key)
Refactored¶
- Complete codebase rebrand: hermes → hermesx across all source files, test files, configs, and scripts
Docs¶
- ARCHITECTURE.md: system architecture overview with component diagram and data flows
- SECURITY_MODEL.md: threat model, authentication chain, RLS, and sandbox isolation
- RBAC_MATRIX.md: 5 roles × 10 resources permission matrix
- ENTERPRISE_READINESS.md: Phase 1 enterprise readiness assessment — 12 capability areas with evidence
- STRESS_TEST_REPORT.md: MiniMaxi Anthropic API mode stress test results
- Expanded DEPLOYMENT.md: environment variable reference, Prometheus metrics table, backup/restore procedures, horizontal scaling guidelines, security hardening checklist, and rollback strategy