Getting Started Developer Guide Feature Catalog Operator Guide Reference
Docs/Feature Catalog

Aether Feature Catalog

173 capabilities across 14 categories.

Integration-verified Proven through multi-node integration tests with failure injection (node kills, partitions, leader failovers) Complete Production-ready, tested Partial Core implemented, gaps noted Planned Designed but not yet implemented Critical Requires significant effort

Deployment & Lifecycle

FeatureStatusDescription
Blueprint managementIntegration-verifiedDeclarative TOML-based deployment specs with dependency ordering, validation, and status tracking
Slice lifecycleIntegration-verifiedFull state machine: DOWNLOADING, LOADING, STARTING, ACTIVE, UNLOADING, FAILED. Per-node KV-Store tracking
Deployment strategiesIntegration-verifiedImmediate, canary (progressive traffic shift), blue-green (atomic switchover), rolling (weighted traffic), A/B testing
Auto-healingIntegration-verifiedBidirectional convergence with metadata-aware scheduling: spot-first, host-spread, zone-balanced provisioning
ClassLoader isolationCompletePer-slice classloader prevents dependency conflicts between slices
Schema migration engineCompleteV/R/U/B migration types, consensus-coordinated, deployment-gated, auto-retry with backoff
Multi-blueprint lifecycleCompleteBlueprint-scoped artifact ownership, exclusivity enforcement, owner-filtered deletion
Compile-time serdeComplete@Codec processor generates codec classes. Deterministic hash-based tags, VLQ encoding, zero reflection

Scaling & Control

FeatureStatusDescription
CPU-based auto-scalingIntegration-verifiedDecisionTreeController: CPU thresholds, 1-second evaluation intervals
minInstances enforcementCompleteHard floor across auto-scaler, manual API, and rolling updates
Manual scale APICompletePOST /api/scale with blueprint membership guard
TTM predictive scalingPartialONNX model inference, 11-metric feature vector, 2-hour window. Not connected to live training
Dynamic aspectsCompleteRuntime method-level instrumentation via KV-Store. CLI and API control

Cluster & Consensus

FeatureStatusDescription
Rabia consensusIntegration-verifiedLeaderless crash-fault tolerant consensus. Formal spec verification suite
Leader electionIntegration-verifiedZero-message deterministic election with instant re-election on departure
Quorum state managementIntegration-verifiedMonotonic-sequenced notifications, graceful degradation, automatic restoration
Topology managementIntegration-verifiedNode discovery, health tracking, grace period for departures
Distributed KV-StoreIntegration-verifiedConsensus-replicated with 12+ typed key categories

Networking & Routing

FeatureStatusDescription
Service-to-service invocationIntegration-verifiedSliceInvoker with HTTP routing, load balancer, timeout/retry, metrics
Version routingIntegration-verifiedTraffic splitting between versions during deployments
Passive load balancerCompleteCluster-aware LB node with smart routing, automatic failover
QUIC transportCompleteQUIC-based cluster transport. Stream-per-message-type multiplexing, mandatory TLS 1.3
HTTP/3 serverCompleteHTTP/3 (QUIC-based) alongside HTTP/1.1 and HTTP/2

Messaging & Streaming

FeatureStatusDescription
Pub-sub deliveryIntegration-verifiedCross-node fan-out, competing consumers, leader failover proven
In-memory streamingCompleteOffHeapRingBuffer, partitioning, consumer groups, cursor checkpointing, dead-letter
Streaming governor failoverCompleteWatermarkTracker, GovernorFailoverHandler with AHSE catch-up
Cross-tier stream readsCompleteTieredStreamReader with segment prefetch from AHSE
Retention enforcementCompleteSegment retention policies with consumer cursor persistence

Scheduled Invocation

FeatureStatusDescription
Scheduled task registryCompleteKV-Store backed registry with change listener pattern and pause/resume support
Scheduled task managerCompleteSINGLE (leader-only) and ALL (every node) execution modes. Interval and cron scheduling
Cron expression parserComplete5-field cron syntax with ranges, steps, lists
Management APICompleteList, filter, pause, resume, manual trigger, execution state query. CLI support
Execution state trackingCompleteLast execution time, consecutive failures, total executions per task

Security & Resilience

FeatureStatusDescription
Inter-node mTLSCompleteMutual TLS for all node-to-node TCP. HKDF-derived from cluster secret, no external PKI
SWIM gossip encryptionCompleteAES-256-GCM encryption with zero-downtime key rotation
RBAC per-route securityCompleteADMIN/OPERATOR/VIEWER roles with per-endpoint enforcement. SHA-256 API keys
Operational audit trailComplete7 event types with cluster-wide aggregation
TLS default for containersCompleteAutomatic TLS enablement in containerized deployments

Storage & Data

FeatureStatusDescription
Artifact repositoryIntegration-verifiedMaven-compatible, chunked storage, checksum verification
Distributed hash tableIntegration-verifiedConsistent hash ring (150 vnodes, 1024 partitions), quorum R/W, anti-entropy repair
Hierarchical storage (AHSE)CompleteContent-addressed blocks, SHA-256, memory/disk/S3 tiers, per-consumer policies. 93 tests
KV-Store durable backupCompleteTOML serialization to local git repo with versioning and optional remote push
Hybrid logical clockComplete48-bit microseconds + 16-bit counter. Foundation for causal ordering

Observability

FeatureStatusDescription
System metricsIntegration-verifiedCPU, heap, event loop lag. 120-minute aggregation window
Cluster metrics APIIntegration-verifiedAggregated load, deployment timeline, error rates, health score
Prometheus exportIntegration-verifiedMicrometer integration with Prometheus scrape endpoint
Invocation metricsCompletePer-method P50/P95/P99, slow invocation detection
Unified observabilityCompleteSampling-based tracing + adaptive per-node sampling + SLF4J bridge
Cluster event aggregatorCompleteRing buffer (1000 events), 11 event types, REST API, WebSocket feed
Dynamic log levelsCompleteRuntime per-logger adjustment via KV-Store

Resource Provisioning

FeatureStatusDescription
SPI resource factoriesCompleteServiceLoader discovery, config-driven provisioning, type-safe qualifiers
Database resourcesCompleteJDBC, R2DBC, jOOQ, postgres-async with pipelining, LISTEN/NOTIFY
Aether StoreComplete@PgSql compile-time SQL validation, CRUD generation, 41-rule migration linter
HTTP clientCompleteConfigurable outbound HTTP with timeouts, retries, SSL/TLS, Jackson
InterceptorsCompleteRetry, circuit breaker, rate limit, logging, metrics. Runtime toggle
Config provisioningCompleteTyped config records, compile-time validation, runtime notification, 3-source merge
ContentStoreComplete@ContentStoreQualifier, ContentStoreFactory SPI

Cloud Integration

FeatureStatusDescription
Environment SPIComplete4 facets: compute, secrets, load balancer, discovery. ServiceLoader
Hetzner CloudCompleteCompute, discovery, load balancer. Label-based peer discovery
AWSCompleteEC2, ELBv2, Secrets Manager, ACM. SigV4 signing — no AWS SDK
GCPCompleteCompute Engine, NEGs, Secret Manager, Certificate Manager. RS256 JWT — no GCP SDK
AzureCompleteVMs, Load Balancers, Key Vault, Resource Graph. Dual OAuth2 — no Azure SDK
Cloud placementCompleteZone-aware provisioning, spot-first/host-spread/zone-balanced scheduling
Cloud certificatesCompleteACM, GCP CM, Azure KV via SecretsProvider SPI

Management

FeatureStatusDescription
REST management APIIntegration-verified60+ endpoints across 13 route classes
Interactive CLICompleteBatch and REPL modes. 60+ commands across 14 groups
WebSocket streamsCompleteDashboard metrics, cluster state, real-time events with delta broadcasting
E2E test frameworkIntegration-verifiedTestcontainers-based, bridge networking, partition/disconnect/reconnect
Forge simulatorIntegration-verifiedLoad generation, chaos injection, visual dashboard
Declarative cluster managementCompleteTOML-based config, 12-step bootstrap orchestrator, CLI commands

Developer Tooling

FeatureStatusDescription
Slice annotation processorCompleteCompile-time code generation: factories, manifests, routes, pub-sub wiring
JBCT complianceCompleteFormat linting, return type validation, pattern checking. Maven plugin
Topology graphCompleteCompile-time topology extraction, swim-lane SVG, search filtering
jbct add-sliceCompleteScaffolds slice into existing project with config, tests, routes
JBCT code formatterCompleteFlow-based deterministic formatter. Records, enums, switch expressions, text blocks, chain alignment
Property-based testingCompletePropertyTest, Arbitrary, Shrinkable, RandomSource

This is a curated subset. The full catalog contains 172 features. See feature-catalog.md for the complete list.