hungry-ghost-hive 0.45.0 → 0.46.0

package/dist/cluster/events.js

@@ -56,6 +56,13 @@ export function ensureClusterTables(db, nodeId) {
       merged_at TEXT NOT NULL
     )
   `);
+    // Add snapshot_version_vector column if it doesn't exist yet (backward-compat migration)
+    try {
+        run(db, 'ALTER TABLE cluster_state ADD COLUMN snapshot_version_vector TEXT');
+    }
+    catch {
+        // Column already exists — ignore
+    }
     const state = queryOne(db, 'SELECT id FROM cluster_state WHERE id = 1');
     const now = new Date().toISOString();
     if (!state) {
@@ -77,6 +84,45 @@ export function getVersionVector(db) {
     }
     return vector;
 }
+/**
+ * Returns the snapshot version vector stored after the last snapshot-based recovery.
+ * Empty object if no snapshot has been applied.
+ */
+export function getSnapshotVersionVector(db) {
+    const row = queryOne(db, 'SELECT snapshot_version_vector FROM cluster_state WHERE id = 1');
+    if (!row?.snapshot_version_vector)
+        return {};
+    try {
+        return JSON.parse(row.snapshot_version_vector);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Persists the snapshot version vector so that future delta requests start
+ * from this point rather than from the (empty) event log.
+ */
+export function setSnapshotVersionVector(db, vector) {
+    run(db, 'UPDATE cluster_state SET snapshot_version_vector = ? WHERE id = 1', [
+        JSON.stringify(vector),
+    ]);
+}
+/**
+ * Returns the effective version vector for delta-sync requests.
+ * Takes the max per actor between the event-log-derived vector and any
+ * snapshot vector stored from a previous snapshot-based recovery.
+ * This prevents re-requesting events that were already covered by a snapshot.
+ */
+export function getEffectiveVersionVector(db) {
+    const eventVector = getVersionVector(db);
+    const snapshotVector = getSnapshotVersionVector(db);
+    const effective = { ...snapshotVector };
+    for (const [actor, counter] of Object.entries(eventVector)) {
+        effective[actor] = Math.max(effective[actor] ?? 0, counter);
+    }
+    return effective;
+}
 export function getAllClusterEvents(db) {
     const rows = queryAll(db, `
     SELECT event_id, actor_id, actor_counter, logical_ts, table_name, row_id, op, payload, created_at
@@ -122,6 +168,34 @@ export function emitLocalEvent(db, nodeId, input) {
       logical_ts = excluded.logical_ts
   `, [input.table_name, input.row_id, nodeId, nextCounter, logicalTs]);
 }
+/**
+ * Prune old cluster_events rows, retaining only the most recent `retainCount` events.
+ * Returns the number of rows deleted.
+ */
+export function pruneClusterEvents(db, retainCount) {
+    if (retainCount <= 0)
+        return 0;
+    const countRow = queryOne(db, 'SELECT COUNT(*) as total FROM cluster_events');
+    const total = countRow?.total || 0;
+    if (total <= retainCount)
+        return 0;
+    // Delete events that are not in the most recent `retainCount` by logical_ts ordering.
+    // We keep the newest events and delete the oldest.
+    run(db, `
+    DELETE FROM cluster_events
+    WHERE event_id NOT IN (
+      SELECT event_id FROM cluster_events
+      ORDER BY logical_ts DESC, actor_id DESC, actor_counter DESC
+      LIMIT ?
+    )
+  `, [retainCount]);
+    const afterRow = queryOne(db, 'SELECT COUNT(*) as total FROM cluster_events');
+    return total - (afterRow?.total || 0);
+}
+export function getClusterEventCount(db) {
+    const row = queryOne(db, 'SELECT COUNT(*) as total FROM cluster_events');
+    return row?.total || 0;
+}
 export function fetchTableSnapshots(db, adapter) {
     const rows = queryAll(db, adapter.selectSql);
     return rows.map(row => {

package/dist/cluster/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/cluster/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/cluster/events.ts"],"names":[],"mappings":"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"}

package/dist/cluster/heartbeat-manager.d.ts

@@ -3,12 +3,14 @@ import type { RaftStateMachine } from './raft-state-machine.js';
 interface HeartbeatResponse {
     term: number;
     success: boolean;
+    fencing_token: number;
 }
 export interface HeartbeatManagerDeps {
     raft: RaftStateMachine;
     postJson: <T>(peer: ClusterPeerConfig, path: string, body: unknown) => Promise<T | null>;
     isActive: () => boolean;
     handleBackgroundError: (error: unknown) => void;
+    onPeersUpdated?: (peers: ClusterPeerConfig[]) => void;
 }
 export declare class HeartbeatManager {
     private readonly config;

package/dist/cluster/heartbeat-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat-manager.d.ts","sourceRoot":"","sources":["../../src/cluster/heartbeat-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAOhE,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzF,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,qBAAqB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD;AAED,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,OAAO,CAAC,cAAc,CAA+B;gBAGlC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,oBAAoB;IAG7C,kBAAkB,IAAI,IAAI;IAQ1B,iBAAiB,IAAI,IAAI;IAOnB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCrC,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB;CAiClD"}
+{"version":3,"file":"heartbeat-manager.d.ts","sourceRoot":"","sources":["../../src/cluster/heartbeat-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAShE,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACzF,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,qBAAqB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,IAAI,CAAC;CACvD;AAED,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,OAAO,CAAC,cAAc,CAA+B;gBAGlC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,oBAAoB;IAG7C,kBAAkB,IAAI,IAAI;IAQ1B,iBAAiB,IAAI,IAAI;IAOnB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAuCrC,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,iBAAiB;CAqDlD"}

package/dist/cluster/heartbeat-manager.js

@@ -26,21 +26,27 @@ export class HeartbeatManager {
         if (!this.deps.isActive())
             return;
         const { raft } = this.deps;
+        const peers = raft.getPeers();
         const heartbeat = {
             term: raft.currentTerm,
             leader_id: this.config.node_id,
+            fencing_token: raft.getFencingToken(),
+            peers: peers.map(p => ({ id: p.id, url: p.url })),
         };
         raft.appendDurableEntry('heartbeat_sent', {
             term: raft.currentTerm,
             leader_id: this.config.node_id,
-            peer_count: this.config.peers.filter(peer => peer.id !== this.config.node_id).length,
+            peer_count: peers.filter(peer => peer.id !== this.config.node_id).length,
         });
-        await Promise.all(this.config.peers
+        await Promise.all(peers
             .filter(peer => peer.id !== this.config.node_id)
             .map(async (peer) => {
             const response = await this.deps.postJson(peer, '/cluster/v1/election/heartbeat', heartbeat);
-            if (response && response.term > raft.currentTerm) {
-                raft.stepDown(response.term, peer.id);
+            if (response) {
+                const remoteTerm = Math.max(response.term, response.fencing_token ?? 0);
+                if (remoteTerm > raft.currentTerm) {
+                    raft.stepDown(remoteTerm, peer.id);
+                }
             }
         }));
     }
@@ -49,8 +55,14 @@ export class HeartbeatManager {
         const request = body;
         const term = Number(request.term || 0);
         const leaderId = typeof request.leader_id === 'string' ? request.leader_id : null;
+        const fencingToken = Number(request.fencing_token ?? term);
+        // Reject heartbeats from stale leaders
         if (term < raft.currentTerm) {
-            return { term: raft.currentTerm, success: false };
+            return { term: raft.currentTerm, success: false, fencing_token: raft.getFencingToken() };
+        }
+        // Reject if fencing token doesn't match the heartbeat term
+        if (fencingToken < term) {
+            return { term: raft.currentTerm, success: false, fencing_token: raft.getFencingToken() };
         }
         const changed = term > raft.currentTerm || leaderId !== raft.leaderId || raft.role !== 'follower';
         if (term > raft.currentTerm) {
@@ -61,14 +73,38 @@ export class HeartbeatManager {
             raft.leaderId = leaderId;
             raft.persistRaftState();
         }
+        // Update lease: record that we received a valid heartbeat now
+        raft.lastHeartbeatReceivedAt = Date.now();
         raft.resetElectionDeadline();
+        // Apply peer list from leader if present
+        const requestPeers = request.peers;
+        if (Array.isArray(requestPeers)) {
+            const parsed = parsePeerList(requestPeers);
+            if (parsed.length > 0) {
+                raft.setPeers(parsed);
+                this.deps.onPeersUpdated?.(parsed);
+            }
+        }
         if (changed) {
             raft.appendDurableEntry('heartbeat_received', {
                 term,
                 leader_id: leaderId,
+                fencing_token: fencingToken,
             });
         }
-        return { term: raft.currentTerm, success: true };
+        return { term: raft.currentTerm, success: true, fencing_token: raft.getFencingToken() };
+    }
+}
+function parsePeerList(input) {
+    const peers = [];
+    for (const item of input) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const p = item;
+        if (typeof p.id === 'string' && typeof p.url === 'string') {
+            peers.push({ id: p.id, url: p.url });
+        }
     }
+    return peers;
 }
 //# sourceMappingURL=heartbeat-manager.js.map

package/dist/cluster/heartbeat-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat-manager.js","sourceRoot":"","sources":["../../src/cluster/heartbeat-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"heartbeat-manager.js","sourceRoot":"","sources":["../../src/cluster/heartbeat-manager.ts"],"names":[],"mappings":"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"}

package/dist/cluster/membership.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=membership.test.d.ts.map

package/dist/cluster/membership.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"membership.test.d.ts","sourceRoot":"","sources":["../../src/cluster/membership.test.ts"],"names":[],"mappings":""}

package/dist/cluster/membership.test.js

@@ -0,0 +1,416 @@
+// Licensed under the Hungry Ghost Hive License. See LICENSE.
+import { mkdirSync, mkdtempSync, rmSync } from 'fs';
+import { createServer as createNetServer } from 'net';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { ClusterRuntime } from './runtime.js';
+const tempRoots = [];
+const activeRuntimes = [];
+afterEach(async () => {
+    for (const runtime of activeRuntimes.splice(0)) {
+        try {
+            await runtime.stop();
+        }
+        catch {
+            // Best effort shutdown for test cleanup.
+        }
+    }
+    for (const root of tempRoots.splice(0)) {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+describe('dynamic membership join', () => {
+    it('leader accepts join request and adds peer to cluster', async () => {
+        if (!(await canListenOnLocalhost()))
+            return;
+        const fixture = await startRuntimeFixture({
+            node_id: 'leader-join',
+            election_timeout_min_ms: 80,
+            election_timeout_max_ms: 120,
+            heartbeat_interval_ms: 60,
+        });
+        await waitFor(() => fixture.runtime.getStatus().is_leader, 4000);
+        const res = await postJson(fixture.config.public_url, '/cluster/v1/membership/join', {
+            node_id: 'new-node',
+            url: 'http://127.0.0.1:9999',
+        });
+        expect(res.success).toBe(true);
+        expect(res.leader_id).toBe('leader-join');
+        expect(res.peers).toContainEqual({ id: 'new-node', url: 'http://127.0.0.1:9999' });
+        const status = fixture.runtime.getStatus();
+        expect(status.peers).toContainEqual({ id: 'new-node', url: 'http://127.0.0.1:9999' });
+    });
+    it('follower redirects join request to leader', async () => {
+        if (!(await canListenOnLocalhost()))
+            return;
+        const fixture = await startRuntimeFixture({
+            node_id: 'follower-join',
+            election_timeout_min_ms: 5000,
+            election_timeout_max_ms: 5000,
+            peers: [{ id: 'remote-leader', url: 'http://127.0.0.1:9998' }],
+        });
+        // Set the node as follower with a known leader
+        await postJson(fixture.config.public_url, '/cluster/v1/election/heartbeat', {
+            term: 3,
+            leader_id: 'remote-leader',
+            fencing_token: 3,
+        });
+        const res = await fetch(`${fixture.config.public_url}/cluster/v1/membership/join`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ node_id: 'joiner', url: 'http://127.0.0.1:9997' }),
+        });
+        expect(res.status).toBe(307);
+        const body = (await res.json());
+        expect(body.success).toBe(false);
+        expect(body.leader_id).toBe('remote-leader');
+        expect(body.leader_url).toBe('http://127.0.0.1:9998');
+    });
+    it('rejects join request with missing fields', async () => {
+        if (!(await canListenOnLocalhost()))
+            return;
+        const fixture = await startRuntimeFixture({ node_id: 'leader-join-bad' });
+        const res = await fetch(`${fixture.config.public_url}/cluster/v1/membership/join`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ node_id: 'missing-url' }),
+        });
+        expect(res.status).toBe(400);
+    });
+    it('updates url for existing peer on re-join', async () => {
+        if (!(await canListenOnLocalhost()))
+            return;
+        const fixture = await startRuntimeFixture({
+            node_id: 'leader-rejoin',
+            election_timeout_min_ms: 80,
+            election_timeout_max_ms: 120,
+            heartbeat_interval_ms: 60,
+        });
+        await waitFor(() => fixture.runtime.getStatus().is_leader, 4000);
+        // First add the peer
+        await postJson(fixture.config.public_url, '/cluster/v1/membership/join', {
+            node_id: 'existing-peer',
+            url: 'http://127.0.0.1:8000',
+        });
+        // Re-join with different URL
+        const res = await postJson(fixture.config.public_url, '/cluster/v1/membership/join', {
+            node_id: 'existing-peer',
+            url: 'http://127.0.0.1:9000',
+        });
+        expect(res.success).toBe(true);
+        expect(res.peers).toContainEqual({ id: 'existing-peer', url: 'http://127.0.0.1:9000' });
+    });
+    it('idempotent join with same url returns success', async () => {
+        if (!(await canListenOnLocalhost()))
+            return;
+        const fixture = await startRuntimeFixture({
+            node_id: 'leader-idem',
+            election_timeout_min_ms: 80,
+            election_timeout_max_ms: 120,
+            heartbeat_interval_ms: 60,
+        });
+        await waitFor(() => fixture.runtime.getStatus().is_leader, 4000);
+        // Add peer first
+        await postJson(fixture.config.public_url, '/cluster/v1/membership/join', {
+            node_id: 'peer-x',
+            url: 'http://127.0.0.1:7777',
+        });
+        // Join again with same details — idempotent
+        const res = await postJson(fixture.config.public_url, '/cluster/v1/membership/join', {
+            node_id: 'peer-x',
+            url: 'http://127.0.0.1:7777',
+        });
+        expect(res.success).toBe(true);
+    });
+});
+describe('dynamic membership leave', () => {
+    it('leader removes peer on leave request', async () => {
+        if (!(await canListenOnLocalhost()))
+            return;
+        const fixture = await startRuntimeFixture({
+            node_id: 'leader-leave',
+            election_timeout_min_ms: 80,
+            election_timeout_max_ms: 120,
+            heartbeat_interval_ms: 60,
+        });
+        await waitFor(() => fixture.runtime.getStatus().is_leader, 4000);
+        // Add peer first, then remove it
+        await postJson(fixture.config.public_url, '/cluster/v1/membership/join', {
+            node_id: 'departing-node',
+            url: 'http://127.0.0.1:8888',
+        });
+        const res = await postJson(fixture.config.public_url, '/cluster/v1/membership/leave', {
+            node_id: 'departing-node',
+        });
+        expect(res.success).toBe(true);
+        expect(res.peers).not.toContainEqual(expect.objectContaining({ id: 'departing-node' }));
+        const status = fixture.runtime.getStatus();
+        expect(status.peers.find(p => p.id === 'departing-node')).toBeUndefined();
+    });
+    it('follower rejects leave request', async () => {
+        if (!(await canListenOnLocalhost()))
+            return;
+        const fixture = await startRuntimeFixture({
+            node_id: 'follower-leave',
+            election_timeout_min_ms: 5000,
+            election_timeout_max_ms: 5000,
+        });
+        const res = await fetch(`${fixture.config.public_url}/cluster/v1/membership/leave`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ node_id: 'some-node' }),
+        });
+        expect(res.status).toBe(400);
+        const body = (await res.json());
+        expect(body.success).toBe(false);
+    });
+    it('leader cannot remove itself', async () => {
+        if (!(await canListenOnLocalhost()))
+            return;
+        const fixture = await startRuntimeFixture({
+            node_id: 'leader-self-leave',
+            election_timeout_min_ms: 80,
+            election_timeout_max_ms: 120,
+            heartbeat_interval_ms: 60,
+        });
+        await waitFor(() => fixture.runtime.getStatus().is_leader, 4000);
+        const res = await fetch(`${fixture.config.public_url}/cluster/v1/membership/leave`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ node_id: 'leader-self-leave' }),
+        });
+        expect(res.status).toBe(400);
+    });
+    it('leave for unknown node is a no-op success', async () => {
+        if (!(await canListenOnLocalhost()))
+            return;
+        const fixture = await startRuntimeFixture({
+            node_id: 'leader-unknown-leave',
+            election_timeout_min_ms: 80,
+            election_timeout_max_ms: 120,
+            heartbeat_interval_ms: 60,
+        });
+        await waitFor(() => fixture.runtime.getStatus().is_leader, 4000);
+        const res = await postJson(fixture.config.public_url, '/cluster/v1/membership/leave', {
+            node_id: 'ghost-node',
+        });
+        expect(res.success).toBe(true);
+    });
+    it('rejects leave request with missing node_id', async () => {
+        if (!(await canListenOnLocalhost()))
+            return;
+        const fixture = await startRuntimeFixture({ node_id: 'leader-leave-bad' });
+        const res = await fetch(`${fixture.config.public_url}/cluster/v1/membership/leave`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({}),
+        });
+        expect(res.status).toBe(400);
+    });
+});
+describe('peer list propagation via heartbeat', () => {
+    it('leader propagates updated peer list to followers', async () => {
+        if (!(await canListenOnLocalhost()))
+            return;
+        const portLeader = await getFreePort();
+        const portFollower = await getFreePort();
+        const leaderConfig = await buildConfig({
+            node_id: 'leader-prop',
+            listen_port: portLeader,
+            public_url: `http://127.0.0.1:${portLeader}`,
+            peers: [{ id: 'follower-prop', url: `http://127.0.0.1:${portFollower}` }],
+            election_timeout_min_ms: 80,
+            election_timeout_max_ms: 120,
+            heartbeat_interval_ms: 60,
+        });
+        const followerConfig = await buildConfig({
+            node_id: 'follower-prop',
+            listen_port: portFollower,
+            public_url: `http://127.0.0.1:${portFollower}`,
+            peers: [{ id: 'leader-prop', url: `http://127.0.0.1:${portLeader}` }],
+            election_timeout_min_ms: 5000,
+            election_timeout_max_ms: 5000,
+        });
+        const leaderFixture = await startRuntimeWithConfig(leaderConfig);
+        const followerFixture = await startRuntimeWithConfig(followerConfig);
+        // Wait for leader election
+        await waitFor(() => leaderFixture.runtime.getStatus().is_leader, 4000);
+        // Add a new peer via the leader
+        await postJson(leaderFixture.config.public_url, '/cluster/v1/membership/join', {
+            node_id: 'new-node-prop',
+            url: 'http://127.0.0.1:7777',
+        });
+        // Wait for heartbeat to propagate peer list to follower
+        await waitFor(() => {
+            const peers = followerFixture.runtime.getStatus().peers;
+            return peers.some(p => p.id === 'new-node-prop');
+        }, 4000);
+        const followerPeers = followerFixture.runtime.getStatus().peers;
+        expect(followerPeers).toContainEqual({ id: 'new-node-prop', url: 'http://127.0.0.1:7777' });
+    });
+    it('follower applies peer list from heartbeat', async () => {
+        if (!(await canListenOnLocalhost()))
+            return;
+        const fixture = await startRuntimeFixture({
+            node_id: 'follower-apply',
+            election_timeout_min_ms: 5000,
+            election_timeout_max_ms: 5000,
+        });
+        // Send heartbeat with peer list
+        await postJson(fixture.config.public_url, '/cluster/v1/election/heartbeat', {
+            term: 5,
+            leader_id: 'external-leader',
+            fencing_token: 5,
+            peers: [
+                { id: 'external-leader', url: 'http://127.0.0.1:6000' },
+                { id: 'follower-apply', url: fixture.config.public_url },
+                { id: 'peer-z', url: 'http://127.0.0.1:6001' },
+            ],
+        });
+        const status = fixture.runtime.getStatus();
+        expect(status.peers).toHaveLength(3);
+        expect(status.peers).toContainEqual({ id: 'peer-z', url: 'http://127.0.0.1:6001' });
+    });
+});
+describe('quorum recalculation after membership change', () => {
+    it('quorum adjusts after adding a peer', async () => {
+        if (!(await canListenOnLocalhost()))
+            return;
+        // Start as a single node (quorum = 1)
+        const fixture = await startRuntimeFixture({
+            node_id: 'quorum-node',
+            election_timeout_min_ms: 80,
+            election_timeout_max_ms: 120,
+            heartbeat_interval_ms: 60,
+        });
+        await waitFor(() => fixture.runtime.getStatus().is_leader, 4000);
+        // Single node: quorum = 1
+        // Add two peers: 3 nodes total, quorum = 2
+        await postJson(fixture.config.public_url, '/cluster/v1/membership/join', {
+            node_id: 'peer-1',
+            url: 'http://127.0.0.1:9001',
+        });
+        await postJson(fixture.config.public_url, '/cluster/v1/membership/join', {
+            node_id: 'peer-2',
+            url: 'http://127.0.0.1:9002',
+        });
+        const status = fixture.runtime.getStatus();
+        expect(status.peers).toHaveLength(2);
+        // The node should still be functional with updated peer list
+        expect(status.is_leader).toBe(true);
+    });
+});
+// --- Test helpers ---
+async function startRuntimeFixture(overrides = {}) {
+    const attempts = overrides.listen_port ? 1 : 5;
+    let lastError;
+    for (let i = 0; i < attempts; i++) {
+        const config = await buildConfig(overrides);
+        try {
+            return await startRuntimeWithConfig(config);
+        }
+        catch (error) {
+            lastError = error;
+            const err = error;
+            if (!overrides.listen_port && err.code === 'EADDRINUSE') {
+                continue;
+            }
+            throw error;
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error('Failed to start runtime fixture');
+}
+async function startRuntimeWithConfig(config) {
+    const root = mkdtempSync(join(tmpdir(), `hive-membership-${config.node_id}-`));
+    const hiveDir = join(root, '.hive');
+    mkdirSync(hiveDir, { recursive: true });
+    const runtime = new ClusterRuntime(config, { hiveDir });
+    try {
+        await runtime.start();
+        activeRuntimes.push(runtime);
+        tempRoots.push(root);
+        return { root, hiveDir, config, runtime };
+    }
+    catch (error) {
+        try {
+            await runtime.stop();
+        }
+        catch {
+            // Best effort cleanup for partial starts.
+        }
+        rmSync(root, { recursive: true, force: true });
+        throw error;
+    }
+}
+async function buildConfig(overrides = {}) {
+    const port = overrides.listen_port ?? (await getFreePort());
+    const base = {
+        enabled: true,
+        node_id: 'node-test',
+        listen_host: '127.0.0.1',
+        listen_port: port,
+        public_url: `http://127.0.0.1:${port}`,
+        peers: [],
+        heartbeat_interval_ms: 100,
+        election_timeout_min_ms: 150,
+        election_timeout_max_ms: 250,
+        sync_interval_ms: 200,
+        request_timeout_ms: 600,
+        story_similarity_threshold: 0.8,
+    };
+    return {
+        ...base,
+        ...overrides,
+        public_url: overrides.public_url || base.public_url,
+        peers: overrides.peers || base.peers,
+    };
+}
+async function postJson(baseUrl, path, body) {
+    const res = await fetch(`${baseUrl}${path}`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    return (await res.json());
+}
+async function waitFor(predicate, timeoutMs) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        if (predicate())
+            return;
+        await new Promise(resolve => setTimeout(resolve, 25));
+    }
+    throw new Error('Timed out waiting for condition');
+}
+async function getFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = createNetServer();
+        server.once('error', reject);
+        server.listen(0, '127.0.0.1', () => {
+            const address = server.address();
+            if (!address || typeof address === 'string') {
+                server.close(() => reject(new Error('Failed to allocate free port')));
+                return;
+            }
+            const port = address.port;
+            server.close(err => {
+                if (err) {
+                    reject(err);
+                    return;
+                }
+                resolve(port);
+            });
+        });
+    });
+}
+async function canListenOnLocalhost() {
+    try {
+        await getFreePort();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=membership.test.js.map