PhoenixFlight
  • GitHub
  • Dynamic Membership Architecture (DMA) for Distributed Runtimes

    Short Answer

    Dynamic Membership Architecture (DMA) is a decentralized design pattern that addresses agent node addition and deletion (churn) without service disruption. Using virtual-node consistent hashing and dynamic workload rebalancing, PhoenixFlight guarantees stability, capability matching, and low migration overhead across fluctuating compute resources.

    In classical distributed systems, membership remains static or is managed by a centralized coordination service (such as ZooKeeper or etcd). When virtual servers spin down or new databases register, the configuration updates across the registry. However, in agentic networks, participant churn is much higher: agents are spawned dynamically to handle a single query, run short-lived operations, or exit due to failure.

    PhoenixFlight's Dynamic Membership Architecture handles this volatility at the routing layer. It implements a decentralized control plane where participant state is managed using consistent hashing over virtual nodes. This design separates physical host resource management from logical agent membership.

    Virtual Nodes & Consistent Hashing

    To distribute tasks evenly and prevent hot-spotting, DMA maps each active agent (physical or container-based) to multiple virtual locations (v-nodes) on a logical 32-bit integer ring. When a task payload (FlightPacket) is routed, its required capabilities are hashed onto the same ring. The task is assigned to the nearest clockwise v-node. This guarantees that adding or removing a node only impacts a local subset of the ring, rather than forcing a full rehash of all workloads.

    Stability & Performance Metrics

    PhoenixFlight tracks system-wide balance indicators to maintain performance under churn:

    • Standard Deviation of Load: Verifies that tasks are evenly distributed among active participants.
    • Rebalancing Overhead Ratio: Tracks the ratio of migrated context packets compared to the total active tasks, aiming to keep it minimal during churn events.
    • Handoff Latency: Measures the time required to sign, serialize, transmit, and verify task states between nodes.

    Frequently Asked Questions

    1. What is membership churn in agent runtimes?
    Churn is the rate at which agent nodes register, fail, or exit the runtime cluster. In autonomous multi-agent systems, churn is frequent because agent workloads are ephemeral. PhoenixFlight is built to handle high churn without task failures.
    2. How is task context migrated during rebalancing?
    When an agent node exits the cluster, the scheduler identifies the new primary v-node clockwise on the ring. The task context (FlightPacket) is securely migrated to the new node, which restores state and resumes execution.
    3. Does DMA require a central database?
    No. While PhoenixFlight supports centralized configuration hubs for enterprise ease-of-use, the DMA routing engine is designed to operate in a decentralized, peer-to-peer peer group, allowing local runtime instances to coordinate state through direct gRPC/HTTP endpoints.

    Citation & Archival Records

    PhoenixFlight is connected to two Zenodo archival records: the Dynamic Membership Architecture research paper and the PhoenixFlight software artifact.

    Research Paper

    Dynamic Membership Architecture Paper

    Research manuscript describing the DMA framework and Phoenix Computing Model lineage. Formalizes the six primitives across Phoenix, Kubernetes, and agentic AI paradigms.

    DOI: 10.5281/zenodo.20693483
    Software Artifact

    PhoenixFlight Software Artifact

    Runnable MVP implementation archived from the GitHub release. Includes CLI, REST API, PhoenixFile runtime, and 95 passing tests.

    DOI: 10.5281/zenodo.20778458