@arcanea/council 0.1.0

package/dist/consensus/gossip.js

@@ -0,0 +1,378 @@
+/**
+ * V3 Gossip Protocol Consensus
+ * Eventually consistent consensus for large-scale distributed systems
+ */
+import { EventEmitter } from 'events';
+import { SWARM_CONSTANTS, } from '../types.js';
+export class GossipConsensus extends EventEmitter {
+    config;
+    node;
+    nodes = new Map();
+    proposals = new Map();
+    messageQueue = [];
+    gossipInterval;
+    proposalCounter = 0;
+    constructor(nodeId, config = {}) {
+        super();
+        this.config = {
+            threshold: config.threshold ?? SWARM_CONSTANTS.DEFAULT_CONSENSUS_THRESHOLD,
+            timeoutMs: config.timeoutMs ?? SWARM_CONSTANTS.DEFAULT_CONSENSUS_TIMEOUT_MS,
+            maxRounds: config.maxRounds ?? 10,
+            requireQuorum: config.requireQuorum ?? false, // Gossip is eventually consistent
+            fanout: config.fanout ?? 3,
+            gossipIntervalMs: config.gossipIntervalMs ?? 100,
+            maxHops: config.maxHops ?? 10,
+            convergenceThreshold: config.convergenceThreshold ?? 0.9,
+        };
+        this.node = {
+            id: nodeId,
+            state: new Map(),
+            version: 0,
+            neighbors: new Set(),
+            seenMessages: new Set(),
+            lastSync: new Date(),
+        };
+    }
+    async initialize() {
+        this.startGossipLoop();
+        this.emit('initialized', { nodeId: this.node.id });
+    }
+    async shutdown() {
+        if (this.gossipInterval) {
+            clearInterval(this.gossipInterval);
+        }
+        this.emit('shutdown');
+    }
+    addNode(nodeId) {
+        this.nodes.set(nodeId, {
+            id: nodeId,
+            state: new Map(),
+            version: 0,
+            neighbors: new Set(),
+            seenMessages: new Set(),
+            lastSync: new Date(),
+        });
+        // Add as neighbor with some probability (random mesh)
+        if (Math.random() < 0.5) {
+            this.node.neighbors.add(nodeId);
+            this.nodes.get(nodeId).neighbors.add(this.node.id);
+        }
+    }
+    removeNode(nodeId) {
+        this.nodes.delete(nodeId);
+        this.node.neighbors.delete(nodeId);
+        for (const node of this.nodes.values()) {
+            node.neighbors.delete(nodeId);
+        }
+    }
+    addNeighbor(nodeId) {
+        if (this.nodes.has(nodeId)) {
+            this.node.neighbors.add(nodeId);
+        }
+    }
+    removeNeighbor(nodeId) {
+        this.node.neighbors.delete(nodeId);
+    }
+    async propose(value) {
+        this.proposalCounter++;
+        const proposalId = `gossip_${this.node.id}_${this.proposalCounter}`;
+        const proposal = {
+            id: proposalId,
+            proposerId: this.node.id,
+            value,
+            term: this.node.version,
+            timestamp: new Date(),
+            votes: new Map(),
+            status: 'pending',
+        };
+        this.proposals.set(proposalId, proposal);
+        // Self-vote
+        proposal.votes.set(this.node.id, {
+            voterId: this.node.id,
+            approve: true,
+            confidence: 1.0,
+            timestamp: new Date(),
+        });
+        // Create gossip message
+        const message = {
+            id: `msg_${proposalId}`,
+            type: 'proposal',
+            senderId: this.node.id,
+            version: ++this.node.version,
+            payload: { proposalId, value },
+            timestamp: new Date(),
+            ttl: this.config.maxHops ?? 10,
+            hops: 0,
+            path: [this.node.id],
+        };
+        // Queue for gossip
+        this.queueMessage(message);
+        return proposal;
+    }
+    async vote(proposalId, vote) {
+        const proposal = this.proposals.get(proposalId);
+        if (!proposal) {
+            return;
+        }
+        proposal.votes.set(vote.voterId, vote);
+        // Create vote gossip message
+        const message = {
+            id: `vote_${proposalId}_${vote.voterId}`,
+            type: 'vote',
+            senderId: this.node.id,
+            version: ++this.node.version,
+            payload: { proposalId, vote },
+            timestamp: new Date(),
+            ttl: this.config.maxHops ?? 10,
+            hops: 0,
+            path: [this.node.id],
+        };
+        this.queueMessage(message);
+        // Check convergence
+        await this.checkConvergence(proposalId);
+    }
+    async awaitConsensus(proposalId) {
+        const startTime = Date.now();
+        const maxWait = this.config.timeoutMs ?? 30000;
+        return new Promise((resolve, reject) => {
+            const checkInterval = setInterval(() => {
+                const proposal = this.proposals.get(proposalId);
+                if (!proposal) {
+                    clearInterval(checkInterval);
+                    reject(new Error(`Proposal ${proposalId} not found`));
+                    return;
+                }
+                if (proposal.status !== 'pending') {
+                    clearInterval(checkInterval);
+                    resolve(this.createResult(proposal, Date.now() - startTime));
+                    return;
+                }
+                // Check convergence
+                this.checkConvergence(proposalId);
+                if (Date.now() - startTime > maxWait) {
+                    clearInterval(checkInterval);
+                    // Gossip is eventually consistent, so mark as accepted if threshold met
+                    const totalNodes = this.nodes.size + 1;
+                    const votes = proposal.votes.size;
+                    const threshold = this.config.convergenceThreshold ?? 0.9;
+                    if (votes / totalNodes >= threshold) {
+                        proposal.status = 'accepted';
+                    }
+                    else {
+                        proposal.status = 'expired';
+                    }
+                    resolve(this.createResult(proposal, Date.now() - startTime));
+                }
+            }, 50);
+        });
+    }
+    // ===== GOSSIP PROTOCOL =====
+    startGossipLoop() {
+        this.gossipInterval = setInterval(() => {
+            this.gossipRound();
+        }, this.config.gossipIntervalMs ?? 100);
+    }
+    async gossipRound() {
+        if (this.messageQueue.length === 0) {
+            return;
+        }
+        // Select random neighbors (fanout)
+        const fanout = Math.min(this.config.fanout ?? 3, this.node.neighbors.size);
+        const neighbors = this.selectRandomNeighbors(fanout);
+        // Send queued messages to selected neighbors
+        const messages = this.messageQueue.splice(0, 10); // Process up to 10 per round
+        for (const message of messages) {
+            for (const neighborId of neighbors) {
+                await this.sendToNeighbor(neighborId, message);
+            }
+        }
+        this.node.lastSync = new Date();
+    }
+    selectRandomNeighbors(count) {
+        const neighbors = Array.from(this.node.neighbors);
+        const selected = [];
+        while (selected.length < count && neighbors.length > 0) {
+            const idx = Math.floor(Math.random() * neighbors.length);
+            selected.push(neighbors.splice(idx, 1)[0]);
+        }
+        return selected;
+    }
+    async sendToNeighbor(neighborId, message) {
+        const neighbor = this.nodes.get(neighborId);
+        if (!neighbor) {
+            return;
+        }
+        // Check if already seen
+        if (neighbor.seenMessages.has(message.id)) {
+            return;
+        }
+        // Deliver message to neighbor node
+        const deliveredMessage = {
+            ...message,
+            hops: message.hops + 1,
+            path: [...message.path, neighborId],
+        };
+        // Process at neighbor
+        await this.processReceivedMessage(neighbor, deliveredMessage);
+        this.emit('message.sent', { to: neighborId, message: deliveredMessage });
+    }
+    async processReceivedMessage(node, message) {
+        // Mark as seen
+        node.seenMessages.add(message.id);
+        // Check TTL
+        if (message.ttl <= 0 || message.hops >= (this.config.maxHops ?? 10)) {
+            return;
+        }
+        switch (message.type) {
+            case 'proposal':
+                await this.handleProposalMessage(node, message);
+                break;
+            case 'vote':
+                await this.handleVoteMessage(node, message);
+                break;
+            case 'state':
+                await this.handleStateMessage(node, message);
+                break;
+        }
+        // Propagate to neighbors (gossip)
+        if (message.hops < (this.config.maxHops ?? 10)) {
+            const propagateMessage = {
+                ...message,
+                ttl: message.ttl - 1,
+            };
+            // Add to queue if this is our node
+            if (node.id === this.node.id) {
+                this.queueMessage(propagateMessage);
+            }
+        }
+    }
+    async handleProposalMessage(node, message) {
+        const { proposalId, value } = message.payload;
+        if (!this.proposals.has(proposalId)) {
+            const proposal = {
+                id: proposalId,
+                proposerId: message.senderId,
+                value,
+                term: message.version,
+                timestamp: message.timestamp,
+                votes: new Map(),
+                status: 'pending',
+            };
+            this.proposals.set(proposalId, proposal);
+            // Auto-vote (simplified)
+            if (node.id === this.node.id) {
+                await this.vote(proposalId, {
+                    voterId: this.node.id,
+                    approve: true,
+                    confidence: 0.9,
+                    timestamp: new Date(),
+                });
+            }
+        }
+    }
+    async handleVoteMessage(node, message) {
+        const { proposalId, vote } = message.payload;
+        const proposal = this.proposals.get(proposalId);
+        if (proposal && !proposal.votes.has(vote.voterId)) {
+            proposal.votes.set(vote.voterId, vote);
+            await this.checkConvergence(proposalId);
+        }
+    }
+    async handleStateMessage(node, message) {
+        const state = message.payload;
+        // Merge state (last-writer-wins)
+        if (message.version > node.version) {
+            for (const [key, value] of Object.entries(state)) {
+                node.state.set(key, value);
+            }
+            node.version = message.version;
+        }
+    }
+    queueMessage(message) {
+        // Avoid duplicates
+        if (!this.node.seenMessages.has(message.id)) {
+            this.node.seenMessages.add(message.id);
+            this.messageQueue.push(message);
+        }
+    }
+    async checkConvergence(proposalId) {
+        const proposal = this.proposals.get(proposalId);
+        if (!proposal || proposal.status !== 'pending') {
+            return;
+        }
+        const totalNodes = this.nodes.size + 1;
+        const votes = proposal.votes.size;
+        const threshold = this.config.convergenceThreshold ?? 0.9;
+        const approvalThreshold = this.config.threshold ?? 0.66;
+        // Check if we've converged (enough nodes have voted)
+        if (votes / totalNodes >= threshold) {
+            const approvingVotes = Array.from(proposal.votes.values()).filter(v => v.approve).length;
+            if (approvingVotes / votes >= approvalThreshold) {
+                proposal.status = 'accepted';
+                this.emit('consensus.achieved', { proposalId, approved: true });
+            }
+            else {
+                proposal.status = 'rejected';
+                this.emit('consensus.achieved', { proposalId, approved: false });
+            }
+        }
+    }
+    createResult(proposal, durationMs) {
+        const totalNodes = this.nodes.size + 1;
+        const approvingVotes = Array.from(proposal.votes.values()).filter(v => v.approve).length;
+        return {
+            proposalId: proposal.id,
+            approved: proposal.status === 'accepted',
+            approvalRate: proposal.votes.size > 0
+                ? approvingVotes / proposal.votes.size
+                : 0,
+            participationRate: proposal.votes.size / totalNodes,
+            finalValue: proposal.value,
+            rounds: this.node.version,
+            durationMs,
+        };
+    }
+    // ===== STATE QUERIES =====
+    getConvergence(proposalId) {
+        const proposal = this.proposals.get(proposalId);
+        if (!proposal)
+            return 0;
+        const totalNodes = this.nodes.size + 1;
+        return proposal.votes.size / totalNodes;
+    }
+    getVersion() {
+        return this.node.version;
+    }
+    getNeighborCount() {
+        return this.node.neighbors.size;
+    }
+    getSeenMessageCount() {
+        return this.node.seenMessages.size;
+    }
+    getQueueDepth() {
+        return this.messageQueue.length;
+    }
+    // Anti-entropy: sync full state with a random neighbor
+    async antiEntropy() {
+        if (this.node.neighbors.size === 0)
+            return;
+        const neighbors = Array.from(this.node.neighbors);
+        const randomNeighbor = neighbors[Math.floor(Math.random() * neighbors.length)];
+        const stateMessage = {
+            id: `state_${this.node.id}_${Date.now()}`,
+            type: 'state',
+            senderId: this.node.id,
+            version: this.node.version,
+            payload: Object.fromEntries(this.node.state),
+            timestamp: new Date(),
+            ttl: 1,
+            hops: 0,
+            path: [this.node.id],
+        };
+        await this.sendToNeighbor(randomNeighbor, stateMessage);
+    }
+}
+export function createGossipConsensus(nodeId, config) {
+    return new GossipConsensus(nodeId, config);
+}
+//# sourceMappingURL=gossip.js.map

package/dist/consensus/gossip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gossip.js","sourceRoot":"","sources":["../../src/consensus/gossip.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAKL,eAAe,GAChB,MAAM,aAAa,CAAC;AA8BrB,MAAM,OAAO,eAAgB,SAAQ,YAAY;IACvC,MAAM,CAAe;IACrB,IAAI,CAAa;IACjB,KAAK,GAA4B,IAAI,GAAG,EAAE,CAAC;IAC3C,SAAS,GAAmC,IAAI,GAAG,EAAE,CAAC;IACtD,YAAY,GAAoB,EAAE,CAAC;IACnC,cAAc,CAAkB;IAChC,eAAe,GAAW,CAAC,CAAC;IAEpC,YAAY,MAAc,EAAE,SAAuB,EAAE;QACnD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG;YACZ,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,eAAe,CAAC,2BAA2B;YAC1E,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,eAAe,CAAC,4BAA4B;YAC3E,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;YACjC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,KAAK,EAAE,kCAAkC;YAChF,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC;YAC1B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,GAAG;YAChD,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;YAC7B,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,IAAI,GAAG;SACzD,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG;YACV,EAAE,EAAE,MAAM;YACV,KAAK,EAAE,IAAI,GAAG,EAAE;YAChB,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,IAAI,GAAG,EAAE;YACpB,YAAY,EAAE,IAAI,GAAG,EAAE;YACvB,QAAQ,EAAE,IAAI,IAAI,EAAE;SACrB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,MAAc;QACpB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE;YACrB,EAAE,EAAE,MAAM;YACV,KAAK,EAAE,IAAI,GAAG,EAAE;YAChB,OAAO,EAAE,CAAC;YACV,SAAS,EAAE,IAAI,GAAG,EAAE;YACpB,YAAY,EAAE,IAAI,GAAG,EAAE;YACvB,QAAQ,EAAE,IAAI,IAAI,EAAE;SACrB,CAAC,CAAC;QAEH,sDAAsD;QACtD,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,UAAU,CAAC,MAAc;QACvB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,WAAW,CAAC,MAAc;QACxB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,cAAc,CAAC,MAAc;QAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAc;QAC1B,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QAEpE,MAAM,QAAQ,GAAsB;YAClC,EAAE,EAAE,UAAU;YACd,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YACxB,KAAK;YACL,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;YACvB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,KAAK,EAAE,IAAI,GAAG,EAAE;YAChB,MAAM,EAAE,SAAS;SAClB,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAEzC,YAAY;QACZ,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;YAC/B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YACrB,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC,CAAC;QAEH,wBAAwB;QACxB,MAAM,OAAO,GAAkB;YAC7B,EAAE,EAAE,OAAO,UAAU,EAAE;YACvB,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YACtB,OAAO,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;YAC5B,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE;YAC9B,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE;YAC9B,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SACrB,CAAC;QAEF,mBAAmB;QACnB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAE3B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,IAAmB;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAEvC,6BAA6B;QAC7B,MAAM,OAAO,GAAkB;YAC7B,EAAE,EAAE,QAAQ,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE;YACxC,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YACtB,OAAO,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;YAC5B,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;YAC7B,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE;YAC9B,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SACrB,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QAE3B,oBAAoB;QACpB,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAAkB;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,KAAK,CAAC;QAE/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE;gBACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,aAAa,CAAC,aAAa,CAAC,CAAC;oBAC7B,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,UAAU,YAAY,CAAC,CAAC,CAAC;oBACtD,OAAO;gBACT,CAAC;gBAED,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAClC,aAAa,CAAC,aAAa,CAAC,CAAC;oBAC7B,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;oBAC7D,OAAO;gBACT,CAAC;gBAED,oBAAoB;gBACpB,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;gBAElC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,CAAC;oBACrC,aAAa,CAAC,aAAa,CAAC,CAAC;oBAC7B,wEAAwE;oBACxE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;oBACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;oBAClC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,IAAI,GAAG,CAAC;oBAE1D,IAAI,KAAK,GAAG,UAAU,IAAI,SAAS,EAAE,CAAC;wBACpC,QAAQ,CAAC,MAAM,GAAG,UAAU,CAAC;oBAC/B,CAAC;yBAAM,CAAC;wBACN,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC;oBAC9B,CAAC;oBAED,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC,EAAE,EAAE,CAAC,CAAC;QACT,CAAC,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B;IAEtB,eAAe;QACrB,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;YACrC,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,GAAG,CAAC,CAAC;IAC1C,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QAED,mCAAmC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CACrB,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,EACvB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CACzB,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAErD,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,6BAA6B;QAE/E,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,KAAK,MAAM,UAAU,IAAI,SAAS,EAAE,CAAC;gBACnC,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;IAClC,CAAC;IAEO,qBAAqB,CAAC,KAAa;QACzC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,OAAO,QAAQ,CAAC,MAAM,GAAG,KAAK,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;YACzD,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,UAAkB,EAAE,OAAsB;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,wBAAwB;QACxB,IAAI,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,mCAAmC;QACnC,MAAM,gBAAgB,GAAkB;YACtC,GAAG,OAAO;YACV,IAAI,EAAE,OAAO,CAAC,IAAI,GAAG,CAAC;YACtB,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC;SACpC,CAAC;QAEF,sBAAsB;QACtB,MAAM,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAE9D,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC3E,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAClC,IAAgB,EAChB,OAAsB;QAEtB,eAAe;QACf,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAElC,YAAY;QACZ,IAAI,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;YACpE,OAAO;QACT,CAAC;QAED,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,UAAU;gBACb,MAAM,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAChD,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC5C,MAAM;YACR,KAAK,OAAO;gBACV,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC7C,MAAM;QACV,CAAC;QAED,kCAAkC;QAClC,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;YAC/C,MAAM,gBAAgB,GAAkB;gBACtC,GAAG,OAAO;gBACV,GAAG,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC;aACrB,CAAC;YAEF,mCAAmC;YACnC,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBAC7B,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,qBAAqB,CACjC,IAAgB,EAChB,OAAsB;QAEtB,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,OAGrC,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAsB;gBAClC,EAAE,EAAE,UAAU;gBACd,UAAU,EAAE,OAAO,CAAC,QAAQ;gBAC5B,KAAK;gBACL,IAAI,EAAE,OAAO,CAAC,OAAO;gBACrB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,KAAK,EAAE,IAAI,GAAG,EAAE;gBAChB,MAAM,EAAE,SAAS;aAClB,CAAC;YAEF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAEzC,yBAAyB;YACzB,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBAC7B,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;oBAC1B,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;oBACrB,OAAO,EAAE,IAAI;oBACb,UAAU,EAAE,GAAG;oBACf,SAAS,EAAE,IAAI,IAAI,EAAE;iBACtB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,IAAgB,EAChB,OAAsB;QAEtB,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,OAGpC,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAClD,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACvC,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAC9B,IAAgB,EAChB,OAAsB;QAEtB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAkC,CAAC;QAEzD,iCAAiC;QACjC,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC7B,CAAC;YACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,OAAsB;QACzC,mBAAmB;QACnB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,UAAkB;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,IAAI,GAAG,CAAC;QAC1D,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;QAExD,qDAAqD;QACrD,IAAI,KAAK,GAAG,UAAU,IAAI,SAAS,EAAE,CAAC;YACpC,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC/D,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CACf,CAAC,MAAM,CAAC;YAET,IAAI,cAAc,GAAG,KAAK,IAAI,iBAAiB,EAAE,CAAC;gBAChD,QAAQ,CAAC,MAAM,GAAG,UAAU,CAAC;gBAC7B,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,MAAM,GAAG,UAAU,CAAC;gBAC7B,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,QAA2B,EAAE,UAAkB;QAClE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACvC,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC/D,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CACf,CAAC,MAAM,CAAC;QAET,OAAO;YACL,UAAU,EAAE,QAAQ,CAAC,EAAE;YACvB,QAAQ,EAAE,QAAQ,CAAC,MAAM,KAAK,UAAU;YACxC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC;gBACnC,CAAC,CAAC,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI;gBACtC,CAAC,CAAC,CAAC;YACL,iBAAiB,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU;YACnD,UAAU,EAAE,QAAQ,CAAC,KAAK;YAC1B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;YACzB,UAAU;SACX,CAAC;IACJ,CAAC;IAED,4BAA4B;IAE5B,cAAc,CAAC,UAAkB;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC;QAExB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACvC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC;IAC1C,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IAC3B,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAClC,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;IACrC,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,WAAW;QACf,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE3C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QAE/E,MAAM,YAAY,GAAkB;YAClC,EAAE,EAAE,SAAS,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;YACzC,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YACtB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;YAC1B,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAC5C,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,GAAG,EAAE,CAAC;YACN,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SACrB,CAAC;QAEF,MAAM,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;IAC1D,CAAC;CACF;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAc,EACd,MAAqB;IAErB,OAAO,IAAI,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC"}

package/dist/consensus/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @arcanea/council — Council Engine Factory
+ *
+ * Creates the appropriate consensus engine based on the selected Council Protocol.
+ * Maps Arcanea's Council terminology to the underlying consensus implementations:
+ *
+ *   council-vote     → Raft (leader election, log replication)
+ *   shinkamis-decree → Byzantine BFT (fault-tolerant under hostile agents)
+ *   whisper          → Gossip (eventual consistency via propagation)
+ *   gate-quorum      → Arcanea-native frequency-weighted Guardian voting
+ *   ancient-accord   → Paxos (falls back to Raft — same lineage)
+ */
+import { EventEmitter } from 'node:events';
+import type { CouncilProtocol, CouncilConfig, Petition, Seal, CouncilResult, ICouncilEngine } from '../types.js';
+import type { GuardianName, Element } from '../external-types.js';
+import { type ByzantineConfig } from './byzantine.js';
+import { type RaftConfig } from './raft.js';
+import { type GossipConfig } from './gossip.js';
+import { type GateQuorumOptions } from './gate-quorum.js';
+export interface CouncilEngineOptions {
+    protocol: CouncilProtocol;
+    nodeId: string;
+    byzantine?: ByzantineConfig;
+    raft?: RaftConfig;
+    gossip?: GossipConfig;
+    gateQuorum?: GateQuorumOptions;
+}
+/**
+ * Unified Council Engine that wraps the selected consensus protocol.
+ * Provides a consistent ICouncilEngine interface regardless of the
+ * underlying algorithm. Adapts between ported claude-flow field names
+ * and Arcanea's Council terminology at the boundary.
+ */
+export declare class CouncilEngine extends EventEmitter implements ICouncilEngine {
+    private protocol;
+    private engine;
+    private usesLegacyFields;
+    private addNodeFn;
+    private removeNodeFn;
+    constructor(options: CouncilEngineOptions);
+    initialize(config?: CouncilConfig): Promise<void>;
+    shutdown(): Promise<void>;
+    addNode(nodeId: string, options?: {
+        isPrimary?: boolean;
+        guardian?: GuardianName;
+    }): void;
+    removeNode(nodeId: string): void;
+    propose(value: unknown): Promise<Petition>;
+    vote(petitionId: string, seal: Seal): Promise<void>;
+    awaitConsensus(petitionId: string): Promise<CouncilResult>;
+    getProtocol(): CouncilProtocol;
+}
+export declare function selectCouncilProtocol(element?: Element): CouncilProtocol;
+export declare function createCouncilEngine(options: CouncilEngineOptions): CouncilEngine;
+export { ByzantineConsensus, type ByzantineConfig } from './byzantine.js';
+export { RaftConsensus, type RaftConfig } from './raft.js';
+export { GossipConsensus, type GossipConfig } from './gossip.js';
+export { GateQuorumConsensus, type GateQuorumOptions } from './gate-quorum.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/consensus/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/consensus/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,QAAQ,EACR,IAAI,EACJ,aAAa,EAIb,cAAc,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AA2E/E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IAGf,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,YAAa,YAAW,cAAc;IACvE,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,SAAS,CAA8D;IAC/E,OAAO,CAAC,YAAY,CAA2B;gBAEnC,OAAO,EAAE,oBAAoB;IAwDnC,UAAU,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAK/B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI;IAIzF,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI1B,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAK1C,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAKhE,WAAW,IAAI,eAAe;CAG/B;AAwBD,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,eAAe,CAGxE;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAEhF;AAGD,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/consensus/index.js

@@ -0,0 +1,193 @@
+/**
+ * @arcanea/council — Council Engine Factory
+ *
+ * Creates the appropriate consensus engine based on the selected Council Protocol.
+ * Maps Arcanea's Council terminology to the underlying consensus implementations:
+ *
+ *   council-vote     → Raft (leader election, log replication)
+ *   shinkamis-decree → Byzantine BFT (fault-tolerant under hostile agents)
+ *   whisper          → Gossip (eventual consistency via propagation)
+ *   gate-quorum      → Arcanea-native frequency-weighted Guardian voting
+ *   ancient-accord   → Paxos (falls back to Raft — same lineage)
+ */
+import { EventEmitter } from 'node:events';
+import { ByzantineConsensus } from './byzantine.js';
+import { RaftConsensus } from './raft.js';
+import { GossipConsensus } from './gossip.js';
+import { GateQuorumConsensus } from './gate-quorum.js';
+/** Adapt a ConsensusProposal (old fields) to a Petition (Arcanea fields) */
+function toPetition(cp) {
+    return {
+        id: cp.id,
+        petitionerId: cp.proposerId,
+        value: cp.value,
+        term: cp.term,
+        timestamp: cp.timestamp,
+        seals: adaptVotesToSeals(cp.votes),
+        status: cp.status,
+    };
+}
+/** Adapt a votes Map<string, ConsensusVote> to seals Map<string, Seal> */
+function adaptVotesToSeals(votes) {
+    const seals = new Map();
+    for (const [key, vote] of votes) {
+        seals.set(key, {
+            guardianId: vote.voterId,
+            approve: vote.approve,
+            confidence: vote.confidence,
+            timestamp: vote.timestamp,
+            reason: vote.reason,
+        });
+    }
+    return seals;
+}
+/** Adapt a Seal (Arcanea) to ConsensusVote (old) for ported engines */
+function toConsensusVote(seal) {
+    return {
+        voterId: seal.guardianId,
+        approve: seal.approve,
+        confidence: seal.confidence,
+        timestamp: seal.timestamp,
+        reason: seal.reason,
+    };
+}
+/** Adapt a ConsensusResult (old) to CouncilResult (Arcanea) */
+function toCouncilResult(cr) {
+    return {
+        petitionId: cr.proposalId,
+        approved: cr.approved,
+        approvalRate: cr.approvalRate,
+        participationRate: cr.participationRate,
+        finalValue: cr.finalValue,
+        rounds: cr.rounds,
+        durationMs: cr.durationMs,
+    };
+}
+/**
+ * Unified Council Engine that wraps the selected consensus protocol.
+ * Provides a consistent ICouncilEngine interface regardless of the
+ * underlying algorithm. Adapts between ported claude-flow field names
+ * and Arcanea's Council terminology at the boundary.
+ */
+export class CouncilEngine extends EventEmitter {
+    protocol;
+    engine;
+    usesLegacyFields;
+    addNodeFn;
+    removeNodeFn;
+    constructor(options) {
+        super();
+        this.protocol = options.protocol;
+        this.usesLegacyFields = options.protocol !== 'gate-quorum';
+        switch (options.protocol) {
+            case 'shinkamis-decree': {
+                const byz = new ByzantineConsensus(options.nodeId, options.byzantine);
+                this.engine = byz;
+                this.addNodeFn = (id, opts) => byz.addNode(id, opts?.isPrimary ?? false);
+                this.removeNodeFn = (id) => byz.removeNode(id);
+                break;
+            }
+            case 'council-vote':
+            case 'ancient-accord': {
+                const raft = new RaftConsensus(options.nodeId, options.raft);
+                this.engine = raft;
+                this.addNodeFn = (id) => raft.addPeer(id);
+                this.removeNodeFn = (id) => raft.removePeer(id);
+                break;
+            }
+            case 'whisper': {
+                const gossip = new GossipConsensus(options.nodeId, options.gossip);
+                this.engine = gossip;
+                this.addNodeFn = (id) => gossip.addNode(id);
+                this.removeNodeFn = (id) => gossip.removeNode(id);
+                break;
+            }
+            case 'gate-quorum': {
+                const gq = new GateQuorumConsensus(options.nodeId, options.gateQuorum);
+                this.engine = gq;
+                this.addNodeFn = (id, opts) => gq.addNode(id, opts);
+                this.removeNodeFn = (id) => gq.removeNode(id);
+                break;
+            }
+            default: {
+                const fallback = new RaftConsensus(options.nodeId);
+                this.engine = fallback;
+                this.usesLegacyFields = true;
+                this.addNodeFn = (id) => fallback.addPeer(id);
+                this.removeNodeFn = (id) => fallback.removePeer(id);
+            }
+        }
+        // Forward all events from the underlying engine
+        const originalEmit = this.engine.emit.bind(this.engine);
+        this.engine.emit = (event, ...args) => {
+            this.emit(event, ...args);
+            return originalEmit(event, ...args);
+        };
+    }
+    async initialize(config) {
+        await this.engine.initialize(config);
+        this.emit('council.initialized', { protocol: this.protocol });
+    }
+    async shutdown() {
+        await this.engine.shutdown();
+        this.emit('council.shutdown', { protocol: this.protocol });
+    }
+    addNode(nodeId, options) {
+        this.addNodeFn(nodeId, options);
+    }
+    removeNode(nodeId) {
+        this.removeNodeFn(nodeId);
+    }
+    async propose(value) {
+        const result = await this.engine.propose(value);
+        return this.usesLegacyFields ? toPetition(result) : result;
+    }
+    async vote(petitionId, seal) {
+        if (this.usesLegacyFields) {
+            return this.engine.vote(petitionId, toConsensusVote(seal));
+        }
+        return this.engine.vote(petitionId, seal);
+    }
+    async awaitConsensus(petitionId) {
+        const result = await this.engine.awaitConsensus(petitionId);
+        return this.usesLegacyFields ? toCouncilResult(result) : result;
+    }
+    getProtocol() {
+        return this.protocol;
+    }
+}
+// ── Protocol Selection ─────────────────────────────────────────
+/**
+ * Element-based protocol routing.
+ * Each element has a natural affinity for a Council Protocol:
+ *
+ *   earth → council-vote (Raft) — stable leadership
+ *   fire  → shinkamis-decree (Byzantine) — adversarial resilience
+ *   water → whisper (Gossip) — fluid propagation
+ *   wind  → gate-quorum — dynamic, frequency-driven
+ *   void  → shinkamis-decree — fault tolerance in the unknown
+ *   spirit → gate-quorum — transcendent, weighted by consciousness
+ */
+const ELEMENT_PROTOCOL_MAP = {
+    earth: 'council-vote',
+    fire: 'shinkamis-decree',
+    water: 'whisper',
+    wind: 'gate-quorum',
+    void: 'shinkamis-decree',
+    spirit: 'gate-quorum',
+};
+export function selectCouncilProtocol(element) {
+    if (!element)
+        return 'gate-quorum'; // Arcanea's native protocol is the default
+    return ELEMENT_PROTOCOL_MAP[element] ?? 'gate-quorum';
+}
+// ── Factory ────────────────────────────────────────────────────
+export function createCouncilEngine(options) {
+    return new CouncilEngine(options);
+}
+// Re-export consensus implementations
+export { ByzantineConsensus } from './byzantine.js';
+export { RaftConsensus } from './raft.js';
+export { GossipConsensus } from './gossip.js';
+export { GateQuorumConsensus } from './gate-quorum.js';
+//# sourceMappingURL=index.js.map

package/dist/consensus/index.js.map

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