raptiye 0.1.0

package/bench-results.json

@@ -0,0 +1,598 @@
+{
+  "environment": {
+    "nodeVersion": "v20.19.5",
+    "os": "Darwin",
+    "platform": "darwin",
+    "release": "25.6.0",
+    "arch": "arm64",
+    "cpuModel": "Apple M2",
+    "cpuCores": 8,
+    "totalMemoryMB": 16384,
+    "date": "2026-09-19T16:12:27.502Z",
+    "gitCommit": "unknown"
+  },
+  "startedAt": "2026-09-19T16:12:27.502Z",
+  "benchmarks": {
+    "singleNode": {
+      "benchmark": "single_node_core_overhead",
+      "environment": {
+        "nodeVersion": "v20.19.5",
+        "os": "Darwin",
+        "platform": "darwin",
+        "release": "25.6.0",
+        "arch": "arm64",
+        "cpuModel": "Apple M2",
+        "cpuCores": 8,
+        "totalMemoryMB": 16384,
+        "date": "2026-09-19T16:12:27.624Z",
+        "gitCommit": "unknown"
+      },
+      "iterations": 200000,
+      "totalTimeMs": 81.855625,
+      "opsPerSec": 2443326,
+      "nsPerOp": 409,
+      "bytesAllocatedPerOp": 160,
+      "heapUsedMB": 37
+    },
+    "replication": {
+      "benchmark": "3_node_replication",
+      "environment": {
+        "nodeVersion": "v20.19.5",
+        "os": "Darwin",
+        "platform": "darwin",
+        "release": "25.6.0",
+        "arch": "arm64",
+        "cpuModel": "Apple M2",
+        "cpuCores": 8,
+        "totalMemoryMB": 16384,
+        "date": "2026-09-19T16:12:34.793Z",
+        "gitCommit": "unknown"
+      },
+      "results": [
+        {
+          "payloadSize": "16 B",
+          "bytes": 16,
+          "iterations": 10000,
+          "opsPerSec": 65633,
+          "mbPerSec": 1,
+          "commitP50Ms": 0.0124,
+          "commitP95Ms": 0.0286,
+          "commitP99Ms": 0.0465,
+          "copiesPerByte": 0
+        },
+        {
+          "payloadSize": "64 B",
+          "bytes": 64,
+          "iterations": 10000,
+          "opsPerSec": 39358,
+          "mbPerSec": 2.4,
+          "commitP50Ms": 0.0202,
+          "commitP95Ms": 0.0401,
+          "commitP99Ms": 0.0913,
+          "copiesPerByte": 0
+        },
+        {
+          "payloadSize": "256 B",
+          "bytes": 256,
+          "iterations": 10000,
+          "opsPerSec": 29213,
+          "mbPerSec": 7.13,
+          "commitP50Ms": 0.0288,
+          "commitP95Ms": 0.0538,
+          "commitP99Ms": 0.1195,
+          "copiesPerByte": 0
+        },
+        {
+          "payloadSize": "1 KB",
+          "bytes": 1024,
+          "iterations": 8000,
+          "opsPerSec": 21015,
+          "mbPerSec": 20.52,
+          "commitP50Ms": 0.043,
+          "commitP95Ms": 0.0615,
+          "commitP99Ms": 0.1173,
+          "copiesPerByte": 0
+        },
+        {
+          "payloadSize": "4 KB",
+          "bytes": 4096,
+          "iterations": 5000,
+          "opsPerSec": 6967,
+          "mbPerSec": 27.21,
+          "commitP50Ms": 0.118,
+          "commitP95Ms": 0.229,
+          "commitP99Ms": 0.4109,
+          "copiesPerByte": 0
+        },
+        {
+          "payloadSize": "64 KB",
+          "bytes": 65536,
+          "iterations": 1000,
+          "opsPerSec": 495,
+          "mbPerSec": 30.96,
+          "commitP50Ms": 1.7322,
+          "commitP95Ms": 3.0451,
+          "commitP99Ms": 6.7927,
+          "copiesPerByte": 0
+        },
+        {
+          "payloadSize": "1 MB",
+          "bytes": 1048576,
+          "iterations": 100,
+          "opsPerSec": 36,
+          "mbPerSec": 35.8,
+          "commitP50Ms": 27.2697,
+          "commitP95Ms": 28.7118,
+          "commitP99Ms": 74.791,
+          "copiesPerByte": 0
+        }
+      ]
+    },
+    "batchCurve": {
+      "benchmark": "batch_curve",
+      "environment": {
+        "nodeVersion": "v20.19.5",
+        "os": "Darwin",
+        "platform": "darwin",
+        "release": "25.6.0",
+        "arch": "arm64",
+        "cpuModel": "Apple M2",
+        "cpuCores": 8,
+        "totalMemoryMB": 16384,
+        "date": "2026-09-19T16:12:36.532Z",
+        "gitCommit": "unknown"
+      },
+      "results": [
+        {
+          "maxBatchEntries": 1,
+          "opsPerSec": 48573,
+          "mbPerSec": 2.96,
+          "latencyP50Ms": 0.0124,
+          "latencyP99Ms": 0.0945
+        },
+        {
+          "maxBatchEntries": 4,
+          "opsPerSec": 73883,
+          "mbPerSec": 4.51,
+          "latencyP50Ms": 0.0123,
+          "latencyP99Ms": 0.0252
+        },
+        {
+          "maxBatchEntries": 16,
+          "opsPerSec": 76037,
+          "mbPerSec": 4.64,
+          "latencyP50Ms": 0.0122,
+          "latencyP99Ms": 0.0506
+        },
+        {
+          "maxBatchEntries": 64,
+          "opsPerSec": 75374,
+          "mbPerSec": 4.6,
+          "latencyP50Ms": 0.0123,
+          "latencyP99Ms": 0.0257
+        },
+        {
+          "maxBatchEntries": 256,
+          "opsPerSec": 75464,
+          "mbPerSec": 4.61,
+          "latencyP50Ms": 0.0127,
+          "latencyP99Ms": 0.0162
+        },
+        {
+          "maxBatchEntries": 1024,
+          "opsPerSec": 76381,
+          "mbPerSec": 4.66,
+          "latencyP50Ms": 0.0131,
+          "latencyP99Ms": 0.0134
+        },
+        {
+          "maxBatchEntries": 4096,
+          "opsPerSec": 74996,
+          "mbPerSec": 4.58,
+          "latencyP50Ms": 0.0134,
+          "latencyP99Ms": 0.0135
+        }
+      ]
+    },
+    "pipeline": {
+      "benchmark": "pipeline_depth",
+      "environment": {
+        "nodeVersion": "v20.19.5",
+        "os": "Darwin",
+        "platform": "darwin",
+        "release": "25.6.0",
+        "arch": "arm64",
+        "cpuModel": "Apple M2",
+        "cpuCores": 8,
+        "totalMemoryMB": 16384,
+        "date": "2026-09-19T16:12:37.951Z",
+        "gitCommit": "unknown"
+      },
+      "results": [
+        {
+          "maxInflightBatches": 1,
+          "opsPerSec": 64972,
+          "p50Ms": 0.014,
+          "p95Ms": 0.0165,
+          "p99Ms": 0.0219
+        },
+        {
+          "maxInflightBatches": 2,
+          "opsPerSec": 62080,
+          "p50Ms": 0.014,
+          "p95Ms": 0.0212,
+          "p99Ms": 0.0347
+        },
+        {
+          "maxInflightBatches": 4,
+          "opsPerSec": 64974,
+          "p50Ms": 0.014,
+          "p95Ms": 0.0166,
+          "p99Ms": 0.0317
+        },
+        {
+          "maxInflightBatches": 8,
+          "opsPerSec": 60713,
+          "p50Ms": 0.0143,
+          "p95Ms": 0.022,
+          "p99Ms": 0.0427
+        },
+        {
+          "maxInflightBatches": 16,
+          "opsPerSec": 55857,
+          "p50Ms": 0.0145,
+          "p95Ms": 0.0284,
+          "p99Ms": 0.0629
+        },
+        {
+          "maxInflightBatches": 32,
+          "opsPerSec": 57719,
+          "p50Ms": 0.0143,
+          "p95Ms": 0.0241,
+          "p99Ms": 0.0628
+        }
+      ]
+    },
+    "slowFollower": {
+      "benchmark": "slow_follower_isolation",
+      "environment": {
+        "nodeVersion": "v20.19.5",
+        "os": "Darwin",
+        "platform": "darwin",
+        "release": "25.6.0",
+        "arch": "arm64",
+        "cpuModel": "Apple M2",
+        "cpuCores": 8,
+        "totalMemoryMB": 16384,
+        "date": "2026-09-19T16:12:38.394Z",
+        "gitCommit": "unknown"
+      },
+      "fastPeerRttMs": 2,
+      "slowPeerRttMs": 200,
+      "commandsSubmitted": 500,
+      "quorumOpsPerSec": 333,
+      "leaderCommit": 501,
+      "fastPeerMatch": 501,
+      "slowPeerMatch": 358,
+      "quorumHealthy": true
+    },
+    "failover": {
+      "benchmark": "failover_timeline",
+      "environment": {
+        "nodeVersion": "v20.19.5",
+        "os": "Darwin",
+        "platform": "darwin",
+        "release": "25.6.0",
+        "arch": "arm64",
+        "cpuModel": "Apple M2",
+        "cpuCores": 8,
+        "totalMemoryMB": 16384,
+        "date": "2026-09-19T16:12:38.442Z",
+        "gitCommit": "unknown"
+      },
+      "iterations": 50,
+      "metrics": {
+        "headlineMetric": "leader_death_to_first_newly_committed_command",
+        "totalWriteUnavailability": {
+          "p50": 133,
+          "p90": 187,
+          "p95": 194,
+          "p99": 208,
+          "max": 208,
+          "mean": 145.3111111111111
+        },
+        "detectionLatency": {
+          "p50": 115,
+          "p90": 168,
+          "p95": 172,
+          "p99": 188,
+          "max": 188,
+          "mean": 126.22222222222223
+        },
+        "electionLatency": {
+          "p50": 12,
+          "p90": 15,
+          "p95": 19,
+          "p99": 52,
+          "max": 52,
+          "mean": 13.355555555555556
+        },
+        "activationAndCommitLatency": {
+          "p50": 6,
+          "p90": 9,
+          "p95": 10,
+          "p99": 10,
+          "max": 10,
+          "mean": 5.733333333333333
+        }
+      },
+      "sampleTimelines": [
+        {
+          "iteration": 1,
+          "T0": 420,
+          "T1": 587,
+          "T2": 587,
+          "T3": 594,
+          "T4": 601,
+          "T5": 601,
+          "T6": 607,
+          "T7": 607,
+          "detectionMs": 167,
+          "electionMs": 14,
+          "totalUnavailabilityMs": 187
+        },
+        {
+          "iteration": 2,
+          "T0": 420,
+          "T1": 526,
+          "T2": 526,
+          "T3": 532,
+          "T4": 537,
+          "T5": 537,
+          "T6": 542,
+          "T7": 542,
+          "detectionMs": 106,
+          "electionMs": 11,
+          "totalUnavailabilityMs": 122
+        },
+        {
+          "iteration": 3,
+          "T0": 420,
+          "T1": 508,
+          "T2": 508,
+          "T3": 513,
+          "T4": 519,
+          "T5": 519,
+          "T6": 523,
+          "T7": 523,
+          "detectionMs": 88,
+          "electionMs": 11,
+          "totalUnavailabilityMs": 103
+        },
+        {
+          "iteration": 4,
+          "T0": 420,
+          "T1": 562,
+          "T2": 562,
+          "T3": 567,
+          "T4": 574,
+          "T5": 574,
+          "T6": 580,
+          "T7": 580,
+          "detectionMs": 142,
+          "electionMs": 12,
+          "totalUnavailabilityMs": 160
+        },
+        {
+          "iteration": 5,
+          "T0": 420,
+          "T1": 535,
+          "T2": 535,
+          "T3": 542,
+          "T4": 544,
+          "T5": 544,
+          "T6": 547,
+          "T7": 547,
+          "detectionMs": 115,
+          "electionMs": 9,
+          "totalUnavailabilityMs": 127
+        }
+      ]
+    },
+    "partition": {
+      "benchmark": "partition_and_split_brain_safety",
+      "environment": {
+        "nodeVersion": "v20.19.5",
+        "os": "Darwin",
+        "platform": "darwin",
+        "release": "25.6.0",
+        "arch": "arm64",
+        "cpuModel": "Apple M2",
+        "cpuCores": 8,
+        "totalMemoryMB": 16384,
+        "date": "2026-09-19T16:12:38.470Z",
+        "gitCommit": "unknown"
+      },
+      "scenarios": [
+        {
+          "scenario": "Leader Isolated & Heal",
+          "isolatedCommitted": false,
+          "majorityCommitted": true,
+          "oldLeaderDemoted": true,
+          "splitBrainPrevented": true,
+          "passed": true
+        },
+        {
+          "scenario": "Single Follower Isolated & Rejoin",
+          "isolatedCommitted": false,
+          "majorityCommitted": true,
+          "oldLeaderDemoted": false,
+          "splitBrainPrevented": true,
+          "passed": true
+        }
+      ]
+    },
+    "recovery": {
+      "benchmark": "follower_recovery",
+      "environment": {
+        "nodeVersion": "v20.19.5",
+        "os": "Darwin",
+        "platform": "darwin",
+        "release": "25.6.0",
+        "arch": "arm64",
+        "cpuModel": "Apple M2",
+        "cpuCores": 8,
+        "totalMemoryMB": 16384,
+        "date": "2026-09-19T16:12:38.609Z",
+        "gitCommit": "unknown"
+      },
+      "results": [
+        {
+          "entriesBehind": 1000,
+          "roundtrips": 1,
+          "timeToReadyMs": 0.99,
+          "entriesPerSec": 1011250,
+          "mbPerSec": 61.72,
+          "heapUsedMB": 39,
+          "rssMB": 368
+        },
+        {
+          "entriesBehind": 100000,
+          "roundtrips": 98,
+          "timeToReadyMs": 65.23,
+          "entriesPerSec": 1533023,
+          "mbPerSec": 93.57,
+          "heapUsedMB": 32,
+          "rssMB": 372
+        }
+      ]
+    },
+    "eventLoop": {
+      "benchmark": "event_loop_health",
+      "environment": {
+        "nodeVersion": "v20.19.5",
+        "os": "Darwin",
+        "platform": "darwin",
+        "release": "25.6.0",
+        "arch": "arm64",
+        "cpuModel": "Apple M2",
+        "cpuCores": 8,
+        "totalMemoryMB": 16384,
+        "date": "2026-09-19T16:12:39.223Z",
+        "gitCommit": "unknown"
+      },
+      "workload": "4850 commands (256 B)",
+      "eventLoopLagMs": {
+        "p50": 0.0133,
+        "p90": 0.0146,
+        "p95": 0.015,
+        "p99": 0.0244,
+        "max": 1.614
+      }
+    },
+    "memorySoak": {
+      "benchmark": "memory_stability_soak",
+      "environment": {
+        "nodeVersion": "v20.19.5",
+        "os": "Darwin",
+        "platform": "darwin",
+        "release": "25.6.0",
+        "arch": "arm64",
+        "cpuModel": "Apple M2",
+        "cpuCores": 8,
+        "totalMemoryMB": 16384,
+        "date": "2026-09-19T16:12:40.019Z",
+        "gitCommit": "unknown"
+      },
+      "totalCommands": 50000,
+      "opsPerSec": 72227,
+      "initialHeapMB": 47,
+      "finalHeapMB": 77,
+      "memoryGrowthMB": 30,
+      "memoryBounded": false,
+      "checkpoints": [
+        {
+          "iteration": 5000,
+          "rssMB": 370,
+          "heapUsedMB": 47,
+          "heapTotalMB": 72,
+          "externalMB": 7,
+          "retainedEntries": 1000
+        },
+        {
+          "iteration": 10000,
+          "rssMB": 371,
+          "heapUsedMB": 50,
+          "heapTotalMB": 72,
+          "externalMB": 8,
+          "retainedEntries": 1000
+        },
+        {
+          "iteration": 15000,
+          "rssMB": 373,
+          "heapUsedMB": 52,
+          "heapTotalMB": 74,
+          "externalMB": 9,
+          "retainedEntries": 1000
+        },
+        {
+          "iteration": 20000,
+          "rssMB": 373,
+          "heapUsedMB": 54,
+          "heapTotalMB": 78,
+          "externalMB": 11,
+          "retainedEntries": 1000
+        },
+        {
+          "iteration": 25000,
+          "rssMB": 377,
+          "heapUsedMB": 55,
+          "heapTotalMB": 81,
+          "externalMB": 12,
+          "retainedEntries": 1000
+        },
+        {
+          "iteration": 30000,
+          "rssMB": 376,
+          "heapUsedMB": 57,
+          "heapTotalMB": 85,
+          "externalMB": 13,
+          "retainedEntries": 1000
+        },
+        {
+          "iteration": 35000,
+          "rssMB": 380,
+          "heapUsedMB": 58,
+          "heapTotalMB": 89,
+          "externalMB": 15,
+          "retainedEntries": 1000
+        },
+        {
+          "iteration": 40000,
+          "rssMB": 381,
+          "heapUsedMB": 60,
+          "heapTotalMB": 92,
+          "externalMB": 16,
+          "retainedEntries": 1000
+        },
+        {
+          "iteration": 45000,
+          "rssMB": 384,
+          "heapUsedMB": 76,
+          "heapTotalMB": 96,
+          "externalMB": 18,
+          "retainedEntries": 1000
+        },
+        {
+          "iteration": 50000,
+          "rssMB": 387,
+          "heapUsedMB": 77,
+          "heapTotalMB": 99,
+          "externalMB": 19,
+          "retainedEntries": 1000
+        }
+      ]
+    }
+  },
+  "completedAt": "2026-09-19T16:12:40.019Z"
+}

package/index.js

@@ -0,0 +1,30 @@
+/**
+ * Raptiye: High-performance, byte-first replicated-log and consensus core for Node.js.
+ */
+
+export { Raptiye } from './src/node/raptiye.js';
+export { ConsensusEngine } from './src/core/engine.js';
+export { ClusterInvariants } from './src/core/invariants.js';
+
+// Storage
+export { LogStorage } from './src/storage/interface.js';
+export { MemoryLog } from './src/storage/memory-log.js';
+export { FileLog } from './src/storage/file-log.js';
+
+// Transport
+export { Transport } from './src/transport/interface.js';
+export { MemoryNetwork, MemoryTransport } from './src/transport/memory-transport.js';
+export { TCPTransport } from './src/transport/tcp-transport.js';
+
+// Simulation & Testing
+export { ClusterSimulator, SimulatedNode } from './src/sim/cluster.js';
+export { VirtualClock } from './src/sim/virtual-clock.js';
+export { PRNG } from './src/sim/prng.js';
+
+// Protocol & Types
+export { Role, RoleName, MessageType, MessageTypeName, EntryType, EventType, EffectType } from './src/types.js';
+export { encodeMessage, decodeMessage, flattenChunks, globalWireMetrics, WireMetrics } from './src/protocol/wire.js';
+export { crc32, crc32Buffers } from './src/protocol/checksum.js';
+
+// Replication & Delivery
+export { ReplicationPipeline, BatchReceipt } from './src/replication/pipeline.js';

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "raptiye",
+  "version": "0.1.0",
+  "description": "High-performance, byte-first replicated-log and consensus core for JavaScript/Node.js",
+  "type": "module",
+  "main": "index.js",
+  "scripts": {
+    "test": "node --test test/**/*.test.js",
+    "bench": "node bench/run-all.js"
+  },
+  "keywords": [
+    "raft",
+    "consensus",
+    "replicated-log",
+    "distributed-systems",
+    "high-performance",
+    "zero-copy",
+    "deterministic"
+  ],
+  "author": "",
+  "license": "Apache-2.0",
+  "dependencies": {},
+  "devDependencies": {}
+}