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

Aether Feature Catalog

172 capabilities across 14 categories.

Status: in active development — release-candidate series toward GA. Not yet production-ready.

Integration-verified Exercised in multi-node integration tests with failure injection (node kills, partitions, leader failovers) Implemented unit-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 isolationImplementedPer-slice classloader prevents dependency conflicts between slices
Schema migration engineImplementedV/R/U/B migration types, consensus-coordinated, deployment-gated, auto-retry with backoff
Multi-blueprint lifecycleImplementedBlueprint-scoped artifact ownership, exclusivity enforcement, owner-filtered deletion
Compile-time serdeImplemented@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 enforcementImplementedHard floor across auto-scaler, manual API, and rolling updates
Manual scale APIImplementedPOST /api/scale with blueprint membership guard
TTM predictive scalingPartialONNX model inference, 11-metric feature vector, 2-hour window. Not connected to live training
Dynamic aspectsImplementedRuntime 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 balancerImplementedCluster-aware LB node with smart routing, automatic failover
QUIC transportImplementedQUIC-based cluster transport. Stream-per-message-type multiplexing, mandatory TLS 1.3
HTTP/3 serverImplementedHTTP/3 (QUIC-based) alongside HTTP/1.1 and HTTP/2

Messaging & Streaming

FeatureStatusDescription
Pub-sub deliveryIntegration-verifiedCross-node fan-out, competing consumers, leader failover validated in tests
In-memory streamingImplementedOffHeapRingBuffer, partitioning, consumer groups, cursor checkpointing, dead-letter
Streaming governor failoverImplementedWatermarkTracker, GovernorFailoverHandler with AHSE catch-up
Cross-tier stream readsImplementedTieredStreamReader with segment prefetch from AHSE
Retention enforcementImplementedSegment retention policies with consumer cursor persistence

Scheduled Invocation

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

Security & Resilience

FeatureStatusDescription
Inter-node mTLSImplementedMutual TLS for all node-to-node TCP. HKDF-derived from cluster secret, no external PKI
SWIM gossip encryptionImplementedAES-256-GCM encryption with zero-downtime key rotation
RBAC per-route securityImplementedADMIN/OPERATOR/VIEWER roles with per-endpoint enforcement. SHA-256 API keys
Operational audit trailImplemented7 event types with cluster-wide aggregation
TLS default for containersImplementedAutomatic 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)ImplementedContent-addressed blocks, SHA-256, memory/disk/S3 tiers, per-consumer policies. 93 tests
KV-Store durable backupImplementedTOML serialization to local git repo with versioning and optional remote push
Hybrid logical clockImplemented48-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 metricsImplementedPer-method P50/P95/P99, slow invocation detection
Unified observabilityImplementedSampling-based tracing + adaptive per-node sampling + SLF4J bridge
Cluster event aggregatorImplementedRing buffer (1000 events), 11 event types, REST API, WebSocket feed
Dynamic log levelsImplementedRuntime per-logger adjustment via KV-Store

Resource Provisioning

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

Cloud Integration

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

Management

FeatureStatusDescription
REST management APIIntegration-verified60+ endpoints across 13 route classes
Interactive CLIImplementedBatch and REPL modes. 60+ commands across 14 groups
WebSocket streamsImplementedDashboard 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 managementImplementedTOML-based config, 12-step bootstrap orchestrator, CLI commands

Developer Tooling

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

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