Skip to content

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 via DispatchWithReceipt()
  • 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
  • auditor RBAC 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.yml with PostgreSQL 16, Redis 7 (AOF + LRU), MinIO, OTel Collector, and Jaeger
  • Enterprise demo script: 11-step ./examples/enterprise-saas-demo/demo.sh walkthrough
  • Backup/restore scripts: scripts/backup/backup.sh (pg_dump + gzip, 7-day retention) and scripts/backup/restore.sh (single-transaction restore)

Changed

  • Project name: Hermes → HermesX — independent enterprise agent platform
  • Binary name: hermeshermesx
  • 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/HERMES to hermesx/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_test in CI environment (was failing lint and integration tests)
  • API key tenant boundary: tenant derivation is now strictly from credential context; body-supplied tenant_id only honored for admin role callers
  • generateRawKey() hardening: explicit panic on crypto/rand.Read failure (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