@arcanea/council 0.1.0

package/dist/consensus/gate-quorum.js

@@ -0,0 +1,280 @@
+/**
+ * @arcanea/council — Gate Quorum Consensus
+ *
+ * Arcanea-specific consensus protocol where the Ten Guardians vote
+ * with weights determined by their Gate frequency (174-1111 Hz).
+ *
+ * Higher-frequency Guardians have more voting weight:
+ *   Lyssandria (174 Hz) = 1.0x weight (broad acceptance, foundation)
+ *   Shinkami (1111 Hz)   = 6.38x weight (selective, source)
+ *
+ * Element affinity boosts votes from Guardians whose element matches the task.
+ * Shinkami can override any decision (Source authority).
+ */
+import { EventEmitter } from 'node:events';
+import { GUARDIANS, } from '../external-types.js';
+const BASE_FREQUENCY = 174; // Foundation Gate — lowest frequency
+export class GateQuorumConsensus extends EventEmitter {
+    config;
+    nodeId;
+    nodes = new Map();
+    proposals = new Map();
+    proposalVotes = new Map();
+    initialized = false;
+    constructor(nodeId, options = {}) {
+        super();
+        this.nodeId = nodeId;
+        this.config = {
+            quorumSize: options.quorumSize ?? 5,
+            weightByFrequency: options.weightByFrequency ?? true,
+            approvalThreshold: options.approvalThreshold ?? 0.6,
+            tieBreaker: options.tieBreaker ?? 'highest-frequency',
+            elementAffinity: options.elementAffinity,
+            voteTimeoutMs: options.voteTimeoutMs ?? 30000,
+            shinkamOverride: options.shinkamOverride ?? true,
+        };
+    }
+    async initialize(config) {
+        if (config) {
+            this.config = {
+                ...this.config,
+                approvalThreshold: config.threshold,
+                voteTimeoutMs: config.timeoutMs,
+            };
+        }
+        this.initialized = true;
+        this.emit('initialized', { nodeId: this.nodeId, protocol: 'gate-quorum' });
+    }
+    async shutdown() {
+        this.proposals.clear();
+        this.proposalVotes.clear();
+        this.emit('shutdown');
+    }
+    /**
+     * Add a Guardian node to the quorum.
+     */
+    addNode(nodeId, options) {
+        const guardian = options?.guardian;
+        if (guardian && GUARDIANS[guardian]) {
+            const profile = GUARDIANS[guardian];
+            this.nodes.set(nodeId, {
+                guardian,
+                frequency: profile.frequency,
+                element: profile.element,
+            });
+        }
+        else {
+            this.nodes.set(nodeId, {
+                frequency: BASE_FREQUENCY,
+                element: 'void',
+            });
+        }
+    }
+    removeNode(nodeId) {
+        this.nodes.delete(nodeId);
+    }
+    /**
+     * Submit a petition to the Gate Quorum.
+     */
+    async propose(value) {
+        const petition = {
+            id: `gq_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+            petitionerId: this.nodeId,
+            value,
+            term: 1,
+            timestamp: new Date(),
+            seals: new Map(),
+            status: 'pending',
+        };
+        this.proposals.set(petition.id, petition);
+        this.proposalVotes.set(petition.id, []);
+        this.emit('consensus.proposed', {
+            proposalId: petition.id,
+            protocol: 'gate-quorum',
+            quorumSize: this.config.quorumSize,
+        });
+        return petition;
+    }
+    /**
+     * Cast a vote (seal) on a petition. Weight is calculated from Guardian frequency.
+     */
+    async vote(petitionId, seal) {
+        const petition = this.proposals.get(petitionId);
+        if (!petition || petition.status !== 'pending')
+            return;
+        petition.seals.set(seal.guardianId, seal);
+        // Calculate weight from Guardian data
+        const nodeData = this.nodes.get(seal.guardianId);
+        const frequency = nodeData?.frequency ?? BASE_FREQUENCY;
+        const element = nodeData?.element ?? 'void';
+        const guardian = nodeData?.guardian;
+        let weight = this.config.weightByFrequency
+            ? frequency / BASE_FREQUENCY
+            : 1.0;
+        // Element affinity bonus
+        if (this.config.elementAffinity && this.config.elementAffinity === element) {
+            weight *= 1.25; // 25% bonus for matching element
+        }
+        const quorumVote = {
+            guardian: guardian ?? 'shinkami',
+            frequency,
+            element,
+            vote: seal.approve ? 'approve' : 'reject',
+            weight,
+            reason: seal.reason,
+            timestamp: Date.now(),
+        };
+        this.proposalVotes.get(petitionId)?.push(quorumVote);
+        // Check if quorum reached
+        if (petition.seals.size >= this.config.quorumSize) {
+            await this.resolveQuorum(petitionId);
+        }
+    }
+    /**
+     * Wait for consensus on a petition.
+     */
+    async awaitConsensus(petitionId) {
+        const petition = this.proposals.get(petitionId);
+        if (!petition) {
+            throw new Error(`Petition ${petitionId} not found`);
+        }
+        const startTime = Date.now();
+        // Wait for resolution or timeout
+        return new Promise((resolve, reject) => {
+            const checkInterval = setInterval(() => {
+                const p = this.proposals.get(petitionId);
+                if (!p) {
+                    clearInterval(checkInterval);
+                    reject(new Error('Petition removed'));
+                    return;
+                }
+                if (p.status !== 'pending') {
+                    clearInterval(checkInterval);
+                    const votes = this.proposalVotes.get(petitionId) ?? [];
+                    resolve({
+                        petitionId,
+                        approved: p.status === 'accepted',
+                        approvalRate: this.calculateApprovalRate(votes),
+                        participationRate: votes.length / Math.max(this.nodes.size, 1),
+                        finalValue: p.value,
+                        rounds: 1,
+                        durationMs: Date.now() - startTime,
+                    });
+                    return;
+                }
+                if (Date.now() - startTime > this.config.voteTimeoutMs) {
+                    clearInterval(checkInterval);
+                    p.status = 'expired';
+                    resolve({
+                        petitionId,
+                        approved: false,
+                        approvalRate: 0,
+                        participationRate: (p.seals.size) / Math.max(this.nodes.size, 1),
+                        finalValue: p.value,
+                        rounds: 1,
+                        durationMs: Date.now() - startTime,
+                    });
+                }
+            }, 100);
+        });
+    }
+    // ── Private ──────────────────────────────────────────────
+    async resolveQuorum(petitionId) {
+        const petition = this.proposals.get(petitionId);
+        const votes = this.proposalVotes.get(petitionId);
+        if (!petition || !votes)
+            return;
+        let totalWeight = 0;
+        let approvalWeight = 0;
+        let rejectionWeight = 0;
+        let abstainWeight = 0;
+        let shinkamOverrideUsed = false;
+        for (const v of votes) {
+            totalWeight += v.weight;
+            if (v.vote === 'approve')
+                approvalWeight += v.weight;
+            else if (v.vote === 'reject')
+                rejectionWeight += v.weight;
+            else
+                abstainWeight += v.weight;
+        }
+        // Check for Shinkami override
+        if (this.config.shinkamOverride) {
+            const shinkamVote = votes.find((v) => v.guardian === 'shinkami');
+            if (shinkamVote && shinkamVote.vote !== 'abstain') {
+                // Shinkami at 1111 Hz has overwhelming weight
+                petition.status = shinkamVote.vote === 'approve' ? 'accepted' : 'rejected';
+                shinkamOverrideUsed = true;
+                this.emit('consensus.achieved', {
+                    petitionId,
+                    approved: petition.status === 'accepted',
+                    override: 'shinkami',
+                });
+                return;
+            }
+        }
+        // Standard weighted vote resolution
+        const effectiveTotal = totalWeight - abstainWeight;
+        if (effectiveTotal <= 0) {
+            petition.status = 'expired';
+            return;
+        }
+        const approvalRatio = approvalWeight / effectiveTotal;
+        if (approvalRatio >= this.config.approvalThreshold) {
+            petition.status = 'accepted';
+        }
+        else if ((1 - approvalRatio) >= this.config.approvalThreshold) {
+            petition.status = 'rejected';
+        }
+        else {
+            // Tie — use tiebreaker
+            petition.status = this.resolveTie(votes);
+        }
+        const result = {
+            approved: petition.status === 'accepted',
+            totalWeight,
+            approvalWeight,
+            rejectionWeight,
+            abstainWeight,
+            votes,
+            shinkamOverrideUsed,
+            durationMs: Date.now() - petition.timestamp.getTime(),
+        };
+        this.emit('consensus.achieved', {
+            petitionId,
+            ...result,
+        });
+    }
+    resolveTie(votes) {
+        switch (this.config.tieBreaker) {
+            case 'highest-frequency': {
+                // Guardian with highest frequency wins
+                const sorted = [...votes].sort((a, b) => b.frequency - a.frequency);
+                return sorted[0]?.vote === 'approve' ? 'accepted' : 'rejected';
+            }
+            case 'element-affinity': {
+                // Guardians matching the element affinity win
+                if (this.config.elementAffinity) {
+                    const matching = votes.filter((v) => v.element === this.config.elementAffinity);
+                    const approvals = matching.filter((v) => v.vote === 'approve').length;
+                    return approvals > matching.length / 2 ? 'accepted' : 'rejected';
+                }
+                return 'rejected';
+            }
+            case 'random':
+            default:
+                return Math.random() > 0.5 ? 'accepted' : 'rejected';
+        }
+    }
+    calculateApprovalRate(votes) {
+        const nonAbstain = votes.filter((v) => v.vote !== 'abstain');
+        if (nonAbstain.length === 0)
+            return 0;
+        const approvals = nonAbstain.filter((v) => v.vote === 'approve');
+        return approvals.length / nonAbstain.length;
+    }
+}
+export function createGateQuorumConsensus(nodeId, options) {
+    return new GateQuorumConsensus(nodeId, options);
+}
+//# sourceMappingURL=gate-quorum.js.map

package/dist/consensus/gate-quorum.js.map

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

package/dist/consensus/gossip.d.ts

@@ -0,0 +1,69 @@
+/**
+ * V3 Gossip Protocol Consensus
+ * Eventually consistent consensus for large-scale distributed systems
+ */
+import { EventEmitter } from 'events';
+import { ConsensusProposal, ConsensusVote, ConsensusResult, ConsensusConfig } from '../types.js';
+export interface GossipMessage {
+    id: string;
+    type: 'proposal' | 'vote' | 'state' | 'ack';
+    senderId: string;
+    version: number;
+    payload: unknown;
+    timestamp: Date;
+    ttl: number;
+    hops: number;
+    path: string[];
+}
+export interface GossipNode {
+    id: string;
+    state: Map<string, unknown>;
+    version: number;
+    neighbors: Set<string>;
+    seenMessages: Set<string>;
+    lastSync: Date;
+}
+export interface GossipConfig extends Partial<ConsensusConfig> {
+    fanout?: number;
+    gossipIntervalMs?: number;
+    maxHops?: number;
+    convergenceThreshold?: number;
+}
+export declare class GossipConsensus extends EventEmitter {
+    private config;
+    private node;
+    private nodes;
+    private proposals;
+    private messageQueue;
+    private gossipInterval?;
+    private proposalCounter;
+    constructor(nodeId: string, config?: GossipConfig);
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    addNode(nodeId: string): void;
+    removeNode(nodeId: string): void;
+    addNeighbor(nodeId: string): void;
+    removeNeighbor(nodeId: string): void;
+    propose(value: unknown): Promise<ConsensusProposal>;
+    vote(proposalId: string, vote: ConsensusVote): Promise<void>;
+    awaitConsensus(proposalId: string): Promise<ConsensusResult>;
+    private startGossipLoop;
+    private gossipRound;
+    private selectRandomNeighbors;
+    private sendToNeighbor;
+    private processReceivedMessage;
+    private handleProposalMessage;
+    private handleVoteMessage;
+    private handleStateMessage;
+    private queueMessage;
+    private checkConvergence;
+    private createResult;
+    getConvergence(proposalId: string): number;
+    getVersion(): number;
+    getNeighborCount(): number;
+    getSeenMessageCount(): number;
+    getQueueDepth(): number;
+    antiEntropy(): Promise<void>;
+}
+export declare function createGossipConsensus(nodeId: string, config?: GossipConfig): GossipConsensus;
+//# sourceMappingURL=gossip.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gossip.d.ts","sourceRoot":"","sources":["../../src/consensus/gossip.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,eAAe,EAEhB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,QAAQ,EAAE,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,YAAa,SAAQ,OAAO,CAAC,eAAe,CAAC;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,eAAe,CAAa;gBAExB,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,YAAiB;IAuB/C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAiB7B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAShC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMjC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI9B,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2CnD,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B5D,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA2ClE,OAAO,CAAC,eAAe;YAMT,WAAW;IAwBzB,OAAO,CAAC,qBAAqB;YAYf,cAAc;YAwBd,sBAAsB;YAsCtB,qBAAqB;YAkCrB,iBAAiB;YAgBjB,kBAAkB;IAehC,OAAO,CAAC,YAAY;YAQN,gBAAgB;IA2B9B,OAAO,CAAC,YAAY;IAqBpB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAQ1C,UAAU,IAAI,MAAM;IAIpB,gBAAgB,IAAI,MAAM;IAI1B,mBAAmB,IAAI,MAAM;IAI7B,aAAa,IAAI,MAAM;IAKjB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAoBnC;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,YAAY,GACpB,eAAe,CAEjB"}